Loading...
1// SPDX-License-Identifier: GPL-2.0
2/*
3 * FPGA Bridge Framework Driver
4 *
5 * Copyright (C) 2013-2016 Altera Corporation, All Rights Reserved.
6 * Copyright (C) 2017 Intel Corporation
7 */
8#include <linux/fpga/fpga-bridge.h>
9#include <linux/idr.h>
10#include <linux/kernel.h>
11#include <linux/module.h>
12#include <linux/of_platform.h>
13#include <linux/slab.h>
14#include <linux/spinlock.h>
15
16static DEFINE_IDA(fpga_bridge_ida);
17static struct class *fpga_bridge_class;
18
19/* Lock for adding/removing bridges to linked lists*/
20static DEFINE_SPINLOCK(bridge_list_lock);
21
22/**
23 * fpga_bridge_enable - Enable transactions on the bridge
24 *
25 * @bridge: FPGA bridge
26 *
27 * Return: 0 for success, error code otherwise.
28 */
29int fpga_bridge_enable(struct fpga_bridge *bridge)
30{
31 dev_dbg(&bridge->dev, "enable\n");
32
33 if (bridge->br_ops && bridge->br_ops->enable_set)
34 return bridge->br_ops->enable_set(bridge, 1);
35
36 return 0;
37}
38EXPORT_SYMBOL_GPL(fpga_bridge_enable);
39
40/**
41 * fpga_bridge_disable - Disable transactions on the bridge
42 *
43 * @bridge: FPGA bridge
44 *
45 * Return: 0 for success, error code otherwise.
46 */
47int fpga_bridge_disable(struct fpga_bridge *bridge)
48{
49 dev_dbg(&bridge->dev, "disable\n");
50
51 if (bridge->br_ops && bridge->br_ops->enable_set)
52 return bridge->br_ops->enable_set(bridge, 0);
53
54 return 0;
55}
56EXPORT_SYMBOL_GPL(fpga_bridge_disable);
57
58static struct fpga_bridge *__fpga_bridge_get(struct device *dev,
59 struct fpga_image_info *info)
60{
61 struct fpga_bridge *bridge;
62 int ret = -ENODEV;
63
64 bridge = to_fpga_bridge(dev);
65
66 bridge->info = info;
67
68 if (!mutex_trylock(&bridge->mutex)) {
69 ret = -EBUSY;
70 goto err_dev;
71 }
72
73 if (!try_module_get(dev->parent->driver->owner))
74 goto err_ll_mod;
75
76 dev_dbg(&bridge->dev, "get\n");
77
78 return bridge;
79
80err_ll_mod:
81 mutex_unlock(&bridge->mutex);
82err_dev:
83 put_device(dev);
84 return ERR_PTR(ret);
85}
86
87/**
88 * of_fpga_bridge_get - get an exclusive reference to an fpga bridge
89 *
90 * @np: node pointer of an FPGA bridge
91 * @info: fpga image specific information
92 *
93 * Return fpga_bridge struct if successful.
94 * Return -EBUSY if someone already has a reference to the bridge.
95 * Return -ENODEV if @np is not an FPGA Bridge.
96 */
97struct fpga_bridge *of_fpga_bridge_get(struct device_node *np,
98 struct fpga_image_info *info)
99{
100 struct device *dev;
101
102 dev = class_find_device_by_of_node(fpga_bridge_class, np);
103 if (!dev)
104 return ERR_PTR(-ENODEV);
105
106 return __fpga_bridge_get(dev, info);
107}
108EXPORT_SYMBOL_GPL(of_fpga_bridge_get);
109
110static int fpga_bridge_dev_match(struct device *dev, const void *data)
111{
112 return dev->parent == data;
113}
114
115/**
116 * fpga_bridge_get - get an exclusive reference to an fpga bridge
117 * @dev: parent device that fpga bridge was registered with
118 * @info: fpga manager info
119 *
120 * Given a device, get an exclusive reference to an fpga bridge.
121 *
122 * Return: fpga bridge struct or IS_ERR() condition containing error code.
123 */
124struct fpga_bridge *fpga_bridge_get(struct device *dev,
125 struct fpga_image_info *info)
126{
127 struct device *bridge_dev;
128
129 bridge_dev = class_find_device(fpga_bridge_class, NULL, dev,
130 fpga_bridge_dev_match);
131 if (!bridge_dev)
132 return ERR_PTR(-ENODEV);
133
134 return __fpga_bridge_get(bridge_dev, info);
135}
136EXPORT_SYMBOL_GPL(fpga_bridge_get);
137
138/**
139 * fpga_bridge_put - release a reference to a bridge
140 *
141 * @bridge: FPGA bridge
142 */
143void fpga_bridge_put(struct fpga_bridge *bridge)
144{
145 dev_dbg(&bridge->dev, "put\n");
146
147 bridge->info = NULL;
148 module_put(bridge->dev.parent->driver->owner);
149 mutex_unlock(&bridge->mutex);
150 put_device(&bridge->dev);
151}
152EXPORT_SYMBOL_GPL(fpga_bridge_put);
153
154/**
155 * fpga_bridges_enable - enable bridges in a list
156 * @bridge_list: list of FPGA bridges
157 *
158 * Enable each bridge in the list. If list is empty, do nothing.
159 *
160 * Return 0 for success or empty bridge list; return error code otherwise.
161 */
162int fpga_bridges_enable(struct list_head *bridge_list)
163{
164 struct fpga_bridge *bridge;
165 int ret;
166
167 list_for_each_entry(bridge, bridge_list, node) {
168 ret = fpga_bridge_enable(bridge);
169 if (ret)
170 return ret;
171 }
172
173 return 0;
174}
175EXPORT_SYMBOL_GPL(fpga_bridges_enable);
176
177/**
178 * fpga_bridges_disable - disable bridges in a list
179 *
180 * @bridge_list: list of FPGA bridges
181 *
182 * Disable each bridge in the list. If list is empty, do nothing.
183 *
184 * Return 0 for success or empty bridge list; return error code otherwise.
185 */
186int fpga_bridges_disable(struct list_head *bridge_list)
187{
188 struct fpga_bridge *bridge;
189 int ret;
190
191 list_for_each_entry(bridge, bridge_list, node) {
192 ret = fpga_bridge_disable(bridge);
193 if (ret)
194 return ret;
195 }
196
197 return 0;
198}
199EXPORT_SYMBOL_GPL(fpga_bridges_disable);
200
201/**
202 * fpga_bridges_put - put bridges
203 *
204 * @bridge_list: list of FPGA bridges
205 *
206 * For each bridge in the list, put the bridge and remove it from the list.
207 * If list is empty, do nothing.
208 */
209void fpga_bridges_put(struct list_head *bridge_list)
210{
211 struct fpga_bridge *bridge, *next;
212 unsigned long flags;
213
214 list_for_each_entry_safe(bridge, next, bridge_list, node) {
215 fpga_bridge_put(bridge);
216
217 spin_lock_irqsave(&bridge_list_lock, flags);
218 list_del(&bridge->node);
219 spin_unlock_irqrestore(&bridge_list_lock, flags);
220 }
221}
222EXPORT_SYMBOL_GPL(fpga_bridges_put);
223
224/**
225 * of_fpga_bridge_get_to_list - get a bridge, add it to a list
226 *
227 * @np: node pointer of an FPGA bridge
228 * @info: fpga image specific information
229 * @bridge_list: list of FPGA bridges
230 *
231 * Get an exclusive reference to the bridge and it to the list.
232 *
233 * Return 0 for success, error code from of_fpga_bridge_get() otherwise.
234 */
235int of_fpga_bridge_get_to_list(struct device_node *np,
236 struct fpga_image_info *info,
237 struct list_head *bridge_list)
238{
239 struct fpga_bridge *bridge;
240 unsigned long flags;
241
242 bridge = of_fpga_bridge_get(np, info);
243 if (IS_ERR(bridge))
244 return PTR_ERR(bridge);
245
246 spin_lock_irqsave(&bridge_list_lock, flags);
247 list_add(&bridge->node, bridge_list);
248 spin_unlock_irqrestore(&bridge_list_lock, flags);
249
250 return 0;
251}
252EXPORT_SYMBOL_GPL(of_fpga_bridge_get_to_list);
253
254/**
255 * fpga_bridge_get_to_list - given device, get a bridge, add it to a list
256 *
257 * @dev: FPGA bridge device
258 * @info: fpga image specific information
259 * @bridge_list: list of FPGA bridges
260 *
261 * Get an exclusive reference to the bridge and it to the list.
262 *
263 * Return 0 for success, error code from fpga_bridge_get() otherwise.
264 */
265int fpga_bridge_get_to_list(struct device *dev,
266 struct fpga_image_info *info,
267 struct list_head *bridge_list)
268{
269 struct fpga_bridge *bridge;
270 unsigned long flags;
271
272 bridge = fpga_bridge_get(dev, info);
273 if (IS_ERR(bridge))
274 return PTR_ERR(bridge);
275
276 spin_lock_irqsave(&bridge_list_lock, flags);
277 list_add(&bridge->node, bridge_list);
278 spin_unlock_irqrestore(&bridge_list_lock, flags);
279
280 return 0;
281}
282EXPORT_SYMBOL_GPL(fpga_bridge_get_to_list);
283
284static ssize_t name_show(struct device *dev,
285 struct device_attribute *attr, char *buf)
286{
287 struct fpga_bridge *bridge = to_fpga_bridge(dev);
288
289 return sprintf(buf, "%s\n", bridge->name);
290}
291
292static ssize_t state_show(struct device *dev,
293 struct device_attribute *attr, char *buf)
294{
295 struct fpga_bridge *bridge = to_fpga_bridge(dev);
296 int enable = 1;
297
298 if (bridge->br_ops && bridge->br_ops->enable_show)
299 enable = bridge->br_ops->enable_show(bridge);
300
301 return sprintf(buf, "%s\n", enable ? "enabled" : "disabled");
302}
303
304static DEVICE_ATTR_RO(name);
305static DEVICE_ATTR_RO(state);
306
307static struct attribute *fpga_bridge_attrs[] = {
308 &dev_attr_name.attr,
309 &dev_attr_state.attr,
310 NULL,
311};
312ATTRIBUTE_GROUPS(fpga_bridge);
313
314/**
315 * fpga_bridge_register - create and register an FPGA Bridge device
316 * @parent: FPGA bridge device from pdev
317 * @name: FPGA bridge name
318 * @br_ops: pointer to structure of fpga bridge ops
319 * @priv: FPGA bridge private data
320 *
321 * Return: struct fpga_bridge pointer or ERR_PTR()
322 */
323struct fpga_bridge *
324fpga_bridge_register(struct device *parent, const char *name,
325 const struct fpga_bridge_ops *br_ops,
326 void *priv)
327{
328 struct fpga_bridge *bridge;
329 int id, ret;
330
331 if (!br_ops) {
332 dev_err(parent, "Attempt to register without fpga_bridge_ops\n");
333 return ERR_PTR(-EINVAL);
334 }
335
336 if (!name || !strlen(name)) {
337 dev_err(parent, "Attempt to register with no name!\n");
338 return ERR_PTR(-EINVAL);
339 }
340
341 bridge = kzalloc(sizeof(*bridge), GFP_KERNEL);
342 if (!bridge)
343 return ERR_PTR(-ENOMEM);
344
345 id = ida_alloc(&fpga_bridge_ida, GFP_KERNEL);
346 if (id < 0) {
347 ret = id;
348 goto error_kfree;
349 }
350
351 mutex_init(&bridge->mutex);
352 INIT_LIST_HEAD(&bridge->node);
353
354 bridge->name = name;
355 bridge->br_ops = br_ops;
356 bridge->priv = priv;
357
358 bridge->dev.groups = br_ops->groups;
359 bridge->dev.class = fpga_bridge_class;
360 bridge->dev.parent = parent;
361 bridge->dev.of_node = parent->of_node;
362 bridge->dev.id = id;
363 of_platform_populate(bridge->dev.of_node, NULL, NULL, &bridge->dev);
364
365 ret = dev_set_name(&bridge->dev, "br%d", id);
366 if (ret)
367 goto error_device;
368
369 ret = device_register(&bridge->dev);
370 if (ret) {
371 put_device(&bridge->dev);
372 return ERR_PTR(ret);
373 }
374
375 return bridge;
376
377error_device:
378 ida_free(&fpga_bridge_ida, id);
379error_kfree:
380 kfree(bridge);
381
382 return ERR_PTR(ret);
383}
384EXPORT_SYMBOL_GPL(fpga_bridge_register);
385
386/**
387 * fpga_bridge_unregister - unregister an FPGA bridge
388 *
389 * @bridge: FPGA bridge struct
390 *
391 * This function is intended for use in an FPGA bridge driver's remove function.
392 */
393void fpga_bridge_unregister(struct fpga_bridge *bridge)
394{
395 /*
396 * If the low level driver provides a method for putting bridge into
397 * a desired state upon unregister, do it.
398 */
399 if (bridge->br_ops && bridge->br_ops->fpga_bridge_remove)
400 bridge->br_ops->fpga_bridge_remove(bridge);
401
402 device_unregister(&bridge->dev);
403}
404EXPORT_SYMBOL_GPL(fpga_bridge_unregister);
405
406static void fpga_bridge_dev_release(struct device *dev)
407{
408 struct fpga_bridge *bridge = to_fpga_bridge(dev);
409
410 ida_free(&fpga_bridge_ida, bridge->dev.id);
411 kfree(bridge);
412}
413
414static int __init fpga_bridge_dev_init(void)
415{
416 fpga_bridge_class = class_create(THIS_MODULE, "fpga_bridge");
417 if (IS_ERR(fpga_bridge_class))
418 return PTR_ERR(fpga_bridge_class);
419
420 fpga_bridge_class->dev_groups = fpga_bridge_groups;
421 fpga_bridge_class->dev_release = fpga_bridge_dev_release;
422
423 return 0;
424}
425
426static void __exit fpga_bridge_dev_exit(void)
427{
428 class_destroy(fpga_bridge_class);
429 ida_destroy(&fpga_bridge_ida);
430}
431
432MODULE_DESCRIPTION("FPGA Bridge Driver");
433MODULE_AUTHOR("Alan Tull <atull@kernel.org>");
434MODULE_LICENSE("GPL v2");
435
436subsys_initcall(fpga_bridge_dev_init);
437module_exit(fpga_bridge_dev_exit);
1/*
2 * FPGA Bridge Framework Driver
3 *
4 * Copyright (C) 2013-2016 Altera Corporation, All Rights Reserved.
5 * Copyright (C) 2017 Intel Corporation
6 *
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms and conditions of the GNU General Public License,
9 * version 2, as published by the Free Software Foundation.
10 *
11 * This program is distributed in the hope it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
14 * more details.
15 *
16 * You should have received a copy of the GNU General Public License along with
17 * this program. If not, see <http://www.gnu.org/licenses/>.
18 */
19#include <linux/fpga/fpga-bridge.h>
20#include <linux/idr.h>
21#include <linux/kernel.h>
22#include <linux/module.h>
23#include <linux/of_platform.h>
24#include <linux/slab.h>
25#include <linux/spinlock.h>
26
27static DEFINE_IDA(fpga_bridge_ida);
28static struct class *fpga_bridge_class;
29
30/* Lock for adding/removing bridges to linked lists*/
31static spinlock_t bridge_list_lock;
32
33static int fpga_bridge_of_node_match(struct device *dev, const void *data)
34{
35 return dev->of_node == data;
36}
37
38/**
39 * fpga_bridge_enable - Enable transactions on the bridge
40 *
41 * @bridge: FPGA bridge
42 *
43 * Return: 0 for success, error code otherwise.
44 */
45int fpga_bridge_enable(struct fpga_bridge *bridge)
46{
47 dev_dbg(&bridge->dev, "enable\n");
48
49 if (bridge->br_ops && bridge->br_ops->enable_set)
50 return bridge->br_ops->enable_set(bridge, 1);
51
52 return 0;
53}
54EXPORT_SYMBOL_GPL(fpga_bridge_enable);
55
56/**
57 * fpga_bridge_disable - Disable transactions on the bridge
58 *
59 * @bridge: FPGA bridge
60 *
61 * Return: 0 for success, error code otherwise.
62 */
63int fpga_bridge_disable(struct fpga_bridge *bridge)
64{
65 dev_dbg(&bridge->dev, "disable\n");
66
67 if (bridge->br_ops && bridge->br_ops->enable_set)
68 return bridge->br_ops->enable_set(bridge, 0);
69
70 return 0;
71}
72EXPORT_SYMBOL_GPL(fpga_bridge_disable);
73
74static struct fpga_bridge *__fpga_bridge_get(struct device *dev,
75 struct fpga_image_info *info)
76{
77 struct fpga_bridge *bridge;
78 int ret = -ENODEV;
79
80 bridge = to_fpga_bridge(dev);
81
82 bridge->info = info;
83
84 if (!mutex_trylock(&bridge->mutex)) {
85 ret = -EBUSY;
86 goto err_dev;
87 }
88
89 if (!try_module_get(dev->parent->driver->owner))
90 goto err_ll_mod;
91
92 dev_dbg(&bridge->dev, "get\n");
93
94 return bridge;
95
96err_ll_mod:
97 mutex_unlock(&bridge->mutex);
98err_dev:
99 put_device(dev);
100 return ERR_PTR(ret);
101}
102
103/**
104 * of_fpga_bridge_get - get an exclusive reference to a fpga bridge
105 *
106 * @np: node pointer of a FPGA bridge
107 * @info: fpga image specific information
108 *
109 * Return fpga_bridge struct if successful.
110 * Return -EBUSY if someone already has a reference to the bridge.
111 * Return -ENODEV if @np is not a FPGA Bridge.
112 */
113struct fpga_bridge *of_fpga_bridge_get(struct device_node *np,
114 struct fpga_image_info *info)
115{
116 struct device *dev;
117
118 dev = class_find_device(fpga_bridge_class, NULL, np,
119 fpga_bridge_of_node_match);
120 if (!dev)
121 return ERR_PTR(-ENODEV);
122
123 return __fpga_bridge_get(dev, info);
124}
125EXPORT_SYMBOL_GPL(of_fpga_bridge_get);
126
127static int fpga_bridge_dev_match(struct device *dev, const void *data)
128{
129 return dev->parent == data;
130}
131
132/**
133 * fpga_bridge_get - get an exclusive reference to a fpga bridge
134 * @dev: parent device that fpga bridge was registered with
135 *
136 * Given a device, get an exclusive reference to a fpga bridge.
137 *
138 * Return: fpga manager struct or IS_ERR() condition containing error code.
139 */
140struct fpga_bridge *fpga_bridge_get(struct device *dev,
141 struct fpga_image_info *info)
142{
143 struct device *bridge_dev;
144
145 bridge_dev = class_find_device(fpga_bridge_class, NULL, dev,
146 fpga_bridge_dev_match);
147 if (!bridge_dev)
148 return ERR_PTR(-ENODEV);
149
150 return __fpga_bridge_get(bridge_dev, info);
151}
152EXPORT_SYMBOL_GPL(fpga_bridge_get);
153
154/**
155 * fpga_bridge_put - release a reference to a bridge
156 *
157 * @bridge: FPGA bridge
158 */
159void fpga_bridge_put(struct fpga_bridge *bridge)
160{
161 dev_dbg(&bridge->dev, "put\n");
162
163 bridge->info = NULL;
164 module_put(bridge->dev.parent->driver->owner);
165 mutex_unlock(&bridge->mutex);
166 put_device(&bridge->dev);
167}
168EXPORT_SYMBOL_GPL(fpga_bridge_put);
169
170/**
171 * fpga_bridges_enable - enable bridges in a list
172 * @bridge_list: list of FPGA bridges
173 *
174 * Enable each bridge in the list. If list is empty, do nothing.
175 *
176 * Return 0 for success or empty bridge list; return error code otherwise.
177 */
178int fpga_bridges_enable(struct list_head *bridge_list)
179{
180 struct fpga_bridge *bridge;
181 int ret;
182
183 list_for_each_entry(bridge, bridge_list, node) {
184 ret = fpga_bridge_enable(bridge);
185 if (ret)
186 return ret;
187 }
188
189 return 0;
190}
191EXPORT_SYMBOL_GPL(fpga_bridges_enable);
192
193/**
194 * fpga_bridges_disable - disable bridges in a list
195 *
196 * @bridge_list: list of FPGA bridges
197 *
198 * Disable each bridge in the list. If list is empty, do nothing.
199 *
200 * Return 0 for success or empty bridge list; return error code otherwise.
201 */
202int fpga_bridges_disable(struct list_head *bridge_list)
203{
204 struct fpga_bridge *bridge;
205 int ret;
206
207 list_for_each_entry(bridge, bridge_list, node) {
208 ret = fpga_bridge_disable(bridge);
209 if (ret)
210 return ret;
211 }
212
213 return 0;
214}
215EXPORT_SYMBOL_GPL(fpga_bridges_disable);
216
217/**
218 * fpga_bridges_put - put bridges
219 *
220 * @bridge_list: list of FPGA bridges
221 *
222 * For each bridge in the list, put the bridge and remove it from the list.
223 * If list is empty, do nothing.
224 */
225void fpga_bridges_put(struct list_head *bridge_list)
226{
227 struct fpga_bridge *bridge, *next;
228 unsigned long flags;
229
230 list_for_each_entry_safe(bridge, next, bridge_list, node) {
231 fpga_bridge_put(bridge);
232
233 spin_lock_irqsave(&bridge_list_lock, flags);
234 list_del(&bridge->node);
235 spin_unlock_irqrestore(&bridge_list_lock, flags);
236 }
237}
238EXPORT_SYMBOL_GPL(fpga_bridges_put);
239
240/**
241 * of_fpga_bridge_get_to_list - get a bridge, add it to a list
242 *
243 * @np: node pointer of a FPGA bridge
244 * @info: fpga image specific information
245 * @bridge_list: list of FPGA bridges
246 *
247 * Get an exclusive reference to the bridge and and it to the list.
248 *
249 * Return 0 for success, error code from of_fpga_bridge_get() othewise.
250 */
251int of_fpga_bridge_get_to_list(struct device_node *np,
252 struct fpga_image_info *info,
253 struct list_head *bridge_list)
254{
255 struct fpga_bridge *bridge;
256 unsigned long flags;
257
258 bridge = of_fpga_bridge_get(np, info);
259 if (IS_ERR(bridge))
260 return PTR_ERR(bridge);
261
262 spin_lock_irqsave(&bridge_list_lock, flags);
263 list_add(&bridge->node, bridge_list);
264 spin_unlock_irqrestore(&bridge_list_lock, flags);
265
266 return 0;
267}
268EXPORT_SYMBOL_GPL(of_fpga_bridge_get_to_list);
269
270/**
271 * fpga_bridge_get_to_list - given device, get a bridge, add it to a list
272 *
273 * @dev: FPGA bridge device
274 * @info: fpga image specific information
275 * @bridge_list: list of FPGA bridges
276 *
277 * Get an exclusive reference to the bridge and and it to the list.
278 *
279 * Return 0 for success, error code from fpga_bridge_get() othewise.
280 */
281int fpga_bridge_get_to_list(struct device *dev,
282 struct fpga_image_info *info,
283 struct list_head *bridge_list)
284{
285 struct fpga_bridge *bridge;
286 unsigned long flags;
287
288 bridge = fpga_bridge_get(dev, info);
289 if (IS_ERR(bridge))
290 return PTR_ERR(bridge);
291
292 spin_lock_irqsave(&bridge_list_lock, flags);
293 list_add(&bridge->node, bridge_list);
294 spin_unlock_irqrestore(&bridge_list_lock, flags);
295
296 return 0;
297}
298EXPORT_SYMBOL_GPL(fpga_bridge_get_to_list);
299
300static ssize_t name_show(struct device *dev,
301 struct device_attribute *attr, char *buf)
302{
303 struct fpga_bridge *bridge = to_fpga_bridge(dev);
304
305 return sprintf(buf, "%s\n", bridge->name);
306}
307
308static ssize_t state_show(struct device *dev,
309 struct device_attribute *attr, char *buf)
310{
311 struct fpga_bridge *bridge = to_fpga_bridge(dev);
312 int enable = 1;
313
314 if (bridge->br_ops && bridge->br_ops->enable_show)
315 enable = bridge->br_ops->enable_show(bridge);
316
317 return sprintf(buf, "%s\n", enable ? "enabled" : "disabled");
318}
319
320static DEVICE_ATTR_RO(name);
321static DEVICE_ATTR_RO(state);
322
323static struct attribute *fpga_bridge_attrs[] = {
324 &dev_attr_name.attr,
325 &dev_attr_state.attr,
326 NULL,
327};
328ATTRIBUTE_GROUPS(fpga_bridge);
329
330/**
331 * fpga_bridge_register - register a fpga bridge driver
332 * @dev: FPGA bridge device from pdev
333 * @name: FPGA bridge name
334 * @br_ops: pointer to structure of fpga bridge ops
335 * @priv: FPGA bridge private data
336 *
337 * Return: 0 for success, error code otherwise.
338 */
339int fpga_bridge_register(struct device *dev, const char *name,
340 const struct fpga_bridge_ops *br_ops, void *priv)
341{
342 struct fpga_bridge *bridge;
343 int id, ret = 0;
344
345 if (!name || !strlen(name)) {
346 dev_err(dev, "Attempt to register with no name!\n");
347 return -EINVAL;
348 }
349
350 bridge = kzalloc(sizeof(*bridge), GFP_KERNEL);
351 if (!bridge)
352 return -ENOMEM;
353
354 id = ida_simple_get(&fpga_bridge_ida, 0, 0, GFP_KERNEL);
355 if (id < 0) {
356 ret = id;
357 goto error_kfree;
358 }
359
360 mutex_init(&bridge->mutex);
361 INIT_LIST_HEAD(&bridge->node);
362
363 bridge->name = name;
364 bridge->br_ops = br_ops;
365 bridge->priv = priv;
366
367 device_initialize(&bridge->dev);
368 bridge->dev.groups = br_ops->groups;
369 bridge->dev.class = fpga_bridge_class;
370 bridge->dev.parent = dev;
371 bridge->dev.of_node = dev->of_node;
372 bridge->dev.id = id;
373 dev_set_drvdata(dev, bridge);
374
375 ret = dev_set_name(&bridge->dev, "br%d", id);
376 if (ret)
377 goto error_device;
378
379 ret = device_add(&bridge->dev);
380 if (ret)
381 goto error_device;
382
383 of_platform_populate(dev->of_node, NULL, NULL, dev);
384
385 dev_info(bridge->dev.parent, "fpga bridge [%s] registered\n",
386 bridge->name);
387
388 return 0;
389
390error_device:
391 ida_simple_remove(&fpga_bridge_ida, id);
392error_kfree:
393 kfree(bridge);
394
395 return ret;
396}
397EXPORT_SYMBOL_GPL(fpga_bridge_register);
398
399/**
400 * fpga_bridge_unregister - unregister a fpga bridge driver
401 * @dev: FPGA bridge device from pdev
402 */
403void fpga_bridge_unregister(struct device *dev)
404{
405 struct fpga_bridge *bridge = dev_get_drvdata(dev);
406
407 /*
408 * If the low level driver provides a method for putting bridge into
409 * a desired state upon unregister, do it.
410 */
411 if (bridge->br_ops && bridge->br_ops->fpga_bridge_remove)
412 bridge->br_ops->fpga_bridge_remove(bridge);
413
414 device_unregister(&bridge->dev);
415}
416EXPORT_SYMBOL_GPL(fpga_bridge_unregister);
417
418static void fpga_bridge_dev_release(struct device *dev)
419{
420 struct fpga_bridge *bridge = to_fpga_bridge(dev);
421
422 ida_simple_remove(&fpga_bridge_ida, bridge->dev.id);
423 kfree(bridge);
424}
425
426static int __init fpga_bridge_dev_init(void)
427{
428 spin_lock_init(&bridge_list_lock);
429
430 fpga_bridge_class = class_create(THIS_MODULE, "fpga_bridge");
431 if (IS_ERR(fpga_bridge_class))
432 return PTR_ERR(fpga_bridge_class);
433
434 fpga_bridge_class->dev_groups = fpga_bridge_groups;
435 fpga_bridge_class->dev_release = fpga_bridge_dev_release;
436
437 return 0;
438}
439
440static void __exit fpga_bridge_dev_exit(void)
441{
442 class_destroy(fpga_bridge_class);
443 ida_destroy(&fpga_bridge_ida);
444}
445
446MODULE_DESCRIPTION("FPGA Bridge Driver");
447MODULE_AUTHOR("Alan Tull <atull@kernel.org>");
448MODULE_LICENSE("GPL v2");
449
450subsys_initcall(fpga_bridge_dev_init);
451module_exit(fpga_bridge_dev_exit);