Bunton33 · Oct 23, 2026 · Oct 23, 2026 · Oct 23, 2026
diff --git a/STYLE_GUIDE.md b/STYLE_GUIDE.md
@@ -172,6 +172,16 @@ where the Apollo installer has no equivalent: TEMP-1 Revision 1
 firmware. The LED-1 uses the official WLED installer at
 `https://install.wled.me/`.
 
+**Boot mode with two buttons.** When a step uses both the boot and reset
+buttons, write the order as three bullets (press and hold **boot**; while
+still holding it, press and release **reset**; let go of **boot**), then a
+`warning` admonition titled "Keep holding boot the whole time" that says
+pressing **reset** alone only restarts the device. Put both before the
+photo or clip. Clips of the sequence carry step captions ("1 Press and hold
+BOOT", "2 Keep holding BOOT. Tap RESET.", "3 Let go of BOOT") so a reader
+who only watches still holds boot. A customer once watched an uncaptioned
+clip, saw a finger resting on the board, and pressed reset alone.
+
 ---
 
 ## 6. Voice and structure

diff --git a/docs/assets/btn-1-boot-mode-method-2.webp b/docs/assets/btn-1-boot-mode-method-2.webp
diff --git a/docs/assets/cast-1-boot-mode-method-2.webp b/docs/assets/cast-1-boot-mode-method-2.webp
diff --git a/docs/assets/esphome-starter-kit-boot-mode.webp b/docs/assets/esphome-starter-kit-boot-mode.webp
diff --git a/docs/assets/h-2-boot-mode-method-2-boot-reset-buttons.webp b/docs/assets/h-2-boot-mode-method-2-boot-reset-buttons.webp
diff --git a/docs/assets/pump-1-hold-boot-and-reset-button-video.webp b/docs/assets/pump-1-hold-boot-and-reset-button-video.webp
diff --git a/docs/homey/products/air1/troubleshooting/air1-boot-mode.md b/docs/homey/products/air1/troubleshooting/air1-boot-mode.md
@@ -21,13 +21,21 @@ You'll hold the boot button while you plug in the USB-C cable, so the device sta
 
 ## Method 2: Boot and reset buttons
 
-You'll use the boot and reset buttons together to put the device into boot mode while it's plugged into your computer.
+You'll plug the device into your computer, then hold the boot button down while you press and release the reset button.
 
 1\. Unplug the device and locate the boot and reset buttons as shown in the image below.
 
 2\. Plug it into your computer.
 
-3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your AIR-1 in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (the right button, next to the USB-C port). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (the left button).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the AIR-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 ![AIR-1 reset and boot buttons boxed and labeled with arrows next to the USB-C port](/assets/air-1-reset-boot-buttons-arrows.jpg)
 

diff --git a/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md b/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md
@@ -22,13 +22,21 @@ You'll hold the boot button while you plug in the USB-C cable.
 
 ## Method 2: Boot and reset buttons
 
-You'll use the boot and reset buttons together while the device is plugged into your computer.
+You'll plug the device into your computer, then hold the boot button down while you press and release the reset button.
 
 1\. Unplug the device and locate the boot button (the right opening, shown in the image above) and the reset button (the left opening, shown in the image below).
 
 2\. Plug it into your computer.
 
-3\. Hold down the boot button (the right button), then press and release the reset button (the left button) while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your MSR-2 in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (the right button). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (the left button).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the MSR-2. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 ![MSR-2 case side with a tool pointing at the left opening for the reset button](/assets/msr-2-reset-button.jpg)
 

diff --git a/docs/homey/products/mtr1/troubleshooting/mtr1-boot-mode.md b/docs/homey/products/mtr1/troubleshooting/mtr1-boot-mode.md
@@ -22,13 +22,21 @@ You'll hold the boot button while you plug in the USB-C cable.
 
 ## Method 2: Boot and reset buttons
 
-You'll use the boot and reset buttons together while the device is plugged into your computer.
+You'll plug the device into your computer, then hold the boot button down while you press and release the reset button.
 
 1\. Unplug the device and locate the boot button (the right opening, shown in the image above) and the reset button (the left opening, shown in the image below).
 
 2\. Plug it into your computer.
 
-3\. Hold down the boot button (the right button), then press and release the reset button (the left button) while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your MTR-1 in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (the right button). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (the left button).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the MTR-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 ![Tool pointing to the reset button opening on the side of the MTR-1 case](/assets/mtr-1-reset-button.jpg)
 

diff --git a/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md b/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md
@@ -22,13 +22,21 @@ You can put your device into boot mode with only the boot button and a USB-C cab
 
 ## Method 2: Boot and reset buttons
 
-You can also put your device into boot mode by pressing the reset button while you hold the boot button.
+You can also put your device into boot mode by holding the boot button down while you press and release the reset button.
 
 1\. Unplug the device and locate the boot button (on the side, shown in the image above) and the reset button (near the USB-C port, shown in the image below).
 
 2\. Plug it into your computer.
 
-3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your PLT-1 in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (on the side, shown in the image above). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (near the USB-C port, shown in the image below).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the PLT-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 ![Top of the PLT-1 with the reset button circled next to the plugged in USB-C cable](/assets/screenshot-2024-10-23-at-12-35-01-pm.png)
 

diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md b/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md
@@ -26,11 +26,19 @@ You can put your device into boot mode with only the boot button and a pin.
 
 ## Method 2: Boot and reset buttons
 
-You can also put your device into boot mode by pressing the reset button while you hold the boot button.
+You can also put your device into boot mode by holding the boot button down while you press and release the reset button.
 
 1\. Plug in the device
 
-2\. Press and hold the boot button, while holding it press and release the reset button, then release the boot button
+2\. Put your PLT-1B in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (next to the USB-C port, shown in the images above). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (labeled RST, shown in the images below).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the PLT-1B. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 ![Tool pointing to the reset button on the PLT-1B PCB](/assets/plt-boot-mode-pic-6.jpg)
 

diff --git a/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md b/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md
@@ -28,12 +28,20 @@ If you prefer, please remove the lid by gently prying up on the small slit by th
 
 ## Method 2: Boot and reset buttons
 
-You can also open the case and use the boot and reset buttons together to put your device into boot mode.
+You can also open the case and put your device into boot mode by holding the boot button down while you press and release the reset button.
 
 1\. Unplug the device and remove the case as shown in the images above
 
 2\. Plug it into your computer.
 
-3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your TEMP-1 in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (labeled BOOT, shown above). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (labeled RST, at the opposite end of the board from **boot**).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the TEMP-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 4\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/homey/products/temp1/troubleshooting/temp1-code/).
diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md b/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md
@@ -28,12 +28,20 @@ If you prefer, please remove the lid by gently prying up on the small slit by th
 
 ## Method 2: Boot and reset buttons
 
