Creates a virtual device to send data point values to the Sensaru cloud.
Requirements
The node requires homegear-cloudconnect
to be installed and fully configured.
Details
cloud-device
creates a virtual device. This device is uploaded to the Sensaru cloud with the configured
data points. Every data point update sent to one of the inputs is sent to the cloud.
Service messages
If an input has a service role set, setting this input to true
generates a service message within the
Sensaru cloud. The service message is removed, when the input is set to false
again.
In addition there is always an offline
data point and service message. Both are triggered when no input
is updated for the time specified in the property Offline timeout
.
Properties
- Description
- A short descriptive text of the device.
- Manufacturer
- The manufacturer of the device, e. g.
ABB
.
- Product name
- The name of the product, e. g.
SA/S12.16.1
.
- Serial number
- The serial number of the device.
- Hardware version
- The hardware version of the device.
- Software version
- The software/firmware version of the device.
- Equipment ID
- An ID to identify individual devices, e. g. the AKS code.
- Tags
- A comma seperated list of tags. Tags specify what a device is used for. E. g.
elevator
to identify
a power meter used for the elevator.
- Location
- If the device's location is different (hierarchically lower) than
the location of the gateway, it can be specified here. The location must start with the location
specified in the client certificate of
homegear-cloudconnect
. If the gateway is located
within the economic unit and the location in the certificate is 89:27842
. Then to place the
data point in building 03
, set Location
to 89:27842.03
.
- Section
- The frontend section to place the device in.
- Offline timeout
- After this time an offline service message is generated.
- Metadata
- A JSON object that is passed as is to the Sensaru cloud.
- Data points
- The list of data points of the device. Every data point has the following properties:
ID
- The ID of the data point. It has to be unique per node.
Type
- The data type of the data point.
Role
- The role of the data point. One of Role
or Service role
must be set. The list of roles can be found here.
Service role
- The service role (a role between 800000
and 899999
)
of the data point. One of Role
and Service role
must be set.
Location
- If the data point's location is different (hierarchically lower) than
the location of the gateway, it can be specified here. The location must start with the location
specified in the client certificate of homegear-cloudconnect
. If the gateway is located
within the economic unit and the location in the certificate is 89:27842
. Then to place the
data point in building 03
, set Location
to 89:27842.03
. This
setting is independent of the device's location setting.
Unit
- The unit of the data point, e. g. m³
.
Unit code
- The BACnet unit code. The unit code is mandatory if there is one. A complete
list can be found here.
Priority
- Only relevant when Service role
is set. In this case this is the
priority of the generated service message.