boards/silabs/starter_kits/slstk3401a/doc/index.rst
.. zephyr:board:: slstk3401a
Overview
The EFM32 Pearl Gecko Starter Kit SLSTK3401A contains an MCU from the EFM32PG family built on an ARM® Cortex®-M4F processor with excellent low power capabilities.
Hardware
For more information about the EFM32PG SoC and SLSTK3401A board:
EFM32PG Website_EFM32PG1 Datasheet_EFM32PG1 Reference Manual_SLSTK3401A Website_SLSTK3401A User Guide_.. zephyr:board-supported-hw::
The EFM32PG1 SoC has five GPIO controllers (PORTA to PORTD and PORTF) and all are enabled for the SLSTK3401A board.
In the following table, the column Name contains pin names. For example, PF4 means pin number 4 on PORTF, as used in the board's datasheets and manuals.
+-------+-------------+-------------------------------------+ | Name | Function | Usage | +=======+=============+=====================================+ | PF4 | GPIO | LED0 | +-------+-------------+-------------------------------------+ | PF5 | GPIO | LED1 | +-------+-------------+-------------------------------------+ | PF6 | GPIO | Push Button PB0 | +-------+-------------+-------------------------------------+ | PF7 | GPIO | Push Button PB1 | +-------+-------------+-------------------------------------+ | PA5 | GPIO | Board Controller Enable | | | | EFM_BC_EN | +-------+-------------+-------------------------------------+ | PA0 | UART_TX | UART TX Console VCOM_TX US0_TX #0 | +-------+-------------+-------------------------------------+ | PA1 | UART_RX | UART RX Console VCOM_RX US0_RX #0 | +-------+-------------+-------------------------------------+ | PD10 | UART_TX | EXP12_UART_TX LEU0_TX #18 | +-------+-------------+-------------------------------------+ | PD11 | UART_RX | EXP14_UART_RX LEU0_RX #18 | +-------+-------------+-------------------------------------+ | PC10 | I2C_SDA | ENV_I2C_SDA I2C0_SDA #15 | +-------+-------------+-------------------------------------+ | PC11 | I2C_SCL | ENV_I2C_SCL I2C0_SCL #15 | +-------+-------------+-------------------------------------+
The EFM32PG SoC is configured to use the 40 MHz external oscillator on the board.
The EFM32PG SoC has two USARTs and one Low Energy UART (LEUART).
Programming and Debugging
.. zephyr:board-supported-runners::
.. note:: Before using the kit the first time, you should update the J-Link firmware in Simplicity Studio.
The SLSTK3401A includes an J-Link_ serial and debug adaptor built into the
board. The adaptor provides:
The sample application :zephyr:code-sample:hello_world is used for this example.
Build the Zephyr kernel and application:
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: slstk3401a :goals: build
Connect the SLSTK3401A to your host computer using the USB port and you should see a USB connection which exposes a mass storage device(SLSTK3401A). Copy the generated zephyr.bin to the SLSTK3401A drive.
Use a USB-to-UART converter such as an FT232/CP2102 to connect to the UART on the expansion header.
Open a serial terminal (minicom, putty, etc.) with the following settings:
Reset the board and you'll see the following message on the corresponding serial port terminal session:
.. code-block:: console
Hello World! slstk3401a
.. _SLSTK3401A Website: https://www.silabs.com/development-tools/mcu/32-bit/efm32pg1-starter-kit
.. _SLSTK3401A User Guide: https://www.silabs.com/documents/public/user-guides/ug154-stk3401-user-guide.pdf
.. _EFM32PG Website: https://www.silabs.com/products/mcu/32-bit/efm32-pearl-gecko
.. _EFM32PG1 Datasheet: https://www.silabs.com/documents/public/data-sheets/efm32pg1-datasheet.pdf
.. _EFM32PG1 Reference Manual: https://www.silabs.com/documents/public/reference-manuals/efm32pg1-rm.pdf
.. _J-Link: https://www.segger.com/jlink-debug-probes.html