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:
| Channel | Description | Multiple | Details |
|---|---|---|---|
device_information | Provides metadata about the device, including manufacturer details, model information, and operational statuses. | No | See details |
Optional Channels
These channels are optional and provide additional features:
| Channel | Description | Multiple | Details |
|---|---|---|---|
outlet | Controls and monitors electrical outlets. | Yes | See details |
switcher | Controls and monitors electrical switches. | Yes | See details |
electrical_energy | Measures the total energy consumption over time, typically reported in kilowatt-hours (kWh). | No | See details |
electrical_power | Reports real-time power metrics such as voltage, current, and wattage for monitoring and diagnostics. | No | See details |
Channel Constraints
One or More Required
At least one channel from each of the following groups must be present:
outletorswitcher
Mutually Exclusive
The following channel groups cannot be used together:
outletORswitcher
Use Case Scenarios
-
Power Switching:
- Toggle power to connected devices using outlet or switcher channels. Support for multiple independent switches.
-
Energy Monitoring:
- Track power consumption across all connected devices.
Developer Notes
- Device must have either outlet OR switcher channels (mutually exclusive).
- Multiple channels of the same type are supported.
- Energy monitoring is optional but recommended.
Last updated on