1. GTM ATOM 的三层结构：PCM、SOMS、HRES 各自解决什么问题
第一次看到GTM ATOM的寄存器手册时，我怀疑自己看错了章节。一个定时器模块配了将近三十页的位域说明，输出模式还分SOMC和PCM两套，寄存器里又单独有个SOMS字段，再往下还有一个叫HRES的独立子模块挂在时钟管理单元旁边。真正把它配起来跑通、并且用示波器验证过边沿精度之后，我才理解这套设计不是堆料，而是把“定时器”这件事按输出信号的精度需求拆成了三层：谁来产生边沿（PCM/SOMC）、边沿长什么样（SOMS）、边沿能精确到什么程度（HRES）。这三层分清楚，后面所有的配置都有了落脚点。
这套东西最典型的落地场景是车规级电机控制、多相电源、LED 矩阵调光这类对 PWM 频率和边沿抖动同时有要求的系统。它解决的问题很具体：普通定时器在 100MHz 时钟下只能给你 10ns 的边沿粒度，占空比调节分辨率只有 7~8 位，做 FOC 电流环时占空比抖动会让相电流出现低频纹波；而 GTM 的 PCM 加上 HRES，能把有效调节分辨率抬高一到两个数量级，同时保持硬件自主运行、不占 CPU。如果你正在调电机驱动、做数字电源，或者单纯想搞明白为什么别人的 PWM 输出这么干净，这篇内容应该能帮你省掉几天的排查时间。文中所有寄存器取值和配置流程，都来自实际调试的整理，涉及具体位偏移的地方我会标注“以所用器件手册为准”，因为这个模块在不同版本之间确实有差异。
1.1 从“计数比较”到“信号发生流水线”的思维转变
大部分人对定时器的理解停留在“计数器到了就翻转电平”。ATOM 的 PCM 模式确实也是这么干的，但它把这件事拆成了一条流水线：时钟进来 → 分频 → 计数 → 与两个影子寄存器比较 → 输出控制单元 → 引脚。这条流水线里每一段都能被独立配置，也能被 ARU 总线在运行中改写。理解这条链，比记住任何单个位域都重要。
我在调试初期犯过的最大错误，就是把 ATOM 当成“带 PWM 功能的定时器”来用，直接往比较寄存器里写值，然后惊讶地发现占空比在运行时改动会造成一个周期的毛刺。后来才明白，ATOM 的 SR0/SR1 在 PCM 模式下是有更新时机约束的，它的设计假设是“你会在周期边界提交新值”，而这个边界由硬件负责判定。一旦脱离这个假设去操作，硬件不会报错，只会默默给你一个宽度异常的脉冲。这类“静默错误”在电机驱动里非常危险，一个异常的窄脉冲可能直接触发过流保护。
所以我把这条流水线拆成四个必须分别确认的环节：时钟源与分频是否落在预期频点、计数模式与周期寄存器是否匹配、比较值与输出模式的对应关系是否正确、更新时机是否与周期同步。四个环节任意一个出问题，波形都能出来，但都是错的。后面章节的排查表也是按这四个环节组织的。
1.2 SOMC 与 PCM：两套输出模式的真实分工
ATOM 的每个通道都可以在两种输出模式之间二选一，这个选择由SOMS字段决定，而两种模式的内部结构完全不同。
SOMC（Signal Output Mode Compare）本质上是“比较输出”。计数器 CNT 自由运行或者被 SR0 复位，两个比较单元 CM0、CM1 分别在 CNT 等于 SR0、SR1 时产生事件，输出单元根据事件翻转或置位。它的优点是灵活：你可以只用 CM0 做一个单边沿，也可以用两个比较单元做任意相位的脉冲，甚至可以把输出配置成“比较匹配时置位、周期溢出时清零”这种非对称波形。缺点是 CPU 必须自己管周期边界，容易在更新时出错。
PCM（Pattern Compare Mode）则是“模式发生器”。它内部有一个专门的状态机，把 SR0 当作周期、SR1 当作占空比（或第二边沿位置），自动生成周期性的 PWM 波形。你只需要保证 SR0 ≥ SR1，剩下的边沿生成、周期复位全部由硬件完成。PCM 的价值在于可预测性：波形形状由硬件保证，CPU 只负责提交数值，不参与边沿时序。
这两者的取舍我用一张表说清楚，实际选型时对着看就行：
| 对比项 | SOMC 比较模式 | PCM 模式 |
|---|---|---|
| 波形自由度 | 高，可做单脉冲、任意相位、非对称波形 | 中，主要是周期性 PWM 与固定模式 |
| CPU 参与度 | 高，周期边界需软件维护 | 低，硬件自动复位与生成 |
| 运行时改占空比 | 需要自己做同步，容易出毛刺 | 影子寄存器 + 周期边界生效，天然安全 |
| 典型用途 | 单次触发、编码器模拟、特殊时序 | 电机 PWM、电源开关、调光 |
| 多通道相位控制 | 需要手工偏移比较值 | 天然支持，各通道独立周期计数 |
我个人的经验是：只要是周期性的、要连续跑的波形，优先上 PCM；只有做“一次性脉冲”或者“非周期特殊时序”时才退回 SOMC。这条经验帮我避免了很多在更新时机上纠结的时间。
1.3 SOMS 字段到底在选什么
很多人把 SOMS 理解成“输出模式选择”，但它选的其实是输出级的行为，不是内部的计数模式。SOMS 是一个多位的字段，不同取值对应输出被置高、被拉低、跟随比较事件翻转、或者直接把输出交给 ARU 数据流控制。
这里有个容易混淆的点：SOMS 和 PCM/SOMC 是两层配置。你先用 SOMS 选出通道工作在哪种输出模式下（比较模式还是模式发生器），再用同一字段的其他位组合决定输出极性和使能方式。我见过有同事把 SOMS 设成“强制高电平”想先让引脚安静，结果后面改回 PWM 时忘了更新这一位，波形死活出不来，查了半天时钟。
注意：SOMS 的取值编码在不同版本的手册里编码方式不完全一致，配置前一定要翻到寄存器位定义那一页逐位核对，不要照抄网上博客里的十六进制值。我吃过这个亏，同一个数值在旧版上是对的，新版上含义变了。
2. 时钟链与寄存器地图：把精度先算在纸面上
配置之前先把时钟算清楚，这是我现在的固定习惯。ATOM 的频率精度完全由时钟链决定，配置错了，后面怎么调波形都不对。GTM 的时钟从模块输入时钟开始，经过 CMU（时钟管理单元）分频成多路全局时钟，再由每个通道的 CLK_SRC 字段选中其中一路作为自己的计数时钟。这条链上任何一级算错，最终频率就会差一个整数倍，而且示波器上看起来“挺正常”，因为占空比是对的。
我习惯先在纸上把三个数算出来：通道计数时钟频率、目标 PWM 频率对应的周期计数值、该计数值下的占空比分辨率。这三个数字一旦确定，寄存器配置基本就是填空题。实测下来，这一步花五分钟，能省掉后面半小时的猜谜。
2.1 从 CMU 到通道计数时钟的完整传递
GTM 的时钟管理单元提供若干路全局时钟（常记为 CLK_0 到 CLK_7），每一路都可以独立设置分频系数，并且可以被单独使能。ATOM 通道通过 CTRL 寄存器里的时钟源选择字段，从这几路里挑一路作为自己的计数时钟。此外通道内部还有一个“慢时钟”位（SL），它影响的是通道内部状态机的推进速率，不是计数时钟本身，这一点经常被误解。
典型的配置逻辑是这样的：模块输入时钟先进入 CMU，假设输入为 100MHz。我给 CLK_0 设置分频系数使输出为 100MHz（不分频），给 CLK_1 设置分频得到 50MHz，给 CLK_2 得到 25MHz。这样不同通道可以按需选频，而不必为每个通道单独做分频器。这种“集中分频、分散选用”的结构在通道数量多的时候特别省资源。
分频系数与输出频率的关系，手册上给的是带分子分母的公式，实践中我用的是简化形式：输出频率等于输入频率除以分频系数（具体是 N 还是 N+1 取决于配置字段，务必核对）。我在第一次配置时按 N 算，结果实测频率比预期低了 0.4%，正是因为公式里有 +1 的偏置。这类细节只能靠手册确认，或者干脆用示波器反推。
实操建议：CMU 配置完成后，先把每一路全局时钟的使能位全部打开，再逐个通道配置。如果时钟没使能就配通道，通道会保持静默，现象就是“配置全对但引脚不动”，排查起来很浪费时间。
2.2 关键寄存器清单与位域速查
ATOM 的寄存器分三个层次：全局控制寄存器、通道控制寄存器、通道数据寄存器。我整理了一份按“配置顺序”排列的清单，照这个顺序写基本不会漏：
| 层次 | 寄存器 | 关键字段 | 作用 |
|---|---|---|---|
| 全局 | ATOM 全局控制 | 通道使能、输出使能、全局复位 | 通道总开关，必须在通道配置完成后置位 |
| 全局 | 通道使能控制 | ENDIS 位组 | 单独启停某个通道的计数 |
| 全局 | 输出使能控制 | OUTEN 位组 | 单独启停某个通道的引脚输出 |
| 通道 | 通道控制 CTRL | 时钟源选择、SL、SOMS、ARU 输入输出选择 | 决定通道行为模式 |
| 通道 | 通道状态 STAT | 计数器方向、比较匹配标志 | 调试时看这里判断计数是否在跑 |
| 通道 | 周期/占空比寄存器 SR0/SR1 | 周期值、比较值 | PCM 模式下分别是周期与占空比 |
| 通道 | 计数器 CNT | 当前计数值 | 只读，调试观察用 |
配置顺序我的习惯是：先端口复用，再时钟，再全局使能，最后通道参数。端口复用必须最先做，因为如果引脚还挂在 GPIO 模式，后面所有配置在示波器上都看不见，你会怀疑寄存器没写进去。全局使能放在通道参数之前还是之后，取决于具体器件，有些版本要求先配参数再使能，否则第一个周期会用默认值跑一遍，产生一个异常宽的脉冲。我一般选择“参数先写好、最后一次性使能”，这样上电瞬间波形就是干净的。
2.3 频率、占空比与分辨率的定量估算
这部分是很多人跳过但实际最该算的地方。PCM 模式下，PWM 频率等于通道计数时钟频率除以周期计数值，占空比等于比较值除以周期计数值。这两个式子看起来简单，但“分辨率”这个概念才是关键：周期计数值决定了你能把占空比分成多少档。
举个例子。计数时钟 100MHz，目标 PWM 频率 20kHz，那么周期计数值是 100M / 20k = 5000。占空比可以取 0 到 5000 共 5001 档，等效分辨率约 12.3 位。这个精度做电机控制勉强够用，但如果目标频率提到 100kHz，周期计数值降到 1000，分辨率就掉到 10 位不到，占空比最小步进变成 0.1%，电流环里就能看到明显的量化纹波了。
我把这个关系做成了一张常用对照表，配的时候直接查：
| 计数时钟 | PWM 频率 | 周期计数值 | 占空比步进 | 等效位数 |
|---|---|---|---|---|
| 100MHz | 10kHz | 10000 | 0.01% | 13.3 |
| 100MHz | 20kHz | 5000 | 0.02% | 12.3 |
| 100MHz | 50kHz | 2000 | 0.05% | 11.0 |
| 100MHz | 100kHz | 1000 | 0.10% | 10.0 |
| 100MHz | 200kHz | 500 | 0.20% | 9.0 |
从表里能直接看出矛盾：频率越高，分辨率越差。这就是为什么需要 HRES：它不改变计数时钟，而是在边沿上做亚周期补偿，把有效分辨率重新拉回来。我在一个 200kHz 的电源项目里，靠 HRES 把 9 位的有效分辨率补到了接近 12 位的效果，输出电压纹波肉眼可见地小了一圈。
3. PCM 模式实操：从零配出一路可用的 PWM
理论讲完，进入真正动手的部分。下面这套流程是我在多个项目里反复用过的顺序，按它走基本不会翻车。为了让内容可直接复现，我用一个具体场景：100MHz 计数时钟、20kHz PWM、初始占空比 30%、单通道输出到某个引脚。所有寄存器写操作用结构体指针示意，实际工程里换成厂商头文件定义的宏即可。
需要说明的是，下面代码里的寄存器名和字段名是我为了表达逻辑做的抽象，字段的位偏移请以手里那颗器件的寄存器手册为准。逻辑顺序是通用可复用的，这才是重点。
3.1 上电初始化顺序与保护解锁
第一步不是写定时器，是解锁。车规 MCU 的很多外设寄存器受写保护控制，没解锁之前写入会被静默丢弃，读回来还是旧值。我吃过一次亏：配置写了一百多行，示波器毫无反应，最后发现是保护没解。
解锁的一般流程是：向保护控制寄存器写入特定的序列（通常是“读-改-写”配合魔数），然后再操作目标外设。部分器件还要求解锁窗口内完成操作，超时自动重新上锁。这种机制的好处是防止跑飞的程序误改时钟配置，坏处是调试时容易忘。
我的初始化顺序固定为五步：
- 解锁外设写保护；
- 配置引脚复用，把目标引脚切到 GTM 输出功能；
- 配置 CMU，使能所需全局时钟；
- 配置 ATOM 通道参数（控制寄存器、周期、占空比）；
- 打开通道使能与输出使能，最后重新上锁。
第 5 步的“重新上锁”别省。我见过有代码为了调试方便一直不解锁回去，量产时留下隐患。上锁之后再改配置，就必须重新走一遍解锁流程，这反而是一个安全边界。
3.2 寄存器级配置代码与逐行解释
下面这段是 PCM 模式的核心配置，我用注释把每一步的意图写清楚了：
/* 1. 引脚复用：把目标引脚切到 GTM 输出功能 */ PORT_PIN_MUX( PIN_PWM ) = MUX_ALT_GTM; /* 选对 ALT 编号，别照抄 */ PORT_PIN_OE( PIN_PWM ) = 1; /* 输出使能，忘了这步波形出不来 */ /* 2. 时钟管理：配置全局时钟 0 为不分频 */ CMU_CLK_EN = CMU_CLK0_EN; /* 先使能时钟输出 */ CMU_CLK0_DIV = 0; /* 分频系数 0 表示不分频，具体编码查手册 */ /* 3. 通道控制：选时钟源、选 PCM 模式 */ ATOM_CH_CTRL = 0; /* 先清零，避免残留位干扰 */ ATOM_CH_CTRL |= CLK_SRC_CLK0; /* 计数时钟选全局时钟 0 */ ATOM_CH_CTRL |= SOMS_PCM; /* 关键：选中 PCM 输出模式 */ ATOM_CH_CTRL |= SL_SLOW; /* 内部状态机时钟，一般选慢速 */ /* 4. 周期与占空比：周期 5000，占空比 30% 即 1500 */ ATOM_CH_SR0 = 5000 - 1; /* 周期寄存器，注意是否要减 1 */ ATOM_CH_SR1 = 1500; /* 比较值，对应占空比 30% */ /* 5. 使能：先开通道计数，再开输出 */ ATOM_AGC_ENDIS = CH_ENABLE_MASK; ATOM_AGC_OUTEN = CH_OUTPUT_MASK;几个必须盯住的点。SR0 是否减 1取决于计数是从 0 到 SR0 还是从 0 到 SR0-1，这个细节会直接让你的实际频率偏差 0.02%，低频时无所谓，高频时会影响占空比的对称性。我的做法是先按“减 1”配，然后用示波器测实际频率，如果差了一个计数周期就调整过来。SOMS_PCM 的具体取值必须查手册的位定义表，不同版本不一样，我这里只表达“要选 PCM”这个语义。
还有一点容易被忽略：SL 位。它控制通道内部状态机的推进速率，在 PCM 模式下会影响从“比较匹配”到“输出翻转”的延迟。默认值通常能用，但如果你的多通道之间有固定相位差要求，这个位不一致就会引入额外的偏移。我一般在同一组通道里把 SL 配成一致，避免这种隐性偏差。
3.3 双缓冲机制与运行时更新占空比
PCM 模式最有价值的设计是影子寄存器。SR0 和 SR1 都不是直接被比较单元使用的，硬件在周期边界把影子值搬到工作寄存器，这样你可以在任意时刻写新值，波形都不会出现半个周期的毛刺。
但这里有个坑：写入时机仍然影响生效延迟。如果你在计数器刚过零时写入，新值要等到下一个周期边界才生效，中间隔了将近一整个周期；如果你在周期末尾写入，可能就是下一个周期立刻生效。做电流环的时候，这个延迟的一致性比延迟的大小更重要：如果你的代码在中断里写占空比，中断响应抖动会让生效时刻抖动，闭环带宽就上不去。
我的处理办法是把更新动作固定在一个位置：在周期匹配中断里写下一周期的值。这样写入时刻与周期边界严格对齐，生效延迟恒定，闭环建模的时候可以直接当成一个固定延时处理。实测下来，电流环的相位裕度明显改善。
提示：如果不用中断，也可以用 ARU 总线让另一个模块（比如多通道序列器）在指定时刻把新值推送到 SR1，完全绕开 CPU。这种方式延迟最稳定，代价是配置复杂度上一个台阶，建议先把 CPU 直写跑通再上 ARU。
3.4 多通道相位控制与组同步
多相电源和多相电机都要求通道之间有精确的相位差。PCM 模式下做这件事很直接：每个通道有独立的计数器，只要让它们的 SR0 相同、初始计数值不同，就能产生固定相位差。
但“初始计数值不同”这个做法有个问题：上电时刻的相位关系依赖写入顺序，而且一旦某个通道被单独复位，相位关系就乱了。更可靠的做法是用全局复位：配置好所有通道的周期值，然后一次性触发全局复位，让所有计数器同时从 0 开始，相位差靠各自的“计数偏移”实现。
不过 ATOM 的计数器本身没有偏移寄存器，纯 PCM 模式下的相位差通常靠“周期值相同、占空比加上偏移”来实现等效效果，或者用通道间的联动。我实际项目里用的是前者：把相位差折算成比较值的偏移，虽然波形结构上略有不同，但对外部负载而言效果是等效的。
这里要提醒一句：多通道同时改占空比时，确保它们在同一个周期边界生效。如果逐通道写，通道之间会有一个周期的错位，多相系统里这会变成环流。我的做法是先写所有通道的影子寄存器，最后统一触发一次更新，或者干脆把更新动作放在同一个中断里顺序执行。
4. HRES 精密控制：把边沿再切细一档
HRES 是 GTM 里最容易被神话、也最容易被误用的部分。它的作用不是“让定时器变成 150ps 分辨率”，而是在一个粗时钟周期内部，对输出边沿做亚周期的微调。理解这个定位，才知道什么时候该用它、什么时候用了也没用。
我在一个数字电源项目上第一次用 HRES，当时的想法很朴素：既然分辨率不够，上 HRES 就对了。结果配完之后占空比确实变细了，但输出电压纹波改善有限。后来才想明白，问题不在 HRES，在于我的控制算法本身还在按粗分辨率计算，微调量被量化掉了。HRES 只是执行机构，精度要由整个控制链路一起撑起来。
4.1 HRES 的工作原理与适用边界
HRES 子模块内部是一条可编程延时链。粗时钟产生一个边沿之后，HRES 可以在这个边沿上再叠加一个小于一个粗周期的延时，延时的档位由配置值决定。假设粗时钟 100MHz（10ns 周期），延时链分成 256 档，那么每档约 39ps；如果分成 64 档，每档就是 156ps，接近常见的“150ps 级”说法。
关键点在于：HRES 只能在“一个粗周期之内”做加法。它不能让你把周期计数值本身变细，只能在已有的整数边沿上补一个分数。所以它的正确用法是“整数部分 + 分数部分”的组合：目标边沿落在 123.7 个粗周期上，粗定时器负责 123，HRES 负责 0.7 个周期的延时。
这个组合带来一个实际约束：微调量必须是 0 到 1 个粗周期之间的值，超出就无效。有些工程师想让 HRES 累计多个周期的分数，那是不可能的，硬件会在每个边沿重新取一次微调量。
适用边界也很清楚：适合中高频、对边沿抖动敏感、但对绝对相位精度要求不极端的场景。比如 100kHz 到 500kHz 的开关电源、需要精确死区控制的半桥驱动、对占空比量化敏感的调光。不适合的是那种要求“绝对时间精度优于 1ns”的测量类应用，因为 HRES 的延时链本身受温度和电压影响，需要校准。
4.2 微调量的计算与生效时机
计算微调量分三步。第一步，算出理想周期计数值（可能是小数）：周期计数值 = 计数时钟 / 目标频率。第二步，把小数部分取出来，乘以延时链的档位数，得到微调量。第三步，把整数部分写进 SR0，微调量写进 HRES 对应的通道寄存器。
举个具体例子。计数时钟 100MHz，目标 123.7kHz。周期计数值 = 100M / 123.7k = 808.4。整数部分 808 写进 SR0，小数部分 0.4 乘以 256 档得到 102，写进 HRES 通道配置。这样每个周期的边沿都会额外延后 0.4 个粗周期，长期平均频率就精确落在 123.7kHz。
占空比同理。目标占空比 33.3%，周期 808，理想比较值 = 269.1。整数 269 写 SR1，小数 0.1 乘 256 得 26，写 HRES 的另一路配置（如果该通道支持双边沿独立微调）。
注意：生效时机。HRES 的微调值通常在下一个边沿生效，不是立即生效。如果你的更新频率很高（比如每个 PWM 周期都改一次），要确认微调值的写入不会和边沿生成撞车，否则会出现偶发的抖动。稳妥的做法是把微调值和整数比较值放在同一次更新里提交。
还有一个经验性细节：HRES 的档位数不一定是 2 的幂。有些实现是 64 档、有些是 128 档，具体看手册。我一开始按 256 算，实际是 128，结果微调量全错了一倍，波形看起来“有变化但不对”。这类问题只能靠手册确认，别靠猜。
4.3 校准与环境漂移的处理
延时链是模拟电路，它的实际延时随工艺、电压、温度变化。同一份配置在实验室常温下测出来是 39ps 一档，装到板子上跑高温可能就变成 43ps。对于要求不高的应用，这个漂移可以忽略；对于闭环电源，它会影响环路增益的标定。
我的处理办法分两种。离线校准适用于量产一致性要求高的场景：在产线上用一个已知频率的参考信号，测出实际边沿位置，反算出当前环境下的每档延时，把这个系数写进参数区。在线自适应适用于工作环境变化大的场景：利用片上比较器或者外部反馈，周期性测量实际输出与期望的偏差，微调 HRES 系数。
两种方式都有成本，所以我一般先评估：如果占空比分辨率要求只在 11 位左右，普通 PCM 就够，根本不用上 HRES；只有确实需要 13 位以上有效分辨率时才引入这套复杂度。我见过有项目为了“显得高端”硬上 HRES，结果校准没做好，抖动比不用还大。
5. 常见问题与排查实录
这一章是我这些年攒下来的排查笔记，按现象组织，遇到问题直接对表查。需要说明的是，很多问题的根因不在 ATOM 本身，而在它上游的时钟、引脚复用、或者使能顺序，所以排查一定要从上游往下游走，不要一上来就怀疑寄存器配错。
5.1 波形出不来的四层排查法
引脚完全没波形，是最常见也最好解决的问题，关键在于按层次排查，不要乱试。
第一层：引脚。确认复用功能选对了、输出使能打开了、引脚没有被其他外设占用。我遇到过引脚复用编号差一位，切到了相邻通道，结果配置全对但波形出现在隔壁引脚上。
第二层：时钟。确认 CMU 里对应的全局时钟使能了、分频系数没错、通道的时钟源选择指向了正确的那一路。这一层出问题的典型现象是“通道状态寄存器显示计数器不动”。
第三层：通道使能。确认全局的通道使能位和输出使能位都置位了。这两个是分开的，只开一个会出现“计数器在跑但引脚不动”或者“引脚有电平但不变”的情况。
第四层：模式配置。确认 SOMS 选的是 PCM，周期值不为 0，比较值小于周期值。如果 SR1 大于 SR0，某些实现会输出恒高或恒低，看起来就像没配置。
按这四层走，90% 的“没波形”问题在五分钟内能定位。
5.2 频率与占空比偏差速查表
波形出来了但对不上，这类问题更费时间，因为现象“看起来正常”。我整理了一张对照表：
| 现象 | 最可能原因 | 验证方法 |
|---|---|---|
| 频率恰好是预期的一半 | 分频系数算错，或者周期值翻倍 | 检查 CMU 分频与 SR0 |
| 频率差 0.02% 左右 | 周期值该减 1 没减 | 用高频示波器测周期 |
| 占空比整体偏大一点 | 比较值加 1 与边沿定义不匹配 | 改成 50% 占空比看是否对称 |
| 占空比运行中偶发跳变 | 更新时机未与周期边界对齐 | 把更新挪进周期中断 |
| 多通道相位漂移 | 未做全局复位同步 | 检查初始化顺序 |
| 高占空比时脉宽异常窄 | 比较值接近周期值时的边界处理 | 限制比较值上限为周期值减一 |
这张表里最值得说的是“差 0.02%”那一行。这个偏差非常小，普通示波器看不出来，但如果你用频率计测，会发现和目标差了零点几个赫兹。根因就是周期值的 ±1 偏置。做电机控制时这个偏差会体现在转速上，做电源时体现在输出电压上，虽然小但会累积。
5.3 几个踩过的坑与独家提醒
第一个坑：上电第一个周期的异常脉冲。如果先开输出使能再写周期值，第一个周期会用复位默认值跑一遍，产生一个极宽或极窄的脉冲。在驱动 MOS 管的场合，这一个脉冲足以炸管。我的做法永远是“参数写完再开输出”，并且在使能前先把比较值写成安全值。
第二个坑：调试器暂停导致波形卡死。ATOM 是硬件自主运行的，CPU 停下来它照跑。但如果你的代码依赖中断更新占空比，暂停后中断不响应，波形就会停在最后一个值上。这不是故障，但会让不熟悉的人误判。调试时我一般先在 Free Run 模式下观察波形，再决定要不要单步。
第三个坑：多通道共用一个时钟源时的相互影响。所有用同一路全局时钟的通道，频率被绑死。有一次我想让两个通道跑不同频率，结果改了一个另一个也跟着变，查了半天才发现它们选的是同一个时钟源。后来我养成习惯：多频率场景下，先把每个通道的时钟源规划好再动手。
最后一个提醒：别在中断里做浮点运算来算占空比。电流环里我见过有人每次中断都跑一遍浮点除法，中断耗时抖动导致更新时刻抖动，最后表现为输出纹波。提前算好定点系数，中断里只做乘加，这个问题就消失了。
6. 落地场景与选型经验
配置跑通只是开始，真正决定这套方案好不好用的是场景匹配。我按自己经手过的三类应用讲一下取舍逻辑，都是踩过坑之后的总结。
6.1 电机控制里的 PWM 与同步触发
FOC 控制对 PWM 的要求集中在三点：频率稳定、占空比分辨率足够、采样时刻与 PWM 同步。PCM 模式天然满足前两点，第三点靠比较匹配事件触发 ADC 转换实现。
我的典型配置是：PWM 频率 20kHz，计数时钟 100MHz，周期值 5000。把 ADC 触发点设在计数器过零时刻（下桥臂导通的中点），这样采样的是相电流的真实值，避开开关噪声。触发信号通过通道的比较事件输出到内部触发网络，不需要额外的定时器。
这里有个细节：触发点的位置要留裕量。如果设在边沿上，开关噪声会污染采样。我一般是设在计数器的 25% 位置附近，具体看死区时间和电流上升时间。这个值调不好，电流采样会有明显的毛刺，闭环就会出现周期性振荡，很多人会误以为是 PID 参数问题。
6.2 电源与调光场景的分辨率权衡
开关电源和 LED 调光的需求正好相反。电源要高频（减小磁性元件体积），调光要低频（避免可见闪烁）但要求极细的占空比调节。
电源场景：100kHz 到 500kHz，周期值只有 200 到 1000，普通 PCM 分辨率不够，必须上 HRES 补精度。这时候要注意的是“有效分辨率”不等于“瞬时分辨率”：如果你的控制环路带宽只有几 kHz，那么占空比的快速抖动会被环路滤掉，真正重要的是长期平均值。这种情况下用抖动（在相邻两个整数比较值之间交替）配合 HRES，效果比单纯追求单周期精度更好。
调光场景：1kHz 左右，周期值上万，普通 PCM 的分辨率就足够做到 0.01% 的调光深度。这时候上 HRES 收益很小，反而是低频下的边沿抖动更值得关注。我一般在这个场景下关掉 HRES，减少配置复杂度。
6.3 与 TOM、DTM 的选型取舍
GTM 里除了 ATOM 还有 TOM 和 DTM。TOM 没有 ARU 连接能力，适合纯 CPU 控制的输出；DTM 专做死区生成，适合半桥驱动。我的选型逻辑是这样的：
| 需求 | 首选 | 理由 |
|---|---|---|
| 纯 CPU 控制的 PWM | TOM | 结构简单，资源占用少 |
| 需要 ARU 数据流更新 | ATOM | 支持总线推送，延迟稳定 |
| 半桥/全桥互补输出带死区 | DTM | 硬件生成死区，不占 CPU |
| 高分辨率 PWM | ATOM + HRES | 唯一支持的组合 |
| 多通道相位严格同步 | ATOM | 支持全局复位与统一更新 |
实际项目里往往是混用：主功率级用 DTM 做互补输出，采样触发用 ATOM 的 PCM 通道，辅助功能用 TOM。规划的时候先把每个通道的职责定死，再统一配时钟，能省掉大量后期调整。
我个人在这些项目里最深的体会是，GTM ATOM 这套东西的复杂度不是设计者炫技，而是把“精度”这件事拆成了可以独立取舍的三个维度。你要 20kHz 的电机 PWM，PCM 就够了，别碰 HRES；你要 300kHz 的电源，那就得把 HRES 的校准一起做掉；你要多通道严格同步，那全局复位和统一更新比任何单通道参数都重要。
还有一个建议：先把简单的跑通，再叠加复杂度。我见过太多人一上来就配 ARU 加 HRES，出问题之后根本分不清是哪一层错了。先用最朴素的 CPU 直写把波形跑出来、用示波器确认频率和占空比都对，再逐层往上加。每加一层就测一次，出问题立刻能定位到刚加的那层。这套方法看起来慢，实际上比一次性配完再debug快得多。
