docs: V2.0.0 培训手册

V2 vs V1 新增内容：
- 波动测试模式 (B4) 及完整流程说明
- 线圈参数管理 + 模拟车辆参数管理
- 工装配置关联线圈/车辆 + 新设备配置检查清单
- 测试信息三视图 + ECharts 图表
- 精确时间筛选（日期+时分秒）
- 自动化测试间隔/超时配置
- Admin 数据删除、继电器状态重构
- 全量操作日志覆盖

docs/VD测试工装V2.0培训手册.md

@@ -0,0 +1,834 @@
+# VD 测试工装 V2.0.0 培训手册
+
+> **版本**: V2.0.0
+> **日期**: 2026-06-08
+> **作者**: wangfq
+> **适用对象**: 测试工程师、生产操作员、系统管理员
+
+---
+
+## 目录
+
+1. [项目概述](#1-项目概述)
+2. [V2.0.0 新增功能总览](#2-v200-新增功能总览)
+3. [系统架构](#3-系统架构)
+4. [硬件环境](#4-硬件环境)
+5. [EDC 服务](#5-edc-服务-edc_server)
+6. [EDC 管理系统](#6-edc-管理系统-edc-web)
+7. [通信协议](#7-通信协议)
+8. [操作指南](#8-操作指南)
+9. [常见问题](#9-常见问题)
+10. [附录](#10-附录)
+
+---
+
+## 1. 项目概述
+
+### 1.1 项目简介
+
+**VD 测试工装**（vd_test_fixture）是一套车检器自动化测试系统，用于**批量检测车检器（Vehicle Detector）的核心性能指标**。
+
+**核心能力**:
+- **灵敏度测试（B2）**: 检测车检器对不同信号强度的响应，含峰峰值、频率、距离、速度等指标
+- **波动测试（B4）** 🆕: 模拟车辆往复运动，动态检测车检器在工作范围内的距离/频率/速度波动
+- **产品一致性测试**: 批量产品之间的性能差异分析
+- **自动化测试**: 支持设定间隔时间和超时时间，自动循环执行，实时进度反馈
+- **工装配置管理**: 支持 DG430 V2.0.x 协议的设备参数配置、版本查询、出厂初始化，可关联线圈参数和模拟车辆参数 🆕
+- **数据可视化** 🆕: 测试数据图表视图（ECharts），支持多 Y 轴、缩放、图片导出
+
+### 1.2 术语说明
+
+| 术语 | 全称 | 说明 |
+|------|------|------|
+| **EDC** | Edge Data Center | 边缘数据中心，系统的核心服务 |
+| **DNT** | Data Network Terminal | 联网终端（PGLC），连接设备与 EDC |
+| **DG430** | — | 地感测试工装硬件，执行实际测试动作 |
+| **VD** | Vehicle Detector | 车检器（被测设备） |
+| **SerialNet** | Serial Network | 串口网络透传，通过 UDP 将指令转发到 DG430 串口 |
+| **B2** | — | 灵敏度测试数据来源标识（0xB2 指令上报） |
+| **B4** | — | 波动测试数据来源标识（0xB4 指令上报） 🆕 |
+| **线圈参数** | Coil Info | 地感线圈的物理参数（形状、尺寸、电感量、圈数等） 🆕 |
+| **模拟车辆** | Simulate Car | 用于模拟车辆通过的金属板参数（形状、尺寸、材质） 🆕 |
+
+### 1.3 V2.0.0 vs V1.0 对比
+
+| 功能 | V1.0 | V2.0.0 |
+|------|:----:|:------:|
+| 灵敏度测试 | ✓ | ✓ |
+| 波动测试 | ✗ | ✓ **新增** |
+| 测试信息查询 | 单表显示 | 三视图标签页 + ECharts 图表 |
+| 工装配置 | 基本参数 | +波动参数 +线圈/模拟车辆关联 |
+| 线圈参数管理 | ✗ | ✓ **新增** |
+| 模拟车辆参数管理 | ✗ | ✓ **新增** |
+| 时间筛选 | 仅日期范围 | 日期 + 时分秒 |
+| Admin 数据删除 | ✗ | ✓ **新增** |
+| 继电器状态 | 文本 | 编码值 + 解码显示 + 图表系列 |
+| 自动化测试 | 固定间隔 | 可配置间隔/超时 |
+| 操作日志 | 部分 | 全覆盖（创建/更新/删除） |
+
+---
+
+## 2. V2.0.0 新增功能总览
+
+### 2.1 波动测试模式
+
+V2.0.0 最重要的新增功能。在原有灵敏度测试（B2）基础上，增加了**波动测试模式（B4）**。
+
+**测试原理**: 工装控制电机驱动金属板（模拟车辆）在地感线圈上方往复运动，通过车检器在不同位置的工作频率、距离、速度等指标变化，评估车检器性能的稳定性。
+
+**与灵敏度测试的区别**:
+| 对比维度 | 灵敏度测试 (B2) | 波动测试 (B4) |
+|----------|:-------------:|:------------:|
+| 运动方式 | 单次进入→离开 | 多次往复运动 |
+| 测试指标 | 峰峰值、进入/离开频率、距离、速度 | 工作频率、当前距离、速度、剩余次数、最近/最远距离 |
+| 完成判定 | 一次进入离开 | 达到设定来回次数 |
+| 继电器 | 存在+脉冲 | 实时变化 |
+
+### 2.2 线圈参数管理
+
+新增线圈参数管理功能，用于记录和维护测试环境中的地感线圈信息：
+
+- 线圈编号、名称
+- 电感量（μH）
+- 形状（矩形/圆形），尺寸（长宽/半径 cm）
+- 圈数、电阻（Ω）
+- 材质（铜线等）、备注
+
+线圈参数在工装配置页可关联到具体工装，测试数据中自动记录关联的线圈信息，为后续数据分析提供环境参考。
+
+### 2.3 模拟车辆参数管理
+
+管理用于模拟车辆通过的金属板参数：
+
+- 模拟编号、名称
+- 形状（矩形/圆形），尺寸（长宽/半径 cm）
+- 材质（铁板、合金等）、备注
+
+模拟车辆参数同样可关联到工装配置，测试记录时自动写入。
+
+### 2.4 测试信息三视图 + 图表
+
+测试信息查询页面拆分为三个标签页：
+- **全部数据**: 所有测试记录汇总视图
+- **灵敏度测试（0xB2）**: B2 专用列布局（含故障信息、继电器、进入/离开频率等）
+- **波动测试（0xB4）**: B4 专用列布局（含工作频率、当前距离、剩余次数、最近/最远距离等）
+
+**图表视图**: 点击「📈 图表」按钮可切换为 ECharts 交互式图表，支持：
+- B2：峰峰值、频率（4条）、距离（2条）、速度（2条）+ 继电器状态
+- B4：工作频率、当前距离、速度、最近/最远距离、进入/离开高度 + 继电器状态
+- 四 Y 轴独立刻度
+- dataZoom 滑块缩放
+- 图例切换显隐
+- 2x 高清图片导出
+
+### 2.5 精确时间筛选
+
+搜索栏时间筛选从"仅日期"升级为"日期 + 时分秒"：
+- 只填日期不填时间 → 行为不变（date_to 自动取 23:59:59）
+- 日期 + 时间都填 → 精确到秒过滤
+
+---
+
+## 3. 系统架构
+
+### 3.1 整体架构图
+
+```
+┌──────────────────┐         浏览器 HTTP
+│    edc-web       │ ◄────────────────────── 操作人员
+│  Flask (Flask-Login) │
+│  前端管理界面      │
+└────────┬─────────┘
+         │ pymysql (同步)
+         ▼
+┌──────────────────┐
+│     MySQL        │
+│  数据库: edc      │
+│  (共享存储)       │
+└────────┬─────────┘
+         │ aiomysql (异步)
+         ▼
+┌──────────────────┐    UDP :4900     ┌──────────────┐   RS485/TTL   ┌────────────┐
+│   edc_server     │ ◄──────────────► │ PGLC 联网终端  │ ◄───────────► │ DG430 工装  │
+│  Python/uvloop   │  SerialNet 透传   │  (DNT)        │  串口协议      │ (测试硬件)  │
+│                  │                  └──────────────┘               └──────┬─────┘
+│ UDP :5500/:5505  │                                                       │
+│ TCP :5550        │                                                       ▼
+└──────────────────┘                                               ┌──────────────┐
+                                                                    │   车检器(VD) │
+                                                                    │  (被测设备)   │
+                                                                    └──────────────┘
+```
+
+### 3.2 通信链路
+
+```
+操作员浏览器 → edc-web (Flask, port 5000) → MySQL → edc_server (asyncio) → DNT → DG430 → 车检器
+                                                                              ↕
+                                                                         MySQL (共享)
+```
+
+**关键点**:
+- edc_server 和 edc-web 共享同一 MySQL 数据库
+- edc_server 使用 aiomysql (异步)，edc-web 使用 pymysql (同步)，互不冲突
+- 前端通过 edc-web 的 REST API 下发指令，实际执行由 edc_server 的轮询任务完成
+
+### 3.3 端口分配
+
+| 端口 | 方向 | 协议 | 说明 |
+|------|------|------|------|
+| **5500** | 监听 | UDP | EDC 设备发现 / 心跳 |
+| **5505** | 监听 | UDP | EDC 消息监听 |
+| **5550** | 监听 | TCP | EDC 时间同步 / 数据上报 / 串口透传 |
+| **4900** | 发送 | UDP | 向设备发送 SerialNet 透传指令 |
+| **5550** | 发送 | TCP | 向设备发送 TCP 数据 |
+| **5000** | 监听 | HTTP | edc-web Flask 管理界面 |
+
+### 3.4 项目结构
+
+```
+vd_test_fixture/
+├── edc_server/          # EDC 边缘数据中心（后端服务）
+│   └── src/
+│       ├── server.py    # UDP/TCP 异步网络服务
+│       ├── handlers.py  # 业务处理 + parse_loop/serialnet_loop 轮询
+│       ├── models.py    # 数据库 DDL + aiomysql CRUD
+│       ├── dg430.py     # DG430 二进制协议解析 (B2/B4/4C/4B)
+│       └── protocol.py  # PGLC JSON 协议解析
+├── edc-web/             # Flask Web 管理系统（前端）
+│   └── app/
+│       ├── models.py    # pymysql 同步数据库操作
+│       ├── auth.py      # Flask-Login 认证
+│       ├── routes/      # 页面路由 (fixture/test_data/test_op/devices/users/logs)
+│       ├── templates/   # Jinja2 HTML 模板
+│       │   ├── fixture.html         # 工装配置页（含线圈/车辆关联）
+│       │   ├── test_data.html       # 测试信息查询页（三视图 + 图表）
+│       │   ├── test_op.html         # 测试操作页（自动化 + 波动数据显示）
+│       │   ├── coil_info.html       # 线圈参数管理页 🆕
+│       │   ├── simulate_car.html    # 模拟车辆管理页 🆕
+│       │   └── vehicle_base_test.html # 车检器基准管理页
+│       └── static/
+│           ├── css/style.css
+│           └── js/
+│               ├── fixture.js       # 工装配 JS（线圈/车辆选择联动）
+│               ├── test_data.js     # 测试信息 JS（三视图/图表/分页）
+│               ├── coil_info.js     # 线圈管理 JS 🆕
+│               ├── simulate_car.js  # 模拟车辆管理 JS 🆕
+│               └── ...
+└── docs/                # 协议文档 + 培训手册
+```
+
+---
+
+## 4. 硬件环境
+
+### 4.1 DG430 地感测试工装
+
+DG430 是执行测试的核心硬件，负责控制电机驱动模拟车辆经过地感线圈，并采集车检器的响应数据。
+
+**接口**:
+| 接口 | 连接 | 说明 |
+|------|------|------|
+| IN1/GND | 地感存在信号 | 检测线圈是否有车 |
+| IN2/GND | 地感脉冲信号 | 检测脉冲继电器 |
+| IN3/COM | 按钮 | 按下开始测试 |
+| IN4/COM | 按钮 | 按下复原位置 |
+| PU+/PU-/DR+/DR-/MF+/MF- | 电机驱动器 | 控制电机前进/后退 |
+| +5V/GND/NO/NC | 限位开关 | 有信号电机停转 |
+| 485A/485B | RS485 | 接 PGLC 联网终端 |
+| GND/LP | 地感线圈 | 模拟车辆通过 |
+| SW3 | 激光探头 | 检测进入/离开 |
+
+**拨码开关**:
+- DIP1=OFF, DIP2=OFF → 测试 132 系列地感
+- DIP1=ON, DIP2=OFF → 测试 110 系列地感
+
+**声音提示**:
+| 声音 | 含义 |
+|------|------|
+| 2 声 | 工作频率/峰峰值异常 |
+| 3 声 | 灵敏度异常 |
+| 4 声 | 灵敏度提升异常 (132 DIP5) |
+| 5 声 | 非离开脉冲 |
+| 6 声 | 脉冲继电器无输入 |
+
+### 4.2 PGLC 联网终端 (DNT)
+
+PGLC 终端是连接 EDC 服务和 DG430 工装的**网络桥接设备**:
+- 通过 **RS485/TTL 串口** 连接 DG430 工装
+- 通过 **TCP/UDP 网络** 连接 EDC 服务
+- 负责串口数据与网络数据的双向透传
+
+### 4.3 测试环境准备 🆕
+
+V2.0.0 新增了测试环境记录能力。在实际测试中，需要准备的硬件包括：
+
+1. **地感线圈**: 安装在地面的感应线圈，需记录形状/尺寸/电感量/圈数等参数
+2. **模拟车辆（金属板）**: 安装在工装电机上的金属板，用于模拟车辆通过线圈
+
+以上两类参数需要在 edc-web 中预先录入，并在工装配置页关联到具体设备。
+
+---
+
+## 5. EDC 服务 (edc_server)
+
+### 5.1 功能概述
+
+EDC 服务是整个系统的**数据中枢**，负责:
+
+1. **设备管理**: 发现、注册、心跳检测、在线状态维护
+2. **数据采集**: 接收设备上报的测试数据、原始传感数据
+3. **协议解析**: 解析 DG430 二进制协议，提取测试结果（B2 + B4）
+4. **指令透传**: SerialNet 透传机制，将前端指令下发给设备
+5. **后台轮询**: 自动化测试调度、超时检测、状态流转
+
+### 5.2 启动方式
+
+```bash
+cd edc_server
+source .venv/bin/activate
+
+# 配置环境变量
+export EDC_MYSQL_HOST=127.0.0.1
+export EDC_MYSQL_USER=dg
+export EDC_MYSQL_PASSWORD=123456
+export EDC_MYSQL_DB=edc
+
+# 启动
+python run.py
+```
+
+> ⚠️ 启动时自动执行数据库表创建和 ALTER TABLE 迁移，无需手动建表。
+
+### 5.3 数据库表结构
+
+| 表名 | 用途 | 关键字段 |
+|------|------|----------|
+| `dnt_info` | 联网终端信息 | serial(唯一), ip, state(在线/离线) |
+| `tb_state_tst` | 设备测试状态 | dnt_id, test_mode, data_source, ppvalue, idle_freq, …, coil_id, simulate_car_id 🆕 |
+| `tb_serialnet` | 透传发送队列 | dnt_id, send_pkg, rcv_pkg, state(0未发→1已发→2完成→3超时) |
+| `tb_fixture_param` | 工装测试参数 | dnt_id(UNIQUE), DevType, TestMode, FarTol…, coil_id, simulate_car_id 🆕 |
+| `tb_coil_info` 🆕 | 线圈参数 | coil_num, name, induct, shape, length/width/radius, turns, resistance, material |
+| `tb_simulate_car` 🆕 | 模拟车辆参数 | simulate_num, name, shape, length/width/radius, material |
+| `tb_vechicle_base_test` | 车检器基准参数 | type_num(编码), SensMin/SensMax, FreMin/FreMax, PeakMin/PeakMax |
+| `tb_user` | 用户账号 | username, password_hash, role(admin/operator) |
+| `tb_log` | 操作日志 | user_id, action_type, target, detail, result, ip |
+| `tb_collect_{DeviceID}` | 设备原始数据采集表 | dat_type, raw_data, state(0未处理/1已处理) |
+
+### 5.4 关键流程
+
+#### 设备注册流程
+
+```
+设备上电 → TCP 时间同步 → UDP 上报 Count_Off → EDC 检查 serial
+    ├─ 已注册 → 更新 IP/网关 + last_login
+    └─ 未注册 → 插入 dnt_info + 创建 tb_collect_{DeviceID}
+```
+
+#### SerialNet 透传流程
+
+```
+前端 → edc-web → INSERT tb_serialnet (state=0)
+    → serialnet_loop 轮询 → UDP 发送到设备 (state=1)
+    → 设备回复 TSReport(dat_type=8 或 9)
+    → parse_loop 解析 → UPDATE tb_serialnet (state=2, rcv_pkg=...)
+    → 前端轮询 api/fixture/serialnet/{id} → 显示结果
+```
+
+#### 测试数据写入流程 🆕
+
+```
+parse_loop 解析 B2/B4 数据 → 查询 tb_fixture_param
+    ├─ B2: 提取 coil_id, simulate_car_id → 写入 tb_state_tst
+    └─ B4: 提取 coil_id, simulate_car_id + DevType → 写入 tb_state_tst (含 sub_type, str_type)
+```
+
+---
+
+## 6. EDC 管理系统 (edc-web)
+
+### 6.1 功能概述
+
+edc-web 是基于 Flask 的 Web 管理系统，提供图形化操作界面。
+
+**功能模块**:
+
+| 模块 | URL | 功能 | V2 变化 |
+|------|-----|------|:------:|
+| **登录** | `/login` | 用户认证 (Flask-Login) | — |
+| **设备管理** | `/` | 联网终端列表、在线状态、名称修改 | — |
+| **测试操作** | `/test-op/<dnt_id>` | 单次测试、手动控制、自动化测试、波动数据显示 | 🆕 新增波动测试区 |
+| **测试信息** | `/test-data` | 三视图（全部/B2/B4）+ ECharts 图表 + 时间精筛 + Admin 删除 | 🆕 大幅增强 |
+| **工装配置** | `/fixture/<dnt_id>` | DG430 参数配置 + 波动参数 + 线圈/车辆关联 | 🆕 新增关联 |
+| **线圈参数** 🆕 | `/coil-info` | 线圈参数增删改查 | 🆕 新增 |
+| **模拟车辆** 🆕 | `/simulate-car` | 模拟车辆参数增删改查 | 🆕 新增 |
+| **车检器基准** | `/vehicle-base-test` | 车检器测试基准参数管理 | — |
+| **用户管理** | `/users` | 账号管理 (admin only) | — |
+| **操作日志** | `/logs` | 操作记录审计 | 🆕 覆盖更全 |
+
+### 6.2 启动方式
+
+```bash
+cd edc-web
+source .venv/bin/activate
+
+# 配置环境变量（与 edc_server 相同）
+export EDC_MYSQL_HOST=127.0.0.1
+export EDC_MYSQL_USER=dg
+export EDC_MYSQL_PASSWORD=123456
+export EDC_MYSQL_DB=edc
+
+# 启动（默认 5000 端口）
+python run.py
+```
+
+**首次启动**: 自动创建默认管理员 `admin / admin123`。
+
+### 6.3 用户角色
+
+| 角色 | 权限 |
+|------|------|
+| **admin** | 全部功能：设备管理、测试操作、数据删除、用户管理、日志查看、参数管理 |
+| **operator** | 受限功能：设备管理、测试操作、数据查看（无删除权限） |
+
+---
+
+## 7. 通信协议
+
+### 7.1 DG430 串口协议
+
+DG430 与 PGLC 终端之间的通信协议，采用**一问一答**方式。
+
+**数据包格式** (7 字节):
+
+```
+┌──────┬──────┬──────┬──────┬──────┬──────┬──────┐
+│ STX  │ ADDR │ LEN  │ CMD  │ DATA │ XOR  │ SUM  │
+│ 0x7F │ 1B   │ 1B   │ 1B   │ LEN-1│ 1B   │ 1B   │
+└──────┴──────┴──────┴──────┴──────┴──────┴──────┘
+```
+
+#### 测试操作指令
+
+| 指令 | CMD | Hex (addr=0x01) | 说明 |
+|------|-----|-----------------|------|
+| 开始测试 | B0 | `7F 81 01 B0 30 32` | 启动一次测试流程 |
+| 测试复原 | B1 | `7F 81 01 B1 31 33` | 恢复到初始位置 |
+| 电机前进 | BA | `7F 81 01 BA 3A 3C` | 电机正转 |
+| 电机后退 | BB | `7F 81 01 BB 3B 3D` | 电机反转 |
+| 电机停止 | BC | `7F 81 01 BC 3C 3E` | 电机停止 |
+
+#### 工装配置指令 (V2.0.x)
+
+| 指令 | CMD | 说明 |
+|------|-----|------|
+| 获取版本号 | 4A | 查询 DG430 固件和硬件版本 |
+| 配置测试参数 | 4B | 下发工装参数（含波动参数），动态构造 |
+| 查询测试参数 | 4C | 查询当前全部参数 |
+| 出厂初始化 | 4D | 恢复出厂设置 |
+| 设备复位 | 4E | 重启 DG430 设备 |
+
+> ⚠️ **端序注意**: B2 上报和 0x4B/0x4C 的 2 字节字段**统一用小端** (`_le16`)。
+
+#### B2 状态上报（灵敏度测试）
+
+| 字段 | 说明 | 范围 |
+|------|------|------|
+| State | 设备状态 | 正常/故障 |
+| Mode | 工作模式 | — |
+| Sens | 灵敏度 | 实际值 |
+| PPValue | 峰峰值 | mV |
+| IdleFreq | 开始工作频率 | kHz |
+| EnterFreq | 进入工作频率 | kHz |
+| EnterDist | 进入距离 | mm |
+| ExitDist | 离开距离 | mm |
+| EnterSpeed | 进入速度 | dm/s |
+| ExitSpeed | 离开速度 | dm/s |
+
+#### B4 状态上报（波动测试）🆕
+
+| 字段 | 说明 | 范围 |
+|------|------|------|
+| RemainCount | 剩余波动次数 | — |
+| WorkFreq | 当前工作频率 | Hz |
+| CurrDist | 当前距离 | mm |
+| Speed | 当前速度 | dm/s |
+| NearDist | 最近距离 | mm |
+| FarDist | 最远距离 | mm |
+| EnterDist | 进入高度 | mm |
+| LeaveDist | 离开高度 | mm |
+| RelayOut | 继电器输出 | 0x00~0x03 |
+
+#### 0x4B 配置参数结构 (V2.0.3)
+
+| 字段 | 字节 | 说明 |
+|------|:---:|------|
+| Addr | 1 | 工装设备地址 |
+| DevType | 1 | 被检设备型号类型编码（1=PD132, 2=DLD110） |
+| TestMode | 1 | 0=灵敏度测试, 1=波动测试 |
+| RestDis | 1 | 复位距离 cm |
+| MinusDis | 1 | 皮距/开始距离 cm |
+| SensMin/Max | 2+2 LE | 灵敏度范围 |
+| FreMin/Max | 2+2 LE | 频率范围 Hz |
+| PeakMin/Max | 2+2 LE | 峰峰值范围 |
+| FarTol | 1 | 最远容差 cm 🆕 |
+| NearTol | 1 | 最近容差 cm 🆕 |
+| StepTol | 1 | 步进容差 cm 🆕 |
+| BackForth | 1 | 来回次数 🆕 |
+| NearStay | 2 LE | 最近停留时间 ms 🆕 |
+| FarStay | 2 LE | 最远停留时间 ms 🆕 |
+
+### 7.2 PGLC 网络接口协议
+
+EDC 服务与 PGLC 终端之间的 JSON 协议。
+
+| Method | 方向 | 说明 |
+|--------|------|------|
+| `TimeStamp` | 设备→EDC | 时间同步请求 |
+| `Count_Off` | 设备→EDC | 设备注册/发现 |
+| `TSReport` | 设备→EDC | 子设备数据上报 |
+| `SerialNet` | EDC→设备 | 串口透传指令下发 |
+| `Heartbeat` | 设备→EDC | 心跳包 |
+
+---
+
+## 8. 操作指南
+
+### 8.1 登录系统
+
+1. 浏览器访问 `http://<服务器IP>:5000/login`
+2. 默认账号: `admin` / `admin123`
+3. 登录后跳转到设备管理页
+
+### 8.2 设备管理
+
+**查看设备列表**:
+- 首页展示所有联网终端
+- 显示序列号、名称、IP、在线状态
+
+**修改设备名称**:
+- 点击设备行的名称编辑图标
+- 输入新名称后提交保存
+
+**进入测试**: 点击设备行右侧的「测试」按钮
+**进入工装配置**: 点击「工装配」按钮 🆕
+
+### 8.3 工装配置（重要：新设备必做）🆕
+
+> ⚠️ **新设备首次使用，必须先完成工装配置并保存到数据库，然后才能进行测试。**
+
+#### 8.3.1 配置前置准备
+
+1. 进入「线圈参数管理」页面（`/coil-info`），录入测试使用的线圈参数
+2. 进入「模拟车辆参数管理」页面（`/simulate-car`），录入金属板参数
+3. 进入「车检器测试基准参数管理」页面（`/vehicle-base-test`），录入车检器型号基准
+
+#### 8.3.2 工装参数配置
+
+从设备页面点击「工装配」进入配置页：
+
+**左侧 - 工装测试参数**:
+1. 设置**工装设备地址**（默认 1）
+2. 选择**测试模式**：灵敏度测试(0) 或 波动测试(1)
+3. 设置复位距离、皮距
+4. 从下拉框选择**被检设备型号**（自动填充灵敏度/频率/峰峰值范围）
+5. 如选择波动测试模式，还需配置 6 个波动参数：
+   - 最远容差 / 最近容差 / 步进容差（cm）
+   - 来回次数
+   - 最近停留时间 / 最远停留时间（ms）
+
+**右侧 - 关联参数**:
+6. 在「关联线圈参数」下拉框选择使用的线圈
+7. 在「关联模拟车辆参数」下拉框选择使用的金属板
+
+#### 8.3.3 保存配置
+
+点击 **「💾 保存」** 按钮将参数保存到数据库。
+
+> 保存会自动记录操作日志。线圈和模拟车辆关联**不需要下发透传到工装硬件**，仅记录在数据库中用于测试环境追溯。
+
+#### 8.3.4 其他工装操作
+
+| 按钮 | 指令 | 说明 |
+|------|------|------|
+| 📋 获取版本号 | 0x4A | 查询 DG430 固件/硬件版本 |
+| 🔍 查询参数 | 0x4C | 从设备读取当前参数（结果自动更新表单） |
+| 📤 配置参数 | 0x4B | 下发配置到 DG430 设备（同时自动保存到数据库） |
+| 🏭 出厂初始化 | 0x4D | 恢复 DG430 出厂设置 |
+| 🔄 设备复位 | 0x4E | 重启 DG430 设备 |
+
+**通信日志**: 每次操作后自动显示 hex 收发记录和结果。
+
+### 8.4 手动测试操作
+
+在测试操作页面（点击设备行的「测试」按钮）:
+
+1. **单次测试**: 点击「开始测试」按钮，DG430 执行一次完整测试流程
+2. **手动控制** (仅 admin):
+   - 测试复原: 恢复初始位置
+   - 电机前进/后退/停止: 手动控制电机
+3. **实时数据**: 页面自动显示设备上报的最新测试数据
+
+### 8.5 自动化测试 🆕
+
+V2.0.0 自动化测试支持可配置的间隔和超时：
+
+1. 设置**间隔时间**（秒，默认 10，0 表示无间隔连续测试）
+2. 设置**超时时间**（秒，默认 5，单次测试最大等待时间）
+3. 填入**测试次数**
+4. 点击「开始」按钮
+   - 进度条显示 `已完成/总数`
+   - 成功/失败计数实时更新
+   - 平均值区域持续刷新
+   - 波动测试数据区实时显示 B4 上报 🆕
+5. 如需中途停止，点击「结束」按钮
+
+**自动化流程**:
+```
+开始 → INSERT tb_serialnet (0xB0, state=0)
+     → serialnet_loop 发送 UDP (state=1)
+     → 等待设备 B2/B4 上报
+     → parse_loop 解析存入 tb_state_tst（含线圈/车辆关联）
+     → 匹配 serialnet 记录 (state=2)
+     → 前端轮询进度 → 等待间隔 → 自动发送下一次 0xB0
+     → ...重复...
+     → 全部完成 / 超时(fail) / 手动结束
+```
+
+**超时处理**: 单次测试超时计入失败，跳过间隔时间立即发送下一条。连续超时不阻塞。
+
+### 8.6 测试数据查询 🆕
+
+#### 8.6.1 三视图切换
+
+进入「测试信息」页面，顶部三个标签页：
+
+- **全部数据**: 显示所有测试记录（灵敏度+波动），通用列布局
+- **灵敏度测试 (0xB2)**: 仅显示 B2 来源数据，含故障信息、继电器、进入/离开频率等专属列
+- **波动测试 (0xB4)**: 仅显示 B4 来源数据，含工作频率、当前距离、剩余次数等专属列
+
+#### 8.6.2 搜索筛选
+
+| 筛选项 | 说明 |
+|--------|------|
+| 设备编码 | 模糊搜索 serial |
+| 时间范围 | 日期 + 时分秒（可选），只填日期不填时间则 date_to 自动取 23:59:59 |
+| 每页 | 20 / 50 / 100 条 |
+
+「测试环境」列显示关联的线圈编号和模拟车辆编号。 🆕
+
+#### 8.6.3 图表视图
+
+点击「📈 图表」按钮切换为 ECharts 交互式图表：
+
+- **B2 图表**: 峰峰值(V)、开始/进入/离开频率(Hz)、进入/离开距离(mm)、进入/离开速度(dm/s) + 继电器状态
+- **B4 图表**: 工作频率(Hz)、当前距离(mm)、速度(dm/s)、最近/最远距离(mm)、进入/离开高度(mm) + 继电器状态
+- **操作**: dataZoom 缩放、图例点击显隐、右键保存为 2x PNG
+
+> 图表切换到「全部」视图时自动跳转到 B2 视图。
+
+#### 8.6.4 导出 CSV
+
+点击「导出 CSV」按钮下载当前筛选条件下的全部数据为 CSV 文件。
+
+#### 8.6.5 Admin 数据删除 🆕
+
+仅 admin 可见「🗑 删除」按钮：
+1. 设置筛选条件（设备编码 / 时间范围 / 数据来源）
+2. 点击「🗑 删除」
+3. 确认框显示筛选条件，确认后执行删除
+4. 删除操作记录到 tb_log
+5. ⚠️ 无筛选条件时不删除任何数据
+
+### 8.7 参数管理 🆕
+
+#### 线圈参数管理 (`/coil-info`)
+
+支持线圈参数的全生命周期管理：
+- **新增**: 填写线圈编号、名称、电感量、形状、尺寸、圈数、电阻、材质、备注
+- **编辑**: 点击表格行的「编辑」按钮修改
+- **删除**: 点击「删除」按钮（需确认）
+- **搜索**: 按编号或名称模糊搜索
+- 所有操作自动记录到操作日志
+
+#### 模拟车辆参数管理 (`/simulate-car`)
+
+支持模拟车辆（金属板）参数的全生命周期管理：
+- 模拟编号、名称、形状、尺寸、材质、备注
+- 操作方式和线圈管理一致
+
+#### 车检器测试基准管理 (`/vehicle-base-test`)
+
+管理不同型号车检器的测试基准参数：
+- 类型编码、型号名称
+- 灵敏度/频率/峰峰值范围
+- 备注
+
+### 8.8 用户管理 (admin only)
+
+1. 点击「用户管理」菜单
+2. 功能: 添加新用户、修改角色、删除用户
+
+### 8.9 操作日志
+
+1. 点击「操作日志」菜单
+2. V2.0.0 覆盖更全的操作类型:
+   - `login` / `logout`: 登录/登出
+   - `command`: 指令下发（工装配/测试操作）
+   - `create` / `update` / `delete`: 参数管理操作（线圈/车辆/基准/工装）
+
+---
+
+## 9. 常见问题
+
+### 9.1 新设备如何开始测试？
+
+1. 确保设备在线（设备列表显示"在线"）
+2. **录入线圈参数** → `/coil-info` 添加测试使用的线圈
+3. **录入模拟车辆参数** → `/simulate-car` 添加金属板参数
+4. **录入车检器基准** → `/vehicle-base-test` 添加车检器型号
+5. **配置工装参数** → 进入工装配页，设置参数、关联线圈和车辆，点击「💾 保存」
+6. 进入测试操作页开始测试
+
+### 9.2 波动测试和灵敏度测试有什么区别？
+
+| 维度 | 灵敏度测试 | 波动测试 |
+|------|:--------:|:------:|
+| 目的 | 检测车检器灵敏度、峰峰值等静态指标 | 检测车检器在工作范围内的动态稳定性 |
+| 运动方式 | 单次进入→离开 | 多次往复运动 |
+| 数据标识 | data_source=B2 | data_source=B4 |
+| 配置 | TestMode=0 | TestMode=1（需配波动参数） |
+| 查询 | 选「灵敏度测试」标签 | 选「波动测试」标签 |
+
+### 9.3 线圈/模拟车辆关联有什么用？
+
+线圈和模拟车辆关联**不会下发到硬件**，仅记录在数据库中。当测试记录写入 `tb_state_tst` 时，会自动带上当时的线圈和车辆信息，方便后续数据分析时了解测试环境（例如"某批次测试用了哪种线圈、哪种金属板"）。
+
+### 9.4 设备离线
+
+**现象**: 设备列表显示"离线"
+
+**排查**:
+1. 检查设备供电是否正常
+2. 检查网络连接（ping 设备 IP）
+3. 查看 edc_server 日志，确认是否收到心跳
+4. 设备超时阈值: 默认 120 秒（`EDC_DEVICE_TIMEOUT`）
+
+### 9.5 测试超时
+
+**现象**: 自动化测试中连续超时
+
+**排查**:
+1. 检查 DG430 工装是否正常上电
+2. 检查 RS485 连接是否正确
+3. 在工装配页发送「获取设备版本号」(0x4A)，验证通信链路
+4. 可调整超时时间（默认 5 秒）
+
+### 9.6 速度显示异常
+
+**现象**: 速度值看起来偏大 10 倍
+
+**原因**: DG430 协议存储的是 dm/s（分米/秒），系统已自动转换为 m/s（米/秒）。如果发现显示值异常，检查转换逻辑。
+
+### 9.7 时间显示偏移 8 小时
+
+**现象**: 测试数据时间比实际晚 8 小时
+
+**已修复**: V2.0.0 已修复 Flask jsonify 的 "GMT" 后缀导致的时区偏移问题，所有时间按服务器本地时间（UTC+8）显示。
+
+---
+
+## 10. 附录
+
+### A. DG430 指令速查
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                     DG430 指令速查表                               │
+├────────┬──────────┬──────────────────────────────────────────────┤
+│  CMD   │  指令     │  Hex (addr=0x01)                            │
+├────────┼──────────┼──────────────────────────────────────────────┤
+│  0xB0  │ 开始测试  │  7F 81 01 B0 30 32                          │
+│  0xB1  │ 测试复原  │  7F 81 01 B1 31 33                          │
+│  0xBA  │ 电机前进  │  7F 81 01 BA 3A 3C                          │
+│  0xBB  │ 电机后退  │  7F 81 01 BB 3B 3D                          │
+│  0xBC  │ 电机停止  │  7F 81 01 BC 3C 3E                          │
+│  0x4A  │ 版本查询  │  7F 81 01 4A CA CC                          │
+│  0x4B  │ 配置参数  │  动态构造（含波动参数）                        │
+│  0x4C  │ 查询参数  │  7F 81 01 4C CC CE                          │
+│  0x4D  │ 出厂初始化 │  7F 81 01 4D CD CF                          │
+│  0x4E  │ 设备复位  │  7F 81 01 4E CE D0                          │
+└────────┴──────────┴──────────────────────────────────────────────┘
+```
+
+### B. 数据库快速参考
+
+```sql
+-- 查看在线设备
+SELECT serial, name, ip, state, last_login FROM dnt_info WHERE state=1;
+
+-- 查看最近灵敏度测试数据
+SELECT s.*, d.serial 
+FROM tb_state_tst s JOIN dnt_info d ON s.dnt_id = d.id 
+WHERE s.data_source='B2' ORDER BY s.create_time DESC LIMIT 20;
+
+-- 查看最近波动测试数据
+SELECT s.*, d.serial 
+FROM tb_state_tst s JOIN dnt_info d ON s.dnt_id = d.id 
+WHERE s.data_source='B4' ORDER BY s.create_time DESC LIMIT 20;
+
+-- 查看测试环境（线圈+车辆关联）
+SELECT t.create_time, d.serial, c.coil_num, c.name as coil_name, 
+       sc.simulate_num, sc.name as car_name
+FROM tb_state_tst t
+JOIN dnt_info d ON t.dnt_id = d.id
+LEFT JOIN tb_coil_info c ON t.coil_id = c.id
+LEFT JOIN tb_simulate_car sc ON t.simulate_car_id = sc.id
+ORDER BY t.create_time DESC LIMIT 20;
+
+-- 查看待发送指令
+SELECT * FROM tb_serialnet WHERE state=0;
+
+-- 查看操作日志
+SELECT l.*, u.username 
+FROM tb_log l JOIN tb_user u ON l.user_id = u.id 
+ORDER BY l.create_time DESC LIMIT 50;
+```
+
+### C. 环境变量速查
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `EDC_MYSQL_HOST` | 127.0.0.1 | MySQL 地址 |
+| `EDC_MYSQL_PORT` | 3306 | MySQL 端口 |
+| `EDC_MYSQL_USER` | dg | 数据库用户 |
+| `EDC_MYSQL_PASSWORD` | 123456 | 数据库密码 |
+| `EDC_MYSQL_DB` | edc | 数据库名 |
+| `EDC_UDP_PORT` | 5500 | UDP 设备发现 |
+| `EDC_UDP_MSG_PORT` | 5505 | UDP 消息监听 |
+| `EDC_TCP_PORT` | 5550 | TCP 数据上报 |
+| `EDC_DEVICE_UDP_PORT` | 4900 | 设备端 UDP |
+| `EDC_DEVICE_TCP_PORT` | 5550 | 设备端 TCP |
+| `EDC_DEVICE_TIMEOUT` | 120 | 设备离线超时(秒) |
+| `EDC_PARSE_POLL_INTERVAL` | 0.5 | 解析轮询间隔(秒) |
+| `EDC_LOG_LEVEL` | INFO | 日志级别 |
+| `EDC_WEB_PORT` | 5000 | Web 管理端口 |
+
+### D. 新设备配置检查清单
+
+- [ ] 设备上电，确认在线状态
+- [ ] `/coil-info` 录入线圈参数
+- [ ] `/simulate-car` 录入模拟车辆参数
+- [ ] `/vehicle-base-test` 录入车检器基准
+- [ ] 工装配页：设置测试模式、被检设备型号
+- [ ] 工装配页：关联线圈和模拟车辆
+- [ ] 工装配页：点击「💾 保存」
+- [ ] （可选）「📤 配置参数」下发到 DG430
+- [ ] 进入测试操作页开始测试
+
+### E. 修订历史
+
+| 版本 | 日期 | 说明 | 作者 |
+|------|------|------|------|
+| V1.0 | 2026-05-31 | 初始版本（灵敏度测试 + 基本工装配置） | wangfq |
+| V2.0.0 | 2026-06-08 | 新增波动测试、线圈/车辆管理、三视图图表、时间精筛、自动化增强 | wangfq |