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