|
2 | 2 |
|
3 | 3 | ## 简介 |
4 | 4 |
|
5 | | -本文档为 **米醋·McoreSTM32电控板** 的 BSP (板级支持包) 说明。 |
| 5 | +本文档为 **米醋·McoreSTM32电控板 ** 的 BSP(板级支持包) 说明。 |
6 | 6 |
|
7 | 7 | 主要内容如下: |
8 | 8 |
|
9 | 9 | - 开发板资源介绍 |
10 | 10 | - BSP 快速上手 |
11 | 11 | - 进阶使用方法 |
12 | 12 |
|
13 | | -通过阅读快速上手章节开发者可以快速地上手该 BSP,将 RT-Thread 运行在开发板上。在进阶使用指南章节,将会介绍更多高级功能,帮助开发者利用 RT-Thread 驱动更多板载资源。 |
| 13 | +通过阅读快速上手章节开发者可以快速地上手该 BSP,将 RT - Thread 运行在开发板上。在进阶使用指南章节,将会介绍更多高级功能,帮助开发者利用 RT - Thread 驱动更多板载资源。 |
14 | 14 |
|
15 | 15 | ## 开发板介绍 |
16 | 16 |
|
17 | | -STM32F407VET6是一款泛用性很高的芯片,基于 ARM Cortex-M4 内核的 32 位微控制器,属于 STM32 系列。它具有高性能、低功耗和丰富的外设,非常适合用于各种嵌入式应用。我们基于这款芯片设计出一块核心板用于嵌入式学习,板载了GD32芯片,搭载DAP-LINK,可用于keil下载调试。板子上还预留一个三色LED、一个用户按键、一个4M的FLASH、一个TF卡槽,此外还搭载了比较常用的传感器,温湿度传感器和姿态传感器。 |
| 17 | +STM32F407VET6是一款泛用性很高的芯片,基于 ARM Cortex - M4 内核的 32 位微控制器,属于 STM32 系列。它具有高性能、低功耗和丰富的外设,非常适合用于各种嵌入式应用。我们基于这款芯片设计出一块核心板用于嵌入式学习,板载了GD32芯片,搭载DAP - LINK,可用于keil下载调试。板子上还预留一个三色LED、一个用户按键、一个4M的FLASH、一个TF卡槽,此外还搭载了比较常用的传感器,温湿度传感器和姿态传感器。 |
18 | 18 |
|
19 | 19 | 开发板外观如下图所示: |
20 | 20 |
|
21 | | - |
| 21 | + |
22 | 22 |
|
23 | | -该开发板常用 **板载资源** 如下: |
| 23 | +该开发板常用 **板载资源 ** 如下: |
24 | 24 |
|
25 | 25 | - MCU:STM32F407VET6,主频 168MHz,512KB FLASH ,192KB RAM |
26 | 26 | - 外部 FLASH:ZD25WQ32,4MB |
27 | 27 | - 常用外设 |
28 | | - - LED:3个,DS0(红色,PC2),DS1(绿色,PC1),DS2(蓝色,PC0) |
29 | | - - 按键:1个,USER(PC3) |
| 28 | +- LED:3个,DS0(红色,PC2),DS1(绿色,PC1),DS2(蓝色,PC0) |
| 29 | +- 按键:1个,USER(PC3) |
30 | 30 | - 常用接口:USB 转串口、SD 卡接口等 |
31 | 31 | - 调试接口,支持SWD(板载DAPLink) |
32 | 32 |
|
33 | 33 | 开发板更多详细信息请参考【立创开源硬件平台】 [米醋·McoreSTM32电控板](https://oshwhub.com/the-first-development-team-of-no/kong-zhi-ban)。 |
34 | 34 |
|
35 | 35 | ## 外设支持 |
36 | 36 |
|
37 | | -本 BSP 目前对外设的支持情况如下: |
38 | | - |
39 | | -| **板载外设** | **支持情况** | **备注** | |
40 | | -| :----------------- | :----------: | :------------------------------------- | |
41 | | -| DAPLink虚拟串口 | 支持 | 已连接到芯片的UART1(PA9,PA10) | |
42 | | -| 三色LED(RGB) | 支持 | 作为系统状态指示灯 | |
43 | | -| SPI Flash | 支持 | 无 | |
44 | | -| TF卡 | 暂不支持 | 即将支持 | |
45 | | -| CAN | 暂不支持 | 即将支持 | |
46 | | -| ICM-20608-G | 暂不支持 | 即将支持 | |
47 | | -| AHT20 | 暂不支持 |即将支持 | |
48 | | -| **片上外设** | **支持情况** | **备注** | |
49 | | -| GPIO | 支持 | 所有GPIO引脚 | |
50 | | -| UART | 支持 | UART1 | |
51 | | -| SPI | 暂不支持 | 即将支持 | |
52 | | -| I2C | 暂不支持 | 即将支持 | |
53 | | -| SDIO | 暂不支持 | 即将支持 | |
54 | | -| RTC | 暂不支持 | 即将支持 | |
55 | | -| PWM | 暂不支持 | 即将支持 | |
56 | | -| USB Device | 暂不支持 | 即将支持 | |
57 | | -| USB Host | 暂不支持 | 即将支持 | |
58 | | -| IWG | 暂不支持 | 即将支持 | |
59 | | -| **扩展模块** | **支持情况** | **备注** | |
60 | | -| 舵机 | 暂不支持 | 即将支持 | |
61 | | -| 编码电机 | 暂不支持 | 即将支持 | |
62 | | -| 步进电机 | 暂不支持 | 即将支持 | |
63 | | -| 蓝牙 | 暂不支持 |即将支持 | |
64 | | -| CAM | 暂不支持 | 即将支持 | |
65 | | -| OLED | 暂不支持 | 即将支持 | |
66 | | -| 陀螺仪 | 暂不支持 | 即将支持 | |
67 | | -| 八路灰度 | 暂不支持 | 即将支持 | |
68 | | -| LED灯 | 暂不支持 | 即将支持 | |
69 | | -| 按键 | 暂不支持 | 即将支持 | |
| 37 | + 本 BSP 目前对外设的支持情况如下: |
| 38 | + |
| 39 | + | **板载外设 ** | **支持情况 ** | **备注 ** | |
| 40 | + | :---------------- - | :----------: | :------------------------------------ - | |
| 41 | + | DAPLink虚拟串口 | 支持 | 已连接到芯片的UART1(PA9, PA10) | |
| 42 | + | 三色LED(RGB) | 支持 | 作为系统状态指示灯 | |
| 43 | + | SPI Flash | 支持 | 无 | |
| 44 | + | TF卡 | 暂不支持 | 即将支持 | |
| 45 | + | CAN | 暂不支持 | 即将支持 | |
| 46 | + | ICM - 20608 - G | 暂不支持 | 即将支持 | |
| 47 | + | AHT20 | 暂不支持 | 即将支持 | |
| 48 | + | **片上外设 ** | **支持情况 ** | **备注 ** | |
| 49 | + | GPIO | 支持 | 所有GPIO引脚 | |
| 50 | + | UART | 支持 | UART1 | |
| 51 | + | SPI | 暂不支持 | 即将支持 | |
| 52 | + | I2C | 暂不支持 | 即将支持 | |
| 53 | + | SDIO | 暂不支持 | 即将支持 | |
| 54 | + | RTC | 暂不支持 | 即将支持 | |
| 55 | + | PWM | 暂不支持 | 即将支持 | |
| 56 | + | USB Device | 暂不支持 | 即将支持 | |
| 57 | + | USB Host | 暂不支持 | 即将支持 | |
| 58 | + | IWG | 暂不支持 | 即将支持 | |
| 59 | + | **扩展模块 ** | **支持情况 ** | **备注 ** | |
| 60 | + | 舵机 | 暂不支持 | 即将支持 | |
| 61 | + | 编码电机 | 暂不支持 | 即将支持 | |
| 62 | + | 步进电机 | 暂不支持 | 即将支持 | |
| 63 | + | 蓝牙 | 暂不支持 | 即将支持 | |
| 64 | + | CAM | 暂不支持 | 即将支持 | |
| 65 | + | OLED | 暂不支持 | 即将支持 | |
| 66 | + | 陀螺仪 | 暂不支持 | 即将支持 | |
| 67 | + | 八路灰度 | 暂不支持 | 即将支持 | |
| 68 | + | LED灯 | 暂不支持 | 即将支持 | |
| 69 | + | 按键 | 暂不支持 | 即将支持 | |
70 | 70 |
|
71 | 71 | ## 使用说明 |
72 | 72 |
|
73 | | -使用说明分为如下两个章节: |
| 73 | + 使用说明分为如下两个章节: |
74 | 74 |
|
75 | | -- 快速上手 |
| 75 | + - 快速上手 |
76 | 76 |
|
77 | | - 本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。 |
| 77 | + 本章节是为刚接触 RT - Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT - Thread 操作系统运行在该开发板上,看到实验效果 。 |
78 | 78 |
|
79 | | -- 进阶使用 |
| 79 | + - 进阶使用 |
80 | 80 |
|
81 | | - 本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置,可以开启更多板载资源,实现更多高级功能。 |
| 81 | + 本章节是为需要在 RT - Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置,可以开启更多板载资源,实现更多高级功能。 |
82 | 82 |
|
83 | 83 |
|
84 | 84 | ### 快速上手 |
85 | 85 |
|
86 | | -本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程,并且支持 GCC 开发环境。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。 |
| 86 | + 本 BSP 为开发者提供 MDK4、MDK5 和 IAR 工程,并且支持 GCC 开发环境。下面以 MDK5 开发环境为例,介绍如何将系统运行起来。 |
87 | 87 |
|
88 | 88 | #### 硬件连接 |
89 | 89 |
|
90 | | -使用数据线连接开发板到 PC,打开电源开关。 |
| 90 | + 使用数据线连接开发板到 PC,打开电源开关。 |
91 | 91 |
|
92 | 92 | #### 编译下载 |
93 | 93 | ##### 请注意!!! |
94 | | -在执行编译工作前请先打开ENV执行以下指令(该指令用于拉取必要的HAL库及CMSIS库,否则无法通过编译): |
95 | | -```bash |
96 | | -pkgs --update |
97 | | -``` |
98 | | -双击 project.uvprojx 文件,打开 MDK5 工程,编译并下载程序到开发板。 |
99 | | -> 工程默认配置使用 DAPLink 仿真器下载程序,在通过 USB 连接开发板的基础上,点击下载按钮即可下载程序到开发板 |
| 94 | + 在执行编译工作前请先打开ENV执行以下指令(该指令用于拉取必要的HAL库及CMSIS库,否则无法通过编译): |
| 95 | + ```bash |
| 96 | + pkgs --update |
| 97 | + ``` |
| 98 | + 双击 project.uvprojx 文件,打开 MDK5 工程,编译并下载程序到开发板。 |
| 99 | + > 工程默认配置使用 DAPLink 仿真器下载程序,在通过 USB 连接开发板的基础上,点击下载按钮即可下载程序到开发板 |
100 | 100 |
|
101 | 101 | #### 运行结果 |
102 | 102 |
|
103 | | -下载程序成功之后,系统会自动运行,【开发板上的三色LED会以1HZ的频率闪烁】。 |
| 103 | + 下载程序成功之后,系统会自动运行,【开发板上的三色LED会以1HZ的频率闪烁】。 |
104 | 104 |
|
105 | | -连接开发板对应串口到 PC , 在终端工具里打开相应的串口(115200-8-1-N),复位设备后,可以看到 RT-Thread 的输出信息: |
| 105 | + 连接开发板对应串口到 PC, 在终端工具里打开相应的串口(115200 - 8 - 1 - N),复位设备后,可以看到 RT - Thread 的输出信息: |
106 | 106 |
|
107 | | -```bash |
108 | | - \ | / |
109 | | -- RT - Thread Operating System |
110 | | - / | \ 5.2.2 build Nov 8 2025 16:39:56 |
111 | | - 2006 - 2024 Copyright by rt-thread team |
112 | | -msh > |
113 | | -``` |
| 107 | + ```bash |
| 108 | + \ | / |
| 109 | + - RT - Thread Operating System |
| 110 | + / | \ 5.2.2 build Nov 8 2025 16:39:56 |
| 111 | + 2006 - 2024 Copyright by rt - thread team |
| 112 | + msh > |
| 113 | + ``` |
114 | 114 | ### 进阶使用 |
115 | 115 |
|
116 | | -此 BSP 默认只开启了 GPIO 和 串口1 的功能,如果需使用 SD 卡、Flash 等更多高级功能,需要利用 ENV 工具对BSP 进行配置,步骤如下: |
| 116 | + 此 BSP 默认只开启了 GPIO 和 串口1 的功能,如果需使用 SD 卡、Flash 等更多高级功能,需要利用 ENV 工具对BSP 进行配置,步骤如下: |
117 | 117 |
|
118 | | -1. 在 bsp 下打开 env 工具。 |
| 118 | + 1. 在 bsp 下打开 env 工具。 |
119 | 119 |
|
120 | | -2. 输入`menuconfig`命令配置工程,配置好之后保存退出。 |
| 120 | + 2. 输入`menuconfig`命令配置工程,配置好之后保存退出。 |
121 | 121 |
|
122 | | -3. 输入`pkgs --update`命令更新软件包。 |
| 122 | + 3. 输入`pkgs --update`命令更新软件包。 |
123 | 123 |
|
124 | | -4. 输入`scons --target=mdk4/mdk5/iar` 命令重新生成工程。 |
| 124 | + 4. 输入`scons --target = mdk4 / mdk5 / iar` 命令重新生成工程。 |
125 | 125 |
|
126 | | -本章节更多详细的介绍请参考 [STM32 系列 BSP 外设驱动使用教程](../docs/STM32系列BSP外设驱动使用教程.md)。 |
| 126 | + 本章节更多详细的介绍请参考 [STM32 系列 BSP 外设驱动使用教程](.. / docs / STM32系列BSP外设驱动使用教程.md)。 |
127 | 127 |
|
128 | 128 | ## 注意事项 |
129 | 129 |
|
130 | | -- 本工程采用ARMCLANG,如需使用ARMCC,需要修改rtconfig.py中的keil平台使用的编译器为ARMCC |
| 130 | + - 本工程采用ARMCLANG, 如需使用ARMCC,需要修改rtconfig.py中的keil平台使用的编译器为ARMCC |
131 | 131 |
|
132 | 132 | ## 联系人信息 |
133 | 133 |
|
134 | | -维护人: |
| 134 | + 维护人: |
| 135 | + |
| 136 | + - [戴凌祥](https://gitee.com/dai-lingxiang), 邮箱:<3070269033@qq.com> |
135 | 137 |
|
136 | | -- [戴凌祥](https://gitee.com/dai-lingxiang), 邮箱:<3070269033@qq.com> |
|
0 commit comments