Fixes for the test-app and configuration.

Author: dgarske

config/examples/nxp-s32k142.config

@@ -8,31 +8,26 @@
 
 ARCH?=ARM
 CORTEX_M4?=1
+NO_MPU=1
 TARGET?=s32k1xx
 SIGN?=ECC256
 HASH?=SHA256
-DEBUG?=0
 VTOR?=1
 NO_ASM?=0
 EXT_FLASH?=0
 SPI_FLASH?=0
 ALLOW_DOWNGRADE?=0
-NVM_FLASH_WRITEONCE?=0
+
+# S32K1xx flash requires erase before write (cannot re-program same location)
+# This is required for sector swap trailer flag updates to work correctly
+NVM_FLASH_WRITEONCE?=1
+
 WOLFBOOT_VERSION?=0
 V?=0
 SPMATH?=1
 RAM_CODE?=1
 DUALBANK_SWAP?=0
 
-# Disable MPU (S32K1xx MPU configuration needs customization)
-WOLFBOOT_NO_MPU?=1
-
-# Enable hardfault debugging
-DEBUG_HARDFAULT?=0
-
-# Debug UART on LPUART1 (PTC6=RX, PTC7=TX)
-DEBUG_UART?=0
-
 # 2KB sectors (S32K142 only - larger variants use 4KB sectors)
 WOLFBOOT_SECTOR_SIZE?=0x800
 
@@ -51,4 +46,10 @@ WOLFBOOT_PARTITION_SWAP_ADDRESS?=0x3E000
 #CFLAGS_EXTRA+=-DS32K1XX_CLOCK_HSRUN
 
 # Optionally enable watchdog
-#CFLAGS_EXTRA+=-DWATCHDOG
+#CFLAGS_EXTRA+=-DWATCHDOG
+
+# Debugging options (uncomment as needed)
+DEBUG?=0
+DEBUG_SYMBOLS?=0
+DEBUG_UART?=0
+#CFLAGS_EXTRA+=-DDEBUG_HARDFAULT

config/examples/nxp-s32k144.config

@@ -8,16 +8,20 @@
 
 ARCH?=ARM
 CORTEX_M4?=1
+NO_MPU=1
 TARGET?=s32k1xx
 SIGN?=ECC256
 HASH?=SHA256
-DEBUG?=0
 VTOR?=1
 NO_ASM?=0
 EXT_FLASH?=0
 SPI_FLASH?=0
 ALLOW_DOWNGRADE?=0
-NVM_FLASH_WRITEONCE?=0
+
+# S32K1xx flash requires erase before write (cannot re-program same location)
+# This is required for sector swap trailer flag updates to work correctly
+NVM_FLASH_WRITEONCE?=1
+
 WOLFBOOT_VERSION?=0
 V?=0
 SPMATH?=1
@@ -27,15 +31,6 @@ DUALBANK_SWAP?=0
 # Select S32K144 variant for correct flash size and sector size
 CFLAGS_EXTRA+=-DS32K144
 
-# Disable MPU (S32K1xx MPU configuration needs customization)
-WOLFBOOT_NO_MPU?=1
-
-# Enable hardfault debugging
-#CFLAGS_EXTRA+=-DDEBUG_HARDFAULT
-
-# Debug UART on LPUART1 (PTC6=RX, PTC7=TX)
-DEBUG_UART?=0
-
 # 4KB sectors (S32K144/146/148 with 512KB+ flash)
 WOLFBOOT_SECTOR_SIZE?=0x1000
 
@@ -55,3 +50,9 @@ WOLFBOOT_PARTITION_SWAP_ADDRESS?=0x7C000
 
 # Optionally enable watchdog
 #CFLAGS_EXTRA+=-DWATCHDOG
+
+# Debugging options (uncomment as needed)
+DEBUG?=0
+DEBUG_SYMBOLS?=0
+DEBUG_UART?=0
+#CFLAGS_EXTRA+=-DDEBUG_HARDFAULT

config/examples/nxp-s32k146.config

@@ -8,16 +8,20 @@
 
 ARCH?=ARM
 CORTEX_M4?=1
+NO_MPU=1
 TARGET?=s32k1xx
 SIGN?=ECC256
 HASH?=SHA256
-DEBUG?=0
 VTOR?=1
 NO_ASM?=0
 EXT_FLASH?=0
 SPI_FLASH?=0
 ALLOW_DOWNGRADE?=0
-NVM_FLASH_WRITEONCE?=0
+
+# S32K1xx flash requires erase before write (cannot re-program same location)
+# This is required for sector swap trailer flag updates to work correctly
+NVM_FLASH_WRITEONCE?=1
+
 WOLFBOOT_VERSION?=0
 V?=0
 SPMATH?=1
