.. 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`_


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
*************************

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_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:

- 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_rb4342a


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

.. _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