Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 16 additions & 8 deletions sld247-matter-overview/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,20 @@ The procedures here describe how to make a simple network of a light, a switch,
## Initial Setup

Both the Matter over Wi-Fi and Matter over Thread demos require that you have set up a simple development environment with Simplicity Studio,
two EFR32MG24-based development boards, and a Raspberry Pi used as a Matter hub. The following requirements are common to both demos. The Thread demo also requires a radio co-processor (RCP) as part of the Matter hub. The requirements for this are provided in the [introduction to the Thread demo](/matter/{build-docspace-version}/matter-light-switch-example/02-thread-light-switch-example).
two Matter compatible development boards (see the [Silicon Labs Matter Selector Guide](https://www.silabs.com/wireless/matter/selector-guide) for available boards and their capabilities), and a Raspberry Pi used as the Matter Controller. The following requirements are common to both demos. The Thread demo requires a radio co-processor (RCP) connected to the Matter Controller. The requirements for this are provided in the [introduction to the Thread demo](/matter/{build-docspace-version}/matter-light-switch-example/02-thread-light-switch-example).

### Hardware Requirements

#### Matter Hub

- 1 Raspberry Pi 4B
- 1 Raspberry Pi 4B or newer
- 1x high speed, 64 GB SD card

#### Matter Devices

**Matter Over Thread Devices**

- SoC: EFR32x MG24, MG26, MG301
- RCP: EFR32x MG21, MG24, MG26, MG301

**Matter Over Wi-Fi Accessory Device Requirements for NCP Mode**

Expand Down Expand Up @@ -62,17 +66,21 @@ Pre-built images for the SiWx917 connectivity firmware are available per the ins

### Software Requirements

**Simplicity Studio 5**: Download and install Simplicity Studio 5 for your operating system from the Silicon Labs [Simplicity Studio page](https://www.silabs.com/developers/simplicity-studio). While the installation process is easy to follow, instructions are provided in the Simplicity Studio v5 [Getting Started section](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-getting-started/install-ss-5-and-software).
**Simplicity Studio**: Download and install Simplicity Studio for your operating system from the Silicon Labs [Simplicity Studio page](https://www.silabs.com/developers/simplicity-studio). Detailed instructions are provided in the Simplicity Studio [User Guide](https://docs.silabs.com/ssv6ug/latest/ssv6ug-overview/).

**Ozone - The J-Link Debugger**: [Ozone](https://www.segger.com/products/development-tools/ozone-j-link-debugger/) is a full-featured graphical debugger for embedded applications. With Ozone, it is possible to debug any embedded application on C/C++ source and assembly level.

**Simplicity Commander**: [Simplicity Commander](/matter/{build-docspace-version}/matter-references/flash-silabs-device#simplicity-commander) is a utility that provides GUI and command line access to the debug features of an EFM32 device. It allows you to flash firmware, update the kit firmware, and lock or unlock debug access.

**Tera Term**: [Tera Term](https://github.com/TeraTermProject/osdn-download) is the terminal emulator for Microsoft Windows that supports serial port, telnet, and SSH connections.

**Silicon Labs Matter SiSDK Extension**: Once Simplicity Studio 5 is installed, you will be prompted to install the Simplicity SDK, formerly released as Gecko SDK (GSDK). Here you should also install the Matter Enablement Package by making sure the extension is checked, as shown.
**Silicon Labs Matter SiSDK Extension**: Once Simplicity Studio is installed, you will be prompted to install the Simplicity SDK. Here you should also install the Matter Enablement Package by making sure the extension is checked, as shown.

![Installing the Matter Extension](./resources/ssv6-matter-install-guide-1.png)

![Installing the Matter Extension](./resources/ssv6-matter-install-guide-2.png)

![Installing the Matter Extension](./resources/install-package-advanced-device.png)
![Installing the Matter Extension](./resources/ssv6-matter-install-guide-3.png)

**Installation of Wi-Fi SDK and WiSeConnect Packages**: The following packages will be installed during the installation of Simplicity Studio. Refer to [Package Installation](/matter/{build-docspace-version}/matter-wifi-getting-started-example/software-installation).

Expand All @@ -88,9 +96,9 @@ Pre-built images for the SiWx917 connectivity firmware are available per the ins

### Visual Studio Code Development

In addition to creating and building your Matter project within Simplicity Studio, Silicon Labs also provides Visual Studio Code (VSCode) IDE integration.
Once a Matter project is created and any components or ZCL clusters modified in Simplicity Studio, Silicon Labs provides a Visual Studio Code (VS Code) IDE extension where code changes can be made. Simplicity Studio 6 (SSv6) does not provide an IDE; instead, VS Code is used. Projects can be built, flashed and debugged directly from VS Code.

For more information on development within Visual Studio Code, please visit [Visual Studio Code Enablement](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-vscode-ide/).
For more information on development with Visual Studio Code, please visit [Visual Studio Code Enablement](https://docs.silabs.com/ss-vscode/latest/ss-vscode-start/).

## Next Steps

Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 3 additions & 6 deletions sld250-matter-references/flash-silabs-device.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,9 @@ Simplicity Studio is a complete development environment and tool suite. It has t

- [Download Simplicity Studio](https://www.silabs.com/developers/simplicity-studio).
- Building Application Using Simplicity Studio:
- [Build Application for EFR32](/matter/{build-docspace-version}/matter-wifi-run-demo/build-efx32-application-using-studio)
- [Build Application for SoC](/matter/{build-docspace-version}/matter-wifi-run-demo/build-soc-application-using-studio)
- Flash Application Using Simplicity Studio:
- [Build Application for EFR32 Step 9](/matter/{build-docspace-version}/matter-wifi-run-demo/build-efx32-application-using-studio)
- [Build Application for SoC Step 9](/matter/{build-docspace-version}/matter-wifi-run-demo/build-soc-application-using-studio)
- [Simplicity Studio Reference Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-building-and-flashing/flashing)
- [Build Application for EFR32](/matter/{build-docspace-version}/matter-quick-start-demo/02-thread-quick-start-demo.md#step-2-build-the-project-in-the-silicon-labs-extension-for-the-visual-studio-code-ide)
- [Flash Application](/matter/{build-docspace-version}/sld251-matter-thread/build-flash-mad.md#step-2-flash-the-matter-accessory-device)
- [Simplicity Studio Reference Guide](https://docs.silabs.com/ssv6ug/latest/ssv6ug-overview/)

## Simplicity Commander

Expand Down
2 changes: 1 addition & 1 deletion sld250-matter-references/matter-ep.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ Matter project will not have been created inside Simplicity Studio.

Complete documentation on using the Simplicity Studio Energy Profiler is
provided in the
[Simplicity Studio 5 Energy Profiler User's Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-tools-energy-profiler/).
[Simplicity Energy Profiler User's Guide](https://docs.silabs.com/energy-profiler/latest/energy-profiler-start/).
25 changes: 15 additions & 10 deletions sld250-matter-references/matter-pintool.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,24 +19,29 @@ When creating a configuration for a custom board do the following:
3. Copy the generated output config files into a custom board support directory
within the Matter repository.

## 2. Create a sample "Empty C++ project" in Simplicity Studio
## 2. Create a Sample "Empty C++ project" in Simplicity Studio

1. In Simplicity Studio click `Create a New Project`
to start the project wizard. Choose your development board type, and the
latest Gecko SDK you'll be working from. Click **Next**.
1. In Simplicity Studio, next to **Start a New Project**, click **all projects & demos** to start the project wizard.
2. In the upper right, click **Select Device** to choose your development board, and in the dropdown, select the appropriate Simplicity SDK.
3. Scroll to the **Empty C++ Project** example, and click **Create**.
4. Click **Finish** to create your project.
to start the project wizard. Choose your development board type via the `+ Select Device` button, and the
latest Simplicity SDK you'll be working from

2. Select the `Empty C++ Project` example and click **Next**.
5. Select the `Empty C++ Project` example and click **Create**.

3. Click **Finish** to create your project.
6. Select a compatible device then click **Next**.

7. Click **Finish** to create your project.

## 3. Customize your Components and Pin configuration in Simplicity Studio

Once you have your project created you will see your project and project
configuration in Simplicity Studio's Project Configurator. Full documentation on
Once you have your project created, you will see your project and project
configuration in Simplicity Studio's Project Configurator. For full documentation on the use of the Project Configurator and Pin Tool, see the [Simplicity Studio User's Guide](https://docs.silabs.com/ssv6ug/latest/ssv6-configure-project/pin-tool).
the use of the Project Configurator and Pin Tool are located here:
[Simplicity Studio 5 User's Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-developing-with-project-configurator/)
[Simplicity Studio User's Guide](https://docs.silabs.com/ssv6ug/latest/ssv6-configure-project/pin-tool)

## 4. Generate your Component and Pin configuration in Simplicity Studio
## 4. Generate your Component and Pin Configuration in Simplicity Studio

When you save your project configuration, Simplicity Studio
saves all the generated header files out into a `config` directory in your
Expand Down
8 changes: 4 additions & 4 deletions sld250-matter-references/using-studio.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
# Development Tools in Simplicity Studio

Simplicity Studio contains a number of integrated tools that you can use with projects created within that environment.
Simplicity Studio contains a number of integrated tools that you can use with projects created within that environment. Documentation on all of these tools can be found in the [Simplicity Studio 6 User's Guide](https://docs.silabs.com/ssv6ug/latest/ssv6ug-overview/).

## Bluetooth GATT Configurator

The Simplicity Studio Bluetooth LE (BLE) GATT Configurator is an Advanced Configurator within the Simplicity Studio Project Configuration suite. You can add the BLE GATT configuration by adding the `Bluetooth > GATT > Configuration` component to your project. This will enable the BLE GATT Configurator under `Configuration Tools > Bluetooth GATT Configurator`. See the Simplicity Studio v5 User's Guide for more information on using the [BLE GATT Configurator](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-developing-with-project-configurator/bluetooth-gatt-configurator).
The Simplicity Studio Bluetooth LE (BLE) GATT Configurator is an Advanced Configurator within the Simplicity Studio Project Configuration suite. You can add the BLE GATT configuration by adding the **Bluetooth > GATT > Configuration** component to your project. This will enable the BLE GATT Configurator under **Configuration Tools > Bluetooth GATT Configurator**. See the Simplicity Studio User's Guide for more information on using the [BLE GATT Configurator](https://docs.silabs.com/ssv6ug/latest/ssv6-configure-project/bluetooth-gatt-configurator).

## Energy Profiler

Simplicity Studio's Energy Profiler allows you to see a graphical view of your device's energy usage over time. This can be very useful when developing an energy-friendly device.

Complete documentation on using the Simplicity Studio Energy Profiler is provided in the
[Simplicity Studio 5 Energy Profiler User's Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-tools-energy-profiler/).
[Simplicity Energy Profiler User's Guide](https://docs.silabs.com/energy-profiler/latest/energy-profiler-start/).

## Custom Hardware Configuration

At some point during product development you may need to move your project over to your custom hardware. In this case, you will likely need to change the pinout and hardware configuration in the example project to reflect your own custom project. You can do this using the Pin Tool. The Simplicity Studio 5 User's Guide contains full documentation on using the [Pin Tool](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-developing-with-project-configurator/pin-tool).
At some point during product development, you may need to move your project over to your custom hardware. In this case, you will likely need to change the pinout and hardware configuration in the example project to reflect your own custom project. You can do this using the Pin Tool. The Simplicity Studio User's Guide contains full documentation on using the [Pin Tool](https://docs.silabs.com/ssv6ug/latest/ssv6-configure-project/pin-tool).
40 changes: 27 additions & 13 deletions sld251-matter-thread/build-flash-mad.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ The Matter Accessory Device, such as the lighting-app, is the actual Matter devi

Use one of the following options to get the required image to flash the MAD:

1. Use the pre-built image file from either Simplicity Studio or [Matter Artifacts page](/matter/{build-docspace-version}/matter-prerequisites/matter-artifacts).
1. Use the pre-built image file from either Simplicity Studio (Demos) or [Matter Artifacts page](/matter/{build-docspace-version}/matter-prerequisites/matter-artifacts).
2. Build the image file from Simplicity Studio or out of the CSA Matter GitHub repository.

### Using the Pre-Built Image File
Expand All @@ -17,13 +17,16 @@ Prebuilt image files are available both on GitHub and inside Simplicity Studio.

To find the demos within Simplicity Studio, even if you do not have a device connected:

1. In Simplicity Studio, click the Launcher in the upper right hand corner.
2. Under **Get Started**, choose **All Products**.
3. Choose a board to start with such as **BRD4186C Rev A01** and click **Start**. This will bring up the Launcher window for that part.
4. In the top navigation, choose **Example Projects & Demos**.
5. In the left hand navigation, choose **Matter** to show all the Matter demos.
6. The demos are marked as "demo" and allow you to "run" them. Projects can be "created".
7. Choose the demo you wish to use, and click **Run** to flash it onto your board.
1. In Simplicity Studio, click the **Home** tab in the upper left corner.
2. Next to **Start a New Project**, click **all projects & demos**.
3. In the upper right, click **Select Device** to choose a connected board or search for a virtual board such as **BRD4187C**. This filters the window for that part.
4. In the left navigation, check **Matter** to show all Matter demos.
The demos are marked as **Demo** and allow you to **Run** them. Projects can be *created*.
5. Choose a demo, and click **Run** to flash it onto your board.
6. Choose a board to by clicking on **Select Device**, you can choose from a connected board or search for one such as **BRD4187C** and on the board. This will filter the window for that part.
7. In the left hand navigation, choose **Matter** to show all the Matter demos.
8. The demos are marked as "demo" and allow you to "run" them. Projects can be "created".
9. Choose the demo you wish to use, and click **Run** to flash it onto your board.

#### Silicon Labs GitHub

Expand All @@ -33,14 +36,25 @@ If you are coming from Simplicity Studio, you may have already installed the dem

### Building the Matter Image File

The entire build process for Simplicity Studio is covered in the [Matter Over Thread Quick Start Guide](/matter/{build-docspace-version}/matter-light-switch-example/02-thread-light-switch-example).

- [Build Using Simplicity Studio](/matter/{build-docspace-version}/matter-light-switch-example/02-thread-light-switch-example)
The entire build process for Simplicity Studio is covered in the [Matter over Thread QuickStart Demo](/matter/{build-docspace-version}/matter-quick-start-demo/02-thread-quick-start-demo.md#step-1-create-a-matter-sample-project).

## Step 2: Flash the Matter Accessory Device

For more information on how to flash your Silicon Labs development platform, see the following instructions: [How to Flash a Silicon Labs Device](/matter/{build-docspace-version}/matter-references/flash-silabs-device).
For more information on how to flash your Silicon Labs development platform, see the following instructions: [How to Flash a Silicon Labs Device](/matter/{build-docspace-version}/matter-references/flash-silabs-device).
There are a few ways to flash a device using Simplicity Studio.

1. [Flash from VS Code](/matter/{build-docspace-version}/matter-quick-start-demo/02-thread-quick-start-demo.md#step-3-flash-the-device)
2. Flash from Commander GUI:
1. In Simplicity Studio, click **Tools**, click **Commander**, and then click **Open Tool**.
The stand-alone Commander GUI opens.
2. Select the board, click **Flash**, and then click **Browse** to find the image file and flash it.

![Commander GUI](./resources/studio-6-commander-gui.png)
2. This will open the stand alone Commander GUI. From here select the board and then click on the flash tab. Browse to the image file and flash it.

![Commander Flash](./resources/studio-6-commander-flash-tab.png)

3. [Flash from Commander CLI](https://docs.silabs.com/simplicity-commander/latest/simplicity-commander-commands/device-flashing-commands)
4. [Flash using Simplicity Device Manager](https://docs.silabs.com/device-manager/latest/device-manager-work-in/devices)

Once your Matter Accessory Device has been flashed, it should show a QR code on the LCD. If no QR Code is present, it may be that you need to add a bootloader to
your device. Bootloader images are provided on the [Matter Artifacts page](/matter/{build-docspace-version}/matter-prerequisites/matter-artifacts).
2 changes: 0 additions & 2 deletions sld251-matter-thread/demo-overview.md

This file was deleted.

8 changes: 6 additions & 2 deletions sld251-matter-thread/matter-rcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,11 @@ RCP image files for all demo boards are accessible through the [Matter Artifacts

### Building the Image File from Simplicity Studio

RCP Images can be built from Simplicity Studio. Select **File > New > Silicon Labs Project Wizard**, look through the **Example Projects**, and then select the **Openthread - RCP Project**. Once the project is generated, you can build and flash the RCP. You can follow along in the [Simplicity Studio Getting Started Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-getting-started/start-a-project) for more information.
RCP Images can be built from Simplicity Studio.

Click **Home**. Next to **Start a New Project**, click **all projects & demos**, look through the **Example Projects & Demos**, and then select the **OpenThread - RCP** project.

Once the project is generated, you can build and flash the RCP. You can follow along in the [Light Switch Example](/matter/{build-docspace-version}/matter-light-switch-example/02-thread-light-switch-example.md#setting-up-the-matter-hub) for more information.

### Building the Image File from the ot-efr32 Repository

Expand Down Expand Up @@ -63,7 +67,7 @@ The output of the build process puts all the image files in the following locati

## Step 2: Flash the RCP

Once you get the RCP image, either by downloading a prebuilt image or building the image file, you can flash it to your device. This is done directly from your laptop and not through the Raspberry Pi, so make sure that the device is connected directly over USB to your laptop. You can flash your RCP using Simplicity Studio or using standalone Simplicity Commander.
Once you get the RCP image, either by downloading a prebuilt image or building the image file, you can flash it to your device. This is done directly from your laptop and not through the Raspberry Pi, so make sure that the device is connected directly over USB to your laptop. You can flash your RCP using Simplicity Studio or using standalone Simplicity Commander (see [How to Build and Flash the Matter Accessory Device](/matter/{build-docspace-version}/matter-thread/build-flash-mad.md#step-2-flash-the-matter-accessory-device)).

Once you have flashed the image, the device becomes the RCP. Disconnect it from you laptop and connect it via USB to the Raspberry Pi.

Expand Down
3 changes: 0 additions & 3 deletions sld251-matter-thread/matter-thread.md

This file was deleted.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading