xref: /linux/drivers/i2c/busses/i2c-sis5595.c (revision daa2be74b1b2302004945b2a5e32424e177cc7da)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3     Copyright (c) 1998, 1999  Frodo Looijaard <frodol@dds.nl> and
4     Philip Edelbrock <phil@netroedge.com>
5 
6 */
7 
8 /* Note: we assume there can only be one SIS5595 with one SMBus interface */
9 
10 /*
11    Note: all have mfr. ID 0x1039.
12    SUPPORTED		PCI ID
13 	5595		0008
14 
15    Note: these chips contain a 0008 device which is incompatible with the
16          5595. We recognize these by the presence of the listed
17          "blacklist" PCI ID and refuse to load.
18 
19    NOT SUPPORTED	PCI ID		BLACKLIST PCI ID
20 	 540		0008		0540
21 	 550		0008		0550
22 	5513		0008		5511
23 	5581		0008		5597
24 	5582		0008		5597
25 	5597		0008		5597
26 	5598		0008		5597/5598
27 	 630		0008		0630
28 	 645		0008		0645
29 	 646		0008		0646
30 	 648		0008		0648
31 	 650		0008		0650
32 	 651		0008		0651
33 	 730		0008		0730
34 	 735		0008		0735
35 	 745		0008		0745
36 	 746		0008		0746
37 */
38 
39 /* TO DO:
40  * Add Block Transfers (ugly, but supported by the adapter)
41  * Add adapter resets
42  */
43 
44 #include <linux/kernel.h>
45 #include <linux/module.h>
46 #include <linux/delay.h>
47 #include <linux/pci.h>
48 #include <linux/ioport.h>
49 #include <linux/init.h>
50 #include <linux/i2c.h>
51 #include <linux/acpi.h>
52 #include <linux/io.h>
53 
54 static int blacklist[] = {
55 	PCI_DEVICE_ID_SI_540,
56 	PCI_DEVICE_ID_SI_550,
57 	PCI_DEVICE_ID_SI_630,
58 	PCI_DEVICE_ID_SI_645,
59 	PCI_DEVICE_ID_SI_646,
60 	PCI_DEVICE_ID_SI_648,
61 	PCI_DEVICE_ID_SI_650,
62 	PCI_DEVICE_ID_SI_651,
63 	PCI_DEVICE_ID_SI_730,
64 	PCI_DEVICE_ID_SI_735,
65 	PCI_DEVICE_ID_SI_745,
66 	PCI_DEVICE_ID_SI_746,
67 	PCI_DEVICE_ID_SI_5511,	/* 5513 chip has the 0008 device but that ID
68 				   shows up in other chips so we use the 5511
69 				   ID for recognition */
70 	PCI_DEVICE_ID_SI_5597,
71 	PCI_DEVICE_ID_SI_5598,
72 	0,			/* terminates the list */
73 };
74 
75 /* Length of ISA address segment */
76 #define SIS5595_EXTENT		8
77 /* SIS5595 SMBus registers */
78 #define SMB_STS_LO		0x00
79 #define SMB_STS_HI		0x01
80 #define SMB_CTL_LO		0x02
81 #define SMB_CTL_HI		0x03
82 #define SMB_ADDR		0x04
83 #define SMB_CMD			0x05
84 #define SMB_PCNT		0x06
85 #define SMB_CNT			0x07
86 #define SMB_BYTE		0x08
87 #define SMB_DEV			0x10
88 #define SMB_DB0			0x11
89 #define SMB_DB1			0x12
90 #define SMB_HAA			0x13
91 
92 /* PCI Address Constants */
93 #define SMB_INDEX		0x38
94 #define SMB_DAT			0x39
95 #define SIS5595_ENABLE_REG	0x40
96 #define ACPI_BASE		0x90
97 
98 /* Other settings */
99 #define MAX_TIMEOUT		500
100 
101 /* SIS5595 constants */
102 #define SIS5595_QUICK		0x00
103 #define SIS5595_BYTE		0x02
104 #define SIS5595_BYTE_DATA	0x04
105 #define SIS5595_WORD_DATA	0x06
106 #define SIS5595_PROC_CALL	0x08
107 #define SIS5595_BLOCK_DATA	0x0A
108 
109 /* insmod parameters */
110 
111 /* If force_addr is set to anything different from 0, we forcibly enable
112    the device at the given address. */
113 static u16 force_addr;
114 module_param_hw(force_addr, ushort, ioport, 0);
115 MODULE_PARM_DESC(force_addr, "Initialize the base address of the i2c controller");
116 
117 static struct pci_driver sis5595_driver;
118 static unsigned short sis5595_base;
119 static struct pci_dev *sis5595_pdev;
120 
121 static u8 sis5595_read(u8 reg)
122 {
123 	outb(reg, sis5595_base + SMB_INDEX);
124 	return inb(sis5595_base + SMB_DAT);
125 }
126 
127 static void sis5595_write(u8 reg, u8 data)
128 {
129 	outb(reg, sis5595_base + SMB_INDEX);
130 	outb(data, sis5595_base + SMB_DAT);
131 }
132 
133 static int sis5595_setup(struct pci_dev *SIS5595_dev)
134 {
135 	u16 a;
136 	u8 val;
137 	int *i;
138 	int retval;
139 
140 	/* Look for imposters */
141 	for (i = blacklist; *i != 0; i++) {
142 		struct pci_dev *dev;
143 		dev = pci_get_device(PCI_VENDOR_ID_SI, *i, NULL);
144 		if (dev) {
145 			dev_err(&SIS5595_dev->dev, "Looked for SIS5595 but found unsupported device %.4x\n", *i);
146 			pci_dev_put(dev);
147 			return -ENODEV;
148 		}
149 	}
150 
151 	/* Determine the address of the SMBus areas */
152 	pci_read_config_word(SIS5595_dev, ACPI_BASE, &sis5595_base);
153 	if (sis5595_base == 0 && force_addr == 0) {
154 		dev_err(&SIS5595_dev->dev, "ACPI base address uninitialized - upgrade BIOS or use force_addr=0xaddr\n");
155 		return -ENODEV;
156 	}
157 
158 	if (force_addr)
159 		sis5595_base = force_addr & ~(SIS5595_EXTENT - 1);
160 	dev_dbg(&SIS5595_dev->dev, "ACPI Base address: %04x\n", sis5595_base);
161 
162 	/* NB: We grab just the two SMBus registers here, but this may still
163 	 * interfere with ACPI :-(  */
164 	retval = acpi_check_region(sis5595_base + SMB_INDEX, 2,
165 				   sis5595_driver.name);
166 	if (retval)
167 		return retval;
168 
169 	if (!request_region(sis5595_base + SMB_INDEX, 2,
170 			    sis5595_driver.name)) {
171 		dev_err(&SIS5595_dev->dev, "SMBus registers 0x%04x-0x%04x already in use!\n",
172 			sis5595_base + SMB_INDEX, sis5595_base + SMB_INDEX + 1);
173 		return -ENODEV;
174 	}
175 
176 	if (force_addr) {
177 		dev_info(&SIS5595_dev->dev, "forcing ISA address 0x%04X\n", sis5595_base);
178 		retval = pci_write_config_word(SIS5595_dev, ACPI_BASE, sis5595_base);
179 		if (retval != PCIBIOS_SUCCESSFUL)
180 			goto error;
181 		retval = pci_read_config_word(SIS5595_dev, ACPI_BASE, &a);
182 		if (retval != PCIBIOS_SUCCESSFUL)
183 			goto error;
184 		if ((a & ~(SIS5595_EXTENT - 1)) != sis5595_base) {
185 			/* doesn't work for some chips! */
186 			dev_err(&SIS5595_dev->dev, "force address failed - not supported?\n");
187 			goto error;
188 		}
189 	}
190 
191 	retval = pci_read_config_byte(SIS5595_dev, SIS5595_ENABLE_REG, &val);
192 	if (retval != PCIBIOS_SUCCESSFUL)
193 		goto error;
194 	if ((val & 0x80) == 0) {
195 		dev_info(&SIS5595_dev->dev, "enabling ACPI\n");
196 		retval = pci_write_config_byte(SIS5595_dev, SIS5595_ENABLE_REG, val | 0x80);
197 		if (retval != PCIBIOS_SUCCESSFUL)
198 			goto error;
199 		retval = pci_read_config_byte(SIS5595_dev, SIS5595_ENABLE_REG, &val);
200 		if (retval != PCIBIOS_SUCCESSFUL)
201 			goto error;
202 		if ((val & 0x80) == 0) {
203 			/* doesn't work for some chips? */
204 			dev_err(&SIS5595_dev->dev, "ACPI enable failed - not supported?\n");
205 			goto error;
206 		}
207 	}
208 
209 	/* Everything is happy */
210 	return 0;
211 
212 error:
213 	release_region(sis5595_base + SMB_INDEX, 2);
214 	return -ENODEV;
215 }
216 
217 static int sis5595_transaction(struct i2c_adapter *adap)
218 {
219 	int temp;
220 	int result = 0;
221 	int timeout = 0;
222 
223 	/* Make sure the SMBus host is ready to start transmitting */
224 	temp = sis5595_read(SMB_STS_LO) + (sis5595_read(SMB_STS_HI) << 8);
225 	if (temp != 0x00) {
226 		dev_dbg(&adap->dev, "SMBus busy (%04x). Resetting...\n", temp);
227 		sis5595_write(SMB_STS_LO, temp & 0xff);
228 		sis5595_write(SMB_STS_HI, temp >> 8);
229 		if ((temp = sis5595_read(SMB_STS_LO) + (sis5595_read(SMB_STS_HI) << 8)) != 0x00) {
230 			dev_dbg(&adap->dev, "Failed! (%02x)\n", temp);
231 			return -EBUSY;
232 		} else {
233 			dev_dbg(&adap->dev, "Successful!\n");
234 		}
235 	}
236 
237 	/* start the transaction by setting bit 4 */
238 	sis5595_write(SMB_CTL_LO, sis5595_read(SMB_CTL_LO) | 0x10);
239 
240 	/* We will always wait for a fraction of a second! */
241 	do {
242 		msleep(1);
243 		temp = sis5595_read(SMB_STS_LO);
244 	} while (!(temp & 0x40) && (timeout++ < MAX_TIMEOUT));
245 
246 	/* If the SMBus is still busy, we give up */
247 	if (timeout > MAX_TIMEOUT) {
248 		dev_dbg(&adap->dev, "SMBus Timeout!\n");
249 		result = -ETIMEDOUT;
250 	}
251 
252 	if (temp & 0x10) {
253 		dev_dbg(&adap->dev, "Error: Failed bus transaction\n");
254 		result = -ENXIO;
255 	}
256 
257 	if (temp & 0x20) {
258 		dev_err(&adap->dev, "Bus collision! SMBus may be locked until "
259 			"next hard reset (or not...)\n");
260 		/* Clock stops and target is stuck in mid-transmission */
261 		result = -EIO;
262 	}
263 
264 	temp = sis5595_read(SMB_STS_LO) + (sis5595_read(SMB_STS_HI) << 8);
265 	if (temp != 0x00) {
266 		sis5595_write(SMB_STS_LO, temp & 0xff);
267 		sis5595_write(SMB_STS_HI, temp >> 8);
268 	}
269 
270 	temp = sis5595_read(SMB_STS_LO) + (sis5595_read(SMB_STS_HI) << 8);
271 	if (temp != 0x00)
272 		dev_dbg(&adap->dev, "Failed reset at end of transaction (%02x)\n", temp);
273 
274 	return result;
275 }
276 
277 /* Return negative errno on error. */
278 static s32 sis5595_access(struct i2c_adapter *adap, u16 addr,
279 			  unsigned short flags, char read_write,
280 			  u8 command, int size, union i2c_smbus_data *data)
281 {
282 	int status;
283 
284 	switch (size) {
285 	case I2C_SMBUS_QUICK:
286 		sis5595_write(SMB_ADDR, ((addr & 0x7f) << 1) | (read_write & 0x01));
287 		size = SIS5595_QUICK;
288 		break;
289 	case I2C_SMBUS_BYTE:
290 		sis5595_write(SMB_ADDR, ((addr & 0x7f) << 1) | (read_write & 0x01));
291 		if (read_write == I2C_SMBUS_WRITE)
292 			sis5595_write(SMB_CMD, command);
293 		size = SIS5595_BYTE;
294 		break;
295 	case I2C_SMBUS_BYTE_DATA:
296 		sis5595_write(SMB_ADDR, ((addr & 0x7f) << 1) | (read_write & 0x01));
297 		sis5595_write(SMB_CMD, command);
298 		if (read_write == I2C_SMBUS_WRITE)
299 			sis5595_write(SMB_BYTE, data->byte);
300 		size = SIS5595_BYTE_DATA;
301 		break;
302 	case I2C_SMBUS_PROC_CALL:
303 	case I2C_SMBUS_WORD_DATA:
304 		sis5595_write(SMB_ADDR, ((addr & 0x7f) << 1) | (read_write & 0x01));
305 		sis5595_write(SMB_CMD, command);
306 		if (read_write == I2C_SMBUS_WRITE) {
307 			sis5595_write(SMB_BYTE, data->word & 0xff);
308 			sis5595_write(SMB_BYTE + 1,
309 				      (data->word & 0xff00) >> 8);
310 		}
311 		size = (size == I2C_SMBUS_PROC_CALL) ? SIS5595_PROC_CALL : SIS5595_WORD_DATA;
312 		break;
313 	default:
314 		dev_warn(&adap->dev, "Unsupported transaction %d\n", size);
315 		return -EOPNOTSUPP;
316 	}
317 
318 	sis5595_write(SMB_CTL_LO, ((size & 0x0E)));
319 
320 	status = sis5595_transaction(adap);
321 	if (status)
322 		return status;
323 
324 	if ((size != SIS5595_PROC_CALL) &&
325 	    ((read_write == I2C_SMBUS_WRITE) || (size == SIS5595_QUICK)))
326 		return 0;
327 
328 
329 	switch (size) {
330 	case SIS5595_BYTE:
331 	case SIS5595_BYTE_DATA:
332 		data->byte = sis5595_read(SMB_BYTE);
333 		break;
334 	case SIS5595_WORD_DATA:
335 	case SIS5595_PROC_CALL:
336 		data->word = sis5595_read(SMB_BYTE) + (sis5595_read(SMB_BYTE + 1) << 8);
337 		break;
338 	}
339 	return 0;
340 }
341 
342 static u32 sis5595_func(struct i2c_adapter *adapter)
343 {
344 	return I2C_FUNC_SMBUS_QUICK | I2C_FUNC_SMBUS_BYTE |
345 	    I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA |
346 	    I2C_FUNC_SMBUS_PROC_CALL;
347 }
348 
349 static const struct i2c_algorithm smbus_algorithm = {
350 	.smbus_xfer	= sis5595_access,
351 	.functionality	= sis5595_func,
352 };
353 
354 static struct i2c_adapter sis5595_adapter = {
355 	.owner		= THIS_MODULE,
356 	.class          = I2C_CLASS_HWMON,
357 	.algo		= &smbus_algorithm,
358 };
359 
360 static const struct pci_device_id sis5595_ids[] = {
361 	{ PCI_DEVICE(PCI_VENDOR_ID_SI, PCI_DEVICE_ID_SI_503) },
362 	{ 0, }
363 };
364 
365 MODULE_DEVICE_TABLE (pci, sis5595_ids);
366 
367 static int sis5595_probe(struct pci_dev *dev, const struct pci_device_id *id)
368 {
369 	int err;
370 
371 	if (sis5595_setup(dev)) {
372 		dev_err(&dev->dev, "SIS5595 not detected, module not inserted.\n");
373 		return -ENODEV;
374 	}
375 
376 	/* set up the sysfs linkage to our parent device */
377 	sis5595_adapter.dev.parent = &dev->dev;
378 
379 	snprintf(sis5595_adapter.name, sizeof(sis5595_adapter.name),
380 		 "SMBus SIS5595 adapter at %04x", sis5595_base + SMB_INDEX);
381 	err = i2c_add_adapter(&sis5595_adapter);
382 	if (err) {
383 		release_region(sis5595_base + SMB_INDEX, 2);
384 		return err;
385 	}
386 
387 	/* Always return failure here.  This is to allow other drivers to bind
388 	 * to this pci device.  We don't really want to have control over the
389 	 * pci device, we only wanted to read as few register values from it.
390 	 */
391 	sis5595_pdev =  pci_dev_get(dev);
392 	return -ENODEV;
393 }
394 
395 static struct pci_driver sis5595_driver = {
396 	.name		= "sis5595_smbus",
397 	.id_table	= sis5595_ids,
398 	.probe		= sis5595_probe,
399 };
400 
401 static int __init i2c_sis5595_init(void)
402 {
403 	return pci_register_driver(&sis5595_driver);
404 }
405 
406 static void __exit i2c_sis5595_exit(void)
407 {
408 	pci_unregister_driver(&sis5595_driver);
409 	if (sis5595_pdev) {
410 		i2c_del_adapter(&sis5595_adapter);
411 		release_region(sis5595_base + SMB_INDEX, 2);
412 		pci_dev_put(sis5595_pdev);
413 		sis5595_pdev = NULL;
414 	}
415 }
416 
417 MODULE_AUTHOR("Frodo Looijaard <frodol@dds.nl>");
418 MODULE_DESCRIPTION("SIS5595 SMBus driver");
419 MODULE_LICENSE("GPL");
420 
421 module_init(i2c_sis5595_init);
422 module_exit(i2c_sis5595_exit);
423