zephyr/boards/silabs/efm32gg_sltb009a/doc/index.rst

166 lines
5.6 KiB
ReStructuredText

.. _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
:zephyr_file:`boards/silabs/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