1.TH SUPERIOTOOL 8 "January 18, 2008" 2.SH NAME 3superiotool \- Super I/O detection tool 4.SH SYNOPSIS 5.B superiotool \fR[\fB\-delVvh\fR] 6.SH DESCRIPTION 7.B superiotool 8is a GPL'd user-space utility which can 9.PP 10 * detect which Super I/O chip is soldered onto your mainboard, 11.PP 12 * at which configuration port it's located (usually 0x2e or 0x4e), and 13.PP 14 * dump all register contents of the Super I/O chip, together with the 15 default values as per datasheet (to make comparing the values easy). 16.PP 17It is mainly used for coreboot development purposes (see coreboot.org 18for details on coreboot), but it may also be useful for other things. 19.PP 20The list of supported Super I/O chips is available at 21.BR http://coreboot.org/Superiotool#Supported_devices "," 22but it can also be viewed by running 23.BR "superiotool -l" "." 24.SH OPTIONS 25If no command line option is specified, 26.B superiotool 27merely tries to detect the Super I/O chip. 28You must use the 29.B "\-d" 30option to dump the Super I/O register contents. 31.TP 32.B "\-d, \-\-dump" 33Dump Super I/O registers (if the Super I/O chip is detected and 34.B superiotool 35supports the 36.B "\-\-dump" 37option for this chip). The output will look something like this: 38.sp 39.B "$ superiotool -d" 40.br 41Found SMSC FDC37N769 (id=0x28, rev=0x01) at 0x3f0 42.br 43Register dump: 44.br 45idx 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11... 46.br 47val 20 90 80 f4 00 00 ff 00 00 00 40 00 0e 28 01 00 00 00... 48.br 49def 28 9c 88 70 00 00 ff 00 00 00 00 00 02 28 NA 00 00 80... 50.sp 51The 52.B idx 53fields contain the register numbers/indexes of the Super I/O, the 54.B val 55fields contain the contents of the respective register as read from the 56Super I/O, and the 57.B def 58fields contain the default values for the respective register, as specified 59in the datasheet. 60.sp 61The numbers in the output are all in hex format, and some special values 62may also occur: 63.BR NA " stands for" 64.I "not available" 65(i.e., the datasheet doesn't specify a default value for the respective 66register), 67.BR RR " means" 68.I reserved 69(the datasheet explicitly marks this register as reserved), and 70.BR MM " means" 71.IR misc , 72which can mean several things. It's recommended to consult the datasheet for 73detailed information about the 74.BR MM " fields." 75.TP 76.B "\-e, \-\-extra-dump" 77Dump extra secondary register contents too, if available. Only in combination 78with the 79.B --dump 80option. This option will, for instance, dump the environmental controller (EC) 81configuration registers for the ITE IT8716F chip. The format is similar to 82the output of the 83.B --dump 84option. 85.TP 86.B "\-l, \-\-list-supported" 87List all Super I/O chips recognized by 88.BR superiotool ". The phrase" 89.BR "(dump available)" 90following a chip name indicates that 91.B superiotool 92supports the 93.B --dump 94option for this chip. 95.TP 96.B "\-V, \-\-verbose" 97Enable verbose mode. This option can be used together with the 98.BR "\-d" " option." 99.sp 100The verbose output will not only list for which type of Super I/O the tool 101is scanning, but also at which configuration port it's probing, and which 102Super I/O initialization sequence is used. If no Super I/O was detected 103in a probing run, the returned output will be shown, as it may be useful 104for figuring out which (currently unrecognized) Super I/O chip this may be. 105.TP 106.B "\-v, \-\-version" 107Show version information and exit. 108.TP 109.B "\-h, \-\-help" 110Show a help text and exit. 111.SH BUGS 112Please report any bugs at 113.B http://tracker.coreboot.org/trac/coreboot/newticket 114or on the coreboot mailing list 115.RB "(" http://coreboot.org/Mailinglist ")." 116.SH AUTHORS 117Please see the individual source code files and/or the README file. 118.SH LICENCE 119.B superiotool 120is covered by the GNU General Public License (GPL), either version 2 of 121the License, or (at your option) any later version. 122.SH SEE ALSO 123.BR sensors-detect (8) 124