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
`Step`	Factory test step base class	`from lager.factory import Step, run`
`PersistentCache`	Data persistence between test runs	`from lager.cache import PersistentCache`
`binaries`	Execute custom binaries	`from lager.binaries import run_custom_binary`
`Net`	Core class for managing hardware connections	`from lager import Net, NetType`
`debug`	Device debug and flash operations	`from lager.debug import connect_jlink`
`RTT`	Real-Time Terminal communication	`from lager.core import RTT`
`usb_hub`	USB device power control	`from lager.usb_hub import enable, disable, toggle`
`Dexarm`	Robotic arm control	`from lager.arm.rotrics import Dexarm`
`Central`	BLE scanning and connection	`from lager.ble import Central, Client`
`BlufiClient`	ESP32 WiFi provisioning	`from lager.blufi import BlufiClient`

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
`NetType.ADC`	Analog-to-digital converter	LabJack T7
`NetType.DAC`	Digital-to-analog converter	LabJack T7
`NetType.Thermocouple`	Temperature sensor	Phidget
`NetType.Rotation`	Rotary encoder	Phidget
`NetType.WattMeter`	Power meter	Yocto-Watt
`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

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

Flash Firmware

from lager.debug import connect_jlink, flash_device, reset_device, disconnect

# Connect to target
connect_jlink(speed='4000', device='NRF52840_XXAA', transport='SWD')

# Flash firmware
for line in flash_device(files=(['firmware.hex'], [], []), mcu='NRF52840_XXAA'):
    print(line)

# Reset and run
for line in reset_device(halt=False):
    print(line)

# Disconnect
disconnect()

USB Power Control

from lager.usb_hub import enable, disable, toggle

# Power on/off USB ports by net name
enable('CAMERA_USB')   # Power on
disable('CAMERA_USB')  # Power off
toggle('SENSOR_USB')   # Toggle state

Complete Example

from lager import Net, NetType
from lager.debug import connect_jlink, flash_device, reset_device, disconnect
from lager.usb_hub import enable as usb_enable, disable as usb_disable
import time

# 1. Flash firmware
connect_jlink(speed='4000', device='NRF52840_XXAA', transport='SWD')
for line in flash_device(files=(['firmware.hex'], [], []), mcu='NRF52840_XXAA'):
    print(line)
for line in reset_device(halt=False):
    print(line)
disconnect()
print("Firmware flashed")

# 2. Power on USB peripheral
usb_enable('SENSOR_USB')
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('SENSOR_USB')
print("Test complete")

API Reference

Core Classes

Page	Description
Factory Test Framework	Step-based production test sequences
Persistent Cache	Data persistence between test runs
Custom Binaries	Execute custom binaries on the Lager Box
Net	Hardware net management and core operations
Debug	Device flashing, reset, and debug control
RTT	Real-Time Terminal communication
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
CAN Bus	Controller Area Network communication
UART	UART net serial communication
Serial	Native pyserial support
BLE	Bluetooth Low Energy communication
BluFi	ESP32 WiFi provisioning over BLE
WiFi	WiFi configuration

Utilities

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

Error Handling

from lager import Net, NetType
from lager.pcb.net import 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

Getting Started

Development

Power & Simulation

Measurement

I/O & Communication

Utilities

Import

Core Classes

Net Types

Quick Start

List Available Nets

Control a Power Supply

Read an ADC

Control GPIO

Flash Firmware

USB Power Control

Complete Example

API Reference

Core Classes

Power & Simulation

Measurement

I/O & Communication

Utilities

Error Handling

Notes

Getting Started

Development

Power & Simulation

Measurement

I/O & Communication

Utilities

​Import

​Core Classes

​Net Types

​Quick Start

​List Available Nets

​Control a Power Supply

​Read an ADC

​Control GPIO

​Flash Firmware

​USB Power Control

​Complete Example

​API Reference

​Core Classes

​Power & Simulation

​Measurement

​I/O & Communication

​Utilities

​Error Handling

​Notes

Import

Core Classes

Net Types

Quick Start

List Available Nets

Control a Power Supply

Read an ADC

Control GPIO

Flash Firmware

USB Power Control

Complete Example

API Reference

Core Classes

Power & Simulation

Measurement

I/O & Communication

Utilities

Error Handling

Notes