docs: link reflash guides to the new Apollo installer

AGENTS.md

@@ -39,6 +39,10 @@ Read the full style guide, but these are the ones worth checking twice:
 - **Apollo addons** (hardware modules) and **Home Assistant apps**
   (formerly add-ons) are different things and not interchangeable.
 - **ESPHome** is the only correct casing.
+- Firmware install links go to the product's page on the Apollo
+  installer (`https://install.apolloautomation.com/#/air-1`), not the
+  old `apolloautomation.github.io/AIR-1/` installers. See
+  [Flashing firmware](STYLE_GUIDE.md#flashing-firmware).
 - **No em dashes** anywhere in user-facing copy.
 - Second person, imperative voice for action copy. Wrap numbered steps
   with framing copy (what the reader unlocks, what success looks like).

STYLE_GUIDE.md

@@ -158,6 +158,20 @@ When introducing the broader project, prefer **ESPHome ecosystem** over
 context (for example, when the audience may not recognize the term).
 Avoid **burn** and **load**.
 
+Link firmware installs to the product's own page on the Apollo
+installer, `https://install.apolloautomation.com/#/<product>` (for
+example `#/air-1` or `#/r-pro-1`), not the older
+`apolloautomation.github.io/<PRODUCT>/` installers. Name buttons the way
+the installer shows them: the variant (**USB Power**, **Battery Power**,
+**WiFi**, **Ethernet**, **Smart (Wi-Fi)**, **Basic (No Wi-Fi)**) and
+then **Connect & Install**, and the firmware option in the next dialog
+exactly as listed (for example **Install ApolloAutomation.AIR-1**). The
+B models use their parent's page with **Battery Power** (TEMP-1B on
+`#/temp-1`, PLT-1B on `#/plt-1`). Keep the older installer link only
+where the Apollo installer has no equivalent: the TEMP Pro-1, and TEMP-1
+Revision 1 firmware. The LED-1 uses the official WLED installer at
+`https://install.wled.me/`.
+
 ---
 
 ## 6. Voice and structure

docs/homey/products/air1/troubleshooting/air1-code.md

@@ -15,11 +15,11 @@ If your Apollo AIR-1 becomes unresponsive and you've exhausted the other trouble
 
 ![AIR-1 case with a tool pointing at the boot button left of the USB-C port](/assets/air-1-boot-button.jpg)
 
-2\. Go to the <a href="https://apolloautomation.github.io/AIR-1/" target="_blank" rel="noreferrer nofollow noopener">Apollo AIR-1 Installer</a> page.
+2\. Go to the <a href="https://install.apolloautomation.com/#/air-1" target="_blank" rel="noreferrer nofollow noopener">Apollo AIR-1 installer</a> page.
 
-3\. Click the big **Connect** button.
+3\. Click **Connect & Install**.
 
-![Apollo AIR-1 Installer web page with the Connect button highlighted](/assets/air-1-reflash-pic-1.png)
+![AIR-1 page of the Apollo installer with the Connect & Install button outlined in red](/assets/installer-air-1.png)
 
 4\. Select the open COM port, then click **Connect**.
 

docs/homey/products/led1/troubleshooting/led1-reflash.md

@@ -1,5 +1,5 @@
 ---
 title: Factory re-flash LED-1
-description: "Step by step guide for re-flashing the LED-1 back to factory firmware."
+description: "Step by step guide for re-flashing the LED-1 with regular WLED from your browser."
 ---
 --8<-- "products/led1/troubleshooting/led1-reflash.md:5:"

docs/homey/products/msr2/setup/msr2-general-tips.md

@@ -34,4 +34,4 @@ The MSR-2 can also be mounted on the ceiling if you can provide power and mount
 
 **![Table of LD2410 gates 0 to 8 with distance ranges in meters and feet and default move and still thresholds](/assets/ld2410-gate-table.png)![Radar Distance Resolution set to 0.75m with Radar End Zone 1, 2, and 3 at 50, 100, and 200 cm](/assets/gate-zones-and-rr.png)**
 
