coreboot-kgpe-d16/util/superiotool
Guenter Roeck 21856eec59 superiotool: Dump data registers for Nuvoton chips
Add support to dump all data registers for Nuvoton chips (NCT6775F, NCT6776F,
and NCT6779D). Register contents will be dumped if the -e option is provided on
the command line.

Change-Id: I2b425b48c1f28a10ff3c1ca1d7f21c501eff74ad
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
Reviewed-on: http://review.coreboot.org/1150
Tested-by: build bot (Jenkins)
Reviewed-by: Patrick Georgi <patrick@georgi-clan.de>
2012-07-12 08:13:21 +02:00
..
COPYING
Makefile superiotool: Add support for git-based version number 2012-07-06 10:21:03 +02:00
README Document CONFIG_PCI usage in the README (trivial). 2010-01-24 17:29:38 +00:00
ali.c The Winbond Super I/O chips have another indirection of registers. The 2008-12-01 14:18:57 +00:00
amd.c remove trailing whitespace 2011-11-01 19:07:45 +01:00
fintek.c Add Fintek F71889 detection and dump support. 2010-11-29 11:56:39 +00:00
infineon.c superiotool: add detection and dump of Infineon SLB9635 TPM 2011-11-07 22:05:21 +01:00
ite.c tell superiotool about the ITE 8772 2012-03-10 08:47:06 +01:00
nsc.c Add support for the NSC PC87364 Super I/O. 2011-03-06 17:58:31 +00:00
nuvoton.c superiotool: Dump data registers for Nuvoton chips 2012-07-12 08:13:21 +02:00
pci.c Add missing files from the last commit (trivial). 2010-01-24 01:47:58 +00:00
serverengines.c Add detection/dump support for ServerEngines SE-SM 4210-P01. 2011-04-11 07:46:27 +00:00
smsc.c Avoid false detection of SMSC FDC37N972 when Infineon TPM is present 2011-11-07 18:15:41 +01:00
superiotool.8 Since some people disapprove of white space cleanups mixed in regular commits 2010-04-27 06:56:47 +00:00
superiotool.c superiotool: Add support for function to dump superio chip data registers 2012-07-12 08:13:13 +02:00
superiotool.h superiotool: Add support for function to dump superio chip data registers 2012-07-12 08:13:13 +02:00
via.c Add missing files from the last commit (trivial). 2010-01-24 01:47:58 +00:00
winbond.c superiotool: Cosmetics and coding style fixes. 2011-06-09 21:26:47 +02: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 coreboot development purposes (see coreboot.org
for details on coreboot), but it may also be useful for other things.


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

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

 $ cd superiotool

Optional: Edit the Makefile and set 'CONFIG_PCI = no' if you don't want to
support PCI-attached "Super I/Os" (which needs libpci-dev) such as the
VIA VT82686A/B southbridge with integrated Super I/O functionality.

 $ make

 $ sudo make install


Usage
-----

Please read the superiotool(8) manpage or type 'superiotool --help'.

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

Typical usage of superiotool:

 - Probe/detect the Super I/O in your mainboard:

   $ superiotool

 - Register dump as table of hex-values of the Super I/O (if detected):

   $ superiotool -d


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

Please see http://coreboot.org/Superiotool#Supported_devices, or type

 $ superiotool -l

There's also a collection of sample register dumps from various Super I/O
chips on that web page. Please send further register dumps (either from a
proprietary BIOS and/or from coreboot) to the coreboot mailing list
(http://coreboot.org/Mailinglist).


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

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

For additional information, patches, and discussions, please join the
coreboot mailing list at http://coreboot.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.


Contributors
------------

Anders Juel Jensen <andersjjensen@gmail.com>
Andriy Gapon <avg@icyb.net.ua>
Arjan Koers <0h3q2rmn2bdb@list.nospam.xutrox.com>
Bingxun Shi <bingxunshi@gmail.com>
Carl-Daniel Hailfinger <c-d.hailfinger.devel.2006@gmx.net>
David Bartley <dtbartle@csclub.uwaterloo.ca>
David Hendricks <david.hendricks@gmail.com>
François-Regis Vuillemin <coreboot@miradou.com>
Frieder Ferlemann <Frieder.Ferlemann@web.de>
Idwer Vollering <idwer_v@hotmail.com>
Ioannis Barkas <tripl3fault@yahoo.com>
Josh Profitt <zorn169@gmail.com>
Luc Verhaegen <libv@skynet.be>
Michael Gold <mgold@ncf.ca>
Michał Mirosław <mirq-linux@rere.qmqm.pl>
Nikos Barkas <levelwol@gmail.com>
Rasmus Wiman <rasmus@wiman.org>
Robinson P. Tryon <bishop.robinson@gmail.com>
Ronald Hoogenboom <hoogenboom30@zonnet.nl>
Ronald Minnich <rminnich@gmail.com>
Sean Young <sean@mess.org>
Stefan Reinauer <stepan@coresystems.de>
Tom Sylla <tsylla@gmail.com>
Ulf Jordan <jordan@chalmers.se>
Urja Rannikko <urjaman@gmail.com>
Uwe Hermann <uwe@hermann-uwe.de>
Ward Vandewege <ward@gnu.org>