Skip to content

Emantor/labgrid

This branch is 1 commit ahead of, 2 commits behind labgrid-project/labgrid:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

4b280bd · Dec 4, 2024
Oct 21, 2024
Aug 13, 2024
Aug 13, 2024
Dec 2, 2024
Aug 13, 2024
Oct 21, 2024
Oct 30, 2024
Dec 4, 2024
Oct 8, 2024
Dec 2, 2024
Mar 4, 2021
Feb 28, 2017
Feb 26, 2021
Nov 19, 2017
Aug 13, 2024
Apr 29, 2023
Oct 16, 2024
Feb 5, 2021
May 11, 2017
May 11, 2017
Sep 30, 2024
Mar 20, 2019
Sep 15, 2021
Nov 19, 2024

Repository files navigation

labgrid logo

Welcome to labgrid

LGPLv2.1 unit tests status docker build status coverage status documentation status chat chat

Labgrid is an embedded board control python library with a focus on testing, development and general automation. It includes a remote control layer to control boards connected to other hosts.

Getting started

There is a tutorial series on the Pengutronix Youtube channel you can follow to get started: Labgrid Tutorial Playlist.

The other starting point is in the documentation.

Purpose and Features

The idea behind labgrid is to create an abstraction of the hardware control layer needed for testing of embedded systems, automatic software installation and automation during development. Labgrid itself is not a testing framework, but is intended to be combined with pytest (and additional pytest plugins). Please see Design Decisions for more background information.

It currently supports:

  • remote client-exporter-coordinator infrastructure to make boards available from different computers on a network
  • pytest plugin to write automated tests for embedded systems
  • CLI and library usage for development and automation
  • interaction with bootloader and Linux shells on top of serial console or SSH
  • power/reset management via drivers for power switches
  • upload of binaries and device bootstrapping via USB
  • control of digital outputs, SD card and USB multiplexers
  • integration of audio/video/measurement devices for remote development and testing
  • Docker/QEMU integration

While labgrid is currently used for daily development on embedded boards and for automated testing, several planned features are not yet implemented and the APIs may be changed as more use-cases appear. We appreciate code contributions and feedback on using labgrid on other environments (see Contributing for details). Please consider contacting us (via a GitHub issue) before starting larger changes, so we can discuss design trade-offs early and avoid redundant work. You can also look at Ideas for enhancements which are not yet implemented.

Documentation

labgrid's documentation is hosted on Read the Docs.

Contributing

See our Development Docs.

Visit us in our IRC channel #labgrid on libera.chat (bridged to the Matrix channel #labgrid:matrix.org)

Background

Work on labgrid started at Pengutronix in late 2016 and is currently in active use and development.

Installation

See the Installation section for more details.

Install Latest Release

Install labgrid via PyPi:

$ virtualenv -p python3 venv
$ source venv/bin/activate
venv $ pip install --upgrade pip
venv $ pip install labgrid

Install Development State

Clone the git repository:

$ git clone https://github.com/labgrid-project/labgrid

Create and activate a virtualenv for labgrid:

$ virtualenv -p python3 venv
$ source venv/bin/activate
venv $ pip install --upgrade pip

Install labgrid into the virtualenv:

venv $ pip install .

Tests can now run via:

venv $ python -m pytest --lg-env <config>

About

Resources

License

Unknown, LGPL-2.1 licenses found

Licenses found

Unknown
LICENSE
LGPL-2.1
COPYING

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 97.1%
  • Shell 2.6%
  • Dockerfile 0.3%