Getting Started with WiSeConnect™ SDK v3.x in SoC Mode#

This guide describes how to get started with running the out-of-box demo for the SiWx91x™ chipset family using the WiSeConnect™ SDK v3.x in System-on-chip (SoC) mode, where both the application and the connectivity stack run on the SiWx91x chipset.

Note: If you wish to develop an application, you may skip this page and go to one of the following guides:
Developing with Radio Boards in SoC Mode
Developing with ICs (with custom boards)

Check Prerequisites#

Hardware#

Wi-Fi Access Point (802.11 ax/b/g/n)
BRD4002A - Si-MB4002A Wireless Pro Kit Mainboard (hereafter referred to as WPK board).
One of the following SoC radio boards (hereafter referred to as SiWx917 radio board):
- BRD4338A - SiWx917 Wi-Fi 6 and Bluetooth LE 8MB Flash Radio Board
- BRD4342A - SiWx917 Wi-Fi 6 and Bluetooth LE 8MB Flash + 8MB ext PSRAM Radio Board
USB power source (for e.g., a computer)
Type C USB cable compatible with the USB power source (for e.g., type C to type A in case of a computer with a type A USB port).
Android smartphone or iPhone

Note: The following pro kits come with the BRD4002A and specific SiWx917 radio boards mentioned above:
SiWx917-PK6031A - SiWx917 Wi-Fi 6 and Bluetooth LE 8MB Flash Pro-Kit (BRD4002A + BRD4338A)
SiWx917-PK6032A - SiWx917 Wi-Fi 6 and Bluetooth LE 8MB Flash + ext 8MB PSRAM Pro-Kit (BRD4002A + BRD4342A)

Software#

Silicon Labs EFR Connect App for Android or iPhone

Run the Demo#

The out-of-box demo is pre-flashed on your SiWx917 radio board.

In this demo, you use the the Silicon Labs EFR Connect App to connect to your SiWx91x device over Bluetooth Low Energy (BLE), commission your SiWx91x device to a Wi-Fi network, and exchange data with your SiWx91x device.

Plug the SiWx917 radio board into the radio board connectors of the WPK board as shown below.
Power on the WPK board by connecting it to a USB power source such as a computer.
Note: If you have an older SiWx917 SoC radio board, you may not have the out-of-box demo pre-flashed on your board. To verify this, check for messages on the board's liquid crystal display (LCD) screen when you plug the radio board into a power source.
```
Wireless interface initialized successfully

BLE advertising started

Device name: BLE_CONFIGURATOR
```
If the expected messages don't appear, flash the latest software to your board before running the demo:
- Download the out-of-box demo binary from the WiseConnect SDK v3.x github repo.
- Follow the instructions on the Developing with Radio Boards in SoC Mode page to:
  - Install Simplicity Studio
  - Connect the SiWx917 board to your computer
  - Upgrade to the latest MBR version if necessary. See the TA Flash Memory Map Change Guide for details.
  - Update the SiWx917 connectivity firmware. Note that you must update your connectivity firmware to a compatible version before proceeding further.
  - Flash the out-of-box demo binary as described in the Flash an Application Binary section. Note that only .rps format application images can be flashed on the SiWx917 SoC chipset.
Run the demo by following the instructions in the README page of the out-of-box-demo example in the WiSeConnect SDK v3.x github repo starting from the Run the Application section.

Note: See the troubleshoot demo run section in case of any issues while running the application.