Pull ec into release branch
[linux-2.6] / drivers / sn / ioc4.c
1 /*
2  * This file is subject to the terms and conditions of the GNU General Public
3  * License.  See the file "COPYING" in the main directory of this archive
4  * for more details.
5  *
6  * Copyright (C) 2005 Silicon Graphics, Inc.  All Rights Reserved.
7  */
8
9 /* This file contains the master driver module for use by SGI IOC4 subdrivers.
10  *
11  * It allocates any resources shared between multiple subdevices, and
12  * provides accessor functions (where needed) and the like for those
13  * resources.  It also provides a mechanism for the subdevice modules
14  * to support loading and unloading.
15  *
16  * Non-shared resources (e.g. external interrupt A_INT_OUT register page
17  * alias, serial port and UART registers) are handled by the subdevice
18  * modules themselves.
19  *
20  * This is all necessary because IOC4 is not implemented as a multi-function
21  * PCI device, but an amalgamation of disparate registers for several
22  * types of device (ATA, serial, external interrupts).  The normal
23  * resource management in the kernel doesn't have quite the right interfaces
24  * to handle this situation (e.g. multiple modules can't claim the same
25  * PCI ID), thus this IOC4 master module.
26  */
27
28 #include <linux/errno.h>
29 #include <linux/module.h>
30 #include <linux/pci.h>
31 #include <linux/ioc4.h>
32 #include <linux/mmtimer.h>
33 #include <linux/rtc.h>
34 #include <linux/mutex.h>
35 #include <asm/sn/addrs.h>
36 #include <asm/sn/clksupport.h>
37 #include <asm/sn/shub_mmr.h>
38
39 /***************
40  * Definitions *
41  ***************/
42
43 /* Tweakable values */
44
45 /* PCI bus speed detection/calibration */
46 #define IOC4_CALIBRATE_COUNT 63 /* Calibration cycle period */
47 #define IOC4_CALIBRATE_CYCLES 256       /* Average over this many cycles */
48 #define IOC4_CALIBRATE_DISCARD 2        /* Discard first few cycles */
49 #define IOC4_CALIBRATE_LOW_MHZ 25       /* Lower bound on bus speed sanity */
50 #define IOC4_CALIBRATE_HIGH_MHZ 75      /* Upper bound on bus speed sanity */
51 #define IOC4_CALIBRATE_DEFAULT_MHZ 66   /* Assumed if sanity check fails */
52
53 /************************
54  * Submodule management *
55  ************************/
56
57 static DEFINE_MUTEX(ioc4_mutex);
58
59 static LIST_HEAD(ioc4_devices);
60 static LIST_HEAD(ioc4_submodules);
61
62 /* Register an IOC4 submodule */
63 int
64 ioc4_register_submodule(struct ioc4_submodule *is)
65 {
66         struct ioc4_driver_data *idd;
67
68         mutex_lock(&ioc4_mutex);
69         list_add(&is->is_list, &ioc4_submodules);
70
71         /* Initialize submodule for each IOC4 */
72         if (!is->is_probe)
73                 goto out;
74
75         list_for_each_entry(idd, &ioc4_devices, idd_list) {
76                 if (is->is_probe(idd)) {
77                         printk(KERN_WARNING
78                                "%s: IOC4 submodule %s probe failed "
79                                "for pci_dev %s",
80                                __FUNCTION__, module_name(is->is_owner),
81                                pci_name(idd->idd_pdev));
82                 }
83         }
84  out:
85         mutex_unlock(&ioc4_mutex);
86         return 0;
87 }
88
89 /* Unregister an IOC4 submodule */
90 void
91 ioc4_unregister_submodule(struct ioc4_submodule *is)
92 {
93         struct ioc4_driver_data *idd;
94
95         mutex_lock(&ioc4_mutex);
96         list_del(&is->is_list);
97
98         /* Remove submodule for each IOC4 */
99         if (!is->is_remove)
100                 goto out;
101
102         list_for_each_entry(idd, &ioc4_devices, idd_list) {
103                 if (is->is_remove(idd)) {
104                         printk(KERN_WARNING
105                                "%s: IOC4 submodule %s remove failed "
106                                "for pci_dev %s.\n",
107                                __FUNCTION__, module_name(is->is_owner),
108                                pci_name(idd->idd_pdev));
109                 }
110         }
111  out:
112         mutex_unlock(&ioc4_mutex);
113 }
114
115 /*********************
116  * Device management *
117  *********************/
118
119 #define IOC4_CALIBRATE_LOW_LIMIT \
120         (1000*IOC4_EXTINT_COUNT_DIVISOR/IOC4_CALIBRATE_LOW_MHZ)
121 #define IOC4_CALIBRATE_HIGH_LIMIT \
122         (1000*IOC4_EXTINT_COUNT_DIVISOR/IOC4_CALIBRATE_HIGH_MHZ)
123 #define IOC4_CALIBRATE_DEFAULT \
124         (1000*IOC4_EXTINT_COUNT_DIVISOR/IOC4_CALIBRATE_DEFAULT_MHZ)
125
126 #define IOC4_CALIBRATE_END \
127         (IOC4_CALIBRATE_CYCLES + IOC4_CALIBRATE_DISCARD)
128
129 #define IOC4_INT_OUT_MODE_TOGGLE 0x7    /* Toggle INT_OUT every COUNT+1 ticks */
130
131 /* Determines external interrupt output clock period of the PCI bus an
132  * IOC4 is attached to.  This value can be used to determine the PCI
133  * bus speed.
134  *
135  * IOC4 has a design feature that various internal timers are derived from
136  * the PCI bus clock.  This causes IOC4 device drivers to need to take the
137  * bus speed into account when setting various register values (e.g. INT_OUT
138  * register COUNT field, UART divisors, etc).  Since this information is
139  * needed by several subdrivers, it is determined by the main IOC4 driver,
140  * even though the following code utilizes external interrupt registers
141  * to perform the speed calculation.
142  */
143 static void
144 ioc4_clock_calibrate(struct ioc4_driver_data *idd)
145 {
146         extern unsigned long sn_rtc_cycles_per_second;
147         union ioc4_int_out int_out;
148         union ioc4_gpcr gpcr;
149         unsigned int state, last_state = 1;
150         uint64_t start = 0, end, period;
151         unsigned int count = 0;
152
153         /* Enable output */
154         gpcr.raw = 0;
155         gpcr.fields.dir = IOC4_GPCR_DIR_0;
156         gpcr.fields.int_out_en = 1;
157         writel(gpcr.raw, &idd->idd_misc_regs->gpcr_s.raw);
158
159         /* Reset to power-on state */
160         writel(0, &idd->idd_misc_regs->int_out.raw);
161         mmiowb();
162
163         printk(KERN_INFO
164                "%s: Calibrating PCI bus speed "
165                "for pci_dev %s ... ", __FUNCTION__, pci_name(idd->idd_pdev));
166         /* Set up square wave */
167         int_out.raw = 0;
168         int_out.fields.count = IOC4_CALIBRATE_COUNT;
169         int_out.fields.mode = IOC4_INT_OUT_MODE_TOGGLE;
170         int_out.fields.diag = 0;
171         writel(int_out.raw, &idd->idd_misc_regs->int_out.raw);
172         mmiowb();
173
174         /* Check square wave period averaged over some number of cycles */
175         do {
176                 int_out.raw = readl(&idd->idd_misc_regs->int_out.raw);
177                 state = int_out.fields.int_out;
178                 if (!last_state && state) {
179                         count++;
180                         if (count == IOC4_CALIBRATE_END) {
181                                 end = rtc_time();
182                                 break;
183                         } else if (count == IOC4_CALIBRATE_DISCARD)
184                                 start = rtc_time();
185                 }
186                 last_state = state;
187         } while (1);
188
189         /* Calculation rearranged to preserve intermediate precision.
190          * Logically:
191          * 1. "end - start" gives us number of RTC cycles over all the
192          *    square wave cycles measured.
193          * 2. Divide by number of square wave cycles to get number of
194          *    RTC cycles per square wave cycle.
195          * 3. Divide by 2*(int_out.fields.count+1), which is the formula
196          *    by which the IOC4 generates the square wave, to get the
197          *    number of RTC cycles per IOC4 INT_OUT count.
198          * 4. Divide by sn_rtc_cycles_per_second to get seconds per
199          *    count.
200          * 5. Multiply by 1E9 to get nanoseconds per count.
201          */
202         period = ((end - start) * 1000000000) /
203             (IOC4_CALIBRATE_CYCLES * 2 * (IOC4_CALIBRATE_COUNT + 1)
204              * sn_rtc_cycles_per_second);
205
206         /* Bounds check the result. */
207         if (period > IOC4_CALIBRATE_LOW_LIMIT ||
208             period < IOC4_CALIBRATE_HIGH_LIMIT) {
209                 printk("failed. Assuming PCI clock ticks are %d ns.\n",
210                        IOC4_CALIBRATE_DEFAULT / IOC4_EXTINT_COUNT_DIVISOR);
211                 period = IOC4_CALIBRATE_DEFAULT;
212         } else {
213                 printk("succeeded. PCI clock ticks are %ld ns.\n",
214                        period / IOC4_EXTINT_COUNT_DIVISOR);
215         }
216
217         /* Remember results.  We store the extint clock period rather
218          * than the PCI clock period so that greater precision is
219          * retained.  Divide by IOC4_EXTINT_COUNT_DIVISOR to get
220          * PCI clock period.
221          */
222         idd->count_period = period;
223 }
224
225 /* Adds a new instance of an IOC4 card */
226 static int
227 ioc4_probe(struct pci_dev *pdev, const struct pci_device_id *pci_id)
228 {
229         struct ioc4_driver_data *idd;
230         struct ioc4_submodule *is;
231         uint32_t pcmd;
232         int ret;
233
234         /* Enable IOC4 and take ownership of it */
235         if ((ret = pci_enable_device(pdev))) {
236                 printk(KERN_WARNING
237                        "%s: Failed to enable IOC4 device for pci_dev %s.\n",
238                        __FUNCTION__, pci_name(pdev));
239                 goto out;
240         }
241         pci_set_master(pdev);
242
243         /* Set up per-IOC4 data */
244         idd = kmalloc(sizeof(struct ioc4_driver_data), GFP_KERNEL);
245         if (!idd) {
246                 printk(KERN_WARNING
247                        "%s: Failed to allocate IOC4 data for pci_dev %s.\n",
248                        __FUNCTION__, pci_name(pdev));
249                 ret = -ENODEV;
250                 goto out_idd;
251         }
252         idd->idd_pdev = pdev;
253         idd->idd_pci_id = pci_id;
254
255         /* Map IOC4 misc registers.  These are shared between subdevices
256          * so the main IOC4 module manages them.
257          */
258         idd->idd_bar0 = pci_resource_start(idd->idd_pdev, 0);
259         if (!idd->idd_bar0) {
260                 printk(KERN_WARNING
261                        "%s: Unable to find IOC4 misc resource "
262                        "for pci_dev %s.\n",
263                        __FUNCTION__, pci_name(idd->idd_pdev));
264                 ret = -ENODEV;
265                 goto out_pci;
266         }
267         if (!request_region(idd->idd_bar0, sizeof(struct ioc4_misc_regs),
268                             "ioc4_misc")) {
269                 printk(KERN_WARNING
270                        "%s: Unable to request IOC4 misc region "
271                        "for pci_dev %s.\n",
272                        __FUNCTION__, pci_name(idd->idd_pdev));
273                 ret = -ENODEV;
274                 goto out_pci;
275         }
276         idd->idd_misc_regs = ioremap(idd->idd_bar0,
277                                      sizeof(struct ioc4_misc_regs));
278         if (!idd->idd_misc_regs) {
279                 printk(KERN_WARNING
280                        "%s: Unable to remap IOC4 misc region "
281                        "for pci_dev %s.\n",
282                        __FUNCTION__, pci_name(idd->idd_pdev));
283                 ret = -ENODEV;
284                 goto out_misc_region;
285         }
286
287         /* Failsafe portion of per-IOC4 initialization */
288
289         /* Initialize IOC4 */
290         pci_read_config_dword(idd->idd_pdev, PCI_COMMAND, &pcmd);
291         pci_write_config_dword(idd->idd_pdev, PCI_COMMAND,
292                                pcmd | PCI_COMMAND_PARITY | PCI_COMMAND_SERR);
293
294         /* Determine PCI clock */
295         ioc4_clock_calibrate(idd);
296
297         /* Disable/clear all interrupts.  Need to do this here lest
298          * one submodule request the shared IOC4 IRQ, but interrupt
299          * is generated by a different subdevice.
300          */
301         /* Disable */
302         writel(~0, &idd->idd_misc_regs->other_iec.raw);
303         writel(~0, &idd->idd_misc_regs->sio_iec);
304         /* Clear (i.e. acknowledge) */
305         writel(~0, &idd->idd_misc_regs->other_ir.raw);
306         writel(~0, &idd->idd_misc_regs->sio_ir);
307
308         /* Track PCI-device specific data */
309         idd->idd_serial_data = NULL;
310         pci_set_drvdata(idd->idd_pdev, idd);
311
312         mutex_lock(&ioc4_mutex);
313         list_add_tail(&idd->idd_list, &ioc4_devices);
314
315         /* Add this IOC4 to all submodules */
316         list_for_each_entry(is, &ioc4_submodules, is_list) {
317                 if (is->is_probe && is->is_probe(idd)) {
318                         printk(KERN_WARNING
319                                "%s: IOC4 submodule 0x%s probe failed "
320                                "for pci_dev %s.\n",
321                                __FUNCTION__, module_name(is->is_owner),
322                                pci_name(idd->idd_pdev));
323                 }
324         }
325         mutex_unlock(&ioc4_mutex);
326
327         return 0;
328
329 out_misc_region:
330         release_region(idd->idd_bar0, sizeof(struct ioc4_misc_regs));
331 out_pci:
332         kfree(idd);
333 out_idd:
334         pci_disable_device(pdev);
335 out:
336         return ret;
337 }
338
339 /* Removes a particular instance of an IOC4 card. */
340 static void
341 ioc4_remove(struct pci_dev *pdev)
342 {
343         struct ioc4_submodule *is;
344         struct ioc4_driver_data *idd;
345
346         idd = pci_get_drvdata(pdev);
347
348         /* Remove this IOC4 from all submodules */
349         mutex_lock(&ioc4_mutex);
350         list_for_each_entry(is, &ioc4_submodules, is_list) {
351                 if (is->is_remove && is->is_remove(idd)) {
352                         printk(KERN_WARNING
353                                "%s: IOC4 submodule 0x%s remove failed "
354                                "for pci_dev %s.\n",
355                                __FUNCTION__, module_name(is->is_owner),
356                                pci_name(idd->idd_pdev));
357                 }
358         }
359         mutex_unlock(&ioc4_mutex);
360
361         /* Release resources */
362         iounmap(idd->idd_misc_regs);
363         if (!idd->idd_bar0) {
364                 printk(KERN_WARNING
365                        "%s: Unable to get IOC4 misc mapping for pci_dev %s. "
366                        "Device removal may be incomplete.\n",
367                        __FUNCTION__, pci_name(idd->idd_pdev));
368         }
369         release_region(idd->idd_bar0, sizeof(struct ioc4_misc_regs));
370
371         /* Disable IOC4 and relinquish */
372         pci_disable_device(pdev);
373
374         /* Remove and free driver data */
375         mutex_lock(&ioc4_mutex);
376         list_del(&idd->idd_list);
377         mutex_unlock(&ioc4_mutex);
378         kfree(idd);
379 }
380
381 static struct pci_device_id ioc4_id_table[] = {
382         {PCI_VENDOR_ID_SGI, PCI_DEVICE_ID_SGI_IOC4, PCI_ANY_ID,
383          PCI_ANY_ID, 0x0b4000, 0xFFFFFF},
384         {0}
385 };
386
387 static struct pci_driver __devinitdata ioc4_driver = {
388         .name = "IOC4",
389         .id_table = ioc4_id_table,
390         .probe = ioc4_probe,
391         .remove = ioc4_remove,
392 };
393
394 MODULE_DEVICE_TABLE(pci, ioc4_id_table);
395
396 /*********************
397  * Module management *
398  *********************/
399
400 /* Module load */
401 static int __devinit
402 ioc4_init(void)
403 {
404         return pci_register_driver(&ioc4_driver);
405 }
406
407 /* Module unload */
408 static void __devexit
409 ioc4_exit(void)
410 {
411         pci_unregister_driver(&ioc4_driver);
412 }
413
414 module_init(ioc4_init);
415 module_exit(ioc4_exit);
416
417 MODULE_AUTHOR("Brent Casavant - Silicon Graphics, Inc. <bcasavan@sgi.com>");
418 MODULE_DESCRIPTION("PCI driver master module for SGI IOC4 Base-IO Card");
419 MODULE_LICENSE("GPL");
420
421 EXPORT_SYMBOL(ioc4_register_submodule);
422 EXPORT_SYMBOL(ioc4_unregister_submodule);