企业官网建设流程全解析

1. 项目概述与核心价值

在电机驱动、数字电源、逆变器这些硬核的嵌入式控制领域，PWM（脉冲宽度调制）就是工程师手中的“画笔”，而微控制器里的PWM模块则是“画板”和“颜料”。你写的算法再精妙，最终都得通过PWM模块输出成实实在在的、能驱动MOSFET或IGBT的开关信号。TI C2000系列DSP里的增强型PWM（ePWM）模块，可以说是这个领域的“瑞士军刀”，功能强大到令人眼花缭乱，但初次接触其数据手册时，面对动辄几十个寄存器、七八个子模块，很容易让人陷入“配置地狱”：寄存器地址是什么？影子模式怎么用？TB和CC子模块到底怎么配合？

我经历过这个阶段，也见过很多工程师在调试时，因为对寄存器映射和影子机制理解不透，导致PWM输出出现毛刺、相位错乱，甚至炸管。所以，今天我们不谈高深的理论，就扎扎实实地把手伸进寄存器层面，把ePWM模块，特别是其心脏——时间基准（TB）和手臂——计数器比较（CC）这两个子模块，给彻底“解剖”一遍。你会发现，一旦理解了寄存器如何映射到硬件行为，以及影子寄存器如何安全地更新参数，你就能像指挥交响乐一样，精准控制每一个PWM脉冲的诞生时机、宽度和相位关系，从而为你的电机FOC控制、LLC谐振变换器或三相逆变器打下最可靠的基础。

2. ePWM寄存器地图全解析与访问逻辑

开始配置前，我们得先有一张“地图”。ePWM模块的寄存器不是胡乱堆在一起的，而是按照功能子模块进行了清晰的分组。这对于我们编程和理解硬件行为至关重要。

2.1 寄存器分组与地址映射逻辑

根据TI的文档，每个ePWM模块实例（如ePWM1， ePWM2...）都有一套完整的、结构相同的寄存器组。它们的基地址在芯片的数据手册中定义，通常是连续的内存空间。寄存器按子模块分组排列，这种设计让代码的模块化和可读性大大增强。

举个例子，假设ePWM1的寄存器组基地址是0x6800。那么时间基准子模块（TB）的第一个寄存器TBCTL的地址就是0x6800 + 0x0000 = 0x6800。紧接着，TBSTS在0x6801，以此类推。这种“基地址+偏移量”的映射方式，是嵌入式外设编程的通用模式。

关键点在于：每个ePWM模块（ePWM1， ePWM2， ... ePWMn）都有一套这样的寄存器组，地址连续递增。这意味着你可以用相同的代码结构去初始化不同的ePWM模块，只需改变操作的基地址即可。在C语言中，我们通常通过TI提供的驱动程序库（DriverLib）或直接定义结构体指针来访问这些寄存器，后者能提供最佳的性能和直观性。

2.2 核心寄存器功能速览与“影子”机制初探

寄存器列表很长，但我们可以先抓住几个最核心的，理解它们的功能和那个关键的“Shadow”（影子）属性。

时间基准子模块寄存器：

• TBCTL (0x0000)：这是TB子模块的“大脑”。配置计数器模式（递增、递减、递增-递减）、时钟预分频、同步使能等都在这里。它没有影子寄存器，写进去立即生效。
• TBPRD (0x0005)：周期寄存器，决定PWM的频率。这是PWM的“心跳”节拍器。它有影子寄存器。这个“有影子”属性是避免输出毛刺的关键，我们后面会细说。
• TBCTR (0x0004)：计数器寄存器，实时反映当前计数值。只读，用于监控。

计数器比较子模块寄存器：

• CMPCTL (0x0007)：CC子模块的控制中心，主要控制CMPA和CMPB的影子加载模式。
• CMPA (0x0009)和CMPB (0x000A)：比较寄存器，直接决定PWM的占空比或特定事件发生的时刻。它们都有影子寄存器。

“影子寄存器”是什么？你可以把它想象成一个“缓冲区”或“预备区”。当寄存器被标记为“Shadowed”时，你软件写入的值并不是直接进入控制硬件的“活动寄存器”，而是先进入这个“影子寄存器”。硬件会在一个安全的时刻（例如，当计数器TBCTR归零时），自动将影子寄存器里的值更新到活动寄存器中。

