xref: /linux/drivers/pnp/driver.c (revision 4d7696f1b05f4aeb586c74868fe3da2731daca4b)
1 /*
2  * driver.c - device id matching, driver model, etc.
3  *
4  * Copyright 2002 Adam Belay <ambx1@neo.rr.com>
5  */
6 
7 #include <linux/string.h>
8 #include <linux/list.h>
9 #include <linux/module.h>
10 #include <linux/ctype.h>
11 #include <linux/slab.h>
12 #include <linux/pnp.h>
13 #include "base.h"
14 
15 static int compare_func(const char *ida, const char *idb)
16 {
17 	int i;
18 
19 	/* we only need to compare the last 4 chars */
20 	for (i = 3; i < 7; i++) {
21 		if (ida[i] != 'X' &&
22 		    idb[i] != 'X' && toupper(ida[i]) != toupper(idb[i]))
23 			return 0;
24 	}
25 	return 1;
26 }
27 
28 int compare_pnp_id(struct pnp_id *pos, const char *id)
29 {
30 	if (!pos || !id || (strlen(id) != 7))
31 		return 0;
32 	if (memcmp(id, "ANYDEVS", 7) == 0)
33 		return 1;
34 	while (pos) {
35 		if (memcmp(pos->id, id, 3) == 0)
36 			if (compare_func(pos->id, id) == 1)
37 				return 1;
38 		pos = pos->next;
39 	}
40 	return 0;
41 }
42 
43 static const struct pnp_device_id *match_device(struct pnp_driver *drv,
44 						struct pnp_dev *dev)
45 {
46 	const struct pnp_device_id *drv_id = drv->id_table;
47 
48 	if (!drv_id)
49 		return NULL;
50 
51 	while (*drv_id->id) {
52 		if (compare_pnp_id(dev->id, drv_id->id))
53 			return drv_id;
54 		drv_id++;
55 	}
56 	return NULL;
57 }
58 
59 int pnp_device_attach(struct pnp_dev *pnp_dev)
60 {
61 	spin_lock(&pnp_lock);
62 	if (pnp_dev->status != PNP_READY) {
63 		spin_unlock(&pnp_lock);
64 		return -EBUSY;
65 	}
66 	pnp_dev->status = PNP_ATTACHED;
67 	spin_unlock(&pnp_lock);
68 	return 0;
69 }
70 
71 void pnp_device_detach(struct pnp_dev *pnp_dev)
72 {
73 	spin_lock(&pnp_lock);
74 	if (pnp_dev->status == PNP_ATTACHED)
75 		pnp_dev->status = PNP_READY;
76 	spin_unlock(&pnp_lock);
77 	pnp_disable_dev(pnp_dev);
78 }
79 
80 static int pnp_device_probe(struct device *dev)
81 {
82 	int error;
83 	struct pnp_driver *pnp_drv;
84 	struct pnp_dev *pnp_dev;
85 	const struct pnp_device_id *dev_id = NULL;
86 	pnp_dev = to_pnp_dev(dev);
87 	pnp_drv = to_pnp_driver(dev->driver);
88 
89 	error = pnp_device_attach(pnp_dev);
90 	if (error < 0)
91 		return error;
92 
93 	if (pnp_dev->active == 0) {
94 		if (!(pnp_drv->flags & PNP_DRIVER_RES_DO_NOT_CHANGE)) {
95 			error = pnp_activate_dev(pnp_dev);
96 			if (error < 0)
97 				return error;
98 		}
99 	} else if ((pnp_drv->flags & PNP_DRIVER_RES_DISABLE)
100 		   == PNP_DRIVER_RES_DISABLE) {
101 		error = pnp_disable_dev(pnp_dev);
102 		if (error < 0)
103 			return error;
104 	}
105 	error = 0;
106 	if (pnp_drv->probe) {
107 		dev_id = match_device(pnp_drv, pnp_dev);
108 		if (dev_id != NULL)
109 			error = pnp_drv->probe(pnp_dev, dev_id);
110 	}
111 	if (error >= 0) {
112 		pnp_dev->driver = pnp_drv;
113 		error = 0;
114 	} else
115 		goto fail;
116 
117 	return error;
118 
119 fail:
120 	pnp_device_detach(pnp_dev);
121 	return error;
122 }
123 
124 static int pnp_device_remove(struct device *dev)
125 {
126 	struct pnp_dev *pnp_dev = to_pnp_dev(dev);
127 	struct pnp_driver *drv = pnp_dev->driver;
128 
129 	if (drv) {
130 		if (drv->remove)
131 			drv->remove(pnp_dev);
132 		pnp_dev->driver = NULL;
133 	}
134 	pnp_device_detach(pnp_dev);
135 	return 0;
136 }
137 
138 static void pnp_device_shutdown(struct device *dev)
139 {
140 	struct pnp_dev *pnp_dev = to_pnp_dev(dev);
141 	struct pnp_driver *drv = pnp_dev->driver;
142 
143 	if (drv && drv->shutdown)
144 		drv->shutdown(pnp_dev);
145 }
146 
147 static int pnp_bus_match(struct device *dev, struct device_driver *drv)
148 {
149 	struct pnp_dev *pnp_dev = to_pnp_dev(dev);
150 	struct pnp_driver *pnp_drv = to_pnp_driver(drv);
151 
152 	if (match_device(pnp_drv, pnp_dev) == NULL)
153 		return 0;
154 	return 1;
155 }
156 
157 static int __pnp_bus_suspend(struct device *dev, pm_message_t state)
158 {
159 	struct pnp_dev *pnp_dev = to_pnp_dev(dev);
160 	struct pnp_driver *pnp_drv = pnp_dev->driver;
161 	int error;
162 
163 	if (!pnp_drv)
164 		return 0;
165 
166 	if (pnp_drv->suspend) {
167 		error = pnp_drv->suspend(pnp_dev, state);
168 		if (error)
169 			return error;
170 	}
171 
172 	if (pnp_can_disable(pnp_dev)) {
173 		error = pnp_stop_dev(pnp_dev);
174 		if (error)
175 			return error;
176 	}
177 
178 	if (pnp_dev->protocol->suspend)
179 		pnp_dev->protocol->suspend(pnp_dev, state);
180 	return 0;
181 }
182 
183 static int pnp_bus_suspend(struct device *dev)
184 {
185 	return __pnp_bus_suspend(dev, PMSG_SUSPEND);
186 }
187 
188 static int pnp_bus_freeze(struct device *dev)
189 {
190 	return __pnp_bus_suspend(dev, PMSG_FREEZE);
191 }
192 
193 static int pnp_bus_resume(struct device *dev)
194 {
195 	struct pnp_dev *pnp_dev = to_pnp_dev(dev);
196 	struct pnp_driver *pnp_drv = pnp_dev->driver;
197 	int error;
198 
199 	if (!pnp_drv)
200 		return 0;
201 
202 	if (pnp_dev->protocol->resume) {
203 		error = pnp_dev->protocol->resume(pnp_dev);
204 		if (error)
205 			return error;
206 	}
207 
208 	if (pnp_can_write(pnp_dev)) {
209 		error = pnp_start_dev(pnp_dev);
210 		if (error)
211 			return error;
212 	}
213 
214 	if (pnp_drv->resume) {
215 		error = pnp_drv->resume(pnp_dev);
216 		if (error)
217 			return error;
218 	}
219 
220 	return 0;
221 }
222 
223 static const struct dev_pm_ops pnp_bus_dev_pm_ops = {
224 	.suspend = pnp_bus_suspend,
225 	.freeze = pnp_bus_freeze,
226 	.resume = pnp_bus_resume,
227 };
228 
229 struct bus_type pnp_bus_type = {
230 	.name    = "pnp",
231 	.match   = pnp_bus_match,
232 	.probe   = pnp_device_probe,
233 	.remove  = pnp_device_remove,
234 	.shutdown = pnp_device_shutdown,
235 	.pm	 = &pnp_bus_dev_pm_ops,
236 	.dev_attrs = pnp_interface_attrs,
237 };
238 
239 int pnp_register_driver(struct pnp_driver *drv)
240 {
241 	drv->driver.name = drv->name;
242 	drv->driver.bus = &pnp_bus_type;
243 
244 	return driver_register(&drv->driver);
245 }
246 
247 void pnp_unregister_driver(struct pnp_driver *drv)
248 {
249 	driver_unregister(&drv->driver);
250 }
251 
252 /**
253  * pnp_add_id - adds an EISA id to the specified device
254  * @dev: pointer to the desired device
255  * @id: pointer to an EISA id string
256  */
257 struct pnp_id *pnp_add_id(struct pnp_dev *dev, const char *id)
258 {
259 	struct pnp_id *dev_id, *ptr;
260 
261 	dev_id = kzalloc(sizeof(struct pnp_id), GFP_KERNEL);
262 	if (!dev_id)
263 		return NULL;
264 
265 	dev_id->id[0] = id[0];
266 	dev_id->id[1] = id[1];
267 	dev_id->id[2] = id[2];
268 	dev_id->id[3] = tolower(id[3]);
269 	dev_id->id[4] = tolower(id[4]);
270 	dev_id->id[5] = tolower(id[5]);
271 	dev_id->id[6] = tolower(id[6]);
272 	dev_id->id[7] = '\0';
273 
274 	dev_id->next = NULL;
275 	ptr = dev->id;
276 	while (ptr && ptr->next)
277 		ptr = ptr->next;
278 	if (ptr)
279 		ptr->next = dev_id;
280 	else
281 		dev->id = dev_id;
282 
283 	return dev_id;
284 }
285 
286 EXPORT_SYMBOL(pnp_register_driver);
287 EXPORT_SYMBOL(pnp_unregister_driver);
288 EXPORT_SYMBOL(pnp_device_attach);
289 EXPORT_SYMBOL(pnp_device_detach);
290