mirror of
https://github.com/brain-hackers/u-boot-brain
synced 2024-08-19 00:18:51 +09:00
![Tom Rini](/assets/img/avatar_default.png)
When U-Boot started using SPDX tags we were among the early adopters and there weren't a lot of other examples to borrow from. So we picked the area of the file that usually had a full license text and replaced it with an appropriate SPDX-License-Identifier: entry. Since then, the Linux Kernel has adopted SPDX tags and they place it as the very first line in a file (except where shebangs are used, then it's second line) and with slightly different comment styles than us. In part due to community overlap, in part due to better tag visibility and in part for other minor reasons, switch over to that style. This commit changes all instances where we have a single declared license in the tag as both the before and after are identical in tag contents. There's also a few places where I found we did not have a tag and have introduced one. Signed-off-by: Tom Rini <trini@konsulko.com>
327 lines
7.2 KiB
C
327 lines
7.2 KiB
C
// SPDX-License-Identifier: GPL-2.0+
|
|
/*
|
|
* (C) Copyright 2002
|
|
* Rich Ireland, Enterasys Networks, rireland@enterasys.com.
|
|
*/
|
|
|
|
/* Generic FPGA support */
|
|
#include <common.h> /* core U-Boot definitions */
|
|
#include <xilinx.h> /* xilinx specific definitions */
|
|
#include <altera.h> /* altera specific definitions */
|
|
#include <lattice.h>
|
|
|
|
/* Local definitions */
|
|
#ifndef CONFIG_MAX_FPGA_DEVICES
|
|
#define CONFIG_MAX_FPGA_DEVICES 5
|
|
#endif
|
|
|
|
/* Local static data */
|
|
static int next_desc = FPGA_INVALID_DEVICE;
|
|
static fpga_desc desc_table[CONFIG_MAX_FPGA_DEVICES];
|
|
|
|
/*
|
|
* fpga_no_sup
|
|
* 'no support' message function
|
|
*/
|
|
static void fpga_no_sup(char *fn, char *msg)
|
|
{
|
|
if (fn && msg)
|
|
printf("%s: No support for %s.\n", fn, msg);
|
|
else if (msg)
|
|
printf("No support for %s.\n", msg);
|
|
else
|
|
printf("No FPGA support!\n");
|
|
}
|
|
|
|
|
|
/* fpga_get_desc
|
|
* map a device number to a descriptor
|
|
*/
|
|
const fpga_desc *const fpga_get_desc(int devnum)
|
|
{
|
|
fpga_desc *desc = (fpga_desc *)NULL;
|
|
|
|
if ((devnum >= 0) && (devnum < next_desc)) {
|
|
desc = &desc_table[devnum];
|
|
debug("%s: found fpga descriptor #%d @ 0x%p\n",
|
|
__func__, devnum, desc);
|
|
}
|
|
|
|
return desc;
|
|
}
|
|
|
|
/*
|
|
* fpga_validate
|
|
* generic parameter checking code
|
|
*/
|
|
const fpga_desc *const fpga_validate(int devnum, const void *buf,
|
|
size_t bsize, char *fn)
|
|
{
|
|
const fpga_desc *desc = fpga_get_desc(devnum);
|
|
|
|
if (!desc)
|
|
printf("%s: Invalid device number %d\n", fn, devnum);
|
|
|
|
if (!buf) {
|
|
printf("%s: Null buffer.\n", fn);
|
|
return (fpga_desc * const)NULL;
|
|
}
|
|
return desc;
|
|
}
|
|
|
|
/*
|
|
* fpga_dev_info
|
|
* generic multiplexing code
|
|
*/
|
|
static int fpga_dev_info(int devnum)
|
|
{
|
|
int ret_val = FPGA_FAIL; /* assume failure */
|
|
const fpga_desc * const desc = fpga_get_desc(devnum);
|
|
|
|
if (desc) {
|
|
debug("%s: Device Descriptor @ 0x%p\n",
|
|
__func__, desc->devdesc);
|
|
|
|
switch (desc->devtype) {
|
|
case fpga_xilinx:
|
|
#if defined(CONFIG_FPGA_XILINX)
|
|
printf("Xilinx Device\nDescriptor @ 0x%p\n", desc);
|
|
ret_val = xilinx_info(desc->devdesc);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Xilinx devices");
|
|
#endif
|
|
break;
|
|
case fpga_altera:
|
|
#if defined(CONFIG_FPGA_ALTERA)
|
|
printf("Altera Device\nDescriptor @ 0x%p\n", desc);
|
|
ret_val = altera_info(desc->devdesc);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Altera devices");
|
|
#endif
|
|
break;
|
|
case fpga_lattice:
|
|
#if defined(CONFIG_FPGA_LATTICE)
|
|
printf("Lattice Device\nDescriptor @ 0x%p\n", desc);
|
|
ret_val = lattice_info(desc->devdesc);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Lattice devices");
|
|
#endif
|
|
break;
|
|
default:
|
|
printf("%s: Invalid or unsupported device type %d\n",
|
|
__func__, desc->devtype);
|
|
}
|
|
} else {
|
|
printf("%s: Invalid device number %d\n", __func__, devnum);
|
|
}
|
|
|
|
return ret_val;
|
|
}
|
|
|
|
/*
|
|
* fpga_init is usually called from misc_init_r() and MUST be called
|
|
* before any of the other fpga functions are used.
|
|
*/
|
|
void fpga_init(void)
|
|
{
|
|
next_desc = 0;
|
|
memset(desc_table, 0, sizeof(desc_table));
|
|
|
|
debug("%s\n", __func__);
|
|
}
|
|
|
|
/*
|
|
* fpga_count
|
|
* Basic interface function to get the current number of devices available.
|
|
*/
|
|
int fpga_count(void)
|
|
{
|
|
return next_desc;
|
|
}
|
|
|
|
/*
|
|
* fpga_add
|
|
* Add the device descriptor to the device table.
|
|
*/
|
|
int fpga_add(fpga_type devtype, void *desc)
|
|
{
|
|
int devnum = FPGA_INVALID_DEVICE;
|
|
|
|
if (!desc) {
|
|
printf("%s: NULL device descriptor\n", __func__);
|
|
return devnum;
|
|
}
|
|
|
|
if (next_desc < 0) {
|
|
printf("%s: FPGA support not initialized!\n", __func__);
|
|
} else if ((devtype > fpga_min_type) && (devtype < fpga_undefined)) {
|
|
if (next_desc < CONFIG_MAX_FPGA_DEVICES) {
|
|
devnum = next_desc;
|
|
desc_table[next_desc].devtype = devtype;
|
|
desc_table[next_desc++].devdesc = desc;
|
|
} else {
|
|
printf("%s: Exceeded Max FPGA device count\n",
|
|
__func__);
|
|
}
|
|
} else {
|
|
printf("%s: Unsupported FPGA type %d\n", __func__, devtype);
|
|
}
|
|
|
|
return devnum;
|
|
}
|
|
|
|
/*
|
|
* Return 1 if the fpga data is partial.
|
|
* This is only required for fpga drivers that support bitstream_type.
|
|
*/
|
|
int __weak fpga_is_partial_data(int devnum, size_t img_len)
|
|
{
|
|
return 0;
|
|
}
|
|
|
|
/*
|
|
* Convert bitstream data and load into the fpga
|
|
*/
|
|
int __weak fpga_loadbitstream(int devnum, char *fpgadata, size_t size,
|
|
bitstream_type bstype)
|
|
{
|
|
printf("Bitstream support not implemented for this FPGA device\n");
|
|
return FPGA_FAIL;
|
|
}
|
|
|
|
#if defined(CONFIG_CMD_FPGA_LOADFS)
|
|
int fpga_fsload(int devnum, const void *buf, size_t size,
|
|
fpga_fs_info *fpga_fsinfo)
|
|
{
|
|
int ret_val = FPGA_FAIL; /* assume failure */
|
|
const fpga_desc *desc = fpga_validate(devnum, buf, size,
|
|
(char *)__func__);
|
|
|
|
if (desc) {
|
|
switch (desc->devtype) {
|
|
case fpga_xilinx:
|
|
#if defined(CONFIG_FPGA_XILINX)
|
|
ret_val = xilinx_loadfs(desc->devdesc, buf, size,
|
|
fpga_fsinfo);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Xilinx devices");
|
|
#endif
|
|
break;
|
|
default:
|
|
printf("%s: Invalid or unsupported device type %d\n",
|
|
__func__, desc->devtype);
|
|
}
|
|
}
|
|
|
|
return ret_val;
|
|
}
|
|
#endif
|
|
|
|
/*
|
|
* Generic multiplexing code
|
|
*/
|
|
int fpga_load(int devnum, const void *buf, size_t bsize, bitstream_type bstype)
|
|
{
|
|
int ret_val = FPGA_FAIL; /* assume failure */
|
|
const fpga_desc *desc = fpga_validate(devnum, buf, bsize,
|
|
(char *)__func__);
|
|
|
|
if (desc) {
|
|
switch (desc->devtype) {
|
|
case fpga_xilinx:
|
|
#if defined(CONFIG_FPGA_XILINX)
|
|
ret_val = xilinx_load(desc->devdesc, buf, bsize,
|
|
bstype);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Xilinx devices");
|
|
#endif
|
|
break;
|
|
case fpga_altera:
|
|
#if defined(CONFIG_FPGA_ALTERA)
|
|
ret_val = altera_load(desc->devdesc, buf, bsize);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Altera devices");
|
|
#endif
|
|
break;
|
|
case fpga_lattice:
|
|
#if defined(CONFIG_FPGA_LATTICE)
|
|
ret_val = lattice_load(desc->devdesc, buf, bsize);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Lattice devices");
|
|
#endif
|
|
break;
|
|
default:
|
|
printf("%s: Invalid or unsupported device type %d\n",
|
|
__func__, desc->devtype);
|
|
}
|
|
}
|
|
|
|
return ret_val;
|
|
}
|
|
|
|
/*
|
|
* fpga_dump
|
|
* generic multiplexing code
|
|
*/
|
|
int fpga_dump(int devnum, const void *buf, size_t bsize)
|
|
{
|
|
int ret_val = FPGA_FAIL; /* assume failure */
|
|
const fpga_desc *desc = fpga_validate(devnum, buf, bsize,
|
|
(char *)__func__);
|
|
|
|
if (desc) {
|
|
switch (desc->devtype) {
|
|
case fpga_xilinx:
|
|
#if defined(CONFIG_FPGA_XILINX)
|
|
ret_val = xilinx_dump(desc->devdesc, buf, bsize);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Xilinx devices");
|
|
#endif
|
|
break;
|
|
case fpga_altera:
|
|
#if defined(CONFIG_FPGA_ALTERA)
|
|
ret_val = altera_dump(desc->devdesc, buf, bsize);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Altera devices");
|
|
#endif
|
|
break;
|
|
case fpga_lattice:
|
|
#if defined(CONFIG_FPGA_LATTICE)
|
|
ret_val = lattice_dump(desc->devdesc, buf, bsize);
|
|
#else
|
|
fpga_no_sup((char *)__func__, "Lattice devices");
|
|
#endif
|
|
break;
|
|
default:
|
|
printf("%s: Invalid or unsupported device type %d\n",
|
|
__func__, desc->devtype);
|
|
}
|
|
}
|
|
|
|
return ret_val;
|
|
}
|
|
|
|
/*
|
|
* fpga_info
|
|
* front end to fpga_dev_info. If devnum is invalid, report on all
|
|
* available devices.
|
|
*/
|
|
int fpga_info(int devnum)
|
|
{
|
|
if (devnum == FPGA_INVALID_DEVICE) {
|
|
if (next_desc > 0) {
|
|
int dev;
|
|
|
|
for (dev = 0; dev < next_desc; dev++)
|
|
fpga_dev_info(dev);
|
|
|
|
return FPGA_SUCCESS;
|
|
} else {
|
|
printf("%s: No FPGA devices available.\n", __func__);
|
|
return FPGA_FAIL;
|
|
}
|
|
}
|
|
|
|
return fpga_dev_info(devnum);
|
|
}
|