1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * core.c - contains all core device and protocol registration functions
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * Copyright 2002 Adam Belay <ambx1@neo.rr.com>
6*4882a593Smuzhiyun */
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun #include <linux/pnp.h>
9*4882a593Smuzhiyun #include <linux/types.h>
10*4882a593Smuzhiyun #include <linux/list.h>
11*4882a593Smuzhiyun #include <linux/device.h>
12*4882a593Smuzhiyun #include <linux/module.h>
13*4882a593Smuzhiyun #include <linux/mutex.h>
14*4882a593Smuzhiyun #include <linux/init.h>
15*4882a593Smuzhiyun #include <linux/string.h>
16*4882a593Smuzhiyun #include <linux/slab.h>
17*4882a593Smuzhiyun #include <linux/errno.h>
18*4882a593Smuzhiyun #include <linux/dma-mapping.h>
19*4882a593Smuzhiyun
20*4882a593Smuzhiyun #include "base.h"
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun static LIST_HEAD(pnp_protocols);
23*4882a593Smuzhiyun LIST_HEAD(pnp_global);
24*4882a593Smuzhiyun DEFINE_MUTEX(pnp_lock);
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun /*
27*4882a593Smuzhiyun * ACPI or PNPBIOS should tell us about all platform devices, so we can
28*4882a593Smuzhiyun * skip some blind probes. ISAPNP typically enumerates only plug-in ISA
29*4882a593Smuzhiyun * devices, not built-in things like COM ports.
30*4882a593Smuzhiyun */
31*4882a593Smuzhiyun int pnp_platform_devices;
32*4882a593Smuzhiyun EXPORT_SYMBOL(pnp_platform_devices);
33*4882a593Smuzhiyun
pnp_alloc(long size)34*4882a593Smuzhiyun void *pnp_alloc(long size)
35*4882a593Smuzhiyun {
36*4882a593Smuzhiyun void *result;
37*4882a593Smuzhiyun
38*4882a593Smuzhiyun result = kzalloc(size, GFP_KERNEL);
39*4882a593Smuzhiyun if (!result) {
40*4882a593Smuzhiyun printk(KERN_ERR "pnp: Out of Memory\n");
41*4882a593Smuzhiyun return NULL;
42*4882a593Smuzhiyun }
43*4882a593Smuzhiyun return result;
44*4882a593Smuzhiyun }
45*4882a593Smuzhiyun
pnp_remove_protocol(struct pnp_protocol * protocol)46*4882a593Smuzhiyun static void pnp_remove_protocol(struct pnp_protocol *protocol)
47*4882a593Smuzhiyun {
48*4882a593Smuzhiyun mutex_lock(&pnp_lock);
49*4882a593Smuzhiyun list_del(&protocol->protocol_list);
50*4882a593Smuzhiyun mutex_unlock(&pnp_lock);
51*4882a593Smuzhiyun }
52*4882a593Smuzhiyun
53*4882a593Smuzhiyun /**
54*4882a593Smuzhiyun * pnp_register_protocol - adds a pnp protocol to the pnp layer
55*4882a593Smuzhiyun * @protocol: pointer to the corresponding pnp_protocol structure
56*4882a593Smuzhiyun *
57*4882a593Smuzhiyun * Ex protocols: ISAPNP, PNPBIOS, etc
58*4882a593Smuzhiyun */
pnp_register_protocol(struct pnp_protocol * protocol)59*4882a593Smuzhiyun int pnp_register_protocol(struct pnp_protocol *protocol)
60*4882a593Smuzhiyun {
61*4882a593Smuzhiyun struct list_head *pos;
62*4882a593Smuzhiyun int nodenum, ret;
63*4882a593Smuzhiyun
64*4882a593Smuzhiyun INIT_LIST_HEAD(&protocol->devices);
65*4882a593Smuzhiyun INIT_LIST_HEAD(&protocol->cards);
66*4882a593Smuzhiyun nodenum = 0;
67*4882a593Smuzhiyun
68*4882a593Smuzhiyun mutex_lock(&pnp_lock);
69*4882a593Smuzhiyun
70*4882a593Smuzhiyun /* assign the lowest unused number */
71*4882a593Smuzhiyun list_for_each(pos, &pnp_protocols) {
72*4882a593Smuzhiyun struct pnp_protocol *cur = to_pnp_protocol(pos);
73*4882a593Smuzhiyun if (cur->number == nodenum) {
74*4882a593Smuzhiyun pos = &pnp_protocols;
75*4882a593Smuzhiyun nodenum++;
76*4882a593Smuzhiyun }
77*4882a593Smuzhiyun }
78*4882a593Smuzhiyun
79*4882a593Smuzhiyun protocol->number = nodenum;
80*4882a593Smuzhiyun dev_set_name(&protocol->dev, "pnp%d", nodenum);
81*4882a593Smuzhiyun
82*4882a593Smuzhiyun list_add_tail(&protocol->protocol_list, &pnp_protocols);
83*4882a593Smuzhiyun
84*4882a593Smuzhiyun mutex_unlock(&pnp_lock);
85*4882a593Smuzhiyun
86*4882a593Smuzhiyun ret = device_register(&protocol->dev);
87*4882a593Smuzhiyun if (ret)
88*4882a593Smuzhiyun pnp_remove_protocol(protocol);
89*4882a593Smuzhiyun
90*4882a593Smuzhiyun return ret;
91*4882a593Smuzhiyun }
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun /**
94*4882a593Smuzhiyun * pnp_unregister_protocol - removes a pnp protocol from the pnp layer
95*4882a593Smuzhiyun * @protocol: pointer to the corresponding pnp_protocol structure
96*4882a593Smuzhiyun */
pnp_unregister_protocol(struct pnp_protocol * protocol)97*4882a593Smuzhiyun void pnp_unregister_protocol(struct pnp_protocol *protocol)
98*4882a593Smuzhiyun {
99*4882a593Smuzhiyun pnp_remove_protocol(protocol);
100*4882a593Smuzhiyun device_unregister(&protocol->dev);
101*4882a593Smuzhiyun }
102*4882a593Smuzhiyun
pnp_free_ids(struct pnp_dev * dev)103*4882a593Smuzhiyun static void pnp_free_ids(struct pnp_dev *dev)
104*4882a593Smuzhiyun {
105*4882a593Smuzhiyun struct pnp_id *id;
106*4882a593Smuzhiyun struct pnp_id *next;
107*4882a593Smuzhiyun
108*4882a593Smuzhiyun id = dev->id;
109*4882a593Smuzhiyun while (id) {
110*4882a593Smuzhiyun next = id->next;
111*4882a593Smuzhiyun kfree(id);
112*4882a593Smuzhiyun id = next;
113*4882a593Smuzhiyun }
114*4882a593Smuzhiyun }
115*4882a593Smuzhiyun
pnp_free_resource(struct pnp_resource * pnp_res)116*4882a593Smuzhiyun void pnp_free_resource(struct pnp_resource *pnp_res)
117*4882a593Smuzhiyun {
118*4882a593Smuzhiyun list_del(&pnp_res->list);
119*4882a593Smuzhiyun kfree(pnp_res);
120*4882a593Smuzhiyun }
121*4882a593Smuzhiyun
pnp_free_resources(struct pnp_dev * dev)122*4882a593Smuzhiyun void pnp_free_resources(struct pnp_dev *dev)
123*4882a593Smuzhiyun {
124*4882a593Smuzhiyun struct pnp_resource *pnp_res, *tmp;
125*4882a593Smuzhiyun
126*4882a593Smuzhiyun list_for_each_entry_safe(pnp_res, tmp, &dev->resources, list) {
127*4882a593Smuzhiyun pnp_free_resource(pnp_res);
128*4882a593Smuzhiyun }
129*4882a593Smuzhiyun }
130*4882a593Smuzhiyun
pnp_release_device(struct device * dmdev)131*4882a593Smuzhiyun static void pnp_release_device(struct device *dmdev)
132*4882a593Smuzhiyun {
133*4882a593Smuzhiyun struct pnp_dev *dev = to_pnp_dev(dmdev);
134*4882a593Smuzhiyun
135*4882a593Smuzhiyun pnp_free_ids(dev);
136*4882a593Smuzhiyun pnp_free_resources(dev);
137*4882a593Smuzhiyun pnp_free_options(dev);
138*4882a593Smuzhiyun kfree(dev);
139*4882a593Smuzhiyun }
140*4882a593Smuzhiyun
pnp_alloc_dev(struct pnp_protocol * protocol,int id,const char * pnpid)141*4882a593Smuzhiyun struct pnp_dev *pnp_alloc_dev(struct pnp_protocol *protocol, int id,
142*4882a593Smuzhiyun const char *pnpid)
143*4882a593Smuzhiyun {
144*4882a593Smuzhiyun struct pnp_dev *dev;
145*4882a593Smuzhiyun struct pnp_id *dev_id;
146*4882a593Smuzhiyun
147*4882a593Smuzhiyun dev = kzalloc(sizeof(struct pnp_dev), GFP_KERNEL);
148*4882a593Smuzhiyun if (!dev)
149*4882a593Smuzhiyun return NULL;
150*4882a593Smuzhiyun
151*4882a593Smuzhiyun INIT_LIST_HEAD(&dev->resources);
152*4882a593Smuzhiyun INIT_LIST_HEAD(&dev->options);
153*4882a593Smuzhiyun dev->protocol = protocol;
154*4882a593Smuzhiyun dev->number = id;
155*4882a593Smuzhiyun dev->dma_mask = DMA_BIT_MASK(24);
156*4882a593Smuzhiyun
157*4882a593Smuzhiyun dev->dev.parent = &dev->protocol->dev;
158*4882a593Smuzhiyun dev->dev.bus = &pnp_bus_type;
159*4882a593Smuzhiyun dev->dev.dma_mask = &dev->dma_mask;
160*4882a593Smuzhiyun dev->dev.coherent_dma_mask = dev->dma_mask;
161*4882a593Smuzhiyun dev->dev.release = &pnp_release_device;
162*4882a593Smuzhiyun
163*4882a593Smuzhiyun dev_set_name(&dev->dev, "%02x:%02x", dev->protocol->number, dev->number);
164*4882a593Smuzhiyun
165*4882a593Smuzhiyun dev_id = pnp_add_id(dev, pnpid);
166*4882a593Smuzhiyun if (!dev_id) {
167*4882a593Smuzhiyun kfree(dev);
168*4882a593Smuzhiyun return NULL;
169*4882a593Smuzhiyun }
170*4882a593Smuzhiyun
171*4882a593Smuzhiyun return dev;
172*4882a593Smuzhiyun }
173*4882a593Smuzhiyun
pnp_delist_device(struct pnp_dev * dev)174*4882a593Smuzhiyun static void pnp_delist_device(struct pnp_dev *dev)
175*4882a593Smuzhiyun {
176*4882a593Smuzhiyun mutex_lock(&pnp_lock);
177*4882a593Smuzhiyun list_del(&dev->global_list);
178*4882a593Smuzhiyun list_del(&dev->protocol_list);
179*4882a593Smuzhiyun mutex_unlock(&pnp_lock);
180*4882a593Smuzhiyun }
181*4882a593Smuzhiyun
__pnp_add_device(struct pnp_dev * dev)182*4882a593Smuzhiyun int __pnp_add_device(struct pnp_dev *dev)
183*4882a593Smuzhiyun {
184*4882a593Smuzhiyun int ret;
185*4882a593Smuzhiyun
186*4882a593Smuzhiyun pnp_fixup_device(dev);
187*4882a593Smuzhiyun dev->status = PNP_READY;
188*4882a593Smuzhiyun
189*4882a593Smuzhiyun mutex_lock(&pnp_lock);
190*4882a593Smuzhiyun
191*4882a593Smuzhiyun list_add_tail(&dev->global_list, &pnp_global);
192*4882a593Smuzhiyun list_add_tail(&dev->protocol_list, &dev->protocol->devices);
193*4882a593Smuzhiyun
194*4882a593Smuzhiyun mutex_unlock(&pnp_lock);
195*4882a593Smuzhiyun
196*4882a593Smuzhiyun ret = device_register(&dev->dev);
197*4882a593Smuzhiyun if (ret)
198*4882a593Smuzhiyun pnp_delist_device(dev);
199*4882a593Smuzhiyun else if (dev->protocol->can_wakeup)
200*4882a593Smuzhiyun device_set_wakeup_capable(&dev->dev,
201*4882a593Smuzhiyun dev->protocol->can_wakeup(dev));
202*4882a593Smuzhiyun
203*4882a593Smuzhiyun return ret;
204*4882a593Smuzhiyun }
205*4882a593Smuzhiyun
206*4882a593Smuzhiyun /*
207*4882a593Smuzhiyun * pnp_add_device - adds a pnp device to the pnp layer
208*4882a593Smuzhiyun * @dev: pointer to dev to add
209*4882a593Smuzhiyun *
210*4882a593Smuzhiyun * adds to driver model, name database, fixups, interface, etc.
211*4882a593Smuzhiyun */
pnp_add_device(struct pnp_dev * dev)212*4882a593Smuzhiyun int pnp_add_device(struct pnp_dev *dev)
213*4882a593Smuzhiyun {
214*4882a593Smuzhiyun int ret;
215*4882a593Smuzhiyun char buf[128];
216*4882a593Smuzhiyun int len = 0;
217*4882a593Smuzhiyun struct pnp_id *id;
218*4882a593Smuzhiyun
219*4882a593Smuzhiyun if (dev->card)
220*4882a593Smuzhiyun return -EINVAL;
221*4882a593Smuzhiyun
222*4882a593Smuzhiyun ret = __pnp_add_device(dev);
223*4882a593Smuzhiyun if (ret)
224*4882a593Smuzhiyun return ret;
225*4882a593Smuzhiyun
226*4882a593Smuzhiyun buf[0] = '\0';
227*4882a593Smuzhiyun for (id = dev->id; id; id = id->next)
228*4882a593Smuzhiyun len += scnprintf(buf + len, sizeof(buf) - len, " %s", id->id);
229*4882a593Smuzhiyun
230*4882a593Smuzhiyun dev_printk(KERN_DEBUG, &dev->dev, "%s device, IDs%s (%s)\n",
231*4882a593Smuzhiyun dev->protocol->name, buf,
232*4882a593Smuzhiyun dev->active ? "active" : "disabled");
233*4882a593Smuzhiyun return 0;
234*4882a593Smuzhiyun }
235*4882a593Smuzhiyun
__pnp_remove_device(struct pnp_dev * dev)236*4882a593Smuzhiyun void __pnp_remove_device(struct pnp_dev *dev)
237*4882a593Smuzhiyun {
238*4882a593Smuzhiyun pnp_delist_device(dev);
239*4882a593Smuzhiyun device_unregister(&dev->dev);
240*4882a593Smuzhiyun }
241*4882a593Smuzhiyun
pnp_init(void)242*4882a593Smuzhiyun static int __init pnp_init(void)
243*4882a593Smuzhiyun {
244*4882a593Smuzhiyun return bus_register(&pnp_bus_type);
245*4882a593Smuzhiyun }
246*4882a593Smuzhiyun
247*4882a593Smuzhiyun subsys_initcall(pnp_init);
248*4882a593Smuzhiyun
249*4882a593Smuzhiyun int pnp_debug;
250*4882a593Smuzhiyun
251*4882a593Smuzhiyun #if defined(CONFIG_PNP_DEBUG_MESSAGES)
252*4882a593Smuzhiyun module_param_named(debug, pnp_debug, int, 0644);
253*4882a593Smuzhiyun #endif
254