Visible to Intel only — GUID: reference_TCL_tcl_pkg_jtag_ver_1_0_cmd_device_virtual_dr_shift
Ixiasoft
Visible to Intel only — GUID: reference_TCL_tcl_pkg_jtag_ver_1_0_cmd_device_virtual_dr_shift
Ixiasoft
3.1.18.7. device_virtual_dr_shift (::quartus::jtag)
The following table displays information for the device_virtual_dr_shift Tcl command:
Tcl Package and Version | Belongs to ::quartus::jtag |
||
Syntax | device_virtual_dr_shift [-h | -help] [-long_help] [-dr_value <data register value> ] -instance_index <instance index> -length <data register length> [-no_captured_dr_value] [-show_equivalent_device_ir_dr_shift] [-value_in_hex] | ||
Arguments | -h | -help | Short help | |
-long_help | Long help with examples and possible return values | ||
-dr_value <data register value> | Value of string operand type in either default binary or hexadecimal format to be written into the data register in this instance | ||
-instance_index <instance index> | The index of the virtual JTAG instance | ||
-length <data register length> | Length of the data register in this instance | ||
-no_captured_dr_value | Option to not return the data instruction register value | ||
-show_equivalent_device_ir_dr_shift | Option to show equivalent device ir dr shifts performed by this command | ||
-value_in_hex | Option to specify that the value string is represented in hexadecimal format | ||
Description | Writes the specified value into the data register of the JTAG tap controller of the open device. Returns the captured data register value. The captured value return can be disabled to improve the JTAG communication speed by packing multiple IR or DR scans together. The value is specified using either a binary string or a hexadecimal string. The bit on the left most side is the first bit shifted in. For example, using the binary string "010001", the first bit shifted into the dr register is 1; the last bit is 0. The same string can be represented in hexadecimal as "11". The device must be locked first, and the target instance must be activated using the device_virtual_ir_shift command before this operation. Moreover, the device should be locked before the virtual IR shift operation to prevent another application from activating another instance. |
||
Example Usage | |
||
Return Value | Code Name | Code | String Return |
TCL_OK | 0 | INFO: Operation successful | |
TCL_ERROR | 1 | ERROR: Captured value cannot be disabled at the time when no value is shifted into data register. | |
TCL_ERROR | 1 | ERROR: The specified virtual JTAG instance cannot be found. | |
TCL_ERROR | 1 | ERROR: One of the options, mfg_id, type_id and version is specified, but not all. All of them are required. | |
TCL_ERROR | 1 | ERROR: A device has not been locked; exclusive communication must be obtained first. | |
TCL_ERROR | 1 | ERROR: A device has been locked by another application; exclusive communication cannot be granted within the specified timeout period. | |
TCL_ERROR | 1 | ERROR: The length of the value string specified does not match the length parameter specified. |