-
Notifications
You must be signed in to change notification settings - Fork 6.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
boards: arm: add docs for efm32gg_sltb009a
This adds the index page and an image of the board. Signed-off-by: Wojciech Sipak <wsipak@antmicro.com>
- Loading branch information
Showing
2 changed files
with
167 additions
and
0 deletions.
There are no files selected for viewing
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,167 @@ | ||
.. _efm32gg_sltb009a: | ||
|
||
EFM32GG12 Thunderboard Kit | ||
################### | ||
|
||
Overview | ||
******** | ||
|
||
The EFM32GG12 Thunderboard Kit (SLTB009A) is an evaluation platform for the EFM32GG12 GiantGecko Microcontroller, | ||
featuring an ARM Cortex-M4 with FPU, 1024kB flash, and 192kB RAM. | ||
|
||
.. figure:: efm32gg12-thunderboard-kit.jpg | ||
:align: center | ||
:alt: SLTB009A | ||
|
||
SLTB009A (Credit: Silicon Labs) | ||
|
||
Hardware | ||
******** | ||
|
||
- PDM stereo microphones | ||
- USB connectivity | ||
- On-board Segger J-Link USB debugger | ||
- 2 user buttons and 2 LEDs | ||
- USB C connector | ||
|
||
For more information about the WGM160P and SLTB009A board: | ||
|
||
- `SLTB009A Website`_ | ||
- `SLTB009A User Guide`_ | ||
- `EFM32GG12 Datasheet`_ | ||
- `EFM32GG12 Reference Manual`_ | ||
|
||
Supported Features | ||
================== | ||
|
||
The efm32gg_sltb009a board configuration supports the following hardware | ||
features: | ||
|
||
+-----------+------------+-------------------------------------+ | ||
| Interface | Controller | Driver/Component | | ||
+===========+============+=====================================+ | ||
| MPU | on-chip | memory protection unit | | ||
+-----------+------------+-------------------------------------+ | ||
| COUNTER | on-chip | rtcc | | ||
+-----------+------------+-------------------------------------+ | ||
| FLASH | on-chip | flash memory | | ||
+-----------+------------+-------------------------------------+ | ||
| GPIO | on-chip | gpio | | ||
+-----------+------------+-------------------------------------+ | ||
| I2C | on-chip | i2c port-polling | | ||
+-----------+------------+-------------------------------------+ | ||
| NVIC | on-chip | nested vector interrupt controller | | ||
+-----------+------------+-------------------------------------+ | ||
| UART | on-chip | serial port-polling; | | ||
| | | serial port-interrupt | | ||
+-----------+------------+-------------------------------------+ | ||
|
||
The default configuration can be found in the defconfig file: | ||
|
||
``boards/arm/efm32gg_sltb009a/efm32gg_sltb009a_defconfig`` | ||
|
||
|
||
Connections and IOs | ||
=================== | ||
|
||
The EFM32GG12 MCU has six GPIO controllers (PORTA to PORTF), all of which are | ||
currently enabled for the SLTB009A board. | ||
|
||
In the following table, the column **Name** contains pin names. For example, PE1 | ||
means pin number 1 on PORTE, as used in the board's datasheets and manuals. | ||
|
||
+-------+-------------+-------------------------------------+ | ||
| Name | Function | Usage | | ||
+=======+=============+=====================================+ | ||
| PE12 | GPIO | LED0 | | ||
+-------+-------------+-------------------------------------+ | ||
| PA13 | GPIO | LED1 | | ||
+-------+-------------+-------------------------------------+ | ||
| PD5 | GPIO | Push Button PB0 | | ||
+-------+-------------+-------------------------------------+ | ||
| PD8 | GPIO | Push Button PB1 | | ||
+-------+-------------+-------------------------------------+ | ||
| PE7 | UART_TX | UART TX Console VCOM_TX US0_TX #1 | | ||
+-------+-------------+-------------------------------------+ | ||
| PE6 | UART_RX | UART RX Console VCOM_RX US0_RX #1 | | ||
+-------+-------------+-------------------------------------+ | ||
| PC0 | I2C_SDA | SENSOR_I2C_SDA I2C0_SDA #1 | | ||
+-------+-------------+-------------------------------------+ | ||
| PC1 | I2C_SCL | SENSOR_I2C_SCL I2C0_SCL #1 | | ||
+-------+-------------+-------------------------------------+ | ||
| PC4 | I2C_SDA | SENSOR_I2C_SDA I2C1_SDA #1 | | ||
+-------+-------------+-------------------------------------+ | ||
| PC5 | I2C_SCL | SENSOR_I2C_SCL I2C1_SCL #1 | | ||
+-------+-------------+-------------------------------------+ | ||
|
||
|
||
System Clock | ||
============ | ||
|
||
The EFM32GG12 MCU is configured to work at 72 MHz. | ||
|
||
Serial Port | ||
=========== | ||
|
||
The EFM32GG12 SoC has five USARTs, two UARTs and two Low Energy UARTs (LEUART). | ||
USART0 is connected to the board controller and is used for the console. | ||
|
||
Programming and Debugging | ||
************************* | ||
|
||
.. note:: | ||
Before using the kit the first time, you should update the J-Link firmware | ||
from `J-Link-Downloads`_ | ||
|
||
Flashing | ||
======== | ||
|
||
The SLTB009A includes an `J-Link`_ serial and debug adaptor built into the | ||
board. The adaptor provides: | ||
|
||
- A USB connection to the host computer | ||
- A physical UART connection which is relayed over interface USB serial port. | ||
|
||
Flashing an application to SLTB009A | ||
-------------------------------------- | ||
|
||
Connect the SLTB009A to your host computer using the USB port. | ||
|
||
Here is an example to build and flash the :ref:`hello_world` application. | ||
|
||
.. zephyr-app-commands:: | ||
:zephyr-app: samples/hello_world | ||
:board: efm32gg_stb009a | ||
:goals: flash | ||
|
||
Open a serial terminal (minicom, putty, etc.) with the following settings: | ||
|
||
- Speed: 115200 | ||
- Data: 8 bits | ||
- Parity: None | ||
- Stop bits: 1 | ||
|
||
Reset the board and you'll see the following message on the corresponding serial port | ||
terminal session: | ||
|
||
.. code-block:: console | ||
Hello World! efm32gg_sltb009a | ||
.. _SLTB009A Website: | ||
https://www.silabs.com/development-tools/thunderboard/thunderboard-gg12-kit | ||
|
||
.. _SLTB009A User Guide: | ||
https://www.silabs.com/documents/public/user-guides/ug371-sltb009a-user-guide.pdf | ||
|
||
.. _EFM32GG12 Datasheet: | ||
https://www.silabs.com/documents/public/data-sheets/efm32gg12-datasheet.pdf | ||
|
||
.. _EFM32GG12 Reference Manual: | ||
https://www.silabs.com/documents/public/reference-manuals/efm32gg12-rm.pdf | ||
|
||
.. _J-Link: | ||
https://www.segger.com/jlink-debug-probes.html | ||
|
||
.. _J-Link-Downloads: | ||
https://www.segger.com/downloads/jlink |