STM32蓝牙电机控制工程：串口协议、PWM调速与PID闭环

简介这份基于STM32的蓝牙与电机控制工程包面向具备C语言和单片机基础的嵌入式学习者围绕蓝牙无线指令驱动直流电机或步进电机的典型场景帮助理解串口通信、脉宽调制调速、方向控制与调试流程。压缩包共136个文件约3.15MB以35个头文件、34个源文件及多份编译中间文件为主同时包含Keil工程配置、可执行输出、映射清单和分散加载脚本较完整保留了从源码、外设库到构建产物的项目结构。已有596人学习。读者可据此复现蓝牙服务与电机控制固件的组织方式参考定时器调速、引脚方向控制和串口指令解析的实现并借助调试配置排查编译、下载与运行问题对标准外设库的调用关系、中断与定时器配置也能形成直观认识适合课程设计、毕业设计前期验证及无线控制入门练习。1. 从手机按键到轮子转动这份 STM32 蓝牙电机控制包补的是中间一段很多人第一次把 STM32、蓝牙串口模块和直流电机凑到一起会遇到一个反直觉的结果代码一行都没错电机单独能转手机单独能连可两边一联动电机就开始抽风、蓝牙就开始掉线。问题通常出在中间的传话、供电和时序环节与算法无关。这份 zip 覆盖的正是中间这一段——从手机发出的一个字节到定时器输出的一路 PWM中间要经过串口中断、环形缓冲、切帧校验、方向脚电平和占空比映射。它适合刚脱离点灯、按键、串口老三样、想直接做整机控制的人也适合手上硬件已经躺了半个月、缺一份能对照排查的参考工程的人。下面按解压、接线、收包、闭环、排坑的顺序拆开说。2. 拆包看骨架一个能跑的 STM32 蓝牙电机工程由哪四层拿到压缩包后先别点编译。源码工程类资源最容易浪费时间的步骤就是上来直接按 F7然后被几十条“找不到头文件”“器件型号不匹配”顶回来。这个包的结构其实就是标准的分层硬件抽象层、板级驱动层、协议层、应用层。先花十分钟把层次认清楚后面改一行代码就知道会动到哪一层比盲目翻 main.c 快得多。2.1 四个目录各自的职责先看 BSP 再看 main典型的目录长这样Drivers/放 HAL 库和 CMSIS基本不用碰Core/放main.c、stm32f1xx_it.c、stm32f1xx_hal_msp.c是启动和中断入口BSP/有的包叫User/或Hardware/放motor.c、encoder.c、protocol.c、bt_port.c这才是要读的部分MDK-ARM/或MDK-ARM/xxx.uvprojx是工程文件另外常配一份.ioc和一张接线图。我的习惯是先看.ioc哪几个脚配成了定时器通道、串口用哪一路、时钟树怎么分的图形化界面里一眼可见比在代码里 grep 引脚名快得多。然后再看main.c的初始化顺序和主循环最后回到stm32f1xx_it.c确认中断服务函数有没有被改写。如果包里没有.ioc那就先看main.c里每个MX_xxx_Init()的排列它就是作者的配置清单。一个必须提前确认的点工程面向的具体型号。包里只要不是同一颗芯片启动文件、stm32f1xx.h里的宏、Flash 容量都会对不上编译过了也可能下载失败。常见做法是打开工程选项里的 Device 一栏跟手上板子的丝印对一遍不一致就换器件型号并重选启动文件别硬编。2.2 接线三张表比十次调试都省事蓝牙和电机同时工作时出的问题八成来自接线尤其是共地和串口交叉。把下面三张表抄到纸上接完逐个打勾。连接项模块侧MCU 侧示例注意串口发送蓝牙模块 RXDUSART1_TXPA9必须交叉TX 接 RX串口接收蓝牙模块 TXDUSART1_RXPA10同上供电VCC / GND3.3V 或 5V / GND看模块电平3.3V 逻辑别喂 5V 电平连接项驱动模块侧MCU 侧示例注意左路调速ENATIM2_CH1PA0必须接 PWM 脚不能接普通 GPIO右路调速ENBTIM2_CH2PA1同上左路方向IN1 / IN2PB12 / PB13两个脚不能同时为高右路方向IN3 / IN4PB14 / PB15同上电源项做法原因电机电源单独电池组电压符合电机额定电机启动瞬间电流是堵转电流的好几倍逻辑电源MCU 与蓝牙模块共用一路 3.3V避免上电时序错乱导致串口乱码共地电机电源负极、逻辑电源负极、驱动模块 GND 全部连一起不共地PWM 信号没有参考点表现为时转时不转第三张表里“共地”这一条是我见过翻车最多的。表现是单独测电压一切正常一接电机 PWM 就乱示波器一看信号幅度被抬高了几伏。原因就是两块电源浮着信号回流路径不存在。2.3 时钟、PWM 频率和引脚改之前先记在纸上初始化顺序不要乱标准写法是时钟、GPIO、定时器、串口最后才启动通道。下面这段是常见的骨架放在main.c的main()里、while(1)之前/* 以 72MHz 主频的型号为例HSE 8MHz × PLL9 72MHz */ SystemClock_Config(); MX_GPIO_Init(); /* 方向脚、使能脚、LED统一先输出低电平 */ MX_TIM2_Init(); /* PWM72MHz / 72 1MHz 计数ARR 999 → 1kHz */ MX_TIM3_Init(); /* 编码器接口TI1/TI2 双边沿计数ARR 65535 */ MX_USART1_UART_Init(); /* 9600 8N1与蓝牙模块出厂参数对齐 */ HAL_TIM_PWM_Start(htim2, TIM_CHANNEL_1); HAL_TIM_PWM_Start(htim2, TIM_CHANNEL_2); HAL_TIM_Encoder_Start(htim3, TIM_CHANNEL_ALL); HAL_UART_Receive_IT(huart1, rx_byte, 1); /* 只挂 1 字节中断频率可控 */几个参数的实际含义预分频PSC71把 72MHz 分到 1MHz自动重装ARR999得到 1kHz 的 PWM 周期占空比就由比较寄存器CCR在 0~999 之间取值。1kHz 是驱动这类双 H 桥模块的常用值——开关损耗小、驱动模块跟得上代价是电机有轻微啸叫要求安静就抬到 16~20kHz但要注意驱动模块的响应上限抬太高会出现“占空比给了、电机没劲”的现象。改引脚之前务必同步改三处.ioc或 CubeMX 配置、stm32f1xx_hal_msp.c里的 GPIO 复用与时钟使能、以及你自己代码里写死的通道常量。只改第一处编译能过运行没波形这类问题排查起来非常玄学。3. 从一串字节到一次调速UART 收包、协议切帧与 PWM 输出链路本身不复杂手机 App 发字节串口中断收字节主循环切帧业务层解析出方向和速度最后写进定时器比较寄存器。难点全在“中断里该做多少事”和“帧边界怎么找”。这两件事处理不好现象就是低速全对一加油门就丢指令或者偶尔电机自己反转一下。3.1 中断里只做搬运环形缓冲扛住突发串口中断服务函数里绝对不要做解析、不要调printf、不要碰电机。常见做法是定义一个固定长度的环形缓冲中断里只负责把字节塞进去主循环再来取。用 HAL 的接收完成回调比手写中断更省心#define RX_BUF_SIZE 64 static volatile uint8_t rx_buf[RX_BUF_SIZE]; static volatile uint16_t rx_head 0, rx_tail 0; static uint8_t rx_byte; /* 每收完 1 字节回调一次只搬运不解析 */ void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { uint16_t next (rx_head 1) % RX_BUF_SIZE; if (next ! rx_tail) { /* 缓冲满则丢弃新字节绝不阻塞 */ rx_buf[rx_head] rx_byte; rx_head next; } HAL_UART_Receive_IT(huart1, rx_byte, 1); /* 必须重新挂载否则只收一字节 */ } } /* 溢出/帧错误必须清否则一次异常之后就再也不进中断 */ void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { __HAL_UART_CLEAR_OREFLAG(huart); HAL_UART_Receive_IT(huart1, rx_byte, 1); } }RX_BUF_SIZE取 64 对 9600 波特率足够一帧 4 字节手机端连点最多也就十几帧每秒64 字节能扛住主循环被其他任务拖住几十毫秒的情况。回调里的HAL_UART_Receive_IT是必须的——只挂一次就只收一个字节这是新手最常见的“串口只收到第一个字符”的原因。ErrorCallback里清溢出标志同样关键串口溢出后硬件会锁住接收不清标志的表现就是“发多少都没反应重启才好”。3.2 三字节协议帧头 数据 异或校验帧格式设计得越简单越好别一上来就上 Modbus。四字节定长帧0xAA | 方向 | 速度 | 校验校验取前三字节异或。定长帧的好处是不用等超时判帧尾切帧逻辑可以写成纯状态机typedef struct { uint8_t dir; uint8_t speed; } cmd_t; static uint8_t frame[4]; static uint8_t idx 0; /* 主循环里调用一次把缓冲里的字节全部处理掉 */ void protocol_poll(void) { while (rx_tail ! rx_head) { uint8_t b rx_buf[rx_tail]; rx_tail (rx_tail 1) % RX_BUF_SIZE; if (idx 0 b ! 0xAA) continue; /* 没等到帧头丢弃噪声 */ frame[idx] b; if (idx 4) { uint8_t sum frame[0] ^ frame[1] ^ frame[2]; if (sum frame[3]) { apply_cmd(frame[1], frame[2]); /* 校验通过才执行 */ } idx 0; /* 无论对错都复位避免粘帧 */ } } }两个细节值得说一是idx在收到完整帧后无条件清零哪怕校验失败。有些实现校验失败后只回退一位遇到连续坏帧就会错位表现为“偶尔自己动一下”。二是速度字段用 0~100 的百分比而不是原始 CCR 值这样协议和硬件解耦将来换 PWM 频率或换电机都不用改手机端。方向字段一般定义成0 停止、1 前进、2 后退、3 原地转向。原地转向时左右轮反向靠两个方向脚分别控制代码里就是一次分支。3.3 占空比映射死区、限幅和停止时的刹车拿到方向和百分比之后落到硬件就三步算 CCR、定方向脚、处理低速死区。#define PWM_ARR 999 static void apply_cmd(uint8_t dir, uint8_t speed) { if (speed 100) speed 100; uint32_t ccr (uint32_t)(PWM_ARR 1) * speed / 100; if (ccr PWM_ARR) ccr PWM_ARR; switch (dir) { case 0: /* 停止两方向脚同低占空比清零避免半桥直通 */ IN1_L(); IN2_L(); __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, 0); break; case 1: /* 前进 */ IN1_H(); IN2_L(); __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, ccr); break; case 2: /* 后退 */ IN1_L(); IN2_H(); __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, ccr); break; case 3: /* 原地转左轮正、右轮反占空比共享 */ IN1_H(); IN2_L(); IN3_L(); IN4_H(); __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, ccr); __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_2, ccr); break; } }死区这件事必须单独处理。这类直流减速电机在 15%~25% 占空比以下基本不转只是嗡嗡响玩家在手机上从 1 加到 100前半段没反应一到临界点突然窜出去。我的做法是分段映射输入 1~10 映射到 011~100 线性映射到 25%~100%并把这个 25% 做成一个宏方便按电池电压变化时微调。停止时方向脚必须同时拉低再清占空比顺序反了会出现一个十几毫秒的“反接制动”驱动模块发烫。4. 把开环变闭环编码器测速与增量式 PID 的落地参数开环占空比在平地上够用一遇到坡道、地毯或者电池从 8.4V 掉到 6.8V速度就完全不一样了。想要“给 60 就跑 60”就得测速加闭环。这一步是这份包从“能转”升级到“能用”的分界线也是大多数人卡住的地方不是 PID 公式难而是测速数据本身不干净。4.1 编码器用定时器的硬件计数模式别用外部中断数脉冲。两路编码器在高速下每秒上千个边沿中断一多串口就抢不到 CPU蓝牙立刻开始丢包。正确做法是把定时器配成编码器接口模式硬件自动加减计数软件只管定时取差值。/* 20ms 调用一次取走计数并清零差值即这段时间的脉冲数 */ int16_t encoder_read_delta(void) { int16_t cnt (int16_t)__HAL_TIM_GET_COUNTER(htim3); __HAL_TIM_SET_COUNTER(htim3, 0); return cnt; } /* 脉冲数换算转速ppr 为编码器线数gear 为减速比4 为四倍频 */ float delta_to_rpm(int16_t delta, uint16_t ppr, uint16_t gear, float dt) { return (float)delta * 60.0f / ((float)ppr * 4.0f * gear * dt); }参数怎么定常见的霍尔编码器是 11 线或 13 线减速比 1:30 到 1:48四倍频后一转的计数就是ppr*4*gear。定时器要配成 16 位、ARR65535、双边沿计数溢出靠 16 位有符号差值自然回绕不用额外判断。dt建议取 20ms太短则量化误差大低速时 20ms 内可能只有几个脉冲太长则响应慢PID 调起来发散。4.2 一阶滤波把毛刺挡在 PID 外面原始测速数据一定带毛刺尤其是 PWM 和编码器共板、地线处理不好的时候。滤波不用复杂一阶低通足够static float spd_flt 0.0f; #define ALPHA 0.3f float speed_filter(float raw) { spd_flt ALPHA * (raw - spd_flt); /* ALPHA 越小越平滑滞后越大 */ return spd_flt; }ALPHA0.3对应约 5 个采样周期100ms跟上阶跃对轮式小车够用。ALPHA调到 0.1 会明显迟钝转弯时内侧轮速跟不上调到 0.6 以上滤波基本失效毛刺直接进 PID表现是电机周期性“一顿一顿”。4.3 增量式 PID三个参数分别管什么位置式 PID 要存积分项抗饱和麻烦电机调速更适合增量式——输出的是“这次该加多少占空比”天然限幅typedef struct { float kp, ki, kd; float e1, e2; /* 上两次误差 */ float out; /* 累计输出即占空比百分比 */ float limit; /* 输出限幅一般 100 */ } pid_t; float pid_calc(pid_t *p, float target, float actual) { float e target - actual; float inc p-kp * (e - p-e1) p-ki * e p-kd * (e - 2.0f * p-e1 p-e2); p-e2 p-e1; p-e1 e; p-out inc; if (p-out p-limit) p-out p-limit; if (p-out -p-limit) p-out -p-limit; return p-out; }调参顺序我一般这样走先ki0, kd0把kp加到转速能跟上、但明显过冲并小幅振荡然后加ki消静差加到过冲可接受、静差进 2% 以内就停kd最后加只用来压超调小车轮速噪声大kd一般取kp的 0.05~0.2 倍加多了反而抖得更凶。积分限幅不能省。堵转时误差恒定ki会把输出一直往上顶松开车轮瞬间满占空比窜出去。上面的写法靠out限幅天然裁掉但更稳的做法是再加一个“误差持续超过阈值 500ms 就清零out”的堵转保护。5. 五个必踩的坑供电、中断、死区、波特率与下载方式这一章按现象、原因、解决三段的格式写都是我自己和身边人踩过的。遇到问题时先在这里对一遍多数情况能省掉半天。5.1 电机一转蓝牙就断松手又自动连上现象手机 App 显示连接正常一给速度就断开停止后几秒恢复。原因不是蓝牙模块坏而是电机启动瞬间的浪涌把 3.3V 拉下来模块复位。解决电机电源与逻辑电源分开逻辑侧加 100μF 电解并 0.1μF 瓷片去耦蓝牙模块 VCC 脚就近再并一个 10μF驱动模块的电机输出端各并一个 0.1μF 瓷片吸收换向火花。改完还没好就把 PWM 频率从 1kHz 抬到 15kHz 以上避开电机的机械共振区。5.2 低速指令全对一加油门就丢帧现象速度 30% 以下控制丝滑60% 以上开始漏指令偶尔方向错乱。原因多半是中断里干了重活——在HAL_UART_RxCpltCallback里直接解析、直接算 PID甚至调了HAL_Delay。解决回调只搬字节解析放到主循环把printf重定向改成环形缓冲发确认HAL_UART_Receive_IT每帧都重新挂载。如果主循环里还有 1ms 的软件延时一并去掉改用定时器标志位。5.3 电机不转、驱动模块发烫现象上电后轮子不动摸驱动模块明显发热电流表读数偏大。原因基本是方向脚电平组合非法或半桥直通两路方向脚同时为高或者停止时只清占空比没清方向。解决把方向控制改成“先拉低两脚延时 1ms再设置新方向最后给占空比”的固定序列初始化时把所有方向脚配成推挽输出并置低上电自检时串口打印四个方向脚的电平确认没有同时为高的组合。5.4 串口收到的全是乱码现象串口助手能看到字节但内容是乱码或首字节固定错。原因有三类波特率不一致模块出厂 9600代码里写了 115200晶振与时钟配置不匹配外部 8MHz 却按内部 8MHz 算误差累积到十几帧就错位电平不匹配模块 5V 逻辑直接怼 3.3V 引脚。解决先用示波器或逻辑分析仪量 TX 上一个字节的宽度反推实际波特率时钟配置里核对 HSE 值与实际晶振电平不匹配串一个分压或用电平转换。这类问题没有后悔药只能量。5.5 换一块板子就下载不了、或者下载后不运行现象同一份工程在旧板子上好使新板子一烧就提示找不到目标或者烧进去了不跑。原因是器件型号、启动文件、下载方式三处之一对不上新型号 Flash 更大但启动文件还是小容量版本BOOT0 被拉高进了系统存储器调试口被复用成了普通 GPIO。解决工程选项里改器件型号并重选启动文件确认 BOOT0 接地、复位后从主 Flash 启动调试口SWD 的两根线在代码里不要配置成普通输出。烧完不跑时先看复位后第一秒有没有串口输出有输出说明程序在跑问题在外设没输出就往启动文件和时钟上找。6. 上电前先自检三张判据表与一套阶跃测试真正省时间的做法是开环自检流程而不是等出了问题再修。我的习惯是每改一次硬件或参数都按下面的顺序走一遍五分钟能挡掉大部分问题。第一步不接电机只接蓝牙和串口手机发一串固定字节串口助手看回显是否完整。第二步接驱动模块但不接电机用万用表量两路输出的电压随占空比线性变化0%、50%、100% 三个点各测一次看有没有跳变。第三步接上电机悬空跑 20%、50%、80% 三档各十秒用手感受驱动模块温度超过 60℃ 就说明 PWM 频率或死区设置有问题。第四步才落地跑。阶跃测试我一般写成一段固定流程让它自己跑人盯着串口曲线/* 阶跃自检0% → 40% → 80% → 0%每档 2 秒串口打印目标值与实测转速 */ void selftest_step(void) { const uint8_t steps[] {0, 40, 80, 0}; for (uint8_t i 0; i sizeof(steps); i) { target_rpm steps[i] * 3; /* 百分比换算成目标转速系数按电机实测改 */ uint32_t t0 HAL_GetTick(); while (HAL_GetTick() - t0 2000) { protocol_poll(); control_loop_20ms(); /* 内部完成测速、滤波、PID、写 CCR */ log_printf(%d,%d\r\n, target_rpm, (int)spd_flt); } } }判据表观测点工具合格判据PWM 波形示波器 / 逻辑分析仪频率与设定一致占空比误差 2%上升沿无台阶方向脚时序逻辑分析仪双通道换向前后有 ≥1ms 全低死区无同时为高转速阶跃响应串口曲线上升时间 300ms超调 10%稳态误差 3%最后说个习惯。早些年我图快改完 PID 直接落地跑结果一次 80% 占空比的阶跃把小车送上了墙编码器线也被扯断。从那以后我每次改控制参数都强制先走一遍“悬空、三档、十秒”的空载自检再落地。多花五分钟能省掉一次拆车。希望帮到你。本文还有配套的精品资源点击获取