1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/boards/nucleo-l552ze-q/doc.txt
2024-05-24 11:02:14 +02:00

103 lines
3.9 KiB
Plaintext

/**
@defgroup boards_nucleo-l552ze-q STM32 Nucleo-L552ZE-Q
@ingroup boards_common_nucleo144
@brief Support for the STM32 Nucleo-L552ZE-Q
## Overview
The Nucleo-L552ZE-Q is a board from ST's Nucleo family supporting ARM Cortex-M33
STM32L552ZE ultra-low-pawer microcontroller with TrustZone, 256KiB of RAM and 512KiB
of Flash.
## Hardware
![Nucleo144 L552ZE-Q](https://www.st.com/bin/ecommerce/api/image.PF267817.en.feature-description-include-personalized-no-cpn-large.jpg)
### MCU
| MCU | STM32L552ZE |
|:-------------|:-----------------------------|
| Family | ARM Cortex-M33 |
| Vendor | ST Microelectronics |
| RAM | 256KiB |
| Flash | 512KiB |
| Frequency | up tp 110MHz |
| FPU | yes |
| TrustZone | yes |
| Timers | 16 |
| UARTs | 6 (3xUSART, 2xUART, 1xLPUART)|
| I2Cs | 4 |
| SPIs | 3 |
| CAN | 1 |
| Datasheet | [Datasheet](https://www.st.com/resource/en/datasheet/stm32l552ze.pdf)|
| Reference Manual | [Reference Manual](https://www.st.com/resource/en/reference_manual/dm00346336-stm32l552xx-and-stm32l562xx-advanced-arm-based-32-bit-mcus-stmicroelectronics.pdf)|
| Programming Manual | [Programming Manual](https://www.st.com/resource/en/programming_manual/pm0264-stm32-cortexm33-mcus-programming-manual-stmicroelectronics.pdf)|
| Board Manual | [Board Manual](https://www.st.com/resource/en/user_manual/dm00615305-stm32l5-nucleo-144-board-mb1361-stmicroelectronics.pdf)|
## Flashing the device
### Flashing the Board Using OpenOCD
The ST Nucleo-L552ZE-Q board includes an on-board ST-LINK programmer and can be
flashed using OpenOCD.
@note The upstream version of OpenOCD doesn't contain yet support for this board,
so the source code version from http://openocd.zylin.com/#/c/5510
must be built to be able to flash this board (adapt the configure command with
your preferred installation directory):
```
$ git clone https://git.code.sf.net/p/openocd/code openocd
$ cd openocd
$ git fetch http://openocd.zylin.com/openocd refs/changes/10/5510/5 && git checkout FETCH_HEAD
$ ./bootstrap
$ ./configure --prefix=<installation directory>
$ make -j
$ sudo make install
```
Once the patched OpenOCD is built and installed, you can flash the board simply
by typing
```
make BOARD=nucleo-l552ze-q flash
```
and debug via GDB by simply typing
```
make BOARD=nucleo-l552ze-q debug
```
### Flashing the Board Using ST-LINK Removable Media
On-board ST-LINK programmer provides via composite USB device removable media.
Copying the HEX file causes reprogramming of the board. This task
could be performed manually; however, the cpy2remed (copy to removable
media) PROGRAMMER script does this automatically. To program board in
this manner, use the command:
```
make BOARD=nucleo-l552ze-q PROGRAMMER=cpy2remed flash
```
@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
could be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
## Accessing RIOT shell
Default RIOT shell access utilize VCP (Virtual COM Port) via USB interface,
provided by integrated ST-LINK programmer. ST-LINK is connected to the
microcontroller LPUART1.
The default baud rate is 115 200.
If a physical connection to LPUART1 is needed, connect UART interface to pins
PG7 (LPUART1 TX) and PG8 (LPUART1 RX).
@note Accordingly to the [MCU Datasheet](https://www.st.com/resource/en/datasheet/stm32l552ze.pdf)
PG7 and PG8 pins are 5V tolerant (see table 21, page 108).
## Supported Toolchains
For using the ST Nucleo-L552ZE-Q board we recommend the usage of the
[GNU Tools for ARM Embedded Processors](https://launchpad.net/gcc-arm-embedded)
toolchain.
*/