1.. zephyr:board:: xg24_ek2703a
2
3Overview
4********
5
6The EFR32xG24 Explorer Kit (xG24-EK2703A) contains
7a Wireless System-On-Chip from the EFR32MG24 family built on an
8ARM Cortex®-M33 processor with excellent low power capabilities.
9
10Hardware
11********
12
13- EFR32MG24B210F1536IM48-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 +10 dBm
18- Operation frequency: 2.4 GHz
19- Crystals for LFXO (32.768 kHz) and HFXO (39 MHz).
20
21For more information about the EFR32MG24 SoC and BRD2703A board, refer to these
22documents:
23
24- `EFR32MG24 Website`_
25- `EFR32MG24 Datasheet`_
26- `EFR32xG24 Reference Manual`_
27- `BRD2703A User Guide`_
28
29Supported Features
30==================
31
32The ``xg24_ek2703a`` board supports the following hardware features:
33
34+-----------+------------+-------------------------------------+
35| Interface | Controller | Driver/Component                    |
36+===========+============+=====================================+
37| MPU       | on-chip    | memory protection unit              |
38+-----------+------------+-------------------------------------+
39| NVIC      | on-chip    | nested vector interrupt controller  |
40+-----------+------------+-------------------------------------+
41| SYSTICK   | on-chip    | systick                             |
42+-----------+------------+-------------------------------------+
43| COUNTER   | on-chip    | stimer                              |
44+-----------+------------+-------------------------------------+
45| FLASH     | on-chip    | flash memory                        |
46+-----------+------------+-------------------------------------+
47| GPIO      | on-chip    | gpio                                |
48+-----------+------------+-------------------------------------+
49| UART      | on-chip    | serial                              |
50+-----------+------------+-------------------------------------+
51| TRNG      | on-chip    | semailbox                           |
52+-----------+------------+-------------------------------------+
53| WATCHDOG  | on-chip    | watchdog                            |
54+-----------+------------+-------------------------------------+
55| I2C(M/S)  | on-chip    | i2c                                 |
56+-----------+------------+-------------------------------------+
57| RADIO     | on-chip    | bluetooth                           |
58+-----------+------------+-------------------------------------+
59
60Other hardware features are currently not supported by the port.
61
62Connections and IOs
63===================
64
65In the following table, the column **Name** contains Pin names. For example, PA2
66means Pin number 2 on PORTA, as used in the board's datasheets and manuals.
67
68+-------+-------------+-------------------------------------+
69| Name  | Function    | Usage                               |
70+=======+=============+=====================================+
71| PA4   | GPIO        | LED0                                |
72+-------+-------------+-------------------------------------+
73| PA7   | GPIO        | LED1                                |
74+-------+-------------+-------------------------------------+
75| PB2   | GPIO        | Push Button 0                       |
76+-------+-------------+-------------------------------------+
77| PB3   | GPIO        | Push Button 1                       |
78+-------+-------------+-------------------------------------+
79| PA5   | USART0_TX   | UART Console VCOM_TX US0_TX         |
80+-------+-------------+-------------------------------------+
81| PA6   | USART0_RX   | UART Console VCOM_RX US0_RX         |
82+-------+-------------+-------------------------------------+
83
84The default configuration can be found in
85:zephyr_file:`boards/silabs/dev_kits/xg24_ek2703a/xg24_ek2703a_defconfig`
86
87System Clock
88============
89
90The EFR32MG24 SoC is configured to use the 39 MHz external oscillator on the
91board.
92
93Serial Port
94===========
95
96The EFR32MG24 SoC has one USART and two EUSARTs.
97USART0 is connected to the board controller and is used for the console.
98
99Programming and Debugging
100*************************
101
102.. note::
103   Before using the kit the first time, you should update the J-Link firmware
104   in Simplicity Studio.
105
106Flashing
107========
108
109The sample application :zephyr:code-sample:`hello_world` is used for this example.
110Build the Zephyr kernel and application:
111
112.. zephyr-app-commands::
113   :zephyr-app: samples/hello_world
114   :board: xg24_ek2703a
115   :goals: build
116
117Connect the xg24_ek2703a to your host computer using the USB port and you
118should see a USB connection.
119
120Open a serial terminal (minicom, putty, etc.) with the following settings:
121
122- Speed: 115200
123- Data: 8 bits
124- Parity: None
125- Stop bits: 1
126
127Reset the board and you'll see the following message on the corresponding serial port
128terminal session:
129
130.. code-block:: console
131
132   Hello World! xg24_ek2703a
133
134Bluetooth
135=========
136
137To use the BLE function, run the command below to retrieve necessary binary
138blobs from the SiLabs HAL repository.
139
140.. code-block:: console
141
142   west blobs fetch hal_silabs
143
144Then build the Zephyr kernel and a Bluetooth sample with the following
145command. The :zephyr:code-sample:`bluetooth_observer` sample application is used in
146this example.
147
148.. zephyr-app-commands::
149   :zephyr-app: samples/bluetooth/observer
150   :board: xg24_ek2703a
151   :goals: build
152
153.. _EFR32MG24 Website:
154   https://www.silabs.com/wireless/zigbee/efr32mg24-series-2-socs#
155
156.. _EFR32MG24 Datasheet:
157   https://www.silabs.com/documents/public/data-sheets/efr32mg24-datasheet.pdf
158
159.. _EFR32xG24 Reference Manual:
160   https://www.silabs.com/documents/public/reference-manuals/efr32xg24-rm.pdf
161
162.. _BRD2703A User Guide:
163   https://www.silabs.com/documents/public/user-guides/ug533-xg24-ek2703a.pdf
164