NXP Semiconductors i.MX 8M Mini User manual

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 1
Rev. 1.0 NXP Semiconductors
Getting Started with i.MX 8M Mini and Matter

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 2
Rev. 1.0 NXP Semiconductors
CONTENTS
1 INTRODUCTION ........................................................................................................................................................... 3
2 HARDWARE SETUP ...................................................................................................................................................... 3
2.1 HARDWARE REQUIREMENTS .................................................................................................................................................. 3
2.2 SOFTWARE REQUIREMENTS ................................................................................................................................................... 4
2.3 HARDWARE CONNECTIONS .................................................................................................................................................... 5
3 MATTER ENVIRONMENT SETUP .................................................................................................................................. 7
3.1 WSL UBUNTU 20.04 LTS .................................................................................................................................................... 7
3.2 LINUX VIRTUAL MACHINE...................................................................................................................................................... 8
3.3 SETTING UP MATTER ENVIRONMENT ..................................................................................................................................... 10
4 BUILDING AND RUNNING OPENTHREAD BOARDER ROUTER BINARIES WITH YOCTO SDK ......................................... 16
4.1 SETUP OTBR ON IMX8MMEVK + 88W8987+K32W .......................................................................................................... 19
4.2 SETUP OTBR ON IMX8MMEVK + IW612 ........................................................................................................................... 21
4.3 FORM OTBR NETWORK ...................................................................................................................................................... 23
5 I.MX8MM MATTER EXAMPLES .................................................................................................................................. 24
5.1 MATTER APPLICATION BUILDING INSTRUCTION ........................................................................................................................ 24
5.2 DEPLOYING MATTER APPLICATION TO THE I.MX8MM BOARD ................................................................................................... 25
6 MATTER NETWORK – CHIP TOOL COMISSIONGING AND CONTROL ........................................................................... 27
7 MATTER DEMO ......................................................................................................................................................... 29
7.1 ADD A K32W END DEVICE IN MATTER NETWORK .................................................................................................................... 29
7.1.1 Pairing commissionee(Lighting node)tocommissioner(OTBR) ............................................................................. 29
7.1.2 Controll the device ............................................................................................................................................... 30
7.2 ANDROID CHIP-TOOL ....................................................................................................................................................... 30

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 3
Rev. 1.0 NXP Semiconductors
1 INTRODUCTION
Matter (previously known as Project CHIP) is a new single, unified, application-layer connectivity standard
designed to enable developers to connect and build reliable, secure IoT (Internet of Things) ecosystems and
increase compatibility among Smart Home and Building devices.
For enabling Matter devices, NXP offers scalable, flexible and secure platforms to enable the variety of use cases
Matter addresses – from end nodes to gateways – so device manufacturers can focus on product innovation and
accelerating time to market.
This document focuses on NXP’s solution for Matter controller and OpenThread Border Router (OTBR) using the
i.MX8M Mini Processor family.
The i.MX 8M Mini is NXP’s first embedded multicore applications processor built using advanced 14LPC FinFET
process technology, providing more speed and improved power efficiency. With commercial and industrial level
qualification and backed by NXP’s product longevity program, the i.MX 8M Mini family may be used in any
general purpose industrial and IoT application.
https://www.nxp.com/part/i.MX8MMini#/
2 HARDWARE SETUP
There are two possible hardware solutions for the i.MX8M Mini matter enablement, that will be detailed below
- i.MX8MM + 88W8987(WiFi-BT combo Module) + K32W(OpenThread RCP module)
- i.MX8MM + IW612 (WiFi-BT-Thread tri-radio single-chip module)
2.1 Hardware Requirements
- i.MX 8M Mini Evaluation Kit (which contains the required materials below)
o i.MX 8M Mini EVK
o USB Type C power supply
o USB A to micro USB cable
o USB A to USB C cable
- K32W061 DK006
o K32W061 DK006 + OM15082
o K32W USB Dongle or K32W061 DK006
o USB A to MINI USB

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 4
Rev. 1.0 NXP Semiconductors
o USB type C to A
- IW612 A1 RD Board
o Micro-SD to SD adapter
o SDIO adapter with ribbon cable
o RD-IW612-CSP-IPA-2A-V2 evaluation board
- Linux host computer
- Wi-Fi Access Point which supports IPv6 and IPv6 DHCP server
2.2 Software Requirements
- Universal Update Utility (UUU)
- A serial COM terminal for the host computer o For instructions on how to set up a serial COM terminal
software, please refer to page 14 in the i.MX 8M Mini LPDDR4 EVKB Hardware User's Guide.
Figure 2-1 i.MX 8M Mini + K32W Matter setup

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 5
Rev. 1.0 NXP Semiconductors
2.3 Hardware connections
OTBR i.MX8MM + 88W8987 + K32W

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 6
Rev. 1.0 NXP Semiconductors
OTBR i.MX8MM + IW612
Note: Although L5.15.52 BSP contains the IW612 driver, it only support Wi-Fi/BT, it doesn’t support thread. So for
Matter enablement, you need to build the IW612 OTBR driver and firmware separately.

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 7
Rev. 1.0 NXP Semiconductors
3 MATTER ENVIRONMENT SETUP
Matter development relies on open-source resources, leveraging Linux based operating systems like Ubuntu and
other tools like git, gcc or python. This also includes GN, a meta build system that generates makefiles and Ninja,
a build system meant to replace Make tool.
Matter is available as an open-source SDK (Software Development Kit) containing all the necessary components
from scripts to install required tools to stack source code and vendor provided applications.
First step in developing a Matter application is to have Linux support for the build. The recommendation is to have
a native Linux machine. If Windows is preferred operating system, support for the build can be set by using either:
- Windows Subsystem for Linux (WSL),
- Linux Virtual Machine.
3.1 WSL Ubuntu 20.04 LTS
The Windows Subsystem for Linux (WSL) provides a GNU/Linux environment directly to Windows.
Use the following steps to install the WSL Ubunut 20.04 LTS (Long Term Support):
1. On Windows 10, open PowerShell as administrator and run the following commands:
- Enable the Windows Subsystem for Linux:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all
/norestart
- Enable virtual machine feature:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
- Restart your machine to complete the WSL installation
2. Install the Ubuntu 20.04 from Microsoft Store
- Create a user account and password for your new Linux distribution

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 8
Rev. 1.0 NXP Semiconductors
- Next you will have to check the WSL version and activate WSL 1, if 2 is used. Run PowerShell as
administrator:
The following command is used to check the wsl version:
wsl --list –verbose
If wsl version 2 is used, then activate wsl 1 using:
wsl --set-version Ubuntu-20.04 1
- After installation is complete, run Ubuntu 20.04 LTS as administrator.
3.2 Linux Virtual Machine
The following steps guide you through virtualbox machine installation steps:
- Download and install virtual machine: https://www.virtualbox.org/wiki/Downloads
- Please consider that based on your operating system some extra steps will be required for enabling the
Virtualization support.
- Download the desktop image for Ubuntu 20.04 Focal and create virtual machine using the downloaded
ISO.
- Configure the virtual machine:
- Linux Ubuntu 20.04 (64 bit);
- VM (Virtual Machine) disk size – more than 20GB;

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 9
Rev. 1.0 NXP Semiconductors
- Enable USB controller -> USB 1.1(OHCI) Controller (support for USB 2.0 is recommended, if possible,
this being available via the Oracle VM VirtualBox Extension Pack);
- Enable network adapter-> Adapter 1 -> Attached to Bridged Adapter;

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 10
Rev. 1.0 NXP Semiconductors
3.3 Setting up Matter Environment
The following steps guide you through creating Matter build environment for K32W0x1 MCU.
1. Matter Dependencies:
- Check for updates and install dos2unix (useful for WSL):
$ sudo apt update
$ sudo apt upgrade --y
$ sudo apt-get install dos2unix
- Install Matter dependencies:
$ sudo apt-get install git gcc g++ python pkg-config libssl-dev libdbus-1-dev libglib2.0-
dev libavahi-client-dev ninja-build python3-venv python3-dev python3-pip
unzip libgirepository1.0-dev libcairo2-dev gcc-arm-none-eabi
- Restart the Linux machine.
2. Generating the i.MX8MM Yocto image:
The Yocto Project (YP) is an open source collaboration project that helps developers create custom Linux-
based systems regardless of the hardware architecture. The project provides a flexible set of tools and a
space where embedded developers worldwide can share technologies, software stacks, configurations,
and best practices that can be used to create tailored Linux images for embedded and IOT (Internet of
Things) devices, or anywhere a customized Linux OS (Operating System) is needed.

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 11
Rev. 1.0 NXP Semiconductors
- To build the Yocto Project, some packages need to be installed. The list of packages required are:
$ sudo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib \build-
essential chrpath socat cpio python3 python3-pip python3-pexpect \xz-utils debianutils
iputils-ping python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \pylint3 xterm npm
zstd build-essential libpython3-dev libdbus-1-dev python3.8-venv
- Then you need to install the repo tool:
$ mkdir ~/bin
$ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo
$ export PATH=~/bin:$PATH
- To build the Yocto Project, some python dependency packages need to be installed.
$wget https://raw.githubusercontent.com/project-
chip/connectedhomeip/master/scripts/constraints.txt
$ pip3 install -r constraints.txt
$ pip3 install build mypy==0.910 types-setuptools pylint==2.9.3
$ pip install dbus-python
- If you have not configured the Git environment on your machine, you should to this now:
$ git config --global user.name "Your Name"
$ git config --global user.email "Your Email"
$ git config --list
- Then, Yocto build environment must be setup.
(Note: The Yocto source code is maintained with a repo manifest, the tool repo is used to download the
source code.)
$ mkdir ~/bin
$ curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
$ chmod a+x ~/bin/repo
$ export PATH=${PATH}:~/bin
$ mkdir ${MY_YOCTO}
$ cd ${MY_YOCTO}
$ repo init -u https://github.com/nxp-imx/imx-manifest-b imx-linux-kirkstone -m imx-
5.15.52-2.1.0.xml
$ repo sync

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 12
Rev. 1.0 NXP Semiconductors
- Then integrate the meta-matter recipe into the Yocto code base
$ cd ${MY_YOCTO}/sources/
$ git clone https://github.com/NXPmicro/meta-matter.git
Note: If you use the IW612 as RCP you will need to add SPI config in ot-br-posix project.
Add “-DOT_POSIX_CONFIG_RCP_BUS=SPI” to sources/meta-matter/recipes-otbr/otbr/otbr.bb
EXTRA_OECMAKE
More information about the downloaded Yocto release can be found in the corresponding i.MX Yocto Project
User’s Guide which can be found at NXP official website.
- Make sure your default Python of the Linux host is Python2.
$ python -version
Python 2.7.x
- Change the current directory to the top directory of the Yocto source code and execute the command
below.
$MACHINE=imx8mmevk DISTRO=fsl-imx-xwayland source sources/meta-matter/tools/imx-iot-
setup.sh bld-xwayland-imx8mm

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 13
Rev. 1.0 NXP Semiconductors
- The system will create a directory bld-xwayland-imx8mm/ and enter this directory automatically,
execute the command below under these directory to generate the Yocto images.
$ Bitbake imx-image-multimedia

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 14
Rev. 1.0 NXP Semiconductors
After execution of previous commands, the Yocto image will be generated under ${MY_YOCTO}/bld-
xwayland-imx8mm/tmp/deploy/images/imx8mmevk/imx-image-multimedia-imx8mmevk.wic.bz2 .
- The bz2 image is a symbolic link file, it is better to copy it to another folder ${MY_images} before
unziping it.
$ cp ${MY_YOCTO}/bld-xwayland-imx8mm/tmp/deploy/images/imx8mmevk/imx-image-
multimedia-imx8mmevk.wic.bz2 ${MY_images}
- The bzip2 command is used to unzip this file then the dd command is used to program the output file to
a microSD card by running the command sequence below.
(Be cautious when executing the dd command below, make sure that you have the microSD card device connected! /dev/sdc in
the command below represents a microSD card connected to the host machine with a USB adapter, however the output device
name may vary. Use the command "ls /dev/sd*" to verify the name of the SD card device!)
$ cd ${MY_images}
$ bzip2 -d imx-image-multimedia-imx8mmevk.wic.bz2
$ sudo dd if=imx-image-multimedia-imx8mmevk.wic of=/dev/sdc bs=4M conv=fsync

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 15
Rev. 1.0 NXP Semiconductors
- Or use the uuu tool to flash the image on the internal eMMC/SDHC 3 storage
- connect the board via the Download port.
- Setup the “Download” boot mode, see printed table onboard
- Power on the board and use the following command in the same folder with the image
$ uuu -b emmc_all imx-image-multimedia-imx8mmevk.wic.bz2
3. Generating the i.MX8MM Yocto SDK:
- The Yocto SDK must be generated by the below command:
$ cd ${MY_YOCTO}/bld-xwayland-imx8mm
$ bitbake imx-image-multimedia -c populate_sdk
- Install the NXP Yocto SDK and set toolchain environment variables. Run the SDK installation script with
root permission.
$ sudo tmp/deploy/sdk/fsl-imx-xwayland-glibc-x86_64-imx-image-multimedia-armv8a-
imx8mmevk-toolchain-5.15-kirkstone.sh
- The default target directory for SDK will be prompted during SDK installation, as shown below, enter a
new target directory:
NXP i.MX Release Distro SDK installer version 5.15-kirkstone
============================================================
Enter target directory for SDK (default: /opt/fsl-imx-xwayland/5.15-kirkstone):
- After the Yocto SDK is installed on the host machine, an environment setup script is also generated, and
there are prompt lines telling the user to source the script each time when using the SDK in a new shell,
for example:
$ . /opt/fsl-imx-xwayland/5.15-kirkstone-imx8mm/environment-setup-armv8a-poky-linux
- After the SDK package installed in the build machine, the Yocto build environment can be imported using
the command:

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 16
Rev. 1.0 NXP Semiconductors
$ source ${iMX8MM_SDK_INSTALLED_PATH}/environment-setup-armv8a-poky-linux
4. Matter Building Setup instructions:
- Clone the Matter SDK using the public repo:
$ mkdir ${MY_Matter_Apps}#thisistopleveldirectoryofthisproject
$ cd ${MY_Matter_Apps}
$ git clone https://github.com/project-chip/connectedhomeip.git
$ cd connectedhomeip
$ git checkout -t origin/v1.0-branch-imx
$ git submodule update --init$source scripts/activate.sh
4 BUILDING AND RUNNING OPENTHREAD BOARDER ROUTER BINARIES WITH YOCTO
SDK
- Fetch latest otbr source codes and execute the build:
$ git clone https://github.com/openthread/ot-br-posix
$ cd ot-br-posix
$ git checkout -t origin/main
$ git submodule update –init
$ source ${yocto_matter_sdk}/environment-setup-cortexa53-crypto-poky-linux
- For the i.MX8MM + K32W configuration:

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 17
Rev. 1.0 NXP Semiconductors
$./script/cmake-build -DOTBR_BORDER_ROUTING=ON -DOTBR_WEB=ON \-DBUILD_TESTING=OFF -
DOTBR_DBUS=ON -DOTBR_DNSSD_DISCOVERY_PROXY=ON \-DOTBR_SRP_ADVERTISING_PROXY=ON -
DOT_THREAD_VERSION=1.3\-DOTBR_INFRA_IF_NAME=mlan0 \-DOTBR_BACKBONE_ROUTER=ON -
DOTBR_BACKBONE_ROUTER_MULTICAST_ROUTING=ON \-DOTBR_MDNS=mDNSResponder \-
DCMAKE_TOOLCHAIN_FILE=./examples/platforms/nxp/linux-imx/aarch64.cmake
- For the i.MX8MM + IW612 configuration
$ ./script/cmake-build -DOTBR_BORDER_ROUTING=ON -DOTBR_WEB=ON \ -DBUILD_TESTING=OFF -DOTBR_DBUS=ON -
DOTBR_DNSSD_DISCOVERY_PROXY=ON \ -DOTBR_SRP_ADVERTISING_PROXY=ON -DOT_THREAD_VERSION=1.3 \ -
DOTBR_INFRA_IF_NAME=mlan0 -DOT_POSIX_CONFIG_RCP_BUS=SPI \ -DOTBR_BACKBONE_ROUTER=ON -
DOTBR_BACKBONE_ROUTER_MULTICAST_ROUTING=ON \ -DOTBR_MDNS=mDNSResponder \ -
DCMAKE_TOOLCHAIN_FILE=./examples/platforms/nxp/linux-imx/aarch64.cmake

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 18
Rev. 1.0 NXP Semiconductors
- The otbr-agent is built in ${MY_OTBR}/build/otbr/src/agent/otbr-agent.
- The otbr-web is built in ${MY_OTBR}/build/otbr/src/web/otbr-web.
- The ot-ctl is built in ${MY_OTBR}/build/otbr/third_party/openthread/repo/src/posix/ot-ctl.
- These files must be copied into Yocto's /usr/sbin/ folder.
- Insert the uSD card flashed with the Yocto image in the uSD card port on the board (From Chapter 3.3
step 2)
- Connect a micro USB cable from the DEBUG port on the board in the PC and open a serial connection
with the following parameters:
• Baud rate: 115200
• 8 data bits
• 1 stop bit
• No parity
• No flow control
- Put the power switch on the ON position
- After the boot sequence when you are prompted to type in an username use “root” (no password
required)

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 19
Rev. 1.0 NXP Semiconductors
4.1 Setup OTBR on IMX8MMEVK + 88W8987+K32W
- Flash k32w RCP binary to K32W061DK6 or USB dongle. For the DK6Programmer installation you can
refer to K32W SDK documentation, The ot-rcp-check-usart-idle-not-txifo-dmacore-interface.bin is a
designed binary for IMX8MM and supports Matter V1.0 firmware.
$ DK6Programmer.exe -s COM${X}-e FLASH -p ot-rcp-check-usart-idle-not-txifo-dmacore-
interface.bin
- Set /etc/radvd.conf to enable IPv6 RA functions
$ vi /etc/radvd.conf
interface mlan0
{
AdvSendAdvert on;
}

