Oscilloscope

Control oscilloscope settings and capture waveforms

Control oscilloscope Nets through the Lager CLI for waveform capture, triggering, and measurements.

Syntax

lager scope [OPTIONS] NET_NAME COMMAND [ARGS]...

Global Options

Option	Description
--box BOX	Lagerbox name or IP address
--help	Show help message and exit

Commands

Command	Description
enable	Enable oscilloscope channel
disable	Disable oscilloscope channel
start	Start waveform capture
start-single	Start single waveform capture
stop	Stop waveform capture
measure	Measure waveform characteristics
trigger	Configure trigger settings
cursor	Control scope cursor
stream	Stream oscilloscope data (PicoScope)

Command Reference

enable

Enable oscilloscope channel for the specified net.

lager scope NET_NAME enable [--box BOX] [--mcu MCU]

disable

Disable oscilloscope channel.

lager scope NET_NAME disable [--box BOX] [--mcu MCU]

start

Start continuous waveform capture.

lager scope NET_NAME start [--box BOX] [--mcu MCU]

start-single

Start single waveform capture (one-shot).

lager scope NET_NAME start-single [--box BOX] [--mcu MCU]

stop

Stop waveform capture.

lager scope NET_NAME stop [--box BOX] [--mcu MCU]

---

Measure Subcommands

measure period

Measure waveform period.

lager scope NET_NAME measure period [--box BOX] [--display BOOL] [--cursor BOOL]

Options:

• --display - Display measurement on screen
• --cursor - Enable measurement cursor

measure freq

Measure waveform frequency.

lager scope NET_NAME measure freq [--box BOX] [--display BOOL] [--cursor BOOL]

---

Trigger Subcommands

trigger edge

Set edge trigger configuration.

lager scope NET_NAME trigger edge [OPTIONS]

Options:

• --mode - Trigger mode: normal, auto, single (default: normal)
• --coupling - Coupling mode: dc, ac, low_freq_rej, high_freq_rej (default: dc)
• --source NET - Trigger source net
• --slope - Trigger slope: rising, falling, both
• --level FLOAT - Trigger level in volts

---

Cursor Subcommands

cursor set-a / cursor set-b

Set cursor A or B position.

lager scope NET_NAME cursor set-a [--x FLOAT] [--y FLOAT]
lager scope NET_NAME cursor set-b [--x FLOAT] [--y FLOAT]

cursor move-a / cursor move-b

Shift cursor position.

lager scope NET_NAME cursor move-a [--del-x FLOAT] [--del-y FLOAT]
lager scope NET_NAME cursor move-b [--del-x FLOAT] [--del-y FLOAT]

cursor hide

Hide the cursor.

lager scope NET_NAME cursor hide

---

Stream Subcommands (PicoScope)

stream start

Start oscilloscope streaming acquisition (PicoScope only).

lager scope NET_NAME stream start [OPTIONS]

Options:

• --channel - Channel to enable: A, B, 1, 2 (default: A)
• --volts-per-div - Volts per division (default: 1.0)
• --time-per-div - Time per division in seconds (default: 0.001)
• --trigger-level - Trigger level in volts (default: 0.0)
• --trigger-slope - Trigger slope: rising, falling, either (default: rising)
• --capture-mode - Capture mode: auto, normal, single (default: auto)
• --coupling - Input coupling: dc, ac (default: dc)

stream stop

Stop oscilloscope streaming acquisition.

lager scope NET_NAME stream stop [--box BOX]

stream status

Check oscilloscope streaming daemon status.

lager scope NET_NAME stream status [--box BOX]

stream web

Open web browser for oscilloscope visualization.

lager scope NET_NAME stream web [--box BOX] [--port PORT]

Options:

• --port - HTTP server port (default: 8080)

stream capture

Capture oscilloscope data to file.

lager scope NET_NAME stream capture [--output FILE] [--duration FLOAT] [--samples INT]

Options:

• --output - Output file path (default: scope_data.csv)
• --duration - Capture duration in seconds (default: 1.0)
• --samples - Number of samples to capture

stream config

Configure oscilloscope streaming settings.

lager scope NET_NAME stream config [OPTIONS]

Options:

• --channel - Channel to configure
• --volts-per-div - Volts per division
• --time-per-div - Time per division
• --trigger-level - Trigger level
• --trigger-source - Trigger source channel
• --trigger-slope - Trigger slope
• --capture-mode - Capture mode
• --coupling - Input coupling
• --enable/--disable - Enable or disable channel

---

Examples

# Enable scope channel
lager scope ANALOG1 enable --box my-lager-box

# Start continuous capture
lager scope ANALOG1 start

# Measure frequency
lager scope ANALOG1 measure freq --display true

# Set edge trigger
lager scope ANALOG1 trigger edge --slope rising --level 1.5

# Start PicoScope streaming
lager scope PICO1 stream start --channel A --volts-per-div 2.0

# Open web visualization
lager scope PICO1 stream web

# Capture data to file
lager scope PICO1 stream capture --output waveform.csv --duration 5.0

Supported Hardware

Manufacturer	Model Series	Features
Rigol	MSO5000	Multi-channel, mixed-signal
PicoScope	Various	Streaming support

Notes

• Net names refer to names assigned when setting up your testbed
• Streaming commands are only supported for PicoScope devices
• Web visualization requires port 8080 to be accessible
• Use lager nets to see available scope nets