HPMicro 板级支持包 (BSP) 介绍

简介

本文档提供了 RT-Thread 仓库中可用的 HPMicro BSP（板级支持包）的概述。每个 BSP 都针对特定的 HPMicro 开发板进行了定制，提供必要的驱动程序和配置，以便在基于 RISC-V 的 HPMicro 微控制器上无缝运行 RT-Thread。

本文档包含以下部分：

HPMicro BSP 概述
可用的 BSP
快速开始指南
通用开发环境设置
参考资料

通过阅读快速开始指南部分，开发者可以快速上手任何 HPMicro BSP 并在开发板上运行 RT-Thread。每个单独的 BSP 都包含特定开发板功能和高级用法的详细文档。

可用的 BSP

以下是当前支持的 HPMicro BSP 的完整列表：

BSP 名称	支持的开发板	MCU	描述
hpm5300evk	HPM5300EVK	HPM5361	HPM5300 系列开发板
hpm5301evklite	HPM5301EVKLITE	HPM5301	HPM5301精简版开发板
hpm5e00evk	HPM5E00EVK	HPM5E31	HPM5E00 系列开发板
hpm6200evk	HPM6200EVK	HPM6200	HPM6200 系列开发板
hpm6300evk	HPM6300EVK	HPM6360	HPM6300 系列开发板，支持以太网
hpm6750evk	HPM6750EVK	HPM6750	HPM6750 系列开发板，双核 RISC-V
hpm6750evk2	HPM6750EVK2	HPM6750	HPM6750 系列第二代开发板
hpm6750evkmini	HPM6750EVKMINI	HPM6750	HPM6750 系列迷你开发板
hpm6800evk	HPM6800EVK	HPM6800	HPM6800 系列开发板
hpm6e00evk	HPM6E00EVK	HPM6E00	HPM6E00 系列开发板
hpm6p00evk	HPM6P00EVK	HPM6P00	HPM6P00 系列开发板

快速开始指南

前提条件

在开始使用任何 HPMicro BSP 之前，您需要准备以下开发环境：

1. RT-Thread ENV

下载并安装 RT-Thread ENV

2. RISC-V 工具链

下载 RISC-V 工具链：riscv32-gnu-toolchain
解压到指定目录，例如：C:\DevTools\riscv32-gnu-toolchain
设置环境变量 RTT_RISCV_TOOLCHAIN 为 <TOOLCHAIN_DIR>\bin
- 例如：C:\DevTools\riscv32-gnu-toolchain\bin

3. HPMicro 专用 OpenOCD

下载 OpenOCD：rtt-debugger-support-package
解压到指定目录，例如：C:\DevTools\openocd-hpmicro
设置环境变量 OPENOCD_HPMICRO 为 <OPENOCD_HPMICRO_DIR>\bin
- 例如：C:\DevTools\openocd-hpmicro\bin

使用特定 BSP 开始

导航到所需的 BSP 目录：
```
cd rt-thread/bsp/hpmicro/<bsp_name>
```
配置项目：
- 打开 RT-Thread ENV 命令行
- 切换到 BSP 目录
- 运行 menuconfig 来配置项目
构建项目：
```
scons -jN  # N 等于 CPU 核心数
```
硬件连接：
- 将 BOOT 引脚切换到 2'b00
- 通过 TYPE-C 线缆将 PWR_DEBUG 端口连接到 PC
下载和调试：
- 使用提供的 OpenOCD 脚本进行下载和调试
- 参考各个 BSP 的 README 文件获取具体命令

运行结果

项目成功下载后，系统会自动运行。开发板上的 LED 会周期性闪烁。

将开发板的串口连接到 PC，通过串口终端工具（115200-8-1-N）与其通信。重置开发板后，将观察到 RT-Thread 的启动信息：

 \ | /
- RT -     Thread Operating System
 / | \     5.2.2 build Aug 16 2025 18:18:18
 2006 - 2025 Copyright by RT-Thread team
msh >

通用外设支持

大多数 HPMicro BSP 支持以下外设：

板载外设	支持	备注
USB	√
QSPI Flash	√
GPIO	√
SPI	√
I2C	√
UART	√
PWM	√
RTC	√
板载调试器	√	ft2232

根据特定开发板，可能支持其他外设：

以太网：在如下开发板上可用
- HPM6300EVK
- HPM6750EVK
- HPM6750EVK2
- HPM6750EVKMINI + ART-Pi Industry IO 扩展板
- HPM6800EVK
- HPM6E00EVK
- HPM6P00EVK
- HPM5E00EVK
CAN：HPM5300EVK、HPM6750系列开发板，HPM6300EVK，HPM6800EVK, HPM6E00EVK, HPM6P00EVK 和HPM5E00EVK
SDIO：HPM6300EVK、HPM6750EVK 系列可用
显示/音频：HPM6750EVK 系列可用

开发环境设置

使用命令行工具

按照前提条件部分所述设置环境变量
使用 scons 进行构建
使用 OpenOCD 和 GDB 进行调试

各个 BSP 文档

每个 BSP 都包含自己的详细 README 文件，内容包括：

特定开发板的硬件信息
外设配置详情
具体的下载和调试命令
高级功能和示例

请参考各个 BSP 目录获取详细文档：

hpm5300evk/README.md
hpm5301evklite/README.md
hpm5e00evk/README.md
hpm6200evk/README.md
hpm6300evk/README.md
hpm6750evk/README.md
hpm6750evk2/README.md
hpm6750evkmini/README.md
hpm6800evk/README.md
hpm6e00evk/README.md
hpm6p00evk/README.md

故障排除

常见问题

找不到工具链：确保 RTT_RISCV_TOOLCHAIN 环境变量设置正确
OpenOCD 连接失败：检查 USB 连接和驱动程序安装
构建错误：验证所有依赖项已安装且环境变量已设置
串口通信问题：检查波特率（115200）和 COM 端口设置

获取帮助

查看各个 BSP 的 README 文件了解特定开发板的问题
访问 RT-Thread 社区
参考 RT-Thread 文档

参考资料

贡献

欢迎对增强现有 BSP 或添加新 BSP 做出贡献。请遵循 RT-Thread 贡献指南，确保您的 BSP 符合项目标准。

为 HPMicro BSP 做出贡献：

Fork RT-Thread 仓库
创建功能分支
按照现有代码风格进行更改
彻底测试您的更改
提交带有清晰描述的拉取请求

许可证

此 BSP 在 RT-Thread 许可证下发布。

README_zh.md 6.5 KB Permalink Histórico Raw