diff --git a/docs/AnalyzeCommand使用指南.md b/docs/AnalyzeCommand使用指南.md new file mode 100644 index 0000000..67af8f2 --- /dev/null +++ b/docs/AnalyzeCommand使用指南.md @@ -0,0 +1,238 @@ +# WCT DataAnalyzer 使用指南 + +## 快速开始 + +### 1. 准备日志文件 + +将日志文件放入 `Datas` 文件夹（与 `Gpulse.WCT.DataAnalyzer.exe` 同级目录）： + +``` +Gpulse.WCT.DataAnalyzer.exe +analyze.bat +Datas/ +├── 奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat +├── 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log +└── 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log +``` + +### 2. 运行分析 + +双击 `analyze.bat`，自动执行： + +1. **Ploss 分析** - 批量分析所有日志文件 +2. **Qfod 标定** - 自动配对纯手机和异物日志 + +``` +======================================== + WCT DataAnalyzer 分析工具 +======================================== + +[1/2] 执行 Ploss 分析... +扫描 Datas 文件夹: + 总计: 4 个日志文件 + 纯手机: 2 个 + 异物: 2 个 + +=== Ploss 分析 === +[OK] Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx +... + +[2/2] 执行 Qfod 标定... +扫描 Datas 文件夹: + 总计: 4 个日志文件 + 纯手机: 2 个 + 异物: 2 个 + +=== Qfod 标定 === +[OK] Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701_qfod.xlsx +... + +======================================== + 分析完成 +======================================== + +输出目录: ...Output +``` + +--- + +## 文件命名规范 + +日志文件名格式： + +``` +车厂-车型-TX面板-TX硬件-TX软件-RX类型-异物类型-测试目的-年月日测试次数.扩展名 +``` + +### 字段说明 + +| 位置 | 字段 | 说明 | 示例 | +|-----|------|------|------| +| 1 | 车厂 | 制造商名称 | 奇瑞、比亚迪 | +| 2 | 车型 | 车型代号 | E5、汉 | +| 3 | TX面板 | 发射端面板类型 | singleMold | +| 4 | TX硬件 | 发射端硬件版本 | A00 | +| 5 | TX软件 | 发射端软件版本 | V001 | +| 6 | RX类型 | 接收端类型（手机名） | iPhone15 | +| **7** | **异物类型** | **区分纯手机/异物** | **无**=纯手机，**硬币**=异物 | +| 8 | 测试目的 | 测试类型 | ploss_test、qfod_pure | +| 9 | 日期序号 | yyyyMMddNN | 2026081701 | + +> **第9段约束**：必须为连续的 8 位日期（`yyyyMMdd`）+ 序号（至少 1 位整数），**日期与序号之间无分隔符**。 +> 正例：`2026081701`（2026-08-17，序号 01）、`202608172`（序号 2）。 +> 反例：`20260817-01`（含分隔符，会被 FileNameParser 拒绝）、`2026-08-1701`（含短横线）。 + +### 异物类型（第7字段） + +- `无` → 纯手机日志 +- 其他值（如`硬币`、`钥匙`）→ 异物日志 + +--- + +## 分析类型 + +### 1. Ploss 分析 + +批量分析所有日志文件，生成 Excel 报告。 + +**输出目录结构**： +``` +Output/ +└── {车厂}/ + └── {车型}/ + └── {手机名}/ + └── {原文件名}.xlsx +``` + +**示例**： +``` +输入: Datas/奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat +输出: Output/奇瑞/E5/iPhone15/奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx +``` + +**Excel 内容**： +- 9 个功率段（350/500/750/1000/1250/1500/1750/2000/2250 W） +- 每个功率段：理论Δp、VPA +- 统计值：最大值、最小值、平均值、中位数、标定值 + +--- + +### 2. Qfod 标定 + +自动配对纯手机日志和异物日志，计算标定阈值。 + +**自动识别规则**： +- 文件名第7字段 = `无` → 纯手机日志 +- 文件名第7字段 ≠ `无` → 异物日志 + +**输出**： +- 阈值计算：`Threshold = (纯手机ΔQ最大值 + 异物ΔQ最小值) / 2` +- 统计值：ΔQ 绝对值的最大/最小/平均/中位数 + +> **阈值与统计的量纲**：阈值使用**有符号 ΔQ**（纯手机为正、异物为负时阈值可为负，如样例 `Threshold: -22`）； +> 统计行（Q最大/最小/平均/中位数）使用 **|ΔQ| 绝对值**。两者刻意不同，勿混用。 + +--- + +## 命令行用法 + +除双击 `analyze.bat` 外，也可直接使用命令行： + +```bash +# 自动扫描 Datas 文件夹并分析 +Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --auto +Gpulse.WCT.DataAnalyzer.exe analyze --type qfod --auto + +# 指定单个文件 +Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --file "日志文件路径.dat" + +# 指定输出路径 +Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --file "日志路径" --output "输出路径.xlsx" + +# Qfod 标定（指定纯手机和异物日志） +Gpulse.WCT.DataAnalyzer.exe analyze --type qfod --pure "纯手机日志" --foreign "异物日志" +``` + +--- + +## 输出示例 + +### 默认输出文件名规则 + +| 命令 | 默认输出名（未指定 `--output` 时） | +|------|----------------------------------| +| Ploss | `{原文件名}.xlsx`（如 `…-ploss_test-2026081701.xlsx`） | +| Qfod | `{纯手机文件名}_qfod.xlsx`（如 `…-qfod_pure-2026081701_qfod.xlsx`，自动加 `_qfod` 后缀） | + +指定 `--output/-o` 时按用户给定路径输出（父目录不存在会自动创建）。 + +### Ploss 分析 + +``` +扫描 Datas 文件夹: + 总计: 4 个日志文件 + 纯手机: 4 个 + 异物: 0 个 + +=== 批量 Ploss 分析 === + +Excel report saved to: Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx + +=== Ploss Analysis: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat === +Total: 35, Errors: 0 +Power segments found: 350, 500, 750 + +[完成] 已分析 4 个文件 +``` + +### Qfod 标定 + +``` +扫描 Datas 文件夹: + 总计: 4 个日志文件 + 纯手机: 2 个 + 异物: 2 个 + +=== Qfod 标定 === + +自动配对: + 纯手机: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log + 异物: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log + +Excel report saved to: Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701_qfod.xlsx + +=== Qfod Calibration === + Pure phone: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log + Foreign object: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log + Threshold: -22 + Pure margin: 27, Foreign margin: -27 +``` + +--- + +## 常见问题 + +### Q: 没有生成 Excel 文件？ + +检查： +1. `Datas` 文件夹是否存在 +2. 日志文件扩展名是否为 `.DAT` 或 `.log` +3. 日志文件格式是否正确 + +### Q: Qfod 标定提示"未找到纯手机日志"？ + +确保文件名第7字段为 `无`： +``` +正确: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log +错误: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_pure-2026081701.log +``` + +### Q: Excel 文件在哪里？ + +输出目录：`Output/{车厂}/{车型}/{手机名}/` + +--- + +## 联系支持 + +如有问题，请联系开发团队。 diff --git a/docs/requirement/无线充测试log保存及管理方案-20260702.pdf b/docs/requirement/无线充测试log保存及管理方案-20260702.pdf deleted file mode 100644 index ba32922..0000000 Binary files a/docs/requirement/无线充测试log保存及管理方案-20260702.pdf and /dev/null differ diff --git a/docs/requirement/无线充测试log保存及管理方案-20260817.pdf b/docs/requirement/无线充测试log保存及管理方案-20260817.pdf new file mode 100644 index 0000000..90953d0 Binary files /dev/null and b/docs/requirement/无线充测试log保存及管理方案-20260817.pdf differ