Achronix Bitporter - Manual (Page 46)

Troubleshooting Exit Codes Using the Achronix STAPL Player
PAGE 40 www.achronix.com Bitporter User Guide
Troubleshooting Exit Codes
There are a variety of things that can go wrong when using the Bitporter, each of which will
report an error code and message. For connection and driver‐level errors, see
“Bitporter
Connection Errors,” on page 20. The rest of the errors will be briefly discussed in this section.
There are two kinds of errors that may happen when playing STAPL files with the
acx_stapl_player: errors reported by the STAPL code, and errors from the player executing the
STAPL code. All error codes from the STAPL code will be positive, while player errors will be
negative. Positive error codes will typically indicate problems interacting with the target
device, while negative error codes will often indicate problems reading the STAPL file.
STAPL Exit Codes
The most frequently seen exit codes when playing a STAPL file are STAPL error codes. These
will all be positive numbers, and typically represent problems with the target device, or
problems encountered by the Bitporter when attempting communication with the target
device. The official STAPL error codes are in the table below, reproduced from EIA/JEDEC
Standard 71 (JESD71), Standard Test and Programming Language (STAPL).
Further information is provided below for those STAPL Exit Codes whose underlying
problem is easily solved, despite descriptions that may not be self‐explanatory.
Exit code = 6... Unrecognized device
Most of the Actions in ACE‐generated STAPL (*.jam) files perform a quick sanity check before
beginning the often slow core work of the Action. Part of the sanity check is to ensure the
device/chip specified in the STAPL file can be found in the connected JTAG scan chain at the
expected location. If the device is not found, this error code is displayed, along with the
expected JTAG IDCODE and whatever IDCODE was found instead.
Table 4-10: STAPL Exit Codes
Exit Code Description
0 Success
1 Checking chain failure
2 Reading IDCODE failure
3 Reading USERCODE failure
4 Reading UESCODE failure
5 Entering ISP failure
6 Unrecognized device ID
7 Device version is not supported
8 Erase failure
9 Blank check failure
10 Programming failure
11 Verify failure
12 Read failure
13 Calculating checksum failure
14 Setting security bit failure
15 Querying security bit failure
16 Exiting ISP failure
17 Performing system test failure