tcl/target: add SPDX tag
[fw/openocd] / tcl / target / kx.cfg
1 # SPDX-License-Identifier: GPL-2.0-or-later
2
3 #
4 # NXP (former Freescale) Kinetis Kx series devices
5 # Also used for Cortex-M4 equipped members of KVx and KE1xF series
6 #
7
8 source [find target/swj-dp.tcl]
9
10 if { [info exists CHIPNAME] } {
11     set _CHIPNAME $CHIPNAME
12 } else {
13     set _CHIPNAME kx
14 }
15
16 # Work-area is a space in RAM used for flash programming
17 # By default use 4kB
18 if { [info exists WORKAREASIZE] } {
19    set _WORKAREASIZE $WORKAREASIZE
20 } else {
21    set _WORKAREASIZE 0x1000
22 }
23
24 if { [info exists CPUTAPID] } {
25     set _CPUTAPID $CPUTAPID
26 } else {
27    if { [using_jtag] } {
28       set _CPUTAPID 0x4ba00477
29    } {
30       set _CPUTAPID 0x2ba01477
31    }
32 }
33
34 swj_newdap $_CHIPNAME cpu -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id $_CPUTAPID
35 dap create $_CHIPNAME.dap -chain-position $_CHIPNAME.cpu
36
37 set _TARGETNAME $_CHIPNAME.cpu
38 target create $_TARGETNAME cortex_m -dap $_CHIPNAME.dap
39
40 $_TARGETNAME configure -work-area-phys 0x20000000 -work-area-size $_WORKAREASIZE -work-area-backup 0
41
42 set _FLASHNAME $_CHIPNAME.pflash
43 flash bank $_FLASHNAME kinetis 0 0 0 0 $_TARGETNAME
44 kinetis create_banks
45
46 adapter speed 1000
47
48 reset_config srst_nogate
49
50 if {[using_hla]} {
51    echo ""
52    echo "!!!!!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!"
53    echo " Kinetis MCUs have a MDM-AP dedicated mainly to MCU security related functions."
54    echo " A high level adapter (like a ST-Link) you are currently using cannot access"
55    echo " the MDM-AP, so commands like 'mdm mass_erase' are not available in your"
56    echo " configuration. Also security locked state of the device will not be reported."
57    echo " Expect problems connecting to a blank device without boot ROM."
58    echo ""
59    echo " Be very careful as you can lock the device though there is no way to unlock"
60    echo " it without mass erase. Don't set write protection on the first block."
61    echo "!!!!!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!"
62    echo ""
63 } else {
64    # Detect secured MCU or boot lock-up in RESET/WDOG loop
65    $_TARGETNAME configure -event examine-fail {
66       kinetis mdm check_security
67    }
68    # During RESET/WDOG loop the target is sometimes falsely examined
69    $_TARGETNAME configure -event examine-end {
70       kinetis mdm check_security
71    }
72
73    # if srst is not fitted use SYSRESETREQ to
74    # perform a soft reset
75    cortex_m reset_config sysresetreq
76 }
77
78 # Disable watchdog not to disturb OpenOCD algorithms running on MCU
79 # (e.g. armv7m_checksum_memory() in verify_image)
80 # Flash driver also disables watchdog before FTFA flash programming.
81 $_TARGETNAME configure -event reset-init {
82    kinetis disable_wdog
83 }