当前位置：首页 > news >正文

零基础玩转RT-Thread：首个LED闪烁项目

news 2026/6/13 19:23:44

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

创建一个最简单的RT-Thread入门项目：1.基于STM32F103C8T6最小系统板；2.实现板载LED每隔500ms闪烁；3.包含串口打印"Hello RT-Thread"功能；4.工程要完整包含RT-Thread内核配置。请用最简化的代码实现，并在关键代码处添加中文注释说明，特别说明：a)如何创建线程 b)如何使用RT-Thread的API c)如何配置工程。输出为MDK工程格式。

点击'项目生成'按钮，等待项目生成完整后预览效果

最近尝试用RT-Thread做了第一个嵌入式项目——让STM32板子上的LED灯闪烁，并实现串口打印功能。作为新手，记录下这个入门过程，希望对同样刚接触RT-Thread的朋友有帮助。整个过程在InsCode(快马)平台上完成，比传统开发方式省心很多。

硬件准备与环境搭建
使用最常见的STM32F103C8T6最小系统板（蓝色小板），板载一颗用户LED（PC13引脚控制）。
传统方式需要手动安装MDK、芯片支持包等，但在快马平台可以直接创建RT-Thread项目模板，自动配置好编译环境。
平台内置了RT-Thread最新稳定版，省去了源码下载和版本匹配的麻烦。
创建基础工程
在平台上选择"RT-Thread MDK工程"模板，目标芯片设为STM32F103C8T6。
系统会自动生成包含RT-Thread内核的完整工程结构，包括启动文件、链接脚本等关键配置。
特别方便的是，平台预置了正确的时钟配置（72MHz主频），不用自己折腾时钟树初始化。
编写LED线程
在main.c中创建线程控制LED：
- 用rt_thread_create()创建线程，指定入口函数为led_thread_entry。
- 线程栈设为256字节足够（平台会提示合理范围）。
- 优先级设为25（中等优先级，数值越小优先级越高）。
LED控制逻辑：
- 在入口函数中用rt_pin_mode()设置PC13为输出模式。
- 循环内用rt_pin_write()交替设置高低电平，配合rt_thread_mdelay(500)实现500ms间隔。
添加串口打印
使用RT-Thread的设备驱动框架操作串口1：
- 通过rt_device_find("uart1")查找设备。
- 用rt_device_open()以读写模式打开串口。
- 调用rt_device_write()发送"Hello RT-Thread"字符串。
注意串口引脚默认配置（PA9/PA10），无需额外初始化。
关键配置说明
通过rtconfig.h开启必要功能：
- 定义RT_USING_PIN启用GPIO驱动。
- 定义RT_USING_DEVICE和RT_USING_SERIAL启用串口设备。
在平台的项目配置界面可以可视化修改这些宏，比直接改文件更直观。
编译与下载
点击平台上的构建按钮自动编译，错误提示会直接定位到代码行。
连接开发板后，使用平台集成的ST-Link工具一键下载程序。
首次下载可能需要安装USB驱动，平台会提供详细指引。
效果验证
上电后看到LED规律闪烁。
用串口助手（如Putty）连接板载串口，波特率115200，收到循环打印的消息。
如果LED没反应，优先检查接线和板载LED的有效电平（有些板子需要低电平点亮）。
踩坑总结
线程栈大小最初设128字节导致运行不稳定，后调整为256字节。
忘记调用rt_device_open()导致串口无法使用，平台运行时日志会明确报错。
延时函数误用rt_thread_delay()（以tick为单位）导致时间不准，应改用毫秒单位的rt_thread_mdelay()。

整个项目从零到运行只用了不到20分钟，比预想中顺利很多。特别点赞快马平台的两个设计：

智能错误提示：编译错误会标记具体位置，甚至给出修改建议。比如忘记包含头文件时，平台会提示可能缺失的依赖。
硬件无关适配：同样的代码稍作修改就能用在其他STM32板卡上，平台会自动处理不同芯片的底层差异。

对于想快速验证想法的开发者，推荐试试InsCode(快马)平台的一键部署功能。我的LED项目虽然简单，但完整走通了嵌入式开发的全流程，而且全程在浏览器里完成，不需要配任何本地环境。接下来准备用同样的方式学习RT-Thread的信号量和消息队列，平台已经预置了相关示例模板，应该能省下不少查资料的时间。

快速体验

打开 InsCode(快马)平台 https://www.inscode.net

输入框内输入如下内容：

创建一个最简单的RT-Thread入门项目：1.基于STM32F103C8T6最小系统板；2.实现板载LED每隔500ms闪烁；3.包含串口打印"Hello RT-Thread"功能；4.工程要完整包含RT-Thread内核配置。请用最简化的代码实现，并在关键代码处添加中文注释说明，特别说明：a)如何创建线程 b)如何使用RT-Thread的API c)如何配置工程。输出为MDK工程格式。