STM32F103RG RT-Thread实战从零构建LED流水灯与串口日志系统1. 项目概述与环境搭建在嵌入式开发领域STM32系列MCU因其出色的性价比和丰富的生态资源而广受欢迎。RT-Thread作为一款国产实时操作系统为STM32开发者提供了完整的软件框架支持。本教程将基于STM32F103RG芯片通过RT-Thread Studio开发环境实现一个包含4个LED流水灯控制和串口日志输出的完整项目。硬件准备清单STM32F103RG开发板如创思通信开发板J-Link调试器V9及以上版本推荐USB-TTL转换模块CH340芯片4个LED灯及限流电阻软件环境配置安装RT-Thread Studio最新版本可从官网获取安装J-Link驱动软件准备串口调试工具如通信猫、Putty等提示确保开发板的供电稳定JTAG接口连接正确USB-TTL模块的TX/RX与开发板交叉连接TX接RXRX接TX。2. 工程创建与基础配置2.1 新建RT-Thread项目在RT-Thread Studio中按照以下步骤创建项目选择文件 → 新建 → RT-Thread项目项目类型选择基于芯片指定芯片型号为STM32F103RG调试器接口选择JTAG完成基础工程创建2.2 硬件抽象层配置修改board.h文件确认系统时钟配置#define BSP_CLOCK_SOURCE HSI #define BSP_CLOCK_FREQ 8U #define BSP_CLOCK_SYSTEM_FREQ 72U配置串口1UART1为日志输出端口#define BSP_USING_UART1 #define BSP_UART1_TX_PIN PA9 #define BSP_UART1_RX_PIN PA103. LED驱动实现3.1 引脚定义与初始化在main.c中添加LED引脚定义#define LED1_PIN 47 // PC15 #define LED2_PIN 45 // PC13 #define LED3_PIN 25 // PB9 #define LED4_PIN 4 // PA4 static void led_init(void) { rt_pin_mode(LED1_PIN, PIN_MODE_OUTPUT); rt_pin_mode(LED2_PIN, PIN_MODE_OUTPUT); rt_pin_mode(LED3_PIN, PIN_MODE_OUTPUT); rt_pin_mode(LED4_PIN, PIN_MODE_OUTPUT); // 初始状态全部熄灭根据电路设计可能为高或低电平熄灭 rt_pin_write(LED1_PIN, PIN_HIGH); rt_pin_write(LED2_PIN, PIN_HIGH); rt_pin_write(LED3_PIN, PIN_HIGH); rt_pin_write(LED4_PIN, PIN_HIGH); }3.2 LED控制逻辑实现创建LED流水灯线程static void led_thread_entry(void *parameter) { while (1) { rt_kprintf(LED sequence start\n); // LED1亮 → LED2亮 → LED3亮 → LED4亮 rt_pin_write(LED1_PIN, PIN_LOW); rt_thread_mdelay(100); rt_pin_write(LED2_PIN, PIN_LOW); rt_thread_mdelay(100); rt_pin_write(LED3_PIN, PIN_LOW); rt_thread_mdelay(100); rt_pin_write(LED4_PIN, PIN_LOW); rt_thread_mdelay(1000); rt_kprintf(All LEDs on\n); // 全部熄灭 rt_pin_write(LED1_PIN, PIN_HIGH); rt_thread_mdelay(100); rt_pin_write(LED2_PIN, PIN_HIGH); rt_thread_mdelay(100); rt_pin_write(LED3_PIN, PIN_HIGH); rt_thread_mdelay(100); rt_pin_write(LED4_PIN, PIN_HIGH); rt_thread_mdelay(2000); rt_kprintf(All LEDs off\n); } }4. 串口日志系统优化4.1 日志级别配置在main.c开头添加日志系统配置#define DBG_TAG MAIN #define DBG_LVL DBG_LOG #include rtdbg.hRT-Thread支持以下日志级别级别宏定义说明错误DBG_ERROR严重错误信息警告DBG_WARNING警告信息信息DBG_INFO普通运行信息调试DBG_LOG详细调试信息4.2 增强型日志输出改进日志输出格式增加时间戳void enhanced_log(const char *fmt, ...) { rt_uint32_t tick rt_tick_get(); rt_kprintf([%5d] , tick); va_list args; va_start(args, fmt); rt_vsnprintf(rt_log_buf, sizeof(rt_log_buf), fmt, args); va_end(args); rt_kprintf(%s\n, rt_log_buf); }5. 系统集成与调试5.1 主函数实现完整的main()函数实现int main(void) { // 硬件初始化 led_init(); // 创建LED控制线程 rt_thread_t tid rt_thread_create(led, led_thread_entry, RT_NULL, 512, 20, 10); if (tid ! RT_NULL) { rt_thread_startup(tid); } else { LOG_E(LED thread creation failed!); return -1; } // 打印系统信息 LOG_I(System initialization completed); LOG_I(RT-Thread version: %s, RT_VERSION); LOG_I(LED pins: PC15(47), PC13(45), PB9(25), PA4(4)); return 0; }5.2 常见问题解决J-Link连接问题排查检查设备管理器是否识别J-Link确认JTAG接口连接正确TCK、TMS、TDI、TDO、nTRST尝试降低JTAG时钟频率在RT-Thread Studio调试配置中设置串口无输出检查确认TX/RX线序正确检查波特率设置默认115200验证串口模块供电正常LED不亮排查# 在MSH控制台中手动测试LED引脚 msh / pin_write 47 0 # LED1亮 msh / pin_write 47 1 # LED1灭6. 进阶功能扩展6.1 添加Shell控制命令扩展LED控制功能支持命令行交互static void led_ctrl(int argc, char **argv) { if (argc ! 3) { rt_kprintf(Usage: led_ctrl led_num on/off\n); return; } int led_num atoi(argv[1]); int state (strcmp(argv[2], on) 0) ? 0 : 1; switch (led_num) { case 1: rt_pin_write(LED1_PIN, state); break; case 2: rt_pin_write(LED2_PIN, state); break; case 3: rt_pin_write(LED3_PIN, state); break; case 4: rt_pin_write(LED4_PIN, state); break; default: rt_kprintf(Invalid LED number (1-4)\n); } } MSH_CMD_EXPORT(led_ctrl, Control LEDs: led_ctrl 1-4 on/off);6.2 状态监测线程创建资源监控线程定期报告系统状态static void monitor_thread_entry(void *parameter) { while (1) { rt_uint32_t total rt_memory_get_total(); rt_uint32_t used rt_memory_get_used(); LOG_I(Memory usage: %d/%d KB (%.1f%%), used / 1024, total / 1024, (float)used / total * 100); rt_thread_mdelay(5000); } }7. 项目优化建议代码结构优化将LED驱动移至独立文件drv_led.c创建硬件抽象层头文件board_define.h实现配置文件app_config.h集中管理参数性能优化技巧使用RT-Thread的软件定时器替代rt_thread_mdelay启用编译器优化选项-O2关键代码段使用RT_ENTER_CRITICAL保护扩展功能思路添加PWM控制实现LED亮度调节通过串口接收命令动态改变流水灯模式集成传感器数据采集与显示