| ------------------------------------------------------------------------------- |
| 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 |
| ------------ |
| |
| $ git clone http://review.coreboot.org/p/coreboot.git |
| |
| $ cd coreboot/util/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> |
| |
