基于C2000的数字双向DC-DC转换器软件控制实践与架构解析-平芜编程栈

1. 项目概述：从模拟到数字，一个双向DC-DC转换器的软件控制实践

如果你正在设计一个需要能量双向流动的系统，比如电动汽车的车载充电机（OBC）、储能系统的双向变流器，或者任何需要在高压电池和低压电池/总线之间高效传递能量的场合，那么一个隔离式的双向DC-DC转换器几乎是标准答案。传统的模拟控制方案虽然成熟，但在面对复杂的控制策略、灵活的模式切换和高级保护功能时，往往显得力不从心。这时，数字控制方案的优势就凸显出来了。

我最近深度参与了一个基于TI C2000系列微控制器（具体型号是TMS320F28035）的300W隔离式双向DC-DC转换器项目。这个项目的核心挑战在于，它不仅要实现从400V高压（HV）总线到12V低压（LV）总线的降压（Buck）转换，还要能无缝切换到反向的升压（Boost）模式，并且所有控制、保护和模式切换逻辑都要通过软件来实现。这不仅仅是把模拟控制环路“数字化”那么简单，它涉及到整个系统架构的重新思考，尤其是软件架构的设计。

经过几个月的调试和优化，我们最终实现了一套稳定可靠的软件控制系统。这套系统的核心是一个C语言后台 + 汇编语言中断服务程序（ISR）的混合编程框架。简单来说，就是把对实时性要求极高的任务（比如每10微秒执行一次的ADC采样、控制算法计算和PWM更新）塞进用汇编精心编写的ISR里，确保时序的绝对精确；而像故障管理、模式切换、参数更新、通信这些“慢”任务，则交给C语言在后台循环中从容处理。这种架构在数字电源设计中非常经典，它很好地平衡了代码的可读性、可维护性和对实时性的苛刻要求。

这篇文章，我将为你彻底拆解这个双向DC-DC转换器的软件控制流程与实现细节。我会从最顶层的软件架构讲起，深入到中断服务程序（ISR）的每一行关键代码，解释控制环路（特别是2P2Z补偿器）是如何在数字域实现的，并分享我们在实现平滑模式切换和可靠保护功能时踩过的坑和总结的经验。无论你是刚刚接触数字电源的工程师，还是想深入了解C2000在复杂电源系统中应用的老手，相信都能从中获得一些实用的参考。

2. 软件整体架构与设计思路拆解

当我们决定用一颗MCU来控制一个功率变换器时，首先要解决的就是如何分配CPU资源。电源控制环路的带宽通常在几千赫兹到几十千赫兹，这意味着控制算法必须在极短的时间内（通常是几个微秒）完成采样、计算和更新。如果所有代码都跑在一个大循环里，任何一点延迟或不确定性都可能导致环路不稳定，甚至炸机。

2.1 C-后台/ASM-ISR框架：实时性的基石

我们采用的C-background/ASM-ISR框架是解决这一矛盾的精妙设计。它的核心思想是任务分离。

ASM-ISR（汇编中断服务程序）：这是系统的“心脏”。它由一个高优先级的定时器中断（通常是PWM的周期中断或零匹配中断）触发。在我们的项目中，这个中断以100kHz的频率执行，周期为10微秒。在这10微秒内，ISR必须完成以下关键任务：
1. 上下文保存：保护现场，将关键的CPU寄存器压栈。
2. ADC采样与数据搬运：触发ADC对关键信号（如HV/LV侧电压、电流）进行采样，并将结果读取到指定的内存位置。这里使用了C2000的ADC序列器（SOC）和DMA（或直接内存访问）来高效完成。
3. 控制算法执行：将采样值进行标幺化或格式化（例如转换为Q格式定点数），然后执行控制算法（如2P2Z补偿器），计算出新的控制量（Buck模式下的相位移或Boost模式下的占空比）。
4. PWM寄存器更新：将计算出的控制量写入对应的ePWM模块的比较寄存器（CMPA/CMPB）或相位寄存器（TBPHS），从而在下一个PWM周期生效。
5. 上下文恢复与返回：恢复现场，退出中断。所有这些操作都必须用汇编语言精心编写，以确保指令周期数确定、执行时间可预测。一个常见的经验是，ISR的执行时间最好控制在中断周期的50%以内，为其他中断和后台任务留出余地。在我们的100kHz系统中，ISR执行时间被严格限制在5微秒以内。
C-background（C语言后台循环）：这是系统的“大脑”。它在主循环for(;;)中运行，负责所有非实时或准实时任务：
- 系统初始化：配置系统时钟、外设时钟、GPIO、ADC、ePWM、比较器等。
- 故障管理与保护：周期性检查过压、欠压、过流标志，执行保护动作（如封锁PWM）。
- 模式切换逻辑：根据外部命令（如Buck0_Boost1变量）和安全条件，执行Buck与Boost模式之间的切换序列。
- 参考值斜坡（Slew）控制：对电压/电流指令进行斜坡处理，避免阶跃变化对系统造成冲击。
- 控制参数更新与计算：例如，根据用户通过GUI设置的P、I、D参数，计算2P2Z控制器的系数B0, B1, B2, A1, A2。
- 通信：处理CAN、SCI等通信接口，接收指令或上传状态。
- 仪器与监控：将关键变量（如电压、电流、状态字）整理供上位机读取。

