xref: /openbmc/linux/drivers/zorro/zorro-driver.c (revision 64c70b1c)
1 /*
2  *  Zorro Driver Services
3  *
4  *  Copyright (C) 2003 Geert Uytterhoeven
5  *
6  *  Loosely based on drivers/pci/pci-driver.c
7  *
8  *  This file is subject to the terms and conditions of the GNU General Public
9  *  License.  See the file COPYING in the main directory of this archive
10  *  for more details.
11  */
12 
13 #include <linux/init.h>
14 #include <linux/module.h>
15 #include <linux/zorro.h>
16 
17 
18     /**
19      *  zorro_match_device - Tell if a Zorro device structure has a matching
20      *                       Zorro device id structure
21      *  @ids: array of Zorro device id structures to search in
22      *  @dev: the Zorro device structure to match against
23      *
24      *  Used by a driver to check whether a Zorro device present in the
25      *  system is in its list of supported devices. Returns the matching
26      *  zorro_device_id structure or %NULL if there is no match.
27      */
28 
29 const struct zorro_device_id *
30 zorro_match_device(const struct zorro_device_id *ids,
31 		   const struct zorro_dev *z)
32 {
33 	while (ids->id) {
34 		if (ids->id == ZORRO_WILDCARD || ids->id == z->id)
35 			return ids;
36 		ids++;
37 	}
38 	return NULL;
39 }
40 
41 
42 static int zorro_device_probe(struct device *dev)
43 {
44 	int error = 0;
45 	struct zorro_driver *drv = to_zorro_driver(dev->driver);
46 	struct zorro_dev *z = to_zorro_dev(dev);
47 
48 	if (!z->driver && drv->probe) {
49 		const struct zorro_device_id *id;
50 
51 		id = zorro_match_device(drv->id_table, z);
52 		if (id)
53 			error = drv->probe(z, id);
54 		if (error >= 0) {
55 			z->driver = drv;
56 			error = 0;
57 		}
58 	}
59 	return error;
60 }
61 
62 
63     /**
64      *  zorro_register_driver - register a new Zorro driver
65      *  @drv: the driver structure to register
66      *
67      *  Adds the driver structure to the list of registered drivers
68      *  Returns zero or a negative error value.
69      */
70 
71 int zorro_register_driver(struct zorro_driver *drv)
72 {
73 	/* initialize common driver fields */
74 	drv->driver.name = drv->name;
75 	drv->driver.bus = &zorro_bus_type;
76 
77 	/* register with core */
78 	return driver_register(&drv->driver);
79 }
80 
81 
82     /**
83      *  zorro_unregister_driver - unregister a zorro driver
84      *  @drv: the driver structure to unregister
85      *
86      *  Deletes the driver structure from the list of registered Zorro drivers,
87      *  gives it a chance to clean up by calling its remove() function for
88      *  each device it was responsible for, and marks those devices as
89      *  driverless.
90      */
91 
92 void zorro_unregister_driver(struct zorro_driver *drv)
93 {
94 	driver_unregister(&drv->driver);
95 }
96 
97 
98     /**
99      *  zorro_bus_match - Tell if a Zorro device structure has a matching Zorro
100      *                    device id structure
101      *  @ids: array of Zorro device id structures to search in
102      *  @dev: the Zorro device structure to match against
103      *
104      *  Used by a driver to check whether a Zorro device present in the
105      *  system is in its list of supported devices.Returns the matching
106      *  zorro_device_id structure or %NULL if there is no match.
107      */
108 
109 static int zorro_bus_match(struct device *dev, struct device_driver *drv)
110 {
111 	struct zorro_dev *z = to_zorro_dev(dev);
112 	struct zorro_driver *zorro_drv = to_zorro_driver(drv);
113 	const struct zorro_device_id *ids = zorro_drv->id_table;
114 
115 	if (!ids)
116 		return 0;
117 
118 	while (ids->id) {
119 		if (ids->id == ZORRO_WILDCARD || ids->id == z->id)
120 			return 1;
121 		ids++;
122 	}
123 	return 0;
124 }
125 
126 
127 struct bus_type zorro_bus_type = {
128 	.name	= "zorro",
129 	.match	= zorro_bus_match,
130 	.probe	= zorro_device_probe,
131 };
132 
133 
134 static int __init zorro_driver_init(void)
135 {
136 	return bus_register(&zorro_bus_type);
137 }
138 
139 postcore_initcall(zorro_driver_init);
140 
141 EXPORT_SYMBOL(zorro_match_device);
142 EXPORT_SYMBOL(zorro_register_driver);
143 EXPORT_SYMBOL(zorro_unregister_driver);
144 EXPORT_SYMBOL(zorro_dev_driver);
145 EXPORT_SYMBOL(zorro_bus_type);
146