About properties

Properties are the Device object properties that describe capabilities. Using properties, you can report data from device properties. Properties are usually used to monitor the environment. A device may not have any properties.

Yango Smart Home doesn't restrict how providers should choose properties for devices. That's why users can have devices with a non-standard device_type:property binding. For example, a TV may have a “humidity” property.

The smart home platform has a specific list of supported properties. If the provider's response to the request of Information about user devices contains properties that are unknown, have an invalid format, or have invalid values, the device will be rejected and the user will not be able to control it.

Tip.

To check the validity of parameters and view validation errors, use the Testing section in the developer console.

Depending on the operation performed, different sets of fields are passed in the Property object:

The device property description is used in the Information about user devices operation:

{
    "type": {string},
    "retrievable": {boolean},
    "reportable": {boolean},
    "parameters": {PropertyParametersObject}
}

The status of the device property is used in the Information about the states of user devices operation:

{
    "type": {string},
    "state": {
      "instance": {string},
      "value": {InstanceValue}
    }
}

Property types


Property type	Description
`float`	Displaying device property values in numeric format.
`event`	Display of readings of device properties (properties can have one of the specified states).