1.. _efr32BG27_brd2602:
2
3SiLabs EFR32BG27-BRD2602(A) (EFR32BG27 +8 dBm Dev Kit Board)
4############################################################
5
6BRD2602 is a board based on EFR32BG27 SoC and is one of
7:ref:`efr32_thunderboard`.
8
9Hardware
10********
11
12- EFR32BG27 Blue Gecko Wireless SoC with up to 76.8 MHz operating frequency
13- ARM® Cortex® M33 core with 64 kB RAM and 768 kB Flash
14- Macronix ultra low power 8-Mbit SPI flash (MX25R8035F)
15- 2.4 GHz ceramic antenna for wireless transmission
16- Silicon Labs Si7021 relative humidity and temperature sensor
17- Vishay VEML6035 low power, high sensitivity ambient light Sensor
18- Silicon Labs Si7210 hall effect sensor
19- TDK InvenSense ICM-20689 6-axis inertial sensor
20- Pair of PDM microphones
21- One LED and one push button
22- Power enable signals and isolation switches for ultra low power operation
23- On-board SEGGER J-Link debugger for easy programming and debugging, which
24  includes a USB virtual COM port and Packet Trace Interface (PTI)
25- Mini Simplicity connector for access to energy profiling and advanced wireless
26  network debugging
27- Breakout pads for GPIO access and connection to external hardware
28- Reset button
29- CR2032 coin cell holder and external battery connector
30
31Supported Features
32==================
33
34The efr32bg27_brd2602 board configuration supports the following hardware features:
35
36+-----------+------------+-------------------------------------+
37| Interface | Controller | Driver/Component                    |
38+===========+============+=====================================+
39| NVIC      | on-chip    | nested vector interrupt controller  |
40+-----------+------------+-------------------------------------+
41| SYSTICK   | on-chip    | systick                             |
42+-----------+------------+-------------------------------------+
43| FLASH     | on-chip    | flash memory                        |
44+-----------+------------+-------------------------------------+
45| GPIO      | on-chip    | gpio                                |
46+-----------+------------+-------------------------------------+
47| UART      | on-chip    | serial                              |
48+-----------+------------+-------------------------------------+
49
50Flashing
51========
52
53The EFR32BG27-BRD2602A includes an embedded `J-Link`_ adapter built around
54EFM32GG12 microcontroller (not user-programmable).
55The adapter provides:
56
57- SWD interface to EFR32BG27 for flashing and debugging.
58- SWO trace interface to EFR32BG27 for tracing.
59- UART interface to EFR32BG27 for console access.
60- A USB connection to the host computer, which exposes CDC-ACM Serial Port
61  endpoints for access to the console UART interface and proprietary J-Link
62  endpoints for access to the SWD and SWO interfaces.
63
64UART functionality of the adapter is accessible via standard CDC-ACM USB driver
65present in most desktop operating systems and any standard serial port terminal
66program e.g. `picocom`_.
67
68SWD and SWO functionality is accessible via `Simplicity Commander`_.
69
70The simplest way to flash the board is by using West, which runs Simplicity
71Commander in unattended mode and passes all the necessary arguments to it.
72
73- If Simplicity Commander is installed in the system and the directory in
74  which `commander` executable is located is present in the `PATH` environment
75  variable:
76
77  .. code-block:: console
78
79   west flash
80
81- Otherwise, one should specify full path to the `commander` executable:
82
83  .. code-block:: console
84
85   west flash --commander <path_to_commander_directory>/commander
86
87- In case several J-Link adapters are connected, you must specify serial number
88  of the adapter which should be used for flashing:
89
90  .. code-block:: console
91
92   west flash --dev-id <J-Link serial number>
93
94Programming and Debugging
95=========================
96
97The sample application :ref:`hello_world` is used for this example.
98Build the Zephyr kernel and application:
99
100.. zephyr-app-commands::
101   :zephyr-app: samples/hello_world
102   :board: efr32bg27_brd2602a
103   :goals: build
104
105Connect your device to your host computer using the USB port and you
106should see a USB connection. Use `west`'s flash command
107
108Open a serial terminal (minicom, putty, etc.) with the following settings:
109
110- Speed: 115200
111- Data: 8 bits
112- Parity: None
113- Stop bits: 1
114
115Reset the board and you should be able to see on the corresponding Serial Port
116the following message:
117
118.. code-block:: console
119
120   Hello World! efr32bg27_brd2602a
121
122.. _picocom:
123   https://github.com/npat-efault/picocom
124
125.. _J-Link:
126   https://www.segger.com/jlink-debug-probes.html
127
128.. _Simplicity Commander:
129   https://www.silabs.com/developers/mcu-programming-options
130