System Console and Toolkit Tcl Command Reference Manual

Download PDF
ID 683101
Date 12/04/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents
Document Table of Contents x
1. System Console Tcl Command Reference 2. Toolkit Tcl Command References
1. System Console Tcl Command Reference x
1.1. Command Summary 1.2. Properties
1.1. Command Summary x
1.1.1. add_help 1.1.2. add_service 1.1.3. autosweep_add_input_parameter 1.1.4. autosweep_add_output_metric 1.1.5. autosweep_apply_bestcase 1.1.6. autosweep_apply_case 1.1.7. autosweep_create_instance 1.1.8. autosweep_destroy_instance 1.1.9. autosweep_get_best_case 1.1.10. autosweep_get_case_count 1.1.11. autosweep_get_case_description 1.1.12. autosweep_get_case_result 1.1.13. autosweep_get_data 1.1.14. autosweep_get_input_parameter_range 1.1.15. autosweep_get_input_parameters 1.1.16. autosweep_get_instances 1.1.17. autosweep_get_output_metrics 1.1.18. autosweep_get_progress 1.1.19. autosweep_remove_input_paramater 1.1.20. autosweep_remove_output_metric 1.1.21. autosweep_set_input_parameter_range 1.1.22. autosweep_start 1.1.23. autosweep_stop 1.1.24. bytestream_receive 1.1.25. bytestream_send 1.1.26. claim_service Description Usage ReturnType Returns Arguments Example 1.1.27. close_service 1.1.28. debug_get_commands 1.1.29. debug_get_legacy_service_types 1.1.30. debug_print_filesystem 1.1.31. design_extract_debug_files 1.1.32. design_extract_dotty 1.1.33. design_get_warnings 1.1.34. design_instantiate 1.1.35. design_link 1.1.36. design_load 1.1.37. design_update_debug_files 1.1.38. device_download_sof 1.1.39. device_get_board 1.1.40. device_get_connections 1.1.41. device_get_design 1.1.42. etile_eye_background_scan_done 1.1.43. etile_eye_cancel_background_scan 1.1.44. etile_eye_get_attribute 1.1.45. etile_eye_get_data 1.1.46. etile_eye_scan_and_load 1.1.47. etile_eye_unload 1.1.48. etile_get_actions 1.1.49. etile_get_parameter 1.1.50. etile_get_parameters 1.1.51. etile_read_register 1.1.52. etile_run_action 1.1.53. etile_set_parameter 1.1.54. etile_write_register 1.1.55. executor_cancel 1.1.56. executor_clean_directory 1.1.57. executor_get_directory 1.1.58. executor_get_environment 1.1.59. executor_get_exit_value 1.1.60. executor_get_stderr 1.1.61. executor_get_stdout 1.1.62. executor_is_cancelled 1.1.63. executor_is_done 1.1.64. executor_run 1.1.65. executor_set_environment 1.1.66. executor_unset_environment 1.1.67. executor_wait_for 1.1.68. eye_create_instance 1.1.69. eye_destroy_instance 1.1.70. eye_get_channel 1.1.71. eye_get_data 1.1.72. eye_get_instances 1.1.73. eye_get_progress 1.1.74. eye_get_toolkit_instance 1.1.75. eye_start 1.1.76. eye_stop 1.1.77. get_claimed_services 1.1.78. get_service_paths 1.1.79. get_service_types 1.1.80. get_services_to_add 1.1.81. get_version 1.1.82. help 1.1.83. io_bus_access 1.1.84. io_bus_get_protocol 1.1.85. is_plugin_enabled 1.1.86. is_service_open 1.1.87. is_service_path 1.1.88. issp_get_instance_info 1.1.89. issp_read_probe_data 1.1.90. issp_read_source_data 1.1.91. issp_write_source_data 1.1.92. jtag_debug_loop 1.1.93. jtag_debug_reset_system 1.1.94. jtag_debug_sample_clock 1.1.95. jtag_debug_sample_reset 1.1.96. jtag_debug_sense_clock 1.1.97. log_command_start 1.1.98. log_command_stop 1.1.99. loopback_get 1.1.100. loopback_set 1.1.101. loopback_start 1.1.102. loopback_stop 1.1.103. marker_get_assignments 1.1.104. marker_get_info 1.1.105. marker_get_type 1.1.106. marker_get_types 1.1.107. marker_node_info 1.1.108. master_get_register_names 1.1.109. master_get_slaves 1.1.110. master_get_timeout 1.1.111. master_read_16 1.1.112. master_read_32 1.1.113. master_read_8 1.1.114. master_read_memory 1.1.115. master_read_to_file 1.1.116. master_set_timeout 1.1.117. master_write_16 1.1.118. master_write_32 1.1.119. master_write_8 1.1.120. master_write_from_file 1.1.121. master_write_memory 1.1.122. module_get_children 1.1.123. module_get_keys 1.1.124. module_get_parent 1.1.125. module_get_values 1.1.126. monitor_add_range 1.1.127. monitor_get_all_read_intervals 1.1.128. monitor_get_interval 1.1.129. monitor_get_missing_event_count 1.1.130. monitor_get_read_interval 1.1.131. monitor_read_all_data 1.1.132. monitor_read_data 1.1.133. monitor_set_callback 1.1.134. monitor_set_enabled 1.1.135. monitor_set_interval 1.1.136. open_service 1.1.137. packet_send_command 1.1.138. plugin_disable 1.1.139. plugin_enable 1.1.140. processor_clear_breakpoint 1.1.141. processor_download_elf 1.1.142. processor_gdbserver 1.1.143. processor_gdbserver_start 1.1.144. processor_gdbserver_stop 1.1.145. processor_get_register 1.1.146. processor_get_register_names 1.1.147. processor_in_debug_mode 1.1.148. processor_reset 1.1.149. processor_run 1.1.150. processor_semihosting_start 1.1.151. processor_semihosting_stop 1.1.152. processor_set_breakpoint 1.1.153. processor_set_register 1.1.154. processor_step 1.1.155. processor_stop 1.1.156. processor_stop_reason 1.1.157. processor_verify_elf 1.1.158. refresh_connections 1.1.159. remove_service 1.1.160. semiConsoleNew 1.1.161. semihosting_start 1.1.162. semihosting_stop 1.1.1632.1.20. send_message 1.1.164. sld_access_dr 1.1.165. sld_access_ir 1.1.166. sld_lock 1.1.167. sld_run_test_idle 1.1.168. sld_send_program 1.1.169. sld_test_logic_reset 1.1.170. sld_unlock 1.1.171. stp_run 1.1.172. system_get_keys 1.1.173. system_get_values 1.1.174. toolkit_get_toolkit_actions 1.1.175. toolkit_get_toolkit_autosweep_input_parameters 1.1.176. toolkit_get_toolkit_autosweep_output_metrics 1.1.177. toolkit_get_toolkit_channel_properties 1.1.178. toolkit_get_toolkit_channels 1.1.179. toolkit_get_toolkit_display_hint 1.1.180. toolkit_get_toolkit_display_id_to_name 1.1.181. toolkit_get_toolkit_display_item_property 1.1.182. toolkit_get_toolkit_eye_channels 1.1.183. toolkit_get_toolkit_eye_input_parameters 1.1.184. toolkit_get_toolkit_eye_output_metrics 1.1.185. toolkit_get_toolkit_matching_modules 1.1.186. toolkit_get_toolkit_matching_services 1.1.187. toolkit_get_toolkit_matching_systems 1.1.188. toolkit_get_toolkit_parameter_properties 1.1.189. toolkit_get_toolkit_parameter_property 1.1.190. toolkit_get_toolkit_parameter_value 1.1.191. toolkit_get_toolkit_parameters 1.1.192. toolkit_get_toolkit_properties 1.1.193. toolkit_get_toolkit_property 1.1.194. toolkit_get_toolkit_requirement_ids 1.1.195. toolkit_get_toolkit_requirement_properties 1.1.196. toolkit_get_toolkit_requirement_property 1.1.197. toolkit_load_toolkit_instance 1.1.198. toolkit_log_toolkit_command_start 1.1.199. toolkit_log_toolkit_command_stop 1.1.200. toolkit_run_toolkit_action 1.1.201. toolkit_set_toolkit_parameter_value 1.1.202. toolkit_unload_toolkit_instance 1.1.203. trace_db_delete_snapshot 1.1.204. trace_db_get_snapshot 1.1.205. trace_db_snapshot_get_event_data 1.1.206. trace_db_snapshot_get_event_fields 1.1.207. trace_db_snapshot_get_event_kind 1.1.208. trace_db_snapshot_get_event_timestamp 1.1.209. trace_db_snapshot_get_events 1.1.210. trace_decoder_add_key_result 1.1.211. trace_decoder_add_result 1.1.212. trace_decoder_define_key 1.1.213. trace_decoder_get_config 1.1.214. trace_decoder_get_data_16 1.1.215. trace_decoder_get_data_16be 1.1.216. trace_decoder_get_data_32 1.1.217. trace_decoder_get_data_32be 1.1.218. trace_decoder_get_data_64 1.1.219. trace_decoder_get_data_64be 1.1.220. trace_decoder_get_data_8 1.1.221. trace_decoder_get_length 1.1.222. trace_decoder_get_timestamp 1.1.223. trace_decoder_set_callback 1.1.224. trace_decoder_set_config_regs 1.1.225. trace_decoder_set_summary 1.1.226. trace_get_db_size 1.1.227. trace_get_max_db_size 1.1.228. trace_get_monitor_info 1.1.229. trace_get_monitors 1.1.230. trace_get_status 1.1.231. trace_load 1.1.232. trace_read_monitor 1.1.233. trace_save 1.1.234. trace_set_max_db_size 1.1.235. trace_set_trigger_mode 1.1.236. trace_start 1.1.237. trace_stop 1.1.238. trace_write_monitor
1.2. Properties x
1.2.1. _hw.tcl Capture Mode 1.2.2. _hw.tcl Command Flag Name 1.2.3. _hw.tcl Format 1.2.4. _hw.tcl Kind 1.2.5. _hw.tcl Protocol 1.2.6. _hw.tcl Status 1.2.7. _hw.tcl Trigger Mode
2. Toolkit Tcl Command References x
2.1. Command Summary 2.2. Properties 2.3. System Console and Toolkit Tcl Command Reference Manual Revision History 2.4. System Console and Toolkit Tcl Command Reference Manual Archives
2.1. Command Summary x
2.1.1. add_channel 2.1.2. add_display_item 2.1.3. add_parameter 2.1.4. add_requirement 2.1.5. add_timed_callback 2.1.6. get_accessible_module 2.1.7. get_accessible_modules 2.1.8. get_accessible_service 2.1.9. get_accessible_services 2.1.10. get_accessible_system 2.1.11. get_channel_display_group 2.1.12. get_channel_property 2.1.13. get_display_hint 2.1.14. get_display_item_property 2.1.15. get_eye_viewer_display_group 2.1.16. get_parameter_property 2.1.17. get_parameter_value 2.1.18. get_toolkit_property 2.1.19. remove_timed_callback 1.1.1632.1.20. send_message 2.1.21. set_channel_property 2.1.22. set_current_progress 2.1.23. set_display_hint 2.1.24. set_display_item_property 2.1.25. set_eye_data 2.1.26. set_eye_property 2.1.27. set_parameter_property 2.1.28. set_parameter_update_callback 2.1.29. set_parameter_value 2.1.30. set_requirement_property 2.1.31. set_toolkit_property 2.1.32. stop_requested
2.2. Properties x
2.2.1. _hw.tcl Callbacks 2.2.2. _hw.tcl Channel Properties 2.2.3. _hw.tcl Channel Type 2.2.4. _hw.tcl Display Hint 2.2.5. _hw.tcl Display Item Properties 2.2.6. _hw.tcl Display Item Type 2.2.7. _hw.tcl Eye Properties 2.2.8. _hw.tcl Parameter Properties 2.2.9. _hw.tcl Parameter Type 2.2.10. _hw.tcl Requirement Properties 2.2.11. _hw.tcl Requirement Type 2.2.12. _hw.tcl Toolkit Properties
1. System Console Tcl Command Reference
2. Toolkit Tcl Command References

