Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SUPERIOTOOL(8)		    System Manager's Manual		SUPERIOTOOL(8)

NAME
       superiotool - Super I/O detection tool

SYNOPSIS
       superiotool [-delVvh]

DESCRIPTION
       superiotool is a	GPL'd 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.

       The list	of supported Super I/O chips  is  available  at	 https://core-
       boot.org/Superiotool#Supported_devices,	but  it	 can also be viewed by
       running superiotool -l.

OPTIONS
       If no command line option is specified, superiotool merely tries	to de-
       tect the	Super I/O chip.	 You must use the -d option to dump the	 Super
       I/O register contents.

       -d, --dump
	      Dump  Super I/O registers	(if the	Super I/O chip is detected and
	      superiotool supports the --dump option for this chip). The  out-
	      put 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...

	      The idx fields contain the register numbers/indexes of the Super
	      I/O,  the	val fields contain the contents	of the respective reg-
	      ister as read from the Super I/O,	and the	def fields contain the
	      default values for the respective	register, as specified in  the
	      datasheet.

	      The  numbers  in the output are all in hex format, and some spe-
	      cial 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.

       -e, --extra-dump
	      Dump extra secondary register contents too, if  available.  Only
	      in combination with the --dump option. This option will, for in-
	      stance,  dump  the  environmental	 controller (EC) configuration
	      registers	for the	ITE IT8716F chip. The format is	similar	to the
	      output of	the --dump option.

       -l, --list-supported
	      List all Super I/O chips recognized by superiotool.  The	phrase
	      (dump  available)	 following  a chip name	indicates that superi-
	      otool supports the --dump	option for this	chip.

       -V, --verbose
	      Enable verbose mode. This	option 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. If no Super	I/O was	detected in a  probing	run,  the  re-
	      turned  output  will  be shown, as it may	be useful for figuring
	      out which	(currently unrecognized) Super I/O chip	this may be.

       -v, --version
	      Show version information and exit.

       -h, --help
	      Show a help text and exit.

BUGS
       Please report any bugs on  the  coreboot	 mailing  list	(https://core-
       boot.org/Mailinglist).

AUTHORS
       Please see the individual source	code files and/or the README file.

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

SEE ALSO
       sensors-detect(8)

			       January 18, 2008			SUPERIOTOOL(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=superiotool&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help