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:
uida unique id provided by the ZDM with the device creation command
namea 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
List of device commands:
The list of supported devices is available here
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
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:
If you want to associate the device to another fleet, see the update command
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
device_id is the device uid,
ctype is the credentials type (chosen from
etype is the endpoint security mode (choosen from
dest-folder is the path where to save the credential file (named
All options are not mandatory and if not given a default value is assigned:
- current directory for
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
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
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 uidthe uid of the fleet you want to associate the device to
--name namethe name you want to give to the device