1. 从“单次触发”到“精准控制”：为什么你需要单脉冲模式？

在嵌入式开发里，定时器是我们最熟悉的老朋友，从简单的延时、PWM输出，到复杂的编码器接口、输入捕获，几乎无处不在。但很多时候，我们需要的不是周期性的“心跳”，而是一次精准的“脉搏”。比如，你想精确控制一个继电器的吸合时间，或者驱动一个步进电机走完一个固定步数后立即停止，又或者为某个传感器生成一个宽度和延迟都严格可控的触发脉冲。这时候，周期性输出模式就显得“过剩”了，你需要的是定时器的“单脉冲模式”。

GD32H7作为GD32系列的高性能代表，其定时器功能非常强大，单脉冲模式更是其精准定时能力的集中体现。但说实话，我第一次接触这个模式时，也被它的寄存器配置绕得有点晕。官方手册的描述固然严谨，但缺少一种“手把手”的实操感。很多教程要么只给库函数代码，要么只讲理论，一旦遇到寄存器配置细节或者实际调试中的波形异常，就让人无从下手。

这篇文章，我就结合自己最近在一个激光测距模块驱动项目中的实际应用，来彻底拆解GD32H7定时器的单脉冲模式。我们不依赖HAL库或标准外设库，直接深入到寄存器层面，搞清楚每一个配置位的意义，以及它们如何协作，最终输出一个你想要的、分毫不差的单脉冲。你会发现，当你理解了寄存器，所谓的“模式”不过是一系列逻辑状态的组合，一切都会变得清晰可控。

2. 单脉冲模式的核心逻辑：它到底是怎么“想”的？

在深入寄存器之前，我们必须先建立正确的认知模型。单脉冲模式，顾名思义，就是定时器在触发一次后，输出一个宽度可调的单次脉冲，然后自动停止。但这里的“触发”和“宽度”具体指什么？GD32H7的单脉冲模式实现，核心依赖于其“从模式”控制器与输出比较单元的联动。

你可以把它想象成一个精心设计的“一次性发射装置”。这个装置有两个关键参数需要你设定：

1. 延迟时间：从收到“发射”指令（触发信号），到实际打出“子弹”（脉冲开始沿）之间的等待时间。
2. 脉冲宽度：“子弹”飞行（脉冲保持高电平或低电平）的持续时间。

在GD32H7的定时器里，这个“发射指令”可以是软件触发（你写1到某个位）、外部引脚的电平变化、或者其他定时器的信号。而“延迟时间”和“脉冲宽度”这两个时间参数，则分别由两个捕获/比较寄存器来定义。

具体的工作流程，我画了一个简单的思维图来帮助理解：

[触发事件到来] --> 启动计数器CNT从0开始计数 | |---> 当 CNT 达到“延迟时间”设定值 --> 翻转输出电平（脉冲开始） | （通常由比较寄存器CCRx设定） | |---> 当 CNT 达到“延迟时间+脉冲宽度”设定值 --> 再次翻转输出电平（脉冲结束） | （通常由自动重载寄存器ARR设定） | |---> 计数器在ARR处停止（单脉冲模式标志位生效）

关键点在于：脉冲的“开始”和“结束”这两个动作，本质上是输出比较模块在特定计数值点对输出电平的两次翻转。而单脉冲模式逻辑，则确保了在第二次翻转（脉冲结束）后，计数器会自动停止，并且相关的使能位会被硬件清除，为下一次触发做好准备。

所以，配置单脉冲模式，实质上就是配置一个“一次性”的PWM输出，并在输出完成后自动刹车。理解这一点，再看寄存器配置就不会觉得零散了。

3. 寄存器层级的庖丁解牛：关键寄存器配置详解

GD32H7的定时器寄存器数量众多，但对于单脉冲模式，我们只需要重点关注其中的几个。这里我以通用定时器TIMERx（例如TIMER1）为例进行说明。请随时对照你的芯片参考手册。

3.1 时基单元配置：设定时间的“尺子”

任何定时器操作的基础都是时基。它决定了计数器计一个数所代表的时间长度。

