1 # Defines basic Tcl procs that must exist for OpenOCD scripts to work.
3 # Embedded into OpenOCD executable
7 # We need to explicitly redirect this to the OpenOCD command
8 # as Tcl defines the exit proc
13 # Help text list. A list of command + help text pairs.
14 proc cmd_help {cmdname h indent} {
15 set indent [expr $indent * 2]
17 set fmt_str [format "%%%ds%%-%ds %%s" $indent [expr 25 - $indent]]
18 set w [expr 50 - $indent]
22 if {$n > [string length $h]} {break}
24 set next_a [expr $n + $w]
25 if {[string length $h] > $n + $w} \
27 set xxxx [string range $h $n [expr $n + $w]]
28 for {set lastpos [expr [string length $xxxx] - 1]} \
29 {$lastpos >= 0 && [string compare \
30 [string range $xxxx $lastpos $lastpos] " "] != 0} \
31 {set lastpos [expr $lastpos - 1]} \
36 set next_a [expr $lastpos + $n + 1]
40 puts [format $fmt_str "" $cmdname \
41 [string range $h $n [expr $next_a - 1]] ]
47 # If a fn is unknown to Tcl, we try to execute it as an OpenOCD command
49 # We also support two level commands. "flash banks" is translated to
52 # do the name mangling from "flash banks" to "flash_banks"
53 if {[llength $args]>=2} {
54 set cmd_name "[lindex $args 0]_[lindex $args 1]"
55 if {[catch {info body $cmd_name}]==0} {
56 # the command exists, try it...
57 return [eval "$cmd_name [lrange $args 2 end]"]
60 # This really is an unknown command.
61 return -code error "Unknown command: $args"
64 # Try flipping / and \ to find file if the filename does not
65 # match the precise spelling
66 proc find {filename} {
67 if {[catch {ocd_find $filename} t]==0} {
70 if {[catch {ocd_find [string map {\ /} $filename} t]==0} {
73 if {[catch {ocd_find [string map {/ \\} $filename} t]==0} {
76 # make sure error message matches original input string
77 return -code error "Can't find $filename"
79 add_help_text find "<file> - print full path to file according to OpenOCD search rules"
82 proc script {filename} {
83 source [find $filename]
86 add_help_text script "<filename> - filename of OpenOCD script (tcl) to run"
90 # catch any exceptions, capture output and return output
91 proc capture_catch {a} {