为什么需要它？想象一下，你的PWM正在输出一个驱动电机的关键脉冲，此时CPU突然改写CMPA值来调整占空比。如果这个写入是立即生效的，且恰好发生在计数器值与旧CMPA值相等的瞬间之后、与新值相等之前，可能会导致当前脉冲宽度出现一个非预期的、极窄的“毛刺”或“缺口”。在高频、大电流的功率应用中，这种毛刺足以引起电磁干扰，甚至导致桥臂直通，损坏器件。影子机制通过将参数更新同步到计数器周期的边界（如零点或周期点），完美避免了这种异步写入带来的风险。

EALLOW保护： 列表中有些寄存器标注了“EALLOW”。这是C2000系列的一个安全特性，用于保护关键的系统配置寄存器（如PIE向量表、时钟配置等）。对这类寄存器进行写操作前，必须执行EALLOW汇编指令（在C中通常有宏EALLOW）；操作完成后，执行EDIS。这是为了防止程序跑飞时意外修改关键配置。在ePWM中，像TBPHS（相位寄存器）、一些HRPWM和Trip-Zone相关的寄存器就受此保护。编程时务必注意，否则写操作会被忽略。

3. 时间基准子模块：PWM节拍器的精密构造

时间基准子模块是整个ePWM的“时钟心脏”，它生成了最基础的时基信号，所有其他子模块的动作都以此为准。

3.1 核心功能与寄存器配置详解

TB子模块的核心任务是产生一个可自由配置的计数器TBCTR，并由此产生关键的时间事件。

1. 时钟源与预分频： 系统时钟SYSCLKOUT通常频率很高（例如90MHz或200MHz）。直接用它来驱动计数器会导致周期分辨率过低（计数器跑得太快）。TBCTL寄存器中的CLKDIV和HSPCLKDIV位域用于对SYSCLKOUT进行分频，产生时间基准时钟TBCLK。例如，SYSCLKOUT=90MHz，设置CLKDIV为/2，HSPCLKDIV为/1，则TBCLK = 90MHz / 2 = 45MHz。TBCLK的周期（TTBCLK）就是计数器计数的最小时间单位。

2. 计数器模式与周期计算： 这是理解PWM波形对称性的关键。通过TBCTL[CTRMODE]位配置。

• 递增模式 (Up-Count)：
  • 计数器从0开始，每个TBCLK加1，直到等于周期值TBPRD，然后瞬间归零，重新开始。
  • PWM周期：Tpwm = (TBPRD + 1) * TTBCLK
  • 特点：生成非对称PWM。波形事件只在计数器递增时发生。常用于简单的开关控制。
• 递减模式 (Down-Count)：
  • 计数器从TBPRD值开始，每个TBCLK减1，直到等于0，然后瞬间重载为TBPRD，重新开始。
  • PWM周期：Tpwm = (TBPRD + 1) * TTBCLK（公式与递增模式相同）
  • 特点：同样生成非对称PWM。
• 递增-递减模式 (Up-Down-Count)：
  • 计数器从0开始递增到TBPRD，然后立即转为递减回到0，如此循环。
  • PWM周期：Tpwm = 2 * TBPRD * TTBCLK
  • 特点：生成对称PWM（中心对齐PWM）。这是电机控制和数字音频功放中最常用的模式，因为它产生的谐波特性更好，有利于减小电磁干扰。在计数上溢和下溢点（TBPRD和0）都会产生事件，为复杂控制提供了更多时间点。

3. 相位控制与同步： 这是实现多路PWM协同工作的基石。涉及寄存器：TBPHS（相位寄存器）、TBCTL[PHSEN]（相位加载使能）、TBCTL[SWFSYNC]（软件强制同步）。

