1 /* SPDX-License-Identifier: GPL-2.0 */
2 
3 #ifndef _FPGA_REGION_H
4 #define _FPGA_REGION_H
5 
6 #include <linux/device.h>
7 #include <linux/fpga/fpga-mgr.h>
8 #include <linux/fpga/fpga-bridge.h>
9 
10 /**
11  * struct fpga_region - FPGA Region structure
12  * @dev: FPGA Region device
13  * @mutex: enforces exclusive reference to region
14  * @bridge_list: list of FPGA bridges specified in region
15  * @mgr: FPGA manager
16  * @info: FPGA image info
17  * @compat_id: FPGA region id for compatibility check.
18  * @priv: private data
19  * @get_bridges: optional function to get bridges to a list
20  */
21 struct fpga_region {
22 	struct device dev;
23 	struct mutex mutex; /* for exclusive reference to region */
24 	struct list_head bridge_list;
25 	struct fpga_manager *mgr;
26 	struct fpga_image_info *info;
27 	struct fpga_compat_id *compat_id;
28 	void *priv;
29 	int (*get_bridges)(struct fpga_region *region);
30 };
31 
32 #define to_fpga_region(d) container_of(d, struct fpga_region, dev)
33 
34 struct fpga_region *fpga_region_class_find(
35 	struct device *start, const void *data,
36 	int (*match)(struct device *, const void *));
37 
38 int fpga_region_program_fpga(struct fpga_region *region);
39 
40 struct fpga_region
41 *fpga_region_create(struct device *dev, struct fpga_manager *mgr,
42 		    int (*get_bridges)(struct fpga_region *));
43 void fpga_region_free(struct fpga_region *region);
44 int fpga_region_register(struct fpga_region *region);
45 void fpga_region_unregister(struct fpga_region *region);
46 
47 struct fpga_region
48 *devm_fpga_region_create(struct device *dev, struct fpga_manager *mgr,
49 			int (*get_bridges)(struct fpga_region *));
50 
51 #endif /* _FPGA_REGION_H */
52