产品应用。

电源、功率级与控制板

伺服驱动的系统边界包含辅助供电、直流母线、三相功率桥、栅极驱动、采样与控制板。控制板决定目标和调制，功率级把母线能量送入电机，辅助电源维持控制与驱动器工作。三者启动和掉电次序影响输出许可，不能只凭MCU程序已经进入主循环就认为功率部分准备完成。

建立信号表时注明各电源监测、驱动器故障、PWM使能、制动与反馈接口的有效电平和默认状态。复位期间引脚可能高阻，硬件应提供符合设计的确定输出状态；软件初始化再接管。母线测量与栅极驱动欠压状态也要参与许可，避免控制电源正常而门极电源未建立时继续发出调制。

板卡带起按模块拆开：先确认低压供电和时钟，再验证采样、驱动逻辑与无功率PWM，最后在受控条件连接母线和电机。为每一步规定可观测量，记录板卡版本、配置和故障入口。参考设计中的额定电压、电流、布局和器件只适用于该设计；移植时应按实际硬件重新验证。

软件维护电源、功率准备、控制初始化和运行许可的独立状态，故障时保留哪个环节先失效。不要通过给一个总使能变量赋真绕过所有条件。联调中同时观察母线、驱动供电和输出许可的建立/释放顺序，重点覆盖上电抖动、部分掉电与复位后旧指令残留。

调试检查

• 记录控制供电、门极供电、母线检测及PWM许可的时间轴，检查任何未满足条件时不放行输出。
• 单独让辅助供电或驱动电源异常，核对故障原因、默认引脚状态和重新运行条件。

控制任务与通信接口

伺服固件通常把电流控制、较慢速度/位置控制、通信服务、参数管理和诊断分成有明确周期的执行路径。通信提供目标和模式，控制器在固定采纳点使用它们；收到一帧数据不能直接改变PWM执行节奏。实时预算应覆盖采样、反馈更新、控制计算、调制和实际寄存器装载。

接口定义把目标单位、正方向、限幅、有效状态和更新时间写清，形成完整命令快照。模式、控制字与目标不能由通信任务分别改写共享结构；消费者只接收验证完毕的同一版本。对PDO、串口或本地调试入口使用统一命令仲裁，明确当前控制来源与失联策略。

调度中电流快环避免阻塞访问、动态分配和无界日志；参数保存、协议长事务放入后台。速度和位置环降采样时，使用其真实周期计算离散增益，而不是把快环周期复制给全部环。任务优先级只是调度工具，还需测量抢占和临界区对截止时间的影响。

联调将协议到达、命令发布、控制采纳与输出生效分开观察，识别迟到目标还是快环超时。测试通信满负载、后台保存和故障上报并发，确认控制仍按预算执行。若只测平均CPU占用，可能忽略偶发的最坏路径；应记录超时计数和版本，而非凭界面刷新正常判定实时性。

调试检查

• 同时施加PDO更新与后台参数操作，量测快环最坏完成时间及命令年龄。
• 切换控制来源与模式，确认被采纳的目标属于同一快照且旧来源不能继续写入。

电机、反馈与机械负载

伺服响应由电机电气参数、位置反馈、机械惯量、传动比、摩擦和弹性共同决定。控制器的输入不应只有电机额定功率，还需极对数、磁链或转矩系数、绕组参数、反馈分辨率及负载方向。相同电机接不同负载时，速度环与位置环的整定和限幅条件可能完全不同。

建立电机与负载参数表，标明单位和测量/手册来源。电机轴与负载轴位置通过传动比换算，编码器装在不同位置会改变闭环看到的误差。弹性联轴器、减速器间隙和机械共振不能靠提高控制增益直接消除；应先识别反馈安装位置和机械约束，再选带宽与滤波。

反馈链路应有有效性与数据新鲜度标识，失效时不把最后角度永久当成当前角度。增量编码器上电通常不提供绝对电气零位，是否需要对齐、找零或保留位置由实际结构决定。带抱闸系统还需明确抱闸开闭时机、承载条件及其与驱动力矩的配合。

带起测试先验证正负方向、反馈计数与机械动作一致，再在限流、限速条件下逐级连接闭环。负载变化时记录惯量估计、跟随误差、控制输出和限制状态，区分参数错误、反馈延迟与机械约束。不能把空载一次往返成功推广为全负载定位性能或安全停机能力。

调试检查

• 对照电机轴和负载轴运动，核查传动比、正方向、极对数及反馈计数换算。
• 改变负载或机械连接后重复误差与限制状态记录，确认整定结论覆盖了实际工况。

系统约束与验证入口

伺服验收需要把定位、速度、转矩、温升和通信要求变成明确工况下的可观察指标。每项指标都写明母线、负载、温度、轨迹、持续时间和反馈条件；一句“高精度”无法形成测试。能力还受电流、可用电压、机械速度和散热约束，不能要求控制器在饱和后仍维持同样动态响应。

验证入口按依赖建立：采样校准、相序与角度、PWM/ADC时序、电流环、速度环、位置轨迹和通信控制。每一步保存通过条件与原始记录，失败停在最接近原因的层。软件单元测试适合单位换算、限幅和状态逻辑，真实电流波形、延迟和机械误差则需要目标硬件。

对限制工况建立独立观察量，包括电压饱和、电流限幅、跟随误差、命令过期和故障反应。输出达到限制时，日志应显示实际采用目标而不是仅保存主站给定。这样可区分系统能力不足与控制错误，也能判断积分器是否在持续累积而导致解除限制后突变。

回归覆盖冷热、不同方向和负载、通信扰动及故障恢复，并记录硬件/固件版本。测试未执行的范围明确保留，不用厂商参考设计结果代替自己的数据。修改采样率、反馈滤波、编译优化或功率板后，重新验证相关时序与性能，不能只确认代码能编译。

调试检查

• 将每条性能要求关联到具体工况、记录和判定，检查有没有缺少母线或负载边界的指标。
• 达到电压/电流限制再退出，观察积分状态、采用目标和误差恢复，确认没有隐藏突变。

逆变桥与栅极驱动

三相逆变桥通过上下管组合产生电机端电压，栅极驱动把MCU逻辑信号转换为适合功率器件的门极动作。PWM有效电平、上下桥臂关系、驱动模式与默认关断状态必须一起核对。逻辑波形看起来互补，不能证明实际门极无重叠；传播延迟、米勒耦合与器件开关时间都会影响结果。

软件配置死区、最小脉宽和故障输入时，应依据功率板与驱动器参数。驱动器内置握手、死区或保护功能不能凭名称默认全部生效，需要检查具体模式与寄存器。自举供电的高侧驱动还受刷新条件约束，高占空比或长时间静态导通可能影响门极电源，应纳入运行边界。

门极驱动强度与开关损耗、过冲和噪声之间存在取舍，不能只把开通速度调到最大。通信固件可负责读回配置与故障，快保护通路仍需按实际器件容限设计。更换MOSFET、IGBT或SiC器件时，重新检查门极电压、驱动电流、关断行为和采样噪声，不能仅修改电流额定值。

联调先在受控供电与无运行命令条件验证默认状态，再测逻辑输入和实际门极/相节点的对应关系。异常脉冲、驱动欠压或故障恢复可能出现在使能边缘，重点记录上电、停机与重新许可的过渡。参考设计的测试波形只能说明其器件与布局，不能为另一块板直接背书。

调试检查

• 对照PWM输入与实际上下管门极时序，检查死区、最小脉宽、默认关闭和故障后输出。
• 读回驱动器模式及保护配置，覆盖高占空比、欠压和使能切换，确认软件假设与硬件一致。

电流、电压与温度测量

伺服控制使用的电流、母线电压和温度来自不同采样链路，其带宽、单位和有效范围不能混为一谈。相电流用于闭环与诊断，母线用于电压能力和保护，温度反映较慢热状态。采样链路需明确传感器、增益、偏置、ADC参考和换算关系，以及超范围或无效数据如何标识。

电流零偏应在符合硬件条件的已知零电流状态测得，不是在电机带载运行时把平均值强制调成零。增益校准使用有依据的输入或参考测量，记录正负方向与通道差异。带PWM抑制的放大器仍存在建立时间和频率特性，采样窗必须结合实际共模跳变与前端响应验证。

电压与温度通道可采用较慢更新和适当滤波，但保护链需要独立考虑响应时间。温度传感器开路、短路或量程外读数不能被简单夹紧成一个正常温度。ADC触发、DMA缓冲和控制采用要有时间一致性，尤其两个相电流不同时采样时，重构与变换可能受到误差。

调试把原始ADC码、工程单位、校准值和有效标志同时记录，区分换算问题与真实噪声。改变母线、占空比和负载后观察零偏、波形与饱和，检查采样前端是否被过驱动。不要通过强滤波让界面波形平滑，却把相位延迟带入电流环而未重新验证稳定性。

调试检查

• 在已知零电流和正负输入条件核查偏置、增益和符号，再观察PWM切换时的建立时间。
• 断开温度或使ADC到量程边界，检查无效标识、故障动作和滤波延迟是否符合定义。

隔离与故障保护

功率系统中的隔离服务于电压域分离和信号传递，故障保护服务于检测与限制损坏，两者需要明确各自边界。隔离驱动器具有某种额定隔离能力，并不能证明整块板的间距、供电、连接器与系统均满足同样等级。器件手册参数必须结合实际布线、工作电压和系统要求解释。

保护链路列出过流、驱动欠压、过温及其他实际故障源，注明检测位置、阈值依据、关断路径和复位许可。快速硬件故障信号可直接限制PWM或门极，软件随后记录并锁存。不能把通信任务中的慢速电流告警当作短路保护，也不能只因有隔离器就认为噪声不会影响故障输入。

故障信号跨隔离域时要核对有效电平、失电默认值、脉宽与传播延迟，防止断线被解释为正常。驱动器消隐和软关断参数需依据器件容限配置，过度消隐可能错过危险事件，过快关断可能增大过压。软件应保存第一故障与现场快照，不让后继掉电状态覆盖原始原因。

验证分别覆盖故障输入通路、软件锁存、日志和恢复，而不是只调用一个模拟故障函数就宣称整条链通过。真实功率故障测试要由合适条件和人员按设计开展；低能量注入可先验证逻辑，但不能替代器件承受能力与实际关断时序。清除记录不等于允许输出恢复。

调试检查

• 从各实际故障源注入逻辑信号，测量到PWM/驱动禁止的时间并记录锁存与第一原因。
• 测试隔离侧失电或故障线无效，检查默认状态与恢复许可，避免失效时被当作正常。

安全功能的原理与边界

STO等安全功能讨论的是规定条件下限制产生转矩的能量，不等于普通软件停机，也不等于电机立即静止。惯量会继续运动，垂直负载可能需要机械抱闸，母线也可能保持危险电压。仅设置软件禁止PWM变量，不能证明STO已经实现。

安全链通常涉及专用硬件、冗余或诊断架构、故障分析和完整生命周期要求。TI的STO参考设计给出了特定架构与评估范围，使用其中某个器件或照抄一段逻辑并不自动继承其SIL或PL结论。自研产品是否符合要求，需要针对实际系统验证与评估。

普通驱动固件可以接收安全状态，禁止新的运行许可并输出诊断，但不应擅自绕过或自动复位独立安全链。状态报告要区分安全请求、硬件实际状态、普通驱动故障和机械静止信号。通信恢复或故障清除不是恢复安全许可的充分条件，重启策略要防止旧启动命令再次产生转矩。

工程梳理可先画能量路径和安全接口，列出断线、失电、单点失效及反馈矛盾时应观察的结果。验证软件接口不能替代安全硬件验证。任何测试报告应限定实际覆盖的通道、工况与故障类型，不把模拟STO输入、普通急停按钮或一次电机停转称为完整安全合规证据。

调试检查

• 分别记录安全请求、硬件许可和驱动运行状态，检查撤销许可后旧控制字不能自动重启。
• 评审测试结果的覆盖边界，区分参考设计评估、软件禁能测试与完整产品认证。

d/q 电流内环

以转子磁链定向的PMSM伺服为讨论对象，电流内环把相电流换算到旋转坐标，分别调节d、q轴电流，再经逆变换与调制产生电压指令。坐标正方向、相序、角度偏置及变换归一化要统一。d/q数值平稳不代表转矩方向正确，错误角度可能让电流分量看起来正常却偏离物理目标。

实现流程先校正采样偏置与比例，使用时间对齐的电角度完成变换，然后计算误差、PI、必要补偿与电压限幅，最后根据母线生成调制。PI增益定义应注明离散周期及积分项是否已经包含周期因子。电压限幅与积分抗饱和配合，避免指令超出母线能力后积分继续增长。

内环带宽受到采样到输出延迟、PWM更新、传感器噪声和电机参数限制，不存在所有伺服通用的固定倍率。先确认硬件与符号再整定增益。外环给定需要电流幅值与变化约束，d/q同时变化时应考虑电流矢量边界，而不是分别把两个轴都夹到同一最大值造成合成过流。

调试从受控的小电流指令开始，观察相电流、d/q反馈、电压采用值和饱和标志。正负阶跃与不同电角度下都要核对响应；仅一个固定角度成功不能证明全周一致。再用适当的方法估计带宽与稳定余量，厂商示例结果只能作参考，不是自研板卡已经达到的性能。

调试检查

• 在不同电角度给出小幅正负电流目标，检查相序、变换符号与反馈响应一致。
• 改变母线或达到电压限制后解除，核查抗饱和、积分状态和输出恢复没有突变。

转矩指令与限幅

转矩模式把外部机械目标转换为电流目标，但转换关系依赖电机模型、磁链、极对数、归一化和电流定义。表贴PMSM在特定假设下可简化转矩与q轴电流关系，内埋PMSM还涉及磁阻转矩；不能把一个固定Iq倍率推广给全部电机或把峰值与RMS电流混用。

产品参数表注明额定转矩、转矩系数的单位和电流基准，接口同时给出命令转矩、实际采用电流和限制原因。上层转矩倍率、机械传动方向和电角度方向要统一。内部限幅结合电机、功率器件、温度和可用电压，不能只按通信对象的数值类型上限允许输出。

动态指令需要幅值与变化速率限制，避免一步转矩跳变激发机械冲击。速度达到边界时，转矩模式也必须有明确策略；它不能像位置模式那样天然约束轴位置。限制改变时处理积分和目标交接，温度降额或母线变化不能让外环继续按已失效的能力积累误差。

验证先在无功率条件核对单位与编码，再在受控条件比较命令、dq电流与负载响应。实际转矩测量需要对应传感器与工况，不能仅从软件Iq换算值宣称测得输出转矩。正反方向、持续负载与短时峰值分别验证，记录采用值而不是只保存目标，从而解释限制为何发生。

调试检查

• 核对转矩系数、极对数及峰值/RMS基准，检查正负命令到Iq的方向与倍率。
• 触发热降额或速度边界，观察采用电流、限制原因和恢复过程，不以软件估算替代转矩实测。

前馈与解耦

伺服电流环中的前馈与解耦用于减少可预测的电压需求对PI误差的影响，常涉及旋转坐标中的交叉项和反电动势。它依赖电机参数、速度与符号约定，不能仅把网上公式的正负号搬进固件。先建立所用坐标方程，再核对实现中电气角速度、Ld/Lq和磁链单位。

把PI输出、前馈项与最终采用电压分开记录，限幅后将抗饱和反馈作用于实际控制结构。补偿也会占用电压余量，不能先分别限幅PI和前馈再相加超出调制边界。对参数误差或速度噪声，设计补偿有效范围和滤波/限幅，避免高增益前馈在启动或反馈无效时放大错误。

验证先在补偿关闭时建立可信内环，再单独开启某项比较扰动与转速变化下的电流误差。低速角度未锁定、速度估计突变或电感随电流变化时，模型补偿可能不准确，允许渐入或受限使用。某些FCL库有特定API与变量组织，移植时需按版本读实现，不靠变量名称推断公式。

调试重点是补偿是否在正确执行点使用同一周期的数据。速度采用旧样本而角度和电流采用新样本，会形成额外不一致。若开启补偿后振荡，先查单位、符号、延迟和饱和，而不是继续提高PI增益。结果需在不同方向和母线条件验证，不能凭一次高速波形更平滑就判定普遍有效。

调试检查

• 分别记录PI、前馈和限幅后电压，改变旋转方向检查交叉补偿符号与坐标方程一致。
• 补偿开关与参数偏差测试中比较误差和饱和，确认无效速度或角度不会放大输出。

采样延迟与纹波

伺服电流纹波由PWM开关、电机电感、母线、电流检测位置和控制输出共同决定，而显示曲线还受采样相位与滤波影响。不要把每次ADC都取到同一相位的平滑序列当成真实电流没有纹波。应区分瞬时开关纹波、控制周期变化与采样噪声，选择相应测量带宽和观察点。

闭环有效延迟包括模拟前端建立、ADC转换、中断等待、运算、PWM影子装载及其他数字滤波。缩短计算耗时只减少其中一部分。对单分流或低侧采样，还需验证占空比变化后有效窗口是否足够；窗口失效时不能把无意义样本硬塞进dq变换。

角度与电流的时间关系也影响高速电流误差，可依据已确认模型考虑延迟补偿，但先要知道真实延迟而非猜一个常数。滤波降低噪声会引入相位滞后，需要重新检查环路。PWM频率提高可能改善纹波却增加开关损耗和CPU负担，选择应结合功率与实时约束，而非只追求更细腻的曲线。

测量同时记录ADC触发、ISR开始/结束、PWM实际装载以及相电流波形，比较不同占空比、方向和母线。通信与后台任务满负载时也测最坏等待。若修改采样位置、驱动器开关设置或放大器后波形改变，应重新检查采样比例和窗口，不能只调PI把硬件采样缺陷掩盖。

调试检查

• 对照示波器电流波形与ADC样本相位，区分真实纹波、混叠和前端建立不足。
• 量出采样到PWM装载的完整延迟并覆盖高调制度窗口，检查无效样本与截止时间计数。

速度外环

速度环根据机械速度误差生成转矩或q轴电流目标，依赖电流内环先具备可信的跟随能力。其对象包含机械惯量、摩擦和负载转矩，与电流环的电气对象不同。整定前固定速度单位、方向、估算方法与更新周期；机械rpm、电气频率和每周期增量不能混用。

速度反馈常由位置差分、捕获周期或组合估算得到，低速量化与滤波延迟会影响控制。需要根据反馈分辨率和速度范围选择测量窗口，不能为了曲线平滑加入过强滤波却忽略相位。外环执行周期通常可以慢于电流环，但离散PI积分增益应使用外环实际周期。

输出限幅结合电机与功率级可用电流，速度目标还应有轨迹约束。电流饱和时速度PI进行抗饱和或有明确积分处理，避免负载解除后高速冲出。负载改变、机械共振或反馈噪声不应一概用更大增益处理；先观察电流采用值、速度误差及限制状态，判断是对象变化还是反馈链问题。

验证先给小幅速度阶跃和扰动，记录目标、反馈、电流目标与实际电流，再改变负载和方向检查稳定性。频率分析可辅助估计带宽与余量，但测试注入幅度和运行工况要适合系统。厂商双轴参考设计展示一种分析方法，不代表任意负载都能采用同一组增益或同一带宽比例。

调试检查

• 核查速度测量窗口和滤波延迟，比较低速、高速与换向时反馈是否连续且单位一致。
• 让电流达到限幅再卸载，观察速度积分状态和超调，确认抗饱和与目标斜坡有效。

位置环与级联关系

位置环把位置误差转换为速度或其他中间目标，再由速度和电流路径执行，形成不同时间尺度的级联。位置反馈可能来自电机轴，也可能来自负载侧，两者闭环对象不同。设计先明确轴坐标、零点、传动比、正方向和位置范围，不能只把编码器计数当作已经校准的机械位置。

带起顺序先验证电流环，再验证速度环，最后连接位置目标和轨迹。位置环带宽受内环能力、反馈延迟与机械结构限制，不应把三个环同时调大。最外环输出也有速度和加速度边界，位置误差较大时产生的目标必须受约束，否则可能在长距离命令下持续驱动内环饱和。

计算位置差时处理多圈数、计数回绕、最短路径还是指定方向，以及整型宽度。不能在回绕边界用直接减法得到一个巨大的假误差。回零、模式切换和反馈复位时需要重新对齐目标与坐标，避免坐标突然变化后控制器认为轴偏离目标而产生冲击。

验证包含小位移、长行程、正反方向、停留与跨回绕情况，观察位置误差、速度采用值和电流限制。机械间隙和弹性会导致电机轴定位正常而负载定位不符，需要根据反馈位置解释。只看最终到位数值不能判断整个轨迹是否稳定，也不能证明不同负载下的定位精度。

