Matter Software Requirements

System Agnostic Software Requirements (Windows/Mac/Linux):

  1. SSH Client (PuTTY, Terminal, or similar):

    SSH client is used to communicate with the Raspberry Pi over a secure shell.

  2. Raspberry Pi Disk Imager

    Raspberry Pi Disk Imager is used to flash the SD Card that contains the operating system for the Raspberry Pi. Note that, for the Thread demo, the operating system is the demo image.

  3. Flash Tools

  4. Git Version Control [only required for building images and development]

    Clone the Silicon Labs Matter repo, then enter and sync all the necessary submodules with the following commands:

    $ git clone https://github.com/SiliconLabs/matter.git
    
    $ cd matter
    
    $ ./scripts/checkout_submodules.py --shallow --recursive --platform efr32
    
  5. If you are using an EFR32MG2x device you will require a bootloader to run the demo applications. When you flash your application image be sure to include a bootloader as well (if one is not already present). Bootloader images are provided on the Matter Artifacts page.

Windows-Specific Software Requirements:

  These requirements are in addition to those mentioned above, for Windows only.

  A Unix-like command line:

Mac-Specific Requirements (building own images):

  These requirements are in addition to those mentioned above for Mac OS users building their own images.

  1. Install Homebrew

    $ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  2. Install pkg-config, openssl, git-lfs

    $ brew install pkg-config openssl git-lfs
    
  3. Install ARM GNU Toolchain (https://developer.arm.com/downloads/-/gnu-rm)

  4. Add ARM GCC toolchain to the search path within bootstrap.sh by adding this line of code:

    $ export PATH="/Applications/ARM/bin:$PATH"
    

    Depending on your Mac processor, you will have to complete the following additional steps.

Apple Silicon (M1) Software Requirements:

Users may also have to specify which pkg-config/openssl to use by adding these lines of code to bootstrap.sh:

$ export PATH="/opt/homebrew/opt/openssl@3/bin:$PATH"
$ export PKG_CONFIG_PATH="/opt/homebrew/opt/openssl@3/lib/pkgconfig"

Intel Software Requirements:

$ cd /usr/local/lib/pkgconfig
$ ln -s ../../Cellar/openssl@1.1/1.1.1g/lib/pkgconfig/* .

openssl@1.1/1.1.1g may need to be replaced with the actual version of OpenSSL installed by Brew.

If using MacPorts, the command

$ port install openssl

is sufficient to satisfy this dependency.

Linux Specific Requirements:

On Debian-based Linux distributions such as Ubuntu, these dependencies can be satisfied with the following:

$ sudo apt-get install git gcc g++ 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 libreadline-dev

Wi-Fi RS9116 Specific Requirements:

Before you run the demo or development on the RS9116 please be sure that you update the RS9116 firmware.

Pre-Built RS9116 firmware is available in the github repository under third_party/silabs/wiseconnect-wifi-bt-sdk/firmware

  1. Setting up TeraTerm

  2. Updating the RS9116 Firmware

Wi-Fi SiWx917 Specific Requirements:

Before you run the demo or development on the SiWx917 please be sure that you update the SiWx917 firmware.

The WiseMCU Combo SDK package is only available to Alpha customers. Please contact Silicon Labs support.

The WiseMCU Combo SDK package version used in this release is A.1.0.0.0.23.

On obtaining the package, extract it, rename the folder as wisemcu-wifi-bt-sdk and copy it in the github repository under third_party/silabs.

Pre-Built SiWx917 firmware is available under third_party/silabs/wisemcu-wifi-bt-sdk/connectivity_firmware

  1. Setting up TeraTerm

  2. For updating the SiWx917 NCP Firmware, refer Updating the RS9116 Firmware. Instructions are the same for both SiWx917 and RS9116.

  3. For updating the SiWx917 SoC Firmware, you have several options outlined here: