1.. zephyr:board:: slwrb4170a
2
3Overview
4********
5
6The EFR32MG12 Mighty Gecko Radio Board contains a Wireless System-On-Chip
7from the EFR32MG12 family built on an ARM Cortex®-M4F processor with excellent
8low power capabilities.
9
10The BRD4170A a.k.a. SLWRB4170A radio board plugs into the Wireless Starter Kit
11Mainboard BRD4001A and is supported as one of :ref:`silabs_radio_boards`.
12
13Hardware
14********
15
16- EFR32MG12P433F1024GM68 Mighty Gecko SoC
17- CPU core: ARM Cortex®-M4 with FPU
18- Flash memory: 1024 kB
19- RAM: 256 kB
20- Transmit power: up to +19 dBm
21- Operation frequency: 2.4 GHz and Sub-Ghz
22- Crystals for LFXO (32.768 kHz) and HFXO (38.4 MHz).
23
24For more information about the EFR32MG12 SoC and BRD4170A board, refer to these
25documents:
26
27- `EFR32MG12 Website`_
28- `EFR32MG12 Datasheet`_
29- `EFR32xG12 Reference Manual`_
30- `BRD4170A User Guide`_
31
32Supported Features
33==================
34
35The board configuration supports the following hardware features:
36
37+-----------+------------+-------------------------------------+
38| Interface | Controller | Driver/Component                    |
39+===========+============+=====================================+
40| MPU       | on-chip    | memory protection unit              |
41+-----------+------------+-------------------------------------+
42| NVIC      | on-chip    | nested vector interrupt controller  |
43+-----------+------------+-------------------------------------+
44| SYSTICK   | on-chip    | systick                             |
45+-----------+------------+-------------------------------------+
46| COUNTER   | on-chip    | rtcc                                |
47+-----------+------------+-------------------------------------+
48| FLASH     | on-chip    | flash memory                        |
49+-----------+------------+-------------------------------------+
50| GPIO      | on-chip    | gpio                                |
51+-----------+------------+-------------------------------------+
52| UART      | on-chip    | serial port-polling;                |
53|           |            | serial port-interrupt               |
54+-----------+------------+-------------------------------------+
55| SPI(M)    | on-chip    | spi port-polling                    |
56+-----------+------------+-------------------------------------+
57| WATCHDOG  | on-chip    | watchdog                            |
58+-----------+------------+-------------------------------------+
59
60The default configuration can be found in
61:zephyr_file:`boards/silabs/radio_boards/slwrb4170a/slwrb4170a_defconfig`
62
63Connections and IOs
64===================
65
66In the following table, the column **Pin** contains Pin names. For example, PA2
67means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
68
69+-------+-------------+-------------------------------------+
70| Pin   | Function    | Usage                               |
71+=======+=============+=====================================+
72| PF4   | GPIO        | LED0                                |
73+-------+-------------+-------------------------------------+
74| PF5   | GPIO        | LED1                                |
75+-------+-------------+-------------------------------------+
76| PF6   | GPIO        | Push Button PB0                     |
77+-------+-------------+-------------------------------------+
78| PF7   | GPIO        | Push Button PB1                     |
79+-------+-------------+-------------------------------------+
80| PA5   | GPIO        | Board Controller Enable VCOM_ENABLE |
81+-------+-------------+-------------------------------------+
82| PA0   | USART0_TX   | UART Console VCOM_TX US0_TX #0      |
83+-------+-------------+-------------------------------------+
84| PA1   | USART0_RX   | UART Console VCOM_RX US0_RX #0      |
85+-------+-------------+-------------------------------------+
86| PC6   | SPI_MOSI    | Flash MOSI US1_TX #11               |
87+-------+-------------+-------------------------------------+
88| PC7   | SPI_MISO    | Flash MISO US1_RX #11               |
89+-------+-------------+-------------------------------------+
90| PC8   | SPI_SCLK    | Flash SCLK US1_CLK #11              |
91+-------+-------------+-------------------------------------+
92| PA4   | SPI_CS      | Flash Chip Select (GPIO)            |
93+-------+-------------+-------------------------------------+
94
95System Clock
96============
97
98The EFR32MG12P SoC is configured to use the 38.4 MHz external oscillator on the
99board.
100
101Serial Port
102===========
103
104The EFR32MG12P SoC has four USARTs and one Low Energy UARTs (LEUART).
105USART0 is connected to the board controller and is used for the console.
106
107Programming and Debugging
108*************************
109
110Flashing
111========
112
113Connect the BRD4001A board with a mounted BRD4170A 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: slwrb4170a
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! slwrb4170a
135
136
137.. _EFR32MG12 Website:
138   https://www.silabs.com/wireless/zigbee/efr32mg12-series-1-socs
139
140.. _EFR32MG12 Datasheet:
141   https://www.silabs.com/documents/public/data-sheets/efr32mg12-datasheet.pdf
142
143.. _EFR32xG12 Reference Manual:
144   https://www.silabs.com/documents/public/reference-manuals/efr32xg12-rm.pdf
145
146.. _BRD4170A User Guide:
147   https://www.silabs.com/documents/public/user-guides/ug342-brd4170a-user-guide.pdf
148