STM32 嵌入式开发入门

嵌入式
7.5k 词

入门文的通病是”能点亮 LED 就毕业”。本文换一条路线：以 RoboMaster 电控的真实任务链为主线——CubeMX 生成工程 → 时钟树 → GPIO → 串口帧协议 → 编码器 → CAN 总线驱动 M3508/C620 → 云台双环 PID，把每一层”为什么”讲透，并附上实际调车时踩过的坑。看完你应该能独立完成”STM32 通过 CAN 控制一个无刷电机并做闭环”这件事。

一、任务链：入门到实战之间缺什么

一个最小可用的电控系统长这样：

1
2
3
4
5
6
7
8
遥控器 → 接收机 → 串口/USB → STM32 (解析协议)
                                    │
          ┌─────────────────────────┼──────────────────┐
          ▼                         ▼                  ▼
     编码器(AB相)               PWM/舵机            CAN 总线 → C620 电调 → M3508 电机
          └──── 定时器编码器模式 ────┘              （反馈角度/转速/电流）
                                    │
                             双环 PID（位置环→速度环）

每一环都有对应的外设和坑。下面按这条链展开。

二、时钟树：一切外设的心跳

2.1 为什么第一件事是配时钟

STM32 上电默认跑 HSI（内部 8MHz RC），精度 ±1% 且温度漂移明显——串口波特率算出来是 9599 而不是 9600 就是它的锅。所有外设（定时器、串口、CAN、ADC）的时钟都从系统时钟分频而来，先定 SYSCLK，才能算 PWM 频率和波特率。

真实踩坑：STM32F407 上配置了 HSE 后发现进 Error_Handler()。原因：HSE 使用的引脚（PC13/PC14 区域）和某个 GPIO 功能冲突，振荡器起振失败。排查手段：CubeMX 里 Clock Configuration 页面会标红；应急方案是改用 HSI（性能略降但能跑），根治方案是换引脚或换晶振方案。

2.2 PLL 推导：8MHz 晶振怎么变成 168MHz

F407 的时钟链路是 HSE → PLL(M, N, P) → SYSCLK：

1
2
VCO 输出 = HSE / M × N
SYSCLK   = VCO / P

CubeMX 默认配置：HSE=8MHz，M=8，N=336，P=2：

1
2
VCO = 8 / 8 × 336 = 336 MHz
SYSCLK = 336 / 2 = 168 MHz   ✓

然后是总线分频（这步直接决定外设速度）：

总线 分频 频率 挂载的外设 定时器时钟
AHB /1 168 MHz GPIO、DMA、内存 —
APB1 /4 42 MHz USART2/3、CAN、I2C、TIM2~7 ×2 = 84 MHz
APB2 /2 84 MHz USART1、SPI1、TIM1/8~11 ×2 = 168 MHz

坑：定时器时钟是 APB 的两倍。 当 APB1 预分频 >1 时，定时器时钟自动 ×2（为了让定时器不损失精度）。算 PWM 频率前先查清楚你的定时器挂在哪条总线上，否则频率差一倍还找不到原因。

2.3 PWM 频率计算：舵机 50Hz 怎么配

PWM 频率公式：

1
f_PWM = TIM_CLK / ((PSC + 1) × (ARR + 1))

舵机需要 50Hz、占空比 0.5ms2.5ms（对应 0°180°）。若挂在 APB1（TIM_CLK=84MHz）：

1
2
3
84MHz / (PSC+1) / (ARR+1) = 50Hz
取 PSC = 83 → 1MHz 计数频率 → ARR = 19999 → 20000 计数 = 20ms 周期
占空比 1.5ms = 1500 计数 = 中位
1
__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 1500);   // 1.5ms 中位

一个定时器只能产生一种周期的 PWM，但每个通道可以独立设置占空比——这是”一个定时器带多个舵机”的依据。要不同频率就得换定时器。

三、GPIO：BSRR 原子写与驱动能力

3.1 HAL_GPIO_WritePin 为什么用 BSRR

看 HAL 源码，写引脚走的是 BSRR（Bit Set/Reset Register）而不是 ODR：

1
2
3
4
5
6
7
8
void HAL_GPIO_WritePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin, GPIO_PinState PinState)
{
    if (PinState != GPIO_PIN_RESET) {
        GPIOx->BSRR = (uint32_t)GPIO_Pin;        // 置位
    } else {
        GPIOx->BSRR = (uint32_t)GPIO_Pin << 16U; // 复位
    }
}

区别在原子性：GPIOA->ODR |= (1<<5) 是”读-改-写”三步，如果在中断里同时操作同一端口的另一位，中间态会被覆盖；BSRR 是单次写寄存器，硬件直接完成置位/复位，中断安全。这就是官方推荐 BSRR 的原因，也是你在看别人代码时看到直接操作 ODR 要警惕的地方。