-![Fan diagram of LD2410 gates G1 to G8, each 0.75 m deep, reaching 6 m (19.69 ft) from the sensor](/assets/ld2410-gate-map.png)![Radar gate diagram with Zones 1, 2, and 3 shaded red, blue, and green over gates G1 to G7](/assets/radar-gates-colored.png)
+![Fan diagram of LD2410 gates G1 to G8, each 0.75 m deep, reaching 6 m (19.69 ft) from the sensor](/assets/ld2410-gate-map.png)![Fan diagram of LD2410 gates G1 to G8 grouped into example zones: Zone 1 (G1 to G2) in red, Zone 2 (G3 to G5) in blue, and Zone 3 (G6 to G8) in green, reaching 6 m](/assets/radar-gates-colored.png)

docs/homey/products/msr2/troubleshooting/msr2-code.md

@@ -16,17 +16,17 @@ If your device has already been added to Homey, please <a href="https://wiki.apo
 
 2\. Push and hold the boot button. While still holding the button down, plug in a USB-C cable into the USB-C port of your MSR-2 then let go of the button.
 
-3\. Navigate to our installer page and click connect under <a href="https://apolloautomation.github.io/MSR-2/" target="_blank" rel="noreferrer nofollow noopener">Apollo MSR-2 Installer</a>.
+3\. Open the <a href="https://install.apolloautomation.com/#/msr-2" target="_blank" rel="noreferrer nofollow noopener">Apollo MSR-2 installer</a>.
 
-4\. Click the big "Connect" button.
+4\. Click **Connect & Install**.
 
-![Apollo MSR-2 Installer page with the CONNECT button highlighted](/assets/msr-2-reflash-pic-1.png)
+![MSR-2 page of the Apollo installer with the Connect & Install button outlined in red](/assets/installer-msr-2.png)
 
 5\. Select the open com port then click Connect.
 
 ![Browser serial port dialog listing the USB JTAG serial debug unit with the Connect button](/assets/msr-2-reflash-pic-2.png)
 
-6\. Click "Install MSR-2".
+6\. Click **Install ApolloAutomation.MSR-2**.
 
 ![Installer Device Dashboard menu with INSTALL MSR-2 highlighted](/assets/msr-2-reflash-pic-3.png)
 

docs/homey/products/mtr1/troubleshooting/mtr1-code.md

@@ -16,17 +16,17 @@ If your device has already been added to Homey, please <a href="https://wiki.apo
 
 2\. Push and hold the boot button. While still holding the button down, plug in a USB-C cable into the USB-C port of your MTR-1 then let go of the button.
 
-3\. Navigate to our installer page and click connect under <a href="https://apolloautomation.github.io/MTR-1/" target="_blank" rel="noreferrer nofollow noopener">Apollo MTR-1 Installer</a>.
+3\. Open the <a href="https://install.apolloautomation.com/#/mtr-1" target="_blank" rel="noreferrer nofollow noopener">Apollo MTR-1 installer</a>.
 
-4\. Click the big "Connect" button.
+4\. Click **Connect & Install**.
 
-![Apollo MTR-1 Installer page with the Connect button highlighted](/assets/mtr-1-reflash-pic-1.png)
+![MTR-1 page of the Apollo installer with the Connect & Install button outlined in red](/assets/installer-mtr-1.png)
 
 5\. Select the open com port then click Connect.
 
 ![Browser serial port prompt with the USB JTAG/serial debug unit selected and Connect clicked](/assets/mtr-1-reflash-pic-2.png)
 
-6\. Click "Install MTR-1".
+6\. Click **Install ApolloAutomation.MTR-1**.
 
 ![Installer Device Dashboard with the Install MTR-1 option being clicked](/assets/mtr-1-reflash-pic-3.png)
 

docs/homey/products/plt1/troubleshooting/plt1-code.md

@@ -16,17 +16,17 @@ Follow these steps to put your device in boot mode and install the factory firmw
 
 ![Side of the PLT-1 with the boot button opening circled](/assets/screenshot-2024-10-23-at-12-32-55-pm.png)
 
-2\. Navigate to our installer page and click connect under Non Battery Firmware <a href="https://apolloautomation.github.io/PLT-1/" target="_blank" rel="noreferrer nofollow noopener">Apollo PLT-1 Installer</a>
+2\. Navigate to the <a href="https://install.apolloautomation.com/#/plt-1" target="_blank" rel="noreferrer nofollow noopener">Apollo PLT-1 installer</a> and choose **USB Power** since you are using a PLT-1.
 
-3\. Click the big "Connect" button.
+3\. Click **Connect & Install**.
 
