u-boot/drivers/fpga/fpga.c

328 lines
7.2 KiB
C
Raw Normal View History

2002-11-02 23:30:20 +00:00
/*
* (C) Copyright 2002
* Rich Ireland, Enterasys Networks, rireland@enterasys.com.
*
* SPDX-License-Identifier: GPL-2.0+
2002-11-02 23:30:20 +00:00
*/
/* Generic FPGA support */
2002-11-02 23:30:20 +00:00
#include <common.h> /* core U-Boot definitions */
#include <xilinx.h> /* xilinx specific definitions */
#include <altera.h> /* altera specific definitions */
#include <lattice.h>
2002-11-02 23:30:20 +00:00
/* 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
2002-11-02 23:30:20 +00:00
* 'no support' message function
*/
static void fpga_no_sup(char *fn, char *msg)
2002-11-02 23:30:20 +00:00
{
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");
2002-11-02 23:30:20 +00:00
}
/* fpga_get_desc
* map a device number to a descriptor
*/
const fpga_desc *const fpga_get_desc(int devnum)
2002-11-02 23:30:20 +00:00
{
fpga_desc *desc = (fpga_desc *)NULL;
2002-11-02 23:30:20 +00:00
if ((devnum >= 0) && (devnum < next_desc)) {
2002-11-02 23:30:20 +00:00
desc = &desc_table[devnum];
debug("%s: found fpga descriptor #%d @ 0x%p\n",
__func__, devnum, desc);
2002-11-02 23:30:20 +00:00
}
return desc;
}
/*
* fpga_validate
2002-11-02 23:30:20 +00:00
* generic parameter checking code
*/
const fpga_desc *const fpga_validate(int devnum, const void *buf,
size_t bsize, char *fn)
2002-11-02 23:30:20 +00:00
{
const fpga_desc *desc = fpga_get_desc(devnum);
2002-11-02 23:30:20 +00:00
if (!desc)
printf("%s: Invalid device number %d\n", fn, devnum);
2002-11-02 23:30:20 +00:00
if (!buf) {
printf("%s: Null buffer.\n", fn);
2002-11-02 23:30:20 +00:00
return (fpga_desc * const)NULL;
}
return desc;
}
/*
* fpga_dev_info
2002-11-02 23:30:20 +00:00
* generic multiplexing code
*/
static int fpga_dev_info(int devnum)
2002-11-02 23:30:20 +00:00
{
int ret_val = FPGA_FAIL; /* assume failure */
const fpga_desc * const desc = fpga_get_desc(devnum);
2002-11-02 23:30:20 +00:00
if (desc) {
debug("%s: Device Descriptor @ 0x%p\n",
__func__, desc->devdesc);
2002-11-02 23:30:20 +00:00
switch (desc->devtype) {
2002-11-02 23:30:20 +00:00
case fpga_xilinx:
#if defined(CONFIG_FPGA_XILINX)
printf("Xilinx Device\nDescriptor @ 0x%p\n", desc);
ret_val = xilinx_info(desc->devdesc);
2002-11-02 23:30:20 +00:00
#else
fpga_no_sup((char *)__func__, "Xilinx devices");
2002-11-02 23:30:20 +00:00
#endif
break;
case fpga_altera:
#if defined(CONFIG_FPGA_ALTERA)
printf("Altera Device\nDescriptor @ 0x%p\n", desc);
ret_val = altera_info(desc->devdesc);
2002-11-02 23:30:20 +00:00
#else
fpga_no_sup((char *)__func__, "Altera devices");
2002-11-02 23:30:20 +00:00
#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;
2002-11-02 23:30:20 +00:00
default:
printf("%s: Invalid or unsupported device type %d\n",
__func__, desc->devtype);
2002-11-02 23:30:20 +00:00
}
} else {
printf("%s: Invalid device number %d\n", __func__, devnum);
2002-11-02 23:30:20 +00:00
}
return ret_val;
}
/*
* fpga_init is usually called from misc_init_r() and MUST be called
2002-11-02 23:30:20 +00:00
* before any of the other fpga functions are used.
*/
void fpga_init(void)
2002-11-02 23:30:20 +00:00
{
next_desc = 0;
memset(desc_table, 0, sizeof(desc_table));
2002-11-02 23:30:20 +00:00
debug("%s\n", __func__);
2002-11-02 23:30:20 +00:00
}
/*
* fpga_count
2002-11-02 23:30:20 +00:00
* Basic interface function to get the current number of devices available.
*/
int fpga_count(void)
2002-11-02 23:30:20 +00:00
{
return next_desc;
}
/*
* fpga_add
* Add the device descriptor to the device table.
2002-11-02 23:30:20 +00:00
*/
int fpga_add(fpga_type devtype, void *desc)
2002-11-02 23:30:20 +00:00
{
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;
2002-11-02 23:30:20 +00:00
} else {
printf("%s: Exceeded Max FPGA device count\n",
__func__);
2002-11-02 23:30:20 +00:00
}
} else {
printf("%s: Unsupported FPGA type %d\n", __func__, devtype);
2002-11-02 23:30:20 +00:00
}
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
2002-11-02 23:30:20 +00:00
/*
* Generic multiplexing code
2002-11-02 23:30:20 +00:00
*/
int fpga_load(int devnum, const void *buf, size_t bsize, bitstream_type bstype)
2002-11-02 23:30:20 +00:00
{
int ret_val = FPGA_FAIL; /* assume failure */
const fpga_desc *desc = fpga_validate(devnum, buf, bsize,
(char *)__func__);
2002-11-02 23:30:20 +00:00
if (desc) {
switch (desc->devtype) {
2002-11-02 23:30:20 +00:00
case fpga_xilinx:
#if defined(CONFIG_FPGA_XILINX)
ret_val = xilinx_load(desc->devdesc, buf, bsize,
bstype);
2002-11-02 23:30:20 +00:00
#else
fpga_no_sup((char *)__func__, "Xilinx devices");
2002-11-02 23:30:20 +00:00
#endif
break;
case fpga_altera:
#if defined(CONFIG_FPGA_ALTERA)
ret_val = altera_load(desc->devdesc, buf, bsize);
2002-11-02 23:30:20 +00:00
#else
fpga_no_sup((char *)__func__, "Altera devices");
2002-11-02 23:30:20 +00:00
#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;
2002-11-02 23:30:20 +00:00
default:
printf("%s: Invalid or unsupported device type %d\n",
__func__, desc->devtype);
2002-11-02 23:30:20 +00:00
}
}
return ret_val;
}
/*
* fpga_dump
2002-11-02 23:30:20 +00:00
* generic multiplexing code
*/
int fpga_dump(int devnum, const void *buf, size_t bsize)
2002-11-02 23:30:20 +00:00
{
int ret_val = FPGA_FAIL; /* assume failure */
const fpga_desc *desc = fpga_validate(devnum, buf, bsize,
(char *)__func__);
2002-11-02 23:30:20 +00:00
if (desc) {
switch (desc->devtype) {
2002-11-02 23:30:20 +00:00
case fpga_xilinx:
#if defined(CONFIG_FPGA_XILINX)
ret_val = xilinx_dump(desc->devdesc, buf, bsize);
2002-11-02 23:30:20 +00:00
#else
fpga_no_sup((char *)__func__, "Xilinx devices");
2002-11-02 23:30:20 +00:00
#endif
break;
case fpga_altera:
#if defined(CONFIG_FPGA_ALTERA)
ret_val = altera_dump(desc->devdesc, buf, bsize);
2002-11-02 23:30:20 +00:00
#else
fpga_no_sup((char *)__func__, "Altera devices");
2002-11-02 23:30:20 +00:00
#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;
2002-11-02 23:30:20 +00:00
default:
printf("%s: Invalid or unsupported device type %d\n",
__func__, desc->devtype);
2002-11-02 23:30:20 +00:00
}
}
return ret_val;
}
/*
* fpga_info
2002-11-02 23:30:20 +00:00
* front end to fpga_dev_info. If devnum is invalid, report on all
* available devices.
*/
int fpga_info(int devnum)
2002-11-02 23:30:20 +00:00
{
if (devnum == FPGA_INVALID_DEVICE) {
if (next_desc > 0) {
2002-11-02 23:30:20 +00:00
int dev;
for (dev = 0; dev < next_desc; dev++)
fpga_dev_info(dev);
2002-11-02 23:30:20 +00:00
return FPGA_SUCCESS;
} else {
printf("%s: No FPGA devices available.\n", __func__);
2002-11-02 23:30:20 +00:00
return FPGA_FAIL;
}
}
return fpga_dev_info(devnum);
}