boards: silabs: Add SiM3U1xx-B-DK

# Copyright (c) 2024 GARDENA GmbH

#

# SPDX-License-Identifier: Apache-2.0

config BOARD_SIM3U1XX_DK

	select SOC_PART_NUMBER_SIM3U167AGQ

# Copyright (c) 2024 GARDENA GmbH

#

# SPDX-License-Identifier: Apache-2.0

include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)

board_runner_args(jlink "--device=SiM3U167")

include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

# Copyright (c) 2024 GARDENA GmbH

#

# SPDX-License-Identifier: Apache-2.0

board:

  name: sim3u1xx_dk

  vendor: silabs

  socs:

    - name: sim3u167

.. _sim3u1xx_dk:

Silicon Labs SiM3U1xx 32-bit MCU USB Development Kit

####################################################

Overview

********

This is a `development kit`_ that is used to develop software for the SiM3U1xx MCUs.

.. figure:: sim3u1xx_dk.webp

   :align: center

Hardware

********

- Silicon Labs SiM3U167-B-GM SoC

- CPU core: ARM Cortex®-M3

- Flash memory: 256 kB

- RAM: 32 kB

- IO:

  - 2x user LEDs

  - 2x user push buttons

  - 2x power LEDs

  - Reset push button

  - Potentiometer

  - Analog terminals

  - Capacitive sensing slider and button

  - USB virtual COM port

For more information about the SiM3U167 SoC and the SiM3U1xx board, refer to these documents:

- Silicon Labs SiM3U1xx_

- Silicon Labs SiM3U167-B-GM_

- Silicon Labs SiM3U1xx-B-DK_

- Silicon Labs SiM3U1xx-B-DK MCU card `user's guide`_

- Silicon Labs SiM3U1xx and SiM3C1xx Revision B Errata_

.. _SiM3U1xx: https://www.silabs.com/mcu/32-bit-microcontrollers/precision32-sim3u1xx

.. _SiM3U167-B-GM: https://www.silabs.com/mcu/32-bit-microcontrollers/precision32-sim3u1xx/device.sim3u167-b-gm

.. _SiM3U1xx-B-DK: https://www.silabs.com/development-tools/mcu/32-bit/sim3u1xx-development-kit

.. _user's guide: https://www.silabs.com/documents/public/user-guides/UPMU-M3U160.pdf

.. _Errata: https://www.silabs.com/documents/public/errata/SiM3U1xx-SiM3C1xxErrata.pdf

Supported Features

==================

The board configuration supports the following hardware features:

+-----------+------------+-------------------------------------+

| Interface | Controller | Driver/Component                    |

+===========+============+=====================================+

| NVIC      | on-chip    | nested vector interrupt controller  |

+-----------+------------+-------------------------------------+

| SYSTICK   | on-chip    | systick                             |

+-----------+------------+-------------------------------------+

| FLASH     | on-chip    | flash memory                        |

+-----------+------------+-------------------------------------+

| GPIO      | on-chip    | gpio                                |

+-----------+------------+-------------------------------------+

| UART      | on-chip    | serial port-polling;                |

|           |            | serial port-interrupt               |

+-----------+------------+-------------------------------------+

Connections and IOs

===================

+--------+--------------------------+----------------------------------------------------+

| Pin    | Name                     | Note                                               |

+========+==========================+====================================================+

| PB1.12 | TX (O)                   | Serial connection to host via USB virtual COM port |

+--------+--------------------------+                                                    |

| PB1.13 | RX (I)                   |                                                    |

+--------+--------------------------+                                                    |

| PB1.14 | RTS (O)                  |                                                    |

+--------+--------------------------+                                                    |

| PB1.15 | CTS (I)                  |                                                    |

+--------+--------------------------+----------------------------------------------------+

| PB2.8  | Push button switch (SW2) |                                                    |

+--------+--------------------------+----------------------------------------------------+

| PB2.9  | Push button switch (SW3) |                                                    |

+--------+--------------------------+----------------------------------------------------+

| PB2.10 | Red LED (DS3)            |                                                    |

+--------+--------------------------+----------------------------------------------------+

| PB2.11 | Yellow LED (DS4)         |                                                    |

+--------+--------------------------+----------------------------------------------------+

| PB1.5  | Potentiometer            |                                                    |

+--------+--------------------------+----------------------------------------------------+

| PB2.12 | Potentiometer bias       |                                                    |

+--------+--------------------------+----------------------------------------------------+

Programming and Debugging

*************************

Flashing

========

The sample application :ref:`hello_world` is used for this example. Build the Zephyr kernel and

application:

.. zephyr-app-commands::

   :zephyr-app: samples/hello_world

   :board: sim3u1xx_dk

   :goals: build

Connect the sim3u1xx_dk to your host computer using both USB port and you should see a USB serial

connection.

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! sim3u1xx_dk/sim3u167

References

**********

.. target-notes::

.. _development kit:

   https://www.silabs.com/development-tools/mcu/32-bit/sim3u1xx-development-kit