Python SDK Overview

The Lager Python SDK provides a powerful, object-oriented interface for controlling hardware and automating tests on your Device Under Test (DUT). It enables programmatic control of power supplies, sensors, debug probes, and more.

Import

from lager import Net, NetType  # Convenience import for Net and NetType

Core Classes

Class	Description	Import
`binaries`	Execute custom binaries	`from lager.binaries import run_custom_binary`
`Net`	Core class for managing hardware connections	`from lager import Net, NetType`
`Central`	BLE scanning and connection	`from lager.ble import Central, Client`

Net Types

The SDK supports various net types for different hardware:

NetType	Description	Hardware
`NetType.PowerSupply`	Programmable power supply	Rigol DP800, Keithley, Keysight
`NetType.PowerSupply2Q`	Two-quadrant supply (solar sim)	EA PSI/EL series
`NetType.Battery`	Battery simulator	Keithley 2281S
`NetType.ELoad`	Electronic load	Rigol DL3000
`NetType.Analog`	Oscilloscope analog input	Rigol MSO5000
`NetType.Logic`	Logic analyzer input	Rigol MSO5000
`NetType.Waveform`	Waveform generator	Rigol MSO5000
`NetType.GPIO`	Digital I/O	LabJack T7, MCC USB-202
`NetType.ADC`	Analog-to-digital converter	LabJack T7, MCC USB-202
`NetType.DAC`	Digital-to-analog converter	LabJack T7, MCC USB-202
`NetType.Thermocouple`	Temperature sensor	Phidget
`NetType.Rotation`	Rotary encoder	Phidget
`NetType.WattMeter`	Power meter	Yocto-Watt, Joulescope JS220
`NetType.UART`	Serial communication	USB Serial
`NetType.Debug`	Debug probe	J-Link, pyOCD
`NetType.Arm`	Robotic arm	Rotrics Dexarm
`NetType.Usb`	USB port control	Acroname, YKUSH
`NetType.Wifi`	WiFi module	Lager Box WiFi
`NetType.Actuate`	Actuator control	Dexarm actuator
`NetType.SPI`	SPI bus communication	Aardvark, FT232H, LabJack T7
`NetType.I2C`	I2C bus communication	Aardvark, FT232H, LabJack T7
`NetType.EnergyAnalyzer`	Energy integration measurement	Joulescope JS220
`NetType.Webcam`	Video streaming	USB Webcam

Quick Start

List Available Nets

from lager import Net

nets = Net.list_saved()
for net in nets:
    print(f"{net['name']}: {net['role']}")

Control a Power Supply

from lager import Net, NetType

# Get the power supply net
psu = Net.get('VDD', type=NetType.PowerSupply)

# Configure and enable
psu.set_voltage(3.3)
psu.set_current(0.5)
psu.enable()

# Read measurements
print(f"Voltage: {psu.voltage()}V")
print(f"Current: {psu.current()}A")

# Disable when done
psu.disable()

Read an ADC

from lager import Net, NetType

adc = Net.get('SENSOR', type=NetType.ADC)
voltage = adc.input()
print(f"Voltage: {voltage}V")

Control GPIO

from lager import Net, NetType

# Read input
button = Net.get('BUTTON', type=NetType.GPIO)
state = button.input()

# Set output
led = Net.get('LED', type=NetType.GPIO)
led.output(1)  # HIGH
led.output(0)  # LOW

Control Debug Probe

from lager import Net, NetType

# Get the debug net
debug = Net.get('jlink1', type=NetType.Debug)

# Connect and flash firmware
debug.connect()
debug.flash('firmware.hex')
debug.reset()

Control USB Hub

from lager import Net, NetType

# Get the USB net
usb = Net.get('SENSOR_USB', type=NetType.Usb)

# Power control
usb.enable()      # Power on
usb.disable()     # Power off
usb.toggle()      # Toggle state

Complete Example

from lager import Net, NetType
import time

