boards/silabs/radio_boards/xg23_rb4210a/doc/index.rst
.. zephyr:board:: xg23_rb4210a
Overview
The EFR32ZG23 Radio Board is the radio board delivered with
xG23-PK6068A Website_. It contains a Wireless System-On-Chip from the
EFR32ZG23 family built on an ARM Cortex®-M33 processor with excellent low
power capabilities.
The BRD4210A a.k.a. xG23-RB4210A radio board plugs into the Wireless Pro Kit
Mainboard BRD4002A and is supported as one of :ref:silabs_radio_boards.
Hardware
For more information about the EFR32ZG23 SoC and BRD4210A board, refer to these documents:
EFR32ZG23 Website_EFR32ZG23 Datasheet_EFR32xG23 Reference Manual_xG23-PK6068A Website_BRD4210A 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 | +=======+=============+=====================================+ | PA8 | EUSART0_TX | UART Console TX | +-------+-------------+-------------------------------------+ | PA9 | EUSART0_RX | UART Console RX | +-------+-------------+-------------------------------------+ | PB0 | GPIO | Board Controller Enable | +-------+-------------+-------------------------------------+ | PB1 | GPIO | Push Button 0 | +-------+-------------+-------------------------------------+ | PB2 | GPIO | LED0 | +-------+-------------+-------------------------------------+ | PB3 | GPIO | Push Button 1 | +-------+-------------+-------------------------------------+ | PC1 | EUSART1_TX | Display/Flash SPI MOSI | +-------+-------------+-------------------------------------+ | PC2 | EUSART1_RX | Flash SPI MISO | +-------+-------------+-------------------------------------+ | PC3 | EUSART1_CLK | Display/Flash SPI Clock | +-------+-------------+-------------------------------------+ | PC4 | GPIO | Flash SPI Chip Select | +-------+-------------+-------------------------------------+ | PC5 | I2C0_SCL | Si7021 I2C Clock | +-------+-------------+-------------------------------------+ | PC6 | GPIO | Display COM Inversion | +-------+-------------+-------------------------------------+ | PC7 | I2C0_SDA | Si7021 I2C Data | +-------+-------------+-------------------------------------+ | PC8 | GPIO | Display SPI Chip Select | +-------+-------------+-------------------------------------+ | PC9 | GPIO | Display/Si7021 Enable | +-------+-------------+-------------------------------------+ | PD3 | GPIO | LED1 | +-------+-------------+-------------------------------------+
The default configuration can be found in
:zephyr_file:boards/silabs/radio_boards/xg23_rb4210a/xg23_rb4210a_defconfig
The EFR32ZG23 SoC is configured to use the 39 MHz external oscillator on the board.
The EFR32ZG23 SoC has one USART and three EUSARTs. USART0 is connected to the board controller and is used for the console.
Programming and Debugging
.. zephyr:board-supported-runners::
Connect the BRD4002A board with a mounted BRD4210A 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: xg23_rb4210a :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! xg23_rb4210a/efr32zg23b020f512im48
.. _xG23-PK6068A Website: https://www.silabs.com/development-tools/wireless/efr32xg23-pro-kit-20-dbm
.. _BRD4210A User Guide: https://www.silabs.com/documents/public/user-guides/ug507-brd4210a-user-guide.pdf
.. _EFR32ZG23 Website: https://www.silabs.com/wireless/z-wave/800-series-modem-soc
.. _EFR32ZG23 Datasheet: https://www.silabs.com/documents/public/data-sheets/efr32zg23-datasheet.pdf
.. _EFR32xG23 Reference Manual: https://www.silabs.com/documents/public/reference-manuals/efr32xg23-rm.pdf