• TBPHS：存储一个相位值。当发生同步事件时，这个值会被加���到计数器TBCTR中。
• 同步输入 EPWMxSYNCI：可以来自外部引脚（对ePWM1）或上一个ePWM模块的输出（ePWMxSYNCO）。例如，ePWM2的SYNCI可以连接ePWM1的SYNCO。
• 工作机制：当TBCTL[PHSEN]=1时，一旦检测到EPWMxSYNCI脉冲（或软件强制同步SWFSYNC），硬件会在下一个TBCLK边沿，将TBPHS的值加载到TBCTR中。这就实现了从模块与主模块的相位对齐。
• 应用场景：在三相逆变器中，你需要6路PWM驱动上下桥臂。你可以将ePWM1设为主模块，ePWM2和ePWM3设为从模块。ePWM2的TBPHS设置为TBPRD/3，ePWM3的TBPHS设置为2*TBPRD/3。当ePWM1的SYNCO触发同步时，三个模块的计数器将分别从0、TBPRD/3、2*TBPRD/3开始计数，自然就产生了相位互差120度的三相对称PWM波。

4. 全局时钟同步 TBCLKSYNC： 这是一个位于系统控制寄存器中的位，而非ePWM模块内。它的作用是让所有ePWM模块的TBCLK时钟边沿对齐。

• 正确启用顺序（务必遵守）：
  1. 使能各个ePWM模块的时钟（通过PCLKCRx寄存器）。
  2. 将TBCLKSYNC位写0（停止所有ePWM的时基时钟）。
  3. 配置所有ePWM模块的TBCTL（包括预分频器CLKDIV/HSPCLKDIV）。
  4. 将TBCLKSYNC位写1（同时启动所有ePWM的时基时钟）。
• 为什么需要这个步骤？如果各个ePWM模块的时钟不同步，即使软件配置的相位差是精确的，硬件上也会因为时钟启动时间的微小差异而产生随机的初始相位偏移，导致多路PWM无法精确同步。这个步骤确保了所有ePWM模块的计数器从第一个时钟沿开始就是对齐的。

3.2 影子寄存器实战：TBPRD的安全更新

让我们以TBPRD为例，深入看看影子寄存器如何工作。TBPRD控制PWM周期，在线调整频率时，必须保证更新过程平滑无毛刺。

寄存器双胞胎：TBPRD（0x0005）和它的影子寄存器。在内存映射中，你只看到0x0005这个地址。是写影子还是写活动寄存器，由TBCTL[PRDLD]位决定。

立即加载模式 (TBCTL[PRDLD] = 1)：

• 写入：你写入0x0005地址的值，直接进入活动寄存器，立即生效。
• 读取：你从0x0005地址读出的值，是活动寄存器的当前值。
• 风险：如果在计数器运行过程中（比如TBCTR=50时）写入新的TBPRD值（比如从1000改为500），计数器会立刻以新的周期值（500）作为目标。如果此时TBCTR（50）小于新TBPRD（500），则继续计数；如果大于（比如旧TBPRD是100，新的是50，而TBCTR当前是60），行为可能不确定或立即触发CTR=PRD事件，造成波形严重畸变。
• 使用场景：初始化阶段，或者对实时性要求极高、且能确保在计数器安全点（如停止计数器后）进行更新的场合。

影子模式 (TBCTL[PRDLD] = 0， 默认)：

• 写入：你写入0x0005地址的值，进入影子寄存器。活动寄存器不受影响，PWM继续以旧周期运行。
• 读取：你从0x0005地址读出的值，是影子寄存器的值。
• 加载时机：硬件会在TBCTR = 0x0000（计数器归零）的时刻，自动将影子寄存器的值复制到活动寄存器中。
• 优势：更新被同步到了周期的自然边界，确保整个PWM周期是完整的，不会出现半个旧周期加半个新周期的“撕裂”现象，输出波形连续平滑。
• 代码示例：

  // 假设我们运行在递增-递减模式，希望在下一个周期开始时改变频率 EPwm1Regs.TBCTL.bit.PRDLD = TB_SHADOW; // 确保处于影子模式（默认） EPwm1Regs.TBPRD = new_period_value; // 写入影子寄存器，当前周期不变 // 硬件会在下一个 TBCTR=0 的时刻，自动将 new_period_value 加载到活动寄存器 // 因此，从再下一个周期开始，PWM频率改变

注意：在影子模式下，如果你需要读取当前正在使用的周期值（活动寄存器的值），不能直接读TBPRD（那会读到影子值）。TI提供了镜像寄存器TBPRDM（地址0x002B）用于此目的。在影子模式下，读取TBPRDM得到的是活动寄存器的值。这是一个非常容易忽略的细节！

