Skip to content

Commit

Permalink
Pull request #29: Cherry-pick: Doc cleanup for v0.1.0
Browse files Browse the repository at this point in the history
Merge in WMN_TOOLS/matter from cherry_pick_latest_doc to silabs

Squashed commit of the following:

commit 56a8d3cce83d5e57a022c9eadebb7123054c980b
Author: Rehan Rasool <Rehan.Rasool@silabs.com>
Date:   Tue Jul 26 01:53:21 2022 +0000

    Pull request #27: Doc cleanup for v0.1.0

    Merge in WMN_TOOLS/matter from v0.1.0-cjo-doc-updates to RC_july_25_2022

    Squashed commit of the following:

    commit 098a8e68963dcef2b5340b0fab3967b782c757e9
    Author: Rehan Rasool <Rehan.Rasool@silabs.com>
    Date:   Mon Jul 25 15:07:36 2022 -0400

        Highlight Silabs documentation in main readme file to steer users in that direction

    commit e9724fdff7e008888ada038d6714a933a9da13cd
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 15:07:23 2022 -0400

        raspberry pi imager tool is also optional

    commit 3bfca8dd7ba7a7f776d35f2c1203e9e81dd33294
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 15:04:08 2022 -0400

        updated ozone instructions to be clear this could be done with simplicity studio or commander too

    commit d71effaa13a15066f856bd918b41b788fea6827e
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 14:55:40 2022 -0400

        fixed a few errors in the Wi-Fi documentation that pointed to the wrong repo, we should always point to the Silicon Labs Matter repo and not the CSA repo

    commit 9a6489181b347f1646a66954d94b559772ffb319
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 14:41:25 2022 -0400

        updated information on building ChipTool for Linux, Mac and Raspberry Pi

    commit 2a9546b10a3b2f200a27e572260df62309a5a523
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 13:58:14 2022 -0400

        added caveat around multiple interfaces

    commit 4be84ece40b19ec1fd364534fa5900f71604fe89
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 12:52:57 2022 -0400

        updated to remove todos

    commit b073ae430f4e6ac1d88cc43af75033bd7bc146f5
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 11:49:16 2022 -0400

        updated demo overview for wifi and navigation, moved to bottom, includes links for both demos

    commit 5337410ebef1d966febc53e017645e4eb7aee1dc
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 10:23:44 2022 -0400

        updated header for raspi login credentials

    commit e9c19b147b8450f3d2aea291374e78bdfc366b3f
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 10:09:51 2022 -0400

        updated raspi image connection to local network information

    commit 24ef311d3e0b85bf278f4926e0819bf19bbb4d64
    Author: Ezra Hale <ezra.hale@silabs.com>
    Date:   Mon Jul 25 09:44:04 2022 -0400

        added reference to Demo images for Wi-Fi

    commit 026cf89802a7cbc98a3c9afb1c1b0437451b5952
    Author: Rehan Rasool <Rehan.Rasool@silabs.com>
    Date:   Mon Jul 25 08:32:58 2022 -0400

        fix space in doc

    commit ff33baa679c6b22e84cc0ddc9939e0f3292cbc33
    Author: cjo-tra <caowens@silabs.com>
    Date:   Sun Jul 24 21:54:33 2022 -0400

        Demo copyedit

        (cherry picked from commit 24159f5e9258ad657566868669faaccdc2517f4e)
  • Loading branch information
jepenven-silabs authored and jmartinez-silabs committed May 25, 2023
1 parent b9dc2e3 commit ca46e18
Show file tree
Hide file tree
Showing 25 changed files with 297 additions and 276 deletions.
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,10 @@
# Silicon Labs Matter

Welcome to the Silicon Labs Matter Github repo. This is your one stop shop for all things related to Silicon Labs and Matter development. To develop a Matter application with Silicon Labs please start here: [Silicon Labs Matter Table of Contents](./docs/silabs/README.md)
Welcome to the Silicon Labs Matter Github repo. This is your one stop shop for all things related to Silicon Labs and Matter development.

<BR>
**To develop a Matter application with Silicon Labs please start here: [Silicon Labs Matter Table of Contents](./docs/silabs/README.md)**

---


