Power-on Recorder 上电录制模式

功能概述

Power-on Recorder 模式是一种上电启动录制功能，用于在目标系统上电启动时自动捕获指定变量的瞬态数据。与传统 Recorder 模式不同，它不需要触发条件，配置下发后目标机在下次上电时立即开始录制。

支持两种工作模式：
- 标准模式：Master 连接后下发配置，Slave 开始录制
- 预录制模式：Slave 端通过 API 预设变量并立即录制，Master 连接后直接获取已录制数据

应用场景

核心特性

打开 Power-on Recorder 窗口

1. 在资源管理器中右键点击工程节点
2. 选择「打开Power-on Recorder窗口...」
3. Power-on Recorder 窗口将在右侧停靠区域显示

窗口特性：
- Power-on Recorder 窗口是一个可停靠窗口（Dock Widget）
- 默认位置：右侧停靠区域
- 支持：移动、浮动、关闭
- 可通过主菜单「视图」→「Power-on Recorder(P)」切换显示

配置录制

1. 选择录制变量

点击「从工程选择变量」按钮，打开变量选择对话框：

• 左侧树形列表：按源文件分组显示工程中的可用变量
• 右侧列表：已选择的变量，显示名称、地址、大小
• 操作按钮：
• >：将选中的可用变量添加到已选列表
• >>：将所有可用变量添加到已选列表
• <：从已选列表中移除选中变量
• <<：清空已选列表

限制：最多选择 10 个变量。变量大小支持 1/2/4 字节。

2. 配置录制参数

3. 标准模式启动录制

1. 选择好变量并配置参数后，点击「准备等待」按钮
2. 系统进入等待连接状态，不断尝试连接目标机
3. 此时给目标机上电
4. 连接成功后，系统自动下发录制配置
5. 目标机开始录制数据
6. 录制完成后自动回传数据到主机端

4. 预录制模式启动录制

预录制模式适用于目标机已上电并已通过 API 预录制数据的场景：

1. 在 Power-on Recorder 窗口勾选「使用预录制变量」
2. 选择与目标机端预设变量对应的变量清单（用于数据解析）
3. 点击「准备等待」按钮
4. 连接成功后，系统自动获取预录制配置
5. 匹配预录制变量与 UI 变量
6. 点击「继续上传」获取预录制数据
7. 数据上传完成后显示波形

注意：预录制模式下，变量清单仅用于数据解析（按地址匹配），不会下发配置到目标机。

5. 录制状态说明

预录制模式详解

工作原理

目标机端（Slave）                           PC端（Master）
    │                                          │
    │  调用预录制 API                           │
    │  → 立即开始录制                           │
    │  → 录制完成，数据保留                      │
    │                                          │
    │                     ... 一段时间后 ...     │
    │                                          │
    │  ◄── 连接请求 ─────────────────          │
    │  ── 连接响应 ────────────────────►        │
    │                                          │
    │  ◄── 获取预录制配置 ───────────          │  勾选"使用预录制变量"
    │  ── 返回预录制配置 ─────────────►          │
    │                                          │
    │  ◄── 开始上传 ─────────────────          │  点击"继续上传"
    │  ── 数据帧 ─────────────────────►          │
    │                                          │
    │  ◄── 确认 ─────────────────────          │

模式选择

是否使用预录制模式由 Master 端配置决定：

变量匹配

预录制模式下，Master 端的变量清单按地址与 Slave 端预录制变量自动匹配：

• 完全匹配：地址相同且大小相同 → 正常解析
• 部分匹配：地址相同但大小不同 → 警告，使用 Slave 端大小
• 未匹配：UI 变量地址在预录制列表中不存在 → 提示用户

查看录制数据

波形分析

录制完成后，数据列表会新增一条记录。可以通过以下方式查看波形：

• 双击数据行：直接在波形图上打开数据
• 右键菜单：选择「查看波形」

系统自动将原始数据解析为 XcpData 格式并加载到波形图，每个录制变量显示为一条波形曲线。

保存到工程

点击「保存到工程」按钮，将录制数据保存为工程数据，可供后续分析和对比。

操作流程总结

标准模式

1. 打开 Power-on Recorder 窗口
       ↓
2. 选择录制变量 + 配置参数
       ↓
3. 点击「准备等待」
       ↓
4. 给目标机上电
       ↓
5. 自动连接 → 配置下发 → 录制 → 数据回传
       ↓
6. 双击数据查看波形 / 保存到工程

预录制模式

1. 目标机端调用预录制 API 开始录制
       ↓
2. 打开 Power-on Recorder 窗口
       ↓
3. 勾选"使用预录制变量" + 选择对应变量
       ↓
4. 点击「准备等待」
       ↓
5. 自动连接 → 获取预录制配置 → 匹配变量 → 上传数据
       ↓
6. 双击数据查看波形 / 保存到工程

注意：
- Power-on Recorder 与 Watch、Scope、Recorder 互斥，使用时需确保其他采集模式已停止
- 如果目标机已连接，配置会在点击"准备等待"时立即下发
- 等待连接超时时间为 10 分钟（300 次重连，每次 2 秒）
- 预录制模式下，如果 Slave 端没有预录制数据，系统会自动回退到标准模式

与其他模式的关系

与 Watch 的关系

• 互斥运行：Power-on Recorder 运行时，Watch 必须暂停刷新
• 独占资源：Power-on Recorder 需要独占通信资源进行上电录制
• 自动恢复：Power-on Recorder 停止后，Watch 自动恢复刷新

与 Scope 的关系

• 互斥运行：Power-on Recorder 运行时，Scope 必须暂停采集
• 独占资源：Power-on Recorder 需要独占通信资源进行上电录制
• 自动恢复：Power-on Recorder 停止后，Scope 自动恢复采集

与 Recorder 的关系

• 互斥运行：Power-on Recorder 与 Recorder 不能同时运行
• 独占资源：两者都需要独占通信资源
• 场景差异：
• Recorder：适用于运行时触发式录制，捕获瞬态事件
• Power-on Recorder：适用于上电启动录制，捕获启动瞬态过程

相关文档

• Recorder 模式
• Watch 窗口
• Scope 模式
• emXCP 目标机库集成

本文档最后更新时间：2026-05-29