2007-09-18 02:01:27 +02:00
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
Superiotool README
|
|
|
|
-------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
Superiotool is a user-space utility which can
|
|
|
|
|
|
|
|
- detect which Super I/O chip is soldered onto your mainboard,
|
|
|
|
|
|
|
|
- at which configuration port it's located (usually 0x2e or 0x4e), and
|
|
|
|
|
|
|
|
- dump all register contents of the Super I/O chip, together with the
|
|
|
|
default values as per datasheet (to make comparing the values easy).
|
|
|
|
|
2008-01-18 16:34:24 +01:00
|
|
|
It is mainly used for coreboot development purposes (see coreboot.org
|
|
|
|
for details on coreboot), but it may also be useful for other things.
|
2007-09-18 02:01:27 +02:00
|
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
------------
|
|
|
|
|
2008-01-18 16:34:24 +01:00
|
|
|
$ svn co svn://coreboot.org/repos/trunk/util/superiotool
|
2007-09-18 02:01:27 +02:00
|
|
|
|
2007-10-11 20:30:05 +02:00
|
|
|
$ cd superiotool
|
|
|
|
|
2007-09-18 02:01:27 +02:00
|
|
|
$ make
|
|
|
|
|
|
|
|
$ sudo make install
|
|
|
|
|
|
|
|
|
|
|
|
Usage
|
|
|
|
-----
|
|
|
|
|
2008-03-01 19:49:39 +01:00
|
|
|
$ superiotool [-d] [-e] [-l] [-V] [-v] [-h]
|
2007-09-18 02:01:27 +02:00
|
|
|
|
2007-11-17 18:13:52 +01:00
|
|
|
-d | --dump Dump Super I/O register contents
|
2008-03-01 19:49:39 +01:00
|
|
|
-e | --extra-dump Dump secondary registers too (e.g. EC registers)
|
2008-01-18 19:04:28 +01:00
|
|
|
-l | --list-supported Show the list of supported Super I/O chips
|
2007-09-21 01:57:44 +02:00
|
|
|
-V | --verbose Verbose mode
|
|
|
|
-v | --version Show the superiotool version
|
|
|
|
-h | --help Show a short help text
|
2007-09-19 18:26:18 +02:00
|
|
|
|
|
|
|
Per default (no options) superiotool will just probe for a Super I/O
|
2007-10-01 15:39:02 +02:00
|
|
|
and print its vendor, name, ID, revision, and config port.
|
2007-09-19 18:26:18 +02:00
|
|
|
|
|
|
|
Typical usage of superiotool:
|
|
|
|
|
|
|
|
- Probe/detect the Super I/O in your mainboard:
|
|
|
|
|
|
|
|
$ superiotool
|
|
|
|
|
2007-09-21 01:57:44 +02:00
|
|
|
- Register dump as table of hex-values of the Super I/O (if detected):
|
2007-09-19 18:26:18 +02:00
|
|
|
|
|
|
|
$ superiotool -d
|
2007-09-18 02:01:27 +02:00
|
|
|
|
|
|
|
|
|
|
|
Supported Super I/O Chips
|
|
|
|
-------------------------
|
|
|
|
|
2008-01-18 19:04:28 +01:00
|
|
|
Please see http://coreboot.org/Superiotool#Supported_devices, or type
|
|
|
|
|
|
|
|
$ superiotool -l
|
2007-09-18 02:01:27 +02:00
|
|
|
|
2007-10-07 21:10:24 +02:00
|
|
|
There's also a collection of sample register dumps from various Super I/O
|
2008-01-18 19:04:28 +01:00
|
|
|
chips on that web page. Please send further register dumps (either from a
|
2008-01-18 16:34:24 +01:00
|
|
|
proprietary BIOS and/or from coreboot) to the coreboot mailing list
|
|
|
|
(http://coreboot.org/Mailinglist).
|
2007-10-07 21:10:24 +02:00
|
|
|
|
2007-09-18 02:01:27 +02:00
|
|
|
|
|
|
|
Website and Mailing List
|
|
|
|
------------------------
|
|
|
|
|
2008-01-18 16:34:24 +01:00
|
|
|
The main website is http://coreboot.org/Superiotool.
|
2007-09-18 02:01:27 +02:00
|
|
|
|
|
|
|
For additional information, patches, and discussions, please join the
|
2008-01-18 16:34:24 +01:00
|
|
|
coreboot mailing list at http://coreboot.org/Mailinglist, where most
|
2007-09-18 02:01:27 +02:00
|
|
|
superiotool developers are subscribed.
|
|
|
|
|
|
|
|
|
|
|
|
Copyright and License
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
Superiotool is copyrighted by a number of individual developers. Please
|
|
|
|
refer to the respective source code files for details.
|
|
|
|
|
|
|
|
It is licensed under the terms of the GNU General Public License (GPL),
|
2008-01-18 19:04:28 +01:00
|
|
|
either version 2 of the license, or (at your option) any later version.
|
2007-09-18 02:01:27 +02:00
|
|
|
|
2007-10-07 21:10:24 +02:00
|
|
|
|
|
|
|
Contributors
|
|
|
|
------------
|
|
|
|
|
2008-01-19 10:43:48 +01:00
|
|
|
Bingxun Shi <bingxunshi@gmail.com>
|
2007-10-07 21:10:24 +02:00
|
|
|
Carl-Daniel Hailfinger <c-d.hailfinger.devel.2006@gmx.net>
|
|
|
|
David Hendricks <david.hendricks@gmail.com>
|
2007-11-29 03:43:50 +01:00
|
|
|
Frieder Ferlemann <Frieder.Ferlemann@web.de>
|
|
|
|
Idwer Vollering <idwer_v@hotmail.com>
|
2007-10-07 21:10:24 +02:00
|
|
|
Rasmus Wiman <rasmus@wiman.org>
|
|
|
|
Robinson P. Tryon <bishop.robinson@gmail.com>
|
2008-02-25 23:32:41 +01:00
|
|
|
Ronald Hoogenboom <hoogenboom30@zonnet.nl>
|
2007-10-07 21:10:24 +02:00
|
|
|
Ronald Minnich <rminnich@gmail.com>
|
|
|
|
Stefan Reinauer <stepan@coresystems.de>
|
2007-11-29 03:43:50 +01:00
|
|
|
Ulf Jordan <jordan@chalmers.se>
|
2007-10-07 21:10:24 +02:00
|
|
|
Uwe Hermann <uwe@hermann-uwe.de>
|
|
|
|
Ward Vandewege <ward@gnu.org>
|