Uwe Hermann | d8a18a2 | 2007-09-18 00:01:27 +0000 | [diff] [blame] | 1 | ------------------------------------------------------------------------------- |
| 2 | Superiotool README |
| 3 | ------------------------------------------------------------------------------- |
| 4 | |
| 5 | Superiotool is a user-space utility which can |
| 6 | |
| 7 | - detect which Super I/O chip is soldered onto your mainboard, |
| 8 | |
| 9 | - at which configuration port it's located (usually 0x2e or 0x4e), and |
| 10 | |
| 11 | - dump all register contents of the Super I/O chip, together with the |
| 12 | default values as per datasheet (to make comparing the values easy). |
| 13 | |
| 14 | It is mainly used for LinuxBIOS development purposes (see linuxbios.org |
| 15 | for details on LinuxBIOS), but it may also be useful for other things. |
| 16 | |
| 17 | |
| 18 | Installation |
| 19 | ------------ |
| 20 | |
| 21 | $ svn co svn://linuxbios.org/repos/trunk/util/superiotool |
| 22 | |
| 23 | $ make |
| 24 | |
| 25 | $ sudo make install |
| 26 | |
| 27 | |
| 28 | Usage |
| 29 | ----- |
| 30 | |
Uwe Hermann | eddc473 | 2007-09-20 23:57:44 +0000 | [diff] [blame] | 31 | $ superiotool [-d] [-D] [-V] [-v] [-h] |
Uwe Hermann | d8a18a2 | 2007-09-18 00:01:27 +0000 | [diff] [blame] | 32 | |
Uwe Hermann | eddc473 | 2007-09-20 23:57:44 +0000 | [diff] [blame] | 33 | -d | --dump Dump Super I/O registers |
| 34 | -D | --dump-readable Dump Super I/O registers in human-readable format |
| 35 | -V | --verbose Verbose mode |
| 36 | -v | --version Show the superiotool version |
| 37 | -h | --help Show a short help text |
Uwe Hermann | e474956 | 2007-09-19 16:26:18 +0000 | [diff] [blame] | 38 | |
| 39 | Per default (no options) superiotool will just probe for a Super I/O |
Uwe Hermann | e4d4eba | 2007-10-01 13:39:02 +0000 | [diff] [blame] | 40 | and print its vendor, name, ID, revision, and config port. |
Uwe Hermann | e474956 | 2007-09-19 16:26:18 +0000 | [diff] [blame] | 41 | |
| 42 | Typical usage of superiotool: |
| 43 | |
| 44 | - Probe/detect the Super I/O in your mainboard: |
| 45 | |
| 46 | $ superiotool |
| 47 | |
Uwe Hermann | eddc473 | 2007-09-20 23:57:44 +0000 | [diff] [blame] | 48 | - Register dump as table of hex-values of the Super I/O (if detected): |
Uwe Hermann | e474956 | 2007-09-19 16:26:18 +0000 | [diff] [blame] | 49 | |
| 50 | $ superiotool -d |
Uwe Hermann | d8a18a2 | 2007-09-18 00:01:27 +0000 | [diff] [blame] | 51 | |
Uwe Hermann | eddc473 | 2007-09-20 23:57:44 +0000 | [diff] [blame] | 52 | - Detailed register dump in human-readable format: |
| 53 | |
| 54 | $ superiotool -D |
| 55 | |
Uwe Hermann | d8a18a2 | 2007-09-18 00:01:27 +0000 | [diff] [blame] | 56 | |
| 57 | Supported Super I/O Chips |
| 58 | ------------------------- |
| 59 | |
| 60 | Please see http://linuxbios.org/Superiotool#Supported_devices. |
| 61 | |
Uwe Hermann | 84bf1e2 | 2007-10-07 19:10:24 +0000 | [diff] [blame] | 62 | There's also a collection of sample register dumps from various Super I/O |
| 63 | chips on that page. Please send further register dumps (either from a |
| 64 | proprietary BIOS and/or from LinuxBIOS) to the LinuxBIOS mailing list |
| 65 | (http://linuxbios.org/Mailinglist). |
| 66 | |
Uwe Hermann | d8a18a2 | 2007-09-18 00:01:27 +0000 | [diff] [blame] | 67 | |
| 68 | Website and Mailing List |
| 69 | ------------------------ |
| 70 | |
| 71 | The main website is http://linuxbios.org/Superiotool. |
| 72 | |
| 73 | For additional information, patches, and discussions, please join the |
| 74 | LinuxBIOS mailing list at http://linuxbios.org/Mailinglist, where most |
| 75 | superiotool developers are subscribed. |
| 76 | |
| 77 | |
| 78 | Copyright and License |
| 79 | --------------------- |
| 80 | |
| 81 | Superiotool is copyrighted by a number of individual developers. Please |
| 82 | refer to the respective source code files for details. |
| 83 | |
| 84 | It is licensed under the terms of the GNU General Public License (GPL), |
| 85 | either version 2 of the License, or (at your option) any later version. |
| 86 | |
Uwe Hermann | 84bf1e2 | 2007-10-07 19:10:24 +0000 | [diff] [blame] | 87 | |
| 88 | Contributors |
| 89 | ------------ |
| 90 | |
| 91 | Carl-Daniel Hailfinger <c-d.hailfinger.devel.2006@gmx.net> |
| 92 | David Hendricks <david.hendricks@gmail.com> |
| 93 | Rasmus Wiman <rasmus@wiman.org> |
| 94 | Robinson P. Tryon <bishop.robinson@gmail.com> |
| 95 | Ronald Minnich <rminnich@gmail.com> |
| 96 | Stefan Reinauer <stepan@coresystems.de> |
| 97 | Uwe Hermann <uwe@hermann-uwe.de> |
| 98 | Ward Vandewege <ward@gnu.org> |
| 99 | |