这种架构的优势非常明显：实时任务得到保障，非实时任务不会干扰关键时序，代码模块化程度高，易于调试和维护。你可以专心优化ISR的效率，而后台循环的逻辑可以写得更加清晰和健壮。

2.2 模块化软件库：构建数字控制系统的“乐高积木”

TI为C2000数字电源应用提供了一套强大的Digital Power Library。这套库将常用的功能封装成可重用的模块，比如PWMDRV（PWM驱动）、ADCDRV（ADC驱动）、CNTL_2P2Z（2极点2零点补偿器）等。每个模块通常包含一个C语言的配置函数（*_Cnf.c）和汇编语言的初始化与运行时宏。

在我们的双向DC-DC项目中，主要用到了以下几个库模块：

C配置函数	ASM初始化宏	ASM运行时宏	功能描述
`ADC_SOC_Cnf.c`	`ADCDRV_4CH_INIT`	`ADCDRV_4CH`	配置并驱动ADC对4个通道进行顺序采样。
`PWM_PSFB_VMC_SR_Cnf.c`	`PWMDRV_PSFB_VMC_SR_INIT`	`PWMDRV_PSFB_VMC_SR`	生成用于相位偏移全桥（Buck模式）及同步整流的PWM波形。
`PWM_BIDIR_BOOST_Cnf.c`	`PWMDRV_BIDIR_BOOST_INIT`	`PWMDRV_BIDIR_BOOST`	生成用于推挽（Boost模式）及高压侧同步整流的PWM波形。
(无独立C文件)	`CNTL_2P2Z_INIT`	`CNTL_2P2Z`	实现一个通用的2P2Z数字补偿器。

使用这些模块就像搭积木。在main.c的初始化部分，我们调用C配置函数来设置模块参数（如ADC通道映射、PWM频率、死区时间等）。在汇编ISR的初始化段（_DPL_Init），我们调用ASM初始化宏来完成硬件寄存器的最终配置。最后，在ISR的运行时段（_DPL_ISR），我们调用ASM运行时宏，传入输入变量（如ADC采样值、参考值），并获取输出变量（如占空比、相位）。

这种模块化设计带来了巨大的灵活性。例如，如果你想将电压模式控制（VMC）改为平均电流模式控制（ACMC），理论上你只需要改变反馈信号接入CNTL_2P2Z模块的来源，而无需重写整个控制逻辑。这也为增量构建（Incremental Build）提供了可能——你可以先构建一个开环系统验证PWM和ADC驱动，再逐步加入控制环路，极大地降低了调试复杂度。

2.3 工作模式与无缝切换策略

这个双向转换器有两个核心工作模式：

Buck模式（降压，能量从HV流向LV）：采用相位偏移全桥（PSFB）拓扑。控制的核心变量是相位移，即全桥对角开关管驱动信号的重叠时间，它决定了传递到副边的能量。同步整流（SR）用于提高低压侧效率。
Boost模式（升压，能量从LV流向HV）：采用电流馈电推挽（Current-Fed Push-Pull）拓扑。控制的核心变量是占空比，即推挽开关管的导通时间。高压侧的全桥开关管在此模式下工作于同步整流状态，以替代体二极管，进一步提升效率。