• TIMERx_CTL0 (控制寄存器0)：这是主控制寄存器。

  • CEN位 (Counter Enable)：切记，在单脉冲模式下，我们通常不应该在初始化时直接软件使能CEN。单脉冲模式的启动应由触发信号来控制。初始配置时CEN应为0。
  • DIR位 (Direction)：计数方向。对于单脉冲模式，我们通常使用向上计数（DIR=0）。计数器从0开始，计数到ARR值后停止。
  • SPM位 (Single Pulse Mode)：单脉冲模式使能位，这是核心！必须将其置1，才能启用单脉冲模式功能。

• TIMERx_PSC (预分频器寄存器)：这个寄存器设定对定时器时钟（CK_PSC）的分频系数。如果系统主频是200MHz，你希望计数器每1us计一个数，那么PSC应配置为(200MHz / 1MHz) - 1 = 199。计算时注意，写入的值是分频系数减一。

• TIMERx_CAR (自动重载寄存器)：这个寄存器在单脉冲模式中扮演了双重角色。

  1. 定义计数周期上限：在向上计数模式下，CNT计数到CAR值就会发生更新事件。
  2. 定义脉冲结束点：在单脉冲模式下，CAR的值决定了“延迟时间+脉冲宽度”的总时间点。当CNT计数到CAR时，不仅会产生更新事件，还会触发输出电平的第二次翻转（结束脉冲），并导致计数器停止。

注意：很多新手会混淆，认为脉冲宽度就是CAR的值。不对！脉冲宽度是(CAR - CCRx)对应的时长。CCRx决定了脉冲开始（第一次翻转），CAR决定了脉冲结束（第二次翻转）。

3.2 输出比较配置：定义脉冲的“起”与“伏”

单脉冲的输出通常通过某个通道（如CH0）实现，因此需要配置该通道为输出比较模式。

• TIMERx_CHCTL0/2 (通道控制寄存器)：以CH0为例，其配置在TIMERx_CHCTL0的低8位。

  • CH0MSEL[1:0] (Channel 0 Mode Selection)：设置为01，表示将通道配置为输出模式。
  • CH0COMCTL[2:0] (Channel 0 Compare Output Control)：这是输出比较行为的关键控制位。对于单脉冲模式，我们需要它执行“翻转”操作。
    • 通常我们将其配置为011（PWM模式1）或100（PWM模式2），但这两种模式是周期性输出的基础。在单脉冲模式下，更底层的配置是结合“强制输出”和“比较匹配时翻转”来实现的。一种常见且清晰的配置方法是：将CH0COMCTL设为000（冻结，输出不受比较匹配影响），然后通过从模式和事件生成来控制翻转。但更直接利用硬件单脉冲逻辑的方法是配置为PWM模式，然后由单脉冲模式硬件管理其单次性。
  • CH0COMSEN (Channel 0 Compare Output Shadow Enable)：建议置1，使能预装载功能，确保参数更改在更新事件时才生效，避免写入时产生毛刺。

• TIMERx_CH0CV (通道0捕获/比较值寄存器)：这个寄存器至关重要！它存储的值（CCR0）就是上文提到的“延迟时间”对应的计数值。当计数器CNT的值等于CCR0时，如果通道配置正确，就会发生第一次比较匹配事件，从而触发输出电平的第一次翻转（脉冲开始）。

• TIMERx_SWEVG (软件事件生成寄存器)：它的CH0G位可以软件模拟一次通道0的比较匹配事件，用于测试。但单脉冲的正式启动不依赖于此。

3.3 从模式控制器配置：定义“发射指令”的来源

单脉冲模式需要由一个触发信号来启动，这个触发源的选择和配置在从模式控制器中完成。

