Chapter 14: Using Jam STAPL for ISP via an Embedded Processor
14–15
Updating Devices Using Jam
Table 14–5. Parameters (Note 1) (Part 2 of 2)
Parameter
action
Status
Description
Mandatory A pointer to a string (text that directs the Player). Example actions are PROGRAM or
VERIFY. In most cases, this parameter will be set to the string PROGRAM. The Player
is not case-sensitive, so the text can be either uppercase or lowercase. The Player
supports all actions defined in the Jam Standard Test and Programming Language
Specification. See Table 14–6. Note that the string must be null terminated.
init_list
error_line
exit_code
Optional
An array of pointers to strings. This parameter is used when applying Jam version 1.1
files. (2)
—
A pointer to a long integer. If an error is encountered during execution, the Player will
record the line of the JBC file where the error occurred.
—
A pointer to a long integer. Returns a code if there is an error that applies to the
syntax or structure of the JBC file. If this kind of error is encountered, the supporting
vendor should be contacted with a detailed description of the circumstances in which
the exit code was encountered.
Notes to Table 14–5:
(1) Mandatory parameters must be passed for the Player to run.
(2) For more information, refer to AN 122: Using Jam STAPL for ISP & ICR via an Embedded Processor.
MAX II Jam/JBC Actions and Procedure Commands
The Jam/JBC supported action commands for MAX II devices are listed in Table 14–6,
including their definitions. The optional procedures that you can execute with each
action are listed along with their definitions in Table 14–7.
Table 14–6. MAX II Jam/JBC Actions (Part 1 of 2)
Optional Procedures (Off by
Default)
Jam/JBC Action
PROGRAM
Description
Programs the device. You can optionally program CFM and
UFM separately.
DO_BYPASS_CFM
DO_BYPASS_UFM
DO_SECURE
DO_REAL_TIME_ISP
DO_READ_USERCODE
BLANKCHECK
VERIFY
Blank checks the entire device. You can optionally blank check DO_BYPASS_CFM
CFM and UFM separately.
DO_BYPASS_UFM
DO_REAL_TIME_ISP
Verifies the entire device against the programming data in the DO_BYPASS_CFM
Jam file. You can optionally verify CFM and UFM separately.
DO_BYPASS_UFM
DO_REAL_TIME_ISP
DO_READ_USERCODE
© October 2008 Altera Corporation
MAX II Device Handbook