Release Notes 3.0.1

1. Overview

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

2. Hardware Platform

Refer to the following page for detailed information on the hardware items included in the Starter Kit: STM32H7 SOM Starter Kit.

The FreeRTOS BSP supports STM32H7 SOM Starter Kits with STM32H7-BSB Rev 1A and STM32H7-BSB Rev 2A baseboards.

3. Release Images

Release images for this software release can be downloaded from the Emcraft web site (requires registration and login):

The archive contains the following files:

  • keys/ - the certificate used for signing the FreeRTOS image;

  • scripts/stm32h7-som-prog.kermit - installation script;

  • freertos_stm32h750.img - FreeRTOS image;

  • u-boot.img - U-Boot image;

  • u-boot-spl.bin - U-Boot-SPL image;

  • stm32h7-splash-24bpp.bmp - splash image.

4. Setting Up Kit and Development Host

Refer to the following page for detailed information on how to build and use this software release: STM32H7 SOM Software.

5. Supported Features

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

  • 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 RTOS auto-boot sequence;

    • Partitioning and management of external Flash;

    • Initial installation of RTOS images to external Flash.

  • FreeRTOS:

    • FreeRTOS v.10.3.1;

    • STM32CubeH7 v1.11.0 HAL;

    • Device drivers for key I/O interfaces of the STM32H7 SOM;

    • Driver for WiFi ESP Click module.

  • Development environment:

    • Linux-hosted cross-development environment.

6. Software Manifest

Repo

Link

Hash

Tag

STM32Cube H7

https://gitlab.com/emcraft/STM32H7/STM32CubeH7.git

b12afcd4

emcraft-h7-3.0.1

U-Boot STM32H7

https://gitlab.com/emcraft/STM32H7/u-boot-upstream.git

20062ac0

emcraft-h7-3.0.1

7. New Functionality

7.1. Release 3.0.1 New Functionality

The following is a summary of the changes in Release 3.0.1, as compared to Release 3.0.0:

Issue Key

Summary

6854

Support WiFi ESP CLICK (MIKROE-2542) in FreeRTOS

7.2. Release 3.0.0 New Functionality

The following is a summary of the changes in Release 3.0.0, as compared to Release 2.0.1:

Issue Key

Summary

RM6849

Port FreeRTOS BSP to STM32H7-BSB Rev 2A

RM6853

Support Ethernet in U-Boot on BSB Rev 2A

7.3. Release 2.0.1 New Functionality

The following is a summary of the changes in Release 2.0.1, as compared to Release 2.0.0:

Issue Key

Summary

RM6598

Support Ethernet in U-Boot

RM6620

Fix the USB Host Mode Issue

RM6625

Fix the Touch Sensor Controller Initialization Routine

7.4. Release 2.0.0 New Functionality

The following is a summary of the changes in Release 2.0.0, as compared to Release 1.1.0:

Issue Key

Summary

RM6593

Update FreeRTOS to latest supported version; Implement corresponding changes to device drivers

7.5. Release 1.1.0 New Functionality

The following is a summary of the changes in Release 1.1.0, as compared to Release 1.0.0 (Beta release):

Issue Key

Summary

RM6589

Productise FreeRTOS BSP and software workflows

8. Known Problems and Limitations

This section lists known problems and limitations of this release.

  1. LCD Glitches in FreeRTOS BSP for STM32H7 SOM.The grayscale gradient part of the test pattern and some of the white lines are displayed incorrectly when FreeRTOS switches the image from the splash screen to the test pattern. The following picture illustrates this issue:

The issue persists on STM32H7 SOM Starter Kits with STM32H7-BSB Rev 1A and STM32H7-BSB Rev 2A baseboards.ID: RM 6874.
Workaround: None.