RC1 2.6 busses docummentation
PATCH 1/1 RC1 2.6 busses docummentation
Hello,
Last chance for comments :)
This is fixed version (thanks Aurel)
Regads
Rudolf
Documentation/i2c/busses/i2c-ali15x3 +112 -0
@@ -0,0 +1,112 @@ +Kernel driver i2c-ali15x3 + +Supported adapters: + * Acer Labs, Inc. ALI 1533 and 1543C (south bridge) + Datasheet: Now under NDA + http://www.ali.com.tw/eng/support/datasheet_request.php + +Authors: + Frodo Looijaard <[email protected]>, + Philip Edelbrock <[email protected]>, + Mark D. Studebaker <[email protected]> + +Module Parameters +----------------- + +* force_addr: int + Initialize the base address of the i2c controller + + +Notes +----- + +The force_addr parameter is useful for boards that don't set the address in +the BIOS. Does not do a PCI force; the device must still be present in +lspci. Don't use this unless the driver complains that the base address is +not set. + +Example: 'modprobe i2c-ali15x3 force_addr=0xe800' + +SMBus periodically hangs on ASUS P5A motherboards and can only be cleared +by a power cycle. Cause unknown (see Issues below). + + +Description +----------- + +This is the driver for the SMB Host controller on Acer Labs Inc. (ALI) +M1541 and M1543C South Bridges. + +The M1543C is a South bridge for desktop systems. +The M1541 is a South bridge for portable systems. +They are part of the following ALI chipsets: + + * "Aladdin Pro 2" Includes the M1621 Slot 1 North bridge with AGP and + 100MHz CPU Front Side bus + * "Aladdin V" Includes the M1541 Socket 7 North bridge with AGP and 100MHz + CPU Front Side bus + Some Aladdin V motherboards: + Asus P5A + Atrend ATC-5220 + BCM/GVC VP1541 + Biostar M5ALA + Gigabyte GA-5AX (** Generally doesn't work because the BIOS doesn't + enable the 7101 device! **) + Iwill XA100 Plus + Micronics C200 + Microstar (MSI) MS-5169 + + * "Aladdin IV" Includes the M1541 Socket 7 North bridge + with host bus up to 83.3 MHz. + +For an overview of these chips see http://www.acerlabs.com At this time the +full data sheets on the web site are password protected, however if you +contact the ALI office in San Jose they may give you the password. + +The M1533/M1543C devices appear as FOUR separate devices on the PCI bus. An +output of lspci will show something similar to the following: + + 00:02.0 USB Controller: Acer Laboratories Inc. M5237 (rev 03) + 00:03.0 Bridge: Acer Laboratories Inc. M7101 <= THIS IS THE ONE WE NEED + 00:07.0 ISA bridge: Acer Laboratories Inc. M1533 (rev c3) + 00:0f.0 IDE interface: Acer Laboratories Inc. M5229 (rev c1) + +** IMPORTANT ** +** If you have a M1533 or M1543C on the board and you get +** "ali15x3.o: Error: Can't detect ali15x3!" +** then run lspci. +** If you see the 1533 and 5229 devices but NOT the 7101 device, +** then you must enable ACPI, the PMU, SMB, or something similar +** in the BIOS. +** The driver won't work if it can't find the M7101 device. + +The SMB controller is part of the M7101 device, which is an ACPI-compliant +Power Management Unit (PMU). + +The whole M7101 device has to be enabled for the SMB to work. You can't +just enable the SMB alone. The SMB and the ACPI have separate I/O spaces. +We make sure that the SMB is enabled. We leave the ACPI alone. + +Features +-------- + +This driver controls the SMB Host only. The SMB Slave +controller on the M15X3 is not enabled. This driver does not use +interrupts. + + +Issues +------ + +This driver requests the I/O space for only the SMB +registers. It doesn't use the ACPI region. + +On the ASUS P5A motherboard, there are several reports that +the SMBus will hang and this can only be resolved by +powering off the computer. It appears to be worse when the board +gets hot, for example under heavy CPU load, or in the summer. +There may be electrical problems on this board. +On the P5A, the W83781D sensor chip is on both the ISA and +SMBus. Therefore the SMBus hangs can generally be avoided +by accessing the W83781D on the ISA bus only. +
Documentation/i2c/busses/i2c-ali1535 +42 -0
42 lines not on this page · raw message
Documentation/i2c/busses/i2c-ali1563 +27 -0
@@ -0,0 +1,27 @@ +Kernel driver i2c-ali1563 + +Supported adapters: + * Acer Labs, Inc. ALI 1563 (south bridge) + Datasheet: Now under NDA + http://www.ali.com.tw/eng/support/datasheet_request.php + +Author: Patrick Mochel <[email protected]> + +Description +----------- + +This is the driver for the SMB Host controller on Acer Labs Inc. (ALI) +M1563 South Bridge. + +For an overview of these chips see http://www.acerlabs.com + +The M1563 southbridge is deceptively similar to the M1533, with a few +notable exceptions. One of those happens to be the fact they upgraded the +i2c core to be SMBus 2.0 compliant, and happens to be almost identical to +the i2c controller found in the Intel 801 south bridges. + +Features +-------- + +This driver controls the SMB Host only. This driver does not use +interrupts.
Documentation/i2c/busses/i2c-amd756 +25 -0
@@ -0,0 +1,25 @@ +Kernel driver i2c-amd756 + +Supported adapters: + * AMD 756 + * AMD 766 + * AMD 768 + * AMD 8111 + Datasheets: Publicly available on AMD website + + * nVidia nForce + Datasheet: Unavailable + +Authors: + Frodo Looijaard <[email protected]>, + Philip Edelbrock <[email protected]> + +Description +----------- + +This driver supports the AMD 756, 766, 768 and 8111 Peripheral Bus +Controllers, and the nVidia nForce. + +Note that for the 8111, there are two SMBus adapters. The SMBus 1.0 adapter +is supported by this driver, and the SMBus 2.0 adapter is supported by the +i2c-amd8111 driver.
Documentation/i2c/busses/i2c-amd8111 +41 -0
41 lines not on this page · raw message
Documentation/i2c/busses/i2c-i801 +80 -0
80 lines not on this page · raw message
Documentation/i2c/busses/i2c-i810 +46 -0
46 lines not on this page · raw message
Documentation/i2c/busses/i2c-nforce2 +41 -0
41 lines not on this page · raw message
Documentation/i2c/busses/i2c-parport +8 -10
@@ -1,8 +1,6 @@ -========= -i2c-parport driver -========= +Kernel driver i2c-parport -2004-07-06, Jean Delvare +Author: Jean Delvare <[email protected]> This is a unified driver for several i2c-over-parallel-port adapters, such as the ones made by Philips, Velleman or ELV. This driver is
@@ -126,14 +124,14 @@ Similar (but different) drivers ------------------------------- -This driver is NOT the same as the i2c-pport driver found in the i2c package. -The i2c-pport driver makes use of modern parallel port features so that -you don't need additional electronics. It has other restrictions however, and -was not ported to Linux 2.6 (yet). +This driver is NOT the same as the i2c-pport driver found in the i2c +package. The i2c-pport driver makes use of modern parallel port features so +that you don't need additional electronics. It has other restrictions +however, and was not ported to Linux 2.6 (yet). This driver is also NOT the same as the i2c-pcf-epp driver found in the -lm_sensors package. The i2c-pcf-epp driver doesn't use the parallel port -as an I2C bus directly. Instead, it uses it to control an external I2C bus +lm_sensors package. The i2c-pcf-epp driver doesn't use the parallel port as +an I2C bus directly. Instead, it uses it to control an external I2C bus master. That driver was not ported to Linux 2.6 (yet) either.
Documentation/i2c/busses/i2c-parport-light +11 -0
@@ -0,0 +1,11 @@ +Kernel driver i2c-parport-light + +Author: Jean Delvare <[email protected]> + +This driver is a light version of i2c-parport. It doesn't depend +on the parport driver, and uses direct I/O access instead. This might be +prefered on embedded systems where wasting memory for the clean but heavy +parport handling is not an option. The drawback is a reduced portability +and the impossibility to dasiy-chain other parallel port devices. + +Please see i2c-parport for documentation.
Documentation/i2c/busses/i2c-pca-isa +23 -0
@@ -0,0 +1,23 @@ +Kernel driver i2c-pca-isa + +Supported adapters: +This driver supports ISA boards using the Philips PCA 9564 +Parallel bus to I2C bus controller + +Author: Ian Campbell <[email protected]>, Arcom Control Systems + +Module Parameters +----------------- + +* base int + I/O base address +* irq int + IRQ interrupt +* clock int + Clock rate as described in table 1 of PCA9564 datasheet + +Description +----------- + +This driver supports ISA boards using the Philips PCA 9564 +Parallel bus to I2C bus controller
Documentation/i2c/busses/i2c-piix4 +72 -0
72 lines not on this page · raw message
Documentation/i2c/busses/i2c-prosavage +23 -0
@@ -0,0 +1,23 @@ +Kernel driver i2c-prosavage + +Supported adapters: + + S3/VIA KM266/VT8375 aka ProSavage8 + S3/VIA KM133/VT8365 aka Savage4 + +Author: Henk Vergonet <[email protected]> + +Description +----------- + +The Savage4 chips contain two I2C interfaces (aka a I2C 'master' or +'host'). + +The first interface is used for DDC (Data Display Channel) which is a +serial channel through the VGA monitor connector to a DDC-compliant +monitor. This interface is defined by the Video Electronics Standards +Association (VESA). The standards are available for purchase at +http://www.vesa.org . The second interface is a general-purpose I2C bus. + +Usefull for gaining access to the TV Encoder chips. +
Documentation/i2c/busses/i2c-savage4 +26 -0
@@ -0,0 +1,26 @@ +Kernel driver i2c-savage4 + +Supported adapters: + * Savage4 + * Savage2000 + +Authors: + Alexander Wold <[email protected]>, + Mark D. Studebaker <[email protected]> + +Description +----------- + +The Savage4 chips contain two I2C interfaces (aka a I2C 'master' +or 'host'). + +The first interface is used for DDC (Data Display Channel) which is a +serial channel through the VGA monitor connector to a DDC-compliant +monitor. This interface is defined by the Video Electronics Standards +Association (VESA). The standards are available for purchase at +http://www.vesa.org . The DDC bus is not yet supported because its register +is not directly memory-mapped. + +The second interface is a general-purpose I2C bus. This is the only +interface supported by the driver at the moment. +
Documentation/i2c/busses/i2c-sis5595 +59 -0
59 lines not on this page · raw message
Documentation/i2c/busses/i2c-sis630 +49 -0
49 lines not on this page · raw message
Documentation/i2c/busses/i2c-sis69x +73 -0
73 lines not on this page · raw message
Documentation/i2c/busses/i2c-via +34 -0
@@ -0,0 +1,34 @@ +Kernel driver i2c-via + +Supported adapters: + * VIA Technologies, InC. VT82C586B + Datasheet: Publicly available at the VIA website + +Author: Ky?sti M?lkki <[email protected]> + +Description +----------- + +i2c-via is an i2c bus driver for motherboards with VIA chipset. + +The following VIA pci chipsets are supported: + - MVP3, VP3, VP2/97, VPX/97 + - others with South bridge VT82C586B + +Your lspci listing must show this : + + Bridge: VIA Technologies, Inc. VT82C586B ACPI (rev 10) + + Problems? + + Q: You have VT82C586B on the motherboard, but not in the listing. + + A: Go to your BIOS setup, section PCI devices or similar. + Turn USB support on, and try again. + + Q: No error messages, but still i2c doesn't seem to work. + + A: This can happen. This driver uses the pins VIA recommends in their + datasheets, but there are several ways the motherboard manufacturer + can actually wire the lines. +
Documentation/i2c/busses/i2c-viapro +47 -0
47 lines not on this page · raw message
Documentation/i2c/busses/i2c-voodoo3 +62 -0
62 lines not on this page · raw message
Documentation/i2c/busses/scx200_acb +14 -0
@@ -0,0 +1,14 @@ +Kernel driver scx200_acb + +Author: Christer Weinigel <[email protected]> + +Module Parameters +----------------- + +* base: int + Base addresses for the ACCESS.bus controllers + +Description +----------- + +Enable the use of the ACCESS.bus controllers of a SCx200 processor.
PATCH 1/1 RC1 2.6 busses docummentation
Quoted 1 line · Rudolf Marek
Hello,
Hi !
Quoted 1 line
Last chance for comments :)
I have looked a it, looks fine for me, except a few cosmetic changes concerning spaces and indentation. Please find my comments below.
Bye,
Aurelien
Documentation/i2c/busses/i2c-ali15x3 +0 -0
+ * "Aladdin Pro 2" Includes the M1621 Slot 1 North bridge with AGP and
^
no need to capitalize the first letter
+ 100MHz CPU Front Side bus
+ * "Aladdin V" Includes the M1541 Socket 7 North bridge with AGP and 100MHz
^
idem
..
+ * "Aladdin IV" Includes the M1541 Socket 7 North bridge
^
idem+ with host bus up to 83.3 MHz.
..
+For an overview of these chips see http://www.acerlabs.com At this time the
^^^
A dot is missing
Documentation/i2c/busses/i2c-ali1563 +0 -0
+The M1563 southbridge is deceptively similar to the M1533, with a few
^
too much spaces
+notable exceptions. One of those happens to be the fact they upgraded the
^
idem
+i2c core to be SMBus 2.0 compliant, and happens to be almost identical to
^
idemDocumentation/i2c/busses/i2c-parport-light +7 -0
@@ -0,0 +1,11 @@ +Kernel driver i2c-parport-light + +Author: Jean Delvare <[email protected]> + +This driver is a light version of i2c-parport. It doesn't depend +on the parport driver, and uses direct I/O access instead. This might be +prefered on embedded systems where wasting memory for the clean but heavy
^
too much spaces
+parport handling is not an option. The drawback is a reduced portability
^
idem+and the impossibility to dasiy-chain other parallel port devices. +
+Please see i2c-parport for documentation.
Documentation/i2c/busses/i2c-piix4 +0 -0
+On some computers (most notably, some Dells), the SMBus is disabled by +default. If you use the insmod parameter 'force=1', the kernel module will
^
too much space
Documentation/i2c/busses/i2c-sis5595 +6 -0
@@ -0,0 +1,59 @@ +Kernel driver i2c-sis5595 + +Authors: + Frodo Looijaard <[email protected]>, + Mark D. Studebaker <[email protected]>, + Philip Edelbrock <[email protected]>
indentation problem. Two lines are indented with tabs, the other with spaces.
+WARNING: If you are trying to access the integrated sensors on the SiS5595
^^^
too much space
Documentation/i2c/busses/i2c-sis630 +0 -0
+* force = [1|0] Forcibly enable the SIS630. DANGEROUS!
+ This can be interesting for chipsets not named
+ above to check if it works for you chipset, but DANGEROUS!
+
+* high_clock = [1|0] Forcibly set Host Master Clock to 56KHz (default,what
^^^
space is missing
+ your BIOS use). DANGEROUS! This should be a bit
+ faster, but freeze some systems (i.e. my Laptop).
Would be nice to have this indented the same way as for force
Documentation/i2c/busses/i2c-sis69x +0 -0
those of the SiS630, although they are located in a completely different +place. Thanks to Alexander Malysh <[email protected]> for providing the +SiS630 datasheet (and driver).
^^^^
too much space
+If you cant see it please look on quirk_sis_96x_smbus
^^^^ idem
Signature · 4 lines
.''`. Aurelien Jarno GPG: 1024D/F1BCDB73 : :' : Debian GNU/Linux developer | Electrical Engineer `. `' [email protected] | [email protected] `- people.debian.org/~aurel32 | www.aurel32.net
PATCH 1/1 RC1 2.6 busses docummentation
In reply to Rudolf MarekDocumentation/i2c/busses/i2c-parport-light line 9
Quoted 4 lines
Documentation/i2c/busses/i2c-parport-light +2
-0+Kernel driver i2c-parport-light +and the impossibility to dasiy-chain other parallel port devices.
Typo here, s/dasiy/daisy/.
Thanks,
--
Jean Delvare