Skip to content

docs: link reflash guides to the new Apollo installer - #1168

Merged
Bunton33 merged 3 commits into
devfrom
docs/new-installer-links
Oct 19, 2026
Merged

Bunton33 merged 3 commits into
devfrom
docs/new-installer-links

Conversation

@Bunton33

Copy link
Copy Markdown
Contributor

Points every firmware reflash guide at its own page on the new Apollo installer, https://install.apolloautomation.com/, instead of the old apolloautomation.github.io/<PRODUCT>/ installers.

Installer links (31 pages)

  • Each product links its own page: #/air-1, #/msr-1, #/msr-2, #/mtr-1, #/r-pro-1, #/temp-1, #/plt-1, #/btn-1, #/pump-1, #/h-1 and #/h-2, on both the Home Assistant and Homey pages, plus the FAQs and the H-2 getting started page.
  • Steps use the installer's own labels: the variant button (USB Power, Battery Power, WiFi, Ethernet, Smart (Wi-Fi)), then Connect & Install.
  • Firmware option names in the dialog step match the current manifests, for example Install ApolloAutomation.MSR-1_Factory and Install Apollo.TEMP-1_R2.
  • New screenshots: 13 headless captures of the installer pages, light theme, with the variant and button outlined.
  • B models: the TEMP-1B and PLT-1B use their parent's page with Battery Power.
  • Older links kept on purpose:
    • TEMP-1 Revision 1 builds are only on the classic installer, so the R1 tips link it and name its firmware option.
    • The TEMP Pro-1 isn't on the new installer and keeps its classic link.
  • Style guide and AGENTS.md: a new rule for installer links.

LED-1

The old reflash page linked a WLED-MM beta built for the Adafruit MatrixPortal ESP32-S3, which is the M-1's board. The LED-1 is a classic ESP32 (its pinout uses GPIO 22, 25 and 27), so that file can't flash it.

  • The page now uses the official WLED web installer (install.wled.me, Basic mode, Plain).
  • It then sets the LED-1 pins in WLED 16. The microphone pins come first because WLED's default microphone WS pin is GPIO 15, which Output 2 needs. Menu labels were checked against the WLED v16.0.1 source.
  • The FAQ answer now links the guide.

Shot list items

  • Zone diagram: radar-gates-colored.png is redrawn with all 8 gates to 6 m, matching ld2410-gate-map.png, with updated alt text on 4 pages.
  • Homey R PRO-1 zones page: a real R PRO-1 capture of the LD2450 Bluetooth switch replaces the MTR-1 one. The switch was set back to off afterward.
  • PLT-1B photo: plt-boot-mode-pic-4.jpg went from 3.6 MB at 3024x4032 to 227 KB at 750 px wide.
  • TEMP Pro-1 FAQ: PoE is 802.3af.

Checks

  • check_markdown: 0 errors.
  • check_secrets: 0.
  • check_images: 0 with GPS data.
  • mkdocs build: succeeds.
  • check_links: 681 pages, 0 broken, 0 bad anchors.
  • Built site: the only apolloautomation.github.io/<PRODUCT>/ links left are the 4 TEMP-1 R1 tips and the TEMP Pro-1.

Needs a human (installer site, not the wiki)

  • The new installer has no TEMP Pro-1 or LED-1 page and no TEMP-1 Revision 1 option.
  • MSR-2: the new installer flashes MSR-2/firmware (ApolloAutomation.MSR-2, 1,752,592 bytes). The classic one flashes firmware-factory (MSR-2_Factory, 1,777,600 bytes). MSR-1 still uses the Factory build on the new installer.
  • Old dialog screenshots: the ESP Web Tools dialog screenshots on these pages still show older firmware names, for example "INSTALL MSR-1". Retaking them needs a device plugged in.

🤖 Generated with Claude Code

Bunton33 and others added 3 commits October 18, 2026 23:26
The LED-1 reflash page linked a WLED-MM beta built for the Adafruit
MatrixPortal ESP32-S3 (an M-1 board). The LED-1 is a classic ESP32
(GPIO 22, 25, and 27), so that binary can't flash it. Use
install.wled.me in Basic mode instead, then set the LED-1 pins in
WLED 16 (Usermods first, because the AudioReactive default WS pin is
GPIO 15, then LED & Hardware). The FAQ answer now links the guide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Redraw radar-gates-colored.png with all 8 LD2410 gates to 6 m, in the
  style of ld2410-gate-map.png, and update its alt text on 4 pages.
- Replace the MTR-1 Bluetooth screenshot on the Homey R PRO-1 zones page
  with a real R PRO-1 web page capture and drop the "Shown on" caption.
