从裸机到RTOS：用RT-Thread重构STM32平衡小车项目

平衡小车作为嵌入式开发的经典练手项目，往往成为工程师从裸机转向RTOS的分水岭。许多开发者都有这样的经历：在裸机环境下用状态机和定时器中断勉强实现了功能，但随着需求增加，代码逐渐变成难以维护的"意大利面条"。本文将带你用RT-Thread对典型的TT马达平衡小车进行彻底重构，体验RTOS带来的工程化优势。

1. 项目背景与重构必要性

我曾在三个不同版本的平衡小车项目中使用裸机开发，每次都在添加新功能时遇到相似的困境：中断服务程序(ISR)越来越臃肿，全局变量四处蔓延，调试时经常遇到诡异的时序问题。以常见的MPU6050数据读取为例，裸机环境下通常这样处理：

void TIM3_IRQHandler(void) { static uint32_t last_read = 0; if(HAL_GetTick() - last_read > 10) { // 每10ms读取一次 MPU6050_Read(&accel, &gyro); last_read = HAL_GetTick(); } // 其他中断处理... }

这种模式存在几个明显问题：

• 优先级倒置：高优先级的定时器中断在等待I2C操作完成
• 阻塞风险：I2C通信失败可能导致整个系统卡顿
• 耦合度高：传感器读取与控制系统强耦合

RT-Thread通过任务划分和IPC机制可以优雅地解决这些问题。下表对比了两种架构的关键差异：

2. RT-Thread环境搭建与工程迁移

2.1 开发环境配置

建议使用以下工具组合：

• STM32CubeMXv6.5+：初始化外设配置
• RT-Thread Studio：创建基础工程
• Keil MDK：最终编译调试

关键配置步骤：

1. 在CubeMX中配置时钟树（保持与原有项目一致）
2. 启用必要外设：I2C1(MPU6050)、TIM1(PWM输出)、USART1(调试)
3. 生成基础代码后导入RT-Thread Studio

注意：RT-Thread的HAL库版本可能与CubeMX生成的不完全兼容，建议在board.h中统一HAL库版本号。

2.2 工程目录重构

典型的RT-Thread项目结构应调整为：

project/ ├── applications/ # 应用代码 │ ├── balance.c # 主控制逻辑 │ └── sensor.c # 传感器处理 ├── drivers/ # 设备驱动 │ ├── drv_pwm.c │ └── drv_i2c.c ├── packages/ # 软件包 │ └── mpu6xxx-latest/ └── rtconfig.h # 系统配置

迁移裸机代码时的黄金法则：将功能模块转化为独立线程。例如原项目的PID控制部分：

// 裸机代码片段 void TIM4_IRQHandler(void) { static float last_error = 0; float error = target - current; float output = Kp*error + Kd*(error - last_error); last_error = error; Motor_SetOutput(output); } // RT-Thread改造后 static void pid_thread_entry(void *param) { while(1) { rt_thread_mdelay(5); // 5ms周期 float error = target - current; float output = pid_calculate(&pid, error); rt_mq_send(motor_mq, &output, sizeof(output)); } }

3. 关键模块RT-Thread化改造

3.1 传感器数据采集优化

MPU6050在RT-Thread中有现成的软件包支持：

# 在Env工具中执行 pkgs --update pkgs --install mpu6xxx

使用传感器框架后，数据采集变得异常简洁：

struct rt_sensor_data accel_data; sensor = rt_device_find("acc_mpu6xxx"); rt_device_open(sensor, RT_DEVICE_FLAG_RDONLY); rt_device_read(sensor, 0, &accel_data, 1);

对比原始裸机方案的改进：

• 自动错误重试：框架内置I2C通信异常处理
• 数据缓冲：避免数据丢失
• 统一接口：更换传感器只需修改设备名称

3.2 电机控制实现

RT-Thread的PWM设备框架显著简化了电机控制：

// 初始化 pwm_dev = rt_device_find("pwm1"); rt_pwm_set(pwm_dev, 1, 20000, 1500); // 20ms周期，1.5ms脉宽 // 动态调整 void motor_set_speed(int speed) { rt_pwm_set(pwm_dev, 1, 20000, 1500 + speed); }

实际项目中，建议为电机控制创建专用线程，并通过消息队列接收控制指令：

static void motor_thread_entry(void *param) { struct rt_messagequeue mq; rt_mq_init(&mq, "motor_mq", ...); while(1) { rt_mq_recv(&mq, &msg, sizeof(msg), RT_WAITING_FOREVER); motor_set_speed(msg.speed); } }

4. 系统整合与性能优化

4.1 任务优先级规划

合理的优先级设置是保证实时性的关键：

经验法则：执行频率越高、实时性要求越高的任务应设置更高优先级

4.2 共享资源保护

多任务环境下必须注意资源共享问题。以PID参数调节为例：

static float kp = 1.0, ki = 0.1, kd = 0.5; static rt_mutex_t pid_mutex = RT_NULL; // 参数设置线程 void pid_param_set(float p, float i, float d) { rt_mutex_take(pid_mutex, RT_WAITING_FOREVER); kp = p; ki = i; kd = d; rt_mutex_release(pid_mutex); } // PID计算线程 float pid_calculate(float error) { static float integral = 0; rt_mutex_take(pid_mutex, RT_WAITING_FOREVER); integral += error * ki; float output = kp*error + integral + kd*(error - last_error); rt_mutex_release(pid_mutex); return output; }

4.3 系统监控与调试

RT-Thread内置的Finsh控制台是强大的调试工具：

MSH_CMD_EXPORT(motor_set_speed, "Set motor speed"); MSH_CMD_EXPORT(pid_param_set, "Set PID parameters");

通过串口输入命令即可实时调整参数，无需重新烧录程序。结合ulog模块，可以方便地记录系统运行日志：

#define LOG_TAG "balance" #include <ulog.h> void balance_task(void) { LOG_D("Start balancing"); while(1) { if(angle > 30) { LOG_W("Dangerous angle: %.1f", angle); } } }

5. 进阶优化方向

当基础功能稳定后，可以考虑以下优化：

内存优化技巧：

• 使用rt_smem替代malloc动态分配
• 调整线程堆栈大小避免浪费
• 启用内存池管理高频申请释放的小对象

实时性提升：

// 在关键路径上禁用中断 rt_base_t level = rt_hw_interrupt_disable(); // 执行关键操作 rt_hw_interrupt_enable(level);

低功耗设计：

// 空闲时进入低功耗模式 void rt_thread_idle_hook(void) { __WFI(); // Wait for interrupt }

重构后的项目在代码可维护性上有了质的飞跃。最近一次添加蓝牙遥控功能时，只需新增一个线程处理通信协议，完全不影响原有控制逻辑，这在裸机方案中是不可想象的。RT-Thread丰富的软件生态也让集成新传感器变得简单——上周测试BMP280气压计时，从找到软件包到数据读取成功只用了15分钟。