调试检查

• 在计数回绕、回零和模式切换时检查位置误差计算与目标重建，确认没有突发大给定。
• 分别观察电机轴与负载轴反馈，核查级联带宽、速度限幅和机械间隙对结果的影响。

指令轨迹与前馈

位置命令需要经过速度、加速度和必要时跃度约束，形成系统能够执行的轨迹。梯形速度与S曲线适用不同的机械平顺要求，选择取决于负载与周期预算。一个目标位置阶跃不能直接解释为可实现的瞬时运动；规划器输出的位置、速度和加速度应来自同一时间点的连续轨迹。

前馈利用规划轨迹的速度或加速度分量减少可预测的跟随误差，但不替代反馈纠错。单位、符号和注入点要与级联结构一致，速度前馈加在速度目标处，转矩前馈则需要负载模型与限幅。不能把轨迹导数重复加入多个环，或在目标缺帧后计算出异常加速度并放大输出。

通信周期与本地控制周期不同时，明确目标保持、插补或重规划规则，记录每个目标的有效时刻。收到新终点时处理当前速度和加速度，而不是每次重新从零速开始。规划器要考虑停止距离与行程限制，前馈总输出仍受电流和可用电压能力约束，并与积分抗饱和配合。

调试先关闭前馈验证基本轨迹，再分别开启速度和加速度项比较误差、超调与饱和。测试短行程、换向、连续目标更新和取消运动，检查轨迹连续性与停止行为。精度结论要绑定负载、速度和测量条件，不能因一个软件曲线与目标重合就称实际机械运动已经达到指标。

调试检查

• 连续改终点、取消及换向，检查位置/速度/加速度边界连续且停止距离符合约束。
• 分别开启前馈项，对照误差与限幅后输出，检查单位、符号及重复补偿。

跟随误差与动态响应

跟随误差表示期望轨迹与实际位置之间的偏差，其计算基准必须明确。主站最终终点、插补后瞬时目标和驱动本地受限目标并不相同；把终点减当前位置可能只是剩余行程，而非闭环跟随误差。位置和反馈若来自不同采样时刻，也会把时间差误认为控制误差。

监测一般结合幅值与持续时间，还需运行模式和有效反馈条件，避免短暂正常动态误差与持续失跟混为一谈。阈值单位按真实位置尺度定义，不能复制其他设备的编码器计数值。触发后采取何种停机、限制或故障反应，取决于机械和功率边界，不从一个错误位名字推断实际动作。

动态响应应同时观察轨迹、实际位置、速度、电流以及限制标志。误差可能来自电压饱和、转矩不足、通信迟到、反馈延迟或机械共振，不应只靠提高位置增益压小一个数值。统计稳态误差、峰值误差、恢复时间与不同方向表现，保留采样周期和数据对齐方法。

验证覆盖加减速、负载变化、连续目标更新和故障恢复，记录发生条件而非只截取最好看的曲线。监测可以在主机侧检查计算和时间窗，但实际停机距离、反馈链与机械位置需要硬件验证。Beckhoff平台监控参数是具体实现参考，不是所有自研驱动必须照抄的阈值与动作。

调试检查

• 用同一时基比较插补目标和反馈，确认监测的是跟随误差而不是剩余行程。
• 改变负载及限幅条件，记录峰值、持续时间和故障动作，检查阈值单位与停止策略一致。

编码器、Hall 与位置反馈

不同反馈器提供的分辨率、绝对性、延迟和失效信息不同。增量编码器通过相位变化计数，绝对编码器返回规定格式的位置，Hall通常提供较粗的转子区间。选择应依据启动、低速转矩、定位和环境要求；不能把信号能解码等同于满足所有伺服反馈需求。

增量链路核对A/B相位、计数倍率、Z脉冲处理、计数范围和输入滤波，绝对链路核对时钟、帧长度、校验、状态位与传输延迟。电缆、供电、接口电平和差分接收也属于反馈链，软件不能通过换一个符号掩盖断线或电气不匹配。Hall组合还需要合法序列和异常状态检测。

反馈数据应携带有效标识、时间或序号，与控制使用时刻对应。滤波、串行读取与重试会延迟位置，尤其高速下影响电角度。失效策略要区分暂时校验错误、连续丢样、计数异常与传感器复位；最后一次位置不能无限保持为“当前有效”。

联调先在不输出转矩条件手动转动或使用可控输入，核查方向、每圈计数与零点，再连接受控电机运行。记录原始反馈、解码位置、速度和有效状态，方便识别协议解析、单位换算与实际机械问题。参考eQEP手册适用于列出的芯片，其他MCU输入滤波和锁存规则需另查。

调试检查

• 手动转一整圈并反向，核对计数倍率、方向、索引脉冲及反馈文档所定义的分辨率。
• 注入断线、坏校验和连续丢样，检查有效状态、最后样本年龄及驱动故障处理。

角度对齐与解码

FOC所需电角度以转子磁链与相绕组关系为基准，编码器机械零点或Z脉冲并不天然等于这个基准。应先定义相序、正转观察方向、编码器方向和Park变换约定，再确定电气零偏。把能连续读出机械角度当作已经完成换相对齐，会导致电流方向和转矩不一致。

解码路径显式处理计数回绕、绝对帧校验、状态和多圈信息，输出统一机械位置与有效标志。对齐过程应依据电机、反馈类型和机械约束设计，记录条件与结果。带负载或抱闸轴能否执行会产生运动/力矩的对齐动作必须事先确定，不能无条件在每次上电自动运行。

零偏参数与电机连接、编码器安装和方向相关，存储时关联硬件/配置身份，并在升级后验证适用性。换相符号不是简单选择“电机能转”的组合；错误关系可能在空载低速看似正常却产生很大d轴电流或错误转矩。不要用修改PI增益弥补未确认的角度基准。

测试用完整一圈或多个电角周期检查角度连续性及dq反馈，再在受控电流条件核对正负转矩方向。把相电流、原始机械位置、换算电角度和对齐偏置一起保存，可区分相序错、极对数错和偏置错。改变接线、反馈器或机械安装后，重新核查而不是沿用旧校准。

调试检查

• 在一个完整机械周期检查电角度重复次数和连续性，确认相序、方向与极对数一致。
• 变更接线或编码器安装后检查零偏适用性，记录dq电流与转矩方向，禁止直接复用旧校准。

机械量与电气量换算

机械位置描述轴运动，电角度描述转子磁场相对定子的周期，二者由极对数与偏置连接。典型关系写为电角度等于极对数乘机械角度再加对齐偏置，最后按一个电周期归一化；方向符号必须纳入已定义约定。机械转速和电气频率同样不能直接互换。

接口层固定角度单位是弧度、度还是每圈归一化值，速度是rpm、弧度每秒还是计数每周期。编码器分辨率需区分线数、边沿计数倍率和绝对位数，传动比还要说明反馈位于电机轴还是负载轴。整型换算先选择足够宽的中间量，避免乘极对数或倍率时溢出。

每周期位置差分估算速度时，处理计数回绕和时间间隔，不能假定每次读取都准确等于固定周期。低速可能出现量化，高速需要考虑反馈延迟与电角度外推；采用何种方法应明确有效范围。滤波后的速度与即时位置有不同时间特性，使用者不能把二者当作同一时刻的原始量。

工程核查可用已知每圈计数、极对数和方向建立纯软件向量，再对照实际手动转轴。电机转一圈对应多少电周期、负载转一圈对应多少电机圈，应分别验证。公式检查通过仍不能证明安装与接线正确，必须把物理方向和真实反馈关联到同一约定表。

示意：θe = wrap(p × θm + θoffset)；p为极对数，符号与wrap区间依所用坐标约定。

调试检查

• 用正反转、回绕和极对数边界向量验证换算，检查整型中间量与单位不发生溢出或混用。
• 实际转轴比较机械圈数、电角度周期数和负载传动比例，核查物理方向与软件约定一致。

无感估算的应用条件

无感算法从电压、电流与电机模型估算角度和速度，能否替代反馈器取决于观测原理、运行区间和应用要求。基于反电动势的方案在低速或零速信息不足，不能直接承诺静止位置或满载启动性能。伺服的保持、低速定位与快速换向要求，应与具体估算方法的可观测范围对照。

估算器输入要反映实际施加电压和有效电流，而不是未经限幅的理想控制指令。死区、母线变化、采样偏置和PWM更新延迟会导致模型误差。模型参数还受温度与工况影响，需明确来源、单位和适用范围；不能把一个观测增益用于所有电机再依靠滤波掩盖不一致。

启动和模式交接需要独立设计，包括角度建立、开环或其他初始化、估算有效判定、渐入闭环及失锁恢复。估算角度与反馈角度切换时保持方向和偏置一致，避免瞬间产生dq跳变。PLL滤波带宽与动态响应有取舍，校验有效性应同时看残差、信号条件与运行区间，而非只看估算值在变化。

验证先用可信反馈作为对照记录估算误差、速度和负载，再探索启动、低速、反转及母线扰动。某一转速估算平稳不能推广到全区间。Microchip AN1292展示特定PMSM PLL与弱磁方案，电机和硬件条件需要重新验证；它不直接保证精密伺服所有位置功能。

调试检查

• 用有反馈工况对照估算角度，在低速、反转和负载变化时记录误差及有效标志。
• 测试启动交接与失锁，观察角度连续性、dq电流和恢复策略，明确不能覆盖的运行区间。

位置/速度/转矩模式

位置模式关注跟踪轨迹，速度模式关注转速，转矩模式关注产生的力矩或相应电流；三者边界和用户责任不同。转矩模式通常不会天然限定轴位置，速度模式也不保证负载达到指定位置。产品应明确每种模式启用哪些环、目标单位、限制条件和有效反馈，而不是只改变一个模式编号。

命令路径为每种模式设置独立的目标解码和采用规则，再共享底层电流与保护。位置模式先规划或插补，速度模式提供加减速与电流约束，转矩模式处理幅值、变化率及速度边界。控制来源、输入有效时间和限幅后采用值应可以读取，便于上位机理解为什么目标没有被直接执行。

切换模式前明确必须停机还是支持在线受控转换，并处理积分器、轨迹缓存和旧目标。未确认实际模式之前，不把新目标写进旧模式的字段。位置坐标、回零状态和转矩基准在切换中也可能变化，需设计初始化与失效条件，不能用清零所有变量一招解决全部转换。

测试先在无能量或受控条件验证单模式，再覆盖带非零旧目标的切换、命令暂停和取消。记录目标、实际模式、各环采用值与输出许可，判断切换是否产生跳变。公开驱动模型给出接口思路，具体设备支持模式和可选对象需要说明；不应声称所有CiA 402模式都已实现。

调试检查

• 从非零目标切换模式，核查旧轨迹和积分状态处理以及新目标在模式确认后才生效。
• 分别达到位置、速度和转矩限制，检查返回采用值与状态是否能解释应用行为。

CiA 402对象与使能

伺服采用CiA 402接口时，对象是通信侧访问驱动行为的窗口，必须连接到真实状态、模式和反馈。控制字提出请求，状态字反映结果，模式请求与模式显示分别表明期望和实际模式。仅建立索引并把写入值回显，无法证明电机具备运行条件或目标进入了闭环。

驱动状态机应核对母线、反馈、参数和故障后再许可输出，并把拒绝条件映射到可解释的诊断。NMT Operational或EtherCAT OP属于通信状态，不能替代驱动Operation enabled。初始化时保持合法禁止状态，收到有效控制字也要通过应用条件，不能在网络连接回调中自动打开功率。

控制字、模式和目标由同一周期快照传给应用，对边沿动作与持续命令分别处理。故障复位要确认实际故障已消除且满足恢复许可，不让主站持续置位导致每周期清掉诊断。快速停止和取消使能对应何种输出行为，取决于所支持选项与机械能力，应写清而非只返回一个状态码。

联调从读身份、确认对象属性开始，再逐步完成状态转换，记录控制字、状态字、模式显示、PWM许可和采用目标。测试未满足反馈或母线条件时的使能请求、故障期间请求和复位后旧目标。示例SDK只能说明接口接入，实际驱动保护与时序需要独立验证。

调试检查

• 保持通信正常但阻断反馈或母线许可，检查控制字请求未造成虚假的运行状态。
• 以持续和边沿方式发送故障复位，观察实际故障、状态转换及新使能要求。

参数、单位与指令更新

伺服接口需要把位置、速度、电流/转矩及时间参数定义到可独立验证的单位。主站的工程单位、线上整数缩放和内部归一化量是不同层，转换集中在受控边界完成。峰值与RMS、电机轴与负载轴、机械与电气速度混用，都会产生数值看似正常而动作错误的问题。

参数表同时声明宽度、有符号性、倍率、默认值、合法范围、生效条件与保存策略。指令更新还注明有效时刻、序号或周期以及失联判断；不能把一条很久以前写入的目标永远当作最新命令。超过范围的配置拒绝，连续运动目标是否裁剪则按公开限制返回实际采用值与原因。

多个参数组合或跨寄存器大数要完整提交，控制中断不得看到一半新一半旧的数据。单位换算使用足够宽的中间量，处理整数溢出、位置回绕和非法浮点。模式变更或反馈零点更新时，对尚未消费的目标重新验证，避免它原本合法却在新坐标或新倍率下变成危险量。

联调用识别性位型验证编码，再用可控正负运动检验物理尺度。记录线上原值、解码值、限幅采用值和实际反馈，分清协议字序与机械误差。修改倍率、极对数、传动比或固件对象版本后应重新检查兼容性，不能靠界面显示一样就认为旧控制程序仍可使用。

调试检查

• 使用正负值、边界值和跨字位型验证接口，再比较线上数值到机械运动的尺度。
• 改变参数倍率或模式时检查未消费目标、版本和控制快照，确认旧目标不能按新单位直接执行。

通信和控制边界联调

伺服联调要观察命令从线路到机械输出的完整路径：协议验证、控制权仲裁、状态许可、目标快照、控制计算及PWM生效。网络抓包只证明报文，软件变量变化只证明某个阶段。调试记录各阶段的序号、时间和拒绝原因，才能判断“有目标但不动作”发生在协议还是应用边界。

通信周期与本地电流周期通常不同，设计目标保持、插补和采用点，并明确数据过期窗口。主站突发多条指令不应把控制任务改成按报文触发；接收缓存只保留定义允许的事务，过期目标有明确丢弃规则。多个接口同时连接时，控制来源切换需要新命令和清晰许可。

联调先锁定单模式与单控制源，确认状态和单位，再增加通信压力、模式变化、参数访问与故障上报。将期望目标、实际采用目标及反馈分开比较，观察电流/电压限制。协议侧重试不能让动作反复执行，网络恢复也不能自动重放旧轨迹或清除驱动内部故障。

验证矩阵包含主站停止更新、网络切出运行、延迟和丢周期、设备复位以及恢复。记录通信状态、驱动状态、命令年龄和输出行为，区分同步、活性与执行截止时间。主机侧模拟可验证仲裁和接口转换，机械停止距离与真实采样延迟仍需目标硬件测试，不能用虚拟反馈代替实际轴。

调试检查

• 沿同一指令序号追踪接收、发布、采用和PWM生效，定位缺失或迟到阶段。
• 让主站停止更新后恢复，检查应用失联动作和控制源许可，确认旧轨迹不被自动重放。

电气、角度与机械方向

联调首先建立三份互相对应的方向定义：功率端A/B/C相序与电流正方向，反馈器计数/角度方向，以及从规定观察位置看到的机械正转。三者不一致时，轴可能无法稳定换相，也可能在某些条件看似旋转但产生异常电流。不能用“调到能转”为验收标准，更不能先提高增益掩盖符号问题。

无功率或受控条件下验证原始反馈每圈计数、回绕和方向，再对照相电流采样通道与PWM输出。电气零偏、极对数及变换归一化集中写入约定表，所有算法与通信对象使用同一套单位。换线、换编码器或改变机械安装后，对齐参数需重新验证适用性，不默认存储值永远正确。

在限制电流与速度的运行条件下，分别检查正负目标、dq反馈和机械方向，观察角度偏置变化是否符合模型。传动比、负载侧反馈与机械间隙还会影响最终轴方向和位置，不能只核对电机轴。抱闸或受约束负载的对齐操作需按实际系统规划，不把会产生运动的测试当成无副作用的软件检查。

保存接线版本、反馈配置、零偏来源及验证波形，把原始计数、机械角、电角度和dq电流关联到同一时间。出现回归时先比较这些事实，再查控制增益。例程中的极对数、通道顺序或传感器型号属于其测试条件，移植后必须以实际电机与功率板重新建立证据。

调试检查

• 对照正负目标的物理方向、反馈计数和dq电流，检查约定表能解释全部结果。
• 改变接线或反馈配置后重复全周检查，确认旧零偏与极对数配置不会被未经验证地沿用。

多环整定与轨迹验证

伺服多环整定从最内层开始，先确认采样与电流环，再连接速度和位置路径；每层先限制输出并验证基本单位与方向。内环不稳定时外环无法补救，外环过快也会让内环和机械结构承受无法跟随的目标。带宽关系需要结合延迟、负载和机械共振确定，而不是照抄固定增益。

建立可重复的测试轨迹和负载条件，记录每环目标、反馈、误差和限制状态。电流阶跃、速度变化与位置运动分别作用于不同对象，不把一条位置曲线当作所有环的性能证据。频率分析能辅助识别带宽与余量，但注入点、幅度、工作点和非线性限制都影响结果，应明确适用范围。

整定过程中每次改变有限参数，保留前后波形与参数集。遇到振荡先检查饱和、反馈延迟、角度/比例和机械异常，再判断是否为增益问题。前馈和滤波在基本环路可信后分别加入，避免多项同时变化而无法解释改善来源；持续限制时还要验证积分处理及解除后的恢复。

轨迹验证覆盖短行程、长行程、换向、停留、连续更新和取消，确认速度/加速度边界、停止距离及误差监测一致。空载整定不能直接覆盖满载，单向成功也不能覆盖换向间隙。更换功率板、反馈滤波、PWM周期或负载后，重新检查相关环与时序，不把原参考设计的结果当作自己的实测。

调试检查

• 按电流、速度、位置顺序保存同工况前后记录，核对各层限制和频率分析注入条件。
• 回放换向、取消及达到限幅的轨迹，检查误差恢复、积分状态和机械响应在规定边界内。

通信中断与故障恢复

伺服恢复过程需要区分通信失联、驱动故障、反馈失效和供电异常。网络恢复只能说明链路重新可用，不能自动消除其他故障或确认旧目标仍有效。应用应分别维护通信状态、驱动状态、命令新鲜度、活动故障及运行许可，以便上位机判断恢复停在哪个条件。

失联动作由产品要求和机械能力确定，可涉及保持、受限减速或输出禁止；任何方案都要验证实际能量和轴行为。控制任务使用最后完整快照直至定义的失效点，而非任意字节刷新活性。进入失联或故障状态后，使过期目标和未完成轨迹明确失效，不能把排队中的旧启动请求在恢复后继续执行。

恢复流程先确认真实故障已消除、反馈与参数有效、通信配置一致，再按规定的新控制字或本地操作重新建立许可。清历史日志、清活动故障和复位协议栈分别有独立含义。断线、重连或设备复位期间，输出默认状态与抱闸配合要符合实际系统，不能只依赖上位机再次发送停机包。

测试分别中断心跳/PDO、切出EtherCAT OP、复位通信栈以及制造本地故障，记录何时触发和恢复为何被允许。对网络尚正常但控制给定停滞的情况也要覆盖。验证逻辑可在主机模拟，真实停止时间与机械负载仍需目标硬件证据；不宣称一次自动重连成功就代表整个故障恢复安全。

调试检查

• 分别冻结有效给定、切断网络和注入本地故障，检查触发原因、输出动作与记录能区分。
• 恢复后保留旧启动值但不发新许可，确认驱动不会自动重放轨迹或直接再次使能。

跟随误差、日志与回归

有效诊断记录需要连接异常现象与控制链状态，而不只是存一个“位置误差过大”代码。发生跟随异常时保存轨迹目标、实际位置、速度、电流目标与反馈、限幅状态、模式、命令序号和相关时刻。采样周期与单位也属于记录，否则不同版本的日志无法直接比较。

现场缓冲使用有界事件或环形记录，优先保存第一异常前后的窗口，标注丢记录和覆盖规则。控制中断同步打印会改变时序，可能制造或遮蔽问题，应把采集与导出分开。故障后母线或反馈下降可能是后果，不能让后继事件覆盖最初导致跟随误差的限制或迟到目标。

