Skip to content
embedded systems control library for development, testing and installation
Branch: master
Clone or download
Emantor and jluebbe driver: remove InfoDriver
The InfoDriver has been integrated into the labgridhelper library.
Remove the driver from the core library, the functionality did never fit
the driver model anyway.

Signed-off-by: Rouven Czerwinski <r.czerwinski@pengutronix.de>
Latest commit 897b3a5 Mar 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.crossbar
.github github: add pull request template Jan 2, 2019
contrib/systemd/tmpfiles.d contrib: tmpfiles: fix tmpfiles directives Mar 5, 2019
debian debian: add tmpfiles.d labgrid.conf to debian package Mar 5, 2019
doc driver: remove InfoDriver Mar 25, 2019
docker
examples driver: remove InfoDriver Mar 25, 2019
labgrid driver: remove InfoDriver Mar 25, 2019
man man/labgrid-client: add write-image command Feb 26, 2019
tests util: agent: add local mode Mar 22, 2019
.codecov.yaml
.coveragerc
.flake8 flake8: add configuration Nov 19, 2017
.gitignore
.pylintrc
.travis.yml travis: remove python directive for docker Mar 8, 2019
CHANGES.rst
COPYING
LICENSE COPYING,LICENSE: move from .txt May 11, 2017
MANIFEST.in setup: use fastentrypoints to reduce the script startup time Feb 27, 2017
README.rst
crossbar-requirements.txt requirements: update autobahn and crossbar to 18.12.1 Jan 4, 2019
deb-requirements.txt
dev-requirements.txt
doc-requirements.txt doc-requirements: update sphinx to 1.8.1 Jan 4, 2019
fastentrypoints.py setup: use fastentrypoints to reduce the script startup time Feb 27, 2017
graph-requirements.txt
labgrid_logo.png add official labgrid logo Mar 20, 2019
modbus-requirements.txt modbus-requirements: update pyModbusTCP to 0.1.7 Jan 4, 2019
onewire-requirements.txt
requirements.txt
setup.cfg
setup.py
snmp-requirements.txt
tox.ini Allow use of Python3.7 features Feb 27, 2019
travis-requirements.txt travis: requirements: move travis requirements to separate file Jun 4, 2018
xena-requirements.txt driver/xenadriver: Add driver to interact with Xena network testing e… Sep 25, 2018

README.rst

labgrid logo

Welcome to labgrid

LGPLv2.1 build status coverage status documentation status chat

Purpose

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.

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:

  • pytest plugin to write tests for embedded systems connecting serial console or SSH
  • remote client-exporter-coordinator infrastructure to make boards available from different computers on a network
  • power/reset management via drivers for power switches or onewire PIOs
  • upload of binaries via USB: imxusbloader/mxsusbloader (bootloader) or fastboot (kernel)
  • functions to control external services such as emulated USB-Sticks and the hawkBit deployment service

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

Read the Docs

Contributing

Development Docs

IRC channel #labgrid on freenode (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.

Quickstart

See the Installation section for more details.

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

Install labgrid into the virtualenv:

$ pip install -r requirements.txt
$ python setup.py install

Tests can now run via:

$ python -m pytest --lg-env <config>
You can’t perform that action at this time.