Nets

lager nets [OPTIONS] [COMMAND]

lager nets --box my-lager-box

    Name      Net Type      Channel
========================================
LabJack T7 [USB0::0x0CD5::0x0007::::INSTR]
├── adc1      adc           AIN0
└── gpio1     gpio          FIO0

Rigol DP811 [USB0::0x1AB1::0x0E11::DP8B123456::INSTR]
└── supply1   power-supply  1

SiLabs CP210x [USB0::0x10C4::0xEA60::0001::INSTR]
└── uart1     uart          /dev/ttyUSB0

lager nets add NAME ROLE CHANNEL ADDRESS [OPTIONS]

# Create a power supply net
lager nets add supply1 power-supply 1 TCPIP::192.168.1.100::INSTR --box my-lager-box

# Create a debug net for STM32
lager nets add debug1 debug STM32F407VG USB::001::002 --box my-lager-box

# Create a debug net with J-Link script
lager nets add debug1 debug STM32F407VG USB::001::002 --jlink-script ./my_device.JLinkScript --box my-lager-box

# Create an ADC net on a LabJack T7
lager nets add temp_sensor adc AIN0 USB0::0x0CD5::0x0007::::INSTR --box my-lager-box

# Create an I2C net on a LabJack T7 (default pins: SDA=FIO4, SCL=FIO5)
lager nets add i2c_bus i2c FIO4-FIO5 USB0::0x0CD5::0x0007::::INSTR --box my-lager-box

# Create an I2C net on a LabJack T7 with custom pins
lager nets add i2c_bus i2c custom USB0::0x0CD5::0x0007::::INSTR --sda EIO0 --scl EIO1 --box my-lager-box

# Create an I2C net on a LabJack U3 (default pins: SDA=FIO6, SCL=FIO7)
lager nets add u3_i2c i2c FIO6-FIO7 USB0::0x0CD5::0x0003::::INSTR --box my-lager-box

# Create an I2C net on Aardvark
lager nets add i2c_aardvark i2c I2C0 USB0::0x0403::0xE0D0::2238595116::INSTR --box my-lager-box

# Create an SPI net on a LabJack T7 (default pins: CS=FIO0, SCK=FIO1, MOSI=FIO2, MISO=FIO3)
lager nets add spi_bus spi FIO0-FIO3 USB0::0x0CD5::0x0007::::INSTR --box my-lager-box

# Create an SPI net on a LabJack T7 with custom pins
lager nets add spi_flash spi custom USB0::0x0CD5::0x0007::::INSTR --cs FIO6 --sck FIO7 --mosi EIO0 --miso EIO1 --box my-lager-box

# Custom-pin SPI without chip select (3-pin SPI, manual CS via gpio)
lager nets add spi_flash spi custom USB0::0x0CD5::0x0007::::INSTR --sck FIO7 --mosi EIO0 --miso EIO1 --box my-lager-box

# Create an SPI net on a LabJack U3 (default pins: CS=FIO4, SCK=FIO5, MISO=FIO6, MOSI=FIO7)
lager nets add u3_spi spi FIO4-FIO7 USB0::0x0CD5::0x0003::::INSTR --box my-lager-box

# Create an SPI net on Aardvark
lager nets add spi_aardvark spi SPI0 USB0::0x0403::0xE0D0::2238595116::INSTR --box my-lager-box

# Create a UART net
lager nets add serial1 uart 0 /dev/ttyUSB0 --box my-lager-box

The channel 'FIO0' is not valid for role 'gpio' on the instrument at USB0::0x0CD5::0x0003::::INSTR.
Valid gpio channels for LabJack_U3: FIO4, FIO5, FIO6, FIO7, EIO0, EIO1, EIO2, EIO3, EIO4, EIO5, EIO6, EIO7, CIO0, CIO1, CIO2, CIO3
FIO0-FIO3 on a LabJack U3 are fixed high-voltage analog inputs and are never digital I/O. Read them with an adc net on AIN0-AIN3, the same physical pins.

Keithley_2281S at <ADDRESS> already has a battery net. This instrument is a single output that fills one role at a time — the driver switches its mode automatically when you drive the other net, ending whatever the previous mode was doing. Add the second net only if you intend to use both roles.

# Channel A (interface 0) — by far the most common
lager nets add debug_a debug STM32F4x@A USB0::0x0403::0x6010::ABCDEF::INSTR

