From 395a76d7915863377b8ec37d6e263cf20a0d34d3 Mon Sep 17 00:00:00 2001 From: Brandon Harvey <8107750+bharvey88@users.noreply.github.com> Date: Wed, 27 May 2026 19:40:09 -0500 Subject: [PATCH] Add "Choosing an mmWave Sensor" guide and link it from the homepage (#885) New General page comparing the MSR-2, MTR-1, and R-PRO-1 mmWave sensors: intro, per-sensor cards, a capability comparison table, inline SVG field-of-view cones (horizontal and vertical), zone tracking, still detection, and reducing false triggers. Beta callout for the Zone Mapper integration and Lovelace card. - Add a green "Deep dive into each sensor" node to the homepage mmWave decision chart, linking to the new guide. - Add nav entries on the main and Homey General sections; Homey page is a snippet wrapper of the main file. --- .../general/choosing-an-mmwave-sensor.md | 5 + docs/index.md | 5 + .../general/choosing-an-mmwave-sensor.md | 119 ++++++++++++++++++ mkdocs.yml | 2 + 4 files changed, 131 insertions(+) create mode 100644 docs/homey/products/general/choosing-an-mmwave-sensor.md create mode 100644 docs/products/general/choosing-an-mmwave-sensor.md diff --git a/docs/homey/products/general/choosing-an-mmwave-sensor.md b/docs/homey/products/general/choosing-an-mmwave-sensor.md new file mode 100644 index 0000000000..7123524c9c --- /dev/null +++ b/docs/homey/products/general/choosing-an-mmwave-sensor.md @@ -0,0 +1,5 @@ +--- +title: Choosing an mmWave Sensor +description: Compare the Apollo MSR-2, MTR-1, and R-PRO-1 mmWave presence sensors and pick the right one for your space. +--- +--8<-- "products/general/choosing-an-mmwave-sensor.md:5:" diff --git a/docs/index.md b/docs/index.md index edf40c9852..7a2a4232e2 100755 --- a/docs/index.md +++ b/docs/index.md @@ -68,6 +68,7 @@ flowchart LR START{{"Which Apollo mmWave sensor is right for me?"}} START --> Q1(["Do you need PoE or
Ethernet connectivity?"]) + START -.-> GUIDE(["Deep dive into each sensor"]) Q1 -->|Yes| RPRO Q1 -->|No| Q2(["Do you need to detect and track
multiple people in zones?"]) @@ -85,9 +86,13 @@ flowchart LR classDef product fill:#4379AA,stroke:#2d5a8a,color:#fff,font-weight:bold class MSR,MTR,RPRO product + classDef guide fill:#2e7d46,stroke:#1f5630,color:#fff,font-weight:bold + class GUIDE guide + click MSR href "https://wiki.apolloautomation.com/products/msr2/introduction/" _blank click MTR href "https://wiki.apolloautomation.com/products/mtr1/introduction/" _blank click RPRO href "https://wiki.apolloautomation.com/products/rpro1/introduction/" _blank + click GUIDE href "https://wiki.apolloautomation.com/products/general/choosing-an-mmwave-sensor/" _blank ``` ### Most Popular diff --git a/docs/products/general/choosing-an-mmwave-sensor.md b/docs/products/general/choosing-an-mmwave-sensor.md new file mode 100644 index 0000000000..a581b29f2b --- /dev/null +++ b/docs/products/general/choosing-an-mmwave-sensor.md @@ -0,0 +1,119 @@ +--- +title: Choosing an mmWave Sensor +description: Compare the Apollo MSR-2, MTR-1, and R-PRO-1 mmWave presence sensors and pick the right one for your space. +--- +# Choosing an mmWave Sensor + +Apollo mmWave sensors detect the **moving** and **still** energy of people and animals, which makes them excellent for presence detection in a room. They are not meant to detect vehicles, so for a car an ultrasonic sensor is a better fit. This guide compares our three current mmWave sensors so you can pick the right one for your space. + +
+ +- :material-bed:{ .lg .middle } **MSR-2** + + --- + + Best still detection, for one person. + + [:octicons-arrow-right-24: MSR-2 overview](https://wiki.apolloautomation.com/products/msr2/introduction/) + +- :material-account-group:{ .lg .middle } **MTR-1** + + --- + + Tracks multiple people across zones. + + [:octicons-arrow-right-24: MTR-1 overview](https://wiki.apolloautomation.com/products/mtr1/introduction/) + +- :material-ethernet:{ .lg .middle } **R-PRO-1** + + --- + + Best of both worlds, plus PoE. + + [:octicons-arrow-right-24: R-PRO-1 overview](https://wiki.apolloautomation.com/products/rpro1/introduction/) + +
+ +## Compare + +| | MSR-2 | MTR-1 | R-PRO-1 | +|---|:---:|:---:|:---:| +| **Targets tracked** | 1 | Up to 3 | Up to 3 | +| **Multi-zone tracking** | :material-minus: | :material-check: 3 zones | :material-check: 3 zones | +| **Still detection** | :material-check: Excellent | :material-minus: Limited | :material-check: With LD2412 add-on | +| **PoE / Ethernet** | :material-minus: | :material-minus: | :material-check: | +| **Horizontal FoV** | 120° | 120° | 120°
150° with LD2412 | +| **Vertical FoV** | 70° | 70° | 70° | +| **Power** | USB-C | USB-C | PoE, Ethernet, Wi-Fi, USB-C | +| **mmWave module** | LD2410B | LD2450 | LD2450, optional LD2412 | + +## Field of view + +Each sensor watches a **cone** that fans out in front of it, like the beam of a flashlight. The cone is wider side to side than it is top to bottom. + +
+ +
+ + + + + + + 120° + sensor + +
Horizontal FoV: 120° side to side (up to 150° on the R-PRO-1 with the LD2412)
+
+ +
+ + + + + + + 70° + sensor + +
Vertical FoV: 70° top to bottom
+
+ +
+ +## Zone tracking (MTR-1 and R-PRO-1) + +The LD2450 module tracks up to three moving targets and reports each one's X and Y position. You draw rectangular zones in those coordinates to decide where presence counts. + +!!! tip "Setting LD2450 zone coordinates" + + - X1 must always be less than X2, and Y1 must always be less than Y2. + - The X axis is where you can get tripped up, especially when both values are negative: -3456 is less than -2345. + - The Y axis is easier since it is never negative. + - The Plotly chart still draws the rectangles even if the X1/X2 or Y1/Y2 values are reversed, so double-check the order. + - Zones cannot overlap. + +To set up zones, follow the guide for your device: [MTR-1 zones](https://wiki.apolloautomation.com/products/mtr1/setup/zones-ha/) or [R-PRO-1 (LD2450) zones](https://wiki.apolloautomation.com/products/rpro1/setup/zones-ha/). + +!!! tip "Beta: try the Zone Mapper" + + We are beta testing **Zone Mapper**, which makes drawing LD2450 zones much easier. It pairs a Home Assistant integration with a Lovelace card, so you can draw rectangular, elliptical, or polygonal zones right on a grid, watch your tracked targets move in real time, and get an occupancy sensor for each zone. Both install through HACS. + + Check it out on GitHub: [Zone Mapper integration](https://github.com/ApolloAutomation/zone-mapper) and [Zone Mapper card](https://github.com/ApolloAutomation/zone-mapper-card). + +## Still detection (MSR-2 and R-PRO-1 with the LD2412) + +The MSR-2, and the R-PRO-1 once you add the optional LD2412, detect a single target using gates: fixed distance bands rather than X and Y coordinates. This is what makes them so good at catching someone who is barely moving, like sleeping or sitting still. To add the second module to an R-PRO-1, follow [Add the LD2412 to your R-PRO-1](https://wiki.apolloautomation.com/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1/). + +### Reducing false triggers + +mmWave detects motion, so things that move or reflect the radar signal can trigger a sensor even when no one is there. Common culprits include: + +- Mirrors and other reflective surfaces +- Fans and spinning blades +- Moving air from HVAC vents and registers +- Curtains, blinds, or plants swaying in a draft + +The **MSR-2 (LD2410)** and the **R-PRO-1 with the LD2412** let you tune the sensitivity of each gate, so you can dial down the distance bands where a fan or vent sits and tune these false positives out. With the **LD2450 (MTR-1 and R-PRO-1)** you can instead draw your zones to exclude the problem area. + +See the [Radar Tuning guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/radar-tuning/zones-ha/) to adjust sensitivity. diff --git a/mkdocs.yml b/mkdocs.yml index 782792defa..333f54e781 100755 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -209,6 +209,7 @@ nav: - Sensor Connection Check: products/general/battery-sensors/sensor-connection-check.md - Prevent Sleep: products/general/battery-sensors/prevent-sleep.md - Source Code and 3D Files: products/general/links.md + - Choosing an mmWave Sensor: products/general/choosing-an-mmwave-sensor.md - Sensor Comparisons: products/general/comparisons.md - Supported Platforms: products/general/supported-platforms.md - Resellers: products/general/resellers.md @@ -590,6 +591,7 @@ nav: - How To Wake Up Your Sensor: homey/products/general/battery-sensors/wake-up-battery-sensor.md - Sensor Connection Check: homey/products/general/battery-sensors/sensor-connection-check.md - Source Code and 3D Files: homey/products/general/links.md + - Choosing an mmWave Sensor: homey/products/general/choosing-an-mmwave-sensor.md - Sensor Comparisons: homey/products/general/comparisons.md - Supported Platforms: homey/products/general/supported-platforms.md - Resellers: homey/products/general/resellers.md