1.1.26. claim_service

Description

Claim service provides finer grain control of which portion of a service the user wants to use. This is an enhanced mode of open_service. The claim-group argument is required; library authors are advised to create their unique claim-group string to keep track of their claimed services, and to prevent other users from accessing their claimed services. For default scripting use, "" is an acceptable default for the claim-group argument. The claims argument is optional, and is used to specify what specific portion of a service the user wants to use. If that specific portion cannot be safely claimed - for example, if another user has claimed that portion for exclusive access - the claim_service command will fail. When specifying claims, the claim strings must be entered as a list of lists. Please see the examples below. Leaving the claims argument empty means the user wants to claim the entire channel for exclusive use. This is equivalent to using open_service to access the service. This call returns a new service-path where the claimed service will be placed. Use this new service-path to access the claimed service.

Usage

claim_service <serviceType> <servicePath> <libraryName> [<claims>]

ReturnType

String

Returns

Arguments

serviceType
servicePath
libraryName
claims (optional)

Example

To claim a service for exclusive use with "" as the claim-group name, run:
	  claim_service <service-type> <service-path> ""
To claim a service with one claim, run:
	  claim_service <service-type> <service-path> claimGroup1 {{<claim contents>}}   , or
	  claim_service <service-type> <service-path> claimGroup1 [list [list <claim contents> ] ]
To claim a service with two claims, run:
	  claim_service <service-type> <service-path> claimGroup1 {{<claim1 contents>} {<claim2 contents>}}   , or
	  claim_service <service-type> <service-path> claimGroup1 [list [list <claim1 contents> ] [list <claim2 contents>]]
Level Two Title