drivers/ftdi: Group adapter commands
[fw/openocd] / src / jtag / startup.tcl
index ab215babd44dea2210d80f7f7d887fab4e82aca2..472a9f283193a90446438e3f9e82cc471fe82acc 100644 (file)
@@ -21,36 +21,244 @@ proc jtag_init {} {
 # 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
+       if {[using_jtag]} {
+               jtag arp_init-reset
+       }
 }
 
 #########
 
 # TODO: power_restore and power_dropout are currently neither
-# documented nor supported except on ZY1000.
+# documented nor supported.
 
 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."
 }
 
 #########
 
 # TODO: srst_deasserted and srst_asserted are currently neither
-# documented nor supported except on ZY1000.
+# documented nor supported.
 
 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];
+       set iterations 10000000;
+       runtest $iterations;
+       set speed [expr "$iterations.0 / ([ms] - $start_time)"]
+       echo "Running at more than $speed kHz";
+}
+
+add_help_text measure_clk "Runs a test to measure the JTAG clk. Useful with RCLK / RTCK."
+
+proc default_to_jtag { f args } {
+       set current_transport [transport select]
+       if {[using_jtag]} {
+               eval $f $args
+       } {
+               error "session transport is \"$current_transport\" but your config requires JTAG"
+       }
+}
+
+proc jtag args {
+       eval default_to_jtag jtag $args
+}
+
+proc jtag_rclk args {
+       eval default_to_jtag jtag_rclk $args
+}
+
+proc jtag_ntrst_delay args {
+       eval default_to_jtag jtag_ntrst_delay $args
+}
+
+proc jtag_ntrst_assert_width args {
+       eval default_to_jtag jtag_ntrst_assert_width $args
+}
+
+# BEGIN MIGRATION AIDS ...  these adapter operations originally had
+# JTAG-specific names despite the fact that the operations were not
+# specific to JTAG, or otherwise had troublesome/misleading names.
+#
+# FIXME phase these aids out after some releases
+#
+lappend _telnet_autocomplete_skip jtag_reset
+proc jtag_reset args {
+       echo "DEPRECATED! use 'adapter \[de\]assert' not 'jtag_reset'"
+       switch $args {
+               "0 0"
+                       {eval adapter deassert trst deassert srst}
+               "0 1"
+                       {eval adapter deassert trst assert srst}
+               "1 0"
+                       {eval adapter assert trst deassert srst}
+               "1 1"
+                       {eval adapter assert trst assert srst}
+               default
+                       {return -code 1 -level 1 "jtag_reset: syntax error"}
+       }
+}
+
+lappend _telnet_autocomplete_skip adapter_khz
+proc adapter_khz args {
+       echo "DEPRECATED! use 'adapter speed' not 'adapter_khz'"
+       eval adapter speed $args
+}
+
+lappend _telnet_autocomplete_skip adapter_name
+proc adapter_name args {
+       echo "DEPRECATED! use 'adapter name' not 'adapter_name'"
+       eval adapter name $args
+}
+
+lappend _telnet_autocomplete_skip adapter_nsrst_delay
+proc adapter_nsrst_delay args {
+       echo "DEPRECATED! use 'adapter srst delay' not 'adapter_nsrst_delay'"
+       eval adapter srst delay $args
+}
+
+lappend _telnet_autocomplete_skip adapter_nsrst_assert_width
+proc adapter_nsrst_assert_width args {
+       echo "DEPRECATED! use 'adapter srst pulse_width' not 'adapter_nsrst_assert_width'"
+       eval adapter srst pulse_width $args
+}
+
+lappend _telnet_autocomplete_skip interface
+proc interface args {
+       echo "DEPRECATED! use 'adapter driver' not 'interface'"
+       eval adapter driver $args
+}
+
+lappend _telnet_autocomplete_skip interface_transports
+proc  interface_transports args {
+       echo "DEPRECATED! use 'adapter transports' not 'interface_transports'"
+       eval adapter transports $args
+}
+
+lappend _telnet_autocomplete_skip interface_list
+proc  interface_list args {
+       echo "DEPRECATED! use 'adapter list' not 'interface_list'"
+       eval adapter list $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_location
+proc ftdi_location args {
+       echo "DEPRECATED! use 'adapter usb location' not 'ftdi_location'"
+       eval adapter usb location $args
+}
+
+lappend _telnet_autocomplete_skip xds110_serial
+proc xds110_serial args {
+       echo "DEPRECATED! use 'xds110 serial' not 'xds110_serial'"
+       eval xds110 serial $args
+}
+
+lappend _telnet_autocomplete_skip xds110_supply_voltage
+proc xds110_supply_voltage args {
+       echo "DEPRECATED! use 'xds110 supply' not 'xds110_supply_voltage'"
+       eval xds110 supply $args
+}
+
+proc hla {cmd args} {
+        tailcall "hla $cmd" {*}$args
+}
+
+lappend _telnet_autocomplete_skip "hla newtap"
+proc "hla newtap" {args} {
+       echo "DEPRECATED! use 'swj_newdap' not 'hla newtap'"
+       eval swj_newdap $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_device_desc
+proc ftdi_device_desc args {
+       echo "DEPRECATED! use 'ftdi device_desc' not 'ftdi_device_desc'"
+       eval ftdi device_desc $args
 }
+
+lappend _telnet_autocomplete_skip ftdi_serial
+proc ftdi_serial args {
+       echo "DEPRECATED! use 'ftdi serial' not 'ftdi_serial'"
+       eval ftdi serial $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_channel
+proc ftdi_channel args {
+       echo "DEPRECATED! use 'ftdi channel' not 'ftdi_channel'"
+       eval ftdi channel $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_layout_init
+proc ftdi_layout_init args {
+       echo "DEPRECATED! use 'ftdi layout_init' not 'ftdi_layout_init'"
+       eval ftdi layout_init $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_layout_signal
+proc ftdi_layout_signal args {
+       echo "DEPRECATED! use 'ftdi layout_signal' not 'ftdi_layout_signal'"
+       eval ftdi layout_signal $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_set_signal
+proc ftdi_set_signal args {
+       echo "DEPRECATED! use 'ftdi set_signal' not 'ftdi_set_signal'"
+       eval ftdi set_signal $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_get_signal
+proc ftdi_get_signal args {
+       echo "DEPRECATED! use 'ftdi get_signal' not 'ftdi_get_signal'"
+       eval ftdi get_signal $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_vid_pid
+proc ftdi_vid_pid args {
+       echo "DEPRECATED! use 'ftdi vid_pid' not 'ftdi_vid_pid'"
+       eval ftdi vid_pid $args
+}
+
+lappend _telnet_autocomplete_skip ftdi_tdo_sample_edge
+proc ftdi_tdo_sample_edge args {
+       echo "DEPRECATED! use 'ftdi tdo_sample_edge' not 'ftdi_tdo_sample_edge'"
+       eval ftdi tdo_sample_edge $args
+}
+
+# END MIGRATION AIDS