@@ -27,15 +31,6 @@ DUALBANK_SWAP?=0
 # Select S32K146 variant for correct flash size and sector size
 CFLAGS_EXTRA+=-DS32K146
 
-# Disable MPU (S32K1xx MPU configuration needs customization)
-WOLFBOOT_NO_MPU?=1
-
-# Enable hardfault debugging
-#CFLAGS_EXTRA+=-DDEBUG_HARDFAULT
-
-# Debug UART on LPUART1 (PTC6=RX, PTC7=TX)
-DEBUG_UART?=0
-
 # 4KB sectors (S32K144/146/148 with 512KB+ flash)
 WOLFBOOT_SECTOR_SIZE?=0x1000
 
@@ -55,3 +50,9 @@ WOLFBOOT_PARTITION_SWAP_ADDRESS?=0xF4000
 
 # Optionally enable watchdog
 #CFLAGS_EXTRA+=-DWATCHDOG
+
+# Debugging options (uncomment as needed)
+DEBUG?=0
+DEBUG_SYMBOLS?=0
+DEBUG_UART?=0
+#CFLAGS_EXTRA+=-DDEBUG_HARDFAULT

config/examples/nxp-s32k148.config

@@ -8,16 +8,20 @@
 
 ARCH?=ARM
 CORTEX_M4?=1
+NO_MPU=1
 TARGET?=s32k1xx
 SIGN?=ECC256
 HASH?=SHA256
-DEBUG?=0
 VTOR?=1
 NO_ASM?=0
 EXT_FLASH?=0
 SPI_FLASH?=0
 ALLOW_DOWNGRADE?=0
-NVM_FLASH_WRITEONCE?=0
+
+# S32K1xx flash requires erase before write (cannot re-program same location)
+# This is required for sector swap trailer flag updates to work correctly
+NVM_FLASH_WRITEONCE?=1
+
 WOLFBOOT_VERSION?=0
 V?=0
 SPMATH?=1
@@ -27,15 +31,6 @@ DUALBANK_SWAP?=0
 # Select S32K148 variant for correct flash size and sector size
 CFLAGS_EXTRA+=-DS32K148
 
-# Disable MPU (S32K1xx MPU configuration needs customization)
-WOLFBOOT_NO_MPU?=1
-
-# Enable hardfault debugging
-#CFLAGS_EXTRA+=-DDEBUG_HARDFAULT
-
-# Debug UART on LPUART1 (PTC6=RX, PTC7=TX)
-DEBUG_UART?=0
-
 # 4KB sectors (S32K144/146/148 with 512KB+ flash)
 WOLFBOOT_SECTOR_SIZE?=0x1000
 
@@ -55,3 +50,9 @@ WOLFBOOT_PARTITION_SWAP_ADDRESS?=0x1EC000
 
 # Optionally enable watchdog
 #CFLAGS_EXTRA+=-DWATCHDOG
+
+# Debugging options (uncomment as needed)
+DEBUG?=0
+DEBUG_SYMBOLS?=0
+DEBUG_UART?=0
+#CFLAGS_EXTRA+=-DDEBUG_HARDFAULT

docs/Targets.md

@@ -2880,12 +2880,15 @@ The following build options are available for the S32K1xx HAL:
 
 | Option | Description |
 |--------|-------------|
+| `NVM_FLASH_WRITEONCE` | **Required for S32K1xx.** Flash can only be written once between erases. Enables proper sector swap trailer management. |
+| `RAM_CODE` | **Required for S32K1xx.** Run flash operations from RAM (no read-while-write on same block). |
 | `WOLFBOOT_RESTORE_CLOCK` | Restore clock to SIRC (8 MHz) before booting application. Recommended for applications that configure their own clocks. |
 | `WOLFBOOT_DISABLE_WATCHDOG_ON_BOOT` | Keep watchdog disabled when jumping to application. By default, the watchdog is re-enabled before boot since it is enabled out of reset. |
 | `WATCHDOG` | Enable watchdog during wolfBoot operation. Recommended for production. |
 | `WATCHDOG_TIMEOUT_MS` | Watchdog timeout in milliseconds when `WATCHDOG` is enabled (default: 1000ms). |
 | `S32K1XX_CLOCK_HSRUN` | Enable HSRUN mode (112 MHz). Requires external crystal and SPLL (not fully implemented). |
 | `DEBUG_UART` | Enable LPUART1 debug output. |
+| `DEBUG_HARDFAULT` | Enable detailed hard fault debugging output. |
 | `S32K144`, `S32K146`, `S32K148` | Select variant (default is S32K142). Affects flash/SRAM size definitions. |
 
 **IMPORTANT:** Flash sector size depends on the S32K variant:
@@ -2948,6 +2951,41 @@ cp factory.srec /media/<user>/S32K142EVB/
 
 The board will automatically program the flash and reset.
 