回归用固定轨迹、负载范围、配置和固件版本比较，先复现再做最小改变。把“错误不再出现”拆成测试次数、覆盖工况与仍未验证范围；不要因为一次运动正常就判断根因已消除。对纯坐标换算与状态逻辑可做主机测试，对机械响应、PWM延迟与反馈噪声继续使用目标硬件。

维修或升级后重跑与改动相关的验证入口，例如反馈配置变更检查角度/单位，调度变更检查最坏截止时间，轨迹算法变更检查取消和换向。日志、原始曲线、参数集与版本共同形成可复查记录。

调试检查

• 触发跟随误差时核对前后窗口、首故障、限制标志和命令年龄，确认日志可解释因果顺序。
• 用固定配置与轨迹复测修改前后，保存尝试次数、原始测量记录和硬件证据。

整流、母线与逆变桥

常见电压源变频器将交流输入经整流形成直流母线，再通过三相逆变桥产生电机所需电压。整流器可以是二极管桥、受控整流或有源前端，不同结构决定输入电流形态以及能量能否回送电网。直流供电设备则可能没有输入整流级，因此系统图应按实际拓扑绘制，不能把所有变频器固定描述成同一种功率链。

母线电容既平滑整流脉动，也暂存运行过程的能量。上电需要管理充电冲击，常见预充电阻和旁路接触器应有状态、反馈与超时；有源预充则具有自己的控制及故障条件。母线已达到某个电压不等于旁路执行成功，应检查接触器反馈或相应诊断。断电后电容仍可能储能，放电路径与电压确认属于独立设计内容。

逆变桥使用PWM把母线电压转换成平均相电压，输出频率、幅度和相位由运行算法确定。普通二极管整流前端通常不能把制动能量主动送回电网，减速时需要根据母线、制动单元与负载能力处置。系统维护应记录整流、预充、逆变、制动和放电的实际边界；仅看MCU使能标志，无法证明所有能量路径都已经处于预期状态。

调试检查

• 核对整流拓扑与制动回馈路径，列出预充、旁路、放电和逆变运行的前置条件及反馈来源。
• 检查上电充电、旁路失败和断电后的母线变化，确认电容残余能量与软件运行状态分别判断。

控制板、采样与保护

控制板承担给定处理、运行状态、调制和测量，但不同信号具有不同实时要求。相电流服务快速控制，母线参与电压能力与异常判定，温度用于热状态和降额，通信则提供较慢的命令及诊断。把这些信号都放进同一低频轮询任务，可能让电流数据过期，也可能使母线异常在长时间平均后才被发现。

采样链包括分流或其他传感器、模拟调理、隔离、ADC及缩放，保护链可能另有比较器或驱动器去饱和检测。控制用电流与快速保护信号应说明各自带宽、有效性和动作路径。软件限流能改善运行约束，硬件快速关断应承担其设计的短路或器件保护角色；不能用控制中断正常执行来证明功率故障已能及时截断。

接口设计还要考虑控制板复位、供电先后、PWM默认电平和故障信号极性。MCU未启动时，驱动器应有明确的禁用状态；采样隔离侧失电后，异常输出不应被解释成真实零电流。诊断应保留来自驱动器、ADC与运行算法的原始原因。参考设计提供的是一种可借鉴架构，保护阈值、延迟和覆盖范围仍需按具体器件与产品配置验证。

调试检查

• 画出控制采样和硬件保护两条路径，核对带宽、故障极性、MCU复位时的PWM与驱动器默认状态。
• 注入采样侧失电、控制板重启和保护输入，分别检查有效位、实际门极输出及故障原因记录。

电机、负载与上位控制

变频器的运行目标需要与电机和负载匹配。风机、泵类工况重视连续调速、效率和过程控制，输送或卷绕可能需要转矩与加减速协调；这些要求不自动等同于伺服位置定位。使用相同三相功率桥或FOC算法，并不能说明产品支持绝对位置、多轴同步或高精度位置保持，应在接口与指标中明确实际能力。

电机铭牌包含额定电压、频率、电流、转速和连接方式，接线及参数选择应共同核对。感应电机实际转速与供电频率之间存在滑差，负载变化会改变转速；永磁电机的角度与控制策略又不同。上位系统给定频率、速度、转矩或工艺量时，需要明确换算链和有效通道，不能将一个无单位的百分比解释成所有模式通用的命令。

负载还决定启动和停止行为。高惯量负载产生较大制动能量，恒转矩负载可能需要低速持续转矩，风机在上电前可能被外力带动。系统设计应收集负载曲线、惯量、旋转方向、允许停机方式及电机冷却条件。上位控制负责过程目标，本地驱动负责执行约束与有效性判定，两者边界要写明，避免上位发出运行命令就被当作无条件输出许可。

调试检查

• 核对铭牌、星三角接线及电机类型，明确上位给定量、转换单位、运行模式和本地使能条件。
• 按负载类型检查残余转动启动、低速持续负载及减速能量，记录产品不支持的位置或同步功能边界。

产品指标与运行工况

产品指标应同时描述额定工作点和允许范围。输入电源、输出电流、输出频率、过载时间、环境温度和冷却条件相互关联，某个短时峰值不能直接代表长期连续能力。控制精度还要注明是输出频率精度还是机械速度精度，开环V/f下电气频率准确并不意味着负载变化时机械速度保持同样准确。

验证工况需要覆盖电机与负载类型、正反方向、母线变化、加减速和热状态。连续低速运行可能降低电机自带风扇冷却能力，高开关频率又可能增加功率级损耗，应依据设备设计降额。负载惯量和制动重复率会改变制动单元热负荷，不能只用一次停止结果证明连续循环能力。

需求表宜把功能、动态、保护和诊断指标分开，明确测试方法、时间窗、误差及证据来源。电机能转动只说明基本链路成立，尚不能覆盖电源扰动、通信超时和异常恢复。参考设计的功率或温度范围属于对应板卡，不应移植成当前产品宣称。法规、功能安全等级或认证状态只能引用产品已有资料，常规固件试验和器件认证不能替代整机合规结论。

调试检查

• 区分额定、峰值及持续能力，给每个指标附输入、负载、温度、冷却和测试时间条件。
• 分别验收频率输出、机械速度、热状态及恢复行为，保存未测试工况，不沿用参考板指标或推断认证。

母线电压与能量路径

母线电压是能量状态的重要观测量，但其变化原因需要结合输入与负载。整流供电能力不足、输入跌落或大加速会使母线下降，电机制动回馈可能使其上升，整流脉动则属于正常拓扑特征。对近似恒定电容量C，储能为E=½CV²，C用法拉、V用伏特、E用焦耳；该式用于估算电容能量，不能代替电容纹波、损耗及寿命分析。

制动时需追踪机械动能到母线及制动单元的路径。若前端不可回馈，能量通常由电容暂存并通过制动斩波及电阻耗散，减速能力受电阻、开关器件、温升和控制限制共同约束。延长减速时间可以降低瞬时功率，却不能在所有负载或失电条件下保证可控停机。重力或外部驱动负载还可能持续输入能量。

预充完成、正常供电、制动及放电应有不同状态与诊断。软件可监测母线上升速度、旁路反馈及制动后趋势，但判据要来自具体设计。母线测量失效时，不宜继续根据错误电压放宽调制度或触发制动。故障记录应保留母线、输入状态、运行阶段和制动占空比，帮助区分供电问题、回馈过量和测量异常，避免把所有过压统一归为减速时间太短。

调试检查

• 估算一次减速的能量与电容允许变化，核对前端能否回馈及制动电阻的脉冲和连续热能力。
• 交叉检查预充、旁路、制动和放电状态，注入母线测量无效时验证控制不会采用错误可用电压。

三相逆变桥

三相两电平逆变桥由三个半桥组成，桥臂中点连接电机，输出平均线间电压取决于占空比差与母线电压。电机中性点通常浮动，因此桥臂对母线电压与相对中性点电压不同。分析输出时应说明测量参考点、峰值与有效值，避免把示波器看到的开关脉冲峰值当成电机基波有效电压。

上下桥臂不能同时导通，互补PWM及死区需要覆盖驱动传播、器件关断和不对称延迟。死区会改变输出，最小脉宽及自举供电又限制可实现占空比。调制度提高可能缩短电流采样窗口，故调制可行域不能只由数学电压极限确定。过调制及不连续调制需要独立验证，不应在运行时默默改变算法却沿用原采样配置。

调试先检查无功率输出下的计数、相序、极性和禁用逻辑，再按规定条件逐级验证实际门极与桥臂。电机反向、输出失衡或电流尖峰要同时核对PWM请求与硬件波形；寄存器正确不证明门极波形正确。停止输出时的桥臂状态和电流续流路径也需要解释，所有PWM变低并不表示电机电流或母线能量立即归零。

调试检查

• 核对桥臂极性、互补关系、死区及影子装载，检查极端占空比下自举和最小脉宽限制。
• 比较最终占空比、门极及平均线间电压，观察禁用后的续流路径与母线变化，不只检查软件PWM标志。

功率器件与栅极驱动

功率器件选择需要同时考虑导通、开关、耐压、热和故障承受条件。IGBT、硅MOSFET与碳化硅器件的驱动电压、关断方式及寄生敏感性不同，不能仅按额定电流互换。栅极电阻、回路电感和布局决定开关斜率及振铃，提高开关速度可能降低某些损耗，也可能增加共模扰动和过压，应结合实际波形验证。

栅极驱动器提供电流放大、隔离及某些保护功能。欠压锁定、米勒钳位、去饱和检测和软关断各有触发条件与时间过程，需要依据所选器件手册配置。去饱和的消隐和滤波过长可能延迟真实故障，过短可能误触发；软关断可以改变电流下降和电压过冲，但不能把所有短路能量风险自动消除。

固件应理解驱动器就绪、故障、复位及使能接口，而不是把它只当PWM传输器。驱动电源未稳定时禁止输出，驱动器故障应锁存原因并检查所有桥臂状态。软件复位驱动故障之前，必须判断故障条件是否消失及后续启动是否需要重新预充或检查电机。具体保护电流、门极电压和消隐时间应按器件及功率板定标。

调试检查

• 逐项核对功率器件和驱动器的推荐条件、故障路径及复位要求，保存门极振铃和关断过程证据。
• 覆盖驱动欠压、去饱和及禁用输入，测量实际关断与故障报告时间，并检查过冲及误触发取舍。

隔离与信号接口

隔离边界应从人员可接触接口与功率参考地之间划分。通信、编码器、采样、门极驱动和辅助电源可能采用不同隔离方式，某个器件耐压高并不代表整个板卡隔离已经成立。工作电压、瞬态电压、爬电距离、电气间隙、污染等级和海拔等共同影响设计，应依据适用标准与产品条件审查。

信号隔离还影响延迟、默认电平和失电行为。PWM隔离需要检查传播差异及共模瞬变下的输出，模拟隔离需检查线性范围、增益与异常指示，数字通信隔离需考虑方向和总线参考。电源隔离必须与信号边界一致，若另一个调试电缆跨接了隔离两侧，预期隔离可能被破坏。测量和调试连接应纳入接口图。

常规电气隔离与安全转矩关闭属于不同功能。禁止PWM可以作为运行控制动作，但未经对应架构、诊断和验证不能称为STO，也不能从隔离器件认证推导整机安全等级。固件文档应准确描述能够观察和控制的接口，同时把硬件隔离及功能安全结论交给正式设计证据。调试时保留故障默认状态，避免为了通信便利把异常指示固定为正常。

调试检查

• 画出所有信号、电源和调试连接的隔离边界，核对工作条件、布局距离及失电默认状态。
• 验证共模扰动和接口侧失电的输出行为，区分常规禁用、隔离性能和已有正式证据支持的安全功能。

PWM 与 ADC 同步

变频器PWM与ADC同步的目标是获得可解释的电流及电压样本，而不是简单让两者使用相同频率。采样保持应落在当前拓扑允许的窗口内，避开开关瞬变并留足放大器建立时间。中心对齐、扇区和占空比都会改变可测时段，采样触发需要跟随调制或使用经过验证的固定区域。

ADC转换完成、DMA搬运和控制计算发生在采样之后，新占空比还需等待装载事件。母线采样若与电流不同步，应明确它在电压重建中的数据年龄。多通道扫描可能使两相样本存在时间差，高速或电流变化快时会影响坐标变换；能同时采样的硬件也需核对触发与结果绑定，不能只看配置选项名称。

调试应按实际计数时间轴验证触发、采样、读取和输出生效，覆盖低调制度、扇区边界和接近最大占空比。控制中断执行时间必须在下一次装载前留足余量，通信和诊断压力可能只造成少数周期延误。对采样窗口不足或转换未完成应产生有效位及明确处置，不宜继续把旧ADC数据当成新电流，让错误在限流或观测器中放大。

调试检查

• 扫描占空比与扇区，测量窗口宽度、模拟建立、采样保持和装载余量，检查最短窗口仍满足配置要求。
• 用周期编号关联ADC与PWM，加入通信压力及转换未完成情形，验证过期样本被标识且超时动作符合定义。

相电流与母线电流

相电流与母线电流反映不同物理量。相线传感器直接观察对应绕组电流，低侧分流在特定导通状态可测，单母线分流则通过开关状态间接提取不同相信息。母线平均电流用于功率或输入负荷观察，不能直接替代每相瞬时电流，也不能用三个相电流的普通算术平均来估算直流输入电流。

单分流重构需要在有效矢量期间获取足够的独立样本，并依据扇区与开关状态映射符号。有效矢量太短会形成不可测区，移动脉冲或替代样本会改变电压及数据年龄。两相重构第三相需满足三相电流和近似为零的条件，地故障或共模泄漏时该假设可能不成立；由公式重构出的和为零不是独立的硬件健康证明。

电流用途还应分控制、保护和功率分析。控制需要时刻明确的样本，快速过流需要更短路径，输入功率估算需要与母线电压同步的合适平均。拓扑变更后，采样触发、放大器范围、保护覆盖及电压观测都要重新验证。分析异常时同时记录原始样本、开关状态、有效位和重构结果，避免只看滤波后电流而漏掉短窗口及通道饱和。

调试检查

• 分别标注各传感器位置与用途，核对单分流映射及不可测区处理，不用重构恒等式证明传感器正常。
• 对极端调制、饱和与地故障模拟检查控制和保护覆盖，比较电流样本年龄、最终重构与原始波形。

母线电压与温度采样

母线电压与温度通常比相电流变化慢，但采样策略仍需匹配用途。母线用于调制归一化和过欠压判断，预充与制动过程可能变化较快；温度用于降额和保护，其测点、热惯性及通道异常同样重要。不能把两者都做长时间平均后只保留一个平滑值，导致控制获得错误电压能力或保护反应过慢。

母线高阻分压需要考虑输入阻抗、隔离放大器范围和ADC采样保持的建立。分压阻值与耐压分配是硬件设计内容，软件换算应绑定实际电阻与增益。温度可来自模块NTC、散热器或其他传感器，其位置测得值不等于瞬时结温。NTC非线性转换、开短路及参考电压漂移应分别处理，不能将异常满量程统一解释成高温或低温。

数据接口宜提供原始值、工程值、有效位和采样时间，并把控制估算、显示与保护使用的滤波分开说明。隔离侧失电可能产生器件定义的故障输出，应先检测有效性再参与归一化。验证时使用受控输入检查多个量程点和变化过程，还需核对更新丢失时的策略。热保护阈值及母线阈值由具体产品确定，任何示例器件数值都不应作为通用设定。

调试检查

• 用已知输入检查母线换算与NTC转换，覆盖低中高量程、开短路及隔离侧失电，核对有效性优先处理。
• 分别测量控制、显示和保护滤波延迟，验证预充与制动期间电压数据年龄及温度通道更新丢失策略。

校准、滤波与测量误差

校准应区分零点、增益、线性及动态误差。ADC内部校准可能改善转换器本身，却不能自动消除分流、放大器、分压和传感器的误差。电流零点必须在确实无电流的条件下获取，电机残余转动或续流时不能简单把平均样本当偏置。增益校准需要可信参考及覆盖范围，单点归零不能证明整个量程准确。

滤波可以降低随机噪声，却无法修复错误比例、饱和或采样窗口不足。采样保持时间应与前级源阻抗及ADC输入特性匹配，通道切换后还可能需要建立时间。软件平均若跨越状态变化，会混合预充、运行或制动的不同含义。数字滤波系数应绑定任务周期，并把延迟计入限流与观测模型。

校准参数需要版本、温度、日期及硬件关联，并有完整性检查。更换采样板、ADC参考或放大器增益后，旧参数应失效或明确重新验证。验收可分静态已知输入、PWM共模干扰和实际运行三层，记录原始与处理后数据，检查量程裁剪及低幅值偏置。仅看到滤波后电流平滑，不能说明测量链正确；应该让误差预算及诊断证据与控制用途对应。

调试检查

• 在真正零电流和多个已知输入点核对偏置、增益及线性，确认校准参数绑定正确板卡与参考电压。
• 改变PWM共模扰动和ADC采样时间检查动态误差，比较原始值、滤波值及延迟，不让滤波掩盖窗口失效。

运行状态与启停

变频器的启动请求应先经过运行状态机，再转成频率或转矩给定。待机、预充、就绪、启动、运行、减速和故障分别拥有进入条件与退出动作。预充完成并不代表可以立即发出功率脉冲，还需要检查驱动电源、采样有效性、接触器反馈和当前命令来源。启动许可的判断应与控制中断共享一致快照，避免后台刚撤销许可，快环仍使用上一轮使能。

启动过程中必须区分静止电机与已经旋转的负载。风机可能被气流反拖，泵也可能因回流旋转；未经速度方向识别直接施加固定起始频率，可能产生冲击电流。飞车启动是否可用取决于电机类型、测量条件和算法，而不是一个统一延时。对于需要磁链建立的异步机矢量控制，磁链准备阶段也应有超时和受限退出路径。

停机命令至少要明确受控减速、自由停车和故障关断的行为差异。受控减速需要逆变桥继续工作并安排再生能量路径，自由停车的机械停止时间取决于负载。运行位清零不能证明母线无电或轴已停止。固件应分别报告请求状态、实际状态与停机原因，并将复位后的重新启动许可作为独立决策，避免保存的运行命令造成意外重启。

调试检查

• 对启动请求分别注入预充未完成、驱动未就绪和采样无效条件，确认状态停在规定阶段，输出使能没有短暂出现，失败原因可查询。
• 验证减速中撤销命令、停机未完成再次启动、复位后旧命令仍在三条时序，记录实际输出、母线变化和状态转换，核对设计的重启规则。

V/f 标量控制

异步电机的标量调速通常让基波电压幅值随定子电气频率变化，以在一定范围内维持磁通。简单恒定比值建立在稳态、定子电阻压降相对较小等近似条件上。电压参数必须注明是线电压有效值还是相电压幅值，频率以赫兹表示，不能直接把铭牌线电压数值填进以相电压峰值计算的调制模块。

低频时定子电阻压降占比上升，按直线比例给电压可能磁通不足；增加补偿也可能导致过励磁和发热，所以提升量应结合电机参数与电流限制验证。达到基频以后，直流母线与调制范围限制可用电压，继续提高频率通常进入弱磁区域，持续转矩能力会变化。标量控制并不自动保证低速满载或快速转矩响应。

同步机械转速可写为 n_s=60f_e/p，单位为每分钟转数，f_e 为定子电气频率，p 为极对数；异步机转子实际转速还取决于滑差与负载。频率显示正常而轴速下降，不一定是通信给定错误。实现时应把给定斜坡、低频补偿、母线电压归一化和限流协调起来，并区分输出频率、估计轴速与实测轴速，禁止把三者用同一个寄存器名称混淆。

调试检查

• 检查铭牌接法、线相电压换算、极数与极对数以及软件电压单位；在输出限制处核对调制实际幅值，避免换算正确但被限幅覆盖。
• 以不同负载验证低频补偿和基频附近过渡，记录电流、实际转速、温升趋势及限流状态；评价结果按负载条件保存，不能只凭空载运行判定。

FOC / 矢量控制

变频器中的矢量控制要先明确电机类型。异步机采用转子磁链定向时，需要估计或测量速度并建立磁链角度，磁链分量与转矩分量由相应电流控制。永久磁体电机则依赖转子电角度及其磁链模型。两种方案虽然共享坐标变换和电流环结构，电机参数、启动准备与无感观测方程不能直接互换。

