Device: Sensor

This device description describes a sensor device containing one or more sensors.

Sensor introduction

A sensor is a device that contains one or more sensor capabilities. These devices come in many forms. Such as single sensors, multi-sensors, or virtual ones. Many actors also contain sensors capabilities. However sensor devices do generally not contain actor capabilities.

Profile name

The profile for this device is homie-sensor/1/0. It is located in the device description JSON document in the device level $profile attribute, and the $profile topic.

Examples

Description:

{
  "homie": "5.0",
  "name": "Living sensor",
  "version": 3,
  "$profile": ["homie-sensor/1/0"],
  "nodes": {

    "presence": {
      "$profile": ["homie-sensor-presence/1/0"],
      ...
    },
    "temperature": {
      "$profile": ["homie-sensor-temperature/1/0"],
      ...
    },
    "light": {
      "$profile": ["homie-sensor-light/1/0"],
      ...
    }

  }
}

Topics:

homie/5/multi-sensor/$profile/homie-sensor/1 → "0"

Nodes

This device-profile MUST implement at least one of the following capability-profiles:

Preferred Node-ID	Capability-Profile	required	additional requirements
power-switch	homie-sensor-power-switch/1/0	no	no
contact	homie-sensor-contact/1/0	no	no
valve	homie-sensor-valve/1/0	no	no
presence	homie-sensor-presence/1/0	no	no
temperature	homie-sensor-temperature	no	no
volume	homie-sensor-volume	no	no
volt	homie-sensor-volt	no	no
current	homie-sensor-current	no	no
power	homie-sensor-power	no	no
energy	homie-sensor-energy	no	no
frequency	homie-sensor-frequency	no	no
battery	homie-sensor-battery	no	no
distance	homie-sensor-distance	no	no
speed	homie-sensor-speed	no	no
pressure	homie-sensor-pressure	no	no
light	homie-sensor-light	no	no
gas-co	homie-sensor-gas-co	no	no
gas-co2	homie-sensor-gas-co2	no	no
gas-ch4	homie-sensor-gas-ch4	no	no
gas-voc	homie-sensor-gas-voc	no	no
humidity	homie-sensor-humidity	no	no

Additional nodes MAY be added to the device.