Skip to main content
通过 Lager CLI 控制示波器 Net,用于波形采集、触发、测量和串流。
Rigol MSO5000 上的已知限制。 边沿触发和 SPI 触发可以工作。脉冲、UART 和 I2C 触发在 Rigol MSO5000 上会失败。 CAN 触发以及 Python API 中的所有总线解码器同样会失败。失败的命令会打印错误并以 1 退出。 Issue #418 跟踪这项工作。

语法

省略 NETNAME 时,列出 Box 上全部可用的示波器 Net。

全局选项

命令

边沿触发在 PicoScope 和 Rigol 上都可用。协议触发(I2C、SPI、UART)和脉宽触发仅限 Rigol。

校验范围

CLI 在把命令发送到示波器之前会先校验输入值:

受支持的硬件

功能对比


基本控制命令

enable

为指定的 Net 启用示波器通道。

disable

停用示波器通道。

start

开始波形采集(连续或单次)。
选项:
  • --single - 采集一次波形后停止(单次模式)

stop

停止波形采集。

force

手动强制触发,绕过触发条件。当信号不满足触发条件时很有用。

autoscale

自动调整垂直刻度和水平时基以获得最佳显示(仅 Rigol)。

通道配置(Rigol)

coupling

设置示波器通道的输入耦合方式。
参数:
  • MODE - 耦合方式:dcacgnd

probe

设置探头衰减比,以获得准确的电压测量。
参数:
  • RATIO - 探头衰减比:1101001000

scale

设置示波器通道的垂直刻度(每格伏特数)。
参数:
  • VOLTS_PER_DIV - 垂直刻度,单位伏特每格(0.001 至 100.0)

timebase

设置示波器的水平时基(每格秒数)。
参数:
  • SEC_PER_DIV - 水平时基,单位秒每格(1e-9 至 50.0)

measure 子命令(Rigol)

在 Rigol 示波器上测量波形特性。PicoScope 用户必须使用串流采集命令导出波形数据再做分析。 所有 measure 命令的通用选项:

时间测量

measure period

测量波形周期。

measure freq

测量波形频率。

measure pulse-width-pos

测量正脉宽。

measure pulse-width-neg

测量负脉宽。

measure duty-cycle-pos

测量正占空比(信号为高电平的时间占比)。

measure duty-cycle-neg

测量负占空比(信号为低电平的时间占比)。

电压测量

measure vpp

测量峰峰值电压。

measure vmax

测量最大电压。

measure vmin

测量最小电压。

measure vavg

测量平均电压。

measure vrms

测量有效值(均方根)电压。

trigger 子命令

配置触发设置。边沿触发在 PicoScope 和 Rigol 上都可用。协议触发(I2C、SPI、UART)和脉冲触发仅限 Rigol。 通用触发选项:

trigger edge

设置边沿触发配置。PicoScope 和 Rigol 都支持。
选项(在通用选项之外): 示例:

trigger pulse

设置脉宽触发(仅 Rigol)。当脉宽满足指定条件时触发。 在 Rigol MSO5000 上,这个触发还不能工作。请参阅本页顶部的限制说明。
选项(在通用选项之外): trigger-on 条件:

trigger i2c

设置 I2C 协议触发(仅 Rigol)。在 I2C 总线事件上触发。 在 Rigol MSO5000 上,这条命令还不能工作。请参阅本页顶部的限制说明。该命令还会拒绝它自己的默认 --directionread_write,以及 ack_miss 条件。
选项(在通用的 mode/coupling 之外): trigger-on 条件:

trigger spi

设置 SPI 协议触发(仅 Rigol)。在 SPI 总线事件上触发。
选项(在通用的 mode/coupling 之外): 若要设置数据模式或时钟边沿,请使用逻辑分析仪 页面上的 lager logic NET trigger spi。它的 --data 取十进制整数, --clk-slopepositivenegative 示例:

trigger uart

设置 UART 协议触发(仅 Rigol)。在 UART 串行事件上触发。 在 Rigol MSO5000 上,这条命令还不能工作。请参阅本页顶部的限制说明。该命令还会拒绝 stop 条件。
选项(在通用选项之外):

cursor 子命令(Rigol)

在 Rigol 示波器上控制手动 XY 光标,以进行精确的时间和电压测量。光标 A 和 B 可以独立定位,示波器会计算它们之间的差值。

cursor set-a / cursor set-b

设置光标 A 或 B 的绝对位置。
选项:

cursor move-a / cursor move-b

按相对于当前位置的偏移量移动光标。
选项:

cursor hide

隐藏光标显示。
示例:

stream 子命令(PicoScope)

从 PicoScope 设备实时串流示波器数据。串流系统在 Lager Box 上使用一个专用守护进程,并提供基于 Web 的可视化界面。

守护进程架构

PicoScope 串流守护进程通过多个端口通信:

stream start

启动带 Web 可视化的示波器串流采集。
选项: 示例:

stream stop

停止示波器串流采集。

stream status

查看示波器串流守护进程的状态。

stream web

打开浏览器进行实时示波器可视化。
选项:
  • --port - HTTP 服务器端口(默认 8080)
Web 界面提供一个 HTML5 示波器显示,通过 WebTransport 实时渲染波形。

stream capture

把示波器波形数据采集到 CSV 文件。
选项: 示例:

stream config

配置示波器串流设置,而不启动或停止采集。
选项: 示例:

示例

Rigol 基本流程

通道配置

测量

触发

光标测量

PicoScope 串流


命令结构


说明

  • Net 名称就是您用 lager nets 搭建实验台时分配的名称
  • --mcu 选项在所有命令上都可用,它会传给后端;当多个 MCU 共用一个示波器通道时请使用它
  • 串流命令仅适用于 PicoScope 设备
  • 测量和光标命令仅适用于 Rigol 设备
  • 边沿触发是 PicoScope 和 Rigol 都支持的唯一触发类型
  • 在 Rigol MSO5000 上,只有边沿触发和 SPI 触发可以工作(见 issue #418
  • Web 可视化要求 Lager Box 上的端口 8080 可访问
  • 校验会在发送到硬件之前拒绝超出允许范围的数值
  • lager nets 查看可用的示波器 Net

参见