Lines Matching refs:region

10 #include <linux/fpga/fpga-region.h>
36  * fpga_region_get - get an exclusive reference to a fpga region
37  * @region: FPGA Region struct
39  * Caller should call fpga_region_put() when done with region.
42  * Return -EBUSY if someone already has a reference to the region.
45 static struct fpga_region *fpga_region_get(struct fpga_region *region)
47 	struct device *dev = &region->dev;
49 	if (!mutex_trylock(&region->mutex)) {
57 		mutex_unlock(&region->mutex);
63 	return region;
67  * fpga_region_put - release a reference to a region
69  * @region: FPGA region
71 static void fpga_region_put(struct fpga_region *region)
73 	struct device *dev = &region->dev;
79 	mutex_unlock(&region->mutex);
85  * @region: FPGA region
87  * Program an FPGA using fpga image info (region->info).
88  * If the region has a get_bridges function, the exclusive reference for the
90  * reprogramming the region until the caller considers it safe to do so.
92  * reprogram the region.
96 int fpga_region_program_fpga(struct fpga_region *region)
98 	struct device *dev = &region->dev;
99 	struct fpga_image_info *info = region->info;
102 	region = fpga_region_get(region);
103 	if (IS_ERR(region)) {
104 		dev_err(dev, "failed to get FPGA region\n");
105 		return PTR_ERR(region);
108 	ret = fpga_mgr_lock(region->mgr);
116 	 * fpga region struct.  Or we don't have any bridges.
118 	if (region->get_bridges) {
119 		ret = region->get_bridges(region);
121 			dev_err(dev, "failed to get fpga region bridges\n");
126 	ret = fpga_bridges_disable(&region->bridge_list);
132 	ret = fpga_mgr_load(region->mgr, info);
138 	ret = fpga_bridges_enable(&region->bridge_list);
140 		dev_err(dev, "failed to enable region bridges\n");
144 	fpga_mgr_unlock(region->mgr);
145 	fpga_region_put(region);
150 	if (region->get_bridges)
151 		fpga_bridges_put(&region->bridge_list);
153 	fpga_mgr_unlock(region->mgr);
155 	fpga_region_put(region);
164 	struct fpga_region *region = to_fpga_region(dev);
166 	if (!region->compat_id)
170 		       (unsigned long long)region->compat_id->id_h,
171 		       (unsigned long long)region->compat_id->id_l);
185  * @mgr: manager that programs this region
188  * The caller of this function is responsible for freeing the resulting region
199 	struct fpga_region *region;
202 	region = kzalloc(sizeof(*region), GFP_KERNEL);
203 	if (!region)
210 	region->mgr = mgr;
211 	region->get_bridges = get_bridges;
212 	mutex_init(&region->mutex);
213 	INIT_LIST_HEAD(&region->bridge_list);
215 	device_initialize(&region->dev);
216 	region->dev.class = fpga_region_class;
217 	region->dev.parent = dev;
218 	region->dev.of_node = dev->of_node;
219 	region->dev.id = id;
221 	ret = dev_set_name(&region->dev, "region%d", id);
225 	return region;
230 	kfree(region);
237  * fpga_region_free - free a FPGA region created by fpga_region_create()
238  * @region: FPGA region
240 void fpga_region_free(struct fpga_region *region)
242 	ida_simple_remove(&fpga_region_ida, region->dev.id);
243 	kfree(region);
249 	struct fpga_region *region = *(struct fpga_region **)res;
251 	fpga_region_free(region);
255  * devm_fpga_region_create - create and initialize a managed FPGA region struct
257  * @mgr: manager that programs this region
260  * This function is intended for use in a FPGA region driver's probe function.
261  * After the region driver creates the region struct with
263  * The region driver's remove function should call fpga_region_unregister().
264  * The region struct allocated with this function will be freed automatically on
275 	struct fpga_region **ptr, *region;
281 	region = fpga_region_create(dev, mgr, get_bridges);
282 	if (!region) {
285 		*ptr = region;
289 	return region;
294  * fpga_region_register - register a FPGA region
295  * @region: FPGA region
299 int fpga_region_register(struct fpga_region *region)
301 	return device_add(&region->dev);
306  * fpga_region_unregister - unregister a FPGA region
307  * @region: FPGA region
309  * This function is intended for use in a FPGA region driver's remove function.
311 void fpga_region_unregister(struct fpga_region *region)
313 	device_unregister(&region->dev);