fpga-bridge.h

/* SPDX-License-Identifier: GPL-2.0-only */
#include <common.h>

#ifndef _LINUX_FPGA_BRIDGE_H
#define _LINUX_FPGA_BRIDGE_H

struct fpga_bridge;

/**
 * struct fpga_bridge_ops - ops for low level FPGA bridge drivers
 * @enable_show: returns the FPGA bridge's status
 * @enable_set: set a FPGA bridge as enabled or disabled
 * @fpga_bridge_remove: set FPGA into a specific state during driver remove
 */
struct fpga_bridge_ops {
	int (*enable_show)(struct fpga_bridge *bridge);
	int (*enable_set)(struct fpga_bridge *bridge, bool enable);
	void (*fpga_bridge_remove)(struct fpga_bridge *bridge);
};

/**
 * struct fpga_bridge - FPGA bridge structure
 * @name: name of low level FPGA bridge
 * @dev: FPGA bridge device
 * @mutex: enforces exclusive reference to bridge
 * @br_ops: pointer to struct of FPGA bridge ops
 * @info: fpga image specific information
 * @node: FPGA bridge list node
 * @priv: low level driver private date
 */
struct fpga_bridge {
	struct device dev;
	const struct fpga_bridge_ops *br_ops;
	struct list_head node;
	unsigned int enable;
	void *priv;
};

#define to_fpga_bridge(d) container_of(d, struct fpga_bridge, dev)

struct fpga_bridge *of_fpga_bridge_get(struct device_node *node);
void fpga_bridge_put(struct fpga_bridge *bridge);
int fpga_bridge_enable(struct fpga_bridge *bridge);
int fpga_bridge_disable(struct fpga_bridge *bridge);

#ifdef CONFIG_FPGA_BRIDGE
int fpga_bridges_enable(struct list_head *bridge_list);
int fpga_bridges_disable(struct list_head *bridge_list);
int fpga_bridge_get_to_list(struct device_node *np,
			    struct list_head *bridge_list);
void fpga_bridges_put(struct list_head *bridge_list);
#else
static inline int fpga_bridges_enable(struct list_head *bridge_list)
{
	return -ENOSYS;
};
static inline int fpga_bridges_disable(struct list_head *bridge_list)
{
	return -ENOSYS;
};
static inline int fpga_bridge_get_to_list(struct device_node *np,
			    struct list_head *bridge_list)
{
	return -ENOSYS;
};
static inline void fpga_bridges_put(struct list_head *bridge_list)
{
	return;
};
#endif

int fpga_bridge_register(struct device *dev, const char *name,
			 const struct fpga_bridge_ops *br_ops, void *priv);

#endif /* _LINUX_FPGA_BRIDGE_H */