; -------------------------------------------------------------------------------- ; @Title: Generic script for Freescale MKW20,MKW21,MKW22 and MKW24 internal flash ; ; @Description: ; Flash declaration of NXP MKW20Z/MKW21Z/MKW21D/MKW22D/MKW24D internal flash. ; Script arguments: ; DO mkw20 [PREPAREONLY] [CPU=] [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/mkw20 CPU=MKW21D256VHA5 PREPAREONLY ; ; List of MKW21/MKW22/MKW24 derivatives and their configuration: ; CPU-Type ProgFlash FlexNVM EEPROM RamSize ; [Byte] [Byte] [Byte] [Byte] ; -------------------------------------------------------------------------------- ; MKW20Z160VHT4 160KB - - 20KB ; MKW20Z160VHT4R 160KB - - 20KB ; MKW21Z512VHT4 512KB - - 128KB ; MKW21Z512VHT4R 512KB - - 128KB ; MKW21Z256VHT4 256KB - - 64KB ; MKW21Z256VHT4R 256KB - - 64KB ; MKW21D256VHA5 256KB 64KB - 32KB ; MKW21D256VHA5R 256KB 64KB - 32KB ; MKW21D512VHA5 512KB - - 32KB ; MKW22D512VHA5 512KB - - 64KB ; MKW24D512VHA5 512KB - - 64KB ; ; Flash Configuration Field: ; ; Byte address 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). ; ; Flash Configuration Field can be programmed using FLASH.AUTO command ; with /CENSORSHIP option. ; ; @Author: FLC ; @Copyright: (C) 1989-2022 Lauterbach GmbH, licensed for use with TRACE32(R) only ; -------------------------------------------------------------------------------- ; $Rev: 12738 $ ; $Id: mkw20.cmm 12738 2023-11-17 07:36:34Z mschaeffner $ ; PRIVATE ¶meters ENTRY %LINE ¶meters PRIVATE ¶m_cpu ¶m_prepareonly ¶m_masserase ¶m_dualport ¶m_prepareonly=(STRing.SCAN(STRing.UPpeR("¶meters"),"PREPAREONLY",0)!=-1) ¶m_masserase=(STRing.SCAN(STRing.UPpeR("¶meters"),"MASSERASE",0)!=-1) ¶m_cpu=STRing.SCANAndExtract(STRing.UPpeR("¶meters"),"CPU=","") ¶m_dualport=STRing.SCANAndExtract(STRing.UPpeR("¶meters"),"DUALPORT=","1") ; -------------------------------------------------------------------------------- ; Initialize and start the debugger IF !SYStem.Up()||¶m_masserase ( SYStem.RESet IF "¶m_cpu"!="" SYStem.CPU ¶m_cpu IF !CPUIS(MKW2*) SYStem.CPU MKW2* SYStem.CONFIG.DEBUGPORTTYPE SWD IF ¶m_masserase GOSUB MassErase SYStem.Up ; Unsecure device IF (Data.Long(EDBG:0x40000100)&0x04)==0x04 GOSUB Unsecure ; Disable watchdog ON.ERROR GOSUB Unsecure GOSUB DisableWatchdog ON.ERROR ) ; -------------------------------------------------------------------------------- ; Flash declaration FLASH.RESet GOSUB FlashDeclaration "¶m_dualport" ; Flash script ends here if called with parameter PREPAREONLY IF ¶m_prepareonly ENDDO PREPAREDONE ; ------------------------------------------------------------------------------ ; Flash programming 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 ; Reset device ; Data.Set 0x400--0x40F %Byte SYStem.Down ; Data.LOAD.auto 0x400--0x40F SYStem.Up ; FLASH.AUTO OFF ; Reset device SYStem.Down SYStem.Up GOSUB DisableWatchdog ) ENDDO ; -------------------------------------------------------------------------------- ; Disable watchdog DisableWatchdog: ( PRIVATE &tmp1 &tmp2 IF CPUIS("MKW2?Z*") ( Data.Set SD:0x40048100 %Long 0 ; this register can only be accessed once after reset. ) ELSE ( &tmp1=Data.Long(ST:0x20000000) &tmp2=Data.Long(ST:0x20000004) ; 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() 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 ) ; -------------------------------------------------------------------------------- ; Try to mass erase the device MassErase: ( ; Mass erase device by unsecure command SYStem.Down FLASH.UNSECUREerase SYStem.Mode.Prepare IF (Data.Long(EDBG:0x40000100)&0x24)!=0x20 ( PRINT %ERROR "Mass erase failed, MDM-AP Status Register is 0x" Data.Long(EDBG:0x40000100) SYStem.Down ENDDO ) RETURN ) ; -------------------------------------------------------------------------------- ; Flash declaration depending on selected CPU FlashDeclaration: ;(param_dualport) ( PARAMETERS ¶m_dualport PRIVATE &PFlashSize &FlexNVMSize &PSectorSize &DSectorSize &flashdriver &FlexNVMSize=0x0 &DSectorSize=0x0 &flashdriver="t.b.d." ; Setup configuration values IF CPUIS("MKW21D256*") ( &PFlashSize=0x40000 &PSectorSize=0x800 &FlexNVMSize=0x10000 &DSectorSize=0x800 &flashdriver="ftfl4x.bin" ) ELSE IF CPUIS("MKW21D512*") ( &PFlashSize=0x80000 &PSectorSize=0x800 &flashdriver="ftfl4n.bin" ) ELSE IF CPUIS("MKW22D512*") ( &PFlashSize=0x80000 &PSectorSize=0x800 &flashdriver="ftfl4n.bin" ) ELSE IF CPUIS("MKW24D512*") ( &PFlashSize=0x80000 &PSectorSize=0x800 &flashdriver="ftfl4n.bin" ) ELSE IF CPUIS("MKW20Z*") ( &PFlashSize=0x28000 &PSectorSize=0x400 &flashdriver="ftfa.bin" ) ELSE IF CPUIS("MKW21Z256*") ( &PSectorSize=0x800 &PFlashSize=0x40000 &flashdriver="ftfa1n.bin" ) ELSE IF CPUIS("MKW21Z512*") ( &PSectorSize=0x800 &PFlashSize=0x80000 &flashdriver="ftfa1n.bin" ) ELSE ( PRINT %ERROR "FLASH size of CPU type is not supported by the script" ENDDO ) ; Program Flash FLASH.Create 1. 0x00000000++(&PFlashSize-0x1) &PSectorSize TARGET Long /CENSORSHIP 0x400--0x40F ; FlexNVM IF &FlexNVMSize>=0x8000 FLASH.Create 2. 0x10000000--0x10007FFF &DSectorSize TARGET Long IF &FlexNVMSize>=0x10000 FLASH.Create 2. 0x10008000--0x1000FFFF &DSectorSize TARGET Long IF &FlexNVMSize>=0x20000 FLASH.Create 2. 0x10010000--0x1001FFFF &DSectorSize TARGET Long IF &FlexNVMSize>=0x40000 FLASH.Create 2. 0x10020000--0x1003FFFF &DSectorSize TARGET Long IF (("¶m_dualport"!="1")||SYStem.ACCESS.DENIED()) FLASH.TARGET 0x1FFFF000 0x20000000 &PSectorSize ~~/demo/arm/flash/long/&flashdriver ELSE FLASH.TARGET 0x1FFFF000 E:0x20000000 &PSectorSize ~~/demo/arm/flash/long/&flashdriver /DualPort RETURN )