From 03b7c568edc8e8bba2a152be47cdeeb40b538275 Mon Sep 17 00:00:00 2001 From: Ezra Hale Date: Fri, 5 May 2023 19:34:15 +0000 Subject: [PATCH] Pull request #752: Final doc pass for v2.0.0-1.1 Merge in WMN_TOOLS/matter from feature/final_doc_pass_for_2.0.0-1.1 to silabs Squashed commit of the following: commit befe098f6631ac35e9e208c05b4307ffd3db1d01 Author: Ezra Hale Date: Fri May 5 19:31:13 2023 +0000 Applied suggestion commit 11aa74474678080709bbaf9f084ed3cc332bf961 Author: Chirag Bansal Date: Fri May 5 19:29:19 2023 +0000 Applied suggestion commit 853b72522e818c862428f7e0640a04a1dea0f7e2 Author: Chirag Bansal Date: Fri May 5 19:29:05 2023 +0000 Applied suggestion ... and 5 more commits --- docs/silabs/general/ARTIFACTS.md | 10 +++++----- docs/silabs/general/COMMIT_HASHES.md | 6 ++++++ docs/silabs/general/OTA_BOOTLOADER.md | 2 +- docs/silabs/general/SOFTWARE_REQUIREMENTS.md | 4 +++- docs/silabs/wifi/RUN_DEMO_SiWx917_SoC.md | 8 ++++---- docs/silabs/wifi/SW_SETUP.md | 8 ++++---- docs/silabs/wifi/SiWx917_SoC_FWUpdate.md | 4 +++- 7 files changed, 26 insertions(+), 16 deletions(-) diff --git a/docs/silabs/general/ARTIFACTS.md b/docs/silabs/general/ARTIFACTS.md index 2e0c02707e5475..8bb546a90c8262 100644 --- a/docs/silabs/general/ARTIFACTS.md +++ b/docs/silabs/general/ARTIFACTS.md @@ -11,7 +11,7 @@ Matter chip-tool. 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_1.1.0-1.1.zip +https://www.silabs.com/documents/public/software/SilabsMatterPi_2.0.0-1.1.zip ## Radio Co-Processor (RCP) Images @@ -20,7 +20,7 @@ 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/v1.1.0-1.1 +https://github.com/SiliconLabs/matter/releases/tag/v2.0.0-1.1 ## Matter Accessory Device Images @@ -28,7 +28,7 @@ The Matter Accessory Device Images are used to turn an EFR into a Matter device. These are pre-built binary images for the Matter Demo. Matter Accessory Device Images are located in the Assets section of this page: -https://github.com/SiliconLabs/matter/releases/tag/v1.1.0-1.1 +https://github.com/SiliconLabs/matter/releases/tag/v2.0.0-1.1 For Matter over Thread, 3 different types of images are provided: @@ -43,7 +43,7 @@ EFR32MG2x device, you will need to flash a bootloader binary on your device alon with the application image. Bootloader binaries for all of the Matter supported devices are available here: -https://github.com/SiliconLabs/matter/releases/tag/v1.1.0-1.1 +https://github.com/SiliconLabs/matter/releases/tag/v2.0.0-1.1 ## RS9116 Firmware @@ -67,7 +67,7 @@ be configured for the SiWx917 SoC device by following the instructions on the [O The **JLinkDevices.xml** and **ELF** files referenced in the instructions may be found in the Assets section of this page: -https://github.com/SiliconLabs/matter/releases/tag/v1.1.0-1.1 +https://github.com/SiliconLabs/matter/releases/tag/v2.0.0-1.1 --- diff --git a/docs/silabs/general/COMMIT_HASHES.md b/docs/silabs/general/COMMIT_HASHES.md index 7a18c1ab879e29..f3451b1c1d4b87 100644 --- a/docs/silabs/general/COMMIT_HASHES.md +++ b/docs/silabs/general/COMMIT_HASHES.md @@ -15,6 +15,12 @@ in this release of the Silicon Labs Matter Out of Box Experience | --------------------------------------- | ------ | ---------------------------------------- | | https://github.com/SiliconLabs/ot-efr32 | main | 7a567da02a078546eb34136c1c44170c8832dd55 | +## Connectivity Standards Alliance (CSA) connectedhomeip (Matter) + +| Repo | Branch | Commit Hash | +| ----------------------------------------------- | ------ | ---------------------------------------- | +| https://github.com/project-chip/connectedhomeip | v1.1-branch | 8f66f4215bc0708efc8cc73bda80620e67d8955f | + ## Matter chip-tool | Repo | Branch | Commit Hash | diff --git a/docs/silabs/general/OTA_BOOTLOADER.md b/docs/silabs/general/OTA_BOOTLOADER.md index 8395a0c54a0932..b04dd07b331e32 100644 --- a/docs/silabs/general/OTA_BOOTLOADER.md +++ b/docs/silabs/general/OTA_BOOTLOADER.md @@ -146,7 +146,7 @@ on BRD4186C. - Build the application disabling all optional features ```shell - $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out lighting-app BRD4186A chip_detail_logging=false chip_automation_logging=false chip_progress_logging=false is_debug=false show_qr_code=false chip_build_libshell=false enable_openthread_cli=false chip_openthread_ftd=true + $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/silabs/efr32/ out lighting-app BRD4186A chip_detail_logging=false chip_automation_logging=false chip_progress_logging=false is_debug=false show_qr_code=false chip_build_libshell=false enable_openthread_cli=false chip_openthread_ftd=true ``` - Build the GBL file for the update image and note its size diff --git a/docs/silabs/general/SOFTWARE_REQUIREMENTS.md b/docs/silabs/general/SOFTWARE_REQUIREMENTS.md index 4957d7dd48f90e..483b6545a72225 100644 --- a/docs/silabs/general/SOFTWARE_REQUIREMENTS.md +++ b/docs/silabs/general/SOFTWARE_REQUIREMENTS.md @@ -163,7 +163,9 @@ Pre-Built SiWx917 firmware is available under `third_party/silabs/wisemcu-wifi-b 1. [Setting up TeraTerm](https://docs.silabs.com/SiWx917/wiseconnect/2.0/tera-term-setup) 2. For updating the SiWx917 NCP Firmware, refer [Updating the RS9116 Firmware](https://docs.silabs.com/rs9116/wiseconnect/2.0/update-evk-firmware). Instructions are the same for both SiWx917 and RS9116. -3. For updating the SiWx917 SoC Firmware, refer [Updating the SiWx917 SoC Firmware](../wifi/SiWx917_SoC_FWUpdate.md) +3. For updating the SiWx917 SoC Firmware, you have several options outlined here: + - [Updating the SiWx917 SoC Firmware using Simplicity Commander](../wifi/RUN_DEMO_SiWx917_SoC.md) + - [Updating the SiWx917 SoC Firmware using Tera Term (Legacy Mode)](../wifi/SiWx917_SoC_FWUpdate.md) --- diff --git a/docs/silabs/wifi/RUN_DEMO_SiWx917_SoC.md b/docs/silabs/wifi/RUN_DEMO_SiWx917_SoC.md index 37b404fa848167..b5dc60d24a3405 100644 --- a/docs/silabs/wifi/RUN_DEMO_SiWx917_SoC.md +++ b/docs/silabs/wifi/RUN_DEMO_SiWx917_SoC.md @@ -1,9 +1,9 @@ # Running the Matter Demo over Wi-Fi for SiWx917 SoC -## Flashing Images/Binaries on the SiWx917 SoC platform using Ozone +## Flashing Images/Binaries on the SiWx917 SoC platform using Ozone or Simplicity Studio and Simplicity Commander > **Note:** -> 1. SiWx917 SoC device support is available in the latest Simplicity Studio and Simplicity Commander(versions 1v14p5 and above). To flash the application on SiWx917 SoC, +> 1. SiWx917 SoC device support is available in the latest Simplicity Studio and Simplicity Commander(versions 1v14p5 and above). To flash the TA Firmware/Matter application on SiWx917 SoC, > - Convert the .s37 file into .rps file using the below command, > > `commander rps create .rps --app .s37` @@ -18,9 +18,9 @@ ![SiWx917 soc Device](./images/SiWx917_Radio_WSTK.png) -1. Launch the Ozone Debugger. +2. Launch the Ozone Debugger. -2. In the **New Project Wizard**: +3. In the **New Project Wizard**: - Click the three dots (`...`) on the **Device** tab and select the **Manufacturer** as `Silicon Labs`. - Select the **Device** as `Si917DualFlash`. diff --git a/docs/silabs/wifi/SW_SETUP.md b/docs/silabs/wifi/SW_SETUP.md index aad74a4bc7f1d1..2e54286cb2d028 100644 --- a/docs/silabs/wifi/SW_SETUP.md +++ b/docs/silabs/wifi/SW_SETUP.md @@ -122,7 +122,7 @@ Enable or disable the lighting application's features using the following flags. 1. `rs91x_wpa3_only` : Use this flag while building to enable wpa3 mode in rs91x wifi chip. ```shell - $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx rs91x_wpa3_only=true --wifi rs9116 |& tee out/rs911x_lighting.log + $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/silabs/efr32/ out/rs911x_lighting BRD41xxx rs91x_wpa3_only=true --wifi rs9116 |& tee out/rs911x_lighting.log ``` > **Note:** @@ -132,12 +132,12 @@ Enable or disable the lighting application's features using the following flags. 2. `segger_rtt_buffer_size_up` : Flag to get the complete logs without truncation. ```shell - $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx segger_rtt_buffer_size_up=2068 --wifi rs9116 |& tee out/rs911x_lighting.log + $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/silabs/efr32/ out/rs911x_lighting BRD41xxx segger_rtt_buffer_size_up=2068 --wifi rs9116 |& tee out/rs911x_lighting.log ``` 3. `show_qr_code=false` : Use this flag while building to disable QR code. ```shell - $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx show_qr_code=false --wifi rs9116 |& tee out/rs911x_lighting.log + $ ./scripts/examples/gn_efr32_example.sh examples/lighting-app/silabs/efr32/ out/rs911x_lighting BRD41xxx show_qr_code=false --wifi rs9116 |& tee out/rs911x_lighting.log ``` > **Note:** > 1. QR code is enabled by default for all except MG24 @@ -146,7 +146,7 @@ Enable or disable the lighting application's features using the following flags. 4. `chip_enable_wifi_ipv4` : Use this flag while building to enable IPV4 (disabled by default). ```shell - ./scripts/examples/gn_efr32_example.sh examples/lighting-app/efr32/ out/rs911x_lighting BRD41xxx chip_enable_wifi_ipv4=true --wifi rs9116 |& tee out/rs911x_lighting.log + ./scripts/examples/gn_efr32_example.sh examples/lighting-app/silabs/efr32/ out/rs911x_lighting BRD41xxx chip_enable_wifi_ipv4=true --wifi rs9116 |& tee out/rs911x_lighting.log ``` The generated software can be found in diff --git a/docs/silabs/wifi/SiWx917_SoC_FWUpdate.md b/docs/silabs/wifi/SiWx917_SoC_FWUpdate.md index f56620d9f16d45..7b99c7a08abd41 100644 --- a/docs/silabs/wifi/SiWx917_SoC_FWUpdate.md +++ b/docs/silabs/wifi/SiWx917_SoC_FWUpdate.md @@ -1,4 +1,6 @@ -# Updating SiWx917 SoC Firmware +# Updating SiWx917 SoC Firmware using Tera Term + +> Please note that the method of updating the SiWx917 SoC firmware listed below is considered a legacy mode of operation. You may also update the SiWx917 SoC firmware using Simplicity Commander. For instructions on how to do this please consider [Running Demo on the SiWx917SoC](./RUN_DEMO_SiWx917_SoC.md) ## Steps to update the firmware on SiWx917 SoC radio board