# SPDX-License-Identifier: GPL-2.0-or-later # Defines basic Tcl procs for OpenOCD JTAG module # Executed during "init". Can be overridden # by board/target/... scripts proc jtag_init {} { if {[catch {jtag arp_init} err]!=0} { # try resetting additionally init_reset startup } } # 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. proc 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 {} { echo "Sensed power dropout." } ######### # TODO: srst_deasserted and srst_asserted are currently neither # documented nor supported. proc srst_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 {} { 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 adapter_gpio_helper_with_caller # Helper for deprecated driver functions that should call "adapter gpio XXX". # Call this function as: # adapter_gpio_helper_with_caller caller sig_name # adapter_gpio_helper_with_caller caller sig_name gpio_num # adapter_gpio_helper_with_caller caller sig_name chip_num gpio_num proc adapter_gpio_helper_with_caller {caller sig_name args} { echo "DEPRECATED! use 'adapter gpio $sig_name' not '$caller'" switch [llength $args] { 0 {} 1 {eval adapter gpio $sig_name $args} 2 {eval adapter gpio $sig_name [lindex $args 1] -chip [lindex $args 0]} default {return -code 1 -level 1 "$caller: syntax error"} } eval adapter gpio $sig_name } lappend _telnet_autocomplete_skip adapter_gpio_helper # Call this function as: # adapter_gpio_helper sig_name # adapter_gpio_helper sig_name gpio_num # adapter_gpio_helper sig_name chip_num gpio_num proc adapter_gpio_helper {sig_name args} { set caller [lindex [info level -1] 0] eval adapter_gpio_helper_with_caller {"$caller"} $sig_name $args } lappend _telnet_autocomplete_skip adapter_gpio_jtag_nums_with_caller # Helper for deprecated driver functions that implemented jtag_nums proc adapter_gpio_jtag_nums_with_caller {caller tck_num tms_num tdi_num tdo_num} { echo "DEPRECATED! use 'adapter gpio tck; adapter gpio tms; adapter gpio tdi; adapter gpio tdo' not '$caller'" eval adapter gpio tck $tck_num eval adapter gpio tms $tms_num eval adapter gpio tdi $tdi_num eval adapter gpio tdo $tdo_num } lappend _telnet_autocomplete_skip adapter_gpio_jtag_nums # Helper for deprecated driver functions that implemented jtag_nums proc adapter_gpio_jtag_nums {args} { set caller [lindex [info level -1] 0] eval adapter_gpio_jtag_nums_with_caller {"$caller"} $args } lappend _telnet_autocomplete_skip adapter_gpio_swd_nums_with_caller # Helper for deprecated driver functions that implemented swd_nums proc adapter_gpio_swd_nums_with_caller {caller swclk_num swdio_num} { echo "DEPRECATED! use 'adapter gpio swclk; adapter gpio swdio' not '$caller'" eval adapter gpio swclk $swclk_num eval adapter gpio swdio $swdio_num } lappend _telnet_autocomplete_skip adapter_gpio_swd_nums # Helper for deprecated driver functions that implemented jtag_nums proc adapter_gpio_swd_nums {args} { set caller [lindex [info level -1] 0] eval adapter_gpio_swd_nums_with_caller {"$caller"} $args } 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 'adapter serial' not 'xds110_serial'" eval adapter 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 'adapter serial' not 'ftdi_serial'" eval adapter 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 } lappend _telnet_autocomplete_skip remote_bitbang_host proc remote_bitbang_host args { echo "DEPRECATED! use 'remote_bitbang host' not 'remote_bitbang_host'" eval remote_bitbang host $args } lappend _telnet_autocomplete_skip remote_bitbang_port proc remote_bitbang_port args { echo "DEPRECATED! use 'remote_bitbang port' not 'remote_bitbang_port'" eval remote_bitbang port $args } lappend _telnet_autocomplete_skip openjtag_device_desc proc openjtag_device_desc args { echo "DEPRECATED! use 'openjtag device_desc' not 'openjtag_device_desc'" eval openjtag device_desc $args } lappend _telnet_autocomplete_skip openjtag_variant proc openjtag_variant args { echo "DEPRECATED! use 'openjtag variant' not 'openjtag_variant'" eval openjtag variant $args } lappend _telnet_autocomplete_skip parport_port proc parport_port args { echo "DEPRECATED! use 'parport port' not 'parport_port'" eval parport port $args } lappend _telnet_autocomplete_skip parport_cable proc parport_cable args { echo "DEPRECATED! use 'parport cable' not 'parport_cable'" eval parport cable $args } lappend _telnet_autocomplete_skip parport_write_on_exit proc parport_write_on_exit args { echo "DEPRECATED! use 'parport write_on_exit' not 'parport_write_on_exit'" eval parport write_on_exit $args } lappend _telnet_autocomplete_skip parport_toggling_time proc parport_toggling_time args { echo "DEPRECATED! use 'parport toggling_time' not 'parport_toggling_time'" eval parport toggling_time $args } lappend _telnet_autocomplete_skip jtag_dpi_set_port proc jtag_dpi_set_port args { echo "DEPRECATED! use 'jtag_dpi set_port' not 'jtag_dpi_set_port'" eval jtag_dpi set_port $args } lappend _telnet_autocomplete_skip jtag_dpi_set_address proc jtag_dpi_set_address args { echo "DEPRECATED! use 'jtag_dpi set_address' not 'jtag_dpi_set_address'" eval jtag_dpi set_address $args } lappend _telnet_autocomplete_skip jtag_vpi_set_port proc jtag_vpi_set_port args { echo "DEPRECATED! use 'jtag_vpi set_port' not 'jtag_vpi_set_port'" eval jtag_vpi set_port $args } lappend _telnet_autocomplete_skip jtag_vpi_set_address proc jtag_vpi_set_address args { echo "DEPRECATED! use 'jtag_vpi set_address' not 'jtag_vpi_set_address'" eval jtag_vpi set_address $args } lappend _telnet_autocomplete_skip jtag_vpi_stop_sim_on_exit proc jtag_vpi_stop_sim_on_exit args { echo "DEPRECATED! use 'jtag_vpi stop_sim_on_exit' not 'jtag_vpi_stop_sim_on_exit'" eval jtag_vpi stop_sim_on_exit $args } lappend _telnet_autocomplete_skip presto_serial proc presto_serial args { echo "DEPRECATED! use 'presto serial' not 'presto_serial'" eval presto serial $args } lappend _telnet_autocomplete_skip xlnx_pcie_xvc_config proc xlnx_pcie_xvc_config args { echo "DEPRECATED! use 'xlnx_pcie_xvc config' not 'xlnx_pcie_xvc_config'" eval xlnx_pcie_xvc config $args } lappend _telnet_autocomplete_skip ulink_download_firmware proc ulink_download_firmware args { echo "DEPRECATED! use 'ulink download_firmware' not 'ulink_download_firmware'" eval ulink download_firmware $args } lappend _telnet_autocomplete_skip vsllink_usb_vid proc vsllink_usb_vid args { echo "DEPRECATED! use 'vsllink usb_vid' not 'vsllink_usb_vid'" eval vsllink usb_vid $args } lappend _telnet_autocomplete_skip vsllink_usb_pid proc vsllink_usb_pid args { echo "DEPRECATED! use 'vsllink usb_pid' not 'vsllink_usb_pid'" eval vsllink usb_pid $args } lappend _telnet_autocomplete_skip vsllink_usb_serial proc vsllink_usb_serial args { echo "DEPRECATED! use 'adapter serial' not 'vsllink_usb_serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip vsllink_usb_bulkin proc vsllink_usb_bulkin args { echo "DEPRECATED! use 'vsllink usb_bulkin' not 'vsllink_usb_bulkin'" eval vsllink usb_bulkin $args } lappend _telnet_autocomplete_skip vsllink_usb_bulkout proc vsllink_usb_bulkout args { echo "DEPRECATED! use 'vsllink usb_bulkout' not 'vsllink_usb_bulkout'" eval vsllink usb_bulkout $args } lappend _telnet_autocomplete_skip vsllink_usb_interface proc vsllink_usb_interface args { echo "DEPRECATED! use 'vsllink usb_interface' not 'vsllink_usb_interface'" eval vsllink usb_interface $args } lappend _telnet_autocomplete_skip bcm2835_gpio_helper proc bcm2835_gpio_helper {sig_name args} { set caller [lindex [info level -1] 0] echo "DEPRECATED! use 'adapter gpio $sig_name' not '$caller'" switch [llength $args] { 0 {} 1 {eval adapter gpio $sig_name $args -chip 0} 2 {eval adapter gpio $sig_name [lindex $args 1] -chip [lindex $args 0]} default {return -code 1 -level 1 "$caller: syntax error"} } eval adapter gpio $sig_name } lappend _telnet_autocomplete_skip bcm2835gpio_jtag_nums proc bcm2835gpio_jtag_nums {tck_num tms_num tdi_num tdo_num} { echo "DEPRECATED! use 'adapter gpio tck; adapter gpio tms; adapter gpio tdi; adapter gpio tdo' not 'bcm2835gpio_jtag_nums'" eval adapter gpio tck $tck_num -chip 0 eval adapter gpio tms $tms_num -chip 0 eval adapter gpio tdi $tdi_num -chip 0 eval adapter gpio tdo $tdo_num -chip 0 } lappend _telnet_autocomplete_skip bcm2835gpio_tck_num proc bcm2835gpio_tck_num args { eval bcm2835_gpio_helper tck $args } lappend _telnet_autocomplete_skip bcm2835gpio_tms_num proc bcm2835gpio_tms_num args { eval bcm2835_gpio_helper tms $args } lappend _telnet_autocomplete_skip bcm2835gpio_tdo_num proc bcm2835gpio_tdo_num args { eval bcm2835_gpio_helper tdo $args } lappend _telnet_autocomplete_skip bcm2835gpio_tdi_num proc bcm2835gpio_tdi_num args { eval bcm2835_gpio_helper tdi $args } lappend _telnet_autocomplete_skip bcm2835gpio_swd_nums proc bcm2835gpio_swd_nums {swclk_num swdio_num} { echo "DEPRECATED! use 'adapter gpio swclk; adapter gpio swdio' not 'bcm2835gpio_swd_nums'" eval adapter gpio swclk $swclk_num -chip 0 eval adapter gpio swdio $swdio_num -chip 0 } lappend _telnet_autocomplete_skip bcm2835gpio_swclk_num proc bcm2835gpio_swclk_num args { eval bcm2835_gpio_helper swclk $args } lappend _telnet_autocomplete_skip bcm2835gpio_swdio_num proc bcm2835gpio_swdio_num args { eval bcm2835_gpio_helper swdio $args } lappend _telnet_autocomplete_skip bcm2835gpio_swdio_dir_num proc bcm2835gpio_swdio_dir_num args { eval bcm2835_gpio_helper swdio_dir $args } lappend _telnet_autocomplete_skip bcm2835gpio_srst_num proc bcm2835gpio_srst_num args { eval bcm2835_gpio_helper srst $args } lappend _telnet_autocomplete_skip bcm2835gpio_trst_num proc bcm2835gpio_trst_num args { eval bcm2835_gpio_helper trst $args } lappend _telnet_autocomplete_skip "bcm2835gpio jtag_nums" proc "bcm2835gpio jtag_nums" {tck_num tms_num tdi_num tdo_num} { echo "DEPRECATED! use 'adapter gpio tck; adapter gpio tms; adapter gpio tdi; adapter gpio tdo' not 'bcm2835gpio jtag_nums'" eval adapter gpio tck $tck_num -chip 0 eval adapter gpio tms $tms_num -chip 0 eval adapter gpio tdi $tdi_num -chip 0 eval adapter gpio tdo $tdo_num -chip 0 } lappend _telnet_autocomplete_skip "bcm2835gpio tck_num" proc "bcm2835gpio tck_num" args { eval bcm2835_gpio_helper tck $args } lappend _telnet_autocomplete_skip "bcm2835gpio tms_num" proc "bcm2835gpio tms_num" args { eval bcm2835_gpio_helper tms $args } lappend _telnet_autocomplete_skip "bcm2835gpio tdo_num" proc "bcm2835gpio tdo_num" args { eval bcm2835_gpio_helper tdo $args } lappend _telnet_autocomplete_skip "bcm2835gpio tdi_num" proc "bcm2835gpio tdi_num" args { eval bcm2835_gpio_helper tdi $args } lappend _telnet_autocomplete_skip "bcm2835gpio swd_nums" proc "bcm2835gpio swd_nums" {swclk_num swdio_num} { echo "DEPRECATED! use 'adapter gpio swclk; adapter gpio swdio' not 'bcm2835gpio swd_nums'" eval adapter gpio swclk $swclk_num -chip 0 eval adapter gpio swdio $swdio_num -chip 0 } lappend _telnet_autocomplete_skip "bcm2835gpio swclk_num" proc "bcm2835gpio swclk_num" args { eval bcm2835_gpio_helper swclk $args } lappend _telnet_autocomplete_skip "bcm2835gpio swdio_num" proc "bcm2835gpio swdio_num" args { eval bcm2835_gpio_helper swdio $args } lappend _telnet_autocomplete_skip "bcm2835gpio swdio_dir_num" proc "bcm2835gpio swdio_dir_num" args { eval bcm2835_gpio_helper swdio_dir $args } lappend _telnet_autocomplete_skip "bcm2835gpio srst_num" proc "bcm2835gpio srst_num" args { eval bcm2835_gpio_helper srst $args } lappend _telnet_autocomplete_skip "bcm2835gpio trst_num" proc "bcm2835gpio trst_num" args { eval bcm2835_gpio_helper trst $args } lappend _telnet_autocomplete_skip bcm2835gpio_speed_coeffs proc bcm2835gpio_speed_coeffs args { echo "DEPRECATED! use 'bcm2835gpio speed_coeffs' not 'bcm2835gpio_speed_coeffs'" eval bcm2835gpio speed_coeffs $args } lappend _telnet_autocomplete_skip bcm2835gpio_peripheral_base proc bcm2835gpio_peripheral_base args { echo "DEPRECATED! use 'bcm2835gpio peripheral_base' not 'bcm2835gpio_peripheral_base'" eval bcm2835gpio peripheral_base $args } lappend _telnet_autocomplete_skip linuxgpiod_jtag_nums proc linuxgpiod_jtag_nums args { eval adapter_gpio_jtag_nums $args } lappend _telnet_autocomplete_skip linuxgpiod_tck_num proc linuxgpiod_tck_num args { eval adapter_gpio_helper tck $args } lappend _telnet_autocomplete_skip linuxgpiod_tms_num proc linuxgpiod_tms_num args { eval adapter_gpio_helper tms $args } lappend _telnet_autocomplete_skip linuxgpiod_tdo_num proc linuxgpiod_tdo_num args { eval adapter_gpio_helper tdo $args } lappend _telnet_autocomplete_skip linuxgpiod_tdi_num proc linuxgpiod_tdi_num args { eval adapter_gpio_helper tdi $args } lappend _telnet_autocomplete_skip linuxgpiod_srst_num proc linuxgpiod_srst_num args { eval adapter_gpio_helper srst $args } lappend _telnet_autocomplete_skip linuxgpiod_trst_num proc linuxgpiod_trst_num args { eval adapter_gpio_helper trst $args } lappend _telnet_autocomplete_skip linuxgpiod_swd_nums proc linuxgpiod_swd_nums args { eval adapter_gpio_swd_nums $args } lappend _telnet_autocomplete_skip linuxgpiod_swclk_num proc linuxgpiod_swclk_num args { eval adapter_gpio_helper swclk $args } lappend _telnet_autocomplete_skip linuxgpiod_swdio_num proc linuxgpiod_swdio_num args { eval adapter_gpio_helper swdio $args } lappend _telnet_autocomplete_skip linuxgpiod_led_num proc linuxgpiod_led_num args { eval adapter_gpio_helper led $args } lappend _telnet_autocomplete_skip linuxgpiod_gpiochip proc linuxgpiod_gpiochip args { echo "DEPRECATED! use 'adapter -chip' not 'linuxgpiod_gpiochip'" switch [llength $args] { 0 { } 1 { foreach sig_name {tck tms tdi tdo trst srst swclk swdio swdio_dir led} { eval adapter gpio $sig_name -chip $args } } default {return -code 1 -level 1 "linuxgpiod_gpiochip: syntax error"} } eval adapter gpio } lappend _telnet_autocomplete_skip sysfsgpio_jtag_nums proc sysfsgpio_jtag_nums args { echo "DEPRECATED! use 'sysfsgpio jtag_nums' not 'sysfsgpio_jtag_nums'" eval sysfsgpio jtag_nums $args } lappend _telnet_autocomplete_skip sysfsgpio_tck_num proc sysfsgpio_tck_num args { echo "DEPRECATED! use 'sysfsgpio tck_num' not 'sysfsgpio_tck_num'" eval sysfsgpio tck_num $args } lappend _telnet_autocomplete_skip sysfsgpio_tms_num proc sysfsgpio_tms_num args { echo "DEPRECATED! use 'sysfsgpio tms_num' not 'sysfsgpio_tms_num'" eval sysfsgpio tms_num $args } lappend _telnet_autocomplete_skip sysfsgpio_tdo_num proc sysfsgpio_tdo_num args { echo "DEPRECATED! use 'sysfsgpio tdo_num' not 'sysfsgpio_tdo_num'" eval sysfsgpio tdo_num $args } lappend _telnet_autocomplete_skip sysfsgpio_tdi_num proc sysfsgpio_tdi_num args { echo "DEPRECATED! use 'sysfsgpio tdi_num' not 'sysfsgpio_tdi_num'" eval sysfsgpio tdi_num $args } lappend _telnet_autocomplete_skip sysfsgpio_srst_num proc sysfsgpio_srst_num args { echo "DEPRECATED! use 'sysfsgpio srst_num' not 'sysfsgpio_srst_num'" eval sysfsgpio srst_num $args } lappend _telnet_autocomplete_skip sysfsgpio_trst_num proc sysfsgpio_trst_num args { echo "DEPRECATED! use 'sysfsgpio trst_num' not 'sysfsgpio_trst_num'" eval sysfsgpio trst_num $args } lappend _telnet_autocomplete_skip sysfsgpio_swd_nums proc sysfsgpio_swd_nums args { echo "DEPRECATED! use 'sysfsgpio swd_nums' not 'sysfsgpio_swd_nums'" eval sysfsgpio swd_nums $args } lappend _telnet_autocomplete_skip sysfsgpio_swclk_num proc sysfsgpio_swclk_num args { echo "DEPRECATED! use 'sysfsgpio swclk_num' not 'sysfsgpio_swclk_num'" eval sysfsgpio swclk_num $args } lappend _telnet_autocomplete_skip sysfsgpio_swdio_num proc sysfsgpio_swdio_num args { echo "DEPRECATED! use 'sysfsgpio swdio_num' not 'sysfsgpio_swdio_num'" eval sysfsgpio swdio_num $args } lappend _telnet_autocomplete_skip buspirate_adc proc buspirate_adc args { echo "DEPRECATED! use 'buspirate adc' not 'buspirate_adc'" eval buspirate adc $args } lappend _telnet_autocomplete_skip buspirate_vreg proc buspirate_vreg args { echo "DEPRECATED! use 'buspirate vreg' not 'buspirate_vreg'" eval buspirate vreg $args } lappend _telnet_autocomplete_skip buspirate_pullup proc buspirate_pullup args { echo "DEPRECATED! use 'buspirate pullup' not 'buspirate_pullup'" eval buspirate pullup $args } lappend _telnet_autocomplete_skip buspirate_led proc buspirate_led args { echo "DEPRECATED! use 'buspirate led' not 'buspirate_led'" eval buspirate led $args } lappend _telnet_autocomplete_skip buspirate_speed proc buspirate_speed args { echo "DEPRECATED! use 'buspirate speed' not 'buspirate_speed'" eval buspirate speed $args } lappend _telnet_autocomplete_skip buspirate_mode proc buspirate_mode args { echo "DEPRECATED! use 'buspirate mode' not 'buspirate_mode'" eval buspirate mode $args } lappend _telnet_autocomplete_skip buspirate_port proc buspirate_port args { echo "DEPRECATED! use 'buspirate port' not 'buspirate_port'" eval buspirate port $args } lappend _telnet_autocomplete_skip usb_blaster_device_desc proc usb_blaster_device_desc args { echo "DEPRECATED! use 'usb_blaster device_desc' not 'usb_blaster_device_desc'" eval usb_blaster device_desc $args } lappend _telnet_autocomplete_skip usb_blaster_vid_pid proc usb_blaster_vid_pid args { echo "DEPRECATED! use 'usb_blaster vid_pid' not 'usb_blaster_vid_pid'" eval usb_blaster vid_pid $args } lappend _telnet_autocomplete_skip usb_blaster_lowlevel_driver proc usb_blaster_lowlevel_driver args { echo "DEPRECATED! use 'usb_blaster lowlevel_driver' not 'usb_blaster_lowlevel_driver'" eval usb_blaster lowlevel_driver $args } lappend _telnet_autocomplete_skip usb_blaster_pin proc usb_blaster_pin args { echo "DEPRECATED! use 'usb_blaster pin' not 'usb_blaster_pin'" eval usb_blaster pin $args } lappend _telnet_autocomplete_skip usb_blaster_firmware proc usb_blaster_firmware args { echo "DEPRECATED! use 'usb_blaster firmware' not 'usb_blaster_firmware'" eval usb_blaster firmware $args } lappend _telnet_autocomplete_skip ft232r_serial_desc proc ft232r_serial_desc args { echo "DEPRECATED! use 'adapter serial_desc' not 'ft232r_serial_desc'" eval adapter serial_desc $args } lappend _telnet_autocomplete_skip ft232r_vid_pid proc ft232r_vid_pid args { echo "DEPRECATED! use 'ft232r vid_pid' not 'ft232r_vid_pid'" eval ft232r vid_pid $args } lappend _telnet_autocomplete_skip ft232r_jtag_nums proc ft232r_jtag_nums args { echo "DEPRECATED! use 'ft232r jtag_nums' not 'ft232r_jtag_nums'" eval ft232r jtag_nums $args } lappend _telnet_autocomplete_skip ft232r_tck_num proc ft232r_tck_num args { echo "DEPRECATED! use 'ft232r tck_num' not 'ft232r_tck_num'" eval ft232r tck_num $args } lappend _telnet_autocomplete_skip ft232r_tms_num proc ft232r_tms_num args { echo "DEPRECATED! use 'ft232r tms_num' not 'ft232r_tms_num'" eval ft232r tms_num $args } lappend _telnet_autocomplete_skip ft232r_tdo_num proc ft232r_tdo_num args { echo "DEPRECATED! use 'ft232r tdo_num' not 'ft232r_tdo_num'" eval ft232r tdo_num $args } lappend _telnet_autocomplete_skip ft232r_tdi_num proc ft232r_tdi_num args { echo "DEPRECATED! use 'ft232r tdi_num' not 'ft232r_tdi_num'" eval ft232r tdi_num $args } lappend _telnet_autocomplete_skip ft232r_srst_num proc ft232r_srst_num args { echo "DEPRECATED! use 'ft232r srst_num' not 'ft232r_srst_num'" eval ft232r srst_num $args } lappend _telnet_autocomplete_skip ft232r_trst_num proc ft232r_trst_num args { echo "DEPRECATED! use 'ft232r trst_num' not 'ft232r_trst_num'" eval ft232r trst_num $args } lappend _telnet_autocomplete_skip ft232r_restore_serial proc ft232r_restore_serial args { echo "DEPRECATED! use 'ft232r restore_serial' not 'ft232r_restore_serial'" eval ft232r restore_serial $args } lappend _telnet_autocomplete_skip cmsis_dap_serial proc cmsis_dap_serial args { echo "DEPRECATED! use 'adapter serial' not 'cmsis_dap_serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip "ft232r serial_desc" proc "ft232r serial_desc" {args} { echo "DEPRECATED! use 'adapter serial' not 'ft232r serial_desc'" eval adapter serial $args } lappend _telnet_autocomplete_skip "ftdi serial" proc "ftdi serial" {args} { echo "DEPRECATED! use 'adapter serial' not 'ftdi serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip hla_serial proc hla_serial args { echo "DEPRECATED! use 'adapter serial' not 'hla_serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip "jlink serial" proc "jlink serial" {args} { echo "DEPRECATED! use 'adapter serial' not 'jlink serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip kitprog_serial proc kitprog_serial args { echo "DEPRECATED! use 'adapter serial' not 'kitprog_serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip "presto serial" proc "presto serial" {args} { echo "DEPRECATED! use 'adapter serial' not 'presto serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip "st-link serial" proc "st-link serial" {args} { echo "DEPRECATED! use 'adapter serial' not 'st-link serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip "vsllink usb_serial" proc "vsllink usb_serial" {args} { echo "DEPRECATED! use 'adapter serial' not 'vsllink usb_serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip "xds110 serial" proc "xds110 serial" {args} { echo "DEPRECATED! use 'adapter serial' not 'xds110 serial'" eval adapter serial $args } lappend _telnet_autocomplete_skip linuxgpiod # linuxgpiod command completely removed, this is required for the sub-commands to work proc linuxgpiod {subcommand args} { eval {"linuxgpiod $subcommand"} $args } lappend _telnet_autocomplete_skip "linuxgpiod tck_num" proc "linuxgpiod tck_num" {args} { eval adapter_gpio_helper tck $args } lappend _telnet_autocomplete_skip "linuxgpiod tms_num" proc "linuxgpiod tms_num" {args} { eval adapter_gpio_helper tms $args } lappend _telnet_autocomplete_skip "linuxgpiod tdi_num" proc "linuxgpiod tdi_num" {args} { eval adapter_gpio_helper tdi $args } lappend _telnet_autocomplete_skip "linuxgpiod tdo_num" proc "linuxgpiod tdo_num" {args} { eval adapter_gpio_helper tdo $args } lappend _telnet_autocomplete_skip "linuxgpiod trst_num" proc "linuxgpiod trst_num" {args} { eval adapter_gpio_helper trst $args } lappend _telnet_autocomplete_skip "linuxgpiod srst_num" proc "linuxgpiod srst_num" {args} { eval adapter_gpio_helper srst $args } lappend _telnet_autocomplete_skip "linuxgpiod swclk_num" proc "linuxgpiod swclk_num" {args} { eval adapter_gpio_helper swclk $args } lappend _telnet_autocomplete_skip "linuxgpiod swdio_num" proc "linuxgpiod swdio_num" {args} { eval adapter_gpio_helper swdio $args } lappend _telnet_autocomplete_skip "linuxgpiod swdio_dir_num" proc "linuxgpiod swdio_dir_num" {args} { eval adapter_gpio_helper swdio_dir $args } lappend _telnet_autocomplete_skip "linuxgpiod led_num" proc "linuxgpiod led_num" {args} { eval adapter_gpio_helper led $args } lappend _telnet_autocomplete_skip "linuxgpiod gpiochip" proc "linuxgpiod gpiochip" {num} { echo "DEPRECATED! use 'adapter -chip' not 'linuxgpiod gpiochip'" foreach sig_name {tck tms tdi tdo trst srst swclk swdio swdio_dir led} { eval adapter gpio $sig_name -chip $num } eval adapter gpio } lappend _telnet_autocomplete_skip "linuxgpiod jtag_nums" proc "linuxgpiod jtag_nums" {tck_num tms_num tdi_num tdo_num} { echo "DEPRECATED! use 'adapter gpio tck; adapter gpio tms; adapter gpio tdi; adapter gpio tdo' not 'linuxgpiod jtag_nums'" eval adapter gpio tck $tck_num eval adapter gpio tms $tms_num eval adapter gpio tdi $tdi_num eval adapter gpio tdo $tdo_num } lappend _telnet_autocomplete_skip "linuxgpiod swd_nums" proc "linuxgpiod swd_nums" {swclk swdio} { echo "DEPRECATED! use 'adapter gpio swclk; adapter gpio swdio' not 'linuxgpiod jtag_nums'" eval adapter gpio swclk $swclk eval adapter gpio swdio $swdio } lappend _telnet_autocomplete_skip "am335xgpio jtag_nums" proc "am335xgpio jtag_nums" {tck_num tms_num tdi_num tdo_num} { echo "DEPRECATED! use 'adapter gpio tck; adapter gpio tms; adapter gpio tdi; adapter gpio tdo' not 'am335xgpio jtag_nums'" eval adapter gpio tck [expr {$tck_num % 32}] -chip [expr {$tck_num / 32}] eval adapter gpio tms [expr {$tms_num % 32}] -chip [expr {$tms_num / 32}] eval adapter gpio tdi [expr {$tdi_num % 32}] -chip [expr {$tdi_num / 32}] eval adapter gpio tdo [expr {$tdo_num % 32}] -chip [expr {$tdo_num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio tck_num" proc "am335xgpio tck_num" {num} { echo "DEPRECATED! use 'adapter gpio tck' not 'am335xgpio tck_num'" eval adapter gpio tck [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio tms_num" proc "am335xgpio tms_num" {num} { echo "DEPRECATED! use 'adapter gpio tms' not 'am335xgpio tms_num'" eval adapter gpio tms [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio tdi_num" proc "am335xgpio tdi_num" {num} { echo "DEPRECATED! use 'adapter gpio tdi' not 'am335xgpio tdi_num'" eval adapter gpio tdi [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio tdo_num" proc "am335xgpio tdo_num" {num} { echo "DEPRECATED! use 'adapter gpio tdo' not 'am335xgpio tdo_num'" eval adapter gpio tdo [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio swd_nums" proc "am335xgpio swd_nums" {swclk swdio} { echo "DEPRECATED! use 'adapter gpio swclk; adapter gpio swdio' not 'am335xgpio jtag_nums'" eval adapter gpio swclk [expr {$swclk % 32}] -chip [expr {$swclk / 32}] eval adapter gpio swdio [expr {$swdio % 32}] -chip [expr {$swdio / 32}] } lappend _telnet_autocomplete_skip "am335xgpio swclk_num" proc "am335xgpio swclk_num" {num} { echo "DEPRECATED! use 'adapter gpio swclk' not 'am335xgpio swclk_num'" eval adapter gpio swclk [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio swdio_num" proc "am335xgpio swdio_num" {num} { echo "DEPRECATED! use 'adapter gpio swdio' not 'am335xgpio swdio_num'" eval adapter gpio swdio [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio swdio_dir_num" proc "am335xgpio swdio_dir_num" {num} { echo "DEPRECATED! use 'adapter gpio swdio_dir' not 'am335xgpio swdio_dir_num'" eval adapter gpio swdio_dir [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio swdio_dir_output_state" proc "am335xgpio swdio_dir_output_state" {state} { echo "DEPRECATED! use 'adapter gpio swdio_dir -active-high' or 'adapter gpio swdio_dir -active-low', not 'am335xgpio swdio_dir_output_state'" switch $state { "high" {eval adapter gpio swdio_dir -active-high} "low" {eval adapter gpio swdio_dir -active-low} default {return -code 1 -level 1 "am335xgpio swdio_dir_output_state: syntax error"} } } lappend _telnet_autocomplete_skip "am335xgpio srst_num" proc "am335xgpio srst_num" {num} { echo "DEPRECATED! use 'adapter gpio srst' not 'am335xgpio srst_num'" eval adapter gpio srst [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio trst_num" proc "am335xgpio trst_num" {num} { echo "DEPRECATED! use 'adapter gpio trst' not 'am335xgpio trst_num'" eval adapter gpio trst [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio led_num" proc "am335xgpio led_num" {num} { echo "DEPRECATED! use 'adapter gpio led' not 'am335xgpio led_num'" eval adapter gpio led [expr {$num % 32}] -chip [expr {$num / 32}] } lappend _telnet_autocomplete_skip "am335xgpio led_on_state" proc "am335xgpio led_on_state" {state} { echo "DEPRECATED! use 'adapter gpio led -active-high' or 'adapter gpio led -active-low', not 'am335xgpio led_on_state'" switch $state { "high" {eval adapter gpio led -active-high} "low" {eval adapter gpio led -active-low} default {return -code 1 -level 1 "am335xgpio led_on_state: syntax error"} } } lappend _telnet_autocomplete_skip "cmsis_dap_backend" proc "cmsis_dap_backend" {backend} { echo "DEPRECATED! use 'cmsis-dap backend', not 'cmsis_dap_backend'" eval cmsis-dap backend $backend } lappend _telnet_autocomplete_skip "cmsis_dap_vid_pid" proc "cmsis_dap_vid_pid" {args} { echo "DEPRECATED! use 'cmsis-dap vid_pid', not 'cmsis_dap_vid_pid'" eval cmsis-dap vid_pid $args } lappend _telnet_autocomplete_skip "cmsis_dap_usb" proc "cmsis_dap_usb" {args} { echo "DEPRECATED! use 'cmsis-dap usb', not 'cmsis_dap_usb'" eval cmsis-dap usb $args } lappend _telnet_autocomplete_skip "kitprog_init_acquire_psoc" proc "kitprog_init_acquire_psoc" {} { echo "DEPRECATED! use 'kitprog init_acquire_psoc', not 'kitprog_init_acquire_psoc'" eval kitprog init_acquire_psoc } lappend _telnet_autocomplete_skip "pld device" proc "pld device" {driver tap_name {opt 0}} { echo "DEPRECATED! use 'pld create ...', not 'pld device ...'" if {[string is integer -strict $opt]} { if {$opt == 0} { eval pld create [lindex [split $tap_name .] 0].pld $driver -chain-position $tap_name } else { eval pld create [lindex [split $tap_name .] 0].pld $driver -chain-position $tap_name -no_jstart } } else { eval pld create [lindex [split $tap_name .] 0].pld $driver -chain-position $tap_name -family $opt } } lappend _telnet_autocomplete_skip "ipdbg -start" proc "ipdbg -start" {args} { echo "DEPRECATED! use 'ipdbg create-hub' and 'chip.ipdbghub ipdbg start ...', not 'ipdbg -start ...'" set tap_name "" set pld_name "" set tool_num "1" set port_num "4242" set idx 0 set num_args [llength $args] while {$idx < $num_args} { set arg [lindex $args $idx] switch -- $arg { "-tap" { incr idx if {$idx >= $num_args || [string index [lindex $args $idx] 0] == "-"} { echo "no TAP name given" return } set tap_name [lindex $args $idx] } "-pld" { incr idx if {$idx >= $num_args || [string index [lindex $args $idx] 0] == "-"} { echo "no PLD name given" return } set pld_name [lindex $args $idx] } "-tool" { if {[expr {$idx + 1}] < $num_args && [string index [lindex $args [expr {$idx + 1}]] 0] != "-"} { set tool_num [lindex $args [expr {$idx + 1}]] set args [lreplace $args [expr {$idx + 1}] [expr {$idx + 1}]] incr num_args -1 } set args [lreplace $args $idx $idx] incr num_args -1 incr idx -1 } "-port" { if {[expr {$idx + 1}] < $num_args && [string index [lindex $args [expr {$idx + 1}]] 0] != "-"} { set port_num [lindex $args [expr {$idx + 1}]] set args [lreplace $args [expr {$idx + 1}] [expr {$idx + 1}]] incr num_args -1 } set args [lreplace $args $idx $idx] incr num_args -1 incr idx -1 } "-hub" { set args [lreplace $args $idx $idx "-ir" ] } default { # don't touch remaining arguments } } incr idx } set hub_name "" if {$tap_name != ""} { set hub_name [lindex [split $tap_name .] 0].ipdbghub } elseif {$pld_name != ""} { set hub_name [lindex [split $pld_name .] 0].ipdbghub } else { echo "parsing arguments failed: no tap and no pld given." return } echo "name: $hub_name" echo "ipdbg create-hub $hub_name $args" catch {eval ipdbg create-hub $hub_name $args} eval $hub_name ipdbg start -tool $tool_num -port $port_num } lappend _telnet_autocomplete_skip "ipdbg -stop" proc "ipdbg -stop" {args} { echo "DEPRECATED! use 'chip.ipdbghub ipdbg stop ...', not 'ipdbg -stop ...'" set tap_name "" set pld_name "" set tool_num "1" set idx 0 set num_args [llength $args] while {$idx < $num_args} { set arg [lindex $args $idx] switch -- $arg { "-tap" { incr idx if {$idx >= $num_args || [string index [lindex $args $idx] 0] == "-"} { echo "no TAP name given" return } set tap_name [lindex $args $idx] } "-pld" { incr idx if {$idx >= $num_args || [string index [lindex $args $idx] 0] == "-"} { echo "no PLD name given" return } set pld_name [lindex $args $idx] } "-tool" { if {[expr {$idx + 1}] < $num_args && [string index [lindex $args [expr {$idx + 1}]] 0] != "-"} { set tool_num [lindex $args [expr {$idx + 1}]] } } default { # don't touch remaining arguments } } incr idx } set hub_name "" if {$tap_name != ""} { set hub_name [lindex [split $tap_name .] 0].ipdbghub } elseif {$pld_name != ""} { set hub_name [lindex [split $pld_name .] 0].ipdbghub } else { echo "parsing arguments failed: no tap and no pld given." return } eval $hub_name ipdbg stop -tool $tool_num } # END MIGRATION AIDS