IoT-LAB cli-tools provide a basic set of operations for managing IoT-LAB experiments from the command-line.
IoT-LAB cli-tools, including all examples, code snippets and attached documentation is covered by the CeCILL v2.1 free software licence.
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 |
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 --helpThe 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