include/xilinx.h

   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_ */