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

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.