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 struct fpga_region;
11 
12 /**
13  * struct fpga_region_info - collection of parameters an FPGA Region
14  * @mgr: fpga region manager
15  * @compat_id: FPGA region id for compatibility check.
16  * @priv: fpga region private data
17  * @get_bridges: optional function to get bridges to a list
18  *
19  * fpga_region_info contains parameters for the register_full function.
20  * These are separated into an info structure because they some are optional
21  * others could be added to in the future. The info structure facilitates
22  * maintaining a stable API.
23  */
24 struct fpga_region_info {
25 	struct fpga_manager *mgr;
26 	struct fpga_compat_id *compat_id;
27 	void *priv;
28 	int (*get_bridges)(struct fpga_region *region);
29 };
30 
31 /**
32  * struct fpga_region - FPGA Region structure
33  * @dev: FPGA Region device
34  * @mutex: enforces exclusive reference to region
35  * @bridge_list: list of FPGA bridges specified in region
36  * @mgr: FPGA manager
37  * @info: FPGA image info
38  * @compat_id: FPGA region id for compatibility check.
39  * @priv: private data
40  * @get_bridges: optional function to get bridges to a list
41  */
42 struct fpga_region {
43 	struct device dev;
44 	struct mutex mutex; /* for exclusive reference to region */
45 	struct list_head bridge_list;
46 	struct fpga_manager *mgr;
47 	struct fpga_image_info *info;
48 	struct fpga_compat_id *compat_id;
49 	void *priv;
50 	int (*get_bridges)(struct fpga_region *region);
51 };
52 
53 #define to_fpga_region(d) container_of(d, struct fpga_region, dev)
54 
55 struct fpga_region *
56 fpga_region_class_find(struct device *start, const void *data,
57 		       int (*match)(struct device *, const void *));
58 
59 int fpga_region_program_fpga(struct fpga_region *region);
60 
61 struct fpga_region *
62 fpga_region_register_full(struct device *parent, const struct fpga_region_info *info);
63 
64 struct fpga_region *
65 fpga_region_register(struct device *parent, struct fpga_manager *mgr,
66 		     int (*get_bridges)(struct fpga_region *));
67 void fpga_region_unregister(struct fpga_region *region);
68 
69 #endif /* _FPGA_REGION_H */
70