+### NXP S32K1XX: Flash Script
+
+A convenience script is provided for building and flashing S32K142:
+
+```sh
+./tools/scripts/nxp-s32k142-flash.sh [OPTIONS]
+```
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| (none) | Build and flash `factory.srec` (v1 only) |
+| `--test-update` | Build with v2 in update partition (use `trigger` command to start update) |
+| `--update` | Build with v2 and auto-trigger (starts update on boot) |
+| `--skip-build` | Skip build, use existing `.srec` file |
+| `--skip-flash` | Skip flashing (just build) |
+| `--skip-uart` | Skip UART monitoring |
+| `--uart-only` | Only monitor UART (no build/flash) |
+| `--interactive` | Keep UART open until Ctrl+C |
+| `--timeout SECS` | UART capture duration (default: 5s) |
+
+**Examples:**
+
+```sh
+# Build and flash factory image, monitor UART for 5 seconds
+./tools/scripts/nxp-s32k142-flash.sh
+
+# Build with v2 update, flash, and stay on UART
+./tools/scripts/nxp-s32k142-flash.sh --test-update --interactive
+
+# Just monitor UART
+./tools/scripts/nxp-s32k142-flash.sh --uart-only --interactive
+```
+
 ### NXP S32K1XX: Test Application
 
 The S32K1xx test application (`test-app/app_s32k1xx.c`) provides a feature-rich demo application for testing wolfBoot functionality.
@@ -2963,12 +3001,14 @@ The S32K1xx test application (`test-app/app_s32k1xx.c`) provides a feature-rich
 
 | Command | Description |
 |---------|-------------|
-| `help` or `?` | Show available commands |
-| `info` | Display system and partition information |
+| `help` | Show available commands |
+| `info` | Display partition and keystore information |
+| `status` | Show partition versions and states |
 | `success` | Mark current firmware as successful (wolfBoot_success) |
-| `update` | Trigger firmware update (wolfBoot_update_trigger) |
-| `reset` | Perform software reset |
-| `xmodem` | Receive firmware image via XMODEM protocol |
+| `trigger` | Set update flag if update image is in flash |
+| `update` | Receive firmware via XMODEM and trigger update |
+| `timestamp` | Show current system time (ms) |
+| `reboot` | Perform software reset |
 
 **UART Configuration:**
 - LPUART1: PTC7 (TX), PTC6 (RX)
@@ -2984,23 +3024,32 @@ Copyright 2025 wolfSSL Inc.
 Firmware Version: 1
 
 === Partition Information ===
-Boot Partition:
-  Address: 0x0000C000
+Boot Partition @ 0xC000:
   Version: 1
-  State:   SUCCESS
-Update Partition:
-  Address: 0x00025000
-  Version: 0
-  State:   SUCCESS
-Swap Partition:
-  Address: 0x0003E000
-  Size:    2048 bytes
+  State: SUCCESS (0x00)
+Update Partition @ 0x25000:
+  Version: 0 (empty)
+  State: (no trailer)
+
+=== Keystore Information ===
+Number of keys: 1
+Key 0: ECDSA P-256 (secp256r1), SHA-256
 
 Type 'help' for available commands.
 
 cmd>
 ```
 
+**Testing Firmware Update:**
+
+1. Flash with v2 image: `./tools/scripts/nxp-s32k142-flash.sh --test-update`
+2. Connect to UART: `picocom -b 115200 /dev/ttyACM1`
+3. Run `status` to verify v1 in boot, v2 in update
+4. Run `trigger` to set update flag
+5. Run `reboot` to start update
+6. After reboot, LED changes from Green (v1) to Blue (v2)
+7. Run `success` to mark v2 as good
+
 ### NXP S32K1XX: Flash Configuration Field (FCF)
 
 The bootloader includes the Flash Configuration Field (FCF) at address 0x400-0x40F with the following settings:
@@ -3043,6 +3092,10 @@ Then power cycle the board.
 
 The following features are planned or available for contribution:
 
+- [x] **Sector swap update**: Full firmware update with sector swapping (completed)
+- [x] **Interactive test application**: Console with status, trigger, success commands (completed)
+- [x] **Flash automation script**: `tools/scripts/nxp-s32k142-flash.sh` (completed)
+- [ ] **XMODEM improvements**: ISR-based UART RX for reliable high-speed transfers
 - [ ] **SPLL + SOSC support**: Add external crystal oscillator and SPLL configuration for true 112 MHz operation in HSRUN mode
 - [ ] **Hardware crypto acceleration**: Integrate CSEc (Cryptographic Services Engine) for hardware-accelerated crypto operations
 - [ ] **FlexNVM/EEPROM support**: Add support for FlexNVM partitioning and EEPROM emulation