1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * (C) Copyright 2002
4  * Rich Ireland, Enterasys Networks, rireland@enterasys.com.
5  */
6 
7 #include <fpga.h>
8 
9 #ifndef _XILINX_H_
10 #define _XILINX_H_
11 
12 /* Xilinx types
13  *********************************************************************/
14 typedef enum {			/* typedef xilinx_iface */
15 	min_xilinx_iface_type,	/* low range check value */
16 	slave_serial,		/* serial data and external clock */
17 	master_serial,		/* serial data w/ internal clock (not used) */
18 	slave_parallel,		/* parallel data w/ external latch */
19 	jtag_mode,		/* jtag/tap serial (not used ) */
20 	master_selectmap,	/* master SelectMap (virtex2)           */
21 	slave_selectmap,	/* slave SelectMap (virtex2)            */
22 	devcfg,			/* devcfg interface (zynq) */
23 	csu_dma,		/* csu_dma interface (zynqmp) */
24 	max_xilinx_iface_type	/* insert all new types before this */
25 } xilinx_iface;			/* end, typedef xilinx_iface */
26 
27 typedef enum {			/* typedef xilinx_family */
28 	min_xilinx_type,	/* low range check value */
29 	xilinx_spartan2,	/* Spartan-II Family */
30 	xilinx_virtexE,		/* Virtex-E Family */
31 	xilinx_virtex2,		/* Virtex2 Family */
32 	xilinx_spartan3,	/* Spartan-III Family */
33 	xilinx_zynq,		/* Zynq Family */
34 	xilinx_zynqmp,		/* ZynqMP Family */
35 	max_xilinx_type		/* insert all new types before this */
36 } xilinx_family;		/* end, typedef xilinx_family */
37 
38 typedef struct {		/* typedef xilinx_desc */
39 	xilinx_family family;	/* part type */
40 	xilinx_iface iface;	/* interface type */
41 	size_t size;		/* bytes of data part can accept */
42 	void *iface_fns;	/* interface function table */
43 	int cookie;		/* implementation specific cookie */
44 	struct xilinx_fpga_op *operations; /* operations */
45 	char *name;		/* device name in bitstream */
46 } xilinx_desc;			/* end, typedef xilinx_desc */
47 
48 struct xilinx_fpga_op {
49 	int (*load)(xilinx_desc *, const void *, size_t, bitstream_type);
50 	int (*loadfs)(xilinx_desc *, const void *, size_t, fpga_fs_info *);
51 	int (*loads)(xilinx_desc *desc, const void *buf, size_t bsize,
52 		     struct fpga_secure_info *fpga_sec_info);
53 	int (*dump)(xilinx_desc *, const void *, size_t);
54 	int (*info)(xilinx_desc *);
55 };
56 
57 /* Generic Xilinx Functions
58  *********************************************************************/
59 int xilinx_load(xilinx_desc *desc, const void *image, size_t size,
60 		bitstream_type bstype);
61 int xilinx_dump(xilinx_desc *desc, const void *buf, size_t bsize);
62 int xilinx_info(xilinx_desc *desc);
63 int xilinx_loadfs(xilinx_desc *desc, const void *buf, size_t bsize,
64 		  fpga_fs_info *fpga_fsinfo);
65 int xilinx_loads(xilinx_desc *desc, const void *buf, size_t bsize,
66 		 struct fpga_secure_info *fpga_sec_info);
67 
68 /* Board specific implementation specific function types
69  *********************************************************************/
70 typedef int (*xilinx_pgm_fn)(int assert_pgm, int flush, int cookie);
71 typedef int (*xilinx_init_fn)(int cookie);
72 typedef int (*xilinx_err_fn)(int cookie);
73 typedef int (*xilinx_done_fn)(int cookie);
74 typedef int (*xilinx_clk_fn)(int assert_clk, int flush, int cookie);
75 typedef int (*xilinx_cs_fn)(int assert_cs, int flush, int cookie);
76 typedef int (*xilinx_wr_fn)(int assert_write, int flush, int cookie);
77 typedef int (*xilinx_rdata_fn)(unsigned char *data, int cookie);
78 typedef int (*xilinx_wdata_fn)(unsigned char data, int flush, int cookie);
79 typedef int (*xilinx_busy_fn)(int cookie);
80 typedef int (*xilinx_abort_fn)(int cookie);
81 typedef int (*xilinx_pre_fn)(int cookie);
82 typedef int (*xilinx_post_fn)(int cookie);
83 typedef int (*xilinx_bwr_fn)(void *buf, size_t len, int flush, int cookie);
84 
85 #endif  /* _XILINX_H_ */
86