SUPERIOTOOL(8)

💖 SUPERIOTOOL(8) 💖

okay bestie, so this is superiotool from the System Manager's Manual section 8, and honestly? she's a little legend. let's get into it 🫶

---

✨ NAME ✨

superiotool — the Super I/O detection tool 🌸

---

🦋 SYNOPSIS 🦋

superiotool [-delVvh]

that's it. that's the whole vibe. short, iconic, no notes 💅

---

👑 DESCRIPTION 👑

okay so superiotool is a GPL'd user-space utility, and here's the tea on what she can do:

• detect which Super I/O chip is soldered onto your mainboard 🔍
• figure out at which configuration port it's located (usually 0x2e or 0x4e, iykyk)
• dump all register contents of the Super I/O chip, together with the default values as per datasheet (so comparing the values is easy peasy, you're welcome 💖)

she's mainly used for coreboot development purposes (peep coreboot.org for all the details on coreboot), but ngl she may also be useful for other things. versatile queen.

the list of supported Super I/O chips lives at https://coreboot.org/Superiotool#Supported_devices, but you can also just run superiotool -l and see it right there. main character energy fr fr ✨

---

💅 OPTIONS 💅

heads up bestie: if you don't pass any command line option, superiotool merely tries to detect the Super I/O chip. if you actually want the register contents dumped, you must use the -d option. no -d, no dump, periodt.

• -d, --dump — dump Super I/O registers (but only if the Super I/O chip is detected and superiotool supports the --dump option for this chip). the output will look something like this:

$ superiotool -d
Found SMSC FDC37N769 (id=0x28, rev=0x01) at 0x3f0
Register dump:
idx 00 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10 11...
val 20 90 80 f4 00 00 ff 00 00 00 40 00 0e 28 01 00 00 00...
def 28 9c 88 70 00 00 ff 00 00 00 00 00 02 28 NA 00 00 80...

so like, decoding this: the idx fields contain the register numbers/indexes of the Super I/O, the val fields contain the contents of the respective register as read from the Super I/O, and the def fields contain the default values for the respective register, as specified in the datasheet. she's giving full transparency 💖

the numbers in the output are all in hex format, and some special values may also occur: NA stands for not available (i.e., the datasheet doesn't specify a default value for the respective register), RR means reserved (the datasheet explicitly marks this register as reserved), and MM means misc, which can mean several things. it's recommended to consult the datasheet for detailed information about the MM fields. don't guess on the misc ones, bestie, go read the datasheet 🙈

• -e, --extra-dump — dump extra secondary register contents too, if available. only in combination with the --dump option, okay? this option will, for instance, dump the environmental controller (EC) configuration registers for the ITE IT8716F chip. the format is similar to the output of the --dump option. extra data, extra slay ✨
• -l, --list-supported — list all Super I/O chips recognized by superiotool. the phrase (dump available) following a chip name indicates that superiotool supports the --dump option for this chip. so if you see it, you know she's got you 👑
• -V, --verbose — enable verbose mode. can be used together with the -d option. the verbose output will not only list for which type of Super I/O the tool is scanning, but also at which configuration port it's probing, and which Super I/O initialization sequence is used. and if no Super I/O was detected in a probing run, the returned output will be shown, as it may be useful for figuring out which (currently unrecognized) Super I/O chip this may be. detective mode activated 🔍
• -v, --version — show version information and exit. quick lil flex, then she's out 🎀
• -h, --help — show a help text and exit. your girl's got your back 🫶

---

😭 BUGS 😭

please report any bugs on the coreboot mailing list (https://coreboot.org/Mailinglist). be nice, they're doing their best 💜

---

🌈 AUTHORS 🌈

please see the individual source code files and/or the README file. the receipts are all there, bestie ✨

---

💖 LICENCE 💖

superiotool is covered by the GNU General Public License (GPL), either version 2 of the License, or (at your option) any later version. free software, free love, fr fr 🌸

---

🔥 SEE ALSO 🔥

sensors-detect(8)

---

okay and that's the whole page!! shoutout to the OG — this one's from January 18, 2008, the absolute vintage era, and it's still out here detecting Super I/O chips like a legend. mwah 💋 stay curious, bestie, and always read the datasheet 💅✨