tcl/target: add SPDX tag
[fw/openocd] / tcl / target / klx.cfg
1 # SPDX-License-Identifier: GPL-2.0-or-later
2
3 #
4 # NXP (former Freescale) Kinetis KL series devices
5 # Also used for Cortex-M0+ equipped members of KVx and KE1xZ 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 klx
14 }
15
16 # Work-area is a space in RAM used for flash programming
17 # By default use 1KiB
18 if { [info exists WORKAREASIZE] } {
19    set _WORKAREASIZE $WORKAREASIZE
20 } else {
21    set _WORKAREASIZE 0x400
22 }
23
24 if { [info exists CPUTAPID] } {
25     set _CPUTAPID $CPUTAPID
26 } else {
27     set _CPUTAPID 0x0bc11477
28 }
29
30 swj_newdap $_CHIPNAME cpu -irlen 4 -expected-id $_CPUTAPID
31 dap create $_CHIPNAME.dap -chain-position $_CHIPNAME.cpu
32
33 set _TARGETNAME $_CHIPNAME.cpu
34 target create $_TARGETNAME cortex_m -dap $_CHIPNAME.dap
35
36 $_TARGETNAME configure -work-area-phys 0x20000000 -work-area-size $_WORKAREASIZE -work-area-backup 0
37
38 set _FLASHNAME $_CHIPNAME.pflash
39 flash bank $_FLASHNAME kinetis 0 0 0 0 $_TARGETNAME
40 kinetis create_banks
41
42 # Table 5-1. Clock Summary of KL25 Sub-Family Reference Manual
43 # specifies up to 1MHz for VLPR mode and up to 24MHz for run mode;
44 # Table 17 of Sub-Family Data Sheet rev4 lists 25MHz as the maximum frequency.
45 adapter speed 1000
46
47 reset_config srst_nogate
48
49 if {[using_hla]} {
50    echo ""
51    echo "!!!!!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!"
52    echo " Kinetis MCUs have a MDM-AP dedicated mainly to MCU security related functions."
53    echo " A high level adapter (like a ST-Link) you are currently using cannot access"
54    echo " the MDM-AP, so commands like 'mdm mass_erase' are not available in your"
55    echo " configuration. Also security locked state of the device will not be reported."
56    echo ""
57    echo " Be very careful as you can lock the device though there is no way to unlock"
58    echo " it without mass erase. Don't set write protection on the first block."
59    echo "!!!!!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!"
60    echo ""
61 } else {
62    # Detect secured MCU
63    $_TARGETNAME configure -event examine-fail {
64       kinetis mdm check_security
65    }
66
67    # if srst is not fitted use SYSRESETREQ to
68    # perform a soft reset
69    cortex_m reset_config sysresetreq
70 }
71
72 # Disable watchdog not to disturb OpenOCD algorithms running on MCU
73 # (e.g. armv7m_checksum_memory() in verify_image)
74 # Flash driver also disables watchdog before FTFA flash programming.
75 $_TARGETNAME configure -event reset-init {
76    kinetis disable_wdog
77 }