Syntax
NETNAME is omitted, lists all available scope nets on the box.
Global Options
Commands
Edge trigger works with both PicoScope and Rigol. Protocol triggers (I2C, SPI, UART) and pulse width trigger are Rigol only.
Validation Ranges
The CLI validates input values before sending commands to the oscilloscope:Supported Hardware
Feature Comparison
Basic Control Commands
enable
Enable oscilloscope channel for the specified net.
disable
Disable oscilloscope channel.
start
Start waveform capture (continuous or single).
--single- Capture single waveform then stop (one-shot mode)
stop
Stop waveform capture.
force
Force trigger manually, bypassing the trigger condition. Useful when the signal doesn’t meet trigger criteria.
autoscale
Automatically adjust vertical scale and horizontal timebase for optimal display (Rigol only).
Channel Configuration (Rigol)
coupling
Set the input coupling mode for the oscilloscope channel.
MODE- Coupling mode:dc,ac, orgnd
probe
Set the probe attenuation ratio for accurate voltage measurements.
RATIO- Probe attenuation:1,10,100, or1000
scale
Set the vertical scale (volts per division) for the oscilloscope channel.
VOLTS_PER_DIV- Vertical scale in volts per division (0.001 to 100.0)
timebase
Set the horizontal timebase (seconds per division) for the oscilloscope.
SEC_PER_DIV- Horizontal timebase in seconds per division (1e-9 to 50.0)
Measure Subcommands (Rigol)
Measure waveform characteristics on Rigol oscilloscopes. PicoScope users should use the streaming capture commands to export waveform data for analysis. Common Options for all measure commands:Time Measurements
measure period
Measure waveform period.
measure freq
Measure waveform frequency.
measure pulse-width-pos
Measure positive pulse width.
measure pulse-width-neg
Measure negative pulse width.
measure duty-cycle-pos
Measure positive duty cycle (percentage of time signal is high).
measure duty-cycle-neg
Measure negative duty cycle (percentage of time signal is low).
Voltage Measurements
measure vpp
Measure peak-to-peak voltage.
measure vmax
Measure maximum voltage.
measure vmin
Measure minimum voltage.
measure vavg
Measure average voltage.
measure vrms
Measure RMS (root mean square) voltage.
Trigger Subcommands
Configure trigger settings. Edge trigger works with both PicoScope and Rigol. Protocol triggers (I2C, SPI, UART) and pulse trigger are Rigol only. Common Trigger Options:trigger edge
Set edge trigger configuration. Works with both PicoScope and Rigol.
Examples:
trigger pulse
Set pulse width trigger (Rigol only). Triggers when pulse width meets specified conditions.
Trigger-on Conditions:
Examples:
trigger i2c
Set I2C protocol trigger (Rigol only). Triggers on I2C bus events.
Trigger-on Conditions:
Examples:
trigger spi
Set SPI protocol trigger (Rigol only). Triggers on SPI bus events.
Examples:
trigger uart
Set UART protocol trigger (Rigol only). Triggers on UART serial events.
Examples:
Cursor Subcommands (Rigol)
Control manual XY cursors on Rigol oscilloscopes for precise time and voltage measurements. Cursors A and B can be positioned independently, and the oscilloscope calculates the delta between them.cursor set-a / cursor set-b
Set the absolute position of cursor A or B.
cursor move-a / cursor move-b
Move a cursor by a relative offset from its current position.
cursor hide
Hide the cursor display.
Stream Subcommands (PicoScope)
Stream oscilloscope data in real time from PicoScope devices. The streaming system uses a dedicated daemon on the Lager Box with a web-based visualization interface.Daemon Architecture
The PicoScope streaming daemon communicates over multiple ports:stream start
Start oscilloscope streaming acquisition with web visualization.
Examples:
stream stop
Stop oscilloscope streaming acquisition.
stream status
Check oscilloscope streaming daemon status.
stream web
Open web browser for real-time oscilloscope visualization.
--port- HTTP server port (default: 8080)
stream capture
Capture oscilloscope waveform data to a CSV file.
Examples:
stream config
Configure oscilloscope streaming settings without starting/stopping acquisition.
Examples:
Examples
Basic Rigol Workflow
Channel Configuration
Measurements
Triggering
Cursor Measurements
PicoScope Streaming
Command Structure
Notes
- Net names refer to names assigned when setting up your testbed with
lager nets - The
--mcuoption is available on all commands and is passed to the backend; use it when multiple MCUs share a scope channel - Streaming commands are only available for PicoScope devices
- Measurement and cursor commands are only available for Rigol devices
- Edge trigger is the only trigger type supported on both PicoScope and Rigol
- Web visualization requires port 8080 to be accessible on the Lager Box
- Validation rejects values outside the allowed ranges before sending to hardware
- Use
lager netsto see available scope nets
See Also
- Logic Analyzer — Digital signal capture and protocol decode
- Python Scope API — Automate oscilloscope operations in Python scripts

