语法
NETNAME 时,列出 Box 上全部可用的示波器 Net。
全局选项
命令
边沿触发在 PicoScope 和 Rigol 上都可用。协议触发(I2C、SPI、UART)和脉宽触发仅限 Rigol。
校验范围
CLI 在把命令发送到示波器之前会先校验输入值:受支持的硬件
功能对比
基本控制命令
enable
为指定的 Net 启用示波器通道。
disable
停用示波器通道。
start
开始波形采集(连续或单次)。
--single- 采集一次波形后停止(单次模式)
stop
停止波形采集。
force
手动强制触发,绕过触发条件。当信号不满足触发条件时很有用。
autoscale
自动调整垂直刻度和水平时基以获得最佳显示(仅 Rigol)。
通道配置(Rigol)
coupling
设置示波器通道的输入耦合方式。
MODE- 耦合方式:dc、ac或gnd
probe
设置探头衰减比,以获得准确的电压测量。
RATIO- 探头衰减比:1、10、100或1000
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 上,这条命令还不能工作。请参阅本页顶部的限制说明。该命令还会拒绝它自己的默认 --direction 值 read_write,以及 ack_miss 条件。
trigger-on 条件:
trigger spi
设置 SPI 协议触发(仅 Rigol)。在 SPI 总线事件上触发。
若要设置数据模式或时钟边沿,请使用逻辑分析仪
页面上的
lager logic NET trigger spi。它的 --data 取十进制整数,
--clk-slope 取 positive 或 negative。
示例:
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)
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
参见
- 逻辑分析仪 — 数字信号采集与协议解码
- Python Scope API — 在 Python 脚本中自动进行示波器操作

