• Home
  • Annotate
  • current directory
Name Date Size #Lines LOC

..21-Aug-2025-

.ci/attachconfig/21-Aug-2025-

applications/21-Aug-2025-

board/21-Aug-2025-

figures/21-Aug-2025-

.config A D21-Aug-202547.3 KiB1,4461,334

.gitignore A D21-Aug-2025332 4039

Kconfig A D21-Aug-2025394 2316

README.md A D21-Aug-20256.1 KiB13683

SConscript A D21-Aug-2025645 2520

SConstruct A D21-Aug-20251.6 KiB5542

project.ewd A D21-Aug-202599.6 KiB2,8352,834

project.ewp A D21-Aug-202562.8 KiB2,3042,303

project.eww A D21-Aug-2025161 117

project.uvopt A D21-Aug-20254.8 KiB163156

project.uvoptx A D21-Aug-20255.7 KiB193185

project.uvproj A D21-Aug-202540.8 KiB1,1391,138

project.uvprojx A D21-Aug-202539.8 KiB1,1221,121

rtconfig.h A D21-Aug-20258.5 KiB43085

rtconfig.py A D21-Aug-20255.2 KiB187144

template.ewp A D21-Aug-202569 KiB2,0332,032

template.eww A D21-Aug-2025152 117

template.uvopt A D21-Aug-20254.8 KiB163156

template.uvoptx A D21-Aug-20255.7 KiB193185

template.uvproj A D21-Aug-202515.1 KiB408403

template.uvprojx A D21-Aug-202514 KiB397391

README.md

1# Keysking STM32学习板BSP说明
2
3## 简介
4
5本文档是为Keysking学习板提供的BSP(板级支持包)说明。
6
7主要内容如下：
8
9* 开发板资源介绍
10
11* BSP快速上手
12
13* 进阶使用
14
15通过阅读快速上手章节开发者可以快速的上手该BSP，将RT-Thread运行在开发板上。在进阶使用指南章节，将会介绍更多高级功能，帮助开发者利用RT-Thread驱动更多板载资源。
16
17## 开发板介绍
18
19Keysking学习板是B站UP主Keysking推出的一块基于ARM Cortex-M3内核的开发板，MCU型号为STM32F103C8T6，最高主频为72MHz。
20
21开发板主要内容如下图所示：
22
23![board](figures/board.png)
24
25该开发板常用**板载资源**如下：
26
27* MCU: STM32F103C8T6，主频72MHz，64KB FLASH，20KB RAM
28
29* 常用外设可参考图示
30
31* 常用接口：USB转串口
32
33* 调试接口：SWD
34
35开发板更多详细信息以及配套视频教程请参考[波特律动官网](https://docs.baud-dance.com/)。
36
37## 外设支持
38
39本BSP目前对外设的支持情况如下：
40
41| 板载外设                               | 支持情况     | 备注                                         |
42| ---------------------------------- |:--------:| ------------------------------------------ |
43| USB转串口                             | 支持       | UART2(用作finsh)                             |
44| 旋转编码器                              | 支持       | A相(PA8),B相(PA9),按键(PB15)                   |
45| OLED                               | 支持       | I2C1，0x7A                                  |
46| LED                                | 支持       | GPIO or PWM: Blue(PA6)，Green(PA7)，Red(PB0) |
47| 无源蜂鸣器                              | 支持       | PWM4_CH4                                   |
48| 电位器                                | 支持       | ADC1_IN5                                   |
49| 温湿度传感器                             | 支持       | I2C1，0x38                                  |
50| **片上外设**                           | **支持情况** | **备注**                                     |
51| GPIO                               | 支持       |                                            |
52| UART                               | 支持       | UART2,3                                    |
53| PWM                                | 支持       | PWM2,3,4                                   |
54| ADC                                | 支持       | ADC1                                       |
55| **预留外设接口**                         | **支持情况** | **备注**                                     |
56| SERVO                              | 支持       | PWM4_CH3                                   |
57| DRV8833                            | 支持       | PWM2_CH1&2                                 |
58| BLUETOOTH                          | 支持       | UART3                                      |
59| TCRT5000                           |          |                                            |
60| HC-SR04超声波                         |          |                                            |
61| NTC传感器 | 支持       | ADC1_IN4                                   |
62
63## 使用说明
64
65使用说明分为如下两个章节：
66
67- 快速上手
68  本章节是为刚接触 RT-Thread 的新手准备的使用说明，遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上，看到实验效果 。
69
70- 进阶使用
71  本章节是为需要在 RT-Thread 操作系统上使用更多开发板资源的开发者准备的。通过使用 ENV 工具对 BSP 进行配置，可以开启更多板载资源，实现更多高级功能。
72
73### 快速上手
74
75本 BSP 为开发者提供 MDK5 和 IAR 工程，并且支持 GCC 开发环境。下面以 MDK5 开发环境为例，介绍如何将系统运行起来。
76
77**请注意！！！**
78
79在执行编译工作前请先打开ENV执行以下指令（该指令用于拉取必要的HAL库及CMSIS库，否则无法通过编译）：
80
81```bash
82pkgs --update
83```
84
85#### 硬件连接
86
87使用ST-Link调试下载器连接开发板的SWD接口，再将ST-Link的另一端连接到PC，然后将Mini开发板插入PC的USB口。
88
89#### 编译下载
90
91双击 project.uvprojx 文件，打开 MDK5 工程，编译并下载程序到开发板。
92
93> 工程默认配置使用 ST-Link 下载程序，在通过 ST-Link连接开发板的基础上，点击下载按钮即可下载程序到开发板
94
95#### 运行结果
96
97下载程序成功之后，系统会自动运行，观察开发板上 LED 的运行效果，其中一个 LED 会周期性闪烁。
98
99连接开发板对应串口到 PC , 在终端工具里打开相应的串口（115200-8-1-N），复位设备后，可以看到 RT-Thread 的输出信息:
100
101```bash
102 \ | /
103- RT -     Thread Operating System
104 / | \     4.1.1 build May 30 2022 17:15:31
105 2006 - 2022 Copyright by RT-Thread team
106msh />
107```
108
109### 进阶使用
110
111此 BSP 默认只开启了 GPIO 和 串口2 的功能，如果需使用更多高级功能，需要利用 ENV 工具对BSP 进行配置，步骤如下：
112
1131. 在 bsp 下打开 env 工具。
114
1152. 输入`menuconfig`命令配置工程，配置好之后保存退出。
116
1173. 输入`pkgs --update`命令更新软件包。
118
1194. 输入`scons --target=mdk5/iar` 命令重新生成工程。
120
121本章节更多详细的介绍请参考 [STM32 系列 BSP 外设驱动使用教程](../docs/STM32系列BSP外设驱动使用教程.md)。
122
123## 注意事项
124
125STM32F103C8T6的Flash在官方文档中的大小是64KB，但是其实该芯片与F103RBT6硬件上是一模一样的。RBT6出厂时完整测试了128KB的Flash情况，而C8T6厂商只保证前64KB是正常运行的。
126
127在链接脚本中，本开发板的Flash与其他C8T6的BSP保持一致，都设置为128KB（只有64的话稍微多点功能就不够用了，并且超过64KB的部分也是可以烧录进芯片的，具体能用多少看运气）
128
129为了保证绝对稳定，可以注意编译结果是否小于64KB。如果遇到功能问题也可以看看是不是这里出问题了。
130
131## 联系人信息
132
133维护人:
134
135* qianjiuyuan, 邮箱:<qianjiuyuan05@qq.com>
136