boards/st/nucleo_l552ze_q/doc/nucleol552ze_q.rst
.. zephyr:board:: nucleo_l552ze_q
Overview
The Nucleo L552ZE Q board, featuring an ARM Cortex-M33 based STM32L552ZE MCU, 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. Here are some highlights of the Nucleo L552ZE Q board:
STM32L552ZE microcontroller in LQFP144 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
External or internal SMPS to generate Vcore logic supply
USB OTG full speed or device only
More information about the board can be found at the Nucleo L552ZE Q website_.
Hardware
The STM32L552xx devices are an ultra-low-power microcontrollers family (STM32L5 Series) based on the high-performance Arm® Cortex®-M33 32-bit RISC core. They operate at a frequency of up to 110 MHz.
Ultra-low-power with FlexPowerControl (down to 108 nA Standby mode and 62 uA/MHz run mode)
Core: ARM® 32-bit Cortex®-M33 CPU with TrustZone® and FPU.
Performance benchmark:
Security
Clock management:
Power management
RTC with HW calendar, alarms and calibration
Up to 114 fast I/Os, most 5 V-tolerant, up to 14 I/Os with independent supply down to 1.08 V
Up to 22 capacitive sensing channels: support touchkey, linear and rotary touch sensors
Up to 16 timers and 2 watchdogs
Memories
Rich analog peripherals (independent supply)
19x communication interfaces
CRC calculation unit
Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell™
More information about STM32L552ZE can be found here:
STM32L552ZE on www.st.com_STM32L552 reference manual_.. zephyr:board-supported-hw::
The STM32L552e is an SoC with Cortex-M33 architecture. Zephyr provides support for building for both Secure and Non-Secure firmware.
The BOARD options are summarized below:
+--------------------------------+-------------------------------------------+ | BOARD | Description | +================================+===========================================+ | nucleo_l552ze_q | For building Trust Zone Disabled firmware | +--------------------------------+-------------------------------------------+ | nucleo_l552ze_q/stm32l552xx/ns | For building Non-Secure firmware | +--------------------------------+-------------------------------------------+
Here are the instructions to build Zephyr with a non-secure configuration,
using :zephyr:code-sample:tfm_ipc sample:
.. code-block:: console
$ west build -b nucleo_l552ze_q/stm32l552xx/ns samples/tfm_integration/tfm_ipc/
Once done, before flashing, you need to first run a generated script that will set platform option bytes config and erase platform (among others, option bit TZEN will be set).
.. code-block:: bash
$ ./build/tfm/api_ns/regression.sh
$ west flash
Please note that, after having run a TFM sample on the board, you will need to
run ./build/tfm/api_ns/regression.sh once more to clean up the board from secure
options and get back the platform back to a "normal" state and be able to run
usual, non-TFM, binaries.
Also note that, even then, TZEN will remain set, and you will need to use
STM32CubeProgrammer_ to disable it fully, if required.
Nucleo L552ZE Q Board has 8 GPIO controllers. These controllers are responsible for pin muxing, input/output, pull-up, etc.
.. image:: img/nucleo_l552ze_q_zio_left_2020_2_11.jpg :align: center :alt: Nucleo L552ZE Q Zio left connector .. image:: img/nucleo_l552ze_q_zio_right_2020_2_11.jpg :align: center :alt: Nucleo L552ZE Q Zio right connector
For more details please refer to STM32 Nucleo-144 board User Manual_.
Nucleo L552ZE Q System Clock could be driven by internal or external oscillator, as well as main PLL clock. By default System clock is driven by PLL clock at 110MHz, driven by 4MHz medium speed internal oscillator.
Nucleo L552ZE Q board has 6 U(S)ARTs. The Zephyr console output is assigned to UART2. Default settings are 115200 8N1.
Programming and Debugging
.. zephyr:board-supported-runners::
Nucleo L552ZE Q board includes an ST-LINK/V2-1 embedded debug tool interface.
Applications for the nucleo_l552ze_q 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 pyOCD can also be used to flash the board using
the --runner (or -r) option:
.. code-block:: console
$ west flash --runner openocd $ west flash --runner pyocd
Support can be enabled for pyOCD by adding "pack" support with the following pyOCD commands:
.. code-block:: console
$ pyocd pack --update $ pyocd pack --install stm32l552ze
Connect the Nucleo L552ZE Q to your host computer using the USB port.
Then build and flash an application. 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 -D /dev/ttyACM0
Then build and flash the application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: nucleo_l552ze_q :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_l552ze_q :maybe-skip-config: :goals: debug
.. _Nucleo L552ZE Q website: https://www.st.com/en/evaluation-tools/nucleo-l552ze-q.html
.. _STM32 Nucleo-144 board User Manual: https://www.st.com/resource/en/user_manual/dm00615305.pdf
.. _STM32L552ZE on www.st.com: https://www.st.com/en/microcontrollers/stm32l552ze.html
.. _STM32L552 reference manual: https://www.st.com/resource/en/reference_manual/DM00346336.pdf
.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html