Devices¶
In the ZDM a device is a peripheral that can execute Zerynth bytecode. In order to do so a device must be prepared and customized with certain attributes. The main attributes of a device are:
uid
a unique id provided by the ZDM with the device creation commandname
a name given by the user to the device in order to identify it
- The first step to connect your device to the ZDM, once you are logged, is the device creation.
- Then you have to type the provision command
There also are commands to list your devices, to get a single device info, update a device
List of device commands:
The list of supported devices is available here
Device creation¶
To connect your device to the ZDM you must first create a new device on ZDM, to obtain a new device uid. The creation command is:
zdm device create name
where name
is the name that you want to give to your new device
If you create your device using this command, it will be associated to your default fleet inside your default workspace. If you want, you can choose to associate the device to another fleet with the optional argument:
--fleet-id uid
If you want to associate the device to another fleet, see the update command
Device provisioning¶
To create a set of device credentials an existent device uid is needed.
The provisioning command is:
zdm device provision device_id --credentials ctype --endpoint_mode etype --output dest-folder
where device_id
is the device uid, ctype
is the credentials type (chosen from device_token
or cloud_token
), etype
is the endpoint security mode (choosen from secure
or insecure
), and dest-folder
is the path where to save the credential file (named zdevice.json
).
All options are not mandatory and if not given a default value is assigned:
device_token
forctype
secure
foretype
- current directory for
dest-folder
List devices¶
If you want to list all your devices, you can use this command to see a table with a device for each rows with the device uid, name and the uid of the fleet and workspace containing them. To see all your devices use the command:
zdm device all
Get device¶
To get a single device information, you can use this command to see the device name and the uid of the fleet and the workspace that contain the device.
zdm device get uid
where uid
is the device uid.
Update a device¶
Once you’ve created a device, you can use this command to update the device name, or to change the fleet uid. To update a device you just need its uid as argument, then you can use optional arguments to update its name or fleet uid. Use the command:
zdm device update uid
And the optional arguments are:
--fleet-id uid
the uid of the fleet you want to associate the device to--name name
the name you want to give to the device