Overview

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

The BSP provides a software development environment for evaluation and development of Linux (uClinux) on the Cortex-A7 processor core of the STM32MP1 microcontroller (the 650MHz STM32MP157A and 800MHz STM32MP157D variants) using the Emcraft STM32MP1 SOM Starter Kit as a hardware platform.

Supported Features

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

• Linux:

  • Kernel v.6.1.28;

  • Serial Linux console;

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

  • eMMC/SD device driver;

  • USB host/gadget device driver;

  • LCD device driver;

  • Touchscreen device driver;

  • Clock driver;

  • pinctrl driver;

  • busybox v1.36.0;

  • POSIX pthreads;

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

• U-Boot firmware:

  • U-Boot v 2022.10;

  • 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;

  • Yocto v4.2.1 distribution.

New and Changed Features

This section lists new and changed features of this release:

1. Add support for the 800MHz STM32MP1-SOM based on STM32MP157D processor.
   ID: STM32MP1-1.

Known Problems and Limitations

This section lists known problems and limitations of this release:

1. Managing U-Boot environment from Linux is not supported.

2. Some SD cards (mostly 32GB and higher capacity) are not detected or properly initialized by the system.
   ID: RM 6831.
   Workaround: 8GB SD cards from Kingstone, Transcend, Bestbuy are known to work reliably and can be used as a temporary work-around until a more generic solution is developed.

Further Reading

• Hardware Materials:

• Documentation Items:

Support

Customers of the Emcraft i.MX 8M Starter Kit may contact Emcraft at a2f-linux-support@emcraft.com for support.