Sensor definitions¶
Once added to Home Assistant you can configure different settings for your MSR-1. 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.
| 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. |
| Restart Radar | Restarts the LD2410 radar module without rebooting the whole device. |
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. |
| BME280 Temperature | 60s | Ambient air temperature from the BME280. Adjusted by the BME280 Temperature Offset. |
| BME280 Humidity | 60s | Relative humidity from the BME280. Adjusted by the BME280 Humidity Offset. |
| BME280 Pressure | 60s | Barometric air pressure from the BME280. |
| 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 mmWave)¶
| 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 the radar currently has a moving target it is tracking. |
| Radar Still Target | real-time | Whether the radar currently has a still target. |
| Radar Moving Distance | real-time | Distance to the moving target in cm. Reports Unknown when no moving target is present. |
| Radar Still Distance | real-time | Distance to the 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 | The amount of movement measured by the LD2410. Faster movements report a higher percentage. |
| Radar Still Energy | real-time | The energy of the current still target. |
| Radar Zone 1 Occupancy | real-time | Whether someone is in Zone 1, a configurable distance band from the sensor. Defined by Radar Zone 1 Start and Radar End Zone 1. |
| Radar Zone 2 Occupancy | real-time | Same as Zone 1, for the second distance band (from Radar End Zone 1 to Radar End Zone 2). |
| Radar Zone 3 Occupancy | real-time | Same as Zones 1 and 2, for the third distance band (from Radar End Zone 2 to Radar End Zone 3). |
| Radar Zone Occupancy | real-time | Whether any of the three zones is currently occupied. |
| g0-g8 move energy | real-time | Live move-energy reading for each distance gate (g0 to g8). Used when tuning the radar. |
| g0-g8 still energy | real-time | Live still-energy reading for each distance gate (g0 to g8). Used when tuning the radar. |
| Setting | Default | What it does |
|---|---|---|
| ESP Reboot | — | Restarts the device. Helpful for troubleshooting or refreshing the connection. |
| BME280 Temperature Offset | 14.54 °C | Calibrates the BME280 temperature reading to a known value. See the temperature & humidity calibration guide. |
| BME280 Humidity Offset | -18.86 % | Calibrates the BME280 humidity reading to a known value. See the temperature & humidity calibration guide. |
| LTR390 Update Interval | 60 s | How often the LTR390 light and UV sensors poll (1 to 300 seconds). Disabled by default. |
| 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. Value between 2 and 8 inclusive. |
| Radar Max Still Distance | — | Maximum distance gate for still detection. Value between 2 and 8 inclusive. |
| Radar Distance Resolution | — | Best kept at 0.75 m in most cases. At 0.25 m the first few gates become very sensitive and the maximum detection distance shrinks a lot. Disabled by default. |
| Radar Zone 1 Start | 0 cm | Starting distance for Zone 1, measured in cm from the sensor. |
| Radar End Zone 1 | 50 cm | Ending distance for Zone 1 in cm. Sets the band reported by Radar Zone 1 Occupancy (for example, 0 to 50 cm from the sensor). |
| Radar End Zone 2 | 150 cm | Ending distance for Zone 2 in cm, measured from the sensor. |
| Radar End Zone 3 | 250 cm | Ending distance for Zone 3 in cm, measured from the sensor. |
| g0-g8 move threshold | from module | Move-detection sensitivity for each distance gate (g0 to g8). See the radar tuning guide. |
| g0-g8 still threshold | from module | Still-detection sensitivity for each distance gate (g0 to g8). See the radar tuning guide. |
| Radar Control Bluetooth | Off | Turns on the LD2410's Bluetooth so you can connect with the HLK Radar phone app (for example, to update the radar chip's own firmware, not the MSR-1 in general). |
| Radar Engineering Mode | — | Enables the radar's engineering mode, which exposes the per-gate energy readings used for tuning. |
| Startup Light Blink | On | Blinks the RGB LED on startup to show the device's connection status. |
| Reduce DB Reporting | Off | Sends fewer updates to Home Assistant, so its database grows more slowly. 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, 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. |
| query params | — | Queries the LD2410 for its current parameters. |
| Factory Reset Radar | — | Sets the radar's move and still thresholds back to the manufacturer's original values. |
| Factory Reset ESP | — | Erases settings and returns the device to factory firmware defaults. Disabled by default. |
| 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. |