Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lagerdata.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Bug Fixes

  • lager uart <net> no longer returns 404 — UART net not found. The v0.16.6 battery-handler consolidation (commit f277402) deleted the two-line UART handler registration in box/lager/box_http_server.py as collateral damage. The imports stayed in place, so the file still parsed cleanly; the /uart/nets/list Flask route just was never registered, so every UART CLI command 404’d. Restored the register_uart_routes(app) / register_uart_socketio(socketio) calls alongside the supply and battery registrations.
  • lager supply <net> state (and other one-shot supply/battery commands) no longer fail with [Errno 16] Resource busy immediately after exiting the TUI. Root cause: /supply/command and /battery/command returned 404 when no active WebSocket session was found, forcing the CLI’s _run_backend into a direct-pyvisa subprocess fallback (cli/impl/power/supply.py → dispatcher) that opened its own pyvisa session against the same USB device hardware_service.py was still caching. Both endpoints now build a transient Device proxy via resolve_net_proxy() when no active WS session exists, routing through hardware_service.py:/invoke like the WS monitor already does. There is now exactly one pyvisa session per (device_name, address) regardless of TUI lifecycle. This completes v0.16.6’s “VISA session ownership unified” promise.
  • Concurrent TUI + CLI access on the same supply no longer cascades Resource busy errors across subsequent commands. Previously, a single transient kernel-level USB-claim collision (the kind that can momentarily occur when two pyvisa-issued USB transfers overlap on the same device) would be mis-classified as a stale pyvisa session: _is_visa_session_error() matched the substring 'resource' inside 'Resource busy', the retry path then popped the live cache entry and called module.create_device() on the same address, and the new open hit Resource busy again because the original session was still alive in the same process. The result was that an isolated USB-busy error turned into a chain of failures across every following command. Removed 'resource' from _VISA_SESSION_ERROR_KEYWORDS in box/lager/hardware_service.py; retry now fires only for genuine stale-session signals ('session', 'closed', 'invalid'). An isolated USB-busy collision is still possible on heavily-contended USB transfers but is now returned to the caller cleanly without disturbing the cache, so the next command immediately succeeds.

​
Known Limitations

  • Keithley 2281S dual-role nets must be used one at a time. When the same physical Keithley 2281S has both a power-supply net (e.g. supply1) and a battery net (e.g. battery1) configured, box/lager/hardware_service.py caches them under two different keys (("keithley", address) vs ("keithley_battery", address)) and tries to open two pyvisa sessions on the same USB device — the second hits [Errno 16] Resource busy. Workaround: configure only the role you need on the Keithley 2281S, or restart the box’s lager container between switching roles. The proper fix (shared pyvisa Resource between supply and battery driver instances, or a merged dual-role driver class) is targeted for v0.16.8.
  • Concurrent battery TUI + CLI on the Keithley 2281S can surface [Errno 16] Resource busy. Running lager battery <net> tui in one terminal while running lager battery <net> state (or any other one-shot battery CLI command against the same net) in another terminal can fail with Resource busy, even when only the battery role is configured on the Keithley (so this is distinct from the dual-role limitation above). v0.16.7’s Bug-B retry-classification fix prevents this from cascading across subsequent commands but does not eliminate the initial collision; the underlying contention appears to live in the Keithley pyvisa session itself rather than in hardware_service.py’s lock. Workaround: do not invoke battery CLI commands while a battery TUI is open against the Keithley 2281S — close the TUI first, or run TUI-only or CLI-only on the Keithley battery net. Root-cause investigation tracked for v0.16.8.

​
Installation

To install this version: 
pip install lager-cli==0.16.7
To upgrade from a previous version: 
pip install --upgrade lager-cli

​
Resources

View Release on PyPI