# 1. Flash firmware
debug = Net.get('jlink1', type=NetType.Debug)
debug.connect()
debug.flash('firmware.hex')
debug.reset()
print("Firmware flashed")

# 2. Power on USB peripheral
usb = Net.get('SENSOR_USB', type=NetType.Usb)
usb.enable()
print("USB sensor powered on")

# 3. Enable main power
main_power = Net.get("VDD_MAIN", type=NetType.PowerSupply)
main_power.set_voltage(3.3)
main_power.enable()
print("Main power enabled")

# 4. Read sensor
sensor = Net.get("TEMP_SENSE", type=NetType.ADC)
temperature = sensor.input()
print(f"Temperature: {temperature}V")

# 5. Clean up
main_power.disable()
usb.disable()
print("Test complete")

API Reference

Prefer to write your tests in Rust? The same nets are reachable from the Rust SDK, which runs against the box from cargo test rather than on the box. Every net type documented below has a Rust counterpart except scope and logic, which are not on the box’s HTTP API yet.

Core Classes

Page	Description
Custom Binaries	Execute custom binaries on the Lager Box
Net	Hardware net management and core operations
Debug	Device flashing, reset, and debug control (includes RTT)
USB	USB device power control

Power & Simulation

Page	Description
Power Supply	Programmable power supply control
Battery	Battery simulation and testing
Solar	Solar panel simulation
Electronic Load	Electronic load control
Watt Meter	Power measurement

Measurement

Page	Description
Scope	Oscilloscope waveform capture and measurements
Logic Analyzer	Digital signal capture and protocol decode
ADC	Analog-to-digital conversion
Thermocouple	Temperature measurement

I/O & Communication

Page	Description
GPIO	Digital input/output control
DAC	Digital-to-analog conversion
I2C	I2C bus communication
SPI	SPI bus communication
UART	UART net serial communication
Serial	Native pyserial support
BLE	Bluetooth Low Energy communication
WiFi	WiFi configuration

Utilities

Page	Description
Robot Arm	Robotic arm control
Webcam	Webcam streaming and video capture

Error Handling

from lager import Net, NetType, InvalidNetError

try:
    net = Net.get('INVALID_NET', NetType.Analog)
except InvalidNetError as e:
    print(f"Net not found: {e}")
except Exception as e:
    print(f"Error: {e}")

Notes

Always call disable() when finished with power-related nets
Simple nets (GPIO, ADC, DAC) don’t require enable()/disable() calls
Complex nets (PowerSupply, Battery, Analog) require enable() before use
Net names must match those configured in the Lager system
Use try/except blocks for robust error handling

Demo Script

The demo script is a more comprehensive example. It combines robot arm control, USB hub power cycling, debug probe flashing, power supply management, and ADC measurement in a single automated workflow.

Getting Started

Development

Power & Simulation

Measurement

I/O & Communication

Utilities

Python SDK Overview

Import

Core Classes

Net Types

Quick Start

List Available Nets

Control a Power Supply

Read an ADC

Control GPIO

Control Debug Probe

Control USB Hub

Complete Example

API Reference

Core Classes

Power & Simulation

Measurement

I/O & Communication

Utilities

Error Handling

Notes

Demo Script

​Import

​Core Classes

​Net Types

​Quick Start

​List Available Nets

​Control a Power Supply

​Read an ADC

​Control GPIO

​Control Debug Probe

​Control USB Hub

​Complete Example

​API Reference

​Core Classes

​Power & Simulation

​Measurement

​I/O & Communication

​Utilities

​Error Handling

​Notes

​Demo Script

Import

Core Classes

Net Types

Quick Start

List Available Nets

Control a Power Supply

Read an ADC

Control GPIO

Control Debug Probe

Control USB Hub

Complete Example

API Reference

Core Classes

Power & Simulation

Measurement

I/O & Communication

Utilities

Error Handling

Notes

Demo Script