• TIMERx_SMCFG (从模式控制寄存器)：
  • TRGSEL[2:0] (Trigger Selection)：选择触发源。这是关键配置！
    • 000：内部触发0（ITR0），通常来自其他定时器。
    • 001：内部触发1（ITR1）。
    • 010：内部触发2（ITR2）。
    • 011：内部触发3（ITR3）。
    • 100：TI0的边沿检测器（对应外部引脚）。
    • 101：滤波后的定时器输入1（TI1FP1）。
    • 110：滤波后的定时器输入2（TI2FP2）。
    • 111：外部触发输入（ETRF）。最常用的就是软件触发（111）和外部引脚触发（100，101，110）。
  • SMC[2:0] (Slave Mode Control)：设置从模式。对于单脉冲模式，我们需要将其设置为触发模式。
    • 当SMC[2:0] =110时，定时器工作在“触发模式”。在此模式下，一旦检测到有效的触发信号（由TRGSEL选择），计数器的使能位CEN将被硬件置1，计数器开始计数，从而启动单脉冲序列。
  • TRGP[1:0] (Trigger Polarity)：当选择外部引脚为触发源时，此位定义有效触发的边沿（上升沿、下降沿或双边沿）。

配置逻辑串联：使能单脉冲模式（SPM=1） + 配置从模式为触发模式（SMC=110）并选好触发源 + 配置好CCRx（延迟）和ARR（总时长） + 配置好输出通道。当触发信号到来，硬件自动启动计数器，CNT从0开始，等于CCRx时输出翻转（脉冲开始），等于ARR时再次翻转（脉冲结束）并停止计数器。

4. 实战配置：生成一个延迟2ms、宽度1ms的正脉冲

假设我们需要用TIMER1的CH0（对应某个GPIO引脚，需先配置为复用推挽输出）生成一个单脉冲：在收到软件触发命令后，延迟2ms，然后产生一个高电平宽度为1ms的正脉冲。系统时钟为200MHz，定时器时钟不分频（即CK_TIMER = 200MHz）。

步骤1：计算预分频PSC和计数值我们希望计时精度为1us（即计数器每1us加1），则定时器时钟应为1MHz。PSC = (CK_TIMER / 目标频率) - 1 = (200MHz / 1MHz) - 1 = 199写入TIMER1_PSC = 199。

延迟时间 = 2ms = 2000us， 所以CCR0 = 2000。 脉冲宽度 = 1ms = 1000us， 所以总时间 = 延迟 + 宽度 = 3ms = 3000us， 所以CAR = 3000。 写入TIMER1_CH0CV = 2000，TIMER1_CAR = 3000。

步骤2：配置时基与单脉冲模式

TIMER1_CTL0 = 0x0000; // 先清零，确保CEN=0, DIR=0(向上计数) TIMER1_CTL0 |= (1 << 3); // 设置SPM位为1，使能单脉冲模式 // 注意：此时先不设置CEN位！

步骤3：配置通道0为输出比较模式（以PWM模式为例）

// 配置CH0为输出模式，PWM模式1（匹配时有效电平，超过ARR时无效） TIMER1_CHCTL0 &= ~(0x03 << 0); // 清零CH0MSEL TIMER1_CHCTL0 |= (0x01 << 0); // CH0MSEL=01, 输出模式 TIMER1_CHCTL0 &= ~(0x07 << 4); // 清零CH0COMCTL TIMER1_CHCTL0 |= (0x06 << 4); // CH0COMCTL=110? 这里需要仔细核对：PWM模式1对应值是110吗？参考手册！ // 更稳妥的写法是直接赋值，避免位操作错误。假设手册定义PWM1为‘110’ TIMER1_CHCTL0 = (TIMER1_CHCTL0 & ~(0x07 << 4)) | (0x06 << 4); TIMER1_CHCTL0 |= (1 << 3); // 设置CH0COMSEN=1，使能预装载

这里是个大坑：不同系列、甚至同一系列不同定时器的模式定义位可能略有差异。务必、绝对、一定要查阅你手头GD32H7xx型号的参考手册中关于TIMERx_CHCTL0寄存器CH0COMCTL位的详细描述！把“110”对应“PWM模式1”这个关系确认无误。配置错了，输出电平逻辑就全乱了。

步骤4：配置从模式控制器为软件触发

