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
lightchannel. - 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
illuminancechannel for adaptive lighting.
- Measure ambient light levels using the
-
Energy Management:
- Track energy usage in real-time with the
electrical_powerchannel. - Monitor long-term energy consumption with the
electrical_energychannel.
- 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
lightchannel to the physical or logical controls for the lighting device. - Include the
device_informationchannel for proper device identification.
- Map the
-
Energy Tracking:
- Use
electrical_energyandelectrical_powerchannels to offer energy usage insights.
- Use
-
Extensibility:
- Add the
illuminancechannel for adaptive lighting based on room brightness. - Customize the
lightchannel for advanced lighting effects or modes. - Support multiple
lightchannels for complex lighting systems or multi-zone fixtures.
- Add the
Last updated on