ADM-XRC SDK 2.8.1 User Guide (Linux)
© Copyright 2001-2009 Alpha Data
Care should be exercised when using EPTest. Modifying certain locations may render the card inoperative. The utility does not by default allow EEPROM locations used to store the adapter PCI configuration to be changed. |
Model | Supported |
ADM-XRC | ![]() |
ADM-XRC-P | ![]() |
ADM-XRC-II-Lite | ![]() |
ADM-XRC-II | ![]() |
ADM-XPL | ![]() |
ADM-XP | ![]() |
ADP-WRC-II | ![]() |
ADP-DRC-II | ![]() |
ADP-XPI | ![]() |
ADM-XRC-4LX | ![]() |
ADM-XRC-4SX | ![]() |
ADM-XRC-4FX | ![]() |
ADPE-XRC-4FX | ![]() |
ADM-XRC-5LX | ![]() |
ADM-XRC-5T1 | ![]() |
ADM-XRC-5T2 | ![]() |
ADM-XRC-5T2-ADV | ![]() |
ADM-XRC-5TZ | ![]() |
ADM-XRC-5T-DA1 | ![]() |
EPTest is a utility that allows modification of the nonvolatile configuration memory of a reconfigurable computing card. Care should be exercised because this memory generally contains Vital Product Data (as reported by the Info utility). Overwriting the memory with invalid data may render a card inoperable.
Should you wish to modify the Vital Product Data of your card, the format of the configuration memory is available on request from support@alpha-data.com.
eptest [options ...] eptest [options ...] <location> eptest [options ...] <location> <value>
Option | Argument type | Meaning |
-card | base 10 integer | ID of card to open |
-f | n/a | DO prompt for confirmation when writing (default) |
+f | n/a | DON'T prompt for confirmation when writing |
-index | base 10 integer | Index of card to open |
-unlock | n/a | Do not allow PCI configuration to be changed (default) |
+unlock | n/a | Allow PCI configuration to be changed |
The EPTest utility can be run in one of three different ways. The first is when no arguments are given, which causes the configuration memory to be dumped to the console, resulting in output of the form:
Selected card ID is 109(0x6d) [0x00] = 0x00100000 [0x20] = 0xFFFFFFFF [0x01] = 0x00000000 [0x21] = 0xFFFFFFFF [0x02] = 0x00000000 [0x22] = 0xFFFFFFFF [0x03] = 0x00000000 [0x23] = 0xFFFFFFFF [0x04] = 0x0BEBC200 [0x24] = 0xFFFFFFFF [0x05] = 0x017D7840 [0x25] = 0xFFFFFFFF [0x06] = 0x01954FC4 [0x26] = 0xFFFFFFFF [0x07] = 0x00000000 [0x27] = 0xFFFFFFFF [0x08] = 0x00190019 [0x28] = 0xFFFFFFFF [0x09] = 0x00190019 [0x29] = 0xFFFFFFFF [0x0A] = 0x00140014 [0x2A] = 0xFFFFFFFF [0x0B] = 0xFFFFFFFF [0x2B] = 0xFFFFFFFF [0x0C] = 0x0000006D [0x2C] = 0xFFFFFFFF [0x0D] = 0x0000006D [0x2D] = 0xFFFFFFFF [0x0E] = 0x1010008C [0x2E] = 0xFFFFFFFF [0x0F] = 0xFFFFFFFF [0x2F] = 0xFFFFFFFF [0x10] = 0xFFFFFFFF [0x30] = 0xFFFFFFFF [0x11] = 0xFFFFFFFF [0x31] = 0xFFFFFFFF [0x12] = 0xFFFFFFFF [0x32] = 0xFFFFFFFF [0x13] = 0xFFFFFFFF [0x33] = 0xFFFFFFFF [0x14] = 0xFFFFFFFF [0x34] = 0xFFFFFFFF [0x15] = 0xFFFFFFFF [0x35] = 0xFFFFFFFF [0x16] = 0xFFFFFFFF [0x36] = 0xFFFFFFFF [0x17] = 0xFFFFFFFF [0x37] = 0xFFFFFFFF [0x18] = 0xFFFFFFFF [0x38] = 0xFFFFFFFF [0x19] = 0xFFFFFFFF [0x39] = 0xFFFFFFFF [0x1A] = 0xFFFFFFFF [0x3A] = 0xFFFFFFFF [0x1B] = 0xFFFFFFFF [0x3B] = 0xFFFFFFFF [0x1C] = 0xFFFFFFFF [0x3C] = 0xFFFFFFFF [0x1D] = 0xFFFFFFFF [0x3D] = 0xFFFFFFFF [0x1E] = 0xFFFFFFFF [0x3E] = 0xFFFFFFFF [0x1F] = 0xFFFFFFFF [0x3F] = 0xFFFFFFFF
Running EPTest this way is unconditionally safe and does not modify any of the configuration data.
The second way to run EPTest is to read a specific location, by specifying the location to read as the first argument. For example, the command line
eptest 0x4
will display the following assuming the same card is used as above:
Selected card ID is 109(0x6d) [0x4] = 0x0bebc200
This is also unconditionally safe because it does not modify any of the configuration data.
The third way to run EPTest is to write a specific location, specifying the location to write as the first argument and the data as the second argument:
eptest 0xA 0x00150015
The above command modifies the word whose index is 0xA (whose value is 0x00140014 according to the above example) to have the new value 0x00150015. This form of the command-line is NOT unconditionally safe and should be used only when the expected result is known and understood, as it is possible to modify the configuration in such a way that recovery is not possible using EPTest. The output from this form of the command is:
Selected card ID is 109(0x6d) Warning: this will write the value 1376277/0x150015 to EEPROM location 0xa Are you sure you want to continue (y/n)? y
The application will ask you to confirm that you really want to modify the configuration memory, and entering "y" will cause EPTest to proceed and update the configuration memory.