Requirements and setup
This page outlines the requirements that you need to meet before you start working with the Matter add-on.
Hardware requirements
This section outlines the hardware you need to develop and run Matter applications with the Matter add-on.
Supported SoCs
Currently, the following SoCs from Nordic Semiconductor are supported for use with the Matter protocol:
nRF5340 (Matter over Thread)
nRF52840 (Matter over Thread)
nRF54L15 (Matter over Thread)
nRF54L10 (Matter over Thread)
nRF54LM20 (Matter over Thread and Matter over Wi-Fi through the
nrf7002eb2shield)
To use the Matter add-on, you need a development kit that supports the Matter protocol.
Hardware platforms |
PCA |
Board name |
Board target |
Shields |
|---|---|---|---|---|
PCA20053 |
|
|||
PCA10184 |
|
|
||
PCA10156 |
|
|||
PCA10095 |
|
|
||
PCA10056 |
|
|
Front-End Modules
SoCs from Nordic Semiconductor that can run the Matter protocol over Thread can also work with external Front-End Modules. For more information about the FEM support in the nRF Connect SDK, see Developing with Front-End Modules and nRF21540 DK.
External flash
For the currently supported SoCs, you must use an external memory with at least 1 MB of flash for the nRF52840 and nRF54L10 devices, and 1.5 MB for nRF5340 and nRF54L15 devices. This is required to perform the DFU operation.
Note
The nRF54L15 SoC supports DFU with image compression, which may eliminate the need for external flash. For more details, see MCUboot image compression.
The development kits for the supported SoCs from Nordic Semiconductor are supplied with the MX25R64 type of external flash that meets these memory requirements. However, it is possible to configure the SoCs with different QSPI or SPI memory if it is supported by Zephyr. For this purpose, check the reference design for Nordic DKs for information about how to connect the external memory with SoC, specifically whether the pins are designed for the QSPI or the high-speed SPIM operations.
Software requirements
For libraries and code for the Matter add-on, see the Matter add-on repository.
To work with the Matter add-on, you need to install the nRF Connect SDK, including all its prerequisites and the nRF Connect SDK toolchain. Follow the Installing the nRF Connect SDK instructions, with the following exception:
In the Installing the nRF Connect SDK section, click Create a new application.
Select Browse nRF Connect SDK Add-on Index, then choose NCS Matter.
Select v1.0.99 of the Matter add-on. This step also installs the nRF Connect SDK v3.4.0.
Initialize a new workspace:
Run the following command to initialize west with the Matter add-on, which also initializes the nRF Connect SDK v3.4.0:
west init -m https://github.com/nrfconnect/ncs-matterUpdate the nRF Connect SDK modules:
west update
Include the add-on in an existing nRF Connect SDK workspace:
Assuming you have an existing nRF Connect SDK workspace in the
ncsfolder, run the following commands:Navigate to the workspace folder:
cd ncsClone the add-on repository:
git clone https://github.com/nrfconnect/ncs-matterSet the manifest path to the add-on directory:
west config manifest.path ncs-matterUpdate the nRF Connect SDK modules:
west update
Optionally, run these commands in case you need to go back to work on the nRF Connect SDK without the add-on:
Configure the manifest path back to the nRF Connect SDK directory:
west config manifest.path nrfUpdate nRF Connect SDK modules:
west updateCheck the current manifest path with the following command:
west config manifest.pathThe output should be:
nrfThis means that the current workspace is using the nRF Connect SDK.
See Configuring and building in the nRF Connect SDK documentation for information about how to permanently or temporarily change the configuration.