xref: /OK3568_Linux_fs/kernel/drivers/dio/dio-driver.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  *  DIO Driver Services
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  *  Copyright (C) 2004 Jochen Friedrich
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  *  Loosely based on drivers/pci/pci-driver.c and drivers/zorro/zorro-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/dio.h>
16*4882a593Smuzhiyun 
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun /**
19*4882a593Smuzhiyun  *  dio_match_device - Tell if a DIO device structure has a matching DIO device id structure
20*4882a593Smuzhiyun  *  @ids: array of DIO device id structures to search in
21*4882a593Smuzhiyun  *  @d: the DIO device structure to match against
22*4882a593Smuzhiyun  *
23*4882a593Smuzhiyun  *  Used by a driver to check whether a DIO device present in the
24*4882a593Smuzhiyun  *  system is in its list of supported devices. Returns the matching
25*4882a593Smuzhiyun  *  dio_device_id structure or %NULL if there is no match.
26*4882a593Smuzhiyun  */
27*4882a593Smuzhiyun 
28*4882a593Smuzhiyun static const struct dio_device_id *
dio_match_device(const struct dio_device_id * ids,const struct dio_dev * d)29*4882a593Smuzhiyun dio_match_device(const struct dio_device_id *ids,
30*4882a593Smuzhiyun 		   const struct dio_dev *d)
31*4882a593Smuzhiyun {
32*4882a593Smuzhiyun 	while (ids->id) {
33*4882a593Smuzhiyun 		if (ids->id == DIO_WILDCARD)
34*4882a593Smuzhiyun 			return ids;
35*4882a593Smuzhiyun 		if (DIO_NEEDSSECID(ids->id & 0xff)) {
36*4882a593Smuzhiyun 			if (ids->id == d->id)
37*4882a593Smuzhiyun 				return ids;
38*4882a593Smuzhiyun 		} else {
39*4882a593Smuzhiyun 			if ((ids->id & 0xff) == (d->id & 0xff))
40*4882a593Smuzhiyun 				return ids;
41*4882a593Smuzhiyun 		}
42*4882a593Smuzhiyun 		ids++;
43*4882a593Smuzhiyun 	}
44*4882a593Smuzhiyun 	return NULL;
45*4882a593Smuzhiyun }
46*4882a593Smuzhiyun 
dio_device_probe(struct device * dev)47*4882a593Smuzhiyun static int dio_device_probe(struct device *dev)
48*4882a593Smuzhiyun {
49*4882a593Smuzhiyun 	int error = 0;
50*4882a593Smuzhiyun 	struct dio_driver *drv = to_dio_driver(dev->driver);
51*4882a593Smuzhiyun 	struct dio_dev *d = to_dio_dev(dev);
52*4882a593Smuzhiyun 
53*4882a593Smuzhiyun 	if (!d->driver && drv->probe) {
54*4882a593Smuzhiyun 		const struct dio_device_id *id;
55*4882a593Smuzhiyun 
56*4882a593Smuzhiyun 		id = dio_match_device(drv->id_table, d);
57*4882a593Smuzhiyun 		if (id)
58*4882a593Smuzhiyun 			error = drv->probe(d, id);
59*4882a593Smuzhiyun 		if (error >= 0) {
60*4882a593Smuzhiyun 			d->driver = drv;
61*4882a593Smuzhiyun 			error = 0;
62*4882a593Smuzhiyun 		}
63*4882a593Smuzhiyun 	}
64*4882a593Smuzhiyun 	return error;
65*4882a593Smuzhiyun }
66*4882a593Smuzhiyun 
67*4882a593Smuzhiyun 
68*4882a593Smuzhiyun /**
69*4882a593Smuzhiyun  *  dio_register_driver - register a new DIO driver
70*4882a593Smuzhiyun  *  @drv: the driver structure to register
71*4882a593Smuzhiyun  *
72*4882a593Smuzhiyun  *  Adds the driver structure to the list of registered drivers
73*4882a593Smuzhiyun  *  Returns zero or a negative error value.
74*4882a593Smuzhiyun  */
75*4882a593Smuzhiyun 
dio_register_driver(struct dio_driver * drv)76*4882a593Smuzhiyun int dio_register_driver(struct dio_driver *drv)
77*4882a593Smuzhiyun {
78*4882a593Smuzhiyun 	/* initialize common driver fields */
79*4882a593Smuzhiyun 	drv->driver.name = drv->name;
80*4882a593Smuzhiyun 	drv->driver.bus = &dio_bus_type;
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun 	/* register with core */
83*4882a593Smuzhiyun 	return driver_register(&drv->driver);
84*4882a593Smuzhiyun }
85*4882a593Smuzhiyun 
86*4882a593Smuzhiyun 
87*4882a593Smuzhiyun /**
88*4882a593Smuzhiyun  *  dio_unregister_driver - unregister a DIO driver
89*4882a593Smuzhiyun  *  @drv: the driver structure to unregister
90*4882a593Smuzhiyun  *
91*4882a593Smuzhiyun  *  Deletes the driver structure from the list of registered DIO drivers,
92*4882a593Smuzhiyun  *  gives it a chance to clean up by calling its remove() function for
93*4882a593Smuzhiyun  *  each device it was responsible for, and marks those devices as
94*4882a593Smuzhiyun  *  driverless.
95*4882a593Smuzhiyun  */
96*4882a593Smuzhiyun 
dio_unregister_driver(struct dio_driver * drv)97*4882a593Smuzhiyun void dio_unregister_driver(struct dio_driver *drv)
98*4882a593Smuzhiyun {
99*4882a593Smuzhiyun 	driver_unregister(&drv->driver);
100*4882a593Smuzhiyun }
101*4882a593Smuzhiyun 
102*4882a593Smuzhiyun 
103*4882a593Smuzhiyun /**
104*4882a593Smuzhiyun  *  dio_bus_match - Tell if a DIO device structure has a matching DIO device id structure
105*4882a593Smuzhiyun  *  @dev: the DIO device structure to match against
106*4882a593Smuzhiyun  *  @drv: the &device_driver that points to the array of DIO device id structures to search
107*4882a593Smuzhiyun  *
108*4882a593Smuzhiyun  *  Used by the driver core to check whether a DIO device present in the
109*4882a593Smuzhiyun  *  system is in a driver's list of supported devices. Returns 1 if supported,
110*4882a593Smuzhiyun  *  and 0 if there is no match.
111*4882a593Smuzhiyun  */
112*4882a593Smuzhiyun 
dio_bus_match(struct device * dev,struct device_driver * drv)113*4882a593Smuzhiyun static int dio_bus_match(struct device *dev, struct device_driver *drv)
114*4882a593Smuzhiyun {
115*4882a593Smuzhiyun 	struct dio_dev *d = to_dio_dev(dev);
116*4882a593Smuzhiyun 	struct dio_driver *dio_drv = to_dio_driver(drv);
117*4882a593Smuzhiyun 	const struct dio_device_id *ids = dio_drv->id_table;
118*4882a593Smuzhiyun 
119*4882a593Smuzhiyun 	if (!ids)
120*4882a593Smuzhiyun 		return 0;
121*4882a593Smuzhiyun 
122*4882a593Smuzhiyun 	return dio_match_device(ids, d) ? 1 : 0;
123*4882a593Smuzhiyun }
124*4882a593Smuzhiyun 
125*4882a593Smuzhiyun 
126*4882a593Smuzhiyun struct bus_type dio_bus_type = {
127*4882a593Smuzhiyun 	.name	= "dio",
128*4882a593Smuzhiyun 	.match	= dio_bus_match,
129*4882a593Smuzhiyun 	.probe	= dio_device_probe,
130*4882a593Smuzhiyun };
131*4882a593Smuzhiyun 
132*4882a593Smuzhiyun 
dio_driver_init(void)133*4882a593Smuzhiyun static int __init dio_driver_init(void)
134*4882a593Smuzhiyun {
135*4882a593Smuzhiyun 	return bus_register(&dio_bus_type);
136*4882a593Smuzhiyun }
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun postcore_initcall(dio_driver_init);
139*4882a593Smuzhiyun 
140*4882a593Smuzhiyun EXPORT_SYMBOL(dio_register_driver);
141*4882a593Smuzhiyun EXPORT_SYMBOL(dio_unregister_driver);
142*4882a593Smuzhiyun EXPORT_SYMBOL(dio_bus_type);
143