160
ChipScope Pro Software and Cores User Guide
UG029 (v14.3) October 16, 2012
Chapter 5:
ChipScope Engine Tcl Interface
::chipscope::csejtag_tap set_irlength
This subcommand sets the instruction register (IR) length of a single device in the current
JTAG chain. The
IR
length is used to determine the amount of padding required to shift an
instruction into a device register. TAP shift and navigate operations do not work until all
devices have the IR lengths set up correctly. The
::chipscope::csejtag_tap
autodetect_chain
subcommand automatically sets up IR lengths for all devices in the
chain that support the
IDCODE
command.
Note:
The JTAG target must be locked by using the
::chipscope::csejtag_target lock
subcommand before calling this subcommand. Also, the device count must be set prior to calling this
subcommand using the
::chipscope::csejtag_tap set_device_count
.
Syntax
::chipscope::csejtag_tap set_irlength handle deviceIndex irLength
Arguments
Returns
An exception is thrown if the subcommand fails.
Example
Set the IR length of the device at index 0 to 11 bits.
%::chipscope::csejtag_tap set_irlength $handle 0 11
Back to list of all CseJtag Tcl Commands
Table 5-32:
Arguments for Subcommand ::chipscope::csejtag_tap set_irlength
Argument
Type
Description
handle
Required
Handle to the session that is returned by
::chipscope::csejtag_session create
.
deviceIndex
Device index (0 to
n
-1) in the
n
-length JTAG chain.
irLength
Length of the IR (in bits)