Configuring Matter controller

The Matter controller is a role within the Matter development environment. The controller device is used to pair and control the Matter accessory device remotely over a network, interacting with it using Bluetooth LE and the regular IPv6 communication.

The following figure shows the available Matter controllers in the nRF Connect SDK.

Controllers used by Matter

Controllers used by Matter

The following Matter controllers can be used for testing Matter applications based on the nRF Connect SDK:

  • Recommended: CHIP Tool controller for Linux or macOS

  • Mobile controller for Android

  • Python controller for Linux

These controller types are compatible with the nRF Connect SDK implementation of Matter. In the Matter upstream repository, you can find information and resources for implementing other controller setups (for example, for mobile controller for iOS).

CHIP Tool controller for Linux or macOS

The CHIP Tool controller is the default implementation of the Matter controller role, recommended for the nRF Connect platform. You can use it either on a separate device from Thread Border Router or on the same device as Thread Border Router, depending on which development environment setup option you choose. CHIP Tool is available for Linux and macOS, and for both amd64 and aarch64 architectures. This implies that the tool can also be run on a Raspberry Pi with a 64-bit OS.

To use this controller type, choose one of the following options:

  • Use the prebuilt tool package from the Matter nRF Connect releases GitHub page. Make sure that the package is compatible with your nRF Connect SDK version.

  • Build it manually from the source files available in the modules/lib/matter/examples/chip-tool directory and using the building instructions from the Working with the CHIP Tool page in the Matter documentation.

For more information about how to test using the CHIP Tool, see the Working with the CHIP Tool page in the Matter documentation.

Mobile controller for Android

The Mobile Controller for Android allows you to test Matter applications using an Android smartphone. You can use it in the development environment setup option where Thread Border Router and Matter controller are running on separate devices.

To use this controller type, choose one of the following options:

  • Use the prebuilt tool package from the Matter nRF Connect releases GitHub page. Make sure that the package is compatible with your nRF Connect SDK version.

  • Build it manually from the source files available in the modules/lib/matter/src/android/CHIPTool directory and using the building instructions from the Building Android page in the Matter documentation.

For instructions about how to test using the Mobile Controller for Android, see the Commissioning nRF Connect Accessory using Android CHIPTool page in the Matter documentation.

Python controller for Linux

The Python Matter controller allows you to test Matter applications on a PC running Linux. You can use it either on a separate device from Thread Border Router or on the same device as Thread Border Router, depending on which development environment setup option you choose.

To use this controller type, choose one of the following options:

  • Use the prebuilt tool package from the Matter nRF Connect releases GitHub page. Make sure that the package is compatible with your nRF Connect SDK version.

  • Build it manually from the source files available in the modules/lib/matter/src/controller/python directory and using the building instructions from the Working with Python CHIP Controller page in the Matter documentation.

For instructions about how to test using the Python Controller for Linux, see the Working with Python CHIP Controller page in the Matter documentation.