对异步机，转子磁链坐标系的电气旋转速度包含机械速度乘极对数与滑差角频率；各项使用弧度每秒，不能把轴速直接当作同步旋转角速度。转子时间常数会影响磁链定向，绕组温度变化也可能造成参数偏离。调试中应观察励磁电流、转矩电流与磁链估计的关联，电流环跟踪良好并不单独证明磁链方向正确。

固件需要把电流环、速度环、磁链建立、限压和限流安排在明确的采样节拍中。估计速度无效时，应按运行阶段选择保持受限给定、退回启动过程或停机，不能无条件闭合速度环。低速和零速可观测性取决于算法及测量条件，宣称无感矢量不代表可以在任意负载下零速保持转矩。调速型产品的验证重点是规定工况下的转矩与速度行为，定位能力另有反馈和机械约束。

调试检查

• 核对电机模型、极对数、速度单位、磁链角方向以及电流符号；用已知转向的低风险工况确认反馈方向，禁止先通过改增益掩盖符号错误。
• 覆盖磁链准备、闭环接管、限压和速度估计失效阶段，记录磁链量、两轴电流与接管状态，确认切换无额外给定跳变且退出规则成立。

加减速、限流与负载

加减速时间描述的是给定变化过程，实际机械响应还受惯量、负载转矩和可用电流限制。以轴侧模型 J·dω_m/dt=T_e−T_L 为例，惯量用千克平方米、机械角速度用弧度每秒、转矩用牛米，并假定各量折算到同一轴。该关系可用于检查斜坡是否合理，但不能替代摩擦、传动弹性和工艺负载的具体建模。

加速时，过快的给定可能使转矩电流持续受限。继续累加速度误差会导致退出限流后过冲，因此调速环需要与电流限制协调，并采用与实现一致的抗积分饱和处理。标量控制的限流还可能通过调整频率变化率或电压实现，其行为与矢量控制的转矩限幅不同。限流状态要有可读原因和持续时间，不能只显示目标速度未达到。

减速时电机可能把机械能送回母线，制动电阻、回馈前端或延长减速过程决定可实现的停机轨迹。只放宽过压判据不能解决能量去向。高惯量负载、风机反拖和频繁启停应分别评价；风机的负载规律不能照搬给恒转矩输送机。在线调整斜坡时还要规定从当前给定继续还是重新生成路径，避免参数修改造成频率突然跨越。

调试检查

• 在规定惯量和负载组合下改变加速时间，区分给定斜坡、实际转速与限流持续时间，核对控制器积分状态及解除限流后的恢复过程。
• 覆盖有制动、无制动和制动暂不可用的减速情形，检查母线趋势、斜坡延长及停机原因；轨迹达标必须同时满足电气与机械约束。

运行命令与给定通道

变频器往往同时具有面板、端子、模拟输入和通信控制入口。运行命令与速度给定可以来自不同通道，但产品必须明确这种组合是否合法，谁有权启动、停止和改变方向。固件应先形成带来源和有效性的命令对象，再由仲裁层提交状态机，不能让多个中断直接写运行标志或频率变量，否则最后一次写入就会成为隐含优先级。

给定通道还包含量纲、比例、死区和故障行为。例如模拟输入断线可能表现为越界或固定值，通信寄存器则需要区分频率、轴速与比例给定。转换应集中处理并报告应用后的实际目标；上位机读回的原始写入值不代表该值已经通过方向限制、最大频率和斜坡约束。方向改变也应走运行规则，不等同于立即交换两相或翻转调制角速度。

仲裁应规定停止请求的优先级、外部禁止信号的作用以及本地与远程接管条件。控制权状态最好与实际运行状态分别公布，便于解释远程写入成功但设备未执行的原因。通信确认只能证明协议请求被接受，其与命令应用的关系需要接口契约描述。应用层停机及普通使能信号不能被自行命名为安全转矩关闭，安全功能须依照实际系统设计与验证范围确定。

调试检查

• 分别从两个入口连续发出相反运行请求和不同给定，核对公开的优先级、被拒绝原因与实际目标，确认没有单周期控制权抖动。
• 切换面板、端子和通信给定时检查单位、方向和当前斜坡；模拟越界与远程写入受限时，读回状态应解释最终采用的值和来源。

Modbus映射与写权限

通信寄存器表应是一份设备接口契约，逐项声明地址、类型、单位、缩放、有效范围、访问条件和生效阶段。Modbus 的寄存器为十六位，协议定义多字节数据的字节传输顺序；跨寄存器的三十二位应用量还需要设备明确字序和符号解释。文档中的编号与帧内地址也要区分，避免上位机习惯的起始编号造成整体偏移。

运行命令、参数和状态量需要不同写权限。只读反馈不应因为底层存放在同一数组就能够被写，停止后才允许修改的电机参数也不能在运行中静默更新。处理请求时先完成长度、地址、范围及状态条件校验，再一次性提交整组值。对于多寄存器组成的给定或参数，半旧半新的组合可能生成合法但错误的数值，快环读取必须得到同一代快照。

协议错误与应用拒绝应能被区分：不支持的功能、非法地址和不允许的值要按接口规定回应；异步操作还要提供处理中、完成或失败状态。广播写入在串行场景没有逐台响应，不能用没有回包判断它未生效。参数表增加字段时需要兼容性版本及默认行为，不能复用旧地址改变单位而让旧上位机继续把同一数值解释成另一物理量。

调试检查

• 用原始帧核对地址、字节序、跨字字序和有符号边界，并检查读回物理值；同时测试只读地址、越界值及运行中禁止写入的返回结果。
• 把多寄存器写入与控制周期交错执行，确认应用层仅看到完整版本；对广播和不支持功能分别验证执行与回应规则，日志能定位拒绝原因。

参数生效、存储与恢复

参数修改至少经历接收、校验、应用和持久化四个阶段。实时给定通常不需要每次落盘，电机模型和功率级配置则可能要求停机后重建相关系数。通信写入成功、算法已经采用和重启后仍然存在是三个不同事实，接口应分别给出参数代号或版本及状态，避免上位机在存储未完成时断电后误认为设备丢失配置。

持久化记录可采用有效标记、版本、长度和校验，并保留可恢复的上一份完整配置；具体原子更新方式由所用存储介质及固件方案决定。使用片内闪存模拟非易失参数时，要检查擦写粒度、寿命、供电中断行为和执行阻塞。库的掉电恢复能力不代表参数集合的业务一致性自动成立，多个相关字段仍需形成一个经过校验的提交单元。

应用参数时还要处理导出量与运行状态：改变额定频率可能影响电压曲线，改变电流比例会影响显示、控制和保护，不能只更新界面字段。恢复出厂值需保留或明确重建板级校准与硬件型号约束，禁止让通用默认值覆盖专用测量标定。启动时检测未知版本、损坏记录或不匹配硬件，应报告原因并限制启动，而不是把未解释的字节当作当前配置。

调试检查

• 在写入、校验、提交和擦除不同阶段模拟复位或断电，确认启动仅采用完整可识别版本，并验证备用记录、错误提示及启动限制。
• 连续修改互相关联的参数，检查实时应用值、存储值和重启读回值；监测擦写期间控制周期，核对是否需要停机或由独立任务安排持久化。

通信超时与控制权切换

通信超时首先是控制契约，而不是串口错误计数。总线上收到其他设备的帧、有效查询或过期重发，并不一定代表当前控制者仍在提供运行许可。固件应规定哪些消息刷新控制租期或运行心跳，使用单调时间计算有效期，并将帧接收、协议校验、命令提交分别记录，避免仅凭接收中断有活动就永久保持旧运行命令。

超时后的动作由负载和产品运行要求确定，可能是受控减速、保持受限目标一段时间或撤销运行；必须同时考虑减速能量和制动可用性。网络恢复也不应自动重放队列中的旧启动请求。接管过程要验证新通道有效、目标合理和运行许可成立，再按设计实现给定衔接；若直接把远程高速给定换成面板当前值，可能产生不可接受的速度突变。

串行帧间隔、校验错误和物理层干扰会影响通信可用性，但应用超时应有自己的状态和原因。实时控制不宜依赖后台解析任务及时运行才停止，命令有效性应由独立可界定的周期检查。多主控制、广播或掉线后的本地接管若属于产品功能，需要明确拥有者身份及撤权条件。诊断页面应同时显示当前入口、最后有效命令时间和失效动作，让现场能够区分链路故障与控制权被切换。

调试检查

• 保持总线查询流量而停止控制心跳，检查旧命令是否仍按契约到期；注入重发、延迟帧和解析任务阻塞，验证有效期判断不被错误刷新。
• 测试掉线后再连接、本地接管及原控制者回归，核对给定衔接、重新许可和旧队列清理；记录超时检测至实际输出变化的最大时间。

过流保护

过流处理需要区分快速破坏性故障、调节过程中的电流受限以及较长时间的过载。短路或直通可能在软件周期到来之前伤害功率器件，因此应由驱动器、比较器和定时器故障路径按设计直接控制输出。用于显示的平均电流或低速滤波值不能代替这条路径，故障中断负责记录与协调后续状态，而不应成为唯一的关断机制。

定时器的逐周期处理与单次锁存具有不同恢复行为。逐周期限制可能在规定计数事件重新释放输出，单次锁存通常需要清除条件和明确复位；选错模式会让持续故障每周期再次激励功率桥。还要核对故障动作经过互补输出、死区、驱动输入极性之后的真实门极状态，寄存器显示已经禁止，并不保证外部器件获得了正确关断电平。

判据必须来自所选功率器件、测量链和产品工况，考虑检测误差、消隐与传播时间，并区别噪声误触发和真实超限。延长消隐可以减少开关瞬态误报，也可能扩大未保护区间，不能以日志干净为优化目标。调试应同时保存触发源、采样是否饱和、运行阶段和给定变化；对可恢复限流与不可自动恢复故障使用不同代码，便于判断是负载要求过高还是硬件路径异常。

调试检查

• 通过规定的低风险信号注入检查比较器、定时器和驱动器链路，测量检测输入至门极变化的延迟，核对所有桥臂及故障持续时的行为。
• 分别验证逐周期限制、单次锁存和清除后重启，确认软件没有过早解除故障；在开关噪声与合法峰值附近分析误触发，不直接放宽保护判据。

母线欠压与过压

母线欠压与过压需要结合运行阶段解释。预充阶段电压尚低可能正常，运行中突然下降则可能来自供电跌落、整流路径或预充旁路异常；减速时电压上升又可能与再生能量有关。固件不能只输出同一个数值越界标志，还应记录电压变化、状态及制动请求，帮助区分能量失衡与采样链故障。

阈值、回差和确认时间应依据实际器件耐压、最低工作电压、测量误差及工况确定。控制母线欠压、栅极驱动电源欠压和逻辑电源复位属于不同观测对象，不能因为都叫欠压就合并恢复条件。电压跌落时，可用输出电压降低，控制环可能受限；继续要求原转矩或高速给定，会改变电流和停机表现，因此运行限制要与电压状态协调。

过压处理必须核对能量出口。制动请求已经发出但电阻过热、斩波器未动作或支路不可用时，不能仍按正常制动能力规划减速。关断逆变桥之后电机和母线的状态也依赖电机类型与转速，故障处理不应假定电压立即下降。采样过时、分压器断线或隔离链无效需要单独诊断，避免把无法判断母线电压当成正常零电压并允许重新预充。

调试检查

• 在预充、稳定运行和减速三个阶段输入相同电压变化，核对阶段判据、回差、确认时间和事件原因，确认启动流程不被运行判据误触发。
• 验证制动支路不可用、母线测量失效及供电恢复时的退出路径，记录请求与实际反馈；核对恢复许可同时包含测量有效和硬件就绪条件。

温度监测与保护

温度保护先要说明测量点。散热器、功率模块内的热敏电阻、控制板环境和电机绕组温度代表不同热过程，不能将其中任一读数直接命名为功率芯片结温。测量点与器件热点之间存在热阻和延迟，瞬态损耗可能先使结温上升，慢速温度采样仍看起来正常。连续负载限制需要与功率损耗及冷却条件一起评价。

模拟热敏电阻通道要考虑非线性、元件误差、分压参考和模数转换误差，查表或拟合应覆盖实际工作区间。开路、短路与采样过期应具备可检测的状态，不能都映射成最低温度。通过校准减小偏差也不会消除热传递延迟；如果采用器件损耗估计辅助降额，其模型适用范围与测温校核方法应写入设计记录。

保护策略可以包含预警、逐步降额和故障停止，但各阶段的回差、最短保持时间及复位条件要与产品要求一致。风扇失效、风道堵塞、低速自冷电机和高环境温度会改变可用负载能力，单一环境点的运行结果不能覆盖全部工况。模块的热敏监测与驱动关断设计可以作为架构参考，器件或参考板上的判据不能直接成为另一台变频器的通用保护值。

调试检查

• 检查每个温度量的物理位置、单位、查表范围与失效编码，用已知输入验证开短路及区间端点，确认异常输入不会落入正常低温区域。
• 组合环境温度、负载持续时间和冷却退化条件，观察预警、降额、停止和恢复顺序；将测温变化与热模型预测分别保存，核对最不利延迟。

故障锁存、记录与复位

故障管理应分别保存当前存在的故障、已经发生且尚未确认的故障，以及最早导致停止的事件。运行中一次驱动故障可能随后伴随欠压、速度反馈无效和控制超时，最后一条报错不一定是根因。记录应带单调时间或控制周期号、运行阶段及故障源，后台显示时可补充系统时间，不能用不稳定的墙钟时间判断快环事件先后。

发生故障后，先执行有界的输出处置，再冻结必要现场。日志写闪存、格式化文本和通信上报不应占用关键关断路径。环形缓冲可保存触发前后的电流、电压、给定及限制状态，并记录丢样和覆盖次数。若故障同时影响测量链，相关数据需要标记无效，避免离线分析把故障后的饱和值误当成触发前真实电流。

故障条件消失不等于故障被确认，确认也不等于允许重新运行。可以借鉴控制库的活动故障、已消失待确认与空闲状态划分，但产品要补充预充、驱动器锁存和外部运行许可等条件。复位请求应逐项检查恢复资格并反馈失败原因，禁止不停清标志掩盖持续故障。自动重试若被允许，还需规定次数、间隔和累计故障策略，且不能把这种逻辑当作功能安全认证依据。

调试检查

• 按已知顺序注入两个故障及一个后续测量失效，核对首发事件、当前位图和历史记录，确认首因不被覆盖，冻结数据包含有效性标志。
• 在故障仍活动、条件已消失但未确认、确认后许可缺失三种情况下发送复位与启动，检查门极状态和返回原因，并验证重试上限及日志完整性。

电机参数与负载工况

系统联调首先建立电机、接法和负载的可追溯配置。记录电机类型、铭牌额定电压与频率、额定电流、极对数、接线方式和冷却方式，软件参数的物理定义应与此一致。铭牌电流未必等同于算法所用的相电流峰值，三角与星形接法也影响绕组量的换算。把另一台电机能运行的参数直接复制进新设备，可能同时改变磁链、限流和显示比例。

自辨识需要明确试验条件与动作范围。不同算法可能采用静止注入、旋转或约束转子等步骤，必须根据实际方案安排机械允许条件和退出机制。辨识状态显示完成，不意味着获得的参数在所有温度、速度与负载下都准确。应保留辨识时的电机状态、采样校准和参数版本，并通过独立工况检查模型与真实响应的一致性，避免用同一批数据既估计又证明有效。

负载档案应包括惯量折算、转矩随速度变化、起动阻力、反拖可能及持续运行时间。空载能启动只能说明当前条件下流程可走通，不能验证高惯量减速、低速散热或工艺峰值负载。对于调速型变频器，评价重点是规定负载下的起动、稳态速度、受限行为和能量处理；若工艺要求准确位置保持，应另行核对反馈、制动与系统能力，而不是仅靠频率精度推断。

调试检查

• 将参数逐项与电机接法和测量单位核对，保存铭牌、板级校准和软件版本的关联记录；检查参数缺失或电机型号不匹配时的启动限制。
• 为辨识结果选择未参与估计的速度及负载工况，比较电流、实际轴速和限制状态；将冷机、热机和机械约束条件分开记录，标注验证覆盖范围。

启动、调速与停机

启动、调速和停机应作为完整事件链联调，不能分别点动成功就认定系统通过。测试从上电初始状态开始，记录预充反馈、驱动就绪、采样校准、运行许可、给定形成和实际输出的先后关系。每一步设定可观察的成功条件与超时结果，确保上位机提前发出命令或接触器反馈延迟时，设备仍按设计进入下一阶段。

调速测试应同时覆盖小幅变化、大幅斜坡、方向请求和负载扰动，并保留原始目标、经过约束的目标与真实轴速。没有轴速测量时，需要明确证据只证明输出频率或估计量，不能声明机械速度精度。记录时对齐通信时间与控制周期，区分传输延迟、斜坡限制和控制响应，防止把上位机刷新较慢造成的阶梯曲线解释成电机振荡。

停机试验需要检查轴和母线两种状态。受控减速过程应验证制动可用性、母线趋势和输出退出时机，自由停车应按照负载观察机械停止时间。连续启停还可能积累制动电阻与电机热量，因此一次停住不代表重复工况成立。外部禁止或故障在启动、稳态和减速中出现时，退出路径可能不同，必须核对最终状态以及恢复后是否需要新的运行请求。

调试检查

• 将相同启停序列施加于上电后首次运行和热态重复运行，检查状态时序、母线及制动请求；延迟预充反馈和运行许可，确认命令不会绕过准备阶段。
• 对速度阶跃、斜坡及停机事件统一时间基准，保存目标、约束后目标、实测或估计轴速与状态，明确每条判据采用哪种反馈证据。

欠压、过流与受限状态

受限状态的验证目标是说明设备能提供什么，以及何时必须退出运行。欠压会减少可用电压，过流判据可能触发快速关断，调节限流则可能让目标速度无法达到，三者不应使用同一个失败判定。试验需要提前规定输入条件、持续时间、期望状态和输出约束，并从未受限、进入限制、限制持续及恢复四段观察控制行为。

故障注入应先在模型、接口仿真或受控信号层验证判据和状态转换，再按实际设备验证所需硬件链路。修改软件测量变量只能证明软件分支会执行，无法证明比较器、隔离器、定时器及门极路径的真实响应。快速过流链与控制电流测量可能使用不同带宽和滤波，联调记录需要说明触发的是哪一条路径，避免将慢速测试误称为短路保护验收。

限制解除以后应检查控制器内部状态与目标衔接。持续限压或限流期间，积分累积、观测器失效和旧给定保留可能使恢复时出现额外冲击。供电恢复也可能先满足母线条件，驱动电源或测量仍未就绪。状态机要等待所需条件全部成立，按定义恢复或保持停机。验收结果需明确覆盖的注入层级和设备工况，不能从模拟通过推断整机具备认证或全部故障覆盖。

调试检查

• 对同一欠压波形改变持续时间和运行阶段，核对限制、故障及恢复的差异；保存积分、估计有效性和目标衔接，检查解除限制后的异常峰值。
• 分开列出软件输入注入、比较器输入注入和实际输出链路验证，记录触发源及响应时间；确认每项结论只覆盖对应路径，没有跨层推断。

日志、恢复与回归验证

可重复联调需要把测试输入与结果一起保存。日志至少包含固件标识、硬件版本、电机配置、参数代号、命令来源和工况说明，波形带采样周期、量纲及有效性。串口导出若存在丢包或抽取，应记录序号与抽取规则；否则两次曲线的差异可能来自记录方式，而不是控制变化。关键事件可使用周期号将快环缓冲与慢速状态日志关联。

恢复验证要跨越复位和重新上电，检查故障记录、参数、运行许可及控制权是否按契约保留或清除。设备重新通信后，上位机需要读取当前状态并决定后续操作，不能只因链路恢复就把中断前的一组命令重发。持久化忙、记录损坏或版本不兼容也要有可重复输入和可检查输出，使配置恢复错误能够与控制算法故障区分。

回归用例应围绕已经明确的产品行为建立，保存输入序列、初始条件和判据。比较模拟量时可按工程允许范围设置数值与时间容差，状态顺序、非法输出使能和禁止自动重启等条件则需要独立检查。新的固件不能只更新基准曲线让差异消失；应解释差异对应的需求变化或缺陷修复，并保留旧基准和变更原因。调试工具开启后的时序结果也应与正常运行模式核对。

调试检查

• 用相同配置与输入重放一次基准和一次新版本，检查波形单位、周期、缺样标记及事件对齐，确保容差有需求依据，离散状态判据没有被曲线比较替代。
• 覆盖存储过程中复位、故障后重启和控制链路恢复，核对参数版本、历史事件及运行许可；关闭调试输出后复核关键响应，记录工具引入的时序差异。

