Visible to Intel only — GUID: reference_TCL_tcl_pkg_jtag_ver_1_0_cmd_device_lock
Ixiasoft
Visible to Intel only — GUID: reference_TCL_tcl_pkg_jtag_ver_1_0_cmd_device_lock
Ixiasoft
3.1.18.4. device_lock (::quartus::jtag)
The following table displays information for the device_lock Tcl command:
Tcl Package and Version | Belongs to ::quartus::jtag |
||
Syntax | device_lock [-h | -help] [-long_help] -timeout <timeout> | ||
Arguments | -h | -help | Short help | |
-long_help | Long help with examples and possible return values | ||
-timeout <timeout> | The amount of time in millisecond to wait for the access to the device. | ||
Description | Obtain an exclusive JTAG communication to the device for the subsequent IR and DR shift operations. The device must be locked before any instruction and/or data register shift operation. This should be used as little time as possible as it denies the access of other applications to this chain. The command, unlock, should be called as soon as possible to allow other applications to access the device. |
||
Example Usage | |
||
Return Value | Code Name | Code | String Return |
TCL_OK | 0 | INFO: Operation successful | |
TCL_ERROR | 1 | ERROR: No device has been opened. | |
TCL_ERROR | 1 | ERROR: JTAG communication error is detected. It can be caused by the hardware failure and signal integrity in the JTAG chain. Try to restart. | |
TCL_ERROR | 1 | ERROR: A device was locked. | |
TCL_ERROR | 1 | ERROR: A device has been locked by another application; exclusive communication cannot be granted within the specified timeout period. |