boards/st/nucleo_f446re/doc/index.rst
.. zephyr:board:: nucleo_f446re
Overview
The Nucleo F446RE board features an ARM Cortex-M4 based STM32F446RE MCU with a wide range of connectivity support and configurations. Here are some highlights of the Nucleo F446RE board:
STM32 microcontroller in QFP64 package
Two types of extension resources:
On-board ST-LINK/V2-1 debugger/programmer with SWD connector
Flexible board power supply:
Three LEDs: USB communication (LD1), user LED (LD2), power LED (LD3)
Two push-buttons: USER and RESET
More information about the board can be found at the Nucleo F446RE website_.
Hardware
Nucleo F446RE provides the following hardware components:
More information about STM32F446RE can be found here:
STM32F446RE on www.st.com_STM32F446 reference manual_.. zephyr:board-supported-hw::
Nucleo F446RE Board has 8 GPIO controllers. These controllers are responsible for pin muxing, input/output, pull-up, etc.
.. image:: img/nucleo_f446re_arduino_top_left.jpg :align: center :alt: Nucleo F446RE Arduino connectors (top left) .. image:: img/nucleo_f446re_arduino_top_right.jpg :align: center :alt: Nucleo F446RE Arduino connectors (top right) .. image:: img/nucleo_f446re_morpho_top_left.jpg :align: center :alt: Nucleo F446RE Morpho connectors (top left) .. image:: img/nucleo_f446re_morpho_top_right.jpg :align: center :alt: Nucleo F446RE Morpho connectors (top right)
For more details please refer to STM32 Nucleo-64 board User Manual_.
Nucleo F446RE System Clock could be driven by an internal or external oscillator, as well as the main PLL clock. By default, the System clock is driven by the PLL clock at 84MHz, driven by an 8MHz high-speed external clock.
Nucleo F446RE board has 2 UARTs and 4 USARTs. The Zephyr console output is assigned to UART2. Default settings are 115200 8N1.
In order to test backup SRAM you may want to disconnect VBAT from VDD. You can
do it by removing SB45 jumper on the back side of the board.
The TX/RX wires connected with D14/D15 of CN5 connector. Thus the board can be
used with RS485 CAN Shield_.
Programming and Debugging
.. zephyr:board-supported-runners::
Nucleo F446RE board includes an ST-LINK/V2-1 embedded debug tool interface.
Applications for the nucleo_f446re 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:hello_world application.
Run a serial host program to connect with your Nucleo board.
.. code-block:: console
$ minicom -b 115200 -D /dev/ttyACM0
Build and flash the application:
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: nucleo_f446re :goals: build flash
You should see the following message on the console:
.. code-block:: console
$ Hello World! arm
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_f446re :maybe-skip-config: :goals: debug
.. _Nucleo F446RE website: https://www.st.com/en/evaluation-tools/nucleo-f446re.html
.. _STM32 Nucleo-64 board User Manual: https://www.st.com/resource/en/user_manual/dm00105823.pdf
.. _STM32F446RE on www.st.com: https://www.st.com/en/microcontrollers/stm32f446re.html
.. _STM32F446 reference manual: https://www.st.com/resource/en/reference_manual/dm00135183.pdf
.. _RS485 CAN Shield: https://www.waveshare.com/wiki/RS485_CAN_Shield
.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html