Skip to Content
🚀 We just launched! Please star us on Github!

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:

ChannelDescriptionMultipleDetails
lightControls the lighting functionality, including power, brightness, and color settings.YesSee details
device_informationProvides metadata about the device, such as manufacturer, model, and firmware.NoSee details

Optional Channels

These channels are optional and provide additional features:

ChannelDescriptionMultipleDetails
electrical_energyTracks total energy consumption over time.NoSee details
electrical_powerProvides real-time power usage information.NoSee details
illuminanceMeasures the ambient light level in the room.NoSee details

Use Case Scenarios

  1. 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.
  2. Environmental Monitoring:

    • Measure ambient light levels using the illuminance channel for adaptive lighting.
  3. Energy Management:

    • Track energy usage in real-time with the electrical_power channel.
    • Monitor long-term energy consumption with the electrical_energy channel.

Developer Notes

  1. Channel Implementation:

    • Implement all required channels for basic lighting functionality.
    • Add optional channels for advanced features like energy tracking and light level monitoring.
  2. Integration:

    • Map the light channel to the physical or logical controls for the lighting device.
    • Include the device_information channel for proper device identification.
  3. Energy Tracking:

    • Use electrical_energy and electrical_power channels to offer energy usage insights.
  4. 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.
Last updated on