boards: quail: MikroBUS

boards: mikroe: Add quail board

Signed-off-by: Oleg Kokorin <[email protected]>

Author: Ole2mail

boards/mikroe/quail/Kconfig.defconfig

@@ -0,0 +1,10 @@
+# MikroE Quail board configuration
+
+# Copyright (c) 2025 ThoseBoards
+# SPDX-License-Identifier: Apache-2.0
+
+source "boards/common/usb/Kconfig.cdc_acm_serial.defconfig"
+
+config SPI_STM32_INTERRUPT
+	default y
+	depends on SPI

boards/mikroe/quail/Kconfig.mikroe_quail

@@ -0,0 +1,5 @@
+# Copyright (c) 2025 ThoseBoards
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_MIKROE_QUAIL
+	select SOC_STM32F427XX

boards/mikroe/quail/board.cmake

@@ -0,0 +1,7 @@
+# SPDX-License-Identifier: Apache-2.0
+
+board_runner_args(dfu-util "--pid=0483:df11" "--alt=0" "--dfuse")
+board_runner_args(jlink "--device=STM32F427VIT6" "--speed=4000")
+
+include(${ZEPHYR_BASE}/boards/common/dfu-util.board.cmake)
+include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

boards/mikroe/quail/board.yml

@@ -0,0 +1,6 @@
+board:
+  name: mikroe_quail
+  full_name: MikroE Quail
+  vendor: mikroe
+  socs:
+    - name: stm32f427xx

boards/mikroe/quail/doc/img/mikroe_quail.webp

@@ -0,0 +1,99 @@
+.. zephyr:board:: mikroe_quail
+
+Overview
+********
+MikroE Quail for STM32 is a development board containing an `STM32F427`_
+microcontroller. It is equipped with four mikrobus sockets.
+The edges of the board are lined with screw terminals and USB ports for
+additional connectivity.
+
+Hardware
+********
+The Quail board contains the following connections:
+
+  - Four MikroBUS connectors
+  - lined with 32 screw terminals and USB ports for
+
+Furthermore the board contains three LEDs that are connected
+to the microcontroller.
+
+Supported Features
+==================
+
+.. zephyr:board-supported-hw::
+
+Connections and IOs
+===================
+
+The four mikroBUS interfaces are aliased in the device tree so that their
+peripherals can be accessed using ``mikrobus_N_INTERFACE`` so e.g. the spi on
+bus 2 can be found by the alias ``mikrobus_2_spi``. The counting corresponds
+with the marking on the board.
+
+For connections on the edge connectors, please refer to `Quail for STM32 User Manual`_.
+
+Programming and Debugging
+*************************
+
+.. zephyr:board-supported-runners::
+
+Applications for the ``mikroe_quail`` board can be built and flashed in the usual way
+(see :ref:`build_an_application` and :ref:`application_run` for more details).
+
+
+Flashing
+========
+The initial state of the board is set to lock.
+When you flash, it will fail with the message:
+
+.. code-block:: console
+
+   Error: stm32x device protected
+
+Unlocking with openocd makes it possible to flash.
+
+.. code-block:: console
+
+   $ openocd -f /usr/share/openocd/scripts/interface/stlink-v2.cfg \
+       -f /usr/share/openocd/scripts/target/stm32f4x.cfg -c init\
+       -c "reset halt" -c "stm32f4x unlock 0" -c "reset run" -c shutdown
+
+Here is an example for the :zephyr:code-sample:`hello_world` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: mikroe_quail
+   :goals: build flash
+
+You should see the following message on the console:
+
+.. code-block:: console
+
+   Hello World! mikroe_quail
+
+
+Debugging
+=========
+
+You can debug an application in the usual way.  Here is an example for the
+:zephyr:code-sample:`hello_world` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: mikroe_quail
+   :maybe-skip-config:
+   :goals: debug
+
+References
+**********
+
+.. target-notes::
+
+.. _Quail website:
+    https://www.mikroe.com/quail
+.. _Quail for STM32 User Manual:
+    https://download.mikroe.com/documents/starter-boards/other/quail/quail-board-manual-v100.pdf
+.. _STM32F427VIT6 Website:
+    https://www.st.com/en/microcontrollers-microprocessors/stm32f427vi.html
+.. _STM32F427:
+    https://www.st.com/resource/en/datasheet/stm32f427vg.pdf