labgrid/client

labgrid/client镜像文档

镜像概述

labgrid/client是Labgrid项目的客户端镜像，Labgrid是一款嵌入式板控制Python库，聚焦嵌入式系统的测试、开发与通用自动化场景。它提供远程控制层，可管理网络中多主机连接的嵌入式板，不直接作为测试框架，而是与pytest结合使用，助力嵌入式系统的自动化测试与开发效率提升。

核心功能

• pytest插件集成：支持通过串口控制台或SSH编写嵌入式系统测试用例；
• 远程控制架构：客户端-导出器-协调器基础设施，实现多计算机上嵌入式板的共享与远程控制；
• 电源管理：通过电源开关或单总线PIO驱动，完成嵌入式板的电源/复位控制；
• 二进制上传：支持USB通道（如imxusbloader/mxsusbloader引导加载器、fastboot内核）上传二进制文件；
• 外部服务对接：控制模拟USB存储设备及hawkBit部署服务等外部系统。

使用场景

• 嵌入式开发调试：远程控制嵌入式板进行代码调试、功能验证；
• 自动化测试：结合pytest编写测试用例，实现嵌入式系统的自动化测试流程；
• 批量设备管理：通过远程架构统一管理多台嵌入式板，降低运维成本。

配置说明

1. 准备配置文件：创建Labgrid环境配置文件（如env.yaml），定义嵌入式板的连接信息、资源映射等；
2. 挂载配置目录：将本地配置文件目录挂载到容器内，确保客户端能读取配置。

Docker部署示例

单容器运行

bash
docker run -v $(pwd)/labgrid_config:/config docker.xuanyuan.run/labgrid/client --lg-env /config/env.yaml

Docker Compose示例

创建docker-compose.yml：

yaml
version: '3'
services:
  labgrid-client:
    image: docker.xuanyuan.run/labgrid/client
    volumes:
      - ./labgrid_config:/config
    command: --lg-env /config/env.yaml

启动命令：

bash
docker-compose up -d