1.. zephyr:board:: xg24_rb4187c
2
3Overview
4********
5
6The EFR32MG24 Mighty Gecko Radio Board is one of the two
7radio boards delivered with `xG24-PK6010A Website`_. It contains
8a Wireless System-On-Chip from the EFR32MG24 family built on an
9ARM Cortex®-M33F processor with excellent low power capabilities.
10
11The BRD4187C a.k.a. xG24-RB4187C 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- EFR32MG24B220F1536IM48 Mighty Gecko SoC
18- CPU core: ARM Cortex®-M33 with FPU
19- Flash memory: 1536 kB
20- RAM: 256 kB
21- Transmit power: up to +20 dBm
22- Operation frequency: 2.4 GHz
23- Crystals for LFXO (32.768 kHz) and HFXO (39 MHz).
24
25For more information about the EFR32MG24 SoC and BRD4187C board, refer to these
26documents:
27
28- `EFR32MG24 Website`_
29- `EFR32MG24 Datasheet`_
30- `EFR32xG24 Reference Manual`_
31- `xG24-PK6010A Website`_
32- `BRD4187C 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| TRNG      | on-chip    | semailbox                           |
61+-----------+------------+-------------------------------------+
62| WATCHDOG  | on-chip    | watchdog                            |
63+-----------+------------+-------------------------------------+
64
65Other hardware features are currently not supported by the port.
66
67Connections and IOs
68===================
69
70In the following table, the column **Name** contains Pin names. For example, PA2
71means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
72
73+-------+-------------+-------------------------------------+
74| Name  | Function    | Usage                               |
75+=======+=============+=====================================+
76| PB2   | GPIO        | LED0                                |
77+-------+-------------+-------------------------------------+
78| PB4   | GPIO        | LED1                                |
79+-------+-------------+-------------------------------------+
80| PB1   | GPIO        | Push Button 0                       |
81+-------+-------------+-------------------------------------+
82| PB3   | GPIO        | Push Button 1                       |
83+-------+-------------+-------------------------------------+
84| PB0   | GPIO        | Board Controller Enable             |
85|       |             | VCOM_ENABLE                         |
86+-------+-------------+-------------------------------------+
87| PA8   | USART0_TX   | UART Console VCOM_TX US0_TX         |
88+-------+-------------+-------------------------------------+
89| PA9   | USART0_RX   | UART Console VCOM_RX US0_RX         |
90+-------+-------------+-------------------------------------+
91
92The default configuration can be found in
93:zephyr_file:`boards/silabs/radio_boards/xg24_rb4187c/xg24_rb4187c_defconfig`
94
95System Clock
96============
97
98The EFR32MG24 SoC is configured to use the 39 MHz external oscillator on the
99board.
100
101Serial Port
102===========
103
104The EFR32MG24 SoC has one USART and two EUSARTs.
105USART0 is connected to the board controller and is used for the console.
106
107Programming and Debugging
108*************************
109
110Flashing
111========
112
113Connect the BRD4002A board with a mounted BRD4187C radio module to your host
114computer using the USB port.
115
116Here is an example for the :zephyr:code-sample:`hello_world` application.
117
118.. zephyr-app-commands::
119   :zephyr-app: samples/hello_world
120   :board: xg24_rb4187c
121   :goals: flash
122
123Open a serial terminal (minicom, putty, etc.) with the following settings:
124
125- Speed: 115200
126- Data: 8 bits
127- Parity: None
128- Stop bits: 1
129
130Reset the board and you should see the following message in the terminal:
131
132.. code-block:: console
133
134   Hello World! xg24_rb4187c
135
136
137.. _xG24-PK6010A Website:
138   https://www.silabs.com/development-tools/wireless/efr32xg24-pro-kit-20-dbm
139
140.. _BRD4187C User Guide:
141   https://www.silabs.com/documents/public/user-guides/ug526-brd4187c-user-guide.pdf
142
143.. _EFR32MG24 Website:
144   https://www.silabs.com/wireless/zigbee/efr32mg24-series-2-socs
145
146.. _EFR32MG24 Datasheet:
147   https://www.silabs.com/documents/public/data-sheets/efr32mg24-datasheet.pdf
148
149.. _EFR32xG24 Reference Manual:
150   https://www.silabs.com/documents/public/reference-manuals/brd4187c-rm.pdf
151