1.. zephyr:board:: slwrb4180a
2
3Overview
4********
5
6The EFR32MG21 Mighty Gecko Radio Board is one of the two
7radio boards delivered with `EFR32-SLWSTK6006A Website`_. It contains
8a Wireless System-On-Chip from the EFR32MG21 family built on an
9ARM Cortex®-M33F processor with excellent low power capabilities.
10
11The BRD4180A a.k.a. SLWRB4180A radio board plugs into the Wireless Starter Kit
12Mainboard BRD4001A and is supported as one of :ref:`silabs_radio_boards`.
13
14Hardware
15********
16
17- EFR32MG21A020F1024IM32 Mighty Gecko SoC
18- CPU core: ARM Cortex®-M33 with FPU
19- Flash memory: 1024 kB
20- RAM: 96 kB
21- Transmit power: up to +20 dBm
22- Operation frequency: 2.4 GHz
23- Crystals for LFXO (32.768 kHz) and HFXO (38.4 MHz).
24
25For more information about the EFR32MG21 SoC and BRD4180A board, refer to these
26documents:
27
28- `EFR32MG21 Website`_
29- `EFR32MG21 Datasheet`_
30- `EFR32xG21 Reference Manual`_
31- `EFR32-SLWSTK6006A Website`_
32- `BRD4180A 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    | rtcc                                |
49+-----------+------------+-------------------------------------+
50| FLASH     | on-chip    | flash memory                        |
51+-----------+------------+-------------------------------------+
52| GPIO      | on-chip    | gpio                                |
53+-----------+------------+-------------------------------------+
54| UART      | on-chip    | serial port-polling;                |
55|           |            | serial port-interrupt               |
56+-----------+------------+-------------------------------------+
57| I2C       | on-chip    | i2c port-polling                    |
58+-----------+------------+-------------------------------------+
59| DMA       | on-chip     | ldma                               |
60+-----------+------------+-------------------------------------+
61| WATCHDOG  | on-chip    | watchdog                            |
62+-----------+------------+-------------------------------------+
63
64Other hardware features are currently not supported by the port.
65
66Connections and IOs
67===================
68
69In the following table, the column **Name** contains Pin names. For example, PA2
70means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
71
72+-------+-------------+-------------------------------------+
73| Name  | Function    | Usage                               |
74+=======+=============+=====================================+
75| PB0   | GPIO        | LED0                                |
76+-------+-------------+-------------------------------------+
77| PB1   | GPIO        | LED1                                |
78+-------+-------------+-------------------------------------+
79| PD2   | GPIO        | Push Button PB0                     |
80+-------+-------------+-------------------------------------+
81| PD3   | GPIO        | Push Button PB1                     |
82+-------+-------------+-------------------------------------+
83| PD4   | GPIO        | Board Controller Enable             |
84|       |             | EFM_BC_EN                           |
85+-------+-------------+-------------------------------------+
86| PA5   | USART1_TX   | UART Console EFM_BC_TX US1_TX       |
87+-------+-------------+-------------------------------------+
88| PA6   | USART1_RX   | UART Console EFM_BC_RX US1_RX       |
89+-------+-------------+-------------------------------------+
90
91The default configuration can be found in
92:zephyr_file:`boards/silabs/radio_boards/slwrb4180a/slwrb4180a_defconfig`
93
94System Clock
95============
96
97The EFR32MG21 SoC is configured to use the 38.4 MHz external oscillator on the
98board.
99
100Serial Port
101===========
102
103The EFR32MG21 SoC has three USARTs.
104USART0 is connected to the board controller and is used for the console.
105
106Programming and Debugging
107*************************
108
109Flashing
110========
111
112Connect the BRD4001A board with a mounted BRD4180A radio module to your host
113computer using the USB port.
114
115Here is an example for the :zephyr:code-sample:`hello_world` application.
116
117.. zephyr-app-commands::
118   :zephyr-app: samples/hello_world
119   :board: slwrb4180a
120   :goals: flash
121
122Open a serial terminal (minicom, putty, etc.) with the following settings:
123
124- Speed: 115200
125- Data: 8 bits
126- Parity: None
127- Stop bits: 1
128
129Reset the board and you should see the following message in the terminal:
130
131.. code-block:: console
132
133   Hello World! slwrb4180a
134
135
136.. _EFR32-SLWSTK6006A Website:
137   https://www.silabs.com/products/development-tools/wireless/efr32xg21-wireless-starter-kit
138
139.. _BRD4180A User Guide:
140   https://www.silabs.com/documents/public/user-guides/ug385-brd4180a-user-guide.pdf
141
142.. _EFR32MG21 Website:
143   https://www.silabs.com/products/wireless/mesh-networking/efr32mg21-series-2-socs
144
145.. _EFR32MG21 Datasheet:
146   https://www.silabs.com/documents/public/data-sheets/efr32mg21-datasheet.pdf
147
148.. _EFR32xG21 Reference Manual:
149   https://www.silabs.com/documents/public/reference-manuals/efr32xg21-rm.pdf
150