模式无缝切换是软件设计的难点和亮点。粗暴地关闭一种模式再开启另一种模式会导致总线电压跌落或过冲，可能损坏负载或电源。我们的策略是：

状态机管理：在后台循环的定时任务（如Timer 1 Tasks中的Mode change）中实现一个状态机。
预同步与软启停：
- Buck -> Boost切换：当接收到切换命令（Buck0_Boost1 = 1）后，软件首先执行Buck模式的“软关机”序列，逐步减小相位移至零，关闭PWM。然后，它将Boost模式的输出电压指令（Gui_VhvSet）设置为略高于当前HV总线电压的值（例如当前值+4V），再以受控的斜率启动Boost模式控制器。这样可以避免在切换瞬间产生大的电流冲击。
- Boost -> Buck切换：过程类似，执行Boost模式软关机，然后将Buck模式的输出电压指令（Gui_VlvSet）设置为略高于当前LV总线电压的值（例如当前值+0.5V），再启动Buck模式。
硬件资源复用：巧妙利用ePWM模块。例如，ePWM4在Buck模式下驱动低压侧的同步整流管（Q5, Q6），在Boost模式下则驱动低压侧的推挽开关管（同样是Q5, Q6）。通过软件在模式切换时重新配置ePWM4的动作限定器（AQ）和死区（DB）模块，实现了同一组硬件资源服务两种不同拓扑，节省了GPIO和代码复杂度。

3. 核心模块解析与关键实现细节

理解了顶层架构，我们深入到几个最核心的模块，看看它们是如何具体工作的。

3.1 中断服务程序（ISR）的解剖

ISR是实时控制的引擎。我们的ISR汇编文件（例如Bi-dir-DPL-ISR.asm）结构清晰：

_DPL_ISR: ; 1. 上下文保存 SAVE_CONTEXT ; 2. ADC驱动模块执行 - 读取4个通道的采样值 ADCDRV_4CH _AdcMirror.ADCRESULT0, _AdcMirror.ADCRESULT1, _AdcMirror.ADCRESULT2, _AdcMirror.ADCRESULT3 ; 3. 读取模式标志，决定执行哪条控制路径 TBIT _Buck0_Boost1, BIT0 BF _RunBoostMode, TC _RunBuckMode: ; Buck模式控制路径 ; 3.1 读取LV侧电压反馈(Adc_Vlv)，进行标幺化处理 ... ; 3.2 执行2P2Z电压控制器 (CNTL_2P2Z:2)，输入为VlvSetSlewed和Adc_Vlv，输出为相位命令(phase) CNTL_2P2Z CNTL_2P2Z_CoefStruct2, _Adc_Vlv, _VlvSetSlewed, _phase ; 3.3 执行PSFB PWM驱动，更新ePWM1/2/4的寄存器 PWMDRV_PSFB_VMC_SR _phase, _dbAtoP_leg, _dbPtoA_leg, _i_min BF _ISR_End, UNC _RunBoostMode: ; Boost模式控制路径 ; 3.1 读取HV侧电压反馈(Adc_Vhv)，进行标幺化处理 ... ; 3.2 执行2P2Z电压控制器 (CNTL_2P2Z:1)，输入为VhvSetSlewed和Adc_Vhv，输出为占空比命令(duty) CNTL_2P2Z CNTL_2P2Z_CoefStruct1, _Adc_Vhv, _VhvSetSlewed, _duty ; 3.3 执行BIDIR_BOOST PWM驱动，更新ePWM4/1/2的寄存器 PWMDRV_BIDIR_BOOST _duty, _dbA_leg, _dbB_leg, _i_min _ISR_End: ; 4. 清除中断标志，恢复上下文，返回 RESTORE_CONTEXT IRET

关键细节与经验：

ADC采样时刻：在PSFB中，为了获得准确的平均输出电压，ADC采样时刻应设置在两个对角管同时导通（重叠期）的中点附近，此时变压器原边电压方波最平坦，副边整流后电压也最稳定，远离开关噪声。这通过配置ePWM模块的SOC（Start-of-Conversion）触发信号来实现。
变量格式：控制算法中大量使用Q格式定点数以提升速度。例如，相位phase和占空比duty常用Q24格式（1.0对应0x1000000），ADC结果常用Q12或Q24格式。必须清楚每个变量的Q格式，并在运算时注意精度管理和溢出保护。
模式判断分支：TBIT指令测试Buck0_Boost1变量的特定位，根据结果跳转到不同的控制路径。确保模式切换逻辑在后台任务中完成，ISR中只做简单的分支判断，避免在ISR内执行复杂的切换序列，否则会严重占用实时计算时间。

