sb_upload_unzip_8671100062229597285（电机FOC电流采样窗口与霍尔角度诊断）Skill 是什么？如何下载？

电机FOC电流采样窗口与霍尔角度诊断（高速三相ADC自动抓拍）Skill：让平台段「指令大、实际小」从猜测变成有据可查

自动取证，无需干预：控制器进入高速段（前进、转速 ≥ 1500 rpm 连续 0.5 s）后自动记录 400 个 PWM 周期（约 27 ms）的三相 ADC 原始值、CC1～CC3 与电角度，记录完成后自动从 CAN 0x4F0～0x4F4 发出，不需要发任何 CAN 命令。
只加诊断，不动控制：固件改动仅新增抓拍模块与调用点，不修改任何控制参数，Flash 占用 112.7 KB / 122 KB、RAM 剩余约 3 KB，编译无警告。
链路已被验证：SIL 回放中，经济模式满把自动抓到 6 次、动力模式满把自动抓到 8 次，校验全部通过、漏周期 0，说明触发、记录、分帧发送、校验整条链路能跑通。
结论可能推翻原有假设：带载四组数据表明，U、V 两相采样偏差都落在拟合残差（3～4 A）以内，「电流采样窗口不够」并不是平台段的原因；真正值得怀疑的是霍尔角度每圈固定位置修正、三相增益与零偏不一致、以及主循环被挤占导致 1 ms 任务实际约 2.5 ms 才执行一次。
判读成本很低：实车只要照常录 ASC，交给 AI 解码，或自行运行 pwm_cap_decode.py，即可得到每次抓拍一个 CSV 与「最大占空比那一相读数 / 另外两相反推值」的分档表。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

技能中文名：电机FOC电流采样窗口与霍尔角度诊断（高速三相ADC自动抓拍）Skill 技能英文名：sb_upload_unzip_8671100062229597285 技能ID：2120486332239872001

它要解决的问题非常具体：电机控制器在高速平台段出现「Iq 指令很大、实测电流很小」（例如 Iq 指令 82 A、实测 22～25 A），此前只能凭经验猜是「最大占空比相的下管导通时间太短、扣掉死区后运放还没稳定、采样读数偏小」。这个技能把这套猜想变成可取证的数据链路——在控制器里植入自动抓拍，在 PC 侧用解码脚本与 AI 分析把「比值是否偏小」「三相是否平衡」「角度是否跳变」「主循环节拍是否正常」全部量化出来。

安装与接入思路（分两类）

AI 技能侧：通过技能ID 2120486332239872001 在所用 AI 平台的技能库/技能市场中检索并添加；具体入口、命令与调用方式以官方说明为准。添加后，在对话中给出 ASC 记录文件或抓拍 CSV，即可让技能完成解码与判读。
目标板侧（诊断固件落地）：抓拍能力本身以固件改动形式存在于工程中，需要按详情中的文件清单落地：
- pwm_capture.inc、pwm_capture.h：新增触发、记录、分帧发送；
- task.c：加 include，并在 200 µs 任务里先调用 pwm_capture_service()；
- control_pipeline.inc：FOC 计算前读本次生效的 CC1～CC3，计算后记一条；
- .cproject、Debug/makefile：去掉 -u _printf_float（程序里没有用 %f 打印），腾出 Flash。
- 烧录文件：AT32M412CBT7_WorkBench_59_PwmCap_20261104.hex；改动前的备份放在 bak_capture（含 task.c、control_pipeline.inc、can.c、at32m412_416_int.c、makefile、cproject.xml）。

安装前提

控制器固件为 59 号（1103 海林版）+ 高速三相 ADC 自动抓拍；
能录制 ASC 的 CAN 工具链（500 kbps 总线）；
需要本地判读时，准备可运行 Python 解码脚本 pwm_cap_decode.py 的环境；
实车或台架能跑到目标转速（经济模式目标 1800 rpm、动力模式目标 2400 rpm，触发阈值 1500 rpm 两种模式都能触发）。

验证是否生效

现象验证：跑车时观察是否出现 0x4F0～0x4F4 报文，且 0x4F0 / 0x4F2 / 0x4F4 / 0x4F3 中带同一个「抓拍编号」；
数据验证：0x4F3 中的累加和校验通过、发送失败次数与漏周期次数为 0；
脚本验证：运行 python D:\Users\12078\at32ide-workspace3\tools\pwm_cap_decode.py 记录.asc，每次抓拍应输出一个 CSV，并在屏幕打印分档表。
仿真验证：设置环境变量 SIL_CANLOG=<路径>，sil_drive 可把全部 CAN 报文写成 ASC，用于先跑通链路再上实车。

该技能的主要功能和特点

