mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-23 01:10:04 +00:00
![Russ Weight](/assets/img/avatar_default.png)
The FPGA region class driver data structure is being treated as a managed resource instead of using the standard dev_release call-back function to release the class data structure. This change removes the managed resource code and combines the create() and register() functions into a single register() or register_full() function. The register_full() function accepts an info data structure to provide flexibility in passing optional parameters. The register() function supports the current parameter list for users that don't require the use of optional parameters. Signed-off-by: Russ Weight <russell.h.weight@intel.com> Reviewed-by: Xu Yilun <yilun.xu@intel.com> Acked-by: Xu Yilun <yilun.xu@intel.com> Signed-off-by: Moritz Fischer <mdf@kernel.org>
69 lines
2.1 KiB
C
69 lines
2.1 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
|
|
#ifndef _FPGA_REGION_H
|
|
#define _FPGA_REGION_H
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/fpga/fpga-mgr.h>
|
|
#include <linux/fpga/fpga-bridge.h>
|
|
|
|
struct fpga_region;
|
|
|
|
/**
|
|
* struct fpga_region_info - collection of parameters an FPGA Region
|
|
* @mgr: fpga region manager
|
|
* @compat_id: FPGA region id for compatibility check.
|
|
* @priv: fpga region private data
|
|
* @get_bridges: optional function to get bridges to a list
|
|
*
|
|
* fpga_region_info contains parameters for the register_full function.
|
|
* These are separated into an info structure because they some are optional
|
|
* others could be added to in the future. The info structure facilitates
|
|
* maintaining a stable API.
|
|
*/
|
|
struct fpga_region_info {
|
|
struct fpga_manager *mgr;
|
|
struct fpga_compat_id *compat_id;
|
|
void *priv;
|
|
int (*get_bridges)(struct fpga_region *region);
|
|
};
|
|
|
|
/**
|
|
* struct fpga_region - FPGA Region structure
|
|
* @dev: FPGA Region device
|
|
* @mutex: enforces exclusive reference to region
|
|
* @bridge_list: list of FPGA bridges specified in region
|
|
* @mgr: FPGA manager
|
|
* @info: FPGA image info
|
|
* @compat_id: FPGA region id for compatibility check.
|
|
* @priv: private data
|
|
* @get_bridges: optional function to get bridges to a list
|
|
*/
|
|
struct fpga_region {
|
|
struct device dev;
|
|
struct mutex mutex; /* for exclusive reference to region */
|
|
struct list_head bridge_list;
|
|
struct fpga_manager *mgr;
|
|
struct fpga_image_info *info;
|
|
struct fpga_compat_id *compat_id;
|
|
void *priv;
|
|
int (*get_bridges)(struct fpga_region *region);
|
|
};
|
|
|
|
#define to_fpga_region(d) container_of(d, struct fpga_region, dev)
|
|
|
|
struct fpga_region *fpga_region_class_find(
|
|
struct device *start, const void *data,
|
|
int (*match)(struct device *, const void *));
|
|
|
|
int fpga_region_program_fpga(struct fpga_region *region);
|
|
|
|
struct fpga_region *
|
|
fpga_region_register_full(struct device *parent, const struct fpga_region_info *info);
|
|
|
|
struct fpga_region *
|
|
fpga_region_register(struct device *parent, struct fpga_manager *mgr,
|
|
int (*get_bridges)(struct fpga_region *));
|
|
void fpga_region_unregister(struct fpga_region *region);
|
|
|
|
#endif /* _FPGA_REGION_H */
|