3  * FPGA Bridge Framework Driver
8 #include <linux/fpga/fpga-bridge.h>
23  * fpga_bridge_enable - Enable transactions on the bridge
25  * @bridge: FPGA bridge
29 int fpga_bridge_enable(struct fpga_bridge *bridge)  in fpga_bridge_enable()  argument
31 	dev_dbg(&bridge->dev, "enable\n");  in fpga_bridge_enable()
33 	if (bridge->br_ops && bridge->br_ops->enable_set)  in fpga_bridge_enable()
34 		return bridge->br_ops->enable_set(bridge, 1);  in fpga_bridge_enable()
41  * fpga_bridge_disable - Disable transactions on the bridge
43  * @bridge: FPGA bridge
47 int fpga_bridge_disable(struct fpga_bridge *bridge)  in fpga_bridge_disable()  argument
49 	dev_dbg(&bridge->dev, "disable\n");  in fpga_bridge_disable()
51 	if (bridge->br_ops && bridge->br_ops->enable_set)  in fpga_bridge_disable()
52 		return bridge->br_ops->enable_set(bridge, 0);  in fpga_bridge_disable()
61 	struct fpga_bridge *bridge;  in __fpga_bridge_get()  local
64 	bridge = to_fpga_bridge(dev);  in __fpga_bridge_get()
66 	bridge->info = info;  in __fpga_bridge_get()
68 	if (!mutex_trylock(&bridge->mutex)) {  in __fpga_bridge_get()
76 	dev_dbg(&bridge->dev, "get\n");  in __fpga_bridge_get()
78 	return bridge;  in __fpga_bridge_get()
81 	mutex_unlock(&bridge->mutex);  in __fpga_bridge_get()
88  * of_fpga_bridge_get - get an exclusive reference to an fpga bridge
90  * @np: node pointer of an FPGA bridge
94  * Return -EBUSY if someone already has a reference to the bridge.
95  * Return -ENODEV if @np is not an FPGA Bridge.
116  * fpga_bridge_get - get an exclusive reference to an fpga bridge
117  * @dev:	parent device that fpga bridge was registered with
120  * Given a device, get an exclusive reference to an fpga bridge.
122  * Return: fpga bridge struct or IS_ERR() condition containing error code.
139  * fpga_bridge_put - release a reference to a bridge
141  * @bridge: FPGA bridge
143 void fpga_bridge_put(struct fpga_bridge *bridge)  in fpga_bridge_put()  argument
145 	dev_dbg(&bridge->dev, "put\n");  in fpga_bridge_put()
147 	bridge->info = NULL;  in fpga_bridge_put()
148 	module_put(bridge->dev.parent->driver->owner);  in fpga_bridge_put()
149 	mutex_unlock(&bridge->mutex);  in fpga_bridge_put()
150 	put_device(&bridge->dev);  in fpga_bridge_put()
158  * Enable each bridge in the list.  If list is empty, do nothing.
160  * Return 0 for success or empty bridge list; return error code otherwise.
164 	struct fpga_bridge *bridge;  in fpga_bridges_enable()  local
167 	list_for_each_entry(bridge, bridge_list, node) {  in fpga_bridges_enable()
168 		ret = fpga_bridge_enable(bridge);  in fpga_bridges_enable()
182  * Disable each bridge in the list.  If list is empty, do nothing.
184  * Return 0 for success or empty bridge list; return error code otherwise.
188 	struct fpga_bridge *bridge;  in fpga_bridges_disable()  local
191 	list_for_each_entry(bridge, bridge_list, node) {  in fpga_bridges_disable()
192 		ret = fpga_bridge_disable(bridge);  in fpga_bridges_disable()
206  * For each bridge in the list, put the bridge and remove it from the list.
211 	struct fpga_bridge *bridge, *next;  in fpga_bridges_put()  local
214 	list_for_each_entry_safe(bridge, next, bridge_list, node) {  in fpga_bridges_put()
215 		fpga_bridge_put(bridge);  in fpga_bridges_put()
218 		list_del(&bridge->node);  in fpga_bridges_put()
225  * of_fpga_bridge_get_to_list - get a bridge, add it to a list
227  * @np: node pointer of an FPGA bridge
231  * Get an exclusive reference to the bridge and it to the list.
239 	struct fpga_bridge *bridge;  in of_fpga_bridge_get_to_list()  local
242 	bridge = of_fpga_bridge_get(np, info);  in of_fpga_bridge_get_to_list()
243 	if (IS_ERR(bridge))  in of_fpga_bridge_get_to_list()
244 		return PTR_ERR(bridge);  in of_fpga_bridge_get_to_list()
247 	list_add(&bridge->node, bridge_list);  in of_fpga_bridge_get_to_list()
255  * fpga_bridge_get_to_list - given device, get a bridge, add it to a list
257  * @dev: FPGA bridge device
261  * Get an exclusive reference to the bridge and it to the list.
269 	struct fpga_bridge *bridge;  in fpga_bridge_get_to_list()  local
272 	bridge = fpga_bridge_get(dev, info);  in fpga_bridge_get_to_list()
273 	if (IS_ERR(bridge))  in fpga_bridge_get_to_list()
274 		return PTR_ERR(bridge);  in fpga_bridge_get_to_list()
277 	list_add(&bridge->node, bridge_list);  in fpga_bridge_get_to_list()
287 	struct fpga_bridge *bridge = to_fpga_bridge(dev);  in name_show()  local
289 	return sprintf(buf, "%s\n", bridge->name);  in name_show()
295 	struct fpga_bridge *bridge = to_fpga_bridge(dev);  in state_show()  local
298 	if (bridge->br_ops && bridge->br_ops->enable_show)  in state_show()
299 		enable = bridge->br_ops->enable_show(bridge);  in state_show()
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
328 	struct fpga_bridge *bridge;  in fpga_bridge_register()  local
341 	bridge = kzalloc(sizeof(*bridge), GFP_KERNEL);  in fpga_bridge_register()
342 	if (!bridge)  in fpga_bridge_register()
351 	mutex_init(&bridge->mutex);  in fpga_bridge_register()
352 	INIT_LIST_HEAD(&bridge->node);  in fpga_bridge_register()
354 	bridge->name = name;  in fpga_bridge_register()
355 	bridge->br_ops = br_ops;  in fpga_bridge_register()
356 	bridge->priv = priv;  in fpga_bridge_register()
358 	bridge->dev.groups = br_ops->groups;  in fpga_bridge_register()
359 	bridge->dev.class = fpga_bridge_class;  in fpga_bridge_register()
360 	bridge->dev.parent = parent;  in fpga_bridge_register()
361 	bridge->dev.of_node = parent->of_node;  in fpga_bridge_register()
362 	bridge->dev.id = id;  in fpga_bridge_register()
363 	of_platform_populate(bridge->dev.of_node, NULL, NULL, &bridge->dev);  in fpga_bridge_register()
365 	ret = dev_set_name(&bridge->dev, "br%d", id);  in fpga_bridge_register()
369 	ret = device_register(&bridge->dev);  in fpga_bridge_register()
371 		put_device(&bridge->dev);  in fpga_bridge_register()
375 	return bridge;  in fpga_bridge_register()
380 	kfree(bridge);  in fpga_bridge_register()
387  * fpga_bridge_unregister - unregister an FPGA bridge
389  * @bridge: FPGA bridge struct
391  * This function is intended for use in an FPGA bridge driver's remove function.
393 void fpga_bridge_unregister(struct fpga_bridge *bridge)  in fpga_bridge_unregister()  argument
396 	 * If the low level driver provides a method for putting bridge into  in fpga_bridge_unregister()
399 	if (bridge->br_ops && bridge->br_ops->fpga_bridge_remove)  in fpga_bridge_unregister()
400 		bridge->br_ops->fpga_bridge_remove(bridge);  in fpga_bridge_unregister()
402 	device_unregister(&bridge->dev);  in fpga_bridge_unregister()
408 	struct fpga_bridge *bridge = to_fpga_bridge(dev);  in fpga_bridge_dev_release()  local
410 	ida_free(&fpga_bridge_ida, bridge->dev.id);  in fpga_bridge_dev_release()
411 	kfree(bridge);  in fpga_bridge_dev_release()
432 MODULE_DESCRIPTION("FPGA Bridge Driver");