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 *********************************************************************/ 14typedef 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 28typedef 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/* FPGA bitstream supported types */ 41#define FPGA_LEGACY BIT(0) 42#define FPGA_XILINX_ZYNQMP_DDRAUTH BIT(1) 43#define FPGA_XILINX_ZYNQMP_ENC BIT(2) 44 45typedef struct { /* typedef xilinx_desc */ 46 xilinx_family family; /* part type */ 47 xilinx_iface iface; /* interface type */ 48 size_t size; /* bytes of data part can accept */ 49 void *iface_fns; /* interface function table */ 50 int cookie; /* implementation specific cookie */ 51 struct xilinx_fpga_op *operations; /* operations */ 52 char *name; /* device name in bitstream */ 53 int flags; /* compatible flags */ 54} xilinx_desc; /* end, typedef xilinx_desc */ 55 56struct xilinx_fpga_op { 57 int (*load)(xilinx_desc *desc, const void *buf, size_t bsize, 58 bitstream_type bstype, int flags); 59 int (*loadfs)(xilinx_desc *desc, const void *buf, size_t bsize, 60 fpga_fs_info *fpga_fsinfo); 61 int (*loads)(xilinx_desc *desc, const void *buf, size_t bsize, 62 struct fpga_secure_info *fpga_sec_info); 63 int (*dump)(xilinx_desc *desc, const void *buf, size_t bsize); 64 int (*info)(xilinx_desc *desc); 65#if CONFIG_IS_ENABLED(FPGA_LOAD_SECURE) 66 int (*str2flag)(xilinx_desc *desc, const char *string); 67#endif 68}; 69 70/* Generic Xilinx Functions 71 *********************************************************************/ 72int xilinx_load(xilinx_desc *desc, const void *image, size_t size, 73 bitstream_type bstype, int flags); 74int xilinx_dump(xilinx_desc *desc, const void *buf, size_t bsize); 75int xilinx_info(xilinx_desc *desc); 76int xilinx_loadfs(xilinx_desc *desc, const void *buf, size_t bsize, 77 fpga_fs_info *fpga_fsinfo); 78int xilinx_loads(xilinx_desc *desc, const void *buf, size_t bsize, 79 struct fpga_secure_info *fpga_sec_info); 80 81/* Board specific implementation specific function types 82 *********************************************************************/ 83typedef int (*xilinx_pgm_fn)(int assert_pgm, int flush, int cookie); 84typedef int (*xilinx_init_fn)(int cookie); 85typedef int (*xilinx_err_fn)(int cookie); 86typedef int (*xilinx_done_fn)(int cookie); 87typedef int (*xilinx_clk_fn)(int assert_clk, int flush, int cookie); 88typedef int (*xilinx_cs_fn)(int assert_cs, int flush, int cookie); 89typedef int (*xilinx_wr_fn)(int assert_write, int flush, int cookie); 90typedef int (*xilinx_rdata_fn)(unsigned char *data, int cookie); 91typedef int (*xilinx_wdata_fn)(unsigned char data, int flush, int cookie); 92typedef int (*xilinx_busy_fn)(int cookie); 93typedef int (*xilinx_abort_fn)(int cookie); 94typedef int (*xilinx_pre_fn)(int cookie); 95typedef int (*xilinx_post_fn)(int cookie); 96typedef int (*xilinx_bwr_fn)(void *buf, size_t len, int flush, int cookie); 97 98#endif /* _XILINX_H_ */ 99