3.2 驱动能力：GPIO 不能直接带电机

STM32 GPIO 推挽输出只能提供约 ±8mA（绝对最大 25mA），而电机启动电流是安培级。结论：功率器件必须走驱动电路（MOS 管、L298N、或者干脆用带驱动的电调如 C620）。同时注意感性负载（电机、继电器）两端必须并联续流二极管，否则关断瞬间的反向电动势会打穿 MOS。

四、串口：中断回调、printf 重定向与帧协议

4.1 HAL 的中断回调机制

CubeMX 生成代码后，串口接收的完整链路是：

1
硬件收到字节 → USARTx_IRQHandler → HAL_UART_IRQHandler → HAL_UART_RxCpltCallback
1
2
3
4
5
6
7
8
9
10
11
// 启动一次接收（接收 1 字节后进回调）
HAL_UART_Receive_IT(&huart1, &rx_byte, 1);

// 回调里处理并【重新使能接收】——这是新手 90% 的 bug 来源
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
    if (huart->Instance == USART1) {
        /* 解析协议... */
        HAL_UART_Receive_IT(&huart1, &rx_byte, 1);  // 忘了这行 = 只收一字节
    }
}

HAL 的 _IT 系列是”一次性”的：接收完成回调后中断就关了，必须手动重新使能。同理 HAL_UART_Transmit 是阻塞发送（带超时），高频发送时会让主循环卡死。

4.2 printf 重定向与 MicroLIB 坑

1
2
3
4
int fputc(int ch, FILE *f) {
    HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 0xffff);
    return ch;
}

真实坑：Keil 调试卡死在 LDR R0, =SystemInit，进不了 main。 触发条件恰好是 CubeMX 开启串口 + 重定向 fgetc()。原因：默认的 C 库（非 MicroLIB）的 fgetc/fputc 依赖半主机模式（semihosting），调试器未使能半主机时 CPU 停在启动代码里。解决：Keil Options → Target → 勾选 Use MicroLIB。

4.3 高频中断丢数据 → FIFO/DMA

逐字节中断接收在低速（9600）下没问题；115200 以上且数据密集时，中断频繁触发会挤占主循环 CPU，且处理不过来就丢字节。两条路：

  1. 软件 FIFO：回调只把字节压入环形缓冲区，主循环解析；
  2. DMA 空闲中断（IDLE）：DMA 把整帧搬到内存，收到空闲（帧间停顿）再一次性处理——批量传输几乎不占 CPU，是量产固件的标准做法。

4.4 帧协议：真实命令码

上位机和 STM32 之间必须定协议，典型结构：帧头 + 命令字 + 长度 + 数据 + 校验 + 结束符。实际项目里的例子（串口舵机控制）：

1
2
3
55 AA A1 0C FA 00 FA 00 00 00 00 00 00 00 00 00 E0 0D 0A   ; 角度 = 250
55 AA A1 0C 32 00 32 00 00 00 00 00 00 00 00 00 43 0D 0A   ; 角度 = 50
55 AA A1 0C A6 FF A6 FF 00 00 00 00 00 00 00 00 64 0D 0A   ; 角度 = -90
  • 55 AA：帧头（0x55=01010101 便于示波器/串口助手识别）
  • A1：命令字；0C：后续数据长度（12 字节）
  • FA 00：小端 int16 = 250，目标角度
  • E0：校验字节；0D 0A：结束符

坑：校验和必须自己实现并测试边界。 只靠帧头+结束符的协议，在数据里恰好出现 0D 0A 时会错帧；加校验（如累加和、CRC8）后宁可丢帧也不解析错帧——控制类系统”错的数据”比”没数据”危险得多。

五、定时器：编码器模式与 ×4 倍频

5.1 正交解码原理

增量式编码器输出两路相位差 90° 的方波 A、B。定时器的编码器模式（TIM_ENCODERMODE_TI12）在 A 和 B 的上升沿+下降沿都计数：

AB 相正交编码器 ×4 倍频

一个完整周期内有 4 个计数沿，所以计数分辨率 = 编码器线数 × 4。方向判定：B 滞后 A 90° 时正向计数，B 超前 A 时反向计数——硬件自动完成，无需软件判断。

1
2
3
4
// CubeMX：TIM2 设为 Encoder Mode TI1+TI2，计数器 32 位（F4 的 TIM2/5 是 32 位）
HAL_TIM_Encoder_Start(&htim2, TIM_CHANNEL_ALL);
int32_t count = __HAL_TIM_GET_COUNTER(&htim2);   // 读计数
__HAL_TIM_SET_COUNTER(&htim2, 0);                // 清零

