Blame view

Documentation/i2c/busses/i2c-i801 5.97 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
  Kernel driver i2c-i801
  
  Supported adapters:
    * Intel 82801AA and 82801AB (ICH and ICH0 - part of the
      '810' and '810E' chipsets)
    * Intel 82801BA (ICH2 - part of the '815E' chipset)
    * Intel 82801CA/CAM (ICH3)
7edcb9abb   Oleg Ryjkov   i2c-i801: Use the...
8
9
    * Intel 82801DB (ICH4) (HW PEC supported)
    * Intel 82801EB/ER (ICH5) (HW PEC supported)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
10
11
    * Intel 6300ESB
    * Intel 82801FB/FR/FW/FRW (ICH6)
a980a99ae   Jason Gaston   i2c: i2c-i801 doc...
12
13
14
    * Intel 82801G (ICH7)
    * Intel 631xESB/632xESB (ESB2)
    * Intel 82801H (ICH8)
d28dc7112   Gaston, Jason D   i2c-i801: Add sup...
15
    * Intel 82801I (ICH9)
c429a247f   Seth Heasley   i2c-i801: Add sup...
16
17
    * Intel EP80579 (Tolapai)
    * Intel 82801JI (ICH10)
e30d9859c   Seth Heasley   i2c-i801: Add Int...
18
    * Intel 5/3400 Series (PCH)
662cda8ab   Seth Heasley   i2c-i801: SMBus p...
19
    * Intel 6 Series (PCH)
e30d9859c   Seth Heasley   i2c-i801: Add Int...
20
    * Intel Patsburg (PCH)
662cda8ab   Seth Heasley   i2c-i801: SMBus p...
21
    * Intel DH89xxCC (PCH)
6e2a851e7   Seth Heasley   i2c-i801: SMBus p...
22
    * Intel Panther Point (PCH)
062737fb6   Seth Heasley   i2c-i801: Add dev...
23
    * Intel Lynx Point (PCH)
4a8f1ddde   James Ralston   i2c-i801: Add Dev...
24
    * Intel Lynx Point-LP (PCH)
c2db409cb   Seth Heasley   i2c: i801: SMBus ...
25
    * Intel Avoton (SOC)
a3fc0ff00   James Ralston   i2c: i801: Add De...
26
    * Intel Wellsburg (PCH)
f39901c1b   Seth Heasley   i2c: i801: SMBus ...
27
    * Intel Coleto Creek (PCH)
b299de839   Jean Delvare   i2c: i801: Add de...
28
    * Intel Wildcat Point (PCH)
afc659241   James Ralston   i2c: i801: Add De...
29
    * Intel Wildcat Point-LP (PCH)
1b31e9b76   Chew, Kean ho   i2c: i801: enable...
30
    * Intel BayTrail (SOC)
3e27a8445   james.d.ralston@intel.com   i2c: i801: Add De...
31
    * Intel Sunrise Point-H (PCH)
3eee1799a   Devin Ryles   i2c: i801: Add De...
32
    * Intel Sunrise Point-LP (PCH)
2b630df72   Jarkko Nikula   i2c: i801: Docume...
33
34
    * Intel DNV (SOC)
    * Intel Broxton (SOC)
cdc5a3110   Alexandra Yates   i2c: i801: add In...
35
    * Intel Lewisburg (PCH)
e07bc679f   Jason Gaston   i2c-i801: Add sup...
36
     Datasheets: Publicly available at the Intel website
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
37

55fee8d7f   David Woodhouse   i2c-i801: Add PCI...
38
39
  On Intel Patsburg and later chipsets, both the normal host SMBus controller
  and the additional 'Integrated Device Function' controllers are supported.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
40
  Authors: 
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
41
  	Mark Studebaker <mdsxyz123@yahoo.com>
7c81c60f3   Jean Delvare   Update Jean Delva...
42
  	Jean Delvare <jdelvare@suse.de>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
43
44
45
46
  
  
  Module Parameters
  -----------------
adff687d8   Jean Delvare   i2c-i801: Let the...
47
48
49
50
  * disable_features (bit vector)
  Disable selected features normally supported by the device. This makes it
  possible to work around possible driver or hardware bugs if the feature in
  question doesn't work as intended for whatever reason. Bit values:
636752bcb   Daniel Kurtz   i2c-i801: Enable ...
51
52
53
54
   0x01  disable SMBus PEC
   0x02  disable the block buffer
   0x08  disable the I2C block read functionality
   0x10  don't use interrupts
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
55
56
57
58
59
60
  
  
  Description
  -----------
  
  The ICH (properly known as the 82801AA), ICH0 (82801AB), ICH2 (82801BA),
