Matter NXP MCXW72 Applications Guide

Matter NXP MCXW72 Applications Guide#

Introduction#

The Matter MCXW72 example applications provide a working demonstration of the MCXW72 board integration, built using the Project CHIP codebase and the NXP MCUX SDK.

Supported configurations#

The examples support:

  • Matter over Openthread

Supported build systems#

MCXW72 platform supports two different build systems to generate the application :

  • GN (contact-sensor application only)

  • CMake

Building#

Make sure to follow shared build instructions from CHIP NXP Examples Guide for FreeRTOS platforms to set-up your environment.

In the following steps, the “lighting-app” is used as an example.

CMake Build System#

The examples support configuration and build using the CMake build system. You can find more information in CMake Build System section which explains how to further configure your application build.

In the west build command, the board option should be replaced with frdmmcxw72. The build option -DCONFIG_MCUX_COMPONENT_middleware.freertos-kernel.config=n must be used in the build command line for the MCXW72 platform. Also, the core_id should be set to cm33_core0.

Example of build command to build the Lighting app with Matter-over-Thread (FTD device type) configuration on MCXW72 platform :

user@ubuntu:~/Desktop/git/connectedhomeip$ west build -d bin/lighting-app/ftd -b frdmmcxw72 examples/lighting-app/nxp -Dcore_id=cm33_core0 -DCONF_FILE_NAME=prj_thread_ftd.conf -DCONFIG_MCUX_COMPONENT_middleware.freertos-kernel.config=n

Note that the MCXW72 examples support various configurations that can be provided to the CONF_FILE_NAME variable, you can refer to the table of available project configuration files and platform compatibility to check all the supported configurations.

GN Build System#

Building with Matter over Thread configuration on MCXW72#

  • Build Matter-over-Thread configuration with BLE commissioning.

user@ubuntu:~/Desktop/git/connectedhomeip/examples/contact-sensor-app/nxp/mcxw72$ gn gen out/debug
user@ubuntu:~/Desktop/git/connectedhomeip/examples/contact-sensor-app/nxp/mcxw72$ ninja -C out/debug

General information#

The resulting application can be found in out/debug/chip-mcxw72-contact-example.

Additional GN options can be added when building the application. You can check Common GN options to FreeRTOS platforms for the full list.

Manufacturing data#

See Guide for writing manufacturing data on NXP devices

Flashing and debugging#

Flashing the NBU firmware#

Normally the NBU image should be written/updated only when migrating to a new NXP SDK or to a new Matter release altogether. The procedure below can be used to upload/refresh the board’s NBU firmware.

  1. Install NXP LinkServer for Microcontrollers.

  2. The NBU image is available in your Matter source code tree in

third_party/nxp/nxp_matter_support/github_sdk/sdk_next/repo/mcuxsdk/middleware/wireless/ieee-802.15.4/bin/mcxw72/mcxw72_nbu_ble_full_15_4_dyn.bin

  1. Initialize the board in ISP (In-System Programming) mode, which allows the SoC to accept commands to erase/write/update internal flash memories via the serial port. In order to do that disconnect the board from your PC and hold down the SW3 button while reconnecting it back. When you release the SW3 button the board should be operating in ISP mode.

  2. Erase the host and NBU flash memories using the blhost tool from the NXP LinkServer for Microcontrollers

    blhost -p <assigned_port> flash-erase-all 0
blhost -p <assigned_port> flash-erase-all 1

  3. Use the same blhost tool to write the NBU image on the board:

    blhost -p <assigned_port> write-memory 0x48800000 mcxw72_nbu_ble_full_15_4_dyn.bin

  4. Return the board to normal operating mode by disconnecting and then reconnecting it back to your PC.

Flashing the example application#

We recommend using JLink from Segger to flash the example application. It can be downloaded and installed from https://www.segger.com/downloads/jlink. Once installed, JLink can be run to flash the application using the following steps :

$ JLink

J-Link > connect
Device> ? # you will be presented with a dialog -> select `MCXW727C_M33_0`
Please specify target interface:
J) JTAG (Default)
S) SWD
T) cJTAG
TIF> S
Specify target interface speed [kHz]. <Default>: 4000 kHz
Speed> # <enter>

Program the application executable :

J-Link > loadfile <application_binary> (.elf or .srec format)

Testing the example#

To test the example, please make sure to check the Testing the example section from the common readme CHIP NXP Examples Guide for FreeRTOS platforms.

UART Ports#

Testing the example with the CLI enabled will require connecting to both UART0 and UART1 serial ports. For applications where CLI is not available, connecting to the default UART1 is enough.

Interface

Role

UART0

Used for logs only when matter-cli is enabled

UART1 (default)

Used either as matter-cli or for logs when matter-cli is disabled

You need a USB-UART bridge to make use of the UART0 interface. The pin configuration is the following:

  • J5 pin 3 - UART0 RX

  • J5 pin 4 - UART0 TX

  • J5 pin 8 - GND

Device UI#

The device state feedback is provided through the on-board LEDs:

Widget

Effect

Description

LED2

short flash on (50ms on/950ms off)

The device is in an unprovisioned (unpaired) state and is waiting for a commissioner to connect.

LED2

rapid even flashing (100ms period)

The device is in an unprovisioned state and a commissioner is connected via BLE.

LED2

short flash off (950ms on/50ms off)

The device is fully provisioned, but does not yet have full network (Thread) or service connectivity.

LED2

solid on

The device is fully provisioned and has full network and service connectivity.

RGB LED

on

The StateValue attribute of the BooleanState cluster is true (simulating detection).

RGB LED

off

The StateValue attribute of the BooleanState cluster is false (simulating no detection).

The user can control the device using the on-board buttons. The actions are summarized below:

Button

Action

State

Output

SW2

short press

not commissioned

Enable/disable BLE advertising

SW2

long press

any

Initiate a factory reset (can be cancelled by pressing the button again within the factory reset timeout limit - 6 seconds by default)

SW4

short press

any

Toggle attribute StateValue value

SW4

long press

any

Clean soft reset of the device (takes into account proper Matter shutdown procedure)

OTA Software Update#

Over-The-Air software updates are supported with the MCXW72 examples. The process to follow in order to perform a software update is described in the dedicated guide ‘Matter Over-The-Air Software Update with NXP MCXW example applications’.