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