Skip to main content
Control oscilloscope nets through the Lager CLI for waveform capture, triggering, measurements, and streaming.

Syntax

If 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).
Options:
  • --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.
Arguments:
  • MODE - Coupling mode: dc, ac, or gnd

probe

Set the probe attenuation ratio for accurate voltage measurements.
Arguments:
  • RATIO - Probe attenuation: 1, 10, 100, or 1000

scale

Set the vertical scale (volts per division) for the oscilloscope channel.
Arguments:
  • 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.
Arguments:
  • 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.
Options (in addition to common): Examples:

trigger pulse

Set pulse width trigger (Rigol only). Triggers when pulse width meets specified conditions.
Options (in addition to common): Trigger-on Conditions: Examples:

trigger i2c

Set I2C protocol trigger (Rigol only). Triggers on I2C bus events.
Options (in addition to common mode/coupling): Trigger-on Conditions: Examples:

trigger spi

Set SPI protocol trigger (Rigol only). Triggers on SPI bus events.
Options (in addition to common mode/coupling): Examples:

trigger uart

Set UART protocol trigger (Rigol only). Triggers on UART serial events.
Options (in addition to common): 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.
Options:

cursor move-a / cursor move-b

Move a cursor by a relative offset from its current position.
Options:

cursor hide

Hide the cursor display.
Examples:

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.
Options: Examples:

stream stop

Stop oscilloscope streaming acquisition.

stream status

Check oscilloscope streaming daemon status.

stream web

Open web browser for real-time oscilloscope visualization.
Options:
  • --port - HTTP server port (default: 8080)
The web interface provides an HTML5 oscilloscope display with real-time waveform rendering via WebTransport.

stream capture

Capture oscilloscope waveform data to a CSV file.
Options: Examples:

stream config

Configure oscilloscope streaming settings without starting/stopping acquisition.
Options: 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 --mcu option 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 nets to see available scope nets

See Also