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