转速触发式自动抓拍：满足「前进 + 转速 ≥ 1500 rpm 连续 0.5 s」即自动记录，不依赖人工发命令，避免错过高速平台段。
一次抓满 400 个 PWM 周期：约 27 ms 的连续窗口，足以覆盖多个电周期，便于观察「每圈固定位置」的角度修正与电压鼓包。
同步记录多类信号：三相 ADC 原始值（低 12 位，高位放序号、饱和、桥臂、母线标志）、CC1～CC3 比较值、电角度，一次抓拍即可同时分析采样、占空比、角度三条线索。
分帧可靠上传：0x4F0 发抓拍编号、周期数、U/V 零偏；0x4F2 发 W 零偏、触发转速、母线电压 ×100；0x4F4 发 Iq 指令 / 实测、Id 实测（均 ×100）；0x4F1 发帧序号 + 3 个字（每周期 7 个字）；0x4F3 发抓拍编号、累加和、发送失败次数、漏周期次数。
周期性复抓：发完约 4 s 后再抓一次，长时间保持平台即可获得多次样本，用于交叉验证结论稳定性。
参数可调：pwm_capture.inc 开头集中定义 PWM_CAP_TRIG_RPM 1500、持续 0.5 s、两次间隔 3 s、周期数 400，适配不同电机与工况。
对控制零侵入：只加诊断不改控制参数；报文 ID 0x4F0～0x4F4 优先级低，每次发送约 940 帧、1 帧/ms、约 1 s 发完，总线负载增加约 26%，不影响其他报文。
AI 侧判读方法成套：三相电流之和理论为 0 可用于互推；更严谨的做法是「每相只用自己稳定时间 ≥ 3 µs 的周期拟合正弦波」，再看短窗口读数偏离多少，不依赖其他相。
顺带诊断出非预期问题：通过抓拍帧的实际发送间隔（桥臂关闭 1.00 ms、桥臂打开 10～13 ms）反推出主循环被挤占，1 ms 任务实际约 2.5 ms 才执行一次，这是普通抓电流工具很难暴露的信息。

如何使用该技能？

第 1 步：烧录诊断固件 烧写 AT32M412CBT7_WorkBench_59_PwmCap_20261104.hex，确认编译产物 Flash 112.7 KB / 122 KB、RAM 剩余约 3 KB、无警告。

第 2 步：确认触发参数 打开 pwm_capture.inc 开头，核对触发转速（默认 1500 rpm）、持续时间（0.5 s）、两次抓拍间隔（默认宏 3 s，实际约 4 s）、周期数（400）。若只想抓更高转速的平台段，可上调触发转速。

第 3 步：开始录 ASC 并照常跑工况 先开始录制，再按日常方式驾驶：经济模式满把跑到平台并保持 10 s 以上；动力模式中油门、满把到平台各保持 10 s 以上。全程不需要发任何 CAN 命令，每到平台会自动抓拍。停车前多跑几秒，让最后一次约 940 帧发完。

第 4 步：解码 把 ASC 交给 AI 技能判读，或本地运行：

python D:\Users\12078\at32ide-workspace3\tools\pwm_cap_decode.py 记录.asc

输出为「每次抓拍一个 CSV」+ 屏幕上的分档表（按最大占空比那一相的稳定时间分档，列出该相读数与另外两相反推值之比）。

第 5 步：判读四个层次

采样是否够用：用每相自身稳定时间 ≥ 3 µs 的周期拟合正弦，看短窗口档的偏差是否超出拟合残差；比值在「稳定时间 < 约 1 µs」档明显小于 1 → 采样窗口猜想成立；各档都接近 1 → 另找原因。
三相是否一致：比较 U/V/W 的幅值与直流偏置。实测中 U 相幅值一直比 V 小 8～11%、V 相带约 +2 A 直流偏置（开机零偏 V = 2095，比理论值 2048 高 47 个计数），会让 dq 电流出现 2 倍电频率与每圈一次的波动。
角度是否跳变：看 FOC 角度是否每个 PWM 周期稳定走 4.34°，还是在固定角度停顿/突进。实测在约 330° 处每圈往回拉 8～10°、30° 与 90° 处往前推 3～4°，对应霍尔表边沿与实际霍尔边沿的偏差。
节拍是否正常：用 0x4F1 帧序号的时间间隔反推任务周期。桥臂关闭时 1.00 ms、桥臂打开 10～13 ms，说明 200 µs 任务实际每 2～2.5 ms 执行一次；用转速斜坡交叉验证（设计 6 rpm/ms，实测 2.4 rpm/ms；经济模式设计 4 rpm/ms，实测约 1.6 rpm/ms）同样指向约 2.5 倍拉长。

第 6 步：按结论决定下一步动作

