; -------------------------------------------------------------------------------- ; @Title: Flash declaration for NXP MKL8?Z128VLK7 internal flash ; @Description: ; Script arguments: ; DO mkl80 [PREPAREONLY] [CPU=] [DUALPORT=<0|1>] [MASSERASE] ; PREPAREONLY only declares flash but does not execute flash programming ; CPU= selects CPU derivative ; DUALPORT=<0|1> use dual port memory access, default 1 ; MASSERASE forces mass erase of device before establishing debug ; connection ; Example: ; DO ~~/demo/arm/flash/mkl80 PREPAREONLY ; Note: ; This file must NOT be modified. ; This file is intended to stay within TRACE32 installation. ; Usage examples are available in the ~~/demo/arm/hardware/... subdirectories. ; ; List of MKL8?Z128VLK7 derivatives and their configuration: ; CPU-Type ProgFlash RamSize ; [Byte] [Byte] ; -------------------------------------------------------------------------------- ; MKL81Z128CBH7R 128kB 96kB ; MKL81Z128VLK7 128kB 96kB ; MKL81Z128VMC7 128kB 96kB ; MKL81Z128VMC7R 128kB 96kB ; -------------------------------------------------------------------------------- ; MKL82Z128VLK7 128kB 96kB ; MKL82Z128VLK7R 128kB 96kB ; MKL82Z128VMC7 128kB 96kB ; ; The range 0x400--0x40f is guarded against modification. ; Address-Range Width Description ; -------------------------------------------------------------------------------- ; 0x0400--0x0407 8 Backdoor Comparison Key. ; 0x0408--0x040B 4 Program flash protection bytes (FPROT0-3). ; 0x040F 1 Program flash only devices: Reserved ; FlexNVM devices: Data flash protection byte ; (FDPROT). ; 0x040E 1 Program flash only devices: Reserved ; FlexNVM devices: EEPROM protection byte ; (FEPROT). ; 0x040D 1 Flash nonvolatile option byte (FOPT). ; 0x040C 1 Flash security byte (FSEC). ; ; Modifications can be done using the FLASH.AUTO command with /CENSORSHIP option. ; ; @Chip: MKL81* MKL82* ; @Author: PHI ; @Copyright: (C) 1989-2022 Lauterbach GmbH, licensed for use with TRACE32(R) only ; -------------------------------------------------------------------------------- ; $Rev: 10516 $ ; $Id: mkl80.cmm 10516 2022-02-02 11:39:30Z bschroefel $ ; PRIVATE ¶meters ENTRY %LINE ¶meters PRIVATE ¶m_prepareonly ¶m_cpu ¶m_dualport ¶m_masserase ¶meters=STRing.UPpeR("¶meters") ¶m_prepareonly=(STRing.SCAN("¶meters","PREPAREONLY",0)!=-1) ¶m_cpu=STRing.SCANAndExtract("¶meters","CPU=","") ¶m_dualport=STRing.SCANAndExtract("¶meters","DUALPORT=","1") ¶m_masserase=(STRing.SCAN("¶meters","MASSERASE",0)!=-1) ; -------------------------------------------------------------------------------- ; Initialize and start the debugger IF !SYStem.Up()||¶m_masserase ( SYStem.RESet IF "¶m_cpu"!="" SYStem.CPU ¶m_cpu IF !CPUIS(MKL8*) SYStem.CPU MKL8* SYStem.MemAccess DAP SYStem.CONFIG DEBUGPORTTYPE SWD IF ¶m_masserase GOSUB Unsecure SYStem.Up GOSUB DisableWatchdog ) ; -------------------------------------------------------------------------------- ; Flash declaration FLASH.RESet GOSUB FlashDeclaration "¶m_dualport" ; Flash script ends here if called with parameter PREPAREONLY IF ¶m_prepareonly ENDDO PREPAREDONE ; -------------------------------------------------------------------------------- ; Flash programming example DIALOG.YESNO "Program flash memory?" PRIVATE &progflash ENTRY &progflash IF &progflash ( FLASH.ReProgram.ALL /Erase Data.LOAD.auto * FLASH.ReProgram.off ; Example to modify Censorship range ; FLASH.AUTO 0x400--0x40f /CENSORSHIP ; Data.Set 0x400--0x40f %Byte ; Data.LOAD.auto 0x400--0x40f ; FLASH.AUTO OFF ; Reset device SYStem.Down SYStem.Up ; Disable watchdog GOSUB DisableWatchdog ) ENDDO ; -------------------------------------------------------------------------------- ; SUBROUTINES ; -------------------------------------------------------------------------------- ; Flash declaration depending on selected CPU ; ; Please do NOT modify the TRACE32 flash declaration. ; ; Modifications can result in unpredictable behavior. ; Please contact support@lauterbach.com for any changes. FlashDeclaration: ;(param_dualport) ( PARAMETERS ¶m_dualport PRIVATE &PFlashSize ; Setup configuration values IF CPUIS("MKL8?Z128V*") &PFlashSize=0x20000 ELSE ( PRINT %ERROR "FLASH size of CPU type is not supported by the script" ENDDO ) ; Program Flash IF &PFlashSize>=0x20000 FLASH.Create 1. 0x00000000--0x0001FFFF 0x800 TARGET Long /CENSORSHIP 0x400--0x40F IF (("¶m_dualport"!="1")||SYStem.ACCESS.DENIED()) FLASH.TARGET 0x1FFFF000 0x20000000 0x800 ~~/demo/arm/flash/long/ftfa.bin ELSE FLASH.TARGET 0x1FFFF000 E:0x20000000 0x800 ~~/demo/arm/flash/long/ftfa.bin /DualPort RETURN ) ; -------------------------------------------------------------------------------- ; Disable watchdog DisableWatchdog: ( ; disable the Watchdog PRIVATE &tmp1 &tmp2 &tmp1=Data.Long(ST:0x20000000) &tmp2=Data.Long(ST:0x20000004) Register.SWAP ; The watchdog has a restrictive timing. It has to be configured and unlocked within a peripod ; of 20+256 cycles. Therefor the unlock sequence need to be done by a small target program. Data.Assemble ST:0x20000000 strh r1,[r0] ;SD:0x4005200E = 0xC520 (Key 1) Data.Assemble , strh r2,[r0] ;SD:0x4005200E = 0xD928 (Key 2) Data.Assemble , strh r4,[r3] ;SD:0x40052000 = 0x0000 (Config register) Data.Assemble , bkpt #0 Register.Set PC 0x20000000 Register.Set R0 0x4005200E Register.Set R1 0xC520 Register.Set R2 0xD928 Register.Set R3 0x40052000 Register.Set R4 0x0 Go.direct WAIT !STATE.RUN() Register.SWAP Data.Set ST:0x20000000 %Long &tmp1 Data.Set ST:0x20000004 %Long &tmp2 RETURN ) ; -------------------------------------------------------------------------------- ; Try to unsecure a secured device Unsecure: ( ; Print security state information SYStem.Mode.Prepare PRINT "MDM-AP Status Register is 0x" Data.Long(EDBG:0x40000100) DIALOG.YESNO "Execute mass erase to unsecure chip?" PRIVATE &masserase ENTRY &masserase IF &masserase ( ON.ERROR DEFault ; Unsecure device SYStem.Down FLASH.UNSECUREerase SYStem.Mode.Prepare IF (Data.Long(EDBG:0x40000100)&0x04)==0x04 ( PRINT %ERROR "Unsecure failed, MDM-AP Status Register is 0x" Data.Long(EDBG:0x40000100) SYStem.Down ENDDO ) ) ELSE ENDDO SYStem.Up ; Disable watchdog GOSUB DisableWatchdog RETURN )