1. 项目背景与核心目标
去年在调试一个机器人底盘时，我发现很多开发者（包括当时的我自己）容易陷入一个误区：一上来就想着用RViz这类可视化工具调试，结果因为底层通信没打通，对着黑屏的RViz界面干瞪眼。这个项目就是要解决这个痛点——用最简化的流程验证从代码到电机驱动的完整链路，确保你的指令能真正让车动起来，再去考虑上层应用。
这个流程特别适合以下场景：
- 刚组装好的机器人首次上电测试
- 更换主控板或驱动板后的基础验证
- 通信协议修改后的回归测试
- 教学演示中快速验证硬件响应
2. 硬件准备与最小系统搭建
2.1 必要硬件清单
- 带编码器的直流电机 ×2（建议先测试单个电机）
- 电机驱动板（如TB6612、DRV8833等）
- 主控板（树莓派/STM32/Arduino等）
- USB转串口模块（若主控无原生USB）
- 万用表（用于测量供电电压）
- 12V锂电池（或其他适配电源）
2.2 电路连接避坑指南
-
电源级联问题：
- 主控板和驱动板的逻辑电源（5V/3.3V）必须共地
- 电机供电（12V）与逻辑供电要隔离，否则PWM信号会被干扰
- 实测案例：某团队因未隔离导致电机启动时主控板重启
-
PWM接线技巧：
plaintext复制
GPIO输出 → 驱动板PWM输入 │ └─ 串联220Ω电阻（防止GPIO过流） -
编码器接线验证：
- 先用示波器/逻辑分析仪检查AB相波形
- 无设备时：手动转动电机，用
gpiod工具监测引脚电平变化
bash复制# 树莓派检测GPIO变化示例 sudo apt install gpiod gpiomon 0 17 # 监控GPIO17
3. 固件层验证（以STM32为例）
3.1 电机驱动基础测试
使用STM32CubeMX生成PWM初始化代码后，添加以下测试逻辑：
c复制// 在main.c的while(1)循环中加入
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 500); // 50%占空比
HAL_Delay(2000);
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 0); // 停止
HAL_Delay(2000);
关键验证点：电机应交替运行2秒停止2秒，若不动：
- 用万用表测量驱动板输出端电压
- 检查TIM时钟配置是否正确
- 确认PWM频率在5-20kHz范围内（过高会导致MOS管发热）
3.2 编码器计数验证
配置编码器接口模式后，通过串口打印计数值：
c复制printf("Encoder: %d\n", (int16_t)TIM1->CNT);
手动旋转电机时应看到数值变化，常见问题：
- 数值跳动：检查AB相接线是否反接
- 数值不变：确认TIM配置为Encoder Mode，上拉电阻已启用
4. 上位机通信测试（不依赖ROS）
4.1 最小化Python控制脚本
python复制import serial
import time
ser = serial.Serial('/dev/ttyACM0', 115200, timeout=1)
def send_motor_cmd(speed):
cmd = f"M1 {speed}\n".encode()
ser.write(cmd)
print(ser.readline().decode())
# 测试正反转
send_motor_cmd(50) # 正转50%功率
time.sleep(2)
send_motor_cmd(-30) # 反转30%功率
time.sleep(2)
send_motor_cmd(0) # 停止
4.2 协议设计建议
推荐使用ASCII协议而非二进制，便于调试：
- 指令格式：
<电机编号> <速度值>\n - 响应格式：
OK <当前编码器值>或ERR <错误码> - 调试技巧：先用
screen工具手动发送指令bash复制
screen /dev/ttyACM0 115200
5. 运动控制闭环验证
5.1 开环速度测试
固定PWM占空比下，测量电机实际转速：
python复制# 编码器计数转RPM公式
rpm = (count_diff / PPR) * (60 / time_interval)
记录不同PWM值对应的转速，绘制曲线用于后续PID调参。
5.2 简易PID实现
python复制class SimplePID:
def __init__(self, Kp, Ki, Kd):
self.Kp, self.Ki, self.Kd = Kp, Ki, Kd
self.last_error = 0
self.integral = 0
def update(self, error, dt):
self.integral += error * dt
derivative = (error - self.last_error) / dt
output = self.Kp*error + self.Ki*self.integral + self.Kd*derivative
self.last_error = error
return output
# 使用示例
pid = SimplePID(0.8, 0.2, 0.05)
target_rpm = 100
current_rpm = read_encoder_rpm()
pwm = pid.update(target_rpm - current_rpm, 0.1)
6. 常见故障排查表
| 现象 | 可能原因 | 排查方法 |
|---|---|---|
| 电机抖动不转 | PWM频率过低 | 调整至10kHz以上 |
| 编码器计数反向 | AB相接反 | 交换A/B相线序 |
| 主控板死机 | 电源回流 | 添加肖特基二极管隔离 |
| 通信时好时坏 | 波特率误差大 | 改用115200或9600 |
| 电机只单向转 | H桥故障 | 测试驱动板另一路输出 |
7. 进阶调试技巧
-
示波器双通道对比：
- 通道1接PWM信号
- 通道2接电机电流（通过采样电阻）
- 观察电流波形是否跟随PWM变化
-
动态负载测试：
- 用手给电机施加阻力
- 观察PID调节响应速度
- 调整Ki参数消除静差
-
离线数据分析：
python复制# 保存测试数据 import csv with open('motor_test.csv', 'w') as f: writer = csv.writer(f) writer.writerow(['time', 'pwm', 'rpm']) for t, p, r in zip(timestamps, pwms, rpms): writer.writerow([t, p, r])
这套流程在多个学生机器人战队中验证过，最快可以在2小时内完成从零到基本运动的验证。记住：先让轮子转起来，再考虑怎么转得优雅——这是硬件调试的不二法则。