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