Skip to main content
Control logic analyzer Nets through the Lager CLI for digital signal capture, protocol decoding, and trigger configuration.

Syntax

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

Global Options

OptionDescription
--box BOXLagerbox name or IP address
--helpShow help message and exit

Commands

CommandDescription
enableEnable logic analyzer channel
disableDisable logic analyzer channel
startStart waveform capture
start-singleStart single waveform capture
stopStop waveform capture
measureMeasure signal characteristics
triggerConfigure trigger settings
cursorControl cursor position

Command Reference

enable

Enable logic analyzer channel for the specified net.
lager logic NET_NAME enable [--box BOX] [--mcu MCU]

disable

Disable logic analyzer channel.
lager logic NET_NAME disable [--box BOX] [--mcu MCU]

start

Start continuous waveform capture.
lager logic NET_NAME start [--box BOX] [--mcu MCU]

start-single

Start single waveform capture (one-shot).
lager logic NET_NAME start-single [--box BOX] [--mcu MCU]

stop

Stop waveform capture.
lager logic NET_NAME stop [--box BOX] [--mcu MCU]

Measure Subcommands

measure period

Measure signal period.
lager logic NET_NAME measure period [--display BOOL] [--cursor BOOL]

measure freq

Measure signal frequency.
lager logic NET_NAME measure freq [--display BOOL] [--cursor BOOL]

measure dc-pos / measure dc-neg

Measure positive or negative duty cycle.
lager logic NET_NAME measure dc-pos [--display BOOL] [--cursor BOOL]
lager logic NET_NAME measure dc-neg [--display BOOL] [--cursor BOOL]

measure pw-pos / measure pw-neg

Measure positive or negative pulse width.
lager logic NET_NAME measure pw-pos [--display BOOL] [--cursor BOOL]
lager logic NET_NAME measure pw-neg [--display BOOL] [--cursor BOOL]

Trigger Subcommands

trigger edge

Set edge trigger configuration.
lager logic 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

trigger pulse

Set pulse trigger configuration.
lager logic NET_NAME trigger pulse [OPTIONS]
Options:
  • --mode - Trigger mode
  • --coupling - Coupling mode
  • --source NET - Trigger source
  • --level FLOAT - Trigger level
  • --trigger-on - Trigger on: gt, lt, gtlt
  • --upper FLOAT - Upper pulse width
  • --lower FLOAT - Lower pulse width

trigger i2c

Set I2C protocol trigger.
lager logic NET_NAME trigger i2c [OPTIONS]
Options:
  • --mode - Trigger mode
  • --coupling - Coupling mode
  • --source-scl NET - SCL trigger source
  • --source-sda NET - SDA trigger source
  • --level-scl FLOAT - SCL trigger level
  • --level-sda FLOAT - SDA trigger level
  • --trigger-on - Trigger on: start, restart, stop, nack, address, data, addr_data
  • --address INT - Address value (for address trigger)
  • --addr-width - Address width: 7, 8, 9, 10 bits
  • --data INT - Data value (for data trigger)
  • --data-width - Data width: 1-5 bytes
  • --direction - Direction: write, read, rw

trigger uart

Set UART protocol trigger.
lager logic NET_NAME trigger uart [OPTIONS]
Options:
  • --mode - Trigger mode
  • --coupling - Coupling mode
  • --source NET - Trigger source
  • --level FLOAT - Trigger level
  • --trigger-on - Trigger on: start, error, cerror, data
  • --parity - Parity: even, odd, none
  • --stop-bits - Stop bits: 1, 1.5, 2
  • --baud INT - Baud rate
  • --data-width INT - Data width in bits
  • --data INT - Data value to trigger on

trigger spi

Set SPI protocol trigger.
lager logic NET_NAME trigger spi [OPTIONS]
Options:
  • --mode - Trigger mode
  • --coupling - Coupling mode
  • --source-mosi-miso NET - MOSI/MISO source
  • --source-sck NET - SCK source
  • --source-cs NET - CS source
  • --level-mosi-miso FLOAT - MOSI/MISO level
  • --level-sck FLOAT - SCK level
  • --level-cs FLOAT - CS level
  • --data INT - Trigger data value
  • --data-width INT - Data width in bits
  • --clk-slope - Clock slope: positive, negative
  • --trigger-on - Trigger on: timeout, cs
  • --cs-idle - CS idle state: high, low
  • --timeout FLOAT - Timeout length

Cursor Subcommands

cursor set-a / cursor set-b

Set cursor A or B position.
lager logic NET_NAME cursor set-a [--x FLOAT] [--y FLOAT]
lager logic NET_NAME cursor set-b [--x FLOAT] [--y FLOAT]

cursor move-a / cursor move-b

Shift cursor position.
lager logic NET_NAME cursor move-a [--del-x FLOAT] [--del-y FLOAT]
lager logic NET_NAME cursor move-b [--del-x FLOAT] [--del-y FLOAT]

cursor hide

Hide the cursor.
lager logic NET_NAME cursor hide

Examples

# Enable logic channel
lager logic SPI_CLK enable --box my-lager-box

# Start capture
lager logic SPI_CLK start

# Measure frequency
lager logic SPI_CLK measure freq

# Set edge trigger on rising edge at 1.5V
lager logic SPI_CLK trigger edge --slope rising --level 1.5

# Set I2C trigger on address match
lager logic I2C_SDA trigger i2c --trigger-on address --address 0x50 --direction write

# Set UART trigger on data match
lager logic UART_TX trigger uart --trigger-on data --baud 115200 --data 0x55

# Set SPI trigger
lager logic SPI_MOSI trigger spi --data 0xFF --data-width 8

Supported Hardware

ManufacturerModel SeriesFeatures
RigolMSO5000Mixed-signal, protocol decode
SaleaeLogic ProHigh-speed capture

Notes

  • Logic nets capture digital signals (high/low states)
  • Protocol triggers (I2C, UART, SPI) require proper level configuration
  • Use lager nets to see available logic nets
  • Analog and Logic nets can be combined for mixed-signal analysis