角度问题 → 用抓拍中的角度修正量离线核对霍尔表六个边沿，尤其 330° 那个（纯离线分析，不改程序）；
增益/零偏问题 → 用钳形表或示波器测一相实际电流，区分是采样电路问题还是电机三相真不平衡；
节拍问题 → 评估 Release（-O2）编译，或让 1 ms 任务按实际经过时间计算（影响面大，需单独决策）；
触发问题 → 把触发改成按真实毫秒计时而非任务调用次数计数，这样每次加速能抓到多次。

注意事项：抓拍缓冲区借用开机零偏标定的 g_calib_raw_u/v/w（6 KB），抓拍时会让出——本次起步的交接诊断（0x480～0x48E）数据会被丢弃，发完再还给交接诊断。

同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势	不足
本技能（高速三相 ADC 自动抓拍 + AI 解码）	控制器内部自动取证	转速触发自动记录 400 个 PWM 周期的三相 ADC、CC1～CC3、电角度，分帧上 CAN，配套解码与拟合判读	需落地固件改动（4 处文件）、烧录 hex、录 ASC、Python 脚本；技能安装以官方说明为准	高速平台段「指令大、实际小」、霍尔角度跳变、任务节拍异常	免命令、不错过平台段、与 FOC 时钟同步、还能顺带暴露主循环挤占	占用 6 KB 缓冲区并挤掉起步交接诊断数据；抓拍期间总线负载 +26%；触发间隔受主循环影响会被拉长
示波器 + 电流探头 / 差分探头	硬件级波形观测	直接看相电流、下管驱动、运放输出波形	需拆机引线、探头与带宽投入，实车走行时布线困难	台架定点评测、死区与运放建立时间验证	带宽高、可信度最高、能看模拟细节	实车难做、无法长时间自动触发、无法同时看角度与占空比逻辑量
专业标定测量工具（CANape / INCA 类，XCP 高速采样）	标定与高速采集平台	高速 DAQ 采集内部变量、在线标定	需 CC 标定协议支持、A2L 描述文件、授权成本高	台架标定、控制参数整定	采样率高、可视化强、支持在线改参	需要固件暴露变量与测量点；不解决「关键时刻自动留存证据」的问题；授权与学习成本高
手工加 printf / 串口打印调试	传统代码级调试	打印关键变量到串口	改动小但需要串口线与上位机；打印本身耗时	低频变量观察、逻辑验证	上手最快、无需额外硬件分析仪	打印阻塞控制循环，会进一步挤占本就紧张的主循环；无法记录高频 ADC 原始值；难以复现高速工况

从对比可以看出，示波器胜在精度、标定工具胜在可视化，但它们都要求人「在场且盯着」；而本技能的核心差异化是把关键时刻的证据自动留存下来，并且判读方法（拟合正弦、分档比值、三相幅值/偏置对比、帧间隔反推节拍）已经成套，拿来即用。

该技能的典型应用场景与实际体验情况

场景一：高速平台段「Iq 指令 82 A、实测 22～25 A」排查（电机控制工程师） 痛点是此前只能靠猜采样窗口。使用方式是满把跑到平台保持 10 s，自动抓拍一次到多次，用拟合正弦法逐相判读。实际体验：001 动力模式最大占空比 94.9%、稳定时间一直短到 < 0 µs，结果 U 相偏差 −0.7～+1.0 A、V 相 −2.3～−3.8 A，都在拟合残差（3～4 A）以内——推翻了采样窗口猜想，也纠正了此前用「另外两相反推」把 W 相偏差算到 U 相头上的错误结论。注意点：拟合方法要按相独立做，不要用三相互推下结论。

场景二：霍尔表边沿核对（控制算法工程师 / 标定工程师） 痛点是角度在固定位置跳变，导致电压矢量每圈鼓包、抗饱和回拉积分。使用方式是用抓拍中的角度修正量离线核对霍尔表六个边沿。实际体验：LOUXIA 四次抓拍规律一致，约 330° 处每圈回拉 8～10°、30° 与 90° 处前推 3～4°；001 动力的电压鼓包落在转子角 0～120°，38 个饱和周期里 31 个在这一段，与「角度跳变 → 电流瞬变 → 每圈顶到电压上限 → 抗饱和回拉」的推测吻合（可信度中等）。注意点：16:19 台架那次的规律（270° 处 −6°、0° 处 +7°）与 LOUXIA 不同，可能是不同电机或不同霍尔，需逐台确认。

场景三：三相采样通道一致性体检（硬件 / 测试工程师） 痛点是 dq 电流出现 2 倍电频率波动与每圈一次波动，怀疑采样电路。使用方式是对比多次抓拍的 U/V/W 幅值与直流偏置。实际体验：4 次抓拍一致显示 U 幅值（23.2 / 24.5 / 25.9）始终小于 V（25.3 / 26.5 / 29.2）8～11%，V 相带 +1.6～+2.8 A 直流偏置，结论可信度高；下一步用钳形表或示波器测一相实际电流即可区分是电路问题还是电机不平衡。

