xref: /OK3568_Linux_fs/kernel/Documentation/i2c/busses/i2c-viapro.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun========================
2*4882a593SmuzhiyunKernel driver i2c-viapro
3*4882a593Smuzhiyun========================
4*4882a593Smuzhiyun
5*4882a593SmuzhiyunSupported adapters:
6*4882a593Smuzhiyun  * VIA Technologies, Inc. VT82C596A/B
7*4882a593Smuzhiyun    Datasheet: Sometimes available at the VIA website
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun  * VIA Technologies, Inc. VT82C686A/B
10*4882a593Smuzhiyun    Datasheet: Sometimes available at the VIA website
11*4882a593Smuzhiyun
12*4882a593Smuzhiyun  * VIA Technologies, Inc. VT8231, VT8233, VT8233A
13*4882a593Smuzhiyun    Datasheet: available on request from VIA
14*4882a593Smuzhiyun
15*4882a593Smuzhiyun  * VIA Technologies, Inc. VT8235, VT8237R, VT8237A, VT8237S, VT8251
16*4882a593Smuzhiyun    Datasheet: available on request and under NDA from VIA
17*4882a593Smuzhiyun
18*4882a593Smuzhiyun  * VIA Technologies, Inc. CX700
19*4882a593Smuzhiyun    Datasheet: available on request and under NDA from VIA
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun  * VIA Technologies, Inc. VX800/VX820
22*4882a593Smuzhiyun    Datasheet: available on http://linux.via.com.tw
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun  * VIA Technologies, Inc. VX855/VX875
25*4882a593Smuzhiyun    Datasheet: available on http://linux.via.com.tw
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun  * VIA Technologies, Inc. VX900
28*4882a593Smuzhiyun    Datasheet: available on http://linux.via.com.tw
29*4882a593Smuzhiyun
30*4882a593SmuzhiyunAuthors:
31*4882a593Smuzhiyun	- Kyösti Mälkki <kmalkki@cc.hut.fi>,
32*4882a593Smuzhiyun	- Mark D. Studebaker <mdsxyz123@yahoo.com>,
33*4882a593Smuzhiyun	- Jean Delvare <jdelvare@suse.de>
34*4882a593Smuzhiyun
35*4882a593SmuzhiyunModule Parameters
36*4882a593Smuzhiyun-----------------
37*4882a593Smuzhiyun
38*4882a593Smuzhiyun* force: int
39*4882a593Smuzhiyun  Forcibly enable the SMBus controller. DANGEROUS!
40*4882a593Smuzhiyun* force_addr: int
41*4882a593Smuzhiyun  Forcibly enable the SMBus at the given address. EXTREMELY DANGEROUS!
42*4882a593Smuzhiyun
43*4882a593SmuzhiyunDescription
44*4882a593Smuzhiyun-----------
45*4882a593Smuzhiyun
46*4882a593Smuzhiyuni2c-viapro is a true SMBus host driver for motherboards with one of the
47*4882a593Smuzhiyunsupported VIA south bridges.
48*4882a593Smuzhiyun
49*4882a593SmuzhiyunYour ``lspci -n`` listing must show one of these :
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun ================   ======================
52*4882a593Smuzhiyun device 1106:3050   (VT82C596A function 3)
53*4882a593Smuzhiyun device 1106:3051   (VT82C596B function 3)
54*4882a593Smuzhiyun device 1106:3057   (VT82C686 function 4)
55*4882a593Smuzhiyun device 1106:3074   (VT8233)
56*4882a593Smuzhiyun device 1106:3147   (VT8233A)
57*4882a593Smuzhiyun device 1106:8235   (VT8231 function 4)
58*4882a593Smuzhiyun device 1106:3177   (VT8235)
59*4882a593Smuzhiyun device 1106:3227   (VT8237R)
60*4882a593Smuzhiyun device 1106:3337   (VT8237A)
61*4882a593Smuzhiyun device 1106:3372   (VT8237S)
62*4882a593Smuzhiyun device 1106:3287   (VT8251)
63*4882a593Smuzhiyun device 1106:8324   (CX700)
64*4882a593Smuzhiyun device 1106:8353   (VX800/VX820)
65*4882a593Smuzhiyun device 1106:8409   (VX855/VX875)
66*4882a593Smuzhiyun device 1106:8410   (VX900)
67*4882a593Smuzhiyun ================   ======================
68*4882a593Smuzhiyun
69*4882a593SmuzhiyunIf none of these show up, you should look in the BIOS for settings like
70*4882a593Smuzhiyunenable ACPI / SMBus or even USB.
71*4882a593Smuzhiyun
72*4882a593SmuzhiyunExcept for the oldest chips (VT82C596A/B, VT82C686A and most probably
73*4882a593SmuzhiyunVT8231), this driver supports I2C block transactions. Such transactions
74*4882a593Smuzhiyunare mainly useful to read from and write to EEPROMs.
75*4882a593Smuzhiyun
76*4882a593SmuzhiyunThe CX700/VX800/VX820 additionally appears to support SMBus PEC, although
77*4882a593Smuzhiyunthis driver doesn't implement it yet.
78