示波器

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

开始前确认

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

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

入口与界面

从 eTuner 主界面打开示波器窗口
连接设备后，点击主界面的 示波器 入口打开示波器窗口。
eTuner 示波器窗口截图
采集后的示波器窗口会显示观察对象统计值和曲线；窗口同时提供采样、触发、曲线保存和加载功能。
区域 说明 操作建议
主界面 → 示波器 打开示波器窗口，窗口主体为数据记录区域。 如果点击后无响应，先确认是否已有示波器窗口、设备是否处于运行状态、通信是否已连接。
采集按钮 可见按钮包括 开始采集、停止采集、跳过触发 和 连续。 先完成观察对象、采样和触发设置，再开始采集。
保存与加载 可见入口包括 曲线保存 和 曲线加载。 曲线记录文件使用 .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 文件格式兼容。