You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Alexandre Abadie 86d5c889fa switch back to dev version 7 months ago
.github/workflows gh_actions: re-add python 3.10 7 months ago
examples script: add an example that saves nodes serial port 5 years ago
iotlabcli switch back to dev version 7 months ago
tests_utils ci: use pylint + fix lint 1 year ago
utils utils/bash-completion: fix typo in script 2 years ago
.gitignore gitignore .idea 4 years ago
AUTHORS License IoT-Lab cli-tools under CeCILL v2.1 7 years ago
CHANGELOG.rst bump to version 3.2.1 and update changelog 2 years ago
COPYING License IoT-Lab cli-tools under CeCILL v2.1 7 years ago
DEV.md treewide: support python 3.7+ 7 months ago
FORMAT_OUTPUT_EXAMPLES.md fix new REST api integration (#41) 3 years ago
MANIFEST.in Updates for Pypi 5 years ago
README.rst README.rst: point badge link to github action 2 years ago
codecov.yml add codecov integration 5 years ago
iotlab iotlab command with subcommands for iotlab-* 4 years ago
iotlab-auth cli: add new iotlab* commands + update ci 5 years ago
iotlab-experiment cli: add new iotlab* commands + update ci 5 years ago
iotlab-node cli: add new iotlab* commands + update ci 5 years ago
iotlab-profile cli: add new iotlab* commands + update ci 5 years ago
iotlab-robot cli: add new iotlab* commands + update ci 5 years ago
iotlab-status add iotlab-status command 2 years ago
setup.cfg setup.cfg: enable consider-using-f-string check with pylint 7 months ago
setup.py setup: tests: remove redundant unicode string prefix 7 months ago
tox.ini treewide: support python 3.7+ 7 months ago

README.rst

IoT-Lab cli-tools

PyPI package status CI status Codecov coverage status

IoT-LAB cli-tools provide a basic set of operations for managing IoT-LAB experiments from the command-line.

License

IoT-LAB cli-tools, including all examples, code snippets and attached documentation is covered by the CeCILL v2.1 free software licence.

Commands

IoT-LAB cli-tools are available through a shared entrypoint, iotlab, Many subcommands are available:

Command Functions
iotlab auth configure account credentials
iotlab experiment start, stop, query experiments
iotlab node start, stop, reset nodes, update firmwares
iotlab profile manage nodes configurations
iotlab robot manage robot nodes
iotlab status manage informations about testbed sites, nodes and running experiments

Optional commands:

When IoT-Lab SSH CLI Tools is installed:

iotlab ssh run commands on A8 open nodes through SSH

When IoT-Lab OML plot Tools is installed:

iotlab plot traj plot robot trajectory
iotlab plot consum plot node consumption
iotlab plot radio plot node sniffer results

When IoT-Lab Aggregation Tools is installed:

iotlab serial aggregate node serial link
iotlab sniffer aggregate node sniffer link

Commands are self-documented, and usually have sub-commands which are also self-documented. Use e.g:

iotlab-node --help
iotlab-profile add --help

Description

The cli-tools leverage the IoT-LAB REST API and simply wrap calls to module iotlabcli, which is a Python client for the API.

The cli-tools come as an installable Python package and require that module setuptools be installed before tools installation can happen. Please grab the relevant python-setuptools package for your distribution.

To install cli-tools from Pypi, use pip install iotlabcli.

To install cli-tools from source, use pip install --user . or python setup.py install

Installing cli-tools automatically fetches additional dependencies as needed.

Further documentation: https://github.com/iot-lab/iot-lab/wiki/CLI-Tools