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 cfi, /* CFI interface(versal) */ 25 max_xilinx_iface_type /* insert all new types before this */ 26 } xilinx_iface; /* end, typedef xilinx_iface */ 27 28 typedef enum { /* typedef xilinx_family */ 29 min_xilinx_type, /* low range check value */ 30 xilinx_spartan2, /* Spartan-II Family */ 31 xilinx_virtexE, /* Virtex-E Family */ 32 xilinx_virtex2, /* Virtex2 Family */ 33 xilinx_spartan3, /* Spartan-III Family */ 34 xilinx_zynq, /* Zynq Family */ 35 xilinx_zynqmp, /* ZynqMP Family */ 36 xilinx_versal, /* Versal Family */ 37 max_xilinx_type /* insert all new types before this */ 38 } xilinx_family; /* end, typedef xilinx_family */ 39 40 typedef struct { /* typedef xilinx_desc */ 41 xilinx_family family; /* part type */ 42 xilinx_iface iface; /* interface type */ 43 size_t size; /* bytes of data part can accept */ 44 void *iface_fns; /* interface function table */ 45 int cookie; /* implementation specific cookie */ 46 struct xilinx_fpga_op *operations; /* operations */ 47 char *name; /* device name in bitstream */ 48 } xilinx_desc; /* end, typedef xilinx_desc */ 49 50 struct xilinx_fpga_op { 51 int (*load)(xilinx_desc *, const void *, size_t, bitstream_type); 52 int (*loadfs)(xilinx_desc *, const void *, size_t, fpga_fs_info *); 53 int (*loads)(xilinx_desc *desc, const void *buf, size_t bsize, 54 struct fpga_secure_info *fpga_sec_info); 55 int (*dump)(xilinx_desc *, const void *, size_t); 56 int (*info)(xilinx_desc *); 57 }; 58 59 /* Generic Xilinx Functions 60 *********************************************************************/ 61 int xilinx_load(xilinx_desc *desc, const void *image, size_t size, 62 bitstream_type bstype); 63 int xilinx_dump(xilinx_desc *desc, const void *buf, size_t bsize); 64 int xilinx_info(xilinx_desc *desc); 65 int xilinx_loadfs(xilinx_desc *desc, const void *buf, size_t bsize, 66 fpga_fs_info *fpga_fsinfo); 67 int xilinx_loads(xilinx_desc *desc, const void *buf, size_t bsize, 68 struct fpga_secure_info *fpga_sec_info); 69 70 /* Board specific implementation specific function types 71 *********************************************************************/ 72 typedef int (*xilinx_pgm_fn)(int assert_pgm, int flush, int cookie); 73 typedef int (*xilinx_init_fn)(int cookie); 74 typedef int (*xilinx_err_fn)(int cookie); 75 typedef int (*xilinx_done_fn)(int cookie); 76 typedef int (*xilinx_clk_fn)(int assert_clk, int flush, int cookie); 77 typedef int (*xilinx_cs_fn)(int assert_cs, int flush, int cookie); 78 typedef int (*xilinx_wr_fn)(int assert_write, int flush, int cookie); 79 typedef int (*xilinx_rdata_fn)(unsigned char *data, int cookie); 80 typedef int (*xilinx_wdata_fn)(unsigned char data, int flush, int cookie); 81 typedef int (*xilinx_busy_fn)(int cookie); 82 typedef int (*xilinx_abort_fn)(int cookie); 83 typedef int (*xilinx_pre_fn)(int cookie); 84 typedef int (*xilinx_post_fn)(int cookie); 85 typedef int (*xilinx_bwr_fn)(void *buf, size_t len, int flush, int cookie); 86 87 #endif /* _XILINX_H_ */ 88