coreboot-kgpe-d16/util/superiotool
Uwe Hermann 3acf31e4ea Further code simplifications and improvements.
Add command line option handling code. The following options
are defined at the moment:

-d|--dump      Dump Super I/O registers.
-V|--verbose   Verbose mode.
-v|--version   Show the superiotool version.
-h|--help      Show a short help text.

Per default (no options) we just probe for a Super I/O
and print its vendor, name, ID, version, and config port.

Example:

$ ./superiotool
Found SMSC FDC37N769 Super I/O (id=0x28, rev=0x01) at port=0x03f0

$ ./superiotool -d
Found SMSC FDC37N769 Super I/O (id=0x28, rev=0x01) at port=0x03f0
idx 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11 12 13 14 15 16 17 18 19 1a 1b 1c 1d 1e 1f 20 21 22 23 24 25 26 27 28 29 2a 2b 2c 2d 2e 2f
val 20 90 80 f4 00 00 ff 00 00 00 40 00 0e 28 01 00 00 00 00 00 02 00 01 03 00 00 00 00 00 00 80 00 00 00 00 00 00 ba 00 00 03 00 00 23 03 03 00 00
def 28 9c 88 70 00 00 ff 00 00 00 00 00 02 28 NA 00 00 80 RR RR NA NA NA 03 RR RR RR RR RR RR 80 00 3c RR RR 00 00 00 00 00 00 00 RR 00 00 03 00 00

$ ./superiotool -s
./superiotool: invalid option -- s

$ ./superiotool -h
Usage: superiotool [-d] [-V] [-v] [-h]

$ ./superiotool -v
superiotool 0.1


Signed-off-by: Uwe Hermann <uwe@hermann-uwe.de>
Acked-by: Uwe Hermann <uwe@hermann-uwe.de>



git-svn-id: svn://svn.coreboot.org/coreboot/trunk@2788 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2007-09-19 01:55:35 +00:00
..
Makefile Use uint16_t and friends where appropriate (trivial). 2007-09-19 00:03:14 +00:00
README Add a README for superiotool (trivial). 2007-09-18 00:01:27 +00:00
fintek.c Further code simplifications and improvements. 2007-09-19 01:55:35 +00:00
ite.c Further code simplifications and improvements. 2007-09-19 01:55:35 +00:00
nsc.c Further code simplifications and improvements. 2007-09-19 01:55:35 +00:00
smsc.c Further code simplifications and improvements. 2007-09-19 01:55:35 +00:00
superiotool.c Further code simplifications and improvements. 2007-09-19 01:55:35 +00:00
superiotool.h Further code simplifications and improvements. 2007-09-19 01:55:35 +00:00

README

-------------------------------------------------------------------------------
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).

It is mainly used for LinuxBIOS development purposes (see linuxbios.org
for details on LinuxBIOS), but it may also be useful for other things.


Installation
------------

 $ svn co svn://linuxbios.org/repos/trunk/util/superiotool

 $ make

 $ sudo make install


Usage
-----

 $ superiotool

Currently the tool will automatically try to detect which Super I/O you
have, and also dump the register contents.


Supported Super I/O Chips
-------------------------

Please see http://linuxbios.org/Superiotool#Supported_devices.


Website and Mailing List
------------------------

The main website is http://linuxbios.org/Superiotool.

For additional information, patches, and discussions, please join the
LinuxBIOS mailing list at http://linuxbios.org/Mailinglist, where most
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),
either version 2 of the License, or (at your option) any later version.