4. 计数器比较子模块：PWM占空比的雕刻师

时间基准生成了均匀的时间流，而计数器比较子模块则是在这个时间流上“刻下标记”，告诉动作限定模块在何时该翻转电平，从而形成占空比。

4.1 核心功能与寄存器配置详解

CC子模块的核心是CMPA和CMPB这两个比较寄存器，以及控制它们如何更新的CMPCTL寄存器。

1. 比较事件生成： CC子模块持续将时间基准计数器TBCTR的值与CMPA和CMPB的值进行比较。

• 当TBCTR == CMPA时，产生CTR = CMPA事件。
• 当TBCTR == CMPB时，产生CTR = CMPB事件。 这两个事件被输出到动作限定子模块，用于触发输出电平的切换，从而决定EPWMxA和EPWMxB输出的占空比。

2. 影子加载模式： 和TBPRD类似，CMPA和CMPB也有影子寄存器，其使能由CMPCTL[SHDWAMODE]和CMPCTL[SHDWBMODE]控制。

• 影子模式 (SHDWxMODE = 0， 默认)：写入CMPA/CMPB的值进入影子寄存器。加载到活动寄存器的时机由CMPCTL[LOADAMODE]和CMPCTL[LOADBMODE]位决定，可以是：
  • CTR=PRD：在计数器达到周期值时加载（递增模式的顶部，递增-递减模式的峰值）。
  • CTR=ZERO：在计数器归零时加载。
  • CTR=PRD or CTR=ZERO：在以上两个时刻都加载。
• 立即加载模式 (SHDWxMODE = 1)：写入操作直接修改活动寄存器。

3. 不同计数模式下的行为： 这是理解占空比计算的关键。

• 递增模式：
  • 计数器从0到TBPRD。假设CMPA=300， TBPRD=1000。
  • 每个PWM周期内，只有当TBCTR从0递增到300时，会触发一次CTR=CMPA事件。
  • 占空比：Duty Cycle = (CMPA / (TBPRD + 1)) * 100%。对于CMPA=300， 占空比约为30%。
• 递减模式：
  • 计数器从TBPRD到0。逻辑与递增模式类似，但动作限定模块通常配置为在递减比较时触发动作，以生成有效的PWM。
  • 占空比公式相同，但控制逻辑相反。
• 递增-递减模式（最常用）：
  • 计数器从0 -> TBPRD -> 0。假设CMPA=300。
  • 在一个完整的PWM周期内，会触发两次CTR=CMPA事件：一次在递增过程（TBCTR从299到300），一次在递减过程（TBCTR从301到300）。
  • 占空比：Duty Cycle = (CMPA / TBPRD) * 100%。注意这里分母是TBPRD，不是TBPRD+1。对于CMPA=300， TBPRD=1000，占空比为30%。
  • 重要特性：对称PWM的波形是关于周期中心对称的。通过配置动作限定模块，可以利用这两次比较事件来生成对称的开关动作，例如在递增比较时置高，在递减比较时拉低，从而产生一个中心对齐的PWM脉冲。

4.2 实战配置：生成一个中心对齐PWM

假设我们需要用ePWM1的EPWM1A通道产生一个频率为10kHz，占空比为30%的中心对齐PWM。系统时钟SYSCLKOUT = 90MHz。

步骤1：计算时基参数

1. 选择递增-递减模式，PWM周期Tpwm = 1 / 10kHz = 100us。
2. 设定TBCLK预分频，假设我们选择CLKDIV=1（即不分频），HSPCLKDIV=1，则TBCLK = SYSCLKOUT = 90MHz，TTBCLK ≈ 11.11ns。
3. 计算TBPRD：Tpwm = 2 * TBPRD * TTBCLK=>TBPRD = Tpwm / (2 * TTBCLK) = 100us / (2 * 11.11ns) ≈ 4500。我们取整为4500。
   • 验证实际频率：Fpwm_actual = 1 / (2 * 4500 * 11.11ns) ≈ 10.001kHz，误差可接受。

步骤2：计算比较值占空比30%，CMPA = TBPRD * DutyCycle = 4500 * 0.3 = 1350。

步骤3：寄存器配置代码