3.2 数字补偿器（2P2Z）的实现与调参

数字控制环路的性能很大程度上取决于补偿器的设计。我们选择了通用的2极点2零点（2P2Z）数字滤波器作为电压环补偿器，其传递函数为：

[ \frac{U(z)}{E(z)} = \frac{b_0 + b_1 z^{-1} + b_2 z^{-2}}{1 + a_1 z^{-1} + a_2 z^{-2}} ]

对应的差分方程（递归形式）为： [ u(k) = -a_1 u(k-1) - a_2 u(k-2) + b_0 e(k) + b_1 e(k-1) + b_2 e(k-2) ]

在代码中，CNTL_2P2Z模块就是实现这个方程。它维护一个状态缓冲区（DBUFF）来存储u(k-1),u(k-2),e(k-1),e(k-2)，并根据最新的误差e(k)和系数B0, B1, B2, A1, A2计算输出u(k)。

直接调节这5个系数对工程师来说非常不直观。因此，软件层做了一个巧妙的映射，将更直观的比例（P）、积分（I）、微分（D）系数转换为2P2Z的系数。映射关系如下（假设采用某种特定的离散化方法，如双线性变换）：

[ \begin{aligned} b_2 &= K_d' \ b_1 &= -K_p' - 2K_d' + K_i' \ b_0 &= K_p' + K_d' + K_i' \ a_1 &= -1 \ a_2 &= 0 \quad \text{(对于PID的特殊情况)} \end{aligned} ]

这样，工程师只需要在CCS的观察窗口中调节Pgain_Gui,Igain_Gui,Dgain_Gui这三个0-999之间的直观参数，后台任务（如Timer 1 Tasks中的2P2Z coefficient calculation）会自动将其转换为Q26格式的K_p', K_i', K_d'，再进一步计算出B0, B1, B2, A1, A2供ISR使用。当然，如果你有通过MATLAB或Mathcad等工具精确设计出的2P2Z系数，也可以直接修改b2_Gui, b1_Gui, ...等变量，并通过设置pid2p2z_GUI = 1来切换到直接系数模式。

调参实操心得：

先开环，后闭环：务必先运行开环构建（Build 1），验证PWM波形和ADC采样值正确，再进入闭环。
从小增益开始：先将Pgain,Igain,Dgain都设为很小的值（比如P=10, I=1, D=0）。
先调P，再调I，最后D：逐步增加P增益直到系统开始出现轻微振荡，然后回调至80%左右。接着加入积分I以消除静差，注意I太大会导致响应变慢或超调。微分D常用于改善动态响应，但会放大噪声，需谨慎使用。
利用实时仿真（Real-Time Emulation）：在CCS中使能实时模式，可以在控制器运行时动态调整参数并立即观察系统响应（如输出电压波形），这是数字电源调试的“神器”。
注意输出限幅（Clamping）：CNTL_2P2Z_CoefStruct结构体中包含OutMin和OutMax成员，用于限制控制器的输出，防止积分饱和（Integral Windup）和输出超出物理可实现范围（如占空比不能超过100%）。

3.3 PWM驱动模块的配置与同步整流策略

PWM生成是数字电源控制的最终执行环节。C2000的ePWM模块非常强大，但也需要精细配置。

Buck模式 (PWMDRV_PSFB_VMC_SR)：
- ePWM1 & ePWM2：分别控制全桥的两个桥臂。配置为递增计数模式，产生50%占空比的互补PWM对（带死区）。通过设置ePWM2的相位寄存器（TBPHS2）相对于ePWM1的偏移，来实现相位移控制。
- ePWM4：控制低压侧的同步整流管（SR）。配置为递增-递减计数模式，以产生中心对齐的PWM，有利于对称驱动。其开通关断逻辑与全桥PWM的相位移和同步整流模式（Mode 0/1/2）复杂相关，由PWMDRV_PSFB_VMC_SR宏内部逻辑处理。
- 同步整流模式：软件实现了三种SR模式以适应不同负载条件，优化效率。
  - Mode 0：二极管整流模式。SR管常关，仅在体二极管导通。适用于极轻载，避免SR开关损耗大于导通损耗。
  - Mode 1：理想二极管仿真模式。SR管仅在对应副边绕组有正向电压时导通。适用于轻载或突发模式。
  - Mode 2：互补导通模式（默认）。SR管在大部分时间导通，仅在另一对对角管导通前短暂关断以防止直通。适用于中重载，效率最高。
Boost模式 (PWMDRV_BIDIR_BOOST)：
- ePWM4：控制低压侧的推挽开关管（Q5, Q6）。配置为递增-递减计数模式，产生大于50%占空比、相位差180度的PWM对。
- ePWM1 & ePWM2：控制高压侧的全桥开关管，在此模式下工作于同步整流状态。它们的导通时刻与ePWM4的关断时刻同步，以实现能量的正向传递。

配置注意事项：

死区时间（Dead Band）：必须为互补驱动的开关管对（如ePWM1A/B）配置足够的死区时间，防止上下管直通。死区时间需要根据MOSFET的开关速度和驱动能力来调整。
故障联防（Trip Zones）：将过流比较器（COMP）的输出连接到ePWM的TZ输入，并配置为单次触发（One-Shot）模式。一旦发生过流，PWM输出立即被强制为安全状态（低电平），并且需要软件复位才能恢复。这是硬件级别的保护，响应速度极快。
相位/占空比更新时机：必须在PWM周期的安全点更新比较寄存器或相位寄存器，通常是在计数器为零（CTR=0）或等于周期值（CTR=PRD）时，以避免产生毛刺。我们的ISR正是在ePWM1的零匹配（ZRO）事件中触发的，确保了更新的同步性。

4. 从零构建与调试：一个完整的实操流程

理论讲得再多，不如动手做一遍。下面我将结合项目文档，梳理出一个从零开始构建、加载、运行和调试这个双向DC-DC项目的完整流程，并补充大量文档中未提及的实操细节和避坑指南。

4.1 开发环境搭建与项目导入

硬件连接（安全第一！）：
- 在给板子通电前，务必确认所有跳线帽（Jumper）已按文档要求安装或移除。错误的跳线可能导致短路或损坏。
- 将F28035 controlCARD牢固插入100-pin DIMM插座。
- 连接12V辅助电源到TP10和TP11（注意极性！）。
- 重要：在接通高压（400V）输入之前，必须在输出端（HV和LV端口）接上合适的负载（电阻或电子负载）。空载启动某些拓扑可能导致电压尖峰损坏器件。
- 使用隔离的可编程高压电源（0-400V）连接到HV输入接口，使用另一个隔离的12V电源连接到LV输入接口。隔离电源可以防止共地问题损坏测试设备或MCU。
- 最后，通过USB线连接板载仿真器到PC。
软件准备：
- 安装Code Composer Studio (CCS)，建议使用v5或更高版本。确保安装了C2000编译器工具链。
- 从TI官网下载controlSUITE或C2000Ware，找到对应的开发套件支持包。项目路径通常类似于：..\controlSUITE\development_kits\BI_DIRECTIONAL_DC_DC_400_12\v1_00_00_00\。
- 首次使用板载仿真器：可能需要运行program_ftdi.bat等脚本对板上的FTDI芯片进行编程，以启用JTAG调试功能。具体文件在支持包内。
导入项目：
- 打开CCS，选择Project -> Import Existing CCS/CCE Eclipse Project。
- 浏览到Bi_Directional_Full目录，选择Bi-dir_Full项目，点击Finish。
- 在Project Explorer中展开项目，熟悉主要文件结构：
  - Bi-dir-Main.c：主程序文件，包含main()函数、后台循环和任务调度。
  - Bi-dir-DevInit_F2803x.c：设备初始化文件，配置时钟、PLL、GPIO等。
  - Bi-dir-DPL-ISR.asm：核心的汇编中断服务程序。
  - Bi-dir-Settings.h：重要的全局设置和宏定义，如INCR_BUILD（选择构建等级）、VMC0_ACMC1（选择VMC或ACMC模式）等。

4.2 增量构建（Incremental Build）策略详解

文档中提到了Buck和Boost模式各自的增量构建（Build 1开环， Build 2闭环）。对于完整的双向项目，通常直接使用Build 2（闭环）进行测试。但理解增量构建的思想至关重要：

Build 1 (开环检查)：目的是验证硬件和底层驱动。程序运行后，PWM以固定的相位或占空比输出，不闭合电压环。你可以在CCS中手动改变phase或BoostDuty变量，同时用示波器观察PWM波形是否正确，用万用表或CCS观察窗口查看ADC采样值是否与实际电压/电流相符。这是排查传感器电路、驱动电路和ADC配置问题的第一步。
Build 2 (闭环运行)：在Build 1验证无误后，切换到Build 2。此时控制环路闭合，你可以通过设置Gui_VlvSet或Gui_VhvSet来命令输出电压，控制器会自动调节相位/占空比来跟踪指令。

切换构建等级的方法：在Bi-dir-Settings.h文件中找到INCR_BUILD宏定义，将其修改为1或2，然后务必在CCS中对项目执行“Clean”操作（右键项目 -> Clean Project），再重新编译（Build All）。这是为了确保所有文件根据新的宏定义重新编译。

4.3 代码调试与实时监控

编译与加载：
- 设置好INCR_BUILD后，点击CCS的Build All按钮编译项目。
- 点击Debug按钮，CCS会编译代码并加载到F28035的Flash中。
- 程序会停在main()函数的开头。
配置观察窗口（Watch Window）：
- 这是调试数字电源最重要的工具之一。项目提供了一个JavaScript脚本（AddWatchWindowVars.js），可以通过View -> Scripting Console打开脚本控制台并运行它，自动将关键变量添加到Expressions窗口。
- 关键变量包括：
  - Adc_Vlv,Adc_Vhv,Adc_Ilv,Adc_Ihv：ADC采样值（通常是Q格式，需要根据电路换算回实际电压/电流）。
  - Gui_VlvSet,Gui_VhvSet：输出电压指令。
  - VlvSetSlewed,VhvSetSlewed：经过斜坡处理后的实际参考值。
  - phase(Buck),duty(Boost)：控制器输出的相位/占空比命令。
  - Buck0_Boost1：模式选择标志（0=Buck, 1=Boost）。
  - start_converter：使能转换器运行。
  - OC_FaultFlg,HVbus_OV,LVbus_UV等：故障标志位。
  - Pgainlv_Gui,Igainlv_Gui,Dgainlv_Gui：Buck环路的PID参数（GUI缩放版）。
启用实时仿真（Real-Time Emulation）：
- 在调试工具栏找到类似“实时模式”的按钮（通常是一个带箭头的处理器图标）并点击。当提示启用调试事件时，选择“Yes”。
- 原理：这会将CPU的调试使能屏蔽位（DGBM）清零，允许调试器在MCU运行时读取/修改变量和内存，而无需暂停程序。这样你就能在系统运行时动态观察波形、调整参数。
- 注意：实时模式会占用一部分JTAG带宽。如果观察的变量太多或刷新太快，可能导致通信缓慢。可以在Expressions窗口右键，调整“Continuous Refresh Interval”到一个合理的值（如1000ms）。

4.4 上电测试与模式切换实操

安全警告再次强调：高压操作存在风险！务必在经验人员指导下进行，佩戴护目镜，使用隔离设备，并确保负载连接可靠。

初始状态设置：
- 在观察窗口中，将start_converter设为0，Buck0_Boost1设为0（准备进入Buck模式）。
- 确认HV侧接有负载（如4-8kΩ电阻），LV侧接有负载（如10Ω电阻）。
供电与启动：
- 将高压电源设置为约225V，电流限制定在安全范围（如1A）。先不要打开输出。
- 将12V电源设置为12V输出。
- 依次打开12V电源、高压电源。
- 在CCS中点击Run（F8）运行程序。
- 将start_converter变量设为1。此时，你应该能听到轻微的变压器工作声音，LV侧输出电压应开始上升至略高于12V电源电压（约12.5V），因为Gui_VlvSet被自动设置为LV电源电压+0.5V。
Buck模式运行：
- 在观察窗口中，逐步增加Gui_VlvSet的值（例如设为13.0V），观察LV输出电压是否跟随。切记，Gui_VlvSet绝对不能设为低于12V电源电压的值，否则会试图从LV电池向HV电源倒灌能量，可能引发故障。
- 你可以尝试改变负载，观察控制环路是否能够稳压。
在线模式切换：
- 这是最精彩的部分。在Buck模式稳定运行的情况下，直接将Buck0_Boost1变量从0改为1。
- 观察：后台任务中的模式切换状态机会动作。你会先看到LV侧电压被控制软下降（Buck模式关闭），然后HV侧电压开始从225V上升至约229V（Gui_VhvSet被设置为当前HV电压+4V）。整个过程应该是平滑的，没有剧烈的电压跌落或过冲。用示波器捕获HV和LV总线电压，可以看到一个干净的模式切换波形。
- Boost模式运行：切换完成后，系统进入Boost模式。此时你可以修改Gui_VhvSet来调节HV侧输出电压。同样，Gui_VhvSet不能低于HV电源的电压。
切换回Buck模式：
- 将Buck0_Boost1从1改回0。
- 系统会执行Boost软关机，然后以LV电源电压+0.5V为目标启动Buck模式。

实操心得：

斜坡率（Slew Rate）：模式切换和参考值变化的平滑度由VlvSlewRate和VhvSlewRate等变量控制。如果切换过程有振荡，可以适当降低这些值。
保护点测试：在安全条件下，可以测试保护功能。例如，在Buck模式下，缓慢增加负载电流，观察过流保护（通过Ihv_trip或Ilv_trip设置阈值）是否动作，PWM是否被正确封锁。测试后需要通过复位MCU来清除故障。
控制参数整定：在实时模式下，你可以一边修改Pgainlv_Gui等参数，一边用示波器观察输出电压的动态响应（如负载阶跃变化），实现“在线调参”。这是模拟控制难以比拟的优势。

5. 常见问题排查与经验总结

即使按照指南操作，在实际调试中也可能遇到各种问题。下面是我总结的一些常见故障现象、排查思路和解决方案。

5.1 问题排查速查表

现象	可能原因	排查步骤与解决方案
编译通过，但加载程序后MCU无反应（PWM无输出）	1. 时钟配置错误。 2. ePWM或ADC模块未使能。 3. 看门狗（Watchdog）未禁用或未正确服务。 4. 程序未进入主循环或卡在初始化。	1. 检查`Bi-dir-DevInit_F2803x.c`中的时钟初始化（PLL, DIV）。 2. 检查外设时钟使能寄存器（`PCLKCR0/1`）。 3. 在初始化代码中禁用看门狗（`DisableDog()`）。 4. 使用CCS单步调试，检查程序执行流。
PWM有输出，但波形频率/相位不对	1. ePWM时基周期（TBPRD）计算错误。 2. 相位寄存器（TBPHS）更新逻辑错误。 3. 计数模式（Up/Down vs Up）设置错误。	1. 确认系统时钟频率（如60MHz）和期望的PWM频率（100kHz），计算正确的TBPRD值（例如600）。 2. 在ISR中检查`phase`或`duty`变量的计算和传递过程。 3. 核对`PWMDRV`宏的配置参数。
ADC采样值不正确或全为零	1. ADC采样触发源（ePWM SOC）未配置正确。 2. ADC通道选择错误。 3. 采样结果寄存器读取地址错误。 4. 传感器电路或信号调理电路故障。	1. 用示波器检查ADC输入引脚的实际电压。 2. 在CCS内存浏览器中查看ADC结果寄存器（`ADCRESULT0`等）的原始值。 3. 检查`ADC_SOC_Cnf.c`和`ADCDRV_4CH_INIT`宏中的触发源和通道配置。 4. 运行开环构建（Build 1），手动改变输入，观察ADC值是否线性变化。
闭环不稳定，输出电压振荡	1. 控制环路参数（PID）不合理。 2. ADC采样时刻不佳，引入了开关噪声。 3. 控制环路计算延迟过大。 4. 功率级参数（电感、电容）与控制带宽不匹配。	1.大幅降低P和I增益，先让系统稳定，再缓慢增加。 2. 调整ePWM的SOC触发点，避开开关瞬间。 3. 使用CCS的Profiling功能测量ISR执行时间，确保远小于10us。 4. 检查输出电容的ESR是否在合理范围。
模式切换时发生电压过冲或跌落	1. 模式切换状态机逻辑有误。 2. 参考值斜坡（Slew）设置过快。 3. 一种模式关闭时，另一种模式的控制器初始输出值不合理。	1. 仔细调试模式切换状态机（在`main.c`的后台任务中），添加更多状态标志进行跟踪。 2. 降低`VlvSlewRate`和`VhvSlewRate`。 3. 在切换前，将即将激活的控制器的输出初始化为一个安全值（如零或当前值）。
过流保护误动作或不动作	1. 比较器（COMP）参考DAC值设置不正确。 2. 电流采样电路增益或偏置错误。 3. 比较器输出到ePWM的Trip路径未正确配置。 4. 故障标志清除逻辑有问题。	1. 校准电流采样：在已知负载下，读取ADC值并计算比例系数。 2. 检查`DAC_Cnf.c`配置，确认`Ihv_trip`和`Ilv_trip`的Q格式与实际电流的对应关系。 3. 使用CCS在运行时修改Trip值，测试保护阈值是否准确。
代码在运行一段时间后跑飞	1. 中断嵌套或优先级冲突。 2. 栈（Stack）溢出。 3. 变量在中断和主循环中被同时访问（共享资源）未加保护。 4. 看门狗复位。	1. 简化中断结构，确保只有一个高优先级定时器中断用于控制。 2. 在链接命令文件（.cmd）中增加栈空间。 3. 对关键全局变量（如模式标志`Buck0_Boost1`）使用原子操作或关中断进行访问。 4. 确认看门狗已被禁用，或定时器中断服务程序中正确服务了看门狗。

5.2 关键经验与技巧分享

定点数运算的精度与溢出管理：这是数字控制中最容易出错的地方。务必为每个变量规划好Q格式（如Q24, Q15）。在乘法运算后，要注意左移或右移来对齐小数点。对于CNTL_2P2Z这样的递归算法，要特别注意状态变量（u(k-1),e(k-1)等）的饱和问题，防止积分饱和导致失控。CNTL_2P2Z模块自带的输出限幅（OutMin/Max）是必须合理设置的。
ISR的优化：ISR的执行时间直接影响系统带宽。除了用汇编编写，还要注意：
- 减少内存访问：尽量使用CPU寄存器，减少对全局变量的读写。
- 使用汇编宏：TI提供的ADCDRV,PWMDRV等宏已经过高度优化。
- 避免函数调用：在ISR中直接内联关键代码，避免调用子函数带来的额外开销。
- 使用CCS的Profile功能：精确测量ISR最坏情况执行时间（WCET），确保有余量。
利用实时仿真进行“虚拟仪器”调试：CCS的Graph功能非常强大。你可以将Adc_Vhv,phase等关键变量添加到时间图或FFT图中，实时观察它们的波形和频谱，就像连接了一台虚拟示波器或频谱分析仪。这对于观察环路动态响应、分析谐波成分极其有用。
版本管理与增量构建：强烈建议使用Git等工具管理代码。为每个重要的调试阶段（如开环验证、闭环调参、模式切换测试）创建分支或标签。增量构建（Build 1, Build 2）本身就是一种防御性编程策略，确保每一步都是坚实的。
安全与鲁棒性设计：
- 上电/下电序列：软件中应有明确的上电初始化序列和下电保护序列。
- 软件看门狗：除了硬件看门狗，可以增加一个在后台任务中踢的软件看门狗，监控主循环是否正常运行。
- 参数范围检查：对所有来自上位机或外部的指令（如电压设定值）进行上下限和变化率检查。
- 故障恢复策略：不是所有故障都需要硬复位。对于一些可恢复的故障（如瞬时过流），可以设计自动重试逻辑。

通过这个基于C2000的双向DC-DC项目，我们不仅实现了一个功能完整的电源转换器，更构建了一套可扩展、可维护的数字电源控制软件框架。从C/ASM混合编程的实时框架，到模块化的驱动库，再到精细的模式切换与保护逻辑，每一个环节都体现了数字控制相对于模拟控制的灵活性和强大潜力。希望这篇详尽的解析能为你自己的数字电源项目提供扎实的参考。在实际操作中，耐心和细致的调试永远是成功的关键。当你第一次看到系统在软件指令下平滑地从Buck模式切换到Boost模式时，那种成就感就是对所有努力的最好回报。