1.. zephyr:board:: xg23_rb4210a
2
3Overview
4********
5
6The EFR32ZG23 Radio Board is the radio board delivered with
7`xG23-PK6068A Website`_. It contains a Wireless System-On-Chip from the
8EFR32ZG23 family built on an ARM Cortex®-M33 processor with excellent low
9power capabilities.
10
11The BRD4210A a.k.a. xG23-RB4210A radio board plugs into the Wireless Pro Kit
12Mainboard BRD4002A and is supported as one of :ref:`silabs_radio_boards`.
13
14Hardware
15********
16
17- EFR32ZG23B020F512IM48 SoC
18- CPU core: ARM Cortex®-M33 with FPU
19- Flash memory: 512 kB
20- RAM: 64 kB
21- Transmit power: up to +20 dBm
22- Operation frequency: 868-915 MHz
23- Crystals for LFXO (32.768 kHz) and HFXO (39 MHz).
24
25For more information about the EFR32ZG23 SoC and BRD4210A board, refer to these
26documents:
27
28- `EFR32ZG23 Website`_
29- `EFR32ZG23 Datasheet`_
30- `EFR32xG23 Reference Manual`_
31- `xG23-PK6068A Website`_
32- `BRD4210A User Guide`_
33
34Supported Features
35==================
36
37The board configuration supports the following hardware features:
38
39+-----------+------------+-------------------------------------+
40| Interface | Controller | Driver/Component                    |
41+===========+============+=====================================+
42| MPU       | on-chip    | memory protection unit              |
43+-----------+------------+-------------------------------------+
44| NVIC      | on-chip    | nested vector interrupt controller  |
45+-----------+------------+-------------------------------------+
46| SYSTICK   | on-chip    | systick                             |
47+-----------+------------+-------------------------------------+
48| COUNTER   | on-chip    | stimer                              |
49+-----------+------------+-------------------------------------+
50| FLASH     | on-chip    | flash memory                        |
51+-----------+------------+-------------------------------------+
52| GPIO      | on-chip    | gpio                                |
53+-----------+------------+-------------------------------------+
54| UART      | on-chip    | serial                              |
55+-----------+------------+-------------------------------------+
56| DMA       | on-chip    | ldma                                |
57+-----------+------------+-------------------------------------+
58| I2C       | on-chip    | i2c                                 |
59+-----------+------------+-------------------------------------+
60| SPI       | on-chip    | spi                                 |
61+-----------+------------+-------------------------------------+
62| TRNG      | on-chip    | semailbox                           |
63+-----------+------------+-------------------------------------+
64| WATCHDOG  | on-chip    | watchdog                            |
65+-----------+------------+-------------------------------------+
66
67Other hardware features are currently not supported by the port.
68
69Connections and IOs
70===================
71
72In the following table, the column **Name** contains Pin names. For example, PA2
73means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
74
75+-------+-------------+-------------------------------------+
76| Name  | Function    | Usage                               |
77+=======+=============+=====================================+
78| PB2   | GPIO        | LED0                                |
79+-------+-------------+-------------------------------------+
80| PD3   | GPIO        | LED1                                |
81+-------+-------------+-------------------------------------+
82| PB1   | GPIO        | Push Button 0                       |
83+-------+-------------+-------------------------------------+
84| PB3   | GPIO        | Push Button 1                       |
85+-------+-------------+-------------------------------------+
86| PB0   | GPIO        | Board Controller Enable             |
87|       |             | VCOM_ENABLE                         |
88+-------+-------------+-------------------------------------+
89| PA8   | USART0_TX   | UART Console VCOM_TX US0_TX         |
90+-------+-------------+-------------------------------------+
91| PA9   | USART0_RX   | UART Console VCOM_RX US0_RX         |
92+-------+-------------+-------------------------------------+
93
94The default configuration can be found in
95:zephyr_file:`boards/silabs/radio_boards/xg23_rb4210a/xg23_rb4210a_defconfig`
96
97System Clock
98============
99
100The EFR32ZG23 SoC is configured to use the 39 MHz external oscillator on the
101board.
102
103Serial Port
104===========
105
106The EFR32ZG23 SoC has one USART and three EUSARTs.
107USART0 is connected to the board controller and is used for the console.
108
109Programming and Debugging
110*************************
111
112Flashing
113========
114
115Connect the BRD4002A board with a mounted BRD4210A radio module to your host
116computer using the USB port.
117
118Here is an example for the :zephyr:code-sample:`hello_world` application.
119
120.. zephyr-app-commands::
121   :zephyr-app: samples/hello_world
122   :board: xg23_rb4210a
123   :goals: flash
124
125Open a serial terminal (minicom, putty, etc.) with the following settings:
126
127- Speed: 115200
128- Data: 8 bits
129- Parity: None
130- Stop bits: 1
131
132Reset the board and you should see the following message in the terminal:
133
134.. code-block:: console
135
136   Hello World! xg23_rb4210a/efr32zg23b020f512im48
137
138
139.. _xG23-PK6068A Website:
140   https://www.silabs.com/development-tools/wireless/efr32xg23-pro-kit-20-dbm
141
142.. _BRD4210A User Guide:
143   https://www.silabs.com/documents/public/user-guides/ug507-brd4210a-user-guide.pdf
144
145.. _EFR32ZG23 Website:
146   https://www.silabs.com/wireless/z-wave/800-series-modem-soc
147
148.. _EFR32ZG23 Datasheet:
149   https://www.silabs.com/documents/public/data-sheets/efr32zg23-datasheet.pdf
150
151.. _EFR32xG23 Reference Manual:
152   https://www.silabs.com/documents/public/reference-manuals/efr32xg23-rm.pdf
153