简介这是一份基于STM32的蓝牙无线电机控制完整工程代码面向嵌入式初学者与物联网开发者适合学习STM32外设驱动、BLE通信及电机PWM调速的集成开发流程。压缩包共136个文件、约3.15MB内部以标准Keil工程组织35个h头文件与34个c源文件构成固件主体涵盖stm32f10x系列标准外设库uvprojx/uvoptx为工程配置hex/axf为编译输出o/d/crf等为中间文件另有stm32f10x_tim.c、usart.c等可见定时器与串口底层实现整体结构紧凑便于对照阅读。该工程利用STM32通过PWM控制电机速度并借助蓝牙模块接收手机端指令涉及USART、定时器、GPIO等关键外设代码注释与工程配置齐全。目前已有594人学习适合想要快速上手STM32无线控制项目、参考蓝牙通信与电机驱动完整实现的读者。1. 用STM32做蓝牙电机控制这份打包资源到底能救什么急很多做智能小车、遥控云台项目的人最后会发现卡住自己的往往不是某个算法而是“蓝牙能连上但电机不动”“电机动了但不按指令走”这类链路问题。这份“基于STM32的蓝牙电机控制.zip”正好把整条链路拆开讲透蓝牙模块怎么选、怎么接线STM32怎么收串口数据指令怎么解析成PWM占空比电机驱动芯片怎么配合。它面向正在做课程设计、毕业设计的在校学生也适合刚转嵌入式、想在STM32上快速打通“无线控制—数据处理—运动执行”链路的新人。核心不是某一块板子的黑匣子而是一整套可以按段验证的工程方法把链路拆开每段单独测试任何异常都能顺着链路定位。2. 先把硬件链路说透蓝牙模块、驱动板与供电三块怎么选2.1 蓝牙模块SPP 与 BLE 的取舍直接决定调试难度资源内例程默认使用“串口透传”型蓝牙模块最常见的是基于SPP协议的经典蓝牙模块典型型号就是HC-05这一大类另一类是基于BLE的低功耗模组常见的有HM-10、AT-09等。选型时不要只盯着价格先问一个问题谁会连这个蓝牙如果演示场合用的是手机上的蓝牙串口助手SPP模块胜在概念负担最小。配好对以后手机端就是一个虚拟串口你发一个字节对端UART就收到一个字节链路里没有通道、服务、特征值这些额外概念。调试时思路非常干净数据没到问题在蓝牙这一侧数据到了电机不动问题在控制逻辑。BLE功耗更低、连接更快但首次接触时会多出MTU大小、Notify通道、Write Characteristic、Service UUID这些术语对一个还没调稳的电机项目来说这些概念带来的干扰远大于它省下的那点功耗。我个人的习惯是不管最终产品用不用BLE第一版原型一定先用SPP模块把电机链路打通。接线方面这类模块多为四线制VCC、GND、TXD、RXD。与STM32接成交叉关系模块TXD接STM32的RX引脚模块RXD接STM32的TX引脚。大多数SPP模块逻辑电平是3.3V可以和STM32直连如果模块标称5V电平串口线最好做分压或使用电平转换芯片长期直连对STM32引脚不友好。还有一个很容易被忽略的点SPP模块的“命令响应模式”与“透传模式”由EN/KEY引脚控制。上电时这个引脚被拉高模块就会进入AT指令模式所有从手机发来的数据都会被当成AT命令处理透传功能相当于被关闭。很多“蓝牙连上了但发了指令没动静”的现场最后都查到这个引脚上。注意HC-05这类模块的EN/KEY引脚在上电时如果被拉高会进入AT指令模式而不是透传模式调试电机控制时这个引脚必须保持低电平。2.2 电机驱动L298N 和 TB6612 的取舍依据STM32的GPIO只能输出毫安级电流直接驱动电机是推不动的必须靠驱动芯片把逻辑信号转换成功率输出。压缩包里的原理图基本都是这个思路STM32给方向电平给PWM信号驱动模块把外部电源变成电机两端电压差。L298N是入门套件里最常见的驱动板。优点是很便宜、电流能力大单路持续电流约2A缺点是内部采用达林顿管结构饱和压降较大同等电流下发热明显。大电流通过芯片本身时压降会白白消耗一部分功率电机上实际得到的电压低于电源电压。另一个实际体验是L298N对PWM频率比较敏感频率太低时电机会发出明显的电磁啸叫这个我在第5章会展开。TB6612FNG是MOSFET结构的H桥驱动逻辑侧兼容2.7V-5.5V可以直接用STM32的3.3V供电单路持续电流约1.2A峰值3.2A。相比L298N它的导通压降小发热少PWM线性度好在10kHz以上PWM频率下表现更稳定。对于大多数小车套件里的直流减速电机工作电流一般也就300mA到800mATB6612完全够用。以TB6612为例控制逻辑如下表AIN1AIN2PWMA电机状态00任意刹车10PWM正转速度由占空比决定01PWM反转11任意停止不同芯片定义略有差异换成L298N时逻辑一致只是引脚编号不同。资源包里如果例程默认接的是L298N你要改成TB6612只需要修改GPIO映射代码逻辑不用动。2.3 供电顺序与上电自检先排除七成硬件问题我每次搭这个电路都会强制走一套固定的上电顺序顺序不对后面出了问题根本没法定位。第一只给STM32上电确认调试串口能打印信息蓝牙模块的指示灯有反应。第二给驱动模块独立上电此时先不接电机确认驱动逻辑地和STM32共地用万用表量一下方向控制引脚的电压变化。第三接上电机但先不发PWM手动在代码里固定方向电平确认电机能按逻辑正转或反转。第四再让蓝牙连上手机发一条小占空比指令看电机是否缓慢启动。这里重点强调共地。电机电源、驱动板逻辑地、STM32地如果不连在一起单片机发出的控制电平就没有统一参考点驱动芯片可能把悬空电平误判成高电平电机出现不可控转动。供电上建议电机一个电源、单片机一个电源两个电源负极连在一起。另一个通用做法是在电机两端反向并联续流二极管PWM关断瞬间电机绕组的感性电流需要泄放回路。驱动芯片内部一般集成有这个二极管但外接一个总归更保险。资源包里的原理图通常画了这一步手工搭板时却经常被漏掉。3. 固件侧拆解从串口字节流到 PWM 占空比的完整链路3.1 代码骨架中断接收、状态机解析、主循环只做执行解压后的工程目录通常按功能拆分主文件负责初始化USART、定时器、GPIO中断服务文件负责接收蓝牙字节协议解析文件负责从字节流中提帧电机控制文件负责把指令翻译成PWM和方向电平。这是一套很标准的分层结构主循环里不做串口轮询所有串口数据先由中断收进状态机解析完成后直接执行指令。以STM32F103系列为例初始化串口的典型代码长这样// 假设USART1接蓝牙波特率96008N1 void BLE_UART_Init(void) { GPIO_InitTypeDef gpio; USART_InitTypeDef uart; RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); gpio.GPIO_Pin GPIO_Pin_9; // TX gpio.GPIO_Mode GPIO_Mode_AF_PP; gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); gpio.GPIO_Pin GPIO_Pin_10; // RX gpio.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, gpio); uart.USART_BaudRate 9600; uart.USART_WordLength USART_WordLength_8b; uart.USART_StopBits USART_StopBits_1; uart.USART_Parity USART_Parity_No; uart.USART_HardwareFlowControl USART_HardwareFlowControl_None; uart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, uart); USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); USART_Cmd(USART1, ENABLE); }这段代码把USART1配置为9600波特率、8数据位、1停止位、无校验只开启接收中断。注意我没有开启发送中断因为电机的控制指令很短主循环里主动发送速度回传就够用开着发送中断反而多了一层打断源。参数上最关键的是波特率必须与蓝牙模块的串口参数一致。常见出厂配置有9600和38400如果例程默认9600而模块是38400收到的就是乱码。拿到工程的第一件事应该去核对这个值。3.2 串口接收状态机抗丢包、抗错位的关键蓝牙透传虽然使用体验像一条无线串口线但本质上仍是无线信道存在字节丢失或顺序错乱的可能。如果代码写成“收到一个字节就立即执行”一旦手机端发了两条指令连在一起或某字节被干扰电机动作就会出错。更稳的做法是定义帧协议用状态机识别帧头、功能码、数据、校验和。一个简洁但够用的命令帧定义如下字段长度说明帧头2字节0xAA 0xAA用于同步功能码1字节0x01调速0x02方向0x03停止数据1字节调速时0-100方向时0正转、1反转校验和1字节前面所有字节累加后取低8位串口中断和状态机的实现可以这样写// 字节接收中断 void USART1_IRQHandler(void) { uint8_t byte; if (USART_GetITStatus(USART1, USART_IT_RXNE) ! RESET) { byte USART_ReceiveData(USART1); BLE_Protocol_Feed(byte); } } // 状态机从等待帧头开始 #define ST_WAIT_HEAD1 0 #define ST_WAIT_HEAD2 1 #define ST_WAIT_CMD 2 #define ST_WAIT_DATA 3 #define ST_WAIT_CHECK 4 void BLE_Protocol_Feed(uint8_t byte) { static uint8_t state ST_WAIT_HEAD1; static uint8_t rx_cmd, rx_data, rx_sum, calc_sum; switch (state) { case ST_WAIT_HEAD1: if (byte 0xAA) state ST_WAIT_HEAD2; break; case ST_WAIT_HEAD2: state (byte 0xAA) ? ST_WAIT_CMD : ST_WAIT_HEAD1; break; case ST_WAIT_CMD: rx_cmd byte; calc_sum byte; state ST_WAIT_DATA; break; case ST_WAIT_DATA: rx_data byte; calc_sum byte; state ST_WAIT_CHECK; break; case ST_WAIT_CHECK: rx_sum byte; if (calc_sum rx_sum) BLE_ExecuteCmd(rx_cmd, rx_data); state ST_WAIT_HEAD1; calc_sum 0; break; default: state ST_WAIT_HEAD1; break; } }逻辑说明先等两个连续的0xAA确认帧头随后依次接收功能码、数据、校验位。校验计算用的也是静态变量每收一字节累加一次帧结束时与校验字节比较一致就执行指令不一致则整帧丢弃并回到初始状态。状态机的好处是即使前一帧传到一半被打断下一帧只要从帧头开始仍能正确同步不会因为一个错字节导致后续所有指令失效。参数说明这里的和校验只能防偶发误码满足不了强干扰环境。项目要求高时可以把累加和换成CRC8代价是多几十行查表代码。另一个容易被忽略的点是static变量代表一套串口通道的状态如果电路里有多路串口每一路都要单独声明一套状态机变量不能共用。提示状态机里的static变量代表了串口通道的状态如果工程里有多路串口每一路都要单独实现一套状态机不能共用。3.3 PWM 输出与方向 GPIO把指令落到电机电机速度控制用定时器PWM。以通用TIM2为例初始化时设置预分频和自动重装载值生成固定频率的PWM波形// 定时器输入时钟72MHz预分频72计数频率1MHz TIM_TimeBaseInitTypeDef tb; tb.TIM_Prescaler 72 - 1; tb.TIM_Period 1000 - 1; // PWM频率 1MHz / 1000 1kHz tb.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, tb); TIM_OCInitTypeDef oc; oc.TIM_OCMode TIM_OCMode_PWM1; oc.TIM_Pulse 0; oc.TIM_OutputState TIM_OutputState_Enable; TIM_OC1Init(TIM2, oc); TIM_Cmd(TIM2, ENABLE);如果把TIM_Period设为999PWM频率就是1kHz对许多减速电机来说可以工作但听觉上会有些许啸叫。想提到10kHz可以把TIM_Period改为100-1预分频仍是72-1注意改完周期后指令数据到占空比的映射比例也要同步调整否则同样的数值对应的实际占空比完全不同。方向控制和指令执行可以写在一起void BLE_ExecuteCmd(uint8_t cmd, uint8_t data) { uint16_t speed; switch (cmd) { case 0x01: // 调速data范围0-100 if (data 100) data 100; speed (uint16_t)((uint32_t)data * 999 / 100); TIM_SetCompare1(TIM2, speed); break; case 0x02: // 方向0正转1反转 GPIO_WriteBit(GPIOB, GPIO_Pin_0, data ? Bit_RESET : Bit_SET); GPIO_WriteBit(GPIOB, GPIO_Pin_1, data ? Bit_SET : Bit_RESET); break; case 0x03: // 停止 TIM_SetCompare1(TIM2, 0); GPIO_WriteBit(GPIOB, GPIO_Pin_0, Bit_RESET); GPIO_WriteBit(GPIOB, GPIO_Pin_1, Bit_RESET); break; default: break; } }注意占空比映射用的是data * 999 / 100而不是data * 10。原因是脉冲计数器范围是0到999乘10会产生1000超过自动重装载值虽然部分定时器会屏蔽溢出但逻辑上不严谨。用99倍再除以100保证线性映射且不会越界。方向引脚就是普通的GPIO推挽输出。3.4 主循环为什么做这么少中断驱动结构的取舍很多第一次看这套代码的人会找“主循环在哪里处理协议”结果发现主循环只有几行真正干活的是中断、状态机和指令执行函数。这样设计的好处是无论手机发送多快单片机都不会因轮询而漏字节也不会因为处理指令耗时太长而阻塞蓝牙接收。我建议保持这个结构不要为了“显得有逻辑”把协议解析放到主循环里反复判断那样反而容易丢数据。4. 模块联调从蓝牙配对到确认电机实际受控4.1 先用 USB-TTL 把蓝牙模块调到确定状态在连接STM32之前先把蓝牙模块插在USB-TTL转串口上单独配置一遍参数。这一步能避免很多“为什么连不上”的问题。模块进入AT模式有两种方式如果模块有按键按住按键再上电或者把EN/KEY引脚拉高再上电。配置内容一般有四项改名ATNAMECarDemo让手机蓝牙列表里一眼能找到设备配对密码ATPSWD1234改成自己熟悉的数值串口参数ATUART9600,0,0第一个数字是波特率后两个分别表示停止位和校验位角色ATROLE0设为从机模式等待手机连接。用AT指令时注意每条以回车换行结尾指令返回OK表示执行成功。如果返回ERROR先查模块是否确认处于AT模式再看波特率是否与USB-TTL当前设置一致。全部配置完后把模块断电重上电进入透传模式再用手机蓝牙连它。配对成功后在串口助手里发HEX格式的AA AA 01 32 87USB-TTL另一端应该收到同样的5个字节。这段回环测试通过说明蓝牙链路本身没问题接下来才轮到STM32的事。4.2 手机端联调先看数据有没有到再谈电机转不转接下来把蓝牙模块的TXD接到STM32的USART1_RXRXD接到USART1_TX。注意不要接反接反的最典型特征是模块连接正常、手机也显示已连接但STM32的串口一个字节都收不到。下载程序后用手机发送帧格式为AA AA 01 50 A5的指令这是调速功能码0x01、数据0x50也就是80%速度校验位0xA5是前面四个字节的和校验。这时候从现象上分三层验证。第一层STM32上的调试串口能打印收到的原始字节确认物理链路通。如果打印出来是乱码查波特率如果什么都没有查TXD/RXD是否交叉查两个设备是否共地。第二层在协议解析处打日志。我调试时习惯在BLE_ExecuteCmd入口打印一条“cmd01, data80”这样能区分“协议解析成功但电机不动”与“收的是乱码根本没解析出来”两种情况不至于对着干转的电机发呆。第三层看电机动作。发0x50后电机的实际转速应该在额定转速的八成左右如果转得太慢或力矩不够再核对驱动电源电压是否足够而不是急着改代码。4.3 把参数约束算明白占空比、转速与供电电压的关系蓝牙指令里传的是百分比但最终作用到电机上的物理量仍是电压平均值。以12V电机为例占空比50%时有效电压约6V忽略驱动压降的话空载转速约为额定转速的50%带载时实际转速会因负载下降。所以一个常见误区是“发100%电机就该满速转”实际在电池电压偏低的情况下实测转速可能只有额定转速的70%。因此我把上位机的调速指令设计成0到100的百分比而不是直接暴露PWM的原始计数值。这样换电机、换电源时上位机不用改只改单片机一端的映射关系即可。比如把电机换成24V版本只需调整满量程对应的占空比计算上位机协议完全不用动。4.4 双电机场景下的协议扩展一个包控制左右轮如果项目是小车底盘两个电机要差速转弯协议可以扩展成“功能码0x01控制左轮0x02控制右轮0x03同时控制”的结构。每帧仍然保持帧头加校验只是数据字节从1个变成2个在状态机里多收一个字节即可。case ST_WAIT_CMD: rx_cmd byte; calc_sum byte; state ST_WAIT_DATA; break; case ST_WAIT_DATA1: rx_data1 byte; calc_sum byte; state ST_WAIT_DATA2; break; case ST_WAIT_DATA2: rx_data2 byte; calc_sum byte; state ST_WAIT_CHECK; break;逻辑说明一个字节数据变两个状态机从ST_WAIT_DATA1到ST_WAIT_DATA2再到ST_WAIT_CHECK。这样可以实现左轮速度、右轮速度独立设置转弯时一侧减速一侧加速比单独发两条指令要稳定得多两条指令之间的间隔会被蓝牙链路拉长。扩展帧协议这种方式也避免了频繁改动硬件接线。5. 避坑与排查五类实测翻车记录及修复方法这一章我把调试中反复遇到的五类典型问题整理成现象、原因、解决三段。每一条都是实际踩过的坑按出现频率从高到低排列特别适合在“蓝牙连上了但现象不对”的时候逐条对照。5.1 电机啸叫并伴随速度抖动现象上电后电机不转或轻微抖动发出明显的高频啸叫声发调速指令后转速不稳定。原因PWM频率太低。早期例程为简化计算把定时器周期设成毫秒量级PWM频率只有几百赫兹电机线圈在这个频率下处于不断地导通和断开状态电磁噪声被人耳听到转速自然不稳。解决把PWM频率提高到10kHz以上。计算方法为PWM频率 定时器时钟 /预分频 × 周期。以72MHz定时器时钟为例预分频设为71、自动重载值设为99PWM频率就是72MHz / (72 × 100) 10kHz。改完后把速度映射的999改成99否则指令100%占空比时会溢出。5.2 蓝牙连接成功但 STM32 收不到数据现象手机配对正常、显示已连接发送HEX指令后电机无任何反应调试串口也打印不出原始字节。原因遇到最多的是TXD/RXD接反。蓝牙模块TXD应该接STM32的RX引脚但很多人按“名字对应”接了TXD到TX结果数据发不出去。另一类是共地缺失两个设备参考地不一致信号电平无效。解决先用万用表确认引脚连通关系或者直接把模块拆下来用USB-TTL做回环测试确认蓝牙本身没问题后再接STM32。接线时强制把GND先用短线连好再连TXD/RXD这个顺序能省掉大量重复排查时间。5.3 发一次指令电机却连续执行半天状态机缺超时机制现象目标是让电机点动一下但电机按指令启动后很久才停或者连续执行了好几次相同的动作。原因上位机发送的数据间隔过长而协议状态机停留在WAIT_DATA状态等待剩余字节。比如只发了帧头AA AA没有后续字节状态机不会自动复位后面再发新一帧状态机会错位解析。解决给状态机加超时机制。最简单的是用一个1ms定时器做时基每次喂给状态机时刷新一个时间戳如果超过20ms没有新字节到达就把状态强制复位到ST_WAIT_HEAD1。资源包例程通常没有这一步实际项目里我都会补上算是一个比较容易忽略的协议健壮性设计。5.4 电机启动瞬间单片机复位现象蓝牙指令一发电机刚要转STM32就重启串口重新打印初始化信息看起来像死机后又恢复了。原因电机启动电流太大把电源电压瞬间拉到单片机复位阈值以下。常见情形是驱动板与单片机共用同一个USB供电或同一个电池电机启动瞬间电压跌落单片机看门狗或者上电复位电路直接复位。解决电机和单片机分开供电两个电源负极共地。如果只能用单电源在驱动板电源输入端加大容量电解电容例如470uF到1000uF并在单片机电源引脚旁边加0.1uF去耦电容效果会改善很多。注意不要用同一个USB口同时给蓝牙、单片机和电机供电我之前在这个问题上翻车过一次。5.5 BLE 模块连不上或连接后很快断开现象手机扫描不到模块或者好不容易连上发送几次指令后连接就断开要重新扫描。原因BLE模块的广播参数或连接参数不合适部分手机对连接间隔比较敏感另一个常见原因是模块供电不足BLE模组发射瞬间电流拉低电压导致断开。电源线太长太细也会有类似表现。解决先排除供电问题给模块单独用3.3V LDO供电不和其他大电流器件共用LDO。如果连接仍不稳用AT指令把广播间隔调大、连接间隔调整到合理范围。SPP模块基本不存在这个问题这也再次验证了第一章的观点第一版原型用SPP最省心。6. 再进一步加编码器测速把开环控制升级成带反馈的闭环蓝牙控制电机到这里已经能跑但开环控制的局限你很快会碰到电池电压变化、负载变化都会让同一占空比对应的转速不一样。想稳定转速就得加编码器把“发多少占空比”换成“转速差多少就调多少占空比”。6.1 编码器信号接入与测速大多数直流减速电机自带霍尔编码器输出A、B两相信号常见的是正交输出。STM32上可以用定时器的编码器模式直接采集也可以退一步只用A相接到一个支持输入捕获的定时器通道在中断里计数。以常见做法为例把编码器A相接在TIM4的CH1上初始化成输入捕获模式。速度计算使用两次采样之间的计数器差值// 每10ms执行一次测速任务 void Speed_Calc_Task(void) { uint16_t now TIM_GetCounter(TIM4); static uint16_t last 0; int16_t delta (int16_t)(now - last); last now; Speed_rpm (int16_t)((int32_t)delta * 6000 / PPR); }这里的PPR是电机编码器线数乘以减速比后的总脉冲数不同电机差别很大必须查数据手册标称值。比如编码器11线、减速比1比30PPR就是330。如果换算后转速为0但电机在转多半是PPR算错了或者计数器溢出方向搞反。6.2 简单的比例调节闭环有了实测转速就可以写一个最简P控制器目标转速由蓝牙指令设定输出占空比等于当前占空比加上Kp乘以转速偏差。Kp先给一个小值比如0.02跑起来后观察超调量再逐步增加。电机这类惯性负载用P控制已经能看效果PI能消除静差但I项调不好容易振荡我在这个阶段通常不加。闭环控制带来的直接变化是把手机端的调速指令从“占空比数值”升级成“目标转速”电池电压波动时占空比会自动修正。测试方法也很直观空载先跑一个目标转速然后用手捏住电机轴模拟负载示波器上应该看到PWM占空比自动加大、转速回稳的过程。从那以后我每次接手新的电机项目都强制走一遍同样的四段验证先单测硬件上电再单独验证蓝牙回环然后验证协议解析最后才碰PID参数。哪怕只是改了一个引脚定义也把前两步重跑一遍。这套流程看起来慢实际是少走弯路的后悔药。希望帮到你。本文还有配套的精品资源点击获取