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