1SUPERIOTOOL(8)              System Manager's Manual             SUPERIOTOOL(8)
2
3
4

NAME

6       superiotool - Super I/O detection tool
7

SYNOPSIS

9       superiotool [-delVvh]
10

DESCRIPTION

12       superiotool is a GPL'd user-space utility which can
13
14        * detect which Super I/O chip is soldered onto your mainboard,
15
16        * at which configuration port it's located (usually 0x2e or 0x4e), and
17
18        * dump all register contents of the Super I/O chip, together with the
19          default values as per datasheet (to make comparing the values easy).
20
21       It  is  mainly used for coreboot development purposes (see coreboot.org
22       for details on coreboot), but it may also be useful for other things.
23
24       The list of supported Super I/O  chips  is  available  at  http://core
25       boot.org/Superiotool#Supported_devices,  but  it  can also be viewed by
26       running superiotool -l.
27

OPTIONS

29       If no command line option is specified,  superiotool  merely  tries  to
30       detect  the  Super  I/O  chip.   You must use the -d option to dump the
31       Super I/O register contents.
32
33       -d, --dump
34              Dump Super I/O registers (if the Super I/O chip is detected  and
35              superiotool  supports the --dump option for this chip). The out‐
36              put will look something like this:
37
38              $ superiotool -d
39              Found SMSC FDC37N769 (id=0x28, rev=0x01) at 0x3f0
40              Register dump:
41              idx 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11...
42              val 20 90 80 f4 00 00 ff 00 00 00 40 00 0e 28 01 00 00 00...
43              def 28 9c 88 70 00 00 ff 00 00 00 00 00 02 28 NA 00 00 80...
44
45              The idx fields contain the register numbers/indexes of the Super
46              I/O,  the val fields contain the contents of the respective reg‐
47              ister as read from the Super I/O, and the def fields contain the
48              default  values for the respective register, as specified in the
49              datasheet.
50
51              The numbers in the output are all in hex format, and  some  spe‐
52              cial  values  may also occur: NA stands for not available (i.e.,
53              the datasheet doesn't specify a default value for the respective
54              register),  RR  means  reserved  (the datasheet explicitly marks
55              this register as reserved), and MM means misc,  which  can  mean
56              several  things.  It's  recommended to consult the datasheet for
57              detailed information about the MM fields.
58
59       -e, --extra-dump
60              Dump extra secondary register contents too, if  available.  Only
61              in  combination  with  the  --dump option. This option will, for
62              instance, dump the environmental controller  (EC)  configuration
63              registers for the ITE IT8716F chip. The format is similar to the
64              output of the --dump option.
65
66       -l, --list-supported
67              List all Super I/O chips recognized by superiotool.  The  phrase
68              (dump  available)  following  a chip name indicates that superi‐
69              otool supports the --dump option for this chip.
70
71       -V, --verbose
72              Enable verbose mode. This option can be used together  with  the
73              -d option.
74
75              The  verbose  output  will not only list for which type of Super
76              I/O the tool is scanning, but also at which  configuration  port
77              it's  probing,  and  which  Super I/O initialization sequence is
78              used. If no Super  I/O  was  detected  in  a  probing  run,  the
79              returned  output will be shown, as it may be useful for figuring
80              out which (currently unrecognized) Super I/O chip this may be.
81
82       -v, --version
83              Show version information and exit.
84
85       -h, --help
86              Show a help text and exit.
87

BUGS

89       Please  report  any  bugs   at   http://tracker.coreboot.org/trac/core
90       boot/newticket   or   on   the   coreboot  mailing  list  (http://core
91       boot.org/Mailinglist).
92

AUTHORS

94       Please see the individual source code files and/or the README file.
95

LICENCE

97       superiotool is covered by the GNU General Public License (GPL),  either
98       version 2 of the License, or (at your option) any later version.
99

SEE ALSO

101       sensors-detect(8)
102
103
104
105                               January 18, 2008                 SUPERIOTOOL(8)
Impressum