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