X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=src%2Fjtag%2Fstartup.tcl;h=94590e13389807fa98d8867fe3825b320c2b9056;hp=999f5d02819bba6e65f19dfdf198ce298536d413;hb=f8a6a07149d88737f3d466e7ce620cc1f0874c6a;hpb=cb7dbc1af41068f826246beb53870c01d8973bb8 diff --git a/src/jtag/startup.tcl b/src/jtag/startup.tcl index 999f5d0281..94590e1338 100644 --- a/src/jtag/startup.tcl +++ b/src/jtag/startup.tcl @@ -9,20 +9,47 @@ proc jtag_init {} { } } +# This reset logic may be overridden by board/target/... scripts as needed +# to provide a reset that, if possible, is close to a power-up reset. +# +# Exit requirements include: (a) JTAG must be working, (b) the scan +# chain was validated with "jtag arp_init" (or equivalent), (c) nothing +# stays in reset. No TAP-specific scans were performed. It's OK if +# some targets haven't been reset yet; they may need TAP-specific scans. +# +# The "mode" values include: halt, init, run (from "reset" command); +# startup (at OpenOCD server startup, when JTAG may not yet work); and +# potentially more (for reset types like cold, warm, etc) +proc init_reset { mode } { + if {[using_jtag]} { + jtag arp_init-reset + } +} + ######### # TODO: power_restore and power_dropout are currently neither # documented nor supported except on ZY1000. proc power_restore {} { - puts "Sensed power restore." + echo "Sensed power restore, running reset init and halting GDB." reset init + + # Halt GDB so user can deal with a detected power restore. + # + # After GDB is halted, then output is no longer forwarded + # to the GDB console. + set targets [target names] + foreach t $targets { + # New event script. + $t invoke-event arp_halt_gdb + } } add_help_text power_restore "Overridable procedure run when power restore is detected. Runs 'reset init' by default." proc power_dropout {} { - puts "Sensed power dropout." + echo "Sensed power dropout." } ######### @@ -31,11 +58,80 @@ proc power_dropout {} { # documented nor supported except on ZY1000. proc srst_deasserted {} { - puts "Sensed nSRST deasserted." + echo "Sensed nSRST deasserted, running reset init and halting GDB." reset init + + # Halt GDB so user can deal with a detected reset. + # + # After GDB is halted, then output is no longer forwarded + # to the GDB console. + set targets [target names] + foreach t $targets { + # New event script. + $t invoke-event arp_halt_gdb + } } + add_help_text srst_deasserted "Overridable procedure run when srst deassert is detected. Runs 'reset init' by default." proc srst_asserted {} { - puts "Sensed nSRST asserted." + echo "Sensed nSRST asserted." +} + +# measure actual JTAG clock +proc measure_clk {} { + set start_time [ms]; + runtest 10000000; + echo "Running at more than [expr 10000.0 / ([ms]-$start_time)] kHz"; } + +add_help_text measure_clk "Runs a test to measure the JTAG clk. Useful with RCLK / RTCK." + +# BEGIN MIGRATION AIDS ... these adapter operations originally had +# JTAG-specific names despite the fact that the operations were not +# specific to JTAG, or otherewise had troublesome/misleading names. +# +# FIXME phase these aids out after about April 2011 +# +proc jtag_khz args { + echo "DEPRECATED! use 'adapter_khz' not 'jtag_khz'" + eval adapter_khz $args +} + +proc jtag_nsrst_delay args { + echo "DEPRECATED! use 'adapter_nsrst_delay' not 'jtag_nsrst_delay'" + eval adapter_nsrst_delay $args +} + +proc jtag_nsrst_assert_width args { + echo "DEPRECATED! use 'adapter_nsrst_assert_width' not 'jtag_nsrst_assert_width'" + eval adapter_nsrst_assert_width $args +} + +# stlink migration helpers +proc stlink_device_desc args { + echo "DEPRECATED! use 'hla_device_desc' not 'stlink_device_desc'" + eval hla_device_desc $args +} + +proc stlink_serial args { + echo "DEPRECATED! use 'hla_serial' not 'stlink_serial'" + eval hla_serial $args +} + +proc stlink_layout args { + echo "DEPRECATED! use 'hla_layout' not 'stlink_layout'" + eval hla_layout $args +} + +proc stlink_vid_pid args { + echo "DEPRECATED! use 'hla_vid_pid' not 'stlink_vid_pid'" + eval hla_vid_pid $args +} + +proc stlink args { + echo "DEPRECATED! use 'hla' not 'stlink'" + eval hla $args +} + +# END MIGRATION AIDS