Skip to Content
🚀 We just launched! Please star us on Github!

Sensor Device

Device Category: sensor

The Sensor device represents a versatile monitoring unit capable of tracking various environmental and safety parameters.


Required Channels

These channels are mandatory for the functionality of the sensor device:

ChannelDescriptionMultipleDetails
device_informationProvides metadata about the device, such as manufacturer, model, and firmware.NoSee details

Optional Channels

These channels are optional and provide additional features:

ChannelDescriptionMultipleDetails
air_particulateMonitors air quality by tracking particulate matter levels.NoSee details
batteryMonitors the battery level and status of the sensor.NoSee details
carbon_dioxideTracks carbon dioxide levels in the environment.NoSee details
carbon_monoxideTracks carbon monoxide levels in the environment.NoSee details
contactDetects the state of physical contact (e.g., open or closed).NoSee details
humidityMonitors the ambient humidity level.NoSee details
illuminanceMeasures the intensity of light in the environment.NoSee details
leakDetects the presence of water or other liquid leaks.NoSee details
motionDetects motion within the sensor’s range.NoSee details
nitrogen_dioxideTracks levels of nitrogen dioxide in the air.NoSee details
occupancyDetects whether a space is occupied.NoSee details
ozoneMonitors ozone levels in the environment.NoSee details
pressureTracks air or fluid pressure.NoSee details
smokeDetects the presence of smoke in the environment.NoSee details
sulphur_dioxideTracks levels of sulphur dioxide in the air.NoSee details
temperatureMonitors the current ambient temperature.NoSee details
volatile_prganic_compoundsTracks the presence of volatile organic compounds in the air.NoSee details

Use Case Scenarios

  1. Environmental Monitoring:

    • Use channels like temperature, humidity, and airParticulate to monitor environmental conditions.
  2. Safety Applications:

    • Track smoke, carbon monoxide, and carbon dioxide levels using their respective channels.
    • Detect leaks with the leak channel for enhanced safety.
  3. Occupancy and Motion Detection:

    • Utilize the motion and occupancy channels for presence detection in smart environments.
  4. Energy Efficiency:

    • Monitor the battery status of wireless sensors using the battery channel.
  5. Advanced Monitoring:

    • Track less common parameters like nitrogenDioxide, ozone, and volatileOrganicCompounds for specialized use cases.

Developer Notes

  1. Channel Implementation:

    • Include the device_information channel for proper device identification.
    • Optional channels should be added based on the sensor’s capabilities and intended use case.
  2. Integration:

    • Ensure the mapping of sensor channels to their respective functionalities.
    • Use optional channels like smoke, motion, or leak for specific applications.
  3. Extensibility:

    • The wide range of optional channels allows this device type to cover diverse use cases, from environmental monitoring to safety applications.
Last updated on