电源、功率级与控制板

伺服驱动的系统边界包含辅助供电、直流母线、三相功率桥、栅极驱动、采样与控制板。控制板决定目标和调制，功率级把母线能量送入电机，辅助电源维持控制与驱动器工作。三者启动和掉电次序影响输出许可，不能只凭MCU程序已经进入主循环就认为功率部分准备完成。

建立信号表时注明各电源监测、驱动器故障、PWM使能、制动与反馈接口的有效电平和默认状态。复位期间引脚可能高阻，硬件应提供符合设计的确定输出状态；软件初始化再接管。母线测量与栅极驱动欠压状态也要参与许可，避免控制电源正常而门极电源未建立时继续发出调制。

板卡带起按模块拆开：先确认低压供电和时钟，再验证采样、驱动逻辑与无功率PWM，最后在受控条件连接母线和电机。为每一步规定可观测量，记录板卡版本、配置和故障入口。参考设计中的额定电压、电流、布局和器件只适用于该设计；移植时应按实际硬件重新验证。

软件维护电源、功率准备、控制初始化和运行许可的独立状态，故障时保留哪个环节先失效。不要通过给一个总使能变量赋真绕过所有条件。联调中同时观察母线、驱动供电和输出许可的建立/释放顺序，重点覆盖上电抖动、部分掉电与复位后旧指令残留。

调试检查

• 记录控制供电、门极供电、母线检测及PWM许可的时间轴，检查任何未满足条件时不放行输出。
• 单独让辅助供电或驱动电源异常，核对故障原因、默认引脚状态和重新运行条件。

控制任务与通信接口

伺服固件通常把电流控制、较慢速度/位置控制、通信服务、参数管理和诊断分成有明确周期的执行路径。通信提供目标和模式，控制器在固定采纳点使用它们；收到一帧数据不能直接改变PWM执行节奏。实时预算应覆盖采样、反馈更新、控制计算、调制和实际寄存器装载。

接口定义把目标单位、正方向、限幅、有效状态和更新时间写清，形成完整命令快照。模式、控制字与目标不能由通信任务分别改写共享结构；消费者只接收验证完毕的同一版本。对PDO、串口或本地调试入口使用统一命令仲裁，明确当前控制来源与失联策略。

调度中电流快环避免阻塞访问、动态分配和无界日志；参数保存、协议长事务放入后台。速度和位置环降采样时，使用其真实周期计算离散增益，而不是把快环周期复制给全部环。任务优先级只是调度工具，还需测量抢占和临界区对截止时间的影响。

联调将协议到达、命令发布、控制采纳与输出生效分开观察，识别迟到目标还是快环超时。测试通信满负载、后台保存和故障上报并发，确认控制仍按预算执行。若只测平均CPU占用，可能忽略偶发的最坏路径；应记录超时计数和版本，而非凭界面刷新正常判定实时性。

调试检查

• 同时施加PDO更新与后台参数操作，量测快环最坏完成时间及命令年龄。
• 切换控制来源与模式，确认被采纳的目标属于同一快照且旧来源不能继续写入。

电机、反馈与机械负载

伺服响应由电机电气参数、位置反馈、机械惯量、传动比、摩擦和弹性共同决定。控制器的输入不应只有电机额定功率，还需极对数、磁链或转矩系数、绕组参数、反馈分辨率及负载方向。相同电机接不同负载时，速度环与位置环的整定和限幅条件可能完全不同。

建立电机与负载参数表，标明单位和测量/手册来源。电机轴与负载轴位置通过传动比换算，编码器装在不同位置会改变闭环看到的误差。弹性联轴器、减速器间隙和机械共振不能靠提高控制增益直接消除；应先识别反馈安装位置和机械约束，再选带宽与滤波。

反馈链路应有有效性与数据新鲜度标识，失效时不把最后角度永久当成当前角度。增量编码器上电通常不提供绝对电气零位，是否需要对齐、找零或保留位置由实际结构决定。带抱闸系统还需明确抱闸开闭时机、承载条件及其与驱动力矩的配合。

带起测试先验证正负方向、反馈计数与机械动作一致，再在限流、限速条件下逐级连接闭环。负载变化时记录惯量估计、跟随误差、控制输出和限制状态，区分参数错误、反馈延迟与机械约束。不能把空载一次往返成功推广为全负载定位性能或安全停机能力。

调试检查

• 对照电机轴和负载轴运动，核查传动比、正方向、极对数及反馈计数换算。
• 改变负载或机械连接后重复误差与限制状态记录，确认整定结论覆盖了实际工况。

系统约束与验证入口

伺服验收需要把定位、速度、转矩、温升和通信要求变成明确工况下的可观察指标。每项指标都写明母线、负载、温度、轨迹、持续时间和反馈条件；一句“高精度”无法形成测试。能力还受电流、可用电压、机械速度和散热约束，不能要求控制器在饱和后仍维持同样动态响应。

验证入口按依赖建立：采样校准、相序与角度、PWM/ADC时序、电流环、速度环、位置轨迹和通信控制。每一步保存通过条件与原始记录，失败停在最接近原因的层。软件单元测试适合单位换算、限幅和状态逻辑，真实电流波形、延迟和机械误差则需要目标硬件。

对限制工况建立独立观察量，包括电压饱和、电流限幅、跟随误差、命令过期和故障反应。输出达到限制时，日志应显示实际采用目标而不是仅保存主站给定。这样可区分系统能力不足与控制错误，也能判断积分器是否在持续累积而导致解除限制后突变。

回归覆盖冷热、不同方向和负载、通信扰动及故障恢复，并记录硬件/固件版本。测试未执行的范围明确保留，不用厂商参考设计结果代替自己的数据。修改采样率、反馈滤波、编译优化或功率板后，重新验证相关时序与性能，不能只确认代码能编译。

调试检查

• 将每条性能要求关联到具体工况、记录和判定，检查有没有缺少母线或负载边界的指标。
• 达到电压/电流限制再退出，观察积分状态、采用目标和误差恢复，确认没有隐藏突变。

逆变桥与栅极驱动

三相逆变桥通过上下管组合产生电机端电压，栅极驱动把MCU逻辑信号转换为适合功率器件的门极动作。PWM有效电平、上下桥臂关系、驱动模式与默认关断状态必须一起核对。逻辑波形看起来互补，不能证明实际门极无重叠；传播延迟、米勒耦合与器件开关时间都会影响结果。

软件配置死区、最小脉宽和故障输入时，应依据功率板与驱动器参数。驱动器内置握手、死区或保护功能不能凭名称默认全部生效，需要检查具体模式与寄存器。自举供电的高侧驱动还受刷新条件约束，高占空比或长时间静态导通可能影响门极电源，应纳入运行边界。

门极驱动强度与开关损耗、过冲和噪声之间存在取舍，不能只把开通速度调到最大。通信固件可负责读回配置与故障，快保护通路仍需按实际器件容限设计。更换MOSFET、IGBT或SiC器件时，重新检查门极电压、驱动电流、关断行为和采样噪声，不能仅修改电流额定值。

联调先在受控供电与无运行命令条件验证默认状态，再测逻辑输入和实际门极/相节点的对应关系。异常脉冲、驱动欠压或故障恢复可能出现在使能边缘，重点记录上电、停机与重新许可的过渡。参考设计的测试波形只能说明其器件与布局，不能为另一块板直接背书。

调试检查

• 对照PWM输入与实际上下管门极时序，检查死区、最小脉宽、默认关闭和故障后输出。
• 读回驱动器模式及保护配置，覆盖高占空比、欠压和使能切换，确认软件假设与硬件一致。

电流、电压与温度测量

伺服控制使用的电流、母线电压和温度来自不同采样链路，其带宽、单位和有效范围不能混为一谈。相电流用于闭环与诊断，母线用于电压能力和保护，温度反映较慢热状态。采样链路需明确传感器、增益、偏置、ADC参考和换算关系，以及超范围或无效数据如何标识。

电流零偏应在符合硬件条件的已知零电流状态测得，不是在电机带载运行时把平均值强制调成零。增益校准使用有依据的输入或参考测量，记录正负方向与通道差异。带PWM抑制的放大器仍存在建立时间和频率特性，采样窗必须结合实际共模跳变与前端响应验证。

电压与温度通道可采用较慢更新和适当滤波，但保护链需要独立考虑响应时间。温度传感器开路、短路或量程外读数不能被简单夹紧成一个正常温度。ADC触发、DMA缓冲和控制采用要有时间一致性，尤其两个相电流不同时采样时，重构与变换可能受到误差。

调试把原始ADC码、工程单位、校准值和有效标志同时记录，区分换算问题与真实噪声。改变母线、占空比和负载后观察零偏、波形与饱和，检查采样前端是否被过驱动。不要通过强滤波让界面波形平滑，却把相位延迟带入电流环而未重新验证稳定性。

调试检查

• 在已知零电流和正负输入条件核查偏置、增益和符号，再观察PWM切换时的建立时间。
• 断开温度或使ADC到量程边界，检查无效标识、故障动作和滤波延迟是否符合定义。

隔离与故障保护

功率系统中的隔离服务于电压域分离和信号传递，故障保护服务于检测与限制损坏，两者需要明确各自边界。隔离驱动器具有某种额定隔离能力，并不能证明整块板的间距、供电、连接器与系统均满足同样等级。器件手册参数必须结合实际布线、工作电压和系统要求解释。

保护链路列出过流、驱动欠压、过温及其他实际故障源，注明检测位置、阈值依据、关断路径和复位许可。快速硬件故障信号可直接限制PWM或门极，软件随后记录并锁存。不能把通信任务中的慢速电流告警当作短路保护，也不能只因有隔离器就认为噪声不会影响故障输入。

故障信号跨隔离域时要核对有效电平、失电默认值、脉宽与传播延迟，防止断线被解释为正常。驱动器消隐和软关断参数需依据器件容限配置，过度消隐可能错过危险事件，过快关断可能增大过压。软件应保存第一故障与现场快照，不让后继掉电状态覆盖原始原因。

验证分别覆盖故障输入通路、软件锁存、日志和恢复，而不是只调用一个模拟故障函数就宣称整条链通过。真实功率故障测试要由合适条件和人员按设计开展；低能量注入可先验证逻辑，但不能替代器件承受能力与实际关断时序。清除记录不等于允许输出恢复。

调试检查

• 从各实际故障源注入逻辑信号，测量到PWM/驱动禁止的时间并记录锁存与第一原因。
• 测试隔离侧失电或故障线无效，检查默认状态与恢复许可，避免失效时被当作正常。

安全功能的原理与边界

STO等安全功能讨论的是规定条件下限制产生转矩的能量，不等于普通软件停机，也不等于电机立即静止。惯量会继续运动，垂直负载可能需要机械抱闸，母线也可能保持危险电压。仅设置软件禁止PWM变量，不能证明STO已经实现。

安全链通常涉及专用硬件、冗余或诊断架构、故障分析和完整生命周期要求。TI的STO参考设计给出了特定架构与评估范围，使用其中某个器件或照抄一段逻辑并不自动继承其SIL或PL结论。自研产品是否符合要求，需要针对实际系统验证与评估。

普通驱动固件可以接收安全状态，禁止新的运行许可并输出诊断，但不应擅自绕过或自动复位独立安全链。状态报告要区分安全请求、硬件实际状态、普通驱动故障和机械静止信号。通信恢复或故障清除不是恢复安全许可的充分条件，重启策略要防止旧启动命令再次产生转矩。

工程梳理可先画能量路径和安全接口，列出断线、失电、单点失效及反馈矛盾时应观察的结果。验证软件接口不能替代安全硬件验证。任何测试报告应限定实际覆盖的通道、工况与故障类型，不把模拟STO输入、普通急停按钮或一次电机停转称为完整安全合规证据。

调试检查

• 分别记录安全请求、硬件许可和驱动运行状态，检查撤销许可后旧控制字不能自动重启。
• 评审测试结果的覆盖边界，区分参考设计评估、软件禁能测试与完整产品认证。

d/q 电流内环

以转子磁链定向的PMSM伺服为讨论对象，电流内环把相电流换算到旋转坐标，分别调节d、q轴电流，再经逆变换与调制产生电压指令。坐标正方向、相序、角度偏置及变换归一化要统一。d/q数值平稳不代表转矩方向正确，错误角度可能让电流分量看起来正常却偏离物理目标。

实现流程先校正采样偏置与比例，使用时间对齐的电角度完成变换，然后计算误差、PI、必要补偿与电压限幅，最后根据母线生成调制。PI增益定义应注明离散周期及积分项是否已经包含周期因子。电压限幅与积分抗饱和配合，避免指令超出母线能力后积分继续增长。

内环带宽受到采样到输出延迟、PWM更新、传感器噪声和电机参数限制，不存在所有伺服通用的固定倍率。先确认硬件与符号再整定增益。外环给定需要电流幅值与变化约束，d/q同时变化时应考虑电流矢量边界，而不是分别把两个轴都夹到同一最大值造成合成过流。

调试从受控的小电流指令开始，观察相电流、d/q反馈、电压采用值和饱和标志。正负阶跃与不同电角度下都要核对响应；仅一个固定角度成功不能证明全周一致。再用适当的方法估计带宽与稳定余量，厂商示例结果只能作参考，不是自研板卡已经达到的性能。

调试检查

• 在不同电角度给出小幅正负电流目标，检查相序、变换符号与反馈响应一致。
• 改变母线或达到电压限制后解除，核查抗饱和、积分状态和输出恢复没有突变。

转矩指令与限幅

转矩模式把外部机械目标转换为电流目标，但转换关系依赖电机模型、磁链、极对数、归一化和电流定义。表贴PMSM在特定假设下可简化转矩与q轴电流关系，内埋PMSM还涉及磁阻转矩；不能把一个固定Iq倍率推广给全部电机或把峰值与RMS电流混用。

产品参数表注明额定转矩、转矩系数的单位和电流基准，接口同时给出命令转矩、实际采用电流和限制原因。上层转矩倍率、机械传动方向和电角度方向要统一。内部限幅结合电机、功率器件、温度和可用电压，不能只按通信对象的数值类型上限允许输出。

动态指令需要幅值与变化速率限制，避免一步转矩跳变激发机械冲击。速度达到边界时，转矩模式也必须有明确策略；它不能像位置模式那样天然约束轴位置。限制改变时处理积分和目标交接，温度降额或母线变化不能让外环继续按已失效的能力积累误差。

验证先在无功率条件核对单位与编码，再在受控条件比较命令、dq电流与负载响应。实际转矩测量需要对应传感器与工况，不能仅从软件Iq换算值宣称测得输出转矩。正反方向、持续负载与短时峰值分别验证，记录采用值而不是只保存目标，从而解释限制为何发生。

调试检查

• 核对转矩系数、极对数及峰值/RMS基准，检查正负命令到Iq的方向与倍率。
• 触发热降额或速度边界，观察采用电流、限制原因和恢复过程，不以软件估算替代转矩实测。

前馈与解耦

伺服电流环中的前馈与解耦用于减少可预测的电压需求对PI误差的影响，常涉及旋转坐标中的交叉项和反电动势。它依赖电机参数、速度与符号约定，不能仅把网上公式的正负号搬进固件。先建立所用坐标方程，再核对实现中电气角速度、Ld/Lq和磁链单位。

把PI输出、前馈项与最终采用电压分开记录，限幅后将抗饱和反馈作用于实际控制结构。补偿也会占用电压余量，不能先分别限幅PI和前馈再相加超出调制边界。对参数误差或速度噪声，设计补偿有效范围和滤波/限幅，避免高增益前馈在启动或反馈无效时放大错误。

验证先在补偿关闭时建立可信内环，再单独开启某项比较扰动与转速变化下的电流误差。低速角度未锁定、速度估计突变或电感随电流变化时，模型补偿可能不准确，允许渐入或受限使用。某些FCL库有特定API与变量组织，移植时需按版本读实现，不靠变量名称推断公式。

调试重点是补偿是否在正确执行点使用同一周期的数据。速度采用旧样本而角度和电流采用新样本，会形成额外不一致。若开启补偿后振荡，先查单位、符号、延迟和饱和，而不是继续提高PI增益。结果需在不同方向和母线条件验证，不能凭一次高速波形更平滑就判定普遍有效。

调试检查

• 分别记录PI、前馈和限幅后电压，改变旋转方向检查交叉补偿符号与坐标方程一致。
• 补偿开关与参数偏差测试中比较误差和饱和，确认无效速度或角度不会放大输出。

采样延迟与纹波

伺服电流纹波由PWM开关、电机电感、母线、电流检测位置和控制输出共同决定，而显示曲线还受采样相位与滤波影响。不要把每次ADC都取到同一相位的平滑序列当成真实电流没有纹波。应区分瞬时开关纹波、控制周期变化与采样噪声，选择相应测量带宽和观察点。

闭环有效延迟包括模拟前端建立、ADC转换、中断等待、运算、PWM影子装载及其他数字滤波。缩短计算耗时只减少其中一部分。对单分流或低侧采样，还需验证占空比变化后有效窗口是否足够；窗口失效时不能把无意义样本硬塞进dq变换。

角度与电流的时间关系也影响高速电流误差，可依据已确认模型考虑延迟补偿，但先要知道真实延迟而非猜一个常数。滤波降低噪声会引入相位滞后，需要重新检查环路。PWM频率提高可能改善纹波却增加开关损耗和CPU负担，选择应结合功率与实时约束，而非只追求更细腻的曲线。

测量同时记录ADC触发、ISR开始/结束、PWM实际装载以及相电流波形，比较不同占空比、方向和母线。通信与后台任务满负载时也测最坏等待。若修改采样位置、驱动器开关设置或放大器后波形改变，应重新检查采样比例和窗口，不能只调PI把硬件采样缺陷掩盖。

调试检查

• 对照示波器电流波形与ADC样本相位，区分真实纹波、混叠和前端建立不足。
• 量出采样到PWM装载的完整延迟并覆盖高调制度窗口，检查无效样本与截止时间计数。

速度外环

速度环根据机械速度误差生成转矩或q轴电流目标，依赖电流内环先具备可信的跟随能力。其对象包含机械惯量、摩擦和负载转矩，与电流环的电气对象不同。整定前固定速度单位、方向、估算方法与更新周期；机械rpm、电气频率和每周期增量不能混用。

速度反馈常由位置差分、捕获周期或组合估算得到，低速量化与滤波延迟会影响控制。需要根据反馈分辨率和速度范围选择测量窗口，不能为了曲线平滑加入过强滤波却忽略相位。外环执行周期通常可以慢于电流环，但离散PI积分增益应使用外环实际周期。

输出限幅结合电机与功率级可用电流，速度目标还应有轨迹约束。电流饱和时速度PI进行抗饱和或有明确积分处理，避免负载解除后高速冲出。负载改变、机械共振或反馈噪声不应一概用更大增益处理；先观察电流采用值、速度误差及限制状态，判断是对象变化还是反馈链问题。

验证先给小幅速度阶跃和扰动，记录目标、反馈、电流目标与实际电流，再改变负载和方向检查稳定性。频率分析可辅助估计带宽与余量，但测试注入幅度和运行工况要适合系统。厂商双轴参考设计展示一种分析方法，不代表任意负载都能采用同一组增益或同一带宽比例。

调试检查

• 核查速度测量窗口和滤波延迟，比较低速、高速与换向时反馈是否连续且单位一致。
• 让电流达到限幅再卸载，观察速度积分状态和超调，确认抗饱和与目标斜坡有效。

位置环与级联关系

位置环把位置误差转换为速度或其他中间目标，再由速度和电流路径执行，形成不同时间尺度的级联。位置反馈可能来自电机轴，也可能来自负载侧，两者闭环对象不同。设计先明确轴坐标、零点、传动比、正方向和位置范围，不能只把编码器计数当作已经校准的机械位置。

带起顺序先验证电流环，再验证速度环，最后连接位置目标和轨迹。位置环带宽受内环能力、反馈延迟与机械结构限制，不应把三个环同时调大。最外环输出也有速度和加速度边界，位置误差较大时产生的目标必须受约束，否则可能在长距离命令下持续驱动内环饱和。

计算位置差时处理多圈数、计数回绕、最短路径还是指定方向，以及整型宽度。不能在回绕边界用直接减法得到一个巨大的假误差。回零、模式切换和反馈复位时需要重新对齐目标与坐标，避免坐标突然变化后控制器认为轴偏离目标而产生冲击。

验证包含小位移、长行程、正反方向、停留与跨回绕情况，观察位置误差、速度采用值和电流限制。机械间隙和弹性会导致电机轴定位正常而负载定位不符，需要根据反馈位置解释。只看最终到位数值不能判断整个轨迹是否稳定，也不能证明不同负载下的定位精度。