[![Builds](https://github.com/project-chip/connectedhomeip/workflows/Builds/badge.svg)](https://github.com/project-chip/connectedhomeip/actions/workflows/build.yaml)
Expand Down
17 changes: 9 additions & 8 deletions docs/silabs/OVERVIEW.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
[<< Back to TOC](./README.md)

# Silicon Labs Matter Repo Overview

Welcome to the Silicon Labs Matter Repo. For more information on Matter in general please checkout the main Matter Overview page located here [Matter Overview](../../README.md)
Welcome to the Silicon Labs Matter Repo. For more information on Matter in general see the main [Matter Overview](../../README.md) page.

Silicon Labs supports Matter on both 802.15.4 (Thread) and 802.11 (Wi-Fi) transport protocols.

Silicon Labs supports Matter on both 802.15.4 (Thread) and 802.11 (Wifi) transport protocols.
This Repo is the starting point for all Silicon Labs-related Matter development. In this repo you will find documentation, demos, examples and all the code needed for Matter Accessory Device development on both Thread and .

This Repo is the starting point for all Silicon Labs related Matter development. In this repo you will find documentation, demos, examples and all the code needed for Matter Accessory Device development on both Thread and Wifi.
The Thread and development use cases differ because the Thread protocol requires the use of an Open Thread Border Router (OTBR).

The Thread and Wifi development use cases differ because the Thread protocol requires the use of an Open Thread Border Router (OTBR).
The Thread demo and development use case is described in the Thread section of this documentation located here: [Matter Thread](./thread/THREAD.md)

The Thread development use case is described in the Thread section of this documentation located here: [Matter Thread](./thread/THREAD.md)
The Wi-Fi demo and development use case is described in the Wi-Fi section of this documentation located here: [Matter Wi-Fi](./wifi/WIFI.md)

The Wifi development use case is described in the Wifi section of this documentation located here: [Matter Wifi](./wifi/WIFI.md)
----
[Table of Contents](./README.md) | [Thread Demo](./thread/DEMO_OVERVIEW.md) | [Wi-Fi Demo](./wifi/DEMO_OVERVIEW.md)
16 changes: 9 additions & 7 deletions docs/silabs/general/ARTIFACTS.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
[<< Back to TOC](../README.md)


# Matter Software Artifacts
This page provides links to pre-built software image "artifacts" that can be used to set up the Matter Demo for the Thread and Wifi use cases.
This page provides links to pre-built software image "artifacts" that can be used to set up the Matter Demo for the Thread and Wi-Fi use cases.

<br>

## Matter Hub Raspberry Pi Image
The Matter Hub image is intended to be flashed onto an SD card for a Raspberry Pi. The Matter Hub Image provides both an Open Thread Border Router and the Matter "ChipTool". Please download the Matter Hub Raspberry Pi image here. Note the image is ~10GB in size so depending on your internet connection this download may take some time.
The Matter Hub image is intended to be flashed onto an SD card for a Raspberry Pi. The Matter Hub Image provides both an Open Thread Border Router and the Matter "ChipTool". Note the image is ~10GB in size so depending on your internet connection this download may take some time. Start the Matter Hub Raspberry Pi image download here:

https://www.silabs.com/documents/public/software/SilabsMatterPi.zip

<br>

## Radio Co-Processor (RCP) Images
The Radio Co-Processor firmware is used to turn an EFR into an RCP that can be used with a Raspberry Pi to allow the Raspberry Pi's Open Thread Border Router to access the Thread network. Radio Co-Processor (RCP) images are available in the Assets section of this page, here:
The Radio Co-Processor firmware is used to turn an EFR into an RCP that can be used with a Raspberry Pi to allow the Raspberry Pi's Open Thread Border Router to access the Thread network. Radio Co-Processor (RCP) images are available in the Assets section of this page:

https://github.com/SiliconLabs/matter/releases/tag/v0.1.0

Expand All @@ -34,7 +34,9 @@ Matter Chip Tool .apk file is located here: http://silabs.com
-->

## RS9116 Firmware
The RS9116 firmware is used to update the RS9116.
RS9116 Firmware is located in GitHub here:
The RS9116 firmware is used to update the RS9116, and is located in GitHub here:

https://github.com/SiliconLabs/wiseconnect-wifi-bt-sdk/tree/2.5.0/firmware

https://github.com/SiliconLabs/wiseconnect-wifi-bt-sdk/tree/2.5.0/firmware
----
[Table of Contents](../README.md) | [Thread Demo](../thread/DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
5 changes: 3 additions & 2 deletions docs/silabs/general/COMMIT_HASHES.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
[<< Back to TOC](../README.md)

# Matter Repositories and Commit Hashes

The following repositories, branches and commit hashes are to be used together
Expand Down Expand Up @@ -28,3 +26,6 @@ in this release of the Silicon Labs Matter Out of Box Experience
| Repo | Branch | Commit Hash |
| ----------------------------------------------- | ------ | ---------------------------------------- |
| https://github.com/SiliconLabs/matter | \<this branch\> | \<this commit\> |

----
[Table of Contents](../README.md) | [Thread Demo](../thread/DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
5 changes: 3 additions & 2 deletions docs/silabs/general/FIND_RASPI.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
[<< Back to TOC](../README.md)

# How to find your Raspberry Pi on the Network

## Finding the IP address of your Raspberry Pi
Expand All @@ -21,3 +19,6 @@ Sometimes it can be difficult to find your Raspberry Pi on the network. One way
| Platform | Strategy |
| -------- | -------- |
| Mac / Linux / Windows | Once you have found your Raspberry Pi's IP address, you can use Secure Shell (SSH) to connect to it over the command line with the following command: <br> &emsp; `ssh <raspberry pi's username>@<raspberry pi's IP address>` <br><br> Example: <br> &emsp; `ssh ubuntu@10.4.148.44` <br> &emsp;`password: raspberrypi` <br><br> When prompted provide the raspberry pi's password, in the case of the Silicon Labs Matter Hub image the username is ***ubuntu*** and the password is ***raspberrypi*** |

----
[Table of Contents](../README.md) | [Thread Demo](../thread/DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
5 changes: 3 additions & 2 deletions docs/silabs/general/FLASH_SILABS_DEVICE.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
[<< Back to TOC](../README.md)

# How to Flash a Silicon Labs Device

Once you have an image built, you can flash it onto your EFR device (either a EFR32 development board or the Thunderboard Sense 2) over USB connected to your development machine. This can be done using either Simplicity Studio or the standalone Simplicity Commander.
Expand All @@ -14,3 +12,6 @@ A link to download Simplicity Commander's standalone version is located along wi
Simplicity Studio is a complete development environment and tool suite. It has the ability to discover USB connected development boards and flash them.
- [Download Simplicity Studio](https://www.silabs.com/developers/simplicity-studio)
- [Simplicity Studio Reference Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-building-and-flashing/flashing)

----
[Table of Contents](../README.md) | [Thread Demo](../thread/DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
5 changes: 3 additions & 2 deletions docs/silabs/general/ZAP.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
[<< Back to TOC](../README.md)

# ZCL Advanced Platform (ZAP) Tool for Matter

## Overview
Expand Down Expand Up @@ -159,3 +157,6 @@ Then click generate in the top menu bar. The user will be prompted to choose a
save location for the generated ZAP code. In the Silicon Labs Matter repository,
the lock-app generated files belong in
matter/zzz_generated/lock-app/zap-generated .

----
[Table of Contents](../README.md) | [Thread Demo](../thread/DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
18 changes: 10 additions & 8 deletions docs/silabs/thread/BUILD_FLASH_MAD.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
[<< Back to TOC](../README.md)

# How to Build and Flash the Matter Accessory Device (MAD)

The Matter Accessory Device, such as the lighting-app, is the actual Matter
Expand All @@ -11,15 +9,15 @@ Chip-Tool.
We have provided two ways to get the required image to flash the MAD. You can
use one of the following options:

1. Using the pre-built image file
2. Building the image file from the '`connectedhomeip`' repository
1. Use the pre-built image file
2. Build the image file from the '`connectedhomeip`' repository

<br>

### **Using the Pre-Built Image File**

All of the Matter Accessory Device image files are accessible through the
[Matter Artifacts Page](../general/ARTIFACTS.md). If you are using the pre-built
[Matter Artifacts Page](../general/ARTIFACTS.md). If you are using a pre-built
image file, you can skip forward to Step #2: Flashing the MAD.

<br>
Expand All @@ -28,13 +26,13 @@ image file, you can skip forward to Step #2: Flashing the MAD.

**1. Clone the Silicon Labs Matter repository**

Since you are reading this documentation it is assumed that you have already cloned the Silicon Labs Matter GitHub repository and have the right branch. If you have not you can follow the directions below.
You should have already cloned the Silicon Labs Matter GitHub repository and have the right branch as part of building an RCP image. If you have not, you can follow the directions below.

The Silicon Labs Matter repo is located in Github here:
https://github.com/SiliconLabs/matter.

In order to clone the Matter repo you'll need to have Git installed on your
local machine. Once you have Git installed you can use the following command:
You must have Git installed on your
local machine. To clone the repo use the following command:

> `$ git clone https://github.com/SiliconLabs/matter.git`
Expand Down Expand Up @@ -68,3 +66,7 @@ the following instructions:
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.


----
[Table of Contents](../README.md) | [Thread Demo](./DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
5 changes: 3 additions & 2 deletions docs/silabs/thread/CHIP_TOOL.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
[<< Back to TOC](../README.md)

# Using the ChipTool

The following commands show how to start a new Thread network from the local
Expand Down Expand Up @@ -178,3 +176,6 @@ and rename the following alias to your liking.
> `$ alias mattertool=‘source $HOME/scripts/matterTool.sh’` <br>
> `$ alias otbrsetup=‘source $HOME/scripts/setupOTBR.sh’`
----
[Table of Contents](../README.md) | [Thread Demo](./DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
47 changes: 24 additions & 23 deletions docs/silabs/thread/DEMO_OVERVIEW.md
Original file line number Diff line number Diff line change
@@ -1,57 +1,55 @@
[<< Back to TOC](../README.md)
# Matter over Thread Demo Overview

# Matter Demo over Thread Overview

This guide goes through the steps for running an example lighting-app for Matter
over Thread. Please look at [this](THREAD.md) file for an introduction to the
This section reviews the steps for running an example lighting-app for Matter
over Thread. See [this file](THREAD.md) for an introduction to the
Matter over Thread setup.

At a high level, we will walk through starting a thread network, commissioning a
new device to the thread network using BLE, and finally sending a basic OnOff
command to the end device.
At a high level, we will walk through starting a Thread network, commissioning a
new device to the Thread network using Bluetooth LE, and finally sending a basic
OnOff command to the end device.

<br>

## Step 0: Prerequisites
## Prerequisites

Before beginning your Matter project, consider the
[Matter Hardware and Software Prerequisites](./THREAD_PREREQS.md). Here you will find all the information you need on Silicon Labs hardware supported for Matter development.
Before beginning your Matter project, you should have the software and systems described in
[Matter Hardware and Software Prerequisites](./THREAD_PREREQS.md).

<br>

## Step 1: Setting up the Matter Hub (Raspberry Pi)

The Matter Hub consists of the OTBR and the ChipTool running on a Raspberry Pi.
Silicon Labs has developed a Raspberry Pi image which can be downloaded and
flashed onto an SD Card that is then to be inserted into the Raspberry Pi.
Silicon Labs has developed a Raspberry Pi image that can be downloaded and
flashed onto an SD Card, which is then inserted into the Raspberry Pi.

The Matter Controller sends IPv6 packets to the OTBR, which converts the IPv6
packets into Thread packets. The Thread packets are then routed to the Silicon
Labs end device.

Please refer to this guide for the setup:
[How to use Matter Hub \(Raspberry Pi\) Image](./RASPI_IMG.md)
See [How to use Matter Hub \(Raspberry Pi\) Image](./RASPI_IMG.md) for setup
instructions.

<br>

## Step 2: Build and Flash the RCP
## Step 2: Flash the RCP

The Radio Co-Processor (RCP) is a thread device that connects to the Raspberry
Pi via USB. First, to flash the RCP, it should be connected to your laptop via
USB. Thereafter, it should be connected to the Raspberry Pi via USB as well.
The Radio Co-Processor (RCP) is a Thread device that connects to the Raspberry
Pi via USB. To flash the RCP, connect it to your laptop via
USB. Thereafter, it should be connected to the Raspberry Pi via USB as well. Prebuilt RCP images are available for the demo

Information on building and flashing the RCP is located here:
Information on flashing and optionally building the RCP is located here:
[How To Build and Flash the RCP](RCP.md)

<br>

## Step 3: Build and Flash the MAD

The Matter Accessory Device (MAD) is the actual Matter device that will be
commissioned onto the Matter network and control using the ChipTool.
commissioned onto the Matter network and controlled using the ChipTool. Prebuilt MAD images are available for the demo.

Information on how to build and flash the Matter Accessory device is located
here: [How To Build and Flash the Matter Accessory Device](./MATTER_DEVICE.md)
Information on flashing and optionally building the Matter Accessory device is located
here: [How To Build and Flash the Matter Accessory Device](./BUILD_FLASH_MAD.md)

<br>

Expand All @@ -69,3 +67,6 @@ Pi image:
| mattertool off | Sends an **off** command to the MAD using ChipTool |

<br>

----
[Table of Contents](../README.md) | [Thread Demo](./DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
10 changes: 3 additions & 7 deletions docs/silabs/thread/FAQ.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,3 @@
[<< Back to TOC](../README.md)

<!-- - connecting raspi to netwrok
- why is mattertool not working:
- bad image
- image not flashed correctly -->

# Frequently Asked Questions for Matter over Thread

## Demo
Expand All @@ -31,3 +24,6 @@
[Raspberry Pi Remote Access](https://www.raspberrypi.com/documentation/computers/remote-access.html)

<br>

----
[Table of Contents](../README.md) | [Thread Demo](./DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
32 changes: 16 additions & 16 deletions docs/silabs/thread/RASPI_IMG.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
[<< Back to TOC](../README.md)

# Setting up the Matter Hub (Raspberry Pi)

The Matter Hub consists of the Open Thread Border Router and the ChipTool
running on a Raspberry Pi. Silicon Labs has developed a Raspberry Pi image which
The Matter Hub consists of the Open Thread Border Router (OTBR) and the ChipTool
running on a Raspberry Pi. Silicon Labs has developed a Raspberry Pi image that
can be downloaded and flashed onto an SD Card for the Raspberry Pi.

In short, the Matter Controller sends IPv6 packets to the OTBR, which converts
Expand All @@ -16,43 +14,42 @@ Silicon Labs end device.

<br>

The Raspberry Pi should be connected to a network - this could be ethernet or a
Wifi network.

Please refer to this page on how to connect your Raspberry Pi to a wifi network:
[Connecting Raspberry Pi to Wifi](https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-networking)

<br>

### Step 1. Raspberry Pi Image Download

The provided Raspberry Pi image is used as a Matter Controller with the OTBR.

The image can be downloaded from the
[Matter Artifacts page](../general/ARTIFACTS.md)

> Please note that this image, even when zipped up, is quite large ~10GB so this download will take a while if you are on a slow connection. This image includes both the Ubuntu operating system as well as the OTBR and Chip-Tool, so there is a lot of sofware pre-packaged in this image, hence the size.
<br>

### Step 2. Flashing your Raspberry Pi

[Raspberry Pi Disk Imager](https://www.raspberrypi.com/software/) can be used to
flash the SD Card which contains the operating system for the Raspberry Pi.
flash the SD Card that contains the operating system for the Raspberry Pi. Under Operating System select 'Use Custom' and then select the .img file.

Alternatively, a tool like [balenaEtcher](https://www.balena.io/etcher/) can be
used to flash the image to a micro SD card.

> After flashing the SD card, insert it into the Raspberry Pi and reset the
> Raspberry Pi. Then, wait at least 10 seconds for it to come up and start the
> Raspberry Pi by unplugging it from the power source and plugging it back in. Then, wait at least 10 seconds for it to come up and start the
> SSH server.
<br>

### Step 3. Finding your Raspberry Pi on the Network

Please see the [Finding Your Raspberry Pi page](../general/FIND_RASPI.md) for
The Raspberry Pi should be connected to a network - this could be Ethernet or a
Wi-Fi network.

The preference here is to use Ethernet, however if you are using Wi-Fi for your connection to the Raspberry Pi, please see [Connecting Raspberry Pi to Wi-Fi](https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-networking) for instructions on how to connect your Raspberry Pi to a Wi-Fi network.

Once you have connected your Raspberry Pi to the network, you will want to connect to your Raspberry Pi over SSH. In order to do this you will need the IP address of your Raspberry Pi. Please see the [Finding Your Raspberry Pi page](../general/FIND_RASPI.md) for
more information on finding the Raspberry Pi on the local network.

##### Raspberry Pi Login Credentials
#### Raspberry Pi Login Credentials

- user: **ubuntu**
- password: **raspberrypi**
Expand All @@ -70,3 +67,6 @@ application inside the Raspberry Pi image.

Please refer to the ChipTool page for information on using the Matter Hub with
`mattertool` commands: [ChipTool page](./CHIP_TOOL.md)

----
[Table of Contents](../README.md) | [Thread Demo](./DEMO_OVERVIEW.md) | [Wi-Fi Demo](../wifi/DEMO_OVERVIEW.md)
Loading

0 comments on commit ca46e18

Please sign in to comment.