boards/silabs/explorer_kits/xg22/doc/bg22_ek4108a.rst
.. zephyr:board:: bg22_ek4108a
Overview
The EFR32BG22 Explorer Kit (BG22-EK4108A) contains a Wireless System-On-Chip from the EFR32BG22 family built on an ARM Cortex®-M33 processor with excellent low power capabilities.
Hardware
For more information about the EFR32BG22 SoC and BRD4108A board, refer to these documents:
EFR32BG22 Website_EFR32BG22 Datasheet_EFR32xG22 Reference Manual_BRD4108A User Guide_.. zephyr:board-supported-hw::
In the following table, the column Name contains Pin names. For example, PA2 means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
+-------+-------------+-------------------------------------+ | Name | Function | Usage | +=======+=============+=====================================+ | PA4 | GPIO | LED0 | +-------+-------------+-------------------------------------+ | PC7 | GPIO | Push Button 0 | +-------+-------------+-------------------------------------+ | PA5 | USART1_TX | UART Console VCOM_TX US0_TX | +-------+-------------+-------------------------------------+ | PA6 | USART1_RX | UART Console VCOM_RX US0_RX | +-------+-------------+-------------------------------------+
The EFR32BG22 SoC is configured to use the 38.4 MHz external oscillator on the board, and can operate a clock speeds of up to 76.8 MHz.
The EFR32BG22 SoC has two USARTs and one EUART. USART1 is connected to the board controller and is used for the console.
Programming and Debugging
.. zephyr:board-supported-runners::
.. note:: Before using the kit the first time, you should update the J-Link firmware in Simplicity Studio.
The sample application :zephyr:code-sample:hello_world is used for this example.
Build the Zephyr kernel and application:
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: bg22_ek4108a :goals: build
Connect the bg22_ek4108a to your host computer using the USB port and you should see a USB connection.
Open a serial terminal (minicom, putty, etc.) with the following settings:
Reset the board and you'll see the following message on the corresponding serial port terminal session:
.. code-block:: console
Hello World! bg22_ek4108a/efr32bg22c224f512im40
To use the BLE function, run the command below to retrieve necessary binary blobs from the SiLabs HAL repository.
.. code-block:: console
west blobs fetch hal_silabs
Then build the Zephyr kernel and a Bluetooth sample with the following
command. The :zephyr:code-sample:bluetooth_observer sample application is used in
this example.
.. zephyr-app-commands:: :zephyr-app: samples/bluetooth/observer :board: bg22_ek4108a :goals: build
.. _EFR32BG22 Website: https://www.silabs.com/wireless/bluetooth/efr32bg22-series-2-socs#
.. _EFR32BG22 Datasheet: https://www.silabs.com/documents/public/data-sheets/efr32bg22-datasheet.pdf
.. _EFR32xG22 Reference Manual: https://www.silabs.com/documents/public/reference-manuals/efr32xg22-rm.pdf
.. _BRD4108A User Guide: https://www.silabs.com/documents/public/user-guides/ug509-bg22-ek4108a.pdf