Defaults

​

Syntax

lager defaults COMMAND [OPTIONS]

​

Commands

​

Command Reference

​

add

lager defaults add [OPTIONS]

• --box BOX - Set default Lager Box

• --supply-net NAME - Default power supply net
• --battery-net NAME - Default battery net
• --solar-net NAME - Default solar net
• --scope-net NAME - Default oscilloscope net
• --logic-net NAME - Default logic analyzer net
• --adc-net NAME - Default ADC net
• --dac-net NAME - Default DAC net
• --gpio-net NAME - Default GPIO net
• --debug-net NAME - Default debug net
• --eload-net NAME - Default electronic load net
• --usb-net NAME - Default USB hub net
• --webcam-net NAME - Default webcam net
• --watt-meter-net NAME - Default watt meter net
• --thermocouple-net NAME - Default thermocouple net
• --uart-net NAME - Default UART net
• --arm-net NAME - Default robotic arm net

• --serial-port PATH - Default serial port path
• --user TEXT - Username recorded on box locks. Another tool can record a lock under your email. To make that lock yours, set this to that email. See Box Locking. The LAGER_USER environment variable overrides this default.

# Set default Lager Box
lager defaults add --box my-lager-box

# Set default power supply net
lager defaults add --supply-net VDD_MAIN

# Set multiple defaults at once
lager defaults add --box my-lager-box --supply-net POWER --debug-net DEBUG_SWD

# Set the default username used for box locking
lager defaults add --user alice

​

list

lager defaults list

Default       Value
box           my-lager-box
serial-port   /dev/ttyUSB0
supply-net    VDD_MAIN
battery-net   VBAT
debug-net     DEBUG_SWD

​

delete

lager defaults delete SUBCOMMAND [OPTIONS]

• box - Delete default Lager Box
• serial-port - Delete default serial port
• supply-net - Delete default supply net
• battery-net - Delete default battery net
• solar-net - Delete default solar net
• scope-net - Delete default scope net
• logic-net - Delete default logic analyzer net
• adc-net - Delete default ADC net
• dac-net - Delete default DAC net
• gpio-net - Delete default GPIO net
• debug-net - Delete default debug net
• eload-net - Delete default electronic load net
• usb-net - Delete default USB hub net
• webcam-net - Delete default webcam net
• watt-meter-net - Delete default watt meter net
• thermocouple-net - Delete default thermocouple net
• uart-net - Delete default UART net
• arm-net - Delete default robotic arm net
• user - Delete default user

• --yes - Skip confirmation prompt

# Delete default Lager Box
lager defaults delete box

# Delete default supply net without confirmation
lager defaults delete supply-net --yes

# Delete default serial port
lager defaults delete serial-port

​

delete-all

lager defaults delete-all

​

How Defaults Work

# Without defaults - must specify everything
lager supply VDD_MAIN voltage 3.3 --box my-lager-box

# With defaults set
lager defaults add --box my-lager-box --supply-net VDD_MAIN

# Now you can simply run
lager supply voltage 3.3

​

Default Resolution Order

1. Command-line option (highest priority)
2. Default setting from lager defaults
3. Error if required and no default

​

Configuration Storage

{
  "DEFAULTS": {
    "gateway_id": "my-lager-box",
    "net_power_supply": "VDD_MAIN",
    "net_battery": "VBAT",
    "serial_device": "/dev/ttyUSB0",
    "user": "alice"
  }
}

​

Workflow Example

# Initial setup - set your common defaults
lager defaults add --box my-bench
lager defaults add --supply-net POWER
lager defaults add --debug-net SWD
lager defaults add --uart-net SERIAL

# Now commands are simpler
lager supply voltage 3.3          # Uses POWER net on my-bench
lager debug flash fw.hex          # Uses SWD net on my-bench
lager uart --interactive          # Uses SERIAL net on my-bench

# Override defaults when needed
lager supply OTHER_SUPPLY voltage 5.0
lager debug flash fw.hex --box other-lager-box

​

Notes

• Defaults are global to your user account (stored in ~/.lager)
• Net names must match configured nets on the Lager Box
• Box names are validated against saved boxes
• Use lager defaults list to verify current settings