ADM-XRC SDK 2.8.1 User Guide (Linux)
© Copyright 2001-2009 Alpha Data
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 |