Matter test and demonstrate

1. Overview

The following figure (from CSA) illustrates a general network topology and the different device types.

Matter network topology
Connectivity Matter network topology.png

A Matter Fabric platform is composed of different equipment types:

  • Matter end device
  • Matter bridge
  • Simple controller
  • Simple Thread Border Router
  • Combined controller and Border Router

The STM end devices have been demonstrated with the following platforms:

  • STM OpenThread Border Router (OTBR)
  • Raspberry Pi (RPi)
  • Google ecosystem
  • Apple ecosystem
  • Samsung ecosystem
  • Amazon ecosystem

For the test and the demonstration, the STM32WB5MM-DK end device platform is programmed with a Lighting-App application. The operation mode for each ecosystem is presented in the following section.

For all ecosystems, the Matter network is composed of the following elements:

  • 1 x STM32WB5MM-DK board as the end device, flashed with the relevant firmware binaries
  • 1 x OpenThread Border Router
  • 1 x Smartphone with an ecosystem application installed as a Matter commissioner/controller device
  • 1 x Wi-Fi access point
  • 1 x PC/Laptop for displaying STM32WB5MM-DK logs.
Matter test and hardware setup demonstration
Connectivity Matter demo setup.png

For a demonstration using CHIPTool, the APK (Android Package Kit) file is embedded in the X-CUBE-MATTER at the Utilities folder (...\X-CUBE-MATTER_1_0\Utilities\APK\ Open the .zip file, get the application (CHIPTool_v1_1.apk), and install it on the device used as commissioner/controller. See top release notes for backward compatibility.

CHIPTool offers the following features:

  • Scan the Matter QR code and display payload information to the user.
  • Commission a Matter device.
  • Send ON/OFF cluster requests to a Matter device.

2. STM ecosystem

The STM ecosystem is created with a STM32MP1+RCP as the border router, and an android smartphone with the CHIPTool application as the commissioner and controller. Both are connected to the same Wi-Fi access point.
For the OTBR setup, go to the dedicated wiki page STM32 OpenThread Border Router.
Once the complete setup is done, start the commissioning on the controller side as follow:


The commissioning is done in PROVISION CHIP DEVICE WITH THREAD, where the user scans the QR code generated by the end device, and display the payload information. The controller must get the commissioning information from the Matter device. The data payload is encoded within a QR code, printed to the UART console by clicking on the following link from the UART log.

QR Code generated.png

Once the QR code scanned, the CHIPTool app displays the default Thread credentials needed to establish a Thread network between the end device and the border router:


To initiate the commissioning over the Bluetooth LE protocol, click on SAVE NETWORK and scan for discoverable Matter devices. Pair with the device and start the procedure.

CHIPTool Pairing.png

On the end device side, the display screen shows that the device is connected over Bluetooth LE before switching to the Thread network:


At the end of the commissioning, the STM32WB5MM-DK device is connected to the Matter network and the Fabric is created. The result on both controller and end device sides is shown below:

  • Controller side:
  • End device side:

At this stage, it is possible to pilot the light of the end device directly using the controller (here the CHIPTool app) by sending ON/OFF commands, and changing the light level using the LIGHT ON/OFF & LEVEL CLUSTER.


On the end device side, the received commands are displayed on the LCD screen which shows the message LED ON when the ON command is pressed, and update the light level when the level cluster is modified as follow:


When the device is commissioned successfully, the following trace information are shown over the UART:


To start a new commissioning properly, it is good practice to factory reset the end device by pressing the SW1 button for at least 10 seconds, then clear the CHIPTool cache, and restart the app.

3. Raspberry Pi ecosystem

The Raspberry Pi ecosystem is created with a Raspberry Pi as the border router, and an android smartphone with the CHIPTool application as the commissioner and controller.

For the RPi setup, get a Test Harness Raspberry Pi bootable image, flash it to the Raspberry Pi following the CSA instructions (Matter Test-Harness User Manual, TH image location link for Matter 1.1), and follow the guide to setup the OTBR.
Once the OTBR is ready, the demo procedure is the same as for STM ecosystem.

4. Other ecosystems: Apple, Amazon, Google, Samsung, ...

The STM32WB5MM-DK platform is used as any other Matter device with the following QR code:

QR Code generated.png

To connect the STM32WB5MM-DK to those ecosystems and perform a demonstration, follow the guide provided for each ecosystem.

4.1. Apple ecosystem

The Apple ecosystem is created with an Apple HomePod Mini (with 16.1 or higher system version) as the border router, and an Apple iPhone (with iOS 16.1 or higher system version) with the Apple Home application (or any application that supports the Matter smart home standard) as the commissioner and controller. For a demonstration of the STM32WB5MM-DK with an Apple ecosystem, follow this link.

4.2. Amazon ecosystem

The Amazon ecosystem is created with an Amazon Echo Hub as the border router, and an Alexa application as the commissioner and controller on an Android or iOS device. For a demonstration of the STM32WB5MM-DK with an Amazon ecosystem, follow this link.
During the commissioning phase, Alexa (the controller) instructs the device to discover the surrounding Thread networks. The available list of Thread networks is sent to Alexa and displayed on the phone screen. The user is then invited to select one. If the selected network is known by Alexa, the commissioning will continue, otherwise Alexa will ask for the network key.
Note that Alexa checks the serial number during the device commissioning. Therefore, when several STM32WB5MM-DK kits are used in a demonstration, it is necessary to modify the serial number, as described in Serial number modification, to differentiate the different kits.

4.3. Google ecosystem

The Google ecosystem is created with a Google Nest Hub 2nd-gen as the border router, and an Android device with the Google Home Application (GHA) as the commissioner and controller. For a demonstration of the STM32WB5MM-DK with a Google ecosystem, follow this link.

4.4. Samsung ecosystem

The Samsung ecosystem is created with a SmartThings Station as the border router, and an Android device with the SmartThings Application, or an iOS device running iOS 16.2 or higher and SmartThings Application version 1.6.94 or higher as the commissioner and controller. For a demonstration of the STM32WB5MM-DK with a Samsung ecosystem, follow this link.

5. Multifabric

For a multifabric demonstration, select the first Fabric, and commission the device in this Fabric. Then follow the guide provided by the related ecosystem on how to commission a device in other ecosystems.