14–16
Chapter 14: Using Jam STAPL for ISP via an Embedded Processor
Updating Devices Using Jam
Table 14–6. MAX II Jam/JBC Actions (Part 2 of 2)
Optional Procedures (Off by
Default)
Jam/JBC Action
Description
ERASE
Erases the programming content of the device. You can
optionally erase CFM and UFM separately.
DO_BYPASS_CFM
DO_BYPASS_UFM
DO_REAL_TIME_ISP
—
READ_USERCODE
Returns the JTAG USERCODE register information from the
device. READ_USERCODE can be set to a specific value in the
programming file in the Quartus II software by using the
Assignments menu -> Device -> Device and Pin options ->
General tab, which has a USERCODE data entry.
Table 14–7. MAX II Jam/JBC Optional Procedure Definitions
Procedure
Description
DO_BYPASS_CFM
DO_BYPASS_UFM
DO_BLANKCHECK
DO_SECURE
When set =1, DO_BYPASS_CFM bypasses the CFM and performs the specified action on the
UFM only. When set =0, this option is ignored (default).
When set =1, DO_BYPASS_UFM bypasses the UFM and performs the specified action on
the CFM only. When set =0, this option is ignored (default).
When set =1, the device, CFM, or UFM is blank checked. When set =0, this option is ignored
(default).
When set =1, the device’s security bit is set. The security bit only affects the CFM data. The
UFM cannot be protected. When set =0, this option is ignored (default).
DO_REAL_TIME_ISP
DO_READ_USERCODE
When set =1, the real-time ISP feature is enabled for the ISP action being executed. When
set =0, the device uses normal ISP mode for any operations.
When set =1, the player returns the JTAG USERCODE register information from the device.
Executing the Jam file from a command prompt requires that an action is specified
using the -a option, as shown in the following example:
jam -aPROGRAM <filename>
This command programs the entire MAX II device with the Jam file specified in the
filename.
You can execute the optional procedures with its associated actions by using the -d
option, as shown in the following example:
jam -aPROGRAM -dDO_BYPASS_UFM=1
-dDO_REAL_TIME_ISP=1<filename>
This command programs the MAX II CFM block only with real-time ISP enabled (i.e.,
the device remains in user mode during the entire process).
The JBC player uses the same format except for the executable name.
The Player returns a status code of type JBI_RETURN_TYPEor integer. This value
indicates whether the action was successful (returns “0”). jbi_execute()can return
any one of the following exit codes in Table 14–8, as defined in the Jam Standard Test
and Programming Language Specification.
MAX II Device Handbook
© October 2008 Altera Corporation