# 示波器

本章说明如何通过主界面“示波器”采集运行数据、查看曲线、使用触发、保存记录文件和加载历史曲线。示波器只用于观察和记录，不替代现场安全确认。

## 开始前确认

项目 | 确认内容
--- | ---
通信连接 | 先完成设备连接，再打开示波器并开始采集。连接对象为空时，示波器不会取得有效通信。
窗口状态 | 示波器已打开、正在采集或设备处于运行状态时，不要反复点击入口。
运动安全 | 采集前确认机构、负载、限位和急停条件。示波器采集可能伴随运动，不应在危险工况下尝试触发。
文件保存 | 保存曲线前选择明确的目录和文件名，避免覆盖现场记录；保存后再交给项目流程归档。

采集中不要反复点击 开始采集。采集或等待触发状态下再次开始采集，软件会先停止当前采集，再重新下发采样、观察和触发参数。

## 入口与界面

连接设备后，点击主界面的 示波器 入口打开示波器窗口。
采集后的示波器窗口会显示观察对象统计值和曲线；窗口同时提供采样、触发、曲线保存和加载功能。

区域 | 说明 | 操作建议
--- | --- | ---
主界面 → 示波器 | 打开示波器窗口，窗口主体为数据记录区域。 | 如果点击后无响应，先确认是否已有示波器窗口、设备是否处于运行状态、通信是否已连接。
采集按钮 | 可见按钮包括 开始采集、停止采集、跳过触发 和 连续。 | 先完成观察对象、采样和触发设置，再开始采集。
保存与加载 | 可见入口包括 曲线保存 和 曲线加载。 | 曲线记录文件使用 `.csv` 后缀；跨软件使用前先确认格式兼容。
图表区域 | 采集完成后显示曲线，可通过右键菜单缩放、重置、标记、游标、复制图片或另存图片。 | 需要对比细节时优先使用缩放和标记，不要只凭整体曲线判断异常。

## 观察对象

开始采集前必须添加至少一个观察对象。观察对象应通过界面选择和添加；观察对象的数值是采集显示值，不是写入参数。

观察对象 | 用途 | 建议
--- | --- | ---
目标位置 | 观察控制目标位置。 | 用于和实际位置、位置误差对照，判断目标是否合理。
实际位置 | 观察位置反馈。 | 用于定位跟随误差、限位边界和位置控制问题。
位置误差 | 观察目标位置与实际位置之间的偏差。 | 用于判断位置跟随效果和保护阈值是否合适。
目标速度 | 观察控制目标速度。 | 用于和实际速度、速度误差对照，分析加减速过程。
实际速度 | 观察速度反馈。 | 用于分析速度波动、超调和负载变化。
速度误差 | 观察目标速度与实际速度之间的偏差。 | 用于判断速度跟随效果和速度保护阈值是否合适。
目标电流 | 观察控制目标电流。 | 用于和实际电流对照，分析电流环响应。
实际电流 | 观察电流反馈。 | 用于分析负载变化、堵转和电流饱和。
三相电流 | 观察三相电流变化。 | 用于分析功率输出、接线或电流采样异常。
母线电压 | 观察供电母线电压。 | 用于分析供电波动、制动工况和保护触发背景。
状态字 | 观察设备状态变化。 | 用于把状态变化和运动、电流、速度曲线对应起来。
控制字 | 观察控制相关状态变化。 | 用于确认当前控制链路是否符合调试预期。
运行模式 | 观察当前运行模式。 | 用于确认曲线对应的位置、速度或力矩控制场景。
实际扭矩 | 观察扭矩相关反馈。 | 用于分析负载变化和力矩输出是否异常。
数字输入 | 观察数字输入状态。 | 用于把现场信号变化和运动曲线对应起来。
模拟输入 | 观察模拟输入状态。 | 用于确认外部模拟量输入是否稳定。

若未添加观察对象就开始采集，软件会提示选择需要观测的参数并停止本次操作。

## 采样设置

