Getting start with Matter - silabs-Simran/connectedhomeip GitHub Wiki

Purpose of this guide

This guide aims to help developers get started with Matter development Because Matter is still under development, this guide stands aside from the usual Simplicity Studio approach. Silicon Labs still aims to integrate Matter in the Gecko SDK Suite at some point.

This guide applies only if

You wish to start Matter Alpha development

You are looking for a non-Simplicity Studio way of building the Matter Project.

For a more standard or OpenThread only approach, Silicon Labs has defined a developer-friendly environment.

Documentation

Matter official GitHub is located here. Silabs Matter FAQ page is located here.

Official Silicon Labs OT documentation can be found on the Developer Documentation page.

Table of Content

Prerequisites

  • Hardware Requirements

  • Software Requirements

  • Walkthrough KBAs.

Prerequisites

Software Requirement:

  1.     VirtualBox (with Ubuntu 20.04 LTS) installed on Windows 10
     • VirtualBox: https://www.virtualbox.org/
     • Ubuntu 20.04.x LTS: https://ubuntu.com/download/desktop   
     Note: Native Linux or Mac machine can also be used to build this Matter example.

  2.     Ubuntu 20.04 or later for Raspberry Pi 4.   

  3.     Tera Term: https://ttssh2.osdn.jp/index.html.en

  4.     J-Link RTT Viewer: https://www.segger.com/downloads/jlink/

  5.     SSH Client (Putty or Similar): https://www.putty.org/

Hardware Requirement:

For this walkthrough guide, we will be using Thunderboard Sense 2 board (BRD4166A). You are free to use another Matter compatible board (like BRD4161A) but make sure to change the board name wherever needed in given instructions when following KBAs.

Raspberry Pi 4 with 64GB SD card.

Thunderboard Sense 2 (BRD4166A) for RCP

Thunderboard Sense 2 (BRD4166A) for the End device.

Walkthrough Guide: Getting Start with Matter Project

Follow the underline KBAs to set up the Matter project and test sending the commands to the end device. The initial setup time may vary depending on your internet speed.

  1. Prerequisites to setup Raspberry Pi 4 (Estimate: 1 hour)

  2. [Building Radio Co-processor (RCP)](https://github.com/silabs-Simran/connectedhomeip/wiki/Matter:-Prerequisites-to-setup-Raspberry-Pi-4] (Estimate: 10 min)

Commit hash required: ec69725

  1. Build OpenThread Border Router

Using Docker (Estimate 10 min)

Using Manual OTBR Setup. (Estimate time 30 mins)

For manual OTBR use the following commit: 72bb3d456

  1. Dev Environment Setup

You need to run the environment setup on both Ubuntu VM and Raspberry Pi4. (Estimate: 25min on Ubuntu VM and 40min on Raspberry Pi 4)

Commit hash required: b0af6ba42b6ce494748f18ecf3e054a400b8f45b

  1. Building and Running Lighting App (Estimate: 20 min)

Commit hash required: b0af6ba42b6ce494748f18ecf3e054a400b8f45b

  1. Chip-tool Commissioning End Device (Estimate: 20 min)

Commit hash required: b0af6ba42b6ce494748f18ecf3e054a400b8f45b

Note: Commit hash must be the same for both building the lightning app and Chip-tool for RaspberryPi 4