-Use this method to put your device into boot mode with the case removed, using both the boot and reset buttons.
+Use this method to put your device into boot mode with the case removed, by holding the boot button down while you press and release the reset button.
 
 1\. Unplug the device and remove the case as shown in the images above
 
 2\. Plug it into your computer.
 
-3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your TEMP-1B in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (labeled BOOT, shown above). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (labeled RST, at the opposite end of the board from **boot**).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the TEMP-1B. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 4\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/homey/products/temp1b/troubleshooting/temp1b-code/).
diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md
@@ -203,9 +203,17 @@ The device is required to be flashed via USB using the bootloader mode the very
 
 ![Plugging the USB-C cable into the ESP32-C6 board](../../../assets/esphome-starter-kit-plug-in-usb-c.webp)
 
-2\. Hold down the boot button. While still holding the boot button, press and release the reset button, then release the boot button.
+2\. Put your ESP32-C6 in boot mode. Use both buttons, in this order:
 
-![Holding the BOOT button on the ESP32-C6 while pressing and releasing RESET](../../../assets/esphome-starter-kit-boot-mode.webp)
+- Press and hold the **Boot** button (labeled BOOT on the board, to the left of the USB-C port when the cable points toward you). Keep holding it.
+- While you're still holding **Boot**, press and release the **Reset** button (labeled RESET, to the right of the USB-C port).
+- Let go of **Boot**.
+
+!!! warning "Keep holding Boot the whole time"
+
+    Pressing **Reset** by itself only restarts the ESP32-C6. It goes into boot mode only when **Boot** is held down while you press and release **Reset**.
+
+![Animation with step captions: press and hold Boot on the ESP32-C6, keep holding it while you tap Reset, then let go of Boot](../../../assets/esphome-starter-kit-boot-mode.webp)
 
 3\. Your device is now in boot mode. The ESP32-C6 will now stay in bootloader mode until you flash it.
 