// 1. 启用ePWM1时钟 (通常在InitSysCtrl()函数中完成) // 2. 配置GPIO复用为EPWM1A输出 (略) // 3. 停止时基时钟并配置TBCLK同步 (遵循标准流程) EALLOW; SysCtrlRegs.PCLKCR0.bit.TBCLKSYNC = 0; // 停止所有ePWM时基时钟 EDIS; // 4. 配置ePWM1时基子模块 EPwm1Regs.TBCTL.bit.CTRMODE = TB_COUNT_UPDOWN; // 递增-递减模式 EPwm1Regs.TBCTL.bit.PHSEN = TB_DISABLE; // 禁用相位加载（作为主模块） EPwm1Regs.TBCTL.bit.PRDLD = TB_SHADOW; // TBPRD使用影子加载模式 EPwm1Regs.TBCTL.bit.SYNCOSEL = TB_SYNC_DISABLE; // 禁止产生同步输出 EPwm1Regs.TBCTL.bit.HSPCLKDIV = TB_DIV1; // 高速时钟分频 EPwm1Regs.TBCTL.bit.CLKDIV = TB_DIV1; // 时钟分频 EPwm1Regs.TBPRD = 4500; // 设置周期值（写入影子寄存器） // 5. 配置计数器比较子模块 EPwm1Regs.CMPCTL.bit.SHDWAMODE = CC_SHADOW; // CMPA使用影子模式 EPwm1Regs.CMPCTL.bit.SHDWBMODE = CC_SHADOW; // CMPB使用影子模式 EPwm1Regs.CMPCTL.bit.LOADAMODE = CC_CTR_ZERO; // 在CTR=0时加载CMPA影子值 EPwm1Regs.CMPCTL.bit.LOADBMODE = CC_CTR_ZERO; // 在CTR=0时加载CMPB影子值 EPwm1Regs.CMPA.bit.CMPA = 1350; // 设置比较值A（写入影子寄存器） // 6. 配置动作限定子模块（决定比较事件如何驱动引脚） // 在递增-递减模式下，我们通常配置为： // 当 CTR=CMPA 且计数器递增时，将EPWMxA置高。 // 当 CTR=CMPA 且计数器递减时，将EPWMxA拉低。 EPwm1Regs.AQCTLA.bit.CAU = AQ_SET; // 递增时，CTR=CMPA，则置高 EPwm1Regs.AQCTLA.bit.CAD = AQ_CLEAR; // 递减时，CTR=CMPA，则拉低 // 7. 启动时基时钟 EALLOW; SysCtrlRegs.PCLKCR0.bit.TBCLKSYNC = 1; // 启动所有ePWM时基时钟 EDIS; // 8. 如果需要，使能ePWM1输出 (通过TZ或AQCTL配置，这里假设默认使能)

这段代码配置出的EPWM1A输出，就是一个标准的10kHz中心对齐PWM，占空比30%。CMPA的值（1350）被安全地存储在影子寄存器中，在每个PWM周期开始时（TBCTR=0）加载到活动寄存器，确保占空比切换平滑无毛刺。

5. 高级应用与避坑指南

理解了基础配置后，我们来看看一些高级应用场景和实际开发中容易踩的“坑”。

5.1 多模块同步与相位控制实战

场景：构建一个三相全桥逆变器，需要6路PWM（上下桥臂互补带死区），且三相之间相位互差120度。

方案：

1. 主从链设置：将ePWM1设为主模块，ePWM2和ePWM3设为从模块。ePWM1的SYNCO输出连接到ePWM2的SYNCI，ePWM2的SYNCO连接到ePWM3的SYNCI。
2. 时基配置：三个模块的TBPRD、计数模式、时钟分频必须完全一致。使用TBCLKSYNC确保它们的时基时钟同步启动。
3. 相位差设置：
   • ePWM1:TBPHS = 0，TBCTL.PHSEN = 0（主模块，忽略同步输入，或自身产生同步）。
   • ePWM2:TBPHS = TBPRD / 3，TBCTL.PHSEN = 1（使能相位加载）。
   • ePWM3:TBPHS = 2 * TBPRD / 3，TBCTL.PHSEN = 1。
