boards/st/nucleo_g031k8/doc/index.rst
.. zephyr:board:: nucleo_g031k8
Overview
The STM32 Nucleo-32 board provides an affordable and flexible way for users to try out new concepts and build prototypes by choosing from the various combinations of performance and power consumption features, provided by the STM32 microcontroller.
The Arduino™ Nano V3 connectivity support allows the easy expansion of the functionality of the STM32 Nucleo open development platform with a wide choice of specialized shields.
The STM32 Nucleo-32 board does not require any separate probe as it integrates the ST-LINK debugger/programmer.
The STM32 Nucleo-32 board comes with the STM32 comprehensive free software libraries and examples available with the STM32Cube MCU Package.
More information about the board can be found at the Nucleo G031K8 website_.
Hardware
Nucleo G031K8 provides the following hardware components:
STM32 microcontroller in 32-pin package featuring 64 Kbytes of Flash memory and 8 Kbytes of SRAM.
Extension resource:
On-board ST-LINK/V2-1 debugger/programmer with SWD connector:
Flexible board power supply:
Four LEDs:
One push-button: RESET
USB re-enumeration capability. Three different interfaces supported on USB:
More information about STM32G031K8 can be found in the
STM32G0x1 reference manual_
.. zephyr:board-supported-hw::
Each of the GPIO pins can be configured by software as output (push-pull or open-drain), as input (with or without pull-up or pull-down), or as peripheral alternate function. Most of the GPIO pins are shared with digital or analog alternate functions. All GPIOs are high current capable except for analog inputs.
For more details please refer to STM32 Nucleo-32 board User Manual_.
Programming and Debugging
.. zephyr:board-supported-runners::
Nucleo G031K8 board includes an ST-LINK/V2-1 embedded debug tool interface.
Applications for the nucleo_g031k8 board configuration can be built and
flashed in the usual way (see :ref:build_an_application and
:ref:application_run for more details).
The board is configured to be flashed using west STM32CubeProgrammer_ runner,
so its :ref:installation <stm32cubeprog-flash-host-tools> is required.
Alternatively, OpenOCD or JLink can also be used to flash the board using
the --runner (or -r) option:
.. code-block:: console
$ west flash --runner openocd $ west flash --runner jlink
Here is an example for the :zephyr:code-sample:blinky application.
.. zephyr-app-commands:: :zephyr-app: samples/basic/blinky :board: nucleo_g031k8 :goals: build flash
You will see the LED blinking every second.
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: nucleo_g031k8 :maybe-skip-config: :goals: debug
Restriction
On some boards, the board reset line is not used by the controller. Therefore the reset button, reset-pin and the ST-Link reset have no effect. To enable those functionalities, the option byte NRST_mode in the User Configuration needs to be changed from 2 to 1 or 3 - depending on the requirements.
References
.. target-notes::
.. _Nucleo G031K8 website: https://www.st.com/en/evaluation-tools/nucleo-g031k8.html
.. _STM32G0x1 reference manual: https://www.st.com/resource/en/reference_manual/rm0444-stm32g0x1-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
.. _STM32 Nucleo-32 board User Manual: https://www.st.com/resource/en/user_manual/um2591-stm32g0-nucleo32-board-mb1455-stmicroelectronics.pdf
.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html