Lighting Device
Device Category: lighting
The Lighting device represents a lighting system designed to provide illumination with optional features for energy tracking, brightness control, and adaptive lighting based on ambient conditions.
Required Channels
These channels are mandatory for the functionality of the lighting:
| Channel | Description | Multiple | Details |
|---|---|---|---|
light | Controls lighting devices, supporting brightness, color temperature, and color adjustments. | Yes | See 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 |
|---|---|---|---|
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 |
illuminance | Detects ambient light levels, typically measured in lux, to monitor brightness in a space. | No | See details |
button | Hardware push-button input. | Yes | See details |
binary_input | Binary toggle or contact switch input. | Yes | See details |
analog_input | Analog control input. | Yes | See details |
temperature | Reports external probe or native helper temperature measurements in degrees Celsius. | Yes | See details |
indicator | Represents a status indicator LED output. Controls on/off state, brightness, and color of hardware indicator LEDs. Used for system status feedback on host devices or external indicator peripherals. | No | See details |
Use Case Scenarios
-
Illumination Control:
- Control brightness, color temperature, and color using the light channel. Support for multiple light elements in a single fixture.
-
Adaptive Lighting:
- Use the illuminance channel to automatically adjust lighting based on ambient light levels.
-
Energy Monitoring:
- Track lighting energy consumption for efficiency analysis.
Developer Notes
- The light channel is required and supports multiple instances for multi-element fixtures.
- Illuminance sensor enables automatic brightness adjustment.
- Not all lights support color or color temperature - check device capabilities.
Last updated on