]>
git.ipfire.org Git - thirdparty/u-boot.git/blob - drivers/fpga/fpga.c
1 // SPDX-License-Identifier: GPL-2.0+
4 * Rich Ireland, Enterasys Networks, rireland@enterasys.com.
7 /* Generic FPGA support */
8 #include <common.h> /* core U-Boot definitions */
9 #include <xilinx.h> /* xilinx specific definitions */
10 #include <altera.h> /* altera specific definitions */
13 /* Local definitions */
14 #ifndef CONFIG_MAX_FPGA_DEVICES
15 #define CONFIG_MAX_FPGA_DEVICES 5
18 /* Local static data */
19 static int next_desc
= FPGA_INVALID_DEVICE
;
20 static fpga_desc desc_table
[CONFIG_MAX_FPGA_DEVICES
];
24 * 'no support' message function
26 static void fpga_no_sup(char *fn
, char *msg
)
29 printf("%s: No support for %s.\n", fn
, msg
);
31 printf("No support for %s.\n", msg
);
33 printf("No FPGA support!\n");
38 * map a device number to a descriptor
40 const fpga_desc
*const fpga_get_desc(int devnum
)
42 fpga_desc
*desc
= (fpga_desc
*)NULL
;
44 if ((devnum
>= 0) && (devnum
< next_desc
)) {
45 desc
= &desc_table
[devnum
];
46 debug("%s: found fpga descriptor #%d @ 0x%p\n",
47 __func__
, devnum
, desc
);
55 * generic parameter checking code
57 const fpga_desc
*const fpga_validate(int devnum
, const void *buf
,
58 size_t bsize
, char *fn
)
60 const fpga_desc
*desc
= fpga_get_desc(devnum
);
63 printf("%s: Invalid device number %d\n", fn
, devnum
);
66 printf("%s: Null buffer.\n", fn
);
67 return (fpga_desc
* const)NULL
;
74 * generic multiplexing code
76 static int fpga_dev_info(int devnum
)
78 int ret_val
= FPGA_FAIL
; /* assume failure */
79 const fpga_desc
* const desc
= fpga_get_desc(devnum
);
82 debug("%s: Device Descriptor @ 0x%p\n",
83 __func__
, desc
->devdesc
);
85 switch (desc
->devtype
) {
87 #if defined(CONFIG_FPGA_XILINX)
88 printf("Xilinx Device\nDescriptor @ 0x%p\n", desc
);
89 ret_val
= xilinx_info(desc
->devdesc
);
91 fpga_no_sup((char *)__func__
, "Xilinx devices");
95 #if defined(CONFIG_FPGA_ALTERA)
96 printf("Altera Device\nDescriptor @ 0x%p\n", desc
);
97 ret_val
= altera_info(desc
->devdesc
);
99 fpga_no_sup((char *)__func__
, "Altera devices");
103 #if defined(CONFIG_FPGA_LATTICE)
104 printf("Lattice Device\nDescriptor @ 0x%p\n", desc
);
105 ret_val
= lattice_info(desc
->devdesc
);
107 fpga_no_sup((char *)__func__
, "Lattice devices");
111 printf("%s: Invalid or unsupported device type %d\n",
112 __func__
, desc
->devtype
);
115 printf("%s: Invalid device number %d\n", __func__
, devnum
);
122 * fpga_init is usually called from misc_init_r() and MUST be called
123 * before any of the other fpga functions are used.
128 memset(desc_table
, 0, sizeof(desc_table
));
130 debug("%s\n", __func__
);
135 * Basic interface function to get the current number of devices available.
144 * Add the device descriptor to the device table.
146 int fpga_add(fpga_type devtype
, void *desc
)
148 int devnum
= FPGA_INVALID_DEVICE
;
151 printf("%s: NULL device descriptor\n", __func__
);
156 printf("%s: FPGA support not initialized!\n", __func__
);
157 } else if ((devtype
> fpga_min_type
) && (devtype
< fpga_undefined
)) {
158 if (next_desc
< CONFIG_MAX_FPGA_DEVICES
) {
160 desc_table
[next_desc
].devtype
= devtype
;
161 desc_table
[next_desc
++].devdesc
= desc
;
163 printf("%s: Exceeded Max FPGA device count\n",
167 printf("%s: Unsupported FPGA type %d\n", __func__
, devtype
);
174 * Return 1 if the fpga data is partial.
175 * This is only required for fpga drivers that support bitstream_type.
177 int __weak
fpga_is_partial_data(int devnum
, size_t img_len
)
183 * Convert bitstream data and load into the fpga
185 int __weak
fpga_loadbitstream(int devnum
, char *fpgadata
, size_t size
,
186 bitstream_type bstype
)
188 printf("Bitstream support not implemented for this FPGA device\n");
192 #if defined(CONFIG_CMD_FPGA_LOADFS)
193 int fpga_fsload(int devnum
, const void *buf
, size_t size
,
194 fpga_fs_info
*fpga_fsinfo
)
196 int ret_val
= FPGA_FAIL
; /* assume failure */
197 const fpga_desc
*desc
= fpga_validate(devnum
, buf
, size
,
201 switch (desc
->devtype
) {
203 #if defined(CONFIG_FPGA_XILINX)
204 ret_val
= xilinx_loadfs(desc
->devdesc
, buf
, size
,
207 fpga_no_sup((char *)__func__
, "Xilinx devices");
211 printf("%s: Invalid or unsupported device type %d\n",
212 __func__
, desc
->devtype
);
221 * Generic multiplexing code
223 int fpga_load(int devnum
, const void *buf
, size_t bsize
, bitstream_type bstype
)
225 int ret_val
= FPGA_FAIL
; /* assume failure */
226 const fpga_desc
*desc
= fpga_validate(devnum
, buf
, bsize
,
230 switch (desc
->devtype
) {
232 #if defined(CONFIG_FPGA_XILINX)
233 ret_val
= xilinx_load(desc
->devdesc
, buf
, bsize
,
236 fpga_no_sup((char *)__func__
, "Xilinx devices");
240 #if defined(CONFIG_FPGA_ALTERA)
241 ret_val
= altera_load(desc
->devdesc
, buf
, bsize
);
243 fpga_no_sup((char *)__func__
, "Altera devices");
247 #if defined(CONFIG_FPGA_LATTICE)
248 ret_val
= lattice_load(desc
->devdesc
, buf
, bsize
);
250 fpga_no_sup((char *)__func__
, "Lattice devices");
254 printf("%s: Invalid or unsupported device type %d\n",
255 __func__
, desc
->devtype
);
264 * generic multiplexing code
266 int fpga_dump(int devnum
, const void *buf
, size_t bsize
)
268 int ret_val
= FPGA_FAIL
; /* assume failure */
269 const fpga_desc
*desc
= fpga_validate(devnum
, buf
, bsize
,
273 switch (desc
->devtype
) {
275 #if defined(CONFIG_FPGA_XILINX)
276 ret_val
= xilinx_dump(desc
->devdesc
, buf
, bsize
);
278 fpga_no_sup((char *)__func__
, "Xilinx devices");
282 #if defined(CONFIG_FPGA_ALTERA)
283 ret_val
= altera_dump(desc
->devdesc
, buf
, bsize
);
285 fpga_no_sup((char *)__func__
, "Altera devices");
289 #if defined(CONFIG_FPGA_LATTICE)
290 ret_val
= lattice_dump(desc
->devdesc
, buf
, bsize
);
292 fpga_no_sup((char *)__func__
, "Lattice devices");
296 printf("%s: Invalid or unsupported device type %d\n",
297 __func__
, desc
->devtype
);
306 * front end to fpga_dev_info. If devnum is invalid, report on all
309 int fpga_info(int devnum
)
311 if (devnum
== FPGA_INVALID_DEVICE
) {
315 for (dev
= 0; dev
< next_desc
; dev
++)
320 printf("%s: No FPGA devices available.\n", __func__
);
325 return fpga_dev_info(devnum
);