简介本资源是一套基于C语言开发的L298N电机驱动程序专为正点原子STM32F103核心板设计面向嵌入式初学者与机器人控制实践者解决直流双电机的正反转、差速拐弯及PWM无级调速等核心控制问题。压缩包共76个文件含33个头文件.h用于外设配置与函数声明、32个源文件.c实现GPIO初始化、PWM输出、电机控制逻辑及中断服务另有工程配置.uvprojx/.uvoptx、启动代码.s、系统库FWLIB和说明文档README.md等结构完整可直接导入Keil MDK编译运行总大小312KB。已有125人学习下载资源提供可运行的全功能工程框架涵盖IN1–IN4方向控制逻辑、ENA/ENB使能管理、TIM通道PWM占空比动态调节函数以及双电机协同拐弯的典型应用示例是掌握STM32底层驱动与电机控制原理的优质实践素材。 这段时间在折腾正点原子F103核心板的小车底盘手头正好有一块L298N电机驱动模块就把整套驱动逻辑从头到尾写了一遍。折腾完发现这题比想象中更值得拆开讲用C语言控制STM32F103输出PWM再通过L298N驱动直流电机表面上看就是几个GPIO高低电平的事实际做下来牵扯到定时器配置、逻辑电平匹配、电源共地、差速转向算法这些细节。这篇文章我会把完整的驱动思路、接线方式、代码实现和踩坑记录都放出来给同样在玩F103核心板加L298N的朋友一个能直接抄作业的参考。我用的硬件是正点原子F103核心板属于STM32F103C8T6这颗芯片的最小系统板没有外挂底板上那些外设好处是引脚全部引出想接什么接什么坏处是所有东西都得自己动手。L298N是双H桥驱动能同时控两个直流电机小车左右各一个电机就能完成前进、后退、转弯再配合STM32的定时器PWM输出还能实现连续调速。这套组合在智能小车入门里非常经典写明白之后再做巡线、避障、遥控小车底层驱动基本不用再动。1. 项目需求拆解与驱动方案选型1.1 核心板、驱动模块和电机的分工先梳理一下整个链路上每个部件到底干什么。STM32F103核心板负责“决策”它根据代码逻辑输出控制信号L298N负责“执行”把单片机的逻辑信号转换成驱动电机的大电流直流电机负责“出力”产生实际的转动。三者之间需要明确的接口定义否则信号会乱套。L298N内部是两个H桥每个H桥对应一个电机通道命名通常叫A、B通道。每个通道有三个控制引脚IN1、IN2和ENA或者IN3、IN4和ENB。IN1和IN2决定电机转向一高一低正转反过来就是反转两个都是低电平或者都是高电平则停止。ENA是使能端只有这个引脚有效时电机才会转如果把它接到高电平相当于电机全速跑如果给它输入PWM信号就能通过改变占空比控制电机速度。所以驱动逻辑一下子就清晰了方向由IN1、IN2控制速度由ENA的PWM占空比控制。你要让小车前进就把两个通道的IN设置成同一方向PWM给一个速度值要后退把方向电平反过来即可。PWM调速的本质是快速通断电源让电机的平均电压变化从而改变转速。直流电机的转速跟端电压近似成正比这就是PWM调速的基本原理。1.2 为什么拐弯要用差速而不是转向舵机小车拐弯这个问题我说过很多次很多新手第一反应是“加个舵机转向不就行了”。舵机转向适合阿克曼结构也就是前轮转向、后轮驱动的车型。但是两轮驱动、后轮各自带电机的底盘最自然的方案是差速转向。差速转向的原理很简单左右轮转速不一致车就会朝转速低的那一侧转弯。如果左轮停转、右轮正转小车会以左轮为支点原地转圈如果左右轮速度差值小一点小车会划一个较大的弧线转弯。在我这套代码里我同时实现了两种转弯方式一种是不调速的原地转向左右轮一个正转一个反转另一种是平滑差速在前进过程中动态调整两侧PWM占空比实现大半径弧线过弯。选择差速方案的另一个原因是它完全复用电机驱动代码不需要额外的舵机控制逻辑和脉宽映射代码。L298N本身就能驱动双电机天然支持差速控制。你要是用带底盘的成品小车上面已经预留了左右电机接口再额外装舵机反而破坏重心和结构。1.3 为什么非要用PWM而不是直接通断有人会问我用IO直接输出高电平让电机全速转用延时函数控制时间间隔不也能实现“调速”吗比如转200ms停100ms平均速度看起来慢了。这种办法叫通断控制确实能调速但是有两个致命问题一是电机是感性负载频繁通断会产生很大的反电动势尖峰容易干扰单片机工作严重点直接复位二是通断方式下电机实际处于加速、减速不断交替的状态噪音大、发热高、响应迟钝尤其在低速情况下会明显抖动。PWM调速就完全不同。它的开关频率通常在10kHz以上电机在这个频率下由于机械惯性转速不会跟着PWM波形起伏而是稳定在平均电压对应的转速上。电机处于连续平滑的运行状态噪音小、发热低、控制线性度也好。所以PWM并非“看起来高级”而是直流电机调速真实的标准做法。从实现角度看STM32的定时器硬件输出PWM非常方便只要设置好预分频系数、自动重装载值和比较寄存器硬件就会自动在引脚上输出占空比可调的方波完全不需要CPU干预。这也是我选择用定时器硬件PWM而不是用延时翻转IO来实现调速的重要原因。软件模拟PWM在低转速时CPU占用率极高而且精度差实际项目里不推荐。2. 硬件连接与供电设计2.1 L298N引脚功能与接线对照先看L298N模块上的关键引脚。电源部分有三个12V输入、GND、5V输出。12V输入用来给电机供电一般接7到12V的电池组我实际用的是两节18650串联大约7.4V。5V输出是模块内部稳压芯片输出的可以用来给单片机或者其他逻辑电路供电但是要特别注意电流能力很有限大概几十毫安带不动太大的负载。逻辑部分有六个引脚ENA、IN1、IN2、IN3、IN4、ENB。其中IN1到IN4接单片机的GPIOENA和ENB接PWM输出。我选用的引脚分配如下表模块信号核心板引脚说明IN1PB0通道A方向控制IN2PB1通道A方向控制ENAPA6通道A使能接TIM3_CH1 PWMIN3PB10通道B方向控制IN4PB11通道B方向控制ENBPA7通道B使能接TIM3_CH2 PWM这个分配有两个讲究。第一PWM引脚固定用PA6和PA7因为这两个引脚在硬件上映射到TIM3的通道1和通道2不需要重映射省去配置AFIO的麻烦。第二方向控制引脚避开PA13、PA14、PA15和PB3、PB4这几个JTAG/SWD调试占用的引脚否则下载程序的时候会出问题。PB0、PB1、PB10、PB11都是普通IO使用上没有坑。电机输出端有OUT1、OUT2和OUT3、OUT4分别接左右两个直流电机。注意两个电机不要接反否则前进会变成后退到时候方向控制逻辑要反过来调排查起来很浪费时间。建议接线后在轮子上标一下左右第一次测试直接全速前进确认两个轮子转向一致。2.2 供电和共地是第一个大坑L298N模块的供电设计是我在这次调试里踩的最大一个坑。很多朋友把电机电源接到L298N的12V输入然后把单片机用USB单独供电结果发现怎么给IO置高电平电机都没有反应或者偶尔抖一下就停。核心原因是没有共地。单片机输出的逻辑信号是以它自己的GND为参考的L298N电路也是以自己的GND为参考的两个参考地如果不连在一起高电平的参考点就不一致收端根本解读不了这个信号。用万用表量IN引脚电压的时候会发现只有零点几伏波动自然驱动不了。正确做法是把L298N的GND和STM32核心板的GND用导线连在一起让两边有一个统一的参考电位。这一步是所有逻辑信号交互的前提也是嵌入式系统里最基础也是最容易忽略的规则。之后信号线上的高低电平才有了统一标准。电源部分我最终采用了这样的方案电机电源用两节18650锂电串联经过总开关接L298N的12V输入STM32核心板用USB线单独供电或者从L298N的5V输出接到核心板的5V引脚。使用L298N的5V输出给单片机供电时要注意模块内部稳压芯片的发热和电流限制如果你的电机功耗大、驱动发热严重建议还是用单独供电只把GND连起来就好。2.3 3.3V逻辑电平直驱L298N是否可靠正点原子F103核心板的IO电平是3.3VL298N这个模块数据手册上说逻辑输入高电平门槛一般在2.3V左右理论上3.3V是够用的。但实际应用里有个区别不同厂家的L298N模块用料不一样有的板子逻辑部分还加了光耦隔离这就会导致输入阈值发生变化甚至需要更高的驱动电流。我实测下来手上这块普通版L298N直接用3.3V GPIO驱动完全没问题IN1到IN4接到PB0、PB1、PB10、PB11高电平时引脚能稳定拉到3.3VL298N能可靠识别。但要注意控制线和GPIO之间的走线不要过长尽量在20cm以内避免线间电容和串扰导致电平畸变。如果你用的是带光耦隔离的版本光耦输入侧一般需要5到15mA的驱动电流3.3V GPIO可能带不动这时候就需要在L298N的板子上加焊限流跳线或者用输入侧共阳的方式让光耦工作在自己的逻辑电平上。买模块之前先看清楚版本别等到接完线才发现驱动不了。从长远角度看如果以后要换更复杂的项目比如使用更高电压的电机驱动板最好在中间加一级电平转换或者直接选用3.3V逻辑兼容的驱动方案比如TB6612这类专门为单片机设计的驱动芯片内部直接兼容3.3V逻辑输入就不存在电平匹配的问题。但L298N作为入门学习把电平匹配这件事亲自踩一遍其实也很有价值。3. 驱动代码实现从GPIO到PWM3.1 GPIO初始化方向控制引脚配置代码部分我基于正点原子提供的标准外设库工程编写所有初始化函数单独放在motor.c文件里。先看GPIO方向控制引脚的初始化这部分逻辑比较固定就是把PB0、PB1、PB10、PB11配置为推挽输出输出速度50MHz。void Motor_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_10 | GPIO_Pin_11; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); }这里用的是推挽输出模式能够让GPIO在输出高电平时主动拉高到3.3V输出低电平时主动拉低到0V。开漏输出模式在这个场景下不合适因为L298N的逻辑输入引脚需要明确的电平驱动开漏输出还得外加上拉电阻才能得到稳定的高电平白白增加器件和故障点。输出速度设置成50MHz其实不是必须的GPIO翻转PWM的速率远远达不到这么高但保持一致也没问题不会带来副作用。如果走线较长、干扰较大可以把速度降到2MHz试试有可能会改善信号完整性问题。3.2 PWM初始化定时器参数怎么算PWM部分我使用TIM3的通道1和通道2分别对应PA6和PA7。STM32F103的定时器时钟是72MHz这个值在正点原子标准工程里已经通过SystemInit配置好了。要得到10kHz的PWM频率我把预分频系数设为35自动重装载值设为199计算过程如下72MHz除以(35加1)等于2MHz也就是说PWM计数器的计数频率是2MHz每个计数脉冲耗时0.5微秒。再除以(199加1)等于200得到10kHz的PWM频率每个PWM周期是100微秒。占空比分辨率是1/200也就是0.5%控制100%量程时精度足够。void Motor_PWM_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); TIM_TimeBaseStructure.TIM_Period 199; TIM_TimeBaseStructure.TIM_Prescaler 35; TIM_TimeBaseStructure.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM3, TIM_TimeBaseStructure); TIM_OCInitStructure.TIM_OCMode TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse 0; TIM_OCInitStructure.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC1Init(TIM3, TIM_OCInitStructure); TIM_OC2Init(TIM3, TIM_OCInitStructure); TIM_OC1PreloadConfig(TIM3, TIM_OCPreload_Enable); TIM_OC2PreloadConfig(TIM3, TIM_OCPreload_Enable); TIM_ARRPreloadConfig(TIM3, ENABLE); TIM_Cmd(TIM3, ENABLE); }PA6和PA7配置为复用推挽输出也就是GPIO引脚的控制权交给片上外设由TIM3硬件来控制引脚输出波形。这里如果配置成普通推挽输出定时器是没法把波形送到引脚上的这是新手特别容易犯的错误之一。为什么选10kHz而不是1kHz或20kHz1kHz以下音频范围内电机线圈会产生明显的啸叫声听起来很刺耳而且电流纹波大电机发热会比较明显。20kHz以上已经超出人耳听觉范围但L298N这个模块的开关损耗会增大驱动芯片容易发烫。10kHz是一个平衡点噪音低、损耗适中、占空比分辨率也够用。3.3 电机控制接口正转、反转、停止和调速有了GPIO和PWM输出之后核心就是控制接口。我把每个基本动作封装成独立函数这样主函数看起来非常简洁逻辑也清晰。定义方向引脚操作宏避免在代码里到处写位操作。#define IN1_0 GPIO_ResetBits(GPIOB, GPIO_Pin_0) #define IN1_1 GPIO_SetBits(GPIOB, GPIO_Pin_0) #define IN2_0 GPIO_ResetBits(GPIOB, GPIO_Pin_1) #define IN2_1 GPIO_SetBits(GPIOB, GPIO_Pin_1) #define IN3_0 GPIO_ResetBits(GPIOB, GPIO_Pin_10) #define IN3_1 GPIO_SetBits(GPIOB, GPIO_Pin_10) #define IN4_0 GPIO_ResetBits(GPIOB, GPIO_Pin_11) #define IN4_1 GPIO_SetBits(GPIOB, GPIO_Pin_11) void Motor_SetSpeed(uint16_t speedA, uint16_t speedB) { if(speedA 199) speedA 199; if(speedB 199) speedB 199; TIM_SetCompare1(TIM3, speedA); TIM_SetCompare2(TIM3, speedB); } void Motor_Forward(uint16_t speed) { IN1_1; IN2_0; IN3_1; IN4_0; Motor_SetSpeed(speed, speed); } void Motor_Backward(uint16_t speed) { IN1_0; IN2_1; IN3_0; IN4_1; Motor_SetSpeed(speed, speed); } void Motor_TurnLeft(uint16_t speed) { IN1_1; IN2_0; IN3_0; IN4_1; Motor_SetSpeed(speed, speed); } void Motor_TurnRight(uint16_t speed) { IN1_0; IN2_1; IN3_1; IN4_0; Motor_SetSpeed(speed, speed); } void Motor_Stop(void) { IN1_0; IN2_0; IN3_0; IN4_0; TIM_SetCompare1(TIM3, 0); TIM_SetCompare2(TIM3, 0); }这里用了两个速度参数因为在实际运行中左右两个电机不可能完全对称电机制造公差、轮胎摩擦差异、负载分布都会导致同样的占空比产生不同的转速。如果这时候还让两边跑一样的PWM值小车就会走偏。所以我在函数设计里保留了同时设置左右轮速度的接口方便后续加入偏差校正逻辑。针对“拐弯”这个需求除了标准的原地左右转之外我还封装了一个差速转弯函数用于实现在行进中画出不同半径的弧线。思想和前面讲的一样给左右轮不同的速度值差值越大转弯半径越小。void Motor_Curve(uint16_t baseSpeed, int16_t diff) { int16_t speedL baseSpeed diff; int16_t speedR baseSpeed - diff; if(speedL 0) speedL 0; if(speedR 0) speedR 0; if(speedL 199) speedL 199; if(speedR 199) speedR 199; IN1_1; IN2_0; IN3_1; IN4_0; Motor_SetSpeed((uint16_t)speedL, (uint16_t)speedR); }diff为正时左轮快右轮慢车向右拐diff为负时左拐。基础速度和差值配合起来就能模拟出类似汽车打方向盘小幅转向的效果比原地转向要顺滑很多。这套函数接口写完之后不管以后接巡线模块还是蓝牙遥控只需要在业务逻辑里调用这些接口就行了。3.4 主函数演示前进、后退、拐弯、调速的完整流程最后在主函数里把这套驱动串起来。我用了一个简单的状态机让小车依次执行前进、后退、左转、右转、差速弧线转弯和停止每个动作持续一段时间。这里用正点原子的Delay函数产生延时代码直观方便验证硬件接线是否正确。int main(void) { delay_init(); Motor_GPIO_Init(); Motor_PWM_Init(); while(1) { Motor_Forward(120); delay_ms(2000); Motor_Backward(120); delay_ms(2000); Motor_TurnLeft(150); delay_ms(1000); Motor_TurnRight(150); delay_ms(1000); Motor_Curve(120, 60); delay_ms(2000); Motor_Stop(); delay_ms(1000); } }第一次上电测试建议先把速度值调小一些比如80同时把小车架起来让轮子悬空避免突然全速冲击撞到东西。确认每个动作都符合预期后再放到地上跑。如果发现小车后退时其实是前进或者左转右转方向相反不用改代码交换同一通道的两根电机线就行。完整源文件结构就是motor.c和motor.hmain.c里调用初始化函数和状态机。把正点原子工程模板里的SYSTEM文件夹保留motor相关文件加进去编译下载就能跑。这是我这次实现最精简也最清晰的代码划分后续要加蓝牙串口或者红外避障也只需要在main.c的业务逻辑层加内容驱动层不需要再动。4. 常见问题与实测排查技巧4.1 电机不转但能听到电流声这是最常见的故障现象代码逻辑看着没问题PWM输出也测量到了但电机就是不动。我遇到这个问题的原因是L298N的ENA和ENB没有接好。有的模块ENA和ENB默认有跳线帽把引脚拉到了高电平这时候IN的控制才有效。如果你跳线帽摘掉了又没有在代码里把对应IO口拉高电机自然就不转。排查方法很简单用万用表直流电压档量ENA引脚对地电压如果量程正常应该在3.3V左右。没有万用表的话可以直接在代码里把ENA和ENB都接高电平用飞线短接如果电机转了说明问题出在PWM配置上再回头查定时器初始化。还有一种情况是PWM已经输出但占空比太小。电机的启动需要克服静摩擦和惯性占空比太低时平均电压不足以让电机转起来只会发出嗡嗡声。我把最低启动占空比测试过在这套电源和电机组合下大概占空比超过8%才会稳定转动低于这个值就表现为静止加电流声。所以排查时可以把速度值调到比较高的位置比如150先确认电机能转再回头找最小启动值。4.2 只能正转不能反转如果你的小车能前进但不能后退或者某个电机只能朝一个方向转大概率不是硬件坏了而是控制逻辑里有两个引脚被错误置成了同一电平导致H桥两侧同时导通电机处于刹车状态。注意L298N的输入组合里IN1和IN2同为高或同为低时通道输出关闭或者刹车并不会反转。要实现反转必须把IN1和IN2高低电平对调。我在代码里写的是通过宏定义设置引脚电平前后逻辑非常直观但如果你自己改过代码很容易出现两个控制脚一直保持同样状态的问题。硬件上也有一个容易忽略的地方如果某个IN引脚虚焊或者杜邦线接触不良比如IN2实际上悬空那么高电平的IN1会被内部逻辑识别为两个高电机同样不转。我排查时习惯拿万用表毫伏档直接量L298N的IN引脚确认每个引脚在动作切换时电压有明确变化这样能快速缩小问题范围。4.3 一启动电机芯片就复位这个现象我在做四轮小车的时候遇到过。代码刚下载完按下复位键一切正常但只要给电机上电核心板立刻重启或者死机。归根结底是电源扛不住电机启动电流而单片机又和电机共用了同一条电源路径。电机启动瞬间电流很大尤其是空载到全速的变化过程电流冲击会导致电源电压瞬间跌落。如果单片机从同一路电源取电电压掉到芯片的欠压复位阈值以下就会触发复位。解决办法有几种第一电机和单片机分开供电只把GND共地第二在电机电源两端并联一个大容量电解电容比如470uF到1000uF吸收瞬态尖峰第三在单片机电源输入端加上电容滤波容纳短时压降。我在最后方案里选了电机用电池组、单片机用独立稳压电源供电的方式效果最稳定。另外还要注意L298N模块本身的散热大电流工作一段时间后芯片会非常烫如果烫到不能摸说明电机堵转或者PWM频率过低导致开关损耗大需要从负载端找原因。4.4 PWM频率、占空比和电机噪声的取舍PWM参数设置虽然看起来只是几个数字但实际体验下来很有讲究。频率太低会啸叫太高则L298N发热增加而且占空比分辨率会下降。我最终采用的10kHz频率是经过实测后觉得比较均衡的方案。占空比范围上ARR设成199意味着占空比粒度是0.5%。有些教程喜欢设成999或9999分辨率更高但是频率会被拉低。如果要保持10kHz又想要更高的占空比分辨率就得引入定时器主从结构或者用高级定时器的重复计数功能对入门项目来说没有太大必要。0.5%的粒度在实际电机控制里已经足够平滑了。电机噪声还有一个来源是PWM频率和机械结构共振。如果小车底盘车架或者车轮在某个转速下产生明显共振可以适当微调PWM频率避开共振点或者在电机安装位置加橡胶垫减震。我实测在10kHz附近没有特别明显的共振但不同车架情况不同这个需要自己试。4.5 用示波器验证PWM波形的心得如果手头有示波器调试起来会轻松很多。把探头夹在PA6引脚上地线夹到GND就能直接看到10kHz的方波占空比随代码中speed参数变化。没有示波器的朋友可以用一个LED串联电阻接到PA6上LED亮度随占空比变化也能粗略判断PWM是否输出正常。我还做过一个更土的办法把一个小喇叭或蜂鸣器接在PA6和GND之间PWM频率是10kHz时听不到声音若改成较低频率就能听到音调变化。这种方式虽然不容易精确测量占空比但至少能快速确认定时器有没有在工作适合手边没有仪器的场景。最后再分享一个我一路调下来最深的体会给这类驱动模块写代码时最花时间的往往不是代码本身而是硬件连接和电源稳定性。代码无非就是GPIO和定时器的排列组合把各部件电平逻辑理顺了功能自然就通了。我建议新手朋友们先把小车架起来空转调试摸清每个电机的最低启动占空比、左右轮一致性差异然后再放到地上跑那时候调转向和调速才会有参照。我这次把差速转弯的参数写在代码里反复调就是因为左右轮实际速度不一致占空比一样但车会跑偏后来在Curve函数里加入速度补偿才实现了比较直线的前进。这套调参思路放到巡线、避障项目里一样适用驱动层写好了后面加什么功能都轻松。本文还有配套的精品资源点击获取