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. Use the same name as other tools that lock boxes, such as a control plane’s display name. A lock taken from either side is then recognized by both.

# 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

Current defaults:
  box: my-lager-box
  supply-net: VDD_MAIN
  battery-net: VBAT
  debug-net: DEBUG_SWD
  serial-port: /dev/ttyUSB0

​

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

[LAGER]
default_lager_box = my-lager-box
default_supply_net = VDD_MAIN
default_battery_net = VBAT
default_serial_port = /dev/ttyUSB0

​

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 per-project (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