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.1.0.

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. Support STM32MP1-BSB in Emcraft BSP and distribution.
   ID: STM32MP1-6.

2. Fix issue: Boot from SD does not work with STM32MP1-BSB Rev 2A.
   ID: STM32MP1-12.

3. Fix issue: Some SD cards do not work with STM32MP1-BSB.
   ID: STM32MP1-26.

4. Fix issue: 5V should not be applied to USB OTG by default.
   ID: STM32MP1-29.

5. Support MIPI DSI with STM32MP1-BSB.
   ID: STM32MP1-22.

6. Support DCMI camera (Waveshare OV5640 A) with STM32MP1-BSB.
   ID: STM32MP1-23.

7. Add support for the TPM Click card to Linux BSP.
   ID: STM32MP1-8.

Known Problems and Limitations

This section lists known problems and limitations of this release:

1. Ethernet does not work if the cable is not attached during boot.
   ID: STM32MP1-14.

2. Cannot modify Flash on SPI Flash dongle.
   ID: STM32MP1-17.

3. Touchscreen does not work with STM32MP1-BSB.
   ID: STM32MP1-18.

4. The STM32MP1-SOM is reset after waking up from the low power mode.
   ID: STM32MP1-24.

5. USB Mouse and USB keyboard does not work in USB-A.
   ID: STM32MP1-30.

6. Support resolutions other than 320*240 / 15 fps for DCMI camera.
   ID: STM32MP1-32.

7. Managing U-Boot environment from Linux is not supported.
   ID: STM32MP1-34.

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.