TIMER1_SMCFG &= ~(0x07 << 4); // 清零TRGSEL TIMER1_SMCFG |= (0x07 << 4); // TRGSEL = 111， 选择外部触发输入(ETRF)，通常映射为软件触发 TIMER1_SMCFG &= ~(0x07 << 0); // 清零SMC TIMER1_SMCFG |= (0x06 << 0); // SMC = 110， 从模式设置为触发模式

步骤5：配置输出极性（可选）TIMERx_CHCTL2寄存器中的CH0P位可以控制输出极性。通常默认（CH0P=0）为高电平有效。即比较匹配后输出高电平。我们需要的是延迟后出现高脉冲，所以PWM模式1配合默认极性通常是正确的。但最好根据实际需要的起始电平和脉冲极性来调整CH0P和PWM模式（模式1或模式2）。

步骤6：使能预分频和自动重载寄存器的预装载

TIMER1_CTL0 |= (1 << 7); // 使能ARPreload，保证CAR值在更新事件时才生效 // PSC的预装载通常也是使能的，但有些寄存器控制位可能不同，查手册确认。

步骤7：启动定时器（但不启动计数）

// 此时CEN位还是0。计数器未运行。 // 需要生成单脉冲时，通过软件触发事件来启动。

步骤8：生成软件触发，发射单脉冲

TIMER1_SWEVG |= (1 << 0); // 设置CH0G位为1，生成通道0的软件事件（也可用更新事件触发UG） // 更标准的单脉冲触发方式是，在配置好从模式为软件触发后，直接给一个触发信号： // TIMER1_SWEVG |= (1 << 4); // 设置TRGG位，生成触发事件。这个更符合“触发”语义。 // **重点核对**：参考手册中，软件触发从模式启动计数器的具体方式。通常是写TRGG位。

执行完这一步后，硬件会自动将TIMER1_CTL0的CEN位置1，计数器开始从0向上计数。当CNT=CCR0(2000)时，输出翻转为高电平（假设配置正确）；当CNT=ARR(3000)时，输出翻转为低电平，同时计数器停止，CEN位被硬件自动清零。一个完美的2ms延迟、1ms宽度的正脉冲就产生了。

5. 调试中的常见“坑”与波形异常分析

理论很美好，但逻辑分析仪上的波形可能很骨感。下面是我在调试中遇到过的几个典型问题：

问题一：根本没有脉冲输出。

• 排查思路：
  1. GPIO配置：首先确认对应的GPIO引脚是否已正确初始化为复用推挽输出模式（AF_PP）。这是最容易被忽略的一步！
  2. 定时器时钟：确认TIMER1的外设时钟是否已使能（通过RCU_APBxEN寄存器）。没有时钟，一切配置都是空谈。
  3. 输出比较使能：确认TIMERx_CHCTL0中对应通道的CHxEN位是否置1？有些架构需要单独使能输出。GD32H7中，配置CHxMSEL为输出模式后通常就已使能，但最好确认。
  4. 触发是否生效：检查TIMERx_SMCFG的配置（SMC和TRGSEL）。尝试将SMC设置为111（门控模式），然后用一个持续高电平的GPIO作为触发源，看定时器是否开始计数（通过调试器读CNT寄存器）。这可以排除触发逻辑的问题。
  5. 软件触发指令：确认你发出的软件触发命令是否正确。是写SWEVG寄存器的TRGG位，还是CHxG位？参考手册的“触发模式”章节，找到正确的软件启动方法。

问题二：脉冲输出持续为高或持续为低，没有变化。

• 排查思路：
  1. 输出极性/模式错误：这是最大嫌疑。用逻辑分析仪抓取初始电平。如果一直为高，可能是配置成了“强制输出高”模式，或者PWM模式/极性配置反了。仔细检查CHxCOMCTL和CHxP位的每一个比特，确保其含义与你期望的“匹配时翻转/变高”逻辑一致。强烈建议：在初始化后、触发前，先读取TIMERx_CHCTL0和TIMERx_CHCTL2寄存器，确认实际写入值是否符合预期。
  2. 比较值设置问题：检查CCRx和ARR的值。如果CCRx >= ARR，则在向上计数模式下，比较匹配事件可能不会在停止事件之前发生，导致输出没有翻转机会。确保0 < CCRx < ARR。
  3. 计数器未运行/立即停止：检查CEN位。可能在触发后，由于某些原因（如更新事件中断中错误地清了CEN），计数器瞬间就停止了。或者触发源本身是一个瞬间脉冲，而配置可能有问题。

