1 # Defines basic Tcl procs for OpenOCD JTAG module
3 # Executed during "init". Can be overridden
4 # by board/target/... scripts
6 if {[catch {jtag arp_init
} err
]!=0} {
7 # try resetting additionally
12 # This reset logic may be overridden by board/target/... scripts as needed
13 # to provide a reset that, if possible, is close to a power-up reset.
15 # Exit requirements include: (a) JTAG must be working, (b) the scan
16 # chain was validated with "jtag arp_init" (or equivalent), (c) nothing
17 # stays in reset. No TAP-specific scans were performed. It's OK if
18 # some targets haven't been reset yet; they may need TAP-specific scans.
20 # The "mode" values include: halt, init, run (from "reset" command);
21 # startup (at OpenOCD server startup, when JTAG may not yet work); and
22 # potentially more (for reset types like cold, warm, etc)
23 proc init_reset
{ mode
} {
31 # TODO: power_restore and power_dropout are currently neither
32 # documented nor supported.
34 proc power_restore
{} {
35 echo
"Sensed power restore, running reset init and halting GDB."
38 # Halt GDB so user can deal with a detected power restore.
40 # After GDB is halted, then output is no longer forwarded
42 set targets
[target names
]
45 $t invoke-event arp_halt_gdb
49 add_help_text power_restore
"Overridable procedure run when power restore is detected. Runs 'reset init' by default."
51 proc power_dropout
{} {
52 echo
"Sensed power dropout."
57 # TODO: srst_deasserted and srst_asserted are currently neither
58 # documented nor supported.
60 proc srst_deasserted
{} {
61 echo
"Sensed nSRST deasserted, running reset init and halting GDB."
64 # Halt GDB so user can deal with a detected reset.
66 # After GDB is halted, then output is no longer forwarded
68 set targets
[target names
]
71 $t invoke-event arp_halt_gdb
75 add_help_text srst_deasserted
"Overridable procedure run when srst deassert is detected. Runs 'reset init' by default."
77 proc srst_asserted
{} {
78 echo
"Sensed nSRST asserted."
81 # measure actual JTAG clock
84 set iterations
10000000;
86 set speed
[expr "$iterations.0 / ([ms] - $start_time)"]
87 echo
"Running at more than $speed kHz";
90 add_help_text measure_clk
"Runs a test to measure the JTAG clk. Useful with RCLK / RTCK."
92 proc default_to_jtag
{ f args
} {
93 set current_transport
[transport select
]
97 error "session transport is \"$current_transport\" but your config requires JTAG"
102 eval default_to_jtag jtag
$args
105 proc jtag_rclk args
{
106 eval default_to_jtag jtag_rclk
$args
109 proc jtag_ntrst_delay args
{
110 eval default_to_jtag jtag_ntrst_delay
$args
113 proc jtag_ntrst_assert_width args
{
114 eval default_to_jtag jtag_ntrst_assert_width
$args
117 # BEGIN MIGRATION AIDS ... these adapter operations originally had
118 # JTAG-specific names despite the fact that the operations were not
119 # specific to JTAG, or otherwise had troublesome/misleading names.
121 # FIXME phase these aids out after some releases
123 lappend _telnet_autocomplete_skip jtag_reset
124 proc jtag_reset args
{
125 echo
"DEPRECATED! use 'adapter \[de\]assert' not 'jtag_reset'"
128 {eval adapter deassert trst deassert srst
}
130 {eval adapter deassert trst assert srst
}
132 {eval adapter assert trst deassert srst
}
134 {eval adapter assert trst assert srst
}
136 {return -code 1 -level 1 "jtag_reset: syntax error"}
140 lappend _telnet_autocomplete_skip adapter_khz
141 proc adapter_khz args
{
142 echo
"DEPRECATED! use 'adapter speed' not 'adapter_khz'"
143 eval adapter speed
$args
146 lappend _telnet_autocomplete_skip adapter_name
147 proc adapter_name args
{
148 echo
"DEPRECATED! use 'adapter name' not 'adapter_name'"
149 eval adapter name
$args
152 lappend _telnet_autocomplete_skip adapter_nsrst_delay
153 proc adapter_nsrst_delay args
{
154 echo
"DEPRECATED! use 'adapter srst delay' not 'adapter_nsrst_delay'"
155 eval adapter srst delay
$args
158 lappend _telnet_autocomplete_skip adapter_nsrst_assert_width
159 proc adapter_nsrst_assert_width args
{
160 echo
"DEPRECATED! use 'adapter srst pulse_width' not 'adapter_nsrst_assert_width'"
161 eval adapter srst pulse_width
$args
164 lappend _telnet_autocomplete_skip interface
165 proc interface args
{
166 echo
"DEPRECATED! use 'adapter driver' not 'interface'"
167 eval adapter driver
$args
170 lappend _telnet_autocomplete_skip interface_transports
171 proc interface_transports args
{
172 echo
"DEPRECATED! use 'adapter transports' not 'interface_transports'"
173 eval adapter transports
$args
176 lappend _telnet_autocomplete_skip interface_list
177 proc interface_list args
{
178 echo
"DEPRECATED! use 'adapter list' not 'interface_list'"
179 eval adapter
list $args
182 lappend _telnet_autocomplete_skip ftdi_location
183 proc ftdi_location args
{
184 echo
"DEPRECATED! use 'adapter usb location' not 'ftdi_location'"
185 eval adapter usb location
$args
188 lappend _telnet_autocomplete_skip xds110_serial
189 proc xds110_serial args
{
190 echo
"DEPRECATED! use 'xds110 serial' not 'xds110_serial'"
191 eval xds110 serial
$args
194 lappend _telnet_autocomplete_skip xds110_supply_voltage
195 proc xds110_supply_voltage args
{
196 echo
"DEPRECATED! use 'xds110 supply' not 'xds110_supply_voltage'"
197 eval xds110 supply
$args
200 proc hla
{cmd args
} {
201 tailcall
"hla $cmd" {*}$args
204 lappend _telnet_autocomplete_skip
"hla newtap"
205 proc "hla newtap" {args
} {
206 echo
"DEPRECATED! use 'swj_newdap' not 'hla newtap'"
207 eval swj_newdap
$args
210 lappend _telnet_autocomplete_skip ftdi_device_desc
211 proc ftdi_device_desc args
{
212 echo
"DEPRECATED! use 'ftdi device_desc' not 'ftdi_device_desc'"
213 eval ftdi device_desc
$args
216 lappend _telnet_autocomplete_skip ftdi_serial
217 proc ftdi_serial args
{
218 echo
"DEPRECATED! use 'ftdi serial' not 'ftdi_serial'"
219 eval ftdi serial
$args
222 lappend _telnet_autocomplete_skip ftdi_channel
223 proc ftdi_channel args
{
224 echo
"DEPRECATED! use 'ftdi channel' not 'ftdi_channel'"
225 eval ftdi channel
$args
228 lappend _telnet_autocomplete_skip ftdi_layout_init
229 proc ftdi_layout_init args
{
230 echo
"DEPRECATED! use 'ftdi layout_init' not 'ftdi_layout_init'"
231 eval ftdi layout_init
$args
234 lappend _telnet_autocomplete_skip ftdi_layout_signal
235 proc ftdi_layout_signal args
{
236 echo
"DEPRECATED! use 'ftdi layout_signal' not 'ftdi_layout_signal'"
237 eval ftdi layout_signal
$args
240 lappend _telnet_autocomplete_skip ftdi_set_signal
241 proc ftdi_set_signal args
{
242 echo
"DEPRECATED! use 'ftdi set_signal' not 'ftdi_set_signal'"
243 eval ftdi set_signal
$args
246 lappend _telnet_autocomplete_skip ftdi_get_signal
247 proc ftdi_get_signal args
{
248 echo
"DEPRECATED! use 'ftdi get_signal' not 'ftdi_get_signal'"
249 eval ftdi get_signal
$args
252 lappend _telnet_autocomplete_skip ftdi_vid_pid
253 proc ftdi_vid_pid args
{
254 echo
"DEPRECATED! use 'ftdi vid_pid' not 'ftdi_vid_pid'"
255 eval ftdi vid_pid
$args
258 lappend _telnet_autocomplete_skip ftdi_tdo_sample_edge
259 proc ftdi_tdo_sample_edge args
{
260 echo
"DEPRECATED! use 'ftdi tdo_sample_edge' not 'ftdi_tdo_sample_edge'"
261 eval ftdi tdo_sample_edge
$args
264 lappend _telnet_autocomplete_skip remote_bitbang_host
265 proc remote_bitbang_host args
{
266 echo
"DEPRECATED! use 'remote_bitbang host' not 'remote_bitbang_host'"
267 eval remote_bitbang host
$args
270 lappend _telnet_autocomplete_skip remote_bitbang_port
271 proc remote_bitbang_port args
{
272 echo
"DEPRECATED! use 'remote_bitbang port' not 'remote_bitbang_port'"
273 eval remote_bitbang port
$args
276 lappend _telnet_autocomplete_skip openjtag_device_desc
277 proc openjtag_device_desc args
{
278 echo
"DEPRECATED! use 'openjtag device_desc' not 'openjtag_device_desc'"
279 eval openjtag device_desc
$args
282 lappend _telnet_autocomplete_skip openjtag_variant
283 proc openjtag_variant args
{
284 echo
"DEPRECATED! use 'openjtag variant' not 'openjtag_variant'"
285 eval openjtag variant
$args
288 lappend _telnet_autocomplete_skip parport_port
289 proc parport_port args
{
290 echo
"DEPRECATED! use 'parport port' not 'parport_port'"
291 eval parport port
$args
294 lappend _telnet_autocomplete_skip parport_cable
295 proc parport_cable args
{
296 echo
"DEPRECATED! use 'parport cable' not 'parport_cable'"
297 eval parport cable
$args
300 lappend _telnet_autocomplete_skip parport_write_on_exit
301 proc parport_write_on_exit args
{
302 echo
"DEPRECATED! use 'parport write_on_exit' not 'parport_write_on_exit'"
303 eval parport write_on_exit
$args
306 lappend _telnet_autocomplete_skip parport_toggling_time
307 proc parport_toggling_time args
{
308 echo
"DEPRECATED! use 'parport toggling_time' not 'parport_toggling_time'"
309 eval parport toggling_time
$args
312 lappend _telnet_autocomplete_skip jtag_dpi_set_port
313 proc jtag_dpi_set_port args
{
314 echo
"DEPRECATED! use 'jtag_dpi set_port' not 'jtag_dpi_set_port'"
315 eval jtag_dpi set_port
$args
318 lappend _telnet_autocomplete_skip jtag_dpi_set_address
319 proc jtag_dpi_set_address args
{
320 echo
"DEPRECATED! use 'jtag_dpi set_address' not 'jtag_dpi_set_address'"
321 eval jtag_dpi set_address
$args
324 lappend _telnet_autocomplete_skip presto_serial
325 proc presto_serial args
{
326 echo
"DEPRECATED! use 'presto serial' not 'presto_serial'"
327 eval presto serial
$args
330 lappend _telnet_autocomplete_skip xlnx_pcie_xvc_config
331 proc xlnx_pcie_xvc_config args
{
332 echo
"DEPRECATED! use 'xlnx_pcie_xvc config' not 'xlnx_pcie_xvc_config'"
333 eval xlnx_pcie_xvc config
$args
336 lappend _telnet_autocomplete_skip ulink_download_firmware
337 proc ulink_download_firmware args
{
338 echo
"DEPRECATED! use 'ulink download_firmware' not 'ulink_download_firmware'"
339 eval ulink download_firmware
$args
342 lappend _telnet_autocomplete_skip vsllink_usb_vid
343 proc vsllink_usb_vid args
{
344 echo
"DEPRECATED! use 'vsllink usb_vid' not 'vsllink_usb_vid'"
345 eval vsllink usb_vid
$args
348 lappend _telnet_autocomplete_skip vsllink_usb_pid
349 proc vsllink_usb_pid args
{
350 echo
"DEPRECATED! use 'vsllink usb_pid' not 'vsllink_usb_pid'"
351 eval vsllink usb_pid
$args
354 lappend _telnet_autocomplete_skip vsllink_usb_serial
355 proc vsllink_usb_serial args
{
356 echo
"DEPRECATED! use 'vsllink usb_serial' not 'vsllink_usb_serial'"
357 eval vsllink usb_serial
$args
360 lappend _telnet_autocomplete_skip vsllink_usb_bulkin
361 proc vsllink_usb_bulkin args
{
362 echo
"DEPRECATED! use 'vsllink usb_bulkin' not 'vsllink_usb_bulkin'"
363 eval vsllink usb_bulkin
$args
366 lappend _telnet_autocomplete_skip vsllink_usb_bulkout
367 proc vsllink_usb_bulkout args
{
368 echo
"DEPRECATED! use 'vsllink usb_bulkout' not 'vsllink_usb_bulkout'"
369 eval vsllink usb_bulkout
$args
372 lappend _telnet_autocomplete_skip vsllink_usb_interface
373 proc vsllink_usb_interface args
{
374 echo
"DEPRECATED! use 'vsllink usb_interface' not 'vsllink_usb_interface'"
375 eval vsllink usb_interface
$args