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>

boards/arm/efm32gg_sltb009a/doc/index.rst

@@ -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