Documentation/i2c/busses/i2c-piix4

   1 Kernel driver i2c-piix4
   2
   3 Supported adapters:
   4   * Intel 82371AB PIIX4 and PIIX4E
   5   * Intel 82443MX (440MX)
   6     Datasheet: Publicly available at the Intel website
   7   * ServerWorks OSB4, CSB5, CSB6 and HT-1000 southbridges
   8     Datasheet: Only available via NDA from ServerWorks
   9   * ATI IXP southbridges IXP200, IXP300, IXP400
  10     Datasheet: Not publicly available
  11   * Standard Microsystems (SMSC) SLC90E66 (Victory66) southbridge
  12     Datasheet: Publicly available at the SMSC website http://www.smsc.com
  13
  14 Authors:
  15         Frodo Looijaard <frodol@dds.nl>
  16         Philip Edelbrock <phil@netroedge.com>
  17
  18
  19 Module Parameters
  20 -----------------
  21
  22 * force: int
  23   Forcibly enable the PIIX4. DANGEROUS!
  24 * force_addr: int
  25   Forcibly enable the PIIX4 at the given address. EXTREMELY DANGEROUS!
  26 * fix_hstcfg: int
  27   Fix config register. Needed on some boards (Force CPCI735).
  28
  29
  30 Description
  31 -----------
  32
  33 The PIIX4 (properly known as the 82371AB) is an Intel chip with a lot of
  34 functionality. Among other things, it implements the PCI bus. One of its
  35 minor functions is implementing a System Management Bus. This is a true
  36 SMBus - you can not access it on I2C levels. The good news is that it
  37 natively understands SMBus commands and you do not have to worry about
  38 timing problems. The bad news is that non-SMBus devices connected to it can
  39 confuse it mightily. Yes, this is known to happen...
  40
  41 Do 'lspci -v' and see whether it contains an entry like this:
  42
  43 0000:00:02.3 Bridge: Intel Corp. 82371AB/EB/MB PIIX4 ACPI (rev 02)
  44              Flags: medium devsel, IRQ 9
  45
  46 Bus and device numbers may differ, but the function number must be
  47 identical (like many PCI devices, the PIIX4 incorporates a number of
  48 different 'functions', which can be considered as separate devices). If you
  49 find such an entry, you have a PIIX4 SMBus controller.
  50
  51 On some computers (most notably, some Dells), the SMBus is disabled by
  52 default. If you use the insmod parameter 'force=1', the kernel module will
  53 try to enable it. THIS IS VERY DANGEROUS! If the BIOS did not set up a
  54 correct address for this module, you could get in big trouble (read:
  55 crashes, data corruption, etc.). Try this only as a last resort (try BIOS
  56 updates first, for example), and backup first! An even more dangerous
  57 option is 'force_addr=<IOPORT>'. This will not only enable the PIIX4 like
  58 'force' foes, but it will also set a new base I/O port address. The SMBus
  59 parts of the PIIX4 needs a range of 8 of these addresses to function
  60 correctly. If these addresses are already reserved by some other device,
  61 you will get into big trouble! DON'T USE THIS IF YOU ARE NOT VERY SURE
  62 ABOUT WHAT YOU ARE DOING!
  63
  64 The PIIX4E is just an new version of the PIIX4; it is supported as well.
  65 The PIIX/PIIX3 does not implement an SMBus or I2C bus, so you can't use
  66 this driver on those mainboards.
  67
  68 The ServerWorks Southbridges, the Intel 440MX, and the Victory766 are
  69 identical to the PIIX4 in I2C/SMBus support.
  70
  71 A few OSB4 southbridges are known to be misconfigured by the BIOS. In this
  72 case, you have you use the fix_hstcfg module parameter. Do not use it
  73 unless you know you have to, because in some cases it also breaks
  74 configuration on southbridges that don't need it.