Linux Audio

Check our new training course

Linux debugging, profiling, tracing and performance analysis training

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