devices.types.sensor

A device that transmits data from properties.

Examples of devices

Temperature sensor, humidity sensor, door opening sensor, motion sensor.

Device control phrases

Each device type has a specific set of phrases. The user can control the device using these phrases without specifying the device name.

Phrases:

Yasmina, what's the temperature in the kitchen?
Yasmina, what's the carbon dioxide level in the bedroom?
Yasmina, what's the humidity in the nursery?

Where can I find all voice commands?

To open the full list of voice commands:

Open the Yango Play app.
Select the desired device in the list of devices.
Go to the Device section at the bottom of the page.
Tap Device.

Recommended capabilities

Any available capabilities describing the device features.

Recommended properties for devices

The table of properties is based on popular device functions in a given category. It provides general recommendations for describing devices. Yango Smart Home does not restrict the provider to the specified list. You can combine properties and devices as you wish based on your awareness of the device features.


Property type	Instances
devices.properties.event	Function: `battery_level`.
	Function: `button`.
	Function: `gas`.
	Function: `motion`.
	Function: `open`.
	Function: `smoke`.
	Function: `vibration`.
	Function: `water_level`.
	Function: `water_leak`.
devices.properties.float	Function: `battery_level`.
	Function: `co2_level`.
	Function: `humidity`.
	Function: `illumination`.
	Function: `pm1_density`.
	Function: `pm2.5_density`.
	Function: `pm10_density`.
	Function: `pressure`.
	Function: `temperature`.
	Function: `tvoc`.
	Function: `water_level`.


Property type	Instances
devices.properties.event	Function: `battery_level`.
	Function: `button`.
	Function: `gas`.
	Function: `motion`.
	Function: `open`.
	Function: `smoke`.
	Function: `vibration`.
	Function: `water_level`.
	Function: `water_leak`.
devices.properties.float	Function: `battery_level`.
	Function: `co2_level`.
	Function: `humidity`.
	Function: `illumination`.
	Function: `pm1_density`.
	Function: `pm2.5_density`.
	Function: `pm10_density`.
	Function: `pressure`.
	Function: `temperature`.
	Function: `tvoc`.
	Function: `water_level`.

Examples of capability and property descriptions

These structures are sent in response to the device list request.

Home weather station with temperature and humidity properties

{
 "capabilities": [],
 "properties": [{
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "temperature",
   "unit": "unit.temperature.celsius"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "humidity",
   "unit": "unit.percent"
  }
 }]
}

Door/window opening sensor

{
 "capabilities": [],
 "properties": [{
  "type": "devices.properties.event",
  "retrievable": true,
  "reportable": true,
  "parameters": {
   "instance": "open",
   "events": [{
     "value": "opened"
    },
    {
     "value": "closed"
    }
   ]
  }
 }]
}

Air quality station

{
 "capabilities": [],
 "properties": [{
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "tvoc",
   "unit": "unit.density.mcg_m3"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "pm1_density",
   "unit": "unit.density.mcg_m3"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "pm2.5_density",
   "unit": "unit.density.mcg_m3"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "pm10_density",
   "unit": "unit.density.mcg_m3"
  }
 }, {
  "type": "devices.properties.float",
  "retrievable": true,
  "parameters": {
   "instance": "co2_level",
   "unit": "unit.ppm"
  }
 }]
}