真实坑 1：编码器计数一直在 0、1 徘徊。 原因是 RCC 时钟配置不对——编码器模式下定时器必须用 HSE 提供的时钟才有效，改成内部时钟（HSI）后计数不动。CubeMX 里检查定时器 Clock Source 是否选了内部时钟且系统时钟来源是 HSE。

真实坑 2：增量式编码器上电初值随机。 断电后角度信息丢失，所以 RoboMaster 的电机才需要”校准”（见第七节）——电机先撞机械限位，把当前位置定义为零点。

5.2 轮速换算公式

1
2
电机轴转速(rpm) = 计数差值 / 4 / 线数 × 60 / Δt(秒)
输出轴角度      = 计数 / 4 / 线数 / 减速比 × 360°

M3508 减速箱减速比 19.2032（规格书值），即电机轴转 19.2 圈输出轴转 1 圈——做 URDF 传动、算轮速时这个数用错，速度会差近 20 倍（真实调车时碰到过：URDF 里减速比符号/数值不对，校准控制器判定”未到位”）。

六、CAN 总线：从原理到 M3508/C620

6.1 协议原理：多主、仲裁、显性/隐性

CAN 是多主总线：总线空闲时任何节点都能发。多个节点同时发送时靠逐位仲裁解决冲突——显性位（逻辑 0）覆盖隐性位（逻辑 1），ID 数值越小优先级越高，发送高优先级报文的节点自动赢得总线，输的节点自动转为接收，全程无数据破坏：

CAN 帧结构与总线仲裁

CAN 2.0A 标准帧最长 108 bit（8 字节数据时），1 Mbit/s 下约 108 µs/帧。这意味着一毫秒控制周期内理论上能塞 9 帧——这就是电调（C620）、云台（GM6020）敢全部挂一条 CAN 的原因。

6.2 物理层：为什么两端要 120Ω

CAN 物理层是差分对（CANH/CANL），总线特征阻抗约 120Ω。总线两端各接一个 120Ω 终端电阻是为了阻抗匹配：没有终端电阻时信号在总线末端反射，波形畸变会导致误码；只有一端接时反射只衰减一半，高速率下同样会出错。排查”CAN 偶发掉线”时第一件事就是量终端电阻。

6.3 C620 电调报文协议（实战核心）

C620 通过 CAN 收电流指令、发电机状态，同一时刻只能用 CAN 或 PWM 一种控制方式。标准协议：

控制帧（0x200，8 字节）——一次控制 4 个电机，每电机 2 字节 int16 电流指令（-1638416384 对应 -20A20A）：

1
2
3
4
5
6
7
8
9
CAN_TxHeaderTypeDef tx = {
    .StdId = 0x200, .IDE = CAN_ID_STD, .RTR = CAN_RTR_DATA, .DLC = 8 };
uint8_t data[8];
int16_t current[4] = {1000, -500, 0, 2000};   // 4 个电机的电流指令
for (int i = 0; i < 4; i++) {
    data[2*i]   = current[i] & 0xFF;          // 小端
    data[2*i+1] = current[i] >> 8;
}
HAL_CAN_AddTxMessage(&hcan, &tx, data, &mailbox);

反馈帧（0x201~0x208，每电机一帧）——C620 以 1kHz 主动上报：

字节 内容 说明
0~1 转子角度 0~8191（13 bit 有效），电机轴一圈
2~3 转子转速 int16，rpm（带符号）
4~5 实际电流 int16，-16384~16384
6 温度 ℃ 
1
2
3
4
5
6
7
8
9
10
11
12
void HAL_CAN_RxFifo0MsgPendingCallback(CAN_HandleTypeDef *hcan)
{
    CAN_RxHeaderTypeDef rx; uint8_t d[8];
    HAL_CAN_GetRxMessage(hcan, CAN_RX_FIFO0, &rx, d);
    if (rx.StdId >= 0x201 && rx.StdId <= 0x208) {
        uint8_t id = rx.StdId - 0x200;               // 1~8
        int16_t angle = (d[1] << 8) | d[0];
        int16_t rpm   = (d[3] << 8) | d[2];
        int16_t cur   = (d[5] << 8) | d[4];
        /* 喂给速度环/位置环 */
    }
}

坑：反馈是电机轴数据，不是输出轴。 角度 8192 对应电机轴一圈，M3508 输出轴要除以 19.2032；GM6020 是直驱（空心轴），8192 直接对应输出一圈。用错换算，位置环永远调不出来。

6.4 真实调车坑：电机 ID 靠后导致丢包