项目 | 说明 | 建议
--- | --- | ---
采样时长 | 单位为秒，用于设置本次记录持续时间。 | 短时长适合捕捉动作瞬间，长时长适合观察慢速漂移或周期性异常；采样时长需与采样间隔、观察对象数量一起控制数据量。
采样间隔 | 按每点时间表述，可见选项覆盖 50 微秒/点到 1000 毫秒/点。 | 间隔越小数据越密，记录压力越高；间隔越大越适合长时间趋势。
采样数据量 | 单次采集数据量由采样时长、采样间隔和观察对象数量共同决定，建议不超过 8000 点。 | 若提示采样数据量过大，减少观察对象、缩短采样时长或增大采样间隔后再采集。
图表数量 | 界面支持 1 到 4 个图表显示。 | 相关性强的曲线可放在同一图表或相邻图表中，便于对照时间点。

## 触发设置

触发用于决定何时开始记录或截取关键数据。设置触发前，应确认触发源和观察对象对应同一调试目标。

项目 | 说明
--- | ---
触发源 | 选择用于判断触发条件的数据源。
触发条件 | 包括无、大于、等于、不等于、小于、上升沿、下降沿、手动强制。
触发值 | 用于配合触发条件判断是否满足触发。
触发位置 | 用于控制触发点在记录数据中的位置，范围为 0% 到 100%。
跳过触发 | 等待触发时可强制触发采集。使用前确认当前数据已经具备记录意义。

触发条件或采样参数配置错误时，软件可能提示数据采集指令错误。不要连续重复开始采集，应先检查触发源、触发值、采样时长和采样间隔。

## 采集流程

1. 完成通信连接，确认当前连接 ID 是目标设备。
2. 打开主界面 示波器。
3. 添加需要观察的对象，确认曲线数量不超过当前配置允许的范围。
4. 设置采样时长、采样间隔和图表数量。
5. 设置触发源、触发条件、触发值和触发位置。
6. 点击 开始采集，等待采集结束和数据上传。
7. 曲线显示后，使用缩放、标记、游标、统计和保存功能分析数据。

需要提前结束时点击 停止采集。等待触发但现场条件已经满足人工记录需要时，可点击 跳过触发 强制触发。

## 图表查看

功能 | 说明 | 建议
--- | --- | ---
曲线显示 | 支持多曲线和多图表显示，常见曲线颜色为红、橙、蓝、黑。 | 保存或截图前确认颜色、单位和曲线含义，避免记录无法追溯。
缩放 | 右键菜单支持 XY、X、Y 方向缩放，也可撤销缩放或重置图表。 | 分析异常点时保留原始记录文件，再做局部缩放截图。
标记与游标 | 右键菜单支持纵向/横向标记和游标类查看功能。 | 用于对齐触发点、峰值、速度变化点或电流突变点。
复制和图片另存 | 右键菜单可复制图像或另存为 JPEG 图片。 | 图片适合报告展示；数据分析仍以曲线记录文件为准。

## 统计与保存

项目 | 说明 | 注意事项
--- | --- | ---
统计显示 | 每条曲线可显示最大值、最小值、平均值，最多 4 组。 | 以界面显示的统计项为准，避免和其他统计口径混淆。
曲线保存 | 通过 曲线保存 保存为 `.csv` 后缀记录文件。 | 交给外部工具分析前，先用 eTuner 重新加载确认记录有效。
曲线加载 | 通过 曲线加载 读取 `.csv` 后缀记录文件并显示曲线。 | 优先加载由 eTuner 导出的记录文件，不使用手工编辑文件作为正式依据。
图形文件 | `.agf` 是软件图形/数据文件，采集后可由软件写入和加载。 | 按界面提供的保存和加载功能使用，不需要额外设置。
图片 | 右键图片另存为 JPEG，也可复制图片。 | 图片只保留显示结果，不保留可重新分析的数据源。

## 常见排查

现象 | 处理建议
--- | ---
点击示波器没有打开窗口 | 确认示波器窗口是否已打开、页面是否正在释放、设备是否处于运行状态，再检查通信连接。
开始采集提示选择参数 | 先添加至少一个观察对象，再重新开始采集。
采集指令错误 | 检查采样时长、采样间隔、触发源、触发条件、触发值和设备当前状态。
曲线长时间不显示 | 确认是否仍在等待触发、通信是否稳定、设备是否处于预期运行状态；必要时停止采集后重新设置。
保存文件无法被外部工具识别 | 优先用 eTuner 重新加载确认记录有效；跨软件使用时先确认 `.csv` 文件格式兼容。