- Resize plt-boot-mode-pic-4.jpg from 3024x4032 (3.6 MB) to 750 px wide.
- TEMP Pro-1 FAQ: PoE is 802.3af, matching the R PRO-1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Every reflash guide now opens the product's own page on
install.apolloautomation.com (#/air-1, #/temp-1, ...) instead of the old
apolloautomation.github.io installers. Steps name the variant buttons
(USB Power, Battery Power, WiFi, Ethernet, Smart (Wi-Fi)) and
Connect & Install exactly as the installer shows them, the firmware
option names match the current manifests, and each page gets a new
screenshot of its installer page.

- TEMP-1B and PLT-1B use their parent's page with Battery Power.
- TEMP-1 Revision 1 firmware is only on the classic installer, so the
  R1 tips link it and name its firmware option.
- TEMP Pro-1 isn't on the new installer and keeps its classic link.
- Style guide and AGENTS.md: new rule for installer links.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Oct 19, 2026

Copy link
Copy Markdown

Review in Change Stack →

Note

Currently processing new changes in this PR. This may take a few minutes, please wait...

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 696be9fc-e42b-4451-9def-4cc0f55f9236
📥 Commits

Reviewing files that changed from the base of the PR and between 24b8419 and 50d60e5.

⛔ Files ignored due to path filters: 17
  • docs/assets/installer-air-1.png is excluded by !**/*.png
  • docs/assets/installer-btn-1.png is excluded by !**/*.png
  • docs/assets/installer-h-1.png is excluded by !**/*.png
  • docs/assets/installer-h-2-smart.png is excluded by !**/*.png
  • docs/assets/installer-msr-1.png is excluded by !**/*.png
  • docs/assets/installer-msr-2.png is excluded by !**/*.png
  • docs/assets/installer-mtr-1.png is excluded by !**/*.png
  • docs/assets/installer-plt-1-battery-power.png is excluded by !**/*.png
  • docs/assets/installer-plt-1-usb-power.png is excluded by !**/*.png
  • docs/assets/installer-pump-1.png is excluded by !**/*.png
  • docs/assets/installer-r-pro-1-wifi.png is excluded by !**/*.png
  • docs/assets/installer-temp-1-battery-power.png is excluded by !**/*.png
  • docs/assets/installer-temp-1-usb-power.png is excluded by !**/*.png
  • docs/assets/plt-boot-mode-pic-4.jpg is excluded by !**/*.jpg
  • docs/assets/r-pro-1-toggle-on-ld2450-bluetooth.png is excluded by !**/*.png
  • docs/assets/radar-gates-colored.png is excluded by !**/*.png
  • docs/assets/wled-installer-plain.png is excluded by !**/*.png
📒 Files selected for processing: 36
  • AGENTS.md
  • STYLE_GUIDE.md
  • docs/homey/products/air1/troubleshooting/air1-code.md
  • docs/homey/products/led1/troubleshooting/led1-reflash.md
  • docs/homey/products/msr2/setup/msr2-general-tips.md
  • docs/homey/products/msr2/troubleshooting/msr2-code.md
  • docs/homey/products/mtr1/troubleshooting/mtr1-code.md
  • docs/homey/products/plt1/troubleshooting/plt1-code.md
  • docs/homey/products/plt1b/troubleshooting/plt1b-code.md
  • docs/homey/products/rpro1/faq.md
  • docs/homey/products/rpro1/setup/zones-hlk.md
  • docs/homey/products/temp1/troubleshooting/temp1-code.md
  • docs/homey/products/temp1b/troubleshooting/temp1b-code.md
  • docs/products/air1/troubleshooting/air1-code.md
  • docs/products/btn1/troubleshooting/btn1-reflash.md
  • docs/products/general/calibrating-and-updating/mmwave-videos.md
  • docs/products/h1/reflash.md
  • docs/products/h2/faq.md
  • docs/products/h2/setup/getting-started.md
  • docs/products/h2/troubleshooting/reflash.md
  • docs/products/led1/faq.md
  • docs/products/led1/troubleshooting/led1-reflash.md
  • docs/products/msr1/setup/general-tips.md
  • docs/products/msr1/troubleshooting/msr1-code.md
  • docs/products/msr2/setup/msr2-general-tips.md
  • docs/products/msr2/troubleshooting/msr2-code.md
  • docs/products/mtr1/troubleshooting/mtr1-code.md
  • docs/products/new-product-template/troubleshooting/productname-reflash.md
  • docs/products/plt1/troubleshooting/plt1-code.md
  • docs/products/plt1b/troubleshooting/plt1b-code.md
  • docs/products/pump1/troubleshooting/pump1-reflash.md
  • docs/products/rpro1/faq.md
  • docs/products/rpro1/troubleshooting/rpro1-code.md
  • docs/products/temp1/troubleshooting/temp1-code.md
  • docs/products/temp1b/troubleshooting/temp1b-code.md
  • docs/products/temppro1/faq.md
+-----------------------------------------------------------+
| Ultimately, we're all just debugging someone else's code. |
+-----------------------------------------------------------+
  \
   \   (\__/)
       (•ㅅ•)
       /   づ
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Bunton33
Bunton33 merged commit 09ff250 into dev Oct 19, 2026
2 of 3 checks passed
@Bunton33
Bunton33 deleted the docs/new-installer-links branch October 19, 2026 03:30
@Bunton33 Bunton33 mentioned this pull request Oct 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants