Skip to content

Latest commit

 

History

History
130 lines (85 loc) · 4.48 KB

SW_SETUP.md

File metadata and controls

130 lines (85 loc) · 4.48 KB
Raw

Software Setup and Preliminaries

Using the Matter Accessory Device (MAD) Pre-Built Binaries

If you are just running the Matter demo, and are not interested in building the Matter Accessory Device images from scratch, you can download the MAD images for Wi-Fi from this software release on the Matter Artifacts Page

Once you have downloaded the image you require for your device, you can skip forward to the Running the Matter Demo over Wi-Fi page

Otherwise if you are planning to build the Wi-Fi images from scratch please continue with this documentation.

Software Setup

If you have not downloaded or cloned this repository, you can run the following commands on a Linux terminal running on either Linux machine, WSL or Virtual Machine to clone the repository and run bootstrap to prepare to build the sample application images.

  1. To download the SiliconLabs Matter codebase run the following commands.

     $ git clone https://github.com/SiliconLabs/matter.git

  2. Bootstrapping:

    $ cd matter
$ ./scripts/checkout_submodules.py --shallow --recursive --platform efr32
$ . scripts/bootstrap.sh
# Create a directory where binaries will be updated/compiled called `out`
$ mkdir out

Compiling the ChipTool

In order to control the Wi-Fi Matter Accessory Device you will have to compile and run the ChipTool on either a Linux, Mac or Raspberry Pi. The ChipTool builds faster on the Mac and Linux machines so that is recommended, but if you have access to a Raspberry Pi that will work as well.

  1. Build the Chip-Tool

    $ ./scripts/examples/gn_build_example.sh examples/chip-tool out/standalone

    This will build chiptool in out/standalone.


Building Matter Application

The following commands are for building the Matter application. Depending on which device you are using, select the appropriate command to build.

Run the following:

$ cd matter
$ <run_appropriate_build_command_from_below>

Build command for EFR32MG12 + RS911x:

$ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx --wifi rs911x |& tee out/rs911x_lighting.log

Build command for EFR32MG12 + WF200:

$ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32 out/wf200_lighting_app BRD41xxx is_debug=false --wifi wf200 |& tee out/wf200_lighting.log

In above command BRD41xxx represent the EFR32MG12 boards

BRD4161A, BRD4163A, BRD4164A

Build command for EFR32MG24 + RS911x:

$ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx disable_lcd=true use_external_flash=false --wifi rs911x

Build command for EFR32MG24 + WF200:

$ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/wf200_lighting BRD41xxx disable_lcd=true use_external_flash=false chip_build_libshell=false --wifi wf200

In above command BRD41xxx represent the EFR32MG24 boards

BRD4186C, BRD4187C

By using the following flags we can enable or disable the features of lighting application.

  1. rs91x_wpa3_only : Use this flag while building to enable wpa3 mode in rs91x wifi chip.

    $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx rs91x_wpa3_only=true --wifi rs911x |& tee out/rs911x_lighting.log

    Note:

    1. WPA/WPA2 is enabled by default for the rs911x
    2. Enabling WPA3 will disable WPA and WPA2 support

  2. segger_rtt_buffer_size_up : Flag to get the complete logs without truncation.

    $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx segger_rtt_buffer_size_up=2068 --wifi rs911x |& tee out/rs911x_lighting.log

The generated software can be found in out/rs911x_xxx/BRD4161A/*.out for the RS9116 and in out/wf200_xxx/BRD4161A/*.out for the WF200.

This is what you will flash onto the EFR32. For more information on how to flash the EFR32 please check out the page on Flashing a Silicon Labs Device


[Optional: Increasing stack size ]
  Navigate to matter and open the file in the path examples/platform/efr32/FreeRTOSConfig.h. Find the macro: `configMINIMAL_STACK_SIZE`, and change the macro value from 140 to 320.


Table of Contents | Thread Demo | Wi-Fi Demo