调试检查

• 在计数回绕、回零和模式切换时检查位置误差计算与目标重建，确认没有突发大给定。
• 分别观察电机轴与负载轴反馈，核查级联带宽、速度限幅和机械间隙对结果的影响。

指令轨迹与前馈

位置命令需要经过速度、加速度和必要时跃度约束，形成系统能够执行的轨迹。梯形速度与S曲线适用不同的机械平顺要求，选择取决于负载与周期预算。一个目标位置阶跃不能直接解释为可实现的瞬时运动；规划器输出的位置、速度和加速度应来自同一时间点的连续轨迹。

前馈利用规划轨迹的速度或加速度分量减少可预测的跟随误差，但不替代反馈纠错。单位、符号和注入点要与级联结构一致，速度前馈加在速度目标处，转矩前馈则需要负载模型与限幅。不能把轨迹导数重复加入多个环，或在目标缺帧后计算出异常加速度并放大输出。

通信周期与本地控制周期不同时，明确目标保持、插补或重规划规则，记录每个目标的有效时刻。收到新终点时处理当前速度和加速度，而不是每次重新从零速开始。规划器要考虑停止距离与行程限制，前馈总输出仍受电流和可用电压能力约束，并与积分抗饱和配合。

调试先关闭前馈验证基本轨迹，再分别开启速度和加速度项比较误差、超调与饱和。测试短行程、换向、连续目标更新和取消运动，检查轨迹连续性与停止行为。精度结论要绑定负载、速度和测量条件，不能因一个软件曲线与目标重合就称实际机械运动已经达到指标。

调试检查

• 连续改终点、取消及换向，检查位置/速度/加速度边界连续且停止距离符合约束。
• 分别开启前馈项，对照误差与限幅后输出，检查单位、符号及重复补偿。

跟随误差与动态响应

跟随误差表示期望轨迹与实际位置之间的偏差，其计算基准必须明确。主站最终终点、插补后瞬时目标和驱动本地受限目标并不相同；把终点减当前位置可能只是剩余行程，而非闭环跟随误差。位置和反馈若来自不同采样时刻，也会把时间差误认为控制误差。

监测一般结合幅值与持续时间，还需运行模式和有效反馈条件，避免短暂正常动态误差与持续失跟混为一谈。阈值单位按真实位置尺度定义，不能复制其他设备的编码器计数值。触发后采取何种停机、限制或故障反应，取决于机械和功率边界，不从一个错误位名字推断实际动作。

动态响应应同时观察轨迹、实际位置、速度、电流以及限制标志。误差可能来自电压饱和、转矩不足、通信迟到、反馈延迟或机械共振，不应只靠提高位置增益压小一个数值。统计稳态误差、峰值误差、恢复时间与不同方向表现，保留采样周期和数据对齐方法。

验证覆盖加减速、负载变化、连续目标更新和故障恢复，记录发生条件而非只截取最好看的曲线。监测可以在主机侧检查计算和时间窗，但实际停机距离、反馈链与机械位置需要硬件验证。Beckhoff平台监控参数是具体实现参考，不是所有自研驱动必须照抄的阈值与动作。

调试检查

• 用同一时基比较插补目标和反馈，确认监测的是跟随误差而不是剩余行程。
• 改变负载及限幅条件，记录峰值、持续时间和故障动作，检查阈值单位与停止策略一致。

编码器、Hall 与位置反馈

不同反馈器提供的分辨率、绝对性、延迟和失效信息不同。增量编码器通过相位变化计数，绝对编码器返回规定格式的位置，Hall通常提供较粗的转子区间。选择应依据启动、低速转矩、定位和环境要求；不能把信号能解码等同于满足所有伺服反馈需求。

增量链路核对A/B相位、计数倍率、Z脉冲处理、计数范围和输入滤波，绝对链路核对时钟、帧长度、校验、状态位与传输延迟。电缆、供电、接口电平和差分接收也属于反馈链，软件不能通过换一个符号掩盖断线或电气不匹配。Hall组合还需要合法序列和异常状态检测。

反馈数据应携带有效标识、时间或序号，与控制使用时刻对应。滤波、串行读取与重试会延迟位置，尤其高速下影响电角度。失效策略要区分暂时校验错误、连续丢样、计数异常与传感器复位；最后一次位置不能无限保持为“当前有效”。

联调先在不输出转矩条件手动转动或使用可控输入，核查方向、每圈计数与零点，再连接受控电机运行。记录原始反馈、解码位置、速度和有效状态，方便识别协议解析、单位换算与实际机械问题。参考eQEP手册适用于列出的芯片，其他MCU输入滤波和锁存规则需另查。

调试检查

• 手动转一整圈并反向，核对计数倍率、方向、索引脉冲及反馈文档所定义的分辨率。
• 注入断线、坏校验和连续丢样，检查有效状态、最后样本年龄及驱动故障处理。

角度对齐与解码

FOC所需电角度以转子磁链与相绕组关系为基准，编码器机械零点或Z脉冲并不天然等于这个基准。应先定义相序、正转观察方向、编码器方向和Park变换约定，再确定电气零偏。把能连续读出机械角度当作已经完成换相对齐，会导致电流方向和转矩不一致。

解码路径显式处理计数回绕、绝对帧校验、状态和多圈信息，输出统一机械位置与有效标志。对齐过程应依据电机、反馈类型和机械约束设计，记录条件与结果。带负载或抱闸轴能否执行会产生运动/力矩的对齐动作必须事先确定，不能无条件在每次上电自动运行。

零偏参数与电机连接、编码器安装和方向相关，存储时关联硬件/配置身份，并在升级后验证适用性。换相符号不是简单选择“电机能转”的组合；错误关系可能在空载低速看似正常却产生很大d轴电流或错误转矩。不要用修改PI增益弥补未确认的角度基准。

测试用完整一圈或多个电角周期检查角度连续性及dq反馈，再在受控电流条件核对正负转矩方向。把相电流、原始机械位置、换算电角度和对齐偏置一起保存，可区分相序错、极对数错和偏置错。改变接线、反馈器或机械安装后，重新核查而不是沿用旧校准。

调试检查

• 在一个完整机械周期检查电角度重复次数和连续性，确认相序、方向与极对数一致。
• 变更接线或编码器安装后检查零偏适用性，记录dq电流与转矩方向，禁止直接复用旧校准。

机械量与电气量换算

机械位置描述轴运动，电角度描述转子磁场相对定子的周期，二者由极对数与偏置连接。典型关系写为电角度等于极对数乘机械角度再加对齐偏置，最后按一个电周期归一化；方向符号必须纳入已定义约定。机械转速和电气频率同样不能直接互换。

接口层固定角度单位是弧度、度还是每圈归一化值，速度是rpm、弧度每秒还是计数每周期。编码器分辨率需区分线数、边沿计数倍率和绝对位数，传动比还要说明反馈位于电机轴还是负载轴。整型换算先选择足够宽的中间量，避免乘极对数或倍率时溢出。

每周期位置差分估算速度时，处理计数回绕和时间间隔，不能假定每次读取都准确等于固定周期。低速可能出现量化，高速需要考虑反馈延迟与电角度外推；采用何种方法应明确有效范围。滤波后的速度与即时位置有不同时间特性，使用者不能把二者当作同一时刻的原始量。

工程核查可用已知每圈计数、极对数和方向建立纯软件向量，再对照实际手动转轴。电机转一圈对应多少电周期、负载转一圈对应多少电机圈，应分别验证。公式检查通过仍不能证明安装与接线正确，必须把物理方向和真实反馈关联到同一约定表。

示意：θe = wrap(p × θm + θoffset)；p为极对数，符号与wrap区间依所用坐标约定。

调试检查

• 用正反转、回绕和极对数边界向量验证换算，检查整型中间量与单位不发生溢出或混用。
• 实际转轴比较机械圈数、电角度周期数和负载传动比例，核查物理方向与软件约定一致。

无感估算的应用条件

无感算法从电压、电流与电机模型估算角度和速度，能否替代反馈器取决于观测原理、运行区间和应用要求。基于反电动势的方案在低速或零速信息不足，不能直接承诺静止位置或满载启动性能。伺服的保持、低速定位与快速换向要求，应与具体估算方法的可观测范围对照。

估算器输入要反映实际施加电压和有效电流，而不是未经限幅的理想控制指令。死区、母线变化、采样偏置和PWM更新延迟会导致模型误差。模型参数还受温度与工况影响，需明确来源、单位和适用范围；不能把一个观测增益用于所有电机再依靠滤波掩盖不一致。

启动和模式交接需要独立设计，包括角度建立、开环或其他初始化、估算有效判定、渐入闭环及失锁恢复。估算角度与反馈角度切换时保持方向和偏置一致，避免瞬间产生dq跳变。PLL滤波带宽与动态响应有取舍，校验有效性应同时看残差、信号条件与运行区间，而非只看估算值在变化。

验证先用可信反馈作为对照记录估算误差、速度和负载，再探索启动、低速、反转及母线扰动。某一转速估算平稳不能推广到全区间。Microchip AN1292展示特定PMSM PLL与弱磁方案，电机和硬件条件需要重新验证；它不直接保证精密伺服所有位置功能。

调试检查

• 用有反馈工况对照估算角度，在低速、反转和负载变化时记录误差及有效标志。
• 测试启动交接与失锁，观察角度连续性、dq电流和恢复策略，明确不能覆盖的运行区间。

位置/速度/转矩模式

位置模式关注跟踪轨迹，速度模式关注转速，转矩模式关注产生的力矩或相应电流；三者边界和用户责任不同。转矩模式通常不会天然限定轴位置，速度模式也不保证负载达到指定位置。产品应明确每种模式启用哪些环、目标单位、限制条件和有效反馈，而不是只改变一个模式编号。

命令路径为每种模式设置独立的目标解码和采用规则，再共享底层电流与保护。位置模式先规划或插补，速度模式提供加减速与电流约束，转矩模式处理幅值、变化率及速度边界。控制来源、输入有效时间和限幅后采用值应可以读取，便于上位机理解为什么目标没有被直接执行。

切换模式前明确必须停机还是支持在线受控转换，并处理积分器、轨迹缓存和旧目标。未确认实际模式之前，不把新目标写进旧模式的字段。位置坐标、回零状态和转矩基准在切换中也可能变化，需设计初始化与失效条件，不能用清零所有变量一招解决全部转换。

测试先在无能量或受控条件验证单模式，再覆盖带非零旧目标的切换、命令暂停和取消。记录目标、实际模式、各环采用值与输出许可，判断切换是否产生跳变。公开驱动模型给出接口思路，具体设备支持模式和可选对象需要说明；不应声称所有CiA 402模式都已实现。

调试检查

• 从非零目标切换模式，核查旧轨迹和积分状态处理以及新目标在模式确认后才生效。
• 分别达到位置、速度和转矩限制，检查返回采用值与状态是否能解释应用行为。

CiA 402对象与使能

伺服采用CiA 402接口时，对象是通信侧访问驱动行为的窗口，必须连接到真实状态、模式和反馈。控制字提出请求，状态字反映结果，模式请求与模式显示分别表明期望和实际模式。仅建立索引并把写入值回显，无法证明电机具备运行条件或目标进入了闭环。

驱动状态机应核对母线、反馈、参数和故障后再许可输出，并把拒绝条件映射到可解释的诊断。NMT Operational或EtherCAT OP属于通信状态，不能替代驱动Operation enabled。初始化时保持合法禁止状态，收到有效控制字也要通过应用条件，不能在网络连接回调中自动打开功率。

控制字、模式和目标由同一周期快照传给应用，对边沿动作与持续命令分别处理。故障复位要确认实际故障已消除且满足恢复许可，不让主站持续置位导致每周期清掉诊断。快速停止和取消使能对应何种输出行为，取决于所支持选项与机械能力，应写清而非只返回一个状态码。

联调从读身份、确认对象属性开始，再逐步完成状态转换，记录控制字、状态字、模式显示、PWM许可和采用目标。测试未满足反馈或母线条件时的使能请求、故障期间请求和复位后旧目标。示例SDK只能说明接口接入，实际驱动保护与时序需要独立验证。

调试检查

• 保持通信正常但阻断反馈或母线许可，检查控制字请求未造成虚假的运行状态。
• 以持续和边沿方式发送故障复位，观察实际故障、状态转换及新使能要求。

参数、单位与指令更新

伺服接口需要把位置、速度、电流/转矩及时间参数定义到可独立验证的单位。主站的工程单位、线上整数缩放和内部归一化量是不同层，转换集中在受控边界完成。峰值与RMS、电机轴与负载轴、机械与电气速度混用，都会产生数值看似正常而动作错误的问题。

参数表同时声明宽度、有符号性、倍率、默认值、合法范围、生效条件与保存策略。指令更新还注明有效时刻、序号或周期以及失联判断；不能把一条很久以前写入的目标永远当作最新命令。超过范围的配置拒绝，连续运动目标是否裁剪则按公开限制返回实际采用值与原因。

多个参数组合或跨寄存器大数要完整提交，控制中断不得看到一半新一半旧的数据。单位换算使用足够宽的中间量，处理整数溢出、位置回绕和非法浮点。模式变更或反馈零点更新时，对尚未消费的目标重新验证，避免它原本合法却在新坐标或新倍率下变成危险量。

联调用识别性位型验证编码，再用可控正负运动检验物理尺度。记录线上原值、解码值、限幅采用值和实际反馈，分清协议字序与机械误差。修改倍率、极对数、传动比或固件对象版本后应重新检查兼容性，不能靠界面显示一样就认为旧控制程序仍可使用。

调试检查

• 使用正负值、边界值和跨字位型验证接口，再比较线上数值到机械运动的尺度。
• 改变参数倍率或模式时检查未消费目标、版本和控制快照，确认旧目标不能按新单位直接执行。

通信和控制边界联调

伺服联调要观察命令从线路到机械输出的完整路径：协议验证、控制权仲裁、状态许可、目标快照、控制计算及PWM生效。网络抓包只证明报文，软件变量变化只证明某个阶段。调试记录各阶段的序号、时间和拒绝原因，才能判断“有目标但不动作”发生在协议还是应用边界。

通信周期与本地电流周期通常不同，设计目标保持、插补和采用点，并明确数据过期窗口。主站突发多条指令不应把控制任务改成按报文触发；接收缓存只保留定义允许的事务，过期目标有明确丢弃规则。多个接口同时连接时，控制来源切换需要新命令和清晰许可。

联调先锁定单模式与单控制源，确认状态和单位，再增加通信压力、模式变化、参数访问与故障上报。将期望目标、实际采用目标及反馈分开比较，观察电流/电压限制。协议侧重试不能让动作反复执行，网络恢复也不能自动重放旧轨迹或清除驱动内部故障。

验证矩阵包含主站停止更新、网络切出运行、延迟和丢周期、设备复位以及恢复。记录通信状态、驱动状态、命令年龄和输出行为，区分同步、活性与执行截止时间。主机侧模拟可验证仲裁和接口转换，机械停止距离与真实采样延迟仍需目标硬件测试，不能用虚拟反馈代替实际轴。

调试检查

• 沿同一指令序号追踪接收、发布、采用和PWM生效，定位缺失或迟到阶段。
• 让主站停止更新后恢复，检查应用失联动作和控制源许可，确认旧轨迹不被自动重放。

电气、角度与机械方向

联调首先建立三份互相对应的方向定义：功率端A/B/C相序与电流正方向，反馈器计数/角度方向，以及从规定观察位置看到的机械正转。三者不一致时，轴可能无法稳定换相，也可能在某些条件看似旋转但产生异常电流。不能用“调到能转”为验收标准，更不能先提高增益掩盖符号问题。

无功率或受控条件下验证原始反馈每圈计数、回绕和方向，再对照相电流采样通道与PWM输出。电气零偏、极对数及变换归一化集中写入约定表，所有算法与通信对象使用同一套单位。换线、换编码器或改变机械安装后，对齐参数需重新验证适用性，不默认存储值永远正确。

在限制电流与速度的运行条件下，分别检查正负目标、dq反馈和机械方向，观察角度偏置变化是否符合模型。传动比、负载侧反馈与机械间隙还会影响最终轴方向和位置，不能只核对电机轴。抱闸或受约束负载的对齐操作需按实际系统规划，不把会产生运动的测试当成无副作用的软件检查。

保存接线版本、反馈配置、零偏来源及验证波形，把原始计数、机械角、电角度和dq电流关联到同一时间。出现回归时先比较这些事实，再查控制增益。例程中的极对数、通道顺序或传感器型号属于其测试条件，移植后必须以实际电机与功率板重新建立证据。

调试检查

• 对照正负目标的物理方向、反馈计数和dq电流，检查约定表能解释全部结果。
• 改变接线或反馈配置后重复全周检查，确认旧零偏与极对数配置不会被未经验证地沿用。

多环整定与轨迹验证

伺服多环整定从最内层开始，先确认采样与电流环，再连接速度和位置路径；每层先限制输出并验证基本单位与方向。内环不稳定时外环无法补救，外环过快也会让内环和机械结构承受无法跟随的目标。带宽关系需要结合延迟、负载和机械共振确定，而不是照抄固定增益。

建立可重复的测试轨迹和负载条件，记录每环目标、反馈、误差和限制状态。电流阶跃、速度变化与位置运动分别作用于不同对象，不把一条位置曲线当作所有环的性能证据。频率分析能辅助识别带宽与余量，但注入点、幅度、工作点和非线性限制都影响结果，应明确适用范围。

整定过程中每次改变有限参数，保留前后波形与参数集。遇到振荡先检查饱和、反馈延迟、角度/比例和机械异常，再判断是否为增益问题。前馈和滤波在基本环路可信后分别加入，避免多项同时变化而无法解释改善来源；持续限制时还要验证积分处理及解除后的恢复。

轨迹验证覆盖短行程、长行程、换向、停留、连续更新和取消，确认速度/加速度边界、停止距离及误差监测一致。空载整定不能直接覆盖满载，单向成功也不能覆盖换向间隙。更换功率板、反馈滤波、PWM周期或负载后，重新检查相关环与时序，不把原参考设计的结果当作自己的实测。

调试检查

• 按电流、速度、位置顺序保存同工况前后记录，核对各层限制和频率分析注入条件。
• 回放换向、取消及达到限幅的轨迹，检查误差恢复、积分状态和机械响应在规定边界内。

通信中断与故障恢复

伺服恢复过程需要区分通信失联、驱动故障、反馈失效和供电异常。网络恢复只能说明链路重新可用，不能自动消除其他故障或确认旧目标仍有效。应用应分别维护通信状态、驱动状态、命令新鲜度、活动故障及运行许可，以便上位机判断恢复停在哪个条件。

失联动作由产品要求和机械能力确定，可涉及保持、受限减速或输出禁止；任何方案都要验证实际能量和轴行为。控制任务使用最后完整快照直至定义的失效点，而非任意字节刷新活性。进入失联或故障状态后，使过期目标和未完成轨迹明确失效，不能把排队中的旧启动请求在恢复后继续执行。

恢复流程先确认真实故障已消除、反馈与参数有效、通信配置一致，再按规定的新控制字或本地操作重新建立许可。清历史日志、清活动故障和复位协议栈分别有独立含义。断线、重连或设备复位期间，输出默认状态与抱闸配合要符合实际系统，不能只依赖上位机再次发送停机包。

测试分别中断心跳/PDO、切出EtherCAT OP、复位通信栈以及制造本地故障，记录何时触发和恢复为何被允许。对网络尚正常但控制给定停滞的情况也要覆盖。验证逻辑可在主机模拟，真实停止时间与机械负载仍需目标硬件证据；不宣称一次自动重连成功就代表整个故障恢复安全。

调试检查

• 分别冻结有效给定、切断网络和注入本地故障，检查触发原因、输出动作与记录能区分。
• 恢复后保留旧启动值但不发新许可，确认驱动不会自动重放轨迹或直接再次使能。

跟随误差、日志与回归

有效诊断记录需要连接异常现象与控制链状态，而不只是存一个“位置误差过大”代码。发生跟随异常时保存轨迹目标、实际位置、速度、电流目标与反馈、限幅状态、模式、命令序号和相关时刻。采样周期与单位也属于记录，否则不同版本的日志无法直接比较。

现场缓冲使用有界事件或环形记录，优先保存第一异常前后的窗口，标注丢记录和覆盖规则。控制中断同步打印会改变时序，可能制造或遮蔽问题，应把采集与导出分开。故障后母线或反馈下降可能是后果，不能让后继事件覆盖最初导致跟随误差的限制或迟到目标。