-![Apollo PLT-1 Installer page with the Non Battery Firmware Connect button highlighted](/assets/plt-1-reflash-pic-1-1.png)
+![PLT-1 page of the Apollo installer with the USB Power variant and the Connect & Install button outlined in red](/assets/installer-plt-1-usb-power.png)
 
 4\. Select the open com port then click Connect.
 
 ![Browser serial port prompt with the USB JTAG/serial debug unit selected and Connect clicked](/assets/plt-1-reflash-pic-2-1.png)
 
-5\. Click "Install ApolloAutomation.PLT-1".
+5\. Click **Install ApolloAutomation.PLT-1**.
 
 ![Installer Device Dashboard with the Install ApolloAutomation.PLT-1 option highlighted](/assets/plt-1-reflash-pic-3.png)
 

docs/homey/products/plt1b/troubleshooting/plt1b-code.md

@@ -21,11 +21,11 @@ Follow these steps to put your PLT-1B in boot mode and install the factory firmw
 
 ![Tool inserted into the boot button opening on the side of the closed PLT-1B case](/assets/plt-boot-mode-pic-4.jpg)
 
-2\. Open the <a href="https://apolloautomation.github.io/PLT-1/" target="_blank" rel="noreferrer nofollow noopener">Apollo PLT-1B Installer</a>.
+2\. Open the <a href="https://install.apolloautomation.com/#/plt-1" target="_blank" rel="noreferrer nofollow noopener">Apollo PLT-1 installer</a>. The PLT-1B uses the same page as the PLT-1.
 
-3\. Under **Battery Firmware**, click the big **Connect** button.
+3\. Choose **Battery Power**, then click **Connect & Install**.
 
-![Apollo PLT-1 Installer page with the Battery Firmware Connect button being clicked](/assets/plt-1b-reflash-pic-1.png)
+![PLT-1 page of the Apollo installer with the Battery Power variant and the Connect & Install button outlined in red](/assets/installer-plt-1-battery-power.png)
 
 4\. Select the open COM port, then click **Connect**.
 

docs/homey/products/rpro1/faq.md

@@ -35,7 +35,7 @@ description: "Answers to common questions about the R PRO-1 PoE mmWave sensor wi
 7\. **How do I connect the R PRO-1 to Homey?**
 
 * The R PRO-1 ships with Wi-Fi firmware. Connect it to your Wi-Fi through its hotspot, then add it in Homey with the Apollo Automation app, which talks to it directly over your local network through the ESPHome native API. The app runs on Homey Pro; Homey Cloud isn't supported. See [Getting started](../../general/setup/getting-started/).
-* Once it's connected, you can switch to Ethernet firmware for PoE from the sensor's own web page: in a browser, open `http://apollo-r-pro-1-w-xxxxxx.local`, where `xxxxxx` is the last 6 characters of the device's name in Homey. Choose **Ethernet** under **Firmware Type**, then press **Firmware Update**. The sensor downloads the new firmware from GitHub, so it needs internet access. You can also reflash it to Ethernet firmware with the <a href="https://apolloautomation.github.io/R_PRO-1/" target="_blank" rel="noreferrer nofollow noopener">R PRO-1 installer</a>.
+* Once it's connected, you can switch to Ethernet firmware for PoE from the sensor's own web page: in a browser, open `http://apollo-r-pro-1-w-xxxxxx.local`, where `xxxxxx` is the last 6 characters of the device's name in Homey. Choose **Ethernet** under **Firmware Type**, then press **Firmware Update**. The sensor downloads the new firmware from GitHub, so it needs internet access. You can also reflash it to Ethernet firmware from the <a href="https://install.apolloautomation.com/#/r-pro-1" target="_blank" rel="noreferrer nofollow noopener">Apollo R PRO-1 installer</a> by choosing **Ethernet**.
 * Homey recognizes the R PRO-1 by its hardware address, so after the switch it stays the same device in Homey.
 
 8\. **What kind of flows can I create with the R PRO-1?**

docs/homey/products/rpro1/setup/zones-hlk.md

@@ -38,9 +38,7 @@ Follow these steps to turn on the LD2450's Bluetooth and set up its zones in the
 
 1\. Open your R PRO-1's web server (see address tip above), scroll down until you see **LD2450 Bluetooth**, and toggle it on.
 
