README_en.md
1
2**English** | [中文](README.md)
3
4# STM32H750-artpi Development Board BSP Guide
5
6## Introduction
7
8Welcome 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.
9
10What's Inside? Let's embark on an exciting journey through this guide, which covers:
11
12- Introduction to the wealth of resources onboard.
13- Quick Start for rapid deployment.
14- Advanced Usage for harnessing the board's full capabilities.
15
16By 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.
17
18## Development Board Introduction
19
20Development 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.
21
22Take a look at the development board's sleek design:
23
24
25
26Explore its features:
27
28- MCU: STM32H7S7, running at 550MHz with 64KB FLASH and 456KB RAM.
29- Interfaces: From USB to serial and USB OTG.
30- Debugging: Seamlessly debug with the standard ST-LINK V3.
31
32## Peripheral Playground
33
34The current support status of peripherals in this BSP is as follows:
35
36| **Onboard peripherals** | Support | Remark |
37| ----------------------- | ----------- | ------------ |
38| LED | YES | One green LE |
39| **On-chip peripherals** | **Support** | **Remark** |
40| GPIO | YES | |
41| UART | YES | UART4 |
42| SPI | YES | SPI |
43
44## Instructions for Use
45
46Instructions for use are divided into the following two sections:
47
48**Quick Start**
49
50This 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.
51
52**Advanced Usage**
53
54This 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.
55
56### Quick Start
57
58This 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.
59
60**Attention please！！！**
61
62Before 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)：
63
64```bash
65pkgs --update
66```
67
68#### Hardware Connection
69
70Connect 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.
71
72#### Compilation and Download
73
74Double-click the project.uvprojx file to open the MDK5 project, compile it, and download the program to the development board.
75
76> 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.
77
78#### Running Result
79
80After successful program download, the system will run automatically, and the LED will blink.
81
82Connect 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:
83
84```
85[I/board] System Clock information
86[I/board] SYSCLK_Frequency = 550000000
87[I/board] HCLK_Frequency = 275000000
88[I/board] PCLK1_Frequency = 137500000
89[I/board] PCLK2_Frequency = 137500000
90[I/board] XSPI1_Frequency = 200000000
91[I/board] XSPI2_Frequency = 200000000
92
93 \ | /
94- RT - Thread Operating System
95 / | \ 5.1.0 build Apr 10 2024 14:32:06
96 2006 - 2024 Copyright by RT-Thread team
97msh >
98```
99
100
101
102### Advanced Usage
103
104By 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:
105
1061. Open the env tool under bsp.
1072. Enter the `menuconfig` command to configure the project, save and exit after configuration.
1083. Enter the `pkgs --update` command to update the software package.
1094. Enter the `scons --target=mdk4/mdk5/iar` command to regenerate the project.
110
111## Pro Tips
112
113- Mapping of debug serial port to USART4:
114
115 PD0 ------> USART4_RX
116
117 PD1 ------> USART4_TX
118
119- Bootloader Damage or Loss
120
121 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.
122
123 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.
124
125## Contact Info
126
127RT-Thread Club: https://club.rt-thread.io/
128
129## Code Contribution
130
131 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.
