1 // SPDX-License-Identifier: GPL-2.0
3  * FPGA Region - Support for FPGA programming under Linux
5  *  Copyright (C) 2013-2016 Altera Corporation
8 #include <linux/fpga/fpga-bridge.h>
9 #include <linux/fpga/fpga-mgr.h>
10 #include <linux/fpga/fpga-region.h>
36  * fpga_region_get - get an exclusive reference to an fpga region
37  * @region: FPGA Region struct
43  * * -EBUSY if someone already has a reference to the region.
44  * * -ENODEV if can't take parent driver module refcount.
48 	struct device *dev = &region->dev;  in fpga_region_get()
50 	if (!mutex_trylock(&region->mutex)) {  in fpga_region_get()
51 		dev_dbg(dev, "%s: FPGA Region already in use\n", __func__);  in fpga_region_get()
52 		return ERR_PTR(-EBUSY);  in fpga_region_get()
56 	if (!try_module_get(region->ops_owner)) {  in fpga_region_get()
58 		mutex_unlock(&region->mutex);  in fpga_region_get()
59 		return ERR_PTR(-ENODEV);  in fpga_region_get()
68  * fpga_region_put - release a reference to a region
70  * @region: FPGA region
74 	struct device *dev = &region->dev;  in fpga_region_put()
78 	module_put(region->ops_owner);  in fpga_region_put()
80 	mutex_unlock(&region->mutex);  in fpga_region_put()
84  * fpga_region_program_fpga - program FPGA
86  * @region: FPGA region
88  * Program an FPGA using fpga image info (region->info).
99 	struct device *dev = &region->dev;  in fpga_region_program_fpga()
100 	struct fpga_image_info *info = region->info;  in fpga_region_program_fpga()
105 		dev_err(dev, "failed to get FPGA region\n");  in fpga_region_program_fpga()
109 	ret = fpga_mgr_lock(region->mgr);  in fpga_region_program_fpga()
111 		dev_err(dev, "FPGA manager is busy\n");  in fpga_region_program_fpga()
117 	 * fpga region struct.  Or we don't have any bridges.  in fpga_region_program_fpga()
119 	if (region->get_bridges) {  in fpga_region_program_fpga()
120 		ret = region->get_bridges(region);  in fpga_region_program_fpga()
122 			dev_err(dev, "failed to get fpga region bridges\n");  in fpga_region_program_fpga()
127 	ret = fpga_bridges_disable(&region->bridge_list);  in fpga_region_program_fpga()
133 	ret = fpga_mgr_load(region->mgr, info);  in fpga_region_program_fpga()
135 		dev_err(dev, "failed to load FPGA image\n");  in fpga_region_program_fpga()
139 	ret = fpga_bridges_enable(&region->bridge_list);  in fpga_region_program_fpga()
145 	fpga_mgr_unlock(region->mgr);  in fpga_region_program_fpga()
151 	if (region->get_bridges)  in fpga_region_program_fpga()
152 		fpga_bridges_put(&region->bridge_list);  in fpga_region_program_fpga()
154 	fpga_mgr_unlock(region->mgr);  in fpga_region_program_fpga()
167 	if (!region->compat_id)  in compat_id_show()
168 		return -ENOENT;  in compat_id_show()
171 		       (unsigned long long)region->compat_id->id_h,  in compat_id_show()
172 		       (unsigned long long)region->compat_id->id_l);  in compat_id_show()
184  * __fpga_region_register_full - create and register an FPGA Region device
186  * @info: parameters for FPGA Region
201 		return ERR_PTR(-EINVAL);  in __fpga_region_register_full()
206 		return ERR_PTR(-ENOMEM);  in __fpga_region_register_full()
214 	region->mgr = info->mgr;  in __fpga_region_register_full()
215 	region->compat_id = info->compat_id;  in __fpga_region_register_full()
216 	region->priv = info->priv;  in __fpga_region_register_full()
217 	region->get_bridges = info->get_bridges;  in __fpga_region_register_full()
218 	region->ops_owner = owner;  in __fpga_region_register_full()
220 	mutex_init(&region->mutex);  in __fpga_region_register_full()
221 	INIT_LIST_HEAD(&region->bridge_list);  in __fpga_region_register_full()
223 	region->dev.class = &fpga_region_class;  in __fpga_region_register_full()
224 	region->dev.parent = parent;  in __fpga_region_register_full()
225 	region->dev.of_node = parent->of_node;  in __fpga_region_register_full()
226 	region->dev.id = id;  in __fpga_region_register_full()
228 	ret = dev_set_name(&region->dev, "region%d", id);  in __fpga_region_register_full()
232 	ret = device_register(&region->dev);  in __fpga_region_register_full()
234 		put_device(&region->dev);  in __fpga_region_register_full()
250  * __fpga_region_register - create and register an FPGA Region device
252  * @mgr: manager that programs this region
263 __fpga_region_register(struct device *parent, struct fpga_manager *mgr,  in __fpga_region_register()  argument
268 	info.mgr = mgr;  in __fpga_region_register()
276  * fpga_region_unregister - unregister an FPGA region
277  * @region: FPGA region
279  * This function is intended for use in an FPGA region driver's remove function.
283 	device_unregister(&region->dev);  in fpga_region_unregister()
291 	ida_free(&fpga_region_ida, region->dev.id);  in fpga_region_dev_release()
302  * fpga_region_init - creates the fpga_region class.
320 MODULE_DESCRIPTION("FPGA Region");