1 # Defines basic Tcl procs for OpenOCD flash module
5 # usage: program filename
6 # optional args: verify, reset, exit and address
9 proc program_error {description exit} {
18 proc program {filename args} {
23 if {[string equal $arg "preverify"]} {
25 } elseif {[string equal $arg "verify"]} {
27 } elseif {[string equal $arg "reset"]} {
29 } elseif {[string equal $arg "exit"]} {
37 set filename \{$filename\}
38 if {[info exists address]} {
39 set flash_args "$filename $address"
41 set flash_args "$filename"
45 # make sure init is called
46 if {[catch {init}] != 0} {
47 program_error "** OpenOCD init failed **" 1
50 # reset target and call any init scripts
51 if {[catch {reset init}] != 0} {
52 program_error "** Unable to reset target **" $exit
55 # Check whether programming is needed
56 if {[info exists preverify]} {
57 echo "**pre-verifying**"
58 if {[catch {eval verify_image $flash_args}] == 0} {
59 echo "**Verified OK - No flashing**"
64 # start programming phase
65 if {$needsflash == 1} {
66 echo "** Programming Started **"
68 if {[catch {eval flash write_image erase $flash_args}] == 0} {
69 echo "** Programming Finished **"
70 if {[info exists verify]} {
72 echo "** Verify Started **"
73 if {[catch {eval verify_image $flash_args}] == 0} {
74 echo "** Verified OK **"
76 program_error "** Verify Failed **" $exit
80 program_error "** Programming Failed **" $exit
84 if {[info exists reset]} {
85 # reset target if requested
87 # also disable target polling, we are shutting down anyway
90 echo "** Resetting Target **"
101 add_help_text program "write an image to flash, address is only required for binary images. verify, reset, exit are optional"
102 add_usage_text program "<filename> \[address\] \[pre-verify\] \[verify\] \[reset\] \[exit\]"
104 # stm32[f0x|f3x] uses the same flash driver as the stm32f1x
105 proc stm32f0x args { eval stm32f1x $args }
106 proc stm32f3x args { eval stm32f1x $args }
108 # stm32[f4x|f7x] uses the same flash driver as the stm32f2x
109 proc stm32f4x args { eval stm32f2x $args }
110 proc stm32f7x args { eval stm32f2x $args }
112 # stm32lx driver supports both STM32 L0 and L1 devices
113 proc stm32l0x args { eval stm32lx $args }
114 proc stm32l1x args { eval stm32lx $args }
116 # stm32[g0|g4|wb|wl] uses the same flash driver as the stm32l4x
117 proc stm32g0x args { eval stm32l4x $args }
118 proc stm32g4x args { eval stm32l4x $args }
119 proc stm32wbx args { eval stm32l4x $args }
120 proc stm32wlx args { eval stm32l4x $args }
122 # ease migration to updated flash driver
124 echo "DEPRECATED! use 'stm32f1x $args' not 'stm32x $args'"
128 proc stm32f2xxx args {
129 echo "DEPRECATED! use 'stm32f2x $args' not 'stm32f2xxx $args'"