coding style: tcl: remove empty lines at end of text files
[fw/openocd] / tcl / target / stm32f7x.cfg
1 # script for stm32f7x family
2
3 #
4 # stm32f7 devices support both JTAG and SWD transports.
5 #
6 source [find target/swj-dp.tcl]
7 source [find mem_helper.tcl]
8
9 if { [info exists CHIPNAME] } {
10    set _CHIPNAME $CHIPNAME
11 } else {
12    set _CHIPNAME stm32f7x
13 }
14
15    set _ENDIAN little
16
17 # Work-area is a space in RAM used for flash programming
18 # By default use 128kB
19 if { [info exists WORKAREASIZE] } {
20    set _WORKAREASIZE $WORKAREASIZE
21 } else {
22    set _WORKAREASIZE 0x20000
23 }
24
25 #jtag scan chain
26 if { [info exists CPUTAPID] } {
27    set _CPUTAPID $CPUTAPID
28 } else {
29    if { [using_jtag] } {
30       # See STM Document RM0385
31       # Section 40.6.3 - corresponds to Cortex-M7 with FPU r0p0
32       set _CPUTAPID 0x5ba00477
33    } {
34       set _CPUTAPID 0x5ba02477
35    }
36 }
37
38 swj_newdap $_CHIPNAME cpu -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id $_CPUTAPID
39 dap create $_CHIPNAME.dap -chain-position $_CHIPNAME.cpu
40
41 if {[using_jtag]} {
42    jtag newtap $_CHIPNAME bs -irlen 5
43 }
44
45 set _TARGETNAME $_CHIPNAME.cpu
46 target create $_TARGETNAME cortex_m -endian $_ENDIAN -dap $_CHIPNAME.dap
47
48 $_TARGETNAME configure -work-area-phys 0x20000000 -work-area-size $_WORKAREASIZE -work-area-backup 0
49
50 set _FLASHNAME $_CHIPNAME.flash
51 flash bank $_FLASHNAME stm32f2x 0 0 0 0 $_TARGETNAME
52 flash bank $_CHIPNAME.otp stm32f2x 0x1ff0f000 0 0 0 $_TARGETNAME
53
54 # On the STM32F7, the Flash is mapped at address 0x08000000 via the AXI and
55 # also address 0x00200000 via the ITCM. The former mapping is read-write in
56 # hardware, while the latter is read-only. By presenting an alias, we
57 # accomplish two things:
58 # (1) We allow writing at 0x00200000 (because the alias acts identically to the
59 #     original bank), which allows code intended to run from that address to
60 #     also be linked for loading at that address, simplifying linking.
61 # (2) We allow the proper memory map to be delivered to GDB, which will cause
62 #     it to use hardware breakpoints at the 0x00200000 mapping (correctly
63 #     identifying it as Flash), which it would otherwise not do. Configuring
64 #     the Flash via ITCM alias as virtual
65 flash bank $_CHIPNAME.itcm-flash.alias virtual 0x00200000 0 0 0 $_TARGETNAME $_FLASHNAME
66
67 # adapter speed should be <= F_CPU/6. F_CPU after reset is 16MHz, so use F_JTAG = 2MHz
68 adapter speed 2000
69
70 adapter srst delay 100
71 if {[using_jtag]} {
72  jtag_ntrst_delay 100
73 }
74
75 # Use hardware reset.
76 #
77 # This target is compatible with connect_assert_srst, which may be set in a
78 # board file.
79 reset_config srst_only srst_nogate
80
81 if {![using_hla]} {
82    # if srst is not fitted use SYSRESETREQ to
83    # perform a soft reset
84    cortex_m reset_config sysresetreq
85
86    # Set CSW[27], which according to ARM ADI v5 appendix E1.4 maps to AHB signal
87    # HPROT[3], which according to AMBA AHB/ASB/APB specification chapter 3.7.3
88    # makes the data access cacheable. This allows reading and writing data in the
89    # CPU cache from the debugger, which is far more useful than going straight to
90    # RAM when operating on typical variables, and is generally no worse when
91    # operating on special memory locations.
92    $_CHIPNAME.dap apcsw 0x08000000 0x08000000
93 }
94
95 $_TARGETNAME configure -event examine-end {
96         # DBGMCU_CR |= DBG_STANDBY | DBG_STOP | DBG_SLEEP
97         mmw 0xE0042004 0x00000007 0
98
99         # Stop watchdog counters during halt
100         # DBGMCU_APB1_FZ |= DBG_IWDG_STOP | DBG_WWDG_STOP
101         mmw 0xE0042008 0x00001800 0
102 }
103
104 $_TARGETNAME configure -event trace-config {
105         # Set TRACE_IOEN; TRACE_MODE is set to async; when using sync
106         # change this value accordingly to configure trace pins
107         # assignment
108         mmw 0xE0042004 0x00000020 0
109 }
110
111 $_TARGETNAME configure -event reset-init {
112         # If the HSE was previously enabled and the external clock source
113         # disappeared, RCC_CR.HSERDY can get stuck at 1 and the PLL cannot be
114         # properly switched back to HSI. This situation persists even over a system
115         # reset, including a pin reset via SRST. However, activating the clock
116         # security system will detect the problem and clear HSERDY to 0, which in
117         # turn allows the PLL to switch back to HSI properly. Since we just came
118         # out of reset, HSEON should be 0. If HSERDY is 1, then this situation must
119         # have happened; in that case, activate the clock security system to clear
120         # HSERDY.
121         if {[mrw 0x40023800] & 0x00020000} {
122                 mmw 0x40023800 0x00090000 0 ;# RCC_CR = CSSON | HSEON
123                 sleep 10                    ;# Wait for CSS to fire, if it wants to
124                 mmw 0x40023800 0 0x00090000 ;# RCC_CR &= ~CSSON & ~HSEON
125                 mww 0x4002380C 0x00800000   ;# RCC_CIR = CSSC
126                 sleep 1                     ;# Wait for CSSF to clear
127         }
128
129         # If the clock security system fired, it will pend an NMI. A pending NMI
130         # will cause a bad time for any subsequent executing code, such as a
131         # programming algorithm.
132         if {[mrw 0xE000ED04] & 0x80000000} {
133                 # ICSR.NMIPENDSET reads as 1. Need to clear it. A pending NMI can’t be
134                 # cleared by any normal means (such as ICSR or NVIC). It can only be
135                 # cleared by entering the NMI handler or by resetting the processor.
136                 echo "[target current]: Clock security system generated NMI. Clearing."
137
138                 # Keep the old DEMCR value.
139                 set old [mrw 0xE000EDFC]
140
141                 # Enable vector catch on reset.
142                 mww 0xE000EDFC 0x01000001
143
144                 # Issue local reset via AIRCR.
145                 mww 0xE000ED0C 0x05FA0001
146
147                 # Restore old DEMCR value.
148                 mww 0xE000EDFC $old
149         }
150
151         # Configure PLL to boost clock to HSI x 10 (160 MHz)
152         mww 0x40023804 0x08002808   ;# RCC_PLLCFGR 16 Mhz /10 (M) * 128 (N) /2(P)
153         mww 0x40023C00 0x00000107   ;# FLASH_ACR = PRFTBE | 7(Latency)
154         mmw 0x40023800 0x01000000 0 ;# RCC_CR |= PLLON
155         sleep 10                    ;# Wait for PLL to lock
156         mww 0x40023808 0x00009400   ;# RCC_CFGR_PPRE1 = 5(div 4), PPRE2 = 4(div 2)
157         mmw 0x40023808 0x00000002 0 ;# RCC_CFGR |= RCC_CFGR_SW_PLL
158
159         # Boost SWD frequency
160         # Do not boost JTAG frequency and slow down JTAG memory access or flash write algo
161         # suffers from DAP WAITs
162         if {[using_jtag]} {
163                 [[target current] cget -dap] memaccess 16
164         } {
165                 adapter speed 8000
166         }
167 }
168
169 $_TARGETNAME configure -event reset-start {
170         # Reduce speed since CPU speed will slow down to 16MHz with the reset
171         adapter speed 2000
172 }