rt-thread/bsp/stm32/stm32h7s7-st-disco/README_en.md

English | 中文

STM32H750-artpi Development Board BSP Guide

Introduction

Welcome to the realm of innovation with the STM32H7S78-DK development board. This document serves as your guide to unleash the full potential of the Board Support Package (BSP) tailored for this cutting-edge hardware.

What's Inside? Let's embark on an exciting journey through this guide, which covers:

• Introduction to the wealth of resources onboard.
• Quick Start for rapid deployment.
• Advanced Usage for harnessing the board's full capabilities.

By reading the Quick Start section, developers can quickly get started with this BSP and run RT-Thread on the development board. In the Advanced Usage Guide section, more advanced features will be introduced to help developers utilize RT-Thread to drive more onboard resources.

Development Board Introduction

Development Board Introduction The STM32H7S78-DK is a development board based on the ARM Cortex-M7 core, with a maximum main frequency of 600MHz. This development board has abundant onboard resources, allowing for a comprehensive evaluation of the performance of the STM32H7S7 chip.

Take a look at the development board's sleek design:

Explore its features:

• MCU: STM32H7S7, running at 550MHz with 64KB FLASH and 456KB RAM.
• Interfaces: From USB to serial and USB OTG.
• Debugging: Seamlessly debug with the standard ST-LINK V3.

Peripheral Playground

The current support status of peripherals in this BSP is as follows:

Onboard peripherals	Support	Remark
LED	YES	One green LE
On-chip peripherals	Support	Remark
GPIO	YES
UART	YES	UART4
SPI	YES	SPI

Instructions for Use

Instructions for use are divided into the following two sections:

Quick Start

This section provides instructions for newcomers to RT-Thread, following simple steps to run the RT-Thread operating system on this development board and observe experimental results.

Advanced Usage

This section is for developers who need to use more development board resources on the RT-Thread operating system. By configuring the BSP using the ENV tool, more onboard resources can be enabled to implement more advanced features.

Quick Start

This BSP provides an MDK5 project for developers and supports the GCC development environment. Below is an example using the MDK5 development environment to start the system.

Attention please！！！

Before the compilation work, please open ENV and execute the following command (this command is used to pull the necessary HAL library and CMSIS library, otherwise it cannot be compiled)：

pkgs --update

Hardware Connection

Connect the ST-Link port of the development board to the PC using a data cable and ensure that the power supply jumpers on the board are properly configured.

Compilation and Download

Double-click the project.uvprojx file to open the MDK5 project, compile it, and download the program to the development board.

The project default configuration uses the ST-LINK emulator to download the program. After connecting the development board via ST-LINK, click the download button to download the program to the development board.

Running Result

After successful program download, the system will run automatically, and the LED will blink.

Connect the corresponding serial port of the development board to the PC, open the terminal tool, and reset the device. You will see RT-Thread output information:

[I/board] System Clock information
[I/board] SYSCLK_Frequency = 550000000
[I/board] HCLK_Frequency   = 275000000
[I/board] PCLK1_Frequency  = 137500000
[I/board] PCLK2_Frequency  = 137500000
[I/board] XSPI1_Frequency  = 200000000
[I/board] XSPI2_Frequency  = 200000000

 \ | /
- RT -     Thread Operating System
 / | \     5.1.0 build Apr 10 2024 14:32:06
 2006 - 2024 Copyright by RT-Thread team
msh >

Advanced Usage

By default, this BSP only enables the functions of GPIO and UART4. If more advanced features are required, ENV tools need to be used to configure BSP, as follows:

1. Open the env tool under bsp.
2. Enter the menuconfig command to configure the project, save and exit after configuration.
3. Enter the pkgs --update command to update the software package.
4. Enter the scons --target=mdk4/mdk5/iar command to regenerate the project.

Pro Tips

• Mapping of debug serial port to USART4:

PD0 ------> USART4_RX

PD1 ------> USART4_TX

• Bootloader Damage or Loss

In case the board does not boot after program download, please first check if the bootloader is not burned or is lost due to erasure of internal flash. If the bootloader is missing, it needs to be rewritten by downloading the h7s7_disco_bootloader.bin file under the directory to the chip's internal flash using the STM32CubeProgrammer tool (ST official download tool) after connecting the development board to the PC. Then disconnect and manually reset the MCU, and the external jump should be executed at this time.

This bin file is generated from the STM32H7RS SDK internal example project. If the external Flash model is modified, you can refer to ST's example for modification.

Contact Info

RT-Thread Club: https://club.rt-thread.io/

Code Contribution

This project is still in its initial stage, and the BSP is not yet perfect. If you are interested in this project and have some interesting projects to share with us, you are welcome to contribute code.