xref: /OK3568_Linux_fs/kernel/Documentation/i2c/busses/i2c-sis96x.rst (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun========================
2*4882a593SmuzhiyunKernel driver i2c-sis96x
3*4882a593Smuzhiyun========================
4*4882a593Smuzhiyun
5*4882a593SmuzhiyunReplaces 2.4.x i2c-sis645
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunSupported adapters:
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun  * Silicon Integrated Systems Corp (SiS)
10*4882a593Smuzhiyun
11*4882a593Smuzhiyun    Any combination of these host bridges:
12*4882a593Smuzhiyun	645, 645DX (aka 646), 648, 650, 651, 655, 735, 745, 746
13*4882a593Smuzhiyun
14*4882a593Smuzhiyun    and these south bridges:
15*4882a593Smuzhiyun	961, 962, 963(L)
16*4882a593Smuzhiyun
17*4882a593SmuzhiyunAuthor: Mark M. Hoffman <mhoffman@lightlink.com>
18*4882a593Smuzhiyun
19*4882a593SmuzhiyunDescription
20*4882a593Smuzhiyun-----------
21*4882a593Smuzhiyun
22*4882a593SmuzhiyunThis SMBus only driver is known to work on motherboards with the above
23*4882a593Smuzhiyunnamed chipset combinations. The driver was developed without benefit of a
24*4882a593Smuzhiyunproper datasheet from SiS. The SMBus registers are assumed compatible with
25*4882a593Smuzhiyunthose of the SiS630, although they are located in a completely different
26*4882a593Smuzhiyunplace. Thanks to Alexander Malysh <amalysh@web.de> for providing the
27*4882a593SmuzhiyunSiS630 datasheet (and  driver).
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunThe command ``lspci`` as root should produce something like these lines::
30*4882a593Smuzhiyun
31*4882a593Smuzhiyun  00:00.0 Host bridge: Silicon Integrated Systems [SiS]: Unknown device 0645
32*4882a593Smuzhiyun  00:02.0 ISA bridge: Silicon Integrated Systems [SiS] 85C503/5513
33*4882a593Smuzhiyun  00:02.1 SMBus: Silicon Integrated Systems [SiS]: Unknown device 0016
34*4882a593Smuzhiyun
35*4882a593Smuzhiyunor perhaps this::
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun  00:00.0 Host bridge: Silicon Integrated Systems [SiS]: Unknown device 0645
38*4882a593Smuzhiyun  00:02.0 ISA bridge: Silicon Integrated Systems [SiS]: Unknown device 0961
39*4882a593Smuzhiyun  00:02.1 SMBus: Silicon Integrated Systems [SiS]: Unknown device 0016
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun(kernel versions later than 2.4.18 may fill in the "Unknown"s)
42*4882a593Smuzhiyun
43*4882a593SmuzhiyunIf you can't see it please look on quirk_sis_96x_smbus
44*4882a593Smuzhiyun(drivers/pci/quirks.c) (also if southbridge detection fails)
45*4882a593Smuzhiyun
46*4882a593SmuzhiyunI suspect that this driver could be made to work for the following SiS
47*4882a593Smuzhiyunchipsets as well: 635, and 635T. If anyone owns a board with those chips
48*4882a593SmuzhiyunAND is willing to risk crashing & burning an otherwise well-behaved kernel
49*4882a593Smuzhiyunin the name of progress... please contact me at <mhoffman@lightlink.com> or
50*4882a593Smuzhiyunvia the linux-i2c mailing list: <linux-i2c@vger.kernel.org>.  Please send bug
51*4882a593Smuzhiyunreports and/or success stories as well.
52*4882a593Smuzhiyun
53*4882a593Smuzhiyun
54*4882a593SmuzhiyunTO DOs
55*4882a593Smuzhiyun------
56*4882a593Smuzhiyun
57*4882a593Smuzhiyun* The driver does not support SMBus block reads/writes; I may add them if a
58*4882a593Smuzhiyun  scenario is found where they're needed.
59*4882a593Smuzhiyun
60*4882a593Smuzhiyun
61*4882a593SmuzhiyunThank You
62*4882a593Smuzhiyun---------
63*4882a593Smuzhiyun
64*4882a593SmuzhiyunMark D. Studebaker <mdsxyz123@yahoo.com>
65*4882a593Smuzhiyun - design hints and bug fixes
66*4882a593Smuzhiyun
67*4882a593SmuzhiyunAlexander Maylsh <amalysh@web.de>
68*4882a593Smuzhiyun - ditto, plus an important datasheet... almost the one I really wanted
69*4882a593Smuzhiyun
70*4882a593SmuzhiyunHans-Günter Lütke Uphues <hg_lu@t-online.de>
71*4882a593Smuzhiyun - patch for SiS735
72*4882a593Smuzhiyun
73*4882a593SmuzhiyunRobert Zwerus <arzie@dds.nl>
74*4882a593Smuzhiyun - testing for SiS645DX
75*4882a593Smuzhiyun
76*4882a593SmuzhiyunKianusch Sayah Karadji <kianusch@sk-tech.net>
77*4882a593Smuzhiyun - patch for SiS645DX/962
78*4882a593Smuzhiyun
79*4882a593SmuzhiyunKen Healy
80*4882a593Smuzhiyun - patch for SiS655
81*4882a593Smuzhiyun
82*4882a593SmuzhiyunTo anyone else who has written w/ feedback, thanks!
83