?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
drm/modes: Fix drm_mode_vrefres() docs
[drm/drm-misc.git] / drivers / i2c / busses / i2c-viapro.c
blob2cc7bba3b8bf8d2f64c4ad1098927e2a2f5a269f
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 Copyright (c) 1998 - 2002 Frodo Looijaard <frodol@dds.nl>,
4 Philip Edelbrock <phil@netroedge.com>, Kyösti Mälkki <kmalkki@cc.hut.fi>,
5 Mark D. Studebaker <mdsxyz123@yahoo.com>
6 Copyright (C) 2005 - 2008 Jean Delvare <jdelvare@suse.de>
7
8 */
9
10 /*
11 Supports the following VIA south bridges:
12
13 Chip name PCI ID REV I2C block
14 VT82C596A 0x3050 no
15 VT82C596B 0x3051 no
16 VT82C686A 0x3057 0x30 no
17 VT82C686B 0x3057 0x40 yes
18 VT8231 0x8235 no?
19 VT8233 0x3074 yes
20 VT8233A 0x3147 yes?
21 VT8235 0x3177 yes
22 VT8237R 0x3227 yes
23 VT8237A 0x3337 yes
24 VT8237S 0x3372 yes
25 VT8251 0x3287 yes
26 CX700 0x8324 yes
27 VX800/VX820 0x8353 yes
28 VX855/VX875 0x8409 yes
29
30 Note: we assume there can only be one device, with one SMBus interface.
31 */
32
33 #include <linux/module.h>
34 #include <linux/delay.h>
35 #include <linux/pci.h>
36 #include <linux/kernel.h>
37 #include <linux/stddef.h>
38 #include <linux/ioport.h>
39 #include <linux/i2c.h>
40 #include <linux/init.h>
41 #include <linux/acpi.h>
42 #include <linux/io.h>
43
44 static struct pci_dev *vt596_pdev;
45
46 #define SMBBA1 0x90
47 #define SMBBA2 0x80
48 #define SMBBA3 0xD0
49
50 /* SMBus address offsets */
51 static unsigned short vt596_smba;
52 #define SMBHSTSTS (vt596_smba + 0)
53 #define SMBHSTCNT (vt596_smba + 2)
54 #define SMBHSTCMD (vt596_smba + 3)
55 #define SMBHSTADD (vt596_smba + 4)
56 #define SMBHSTDAT0 (vt596_smba + 5)
57 #define SMBHSTDAT1 (vt596_smba + 6)
58 #define SMBBLKDAT (vt596_smba + 7)
59
60 /* PCI Address Constants */
61
62 /* SMBus data in configuration space can be found in two places,
63 We try to select the better one */
64
65 static unsigned short SMBHSTCFG = 0xD2;
66
67 /* Other settings */
68 #define MAX_TIMEOUT 500
69
70 /* VT82C596 constants */
71 #define VT596_QUICK 0x00
72 #define VT596_BYTE 0x04
73 #define VT596_BYTE_DATA 0x08
74 #define VT596_WORD_DATA 0x0C
75 #define VT596_PROC_CALL 0x10
76 #define VT596_BLOCK_DATA 0x14
77 #define VT596_I2C_BLOCK_DATA 0x34
78
79
80 /* If force is set to anything different from 0, we forcibly enable the
81 VT596. DANGEROUS! */
82 static bool force;
83 module_param(force, bool, 0);
84 MODULE_PARM_DESC(force, "Forcibly enable the SMBus. DANGEROUS!");
85
86 /* If force_addr is set to anything different from 0, we forcibly enable
87 the VT596 at the given address. VERY DANGEROUS! */
88 static u16 force_addr;
89 module_param_hw(force_addr, ushort, ioport, 0);
90 MODULE_PARM_DESC(force_addr,
91 "Forcibly enable the SMBus at the given address. "
92 "EXTREMELY DANGEROUS!");
93
94
95 static struct pci_driver vt596_driver;
96 static struct i2c_adapter vt596_adapter;
97
98 #define FEATURE_I2CBLOCK (1<<0)
99 static unsigned int vt596_features;
100
101 #ifdef DEBUG
102 static void vt596_dump_regs(const char *msg, u8 size)
103 {
104 dev_dbg(&vt596_adapter.dev, "%s: STS=%02x CNT=%02x CMD=%02x ADD=%02x "
105 "DAT=%02x,%02x\n", msg, inb_p(SMBHSTSTS), inb_p(SMBHSTCNT),
106 inb_p(SMBHSTCMD), inb_p(SMBHSTADD), inb_p(SMBHSTDAT0),
107 inb_p(SMBHSTDAT1));
108
109 if (size == VT596_BLOCK_DATA
110 || size == VT596_I2C_BLOCK_DATA) {
111 int i;
112
113 dev_dbg(&vt596_adapter.dev, "BLK=");
114 for (i = 0; i < I2C_SMBUS_BLOCK_MAX / 2; i++)
115 printk("%02x,", inb_p(SMBBLKDAT));
116 printk("\n");
117 dev_dbg(&vt596_adapter.dev, " ");
118 for (; i < I2C_SMBUS_BLOCK_MAX - 1; i++)
119 printk("%02x,", inb_p(SMBBLKDAT));
120 printk("%02x\n", inb_p(SMBBLKDAT));
121 }
122 }
123 #else
124 static inline void vt596_dump_regs(const char *msg, u8 size) { }
125 #endif
126
127 /* Return -1 on error, 0 on success */
128 static int vt596_transaction(u8 size)
129 {
130 int temp;
131 int result = 0;
132 int timeout = 0;
133
134 vt596_dump_regs("Transaction (pre)", size);
135
136 /* Make sure the SMBus host is ready to start transmitting */
137 if ((temp = inb_p(SMBHSTSTS)) & 0x1F) {
138 dev_dbg(&vt596_adapter.dev, "SMBus busy (0x%02x). "
139 "Resetting...\n", temp);
140
141 outb_p(temp, SMBHSTSTS);
142 if ((temp = inb_p(SMBHSTSTS)) & 0x1F) {
143 dev_err(&vt596_adapter.dev, "SMBus reset failed! "
144 "(0x%02x)\n", temp);
145 return -EBUSY;
146 }
147 }
148
149 /* Start the transaction by setting bit 6 */
150 outb_p(0x40 | size, SMBHSTCNT);
151
152 /* We will always wait for a fraction of a second */
153 do {
154 msleep(1);
155 temp = inb_p(SMBHSTSTS);
156 } while ((temp & 0x01) && (++timeout < MAX_TIMEOUT));
157
158 /* If the SMBus is still busy, we give up */
159 if (timeout == MAX_TIMEOUT) {
160 result = -ETIMEDOUT;
161 dev_err(&vt596_adapter.dev, "SMBus timeout!\n");
162 }
163
164 if (temp & 0x10) {
165 result = -EIO;
166 dev_err(&vt596_adapter.dev, "Transaction failed (0x%02x)\n",
167 size);
168 }
169
170 if (temp & 0x08) {
171 result = -EIO;
172 dev_err(&vt596_adapter.dev, "SMBus collision!\n");
173 }
174
175 if (temp & 0x04) {
176 result = -ENXIO;
177 dev_dbg(&vt596_adapter.dev, "No response\n");
178 }
179
180 /* Resetting status register */
181 if (temp & 0x1F)
182 outb_p(temp, SMBHSTSTS);
183
184 vt596_dump_regs("Transaction (post)", size);
185
186 return result;
187 }
188
189 /* Return negative errno on error, 0 on success */
190 static s32 vt596_access(struct i2c_adapter *adap, u16 addr,
191 unsigned short flags, char read_write, u8 command,
192 int size, union i2c_smbus_data *data)
193 {
194 int i;
195 int status;
196
197 switch (size) {
198 case I2C_SMBUS_QUICK:
199 size = VT596_QUICK;
200 break;
201 case I2C_SMBUS_BYTE:
202 if (read_write == I2C_SMBUS_WRITE)
203 outb_p(command, SMBHSTCMD);
204 size = VT596_BYTE;
205 break;
206 case I2C_SMBUS_BYTE_DATA:
207 outb_p(command, SMBHSTCMD);
208 if (read_write == I2C_SMBUS_WRITE)
209 outb_p(data->byte, SMBHSTDAT0);
210 size = VT596_BYTE_DATA;
211 break;
212 case I2C_SMBUS_WORD_DATA:
213 outb_p(command, SMBHSTCMD);
214 if (read_write == I2C_SMBUS_WRITE) {
215 outb_p(data->word & 0xff, SMBHSTDAT0);
216 outb_p((data->word & 0xff00) >> 8, SMBHSTDAT1);
217 }
218 size = VT596_WORD_DATA;
219 break;
220 case I2C_SMBUS_PROC_CALL:
221 outb_p(command, SMBHSTCMD);
222 outb_p(data->word & 0xff, SMBHSTDAT0);
223 outb_p((data->word & 0xff00) >> 8, SMBHSTDAT1);
224 size = VT596_PROC_CALL;
225 break;
226 case I2C_SMBUS_I2C_BLOCK_DATA:
227 if (!(vt596_features & FEATURE_I2CBLOCK))
228 goto exit_unsupported;
229 if (read_write == I2C_SMBUS_READ)
230 outb_p(data->block[0], SMBHSTDAT0);
231 fallthrough;
232 case I2C_SMBUS_BLOCK_DATA:
233 outb_p(command, SMBHSTCMD);
234 if (read_write == I2C_SMBUS_WRITE) {
235 u8 len = data->block[0];
236 if (len > I2C_SMBUS_BLOCK_MAX)
237 len = I2C_SMBUS_BLOCK_MAX;
238 outb_p(len, SMBHSTDAT0);
239 inb_p(SMBHSTCNT); /* Reset SMBBLKDAT */
240 for (i = 1; i <= len; i++)
241 outb_p(data->block[i], SMBBLKDAT);
242 }
243 size = (size == I2C_SMBUS_I2C_BLOCK_DATA) ?
244 VT596_I2C_BLOCK_DATA : VT596_BLOCK_DATA;
245 break;
246 default:
247 goto exit_unsupported;
248 }
249
250 outb_p(((addr & 0x7f) << 1) | read_write, SMBHSTADD);
251
252 status = vt596_transaction(size);
253 if (status)
254 return status;
255
256 if (size == VT596_PROC_CALL)
257 read_write = I2C_SMBUS_READ;
258
259 if ((read_write == I2C_SMBUS_WRITE) || (size == VT596_QUICK))
260 return 0;
261
262 switch (size) {
263 case VT596_BYTE:
264 case VT596_BYTE_DATA:
265 data->byte = inb_p(SMBHSTDAT0);
266 break;
267 case VT596_WORD_DATA:
268 case VT596_PROC_CALL:
269 data->word = inb_p(SMBHSTDAT0) + (inb_p(SMBHSTDAT1) << 8);
270 break;
271 case VT596_I2C_BLOCK_DATA:
272 case VT596_BLOCK_DATA:
273 data->block[0] = inb_p(SMBHSTDAT0);
274 if (data->block[0] > I2C_SMBUS_BLOCK_MAX)
275 data->block[0] = I2C_SMBUS_BLOCK_MAX;
276 inb_p(SMBHSTCNT); /* Reset SMBBLKDAT */
277 for (i = 1; i <= data->block[0]; i++)
278 data->block[i] = inb_p(SMBBLKDAT);
279 break;
280 }
281 return 0;
282
283 exit_unsupported:
284 dev_warn(&vt596_adapter.dev, "Unsupported transaction %d\n",
285 size);
286 return -EOPNOTSUPP;
287 }
288
289 static u32 vt596_func(struct i2c_adapter *adapter)
290 {
291 u32 func = I2C_FUNC_SMBUS_QUICK | I2C_FUNC_SMBUS_BYTE |
292 I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA |
293 I2C_SMBUS_PROC_CALL | I2C_FUNC_SMBUS_BLOCK_DATA;
294
295 if (vt596_features & FEATURE_I2CBLOCK)
296 func |= I2C_FUNC_SMBUS_I2C_BLOCK;
297 return func;
298 }
299
300 static const struct i2c_algorithm smbus_algorithm = {
301 .smbus_xfer = vt596_access,
302 .functionality = vt596_func,
303 };
304
305 static struct i2c_adapter vt596_adapter = {
306 .owner = THIS_MODULE,
307 .class = I2C_CLASS_HWMON,
308 .algo = &smbus_algorithm,
309 };
310
311 static int vt596_probe(struct pci_dev *pdev,
312 const struct pci_device_id *id)
313 {
314 unsigned char temp;
315 int error;
316
317 /* Determine the address of the SMBus areas */
318 if (force_addr) {
319 vt596_smba = force_addr & 0xfff0;
320 force = 0;
321 goto found;
322 }
323
324 if ((pci_read_config_word(pdev, id->driver_data, &vt596_smba)) ||
325 !(vt596_smba & 0x0001)) {
326 /* try 2nd address and config reg. for 596 */
327 if (id->device == PCI_DEVICE_ID_VIA_82C596_3 &&
328 !pci_read_config_word(pdev, SMBBA2, &vt596_smba) &&
329 (vt596_smba & 0x0001)) {
330 SMBHSTCFG = 0x84;
331 } else {
332 /* no matches at all */
333 dev_err(&pdev->dev, "Cannot configure "
334 "SMBus I/O Base address\n");
335 return -ENODEV;
336 }
337 }
338
339 vt596_smba &= 0xfff0;
340 if (vt596_smba == 0) {
341 dev_err(&pdev->dev, "SMBus base address "
342 "uninitialized - upgrade BIOS or use "
343 "force_addr=0xaddr\n");
344 return -ENODEV;
345 }
346
347 found:
348 error = acpi_check_region(vt596_smba, 8, vt596_driver.name);
349 if (error)
350 return -ENODEV;
351
352 if (!request_region(vt596_smba, 8, vt596_driver.name)) {
353 dev_err(&pdev->dev, "SMBus region 0x%x already in use!\n",
354 vt596_smba);
355 return -ENODEV;
356 }
357
358 pci_read_config_byte(pdev, SMBHSTCFG, &temp);
359 /* If force_addr is set, we program the new address here. Just to make
360 sure, we disable the VT596 first. */
361 if (force_addr) {
362 pci_write_config_byte(pdev, SMBHSTCFG, temp & 0xfe);
363 pci_write_config_word(pdev, id->driver_data, vt596_smba);
364 pci_write_config_byte(pdev, SMBHSTCFG, temp | 0x01);
365 dev_warn(&pdev->dev, "WARNING: SMBus interface set to new "
366 "address 0x%04x!\n", vt596_smba);
367 } else if (!(temp & 0x01)) {
368 if (force) {
369 /* NOTE: This assumes I/O space and other allocations
370 * WERE done by the Bios! Don't complain if your
371 * hardware does weird things after enabling this.
372 * :') Check for Bios updates before resorting to
373 * this.
374 */
375 pci_write_config_byte(pdev, SMBHSTCFG, temp | 0x01);
376 dev_info(&pdev->dev, "Enabling SMBus device\n");
377 } else {
378 dev_err(&pdev->dev, "SMBUS: Error: Host SMBus "
379 "controller not enabled! - upgrade BIOS or "
380 "use force=1\n");
381 error = -ENODEV;
382 goto release_region;
383 }
384 }
385
386 dev_dbg(&pdev->dev, "VT596_smba = 0x%X\n", vt596_smba);
387
388 switch (pdev->device) {
389 case PCI_DEVICE_ID_VIA_CX700:
390 case PCI_DEVICE_ID_VIA_VX800:
391 case PCI_DEVICE_ID_VIA_VX855:
392 case PCI_DEVICE_ID_VIA_VX900:
393 case PCI_DEVICE_ID_VIA_8251:
394 case PCI_DEVICE_ID_VIA_8237:
395 case PCI_DEVICE_ID_VIA_8237A:
396 case PCI_DEVICE_ID_VIA_8237S:
397 case PCI_DEVICE_ID_VIA_8235:
398 case PCI_DEVICE_ID_VIA_8233A:
399 case PCI_DEVICE_ID_VIA_8233_0:
400 vt596_features |= FEATURE_I2CBLOCK;
401 break;
402 case PCI_DEVICE_ID_VIA_82C686_4:
403 /* The VT82C686B (rev 0x40) does support I2C block
404 transactions, but the VT82C686A (rev 0x30) doesn't */
405 if (pdev->revision >= 0x40)
406 vt596_features |= FEATURE_I2CBLOCK;
407 break;
408 }
409
410 vt596_adapter.dev.parent = &pdev->dev;
411 snprintf(vt596_adapter.name, sizeof(vt596_adapter.name),
412 "SMBus Via Pro adapter at %04x", vt596_smba);
413
414 vt596_pdev = pci_dev_get(pdev);
415 error = i2c_add_adapter(&vt596_adapter);
416 if (error) {
417 pci_dev_put(vt596_pdev);
418 vt596_pdev = NULL;
419 goto release_region;
420 }
421
422 /* Always return failure here. This is to allow other drivers to bind
423 * to this pci device. We don't really want to have control over the
424 * pci device, we only wanted to read as few register values from it.
425 */
426 return -ENODEV;
427
428 release_region:
429 release_region(vt596_smba, 8);
430 return error;
431 }
432
433 static const struct pci_device_id vt596_ids[] = {
434 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_82C596_3),
435 .driver_data = SMBBA1 },
436 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_82C596B_3),
437 .driver_data = SMBBA1 },
438 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_82C686_4),
439 .driver_data = SMBBA1 },
440 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8233_0),
441 .driver_data = SMBBA3 },
442 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8233A),
443 .driver_data = SMBBA3 },
444 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8235),
445 .driver_data = SMBBA3 },
446 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8237),
447 .driver_data = SMBBA3 },
448 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8237A),
449 .driver_data = SMBBA3 },
450 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8237S),
451 .driver_data = SMBBA3 },
452 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8231_4),
453 .driver_data = SMBBA1 },
454 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_8251),
455 .driver_data = SMBBA3 },
456 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_CX700),
457 .driver_data = SMBBA3 },
458 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_VX800),
459 .driver_data = SMBBA3 },
460 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_VX855),
461 .driver_data = SMBBA3 },
462 { PCI_DEVICE(PCI_VENDOR_ID_VIA, PCI_DEVICE_ID_VIA_VX900),
463 .driver_data = SMBBA3 },
464 { 0, }
465 };
466
467 MODULE_DEVICE_TABLE(pci, vt596_ids);
468
469 static struct pci_driver vt596_driver = {
470 .name = "vt596_smbus",
471 .id_table = vt596_ids,
472 .probe = vt596_probe,
473 };
474
475 static int __init i2c_vt596_init(void)
476 {
477 return pci_register_driver(&vt596_driver);
478 }
479
480
481 static void __exit i2c_vt596_exit(void)
482 {
483 pci_unregister_driver(&vt596_driver);
484 if (vt596_pdev != NULL) {
485 i2c_del_adapter(&vt596_adapter);
486 release_region(vt596_smba, 8);
487 pci_dev_put(vt596_pdev);
488 vt596_pdev = NULL;
489 }
490 }
491
492 MODULE_AUTHOR("Kyosti Malkki <kmalkki@cc.hut.fi>");
493 MODULE_AUTHOR("Mark D. Studebaker <mdsxyz123@yahoo.com>");
494 MODULE_AUTHOR("Jean Delvare <jdelvare@suse.de>");
495 MODULE_DESCRIPTION("vt82c596 SMBus driver");
496 MODULE_LICENSE("GPL");
497
498 module_init(i2c_vt596_init);
499 module_exit(i2c_vt596_exit);
Kernel DRM miscellaneous fixes and cross-tree changes