labgrid-plugins is a labgrid plugin package providing Analog Devices specific drivers, resources, and strategies for automated hardware testing and device control of FPGA SoC systems.
Features
- Power Control -- VeSync, TP-Link Kasa, and Home Assistant outlets; APC and CyberPower PDUs
- Shell Access -- XMODEM file transfer over serial console
- Boot Strategies -- FPGA SoC (SD-mux, SSH, TFTP), Fabric, SelMap, openFPGALoader, VPK180, ZynqMP and Zynq-7000 JTAG recovery, no-os JTAG, Tick runtime deploy, and Raspberry Pi workflows
- FPGA Programming -- Xilinx
xsdb and openFPGALoader JTAG programming, run on the exporter next to the probe
- Mass Storage -- SD card file management and full-image writes via USB SD-Mux
- Kuiper / Cloudsmith -- Download ADI Kuiper releases and Cloudsmith boot artifacts
- Hardware CI -- Reusable GitHub Actions workflows that request boards by part, plus a daily lab boot-smoke and Prism result upload
- Lab Onboarding --
adi-lg netbox add-hardware registers a board in NetBox, deploys its exporter, and creates its place; adi-lg setup-runner sets up self-hosted runners
- MCP Server -- FastMCP interface for LLM-driven hardware control with coordinator support
- Coordinator -- Docker-based labgrid coordinator with REST API, authentication, node-deployment tracking, and a React web dashboard
Quick Start
Install
pip install git+https://github.com/tfcollins/labgrid-plugins.git
Or for development:
git clone https://github.com/tfcollins/labgrid-plugins.git
cd labgrid-plugins
pip install -e ".[dev]"
Control a VeSync Outlet
# target.yaml
imports:
- adi_lg_plugins # registers the ADI drivers/resources/strategies with labgrid
targets:
my_device:
resources:
VesyncOutlet:
outlet_names: "Device Power"
username: "[email protected]"
password: "password"
drivers:
VesyncPowerDriver: {}
from labgrid import Environment
env = Environment("target.yaml")
target = env.get_target("my_device")
power = target.get_driver("VesyncPowerDriver")
power.on()
power.off()
Start the Coordinator
cd coordinator
docker compose up -d
This starts the labgrid coordinator (:20408), REST API (:8000), and web dashboard (:3000).
Run the MCP Server
adi-lg-mcp
Set LG_COORDINATOR to enable remote hardware discovery:
export LG_COORDINATOR=10.0.0.41:20408
adi-lg-mcp
Documentation
Full documentation is available at labgrid-plugins.readthedocs.io.
Key sections:
License
Apache License 2.0
