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 device:
Channel | Description | Multiple | Details |
---|---|---|---|
light | Controls the lighting functionality, including power, brightness, and color settings. | Yes | See details |
device_information | Provides metadata about the device, such as manufacturer, model, and firmware. | No | See details |
Optional Channels
These channels are optional and provide additional features:
Channel | Description | Multiple | Details |
---|---|---|---|
electrical_energy | Tracks total energy consumption over time. | No | See details |
electrical_power | Provides real-time power usage information. | No | See details |
illuminance | Measures the ambient light level in the room. | No | See details |
Use Case Scenarios
-
Lighting Control:
- Turn the lights on or off and adjust brightness or color through the
light
channel. - Support multiple lighting zones or fixtures with independent controls.
- Turn the lights on or off and adjust brightness or color through the
-
Environmental Monitoring:
- Measure ambient light levels using the
illuminance
channel for adaptive lighting.
- Measure ambient light levels using the
-
Energy Management:
- Track energy usage in real-time with the
electrical_power
channel. - Monitor long-term energy consumption with the
electrical_energy
channel.
- Track energy usage in real-time with the
Developer Notes
-
Channel Implementation:
- Implement all required channels for basic lighting functionality.
- Add optional channels for advanced features like energy tracking and light level monitoring.
-
Integration:
- Map the
light
channel to the physical or logical controls for the lighting device. - Include the
device_information
channel for proper device identification.
- Map the
-
Energy Tracking:
- Use
electrical_energy
andelectrical_power
channels to offer energy usage insights.
- Use
-
Extensibility:
- Add the
illuminance
channel for adaptive lighting based on room brightness. - Customize the
light
channel for advanced lighting effects or modes. - Support multiple
light
channels for complex lighting systems or multi-zone fixtures.
- Add the
Last updated on