Skip to main content

mrg-iot devices list

List the devices in an experiment, or the devices that are free to reserve.

Usage​

mrg-iot devices list [-p PROJECT] [-e EXPERIMENT] [-r REALIZATION] [-x XDC] [--available]

Arguments​

ArgumentDescription
--project, -pProject name. Default: your only project; required when you belong to several.
--experiment, -eExperiment name. Default: your username.
--realization, -rRealization name. Default: realiot.
--xdc, -xXDC name. Default: <experiment>xdc.
--available, -aList the devices no experiment holds yet, instead of the ones in your experiment.

Details​

Free devices: --available​

devices list --available asks the portal which devices no experiment currently holds. This is the one device command that opens no session to an experiment, so it works before you have one. It hides devices that are already allocated, including the ones your own experiment holds.

mrg-iot devices list --available printing the project and device name for each free device

If you belong to several IoT projects, pass --project to pick one (neuiot for most researchers).

Devices in your experiment​

Without --available, the command opens a session to the experiment and names the devices it is about:

mrg-iot devices list showing the devices in a running experiment

Examples​

mrg-iot devices list --available # everything free
mrg-iot devices list --available -p neuiot # one project only
mrg-iot devices list -e myexp # the devices myexp holds

See also​