X-Git-Url: https://review.openocd.org/gitweb?a=blobdiff_plain;f=src%2Fjtag%2Fstartup.tcl;h=11a79779341488001978d030fbfc0379221642eb;hb=3d2dd4a3a31d730de244d2f35f351e826ced55b1;hp=999f5d02819bba6e65f19dfdf198ce298536d413;hpb=cb7dbc1af41068f826246beb53870c01d8973bb8;p=openocd.git diff --git a/src/jtag/startup.tcl b/src/jtag/startup.tcl index 999f5d0281..11a7977934 100644 --- a/src/jtag/startup.tcl +++ b/src/jtag/startup.tcl @@ -9,20 +9,45 @@ 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 } { + 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 +56,54 @@ 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 +} + +# END MIGRATION AIDS