coreboot-kgpe-d16/util/superiotool
Uwe Hermann 59b99d9071 Various small fixes (trivial).
- Add missing contributors to the README.

 - Drop obsolete -D option from manpage.

 - Only list contributors who added non-trivial amounts of code as copyright
   holders (and do not list those who merely provided register dump support
   for Super I/Os). Those contributors are still listed in the README,
   of course. See discussion in the thread starting at
   http://www.linuxbios.org/pipermail/linuxbios/2007-October/025516.html

 - Make a function static.

 - Fix incorrect URL in code comment. Drop obsolete comments.

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@2992 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2007-11-29 02:43:50 +00:00
..
COPYING Add a copy of the GPL (trivial). 2007-10-03 18:56:51 +00:00
Makefile Set the superiotool version number from svn at build time. 2007-10-13 18:06:12 +00:00
README Various small fixes (trivial). 2007-11-29 02:43:50 +00:00
ali.c Detection support for more Super I/Os. Small fixes (trivial). 2007-11-17 17:13:52 +00:00
fintek.c Drop superfluous exit_conf_mode*() calls, we don't want to call them twice. 2007-11-12 21:02:44 +00:00
ite.c Drop superfluous exit_conf_mode*() calls, we don't want to call them twice. 2007-11-12 21:02:44 +00:00
nsc.c Add dump support for the PC87366. 2007-11-24 21:49:39 +00:00
smsc.c Various small fixes (trivial). 2007-11-29 02:43:50 +00:00
superiotool.8 Various small fixes (trivial). 2007-11-29 02:43:50 +00:00
superiotool.c Various small fixes (trivial). 2007-11-29 02:43:50 +00:00
superiotool.h Detection support for more Super I/Os. Small fixes (trivial). 2007-11-17 17:13:52 +00:00
winbond.c Various small fixes (trivial). 2007-11-29 02:43:50 +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

 $ cd superiotool

 $ make

 $ sudo make install


Usage
-----

 $ superiotool [-d] [-V] [-v] [-h]

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

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://linuxbios.org/Superiotool#Supported_devices.

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


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.


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

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>
Rasmus Wiman <rasmus@wiman.org>
Robinson P. Tryon <bishop.robinson@gmail.com>
Ronald Minnich <rminnich@gmail.com>
Stefan Reinauer <stepan@coresystems.de>
Ulf Jordan <jordan@chalmers.se>
Uwe Hermann <uwe@hermann-uwe.de>
Ward Vandewege <ward@gnu.org>