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

Air Conditioner Device

Device Category: air_conditioner

The Air Conditioner device represents a cooling system with additional features for environmental monitoring and energy management.


Required Channels

These channels are mandatory for the functionality of the air conditioner:

ChannelDescriptionMultipleDetails
coolerControls devices that lower air or liquid temperatures, such as air conditioners or refrigeration systems.NoSee details
fanControls fan devices, including speed, oscillation, and modes for air circulation.NoSee details
temperatureMeasures the current temperature in an environment, reported in degrees Celsius.NoSee details
device_informationProvides metadata about the device, including manufacturer details, model information, and operational statuses.NoSee details

Optional Channels

These channels are optional and provide additional features:

ChannelDescriptionMultipleDetails
electrical_energyMeasures the total energy consumption over time, typically reported in kilowatt-hours (kWh).NoSee details
electrical_powerReports real-time power metrics such as voltage, current, and wattage for monitoring and diagnostics.NoSee details
heaterManages heating devices, allowing control of temperature settings and modes.NoSee details
humidityMeasures the relative humidity in the environment, reported as a percentage.NoSee details
contactTracks the open or closed state of a contact point, such as a door, window, or cabinet.NoSee details
leakIdentifies the presence of water or other liquids to detect leaks and prevent damage.NoSee details
filterMonitors the filter status and remaining life, with option to reset after replacement.NoSee details

Use Case Scenarios

  1. Cooling and Fan Control:

    • Set a target temperature using the cooler and temperature channels. Adjust fan speed and direction via the fan channel.
  2. Environmental Monitoring:

    • Monitor room temperature and humidity for better climate control. Detect leaks using the leak channel to ensure safety.
  3. Energy Management:

    • Track power usage and energy consumption using the electrical_power and electrical_energy channels.

Developer Notes

  1. Implement all required channels for core air conditioning functionality.
  2. Add optional channels based on the specific features of the device.
  3. The device_information channel is mandatory for device identification.
  4. Include electrical_energy and electrical_power for energy efficiency tracking.
  5. Use the leak channel for enhanced safety in environments prone to water-related issues.
Last updated on