简介本资源是面向嵌入式初学者与APM32E1系列单片机开发者的定时器实践工程包聚焦基本定时器的底层驱动实现与中断应用解决定时精度配置、计数模式选择、中断服务响应等典型开发痛点适用于实时控制、LED闪烁、脉冲触发等典型嵌入式场景。压缩包共78个文件264KB含39个头文件.h定义外设寄存器与API接口33个源文件.c实现标准外设驱动、BSP板级支持、中断向量表及主程序逻辑另有启动文件.s、Keil工程配置.uvprojx/.uvoptx、固件镜像.hex和说明文档.txt目录结构完整覆盖CMSIS、StdPeriphDriver、User应用层三级架构。已有188人学习下载提供可直接编译运行的完整MDK-ARM工程包含预配置的1秒LED定时翻转示例、清晰的中断服务例程ISR模板及apm32e10x_int.h/c中断初始化框架助开发者快速掌握时钟分频、计数周期设定与中断使能全流程。1. APM32E103这颗料为什么值得用基本定时器负责干什么1.1 从国产替代到性能升级APM32E103的定位这几年做嵌入式项目很多人会面临同一个问题原方案里的STM32F103缺货、涨价或者出于供应链安全考虑必须做国产替代。APM32E103就是在这个背景下被频繁提到的型号。我第一次拿到这颗芯片的评估板时第一反应是“这不就是F103的翻版吗”但翻完数据手册才发现事情没那么简单。它虽然引脚、外设布局和STM32F103高度兼容但内核主频直接干到了120MHz比F103的72MHz高了接近一倍Flash和SRAM的容量也更大。这意味着你以前写的STM32F103标准外设库代码不用大改就能跑起来同时还能享受到更高的主频、更大的存储空间。对于老项目的降本升级或者新项目的选型这个诱惑力是很大的。极海这颗料主打的就是“兼容中带提升”而不是简简单单的仿制品。APM32E103的定时器、串口、ADC、CAN、USB这些外设模块在寄存器布局和中断向量设计上基本对齐了F103因此从F103迁移过来的学习成本很低但每个外设又都有一些自己的小脾气比如外设命名用的是TMR而不是TIM时钟使能函数是RCM开头的这些细节不提前踩一遍很容易让你在移植时白耗一个晚上。我写这篇文章就是想把APM32E103的基本定时器从原理到代码完整梳理一遍。不管你是第一次接触极海单片机还是已经从STM32切过来但还没把定时器跑熟这篇文章都能让你少走弯路。1.2 基本定时器TMR6/TMR7的定位没有引脚也能撑起一片天很多人刚接触定时器时会把注意力放在PWM输出、输入捕获这些带引脚的外设功能上觉得基本定时器“啥都不能干”。这个观点不全面。APM32E103里的基本定时器有TMR6和TMR7它们确实没有外部引脚不能输出PWM也不能做输入捕获但它们的作用恰恰是很多系统里最刚需的那部分产生精准的时间基准。你可以用TMR6产生1ms中断然后在这个中断里做LED闪烁、按键扫描、任务调度心跳、超时计数。操作系统的tick、协议栈的超时计时器、传感器数据采集的采样节拍全部可以挂在这个时基上。和通用定时器相比基本定时器的寄存器少、配置简单、没有乱七八糟的捕获比较通道反而更不容易出错。我实测下来TMR6的定时精度完全可以满足绝大多数业务逻辑对时间基准的要求只有在做高频PWM或电机控制这类需要IO输出的场景时才需要动用通用定时器或高级定时器。所以基本定时器是一个项目里“少说话多干活”的角色。它不像串口那样有收发数据的成就感也不像PWM那样能看到波形变化但整个系统的时序骨架全靠它撑着。把TMR6的时基跑稳了后面写任务调度、写协议解析、写传感器驱动都会顺手很多。1.3 这套代码能直接覆盖的APM32E1系列范围标题里写了“支持APM32E1系列单片机”这绝不是噱头。APM32E103、APM32E102、APM32E101这几个型号虽然Flash、SRAM、外设数量有差异但TMR6/TMR7基本定时器模块的设计是一致的。也就是说你在APM32E103上验证通过的定时器初始化代码、中断处理逻辑直接换到APM32E102或者APM32E101的工程里代码层面不需要动改一下芯片型号配置就能编译通过。这一点在做产品系列化开发时特别有价值。同一个代码仓库通过宏定义区分不同型号换一颗不同Flash大小的芯片就能覆盖低端到高端的多个SKU。TMR6因为不占用引脚连硬件设计上的PinToPin兼容都不用操心。所以这篇文章里的代码你可以放心作为整个E1系列的基础时基驱动来积累后面每个项目直接复用即可。2. 从零准备开发环境PACK、库文件、调试器一个都不能错2.1 Keil MDK下安装APM32E1xx设备支持包开发APM32E103我首选还是Keil MDK毕竟绝大多数从STM32转过来的工程师最熟悉的就是这个IDE。新建工程前第一件事是装极海官方的设备支持包。在Keil的Pack Installer界面里搜APM32能看到极海官方的APM32E1xx系列DFP包安装后设备列表里就会出现APM32E103系列的具体型号。这里有一个容易踩的坑APM32E103在Pack里分了很多具体型号比如APM32E103VET6、APM32E103RBT6、APM32E103CBT6后缀里V/R/C区分引脚数量E/B区分Flash大小。选型时一定要和你手里的芯片丝印完全对应如果选错虽然编译也能过但下载后可能会因为Flash容量信息不匹配导致调试异常。还有一种情况是网站直接提供了百度网盘或者官网下载链接的离线PACK安装方式一样双击即可。如果你不想用Keil极海官方SDK也提供了IAR的工程模板甚至还可以用STM32CubeMX生成F103的工程后手动改外设库文件来适配APM32。不过对于大多数项目来说Keil MDK加官方SDK是最省心的组合。我建议新项目直接从官方SDK的Template工程开始改而不是自己手搓一个空工程因为SDK里已经配好了启动文件、系统时钟初始化代码和标准外设库的完整目录结构省去很多基础配置的时间。2.2 Flash算法与调试器配置设备支持包装好之后板上调试器和下载算法的配置是下一个容易翻车的点。如果你用的是CMSIS-DAP或者DAPLink先在Options for Target的Debug页面选择CMSIS-DAP Debugger然后进入Settings在Flash Download页面里检查Programming Algorithm列表里有没有APM32E103对应的Flash算法文件。正常情况下安装极海的PACK后Flash算法会自动关联好。但如果你是从STM32工程改过来的Keil可能还保留着STM32F10x的Flash算法这时候下载时就会报错或者明明显示下载成功板子跑起来却完全没反应。解决方法是把Flash Download里的算法列表清空然后点Add从列表里选择APM32E103对应的算法。如果你用的是J-Link原理一样只是调试器选成J-LINK/J-TRACE Cortex即可。另外有一点要提醒APM32E103的调试接口默认是SWD如果你板子上只引了SWDIO和SWCLK两个引脚连接时记得把Reset选项配置为硬件复位。有些低功耗设计里软件复位容易导致下载器识别不到芯片设置成硬件复位能解决大部分连接失败的问题。我调试APM32E103的过程中遇到过几次“No Target connected”的报错最后都是靠这个设置解决的。2.3 极海标准外设库的目录结构和关键文件极海的SDK结构和STM32标准外设库非常相似。核心目录里有CMSIS、Device、StdPeriph_Driver对应的源文件后缀和命名习惯也非常接近区别在于外设前缀从STM32的“STM32F10x”变成了“APM32E1xx”库函数前缀从“XXX_”变成了“RCM_”、“TMR_”、“GPIO_”这种风格。拿到SDK后建议先打开APM32E1xx.h这个头文件浏览一下外设基地址定义和中断向量表。你会发现TMR6的基地址和你在STM32F103里看到的TIM6是一样的中断向量名却换成了TMR6_IRQHandler。这个细节对后面写中断服务函数非常关键一旦写错名字编译器不会报错但中断永远进不去。我建议把SDK里所有TMR开头的库函数名扫一遍心里有个大概印象后面写代码查起来就快很多。3. 时钟树分析定时器时钟为什么不是简单的APB13.1 从外部晶振到TMR6的完整时钟链路很多人写定时器代码时最头疼的不是怎么配寄存器而是“我到底该用多少频率来计算分频系数”。如果你直接拿主频120MHz去算而不去管APB1分频和定时器倍频的关系算出来的定时时间必然不对。APM32E103的时钟树大致是这样的外部高速晶振HXTAL经过PLL倍频得到系统时钟SYSCLKSYSCLK经过AHB预分频得到HCLKHCLK再经过APB1预分频得到APB1外设时钟而TMR6的时钟源是从APB1这个节点上再单独引出来的一路这一路在APB1分频系数不等于1的时候会自动翻倍。这里的“自动翻倍”是ARM Cortex-M3内核里的经典设计目的是让定时器即使挂在低速外设总线上依然能获得较高的计数频率。如果你在APM32E103上把主频配成120MHzAHB不分频APB1设置为2分频那么APB1总线上外设的时钟是60MHz但TMR6的时钟会是120MHz。这一点和STM32F103完全一致区别只在于F103的主频是72MHz所以APB1为2分频时定时器时钟是72MHz。理解这层关系后再去算PSC和ARR就不会懵了。我在帮群友排查定时器问题时就发现很多人的错误都是把TMR6时钟源直接当成APB1上的60MHz来用结果所有定时时间都慢了一倍。文章后面我会给一个完整推导你可以对照着自己算一遍。3.2 APB1分频系数为2时定时器时钟翻倍的原理为什么APB1分频后定时器时钟反而翻倍你可以这样理解APB1总线上的大多数外设比如串口、I2C、DAC它们的工作频率不需要太高60MHz已经够用了所以APB1被配置成2分频以降低功耗。但定时器需要一个比较高且稳定的计数时钟如果直接让定时器也用60MHz在很多场景下分频粒度会不够精细所以芯片内部为定时器单独加了硬件逻辑当APB1的预分频系数大于1时定时器时钟源自动乘2等于“补偿”回系统时钟的频率。这个补偿不是软件做的而是硬件电路自动完成的。你不需要写任何代码去开启这个倍频只需要在计算PSC和ARR时把定时器时钟按“APB1时钟的2倍”代入即可。我见过一些初学者查到了这个规律但不确定自己的分频配置到底是不是“大于1”于是把PSC和ARR算来算去都对不上。这里分享一个小技巧直接看你的RCM配置代码里APB1的分频宏如果是RCM_APB1_DIV2那定时器时钟就是SYSCLK的1倍如果是RCM_APB1_DIV1那定时器时钟就是APB1本身的频率不需要翻倍。3.3 超时时间的计算公式与两套参数示例基本定时器的计数逻辑是内部时钟经过PSC预分频后得到一个计数频率然后计数器从0开始往上加加到ARR设定的值后溢出产生更新事件。换成人话就是“一秒想分成多少份、每份数到多少由PSC和ARR一起决定”。计算超时时间的核心公式是定时时间 (PSC 1) × (ARR 1) / TMR时钟频率拿APM32E103跑120MHz、APB1 2分频、TMR6时钟120MHz来举例目标1ms中断设PSC为119那么计数频率是120MHz / 120 1MHz即每1微秒计一个数再设ARR为999那么计数器从0加到999一共1000次耗时1000微秒正好1ms。目标1s中断设PSC为11999那么计数频率是120MHz / 12000 10kHz即每0.1毫秒计一个数再设ARR为9999那么10000次计数耗时1秒。这里有个实际限制要记住PSC和ARR都是16位寄存器最大值65535。如果你想让定时器单次溢出就能达到一个很长的超时时间比如10秒那就需要把PSC和ARR都往大了设。如果实在超出65535方法有几种把PSC调到最大或者让定时器产生多次中断后再累加计数也就是用软件变量做溢出次数翻倍。我在项目里做几十分钟的系统看门狗喂狗超时时就是用“定时器1秒中断 软件累计次数”的方式实现的效果非常稳定。4. TMR6初始化与中断处理的完整实现4.1 基于标准外设库的初始化流程配置TMR6我的习惯是严格按照“开启外设时钟、配置时基结构体、使能更新中断、使能定时器、配置NVIC”五步走。这套流程和STM32标准外设库几乎一样只要把函数名前缀换成TMR即可。第一步是开启TMR6的外设时钟SDK里的函数是RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_TMR6)。这行代码千万别漏如果漏了后面所有寄存器操作都不会生效计数器根本不跑。第二步是定义TMR_TimerBaseConfig_T结构体变量或者你手上SDK里的同名结构体然后依次填入分频系数和自动重载值。实际的赋值代码类似下面这样TMR_TimerBaseConfig_T timerBaseStruct; timerBaseStruct.clockDivision TMR_CLOCK_DIV_1; timerBaseStruct.countMode TMR_COUNTER_MODE_UP; timerBaseStruct.division 119; // PSC timerBaseStruct.period 999; // ARR timerBaseStruct.repetitionCounter 0; TMR_ConfigTimerBase(TMR6, timerBaseStruct);第三步是使能更新中断调用TMR_EnableInterrupt(TMR6, TMR_INT_UPDATE)。第四步调用TMR_Enable(TMR6)或者TMR_EnableAutoReload(TMR6)让计数器开始跑。第五步配置NVIC调用NVIC_EnableIRQ(TMR6_IRQn)并设置优先级。这里有一个小细节极海SDK里NVIC的优先级分组和STM32一样需要在main函数早期调用NVIC_PriorityGroup_Config(NVIC_PRIORITY_GROUP_2)之类的函数。如果不分组中断优先级设置可能不生效但对基本定时器这种单一中断来说影响不大你只需要保证优先级数值在合理范围内即可。4.2 中断服务函数与标志位处理中断服务函数的名字必须和启动文件里的向量表完全一致APM32E103上TMR6对应的中断服务函数叫TMR6_IRQHandler。这里和STM32F103里的TIM6_IRQHandler只有前缀不同但往往就是这一字之差让很多人掉进坑里。函数内部第一件事是判断更新中断标志位是否置位判断完再处理用户逻辑最后一定要记得清除中断标志位。一个典型的1ms中断处理函数如下void TMR6_IRQHandler(void) { if (TMR_ReadStatusFlag(TMR6, TMR_STATUS_FLAG_UPDATE) SET) { TMR_ClearStatusFlag(TMR6, TMR_STATUS_FLAG_UPDATE); ToggleLED(); SystemTick; } }为什么先判断标志位再清标志位因为如果不清除标志位中断会不断重复进入导致CPU被这个中断完全占住。而如果不判断就直接清在多中断源共用同一个中断服务函数的情况下可能会误清其他中断的标志位。虽然TMR6基本定时器只有一个更新中断源但养成“先判后清”的习惯总没错。4.3 用GPIO翻转验证1ms时基代码写好了怎么确认定时器真的按1ms在跑最直观的方法就是搞一个GPIO口在中断里翻转电平然后用示波器看方波频率。如果你每进入一次中断就翻转一次引脚那么引脚输出的方波周期应该是2ms频率500Hz。GPIO部分的初始化和STM32类似只是函数名同样要换成极海SDK的命名风格。你可以把LED接在PB0上翻转函数里调用GPIO_TogglePin(GPIOB, GPIO_PIN_0)。看到方波周期是2.00ms说明定时器和计算完全吻合如果看到的是4.00ms或者1.00ms那就要回头检查PSC和ARR是不是算错了或者定时器时钟频率代入错了。这个验证方法虽然土但非常有效。我每次新换一颗芯片或者新写一个定时器驱动都会先点个灯或者测个方波确认时基对了再往上堆业务逻辑。时基不对后面所有依赖延时的代码都会跟着错到时候排查问题的成本会成倍增加。5. 实测中踩过的坑从中断不触发到计数频率翻倍5.1 中断不触发的排查链路在APM32E103上移植或新写TMR6驱动最容易遇到的问题就是“定时器配置好了但中断就是不进来”。我自己的排查链路是这样的。第一步查外设时钟看RCM_EnableAPB1PeriphClock(RCM_APB1_PERIPH_TMR6)有没有执行。如果外设时钟没开定时器寄存器写什么都没反应。第二步查NVIC看中断服务函数有没有使能。NVIC_EnableIRQ(TMR6_IRQn)这一句漏掉或者放在系统初始化之前执行被后续代码重置都会导致中断不触发。第三步查中断服务函数名字。如果编译器没有把这个函数链接到中断向量表里函数永远不会被调用。你可以在这个函数里打断点如果断点没被命中大概率是函数名和启动文件里的向量名对不上。第四步查更新标志位。如果你在初始化阶段已经调用过TMR_ReadStatusFlag来清标志位注意不要在还没使能定时器之前就把标志位状态搞乱。基本定时器的更新标志位在使能后应该能正常置位如果始终为RESET说明计数器根本没跑起来那就要检查TMR_Enable有没有调用。最后一步是在调试器里实时看TMR6的寄存器值。如果CNT寄存器始终不动说明时钟链路或使能位有问题如果CNT在快速累加但中断不触发说明中断使能位或NVIC配置有问题。按这个链路走下来基本没有排查不出来的定时器中断问题。5.2 从STM32F103移植时容易翻车的命名差异因为APM32E103和STM32F103高度兼容很多人习惯直接把旧工程里的文件复制过来然后把芯片型号改成APM32E103就以为完事了。结果编译报一堆错。问题多半出在库函数命名上。极海把TIM前缀全部换成了TMR所以TIM_TimeBaseInit要改成TMR_ConfigTimerBaseTIM_Cmd要改成TMR_Enable。RCC前缀换成了RCM所以RCC_APB1PeriphClockCmd要改成RCM_EnableAPB1PeriphClock。GPIO相关的结构体类型名也可能有差异需要对照SDK头文件逐个改。这里我建议先别急着全局替换因为ST和极海的库函数名虽然有规律但参数类型和结构体成员并不完全一一对应。更好的做法是新建一个极海SDK的Template工程把原有的应用层代码按模块迁移进来底层驱动全部重写。这样做迁移工作量看起来大一点但能彻底避免“感觉兼容结果暗中埋雷”的尴尬。5.3 下载失败与Flash算法不匹配的处理还有一种情况代码写得没问题但下载时Keil直接报错。如果你是从STM32工程改过来的十有八九是Flash算法还是STM32F10x的。解决办法前面讲过就是把Flash Download里的算法替换成APM32E103的。如果下载器型号识别不到先确认SWDIO和SWCLK两个引脚没有被复用成GPIO。比较常见的场景是之前某个程序把这两个引脚配置成了普通IO导致第二次下载时连接不上。处理方法是按住板子复位键在点击Download的瞬间松开或者把调试器配置里的Reset选项改成hardware reset让下载器强制拉低复位引脚再连接。下载成功但代码跑不起来的另一个隐藏原因是启动文件和新芯片不匹配。如果用STM32F103的启动文件去跑APM32E103SystemInit里对时钟的初始化可能还是72MHz的配置。虽然也能跑但120MHz的芯片只跑了72MHz性能优势完全没发挥出来。正确的做法是确认工程里的启动文件、系统时钟初始化文件都来自极海SDK这样默认就能把主频配置到120MHz后面定时器计算也才能和这篇文章里的参数对上。5.4 用TMR6作为整个系统的时基后再谈复用TMR6跑通以后你会发现这套代码的价值远不止一个1ms中断。它完全可以作为整个系统的统一时基在中断里维护一个毫秒计数值然后为不同业务模块提供“每N毫秒执行一次”的调度逻辑比如10ms按键扫描、50ms传感器采样、100ms状态上报。这样做的好处是每个模块不需要自己单独开定时器系统里只有一个基本定时器在跑逻辑清晰资源占用也少。我建议把TMR6初始化封装成一个独立驱动文件比如tmr6_drv.c对外提供TMR6_Init、TMR6_GetTick、TMR6_DelayMs这几个函数。后面不管换到APM32E103还是APM32E102这个文件直接搬过去只需要核对主频配置是否一致即可。实测下来这套驱动的稳定性和可维护性都很好。最后再分享一个技巧如果你手头只有逻辑分析仪没有示波器也可以用GPIO翻转加逻辑分析仪测量方波周期效果一样。测的时候把采样率调高一点能够得到比较精确的周期数据。把TMR6时基调准了后面做串口超时判断、协议解析、系统调度都会顺畅很多。本文还有配套的精品资源点击获取