# Channel B (interface 1) — second target on the same FT2232H
lager nets add debug_b debug NRF52840_XXAA@B USB0::0x0403::0x6010::ABCDEF::INSTR

# I2C on channel B of an FT4232H
lager nets add sensors i2c I2C0 USB0::0x0403::0x6011::ABCDEF::INSTR --interface B
# A reset line on channel C, which has no MPSSE engine
lager nets add reset_line gpio 5 USB0::0x0403::0x6011::ABCDEF::INSTR --interface C

Error: LabJack_T7 at USB0::0x0CD5::0x0007::::INSTR: more than one device reports this address, so a net could not say which one it means. This model exposes no unique serial number. Use only one at a time, or drive them from separate boxes.

lager nets add-all [OPTIONS]

# Preview what nets would be created
lager nets add-all --box my-lager-box

# Create all nets without prompting
lager nets add-all --box my-lager-box --yes

Found 7 nets that can be created:
  - supply1 (power-supply) on Rigol_DP811 channel 1
  - adc1 (adc) on LabJack_T7 channel AIN0
  - adc2 (adc) on LabJack_T7 channel AIN1
  - gpio1 (gpio) on LabJack_T7 channel FIO0
  - i2c1 (i2c) on LabJack_T7 channel FIO4-FIO5
  - spi1 (spi) on LabJack_T7 channel FIO0-FIO3
  - debug1 (debug) on J-Link channel STM32F4

Create all 7 nets on box <BOX_IP>? [y/N]:

lager nets add-batch JSON_FILE [OPTIONS]

[
  {
    "name": "supply1",
    "role": "power-supply",
    "channel": "1",
    "address": "USB0::0x1AB1::0x0E11::DP8B123456::INSTR"
  },
  {
    "name": "i2c_bus",
    "role": "i2c",
    "channel": "FIO4-FIO5",
    "address": "USB0::0x0CD5::0x0007::::INSTR"
  },
  {
    "name": "spi_bus",
    "role": "spi",
    "channel": "SPI0",
    "address": "USB0::0x0403::0xE0D0::2238595116::INSTR"
  }
]

Net 2 ('i2c_bus'): channel '0' is not valid for role 'i2c' on LabJack_T7. Valid: FIO4-FIO5
No nets were saved.

lager nets add-batch nets.json --box my-lager-box

lager nets assign --list [OPTIONS]                       # discover
lager nets assign DEVICE --serial|--port [OPTIONS]       # assign
lager nets assign --remove --serial|--port [OPTIONS]     # unassign

# 1. Plug the instrument's USB-serial cable into the box, then find it:
lager nets assign --list --box my-lager-box
#   Unassigned USB-serial cables:
#     serial 00000006  port 1-1.2  [067b:23a3]  /dev/ttyUSB0

# 2. Assign the cable — and create a supply net in the same step:
lager nets assign Rigol_DP711 --serial 00000006 --as-net main_supply --box my-lager-box

# 3. Drive it like any other supply net:
lager supply main_supply voltage 3.3 --box my-lager-box

lager nets add <name> power-supply 1 'serial://067b:23a3/serial/00000006'

lager nets assign --remove --serial 00000006 --box my-lager-box

lager nets delete NAME NET_TYPE [OPTIONS]

# Delete a supply net (with confirmation)
lager nets delete supply1 supply --box my-lager-box

# Delete without confirmation
lager nets delete temp_sensor adc --box my-lager-box --yes

# Delete an I2C net
lager nets delete i2c_bus i2c --box my-lager-box --yes

lager nets delete-all [OPTIONS]

# Delete all nets (requires confirmation)
lager nets delete-all --box my-lager-box

# Delete all nets without prompting
lager nets delete-all --box my-lager-box --yes

lager nets rename NAME NEW_NAME [OPTIONS]

lager nets rename supply1 main_power --box my-lager-box

lager nets tui [OPTIONS]

lager nets tui --box my-lager-box

lager nets set-script NAME SCRIPT_PATH [OPTIONS]

# Attach a J-Link script to a J-Link net (auto-detected)
lager nets set-script debug1 ./custom_connect.JLinkScript --box my-lager-box

# Attach an OpenOCD config to an FTDI/ST-Link/CMSIS-DAP net (auto-detected)
lager nets set-script debug1 ./probe.cfg --box my-lager-box

# Read the script from stdin
cat probe.cfg | lager nets set-script debug1 - --box my-lager-box

# Force a specific backend when the file or probe is ambiguous
lager nets set-script debug1 ./generic_script --backend openocd --box my-lager-box

