4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * as published by the Free Software Foundation; either version
7 * 2 of the License, or (at your option) any later version.
9 * Copyright (c) 1999 The Puffin Group
10 * Copyright (c) 2001 Matthew Wilcox for Hewlett Packard
11 * Copyright (c) 2001 Helge Deller <deller@gmx.de>
12 * Copyright (c) 2001,2002 Ryan Bradetich
13 * Copyright (c) 2004-2005 Thibaut VARENE <varenet@parisc-linux.org>
15 * The file handles registering devices and drivers, then matching them.
16 * It's the closest we get to a dating agency.
18 * If you're thinking about modifying this file, here are some gotchas to
20 * - 715/Mirage device paths have a dummy device between Lasi and its children
21 * - The EISA adapter may show up as a sibling or child of Wax
22 * - Dino has an optionally functional serial port. If firmware enables it,
23 * it shows up as a child of Dino. If firmware disables it, the buswalk
24 * finds it and it shows up as a child of Cujo
25 * - Dino has both parisc and pci devices as children
26 * - parisc devices are discovered in a random order, including children
27 * before parents in some cases.
30 #include <linux/slab.h>
31 #include <linux/types.h>
32 #include <linux/kernel.h>
33 #include <linux/pci.h>
34 #include <linux/spinlock.h>
35 #include <linux/string.h>
36 #include <asm/hardware.h>
39 #include <asm/parisc-device.h>
41 /* See comments in include/asm-parisc/pci.h */
42 struct hppa_dma_ops *hppa_dma_ops __read_mostly;
43 EXPORT_SYMBOL(hppa_dma_ops);
45 static struct device root = {
46 .init_name = "parisc",
49 static inline int check_dev(struct device *dev)
51 if (dev->bus == &parisc_bus_type) {
52 struct parisc_device *pdev;
53 pdev = to_parisc_device(dev);
54 return pdev->id.hw_type != HPHW_FAULTY;
59 static struct device *
60 parse_tree_node(struct device *parent, int index, struct hardware_path *modpath);
62 struct recurse_struct {
64 int (*fn)(struct device *, void *);
67 static int descend_children(struct device * dev, void * data)
69 struct recurse_struct * recurse_data = (struct recurse_struct *)data;
71 if (recurse_data->fn(dev, recurse_data->obj))
74 return device_for_each_child(dev, recurse_data, descend_children);
78 * for_each_padev - Iterate over all devices in the tree
79 * @fn: Function to call for each device.
80 * @data: Data to pass to the called function.
82 * This performs a depth-first traversal of the tree, calling the
83 * function passed for each node. It calls the function for parents
87 static int for_each_padev(int (*fn)(struct device *, void *), void * data)
89 struct recurse_struct recurse_data = {
93 return device_for_each_child(&root, &recurse_data, descend_children);
97 * match_device - Report whether this driver can handle this device
98 * @driver: the PA-RISC driver to try
99 * @dev: the PA-RISC device to try
101 static int match_device(struct parisc_driver *driver, struct parisc_device *dev)
103 const struct parisc_device_id *ids;
105 for (ids = driver->id_table; ids->sversion; ids++) {
106 if ((ids->sversion != SVERSION_ANY_ID) &&
107 (ids->sversion != dev->id.sversion))
110 if ((ids->hw_type != HWTYPE_ANY_ID) &&
111 (ids->hw_type != dev->id.hw_type))
114 if ((ids->hversion != HVERSION_ANY_ID) &&
115 (ids->hversion != dev->id.hversion))
123 static int parisc_driver_probe(struct device *dev)
126 struct parisc_device *pa_dev = to_parisc_device(dev);
127 struct parisc_driver *pa_drv = to_parisc_driver(dev->driver);
129 rc = pa_drv->probe(pa_dev);
132 pa_dev->driver = pa_drv;
137 static int parisc_driver_remove(struct device *dev)
139 struct parisc_device *pa_dev = to_parisc_device(dev);
140 struct parisc_driver *pa_drv = to_parisc_driver(dev->driver);
142 pa_drv->remove(pa_dev);
149 * register_parisc_driver - Register this driver if it can handle a device
150 * @driver: the PA-RISC driver to try
152 int register_parisc_driver(struct parisc_driver *driver)
154 /* FIXME: we need this because apparently the sti
155 * driver can be registered twice */
156 if(driver->drv.name) {
158 "BUG: skipping previously registered driver %s\n",
163 if (!driver->probe) {
165 "BUG: driver %s has no probe routine\n",
170 driver->drv.bus = &parisc_bus_type;
172 /* We install our own probe and remove routines */
173 WARN_ON(driver->drv.probe != NULL);
174 WARN_ON(driver->drv.remove != NULL);
176 driver->drv.name = driver->name;
178 return driver_register(&driver->drv);
180 EXPORT_SYMBOL(register_parisc_driver);
184 struct parisc_driver * driver;
188 static int match_and_count(struct device * dev, void * data)
190 struct match_count * m = data;
191 struct parisc_device * pdev = to_parisc_device(dev);
193 if (check_dev(dev)) {
194 if (match_device(m->driver, pdev))
201 * count_parisc_driver - count # of devices this driver would match
202 * @driver: the PA-RISC driver to try
204 * Use by IOMMU support to "guess" the right size IOPdir.
205 * Formula is something like memsize/(num_iommu * entry_size).
207 int count_parisc_driver(struct parisc_driver *driver)
209 struct match_count m = {
214 for_each_padev(match_and_count, &m);
222 * unregister_parisc_driver - Unregister this driver from the list of drivers
223 * @driver: the PA-RISC driver to unregister
225 int unregister_parisc_driver(struct parisc_driver *driver)
227 driver_unregister(&driver->drv);
230 EXPORT_SYMBOL(unregister_parisc_driver);
234 struct parisc_device * dev;
237 static int find_device(struct device * dev, void * data)
239 struct parisc_device * pdev = to_parisc_device(dev);
240 struct find_data * d = (struct find_data*)data;
242 if (check_dev(dev)) {
243 if (pdev->hpa.start == d->hpa) {
251 static struct parisc_device *find_device_by_addr(unsigned long hpa)
253 struct find_data d = {
258 ret = for_each_padev(find_device, &d);
259 return ret ? d.dev : NULL;
263 * find_pa_parent_type - Find a parent of a specific type
264 * @dev: The device to start searching from
265 * @type: The device type to search for.
267 * Walks up the device tree looking for a device of the specified type.
268 * If it finds it, it returns it. If not, it returns NULL.
270 const struct parisc_device *
271 find_pa_parent_type(const struct parisc_device *padev, int type)
273 const struct device *dev = &padev->dev;
274 while (dev != &root) {
275 struct parisc_device *candidate = to_parisc_device(dev);
276 if (candidate->id.hw_type == type)
285 static inline int is_pci_dev(struct device *dev)
287 return dev->bus == &pci_bus_type;
290 static inline int is_pci_dev(struct device *dev)
297 * get_node_path fills in @path with the firmware path to the device.
298 * Note that if @node is a parisc device, we don't fill in the 'mod' field.
299 * This is because both callers pass the parent and fill in the mod
300 * themselves. If @node is a PCI device, we do fill it in, even though this
303 static void get_node_path(struct device *dev, struct hardware_path *path)
306 memset(&path->bc, -1, 6);
308 if (is_pci_dev(dev)) {
309 unsigned int devfn = to_pci_dev(dev)->devfn;
310 path->mod = PCI_FUNC(devfn);
311 path->bc[i--] = PCI_SLOT(devfn);
315 while (dev != &root) {
316 if (is_pci_dev(dev)) {
317 unsigned int devfn = to_pci_dev(dev)->devfn;
318 path->bc[i--] = PCI_SLOT(devfn) | (PCI_FUNC(devfn)<< 5);
319 } else if (dev->bus == &parisc_bus_type) {
320 path->bc[i--] = to_parisc_device(dev)->hw_path;
326 static char *print_hwpath(struct hardware_path *path, char *output)
329 for (i = 0; i < 6; i++) {
330 if (path->bc[i] == -1)
332 output += sprintf(output, "%u/", (unsigned char) path->bc[i]);
334 output += sprintf(output, "%u", (unsigned char) path->mod);
339 * print_pa_hwpath - Returns hardware path for PA devices
340 * dev: The device to return the path for
341 * output: Pointer to a previously-allocated array to place the path in.
343 * This function fills in the output array with a human-readable path
344 * to a PA device. This string is compatible with that used by PDC, and
345 * may be printed on the outside of the box.
347 char *print_pa_hwpath(struct parisc_device *dev, char *output)
349 struct hardware_path path;
351 get_node_path(dev->dev.parent, &path);
352 path.mod = dev->hw_path;
353 return print_hwpath(&path, output);
355 EXPORT_SYMBOL(print_pa_hwpath);
357 #if defined(CONFIG_PCI) || defined(CONFIG_ISA)
359 * get_pci_node_path - Determines the hardware path for a PCI device
360 * @pdev: The device to return the path for
361 * @path: Pointer to a previously-allocated array to place the path in.
363 * This function fills in the hardware_path structure with the route to
364 * the specified PCI device. This structure is suitable for passing to
367 void get_pci_node_path(struct pci_dev *pdev, struct hardware_path *path)
369 get_node_path(&pdev->dev, path);
371 EXPORT_SYMBOL(get_pci_node_path);
374 * print_pci_hwpath - Returns hardware path for PCI devices
375 * dev: The device to return the path for
376 * output: Pointer to a previously-allocated array to place the path in.
378 * This function fills in the output array with a human-readable path
379 * to a PCI device. This string is compatible with that used by PDC, and
380 * may be printed on the outside of the box.
382 char *print_pci_hwpath(struct pci_dev *dev, char *output)
384 struct hardware_path path;
386 get_pci_node_path(dev, &path);
387 return print_hwpath(&path, output);
389 EXPORT_SYMBOL(print_pci_hwpath);
391 #endif /* defined(CONFIG_PCI) || defined(CONFIG_ISA) */
393 static void setup_bus_id(struct parisc_device *padev)
395 struct hardware_path path;
400 get_node_path(padev->dev.parent, &path);
402 for (i = 0; i < 6; i++) {
403 if (path.bc[i] == -1)
405 output += sprintf(output, "%u:", (unsigned char) path.bc[i]);
407 sprintf(output, "%u", (unsigned char) padev->hw_path);
408 dev_set_name(&padev->dev, name);
411 struct parisc_device * create_tree_node(char id, struct device *parent)
413 struct parisc_device *dev = kzalloc(sizeof(*dev), GFP_KERNEL);
418 dev->id.hw_type = HPHW_FAULTY;
420 dev->dev.parent = parent;
423 dev->dev.bus = &parisc_bus_type;
424 dev->dma_mask = 0xffffffffUL; /* PARISC devices are 32-bit */
426 /* make the generic dma mask a pointer to the parisc one */
427 dev->dev.dma_mask = &dev->dma_mask;
428 dev->dev.coherent_dma_mask = dev->dma_mask;
429 if (device_register(&dev->dev)) {
437 struct match_id_data {
439 struct parisc_device * dev;
442 static int match_by_id(struct device * dev, void * data)
444 struct parisc_device * pdev = to_parisc_device(dev);
445 struct match_id_data * d = data;
447 if (pdev->hw_path == d->id) {
455 * alloc_tree_node - returns a device entry in the iotree
456 * @parent: the parent node in the tree
457 * @id: the element of the module path for this entry
459 * Checks all the children of @parent for a matching @id. If none
460 * found, it allocates a new device and returns it.
462 static struct parisc_device * alloc_tree_node(struct device *parent, char id)
464 struct match_id_data d = {
467 if (device_for_each_child(parent, &d, match_by_id))
470 return create_tree_node(id, parent);
473 static struct parisc_device *create_parisc_device(struct hardware_path *modpath)
476 struct device *parent = &root;
477 for (i = 0; i < 6; i++) {
478 if (modpath->bc[i] == -1)
480 parent = &alloc_tree_node(parent, modpath->bc[i])->dev;
482 return alloc_tree_node(parent, modpath->mod);
485 struct parisc_device *
486 alloc_pa_dev(unsigned long hpa, struct hardware_path *mod_path)
489 unsigned long bytecnt;
491 struct parisc_device *dev;
494 /* Check to make sure this device has not already been added - Ryan */
495 if (find_device_by_addr(hpa) != NULL)
498 status = pdc_iodc_read(&bytecnt, hpa, 0, &iodc_data, 32);
499 if (status != PDC_OK)
502 dev = create_parisc_device(mod_path);
503 if (dev->id.hw_type != HPHW_FAULTY) {
504 printk(KERN_ERR "Two devices have hardware path [%s]. "
505 "IODC data for second device: "
506 "%02x%02x%02x%02x%02x%02x\n"
507 "Rearranging GSC cards sometimes helps\n",
508 parisc_pathname(dev), iodc_data[0], iodc_data[1],
509 iodc_data[3], iodc_data[4], iodc_data[5], iodc_data[6]);
513 dev->id.hw_type = iodc_data[3] & 0x1f;
514 dev->id.hversion = (iodc_data[0] << 4) | ((iodc_data[1] & 0xf0) >> 4);
515 dev->id.hversion_rev = iodc_data[1] & 0x0f;
516 dev->id.sversion = ((iodc_data[4] & 0x0f) << 16) |
517 (iodc_data[5] << 8) | iodc_data[6];
518 dev->hpa.name = parisc_pathname(dev);
519 dev->hpa.start = hpa;
520 /* This is awkward. The STI spec says that gfx devices may occupy
521 * 32MB or 64MB. Unfortunately, we don't know how to tell whether
522 * it's the former or the latter. Assumptions either way can hurt us.
524 if (hpa == 0xf4000000 || hpa == 0xf8000000) {
525 dev->hpa.end = hpa + 0x03ffffff;
526 } else if (hpa == 0xf6000000 || hpa == 0xfa000000) {
527 dev->hpa.end = hpa + 0x01ffffff;
529 dev->hpa.end = hpa + 0xfff;
531 dev->hpa.flags = IORESOURCE_MEM;
532 name = parisc_hardware_description(&dev->id);
534 strlcpy(dev->name, name, sizeof(dev->name));
537 /* Silently fail things like mouse ports which are subsumed within
538 * the keyboard controller
540 if ((hpa & 0xfff) == 0 && insert_resource(&iomem_resource, &dev->hpa))
541 printk("Unable to claim HPA %lx for device %s\n",
547 static int parisc_generic_match(struct device *dev, struct device_driver *drv)
549 return match_device(to_parisc_driver(drv), to_parisc_device(dev));
552 #define pa_dev_attr(name, field, format_string) \
553 static ssize_t name##_show(struct device *dev, struct device_attribute *attr, char *buf) \
555 struct parisc_device *padev = to_parisc_device(dev); \
556 return sprintf(buf, format_string, padev->field); \
559 #define pa_dev_attr_id(field, format) pa_dev_attr(field, id.field, format)
561 pa_dev_attr(irq, irq, "%u\n");
562 pa_dev_attr_id(hw_type, "0x%02x\n");
563 pa_dev_attr(rev, id.hversion_rev, "0x%x\n");
564 pa_dev_attr_id(hversion, "0x%03x\n");
565 pa_dev_attr_id(sversion, "0x%05x\n");
567 static ssize_t modalias_show(struct device *dev, struct device_attribute *attr, char *buf)
569 struct parisc_device *padev = to_parisc_device(dev);
570 struct parisc_device_id *id = &padev->id;
572 return sprintf(buf, "parisc:t%02Xhv%04Xrev%02Xsv%08X\n",
573 (u8)id->hw_type, (u16)id->hversion, (u8)id->hversion_rev,
577 static struct device_attribute parisc_device_attrs[] = {
587 struct bus_type parisc_bus_type = {
589 .match = parisc_generic_match,
590 .dev_attrs = parisc_device_attrs,
591 .probe = parisc_driver_probe,
592 .remove = parisc_driver_remove,
596 * register_parisc_device - Locate a driver to manage this device.
597 * @dev: The parisc device.
599 * Search the driver list for a driver that is willing to manage
602 int register_parisc_device(struct parisc_device *dev)
614 * match_pci_device - Matches a pci device against a given hardware path
616 * @dev: the generic device (known to be contained by a pci_dev).
617 * @index: the current BC index
618 * @modpath: the hardware path.
619 * @return: true if the device matches the hardware path.
621 static int match_pci_device(struct device *dev, int index,
622 struct hardware_path *modpath)
624 struct pci_dev *pdev = to_pci_dev(dev);
628 /* we are at the end of the path, and on the actual device */
629 unsigned int devfn = pdev->devfn;
630 return ((modpath->bc[5] == PCI_SLOT(devfn)) &&
631 (modpath->mod == PCI_FUNC(devfn)));
634 id = PCI_SLOT(pdev->devfn) | (PCI_FUNC(pdev->devfn) << 5);
635 return (modpath->bc[index] == id);
639 * match_parisc_device - Matches a parisc device against a given hardware
641 * @dev: the generic device (known to be contained by a parisc_device).
642 * @index: the current BC index
643 * @modpath: the hardware path.
644 * @return: true if the device matches the hardware path.
646 static int match_parisc_device(struct device *dev, int index,
647 struct hardware_path *modpath)
649 struct parisc_device *curr = to_parisc_device(dev);
650 char id = (index == 6) ? modpath->mod : modpath->bc[index];
652 return (curr->hw_path == id);
655 struct parse_tree_data {
657 struct hardware_path * modpath;
661 static int check_parent(struct device * dev, void * data)
663 struct parse_tree_data * d = data;
665 if (check_dev(dev)) {
666 if (dev->bus == &parisc_bus_type) {
667 if (match_parisc_device(dev, d->index, d->modpath))
669 } else if (is_pci_dev(dev)) {
670 if (match_pci_device(dev, d->index, d->modpath))
672 } else if (dev->bus == NULL) {
673 /* we are on a bus bridge */
674 struct device *new = parse_tree_node(dev, d->index, d->modpath);
679 return d->dev != NULL;
683 * parse_tree_node - returns a device entry in the iotree
684 * @parent: the parent node in the tree
685 * @index: the current BC index
686 * @modpath: the hardware_path struct to match a device against
687 * @return: The corresponding device if found, NULL otherwise.
689 * Checks all the children of @parent for a matching @id. If none
690 * found, it returns NULL.
692 static struct device *
693 parse_tree_node(struct device *parent, int index, struct hardware_path *modpath)
695 struct parse_tree_data d = {
700 struct recurse_struct recurse_data = {
705 if (device_for_each_child(parent, &recurse_data, descend_children))
712 * hwpath_to_device - Finds the generic device corresponding to a given hardware path.
713 * @modpath: the hardware path.
714 * @return: The target device, NULL if not found.
716 struct device *hwpath_to_device(struct hardware_path *modpath)
719 struct device *parent = &root;
720 for (i = 0; i < 6; i++) {
721 if (modpath->bc[i] == -1)
723 parent = parse_tree_node(parent, i, modpath);
727 if (is_pci_dev(parent)) /* pci devices already parse MOD */
730 return parse_tree_node(parent, 6, modpath);
732 EXPORT_SYMBOL(hwpath_to_device);
735 * device_to_hwpath - Populates the hwpath corresponding to the given device.
736 * @param dev the target device
737 * @param path pointer to a previously allocated hwpath struct to be filled in
739 void device_to_hwpath(struct device *dev, struct hardware_path *path)
741 struct parisc_device *padev;
742 if (dev->bus == &parisc_bus_type) {
743 padev = to_parisc_device(dev);
744 get_node_path(dev->parent, path);
745 path->mod = padev->hw_path;
746 } else if (is_pci_dev(dev)) {
747 get_node_path(dev, path);
750 EXPORT_SYMBOL(device_to_hwpath);
752 #define BC_PORT_MASK 0x8
753 #define BC_LOWER_PORT 0x8
755 #define BUS_CONVERTER(dev) \
756 ((dev->id.hw_type == HPHW_IOA) || (dev->id.hw_type == HPHW_BCPORT))
758 #define IS_LOWER_PORT(dev) \
759 ((gsc_readl(dev->hpa.start + offsetof(struct bc_module, io_status)) \
760 & BC_PORT_MASK) == BC_LOWER_PORT)
762 #define MAX_NATIVE_DEVICES 64
763 #define NATIVE_DEVICE_OFFSET 0x1000
765 #define FLEX_MASK F_EXTEND(0xfffc0000)
766 #define IO_IO_LOW offsetof(struct bc_module, io_io_low)
767 #define IO_IO_HIGH offsetof(struct bc_module, io_io_high)
768 #define READ_IO_IO_LOW(dev) (unsigned long)(signed int)gsc_readl(dev->hpa.start + IO_IO_LOW)
769 #define READ_IO_IO_HIGH(dev) (unsigned long)(signed int)gsc_readl(dev->hpa.start + IO_IO_HIGH)
771 static void walk_native_bus(unsigned long io_io_low, unsigned long io_io_high,
772 struct device *parent);
774 void walk_lower_bus(struct parisc_device *dev)
776 unsigned long io_io_low, io_io_high;
778 if (!BUS_CONVERTER(dev) || IS_LOWER_PORT(dev))
781 if (dev->id.hw_type == HPHW_IOA) {
782 io_io_low = (unsigned long)(signed int)(READ_IO_IO_LOW(dev) << 16);
783 io_io_high = io_io_low + MAX_NATIVE_DEVICES * NATIVE_DEVICE_OFFSET;
785 io_io_low = (READ_IO_IO_LOW(dev) + ~FLEX_MASK) & FLEX_MASK;
786 io_io_high = (READ_IO_IO_HIGH(dev)+ ~FLEX_MASK) & FLEX_MASK;
789 walk_native_bus(io_io_low, io_io_high, &dev->dev);
793 * walk_native_bus -- Probe a bus for devices
794 * @io_io_low: Base address of this bus.
795 * @io_io_high: Last address of this bus.
796 * @parent: The parent bus device.
798 * A native bus (eg Runway or GSC) may have up to 64 devices on it,
799 * spaced at intervals of 0x1000 bytes. PDC may not inform us of these
800 * devices, so we have to probe for them. Unfortunately, we may find
801 * devices which are not physically connected (such as extra serial &
802 * keyboard ports). This problem is not yet solved.
804 static void walk_native_bus(unsigned long io_io_low, unsigned long io_io_high,
805 struct device *parent)
807 int i, devices_found = 0;
808 unsigned long hpa = io_io_low;
809 struct hardware_path path;
811 get_node_path(parent, &path);
813 for(i = 0; i < MAX_NATIVE_DEVICES; i++, hpa += NATIVE_DEVICE_OFFSET) {
814 struct parisc_device *dev;
816 /* Was the device already added by Firmware? */
817 dev = find_device_by_addr(hpa);
820 dev = alloc_pa_dev(hpa, &path);
824 register_parisc_device(dev);
829 } while(!devices_found && hpa < io_io_high);
832 #define CENTRAL_BUS_ADDR F_EXTEND(0xfff80000)
835 * walk_central_bus - Find devices attached to the central bus
837 * PDC doesn't tell us about all devices in the system. This routine
838 * finds devices connected to the central bus.
840 void walk_central_bus(void)
842 walk_native_bus(CENTRAL_BUS_ADDR,
843 CENTRAL_BUS_ADDR + (MAX_NATIVE_DEVICES * NATIVE_DEVICE_OFFSET),
847 static void print_parisc_device(struct parisc_device *dev)
852 print_pa_hwpath(dev, hw_path);
853 printk(KERN_INFO "%d. %s at 0x%p [%s] { %d, 0x%x, 0x%.3x, 0x%.5x }",
854 ++count, dev->name, (void*) dev->hpa.start, hw_path, dev->id.hw_type,
855 dev->id.hversion_rev, dev->id.hversion, dev->id.sversion);
857 if (dev->num_addrs) {
859 printk(", additional addresses: ");
860 for (k = 0; k < dev->num_addrs; k++)
861 printk("0x%lx ", dev->addr[k]);
867 * init_parisc_bus - Some preparation to be done before inventory
869 void init_parisc_bus(void)
871 if (bus_register(&parisc_bus_type))
872 panic("Could not register PA-RISC bus type\n");
873 if (device_register(&root))
874 panic("Could not register PA-RISC root device\n");
879 static int print_one_device(struct device * dev, void * data)
881 struct parisc_device * pdev = to_parisc_device(dev);
884 print_parisc_device(pdev);
889 * print_parisc_devices - Print out a list of devices found in this system
891 void print_parisc_devices(void)
893 for_each_padev(print_one_device, NULL);