i2c-ali15x3.rst 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. =========================
  2. Kernel driver i2c-ali15x3
  3. =========================
  4. Supported adapters:
  5. * Acer Labs, Inc. ALI 1533 and 1543C (south bridge)
  6. Datasheet: Now under NDA
  7. http://www.ali.com.tw/
  8. Authors:
  9. - Frodo Looijaard <[email protected]>,
  10. - Philip Edelbrock <[email protected]>,
  11. - Mark D. Studebaker <[email protected]>
  12. Module Parameters
  13. -----------------
  14. * force_addr: int
  15. Initialize the base address of the i2c controller
  16. Notes
  17. -----
  18. The force_addr parameter is useful for boards that don't set the address in
  19. the BIOS. Does not do a PCI force; the device must still be present in
  20. lspci. Don't use this unless the driver complains that the base address is
  21. not set.
  22. Example::
  23. modprobe i2c-ali15x3 force_addr=0xe800
  24. SMBus periodically hangs on ASUS P5A motherboards and can only be cleared
  25. by a power cycle. Cause unknown (see Issues below).
  26. Description
  27. -----------
  28. This is the driver for the SMB Host controller on Acer Labs Inc. (ALI)
  29. M1541 and M1543C South Bridges.
  30. The M1543C is a South bridge for desktop systems.
  31. The M1541 is a South bridge for portable systems.
  32. They are part of the following ALI chipsets:
  33. * "Aladdin Pro 2" includes the M1621 Slot 1 North bridge with AGP and
  34. 100MHz CPU Front Side bus
  35. * "Aladdin V" includes the M1541 Socket 7 North bridge with AGP and 100MHz
  36. CPU Front Side bus
  37. Some Aladdin V motherboards:
  38. - Asus P5A
  39. - Atrend ATC-5220
  40. - BCM/GVC VP1541
  41. - Biostar M5ALA
  42. - Gigabyte GA-5AX (Generally doesn't work because the BIOS doesn't
  43. enable the 7101 device!)
  44. - Iwill XA100 Plus
  45. - Micronics C200
  46. - Microstar (MSI) MS-5169
  47. * "Aladdin IV" includes the M1541 Socket 7 North bridge
  48. with host bus up to 83.3 MHz.
  49. For an overview of these chips see http://www.acerlabs.com. At this time the
  50. full data sheets on the web site are password protected, however if you
  51. contact the ALI office in San Jose they may give you the password.
  52. The M1533/M1543C devices appear as FOUR separate devices on the PCI bus. An
  53. output of lspci will show something similar to the following::
  54. 00:02.0 USB Controller: Acer Laboratories Inc. M5237 (rev 03)
  55. 00:03.0 Bridge: Acer Laboratories Inc. M7101 <= THIS IS THE ONE WE NEED
  56. 00:07.0 ISA bridge: Acer Laboratories Inc. M1533 (rev c3)
  57. 00:0f.0 IDE interface: Acer Laboratories Inc. M5229 (rev c1)
  58. .. important::
  59. If you have a M1533 or M1543C on the board and you get
  60. "ali15x3: Error: Can't detect ali15x3!"
  61. then run lspci.
  62. If you see the 1533 and 5229 devices but NOT the 7101 device,
  63. then you must enable ACPI, the PMU, SMB, or something similar
  64. in the BIOS.
  65. The driver won't work if it can't find the M7101 device.
  66. The SMB controller is part of the M7101 device, which is an ACPI-compliant
  67. Power Management Unit (PMU).
  68. The whole M7101 device has to be enabled for the SMB to work. You can't
  69. just enable the SMB alone. The SMB and the ACPI have separate I/O spaces.
  70. We make sure that the SMB is enabled. We leave the ACPI alone.
  71. Features
  72. --------
  73. This driver controls the SMB Host only. The SMB Slave
  74. controller on the M15X3 is not enabled. This driver does not use
  75. interrupts.
  76. Issues
  77. ------
  78. This driver requests the I/O space for only the SMB
  79. registers. It doesn't use the ACPI region.
  80. On the ASUS P5A motherboard, there are several reports that
  81. the SMBus will hang and this can only be resolved by
  82. powering off the computer. It appears to be worse when the board
  83. gets hot, for example under heavy CPU load, or in the summer.
  84. There may be electrical problems on this board.
  85. On the P5A, the W83781D sensor chip is on both the ISA and
  86. SMBus. Therefore the SMBus hangs can generally be avoided
  87. by accessing the W83781D on the ISA bus only.