1.. zephyr:board:: xg24_dk2601b
2
3Overview
4********
5
6The EFR32MG24 Mighty Gecko Board dev kit contains
7a Wireless System-On-Chip from the EFR32MG24 family built on an
8ARM Cortex®-M33F processor with excellent low power capabilities.
9
10Hardware
11********
12
13- EFR32MG24B310F1536IM48-B Mighty Gecko SoC
14- CPU core: ARM Cortex®-M33 with FPU
15- Flash memory: 1536 kB
16- RAM: 256 kB
17- Transmit power: up to +20 dBm
18- Operation frequency: 2.4 GHz
19- Crystals for LFXO (32.768 kHz) and HFXO (38.4 MHz).
20- On board sensors:
21
22  - Silicon Labs Si7021 relative humidity & temperature sensor
23  - Silicon Labs Si7210 hall effect sensor
24  - 2x TDK InvenSense ICS-43434 MEMS microphones with I2S output
25  - TDK InvenSense ICM-20689 6-axis inertial measurement sensor
26  - Vishay VEML6035 ambient light sensor
27  - Bosch BMP384 pressure sensor with internal temperature sensor
28
29For more information about the EFR32MG24 SoC and BRD2601B board, refer to these
30documents:
31
32- `EFR32MG24 Website`_
33- `EFR32MG24 Datasheet`_
34- `EFR32xG24 Reference Manual`_
35- `BRD2601B User Guide`_
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    | stimer                              |
52+-----------+------------+-------------------------------------+
53| FLASH     | on-chip    | flash memory                        |
54+-----------+------------+-------------------------------------+
55| GPIO      | on-chip    | gpio                                |
56+-----------+------------+-------------------------------------+
57| UART      | on-chip    | serial                              |
58+-----------+------------+-------------------------------------+
59| DMA       | on-chip    | ldma                                |
60+-----------+------------+-------------------------------------+
61| TRNG      | on-chip    | semailbox                           |
62+-----------+------------+-------------------------------------+
63| WATCHDOG  | on-chip    | watchdog                            |
64+-----------+------------+-------------------------------------+
65| I2C(M/S)  | on-chip    | i2c                                 |
66+-----------+------------+-------------------------------------+
67| RADIO     | on-chip    | bluetooth                           |
68+-----------+------------+-------------------------------------+
69
70Other hardware features are currently not supported by the port.
71
72Connections and IOs
73===================
74
75In the following table, the column **Name** contains Pin names. For example, PA2
76means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
77
78+-------+-------------+-------------------------------------+
79| Name  | Function    | Usage                               |
80+=======+=============+=====================================+
81| PA4   | GPIO        | LED0                                |
82+-------+-------------+-------------------------------------+
83| PB0   | GPIO        | LED1                                |
84+-------+-------------+-------------------------------------+
85| PB2   | GPIO        | Push Button 0                       |
86+-------+-------------+-------------------------------------+
87| PB3   | GPIO        | Push Button 1                       |
88+-------+-------------+-------------------------------------+
89| PA5   | USART0_TX   | UART Console VCOM_TX US0_TX         |
90+-------+-------------+-------------------------------------+
91| PA6   | USART0_RX   | UART Console VCOM_RX US0_RX         |
92+-------+-------------+-------------------------------------+
93
94The default configuration can be found in
95:zephyr_file:`boards/silabs/dev_kits/xg24_dk2601b/xg24_dk2601b_defconfig`
96
97System Clock
98============
99
100The EFR32MG24 SoC is configured to use the 39 MHz external oscillator on the
101board.
102
103Serial Port
104===========
105
106The EFR32MG24 SoC has one USART and two EUSARTs.
107USART0 is connected to the board controller and is used for the console.
108
109Programming and Debugging
110*************************
111
112.. note::
113   Before using the kit the first time, you should update the J-Link firmware
114   in Simplicity Studio.
115
116Flashing
117========
118
119The sample application :zephyr:code-sample:`hello_world` is used for this example.
120Build the Zephyr kernel and application:
121
122.. zephyr-app-commands::
123   :zephyr-app: samples/hello_world
124   :board: xg24_dk2601b
125   :goals: build
126
127Connect the xg24_dk2601b to your host computer using the USB port and you
128should see a USB connection.
129
130Open a serial terminal (minicom, putty, etc.) with the following settings:
131
132- Speed: 115200
133- Data: 8 bits
134- Parity: None
135- Stop bits: 1
136
137Reset the board and you'll see the following message on the corresponding serial port
138terminal session:
139
140.. code-block:: console
141
142   Hello World! xg24_dk2601b
143
144Bluetooth
145=========
146
147To use the BLE function, run the command below to retrieve necessary binary
148blobs from the SiLabs HAL repository.
149
150.. code-block:: console
151
152   west blobs fetch hal_silabs
153
154Then build the Zephyr kernel and a Bluetooth sample with the following
155command. The :zephyr:code-sample:`bluetooth_observer` sample application is used in
156this example.
157
158.. zephyr-app-commands::
159   :zephyr-app: samples/bluetooth/observer
160   :board: xg24_dk2601b
161   :goals: build
162
163.. _EFR32MG24 Website:
164   https://www.silabs.com/wireless/zigbee/efr32mg24-series-2-socs#
165
166.. _EFR32MG24 Datasheet:
167   https://www.silabs.com/documents/public/data-sheets/efr32mg24-datasheet.pdf
168
169.. _EFR32xG24 Reference Manual:
170   https://www.silabs.com/documents/public/reference-manuals/efr32xg24-rm.pdf
171
172.. _BRD2601B User Guide:
173   https://www.silabs.com/documents/public/user-guides/ug524-brd2601b-user-guide.pdf
174