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


EPTest utility

WARNING

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 support

ModelSupported
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

Overview

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.

Syntax
eptest [options ...]
eptest [options ...] <location>
eptest [options ...] <location> <value>
Options

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

Description

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.

 


 Top of page