Device
A Device is a virtual representation of a physical or virtual IoT device.
Each Device has a unique identifier in the system. It becomes able to communicate with the platform as soon as it is provisioned on a Channel.
Devices communicate with the Cloud through:
- Telemetry: data sent from the Device to Kamea
- Configuration data: bidirectional payloads used to send and retrieve various information
Device details
- Unique identifier : a unique platform identifier that can be shared with end users as a QR Code to allow a unique identification of it
- Name: a readable name, mandatory and unique across the platform
- Serial Number: an optional free field allowing end users to associate an existing serial number to the Device
- GPS position: an optional field for store the device's position
- Description: A free optional text field allowing end users to add extra description or comments on the Device
- Folder: a dedicated Folder on the Tenant that can be used to organize the Devices
- Tags: a set of Device Tags used to classify or mark devices
- Channel configurations: collection of Channels on which the device is configured to communicate, along with the configuration for each provisioning
- Metadata: A set of additional information configurable by end users
Device Features
| Feature | State |
|---|---|
| List Devices by Tenant | Available |
| List Devices by Folder | Available |
| List Devices by Device Tag | Available |
| Create a new Device | Available |
| Update a Device's details | Available |
| Delete a Device | Available |
| Change a Device's Folder | Available |
| Change a Device's Tenant | Available |
List Devices by Tenant
Permission
- read.device
Feature
- a User can read all the devices on a tenant, from any Folder
List Devices by Folder
Permission
- read.device
Feature
- a User can filter the devices by Folder
List Devices by Device Tag
Permission
- read.device
Feature
- a User can filter the devices by Device Tag
Create a new Device
Permission
- create.device
Feature
- a User can create new Devices
Update a Device's details
Permission
- update.device
Feature
- a User can update a Device's information
Delete a Device
Permission
- delete.device
Feature
- a User can delete a Device
- this also deprovisions the device
Change a Device's Folder
Permission
- move folder.device on current and target folder
Feature
- a User can change a Device's Folder, as long as it remains in the same Tenant
Change a Device's Tenant
Permission
- transfer tenant.device on current and target tenant or folder
Feature
- a User can transfer a Device from a Tenant to another
- the Device gets a new Folder and Device tags assigned
- the transfer can be configured to include or ignore custom Events
- telemetry cannot be transferred to the new Tenant