1.. zephyr:board:: slwrb4321a
2
3Overview
4********
5
6The WGM160P Starter Kit SLWSTK6121A comes with the BRD4321A radio board.
7This radio boards contains a WGM160P module, which combines the WF200 Wi-Fi
8transceiver with an EFM32GG11 microcontroller.
9
10Hardware
11********
12
13- Advanced Energy Monitoring provides real-time information about the energy
14  consumption of an application or prototype design.
15- Ultra low power 128x128 pixel color Memory-LCD
16- 2 user buttons and 2 LEDs
17- Si7021 Humidity and Temperature Sensor
18- On-board Segger J-Link USB and Ethernet debugger
19- 10/100Base-TX ethernet PHY and RJ-45 jack (on included expansion board)
20- MicroSD card slot
21- USB Micro-AB connector
22
23For more information about the WGM160P and SLWSTK6121A board:
24
25- `WGM160P Website`_
26- `WGM160P Datasheet`_
27- `SLWSTK6121A Website`_
28- `SLWSTK6121A User Guide`_
29- `EFM32GG11 Datasheet`_
30- `EFM32GG11 Reference Manual`_
31- `WF200 Datasheet`_
32
33Supported Features
34==================
35
36The slwrb4321a board configuration supports the following hardware
37features:
38
39+-----------+------------+-------------------------------------+
40| Interface | Controller | Driver/Component                    |
41+===========+============+=====================================+
42| MPU       | on-chip    | memory protection unit              |
43+-----------+------------+-------------------------------------+
44| COUNTER   | on-chip    | rtcc                                |
45+-----------+------------+-------------------------------------+
46| ETHERNET  | on-chip    | ethernet                            |
47+-----------+------------+-------------------------------------+
48| FLASH     | on-chip    | flash memory                        |
49+-----------+------------+-------------------------------------+
50| GPIO      | on-chip    | gpio                                |
51+-----------+------------+-------------------------------------+
52| I2C       | on-chip    | i2c port-polling                    |
53+-----------+------------+-------------------------------------+
54| NVIC      | on-chip    | nested vector interrupt controller  |
55+-----------+------------+-------------------------------------+
56| SYSTICK   | on-chip    | systick                             |
57+-----------+------------+-------------------------------------+
58| UART      | on-chip    | serial port-polling;                |
59|           |            | serial port-interrupt               |
60+-----------+------------+-------------------------------------+
61
62The default configuration can be found in
63:zephyr_file:`boards/silabs/radio_boards/slwrb4321a/slwrb4321a_defconfig`
64
65Other hardware features, including the WF200 WiFi transceiver, are
66currently not supported by the port.
67
68Connections and IOs
69===================
70
71The WGM160P's EFM32GG11 SoC has six GPIO controllers (PORTA to PORTF), all of which are
72currently enabled for the SLWSTK6121A board.
73
74In the following table, the column **Name** contains pin names. For example, PE1
75means pin number 1 on PORTE, as used in the board's datasheets and manuals.
76
77+-------+-------------+-------------------------------------+
78| Name  | Function    | Usage                               |
79+=======+=============+=====================================+
80| PA4   | GPIO        | LED0                                |
81+-------+-------------+-------------------------------------+
82| PA5   | GPIO        | LED1                                |
83+-------+-------------+-------------------------------------+
84| PD6   | GPIO        | Push Button PB0                     |
85+-------+-------------+-------------------------------------+
86| PD8   | GPIO        | Push Button PB1                     |
87+-------+-------------+-------------------------------------+
88| PE7   | UART_TX     | UART TX Console VCOM_TX US0_TX #1   |
89+-------+-------------+-------------------------------------+
90| PE6   | UART_RX     | UART RX Console VCOM_RX US0_RX #1   |
91+-------+-------------+-------------------------------------+
92| PB11  | I2C_SDA     | SENSOR_I2C_SDA I2C1_SDA #1          |
93+-------+-------------+-------------------------------------+
94| PB12  | I2C_SCL     | SENSOR_I2C_SCL I2C1_SCL #1          |
95+-------+-------------+-------------------------------------+
96
97
98System Clock
99============
100
101The EFM32GG11 SoC is configured to use the 50 MHz external oscillator on the
102board.
103
104Serial Port
105===========
106
107The EFM32GG11 SoC has four USARTs, two UARTs and two Low Energy UARTs (LEUART).
108USART0 is connected to the board controller and is used for the console.
109
110Programming and Debugging
111*************************
112
113.. note::
114   Before using the kit the first time, you should update the J-Link firmware
115   in Simplicity Studio.
116
117Flashing
118========
119
120The SLWSTK6121A includes an `J-Link`_ serial and debug adaptor built into the
121board. The adaptor provides:
122
123- A USB connection to the host computer
124- A physical UART connection which is relayed over interface USB serial port.
125
126Flashing an application to SLWSTK6121A
127--------------------------------------
128
129Connect the SLWSTK6121A to your host computer using the USB port.
130
131Here is an example to build and flash the :zephyr:code-sample:`hello_world` application.
132
133.. zephyr-app-commands::
134   :zephyr-app: samples/hello_world
135   :board: slwrb4321a
136   :goals: flash
137
138Open a serial terminal (minicom, putty, etc.) with the following settings:
139
140- Speed: 115200
141- Data: 8 bits
142- Parity: None
143- Stop bits: 1
144
145Reset the board and you'll see the following message on the corresponding serial port
146terminal session:
147
148.. code-block:: console
149
150   Hello World! slwrb4321a
151
152.. _WGM160P Website:
153   https://www.silabs.com/wireless/wi-fi/wfm160-series-1-modules
154
155.. _WGM160P Datasheet:
156   https://www.silabs.com/documents/public/data-sheets/wgm160p-datasheet.pdf
157
158.. _SLWSTK6121A Website:
159   https://www.silabs.com/development-tools/wireless/wi-fi/wgm160p-wifi-module-starter-kit
160
161.. _SLWSTK6121A User Guide:
162   https://www.silabs.com/documents/public/user-guides/ug351-brd4321a-user-guide.pdf
163
164.. _EFM32GG11 Datasheet:
165   https://www.silabs.com/documents/public/data-sheets/efm32gg11-datasheet.pdf
166
167.. _EFM32GG11 Reference Manual:
168   https://www.silabs.com/documents/public/reference-manuals/efm32gg11-rm.pdf
169
170.. _WF200 Datasheet:
171   https://www.silabs.com/documents/public/data-sheets/wf200-datasheet.pdf
172
173.. _J-Link:
174   https://www.segger.com/jlink-debug-probes.html
175