回归用固定轨迹、负载范围、配置和固件版本比较，先复现再做最小改变。把“错误不再出现”拆成测试次数、覆盖工况与仍未验证范围；不要因为一次运动正常就判断根因已消除。对纯坐标换算与状态逻辑可做主机测试，对机械响应、PWM延迟与反馈噪声继续使用目标硬件。

维修或升级后重跑与改动相关的验证入口，例如反馈配置变更检查角度/单位，调度变更检查最坏截止时间，轨迹算法变更检查取消和换向。日志、原始曲线、参数集与版本共同形成可复查记录。

调试检查

• 触发跟随误差时核对前后窗口、首故障、限制标志和命令年龄，确认日志可解释因果顺序。
• 用固定配置与轨迹复测修改前后，保存尝试次数、原始测量记录和硬件证据。

整流、母线与逆变桥

常见电压源变频器将交流输入经整流形成直流母线，再通过三相逆变桥产生电机所需电压。整流器可以是二极管桥、受控整流或有源前端，不同结构决定输入电流形态以及能量能否回送电网。直流供电设备则可能没有输入整流级，因此系统图应按实际拓扑绘制，不能把所有变频器固定描述成同一种功率链。

母线电容既平滑整流脉动，也暂存运行过程的能量。上电需要管理充电冲击，常见预充电阻和旁路接触器应有状态、反馈与超时；有源预充则具有自己的控制及故障条件。母线已达到某个电压不等于旁路执行成功，应检查接触器反馈或相应诊断。断电后电容仍可能储能，放电路径与电压确认属于独立设计内容。

逆变桥使用PWM把母线电压转换成平均相电压，输出频率、幅度和相位由运行算法确定。普通二极管整流前端通常不能把制动能量主动送回电网，减速时需要根据母线、制动单元与负载能力处置。系统维护应记录整流、预充、逆变、制动和放电的实际边界；仅看MCU使能标志，无法证明所有能量路径都已经处于预期状态。

调试检查

• 核对整流拓扑与制动回馈路径，列出预充、旁路、放电和逆变运行的前置条件及反馈来源。
• 检查上电充电、旁路失败和断电后的母线变化，确认电容残余能量与软件运行状态分别判断。

控制板、采样与保护

控制板承担给定处理、运行状态、调制和测量，但不同信号具有不同实时要求。相电流服务快速控制，母线参与电压能力与异常判定，温度用于热状态和降额，通信则提供较慢的命令及诊断。把这些信号都放进同一低频轮询任务，可能让电流数据过期，也可能使母线异常在长时间平均后才被发现。

采样链包括分流或其他传感器、模拟调理、隔离、ADC及缩放，保护链可能另有比较器或驱动器去饱和检测。控制用电流与快速保护信号应说明各自带宽、有效性和动作路径。软件限流能改善运行约束，硬件快速关断应承担其设计的短路或器件保护角色；不能用控制中断正常执行来证明功率故障已能及时截断。

接口设计还要考虑控制板复位、供电先后、PWM默认电平和故障信号极性。MCU未启动时，驱动器应有明确的禁用状态；采样隔离侧失电后，异常输出不应被解释成真实零电流。诊断应保留来自驱动器、ADC与运行算法的原始原因。参考设计提供的是一种可借鉴架构，保护阈值、延迟和覆盖范围仍需按具体器件与产品配置验证。

调试检查

• 画出控制采样和硬件保护两条路径，核对带宽、故障极性、MCU复位时的PWM与驱动器默认状态。
• 注入采样侧失电、控制板重启和保护输入，分别检查有效位、实际门极输出及故障原因记录。

电机、负载与上位控制

变频器的运行目标需要与电机和负载匹配。风机、泵类工况重视连续调速、效率和过程控制，输送或卷绕可能需要转矩与加减速协调；这些要求不自动等同于伺服位置定位。使用相同三相功率桥或FOC算法，并不能说明产品支持绝对位置、多轴同步或高精度位置保持，应在接口与指标中明确实际能力。

电机铭牌包含额定电压、频率、电流、转速和连接方式，接线及参数选择应共同核对。感应电机实际转速与供电频率之间存在滑差，负载变化会改变转速；永磁电机的角度与控制策略又不同。上位系统给定频率、速度、转矩或工艺量时，需要明确换算链和有效通道，不能将一个无单位的百分比解释成所有模式通用的命令。

负载还决定启动和停止行为。高惯量负载产生较大制动能量，恒转矩负载可能需要低速持续转矩，风机在上电前可能被外力带动。系统设计应收集负载曲线、惯量、旋转方向、允许停机方式及电机冷却条件。上位控制负责过程目标，本地驱动负责执行约束与有效性判定，两者边界要写明，避免上位发出运行命令就被当作无条件输出许可。

调试检查

• 核对铭牌、星三角接线及电机类型，明确上位给定量、转换单位、运行模式和本地使能条件。
• 按负载类型检查残余转动启动、低速持续负载及减速能量，记录产品不支持的位置或同步功能边界。

产品指标与运行工况

产品指标应同时描述额定工作点和允许范围。输入电源、输出电流、输出频率、过载时间、环境温度和冷却条件相互关联，某个短时峰值不能直接代表长期连续能力。控制精度还要注明是输出频率精度还是机械速度精度，开环V/f下电气频率准确并不意味着负载变化时机械速度保持同样准确。

验证工况需要覆盖电机与负载类型、正反方向、母线变化、加减速和热状态。连续低速运行可能降低电机自带风扇冷却能力，高开关频率又可能增加功率级损耗，应依据设备设计降额。负载惯量和制动重复率会改变制动单元热负荷，不能只用一次停止结果证明连续循环能力。

需求表宜把功能、动态、保护和诊断指标分开，明确测试方法、时间窗、误差及证据来源。电机能转动只说明基本链路成立，尚不能覆盖电源扰动、通信超时和异常恢复。参考设计的功率或温度范围属于对应板卡，不应移植成当前产品宣称。法规、功能安全等级或认证状态只能引用产品已有资料，常规固件试验和器件认证不能替代整机合规结论。

调试检查

• 区分额定、峰值及持续能力，给每个指标附输入、负载、温度、冷却和测试时间条件。
• 分别验收频率输出、机械速度、热状态及恢复行为，保存未测试工况，不沿用参考板指标或推断认证。

母线电压与能量路径

母线电压是能量状态的重要观测量，但其变化原因需要结合输入与负载。整流供电能力不足、输入跌落或大加速会使母线下降，电机制动回馈可能使其上升，整流脉动则属于正常拓扑特征。对近似恒定电容量C，储能为E=½CV²，C用法拉、V用伏特、E用焦耳；该式用于估算电容能量，不能代替电容纹波、损耗及寿命分析。

制动时需追踪机械动能到母线及制动单元的路径。若前端不可回馈，能量通常由电容暂存并通过制动斩波及电阻耗散，减速能力受电阻、开关器件、温升和控制限制共同约束。延长减速时间可以降低瞬时功率，却不能在所有负载或失电条件下保证可控停机。重力或外部驱动负载还可能持续输入能量。

预充完成、正常供电、制动及放电应有不同状态与诊断。软件可监测母线上升速度、旁路反馈及制动后趋势，但判据要来自具体设计。母线测量失效时，不宜继续根据错误电压放宽调制度或触发制动。故障记录应保留母线、输入状态、运行阶段和制动占空比，帮助区分供电问题、回馈过量和测量异常，避免把所有过压统一归为减速时间太短。

调试检查

• 估算一次减速的能量与电容允许变化，核对前端能否回馈及制动电阻的脉冲和连续热能力。
• 交叉检查预充、旁路、制动和放电状态，注入母线测量无效时验证控制不会采用错误可用电压。

三相逆变桥

三相两电平逆变桥由三个半桥组成，桥臂中点连接电机，输出平均线间电压取决于占空比差与母线电压。电机中性点通常浮动，因此桥臂对母线电压与相对中性点电压不同。分析输出时应说明测量参考点、峰值与有效值，避免把示波器看到的开关脉冲峰值当成电机基波有效电压。

上下桥臂不能同时导通，互补PWM及死区需要覆盖驱动传播、器件关断和不对称延迟。死区会改变输出，最小脉宽及自举供电又限制可实现占空比。调制度提高可能缩短电流采样窗口，故调制可行域不能只由数学电压极限确定。过调制及不连续调制需要独立验证，不应在运行时默默改变算法却沿用原采样配置。

调试先检查无功率输出下的计数、相序、极性和禁用逻辑，再按规定条件逐级验证实际门极与桥臂。电机反向、输出失衡或电流尖峰要同时核对PWM请求与硬件波形；寄存器正确不证明门极波形正确。停止输出时的桥臂状态和电流续流路径也需要解释，所有PWM变低并不表示电机电流或母线能量立即归零。

调试检查

• 核对桥臂极性、互补关系、死区及影子装载，检查极端占空比下自举和最小脉宽限制。
• 比较最终占空比、门极及平均线间电压，观察禁用后的续流路径与母线变化，不只检查软件PWM标志。

功率器件与栅极驱动

功率器件选择需要同时考虑导通、开关、耐压、热和故障承受条件。IGBT、硅MOSFET与碳化硅器件的驱动电压、关断方式及寄生敏感性不同，不能仅按额定电流互换。栅极电阻、回路电感和布局决定开关斜率及振铃，提高开关速度可能降低某些损耗，也可能增加共模扰动和过压，应结合实际波形验证。

栅极驱动器提供电流放大、隔离及某些保护功能。欠压锁定、米勒钳位、去饱和检测和软关断各有触发条件与时间过程，需要依据所选器件手册配置。去饱和的消隐和滤波过长可能延迟真实故障，过短可能误触发；软关断可以改变电流下降和电压过冲，但不能把所有短路能量风险自动消除。

固件应理解驱动器就绪、故障、复位及使能接口，而不是把它只当PWM传输器。驱动电源未稳定时禁止输出，驱动器故障应锁存原因并检查所有桥臂状态。软件复位驱动故障之前，必须判断故障条件是否消失及后续启动是否需要重新预充或检查电机。具体保护电流、门极电压和消隐时间应按器件及功率板定标。

调试检查

• 逐项核对功率器件和驱动器的推荐条件、故障路径及复位要求，保存门极振铃和关断过程证据。
• 覆盖驱动欠压、去饱和及禁用输入，测量实际关断与故障报告时间，并检查过冲及误触发取舍。

隔离与信号接口

隔离边界应从人员可接触接口与功率参考地之间划分。通信、编码器、采样、门极驱动和辅助电源可能采用不同隔离方式，某个器件耐压高并不代表整个板卡隔离已经成立。工作电压、瞬态电压、爬电距离、电气间隙、污染等级和海拔等共同影响设计，应依据适用标准与产品条件审查。

信号隔离还影响延迟、默认电平和失电行为。PWM隔离需要检查传播差异及共模瞬变下的输出，模拟隔离需检查线性范围、增益与异常指示，数字通信隔离需考虑方向和总线参考。电源隔离必须与信号边界一致，若另一个调试电缆跨接了隔离两侧，预期隔离可能被破坏。测量和调试连接应纳入接口图。

常规电气隔离与安全转矩关闭属于不同功能。禁止PWM可以作为运行控制动作，但未经对应架构、诊断和验证不能称为STO，也不能从隔离器件认证推导整机安全等级。固件文档应准确描述能够观察和控制的接口，同时把硬件隔离及功能安全结论交给正式设计证据。调试时保留故障默认状态，避免为了通信便利把异常指示固定为正常。

调试检查

• 画出所有信号、电源和调试连接的隔离边界，核对工作条件、布局距离及失电默认状态。
• 验证共模扰动和接口侧失电的输出行为，区分常规禁用、隔离性能和已有正式证据支持的安全功能。

PWM 与 ADC 同步

变频器PWM与ADC同步的目标是获得可解释的电流及电压样本，而不是简单让两者使用相同频率。采样保持应落在当前拓扑允许的窗口内，避开开关瞬变并留足放大器建立时间。中心对齐、扇区和占空比都会改变可测时段，采样触发需要跟随调制或使用经过验证的固定区域。

ADC转换完成、DMA搬运和控制计算发生在采样之后，新占空比还需等待装载事件。母线采样若与电流不同步，应明确它在电压重建中的数据年龄。多通道扫描可能使两相样本存在时间差，高速或电流变化快时会影响坐标变换；能同时采样的硬件也需核对触发与结果绑定，不能只看配置选项名称。

调试应按实际计数时间轴验证触发、采样、读取和输出生效，覆盖低调制度、扇区边界和接近最大占空比。控制中断执行时间必须在下一次装载前留足余量，通信和诊断压力可能只造成少数周期延误。对采样窗口不足或转换未完成应产生有效位及明确处置，不宜继续把旧ADC数据当成新电流，让错误在限流或观测器中放大。

调试检查

• 扫描占空比与扇区，测量窗口宽度、模拟建立、采样保持和装载余量，检查最短窗口仍满足配置要求。
• 用周期编号关联ADC与PWM，加入通信压力及转换未完成情形，验证过期样本被标识且超时动作符合定义。

相电流与母线电流

相电流与母线电流反映不同物理量。相线传感器直接观察对应绕组电流，低侧分流在特定导通状态可测，单母线分流则通过开关状态间接提取不同相信息。母线平均电流用于功率或输入负荷观察，不能直接替代每相瞬时电流，也不能用三个相电流的普通算术平均来估算直流输入电流。

单分流重构需要在有效矢量期间获取足够的独立样本，并依据扇区与开关状态映射符号。有效矢量太短会形成不可测区，移动脉冲或替代样本会改变电压及数据年龄。两相重构第三相需满足三相电流和近似为零的条件，地故障或共模泄漏时该假设可能不成立；由公式重构出的和为零不是独立的硬件健康证明。

电流用途还应分控制、保护和功率分析。控制需要时刻明确的样本，快速过流需要更短路径，输入功率估算需要与母线电压同步的合适平均。拓扑变更后，采样触发、放大器范围、保护覆盖及电压观测都要重新验证。分析异常时同时记录原始样本、开关状态、有效位和重构结果，避免只看滤波后电流而漏掉短窗口及通道饱和。

调试检查

• 分别标注各传感器位置与用途，核对单分流映射及不可测区处理，不用重构恒等式证明传感器正常。
• 对极端调制、饱和与地故障模拟检查控制和保护覆盖，比较电流样本年龄、最终重构与原始波形。

母线电压与温度采样

母线电压与温度通常比相电流变化慢，但采样策略仍需匹配用途。母线用于调制归一化和过欠压判断，预充与制动过程可能变化较快；温度用于降额和保护，其测点、热惯性及通道异常同样重要。不能把两者都做长时间平均后只保留一个平滑值，导致控制获得错误电压能力或保护反应过慢。

母线高阻分压需要考虑输入阻抗、隔离放大器范围和ADC采样保持的建立。分压阻值与耐压分配是硬件设计内容，软件换算应绑定实际电阻与增益。温度可来自模块NTC、散热器或其他传感器，其位置测得值不等于瞬时结温。NTC非线性转换、开短路及参考电压漂移应分别处理，不能将异常满量程统一解释成高温或低温。

数据接口宜提供原始值、工程值、有效位和采样时间，并把控制估算、显示与保护使用的滤波分开说明。隔离侧失电可能产生器件定义的故障输出，应先检测有效性再参与归一化。验证时使用受控输入检查多个量程点和变化过程，还需核对更新丢失时的策略。热保护阈值及母线阈值由具体产品确定，任何示例器件数值都不应作为通用设定。

调试检查

• 用已知输入检查母线换算与NTC转换，覆盖低中高量程、开短路及隔离侧失电，核对有效性优先处理。
• 分别测量控制、显示和保护滤波延迟，验证预充与制动期间电压数据年龄及温度通道更新丢失策略。

校准、滤波与测量误差

校准应区分零点、增益、线性及动态误差。ADC内部校准可能改善转换器本身，却不能自动消除分流、放大器、分压和传感器的误差。电流零点必须在确实无电流的条件下获取，电机残余转动或续流时不能简单把平均样本当偏置。增益校准需要可信参考及覆盖范围，单点归零不能证明整个量程准确。

滤波可以降低随机噪声，却无法修复错误比例、饱和或采样窗口不足。采样保持时间应与前级源阻抗及ADC输入特性匹配，通道切换后还可能需要建立时间。软件平均若跨越状态变化，会混合预充、运行或制动的不同含义。数字滤波系数应绑定任务周期，并把延迟计入限流与观测模型。

校准参数需要版本、温度、日期及硬件关联，并有完整性检查。更换采样板、ADC参考或放大器增益后，旧参数应失效或明确重新验证。验收可分静态已知输入、PWM共模干扰和实际运行三层，记录原始与处理后数据，检查量程裁剪及低幅值偏置。仅看到滤波后电流平滑，不能说明测量链正确；应该让误差预算及诊断证据与控制用途对应。

调试检查

• 在真正零电流和多个已知输入点核对偏置、增益及线性，确认校准参数绑定正确板卡与参考电压。
• 改变PWM共模扰动和ADC采样时间检查动态误差，比较原始值、滤波值及延迟，不让滤波掩盖窗口失效。

运行状态与启停

变频器的启动请求应先经过运行状态机，再转成频率或转矩给定。待机、预充、就绪、启动、运行、减速和故障分别拥有进入条件与退出动作。预充完成并不代表可以立即发出功率脉冲，还需要检查驱动电源、采样有效性、接触器反馈和当前命令来源。启动许可的判断应与控制中断共享一致快照，避免后台刚撤销许可，快环仍使用上一轮使能。

启动过程中必须区分静止电机与已经旋转的负载。风机可能被气流反拖，泵也可能因回流旋转；未经速度方向识别直接施加固定起始频率，可能产生冲击电流。飞车启动是否可用取决于电机类型、测量条件和算法，而不是一个统一延时。对于需要磁链建立的异步机矢量控制，磁链准备阶段也应有超时和受限退出路径。

停机命令至少要明确受控减速、自由停车和故障关断的行为差异。受控减速需要逆变桥继续工作并安排再生能量路径，自由停车的机械停止时间取决于负载。运行位清零不能证明母线无电或轴已停止。固件应分别报告请求状态、实际状态与停机原因，并将复位后的重新启动许可作为独立决策，避免保存的运行命令造成意外重启。

调试检查

• 对启动请求分别注入预充未完成、驱动未就绪和采样无效条件，确认状态停在规定阶段，输出使能没有短暂出现，失败原因可查询。
• 验证减速中撤销命令、停机未完成再次启动、复位后旧命令仍在三条时序，记录实际输出、母线变化和状态转换，核对设计的重启规则。

V/f 标量控制

异步电机的标量调速通常让基波电压幅值随定子电气频率变化，以在一定范围内维持磁通。简单恒定比值建立在稳态、定子电阻压降相对较小等近似条件上。电压参数必须注明是线电压有效值还是相电压幅值，频率以赫兹表示，不能直接把铭牌线电压数值填进以相电压峰值计算的调制模块。

低频时定子电阻压降占比上升，按直线比例给电压可能磁通不足；增加补偿也可能导致过励磁和发热，所以提升量应结合电机参数与电流限制验证。达到基频以后，直流母线与调制范围限制可用电压，继续提高频率通常进入弱磁区域，持续转矩能力会变化。标量控制并不自动保证低速满载或快速转矩响应。

同步机械转速可写为 n_s=60f_e/p，单位为每分钟转数，f_e 为定子电气频率，p 为极对数；异步机转子实际转速还取决于滑差与负载。频率显示正常而轴速下降，不一定是通信给定错误。实现时应把给定斜坡、低频补偿、母线电压归一化和限流协调起来，并区分输出频率、估计轴速与实测轴速，禁止把三者用同一个寄存器名称混淆。

调试检查

• 检查铭牌接法、线相电压换算、极数与极对数以及软件电压单位；在输出限制处核对调制实际幅值，避免换算正确但被限幅覆盖。
• 以不同负载验证低频补偿和基频附近过渡，记录电流、实际转速、温升趋势及限流状态；评价结果按负载条件保存，不能只凭空载运行判定。

FOC / 矢量控制

变频器中的矢量控制要先明确电机类型。异步机采用转子磁链定向时，需要估计或测量速度并建立磁链角度，磁链分量与转矩分量由相应电流控制。永久磁体电机则依赖转子电角度及其磁链模型。两种方案虽然共享坐标变换和电流环结构，电机参数、启动准备与无感观测方程不能直接互换。

