ContextQMD
Back to Zephyr

Overview

boards/silabs/radio_boards/siwx917/doc/siwx917_rb4338a.rst

4.4.03.5 KB
Original Source

.. zephyr:board:: siwx917_rb4338a

Overview

The SiWx917-RB4338A (aka BRD4338A) radio board provides support for the Silicon Labs SiWG917 SoC. This board cannot be used stand-alone and requires a a Wireless Pro Kit_ Mainboard (Si-MB4002A aka BRD4002A), for power, debug options etc.

This board might be sold as a part of the SiWx917-PK6031A_ bundle ("SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash Pro Kit"), which includes the BRD4002A Mainboard in addition of the BRD4338A.

SiWG917 is an ultra-low power SoC that includes hardware support for Single-Band Wi-Fi 6 + Bluetooth LE 5.4, Matter...

Hardware

For more information about the SiWG917 SoC and BRD4338A board, refer to these documents:

  • SiWG917 Website_
  • SiWG917 Datasheet_
  • SiWG917 Reference Manual_
  • BRD4338A Website_
  • BRD4338A User Guide_

Supported Features

.. zephyr:board-supported-hw::

Refer to the :ref:siwx917_wifi_features page for a list of supported Wi-Fi features.

Programming and Debugging

.. zephyr:board-supported-runners::

Flashing

First, ensure Simplicity Commander_ is properly installed on the host.

The SiWG917 contains a Network Co-Processor (NWP). Ensure the NWP is flashed with the firmware associated with the current Zephyr version. The firmware is provided with the blobs of hal_silabs:

.. code-block:: console

west blobs fetch hal_silabs

Then, flash the firmware with:

.. code-block:: console

commander flash modules/hal/silabs/zephyr/blobs/wiseconnect/connectivity_firmware/standard/SiWG917-*.rps

This operation has to be done once, until the user update the Zephyr release.

Applications for the siwx917_rb4338a board can be built in the usual way. Then, connect the BRD4002A board with a mounted BRD4338A radio module to your host computer using the USB port.

Here is an example for the :zephyr:code-sample:hello_world application.

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: siwx917_rb4338a :goals: flash

Open a serial terminal (minicom, putty, etc.) with the following settings:

  • Speed: 115200
  • Data: 8 bits
  • Parity: None
  • Stop bits: 1

Reset the board and you should see the following message in the terminal:

.. code-block:: console

Hello World! siwx917_rb4338a

Debugging

Debuggning relies on JLink tool. JLink is not able to flash the firmware. So debug session has to be done in two steps. west flash will flash the firmware using Simplicity Commander. Then west attach will use JLink to attach to the board. The Zephyr image may has already booted when user runs west attach. User may execute monitor reset in the gdb prompt to reset the board.

.. _SiWx917-PK6031A: https://www.silabs.com/development-tools/wireless/wi-fi/siwx917-pk6031a-wifi-6-bluetooth-le-soc-pro-kit

.. _Wireless Pro Kit: https://www.silabs.com/development-tools/wireless/wireless-pro-kit-mainboard

.. _BRD4338A Website: https://www.silabs.com/development-tools/wireless/wi-fi/siwx917-rb4338a-wifi-6-bluetooth-le-soc-radio-board

.. _BRD4338A User Guide: https://www.silabs.com/documents/public/user-guides/ug562-brd4338a-user-guide.pdf

.. _SiWG917 Website: https://www.silabs.com/wireless/wi-fi/siwx917-wireless-socs

.. _SiWG917 Datasheet: https://www.silabs.com/documents/public/data-sheets/siwg917-datasheet.pdf

.. _SiWG917 Reference Manual: https://www.silabs.com/documents/public/reference-manuals/siw917x-family-rm.pdf

.. _Simplicity Commander: https://www.silabs.com/developer-tools/simplicity-studio/simplicity-commander