blob: a2115c6a5505396e81dfc1199ca7be01bac8f36c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
# HPMicro 板级支持包 (BSP) 介绍
[English](README.md) |
## 简介
本文档提供了 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 系列开发板 |
| hpm5100evk | HPM5100EVK | HPM5100 | HPM5100 系列开发板 |
## 快速开始指南
### 前提条件
在开始使用任何 HPMicro BSP 之前，您需要准备以下开发环境：
#### 1. RT-Thread ENV
- 下载并安装 [RT-Thread ENV](https://www.rt-thread.org/download.html#download-rt-thread-env-tool)
#### 2. RISC-V 工具链
- 下载 RISC-V 工具链：[riscv32-gnu-toolchain](https://github.com/helloeagleyang/riscv32-gnu-toolchain-win/archive/2022.04.12.zip)
- 解压到指定目录，例如：`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](https://github.com/hpmicro/rtt-debugger-support-package/archive/v0.4.0.zip)
- 解压到指定目录，例如：`C:\DevTools\openocd-hpmicro`
- 设置环境变量 `OPENOCD_HPMICRO` 为 `<OPENOCD_HPMICRO_DIR>\bin`
- 例如：`C:\DevTools\openocd-hpmicro\bin`
### 使用特定 BSP 开始
1. **导航到所需的 BSP 目录**：
```bash
cd rt-thread/bsp/hpmicro/<bsp_name>
```
2. **配置项目**：
- 打开 RT-Thread ENV 命令行
- 切换到 BSP 目录
- 运行 `menuconfig` 来配置项目
3. **构建项目**：
```bash
scons -jN # N 等于 CPU 核心数
```
4. **硬件连接**：
- 将 BOOT 引脚切换到 2'b00
- 通过 TYPE-C 线缆将 `PWR_DEBUG` 端口连接到 PC
5. **下载和调试**：
- 使用提供的 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 和HPM5100EVK
- **SDIO**：HPM6300EVK、HPM6750EVK 系列可用
- **显示/音频**：HPM6750EVK 系列可用
## 开发环境设置
### 使用命令行工具
1. 按照前提条件部分所述设置环境变量
2. 使用 `scons` 进行构建
3. 使用 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`
- `hpm5100evk/README.md`
## 故障排除
### 常见问题
1. **找不到工具链**：确保 `RTT_RISCV_TOOLCHAIN` 环境变量设置正确
2. **OpenOCD 连接失败**：检查 USB 连接和驱动程序安装
3. **构建错误**：验证所有依赖项已安装且环境变量已设置
4. **串口通信问题**：检查波特率（115200）和 COM 端口设置
### 获取帮助
- 查看各个 BSP 的 README 文件了解特定开发板的问题
- 访问 [RT-Thread 社区](https://club.rt-thread.org/)
- 参考 [RT-Thread 文档](https://www.rt-thread.org/document/site/)
## 参考资料
- [RT-Thread 文档中心](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/README)
- [RT-Thread ENV](https://github.com/RT-Thread/rtthread-manual-doc/blob/master/env/env.md)
- [HPMicro 官方网站](https://www.hpmicro.com/)
- [HPMicro SDK 文档](https://hpmicro.github.io/)
- [RISC-V 工具链](https://github.com/riscv/riscv-gnu-toolchain)
## 贡献
欢迎对增强现有 BSP 或添加新 BSP 做出贡献。请遵循 RT-Thread 贡献指南，确保您的 BSP 符合项目标准。
为 HPMicro BSP 做出贡献：
1. Fork `RT-Thread` 仓库
2. 创建功能分支
3. 按照现有代码风格进行更改
4. 彻底测试您的更改
5. 提交带有清晰描述的拉取请求
## 许可证
此 BSP 在 [RT-Thread 许可证](https://github.com/RT-Thread/rt-thread/blob/master/LICENSE) 下发布。
|