lager nets remove-script NAME [OPTIONS]

# Remove whichever script is attached
lager nets remove-script debug1 --box my-lager-box

# Only remove the J-Link script (leave any OpenOCD config in place)
lager nets remove-script debug1 --backend jlink --box my-lager-box

lager nets show-script NAME [OPTIONS]

# Display the attached script (J-Link or OpenOCD)
lager nets show-script debug1 --box my-lager-box

# Save to a local file (the stderr banner doesn't end up in the file)
lager nets show-script debug1 --box my-lager-box > script.txt

lager nets show NAME [OPTIONS]

lager nets show battery1 --box my-lager-box
lager nets show battery1 --json --box my-lager-box

lager nets state [OPTIONS]

lager nets state --box my-lager-box
lager nets state --json --box my-lager-box

    Name      Net Type      Channel       State
=============================================================
Acroname 8Port [USB0::0x24FF::0x0013::EBFB0000::INSTR]
├── usb1      usb           0             –
└── usb2      usb           1             –

LabJack T7 [USB0::0x0CD5::0x0007::::INSTR]
├── adc1      adc           AIN0          1.2345V
└── gpio1     gpio          FIO0          HIGH (1)

Rigol DP811 [USB0::0x1AB1::0x0E11::DP8B123456::INSTR]
└── supply1   power-supply  1             CH1/on/3.30V/0.120A

SiLabs CP210x [USB0::0x10C4::0xEA60::0001::INSTR]
└── uart1     uart          /dev/ttyUSB0  –

Nets reporting no state:
    usb1, usb2: unreadable: <error from the hub driver>
    -> the hub is not on the USB bus at all -- unplugged, or its upstream port is off.

lager nets describe NAME [OPTIONS]

# Describe a net's purpose and add tags
lager nets describe battery1 \
  --purpose "Main battery rail powering the MCU" \
  --tag power --tag critical \
  --box my-lager-box

# Replace the existing tags
lager nets describe battery1 --clear-tags --tag power --box my-lager-box

# View what was set
lager nets show battery1 --box my-lager-box

# Attach a J-Link script to a J-Link probe (auto-detected from .JLinkScript extension)
lager nets set-script debug1 ./my_device.JLinkScript --box my-lager-box

# Attach an OpenOCD config to an FTDI / ST-Link / CMSIS-DAP probe (auto-detected)
lager nets set-script debug1 ./probe.cfg --box my-lager-box

# Verify what's attached (stderr says which backend, stdout has the content)
lager nets show-script debug1 --box my-lager-box

# Scripts are used automatically for all debug operations:
lager debug debug1 flash --hex firmware.hex --box my-lager-box
lager debug debug1 gdbserver --box my-lager-box

# Remove the script when no longer needed
lager nets remove-script debug1 --box my-lager-box

lager nets add debug1 debug STM32F407VG USB::001::002 \
  --jlink-script ./my_device.JLinkScript --box my-lager-box

lager nets add debug2 debug d2763 USB::003::004 \
  --openocd-config ./probe.cfg --box my-lager-box

{
  "DEBUG": {
    "debug1": "./scripts/my_device.JLinkScript"
  }
}

# List all nets
lager nets --box my-lager-box

# Create a new power supply net
lager nets add vdd_main power-supply 1 TCPIP::192.168.1.100::INSTR --box my-lager-box

# Create I2C and SPI bus nets
lager nets add i2c_sensors i2c FIO4-FIO5 USB0::0x0CD5::0x0007::::INSTR --box my-lager-box
lager nets add spi_flash spi SPI0 USB0::0x0403::0xE0D0::2238595116::INSTR --box my-lager-box

# Show the live state of every net
lager nets state --box my-lager-box

# Auto-create all available nets
lager nets add-all --box my-lager-box --yes

# Delete a specific net
lager nets delete old_supply supply --box my-lager-box --yes

# Rename a net
lager nets rename supply1 main_power --box my-lager-box

# Launch interactive manager
lager nets tui --box my-lager-box

# Bulk create from JSON file
lager nets add-batch testbed-nets.json --box my-lager-box

# Manage debug-probe scripts (J-Link or OpenOCD, auto-detected)
lager nets set-script debug1 ./custom_init.JLinkScript --box my-lager-box
lager nets set-script debug2 ./probe.cfg --box my-lager-box
lager nets show-script debug1 --box my-lager-box
lager nets remove-script debug1 --box my-lager-box