labgrid-plugins

---

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:

• Getting Started
• User Guide -- drivers, strategies, CLI, MCP, coordinator
• API Reference
• Exporter Deployment
• NetBox Onboarding
• Running Coordinator Tests

License

Apache License 2.0