coreboot-kgpe-d16/util/superiotool
Urja Rannikko 38204a2c18 Add support for the ITE IT8661F/IT8770F, IT8673F, and IT8671F/IT8687R.
They all use a different init sequence than the more modern ITE Super I/Os.

For now we only use 0x370 as config port, but 0x3f0 or 0x3bd would also be
valid. Contrary to other Super I/Os, the config port for these is _not_
hardcoded via hardware, instead it can be programmed by software, i.e.
you get to choose whether you want to use 0x370, 0x3f0, or 0x3bd.

Tested on IT8671F by Uwe Hermann and on IT8770F by Urja Rannikko.

Signed-off-by: Urja Rannikko <urjaman@gmail.com>
Signed-off-by: Uwe Hermann <uwe@hermann-uwe.de>
Acked-by: Urja Rannikko <urjaman@gmail.com>
Acked-by: Uwe Hermann <uwe@hermann-uwe.de>



git-svn-id: svn://svn.coreboot.org/coreboot/trunk@3692 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2008-10-23 23:33:18 +00:00
..
COPYING Add a copy of the GPL (trivial). 2007-10-03 18:56:51 +00:00
Makefile Various smaller fixes in superiotool: 2008-03-17 13:43:48 +00:00
README Add support for the ITE IT8661F/IT8770F, IT8673F, and IT8671F/IT8687R. 2008-10-23 23:33:18 +00:00
ali.c Drop global register 0x07 for all Super I/Os (trivial). 2008-10-14 16:34:38 +00:00
fintek.c Drop global register 0x07 for all Super I/Os (trivial). 2008-10-14 16:34:38 +00:00
ite.c Add support for the ITE IT8661F/IT8770F, IT8673F, and IT8671F/IT8687R. 2008-10-23 23:33:18 +00:00
nsc.c Add dump support for Winbond (NSC) PC87427. Dumps available from real hardware. 2008-06-07 11:36:30 +00:00
smsc.c Drop global register 0x07 for all Super I/Os (trivial). 2008-10-14 16:34:38 +00:00
superiotool.8 Small coding style fixes and documentation updates (trivial). 2008-03-01 18:49:39 +00:00
superiotool.c Add support for the ITE IT8661F/IT8770F, IT8673F, and IT8671F/IT8687R. 2008-10-23 23:33:18 +00:00
superiotool.h Add support for the ITE IT8661F/IT8770F, IT8673F, and IT8671F/IT8687R. 2008-10-23 23:33:18 +00:00
winbond.c Add register definitions for W83627HF based on publicly available 2008-10-19 21:03:41 +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 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

 $ 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
------------

Andriy Gapon <avg@icyb.net.ua>
Bingxun Shi <bingxunshi@gmail.com>
Carl-Daniel Hailfinger <c-d.hailfinger.devel.2006@gmx.net>
David Hendricks <david.hendricks@gmail.com>
Frieder Ferlemann <Frieder.Ferlemann@web.de>
Idwer Vollering <idwer_v@hotmail.com>
Josh Profitt <zorn169@gmail.com>
Rasmus Wiman <rasmus@wiman.org>
Robinson P. Tryon <bishop.robinson@gmail.com>
Ronald Hoogenboom <hoogenboom30@zonnet.nl>
Ronald Minnich <rminnich@gmail.com>
Stefan Reinauer <stepan@coresystems.de>
Ulf Jordan <jordan@chalmers.se>
Urja Rannikko <urjaman@gmail.com>
Uwe Hermann <uwe@hermann-uwe.de>
Ward Vandewege <ward@gnu.org>