Skip to main content

Light Sensor

The controller supports a light sensor for automatic brightness adjustment based on ambient lighting conditions.


Enabling the Sensor

Go to Settings → Light Sensor.

ParameterDescription
Enable Light SensorActivates the hardware or virtual sensor (applying changes is required to take effect)
Virtual SensorAllows the brightness to be controlled by external light sensor by REST API or MQTT
Adaptive ModeAutomatically adjusts brightness based on ambient light

Adaptive Mode Parameters

Adaptive mode displays an Auto icon on the brightness slider in the control panel.

ParameterRangeDescription
"Bright" threshold (trig_bright)0–255Light level above which it is considered "bright"
"Dark" threshold (trig_dark)0–255Light level below which it is considered "dark"
Min. brightness X0–255Lower light bound for brightness calculation
Min. brightness Y0–255Brightness at minimum light level

Operating Logic

If light > trig_bright  → "bright" mode (sensors and night backlight are turned off)
If light < trig_dark → "dark" mode (sensors and night backlight are on. If adaptive brightness is selected, brightness will be adjusted according to current light sensor readings)

Recommended default values:

  • trig_bright: 105
  • trig_dark: 95
  • min_lux_x: 30, min_lux_y: 30

Sensor State in MQTT

Current light readings and sensor state are published to {base}/M/Illuminance and {base}/M/LightSensorState.


Recommendations

  • Do not place the light sensor under steps, that are used as night backlight steps.
  • In adaptive mode, set the "bright" threshold slightly above the daytime corridor lighting level
  • The hysteresis between trig_bright and trig_dark prevents frequent switching (a difference of 10–20 units is recommended)