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