-![Device Configuration panel with the LD2450 Bluetooth toggle switched on and highlighted](/assets/mtr-1-toggle-on-ld2450-bluetooth.png)
-
-*Shown on an MTR-1; the R PRO-1 has the same LD2450 Bluetooth switch.*
+![R PRO-1 web page with the LD2450 Bluetooth switch turned on and highlighted](/assets/r-pro-1-toggle-on-ld2450-bluetooth.png)
 
 2\. Open the HLKRadarTool App and select your device.
 

docs/homey/products/temp1/troubleshooting/temp1-code.md

@@ -14,27 +14,27 @@ Follow these steps to put your device in boot mode and install the factory firmw
 
 1\. <a href="https://wiki.apolloautomation.com/homey/products/temp1/troubleshooting/temp1-boot-mode/" target="_blank" rel="noopener">Put your device in boot mode</a> by holding down the boot button and then plugging in the USB cable.
 
-2\. Navigate to the [Apollo TEMP-1 Installer](https://apolloautomation.github.io/TEMP-1/).
+2\. Navigate to the [Apollo TEMP-1 installer](https://install.apolloautomation.com/#/temp-1).
 
-3\. Click "Connect" under **Non Battery Firmware Revision 2** since you are using a TEMP-1.
+3\. Choose **USB Power** since you are using a TEMP-1, then click **Connect & Install**.
 
 !!! tip "Use R2 version unless instructed to use R1 by support!"
 
-    R2 is what all of our devices use except a very small batch of TEMP-1 and TEMP-1B
+    The Apollo installer installs the Revision 2 (R2) firmware. R2 is what all of our devices use except a very small batch of TEMP-1 and TEMP-1B boards. If support tells you your board needs Revision 1 (R1), click **Connect** under **Non Battery Firmware Revision 1** on the [classic TEMP-1 installer](https://apolloautomation.github.io/TEMP-1/) instead. In the next steps, the firmware option is named **Install ApolloAutomation.TEMP-1**.
 
-![Apollo TEMP-1 Installer page with the Non Battery Firmware Revision 2 Connect button clicked](/assets/temp-1-reflash-pic-1-1.png)
+![TEMP-1 page of the Apollo installer with the USB Power variant and the Connect & Install button outlined in red](/assets/installer-temp-1-usb-power.png)
 
 4\. Select the open com port then click Connect.
 
 ![Browser serial port dialog with the USB JTAG/serial debug unit port selected and the Connect button](/assets/temp-1-reflash-pic-2.png)
 
-5\. Click "Install ApolloAutomation.TEMP-1".
+5\. Click **Install Apollo.TEMP-1_R2**.
 
-![Device Dashboard dialog with Install ApolloAutomation.TEMP-1 highlighted](/assets/temp-1-reflash-pic-3.png)
+![Device Dashboard dialog with the TEMP-1 firmware install option highlighted](/assets/temp-1-reflash-pic-3.png)
 
 6\. Click "INSTALL".
 
-![Install ApolloAutomation.TEMP-1 confirmation dialog with the Install button highlighted](/assets/temp-1-reflash-pic-4.png)
+![TEMP-1 firmware install confirmation dialog with the Install button highlighted](/assets/temp-1-reflash-pic-4.png)
 
 7\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window.
 

docs/homey/products/temp1b/troubleshooting/temp1b-code.md

@@ -12,30 +12,38 @@ If your device has already been added to Homey, please <a href="https://wiki.apo
 
 1\. <a href="https://wiki.apolloautomation.com/homey/products/temp1b/troubleshooting/temp1b-boot-mode/" target="_blank" rel="noopener">Put your device in boot mode</a> by holding down the boot button and then plugging in the USB cable.
 
-2\. Navigate to our installer page and click connect under Battery Firmware [Apollo TEMP-1 Installer](https://apolloautomation.github.io/TEMP-1/)
+2\. Navigate to the [Apollo TEMP-1 installer](https://install.apolloautomation.com/#/temp-1). The TEMP-1B uses the same page as the TEMP-1.
 
 !!! failure "Remove the battery!"
 
     This will not work properly if the battery is still supplying power to the TEMP-1B. Please remove the battery if you are having issues!
 
-3\. Select the open com port then click Connect.
+3\. Choose **Battery Power** since you are using a TEMP-1B, then click **Connect & Install**.
+
+![TEMP-1 page of the Apollo installer with the Battery Power variant and the Connect & Install button outlined in red](/assets/installer-temp-1-battery-power.png)
+
+!!! tip "Use R2 version unless instructed to use R1 by support!"
+
+    The Apollo installer installs the Revision 2 (R2) firmware. R2 is what all of our devices use except a very small batch of TEMP-1 and TEMP-1B boards. If support tells you your board needs Revision 1 (R1), click **Connect** under **Battery Firmware Revision 1** on the [classic TEMP-1 installer](https://apolloautomation.github.io/TEMP-1/) instead. In the next steps, the firmware option is named **Install ApolloAutomation.TEMP-1B**.
+
+4\. Select the open com port then click Connect.
 
 ![Browser serial port dialog with the USB JTAG/serial debug unit port selected and the Connect button](/assets/temp-1b-reflash-pic-2-1.png)
 
-4\. Click "Install ApolloAutomation.TEMP-1B".
+5\. Click **Install Apollo.TEMP-1B_R2**.
 
-![Device Dashboard dialog with Install ApolloAutomation.TEMP-1B selected](/assets/temp-1b-reflash-pic-3.png)
+![Device Dashboard dialog with the TEMP-1B firmware install option selected](/assets/temp-1b-reflash-pic-3.png)
 
-5\. Click "INSTALL".
+6\. Click "INSTALL".
 
-![Install ApolloAutomation.TEMP-1B confirmation dialog with the cursor on the Install button](/assets/temp-1b-reflash-pic-4.png)
+![TEMP-1B firmware install confirmation dialog with the cursor on the Install button](/assets/temp-1b-reflash-pic-4.png)
 
-6\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window.
+7\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window.
 
 ![Web installer dialog showing Installation complete after flashing the TEMP-1B, with the Next button](/assets/temp-1b-reflash-pic-7.png)
 
 !!! warning "Power cycle your device before doing anything else!"
 
     Your device is still in boot mode and needs to be power cycled aka power removed to make it boot in a normal mode!
 
-7\. Please <a href="https://wiki.apolloautomation.com/homey/products/general/setup/getting-started/" target="_blank" rel="noopener">proceed to the getting started guide</a> and set up your sensor as a new device!
+8\. Please <a href="https://wiki.apolloautomation.com/homey/products/general/setup/getting-started/" target="_blank" rel="noopener">proceed to the getting started guide</a> and set up your sensor as a new device!

docs/products/air1/troubleshooting/air1-code.md

@@ -13,23 +13,23 @@ If your Apollo AIR-1 becomes unresponsive and you've exhausted the other trouble
 
 ## Re-flash the factory firmware
 
-Follow these steps to put the factory firmware back on your AIR-1 from the Apollo AIR-1 Installer.
+Follow these steps to put the factory firmware back on your AIR-1 from the Apollo AIR-1 installer.
 
 1\. <a href="https://wiki.apolloautomation.com/products/air1/troubleshooting/air1-boot-mode/" target="_blank" rel="noreferrer nofollow noopener">Put your AIR-1 in boot mode</a>: hold down the boot button (the right of the two buttons beside the USB-C port), then plug in the USB cable. Let go of the button once the cable is in.
 
 ![Tool pointing to the AIR-1 boot button, the right of two buttons beside the USB-C port](/assets/air-1-boot-button.jpg)
 
-2\. Navigate to the <a href="https://apolloautomation.github.io/AIR-1/" target="_blank" rel="noreferrer nofollow noopener">Apollo AIR-1 Installer</a>.
+2\. Open the <a href="https://install.apolloautomation.com/#/air-1" target="_blank" rel="noreferrer nofollow noopener">Apollo AIR-1 installer</a>.
 
-3\. Click the big **Connect** button on the installer page.
+3\. Click **Connect & Install** on the installer page.
 
-![Apollo AIR-1 Installer page with the Connect button highlighted](/assets/air-1-reflash-pic-1.png)
+![AIR-1 page of the Apollo installer with the Connect & Install button outlined in red](/assets/installer-air-1.png)
 
 4\. In the browser pop-up, select your AIR-1's open serial (COM) port, then click **Connect**. In the screenshot below, it's listed as USB JTAG/serial debug unit.
 
 ![Browser serial port dialog with the USB JTAG/serial debug unit port and the Connect button](/assets/air-1-reflash-pic-2-1.png)
 
-5\. Click **Install AIR-1**.
+5\. Click **Install ApolloAutomation.AIR-1**.
 
 ![Installer Device Dashboard with the Install AIR-1 option highlighted](/assets/air-1-reflash-pic-3.png)