|
| 1 | +.. zephyr:board:: xg22_ek2710a |
| 2 | +
|
| 3 | +Overview |
| 4 | +******** |
| 5 | + |
| 6 | +The EFR32xG22E Explorer Kit (xG22-EK2710A) contains |
| 7 | +a Wireless System-On-Chip from the EFR32MG22 family built on an |
| 8 | +ARM Cortex®-M33 processor with excellent low power capabilities. |
| 9 | + |
| 10 | +Hardware |
| 11 | +******** |
| 12 | + |
| 13 | +- EFR32MG22E224F512IM40 Mighty Gecko SoC |
| 14 | +- CPU core: ARM Cortex®-M33 with FPU |
| 15 | +- Flash memory: 512 kB |
| 16 | +- RAM: 32 kB |
| 17 | +- Transmit power: up to +6 dBm |
| 18 | +- Operation frequency: 2.4 GHz |
| 19 | +- Crystal for HFXO (38.4 MHz) |
| 20 | + |
| 21 | +For more information about the EFR32MG22 SoC and BRD2710A board, refer to these |
| 22 | +documents: |
| 23 | + |
| 24 | +- `EFR32MG22 Website`_ |
| 25 | +- `EFR32MG22E Datasheet`_ |
| 26 | +- `EFR32xG22 Reference Manual`_ |
| 27 | +- `BRD2710A User Guide`_ |
| 28 | + |
| 29 | +Supported Features |
| 30 | +================== |
| 31 | + |
| 32 | +.. zephyr:board-supported-hw:: |
| 33 | +
|
| 34 | +Connections and IOs |
| 35 | +=================== |
| 36 | + |
| 37 | +In the following table, the column **Name** contains Pin names. For example, PA2 |
| 38 | +means Pin number 2 on PORTA, as used in the board's datasheets and manuals. |
| 39 | + |
| 40 | ++-------+-------------+-------------------------------------+ |
| 41 | +| Name | Function | Usage | |
| 42 | ++=======+=============+=====================================+ |
| 43 | +| PA4 | GPIO | LED0 | |
| 44 | ++-------+-------------+-------------------------------------+ |
| 45 | +| PC7 | GPIO | Push Button 0 | |
| 46 | ++-------+-------------+-------------------------------------+ |
| 47 | +| PA5 | USART1_TX | UART Console VCOM_TX US0_TX | |
| 48 | ++-------+-------------+-------------------------------------+ |
| 49 | +| PA6 | USART1_RX | UART Console VCOM_RX US0_RX | |
| 50 | ++-------+-------------+-------------------------------------+ |
| 51 | + |
| 52 | +The default configuration can be found in |
| 53 | +:zephyr_file:`boards/silabs/dev_kits/xg22_ek2710a/xg22_ek2710a_defconfig` |
| 54 | + |
| 55 | +System Clock |
| 56 | +============ |
| 57 | + |
| 58 | +The EFR32MG22E SoC is configured to use the 38.4 MHz external oscillator on the |
| 59 | +board, and can operate a clock speeds of up to 76.8 MHz. |
| 60 | + |
| 61 | +Serial Port |
| 62 | +=========== |
| 63 | + |
| 64 | +The EFR32MG22E SoC has two USARTs and one EUART. |
| 65 | +USART1 is connected to the board controller and is used for the console. |
| 66 | + |
| 67 | +Programming and Debugging |
| 68 | +************************* |
| 69 | + |
| 70 | +.. zephyr:board-supported-runners:: |
| 71 | +
|
| 72 | +.. note:: |
| 73 | + Before using the kit the first time, you should update the J-Link firmware |
| 74 | + in Simplicity Studio. |
| 75 | + |
| 76 | +Flashing |
| 77 | +======== |
| 78 | + |
| 79 | +The sample application :zephyr:code-sample:`hello_world` is used for this example. |
| 80 | +Build the Zephyr kernel and application: |
| 81 | + |
| 82 | +.. zephyr-app-commands:: |
| 83 | + :zephyr-app: samples/hello_world |
| 84 | + :board: xg22_ek2710a |
| 85 | + :goals: build |
| 86 | + |
| 87 | +Connect the xg22_ek2710a to your host computer using the USB port and you |
| 88 | +should see a USB connection. |
| 89 | + |
| 90 | +Open a serial terminal (minicom, putty, etc.) with the following settings: |
| 91 | + |
| 92 | +- Speed: 115200 |
| 93 | +- Data: 8 bits |
| 94 | +- Parity: None |
| 95 | +- Stop bits: 1 |
| 96 | + |
| 97 | +Reset the board and you'll see the following message on the corresponding serial port |
| 98 | +terminal session: |
| 99 | + |
| 100 | +.. code-block:: console |
| 101 | +
|
| 102 | + Hello World! xg22_ek2710a/efr32mg22e224f512im40 |
| 103 | +
|
| 104 | +Bluetooth |
| 105 | +========= |
| 106 | + |
| 107 | +To use the BLE function, run the command below to retrieve necessary binary |
| 108 | +blobs from the SiLabs HAL repository. |
| 109 | + |
| 110 | +.. code-block:: console |
| 111 | +
|
| 112 | + west blobs fetch hal_silabs |
| 113 | +
|
| 114 | +Then build the Zephyr kernel and a Bluetooth sample with the following |
| 115 | +command. The :zephyr:code-sample:`bluetooth_observer` sample application is used in |
| 116 | +this example. |
| 117 | + |
| 118 | +.. zephyr-app-commands:: |
| 119 | + :zephyr-app: samples/bluetooth/observer |
| 120 | + :board: xg22_ek2710a |
| 121 | + :goals: build |
| 122 | + |
| 123 | +.. _EFR32MG22 Website: |
| 124 | + https://www.silabs.com/wireless/zigbee/efr32mg22-series-2-socs# |
| 125 | + |
| 126 | +.. _EFR32MG22E Datasheet: |
| 127 | + https://www.silabs.com/documents/public/data-sheets/efr32mg22e-datasheet.pdf |
| 128 | + |
| 129 | +.. _EFR32xG22 Reference Manual: |
| 130 | + https://www.silabs.com/documents/public/reference-manuals/efr32xg22-rm.pdf |
| 131 | + |
| 132 | +.. _BRD2710A User Guide: |
| 133 | + https://www.silabs.com/documents/public/user-guides/ug582-brd2710a-user-guide.pdf |
0 commit comments