168
ChipScope Pro Software and Cores User Guide
UG029 (v14.3) October 16, 2012
Chapter 5:
ChipScope Engine Tcl Interface
::chipscope::csejtag_tap shift_chain_dr
This subcommand is used to shift a stream of bits into and out of the data register (DR) of
the JTAG chain. No device padding is performed by this subcommand. For device-indexed
DR shifting, see
::chipscope::csejtag_tap shift_device_dr
.
Note:
The JTAG target must be locked by using the
::chipscope::csejtag_target lock
subcommand before calling this subcommand.
Syntax
::chipscope::csejtag_tap shift_chain_dr handle shiftMode exitState
progressCallbackFunc bitCount hextdibuf [-hextdimask hextdimaskval] [-
hextdomask hextdomaskval]
Arguments
Returns
A buffer that is full of the data that is shifted out of the TDO pin of the JTAG TAP.
An exception is thrown if the subcommand fails.
Table 5-38:
Arguments for Subcommand ::chipscope::csejtag_tap shift_chain_dr
Argument
Type
Description
handle
Required
Handle to the session that is returned by
::chipscope::csejtag_session create
.
shiftMode
{CSJTAG_SHIFT_READ | CSJTAG_SHIFT_WRITE |
CSJTAG_SHIFT_READWRITE)
exitState
State to end in after shift is complete (
CSEJTAG_SHIFT_DR
if no state change is desired).
progressCallb
ackFunc
Progress callback function that can be used to monitor
progress of JTAG target operations. The format of the
progress callback function is:
proc progressCallbackFunc (handle totalCount
CurrentCount progressStatus) {...}
The progress callback function must return either
$CSE_STOP or $CSE_CONTINUE
. If no progress callback
function is necessary, a
0
should be passed into this
argument position.
bitCount
Number of bits to shift.
hextdibuf
Data buffer that holds the data bits to be written into
TDI
.
The least-significant bit is shifted into
TDI
first.
-hextdimask
hextdimaskval
Optional
Specifies that a mask word
hextdimaskval
should be
applied to the data buffer bits before the data is shifted into
the TDI pin of the JTAG TAP.
-hextdomask
hextdomaskval
Specifies that a mask word
hextdomaskval
should be
applied to the data buffer bits after the data is shifted out of
the TDO pin of the JTAG TAP.
