ADM-XRC SDK 2.8.1 User Guide (Linux)
© Copyright 2001-2009 Alpha Data


ADMXRC2_CARD_INFO

Declaration

typedef struct _ADMXRC2_CARD_INFO
{
    ADMXRC2_CARDID      CardID;
    uint32_t            SerialNum;
    ADMXRC2_BOARD_TYPE  BoardType;
    ADMXRC2_FPGA_TYPE   FPGAType;
    unsigned long       NumClock;
    unsigned long       NumDMAChan;
    unsigned long       NumRAMBank;
    unsigned long       NumSpace;
    uint32_t            RAMBanksFitted;
    uint8_t             BoardRevision;
    uint8_t             LogicRevision;
} ADMXRC2_CARD_INFO;

Description

The ADMXRC2_CARD_INFO structure is returned by ADMXRC2_GetCardInfo and contains information about a card. Some applications may require this information in order, for example, to load the correct bitstream for the FPGA fitted to the card.

The CardID member, of type ADMXRC2_CARDID, is the ID of the card. This value returned is read from an EEPROM on the card.

The SerialNum member is the serial number of the card.

The BoardType member identifies the model (ADM-XRC, ADM-XRC-P, ADM-XRC-II-Lite etc.) and is of the enumerated type ADMXRC2_BOARD_TYPE. BoardType also implicitly defines the package of the FPGA fitted to the card:

Model FPGA package
ADM-XRC BG560
ADM-XRC-P BG560
ADM-XRC-II-Lite FG456
ADM-XRC-II FF1152
ADM-XPL FF896
ADP-WRC-II FF1517
ADP-DRC-II FF1152
ADP-XPI FF1704
ADM-XRC-4LX FF1148
ADM-XRC-4SX FF1148
ADM-XRC-4FX FF1517
ADPE-XRC-4FX FF1517
ADM-XRC-5LX FF1153
ADM-XRC-5T1 FF1136
ADM-XRC-5T2 FF1738
ADM-XRC-5T2-ADV FF1738
ADM-XRC-5T-DA1 FF1136

The FPGAType member, of the enumerated type ADMXRC2_FPGA_TYPE identifies the type of FPGA fitted to the card. To be precise, it identifies the FPGA family and size, but not the package.

The NumClock member is the number of programmable clock generators available on the card.

The NumDMAChan member is the number of DMA channels provided by the card.

The NumRAMBank member is the number of RAM banks on the card, whether fitted or not. This value is obtained by reading the EEPROM on the card. This value can be also be implied from the model:

The NumSpace member is the regions of local bus space that the card provides.

The RAMBanksFitted is a bitmap indicating which RAM banks are fitted on the card. A 1 bit indicates "fitted" and a 0 bit indicates "not fitted". RAMBanksFitted[n] corresponds to bank n. This value is obtained by reading the EEPROM on the card.

The BoardRevision member is the revision of the board, as a two digit number 0xAB where A is the major revision and B is the minor revision.

The LogicRevision member is the revision of the control logic on the board, as a two digit number 0xAB where A is the major revision and B is the minor revision.

Although the number of clock generators, the number of RAM banks, and the number of spaces provided by a card can be obtained from the NumClock and NumRAMBank, they can also be implied from the model:

Model NumClock NumRAMBank NumSpace
ADM-XRC 2 4 2
ADM-XRC-P 2 4 2
ADM-XRC-II-Lite 2 4 2
ADM-XRC-II 2 6 2
ADM-XPL 1 2 2
ADP-WRC-II 2 2 2
ADP-DRC-II 2 5 2
ADP-XPI 1 5 2
ADM-XRC-4LX 2 6 2
ADM-XRC-4SX 2 4 2
ADM-XRC-4FX 2 4 2
ADPE-XRC-4FX 2 4 2
ADM-XRC-5LX 2 4 2
ADM-XRC-5T1 2 3 2
ADM-XRC-5T2 2 6 2
ADM-XRC-5T2-ADV 2 6 2
ADM-XRC-5T-DA1 2 4 2

 


 Top of page