Sensor definitions¶
Once added to Home Assistant you can configure different settings for your MSR-2. Use the tabs below to see what each entity does, grouped the same way Home Assistant displays them.
How often readings update
The Default Update column is how often each entity refreshes. Radar entities update in real time as targets move. The LTR390 Light and LTR390 UV Index sensors use the interval set by the LTR390 Update Interval number (60s by default).
Lights that turn off while someone sits still
Run room lights from Radar Target. It's on while the radar detects anyone, moving or still. The zone sensors also depend on the distance readings, so they can drop out while Radar Target stays on. Use a zone sensor only when you need one part of the room, and then leave Reduce DB Reporting off.
If the lights still turn off while someone sits still, raise Radar Timeout to 60 seconds or more. A longer timeout carries Radar Target through short dips and only delays the lights going off after everyone leaves. Changing Radar Timeout restarts the radar, and the radar may not find someone sitting still again until they move, so change it while nobody's sitting in the room, or ask them to move once afterward.
Ensure that the LD2410 firmware version is V2.04.23022511 or later for proper integration functionality.
The newer version of the firmware includes an "auto calibrate" function, so you might want to test it out.
| Control | What it does |
|---|---|
| RGB Light | Three RGB Neopixel LEDs. Click the light bulb or color wheel to change the color. Use the toggle to turn them on or off. |
| Calibrate SCD40 To 420ppm | Forces a fresh-air calibration of the SCD40 CO₂ sensor to the outdoor baseline (about 420 ppm). Run it outdoors or next to an open window. Only needed when CO2 Auto Calibration is off. |
Air quality & light¶
| Sensor | Default Update | Details |
|---|---|---|
| CO2 | 60s | True NDIR reading from the SCD40. Shows Unknown if you do not have the CO₂ module. You can re-calibrate it to the outdoor baseline. |
| DPS310 Pressure | 30s | Barometric air pressure. A small subset of devices do not include a DPS310 sensor. If this reads Unknown, your device may be one of these units. |
| DPS310 Temperature | 30s | Ambient air temperature from the DPS310. Adjusted by the DPS Temperature Offset. A small subset of devices do not include a DPS310 sensor. |
| LTR390 Light | 60s* | Ambient light level in lux. *Polls at the LTR390 Update Interval (60s by default). |
| LTR390 UV Index | 60s* | UV index measured by the LTR390. *Polls at the LTR390 Update Interval. |
Radar (LD2410)¶
| Sensor | Default Update | Details |
|---|---|---|
| Radar Target | real-time | Whether the radar detects a still or moving target. Good for triggering occupancy automations. |
| Radar Moving Target | real-time | Whether a moving target is currently detected. |
| Radar Still Target | real-time | Whether a stationary target is currently detected. |
| Radar Moving Distance | real-time | Distance to a moving target in cm. Reports Unknown when no moving target is present. |
| Radar Still Distance | real-time | Distance to a still target in cm. Reports Unknown when no still target is present. |
| Radar Detection Distance | real-time | Distance to the target the radar detects, in cm. Reports Unknown when the radar detects nobody. |
| Radar Move Energy | real-time | Amount of movement measured by the LD2410. Faster movement reads as a higher percentage. |
| Radar Still Energy | real-time | Energy of the current still target. |
| Radar Zone 1 Occupancy | real-time | Whether someone is in Zone 1. Zones are distance bands from the sensor, set with Radar Zone 1 Start and Radar End Zone 1. |
| Radar Zone 2 Occupancy | real-time | Whether someone is in Zone 2, from the end of Zone 1 to Radar End Zone 2. |
| Radar Zone 3 Occupancy | real-time | Whether someone is in Zone 3, from the end of Zone 2 to Radar End Zone 3. |
| Radar Zone Occupancy | real-time | Whether any of Zone 1, 2, or 3 is occupied. |
| Setting | Default | What it does |
|---|---|---|
| ESP Reboot | — | Restarts the device. Helpful for troubleshooting or refreshing the connection. |
| Factory Reset ESP | — | Erases settings and returns the device to factory firmware defaults. Disabled by default. |
| Factory Reset Radar | — | Resets the LD2410 radar to its factory move and still thresholds. |
| Restart Radar | — | Restarts the LD2410 radar module. |
| Radar Timeout | 5 s | How long Radar Target stays on, in seconds, after the radar last detects someone. Raise it to 60 s or more if lights turn off while someone sits still. Changing it restarts the radar (see the tip above). |
| Radar Max Move Distance | — | Maximum distance gate for movement detection (gate 2 to 8). Use it to ignore movement past a chosen distance. |
| Radar Max Still Distance | — | Maximum distance gate for still detection (gate 2 to 8). Use it to ignore still targets past a chosen distance. |
| Radar Zone 1 Start | 0 cm | Start distance of Zone 1 from the sensor, in cm (0 to 800). |
| Radar End Zone 1 | 50 cm | End distance of Zone 1 from the sensor, in cm. From Radar Zone 1 Start to this value is Zone 1. |
| Radar End Zone 2 | 150 cm | End distance of Zone 2, in cm. From the end of Zone 1 to this value is Zone 2. |
| Radar End Zone 3 | 250 cm | End distance of Zone 3, in cm. From the end of Zone 2 to this value is Zone 3. |
| Radar Engineering Mode | — | Enables the g0-g8 threshold sliders for mmWave tuning. |
| g0-g8 move threshold | — | Movement sensitivity threshold for each gate (g0 through g8). See the radar tuning guide. |
| g0-g8 still threshold | — | Stillness sensitivity threshold for each gate (g0 through g8). See the radar tuning guide. |
| ld2410 Gate Size | — | Distance resolution per gate on the LD2410. Disabled by default. |
| ld2410 Bluetooth | Off | Turns on the LD2410's Bluetooth so you can connect with the HLK Radartool phone app for tuning. Turned off at boot. |
| LTR390 Update Interval | 60 s | How often the LTR390 light and UV sensors poll (1 to 300 seconds). Disabled by default. |
| DPS310 Pressure Offset | 0.0 hPa | Calibration offset for the DPS310 pressure reading (-100 to +100 hPa in 0.1 hPa steps). Disabled by default. A small subset of devices do not include a DPS310 sensor; if this reads Unknown, your device may be one of these units. |
| DPS Temperature Offset | 14.54 °C | Offsets heat from the ESP chip for a more accurate DPS310 temperature reading. A small subset of devices do not include a DPS310 sensor. |
| CO2 Auto Calibration | On | Keeps the SCD40 CO₂ sensor calibrated automatically. The sensor assumes it sees fresh air (about 420 ppm) at least once a week and corrects its baseline to match. Turn it off if the device sits in a space that rarely gets fresh air, then calibrate manually with Calibrate SCD40 To 420ppm every 1 to 2 years. |
| Reduce DB Reporting | Off | Applies filters so many entities only report when they change by a set amount, using less Wi-Fi airtime and less Home Assistant database space. While it's on, Radar Move Energy and Radar Still Energy stop updating, the three distance sensors report only changes of 5 cm (2 in) or more, and the light, UV, pressure, and ESP temperature sensors only report larger changes, at least once an hour. Radar Target, Radar Moving Target, Radar Still Target, and the g0-g8 energies aren't affected. With it on, after the radar briefly loses someone and finds them again at almost the same distance, the distance sensors can stay Unknown and the zone sensors Clear while Radar Still Target is on, until the distance changes by 5 cm or more. Leave it off if you automate on the zone sensors. |
| Startup Light Blink | On | Blinks the RGB LED during the MSR-2's initial boot. |
| Entity | Default Update | What it shows |
|---|---|---|
| Apollo Firmware Version | on boot | The Apollo firmware build installed on the device (for example, 26.3.2.1). |
| ESPHome Version | on boot | The ESPHome version the firmware was compiled with. |
| Firmware Update | — | Shows whether a firmware update is available and lets you update from inside Home Assistant. Separate from the Apollo Firmware Version and ESPHome Version sensors above. |
| IP Address | on connect | The device's IP address on your network. |
| Online | on change | Connection status of the device to Home Assistant. |
| RSSI | 60s | Wi-Fi signal strength in dBm. Values closer to 0 are stronger; a weak signal can affect reliability. |
| ESP Temperature | 60s | Internal temperature of the ESP32 chip. Runs warmer than the room because of the processor and Wi-Fi radio. |
| Uptime | 60s | How long the device has been running since its last reboot. |
| Radar Firmware Version | on boot | Firmware version installed on the LD2410 radar module. |
| query params | — | Queries the LD2410's current parameters for debugging and advanced tuning. |
| g0 move energy to g8 move energy | real-time | Live move-energy level for each gate (g0 through g8). |
| g0 still energy to g8 still energy | real-time | Live still-energy level for each gate (g0 through g8). |