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

Fan Device

Device Category: fan

The Fan device represents a standalone or integrated fan system with features for speed control, direction adjustment, and energy monitoring.


Required Channels

These channels are mandatory for the functionality of the fan:

ChannelDescriptionMultipleDetails
fanManages the fan’s operation, including speed, direction, and activation.NoSee details
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
electrical_energyTracks total energy consumption over time.NoSee details
electrical_powerProvides real-time power usage information.NoSee details

Use Case Scenarios

  1. Fan Operation and Control:

    • Activate or deactivate the fan using the fan channel.
    • Adjust speed and direction settings through the fan channel.
  2. Energy Monitoring:

    • Use the electrical_power channel to monitor real-time power usage.
    • Track long-term energy consumption with the electrical_energy channel.

Developer Notes

  1. Channel Implementation:

    • Implement all required channels for core fan functionality.
    • Add optional channels for energy monitoring if the fan supports these features.
  2. Integration:

    • Map the fan channel to the fan’s speed and direction control mechanisms.
    • Include the device_information channel for device identification.
  3. Energy Tracking:

    • Use the electrical_energy and electrical_power channels to enhance energy efficiency features.
  4. Use Cases:

    • Suitable for standalone fans, ceiling fans, or integrated HVAC systems.
    • Provides energy management capabilities when combined with optional channels.
Last updated on