1SUPERIOTOOL(8) System Manager's Manual SUPERIOTOOL(8)
2
6 superiotool - Super I/O detection tool
7
9 superiotool [-delVvh]
10
12 superiotool is a GPL'd user-space utility which can
13 * detect which Super I/O chip is soldered onto your mainboard,
15 * at which configuration port it's located (usually 0x2e or 0x4e), and
17 * 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 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 The list of supported Super I/O chips is available at https://core‐
25 boot.org/Superiotool#Supported_devices, but it can also be viewed by
26 running superiotool -l.
27
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 -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 $ 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 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 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 -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 -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 -V, --verbose
72 Enable verbose mode. This option can be used together with the
73 -d option.
74 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 -v, --version
83 Show version information and exit.
84 -h, --help
86 Show a help text and exit.
87
89 Please report any bugs on the coreboot mailing list (https://core‐
90 boot.org/Mailinglist).
91
93 Please see the individual source code files and/or the README file.
94
96 superiotool is covered by the GNU General Public License (GPL), either
97 version 2 of the License, or (at your option) any later version.
98
100 sensors-detect(8)
101 January 18, 2008 SUPERIOTOOL(8)