Automatic LED Lighting
UltimateSensor v2 has three front RGB LEDs. The firmware can use them as a white motion light, a warm night light, and a visual CO2 warning. These functions are available in both local Home Assistant firmware and SmartHomeShop App cloud firmware.
This page applies to UltimateSensor v2. UltimateSensor v1 does not support this automatic LED configuration.
Automatic LED lighting is disabled by default. The master switch and every individual function must be enabled explicitly. Saved settings are restored after a restart and normal firmware update.
Available Functions
| Function | Behavior |
|---|---|
| Motion Light | Turns the three front LEDs white while motion is detected |
| Night Light | Uses a warm orange light while the room is occupied during the configured night window |
| CO2 warning | Flashes orange three times when the warning threshold is reached |
| Critical CO2 alert | Flashes red three times when the critical threshold is reached |
CO2 alerts are not continuous. They repeat only after the configured cooldown. An increase from warning to critical can trigger a new alert immediately.
Motion Detection
The motion light combines the available fast-motion sources:
- PIR motion;
- an LD2412 moving target;
- an LD2450 moving target in standard firmware;
- LD2460 presence in an LD2460 upgrade variant.
The LD2460 does not classify targets as moving or still. For that reason, an LD2460 presence detection is treated as motion for the light.
The night light uses the combined Occupancy state. When Motion Light is enabled and motion is active, Motion Light has priority over Night Light.
LED Priority
The firmware uses one LED controller so the functions do not fight each other:
- Boot animation and active Voice Assistant status.
- Critical CO2 alert.
- High CO2 warning.
- Motion Light.
- Night Light.
- No active condition: front LEDs off.
Automatic lighting pauses while the boot animation or an active Voice Assistant phase is using the LEDs. Disabling automatic lighting does not disable the boot or Voice Assistant indications.
Settings and Defaults
| Setting | Default |
|---|---|
| Automatic LED Lighting | Off |
| Motion Light | Off |
| Motion Light Brightness | 70% |
| Night Light | Off |
| Night Light Brightness | 10% |
| Night Light Start Hour | 22:00 |
| Night Light End Hour | 07:00 |
| CO2 LED Warning | Off |
| CO2 Warning Threshold | 1000 ppm |
| CO2 Critical Threshold | 1500 ppm |
| CO2 Alert Cooldown | 5 minutes |
When the start and end hour are equal, the night window is active all day.
Configure the LEDs
Local Home Assistant firmware
Open the UltimateSensor v2 device in Home Assistant. The switches and numbers listed above are available as ESPHome configuration entities.
SmartHomeShop App cloud firmware
Open the device settings in the SmartHomeShop App and use the Status LED section. The device downloads the configuration, stores it locally, and reports whether that version was applied.
The SmartHomeShop App settings require a v2 cloud firmware version that supports device configuration. Local firmware is configured through Home Assistant instead.
Troubleshooting
If the front LEDs do not respond:
- Confirm Automatic LED Lighting is enabled.
- Enable the individual Motion Light, Night Light, or CO2 LED Warning function.
- Check the relevant PIR, moving-target, occupancy, or CO2 entity for a valid state.
- For Night Light, check that the device has synchronized time and the current hour is inside the configured window. UltimateSensor v2 gets the time from public NTP servers and uses the Europe/Amsterdam time zone.
- For cloud firmware, check the configuration status in the SmartHomeShop App.