boards/silabs/radio_boards/siwx917/doc/siwx917_rb4342a.rst
.. zephyr:board:: siwx917_rb4342a
Overview
The SiWx917-RB4342A (aka BRD4342A) 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.
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 BRD4342A board, refer to these documents:
SiWG917 Website_SiWG917 Datasheet_SiWG917 Reference Manual_BRD4342A Website_BRD4342A User Guide_.. zephyr:board-supported-hw::
Refer to the :ref:siwx917_wifi_features page for a list of supported Wi-Fi features.
Programming and Debugging
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_rb4342a 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_rb4342a :goals: flash
Open a serial terminal (minicom, putty, etc.) with the following settings:
Reset the board and you should see the following message in the terminal:
.. code-block:: console
Hello World! siwx917_rb4342a
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
.. _BRD4342A Website: https://www.silabs.com/development-tools/wireless/wi-fi/siwx91x-rb4342a-wifi-6-bluetooth-le-soc-radio-board
.. _BRD4342A User Guide: https://www.silabs.com/documents/public/user-guides/ug564-brd4342a-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