|
|
@@ -1,91 +1,95 @@
|
|
|
-# **NUCLEO-H563ZI** 开发板 BSP 说明
|
|
|
+# **NUCLEO-STM32H563ZI** BSP Introduction
|
|
|
|
|
|
-## 简介
|
|
|
+[中文页](README_zh.md) |
|
|
|
|
|
|
-本文档为 yuanzihao为 NUCLEO-STM32H563ZIT6 开发板提供的 BSP (板级支持包) 说明。
|
|
|
+## Introduction
|
|
|
|
|
|
-主要内容如下：
|
|
|
+This document records the execution instruction of the BSP (board support package) provided by the RT-Thread development team for the NUCLEO-STM32H563ZIT6 development board.
|
|
|
|
|
|
-- 开发板资源介绍
|
|
|
-- BSP 快速上手
|
|
|
-- 注意事项及参考资料
|
|
|
+The document is covered in three parts:
|
|
|
|
|
|
-通过阅读快速上手章节开发者可以快速地上手该 BSP，将 RT-Thread 运行在开发板上。
|
|
|
+- NUCLEO-STM32H563ZIT6 Board Resources Introduction
|
|
|
+- Quickly Get Started
|
|
|
+- Advanced Features
|
|
|
|
|
|
-## 开发板介绍
|
|
|
+By reading the Quickly Get Started section developers can quickly get their hands on this BSP and run RT-Thread on the board. More advanced features will be introduced in the Advanced Features section to help developers take advantage of RT-Thread to drive more on-board resources.
|
|
|
|
|
|
-NUCLEO-STM32H563ZIT6是 ST 推出的一款基于 ARM Cortex-M33 内核的开发板，最高主频为 250Mhz，2 MB Flash，640 KB RAM，该开发板具有丰富的板载资源，可以充分发挥 STM32H563ZIT6的芯片性能。
|
|
|
+## Board Resources Introduction
|
|
|
|
|
|
-开发板外观如下图所示（板载TYPE-C接口的STLINK-V3哦）：
|
|
|
+the ARM Cortex-M33 core. It operates at a maximum frequency of 250MHz and comes equipped with 2 MB Flash and 640 KB RAM. This development board offers abundant onboard resources, allowing for the full utilization of the STM32H563ZIT6 chip's performance capabilities.
|
|
|
|
|
|
-
|
|
|
+The appearance of the development board is as shown in the following picture.
|
|
|
|
|
|
-该开发板常用 **板载资源** 如下：
|
|
|
+
|
|
|
|
|
|
-- MCU：STM32H563ZI，高性能，Arm Cortex-M33带有TrustZone，MCU带有2 MB Flash，640 KB RAM，250 MHz CPU，375 DMIPS (Dhrystone 2.1)
|
|
|
-- 通用特性
|
|
|
- - 采用LQFP144封装的STM32 微控制器
|
|
|
- - 3个用户LED
|
|
|
- - 2个用户按钮和复位按钮
|
|
|
- - 32.768 kHz晶体振荡器
|
|
|
- - 板连接器：SWDST Zio扩展连接器，包括ARDUINO® Uno V3ST morpho扩展连接器
|
|
|
- - 灵活的供电选项：ST-LINK、USB VBUS或外部电源
|
|
|
- - 具有USB重新枚举功能的板上ST-LINK调试器/编程器：大容量存储器、虚拟COM端口和调试端口
|
|
|
- - 提供了全面的免费软件库和例程，可从STM32Cube MCU软件包获得
|
|
|
- - 支持多种集成开发环境（IDE），包括IAR™、Keil®、和STM32CubeIDE
|
|
|
+The mainly-used **on-board resources** are shown as follows:
|
|
|
|
|
|
-开发板更多详细信息请参考 ST [STM32H563ZI]([STM32H563ZI - 高性能，Arm Cortex-M33带有TrustZone，MCU带有2 MB Flash，640 KB RAM，250 MHz CPU - 意法半导体STMicroelectronics](https://www.st.com/zh/microcontrollers-microprocessors/stm32h563zi.html))。
|
|
|
+- MCU: The STM32H563ZI is a high-performance microcontroller unit (MCU) featuring an Arm Cortex-M33 with TrustZone. The MCU is equipped with 2 MB Flash, 640 KB RAM, a 250 MHz CPU, and achieves 375 DMIPS (Dhrystone 2.1).
|
|
|
+- Common features
|
|
|
+ - STM32 microcontroller in an LQFP144 package
|
|
|
+ - 3 user LEDs
|
|
|
+ - 2 user and reset push-buttons
|
|
|
+ - 32.768 kHz crystal oscillator
|
|
|
+ - Board connectors:
|
|
|
+ - SWD
|
|
|
+ - ST Zio expansion connector including ARDUINO® Uno V3
|
|
|
+ - ST morpho expansion connector
|
|
|
+ - Flexible power-supply options: ST-LINK USB VBUS, USB connector, or external sources
|
|
|
+ - On-board ST-LINK debugger/programmer with USB re-enumeration capability: mass storage, Virtual COM port, and debug port
|
|
|
+ - Comprehensive free software libraries and examples available with the STM32Cube MCU Package
|
|
|
+ - Support of a wide choice of Integrated Development Environments (IDEs) including IAR Embedded Workbench®, MDK-ARM, and STM32CubeIDE
|
|
|
|
|
|
-硬件框图如下：
|
|
|
+#### For more details about this board, please refer to the [ST official documentation](https://www.st.com/en/evaluation-tools/nucleo-h563zi.html)
|
|
|
|
|
|
-
|
|
|
+The hardware block diagram is as follows:
|
|
|
|
|
|
-## 外设支持
|
|
|
+
|
|
|
|
|
|
-本 BSP 目前对外设的支持情况如下：
|
|
|
+### Peripheral Condition
|
|
|
|
|
|
-| **板载外设** | **支持情况** | **备注** |
|
|
|
-| :------------------------------- | :----------: | :------- |
|
|
|
-| USB 转 串口(板载**STLINK-V3EC**) | 支持 | |
|
|
|
-| **片上外设** | **支持情况** | **备注** |
|
|
|
-| GPIO | 支持 | |
|
|
|
-| UART | 支持 | UART3 |
|
|
|
+Each peripheral supporting condition for this BSP is as follows:
|
|
|
|
|
|
+| **On-chip Peripheral Drivers** | **Support** | **Remark** |
|
|
|
+| --------------------------------------- | ----------- | ---------- |
|
|
|
+| GPIO | Support | |
|
|
|
+| UART | Support | UART3 |
|
|
|
+| USB to Serial (Onboard **STLINK-V3EC**) | Support | |
|
|
|
+| PWM | Support | |
|
|
|
+| ADC | Support | |
|
|
|
|
|
|
-## 使用说明
|
|
|
+## User Manual
|
|
|
|
|
|
-使用说明分为如下两个章节：
|
|
|
+The user manual is divided into the following two sections:
|
|
|
|
|
|
-- 快速上手
|
|
|
+- Quick Start
|
|
|
|
|
|
- 本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
|
|
|
+ This section is designed for beginners who are new to RT-Thread. By following simple steps, you can run the RT-Thread operating system on the development board and observe the experimental results.
|
|
|
|
|
|
-- 进阶使用
|
|
|
+- Advanced Usage
|
|
|
|
|
|
- 本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置，可以开启更多板载资源，实现更多高级功能。
|
|
|
+ This section is intended for developers who need to leverage more development board resources on the RT-Thread operating system. By using the ENV tool to configure the Board Support Package (BSP), you can enable additional onboard resources and implement more advanced functionalities.
|
|
|
|
|
|
+### Quickly Get Started
|
|
|
|
|
|
-### 快速上手
|
|
|
+This BSP provides MDK5 and IAR projects for developers. Also support GCC development environment. Here's an example of the MDK5 development environment, to introduce how to run the system.
|
|
|
|
|
|
-本 BSP 为开发者提供 MDK5 和 IAR 工程，并且支持 GCC 开发环境。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。
|
|
|
+#### Hardware Connection
|
|
|
|
|
|
-#### 硬件连接
|
|
|
+Connect the development board to the PC using a Type-C data cable.
|
|
|
|
|
|
-使用Type-C数据线连接开发板到 PC。
|
|
|
+#### Compile And Download
|
|
|
|
|
|
-#### 编译下载
|
|
|
+Double-click the `project.uvprojx` file, to open the MDK5 project, compile and download the program to the board.
|
|
|
|
|
|
-双击 project.uvprojx 文件，打开 MDK5 工程，编译并下载程序到开发板。
|
|
|
+> By default, the project uses ST_LINK simulator to download the program, when the ST_LINK connects the board, clicking the download button can download the program to the board.
|
|
|
|
|
|
-> 工程默认配置使用 ST_LINK 仿真器下载程序，在通过 ST_LINK 连接开发板的基础上，点击下载按钮即可下载程序到开发板
|
|
|
+### Running Results
|
|
|
|
|
|
-#### 运行结果
|
|
|
+After the program is successfully downloaded, the system runs automatically. Observe the running results of the LED on the development board, the LED1 will flash periodically.
|
|
|
|
|
|
-下载程序成功之后，系统会自动运行，LED1闪烁。
|
|
|
+Connect the corresponding serial port of the development board to the PC. Open the corresponding serial port in the terminal tool (115200-8-1-N). After resetting the device, you should be able to see the output information from RT-Thread.
|
|
|
|
|
|
-连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，可以看到 RT-Thread 的输出信息:
|
|
|
-
|
|
|
-```bash
|
|
|
+```
|
|
|
\ | /
|
|
|
- RT - Thread Operating System
|
|
|
/ | \ 5.0.1 build Aug 27 2023 20:47:55
|
|
|
@@ -97,39 +101,41 @@ initialize finsh_system_init:0 done
|
|
|
msh >
|
|
|
```
|
|
|
|
|
|
-### 进阶使用
|
|
|
+### Advanced Features
|
|
|
|
|
|
-此 BSP 默认只开启了 GPIO 和 UART1 的功能，如果需使用更多高级功能，需要利用 ENV 工具对BSP 进行配置，步骤如下：
|
|
|
+This BSP only enables GPIO and serial port 1 by default. If need more advanced features, you need to configure the BSP with RT-Thread Env tools, as follows:
|
|
|
|
|
|
-1. 在 bsp 下打开 env 工具。
|
|
|
+- Open the [Env](https://www.rt-thread.io/download.html?download=Env) tool under this BSP;
|
|
|
|
|
|
-2. 输入`menuconfig`命令配置工程，配置好之后保存退出。
|
|
|
+- Enter the `menuconfig` command to configure the project, then save and exit;
|
|
|
|
|
|
-3. 输入`pkgs --update`命令更新软件包。
|
|
|
+- Enter the `pkgs --update` command to update the packages;
|
|
|
|
|
|
-4. 输入`scons --target=mdk4/mdk5/iar` 命令重新生成工程。
|
|
|
+- Enter the `scons --target=mdk4/mdk5/iar` command to regenerate the project.
|
|
|
|
|
|
-本章节更多详细的介绍请参考 [STM32 系列 BSP 外设驱动使用教程](../docs/STM32系列BSP外设驱动使用教程.md)。
|
|
|
+
|
|
|
|
|
|
-## 注意事项
|
|
|
+## Notes
|
|
|
|
|
|
-- 调试串口为 UART3 ，映射说明（详情看STM32Cubemx中的配置）：
|
|
|
+- Debug the UART3 serial port with mapping details (refer to the configuration in STM32CubeMX for more details):
|
|
|
|
|
|
- ```c
|
|
|
+ ```
|
|
|
PD8 ------> USART3_TX（T_VCP_TX）
|
|
|
PD9 ------> USART3_RX（T_VCP_RX）
|
|
|
```
|
|
|
|
|
|
-* MDK版本最好使用比较新的版本的，本次搭建是在MDK5.36版本下进行的。
|
|
|
+- It is recommended to use a relatively recent version of MDK. The setup for this project was done using MDK version 5.36.
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+## References:
|
|
|
|
|
|
-## 参考资料：
|
|
|
+1. [Download STM32H563-NUCLEO Schematic](https://www.st.com/resource/en/schematic_pack/mb1404-h563zi-c01-schematic.pdf)
|
|
|
+2. [STM32H563 Official Introduction](https://www.st.com/en/microcontrollers-microprocessors/stm32h563zi.html)
|
|
|
+3. [STM32H563-NUCLEO Development Board Manual](https://www.st.com/resource/en/user_manual/um3115-stm32h5-nucleo144-board-mb1404-stmicroelectronics.pdf)
|
|
|
|
|
|
-1. [STM32H563-NUCLEO原理图下载](https://www.st.com/resource/en/schematic_pack/mb1404-h563zi-c01-schematic.pdf)
|
|
|
-2. [STM32H563官方介绍页](https://www.st.com/en/microcontrollers-microprocessors/stm32h563zi.html)
|
|
|
-3. [STM32H563-NUCLEO开发板手册](https://www.st.com/resource/en/user_manual/um3115-stm32h5-nucleo144-board-mb1404-stmicroelectronics.pdf)
|
|
|
|
|
|
-## 联系人信息
|
|
|
|
|
|
-维护人:
|
|
|
+## Maintained By
|
|
|
|
|
|
-- [yuanzihao](https://github.com/zihao-yuan/), 邮箱：[y@yzh.email](mailto:y@yzh.email)
|
|
|
+[yuanzihao](https://github.com/zihao-yuan/) [y@yzh.email](mailto:y@yzh.email)
|
Shicheng Chu