diff --git a/docs/products/air1/troubleshooting/air1-boot-mode.md b/docs/products/air1/troubleshooting/air1-boot-mode.md
@@ -22,13 +22,21 @@ With this method, you hold the boot button while you plug in the USB-C cable.
 
 ## Method 2: Boot and reset buttons
 
-With this method, you use the boot and reset buttons while the device is plugged into your computer.
+With this method, you plug the device into your computer, then hold the boot button down while you press and release the reset button.
 
 1\. Unplug the device and locate the boot and reset buttons as shown in the image below.
 
 2\. Plug it into your computer.
 
-3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your AIR-1 in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (the right button, next to the USB-C port). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (the left button).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the AIR-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 ![AIR-1 case with arrows labeling the reset button on the left and the boot button on the right](/assets/air-1-reset-boot-buttons-arrows.jpg)
 

diff --git a/docs/products/btn1/troubleshooting/btn1-boot-mode.md b/docs/products/btn1/troubleshooting/btn1-boot-mode.md
@@ -22,7 +22,7 @@ This method puts your device into boot mode using only the boot button.
 
 ![Holding the BTN-1 boot button on the right while plugging in the USB-C cable](/assets/btn-1-boot-mode-method-1.webp)
 
-4\. You are now ready to reflash your device!
+3\. You are now ready to reflash your device!
 
 [Click here to go to the reflashing guide!](https://wiki.apolloautomation.com/products/btn1/troubleshooting/btn1-reflash/){       .md-button .md-button--primary }
 
@@ -38,10 +38,18 @@ This method uses the boot and reset buttons, and it's the one to use if your dev
 
 ![Back of the BTN-1 with arrows labeling the reset button on the left and the boot button on the right](/assets/btn-1-reset-boot-buttons.png)
 
-2\. Hold down the boot button (the right button), then press and release the reset button (the left button) while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your BTN-1 in boot mode. Use both buttons, in this order:
 
-![Holding the BTN-1 boot button while pressing and releasing the reset button](/assets/btn-1-boot-mode-method-2.webp)
+- Press and hold the **boot** button (the right button). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (the left button).
+- Let go of **boot**.
 
-3\. You are now ready to reflash your device!
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the BTN-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
+
+![Animation with step captions: press and hold boot on the BTN-1, keep holding it while you tap reset, then let go of boot](/assets/btn-1-boot-mode-method-2.webp)
+
+4\. You are now ready to reflash your device!
 
 [Click here to go to the reflashing guide!](https://wiki.apolloautomation.com/products/btn1/troubleshooting/btn1-reflash/){       .md-button .md-button--primary }
diff --git a/docs/products/btn1/troubleshooting/btn1-reflash.md b/docs/products/btn1/troubleshooting/btn1-reflash.md
@@ -16,9 +16,17 @@ description: Step by step guide for reflashing The BTN-1.
 
 ![Back of the BTN-1 with arrows labeling the reset button on the left and the boot button on the right](/assets/btn-1-reset-boot-buttons.png)
 
-3\. Hold down the boot button (the right button), then press and release the reset button (the left button) while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your BTN-1 in boot mode. Use both buttons, in this order:
 
-![Holding the BTN-1 boot button while pressing and releasing the reset button](/assets/btn-1-boot-mode-method-2.webp)
+- Press and hold the **boot** button (the right button). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (the left button).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the BTN-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
+
+![Animation with step captions: press and hold boot on the BTN-1, keep holding it while you tap reset, then let go of boot](/assets/btn-1-boot-mode-method-2.webp)
 
 4\. Open the <a href="https://install.apolloautomation.com/#/btn-1" target="_blank" rel="noreferrer nofollow noopener">Apollo BTN-1 installer</a> in a Chromium-based browser such as Chrome or Edge and click **Connect & Install**. Select the open com port and click **Connect**.
 

diff --git a/docs/products/cast1/troubleshooting/cast1-boot-mode.md b/docs/products/cast1/troubleshooting/cast1-boot-mode.md
@@ -28,9 +28,17 @@ This method puts your device into boot mode with the boot and reset buttons.
 
 ![CAST-1 case with labels pointing to the boot button on the left and the reset button on the right](/assets/cast-1-boot-reset-buttons.webp)
 
-3\. Hold down the **boot** button (on the left), then press and release the **reset** button (on the right) while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your CAST-1 in boot mode. Use both buttons, in this order:
 
-![Holding the CAST-1 boot button while pressing and releasing the reset button beside it](/assets/cast-1-boot-mode-method-2.webp)
+- Press and hold the **boot** button (on the left). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (on the right).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the CAST-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
+
+![Animation with step captions: press and hold boot on the CAST-1, keep holding it while you tap reset, then let go of boot](/assets/cast-1-boot-mode-method-2.webp)
 
 4\. You are now ready to reflash your device!
 

diff --git a/docs/products/cast1/troubleshooting/cast1-reflash.md b/docs/products/cast1/troubleshooting/cast1-reflash.md
@@ -17,9 +17,17 @@ description: Step by step guide for reflashing The CAST-1.
 
 ![CAST-1 case with labels pointing to the boot button on the left and the reset button on the right](/assets/cast-1-boot-reset-buttons.webp)
 
-3\. Put the CAST-1 into boot mode. Hold down the **boot** button (on the left), then press and release the **reset** button (on the right) while keeping the boot button pressed. Finally, release the boot button.
+3\. Put your CAST-1 in boot mode. Use both buttons, in this order:
 
-![Holding the CAST-1 boot button while pressing and releasing the reset button beside it](/assets/cast-1-boot-mode-method-2.webp)
+- Press and hold the **boot** button (on the left). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (on the right).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the CAST-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
+
+![Animation with step captions: press and hold boot on the CAST-1, keep holding it while you tap reset, then let go of boot](/assets/cast-1-boot-mode-method-2.webp)
 
 4\. Open the <a href="https://install.apolloautomation.com/#/cast-1" target="_blank" rel="noreferrer nofollow noopener">Apollo CAST-1 Installer</a>.
 

diff --git a/docs/products/h1/boot-mode.md b/docs/products/h1/boot-mode.md
@@ -22,6 +22,14 @@ You can also enter boot mode with the boot and reset buttons while the device is
 
 1\. Plug in the device
 
-2\. Press and hold the boot button, while holding it press and release the reset button, then release the boot button
+2\. Put your H-1 in boot mode. Use both buttons, in this order:
+
+- Press and hold the **boot** button (circled in the photo above). Keep holding it.
+- While you're still holding **boot**, press and release the **reset** button (also circled in the photo above).
+- Let go of **boot**.
+
+!!! warning "Keep holding boot the whole time"
+
+    Pressing **reset** by itself only restarts the H-1. It goes into boot mode only when **boot** is held down while you press and release **reset**.
 
 3\. Continue with [uploading the firmware](https://wiki.apolloautomation.com/products/h1/reflash/)