1. Overview

This is the Linux BSP (Board Support Package) and the development environment for the STM32H7 System-On-Module (SOM) and Starter Kit, release 2.6.1.

The BSP provides a software development environment for evaluation and development of Linux (uClinux) on the Cortex-M7 processor core of the STM32H7 microcontroller using the Emcraft STM32H7 SOM Starter Kit as a hardware platform.

2. Supported Features

The following list provides a summary of the features and capabilities of this release of the STM32H7 BSP:

• Linux:

  • Kernel v.6.1.28;

  • Serial Linux console;

  • Ethernet device driver and Linux TCP/IP networking (ping, NFS, Telnet, FTP, NTPD, etc);

  • Clock driver;

  • pinctrl driver;

  • busybox v1.35.0;

  • POSIX pthreads;

  • Hardened exception handling; an exception triggered by a process affects only the offending process.

• U-Boot firmware:

  • U-Boot v 2019.04-rc3;

  • Serial console command interface with various setup, test and maintenance commands;

  • Environment variables allowing customisation of a unit;

  • Sophisticated OS auto-boot sequence;

  • Partitioning and management of external Flash;

  • Initial installation of Linux image to external Flash.

• Development environment:

  • Linux-hosted cross-development environment;

  • 10.3-2021.10 Arm Embedded Toolchain is used for development of U-Boot, Linux;

  • 11.3 GNU toolchain is used for development of user-space applications;

  • ELF / dynamic linking supported;

  • Debugging of user-space applications with cross-GDB;

  • Hardware FPU enabled in the toolchain and kernel;

  • mkimage tool used by the Linux kernel build process to create a bootable Linux image.

3. Software Manifest

4. New and Changed Features

The following is a summary of the changes in release 2.6.1, as compared to release 2.6.0:

1. Fix bug: Controlling LEDs from user space doesn't work in uClinux 2.6.0 for STM32H7 SOM.
   ID: STM32H7-22.

2. Fix bug: The "next" command does not work in gdb 11.2.
   ID: RM 7052.

5. Known Problems and Limitations

This section lists known problems and limitations of this release:

1. Managing U-Boot environment from Linux is not supported.
   ID: STM32H7-17.

2. Switch to Low Power Mode doesn't work in uClinux 2.6.0 for STM32H7 SOM.
   ID: STM32H7-21.