对异步机，转子磁链坐标系的电气旋转速度包含机械速度乘极对数与滑差角频率；各项使用弧度每秒，不能把轴速直接当作同步旋转角速度。转子时间常数会影响磁链定向，绕组温度变化也可能造成参数偏离。调试中应观察励磁电流、转矩电流与磁链估计的关联，电流环跟踪良好并不单独证明磁链方向正确。

固件需要把电流环、速度环、磁链建立、限压和限流安排在明确的采样节拍中。估计速度无效时，应按运行阶段选择保持受限给定、退回启动过程或停机，不能无条件闭合速度环。低速和零速可观测性取决于算法及测量条件，宣称无感矢量不代表可以在任意负载下零速保持转矩。调速型产品的验证重点是规定工况下的转矩与速度行为，定位能力另有反馈和机械约束。

调试检查

• 核对电机模型、极对数、速度单位、磁链角方向以及电流符号；用已知转向的低风险工况确认反馈方向，禁止先通过改增益掩盖符号错误。
• 覆盖磁链准备、闭环接管、限压和速度估计失效阶段，记录磁链量、两轴电流与接管状态，确认切换无额外给定跳变且退出规则成立。

加减速、限流与负载

加减速时间描述的是给定变化过程，实际机械响应还受惯量、负载转矩和可用电流限制。以轴侧模型 J·dω_m/dt=T_e−T_L 为例，惯量用千克平方米、机械角速度用弧度每秒、转矩用牛米，并假定各量折算到同一轴。该关系可用于检查斜坡是否合理，但不能替代摩擦、传动弹性和工艺负载的具体建模。

加速时，过快的给定可能使转矩电流持续受限。继续累加速度误差会导致退出限流后过冲，因此调速环需要与电流限制协调，并采用与实现一致的抗积分饱和处理。标量控制的限流还可能通过调整频率变化率或电压实现，其行为与矢量控制的转矩限幅不同。限流状态要有可读原因和持续时间，不能只显示目标速度未达到。

减速时电机可能把机械能送回母线，制动电阻、回馈前端或延长减速过程决定可实现的停机轨迹。只放宽过压判据不能解决能量去向。高惯量负载、风机反拖和频繁启停应分别评价；风机的负载规律不能照搬给恒转矩输送机。在线调整斜坡时还要规定从当前给定继续还是重新生成路径，避免参数修改造成频率突然跨越。

调试检查

• 在规定惯量和负载组合下改变加速时间，区分给定斜坡、实际转速与限流持续时间，核对控制器积分状态及解除限流后的恢复过程。
• 覆盖有制动、无制动和制动暂不可用的减速情形，检查母线趋势、斜坡延长及停机原因；轨迹达标必须同时满足电气与机械约束。

运行命令与给定通道

变频器往往同时具有面板、端子、模拟输入和通信控制入口。运行命令与速度给定可以来自不同通道，但产品必须明确这种组合是否合法，谁有权启动、停止和改变方向。固件应先形成带来源和有效性的命令对象，再由仲裁层提交状态机，不能让多个中断直接写运行标志或频率变量，否则最后一次写入就会成为隐含优先级。

给定通道还包含量纲、比例、死区和故障行为。例如模拟输入断线可能表现为越界或固定值，通信寄存器则需要区分频率、轴速与比例给定。转换应集中处理并报告应用后的实际目标；上位机读回的原始写入值不代表该值已经通过方向限制、最大频率和斜坡约束。方向改变也应走运行规则，不等同于立即交换两相或翻转调制角速度。

仲裁应规定停止请求的优先级、外部禁止信号的作用以及本地与远程接管条件。控制权状态最好与实际运行状态分别公布，便于解释远程写入成功但设备未执行的原因。通信确认只能证明协议请求被接受，其与命令应用的关系需要接口契约描述。应用层停机及普通使能信号不能被自行命名为安全转矩关闭，安全功能须依照实际系统设计与验证范围确定。

调试检查

• 分别从两个入口连续发出相反运行请求和不同给定，核对公开的优先级、被拒绝原因与实际目标，确认没有单周期控制权抖动。
• 切换面板、端子和通信给定时检查单位、方向和当前斜坡；模拟越界与远程写入受限时，读回状态应解释最终采用的值和来源。

Modbus映射与写权限

通信寄存器表应是一份设备接口契约，逐项声明地址、类型、单位、缩放、有效范围、访问条件和生效阶段。Modbus 的寄存器为十六位，协议定义多字节数据的字节传输顺序；跨寄存器的三十二位应用量还需要设备明确字序和符号解释。文档中的编号与帧内地址也要区分，避免上位机习惯的起始编号造成整体偏移。

运行命令、参数和状态量需要不同写权限。只读反馈不应因为底层存放在同一数组就能够被写，停止后才允许修改的电机参数也不能在运行中静默更新。处理请求时先完成长度、地址、范围及状态条件校验，再一次性提交整组值。对于多寄存器组成的给定或参数，半旧半新的组合可能生成合法但错误的数值，快环读取必须得到同一代快照。

协议错误与应用拒绝应能被区分：不支持的功能、非法地址和不允许的值要按接口规定回应；异步操作还要提供处理中、完成或失败状态。广播写入在串行场景没有逐台响应，不能用没有回包判断它未生效。参数表增加字段时需要兼容性版本及默认行为，不能复用旧地址改变单位而让旧上位机继续把同一数值解释成另一物理量。

调试检查

• 用原始帧核对地址、字节序、跨字字序和有符号边界，并检查读回物理值；同时测试只读地址、越界值及运行中禁止写入的返回结果。
• 把多寄存器写入与控制周期交错执行，确认应用层仅看到完整版本；对广播和不支持功能分别验证执行与回应规则，日志能定位拒绝原因。

参数生效、存储与恢复

参数修改至少经历接收、校验、应用和持久化四个阶段。实时给定通常不需要每次落盘，电机模型和功率级配置则可能要求停机后重建相关系数。通信写入成功、算法已经采用和重启后仍然存在是三个不同事实，接口应分别给出参数代号或版本及状态，避免上位机在存储未完成时断电后误认为设备丢失配置。

持久化记录可采用有效标记、版本、长度和校验，并保留可恢复的上一份完整配置；具体原子更新方式由所用存储介质及固件方案决定。使用片内闪存模拟非易失参数时，要检查擦写粒度、寿命、供电中断行为和执行阻塞。库的掉电恢复能力不代表参数集合的业务一致性自动成立，多个相关字段仍需形成一个经过校验的提交单元。

应用参数时还要处理导出量与运行状态：改变额定频率可能影响电压曲线，改变电流比例会影响显示、控制和保护，不能只更新界面字段。恢复出厂值需保留或明确重建板级校准与硬件型号约束，禁止让通用默认值覆盖专用测量标定。启动时检测未知版本、损坏记录或不匹配硬件，应报告原因并限制启动，而不是把未解释的字节当作当前配置。

调试检查

• 在写入、校验、提交和擦除不同阶段模拟复位或断电，确认启动仅采用完整可识别版本，并验证备用记录、错误提示及启动限制。
• 连续修改互相关联的参数，检查实时应用值、存储值和重启读回值；监测擦写期间控制周期，核对是否需要停机或由独立任务安排持久化。

通信超时与控制权切换

通信超时首先是控制契约，而不是串口错误计数。总线上收到其他设备的帧、有效查询或过期重发，并不一定代表当前控制者仍在提供运行许可。固件应规定哪些消息刷新控制租期或运行心跳，使用单调时间计算有效期，并将帧接收、协议校验、命令提交分别记录，避免仅凭接收中断有活动就永久保持旧运行命令。

超时后的动作由负载和产品运行要求确定，可能是受控减速、保持受限目标一段时间或撤销运行；必须同时考虑减速能量和制动可用性。网络恢复也不应自动重放队列中的旧启动请求。接管过程要验证新通道有效、目标合理和运行许可成立，再按设计实现给定衔接；若直接把远程高速给定换成面板当前值，可能产生不可接受的速度突变。

串行帧间隔、校验错误和物理层干扰会影响通信可用性，但应用超时应有自己的状态和原因。实时控制不宜依赖后台解析任务及时运行才停止，命令有效性应由独立可界定的周期检查。多主控制、广播或掉线后的本地接管若属于产品功能，需要明确拥有者身份及撤权条件。诊断页面应同时显示当前入口、最后有效命令时间和失效动作，让现场能够区分链路故障与控制权被切换。

调试检查

• 保持总线查询流量而停止控制心跳，检查旧命令是否仍按契约到期；注入重发、延迟帧和解析任务阻塞，验证有效期判断不被错误刷新。
• 测试掉线后再连接、本地接管及原控制者回归，核对给定衔接、重新许可和旧队列清理；记录超时检测至实际输出变化的最大时间。

过流保护

过流处理需要区分快速破坏性故障、调节过程中的电流受限以及较长时间的过载。短路或直通可能在软件周期到来之前伤害功率器件，因此应由驱动器、比较器和定时器故障路径按设计直接控制输出。用于显示的平均电流或低速滤波值不能代替这条路径，故障中断负责记录与协调后续状态，而不应成为唯一的关断机制。

定时器的逐周期处理与单次锁存具有不同恢复行为。逐周期限制可能在规定计数事件重新释放输出，单次锁存通常需要清除条件和明确复位；选错模式会让持续故障每周期再次激励功率桥。还要核对故障动作经过互补输出、死区、驱动输入极性之后的真实门极状态，寄存器显示已经禁止，并不保证外部器件获得了正确关断电平。

判据必须来自所选功率器件、测量链和产品工况，考虑检测误差、消隐与传播时间，并区别噪声误触发和真实超限。延长消隐可以减少开关瞬态误报，也可能扩大未保护区间，不能以日志干净为优化目标。调试应同时保存触发源、采样是否饱和、运行阶段和给定变化；对可恢复限流与不可自动恢复故障使用不同代码，便于判断是负载要求过高还是硬件路径异常。

调试检查

• 通过规定的低风险信号注入检查比较器、定时器和驱动器链路，测量检测输入至门极变化的延迟，核对所有桥臂及故障持续时的行为。
• 分别验证逐周期限制、单次锁存和清除后重启，确认软件没有过早解除故障；在开关噪声与合法峰值附近分析误触发，不直接放宽保护判据。

母线欠压与过压

母线欠压与过压需要结合运行阶段解释。预充阶段电压尚低可能正常，运行中突然下降则可能来自供电跌落、整流路径或预充旁路异常；减速时电压上升又可能与再生能量有关。固件不能只输出同一个数值越界标志，还应记录电压变化、状态及制动请求，帮助区分能量失衡与采样链故障。

阈值、回差和确认时间应依据实际器件耐压、最低工作电压、测量误差及工况确定。控制母线欠压、栅极驱动电源欠压和逻辑电源复位属于不同观测对象，不能因为都叫欠压就合并恢复条件。电压跌落时，可用输出电压降低，控制环可能受限；继续要求原转矩或高速给定，会改变电流和停机表现，因此运行限制要与电压状态协调。

过压处理必须核对能量出口。制动请求已经发出但电阻过热、斩波器未动作或支路不可用时，不能仍按正常制动能力规划减速。关断逆变桥之后电机和母线的状态也依赖电机类型与转速，故障处理不应假定电压立即下降。采样过时、分压器断线或隔离链无效需要单独诊断，避免把无法判断母线电压当成正常零电压并允许重新预充。

调试检查

• 在预充、稳定运行和减速三个阶段输入相同电压变化，核对阶段判据、回差、确认时间和事件原因，确认启动流程不被运行判据误触发。
• 验证制动支路不可用、母线测量失效及供电恢复时的退出路径，记录请求与实际反馈；核对恢复许可同时包含测量有效和硬件就绪条件。

温度监测与保护

温度保护先要说明测量点。散热器、功率模块内的热敏电阻、控制板环境和电机绕组温度代表不同热过程，不能将其中任一读数直接命名为功率芯片结温。测量点与器件热点之间存在热阻和延迟，瞬态损耗可能先使结温上升，慢速温度采样仍看起来正常。连续负载限制需要与功率损耗及冷却条件一起评价。

模拟热敏电阻通道要考虑非线性、元件误差、分压参考和模数转换误差，查表或拟合应覆盖实际工作区间。开路、短路与采样过期应具备可检测的状态，不能都映射成最低温度。通过校准减小偏差也不会消除热传递延迟；如果采用器件损耗估计辅助降额，其模型适用范围与测温校核方法应写入设计记录。

保护策略可以包含预警、逐步降额和故障停止，但各阶段的回差、最短保持时间及复位条件要与产品要求一致。风扇失效、风道堵塞、低速自冷电机和高环境温度会改变可用负载能力，单一环境点的运行结果不能覆盖全部工况。模块的热敏监测与驱动关断设计可以作为架构参考，器件或参考板上的判据不能直接成为另一台变频器的通用保护值。

调试检查

• 检查每个温度量的物理位置、单位、查表范围与失效编码，用已知输入验证开短路及区间端点，确认异常输入不会落入正常低温区域。
• 组合环境温度、负载持续时间和冷却退化条件，观察预警、降额、停止和恢复顺序；将测温变化与热模型预测分别保存，核对最不利延迟。

故障锁存、记录与复位

故障管理应分别保存当前存在的故障、已经发生且尚未确认的故障，以及最早导致停止的事件。运行中一次驱动故障可能随后伴随欠压、速度反馈无效和控制超时，最后一条报错不一定是根因。记录应带单调时间或控制周期号、运行阶段及故障源，后台显示时可补充系统时间，不能用不稳定的墙钟时间判断快环事件先后。

发生故障后，先执行有界的输出处置，再冻结必要现场。日志写闪存、格式化文本和通信上报不应占用关键关断路径。环形缓冲可保存触发前后的电流、电压、给定及限制状态，并记录丢样和覆盖次数。若故障同时影响测量链，相关数据需要标记无效，避免离线分析把故障后的饱和值误当成触发前真实电流。

故障条件消失不等于故障被确认，确认也不等于允许重新运行。可以借鉴控制库的活动故障、已消失待确认与空闲状态划分，但产品要补充预充、驱动器锁存和外部运行许可等条件。复位请求应逐项检查恢复资格并反馈失败原因，禁止不停清标志掩盖持续故障。自动重试若被允许，还需规定次数、间隔和累计故障策略，且不能把这种逻辑当作功能安全认证依据。

调试检查

• 按已知顺序注入两个故障及一个后续测量失效，核对首发事件、当前位图和历史记录，确认首因不被覆盖，冻结数据包含有效性标志。
• 在故障仍活动、条件已消失但未确认、确认后许可缺失三种情况下发送复位与启动，检查门极状态和返回原因，并验证重试上限及日志完整性。

电机参数与负载工况

系统联调首先建立电机、接法和负载的可追溯配置。记录电机类型、铭牌额定电压与频率、额定电流、极对数、接线方式和冷却方式，软件参数的物理定义应与此一致。铭牌电流未必等同于算法所用的相电流峰值，三角与星形接法也影响绕组量的换算。把另一台电机能运行的参数直接复制进新设备，可能同时改变磁链、限流和显示比例。

自辨识需要明确试验条件与动作范围。不同算法可能采用静止注入、旋转或约束转子等步骤，必须根据实际方案安排机械允许条件和退出机制。辨识状态显示完成，不意味着获得的参数在所有温度、速度与负载下都准确。应保留辨识时的电机状态、采样校准和参数版本，并通过独立工况检查模型与真实响应的一致性，避免用同一批数据既估计又证明有效。

负载档案应包括惯量折算、转矩随速度变化、起动阻力、反拖可能及持续运行时间。空载能启动只能说明当前条件下流程可走通，不能验证高惯量减速、低速散热或工艺峰值负载。对于调速型变频器，评价重点是规定负载下的起动、稳态速度、受限行为和能量处理；若工艺要求准确位置保持，应另行核对反馈、制动与系统能力，而不是仅靠频率精度推断。

调试检查

• 将参数逐项与电机接法和测量单位核对，保存铭牌、板级校准和软件版本的关联记录；检查参数缺失或电机型号不匹配时的启动限制。
• 为辨识结果选择未参与估计的速度及负载工况，比较电流、实际轴速和限制状态；将冷机、热机和机械约束条件分开记录，标注验证覆盖范围。

启动、调速与停机

启动、调速和停机应作为完整事件链联调，不能分别点动成功就认定系统通过。测试从上电初始状态开始，记录预充反馈、驱动就绪、采样校准、运行许可、给定形成和实际输出的先后关系。每一步设定可观察的成功条件与超时结果，确保上位机提前发出命令或接触器反馈延迟时，设备仍按设计进入下一阶段。

调速测试应同时覆盖小幅变化、大幅斜坡、方向请求和负载扰动，并保留原始目标、经过约束的目标与真实轴速。没有轴速测量时，需要明确证据只证明输出频率或估计量，不能声明机械速度精度。记录时对齐通信时间与控制周期，区分传输延迟、斜坡限制和控制响应，防止把上位机刷新较慢造成的阶梯曲线解释成电机振荡。

停机试验需要检查轴和母线两种状态。受控减速过程应验证制动可用性、母线趋势和输出退出时机，自由停车应按照负载观察机械停止时间。连续启停还可能积累制动电阻与电机热量，因此一次停住不代表重复工况成立。外部禁止或故障在启动、稳态和减速中出现时，退出路径可能不同，必须核对最终状态以及恢复后是否需要新的运行请求。

调试检查

• 将相同启停序列施加于上电后首次运行和热态重复运行，检查状态时序、母线及制动请求；延迟预充反馈和运行许可，确认命令不会绕过准备阶段。
• 对速度阶跃、斜坡及停机事件统一时间基准，保存目标、约束后目标、实测或估计轴速与状态，明确每条判据采用哪种反馈证据。

欠压、过流与受限状态

受限状态的验证目标是说明设备能提供什么，以及何时必须退出运行。欠压会减少可用电压，过流判据可能触发快速关断，调节限流则可能让目标速度无法达到，三者不应使用同一个失败判定。试验需要提前规定输入条件、持续时间、期望状态和输出约束，并从未受限、进入限制、限制持续及恢复四段观察控制行为。

故障注入应先在模型、接口仿真或受控信号层验证判据和状态转换，再按实际设备验证所需硬件链路。修改软件测量变量只能证明软件分支会执行，无法证明比较器、隔离器、定时器及门极路径的真实响应。快速过流链与控制电流测量可能使用不同带宽和滤波，联调记录需要说明触发的是哪一条路径，避免将慢速测试误称为短路保护验收。

限制解除以后应检查控制器内部状态与目标衔接。持续限压或限流期间，积分累积、观测器失效和旧给定保留可能使恢复时出现额外冲击。供电恢复也可能先满足母线条件，驱动电源或测量仍未就绪。状态机要等待所需条件全部成立，按定义恢复或保持停机。验收结果需明确覆盖的注入层级和设备工况，不能从模拟通过推断整机具备认证或全部故障覆盖。

调试检查

• 对同一欠压波形改变持续时间和运行阶段，核对限制、故障及恢复的差异；保存积分、估计有效性和目标衔接，检查解除限制后的异常峰值。
• 分开列出软件输入注入、比较器输入注入和实际输出链路验证，记录触发源及响应时间；确认每项结论只覆盖对应路径，没有跨层推断。

日志、恢复与回归验证

可重复联调需要把测试输入与结果一起保存。日志至少包含固件标识、硬件版本、电机配置、参数代号、命令来源和工况说明，波形带采样周期、量纲及有效性。串口导出若存在丢包或抽取，应记录序号与抽取规则；否则两次曲线的差异可能来自记录方式，而不是控制变化。关键事件可使用周期号将快环缓冲与慢速状态日志关联。

恢复验证要跨越复位和重新上电，检查故障记录、参数、运行许可及控制权是否按契约保留或清除。设备重新通信后，上位机需要读取当前状态并决定后续操作，不能只因链路恢复就把中断前的一组命令重发。持久化忙、记录损坏或版本不兼容也要有可重复输入和可检查输出，使配置恢复错误能够与控制算法故障区分。

回归用例应围绕已经明确的产品行为建立，保存输入序列、初始条件和判据。比较模拟量时可按工程允许范围设置数值与时间容差，状态顺序、非法输出使能和禁止自动重启等条件则需要独立检查。新的固件不能只更新基准曲线让差异消失；应解释差异对应的需求变化或缺陷修复，并保留旧基准和变更原因。调试工具开启后的时序结果也应与正常运行模式核对。

调试检查

• 用相同配置与输入重放一次基准和一次新版本，检查波形单位、周期、缺样标记及事件对齐，确保容差有需求依据，离散状态判据没有被曲线比较替代。
• 覆盖存储过程中复位、故障后重启和控制链路恢复，核对参数版本、历史事件及运行许可；关闭调试输出后复核关键响应，记录工具引入的时序差异。