xilinx.h 3.9 KB

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