4. 同步信号源：配置ePWM1的TBCTL.SYNCOSEL，使其在CTR=ZERO时产生同步输出脉冲（EPWM1SYNCO）。这个脉冲会触发ePWM2和ePWM3在下一个TBCLK边沿将各自的TBPHS值加载到TBCTR中。
5. 死区与互补输出：每个ePWM模块的A和B通道通过死区子模块（DB）配置为互补输出，并插入死区时间防止上下管直通。

关键点：相位寄存器TBPHS的值是有符号的16位整数。在递增-递减模式下，如果设置TBPHS大于TBPRD，计数器可能会从中间值开始，导致第一个周期不完整。通常我们将相位差控制在0到TBPRD之间。

5.2 影子寄存器更新与实时性权衡

影子模式保证了安全，但引入了一个PWM周期的延迟。当你写入新的CMPA值到影子寄存器后，必须等到下一个加载点（如CTR=0）才会生效。这对于需要极高动态响应的系统（如峰值电流模式控制）可能是个问题。

策略：

1. 预测性更新：在算法中提前计算下一个周期需要的占空比，并在当前周期早期就写入影子寄存器。这需要精确的时序控制。
2. 使用立即加载模式：在确保安全的时刻进行“立即加载”。例如，在电机控制中，可以在ADC采样中断中，根据采样值计算新占空比，并立即更新CMPA。但必须确保这个更新发生在当前PWM周期的“安全窗口”内，比如在计数器从0到CMPA的区间之外（对于递增模式，在CMPA到TBPRD之间更新是相对安全的）。这需要精细的中断响应时间管理。
3. 监控加载状态：CMPCTL寄存器有SHDWAFULL和SHDWBFULL状态位，指示影子寄存器是否已满（即是否有新值等待加载）。在写入前检查这些位，可以避免覆盖尚未加载的值。

5.3 常见问题排查实录

问题1：PWM没有输出。

• 检查清单：
  1. GPIO复用：确认对应引脚的GPIO MUX是否已正确配置为ePWM功能。
  2. 时钟使能：确认PCLKCRx寄存器中对应ePWM模块的时钟使能位已置1。
  3. TBCLK同步：是否按照“先停时钟->配置->启时钟”的顺序操作了TBCLKSYNC？
  4. 输出使能：检查动作限定寄存器AQCTL是否已配置了有效的动作（SET/CLEAR/TOGGLE）。默认状态输出可能是高阻。
  5. Trip-Zone：检查TZ子模块是否强制将输出置为高阻、高或低电平。默认状态下TZ可能被禁用。

问题2：PWM频率或占空比不对。

• 检查清单：
  1. TBPRD计算：确认使用的公式与计数模式匹配（递增/递减用TBPRD+1，递增-递减用2*TBPRD）。
  2. TBCLK频率：检查SYSCLKOUT频率和TBCTL中的CLKDIV/HSPCLKDIV分频设置是否正确。
  3. 影子 vs 立即：确认TBPRD和CMPA/CMPB的加载模式。如果你在运行时修改了值但波形没变，很可能是因为处于影子模式，而写入后没有等到加载事件（CTR=0/PRD）。尝试读取活动寄存器的镜像（如TBPRDM）来确认当前硬件使用的值。
  4. 计数器模式：确认TBCTL.CTRMODE设置是否符合预期。占空比计算严重依赖于此。

问题3：多路PWM不同步，有随机相位差。

• 根本原因：各ePWM模块的TBCLK没有同步启动。
• 解决方案：严格遵循3.1节中提到的全局时钟同步（TBCLKSYNC）配置流程。确保所有模块的预分频配置一致后再同时启动时钟。

问题4：修改参数时输出出现毛刺。

• 几乎可以断定是影子寄存器使用不当。确保所有在PWM周期中动态更新的参数（TBPRD， CMPA， CMPB）都配置为影子模式，并理解其加载时机。避免在计数器运行于危险区间时更新立即加载模式的寄存器。

调试技巧：充分利用CCS的寄存器查看和图形化显示功能。实时观察TBCTR、CMPA、CMPB的值，以及EPWMxA/B引脚的实际波形。将理论计算的时间点与波形上的跳变沿对齐，是排查问题最直接的方法。另外，在初始化代码中，养成先停止计数器（TBCTL.CTRMODE = TB_FREEZE），配置完所有参数后再启动的习惯，可以避免初始化过程中的不确定状态。