给拨盘电机发 1Hz 指令，正常转一会后乱转。排查：电机 ID 太靠后，CAN 帧在总线上排队/过滤出问题导致丢包严重——控制指令丢了电机保持旧电流，反馈丢了 PID 拿不到测量值，系统就”疯”了。解决：把电机 ID 改到前面。

CAN 接收侧同理：RX FIFO 溢出（FIFO0 满）时新帧被丢弃，HAL_CAN_GetRxMessage 没及时取走就会出现”时好时坏”。开 HAL_CAN_ActivateNotification 的回调里要尽快取帧，处理逻辑放主循环。

七、实战：云台双环 PID 与电机标定

7.1 为什么是”位置环套速度环”

云台（yaw/pitch）的标准做法是双环：外环位置环输出转速指令，内环速度环跟踪该转速。为什么不用单环位置 PID？

  1. 速度环先吃掉扰动：摩擦、重力矩先由内环快速补偿，外环只看到”残差”，抗扰性能好；
  2. 天然限幅：外环输出限幅 = 最大转速，保护机构；
  3. 内环可以单独调试：先让速度环稳，再叠位置环，问题定位清晰。

调参经验（来自实际调试记录）：

1
2
3
速度环（内环）：只给 P、I   —— P 给响应速度，I 消静差（摩擦/重力导致的稳态误差）
位置环（外环）：只给 P       —— 位置环给 D 容易引入噪声放大，先不加
验收标准：速度环跟得上正弦指令；位置环"手掰不超调、不抖动"

实测指标（云台测试）：yaw 给 2·sin(2πt/100) 位置指令，稳态误差控制在 0.004 rad 以内；pitch 给 0.3·sin(2πt/150)，误差 0.006 rad 以内。没有这个量化标准，”调好了”就是玄学。

7.2 电机反应时间怎么测

云台切到 DIRECT 模式（直接发位置），只发 x/y 轴位置指令（pitch 有限位小心别打机构），用 PlotJuggler 录 setpoint 和 process_value 曲线：电机回到稳态的时间 − 指令发布时间 = 电机反应时间。反应时间 >50ms 的云台，视觉自瞄根本追不上快速目标。

7.3 校准：增量式编码器必须撞限位

增量式编码器上电初值是随机的，必须校准：开启校准控制器让电机转到一个机械限位，把该位置记为角度零点。真实经验：

  • 校准失败排查顺序：CAN 掉线 → PID 没配（P 太小或没定义）→ 代码错误；
  • 校准显示成功但电机没转：URDF 里的判定阈值（firsthole 相关元素）设太小，或减速比正负反了；
  • 拨盘校准放一颗弹丸再校——防止”卡住弹丸”被误判成”撞到机械限位”。

八、PCB 设计要点

  1. 电源去耦：每个 VDD 引脚旁放 100nF，MCU 电源入口再放 10µF+100nF 组合；去耦电容必须紧贴引脚，过孔就近打
  2. 晶振布局：靠近 MCU（<10mm），走线等长、包地，晶振下方不要走其他信号线
  3. CAN 终端电阻：总线两端各 120Ω；走差分线，等长、阻抗匹配，远离 PWM 和电机线
  4. 功率与信号分离：电机线、电源线与信号线分区走，地平面单点/分区连接，避免大电流回路耦合进信号地
  5. 地平面完整：底层尽量整片铺地，不要被过孔和走线切碎——地平面不完整 = 天线 = EMI 问题
  6. 串口/USB 防护：机器人场景加 TVS 和共模电感，热插拔和静电是烧串口芯片的头号原因

九、踩坑清单（都是真实发生过的）

现象 原因 解决
进 Error_Handler() HSE 与 GPIO 功能冲突，晶振不起振 换引脚或改 HSI
编码器计数 0/1 徘徊 定时器时钟源不对（HSI） RCC 选 HSE，定时器选内部时钟
Keil 卡 LDR R0, =SystemInit printf/fgetc 半主机模式 勾选 Use MicroLIB
串口只收第一字节 HAL_UART_Receive_IT 没重新使能 回调末尾重新使能
电机转一会乱转 电机 ID 靠后丢包 / RX FIFO 溢出 ID 改前、及时取帧
CAN 偶发掉线 终端电阻缺失/松动 量 120Ω，重新插拔
校准成功但电机不动 URDF 减速比符号/阈值错误 对减速比 19.2032，开 rqt 调 P
云台一开控制器就甩 IMU 坐标系与 URDF 不一致 对比实物 IMU 丝印与 rviz，改 <inertial> 的 rpy

最后一句：嵌入式开发的瓶颈从来不是”会不会调库”，而是时钟算得对不对、协议定得严不严、反馈换算准不准。把这三件事做到位，剩下的就是控制律的活了。