场景四：控制节拍体检（嵌入式软件工程师） 痛点是速度环响应偏慢、经济模式先冲过 1920 rpm 再回落、动力模式平台段慢慢爬。使用方式是用 0x4F1 帧间隔与转速斜坡反推任务周期。实际体验：桥臂关闭时正好 1.00 ms、桥臂打开时 10～13 ms，斜率实测 2.4 rpm/ms（设计 6）与 1.6 rpm/ms（设计 4），一致指向 1 ms 任务实际约 2.5 ms 执行一次；根因线索是 FOC 电流环分支每次 34.5 µs、占 PWM 周期 66.7 µs 的 52%，加上 ADC、霍尔、提交 PWM 等中断，且为 -O0 编译。注意点：SIL 没有模拟这个 CPU 占用，所以小模型的速度环响应比实车快，不能只信仿真。

整体上手难度：固件侧改动集中在 4 个文件、编译无警告，属于「小改动」；难点在判读——需要理解稳定时间 = 下管窗口的一半 − 死区（当前死区 deadtime = 205 ≈ 2.0 µs，老程序 V7.6 为 192 ≈ 1.42 µs，最大相占空比 90% 时只剩 1.3 µs、93% 时只剩 0.3 µs、94% 以上采样时下管还没导通）。

该技能能为用户带来的价值

把「猜」换成「证」：以往平台段异常只能凭经验判断采样窗口，现在一次抓拍就给出 400 个 PWM 周期的原始证据，直接判定猜想成立或不成立——本次就据此作废了「U 相偏小 15 A」的旧结论。
省掉反复试错的台架时间：触发、记录、发送、校验全自动，一次加速即可完成取证；单次发送约 940 帧、约 1 s 发完，不占用额外人工发命令的时间。
降低硬件测量门槛：不需要拆机接探头，也不需要 XCP 授权与 A2L 文件，只要录 ASC 即可；判读方法（分档比值、正弦拟合残差、幅值/偏置对比、帧间隔反推节拍）已经固化成脚本输出。
一次抓拍多问题联查：同一条数据链可同时回答采样精度、占空比饱和（如 400 个周期里 66 个饱和、38 个饱和）、霍尔角度跳变、主循环节拍四类问题，避免多次改动固件。
长期价值在于可复用的诊断范式：触发转速、持续时间、间隔、周期数均为宏，可移植到不同机型与工况；配合 SIL 的 SIL_CANLOG 能力，可在台架前先跑通链路，把风险前移。
风险可控：只加诊断不改控制参数，报文优先级低、不影响其他报文；代价明确（6 KB 缓冲区借用、起步交接诊断数据丢弃、总线负载约 +26%），团队可以自行权衡。

常见问题 FAQ

Q1：这个技能怎么安装、怎么接入我的项目？ 分两部分：AI 技能侧通过技能ID 2120486332239872001 在技能库中检索添加，具体入口与调用方式以官方说明为准；目标板侧按详情落地 4 处文件改动（pwm_capture.inc/.h、task.c、control_pipeline.inc、.cproject 与 Debug/makefile），烧录 AT32M412CBT7_WorkBench_59_PwmCap_20261104.hex。验证方法是跑车时看到 0x4F0～0x4F4 报文且 0x4F3 校验通过、漏周期为 0。

Q2：抓拍会不会影响控制、影响其他报文？ 只加诊断，不修改任何控制参数。代价有三点：借用开机零偏标定的 g_calib_raw_u/v/w（6 KB），抓拍时本次起步的交接诊断（0x480～0x48E）数据会被丢弃；每次发送约 940 帧、约 1 s 发完，500 kbps 总线上负载增加约 26%；0x4F0～0x4F4 优先级低，不影响其他报文。

Q3：需要收费吗？ 技能详情中未涉及任何价格、授权或计费信息，是否有商业授权、是否收费请以官方说明为准。文中提到的固件、解码脚本、烧录文件均为工程内自有资产。

Q4：为什么我每次加速只能抓到 1 次，不是间隔约 4 s 吗？ 触发与冷却按任务调用次数计数，而主循环被挤占后 1 ms 任务实际约 2.5 ms 才执行一次，所以 0.5 s 的持续时间实际约 6 s、3 s 的冷却实际约 36 s。改进方向是把触发改成按真实毫秒计时，这需要改程序，建议先确认结论后再做。

Q5：这个技能适合谁用？和示波器、标定工具怎么选？ 适合做电机 FOC 控制、台架标定与整车调试的工程师，尤其是遇到「高速平台段指令大、实际小」「dq 电流周期性波动」「角度疑似跳变」这类难以复现的问题。追求波形精度与模拟细节选示波器；需要在线标定与高速可视化选专业标定工具；需要「关键时刻自动留证 + 成套判读方法 + 不改控制参数」选本技能，三者也可以组合使用。