forked from xobs/novena-eeprom
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathnovena-eeprom.8
142 lines (130 loc) · 4.56 KB
/
novena-eeprom.8
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
.TH NOVENA-EEPROM 8 "14 Oct 2014" Novena "Linux System Administration"
.SH NAME
novena-eeprom \- view or modify the onboard serial EEPROM for Novena
.SH SYNOPSIS
\fBnovena-eeprom\fR
[\fB-m\fR \fImac-address\fR]
[\fB-s\fR \fIserial-number\fR]
[\fB-f\fR \fIflag-list\fR]
[\fB-o\fR \fIoops-start\fR[:\fIoops-length\fR]]
[\fB-l\fR \fIeeprom-length\fR]
[\fB-p\fR \fIeeprom-page-size\fR]
[\fB-1\fR \fIlvds1-modesetting\fR]
[\fB-2\fR \fIlvds2-modesetting\fR]
[\fB-d\fR \fIhdmi-modesetting\fR]
[\fB-w\fR]
.TP
\fBnovena-eeprom\fR [\fB-e\fR \fIexport-filename\fR]
.TP
\fBnovena-eeprom\fR [\fB-i\fR \fIimport-filename\fR]
.TP
\fBnovena-eeprom\fR [\fB-h\fR]
.SH DESCRIPTION
.LP
Novena contains an onboard EEPROM that is used by the bootloader to determine
everything from available featurs to where the root filesystem is located.
You can use \fBnovena-eeprom\fR to view and modify this EEPROM data.
.SH OPTIONS
.TP
.BI \-m " mac-address"
MAC address for the gigabit ethernet port. If set to the special value of
\fIff:ff:ff:ff:ff:ff\fR, then a new address will be "randomly" generated at
boot (when not much entropy is available.)
.TP
.BI \-s " serial-number"
32-bit device-specific serial number. Assigned at the factory, but you can
change it if you really want to.
.TP
.BI \-f " feature-list"
Select a list of features installed on this Novena. Currently-defined features
include:
.TS
allbox tab(^);
c s
c c
l l.
Available Features
Flag^Description
es8328^ES8328 audio codec
senoko^Senoko battery board
edp^eDP bridge chip (it6251)
pcie^PCIe Express
gbit^Gigabit Ethernet
hdmi^HDMI output
eepromoops^Log kernel panics to EEPROM
sataroot^Use SATA as root filesystem
.TE
.TP
.BI \-o " eepromoops-params"
Specify the eepromoops offset start, and optionally size. If one number is
specified, this will set the eepromoops start, and the size will be unaffected.
If you specify two numbers (delimited in some fashion, e.g. 1-2 or 100,200 or
1000;2000), the second number will be set to the eepromoops length.
.TP
.BI \-p " eeprom-page-size"
The number of bytes that can be written at once to the EEPROM. Refer to
the datasheet for this number.
.TP
.BI \-l " eeprom-length"
The length (in bytes) of the EEPROM.
.TP
.BI \-1 " LVDS channel 1 modeline"
.BI \-2 " LVDS channel 2 modeline"
.BI \-m " LVDS channel 2 modeline"
Specify modeline timings for the various output devices. See \fBMODELINES\fR
below for more information.
If a channel is present, specify the \fIchannel_present\fR flag. If you're
using a dual-lane LVDS device, specify \fIdual_channel\fR for LVDS channel 0.
.TP
.BI \-w
Write the specified values to the EEPROM. Without this flag, no values
will be written.
.TP
.BI \-e " output-filename"
Export the current EEPROM to a file. Useful for taking backups, and copying
files from one device to another.
.TP
.BI \-i " import-filename"
Import a file to the EEPROM. Used to restore an EEPROM file to a device. Note
that you can specify additional parameters to modify a file as it gets written
to the board. For example, you can import an EEPROM and then specify a new
MAC address and serial number all in one step.
In order to actually write the data, you must specify \fB-w\fR. Otherwise,
\fBnovena-eeprom\fR will simply display the contents of the file.
.TP
.BI \-h
Print out a help message.
.SH MODELINES
You can specify modelines for various display devices. The entire line should
be quoted. Standard X11 Modeline format is supported, but the flags are
nonstandard:
.TS
allbox tab(^);
c s
c c
l l.
Available Modeline Flags
Flag^Description
channel_present^This channel is present
dual_channel^Run LVDS in dual-channel
vsync_polarity^Positive VSync
hsync_polarity^Positive HSync
\+HSYNC^Alias for hsync_polarity
\+VSYNC^Alias for vsync_polarity
mapping_jeida^Use JEIDA mapping for LVDS
data_width_8bit^Use 8-bit data
ignore_settings^Attempt to auto-detect the mode
.TE
You may only run LVDS channel 1 in dual-channel mode. In this case, you
should still specify that LVDS channel 2 is present. Marking other devices
as \fIdual_channel\fR has no effect.
Negative HSync or VSync is specified by omitting the polarity flag, or
specifying either \fI\-HSYNC\fR or \fI\-VSYNC\fR.
If \fIdata_width_8bit\fR is omitted, then an LVDS channel will use 6-bit data,
and the HDMI channel will use 10-bit data.
The mapping is only valid for LVDS. If \fImapping_jeida\fR is not specified,
then PSWG/SWPG data mapping will be used.
An example modeline is:
.B 'Modeline "lvds1" 148.500 1920 2068 2156 2200 1080 1116 1120 1125 +HSync +VSync channel_present dual_channel mapping_jeida data_width_8bit'
.SH AUTHORS
Written by Sean Cross <[email protected]>