1.. zephyr:board:: slwrb4255a
2
3Overview
4********
5
6The EFR32FG13P Flex Gecko 2.4 GHz and 915 MHz Radio Board is delivered as a
7`standalone Proprietary Wireless radio board`_. It contains a EFR32FG13P Wireless
8SoC built on an ARM Cortex®-M4F processor with excellent low power capabilities.
9
10The BRD4255A a.k.a. SLWRB4255A 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- EFR32FG13P233F512GM48 Flex Gecko SoC
17- CPU core: ARM Cortex®-M4 with FPU
18- Flash memory: 512 kB
19- RAM: 64 kB
20- Transmit power: up to 19 dBm
21- Operation frequency: 2.4 GHz, 915 MHz
22- Crystals for LFXO (32.768 kHz) and HFXO (38.4 MHz).
23
24For more information about the EFR32FG13 SoC and BRD4255A board, refer to these
25documents:
26
27- `EFR32FG13 Website`_
28- `EFR32FG13 Datasheet`_
29- `EFR32xG13 Reference Manual`_
30- `BRD4255A Reference Manual`_
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/slwrb4255a/slwrb4255a_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 EFR32FG13P SoC is configured to use the 38.4 MHz external oscillator on the
99board.
100
101Serial Port
102===========
103
104The EFR32FG13P SoC has three 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 BRD4255A 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: slwrb4255a
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! slwrb4255a
135
136
137.. _EFR32FG13 Website:
138   https://www.silabs.com/wireless/proprietary/efr32fg13-series-1-sub-ghz-2-4-ghz-socs
139
140.. _EFR32FG13 Datasheet:
141   https://www.silabs.com/documents/public/data-sheets/efr32fg13-datasheet.pdf
142
143.. _EFR32xG13 Reference Manual:
144   https://www.silabs.com/documents/public/reference-manuals/efr32xg13-rm.pdf
145
146.. _standalone Proprietary Wireless radio board:
147   https://www.silabs.com/development-tools/wireless/proprietary/slwrb4255a-efr32fg13-915-mhz-radio-board
148
149.. _BRD4255A Reference Manual:
150   https://www.silabs.com/documents/public/reference-manuals/brd4255a-rm.pdf
151