c429a247f   Seth Heasley   i2c-i801: Add sup...
61
  ICH3 (82801CA/CAM) and later devices (PCH) are Intel chips that are a part of
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
  Intel's '810' chipset for Celeron-based PCs, '810E' chipset for
  Pentium-based PCs, '815E' chipset, and others.
  
  The ICH chips contain at least SEVEN separate PCI functions in TWO logical
  PCI devices. An output of lspci will show something similar to the
  following:
  
    00:1e.0 PCI bridge: Intel Corporation: Unknown device 2418 (rev 01)
    00:1f.0 ISA bridge: Intel Corporation: Unknown device 2410 (rev 01)
    00:1f.1 IDE interface: Intel Corporation: Unknown device 2411 (rev 01)
    00:1f.2 USB Controller: Intel Corporation: Unknown device 2412 (rev 01)
    00:1f.3 Unknown class [0c05]: Intel Corporation: Unknown device 2413 (rev 01)
  
  The SMBus controller is function 3 in device 1f. Class 0c05 is SMBus Serial
  Controller.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
77
78
  The ICH chips are quite similar to Intel's PIIX4 chip, at least in the
  SMBus controller.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
79
80
81
82
83
84
85
86
87
  
  Process Call Support
  --------------------
  
  Not supported.
  
  
  I2C Block Read Support
  ----------------------
6342064ca   Jean Delvare   i2c-i801: Impleme...
88
  I2C block read is supported on the 82801EB (ICH5) and later chips.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
89
90
91
92
93
94
  
  
  SMBus 2.0 Support
  -----------------
  
  The 82801DB (ICH4) and later chips support several SMBus 2.0 features.
099ab118b   Jean Delvare   i2c-i801: Documen...
95

636752bcb   Daniel Kurtz   i2c-i801: Enable ...
96
97
98
99
  Interrupt Support
  -----------------
  
  PCI interrupt support is supported on the 82801EB (ICH5) and later chips.
099ab118b   Jean Delvare   i2c-i801: Documen...
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
  Hidden ICH SMBus
  ----------------
  
  If your system has an Intel ICH south bridge, but you do NOT see the
  SMBus device at 00:1f.3 in lspci, and you can't figure out any way in the
  BIOS to enable it, it means it has been hidden by the BIOS code. Asus is
  well known for first doing this on their P4B motherboard, and many other
  boards after that. Some vendor machines are affected as well.
  
  The first thing to try is the "i2c_ec" ACPI driver. It could be that the
  SMBus was hidden on purpose because it'll be driven by ACPI. If the
  i2c_ec driver works for you, just forget about the i2c-i801 driver and
  don't try to unhide the ICH SMBus. Even if i2c_ec doesn't work, you
  better make sure that the SMBus isn't used by the ACPI code. Try loading
  the "fan" and "thermal" drivers, and check in /proc/acpi/fan and
  /proc/acpi/thermal_zone. If you find anything there, it's likely that
  the ACPI is accessing the SMBus and it's safer not to unhide it. Only
  once you are certain that ACPI isn't using the SMBus, you can attempt
  to unhide it.
  
  In order to unhide the SMBus, we need to change the value of a PCI
  register before the kernel enumerates the PCI devices. This is done in
  drivers/pci/quirks.c, where all affected boards must be listed (see
  function asus_hides_smbus_hostbridge.) If the SMBus device is missing,
  and you think there's something interesting on the SMBus (e.g. a
  hardware monitoring chip), you need to add your board to the list.
  
  The motherboard is identified using the subvendor and subdevice IDs of the
  host bridge PCI device. Get yours with "lspci -n -v -s 00:00.0":
  
  00:00.0 Class 0600: 8086:2570 (rev 02)
          Subsystem: 1043:80f2
          Flags: bus master, fast devsel, latency 0
          Memory at fc000000 (32-bit, prefetchable) [size=32M]
          Capabilities: [e4] #09 [2106]
          Capabilities: [a0] AGP version 3.0
  
  Here the host bridge ID is 2570 (82865G/PE/P), the subvendor ID is 1043
  (Asus) and the subdevice ID is 80f2 (P4P800-X). You can find the symbolic
  names for the bridge ID and the subvendor ID in include/linux/pci_ids.h,
  and then add a case for your subdevice ID at the right place in
  drivers/pci/quirks.c. Then please give it very good testing, to make sure
  that the unhidden SMBus doesn't conflict with e.g. ACPI.
  
  If it works, proves useful (i.e. there are usable chips on the SMBus)
  and seems safe, please submit a patch for inclusion into the kernel.
  
  Note: There's a useful script in lm_sensors 2.10.2 and later, named
  unhide_ICH_SMBus (in prog/hotplug), which uses the fakephp driver to
  temporarily unhide the SMBus without having to patch and recompile your
  kernel. It's very convenient if you just want to check if there's
  anything interesting on your hidden ICH SMBus.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
152
153
154
155
156
157
  **********************
  The lm_sensors project gratefully acknowledges the support of Texas
  Instruments in the initial development of this driver.
  
  The lm_sensors project gratefully acknowledges the support of Intel in the
  development of SMBus 2.0 / ICH4 features of this driver.