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