1.. zephyr:board:: slwrb4104a
2
3Overview
4********
5
6The EFR32BG13 Blue Gecko Bluetooth® Low Energy Radio Board is one of the two
7radio boards delivered with `SLWSTK6020B Bluetooth SoC Starter Kit`_. It
8contains a Wireless System-On-Chip from the EFR32BG13 family built on an
9ARM Cortex®-M4F processor with excellent low power capabilities.
10
11The BRD4104A a.k.a. SLWRB4104A 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- EFR32BG13P632F512GM48 Blue Gecko SoC
18- CPU core: ARM Cortex®-M4 with FPU
19- Flash memory: 512 kB
20- RAM: 64 kB
21- Transmit power: up to +10 dBm
22- Operation frequency: 2.4 GHz
23- 8Mbit SPI NOR Flash
24- Crystals for LFXO (32.768 kHz) and HFXO (38.4 MHz).
25
26For more information about the EFR32BG13 SoC and BRD4104A board, refer to these
27documents:
28
29- `EFR32BG13 Website`_
30- `EFR32BG13 Datasheet`_
31- `EFR32xG13 Reference Manual`_
32- `SLWSTK6020B Bluetooth SoC Starter Kit`_
33- `BRD4104A User Guide`_
34- `BRD4104A Reference Manual`_
35- `EFR32BG13-BRD4104A Schematics`_
36
37Supported Features
38==================
39
40The board configuration supports the following hardware features:
41
42+-----------+------------+-------------------------------------+
43| Interface | Controller | Driver/Component                    |
44+===========+============+=====================================+
45| MPU       | on-chip    | memory protection unit              |
46+-----------+------------+-------------------------------------+
47| NVIC      | on-chip    | nested vector interrupt controller  |
48+-----------+------------+-------------------------------------+
49| SYSTICK   | on-chip    | systick                             |
50+-----------+------------+-------------------------------------+
51| COUNTER   | on-chip    | rtcc                                |
52+-----------+------------+-------------------------------------+
53| FLASH     | on-chip    | flash memory                        |
54+-----------+------------+-------------------------------------+
55| GPIO      | on-chip    | gpio                                |
56+-----------+------------+-------------------------------------+
57| UART      | on-chip    | serial port-polling;                |
58|           |            | serial port-interrupt               |
59+-----------+------------+-------------------------------------+
60| SPI(M)    | on-chip    | spi port-polling                    |
61+-----------+------------+-------------------------------------+
62| WATCHDOG  | on-chip    | watchdog                            |
63+-----------+------------+-------------------------------------+
64
65The default configuration can be found in
66:zephyr_file:`boards/silabs/radio_boards/slwrb4104a/slwrb4104a_defconfig`
67
68Connections and IOs
69===================
70
71In the following table, the column **Pin** contains Pin names. For example, PA2
72means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
73
74+-------+-------------+-------------------------------------+
75| Pin   | Function    | Usage                               |
76+=======+=============+=====================================+
77| PF4   | GPIO        | LED0                                |
78+-------+-------------+-------------------------------------+
79| PF5   | GPIO        | LED1                                |
80+-------+-------------+-------------------------------------+
81| PF6   | GPIO        | Push Button PB0                     |
82+-------+-------------+-------------------------------------+
83| PF7   | GPIO        | Push Button PB1                     |
84+-------+-------------+-------------------------------------+
85| PA5   | GPIO        | Board Controller Enable             |
86|       |             | VCOM_ENABLE                         |
87+-------+-------------+-------------------------------------+
88| PA0   | USART0_TX   | UART Console VCOM_TX US0_TX #0      |
89+-------+-------------+-------------------------------------+
90| PA1   | USART0_RX   | UART Console VCOM_RX US0_RX #0      |
91+-------+-------------+-------------------------------------+
92| PC6   | SPI_MOSI    | Flash MOSI US1_TX #11               |
93+-------+-------------+-------------------------------------+
94| PC7   | SPI_MISO    | Flash MISO US1_RX #11               |
95+-------+-------------+-------------------------------------+
96| PC8   | SPI_SCLK    | Flash SCLK US1_CLK #11              |
97+-------+-------------+-------------------------------------+
98| PA4   | SPI_CS      | Flash Chip Select (GPIO)            |
99+-------+-------------+-------------------------------------+
100
101System Clock
102============
103
104The EFR32BG13P SoC is configured to use the 38.4 MHz external oscillator on the
105board.
106
107Serial Port
108===========
109
110The EFR32BG13P SoC has three USARTs and one Low Energy UARTs (LEUART).
111USART0 is connected to the board controller and is used for the console.
112
113Programming and Debugging
114*************************
115
116Flashing
117========
118
119Connect the BRD4001A board with a mounted BRD4104A radio module to your host
120computer using the USB port.
121
122Here is an example for the :zephyr:code-sample:`hello_world` application.
123
124.. zephyr-app-commands::
125   :zephyr-app: samples/hello_world
126   :board: slwrb4104a
127   :goals: flash
128
129Open a serial terminal (minicom, putty, etc.) with the following settings:
130
131- Speed: 115200
132- Data: 8 bits
133- Parity: None
134- Stop bits: 1
135
136Reset the board and you should see the following message in the terminal:
137
138.. code-block:: console
139
140   Hello World! slwrb4161a
141
142
143.. _EFR32BG13 Website:
144   https://www.silabs.com/wireless/bluetooth/efr32bg13-series-1-socs
145
146.. _EFR32BG13 Datasheet:
147   https://www.silabs.com/documents/public/data-sheets/efr32bg13-datasheet.pdf
148
149.. _EFR32xG13 Reference Manual:
150   https://www.silabs.com/documents/public/reference-manuals/efr32xg13-rm.pdf
151
152.. _SLWSTK6020B Bluetooth SoC Starter Kit:
153   https://www.silabs.com/products/development-tools/wireless/bluetooth/blue-gecko-bluetooth-low-energy-soc-starter-kit
154
155.. _BRD4104A User Guide:
156   https://www.silabs.com/documents/public/user-guides/ug279-brd4104a-user-guide.pdf
157
158.. _BRD4104A Reference Manual:
159   https://www.silabs.com/documents/public/reference-manuals/brd4104a-rm.pdf
160
161.. _EFR32BG13-BRD4104A Schematics:
162   https://www.silabs.com/documents/public/schematic-files/BRD4104A-A00-schematic.pdf
163