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

Switcher Device

Device Category: switcher

The Switcher device represents a controllable outlet or switch that can toggle the power supply to connected devices and monitor energy usage. It supports multiple outlets or switches for power control.


Required Channels

These channels are mandatory for the functionality of the switcher:

ChannelDescriptionMultipleDetails
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
outletControls and monitors electrical outlets.YesSee details
switcherControls and monitors electrical switches.YesSee details
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

Channel Constraints

One or More Required

At least one channel from each of the following groups must be present:

  • outlet or switcher

Mutually Exclusive

The following channel groups cannot be used together:

  • outlet OR switcher

Use Case Scenarios

  1. Power Switching:

    • Toggle power to connected devices using outlet or switcher channels. Support for multiple independent switches.
  2. Energy Monitoring:

    • Track power consumption across all connected devices.

Developer Notes

  1. Device must have either outlet OR switcher channels (mutually exclusive).
  2. Multiple channels of the same type are supported.
  3. Energy monitoring is optional but recommended.
Last updated on