NXP Semiconductors. Getting started with i.MX 8M Mini and Matter 20
Rev. 1.0 NXP Semiconductors
- Sync with current time
$ date -s "2022-11-20 17:14"
- Connect the OTBR to the target Wi-Fi AP network
$/usr/libexec/bluetooth/Bluetoothd&
$modprobe moal mod_para=nxp/wifi_mod_para.conf
$ sysctl -w net.ipv6.conf.mlan0.accept_ra_rt_info_max_plen=64
$ sysctl -w net.ipv6.conf.mlan0.accept_ra_rt_info_min_plen=48
$ wpa_passphrase ${SSID} ${PASSWORD} > imxrouter.conf
$ wpa_supplicant -d -B -i mlan0 -c ./imxrouter.conf
$ udhcpc -i mlan0
$ systemctl restart radvd
$ sleep 4
$ hciattach /dev/ttymxc0 any 115200 flow
$ hciconfig hci0 up
$ echo 1 > /proc/sys/net/ipv6/conf/all/forwarding
$ echo 1 > /proc/sys/net/ipv4/ip_forward
$ echo 2 > /proc/sys/net/ipv6/conf/all/accept_ra
$ ln -sf /usr/sbin/xtables-nft-multi /usr/sbin/ip6tables
$ ipset create -exist otbr-ingress-deny-src hash:net family inet6
$ ipset create -exist otbr-ingress-deny-src-swap hash:net family inet6
$ ipset create -exist otbr-ingress-allow-dst hash:net family inet6
$ ipset create -exist otbr-ingress-allow-dst-swap hash:net family inet6
- Setup Openthread
$ ./otbr-agent -I wpan0 -B mlan0 'spinel+hdlc+uart:///dev/ttyUSB0?uart-
baudrate=1000000' -v -d 5 &
$ iptables -A FORWARD -i mlan0 -o wpan0 -j ACCEPT
$ iptables -A FORWARD -i wpan0 -o mlan0 -j ACCEPT
$ ip6tables -A FORWARD -i mlan0 -o wpan0 -j ACCEPT
$ ip6tables -A FORWARD -i wpan0 -o mlan0 -j ACCEPT
$ hciconfig hci0 up
$ otbr-web &