X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=src%2Fflash%2Fstartup.tcl;h=ff053ae1b229bc27aa0b52a0795b5f72a70d0ec5;hp=6cb7d8e8a402f1c02e84e035da5344ec46869f2a;hb=69b0021846fd5b3ded5dc3ed85b9d1aef331900f;hpb=30a6e683b85291b8248a2f6189aa292fdf43162d diff --git a/src/flash/startup.tcl b/src/flash/startup.tcl index 6cb7d8e8a4..ff053ae1b2 100644 --- a/src/flash/startup.tcl +++ b/src/flash/startup.tcl @@ -1,2 +1,113 @@ # Defines basic Tcl procs for OpenOCD flash module +# +# program utility proc +# usage: program filename +# optional args: verify, reset, exit and address +# + +proc program_error {description exit} { + if {$exit == 1} { + echo $description + shutdown error + } + + error $description +} + +proc program {filename args} { + set exit 0 + + foreach arg $args { + if {[string equal $arg "verify"]} { + set verify 1 + } elseif {[string equal $arg "reset"]} { + set reset 1 + } elseif {[string equal $arg "exit"]} { + set exit 1 + } else { + set address $arg + } + } + + # make sure init is called + if {[catch {init}] != 0} { + program_error "** OpenOCD init failed **" 1 + } + + # reset target and call any init scripts + if {[catch {reset init}] != 0} { + program_error "** Unable to reset target **" $exit + } + + # start programming phase + echo "** Programming Started **" + set filename \{$filename\} + if {[info exists address]} { + set flash_args "$filename $address" + } else { + set flash_args "$filename" + } + + if {[catch {eval flash write_image erase $flash_args}] == 0} { + echo "** Programming Finished **" + if {[info exists verify]} { + # verify phase + echo "** Verify Started **" + if {[catch {eval verify_image $flash_args}] == 0} { + echo "** Verified OK **" + } else { + program_error "** Verify Failed **" $exit + } + } + + if {[info exists reset]} { + # reset target if requested + if {$exit == 1} { + # also disable target polling, we are shutting down anyway + poll off + } + echo "** Resetting Target **" + reset run + } + } else { + program_error "** Programming Failed **" $exit + } + + if {$exit == 1} { + shutdown + } + return +} + +add_help_text program "write an image to flash, address is only required for binary images. verify, reset, exit are optional" +add_usage_text program " \[address\] \[verify\] \[reset\] \[exit\]" + +# stm32f0x uses the same flash driver as the stm32f1x +# this alias enables the use of either name. +proc stm32f0x args { + eval stm32f1x $args +} + +# stm32f3x uses the same flash driver as the stm32f1x +# this alias enables the use of either name. +proc stm32f3x args { + eval stm32f1x $args +} + +# stm32f4x uses the same flash driver as the stm32f2x +# this alias enables the use of either name. +proc stm32f4x args { + eval stm32f2x $args +} + +# ease migration to updated flash driver +proc stm32x args { + echo "DEPRECATED! use 'stm32f1x $args' not 'stm32x $args'" + eval stm32f1x $args +} + +proc stm32f2xxx args { + echo "DEPRECATED! use 'stm32f2x $args' not 'stm32f2xxx $args'" + eval stm32f2x $args +}