问题三：脉冲宽度或延迟时间不准。

• 排查思路：
  1. 时钟源精度：确认给定时器的时钟频率是否准确。200MHz的系统时钟是否经过PLL稳定锁定？用示波器测量一下相关时钟引脚。
  2. PSC计算错误：回顾PSC的计算公式PSC = (CK_PSC / Ftimer) - 1。其中CK_PSC是定时器时钟源频率，Ftimer是你期望的计数器频率。确保单位统一（MHz），且计算正确。
  3. 计数值计算错误：时间T对应的计数值Count = T * Ftimer。例如，期望延迟2ms，计数器频率1MHz，则Count = 2ms * 1000us/ms * 1Count/us = 2000。注意时间单位换算。
  4. 中断干扰：如果使能了定时器更新中断或其他高优先级中断，中断服务程序的执行时间可能会轻微干扰计时的精确性。对于极高精度要求，可以考虑禁用中断，或者使用DMA。

问题四：只能产生一次脉冲，无法再次触发。

• 原因分析：这是单脉冲模式的正常现象，但也是需要正确复位的特性。在一次单脉冲序列完成后，CEN位被硬件清零，SPM位可能仍然有效，但计数器已停止。此时，即使新的触发信号到来，因为计数器CNT可能还停留在ARR值，不会从0开始。
• 解决方案：在每次准备发起新的单脉冲触发前，需要软件清除计数器的当前值，确保其从0开始。最简洁的方法是：

  // 在下次触发前，执行以下操作 TIMER1_CNT = 0; // 清零计数器 // 然后，再次发出软件触发指令 TIMER1_SWEVG |= (1 << 4); // 触发

  有些应用场景中，也可能需要先清除SWEVG寄存器中的相关标志位。

6. 进阶应用：与从模式其他功能联动的思考

单脉冲模式的基础是触发模式。而GD32H7的从模式控制器功能强大，触发源的选择非常灵活，这为单脉冲模式的应用打开了更多可能：

• 外部硬件触发：将TRGSEL配置为TI0边沿检测（100），就可以用一个外部GPIO的上升沿或下降沿来精准启动单脉冲。这在需要与外部传感器或设备同步的场合非常有用。
• 定时器级联：将TRGSEL配置为内部触发ITRx，可以用另一个定时器的更新事件或比较匹配事件来触发本定时器的单脉冲。这样可以构建复杂的定时序列。例如，用TIMER2以10Hz频率产生更新事件，去触发TIMER1的单脉冲，那么TIMER1就会每100ms精确产生一个宽度固定的脉冲。
• 门控模式：虽然单脉冲模式常搭配触发模式，但了解门控模式（SMC=101）也有帮助。在门控模式下，触发信号的高电平期间计数器运行，低电平期间暂停。这可以用来测量一个外部信号的有效宽度。虽然不直接产生单脉冲，但思想是相通的——都是用外部信号控制计数器的启停。

理解这些联动，你就能把定时器从简单的延时工具，变成系统内精准的“时序调度中心”。在配置时，务必理清信号流：触发源 -> 从模式控制器 -> 计数器启停 -> 输出比较单元 -> 最终GPIO电平。画出这个数据流图，对于调试复杂配置有奇效。

最后，寄存器配置看似繁琐，但给了我们最大的灵活性。当你通过调试器，一步步看着CNT寄存器按照预期累加，并在CCRx和ARR点看到对应的标志位被置起，最终在逻辑分析仪上捕捉到那个完美的方波时，这种对硬件直接掌控的感觉，是调用库函数无法比拟的。它让你真正理解芯片是如何工作的，下次再遇到任何定时器相关的问题，你都能从容地翻开手册，从寄存器层面找到答案。