From e94d66d81e4b9c697b41cd59522da03c25ea0d0d Mon Sep 17 00:00:00 2001 From: Justin Bunton <130115204+Bunton33@users.noreply.github.com> Date: Mon, 12 Oct 2026 06:16:00 -0400 Subject: [PATCH 1/4] docs: add descriptive alt text to every image - Write alt text for 1,533 images that had none (markdown ![]() and tags without alt), across 281 pages and snippets. Writers looked at 1,254 of the images; an independent reviewer per chunk spot-checked 665 more and corrected 62. - Replace 211 alt texts that were only a file name ("image.png", "Alarmo 3.png") or started with "Image of"; reviewers corrected 14. - Only alt text changed: every file was checked against HEAD with a script that fails on any other difference. The built site goes from 2,452 images without alt text to 0. Co-Authored-By: Claude Opus 5.5 --- .../bluetooth-proxy/method1-finish.md | 6 +- .../bluetooth-proxy/method1-steps.md | 4 +- docs/_snippets/bluetooth-proxy/method2.md | 6 +- docs/homey.md | 2 +- .../air1/addons/adding-co2-to-air-1.md | 16 ++-- .../addons/adding-gpio-header-to-air-1.md | 18 ++-- .../air-1-temp-calibration.md | 2 +- .../air-quality-notification-example.md | 34 ++++---- .../homey/products/air1/setup/general-tips.md | 4 +- .../air1/troubleshooting/air1-boot-mode.md | 4 +- .../air1/troubleshooting/air1-code.md | 12 +-- .../air1-reset-wi-fi-credentials.md | 2 +- .../sensor-connection-check.md | 8 +- .../co2-calibration.md | 12 +-- .../calibrating-and-updating/mmwave-videos.md | 10 +-- docs/homey/products/general/introduction.md | 2 +- ...dding-apollo-devices-to-hidden-networks.md | 12 +-- .../products/general/setup/getting-started.md | 18 ++-- .../general/setup/renaming-apollo-devices.md | 4 +- .../products/general/supported-platforms.md | 2 +- .../removing-device-from-homey.md | 4 +- .../high-co2-notification-example.md | 34 ++++---- .../adding-articulating-stand-to-msr-2.md | 12 +-- .../msr2/addons/adding-co2-to-msr-2.md | 12 +-- .../addons/adding-gpio-header-to-msr-2.md | 16 ++-- .../addons/adding-rear-female-usb-to-msr-2.md | 16 ++-- .../products/msr2/addons/msr2-outlet-mount.md | 8 +- docs/homey/products/msr2/calibrating-co2.md | 6 +- .../products/msr2/examples/msr2-alarmo.md | 14 ++-- .../products/msr2/examples/msr2-dashboards.md | 8 +- .../msr2/examples/using-msr-2-buzzer.md | 4 +- .../products/msr2/setup/msr2-general-tips.md | 10 +-- docs/homey/products/msr2/setup/zones-ha.md | 10 +-- docs/homey/products/msr2/setup/zones-hlk.md | 20 ++--- .../msr2/troubleshooting/msr2-boot-mode.md | 4 +- .../msr2/troubleshooting/msr2-code.md | 12 +-- .../msr2-reset-wi-fi-credentials.md | 2 +- .../addons/adding-90-degree-usb-c-to-mtr-1.md | 10 +-- .../adding-articulating-stand-to-mtr-1.md | 10 +-- .../mtr1/addons/adding-co2-to-mtr-1.md | 16 ++-- .../addons/adding-gpio-header-to-mtr-1.md | 16 ++-- .../addons/adding-rear-male-usb-to-mtr-1.md | 14 ++-- ...mtr-1-home-assistant-dashboard-examples.md | 8 +- .../products/mtr1/examples/mtr1-alarmo.md | 14 ++-- .../mtr1/examples/using-mtr-1-buzzer.md | 4 +- .../homey/products/mtr1/setup/general-tips.md | 10 +-- docs/homey/products/mtr1/setup/zones-hlk.md | 16 ++-- .../mtr1/troubleshooting/mtr1-boot-mode.md | 4 +- .../mtr1/troubleshooting/mtr1-code.md | 12 +-- .../mtr1-reset-wi-fi-credentials.md | 4 +- .../products/plt1/examples/flower-card.md | 2 +- docs/homey/products/plt1/general-tips.md | 4 +- .../products/plt1/setup/prevent-sleep.md | 4 +- .../plt1/troubleshooting/plt1-boot-mode.md | 4 +- .../plt1/troubleshooting/plt1-code.md | 12 +-- .../plt1-reset-wi-fi-credentials.md | 2 +- docs/homey/products/plt1b/general-tips.md | 4 +- .../products/plt1b/setup/prevent-sleep.md | 4 +- .../plt1b/troubleshooting/plt1b-boot-mode.md | 10 +-- .../plt1b/troubleshooting/plt1b-code.md | 18 ++-- .../plt1b-reset-wi-fi-credentials.md | 4 +- docs/homey/products/rpro1/setup/zones-hlk.md | 18 ++-- .../homey/products/temp1/addons/food-probe.md | 10 +-- .../products/temp1/addons/magnetic-mount.md | 14 ++-- .../temp1/examples/temp1-alert-example.md | 6 +- .../examples/temp1-automation-examples.md | 80 +++++++++--------- .../products/temp1/setup/prevent-sleep.md | 4 +- .../temp1/troubleshooting/temp1-boot-mode.md | 6 +- .../temp1/troubleshooting/temp1-code.md | 10 +-- .../temp1-reset-wi-fi-credentials.md | 4 +- .../temp1/troubleshooting/temp1-teardown.md | 12 +-- .../products/temp1b/addons/food-probe.md | 10 +-- .../products/temp1b/addons/magnetic-mount.md | 14 ++-- .../temp1b/examples/temp1b-alert-example.md | 6 +- .../examples/temp1b-automation-examples.md | 80 +++++++++--------- .../products/temp1b/setup/insert-battery.md | 26 +++--- .../products/temp1b/setup/prevent-sleep.md | 4 +- .../troubleshooting/temp1b-boot-mode.md | 6 +- .../temp1b/troubleshooting/temp1b-code.md | 8 +- .../temp1b-reset-wi-fi-credentials.md | 2 +- .../temp1b/troubleshooting/temp1b-teardown.md | 8 +- .../automations/button-controlled-leds.md | 8 +- .../automations/motion-activated-light.md | 14 ++-- .../automations/play-a-tune.md | 8 +- .../automations/press-to-check-climate.md | 2 +- .../automations/temp-reactive-leds.md | 8 +- .../ESPHome-Starter-Kit/community-corner.md | 4 +- .../everyday-use/button-toggles-room-light.md | 8 +- .../motion-activated-room-lights.md | 16 ++-- .../play-a-tune-from-home-assistant.md | 18 ++-- .../temperature-on-your-dashboard.md | 4 +- .../everyday-use/trash-night-reminder.md | 8 +- docs/products/ESPHome-Starter-Kit/faq.md | 2 +- .../learning-the-basics/core-components.md | 4 +- .../device-builder-tour.md | 18 ++-- .../learning-the-basics/explaining-esphome.md | 2 +- .../how-esphome-talks-to-home-assistant.md | 2 +- .../learning-the-basics/what-is-i2c.md | 2 +- .../what-is-secrets-yaml.md | 2 +- .../learning-the-basics/what-is-yaml.md | 2 +- .../modules/apollo-breakout-module.md | 20 ++--- .../ESPHome-Starter-Kit/modules/battery.md | 2 +- .../sen65-air-quality-sensor.md | 4 +- .../breakout-addons/temperature-probe.md | 2 +- .../modules/button-module.md | 20 ++--- .../modules/motion-module.md | 16 ++-- .../modules/rgb-buzzer-module.md | 20 ++--- .../modules/temperature-humidity-module.md | 16 ++-- .../ESPHome-Starter-Kit/setup/first-steps.md | 30 +++---- .../ESPHome-Starter-Kit/start-here.md | 20 ++--- .../tutorials/bluetooth-proxy.md | 4 +- .../tutorials/connect-to-home-assistant.md | 2 +- .../tutorials/light-effects.md | 8 +- .../tutorials/remote-build-server.md | 8 +- .../tutorials/using-secrets.md | 4 +- .../adding-co2-to-air-1-mesh-case-design.md | 4 +- .../air1/addons/adding-co2-to-air-1.md | 16 ++-- .../addons/adding-gpio-header-to-air-1.md | 18 ++-- .../air-1-temp-calibration.md | 4 +- .../air1/examples/air1-dashboard-examples.md | 16 ++-- .../air1/examples/firstof9's-apex-charts.md | 20 ++--- docs/products/air1/setup/general-tips.md | 4 +- .../air1/troubleshooting/air1-boot-mode.md | 4 +- .../air1/troubleshooting/air1-code.md | 12 +-- .../air1-reset-wi-fi-credentials.md | 2 +- docs/products/apolloodroid/getting-started.md | 6 +- docs/products/apolloodroid/introduction.md | 2 +- .../scd40-breakout-board/introduction.md | 4 +- .../introduction.md | 4 +- docs/products/btn1/examples/blueprint.md | 14 ++-- .../btn1/examples/example-automation.md | 4 +- docs/products/btn1/setup/general-tips.md | 8 +- docs/products/btn1/setup/getting-started.md | 26 +++--- .../btn1/troubleshooting/btn1-boot-mode.md | 8 +- .../btn1/troubleshooting/btn1-reflash.md | 12 +-- .../btn1-reset-wi-fi-credentials.md | 4 +- .../btn1/troubleshooting/btn1-teardown.md | 16 ++-- .../additional-info/esphome-device-builder.md | 12 +-- docs/products/cast1/addons/ethernet-module.md | 2 +- .../cast1/examples/wizmote-blueprint.md | 4 +- docs/products/cast1/introduction.md | 2 +- docs/products/cast1/setup/getting-started.md | 16 ++-- .../cast1/troubleshooting/cast1-boot-mode.md | 6 +- .../cast1/troubleshooting/cast1-reflash.md | 6 +- .../cast1-reset-wi-fi-credentials.md | 2 +- docs/products/dev1/introduction.md | 2 +- docs/products/dev2/introduction.md | 2 +- .../battery-sensors/awake-ha-helper.md | 24 +++--- .../general/battery-sensors/prevent-sleep.md | 4 +- .../sensor-connection-check.md | 8 +- .../battery-sensors/wake-up-battery-sensor.md | 14 ++-- .../calibrate-plt1.md | 18 ++-- .../co2-calibration-quick.md | 6 +- .../co2-calibration.md | 14 ++-- .../calibrating-and-updating/mmwave-videos.md | 8 +- .../updating-firmware.md | 12 +-- docs/products/general/introduction.md | 2 +- docs/products/general/piezo.md | 2 +- ...dding-apollo-devices-to-hidden-networks.md | 12 +-- .../general/setup/adjusting-wifi-power.md | 10 +-- .../general/setup/bluetooth-tracking.md | 12 +-- .../change-the-update-frequency-of-sensors.md | 4 +- .../products/general/setup/getting-started.md | 38 ++++----- ...how-to-add-temp-and-humidity-from-scd40.md | 8 +- .../general/setup/renaming-apollo-devices.md | 16 ++-- .../general/setup/switch-to-beta-branch.md | 12 +-- docs/products/general/supported-platforms.md | 2 +- .../troubleshooting/connection-issues.md | 4 +- .../opnsense-mdns-auto-discover-issue.md | 6 +- .../removing-device-from-home-assistant.md | 6 +- ...ubiquiti-unifi-mdns-auto-discover-issue.md | 20 ++--- .../tutorials/change-co2-update-interval.md | 4 +- ...-edit-your-sensor's-lux-update-interval.md | 6 +- docs/products/h1/boot-mode.md | 2 +- docs/products/h1/faq.md | 2 +- docs/products/h1/getting-started.md | 4 +- docs/products/h1/introduction.md | 2 +- docs/products/h1/reflash.md | 8 +- docs/products/h2/setup/getting-started.md | 2 +- docs/products/h2/troubleshooting/boot-mode.md | 6 +- docs/products/h2/troubleshooting/reflash.md | 8 +- .../led-1-controlling-govee-lights.md | 14 ++-- docs/products/led1/introduction.md | 2 +- .../led1/setup/getting-started-led1.md | 4 +- docs/products/led1/setup/led1-replace-fuse.md | 18 ++-- .../led1-find-ip-address-and-hostname.md | 6 +- .../led1/troubleshooting/led1-reflash.md | 6 +- .../m1/addons/adding-microphone-to-m-1.md | 8 +- docs/products/m1/addons/wizmote-remote.md | 2 +- docs/products/m1/examples/add-gifs-to-wled.md | 18 ++-- docs/products/m1/examples/pixel-forge.md | 8 +- docs/products/m1/examples/scrolling-text.md | 18 ++-- docs/products/m1/examples/sendspin.md | 2 +- .../share-data-from-home-assistant.md | 12 +-- .../m1/setup/getting-started-m1-esphome.md | 36 ++++---- docs/products/m1/setup/getting-started-m1.md | 24 +++--- docs/products/m1/setup/m1-matrix-settings.md | 10 +-- docs/products/m1/setup/m1-multiple-panels.md | 84 +++++++++---------- docs/products/m1/setup/m1-segments.md | 14 ++-- docs/products/m1/setup/use-without-wifi.md | 2 +- .../m1/troubleshooting/m1-boot-mode.md | 2 +- .../m1-find-ip-address-and-hostname.md | 6 +- .../m1/troubleshooting/m1-reflash-esphome.md | 2 +- .../products/m1/troubleshooting/m1-reflash.md | 4 +- .../msr1/additional-info/exposed-gpio.md | 2 +- .../msr1/addons/adding-co2-to-msr-1.md | 8 +- docs/products/msr1/examples/msr1-alarmo.md | 14 ++-- .../products/msr1/examples/msr1-dashboards.md | 8 +- .../msr1/examples/using-msr-1-buzzer.md | 4 +- docs/products/msr1/introduction.md | 2 +- docs/products/msr1/setup/general-tips.md | 12 +-- docs/products/msr1/setup/zones-ha.md | 10 +-- docs/products/msr1/setup/zones-hlk.md | 20 ++--- .../msr1/troubleshooting/msr1-boot-mode.md | 4 +- .../msr1/troubleshooting/msr1-code.md | 14 ++-- .../msr1-reset-wi-fi-credentials.md | 4 +- .../addons/adding-90-degree-usb-c-to-msr-2.md | 8 +- .../adding-articulating-stand-to-msr-2.md | 12 +-- .../msr2/addons/adding-co2-to-msr-2.md | 12 +-- .../addons/adding-gpio-header-to-msr-2.md | 16 ++-- .../addons/adding-rear-female-usb-to-msr-2.md | 16 ++-- .../products/msr2/addons/msr2-outlet-mount.md | 8 +- docs/products/msr2/calibrating-co2.md | 6 +- docs/products/msr2/examples/msr2-alarmo.md | 14 ++-- docs/products/msr2/setup/msr2-general-tips.md | 10 +-- .../msr2/setup/msr2-tuning-dashboard.md | 6 +- docs/products/msr2/setup/zones-ha.md | 12 +-- docs/products/msr2/setup/zones-hlk.md | 20 ++--- .../msr2/troubleshooting/msr2-boot-mode.md | 4 +- .../msr2/troubleshooting/msr2-code.md | 12 +-- .../msr2-reset-wi-fi-credentials.md | 2 +- .../addons/adding-90-degree-usb-c-to-mtr-1.md | 10 +-- .../adding-articulating-stand-to-mtr-1.md | 10 +-- .../mtr1/addons/adding-co2-to-mtr-1.md | 16 ++-- .../addons/adding-gpio-header-to-mtr-1.md | 16 ++-- .../addons/adding-rear-male-usb-to-mtr-1.md | 14 ++-- docs/products/mtr1/examples/mtr1-alarmo.md | 14 ++-- docs/products/mtr1/setup/general-tips.md | 10 +-- docs/products/mtr1/setup/zones-ha.md | 18 ++-- docs/products/mtr1/setup/zones-hlk.md | 16 ++-- .../mtr1/troubleshooting/mtr1-boot-mode.md | 4 +- .../mtr1/troubleshooting/mtr1-code.md | 12 +-- .../mtr1-reset-wi-fi-credentials.md | 4 +- .../addons/productname-addon.md | 2 +- .../new-product-template/introduction.md | 2 +- .../troubleshooting/productname-boot-mode.md | 6 +- .../troubleshooting/productname-reflash.md | 12 +-- .../productname-reset-wi-fi-credentials.md | 2 +- .../troubleshooting/productname-teardown.md | 10 +-- docs/products/plt1/examples/blueprint.md | 14 ++-- docs/products/plt1/examples/flower-card.md | 2 +- docs/products/plt1/general-tips.md | 2 +- docs/products/plt1/setup/prevent-sleep.md | 4 +- .../plt1/troubleshooting/plt1-boot-mode.md | 4 +- .../plt1/troubleshooting/plt1-code.md | 12 +-- .../plt1-reset-wi-fi-credentials.md | 2 +- .../plt1b/additional-info/insert-battery.md | 12 +-- docs/products/plt1b/general-tips.md | 2 +- .../plt1b/troubleshooting/plt1b-boot-mode.md | 10 +-- .../plt1b/troubleshooting/plt1b-code.md | 18 ++-- .../plt1b-reset-wi-fi-credentials.md | 4 +- .../addons/attaching-bottle-to-pump-1.md | 2 +- .../attaching-fluid-level-sensors-pump-1.md | 8 +- .../pump1/addons/attaching-tubes-to-pump-1.md | 2 +- .../pump1/troubleshooting/pump1-boot-mode.md | 6 +- .../pump1/troubleshooting/pump1-reflash.md | 12 +-- .../pump1-reset-wi-fi-credentials.md | 2 +- .../pump1/troubleshooting/pump1-teardown.md | 10 +-- ...add-the-ld2412-mmwave-sensor-to-r-pro-1.md | 12 +-- .../rpro1/addons/adding-co2-to-r-pro-1.md | 6 +- .../attaching-gang-box-mount-to-r-pro-1.md | 16 ++-- .../install-ceiling-mount-for-r-pro-1.md | 22 ++--- docs/products/rpro1/calibrating-co2.md | 6 +- .../rpro1/setup/rpro1-general-tips.md | 8 +- .../rpro1/setup/rpro1-switch-firmware.md | 12 +-- docs/products/rpro1/setup/zones-ha-new.md | 4 +- docs/products/rpro1/setup/zones-ha.md | 26 +++--- docs/products/rpro1/setup/zones-hlk.md | 22 ++--- .../rpro1/troubleshooting/rpro1-boot-mode.md | 14 ++-- .../rpro1/troubleshooting/rpro1-code.md | 12 +-- .../rpro1-reset-wi-fi-credentials.md | 2 +- .../rpro1/troubleshooting/rpro1-teardown.md | 16 ++-- docs/products/temp1/addons/food-probe.md | 10 +-- docs/products/temp1/addons/magnetic-mount.md | 14 ++-- docs/products/temp1/addons/multiple-probes.md | 12 +-- docs/products/temp1/addons/temp-probe.md | 14 ++-- .../temp1/examples/hot-water-recirculation.md | 2 +- .../temp1/examples/temp1-alert-example.md | 6 +- .../examples/temp1-automation-examples.md | 80 +++++++++--------- docs/products/temp1/setup/prevent-sleep.md | 4 +- ...temp1-change-temp-probe-update-interval.md | 6 +- .../temp1/troubleshooting/temp1-boot-mode.md | 8 +- .../temp1/troubleshooting/temp1-code.md | 10 +-- .../temp1-reset-wi-fi-credentials.md | 4 +- .../temp1/troubleshooting/temp1-teardown.md | 12 +-- docs/products/temp1b/addons/food-probe.md | 10 +-- docs/products/temp1b/addons/magnetic-mount.md | 14 ++-- docs/products/temp1b/addons/temp-probe.md | 14 ++-- .../temp1b/examples/temp1b-alert-example.md | 6 +- .../examples/temp1b-automation-examples.md | 80 +++++++++--------- docs/products/temp1b/setup/insert-battery.md | 26 +++--- .../troubleshooting/temp1b-boot-mode.md | 8 +- .../temp1b/troubleshooting/temp1b-code.md | 10 +-- .../temp1b-reset-wi-fi-credentials.md | 2 +- .../temp1b/troubleshooting/temp1b-teardown.md | 8 +- .../temppro1/addons/temp-humidity-probe.md | 6 +- docs/products/temppro1/addons/temp-probe.md | 10 +-- .../temppro1/examples/temp1-alert-example.md | 6 +- .../examples/temp1-automation-examples.md | 80 +++++++++--------- .../troubleshooting/temp-pro1-boot-mode.md | 6 +- .../troubleshooting/temp-pro1-code.md | 10 +-- .../temp-pro1-reset-wi-fi-credentials.md | 2 +- .../troubleshooting/temp-pro1-teardown.md | 2 +- 313 files changed, 1654 insertions(+), 1654 deletions(-) diff --git a/docs/_snippets/bluetooth-proxy/method1-finish.md b/docs/_snippets/bluetooth-proxy/method1-finish.md index 37004f5b18..187cd1b158 100644 --- a/docs/_snippets/bluetooth-proxy/method1-finish.md +++ b/docs/_snippets/bluetooth-proxy/method1-finish.md @@ -1,11 +1,11 @@ -![](/assets/esphome-device-builder-add-ble-proxy-method-1-edit-yaml.gif) +![ESPHome Device Builder editor with the packages line replaced by the Bluetooth proxy package](/assets/esphome-device-builder-add-ble-proxy-method-1-edit-yaml.gif) 5\. Click **Save** then **Install** in the bottom right. Click **On the network** when prompted. -![](/assets/esphome-device-builder-add-ble-proxy-save-install.gif) +![ESPHome Device Builder Save and Install buttons in the bottom right of the editor](/assets/esphome-device-builder-add-ble-proxy-save-install.gif) 6\. When you see the purple lines the device has booted successfully and the logs will show the **Bluetooth Proxy** section. Click **Stop** in the bottom right and you're finished! -![](/assets/ble-proxy-install-completed.png) +![ESPHome Device Builder logs with the Bluetooth Proxy section boxed and an arrow to Stop](/assets/ble-proxy-install-completed.png) --8<-- "_snippets/bluetooth-proxy/verify.md" diff --git a/docs/_snippets/bluetooth-proxy/method1-steps.md b/docs/_snippets/bluetooth-proxy/method1-steps.md index a0d626bd76..08a56969d5 100644 --- a/docs/_snippets/bluetooth-proxy/method1-steps.md +++ b/docs/_snippets/bluetooth-proxy/method1-steps.md @@ -1,6 +1,6 @@ 1\. Open ESPHome Device Builder. The button below opens the app right in your Home Assistant. - Open ESPHome Device Builder +ESPHome logo Open ESPHome Device Builder 2\. Don't have it installed yet? Add it from the App Store with the badge below, then move on to step 3. @@ -8,6 +8,6 @@ 3\. Find your device and click **Edit**. -![](/assets/esphome-device-builder-edit-device.gif) +![ESPHome Device Builder device list with an Edit button on each device card](/assets/esphome-device-builder-edit-device.gif) 4\. Replace the `packages:` line and the line directly below it with the code below. diff --git a/docs/_snippets/bluetooth-proxy/method2.md b/docs/_snippets/bluetooth-proxy/method2.md index 7a1dd91b8a..12e133e48e 100644 --- a/docs/_snippets/bluetooth-proxy/method2.md +++ b/docs/_snippets/bluetooth-proxy/method2.md @@ -2,7 +2,7 @@ The easiest way is to let ESPHome Device Builder add the component for you. You 1\. Open ESPHome Device Builder and click **Edit** on your device. The button below opens the app right in your Home Assistant. - Open ESPHome Device Builder +ESPHome logo Open ESPHome Device Builder Don't have it installed yet? Add it from the App Store with the badge below first. @@ -10,7 +10,7 @@ Don't have it installed yet? Add it from the App Store with the badge below firs 2\. Click **Add Component** in the editor toolbar, search for **Bluetooth Proxy**, and click **Add**. -![](/assets/esphome-device-builder-add-ble-proxy-component.gif) +![ESPHome Device Builder adding the Bluetooth Proxy component with Add Component](/assets/esphome-device-builder-add-ble-proxy-component.gif) Device Builder drops a single line into your config: @@ -22,6 +22,6 @@ That's all it needs. Active connections are on by default, and `bluetooth_proxy` 3\. Click **Save**, then **Install**, and choose **On the Network** to flash the new firmware over Wi-Fi. -![](/assets/esphome-device-builder-add-ble-proxy-save-validate-install.gif) +![ESPHome Device Builder validating the config with bluetooth_proxy added, then Save and Install](/assets/esphome-device-builder-add-ble-proxy-save-validate-install.gif) --8<-- "_snippets/bluetooth-proxy/verify.md" diff --git a/docs/homey.md b/docs/homey.md index 8e60f82c89..b891397706 100755 --- a/docs/homey.md +++ b/docs/homey.md @@ -2,7 +2,7 @@ title: Homey Integration description: Guide to integrating Apollo Automation devices with the Homey smart home platform. --- - +Apollo Automation Homey docs banner !!! info "Welcome to Apollo Automation Docs!" diff --git a/docs/homey/products/air1/addons/adding-co2-to-air-1.md b/docs/homey/products/air1/addons/adding-co2-to-air-1.md index bf82eeeee2..0afab68d1b 100755 --- a/docs/homey/products/air1/addons/adding-co2-to-air-1.md +++ b/docs/homey/products/air1/addons/adding-co2-to-air-1.md @@ -10,34 +10,34 @@ description: Adding The SCD40 CO₂ Sensor from Sensirion To The AIR-1. 1\. Unplug your AIR-1 from power and lift the top of the case or "lid". -![](/assets/air-1-add-co2-pic-1.jpg)![](/assets/air-1-add-co2-pic-2.jpg)![](/assets/air-1-add-co2-pic-3.jpg) +![AIR-1 in its white case with the lid on and the USB-C port facing forward](/assets/air-1-add-co2-pic-1.jpg)![Fingers lifting one side of the AIR-1 lid](/assets/air-1-add-co2-pic-2.jpg)![AIR-1 lid lifted, showing the circuit board inside the case](/assets/air-1-add-co2-pic-3.jpg) 2\. Remove the lid completely by grabbing the lid from the other side and gently lifting upwards. -![](/assets/air-1-add-co2-pic-4.jpg) +![Lifting the AIR-1 lid completely off from the other side](/assets/air-1-add-co2-pic-4.jpg) 3\. Hold the PCB and orient it correctly where Apollo (the dog) is facing you in. -![](/assets/air-1-add-co2-pic-5.jpg) +![AIR-1 circuit board held with the Apollo dog graphic facing you, sensor below](/assets/air-1-add-co2-pic-5.jpg) 4\. Gently slide the pcb out by sliding it to the left as shown in the images below. -![](/assets/air-1-add-co2-pic-6.jpg)![](/assets/air-1-add-co2-pic-7.jpg) +![AIR-1 circuit board being slid to the left out of the lid](/assets/air-1-add-co2-pic-6.jpg)![AIR-1 circuit board slid further left, almost free of the lid](/assets/air-1-add-co2-pic-7.jpg) 5\. Flip the PCB over and identify the bottom right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the SCD40 CO2 sensor. There is an X on the SCD40 sensor's PCB as well, you can see it in the image below but it is slightly cut off on the PCB itself. There is also a "gold dot" in the top left of the SCD40 when oriented properly. -![](/assets/air-1-add-co2-pic-8.jpg) +![Back of the AIR-1 circuit board with an X marking the bottom right mezzanine connector](/assets/air-1-add-co2-pic-8.jpg) 6\. Gently push the SCD40 CO2 module onto the black mezzanine connector. -![](/assets/air-1-add-co2-pic-9-1.jpg) +![SCD40 CO2 sensor pressed onto the mezzanine connector on the AIR-1 board](/assets/air-1-add-co2-pic-9-1.jpg) 7\. Gently slide the PCB back into the 3d printed case as shown below. -![](/assets/air-1-add-co2-pic-10.jpg)![](/assets/air-1-add-co2-pic-11.jpg) +![AIR-1 circuit board being slid back into the lid's printed channels](/assets/air-1-add-co2-pic-10.jpg)![AIR-1 circuit board fully seated in the lid with the Apollo dog graphic facing out](/assets/air-1-add-co2-pic-11.jpg) 8\. Gently push the case back together as shown below. -![](/assets/air-1-add-co2-pic-12.jpg)![](/assets/air-1-add-co2-pic-13.jpg)![](/assets/air-1-add-co2-pic-14.jpg) +![AIR-1 lid being lowered back onto the case](/assets/air-1-add-co2-pic-12.jpg)![AIR-1 lid nearly closed with the USB-C port lined up with its opening](/assets/air-1-add-co2-pic-13.jpg)![AIR-1 case fully closed with the lid back in place](/assets/air-1-add-co2-pic-14.jpg) 9\. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module after installation. This is required for all CO2 addons purchased from us separately from a product (such as buying it to addon to an existing Apollo device). \ No newline at end of file diff --git a/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md b/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md index 8c95facd6b..ff20050acd 100755 --- a/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md +++ b/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md @@ -6,35 +6,35 @@ description: Adding Optional GPIO Header to AIR-1. 1\. Unplug your AIR-1 from power and lift the top of the case or "lid". -![](/assets/air-1-add-co2-pic-1.jpg)![](/assets/air-1-add-co2-pic-2.jpg)![](/assets/air-1-add-co2-pic-3.jpg) +![AIR-1 in its white case with the lid on and the USB-C port facing forward](/assets/air-1-add-co2-pic-1.jpg)![Fingers lifting one side of the AIR-1 lid](/assets/air-1-add-co2-pic-2.jpg)![AIR-1 lid lifted, showing the circuit board inside the case](/assets/air-1-add-co2-pic-3.jpg) 2\. Remove the lid completely by grabbing the lid from the other side and gently lifting upwards. -![](/assets/air-1-add-co2-pic-4.jpg) +![Lifting the AIR-1 lid completely off from the other side](/assets/air-1-add-co2-pic-4.jpg) 3\. Hold the PCB and orient it correctly where Apollo (the dog) is facing you in. -![](/assets/air-1-add-co2-pic-5.jpg) +![AIR-1 circuit board held with the Apollo dog graphic facing you, sensor below](/assets/air-1-add-co2-pic-5.jpg) 4\. Gently slide the pcb out by sliding it to the left as shown in the images below. -![](/assets/air-1-add-co2-pic-6.jpg)![](/assets/air-1-add-co2-pic-7.jpg) +![AIR-1 circuit board being slid to the left out of the lid](/assets/air-1-add-co2-pic-6.jpg)![AIR-1 circuit board slid further left, almost free of the lid](/assets/air-1-add-co2-pic-7.jpg) 5\. Flip the PCB over and identify the Top Right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the PCB of the GPIO Header. There is an X on the GPIO Header's PCB as well, you can see it in the images below -![](/assets/air-1-gpio-header-wiki-pic-1.webp)![](/assets/air-1-gpio-header-wiki-pic-2.webp) +![Back of the AIR-1 board with a tool pointing at the top right mezzanine connector](/assets/air-1-gpio-header-wiki-pic-1.webp)![GPIO header addon board with an X marked in one corner](/assets/air-1-gpio-header-wiki-pic-2.webp) 6\. Match up the X on the PCB of the GPIO Header and the X on the AIR-1 PCB and then gently push the GPIO Header onto the black mezzanine connector. -![](/assets/air-1-gpio-header-wiki-pic-3.webp)![](/assets/air-1-gpio-header-wiki-pic-4.webp)![](/assets/air-1-gpio-header-wiki-pic-5.webp) +![GPIO header held next to the AIR-1 mezzanine connector with the X marks lined up](/assets/air-1-gpio-header-wiki-pic-3.webp)![Pressing the GPIO header onto the AIR-1 mezzanine connector](/assets/air-1-gpio-header-wiki-pic-4.webp)![GPIO header seated on the top right connector of the AIR-1 board](/assets/air-1-gpio-header-wiki-pic-5.webp) 7\. Flip the AIR-1 PCB over and gently slide it back into the new AIR-1 Lid which came with your GPIO Header addon! Please do not use much force, the PCB should slide in relatively smoothly, with a tiny bit of force needed. There are three channels in the plastic where the PCB slides into! -![](/assets/air-1-gpio-header-wiki-pic-6.webp)![](/assets/air-1-gpio-header-wiki-pic-7.webp) +![AIR-1 circuit board being slid into the new lid for the GPIO header](/assets/air-1-gpio-header-wiki-pic-6.webp)![AIR-1 circuit board seated in the new lid with the Apollo dog graphic facing out](/assets/air-1-gpio-header-wiki-pic-7.webp) 8\. Gently push the case back together as shown below. -![](/assets/air-1-gpio-header-wiki-pic-8.webp)![](/assets/air-1-gpio-header-wiki-pic-9.webp)![](/assets/air-1-gpio-header-wiki-pic-10.webp) +![New AIR-1 lid with the GPIO header being lowered onto the case](/assets/air-1-gpio-header-wiki-pic-8.webp)![Closed AIR-1 case with the GPIO header showing through the lid](/assets/air-1-gpio-header-wiki-pic-9.webp)![Top of the closed AIR-1 lid with the GPIO header in its cutout](/assets/air-1-gpio-header-wiki-pic-10.webp) 9\. You are now done and your AIR-1 is now able to be used with the GPIO Header addon! Here is the pinout image below and here's a great wiki article showing you how to add a small led strip! @@ -42,4 +42,4 @@ description: Adding Optional GPIO Header to AIR-1. If you plan to use a lot of leds or your gpio project requires a lot of power then you need to use a dedicated power supply and not try to use too much power (under 350mA) from the GPIO of the device! You can power the AIR-1 via the vcc (5v) and GND pins but please do not power it via the pins AND the USB-C port, it should be one or the other. -![](/assets/gpio-header-pinout.webp) \ No newline at end of file +![AIR-1 GPIO header pinout: GND, IO18, IO19, IO4, IO2, IO6 on the left; 5V, IO7, SDA, SCL, GND, 3V on the right](/assets/gpio-header-pinout.webp) \ No newline at end of file diff --git a/docs/homey/products/air1/calibrating-and-updating/air-1-temp-calibration.md b/docs/homey/products/air1/calibrating-and-updating/air-1-temp-calibration.md index d7921c0fa6..3efa00d8c0 100755 --- a/docs/homey/products/air1/calibrating-and-updating/air-1-temp-calibration.md +++ b/docs/homey/products/air1/calibrating-and-updating/air-1-temp-calibration.md @@ -2,4 +2,4 @@ description: "Calibrate the AIR-1 temperature reading from its SEN55 to your room using a temperature offset." --- -![AIR-1 Temperature Offset 2.png](/assets/air-1-temperature-offset-2.png) \ No newline at end of file +![AIR-1 Configuration card in Home Assistant with the SEN55 Temperature Offset set to 5.0 °C circled](/assets/air-1-temperature-offset-2.png) \ No newline at end of file diff --git a/docs/homey/products/air1/examples/air-quality-notification-example.md b/docs/homey/products/air1/examples/air-quality-notification-example.md index 0856538190..ecba4f74a2 100755 --- a/docs/homey/products/air1/examples/air-quality-notification-example.md +++ b/docs/homey/products/air1/examples/air-quality-notification-example.md @@ -12,69 +12,69 @@ description: Example flow that sends alerts based on changing indoor air quality 2\. Click "New Flow" then "Advanced Flow". -![](/assets/homey-flow-example-pic-1.png) +![Homey Create a new Flow dialog with Advanced Flow selected](/assets/homey-flow-example-pic-1.png) 3\. Click "Add" and select "When". -![](/assets/homey-flow-example-pic-2.png) +![Homey Advanced Flow Add menu with When highlighted](/assets/homey-flow-example-pic-2.png) 4\. In the search bar at the top, type in "co2 becomes" and select the card for the sensor you want to track. We are choosing "CO2 becomes greater than" for the Apollo AIR-1 device. -![](/assets/homey-flow-example-pic-3-1.png) +![Homey card search for co2 becomes, selecting the AIR-1 CO2 becomes greater than card](/assets/homey-flow-example-pic-3-1.png) 5\. Place your card on your flow area with a left click. You should have this node on your flow canvas. -![](/assets/homey-flow-example-pic-4-1.png) +![AIR-1 CO2 becomes greater than ppm card placed on the Homey flow canvas](/assets/homey-flow-example-pic-4-1.png) 6\. Select "ppm" and type in your value, we will use 999. -![](/assets/homey-flow-example-pic-7.png) +![AIR-1 CO2 becomes greater than 999 ppm card in Homey](/assets/homey-flow-example-pic-7.png) 7\. Duplicate steps 4 and 5 above but this time select "CO2 becomes less than" and place it on your flow canvas.Make sure to fill in your less than ppm value such as 1000. -![](/assets/homey-flow-example-pic-5-1.png) +![AIR-1 CO2 cards for greater than 999 ppm and less than 1000 ppm in Homey](/assets/homey-flow-example-pic-5-1.png) 8\. Click "Add" and select "Then" and search for "set a color" and choose the AIR-1 device option. -![](/assets/homey-flow-example-pic-6.png) +![Homey card search for set a color with the AIR-1 card highlighted](/assets/homey-flow-example-pic-6.png) 9\. Draw a line to connect "CO2 becomes greater than 999 ppm. Click the 3 dots and select a color - we have chosen red to indicate a problem. -![](/assets/homey-flow-example-pic-8.png) +![Homey flow linking CO2 greater than 999 ppm to an AIR-1 Set a color card set to red](/assets/homey-flow-example-pic-8.png) 10\. Duplicate steps 7 and 8 but this time select green for the color when "CO2 becomes less than 1000 ppm". -![](/assets/homey-flow-example-pic-10.png) +![Homey flow setting red above 999 ppm CO2 and green below 1000 ppm CO2 on the AIR-1](/assets/homey-flow-example-pic-10.png) 11\. Click "Add" and select "Then" and search "push" and choose "Send message to user". -![](/assets/homey-flow-example-pic-9.png) +![Homey card search for push with the Send message to user card highlighted](/assets/homey-flow-example-pic-9.png) 12\. Draw a line to connect set a color to the push notification. Write in "The CO2 level in the bedroom is currently CO2 ppm. Open the Window, turn on HVAC, etc to lower this value!" Then replace the second "CO2" and click the little tag icon and type in CO2 then select the blue CO2 option under Apollo AIR-1. -![](/assets/homey-flow-example-pic-12.png)![](/assets/homey-flow-example-pic-13.png) +![Homey push notification message box with the cursor on the tag icon](/assets/homey-flow-example-pic-12.png)![Homey tag search for co2 with the AIR-1 CO2 tag selected](/assets/homey-flow-example-pic-13.png) -![](/assets/homey-flow-example-pic-11.png) +![Homey flow sending a push notification with the AIR-1 CO2 tag after the red color card](/assets/homey-flow-example-pic-11.png) 13\. Click "User" and choose "Everyone who's home" or your preferred option. -![](/assets/homey-flow-example-pic-18.png) +![Homey push notification user list with Everyone who's home highlighted](/assets/homey-flow-example-pic-18.png) 13\. Click "Add" and select "Delay" and then place it on your flow canvas. Change to minutes and input 5 for adding a 5 minute delay then drag a line from "set a color" to the delay. -![](/assets/homey-flow-example-pic-15.png) +![Homey flow with the green Set a color card connected to a 5 minute delay](/assets/homey-flow-example-pic-15.png) 14\. Click "Add" and select "Then" and search for "turn off" and choose the AIR-1 device option. -![](/assets/homey-flow-example-pic-14.png) +![Homey card search for turn off with the AIR-1 card highlighted](/assets/homey-flow-example-pic-14.png) 15\. Drag a line from the Delay in step 13 to the Turn off card and that's it! Click save at the top and give your flow a name. -![](/assets/homey-flow-example-pic-16-1.png) +![Completed Homey Advanced Flow for AIR-1 CO2 alerts with colors, a notification, and turn off](/assets/homey-flow-example-pic-16-1.png) 16\. As a bonus, you can add a note reminding you what this automation does. Click "Add" then click "Note" and type in "CO2 level alert with RGB LEDs" on the note. -![](/assets/homey-flow-example-pic-17-1.png) +![Homey Advanced Flow with a CO2 level alert with RGB LEDs note added](/assets/homey-flow-example-pic-17-1.png) 17\. You are done! Your sensor is now ready to create flows and add as a favorite to your dashboard! diff --git a/docs/homey/products/air1/setup/general-tips.md b/docs/homey/products/air1/setup/general-tips.md index 38be8c849a..20907994f9 100755 --- a/docs/homey/products/air1/setup/general-tips.md +++ b/docs/homey/products/air1/setup/general-tips.md @@ -150,11 +150,11 @@ The latest AIR-1 firmware keeps the SCD40 calibrated automatically. The sensor a If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), automatic self-calibration will slowly drag the CO2 readings down. Turn off the **CO2 Auto Calibration** switch in your device's settings and follow the [manual calibration guide](../../general/calibrating-and-updating/co2-calibration.md) every 1 to 2 years instead. -![](/assets/co2-levels-drop-after-hvac-on.png) +![CO2 10 minute average graph dropping in several rooms after the HVAC turned on overnight](/assets/co2-levels-drop-after-hvac-on.png) Wisconsin Department of Health CO2 Level Chart -![CO2 Health Department.png](/assets/air-1-co2-calibration-image-6.jpg) +![CO2 level chart listing ppm ranges from 400 to 40,000 and their potential health effects](/assets/air-1-co2-calibration-image-6.jpg) !!! tip "We suggest triggering alert automations, hvac or a fan turning on, etc when CO2 is over 1000" diff --git a/docs/homey/products/air1/troubleshooting/air1-boot-mode.md b/docs/homey/products/air1/troubleshooting/air1-boot-mode.md index 9b8b768f5a..11abae830e 100755 --- a/docs/homey/products/air1/troubleshooting/air1-boot-mode.md +++ b/docs/homey/products/air1/troubleshooting/air1-boot-mode.md @@ -10,7 +10,7 @@ description: "Step by step guide for putting The AIR-1 In Boot Mode." 1\. Position the AIR-1 so that the USB-C port is facing you. On the left side of the USB-C port, locate a small opening to press the boot button (the right button). -![](/assets/air-1-boot-button.jpg) +![AIR-1 case with a tool pointing at the boot button left of the USB-C port](/assets/air-1-boot-button.jpg) 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 AIR-1 then let go of the button. @@ -24,6 +24,6 @@ description: "Step by step guide for putting The AIR-1 In Boot Mode." 3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button. -![](/assets/air-1-reset-boot-buttons-arrows.jpg) +![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) 4\. Continue with uploading the firmware document. \ No newline at end of file diff --git a/docs/homey/products/air1/troubleshooting/air1-code.md b/docs/homey/products/air1/troubleshooting/air1-code.md index 64270480a7..8295fcae89 100755 --- a/docs/homey/products/air1/troubleshooting/air1-code.md +++ b/docs/homey/products/air1/troubleshooting/air1-code.md @@ -10,29 +10,29 @@ If your device has already been connected to Home Assistant please Put your device in boot mode by holding down the boot button and then plugging in the USB cable. 1. Position the AIR-1 so that the USB-C port is facing you. On the left side of the USB-C port, locate a small opening to press the boot button (the right button). -![](/assets/air-1-boot-button.jpg) +![AIR-1 case with a tool pointing at the boot button left of the USB-C port](/assets/air-1-boot-button.jpg) 2\. Navigate to our installer page and click connect under Battery Firmware Apollo AIR-1 Installer. 3\. Click the big "Connect" button. -![](/assets/air-1-reflash-pic-1.png) +![Apollo AIR-1 Installer web page with the Connect button highlighted](/assets/air-1-reflash-pic-1.png) 4\. Select the open com port then click Connect. -![](/assets/air-1-reflash-pic-2-1.png) +![Browser serial port prompt with the USB JTAG serial debug unit selected and Connect](/assets/air-1-reflash-pic-2-1.png) 5\. Click "Install ApolloAutomation.AIR-1". -![](/assets/air-1-reflash-pic-3.png) +![AIR-1 installer Device Dashboard with Install AIR-1 highlighted](/assets/air-1-reflash-pic-3.png) 6\. Click "INSTALL". -![](/assets/air-1-reflash-pic-4.png) +![AIR-1 installer confirmation dialog with the Install button highlighted](/assets/air-1-reflash-pic-4.png) 7\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/air-1-reflash-pic-5.png) +![AIR-1 installer showing Installation complete with the Next button highlighted](/assets/air-1-reflash-pic-5.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md b/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md index 55cb128f23..5441054255 100755 --- a/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md +++ b/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md @@ -6,7 +6,7 @@ description: "Step by step guide for resetting the Wi-Fi Credentials on your AIR 2\. Press and hold the Boot button for 10 seconds. -![](/assets/air-1-boot-button.jpg) +![AIR-1 case with a tool pointing at the boot button left of the USB-C port](/assets/air-1-boot-button.jpg) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/homey/products/general/battery-sensors/sensor-connection-check.md b/docs/homey/products/general/battery-sensors/sensor-connection-check.md index a5002a6e8b..c00f992d09 100755 --- a/docs/homey/products/general/battery-sensors/sensor-connection-check.md +++ b/docs/homey/products/general/battery-sensors/sensor-connection-check.md @@ -6,19 +6,19 @@ description: How to check if your device is connected to Wi-Fi, Home Assistant, 1\. Press the reset button and let go to restart the device
TEMP-1B reset button -![](/assets/temp-1-reset-button-lid-off.jpg) +![TEMP-1B board with the lid off and a tool pointing at the reset button](/assets/temp-1-reset-button-lid-off.jpg) PLT-1B reset button -![](/assets/plt-boot-mode-pic-6-1.jpg) +![PLT-1B board with a tool pointing at the reset button](/assets/plt-boot-mode-pic-6-1.jpg) 2\. Press the boot button and let go
TEMP-1B boot button -![](/assets/temp-1b-boot-button-lid-off.jpg) +![TEMP-1B board with the lid off and a tool pointing at the boot button](/assets/temp-1b-boot-button-lid-off.jpg) PLT-1B boot button -![](/assets/plt-boot-mode-pic-2.jpg) +![PLT-1B board with a tool pointing at the boot button near the USB-C port](/assets/plt-boot-mode-pic-2.jpg) The RGB Light on your device should flash green if connected to Wi-Fi, blue if connected to Wi-Fi and Home Assistant, or yellow if no Wi-Fi or Home Assistant connection. diff --git a/docs/homey/products/general/calibrating-and-updating/co2-calibration.md b/docs/homey/products/general/calibrating-and-updating/co2-calibration.md index 7ddf0f0836..47c8031525 100755 --- a/docs/homey/products/general/calibrating-and-updating/co2-calibration.md +++ b/docs/homey/products/general/calibrating-and-updating/co2-calibration.md @@ -21,17 +21,17 @@ description: "Step by step guide for re-calibrating your SCD40 CO2 sensor" 3\. Navigate to your device, such as via the "Favorite Devices" section and right click (or on mobile short hold) then click on Settings. -![](/assets/co2-calibration-homey-pic-1.png) +![Homey Favorite Devices menu for the Apollo AIR-1 with Settings highlighted](/assets/co2-calibration-homey-pic-1.png) 4\. Scroll down until you see "Maintenance" and select it on mobile, then click on "Calibrate SCD40 to 420ppm" and you should see the CO2 readings at 420 ppm or near it. -![](/assets/co2-calibration-homey-pic-2.png) +![Homey AIR-1 settings with Calibrate SCD40 to 420ppm under Maintenance highlighted](/assets/co2-calibration-homey-pic-2.png) It might take several attempts clicking the "Press" button for it to equalize correctly. If you don't see the SCD40 reporting 400-500 ppm then click the button again. 5\. Now your CO2 sensor should be calibrated! Be sure to setup some nice flows and check out the insights so you can monitor the CO2 levels. -![Image of CO2ppm on a graph](/assets/co2-calibration-homey-pic-3.png) +![Homey CO2 graph for the Apollo AIR-1 with readings between 550 and 700 ppm](/assets/co2-calibration-homey-pic-3.png) !!! danger "Dangerous CO2 level considerations" @@ -39,14 +39,14 @@ It might take several attempts clicking the "Press" button for it to equalize co Note the steep decline in CO2 ppm detected due to the door and window being opened and fan turned on. -![CO2_8.jpg](/assets/air-1-co2-calibration-image-5.jpg) +![Home Assistant history of MSR-1 CO2 rising to about 2,500 ppm overnight, then dropping steeply](/assets/air-1-co2-calibration-image-5.jpg) Wisconsin Department of Health CO2 Level Chart -![CO2 Health Department.png](/assets/air-1-co2-calibration-image-6.jpg) +![CO2 level chart listing ppm ranges from 400 to 40,000 and their potential health effects](/assets/air-1-co2-calibration-image-6.jpg) !!! example "CO2 levels dropping due to HVAC Fan on a schedule" This could be improved by increasing air exchange to get below 1000 ppm for a safer environment. -![Plotly CO2 Graph.png](/assets/plotly-co2-graph.png) \ No newline at end of file +![Bedroom CO2 graph rising and falling with the HVAC fan schedule, peaking near 1,500 ppm](/assets/plotly-co2-graph.png) \ No newline at end of file diff --git a/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md b/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md index 257e9d8689..ccf5eb958e 100755 --- a/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md +++ b/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md @@ -27,23 +27,23 @@ How to tune the mmWave sensor using radar engineering mode. 3\. Turn on Radar Engineering Mode (REM). -![](/assets/mmwave-tuning-pic-1.png) +![Home Assistant Radar Engineering Mode toggle switched on and circled](/assets/mmwave-tuning-pic-1.png) 4\. Scroll down to the Diagnostic section and you will see that REM shows the move and still energy for gates 0-8. -![](/assets/mmwave-tuning-pic-2-1.png) +![Home Assistant diagnostic sensors showing gate 2 move and still energy and gate 3 move energy](/assets/mmwave-tuning-pic-2-1.png) 5\. The gates are different distances from the sensor. -![Radar Gates Colored](/assets/radar-gates-colored.png "Radar Gates Colored") +![mmWave radar diagram of gates G1 to G7 out to 5 m, colored by zones 1 to 3](/assets/radar-gates-colored.png "Radar Gates Colored") 6\. Moving the gate still and move threshold slider to the right increases the amount of energy needed to trigger the sensor. Do this if you want the gate to be less sensitive. -![](/assets/mmwave-tuning-pic-3.png) +![Home Assistant g6 still threshold slider moved all the way to the right and circled](/assets/mmwave-tuning-pic-3.png) 7\. Moving the gate still and move threshold slider to the left decreases the amount of energy needed to trigger the sensor. Do this if you want the gate to be more sensitive. -![](/assets/mmwave-tuning-pic-4.png) +![Home Assistant g4 move threshold slider moved toward the left and circled](/assets/mmwave-tuning-pic-4.png) !!! quote "Quote from popular Youtuber Make It Work Tech" diff --git a/docs/homey/products/general/introduction.md b/docs/homey/products/general/introduction.md index dd0563ead3..e1b61c76b7 100755 --- a/docs/homey/products/general/introduction.md +++ b/docs/homey/products/general/introduction.md @@ -4,7 +4,7 @@ description: >- Learn what Apollo Automation is all about, including our mission, our products, and how we empower smarter homes. --- -![](/assets/apolloautomation-finals-66.jpg) +![Several white Apollo Automation sensors arranged on a marble serving board](/assets/apolloautomation-finals-66.jpg) Apollo Automation is a small startup based in Lexington, Kentucky, dedicated to creating innovative, high-quality, and affordable smart home automation hardware. Founded in 2023 by a group of friends, the company was born out of frustration with existing solutions that lacked transparency and customization options. Named after Trevor’s dog, Apollo, the team set out to build products that offer complete local control without reliance on cloud services or subscriptions! diff --git a/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md b/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md index 760b2efca7..a4883721a1 100755 --- a/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md +++ b/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md @@ -6,13 +6,13 @@ description: Tutorial for how to add Apollo Devices To Hidden Networks. 1\. Open the Esphome Device Builder. -![](/assets/bluetooth-proxy-tutorial-1.png) +![ESPHome Device Builder dashboard listing Apollo devices](/assets/bluetooth-proxy-tutorial-1.png) 2\. If you do not have it installed, [go here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Install Esphome Device Builder.") and then move on to step 3. 3\. Click "Edit" as shown below. -![](/assets/bluetooth-proxy-tutorial-2.png) +![ESPHome Device Builder card for the Apollo MTR-1 with the Edit button circled](/assets/bluetooth-proxy-tutorial-2.png) 4\. Copy the code inside the codeblock below. @@ -22,18 +22,18 @@ description: Tutorial for how to add Apollo Devices To Hidden Networks. 5\. Paste the code as shown below directly below the yaml you just edited above. Make sure the spaces look the same and there are no red lines under any of the code. -![](/assets/hidden-ssid-tutorial-1.png) +![MTR-1 YAML in ESPHome Device Builder with fast_connect: True added under wifi](/assets/hidden-ssid-tutorial-1.png) 6 Click save then Install in the top right. -![](/assets/hidden-ssid-tutorial-2.png) +![ESPHome Device Builder editor with an arrow pointing to Save and Install in the top right](/assets/hidden-ssid-tutorial-2.png) 7\. Click "Wirelessly" and let it finish compiling then installing. -![](/assets/hidden-ssid-tutorial-3.png) +![ESPHome Device Builder install options with Wirelessly circled](/assets/hidden-ssid-tutorial-3.png) 8\. When you see this "OTA Successful" it has finished and you can click "Close" in the bottom right. -![](/assets/hidden-ssid-tutorial-4.png) +![ESPHome Device Builder install log showing OTA successful with an arrow to Close](/assets/hidden-ssid-tutorial-4.png) 9\. You are finished and your Apollo device is now able to connect to your Wi-Fi with a hidden SSID! Make sure you understand the downsides as [mentioned here](https://esphome.io/components/wifi.html "downsides of fast_connect: true").

**fast\_connect** (*Optional*, boolean): If enabled, directly connects to WiFi network without doing a full scan first. This is required for hidden networks and can significantly improve connection times. Defaults to `off`. The downside is that this option connects to the first network the ESP sees, even if that network is very far away and better ones are available. \ No newline at end of file diff --git a/docs/homey/products/general/setup/getting-started.md b/docs/homey/products/general/setup/getting-started.md index ca0ab724e5..09a1e77c33 100755 --- a/docs/homey/products/general/setup/getting-started.md +++ b/docs/homey/products/general/setup/getting-started.md @@ -13,7 +13,7 @@ To get your new Apollo sensor connected to your Wi-Fi, follow the steps below! 2\. On your phone or PC, open the WiFi settings and connect to "Apollo MSR-2 Hotspot", it might take a minute for the WiFi network to show up. -![](/assets/getting-started-pic-1-1.png) +![Phone Wi-Fi settings with the Apollo MSR-2 hotspot network highlighted](/assets/getting-started-pic-1-1.png) 3\. Once connected it should automatically open a dashboard for your sensor @@ -21,7 +21,7 @@ If this does not automatically open the dashboard, please open your web browser 4\. Select the WiFi network that you would like your sensor to connect to or scroll to the bottom and type in your Wi-Fi network then click "**Save**". -![](/assets/getting-started-pic-2.png) +![Apollo hotspot page at 192.168.4.1 with the SSID and Password fields and Save button highlighted](/assets/getting-started-pic-2.png) !!! tip "Tip for Mesh Wi-Fi systems or multiple Access Points" @@ -33,9 +33,9 @@ If this does not automatically open the dashboard, please open your web browser 1\. Navigate to this website and click "Install App". For now this needs to be done from a desktop PC or a browser. -![](/assets/homey-install-app.png) +![Homey app store page for Apollo Automation with the Install App button highlighted](/assets/homey-install-app.png) -![](/assets/homey-install-app-confirm.png) +![Homey install dialog for the Apollo Automation app with Install App highlighted](/assets/homey-install-app-confirm.png) 2\. Select the Homey device you want to install it on and then click "Install App" again! @@ -45,25 +45,25 @@ If this does not automatically open the dashboard, please open your web browser 1\. Open the Homey App on your phone and navigate to the Devices tab at the bottom then select the (+) icon in the top right and choose "**New Device**". Choose "Allow" if it pops up asking to find Bluetooth devices, or you can change this later in settings. -![](/assets/homey-getting-started-pic-2-1.png) +![Homey app Devices tab with the plus menu open and New Device highlighted](/assets/homey-getting-started-pic-2-1.png) 2\. Select Apollo Automation under Brands in the bottom left then choose "Every Apollo Sensor". When prompted, click "Connect". -![](/assets/homey-getting-started-pic-3.png)![](/assets/homey-getting-started-pic-4.png) +![Homey Apollo Automation brand page showing the Every Apollo sensor option](/assets/homey-getting-started-pic-3.png)![Homey Every Apollo sensor screen with the Connect button](/assets/homey-getting-started-pic-4.png) 3\. Your Apollo devices will automatically show up and if not, please first connect it to your Wi-Fi following the steps outlined here. 4\. Select the device you want to add, in this case an Apollo MTR-1 and click Continue at the bottom. -![](/assets/homey-getting-started-pic-5.png) +![Homey New Devices Found screen with an Apollo MTR-1 selected](/assets/homey-getting-started-pic-5.png) 5\. Click Continue Setup and choose a Zone to place your device in. If you are new to Homey you can choose Home and move it to another Zone later after you create more zones! -![](/assets/homey-getting-started-pic-6.png) +![Homey Device Connected screen for the Apollo MTR-1 with the Continue Setup button](/assets/homey-getting-started-pic-6.png) 6\. Change any other default settings like the Name, icon, etc or just click Finish in the bottom right. -![](/assets/homey-getting-started-pic-7.png) +![Homey Make It Your Own screen for the MTR-1 with name, zone, and Finish button](/assets/homey-getting-started-pic-7.png) 7\. You are done! Your sensor is now ready to create flows and add as a favorite to your dashboard! diff --git a/docs/homey/products/general/setup/renaming-apollo-devices.md b/docs/homey/products/general/setup/renaming-apollo-devices.md index 037c4f8c4f..7b999505c3 100755 --- a/docs/homey/products/general/setup/renaming-apollo-devices.md +++ b/docs/homey/products/general/setup/renaming-apollo-devices.md @@ -5,8 +5,8 @@ description: "Rename an Apollo device from the Homey app or the Homey dashboard. 1\. Open the Homey App or dashboard in a browser and right click a device or short hold and then select "Rename". -![](/assets/homey-rename-pic-1.png) +![Homey dashboard device menu on an AIR-1 tile with Rename highlighted](/assets/homey-rename-pic-1.png) 2\. Type in the new name and then hit enter. That's it, you're done! -![](/assets/homey-rename-pic-2.png) \ No newline at end of file +![Homey device tile with the name edited to Apollo AIR-1 Testbench](/assets/homey-rename-pic-2.png) \ No newline at end of file diff --git a/docs/homey/products/general/supported-platforms.md b/docs/homey/products/general/supported-platforms.md index d3b356f740..7776cca95b 100755 --- a/docs/homey/products/general/supported-platforms.md +++ b/docs/homey/products/general/supported-platforms.md @@ -2,7 +2,7 @@ title: Supported Platforms description: A list of platforms compatible with Apollo Automation products. --- -![](/assets/apollo-logo.png) +![Apollo Automation logo in white on a blue background](/assets/apollo-logo.png) At Apollo, we are actively working on adding support for every smart home ecosystem out there. Although we are a works with Home Assistant partner and a Made for ESPHome partner, we want everyone to be able to use our sensors! Please take a look at the list of smart home ecosystems below to see the type of support we offer and the type of integration/functionality our sensors have. If you see any outdated info or have any questions/comments/concerns, please reach out to us at support@apolloautomation.com or come say hi in our [discord server](https://link.apolloautomation.com/discord)! diff --git a/docs/homey/products/general/troubleshooting/removing-device-from-homey.md b/docs/homey/products/general/troubleshooting/removing-device-from-homey.md index dde8f77273..f66388dac5 100755 --- a/docs/homey/products/general/troubleshooting/removing-device-from-homey.md +++ b/docs/homey/products/general/troubleshooting/removing-device-from-homey.md @@ -7,6 +7,6 @@ description: "Remove an Apollo device from Homey through the app or the dashboar 2\. Navigate to your device, such as via the "Favorite Devices" section and right click (or on mobile short hold) then click "Delete". -![](/assets/homey-delete-device-pic-1.png) +![Homey dashboard device menu on an AIR-1 tile with Delete selected](/assets/homey-delete-device-pic-1.png) -![](/assets/homey-delete-device-pic-2.png) \ No newline at end of file +![Homey confirmation dialog asking to delete the device, with the red Delete button](/assets/homey-delete-device-pic-2.png) \ No newline at end of file diff --git a/docs/homey/products/general/tutorials/high-co2-notification-example.md b/docs/homey/products/general/tutorials/high-co2-notification-example.md index 12f01f8a19..4ae4f55223 100755 --- a/docs/homey/products/general/tutorials/high-co2-notification-example.md +++ b/docs/homey/products/general/tutorials/high-co2-notification-example.md @@ -13,69 +13,69 @@ description: Example flow for sending alerts when CO₂ levels exceed a defined 2\. Click "New Flow" then "Advanced Flow". -![](/assets/homey-flow-example-pic-1.png) +![Homey Create a new Flow dialog with Advanced Flow selected](/assets/homey-flow-example-pic-1.png) 3\. Click "Add" and select "When". -![](/assets/homey-flow-example-pic-2.png) +![Homey Advanced Flow Add menu with When highlighted](/assets/homey-flow-example-pic-2.png) 4\. In the search bar at the top, type in "co2 becomes" and select the card for the sensor you want to track. We are choosing "CO2 becomes greater than" for the Apollo AIR-1 device. -![](/assets/homey-flow-example-pic-3-1.png) +![Homey card search for co2 becomes with the cursor on the AIR-1 CO2 becomes greater than card](/assets/homey-flow-example-pic-3-1.png) 5\. Place your card on your flow area with a left click. You should have this node on your flow canvas. -![](/assets/homey-flow-example-pic-4-1.png) +![AIR-1 CO2 becomes greater than card placed on the Homey flow canvas](/assets/homey-flow-example-pic-4-1.png) 6\. Select "ppm" and type in your value, we will use 999. -![](/assets/homey-flow-example-pic-7.png) +![AIR-1 CO2 becomes greater than card set to 999 ppm in Homey](/assets/homey-flow-example-pic-7.png) 7\. Duplicate steps 4 and 5 above but this time select "CO2 becomes less than" and place it on your flow canvas.Make sure to fill in your less than ppm value such as 1000. -![](/assets/homey-flow-example-pic-5-1.png) +![Homey AIR-1 CO2 cards set to greater than 999 ppm and less than 1000 ppm](/assets/homey-flow-example-pic-5-1.png) 8\. Click "Add" and select "Then" and search for "set a color" and choose the AIR-1 device option. -![](/assets/homey-flow-example-pic-6.png) +![Homey card search for set a color with the AIR-1 option highlighted](/assets/homey-flow-example-pic-6.png) 9\. Draw a line to connect "CO2 becomes greater than 999 ppm. Click the 3 dots and select a color - we have chosen red to indicate a problem. -![](/assets/homey-flow-example-pic-8.png) +![Homey CO2 greater than 999 ppm card connected to an AIR-1 Set a color card set to red](/assets/homey-flow-example-pic-8.png) 10\. Duplicate steps 7 and 8 but this time select green for the color when "CO2 becomes less than 1000 ppm". -![](/assets/homey-flow-example-pic-10.png) +![Homey flow setting red above 999 ppm and green below 1000 ppm on the AIR-1](/assets/homey-flow-example-pic-10.png) 11\. Click "Add" and select "Then" and search "push" and choose "Send message to user". -![](/assets/homey-flow-example-pic-9.png) +![Homey card search for push with the Send Message to User card highlighted](/assets/homey-flow-example-pic-9.png) 12\. Draw a line to connect set a color to the push notification. Write in "The CO2 level in the bedroom is currently CO2 ppm. Open the Window, turn on HVAC, etc to lower this value!" Then replace the second "CO2" and click the little tag icon and type in CO2 then select the blue CO2 option under Apollo AIR-1. -![](/assets/homey-flow-example-pic-12.png)![](/assets/homey-flow-example-pic-13.png) +![Homey push notification message field with the cursor on the tag icon](/assets/homey-flow-example-pic-12.png)![Homey tag search for co2 with the cursor on the AIR-1 CO2 tag](/assets/homey-flow-example-pic-13.png) -![](/assets/homey-flow-example-pic-11.png) +![Homey flow linking the 999 ppm trigger, red color card, and CO2 push notification](/assets/homey-flow-example-pic-11.png) 13\. Click "User" and choose "Everyone who's home" or your preferred option. -![](/assets/homey-flow-example-pic-18.png) +![Homey push notification user picker with Everyone who's home highlighted](/assets/homey-flow-example-pic-18.png) 14\. Click "Add" and select "Delay" and then place it on your flow canvas. Change to minutes and input 5 for adding a 5 minute delay then drag a line from "set a color" to the delay. -![](/assets/homey-flow-example-pic-15.png) +![Homey flow linking the green Set a color card to a 5 minute delay](/assets/homey-flow-example-pic-15.png) 15\. Click "Add" and select "Then" and search for "turn off" and choose the AIR-1 device option. -![](/assets/homey-flow-example-pic-14.png) +![Homey card search for turn off with the AIR-1 option highlighted](/assets/homey-flow-example-pic-14.png) 16\. Drag a line from the Delay in step 14 to the Turn off card and that's it! Click save at the top and give your flow a name. -![](/assets/homey-flow-example-pic-16-1.png) +![Completed Homey Advanced Flow for AIR-1 CO2 alerts with delay and Turn off cards](/assets/homey-flow-example-pic-16-1.png) 17\. As a bonus, you can add a note reminding you what this automation does. Click "Add" then click "Note" and type in "CO2 level alert with RGB LEDs" on the note. -![](/assets/homey-flow-example-pic-17-1.png) +![Completed Homey CO2 flow with a yellow note reading CO2 level alert with RGB LEDs](/assets/homey-flow-example-pic-17-1.png) 18\. You are done! Your sensor is now ready to create flows and add as a favorite to your dashboard! diff --git a/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md b/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md index 32973140b9..11cc148f3d 100755 --- a/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md @@ -6,18 +6,18 @@ description: Tutorial on adding the rear female usb-c port to your MSR-2. 1\. Unplug your MSR-2 from power and remove the back. -![](/assets/msr-2-add-co2-pic-1.jpg) +![Back of the MSR-2 with the Apollo lettered backplate in place](/assets/msr-2-add-co2-pic-1.jpg) -![](/assets/msr-2-add-co2-pic-2.jpg) +![Holding the MSR-2 and lifting the backplate off with a thumb](/assets/msr-2-add-co2-pic-2.jpg) -![](/assets/msr-2-add-co2-pic-3-1.jpg) +![MSR-2 with the backplate removed and set aside, showing the circuit board](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Align the new backplate that came with the articulating stand addon and gently push down on two corners near the articulating ball mount then the other two corners until it seats flat. -![](/assets/msr-2-stand-pic-1.jpg) +![Pressing the articulating stand backplate onto the MSR-2 near the ball mount](/assets/msr-2-stand-pic-1.jpg) -![](/assets/msr-2-stand-pic-2.jpg) +![MSR-2 with the articulating stand backplate seated flat](/assets/msr-2-stand-pic-2.jpg) 3\. Align the ball inside the articulating mount and then push down until it's fully seated. -![](/assets/msr-2-stand-pic-3.jpg) \ No newline at end of file +![Pushing the articulating stand ball into the socket on the MSR-2 backplate](/assets/msr-2-stand-pic-3.jpg) \ No newline at end of file diff --git a/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md b/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md index 20447c9a0e..310b86f431 100755 --- a/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md @@ -5,26 +5,26 @@ description: "Tutorial on adding the SCD40 CO2 sensor to your MSR-2." 1\. Unplug your MSR-2 from power and remove the back -![](/assets/msr-2-add-co2-pic-1.jpg)![](/assets/msr-2-add-co2-pic-2.jpg)![](/assets/msr-2-add-co2-pic-3-1.jpg) +![Back of the MSR-2 with the Apollo lettered backplate in place](/assets/msr-2-add-co2-pic-1.jpg)![Holding the MSR-2 and lifting the backplate off with a thumb](/assets/msr-2-add-co2-pic-2.jpg)![MSR-2 with the backplate removed and set aside, showing the circuit board](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Flip the MSR-2 upside down and gently tap the case on the table and your MSR-2 should slide out of the case. -![](/assets/msr-2-add-co2-pic-4.jpg)![](/assets/msr-2-add-co2-pic-5.jpg)![](/assets/msr-2-add-co2-pic-6.jpg) +![MSR-2 flipped upside down on the table with the backplate behind it](/assets/msr-2-add-co2-pic-4.jpg)![Lifting the case off the MSR-2 board labeled MSR-2 Rev 9](/assets/msr-2-add-co2-pic-5.jpg)![MSR-2 board out of its case, showing the radar, ESP32-C3 module, and CN1 connector](/assets/msr-2-add-co2-pic-6.jpg) 3\. With the case removed, identify the bottom right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the SCD40 CO2 sensor. There is an X on the SCD40 sensor's PCB as well, you can see it in the image below but it is slightly cut off on the PCB itself. There is also a "gold dot" in the top left of the SCD40 when oriented properly. -![](/assets/msr-2-add-co2-pic-7.jpg)![](/assets/msr-2-add-co2-pic-8.jpg) +![Close-up of the MSR-2 CN1 mezzanine connector with the X mark at its bottom right](/assets/msr-2-add-co2-pic-7.jpg)![SCD40 CO2 module below the MSR-2 connector with matching X marks and a gold dot](/assets/msr-2-add-co2-pic-8.jpg) 4\. Gently push the SCD40 CO2 module onto the black mezzanine connector. -![](/assets/msr-2-add-co2-pic-9.jpg)![](/assets/msr-2-add-co2-pic-10.jpg) +![Pressing the SCD40 CO2 module onto the MSR-2 mezzanine connector](/assets/msr-2-add-co2-pic-9.jpg)![SCD40 CO2 module seated on the MSR-2 board next to the ESP32-C3 module](/assets/msr-2-add-co2-pic-10.jpg) 5\. Slide the case back over the MSR-2, making sure that the case has the hole for the USB-C port facing the right direction. -![](/assets/msr-2-add-co2-pic-11.jpg)![](/assets/msr-2-add-co2-pic-12.jpg) +![Sliding the case back over the MSR-2 board with the port hole at the USB-C end](/assets/msr-2-add-co2-pic-11.jpg)![MSR-2 case end with the USB-C port showing through the hole](/assets/msr-2-add-co2-pic-12.jpg) 6\. Gently press the backplate of the MSR-2 case onto the MSR-2 until it lightly snaps into place. Please do not force it, if necessary please repeat steps above until it seats in the case without any force required. -![](/assets/msr-2-add-co2-pic-15.jpg) +![Pressing the backplate onto the MSR-2 case until it snaps into place](/assets/msr-2-add-co2-pic-15.jpg) 7\. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/homey/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module after installation. This is required for all CO2 addons purchased from us separately from a product (such as buying it to addon to an existing Apollo device). \ No newline at end of file diff --git a/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md b/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md index 596545ac24..ca4f2cfad8 100755 --- a/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md @@ -5,27 +5,27 @@ description: "Tutorial on adding the GPIO Header to your MSR-2." 1\. Unplug your MSR-2 from power and remove the back. -![](/assets/msr-2-add-co2-pic-1.jpg) +![Back of the MSR-2 with the Apollo lettered backplate in place](/assets/msr-2-add-co2-pic-1.jpg) -![](/assets/msr-2-add-co2-pic-2.jpg) +![Holding the MSR-2 and lifting the backplate off with a thumb](/assets/msr-2-add-co2-pic-2.jpg) -![](/assets/msr-2-add-co2-pic-3-1.jpg) +![MSR-2 with the backplate removed and set aside, showing the circuit board](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Identify the "X" on the PCB on the back of your MSR-2 and the "X" on the top left corner of the GPIO Header addon. -![](/assets/msr-2-gpio-header-pic-1.jpg) +![Tool pointing at the X mark beside the MSR-2 CN2 connector, with the GPIO Header addon beside it](/assets/msr-2-gpio-header-pic-1.jpg) -![](/assets/msr-2-gpio-header-pic-2.jpg) +![MSR-2 CN2 connector next to the GPIO Header addon with its X mark at the top left](/assets/msr-2-gpio-header-pic-2.jpg) 3\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/msr-2-gpio-header-pic-3.jpg) +![GPIO Header addon seated on the MSR-2 board with the X marks aligned](/assets/msr-2-gpio-header-pic-3.jpg) 4\. Align the new back for your MSR-2 that came with the GPIO Header addon. Push down on the corners closest to the GPIO Header addon first, and then push the back on securely on the other two corners. -![](/assets/msr-2-gpio-header-pic-5.jpg) +![Pressing the GPIO Header backplate onto the MSR-2 near the header first](/assets/msr-2-gpio-header-pic-5.jpg) -![](/assets/msr-2-gpio-header-pic-4.jpg) +![MSR-2 with the GPIO Header backplate fully seated and the header exposed](/assets/msr-2-gpio-header-pic-4.jpg) !!! tip "Make sure to check out our MSR-2 GPIO Header LED Strip Tutorial!" diff --git a/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md b/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md index 702acaf6fe..d3f5f354db 100755 --- a/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md @@ -5,26 +5,26 @@ description: "Tutorial on adding the rear female usb-c port to your MSR-2." 1\. Unplug your MSR-2 from power and remove the back -![](/assets/msr-2-add-co2-pic-1.jpg) +![Back of the MSR-2 with the Apollo lettered backplate in place](/assets/msr-2-add-co2-pic-1.jpg) -![](/assets/msr-2-add-co2-pic-2.jpg) +![Holding the MSR-2 and lifting the backplate off with a thumb](/assets/msr-2-add-co2-pic-2.jpg) -![](/assets/msr-2-add-co2-pic-3-1.jpg) +![MSR-2 with the backplate removed and set aside, showing the circuit board](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Identify the "X" on the PCB on the back of your MSR-2 and the "X" on the top left corner of the Female Rear USB-C addon. -![](/assets/msr-2-female-usb-c-pic-1.jpeg) +![Tool pointing at the X mark beside the MSR-2 CN2 connector, with the rear USB-C addon beside it](/assets/msr-2-female-usb-c-pic-1.jpeg) -![](/assets/msr-2-female-usb-c-pic-2.jpeg) +![Tool pointing at the X mark on the top left corner of the rear USB-C addon](/assets/msr-2-female-usb-c-pic-2.jpeg) 3\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/msr-2-female-usb-c-pic-3.jpeg) +![Rear USB-C addon seated on the MSR-2 board with the X marks aligned](/assets/msr-2-female-usb-c-pic-3.jpeg) 4\. Align the new back for your MSR-2 that came with the Female USB-C addon. It's possible you might have a flat back version and you can print that yourself too! -![](/assets/msr-2-female-usb-c-pic-4.jpeg) +![Pressing the rear USB-C backplate with an articulating mount onto the MSR-2](/assets/msr-2-female-usb-c-pic-4.jpeg) 5\. Push down on the corners closest to the USB-C addon first, and then push the back on securely on the other two corners. -![](/assets/msr-2-female-usb-c-pic-5.jpeg) \ No newline at end of file +![MSR-2 with the rear USB-C backplate seated and the USB-C port exposed](/assets/msr-2-female-usb-c-pic-5.jpeg) \ No newline at end of file diff --git a/docs/homey/products/msr2/addons/msr2-outlet-mount.md b/docs/homey/products/msr2/addons/msr2-outlet-mount.md index eadb44536b..4f4b5ae51b 100755 --- a/docs/homey/products/msr2/addons/msr2-outlet-mount.md +++ b/docs/homey/products/msr2/addons/msr2-outlet-mount.md @@ -6,19 +6,19 @@ description: Tutorial for using the MSR-2 Outlet Mount. 1\. Gather a top facing usb-c plug, an MSR-2, and our MSR-2 Outlet Mount. -![](/assets/msr-2-outlet-mount-pic-1.jpg) +![USB-C wall plug, L-shaped MSR-2 Outlet Mount, and MSR-2 laid out on a table](/assets/msr-2-outlet-mount-pic-1.jpg) 2\. Align the MSR-2 with the USB-C port facing the left side and align the MSR-2 Outlet Mount as shown in the image below. -![](/assets/msr-2-outlet-mount-pic-2.jpg) +![MSR-2 Outlet Mount lined up with the MSR-2 USB-C port facing left](/assets/msr-2-outlet-mount-pic-2.jpg) 3\. Push the MSR-2 Outlet Mount into the usb-c port until it's fully seated. Do not push hard, it will go in very smoothly. -![](/assets/msr-2-outlet-mount-pic-3.jpg) +![MSR-2 Outlet Mount fully seated in the MSR-2 USB-C port](/assets/msr-2-outlet-mount-pic-3.jpg) 4\. Gently push the other USB-C port of the MSR-2 Outlet Mount into the top of the USB-C top facing plug. -![](/assets/msr-2-outlet-mount-pic-4.jpg) +![MSR-2 on the Outlet Mount plugged into the top of a USB-C wall plug](/assets/msr-2-outlet-mount-pic-4.jpg) !!! success "You're ready to plug it in and begin using your device!" diff --git a/docs/homey/products/msr2/calibrating-co2.md b/docs/homey/products/msr2/calibrating-co2.md index b475f02732..306de489d2 100755 --- a/docs/homey/products/msr2/calibrating-co2.md +++ b/docs/homey/products/msr2/calibrating-co2.md @@ -16,7 +16,7 @@ This article will guide you through a simple calibration of your CO2 1\. Plug in your sensor outdoors and leave it for at least 5 minutes to allow the readings to stabilize. This should be around 420 ppm per NASA. -![](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) +![AIR-1 plugged into USB-C power outdoors on concrete to read fresh air CO2](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) 2\. Go to your Home Assistant dashboard and hit the letter "e" - It will pop up with an entity filter then type in "Calibrate CO2" and select the correct device. @@ -24,8 +24,8 @@ This article will guide you through a simple calibration of your CO2 If you cannot get this menu to pop-up, click somewhere on the Home Assistant dashboard then press your "e" key. -![Image of popup with CO2 calibration choice circled in red](/assets/co2-calibration-quick-pic-1.png) +![Home Assistant entity search for Calibrate CO2 with the AIR-1 Calibrate SCD40 To 420ppm button circled](/assets/co2-calibration-quick-pic-1.png) 3\. Click on the button that says "PRESS" and then you are done. -![Image of popup with CO2 calibration press button circled in red](/assets/co2-calibration-quick-pic-2.png) +![Home Assistant Calibrate SCD40 To 420ppm dialog with the PRESS button circled in red](/assets/co2-calibration-quick-pic-2.png) diff --git a/docs/homey/products/msr2/examples/msr2-alarmo.md b/docs/homey/products/msr2/examples/msr2-alarmo.md index 832c0e9641..21806af6b8 100755 --- a/docs/homey/products/msr2/examples/msr2-alarmo.md +++ b/docs/homey/products/msr2/examples/msr2-alarmo.md @@ -8,29 +8,29 @@ My grandmother wanted a security system that would alert her when there was move 1\. Install [HACS](https://hacs.xyz/docs/use/download/download/) 2\. Install [Alarmo](https://github.com/nielsfaber/alarmo?tab=readme-ov-file#installation) and the [Alarmo Card](https://github.com/nielsfaber/alarmo-card) (Pretty Arm and Disarm card for your HA dashboard) -![Alarmo 7.png](/assets/alarmo-7.png) +![Alarmo card on a Home Assistant dashboard showing Disarmed with Arm Away and Arm Home buttons](/assets/alarmo-7.png) -![Alarmo 1.png](/assets/alarmo-1.png) +![Alarmo General tab in Home Assistant with global alarm settings and arm modes, Armed home enabled](/assets/alarmo-1.png) 3\. Find Alarmo on the left, select the Sensors tab, and toggle on the sensor entities that you would like to use for your alarm system. -![Alarmo 2.png](/assets/alarmo-2.png) +![Alarmo Sensors tab with MSR-1 radar target entities toggled on for Home arm mode](/assets/alarmo-2.png) 4\. Now select the Actions tab and under Condition > Event > Select "Alarm is triggered". You can also select the device you would like to receive a notification on under Task > Target > Select Device (Phone, tablet, etc.) -![Alarmo 3.png](/assets/alarmo-3.png) +![Alarmo notification setup with Event set to Alarm is triggered and Target set to a phone](/assets/alarmo-3.png) 5\. You can change the Title, Message, and Name of the alarm notification. -![Alarmo 4.png](/assets/alarmo-4.png) +![Alarmo notification Title, Message, and Name fields filled in for a movement alert](/assets/alarmo-4.png) 6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Uner Entity select your sensors RGB light. -![Alarmo 5.png](/assets/alarmo-5.png) +![Alarmo action setup for Alarm is triggered with AIR-1 and MSR-1 RGB light entities selected](/assets/alarmo-5.png) 7\. Under Action select Turn On and now your sensors RGB lights will turn on when the alarm is triggered. -![Alarmo 6.png](/assets/alarmo-6.png) +![Alarmo action with the RGB light entities selected and Turn On chosen as the action](/assets/alarmo-6.png) 8\. And that's it, seriously... Now you can enjoy a free and local security system. diff --git a/docs/homey/products/msr2/examples/msr2-dashboards.md b/docs/homey/products/msr2/examples/msr2-dashboards.md index c3c249db34..ecf56115fd 100755 --- a/docs/homey/products/msr2/examples/msr2-dashboards.md +++ b/docs/homey/products/msr2/examples/msr2-dashboards.md @@ -6,7 +6,7 @@ description: "Example dashboard cards for the MSR-2, including an ApexCharts sca **Radar Scatter Plot With Apex Charts For **[**MSR-2**](https://apolloautomation.com/products/msr-2) -![JPE Apex Charts 3.png](/assets/jpe-apex-charts-3.png) +![ApexCharts scatter plot card of MSR-1 radar detection, moving, and still distances over time](/assets/jpe-apex-charts-3.png) ```plaintext type: custom:apexcharts-card @@ -46,7 +46,7 @@ series: **CO2 Charts** Home Assistant Sensor -![CO 2 Graph.png](/assets/co-2-graph.png) +![Home Assistant sensor card with a Bedroom CO2 line graph reading 1,000 ppm](/assets/co-2-graph.png) ```plaintext graph: line @@ -59,7 +59,7 @@ hours_to_show: 24 Custom: Plotly Graph Card -![Plotly CO2 Graph.png](/assets/plotly-co2-graph.png) +![Plotly graph card of Bedroom CO2 in ppm over 24 hours](/assets/plotly-co2-graph.png) ```plaintext type: custom:plotly-graph @@ -72,7 +72,7 @@ title: Bedroom CO2 Home Assistant Guage -![CO2 Guage.png](/assets/co2-guage.png) +![Home Assistant gauge card showing MSR-1 CO2 at 1,063 ppm with green, yellow, and red ranges](/assets/co2-guage.png) ```plaintext type: gauge diff --git a/docs/homey/products/msr2/examples/using-msr-2-buzzer.md b/docs/homey/products/msr2/examples/using-msr-2-buzzer.md index bb7547b4ba..c95afbb076 100755 --- a/docs/homey/products/msr2/examples/using-msr-2-buzzer.md +++ b/docs/homey/products/msr2/examples/using-msr-2-buzzer.md @@ -7,7 +7,7 @@ This guide will walk you through using the buzzer on your MSR-2. You can also us 1. Open Home Assistant and navigate to developer tools in the bottom left -![Screenshot 2023-11-01 at 10.52.38 PM.png](/assets/screenshot-2023-11-01-at-10-52-38-pm.png) +![Home Assistant sidebar with the Developer tools hammer icon highlighted](/assets/screenshot-2023-11-01-at-10-52-38-pm.png) 2\. Click on services @@ -29,4 +29,4 @@ This guide will walk you through using the buzzer on your MSR-2. You can also us 5\. Click on the ACTIONS button in bottom right -![image.png](/assets/HJuimage.png) \ No newline at end of file +![Home Assistant Developer tools Actions tab with the ESPHome MSR-2 play buzzer action and an RTTTL song entered](/assets/HJuimage.png) \ No newline at end of file diff --git a/docs/homey/products/msr2/setup/msr2-general-tips.md b/docs/homey/products/msr2/setup/msr2-general-tips.md index e52dd60156..1c5cb28d5e 100755 --- a/docs/homey/products/msr2/setup/msr2-general-tips.md +++ b/docs/homey/products/msr2/setup/msr2-general-tips.md @@ -5,7 +5,7 @@ description: "Multiple helpful images for mounting, lux/rgb, and gate and zone v ##### **Light Sensor (LTR-390UV)** -![20240514_123742.jpg](/assets/20240514-123742.jpg) +![MSR-2 enclosure with the light sensor visible through the vent slots, outlined in red](/assets/20240514-123742.jpg) When mounting the MSR-2 be sure to position the device so that the two large holes are not covered. This allows more light to enter and will ensure better accuracy. @@ -17,11 +17,11 @@ When mounting the MSR-2 be sure to position the device so that the two large hol The MSR-2 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120degree FOV of the mmWave radar. -![ld2410_mounting_hor-1.jpeg](/assets/ld2410-mounting-hor-1.jpeg) +![HLK-LD2410B manual diagram of wall mounting at 1.5 to 2 m with a detection range chart by angle](/assets/ld2410-mounting-hor-1.jpeg) The MSR-2 can also be mounted on the ceiling if you can provide power and mount our articulating stand on the ceiling. -![LD2410 Gates.png](/assets/ld2410-gates.png) +![LD2410 diagrams for wall mounting at 1.5 to 2 m and ceiling mounting at 2.6 to 3 m](/assets/ld2410-gates.png) !!! tip "These are some useful hints!" @@ -31,6 +31,6 @@ The MSR-2 can also be mounted on the ceiling if you can provide power and mount ##### **Gate and FOV Visualization** -**![ld2410 table.png](/assets/ld2410-table.png)![Gate, Zones and RR.png](/assets/gate-zones-and-rr.png)** +**![Table of LD2410 gates 0 to 8 with distances in meters and feet and default move and still thresholds](/assets/ld2410-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)** -![MSR-1 radar map.png](/assets/msr-1-radar-map.png)![Radar gates Colored.png](/assets/radar-gates-colored.png) \ No newline at end of file +![Radar field of view diagram split into gates G1 to G7 at 0.75 m steps out to 5 m](/assets/msr-1-radar-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) \ No newline at end of file diff --git a/docs/homey/products/msr2/setup/zones-ha.md b/docs/homey/products/msr2/setup/zones-ha.md index c517827a42..ef72cb59f2 100755 --- a/docs/homey/products/msr2/setup/zones-ha.md +++ b/docs/homey/products/msr2/setup/zones-ha.md @@ -15,15 +15,15 @@ Here is a video of how to tune the mmWave sensor using radar engineering mode, 2. Navigate to Settings>Devices & services>ESPHome>Select the MSR-2 3. Scroll down to the Configuration section 4. Turn on Radar Engineering Mode (REM) - ![Configuration.png](/assets/5l4configuration.png) + ![Home Assistant Configuration card with the Radar Engineering Mode toggle highlighted](/assets/5l4configuration.png) 5. Scroll down to the Diagnostic section and you will see that REM shows the move and still energy for gates 0-8 - ![Diagnostic.png](/assets/diagnostic.png) + ![Diagnostic card listing move and still energy percentages for gates 0 to 8](/assets/diagnostic.png) 6. The gates are different distances from the sensor - ![ld2410 table.png](/assets/ld2410-table_1.png)![MSR-1 radar map.png](/assets/msr-1-radar-map_1.png) + ![LD2410 gate table with distance ranges and default move and still thresholds](/assets/ld2410-table_1.png)![Radar cone diagram showing gates G1 to G7 in 0.75 m steps out to 5 m](/assets/msr-1-radar-map_1.png) 7. Moving the gate still and move threshold slider to the right increases the amount of energy needed to trigger the sensor. Do this if you want the gate to be less sensitive. - ![High Threshold.png](/assets/high-threshold.png) + ![g0 move and still threshold sliders pushed all the way to the right](/assets/high-threshold.png) 8. Moving the gate still and move threshold slider to the left decreases the amount of energy needed to trigger the sensor. Do this if you want the gate to be more sensitive. - ![Low Threshold.png](/assets/low-threshold.png) + ![g0 move and still threshold sliders pushed all the way to the left](/assets/low-threshold.png) **Alternate Method** diff --git a/docs/homey/products/msr2/setup/zones-hlk.md b/docs/homey/products/msr2/setup/zones-hlk.md index dacdddb108..1c09558b6c 100755 --- a/docs/homey/products/msr2/setup/zones-hlk.md +++ b/docs/homey/products/msr2/setup/zones-hlk.md @@ -10,41 +10,41 @@ description: "Tutorial for MSR-2 HLKRadarTool app Zone Configuration." 2\. Ensure the mmWave radar you want to tune has Radar Control Bluetooth turned on. Home Assistant > Settings > Devices & services > ESPHome Devices > Select Device > Scroll down and toggle on Radar Control Bluetooth -![Radar Control Bluetooth.png](/assets/radar-control-bluetooth.png) +![Home Assistant device controls with the Radar Control Bluetooth toggle turned on and outlined in red](/assets/radar-control-bluetooth.png) 3\. Open the app and select your device -![Find Device.png](/assets/find-device.png) +![HLKRadarTool device list showing the HLK-LD2410 radar found nearby](/assets/find-device.png) 4\. Turn on Engineering Mode -![EM.png](/assets/em.png) +![HLKRadarTool device screen with the Engineering mode toggle turned on and outlined in red](/assets/em.png) 5\. Select More and then select Parameter settings -![More and PS.png](/assets/more-and-ps.png) +![HLKRadarTool device screen with More and Parameter settings outlined in red](/assets/more-and-ps.png) 6\. Select Detect background noise -![DBN.png](/assets/dbn.png) +![HLKRadarTool Parameter settings with Detect background noise outlined in red](/assets/dbn.png) 7\. Insert Delay detection and Detection time values. (For iPhone users Delay detection cannot be 0). Then select Start. This will give us our reference values so we can auto-calibrate the mmWave sensor. -![DD, DT and Start.png](/assets/dd-dt-and-start.png) +![HLKRadarTool Bottom noise statistics with Delay detection, Detection time, and Start outlined in red](/assets/dd-dt-and-start.png) 8\. Select Back to navigate to the Parameter settings. Then select one of the auto-calibration buttons. **Average** - Sets the gate sensitivity to the average move and still energy -![Average.png](/assets/average.png) +![HLKRadarTool Parameter settings with the Average one click setting button outlined in red](/assets/average.png) **Maximum** - Sets the gate sensitivity to the maximum move and still energy -![Max.png](/assets/max.png) +![HLKRadarTool Parameter settings with the Maximum one click setting button outlined in red](/assets/max.png) -**Intelligent** - Sets the gate sensitivity equal to or just above the maximum move and still energ**y** **![Intelligent.png](/assets/intelligent.png)** 9. Now your mmWave should be tuned to your environment! **Manual Calibration** 1. Follow steps 1-5 above +**Intelligent** - Sets the gate sensitivity equal to or just above the maximum move and still energ**y** **![HLKRadarTool Parameter settings with the Intelligent one click setting button outlined in red](/assets/intelligent.png)** 9. Now your mmWave should be tuned to your environment! **Manual Calibration** 1. Follow steps 1-5 above 2\. Select Motion or Static sensitivity, change it to your desired value, and select Set -![Manual.png](/assets/manual.png) +![HLKRadarTool Parameter settings with the 0M motion and static sensitivity values and Set outlined in red](/assets/manual.png) 3\. Now your mmWave should be tuned to your environment! \ No newline at end of file diff --git a/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md b/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md index 6db0389267..97d924b021 100755 --- a/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md +++ b/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md @@ -11,7 +11,7 @@ description: "Step by step guide for putting The MSR-2 In Boot Mode." 1\. Position the MSR-2 as shown in the image below and locate the small opening to press the boot button (the right button). -![](/assets/msr-2-boot-button.jpg) +![MSR-2 case side with a tool pointing at the right opening for the boot button](/assets/msr-2-boot-button.jpg) 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. @@ -25,6 +25,6 @@ description: "Step by step guide for putting The MSR-2 In Boot Mode." 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. -![](/assets/msr-2-reset-button.jpg) +![MSR-2 case side with a tool pointing at the left opening for the reset button](/assets/msr-2-reset-button.jpg) 4\. Continue with uploading the firmware document. \ No newline at end of file diff --git a/docs/homey/products/msr2/troubleshooting/msr2-code.md b/docs/homey/products/msr2/troubleshooting/msr2-code.md index 5510cce6b2..c213fa1e99 100755 --- a/docs/homey/products/msr2/troubleshooting/msr2-code.md +++ b/docs/homey/products/msr2/troubleshooting/msr2-code.md @@ -11,7 +11,7 @@ If your device has already been connected to Home Assistant please 2 sensor. There is an X on the SCD40 sensor's PCB as well, you can see it in the image below. There is also a "gold dot" in the top left of the SCD40 when oriented properly. -![](/assets/mtr-1-add-co2-pic-6.jpg)![](/assets/mtr-1-add-co2-pic-7.jpg) +![Close-up of the MTR-1 black mezzanine connector with the X mark at its bottom right](/assets/mtr-1-add-co2-pic-6.jpg)![SCD40 CO2 module next to the MTR-1 connector with matching X marks on both boards](/assets/mtr-1-add-co2-pic-7.jpg) 4\. Gently push the SCD40 CO2 module onto the black mezzanine connector. -![](/assets/mtr-1-add-co2-pic-8.jpg)![](/assets/mtr-1-add-co2-pic-9.jpg) +![Pressing the SCD40 CO2 module onto the MTR-1 mezzanine connector](/assets/mtr-1-add-co2-pic-8.jpg)![Side view of the SCD40 CO2 module seated on the MTR-1 board](/assets/mtr-1-add-co2-pic-9.jpg) 5\. Slide the case back over the MTR-1, making sure that the case has the hole for the LUX Sensor facing the right direction (to the right). -![](/assets/mtr-1-add-co2-pic-10.jpg) +![Sliding the case back over the MTR-1 board](/assets/mtr-1-add-co2-pic-10.jpg) 6\. Flip the MTR-1 back over to prepare to put the back case on. -![](/assets/mtr-1-add-co2-pic-11.jpg) +![Back of the MTR-1 in its case with the board visible, ready for the backplate](/assets/mtr-1-add-co2-pic-11.jpg) 7\. Gently press the backplate of the MTR-1 case onto the MTR-1 until it lightly snaps into place. Please do not force it, if necessary please repeat steps above until it seats in the case without any force required. -![](/assets/mtr-1-add-co2-pic-12.jpg)![](/assets/mtr-1-add-co2-pic-13.jpg) +![Pressing the backplate onto the MTR-1 until it snaps into place](/assets/mtr-1-add-co2-pic-12.jpg)![Pressing a corner of the backplate to seat it on the MTR-1](/assets/mtr-1-add-co2-pic-13.jpg) 8\. Put the stand back on if applicable. -![](/assets/mtr-1-add-co2-pic-14.jpg) +![Reassembled MTR-1 with the stand attached](/assets/mtr-1-add-co2-pic-14.jpg) 9\. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module after installation. This is required for all CO2 addons purchased from us separately from a product (such as buying it to addon to an existing Apollo device). \ No newline at end of file diff --git a/docs/homey/products/mtr1/addons/adding-gpio-header-to-mtr-1.md b/docs/homey/products/mtr1/addons/adding-gpio-header-to-mtr-1.md index fc6d3039e2..08834eef19 100755 --- a/docs/homey/products/mtr1/addons/adding-gpio-header-to-mtr-1.md +++ b/docs/homey/products/mtr1/addons/adding-gpio-header-to-mtr-1.md @@ -6,31 +6,31 @@ description: Step by step tutorial for adding the GPIO Header Addon to the MTR-1 1\. Unplug your MTR-1 from power and remove the stand if attached. -![](/assets/mtr-1-add-co2-pic-1.jpg) +![Back of the MTR-1 with the stand still attached beside the USB-C port](/assets/mtr-1-add-co2-pic-1.jpg) 2\. Remove the backplate of the MTR-1. -![](/assets/mtr-1-add-co2-pic-4.jpg) +![MTR-1 with the backplate removed, exposing the green PCB and mezzanine connector](/assets/mtr-1-add-co2-pic-4.jpg) 3\. Identify the "X" on the PCB on the back of your MTR-1 and the "X" on the top left corner of the GPIO Header addon. -![](/assets/mtr-1-add-gpio-pic-1.jpg) +![Tool pointing to the X marking beside the mezzanine connector on the MTR-1 PCB](/assets/mtr-1-add-gpio-pic-1.jpg) -![](/assets/mtr-1-add-gpio-pic-2.jpg) +![Tool pointing to the X marking in the top left corner of the GPIO Header addon](/assets/mtr-1-add-gpio-pic-2.jpg) 4\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/mtr-1-add-gpio-pic-3.jpg) +![Fingers pressing the GPIO Header addon into place on the back of the MTR-1](/assets/mtr-1-add-gpio-pic-3.jpg) 5\. Align the new back for your MTR-1 that came with the GPIO Header addon. Push down on the corners closest to the GPIO Header addon first, and then push the back on securely on the other two corners. -![](/assets/mtr-1-add-gpio-pic-4-1.jpg) +![GPIO Header addon seated on the MTR-1 PCB, with the new backplate ready to fit](/assets/mtr-1-add-gpio-pic-4-1.jpg) 6\. The case should sit flush and you're now ready to add functionality to your device! -![](/assets/mtr-1-add-gpio-pic-5.jpg) +![Assembled MTR-1 with the new backplate sitting flush around the GPIO Header addon](/assets/mtr-1-add-gpio-pic-5.jpg) -![](/assets/gpio-header-pinout.webp) +![GPIO Header addon pinout diagram labeling the GND, 5V, 3V, SDA, SCL, and IO pins](/assets/gpio-header-pinout.webp) !!! ! tip "Make sure to check out our GPIO Header LED Strip Tutorial!" diff --git a/docs/homey/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md b/docs/homey/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md index cbd0458171..eccc4f0556 100755 --- a/docs/homey/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md +++ b/docs/homey/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md @@ -6,26 +6,26 @@ description: Step by step tutorial for adding the Rear Male USB addon to the MTR 1\. Unplug your MTR-1 from power and remove the stand if attached. -![](/assets/mtr-1-add-co2-pic-1.jpg) +![Back of the MTR-1 with the stand still attached beside the USB-C port](/assets/mtr-1-add-co2-pic-1.jpg) 2\. Remove the backplate of the MTR-1. -![](/assets/mtr-1-add-co2-pic-4.jpg) +![MTR-1 with the backplate removed, exposing the green PCB and mezzanine connector](/assets/mtr-1-add-co2-pic-4.jpg) 3\. Identify the "X" on the PCB on the back of your MTR-1 and the "X" on the top left corner of the male Rear USB-C addon. -![](/assets/mtr-1-add-male-usb-pic-1.jpg) +![Tool pointing to the X marking beside the mezzanine connector on the MTR-1 PCB](/assets/mtr-1-add-male-usb-pic-1.jpg) -![](/assets/mtr-1-add-male-usb-pic-2.jpg) +![Tool pointing to the X marking in the top left corner of the Rear Male USB-C addon](/assets/mtr-1-add-male-usb-pic-2.jpg) 4\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/mtr-1-add-male-usb-pic-3.jpg) +![Rear Male USB-C addon seated on the mezzanine connector of the MTR-1 PCB](/assets/mtr-1-add-male-usb-pic-3.jpg) 5\. Align the new back for your MTR-1 that came with the Male USB-C addon. Push down on the corners closest to the USB-C addon first, and then push the back on securely on the other two corners. -![](/assets/mtr-1-add-male-usb-pic-4.jpg) +![Fingers pushing the new backplate onto the MTR-1 around the Male USB-C addon](/assets/mtr-1-add-male-usb-pic-4.jpg) 6\. The case should sit flush and you're now ready to plug into a USB-C Outlet! -![](/assets/mtr-1-add-male-usb-pic-5.jpg) \ No newline at end of file +![Assembled MTR-1 with the new backplate sitting flush around the rear male USB-C plug](/assets/mtr-1-add-male-usb-pic-5.jpg) \ No newline at end of file diff --git a/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md b/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md index a8b2bff103..61e938d299 100755 --- a/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md +++ b/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md @@ -6,7 +6,7 @@ description: "Example dashboard cards for the MTR-1, including an ApexCharts rad **Radar Scatter Plot With Apex Charts** -![JPE Apex Charts 3.png](/assets/jpe-apex-charts-3.png) +![ApexCharts scatter card of MSR-1 radar detection, moving, and still distances with a brush timeline below](/assets/jpe-apex-charts-3.png) ```plaintext type: custom:apexcharts-card @@ -46,7 +46,7 @@ series: **CO2 Charts** Home Assistant Sensor -![CO 2 Graph.png](/assets/co-2-graph.png) +![Home Assistant sensor card with a line graph of Bedroom CO2 reading 1,000 ppm](/assets/co-2-graph.png) ```plaintext graph: line @@ -59,7 +59,7 @@ hours_to_show: 24 Custom: Plotly Graph Card -![Plotly CO2 Graph.png](/assets/plotly-co2-graph.png) +![Plotly Graph card plotting Bedroom CO2 in ppm over 24 hours](/assets/plotly-co2-graph.png) ```plaintext type: custom:plotly-graph @@ -72,7 +72,7 @@ title: Bedroom CO2 Home Assistant Guage -![CO2 Guage.png](/assets/co2-guage.png) +![Home Assistant gauge card reading 1,063 ppm CO2 with green, yellow, and red severity bands](/assets/co2-guage.png) ```plaintext type: gauge diff --git a/docs/homey/products/mtr1/examples/mtr1-alarmo.md b/docs/homey/products/mtr1/examples/mtr1-alarmo.md index a366d7c636..21b498137c 100755 --- a/docs/homey/products/mtr1/examples/mtr1-alarmo.md +++ b/docs/homey/products/mtr1/examples/mtr1-alarmo.md @@ -8,29 +8,29 @@ My grandmother wanted a security system that would alert her when there was move 1\. Install [HACS](https://hacs.xyz/docs/use/download/download/) 2\. Install [Alarmo](https://github.com/nielsfaber/alarmo?tab=readme-ov-file#installation) and the [Alarmo Card](https://github.com/nielsfaber/alarmo-card) (Pretty Arm and Disarm card for your HA dashboard) -![Alarmo 7.png](/assets/alarmo-7.png) +![Alarmo Card on a dashboard showing Disarmed with Arm Away and Arm Home buttons](/assets/alarmo-7.png) -![Alarmo 1.png](/assets/alarmo-1.png) +![Alarmo alarm panel General tab in Home Assistant listing the arm modes](/assets/alarmo-1.png) 3\. Find Alarmo on the left, select the Sensors tab, and toggle on the sensor entities that you would like to use for your alarm system. -![Alarmo 2.png](/assets/alarmo-2.png) +![Alarmo Sensors tab with MSR-1 radar target entities enabled for Home mode](/assets/alarmo-2.png) 4\. Now select the Actions tab and under Condition > Event > Select "Alarm is triggered". You can also select the device you would like to receive a notification on under Task > Target > Select Device (Phone, tablet, etc.) -![Alarmo 3.png](/assets/alarmo-3.png) +![Alarmo notification action with the Alarm is triggered event and a phone as the target](/assets/alarmo-3.png) 5\. You can change the Title, Message, and Name of the alarm notification. -![Alarmo 4.png](/assets/alarmo-4.png) +![Alarmo notification Title, Message, and Name fields filled in for the alarm alert](/assets/alarmo-4.png) 6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Uner Entity select your sensors RGB light. -![Alarmo 5.png](/assets/alarmo-5.png) +![Alarmo action for Alarm is triggered with Apollo sensor RGB light entities selected](/assets/alarmo-5.png) 7\. Under Action select Turn On and now your sensors RGB lights will turn on when the alarm is triggered. -![Alarmo 6.png](/assets/alarmo-6.png) +![Alarmo action with Turn On selected for the Apollo sensor RGB light entities](/assets/alarmo-6.png) 8\. And that's it, seriously... Now you can enjoy a free and local security system. diff --git a/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md b/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md index a9206e9562..8b36c5f29e 100755 --- a/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md +++ b/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md @@ -7,7 +7,7 @@ This guide will walk you through using the buzzer on your MTR-1. You can also us 1. Open Home Assistant and navigate to developer tools in the bottom left -![Screenshot 2023-11-01 at 10.52.38 PM.png](/assets/screenshot-2023-11-01-at-10-52-38-pm.png) +![Developer tools hammer icon highlighted in the Home Assistant sidebar](/assets/screenshot-2023-11-01-at-10-52-38-pm.png) 2\. Click on services @@ -29,4 +29,4 @@ This guide will walk you through using the buzzer on your MTR-1. You can also us 5\. Click on the ACTIONS button in bottom right -![image.png](/assets/HJuimage.png) \ No newline at end of file +![Home Assistant Developer tools with the Actions tab circled and the ESPHome play_buzzer action filled in](/assets/HJuimage.png) \ No newline at end of file diff --git a/docs/homey/products/mtr1/setup/general-tips.md b/docs/homey/products/mtr1/setup/general-tips.md index 3c3aae7ee1..838cad3f4d 100755 --- a/docs/homey/products/mtr1/setup/general-tips.md +++ b/docs/homey/products/mtr1/setup/general-tips.md @@ -4,11 +4,11 @@ description: "Multiple helpful images for mounting, lux/rgb, and zone visualizat ##### **MTR-1 PCB with Sensors** -![20240501_155316.jpg](/assets/20240501-155316.jpg)![20240501_155130.jpg](/assets/20240501-155130.jpg)![20240501_155248.jpg](/assets/20240501-155248.jpg) +![MTR-1 main board with the ESP32-C3, Boot and Reset buttons, RGB LED, and buzzer](/assets/20240501-155316.jpg)![MTR-1 with the HLK-LD2450 radar module laid out beside the ESP32-C3 board](/assets/20240501-155130.jpg)![Back of the MTR-1 board with the Apollo logo and USB-C port](/assets/20240501-155248.jpg) ##### **Light Sensor (LTR-390UV)** -![Screenshot 2024-04-30 at 5.42.54 PM.png](/assets/screenshot-2024-04-30-at-5-42-54-pm.png) +![MTR-1 case render with the light sensor opening at the top circled in red](/assets/screenshot-2024-04-30-at-5-42-54-pm.png) When mounting the MTR-1 be sure to position the device so that the large hole at the top is not covered. This allows more light to enter and will ensure better accuracy @@ -16,19 +16,19 @@ The onboard RGB LED will trigger the light sensor. Be cognizant of this when mak ##### **Mounting** -![Screenshot 2024-04-30 at 5.51.36 PM.png](/assets/screenshot-2024-04-30-at-5-51-36-pm.png) +![LD2450 datasheet diagrams of wall mounting at 1.5 to 2 m, mounting angle, and tracking range](/assets/screenshot-2024-04-30-at-5-51-36-pm.png) ##### **LD2450 Performance and Electrical Parameters** ##### [**LD2450 Datasheet**](https://www.tinytronics.nl/index.php?route=product/product/get_file&file=6000/HLK-LD2450-Instruction-Manual.pdf) -![Screenshot 2024-04-30 at 5.53.09 PM.png](/assets/screenshot-2024-04-30-at-5-53-09-pm.png) +![LD2450 datasheet table of performance and electrical parameters](/assets/screenshot-2024-04-30-at-5-53-09-pm.png) ##### **Expanding Horizontal Distance as Target Moves Further Away** The detection is 60 degrees from center on each side. So it is a cone when you are close to it but at 4 feet away to the side you might not be visible. If you are further from the wall it can detect further in a horizontal distance. -![image.png](/assets/9jtimage.png) +![HLK-LD2450 demo app tracking two targets inside the wide radar detection cone](/assets/9jtimage.png) ##### **Increased ESP Temperature** diff --git a/docs/homey/products/mtr1/setup/zones-hlk.md b/docs/homey/products/mtr1/setup/zones-hlk.md index 84ce325bb1..9512e007ae 100755 --- a/docs/homey/products/mtr1/setup/zones-hlk.md +++ b/docs/homey/products/mtr1/setup/zones-hlk.md @@ -20,7 +20,7 @@ The ESPHome Integrations page then select your MTR-1 and scroll down until you see LD2450 Bluetooth. -![Screenshot 2024-05-14 at 10.30.31 AM.png](/assets/mtr-1-toggle-on-ld2450-bluetooth.png) +![MTR-1 Configuration card with the LD2450 Bluetooth toggle turned on and highlighted](/assets/mtr-1-toggle-on-ld2450-bluetooth.png) 2\. Open the HLKRadarTool App and select your device. @@ -28,11 +28,11 @@ The uploading the firmware document. \ No newline at end of file diff --git a/docs/homey/products/mtr1/troubleshooting/mtr1-code.md b/docs/homey/products/mtr1/troubleshooting/mtr1-code.md index bb26b8451b..d7bf76630f 100755 --- a/docs/homey/products/mtr1/troubleshooting/mtr1-code.md +++ b/docs/homey/products/mtr1/troubleshooting/mtr1-code.md @@ -11,7 +11,7 @@ If your device has already been connected to Home Assistant please Home Assistant Plant Integration

This integration can automatically fetch data from OpenPlantBook if you are a registered user. Registration is free.

Plants are set up in the UI and all configuration of your plants can be managed there or by automations and scripts. diff --git a/docs/homey/products/plt1/general-tips.md b/docs/homey/products/plt1/general-tips.md index 88644ab58a..5639c365ef 100755 --- a/docs/homey/products/plt1/general-tips.md +++ b/docs/homey/products/plt1/general-tips.md @@ -7,10 +7,10 @@ description: "Helpful tips to get the most use out of your sensor." When looking at the PLT-1 in the below orientation, the boot button is on the left and the reset is on the right by the USB-C port. -![](/assets/plt-1-buttons-1.png) +![PLT-1 diagram labeling the boot button on the left and the reset button and USB port on the right](/assets/plt-1-buttons-1.png) ## LTR390 UV For the most accurate UV and LUX readings, be sure to expose the sensor circled in the image below to light. -![](/assets/screenshot-2024-10-22-at-3-35-46-pm.png) \ No newline at end of file +![Back of the PLT-1 with the LTR390 UV sensor circled in the top left corner](/assets/screenshot-2024-10-22-at-3-35-46-pm.png) \ No newline at end of file diff --git a/docs/homey/products/plt1/setup/prevent-sleep.md b/docs/homey/products/plt1/setup/prevent-sleep.md index e1cba1f6a5..7c97d5bd9a 100755 --- a/docs/homey/products/plt1/setup/prevent-sleep.md +++ b/docs/homey/products/plt1/setup/prevent-sleep.md @@ -13,11 +13,11 @@ description: "Tutorial for how to enable/disable prevent sleep." 2\. Click on the name "1 device" below your Apollo device's name. -![](/assets/plt-1-prevent-sleep-pic-1.png) +![ESPHome integration entry for an Apollo PLT-1 with the 1 device link highlighted](/assets/plt-1-prevent-sleep-pic-1.png) 3\. Scroll down until you see "Prevent Sleep" and "Sleep Duration". -![](/assets/plt-1-prevent-sleep-pic-2.png) +![Home Assistant device page with the Prevent Sleep toggle and Sleep Duration setting highlighted](/assets/plt-1-prevent-sleep-pic-2.png) 4\. Type in the amount of minutes you want your sensor to sleep in the "Sleep Duration" box. Defaults to 5 minutes. diff --git a/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md b/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md index 492a2a026f..860e57d6dd 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md @@ -11,7 +11,7 @@ description: "Step by step guide for putting The PLT-1 In Boot Mode." 1\. Position the PLT-1 as shown in the image below and locate the small opening to press the boot button. -![](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) +![Side of the PLT-1 with the boot button opening circled](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) 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. @@ -25,6 +25,6 @@ description: "Step by step guide for putting The PLT-1 In Boot Mode." 3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button. -![](/assets/screenshot-2024-10-23-at-12-35-01-pm.png) +![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) 4\. Continue with uploading the firmware document. \ No newline at end of file diff --git a/docs/homey/products/plt1/troubleshooting/plt1-code.md b/docs/homey/products/plt1/troubleshooting/plt1-code.md index aee83e601b..f0ddbe66b1 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-code.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-code.md @@ -11,29 +11,29 @@ If your device has already been connected to Home Assistant please Put your device in boot mode by holding down the boot button and then plugging in the USB cable. -![](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) +![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 Apollo PLT-1 Installer 3\. Click the big "Connect" button. -![](/assets/plt-1-reflash-pic-1-1.png) +![Apollo PLT-1 Installer page with the Non Battery Firmware Connect button highlighted](/assets/plt-1-reflash-pic-1-1.png) 4\. Select the open com port then click Connect. -![](/assets/plt-1-reflash-pic-2-1.png) +![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". -![](/assets/plt-1-reflash-pic-3.png) +![Installer Device Dashboard with the Install ApolloAutomation.PLT-1 option highlighted](/assets/plt-1-reflash-pic-3.png) 6\. Click "INSTALL". -![](/assets/plt-1-reflash-pic-4.png) +![PLT-1 install confirmation dialog with the Install button highlighted](/assets/plt-1-reflash-pic-4.png) 7\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/plt-1-reflash-pic-5.png) +![Installer showing Installation complete with the Next button](/assets/plt-1-reflash-pic-5.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md b/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md index 8c3992b9ba..45628b1c7a 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md @@ -7,7 +7,7 @@ description: "Step by step guide for resetting the Wi-Fi Credentials on your PLT 2\. Long press the Boot button for 10 seconds -![](/assets/plt-1-boot-button-pic-1.png) +![Side of the PLT-1 with the boot button opening circled](/assets/plt-1-boot-button-pic-1.png) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/homey/products/plt1b/general-tips.md b/docs/homey/products/plt1b/general-tips.md index 3beb9d1ece..b686642dab 100755 --- a/docs/homey/products/plt1b/general-tips.md +++ b/docs/homey/products/plt1b/general-tips.md @@ -7,10 +7,10 @@ description: "Helpful tips to get the most use out of your sensor." When looking at the PLT-1B in the below orientation, the boot button is on the left and the reset is on the right by the USB-C port. -![](/assets/plt-1b-buttons.png) +![PLT-1B diagram labeling the reset button on the left and the boot button and USB-C port on the right](/assets/plt-1b-buttons.png) ## LTR390 UV For the most accurate UV and LUX readings, be sure to expose the sensor circled in the image below to light. -![](/assets/plt-1b-buttons-1.png) \ No newline at end of file +![PLT-1B diagram with the LTR390 UV sensor circled in the top left corner](/assets/plt-1b-buttons-1.png) \ No newline at end of file diff --git a/docs/homey/products/plt1b/setup/prevent-sleep.md b/docs/homey/products/plt1b/setup/prevent-sleep.md index 0987d02c0c..c313b857d5 100755 --- a/docs/homey/products/plt1b/setup/prevent-sleep.md +++ b/docs/homey/products/plt1b/setup/prevent-sleep.md @@ -13,11 +13,11 @@ description: "Keep the PLT-1B awake instead of letting it sleep, and what that c 2\. Click on the name "1 device" below your Apollo device's name. -![](/assets/plt-1b-prevent-sleep-pic-1.png) +![ESPHome integration entry for an Apollo PLT-1B with the 1 device link highlighted](/assets/plt-1b-prevent-sleep-pic-1.png) 3\. Scroll down until you see "Prevent Sleep" and "Sleep Duration". -![](/assets/plt-1b-prevent-sleep-pic-2.png) +![Home Assistant device page with the Prevent Sleep toggle and Sleep Duration setting highlighted](/assets/plt-1b-prevent-sleep-pic-2.png) 4\. Type in the amount of minutes you want your sensor to sleep in the "Sleep Duration" box. Defaults to 12 hours. diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md b/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md index 92a11c3817..2172554c0d 100755 --- a/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md +++ b/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md @@ -7,15 +7,15 @@ description: "Step by step guide for putting The PLT-1B In Boot Mode." This is needed to force the device into boot mode to reflash the firmware. -![](/assets/plt-1b-buttons-2.png) +![PLT-1B diagram labeling the reset button on the left and the boot button and USB-C port on the right](/assets/plt-1b-buttons-2.png) ##### Method 1: Boot Button Only 1\. Position the PLT-1B as shown in the image below and locate the small opening to press the boot button. -![](/assets/plt-boot-mode-pic-2.jpg) +![Open PLT-1B case with a tool pointing to the boot button on the PCB near the USB-C port](/assets/plt-boot-mode-pic-2.jpg) -![](/assets/plt-boot-mode-pic-4.jpg) +![Tool inserted into the boot button opening on the side of the closed PLT-1B case](/assets/plt-boot-mode-pic-4.jpg) 2\. Use a pin to press and hold the boot button, while holding the boot button plug the PLT-1B back into your computer/power and then release the boot button @@ -27,8 +27,8 @@ description: "Step by step guide for putting The PLT-1B In Boot Mode." 2\. Press and hold the boot button, while holding it press and release the reset button, then release the boot button -![](/assets/plt-boot-mode-pic-6.jpg) +![Tool pointing to the reset button on the PLT-1B PCB](/assets/plt-boot-mode-pic-6.jpg) -![](/assets/plt-boot-mode-pic-7.jpg) +![Tool pointing to the reset button opening on the end of the closed PLT-1B case](/assets/plt-boot-mode-pic-7.jpg) 3\. Continue with [uploading the firmware](https://wiki.apolloautomation.com/products/plt1b/troubleshooting/plt1b-code/) \ No newline at end of file diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-code.md b/docs/homey/products/plt1b/troubleshooting/plt1b-code.md index 18774753fa..0c2ea18589 100755 --- a/docs/homey/products/plt1b/troubleshooting/plt1b-code.md +++ b/docs/homey/products/plt1b/troubleshooting/plt1b-code.md @@ -13,17 +13,17 @@ If your device has already been connected to Home Assistant please Put your device in boot mode by holding down the boot button and then plugging in the USB cable. -![](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) +![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 Battery Firmware Apollo PLT-1B Installer @@ -51,23 +51,23 @@ If your device has already been connected to Home Assistant please in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. my minimums are around -20F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe, with arrows marking the highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2C and a min probe temp of -30C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![TEMP-1 Max Probe Temp set to 2.0 and Min Probe Temp set to -30.0 degrees Celsius](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1 will play an audible alert with it's buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off -![](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file +![TEMP-1 Controls card with the Alarm Outside Temp Range toggle being switched on](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file diff --git a/docs/homey/products/temp1/examples/temp1-automation-examples.md b/docs/homey/products/temp1/examples/temp1-automation-examples.md index 4e31ed9850..0d61f133a9 100755 --- a/docs/homey/products/temp1/examples/temp1-automation-examples.md +++ b/docs/homey/products/temp1/examples/temp1-automation-examples.md @@ -11,11 +11,11 @@ This will guide you through how to setup an automation in Home Assistant using t 2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. my minimums are around -20°F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe, with arrows marking the highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2°C and a min probe temp of -30°C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![TEMP-1 Max Probe Temp set to 2.0 and Min Probe Temp set to -30.0 degrees Celsius](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. The automation is now ready to be created - @@ -23,11 +23,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you found in step 2 above. Advanced users skip to step 10. -![](/assets/temp-1-temp-probe-ex-automation-pic-3.png) +![Numeric state trigger on Apollo TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png) 7\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -35,11 +35,11 @@ This will guide you through how to setup an automation in Home Assistant using t 8\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1 reached its max temperature and your freezer might be having issues." and "Check the freezer!". -![](/assets/temp-1-temp-probe-ex-automation-pic-5.png) +![Notification action with the freezer warning message and Check the freezer title highlighted](/assets/temp-1-temp-probe-ex-automation-pic-5.png) 9\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-temp-probe-ex-automation-pic-6.png) +![Automation Save dialog with name, description, and category filled in and Save highlighted](/assets/temp-1-temp-probe-ex-automation-pic-6.png) --- @@ -71,7 +71,7 @@ This will guide you through how to setup an automation in Home Assistant using t 1\. Set your Max Probe Temp to 73.9°C. The offsets MUST be in Celsius even if you are using F in the automation below. -![](/assets/temp-1-food-probe-ex-automation-pic-1.png) +![TEMP-1 Max Probe Temp setting highlighted with a value of 73.9 degrees Celsius](/assets/temp-1-food-probe-ex-automation-pic-1.png) 2\. Place the food probe inside your food once it's on the grill. Make sure your TEMP-1 is in a cool dry place - only the food probe and the wire can withstand temperatures on a grill, in the oven, etc. @@ -79,11 +79,11 @@ This will guide you through how to setup an automation in Home Assistant using t 4\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. -![](/assets/temp-1-food-probe-ex-automation-pic-3.png) +![Numeric state trigger with the Apollo TEMP-1 Max Probe Temp entity and Above value of 165 highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png) 5\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -91,11 +91,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1 reached its max temperature and your food is ready." and "Check the food!". -![](/assets/temp-1-food-probe-ex-automation-pic-5.png) +![Notification action with the food ready message and Check the food title highlighted](/assets/temp-1-food-probe-ex-automation-pic-5.png) 7\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-food-probe-ex-automation-pic-6.png) +![Save dialog for the Food over Max Temp Automation with Save highlighted](/assets/temp-1-food-probe-ex-automation-pic-6.png) --- @@ -126,122 +126,122 @@ This will guide you through adding a button to your dashboard called "Chicken Mo 1\. Create a new toggle helper called "Chicken Monitor". Please click here for step by step directions on creating a toggle helper. -![](/assets/temp-1-cook-chicken-example-pic-1.png) +![Create Toggle dialog for a Chicken Monitor helper with the Create button highlighted](/assets/temp-1-cook-chicken-example-pic-1.png) 2\. Edit your dashboard, add a button card, select Chicken Monitor, and then save. -![](/assets/temp-1-cook-chicken-example-pic-3.png)![](/assets/temp-1-cook-chicken-example-pic-2.png) +![Add to dashboard dialog searching button, showing the Button card](/assets/temp-1-cook-chicken-example-pic-3.png)![Button card configuration with Chicken Monitor selected as the entity and Save highlighted](/assets/temp-1-cook-chicken-example-pic-2.png) 3\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left then "create new automation". Click here to go straight there! 4\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "On". Advanced users skip to step 25 for the YAML. -![](/assets/temp-1-cook-chicken-example-pic-4.png) +![State trigger for when Chicken Monitor changes to On](/assets/temp-1-cook-chicken-example-pic-4.png) 5\. Create a Trigger ID for this called "Chicken Monitor On". -![](/assets/temp-1-cook-chicken-example-pic-5.png)![](/assets/temp-1-cook-chicken-example-pic-6-1.png) +![Trigger options menu open with Edit ID being selected](/assets/temp-1-cook-chicken-example-pic-5.png)![State trigger with the Trigger ID set to Chicken Monitor On](/assets/temp-1-cook-chicken-example-pic-6-1.png) 6\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "Off". Create a Trigger ID for this called "Chicken Monitor Off". -![](/assets/temp-1-cook-chicken-example-pic-21.png) +![State trigger with Trigger ID Chicken Monitor Off and To set to Off, both highlighted](/assets/temp-1-cook-chicken-example-pic-21.png) 7\. Click Add Trigger then Entity then Numeric state and search for your temp-1 food probe entity such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 160°F(71.1C) because the Chicken will rest and reach 165°F once removed from the oven/grill. -![](/assets/temp-1-cook-chicken-example-pic-7.png) +![Numeric state trigger for when Apollo TEMP-1 Food Probe is above 160](/assets/temp-1-cook-chicken-example-pic-7.png) 8\. Create a Trigger ID for this called "Temp Reached". -![](/assets/temp-1-cook-chicken-example-pic-8.png) +![Food Probe numeric state trigger with the Trigger ID Temp Reached highlighted](/assets/temp-1-cook-chicken-example-pic-8.png) 9\. Click Add Action and search "choose" then select it. -![](/assets/temp-1-cook-chicken-example-pic-12.png) +![Add action dialog searching choose, with the Choose action listed](/assets/temp-1-cook-chicken-example-pic-12.png) 10\. Under option 1 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Add condition dialog searching trigger id, with the Triggered by condition listed](/assets/temp-1-cook-chicken-example-pic-13.png) 11\. Check off the option "Button Pressed" that we created in step 5 above. -![](/assets/temp-1-cook-chicken-example-pic-14.png) +![Option 1 Triggered by condition with the Button Pressed trigger checked and highlighted](/assets/temp-1-cook-chicken-example-pic-14.png) 12\. While still under Option 1 in the choose action: Click Add Action and search "light" then select Light: Turn on. -![](/assets/temp-1-cook-chicken-example-pic-9.png) +![Add action dialog searching light, with Light: Turn on highlighted](/assets/temp-1-cook-chicken-example-pic-9.png) 13\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-10.png) +![Home Assistant entity picker listing Apollo TEMP-1 and TEMP-1B RGB Light entities](/assets/temp-1-cook-chicken-example-pic-10.png) 14\. Click "Advanced Options" and then click the check box for Color name then select a color from the dropdown such as Green. -![](/assets/temp-1-cook-chicken-example-pic-11.png) +![Light action Advanced options with Color name checked and Green selected in the dropdown](/assets/temp-1-cook-chicken-example-pic-11.png) 15\. While still under Option 1 in the choose action: Click Add Action and search "mobile" and then select your phone in the list. -![](/assets/temp-1-cook-chicken-example-pic-15.png) +![Add action dialog searching mobile, with the iPhone notification action highlighted](/assets/temp-1-cook-chicken-example-pic-15.png) 16\. Write in a custom title and or message- the message is required but the title is not. -![](/assets/temp-1-cook-chicken-example-pic-16.png) +![Notification action with the Chicken Monitoring Started title and message filled in](/assets/temp-1-cook-chicken-example-pic-16.png) 17\. This is how option 1 will look when you are done with this part: -![](/assets/temp-1-cook-chicken-example-pic-17-1.png) +![Completed Option 1 triggered by Chicken Monitor On, with light on and notification actions](/assets/temp-1-cook-chicken-example-pic-17-1.png) 18\. Click "Add Option" at the bottom then under option 2 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Add condition dialog searching trigger id, with the Triggered by condition listed](/assets/temp-1-cook-chicken-example-pic-13.png) 19\. Check off the option "Temp Reached" that we created in step 7 above. -![](/assets/temp-1-cook-chicken-example-pic-18-1.png) +![Triggered by condition with only the Temp Reached trigger checked](/assets/temp-1-cook-chicken-example-pic-18-1.png) 20\. While still under Option 2 in the choose action: Click Add Action and search "repeat" then select "Until" in the dropdown. -![](/assets/temp-1-cook-chicken-example-pic-22.png) +![Add action dialog searching repeat, with the Repeat action listed](/assets/temp-1-cook-chicken-example-pic-22.png) 21\. Under Until Conditions, select "Add condition" then search "state". -![](/assets/temp-1-cook-chicken-example-pic-25.png) +![Add condition dialog searching state, with the State condition listed](/assets/temp-1-cook-chicken-example-pic-25.png) 22\. Type in Chicken Monitor and select it, then click "Off" in the dropdown for the state of the sensor. -![](/assets/temp-1-cook-chicken-example-pic-26.png) +![Repeat until condition with Chicken Monitor as the entity and Off as the state, both highlighted](/assets/temp-1-cook-chicken-example-pic-26.png) 23\. Click "Add Action" under the "until" condition we created above. Be very careful to select the correct "Add Action" button as shown below. -![](/assets/temp-1-cook-chicken-example-pic-27.png) +![Repeat until block with the correct Add Action button highlighted under its Actions](/assets/temp-1-cook-chicken-example-pic-27.png) 24\. Search "light toggle" in the search bar shown then select "Choose entity" and select your the rgb led for your device -![](/assets/temp-1-cook-chicken-example-pic-28.png) +![Add action dialog searching light toggle, with Light: Toggle listed](/assets/temp-1-cook-chicken-example-pic-28.png) 25\. Head down to Add Action under Option 2 and search "mobile" then select your phone as you did above in step 15. Give it a message and a title as shown below. -![](/assets/temp-1-cook-chicken-example-pic-29.png) +![Notification action under Option 2 titled Time to check the Chicken, with a 160F message](/assets/temp-1-cook-chicken-example-pic-29.png) 26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already setup. -![](/assets/temp-1-cook-chicken-example-pic-30.png)![](/assets/temp-1-cook-chicken-example-pic-31.png) +![Add action dialog searching tts, with Text-to-speech (TTS): Speak listed first](/assets/temp-1-cook-chicken-example-pic-30.png)![TTS Speak action on piper targeting Homepods with the message The Chicken is almost ready](/assets/temp-1-cook-chicken-example-pic-31.png) 27\. Click "Add Option" (this is now Option 3). We will choose add condition then search "triggered by" and then choose the "Chicken Monitor Off" Trigger ID that we created in step 6. 28\. While still under Option 3 in the choose action: Click Add Action and search "light" then select Light: Turn off. -![](/assets/temp-1-cook-chicken-example-pic-19.png) +![Add action dialog searching light.turn, with Light: Turn off being selected](/assets/temp-1-cook-chicken-example-pic-19.png) 29\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-20.png) +![Light Turn off action targeting the Apollo TEMP-1 RGB Light](/assets/temp-1-cook-chicken-example-pic-20.png) 30\. Choose "Add Action" and search mobile like we did above and select your mobile phone. Give it an optional title and message as shown below. -![](/assets/temp-1-cook-chicken-example-pic-33.png) +![Notification action titled Chicken Monitoring Stopped with a no longer monitored message](/assets/temp-1-cook-chicken-example-pic-33.png) 31\. Click save in the bottom right then give it a name and save -![](/assets/temp-1-cook-chicken-example-pic-34.png) +![Save dialog for the TEMP-1 Chicken Automation with Save being clicked](/assets/temp-1-cook-chicken-example-pic-34.png) 32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to discord user RalphP for this example! \ No newline at end of file diff --git a/docs/homey/products/temp1/setup/prevent-sleep.md b/docs/homey/products/temp1/setup/prevent-sleep.md index d23f61f4ee..05151144b8 100755 --- a/docs/homey/products/temp1/setup/prevent-sleep.md +++ b/docs/homey/products/temp1/setup/prevent-sleep.md @@ -13,11 +13,11 @@ description: "Guide for setting up and using the prevent sleep toggle with the T 2\. Click on the name "1 device" below your Apollo device's name. -![](/assets/prevent-sleep-pic-3.png) +![Home Assistant ESPHome integration entry for an Apollo TEMP-1B with the 1 device link highlighted](/assets/prevent-sleep-pic-3.png) 3\. Scroll down until you see "Prevent Sleep" and "Sleep Duration". -![](/assets/prevent-sleep-pic-2.png) +![Home Assistant device page with the Prevent Sleep toggle and Sleep Duration box highlighted](/assets/prevent-sleep-pic-2.png) 4\. Type in the amount of minutes you want your sensor to sleep in the "Sleep Duration" box. Defaults to 8 minutes. diff --git a/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md b/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md index d14f1611e4..bf8da66557 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md @@ -11,13 +11,13 @@ description: "Step by step guide for putting The TEMP-1 In Boot Mode." 1\. Position the TEMP-1 so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. -![](/assets/temp-1-boot-button-side-view.jpg) +![Side of the TEMP-1 case with a pointed tool inserted into the opening to press the boot button](/assets/temp-1-boot-button-side-view.jpg) If you prefer, please remove the lid by gently prying up on the small slit by the top of the case. -![](/assets/temp-1-pry-open.jpg) +![Flat tool prying the lid off the TEMP-1 case at the slit along the top edge](/assets/temp-1-pry-open.jpg) -![](/assets/temp-1b-boot-button-lid-off.jpg) +![TEMP-1 board inside the open case with a tool pointing at the BOOT button on the right edge](/assets/temp-1b-boot-button-lid-off.jpg) 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 TEMP-1 then let go of the button. diff --git a/docs/homey/products/temp1/troubleshooting/temp1-code.md b/docs/homey/products/temp1/troubleshooting/temp1-code.md index 9826e9fe65..cc1847194c 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-code.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-code.md @@ -15,23 +15,23 @@ If your device has already been connected to Home Assistant please in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. my minimums are around -20F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the temperature probe in a freezer, with arrows at a high and a low point](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2C and a min probe temp of -30C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![Max Probe Temp set to 2.0 and Min Probe Temp set to -30.0 degrees Celsius in Home Assistant](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1B will play an audible alert with it's buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off -![](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file +![Alarm Outside Temp Range toggle being turned on in the Home Assistant Controls card](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file diff --git a/docs/homey/products/temp1b/examples/temp1b-automation-examples.md b/docs/homey/products/temp1b/examples/temp1b-automation-examples.md index e19c580163..805ec8ef00 100755 --- a/docs/homey/products/temp1b/examples/temp1b-automation-examples.md +++ b/docs/homey/products/temp1b/examples/temp1b-automation-examples.md @@ -11,11 +11,11 @@ This will guide you through how to setup an automation in Home Assistant using t 2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. my minimums are around -20°F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the temperature probe in a freezer, with arrows at a high and a low point](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2°C and a min probe temp of -30°C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![Max Probe Temp set to 2.0 and Min Probe Temp set to -30.0 degrees Celsius in Home Assistant](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. The automation is now ready to be created - @@ -23,11 +23,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1B device such as "temp-1b max probe temp" then in the box labeled "Above" type in the max probe temp number you found in step 2 above. Advanced users skip to step 10. -![](/assets/temp-1-temp-probe-ex-automation-pic-3.png) +![Home Assistant numeric state trigger for Apollo TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png) 7\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -35,11 +35,11 @@ This will guide you through how to setup an automation in Home Assistant using t 8\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1B reached its max temperature and your freezer might be having issues." and "Check the freezer!". -![](/assets/temp-1-temp-probe-ex-automation-pic-5.png) +![Home Assistant notification action with the message and the Check the freezer title fields highlighted](/assets/temp-1-temp-probe-ex-automation-pic-5.png) 9\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-temp-probe-ex-automation-pic-6.png) +![Home Assistant Save dialog with name, description, and category filled in and the Save button highlighted](/assets/temp-1-temp-probe-ex-automation-pic-6.png) --- @@ -71,7 +71,7 @@ This will guide you through how to setup an automation in Home Assistant using t 1\. Set your Max Probe Temp to 73.9°C. The offsets MUST be in Celsius even if you are using F in the automation below. -![](/assets/temp-1-food-probe-ex-automation-pic-1.png) +![Home Assistant Max Probe Temp field set to 73.9 degrees Celsius, highlighted](/assets/temp-1-food-probe-ex-automation-pic-1.png) 2\. Place the food probe inside your food once it's on the grill. Make sure your TEMP-1 is in a cool dry place - only the food probe and the wire can withstand temperatures on a grill, in the oven, etc. @@ -79,11 +79,11 @@ This will guide you through how to setup an automation in Home Assistant using t 4\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1b device such as "temp-1b max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. -![](/assets/temp-1-food-probe-ex-automation-pic-3.png) +![Home Assistant numeric state trigger for Apollo TEMP-1 Max Probe Temp with Above set to 165](/assets/temp-1-food-probe-ex-automation-pic-3.png) 5\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -91,11 +91,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1B reached its max temperature and your food is ready." and "Check the food!". -![](/assets/temp-1-food-probe-ex-automation-pic-5.png) +![Home Assistant notification action with the message and the Check the food title fields highlighted](/assets/temp-1-food-probe-ex-automation-pic-5.png) 7\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-food-probe-ex-automation-pic-6.png) +![Home Assistant Save dialog for the Food over Max Temp Automation with the Save button highlighted](/assets/temp-1-food-probe-ex-automation-pic-6.png) --- @@ -126,122 +126,122 @@ This will guide you through adding a button to your dashboard called "Chicken Mo 1\. Create a new toggle helper called "Chicken Monitor". Please click here for step by step directions on creating a toggle helper. -![](/assets/temp-1-cook-chicken-example-pic-1.png) +![Home Assistant Create Toggle dialog named Chicken Monitor with a drumstick icon and the Create button highlighted](/assets/temp-1-cook-chicken-example-pic-1.png) 2\. Edit your dashboard, add a button card, select Chicken Monitor, and then save. -![](/assets/temp-1-cook-chicken-example-pic-3.png)![](/assets/temp-1-cook-chicken-example-pic-2.png) +![Home Assistant Add to dashboard dialog searching button, showing the Button card](/assets/temp-1-cook-chicken-example-pic-3.png)![Home Assistant Button card configuration with the Chicken Monitor entity and the Save button highlighted](/assets/temp-1-cook-chicken-example-pic-2.png) 3\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left then "create new automation". Click here to go straight there! 4\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "On". Advanced users skip to step 25 for the YAML. -![](/assets/temp-1-cook-chicken-example-pic-4.png) +![Home Assistant state trigger that fires when Chicken Monitor changes to On](/assets/temp-1-cook-chicken-example-pic-4.png) 5\. Create a Trigger ID for this called "Chicken Monitor On". -![](/assets/temp-1-cook-chicken-example-pic-5.png)![](/assets/temp-1-cook-chicken-example-pic-6-1.png) +![Trigger options menu in the Home Assistant automation editor with Edit ID selected](/assets/temp-1-cook-chicken-example-pic-5.png)![Home Assistant state trigger with the Trigger ID set to Chicken Monitor On](/assets/temp-1-cook-chicken-example-pic-6-1.png) 6\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "Off". Create a Trigger ID for this called "Chicken Monitor Off". -![](/assets/temp-1-cook-chicken-example-pic-21.png) +![Home Assistant state trigger for Chicken Monitor changing to Off with the Trigger ID Chicken Monitor Off](/assets/temp-1-cook-chicken-example-pic-21.png) 7\. Click Add Trigger then Entity then Numeric state and search for your temp-1 food probe entity such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 160°F(71.1C) because the Chicken will rest and reach 165°F once removed from the oven/grill. -![](/assets/temp-1-cook-chicken-example-pic-7.png) +![Home Assistant numeric state trigger for Apollo TEMP-1 Food Probe with Above set to 160](/assets/temp-1-cook-chicken-example-pic-7.png) 8\. Create a Trigger ID for this called "Temp Reached". -![](/assets/temp-1-cook-chicken-example-pic-8.png) +![Home Assistant food probe trigger with the Trigger ID set to Temp Reached highlighted](/assets/temp-1-cook-chicken-example-pic-8.png) 9\. Click Add Action and search "choose" then select it. -![](/assets/temp-1-cook-chicken-example-pic-12.png) +![Home Assistant Add action dialog searching choose, with the Choose action shown](/assets/temp-1-cook-chicken-example-pic-12.png) 10\. Under option 1 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Home Assistant Add condition dialog searching trigger id, with Triggered by shown](/assets/temp-1-cook-chicken-example-pic-13.png) 11\. Check off the option "Button Pressed" that we created in step 5 above. -![](/assets/temp-1-cook-chicken-example-pic-14.png) +![Option 1 condition in the Home Assistant choose action with the Button Pressed trigger checked](/assets/temp-1-cook-chicken-example-pic-14.png) 12\. While still under Option 1 in the choose action: Click Add Action and search "light" then select Light: Turn on. -![](/assets/temp-1-cook-chicken-example-pic-9.png) +![Home Assistant Add action dialog searching light, with Light: Turn on highlighted](/assets/temp-1-cook-chicken-example-pic-9.png) 13\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-10.png) +![Home Assistant entity picker listing Apollo TEMP-1 and TEMP-1B RGB Light entities](/assets/temp-1-cook-chicken-example-pic-10.png) 14\. Click "Advanced Options" and then click the check box for Color name then select a color from the dropdown such as Green. -![](/assets/temp-1-cook-chicken-example-pic-11.png) +![Home Assistant Advanced options with Color name checked and Green chosen in the color dropdown](/assets/temp-1-cook-chicken-example-pic-11.png) 15\. While still under Option 1 in the choose action: Click Add Action and search "mobile" and then select your phone in the list. -![](/assets/temp-1-cook-chicken-example-pic-15.png) +![Home Assistant Add action dialog searching mobile, with the iPhone notification action highlighted](/assets/temp-1-cook-chicken-example-pic-15.png) 16\. Write in a custom title and or message- the message is required but the title is not. -![](/assets/temp-1-cook-chicken-example-pic-16.png) +![Home Assistant notification action with the Chicken Monitoring Started title and message filled in](/assets/temp-1-cook-chicken-example-pic-16.png) 17\. This is how option 1 will look when you are done with this part: -![](/assets/temp-1-cook-chicken-example-pic-17-1.png) +![Finished Option 1 in the Home Assistant choose action with the RGB light turn on and notification actions](/assets/temp-1-cook-chicken-example-pic-17-1.png) 18\. Click "Add Option" at the bottom then under option 2 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Home Assistant Add condition dialog searching trigger id, with Triggered by shown](/assets/temp-1-cook-chicken-example-pic-13.png) 19\. Check off the option "Temp Reached" that we created in step 7 above. -![](/assets/temp-1-cook-chicken-example-pic-18-1.png) +![Option 2 condition in Home Assistant with the Temp Reached trigger checked](/assets/temp-1-cook-chicken-example-pic-18-1.png) 20\. While still under Option 2 in the choose action: Click Add Action and search "repeat" then select "Until" in the dropdown. -![](/assets/temp-1-cook-chicken-example-pic-22.png) +![Home Assistant Add action dialog searching repeat, with the Repeat action shown](/assets/temp-1-cook-chicken-example-pic-22.png) 21\. Under Until Conditions, select "Add condition" then search "state". -![](/assets/temp-1-cook-chicken-example-pic-25.png) +![Home Assistant Add condition dialog searching state, with the State condition shown](/assets/temp-1-cook-chicken-example-pic-25.png) 22\. Type in Chicken Monitor and select it, then click "Off" in the dropdown for the state of the sensor. -![](/assets/temp-1-cook-chicken-example-pic-26.png) +![Home Assistant repeat until condition with the Chicken Monitor entity and Off state highlighted](/assets/temp-1-cook-chicken-example-pic-26.png) 23\. Click "Add Action" under the "until" condition we created above. Be very careful to select the correct "Add Action" button as shown below. -![](/assets/temp-1-cook-chicken-example-pic-27.png) +![Add Action button inside the repeat until block in Home Assistant, highlighted](/assets/temp-1-cook-chicken-example-pic-27.png) 24\. Search "light toggle" in the search bar shown then select "Choose entity" and select your the rgb led for your device -![](/assets/temp-1-cook-chicken-example-pic-28.png) +![Home Assistant Add action dialog searching light toggle, with Light: Toggle shown](/assets/temp-1-cook-chicken-example-pic-28.png) 25\. Head down to Add Action under Option 2 and search "mobile" then select your phone as you did above in step 15. Give it a message and a title as shown below. -![](/assets/temp-1-cook-chicken-example-pic-29.png) +![Home Assistant notification action titled Time to check the Chicken, below the repeat action](/assets/temp-1-cook-chicken-example-pic-29.png) 26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already setup. -![](/assets/temp-1-cook-chicken-example-pic-30.png)![](/assets/temp-1-cook-chicken-example-pic-31.png) +![Home Assistant Add action dialog searching tts, with the Text-to-speech (TTS): Speak action selected](/assets/temp-1-cook-chicken-example-pic-30.png)![Home Assistant TTS Speak action on piper targeting Homepods with the message The Chicken is almost ready](/assets/temp-1-cook-chicken-example-pic-31.png) 27\. Click "Add Option" (this is now Option 3). We will choose add condition then search "triggered by" and then choose the "Chicken Monitor Off" Trigger ID that we created in step 6. 28\. While still under Option 3 in the choose action: Click Add Action and search "light" then select Light: Turn off. -![](/assets/temp-1-cook-chicken-example-pic-19.png) +![Home Assistant Add action dialog searching light.turn, with Light: Turn off selected](/assets/temp-1-cook-chicken-example-pic-19.png) 29\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-20.png) +![Home Assistant Light Turn off action targeting the Apollo TEMP-1 RGB Light](/assets/temp-1-cook-chicken-example-pic-20.png) 30\. Choose "Add Action" and search mobile like we did above and select your mobile phone. Give it an optional title and message as shown below. -![](/assets/temp-1-cook-chicken-example-pic-33.png) +![Home Assistant notification action titled Chicken Monitoring Stopped with its message filled in](/assets/temp-1-cook-chicken-example-pic-33.png) 31\. Click save in the bottom right then give it a name and save -![](/assets/temp-1-cook-chicken-example-pic-34.png) +![Home Assistant Save dialog for the TEMP-1 Chicken Automation with the Save button](/assets/temp-1-cook-chicken-example-pic-34.png) 32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to discord user RalphP for this example! \ No newline at end of file diff --git a/docs/homey/products/temp1b/setup/insert-battery.md b/docs/homey/products/temp1b/setup/insert-battery.md index 8f7bcdf3e8..522fb603d5 100755 --- a/docs/homey/products/temp1b/setup/insert-battery.md +++ b/docs/homey/products/temp1b/setup/insert-battery.md @@ -9,44 +9,44 @@ description: "How to Insert Battery on TEMP-1B." 1\. Gently pry open the case lid as shown in the image below. -![](/assets/temp-1b-pry-open.jpg) +![Flat tool prying the lid off the TEMP-1B case at the side slit](/assets/temp-1b-pry-open.jpg) -![](/assets/temp-1b-lid-off.jpg) +![TEMP-1B case with the lid removed, showing the circuit board inside](/assets/temp-1b-lid-off.jpg) 2\. Once the lid is removed either lift the PCB out or gently dump the pcb out by turning it upside down. -![](/assets/temp-1b-lift-pcb-out-1.jpg) +![Fingers lifting the TEMP-1B circuit board out of the case](/assets/temp-1b-lift-pcb-out-1.jpg) -![](/assets/temp-1b-remove-case.jpg) +![TEMP-1B case lifted off the board, exposing the empty battery holder underneath](/assets/temp-1b-remove-case.jpg) 3\. Align the battery as shown in the image below. -![](/assets/temp-1b-battery-insert-pic-1.jpg) +![Battery held next to the empty TEMP-1B battery holder with the minus and plus markings highlighted](/assets/temp-1b-battery-insert-pic-1.jpg) 4\. Insert the battery with the positive terminal facing the + sign. -![](/assets/temp-1b-battery-insert-pic-3.jpg) +![Battery seated in the TEMP-1B battery holder on the back of the board](/assets/temp-1b-battery-insert-pic-3.jpg) -![](/assets/temp-1b-battery-insert-pic-4.jpg) +![16340 battery installed in the TEMP-1B holder with its positive end at the + mark on the board](/assets/temp-1b-battery-insert-pic-4.jpg) 5\. Begin reassembly by placing the battery side down with the RGB led in the top right corner. -![](/assets/temp-1b-battery-insert-empty-case.jpg) +![Empty TEMP-1B case ready for the board to go back in](/assets/temp-1b-battery-insert-empty-case.jpg) -![](/assets/temp-1b-battery-insert-pcb-ledge.jpg) +![Thumb setting the TEMP-1B board into the case battery side down, with the RGB LED in the top right corner](/assets/temp-1b-battery-insert-pcb-ledge.jpg) 6\. You will use the "ledge" of the case to set the PCB down and then it will lay down and rest on the ledge of the other side as well. -![](/assets/temp-1b-battery-insert-pcb-hinge.jpg) +![TEMP-1B board tilted into the case, resting on the ledge with the battery underneath](/assets/temp-1b-battery-insert-pcb-hinge.jpg) -![](/assets/temp-1b-battery-insert-pcb-flat.jpg) +![TEMP-1B board lying flat in the case with the RGB LED in the top right corner](/assets/temp-1b-battery-insert-pcb-flat.jpg) 7\. Align the RGB led in the top right with the small hole in the lid. -![](/assets/temp-1b-battery-insert-align-rgb.jpg) +![TEMP-1B lid sliding into place, with a tool pointing at the lid hole that lines up with the RGB LED](/assets/temp-1b-battery-insert-align-rgb.jpg) 8\. Gently press down until it the lid seats. -![](/assets/temp-1b-battery-insert-press-case.jpg) +![Thumb pressing the lid down onto the TEMP-1B case until it seats](/assets/temp-1b-battery-insert-press-case.jpg) 9 You have now installed or reinstalled the battery! \ No newline at end of file diff --git a/docs/homey/products/temp1b/setup/prevent-sleep.md b/docs/homey/products/temp1b/setup/prevent-sleep.md index 1017b03847..f922c59acd 100755 --- a/docs/homey/products/temp1b/setup/prevent-sleep.md +++ b/docs/homey/products/temp1b/setup/prevent-sleep.md @@ -13,11 +13,11 @@ description: "Keep the TEMP-1B awake instead of letting it sleep, and what that 2\. Click on the name "1 device" below your Apollo device's name. -![](/assets/temp-1b-prevent-sleep-pic-1.png) +![Home Assistant ESPHome integration entry for an Apollo TEMP-1B with the 1 device link highlighted](/assets/temp-1b-prevent-sleep-pic-1.png) 3\. Scroll down until you see "Prevent Sleep" and "Sleep Duration". -![](/assets/temp-1b-prevent-sleep-pic-2.png) +![Home Assistant device page with the Prevent Sleep toggle and the Sleep Duration box set to 12 hours highlighted](/assets/temp-1b-prevent-sleep-pic-2.png) 4\. Type in the amount of hours you want your sensor to sleep in the "Sleep Duration" box. Defaults to 12 hours. diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md b/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md index 757cf84c28..a4992032ad 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md @@ -11,13 +11,13 @@ description: "Step by step guide for putting The TEMP-1B In Boot Mode." 1\. Position the TEMP-1B so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. -![](/assets/temp-1b-boot-button-side-view.jpg) +![Side of the TEMP-1B case with a pointed tool at the opening used to press the boot button](/assets/temp-1b-boot-button-side-view.jpg) If you prefer, please remove the lid by gently prying up on the small slit by the top of the case. -![](/assets/temp-1b-pry-open.jpg) +![Flat tool prying the lid off the TEMP-1B case at the side slit](/assets/temp-1b-pry-open.jpg) -![](/assets/temp-1b-boot-button-lid-off.jpg) +![TEMP-1B board inside the open case with a tool pointing at the BOOT button on the right edge](/assets/temp-1b-boot-button-lid-off.jpg) 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 TEMP-1B then let go of the button. diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-code.md b/docs/homey/products/temp1b/troubleshooting/temp1b-code.md index 97b9be9ac8..c6f19b98bc 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-code.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-code.md @@ -19,19 +19,19 @@ If your device has already been connected to Home Assistant please Next - Light Effects +ESPHome logo Next - Light Effects --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md b/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md index 04b1de041f..f6d1d724fa 100644 --- a/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md +++ b/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md @@ -28,7 +28,7 @@ ESPHome Device Builder has a GUI for building @@ -132,7 +132,7 @@ Your automation is saved in Device Builder, but the device is still running its 3. Wait for the compile and flash to finish. The device reboots once the install is done. -![](../../../assets/esphome-device-builder-install-firmware-motion-sensor.gif) +![Saving the motion automations, clicking Install, choosing On the network, and the compile log starting](../../../assets/esphome-device-builder-install-firmware-motion-sensor.gif) ## Test the automations @@ -142,6 +142,6 @@ Your automation is saved in Device Builder, but the device is still running its With the device back online, wave your hand in front of the PIR sensor. The RGB light turns on as soon as motion is detected, then turns off shortly after the sensor stops seeing movement. If the light triggers right after boot with nothing moving, give the sensor a moment. PIR sensors need a brief warm-up after powering on, usually 5 to 10 seconds, before their readings stabilize. - Next - Temp-Reactive LEDs +ESPHome logo Next - Temp-Reactive LEDs --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/automations/play-a-tune.md b/docs/products/ESPHome-Starter-Kit/automations/play-a-tune.md index 773276d2fb..47d412b3a2 100644 --- a/docs/products/ESPHome-Starter-Kit/automations/play-a-tune.md +++ b/docs/products/ESPHome-Starter-Kit/automations/play-a-tune.md @@ -35,7 +35,7 @@ ESPHome Device Builder has a GUI for building Next - Connect to Home Assistant +ESPHome logo Next - Connect to Home Assistant --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/automations/temp-reactive-leds.md b/docs/products/ESPHome-Starter-Kit/automations/temp-reactive-leds.md index 0da99f9d4b..72fe120b62 100644 --- a/docs/products/ESPHome-Starter-Kit/automations/temp-reactive-leds.md +++ b/docs/products/ESPHome-Starter-Kit/automations/temp-reactive-leds.md @@ -51,7 +51,7 @@ ESPHome Device Builder has a GUI for building Next - Connect to Home Assistant +ESPHome logo Next - Connect to Home Assistant --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/community-corner.md b/docs/products/ESPHome-Starter-Kit/community-corner.md index 7603544d54..aac7907c37 100644 --- a/docs/products/ESPHome-Starter-Kit/community-corner.md +++ b/docs/products/ESPHome-Starter-Kit/community-corner.md @@ -21,6 +21,6 @@ A printable housing for the LED & Buzzer module. Print one and give your notific [Download the .STEP file :material-download:](../../assets/apollo_starterkit_housing_var2.step){ .md-button .md-button--primary } -![](../../assets/rgb-module-case-front.jpeg) +![3D-printed orange and white case for the LED & Buzzer module with glowing teal LEDs and a USB-C cable plugged in](../../assets/rgb-module-case-front.jpeg) -![](../../assets/rgb-module-case-rear.jpeg) +![Back of the white 3D-printed LED & Buzzer module case with a ribbon cable running out to another module](../../assets/rgb-module-case-rear.jpeg) diff --git a/docs/products/ESPHome-Starter-Kit/everyday-use/button-toggles-room-light.md b/docs/products/ESPHome-Starter-Kit/everyday-use/button-toggles-room-light.md index e6d074549d..3ae44c3101 100644 --- a/docs/products/ESPHome-Starter-Kit/everyday-use/button-toggles-room-light.md +++ b/docs/products/ESPHome-Starter-Kit/everyday-use/button-toggles-room-light.md @@ -33,7 +33,7 @@ This is an alternative way to use the Starter Kit's button. Instead of toggling 1. The button registers as a binary sensor. `On` maps to a pressed state - the moment you push the button down. Home Assistant fires the automation at that instant. - ![](../../../assets/button-toggles-room-light-hass-automation-example.gif) + ![Home Assistant automation editor adding a State trigger for Button Module with To set to On](../../../assets/button-toggles-room-light-hass-automation-example.gif) 4. Under **Then do**, click **+ Add action**, type `toggle light`, and select **Light: Toggle**. @@ -47,12 +47,12 @@ This is an alternative way to use the Starter Kit's button. Instead of toggling 1. If you'd rather it always turn on or always turn off, use **Light: Turn on** or **Light: Turn off** instead. 2. You can also set a **Color**, **Color temperature**, or **Brightness** here for when the light turns on. Toggling it off ignores them. - ![](../../../assets/button-toggles-room-light-action-example.gif) + ![Adding a Toggle light action in Home Assistant and choosing Brandons Room as the target light](../../../assets/button-toggles-room-light-action-example.gif) 5. Click **Save**. 6. Give the automation a name like `Button toggles room light`, then click **Save** again. - ![](../../../assets/button-toggles-room-light-name-and-save.gif) + ![Home Assistant Save dialog naming the automation Button toggles room light, then clicking Save](../../../assets/button-toggles-room-light-name-and-save.gif) ??? note "What the automation looks like in YAML" @@ -85,6 +85,6 @@ Press the button on the Button module. The light you targeted toggles. Press aga Any light in your home - a bedside lamp, a ceiling group, a smart bulb strip - is one button press away. Swap `light.toggle` for `light.turn_on` with a `brightness_pct` to land on a specific brightness, or target a light group to control a whole room at once. - Next - Trash Night Reminder +ESPHome logo Next - Trash Night Reminder --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/everyday-use/motion-activated-room-lights.md b/docs/products/ESPHome-Starter-Kit/everyday-use/motion-activated-room-lights.md index 123edf6544..c7adf98abe 100644 --- a/docs/products/ESPHome-Starter-Kit/everyday-use/motion-activated-room-lights.md +++ b/docs/products/ESPHome-Starter-Kit/everyday-use/motion-activated-room-lights.md @@ -42,7 +42,7 @@ A blueprint is a fill-in-the-blanks automation. Home Assistant ships one called 1. Open [Settings → Automations & scenes → Blueprints](https://my.home-assistant.io/redirect/blueprints/) and look for **Motion-activated Light**. If it's there, skip to step 3. (1) - ![](../../../assets/motion-activated-lights-select-blueprint.gif) + ![Home Assistant Blueprints list with Motion-activated Light selected, showing its Motion Sensor, Light, and Wait time fields](../../../assets/motion-activated-lights-select-blueprint.gif) 2. If it's missing, click **Import Blueprint** in the bottom right, paste the URL below, then click **Preview** and **Import Blueprint**. @@ -55,7 +55,7 @@ A blueprint is a fill-in-the-blanks automation. Home Assistant ships one called * **Light Target** → the light you want to control. * **Wait time** → seconds to leave the light on after the last movement. 120 is a sensible start. (2) - ![](../../../assets/motion-activated-lights-configure-blueprint.gif) + ![Motion-activated Light blueprint with Motion Module as the sensor, Brandons Room as the light, and a 120 second wait](../../../assets/motion-activated-lights-configure-blueprint.gif) @@ -79,24 +79,24 @@ You could make two automations, one to turn the light on and one to turn it off. 1. Open [Settings → Automations & scenes](https://my.home-assistant.io/redirect/automations/), click **Create Automation**, then **Create new automation**. 2. Click **Add Trigger**, search **motion**, and click **Motion detected**. Set its target to your **Motion Module** sensor. Open the trigger's menu (the three dots), choose **Rename**, and set the **Trigger ID** to `Detected`. (1) - ![](../../../assets/motion-activated-lights-detected.gif) + ![Adding a Motion detected trigger in Home Assistant, setting its Trigger ID to Detected, and targeting Motion Module](../../../assets/motion-activated-lights-detected.gif) 3. Add another trigger the same way, this time **Motion cleared** on the same **Motion Module**, with **For** → 2 minutes. Set its **Trigger ID** to `Clear`. (2) - ![](../../../assets/motion-activated-lights-clear.gif) + ![Adding a Motion cleared trigger with Trigger ID Clear, a Motion Module target, and a 2 minute duration](../../../assets/motion-activated-lights-clear.gif) 4. Under **Then do**, add **Building Blocks → Choose**. 5. In **Option 1**, add a **Triggered by** condition set to `Detected`, then an action of **Light → Turn on** targeting your room light. - ![](../../../assets/motion-activated-lights-choose-option-1.gif) + ![Adding a Choose block whose Option 1 runs Turn on light for Brandons Room when triggered by Detected](../../../assets/motion-activated-lights-choose-option-1.gif) 6. Add **Option 2** with a **Triggered by** condition of `Clear` and a **Light → Turn off** action on the same light. - ![](../../../assets/motion-activated-lights-choose-option-2.gif) + ![Adding Option 2 to the Choose block, which runs Turn off light for Brandons Room when triggered by Clear](../../../assets/motion-activated-lights-choose-option-2.gif) 7. Click the three dots in the top right, choose **Change mode**, select **Restart**, then click **Change mode** to confirm. (3) - ![](../../../assets/motion-activated-lights-change-mode.gif) + ![Home Assistant automation menu open to Change mode, with Restart selected and Change mode clicked](../../../assets/motion-activated-lights-change-mode.gif) @@ -158,7 +158,7 @@ You could make two automations, one to turn the light on and one to turn it off. Click **Save**, give the automation a name like `Motion Activated Lights`, and if you like, add a label such as `Lighting` to group it with your other light automations. Click **Save** to finish. -![](../../../assets/motion-activated-lights-name-and-label.gif) +![Save dialog naming the automation Motion Activated Lights and adding the Lighting label in Home Assistant](../../../assets/motion-activated-lights-name-and-label.gif) Now walk in. The light comes on, the room goes still, and after the quiet period it turns off. From here you can add a [condition](https://www.home-assistant.io/docs/scripts/conditions/) so it only runs after sunset, or point the `Detected` branch at a whole scene. diff --git a/docs/products/ESPHome-Starter-Kit/everyday-use/play-a-tune-from-home-assistant.md b/docs/products/ESPHome-Starter-Kit/everyday-use/play-a-tune-from-home-assistant.md index ae10ec48c8..b49eebe41c 100644 --- a/docs/products/ESPHome-Starter-Kit/everyday-use/play-a-tune-from-home-assistant.md +++ b/docs/products/ESPHome-Starter-Kit/everyday-use/play-a-tune-from-home-assistant.md @@ -48,11 +48,11 @@ Start with a single named song, or set up a bank of swappable song slots. Pick a 1. Open your starter kit device in ESPHome Device Builder and click **Edit**, then open the **Core configuration** tab and select **Native API**. - ![](../../../assets/esphome-device-builder-navigate-to-native-api-core-config.gif) + ![Opening the device in ESPHome Device Builder, expanding Core configuration, and selecting Native API](../../../assets/esphome-device-builder-navigate-to-native-api-core-config.gif) 2. Click **Add API Action** and enter `play_pink_panther` as the **Action name**. (1) - ![](../../../assets/esphome-device-builder-add-api-action-rtttl.gif) + ![Clicking Add API action on the Native API page and naming the new action play_pink_panther](../../../assets/esphome-device-builder-add-api-action-rtttl.gif) 3. Click **Add action**, choose **Rtttl → Play** from the top of the list, and paste the Pink Panther theme into the **Rtttl** field: @@ -60,7 +60,7 @@ Start with a single named song, or set up a bank of swappable song slots. Pick a PinkPanther:d=4,o=5,b=160:8d#,8e,2p,8f#,8g,2p,8d#,8e,16p,8f#,8g,16p,8c6,8b,16p,8d#,8e,16p,8b,2a#,2p,16a,16g,16e,16d,2e ``` - ![](../../../assets/esphome-device-builder-rtttl-play-enter-in-tune.gif) + ![Adding an Rtttl Play action to the play_pink_panther API action and pasting the Pink Panther tune](../../../assets/esphome-device-builder-rtttl-play-enter-in-tune.gif) @@ -90,7 +90,7 @@ Start with a single named song, or set up a bank of swappable song slots. Pick a 1. Open your starter kit device in ESPHome Device Builder and click **Edit**, then open the **Core configuration** tab and select **Native API**. - ![](../../../assets/esphome-device-builder-navigate-to-native-api-core-config.gif) + ![Opening the device in ESPHome Device Builder, expanding Core configuration, and selecting Native API](../../../assets/esphome-device-builder-navigate-to-native-api-core-config.gif) 2. Add a slot for each of the four tunes below. Each slot is its own API action, so **repeat these steps once per song**: @@ -107,7 +107,7 @@ Start with a single named song, or set up a bank of swappable song slots. Pick a The gif shows the first slot; the tunes for all four are below. - ![](../../../assets/esphome-device-builder-add-song-1.gif) + ![Creating the play_song_1 API action with an Rtttl Play action holding the Pink Panther tune](../../../assets/esphome-device-builder-add-song-1.gif) **`play_song_1`** — Pink Panther @@ -145,7 +145,7 @@ Start with a single named song, or set up a bank of swappable song slots. Pick a 1. Use **λ Lambda**, not **Value**. A plain **Value** treats `song_str` as literal text, a tune named "song_str" that won't play, while the lambda returns the variable's contents. Leave the quotes off `song_str` so it stays the variable and not a string. - ![](../../../assets/esphome-device-builder-add-play-buzzer-action.gif) + ![Creating the play_buzzer API action with a string variable song_str and a lambda that returns song_str](../../../assets/esphome-device-builder-add-play-buzzer-action.gif) ??? note "What the editor built in YAML" @@ -201,7 +201,7 @@ Start with a single named song, or set up a bank of swappable song slots. Pick a 1. Lets the field store what you type. Without it the install fails with *"Either optimistic mode must be enabled, or set_action must be set"*. 2. The play buttons reference these IDs by name, so they have to match exactly, or the install fails with *"Couldn't find ID 'song_1'"*. - ![](../../../assets/esphome-device-builder-template-text-song-1.gif) + ![Adding a Template Text component named Song 1 with Mode Text, Optimistic on, ID song_1, and Restore value on](../../../assets/esphome-device-builder-template-text-song-1.gif) Repeat for **Song 2**, **Song 3**, and **Song 4**, giving each the matching **ID** (`song_2`, `song_3`, `song_4`). To have a tune ready to play right away, paste an RTTTL string into each field's **Initial value**; otherwise leave it empty and paste one in from the dashboard before pressing Play. @@ -211,7 +211,7 @@ Start with a single named song, or set up a bank of swappable song slots. Pick a - Click **Add action** and choose **Rtttl → Play**. - Switch the **Rtttl** field to **λ Lambda** and enter `return id(song_1).state;`. - ![](../../../assets/esphome-device-builder-template-button-song-1.gif) + ![Adding a Template Button named Play Song 1 whose On Press action plays the Song 1 text with a lambda](../../../assets/esphome-device-builder-template-button-song-1.gif)
@@ -315,7 +315,7 @@ Your actions are saved in Device Builder, but the device is still running its ol 3. Wait for the compile and flash to finish. The device reboots once the install is done. -![](../../../assets/esphome-device-builder-rtttl-save-validate-install.gif) +![Clicking Save and Install in ESPHome Device Builder, choosing On the network, and watching the compile log](../../../assets/esphome-device-builder-rtttl-save-validate-install.gif) ## Call it from Home Assistant diff --git a/docs/products/ESPHome-Starter-Kit/everyday-use/temperature-on-your-dashboard.md b/docs/products/ESPHome-Starter-Kit/everyday-use/temperature-on-your-dashboard.md index 1566adfa81..ab78a20b28 100644 --- a/docs/products/ESPHome-Starter-Kit/everyday-use/temperature-on-your-dashboard.md +++ b/docs/products/ESPHome-Starter-Kit/everyday-use/temperature-on-your-dashboard.md @@ -27,7 +27,7 @@ A Tile card is the small, modern card you see across most Home Assistant dashboa 2. Search `starter kit` and check both the **Temperature** and **Humidity** sensors. (1) 3. Click **Tile** to lay them out as two tiles, then click **Save**. - ![](../../../assets/temp-on-dashboard-select-temp-hum-tile-cards.gif) + ![Adding the starter kit Temperature and Humidity sensors to a Home Assistant dashboard as tile cards](../../../assets/temp-on-dashboard-select-temp-hum-tile-cards.gif)
@@ -48,7 +48,7 @@ A Gauge card shines when a higher reading really does mean worse, and indoor hum 3. Set **Minimum** to `0` and **Maximum** to `100`, the full percentage range. 4. Toggle on **Display as needle gauge**, then turn on **Severity** and set green at `0`, yellow at `50`, and red at `60`. (1) - ![](../../../assets/temp-on-dashboard-humidity-gauge-card.gif) + ![Configuring a Home Assistant Gauge card for Kitchen Humidity with a needle and severity colors, then saving](../../../assets/temp-on-dashboard-humidity-gauge-card.gif) diff --git a/docs/products/ESPHome-Starter-Kit/everyday-use/trash-night-reminder.md b/docs/products/ESPHome-Starter-Kit/everyday-use/trash-night-reminder.md index dd199107b9..211333cf24 100644 --- a/docs/products/ESPHome-Starter-Kit/everyday-use/trash-night-reminder.md +++ b/docs/products/ESPHome-Starter-Kit/everyday-use/trash-night-reminder.md @@ -42,7 +42,7 @@ Home Assistant's **Local Calendar** integration stores events entirely inside Ho 2. Name it `Trash` and click **Submit**. Home Assistant creates a calendar entity called `calendar.trash`. - ![](../../../assets/create-trash-calendar.gif) + ![Setting up Local Calendar in Home Assistant, naming the calendar Trash, and clicking Submit and Finish](../../../assets/create-trash-calendar.gif) **Add the Recycle calendar** @@ -50,7 +50,7 @@ Home Assistant's **Local Calendar** integration stores events entirely inside Ho [![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=local_calendar) - ![](../../../assets/create-recycle-calendar.gif) + ![Setting up a second Local Calendar named Recycle and clicking Submit and Finish](../../../assets/create-recycle-calendar.gif) **Add recurring events** @@ -75,7 +75,7 @@ Add a repeating event to each calendar to match your actual pickup schedule. 6. Click **Save**. - ![](../../../assets/trash-pickup-recurring-event.gif) + ![Adding a Trash Pickup event on the Trash calendar from 7 to 9 PM that repeats weekly](../../../assets/trash-pickup-recurring-event.gif) ??? note "Do the same for the Recycle calendar" @@ -87,7 +87,7 @@ Add a repeating event to each calendar to match your actual pickup schedule. - Enable **Repeat** and set it to **Weekly** on that day. If recycle goes out more than once a week, scroll down and select the other day too. - Click **Save**. - ![](../../../assets/recycle-pickup-recurring-event.gif) + ![Adding a Recycle Pickup event on the Recycle calendar from 7 to 9 PM that repeats weekly](../../../assets/recycle-pickup-recurring-event.gif) ## Build the automation diff --git a/docs/products/ESPHome-Starter-Kit/faq.md b/docs/products/ESPHome-Starter-Kit/faq.md index f77d895ead..9eff86cb5e 100644 --- a/docs/products/ESPHome-Starter-Kit/faq.md +++ b/docs/products/ESPHome-Starter-Kit/faq.md @@ -4,7 +4,7 @@ description: Frequently asked questions about the ESPHome Starter Kit, ESPHome D --- # ESPHome Starter Kit FAQ -![](../../assets/esphome-starter-kit-exploded-with-box-1.png) +![ESPHome Starter Kit box with the ESP32-C6 board, LED & Buzzer, Motion, Button, and sensor modules, and ribbon cables](../../assets/esphome-starter-kit-exploded-with-box-1.png) 1\. **What is the ESPHome Starter Kit?** diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/core-components.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/core-components.md index f13018fcd4..b0448e3727 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/core-components.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/core-components.md @@ -39,7 +39,7 @@ If you remove the Web Server component, the device still works, but `esphome-sta 3. Click **Add** once more to confirm. 4. Toggle **Show advanced settings**, scroll to **Version**, and select **3**. - ESPHome Web Server docs +ESPHome logo ESPHome Web Server docs --- @@ -70,7 +70,7 @@ If you remove the rail, **the Onboard RGB LED and any plugged-in modules will st 2. Click **Add component**, scroll to **Accessory Power Rail**, and click **Add**. 3. Click **Add** once more to confirm. - ESPHome GPIO Switch docs +ESPHome logo ESPHome GPIO Switch docs --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md index 356bc37b44..2ce3b324a6 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md @@ -17,7 +17,7 @@ The **ESPHome Device Builder** is the app you used in [First Steps](../setup/fir ESPHome Device Builder has a tour built in that walks you through creating, configuring, and installing a device. It takes about five minutes. Start it from the menu in the top-right corner, or from **Start guided tour** on the last screen of first-time setup. -![](../../../assets/esphome-device-builder-guided-tour.gif) +![ESPHome Device Builder quickstart tour: creating a device, naming it, entering Wi-Fi, and exploring the editor](../../../assets/esphome-device-builder-guided-tour.gif) The rest of this page covers the same screens in more detail, so you can come back and read whichever one you need. @@ -25,7 +25,7 @@ The rest of this page covers the same screens in more detail, so you can come ba When you open **ESPHome Device Builder**, you see a list of your ESPHome devices. -![](../../../assets/esphome-device-builder-dashboard-card-overview.png) +![ESPHome Device Builder device card for esphome-starter-kit showing Online status and the blue Edit button](../../../assets/esphome-device-builder-dashboard-card-overview.png) * The blue **Edit** button on your device card opens the [configuration editor](#editor). You'll use this most. @@ -41,7 +41,7 @@ When you open **ESPHome Device Builder**, you see a list of your ESPHome devices Click **Edit** on your device card and the screen flips into the configuration editor. It has three panes: the **Device navigator** on the left, the **Form pane** in the middle, and the **YAML editor** on the right. -![](../../../assets/esphome-device-builder-navigate-to-editor.gif) +![Clicking Edit on the device card to open the editor with the Device navigator, form pane, and YAML editor](../../../assets/esphome-device-builder-navigate-to-editor.gif) #### Device navigator (left) @@ -51,13 +51,13 @@ The left pane is your config's table of contents. It groups everything into thre * **Components.** The things your device does: switches, sensors, lights. The default Starter Kit has the accessory power switch, the I²C bus, and the AHT10 temperature and humidity sensor. Use **\+ Add component** to add more. * **Automations.** Reactions that run on the device, like "when this button is pressed, turn that switch on". The Starter Kit ships with none by default. -![](../../../assets/esphome-device-builder-device-navigator.gif) +![Device navigator expanding Core configuration, Components, and Automations to show what each section holds](../../../assets/esphome-device-builder-device-navigator.gif) #### Form pane (middle) Click anything in the navigator to see its settings here as a form. Every field has inline help text, and a **Docs** link in the top right takes you to the official ESPHome reference for that component. -![](../../../assets/esphome-device-builder-form-panel.png) +![Form pane for the Web Server Component with a Docs link, Version set to 3, and Show advanced settings](../../../assets/esphome-device-builder-form-panel.png) #### YAML editor (right) @@ -65,7 +65,7 @@ The right pane is the raw YAML for your device, colour-coded with line numbers. The form pane and the YAML editor are always in sync. Edit either side and the other updates instantly. You can learn [YAML](what-is-yaml.md) by reading what the forms produce. -![](../../../assets/esphome-device-builder-yaml-editor.png) +![YAML editor showing the aht10 sensor block with humidity and temperature settings and line numbers](../../../assets/esphome-device-builder-yaml-editor.png) ## Publishing Changes @@ -75,13 +75,13 @@ When you have finished making changes: 2. Click **Validate** at the bottom right. ESPHome checks your config and reports any errors with the exact line and reason. 3. After saving, an **Install** button appears at the bottom right of the editor. If there's also a new ESPHome release available, the button reads **Update** instead. Click it, then pick **On the Network** for OTA, or **Plug into this computer** for USB. -![](../../../assets/esphome-device-builder-save-validate-install.gif) +![Clicking Save, Validate, and Install in the editor, with the Configuration is valid result and install log](../../../assets/esphome-device-builder-save-validate-install.gif) #### Logs Click **Logs** from the info panel or the device card's three-dot menu to open a live stream of what the device is reporting. Click **Stop** when done. -![](../../../assets/esphome-device-builder-logs-start-stop.gif) +![Opening the live Logs stream from the device card, then clicking Stop to pause it](../../../assets/esphome-device-builder-logs-start-stop.gif) Pop them open when something looks off, or just to watch sensor readings come in. @@ -91,6 +91,6 @@ Pop them open when something looks off, or just to watch sensor readings come in * Read [What is secrets.yaml?](what-is-secrets-yaml.md) to understand how Wi-Fi and encryption keys are stored. * Bookmark the [official ESPHome documentation](https://esphome.io) for component reference whenever you click a **Docs** link. - Back - Explaining ESPHome Next - What is YAML? +ESPHome logo Back - Explaining ESPHome ESPHome logo Next - What is YAML? --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/explaining-esphome.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/explaining-esphome.md index b294dd4d72..89de64e11b 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/explaining-esphome.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/explaining-esphome.md @@ -50,7 +50,7 @@ You get wireless updates, a built-in web page for controlling your device, and d The official ESPHome documentation covers every component, configuration option, and advanced topic in detail. - Next - Device Builder Tour Visit esphome.io +ESPHome logo Next - Device Builder Tour ESPHome logo Visit esphome.io --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/how-esphome-talks-to-home-assistant.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/how-esphome-talks-to-home-assistant.md index 4565fbcfb8..46dc8db3eb 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/how-esphome-talks-to-home-assistant.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/how-esphome-talks-to-home-assistant.md @@ -57,7 +57,7 @@ For a single device, the on-device web page is often enough. For anything that t For UniFi networks specifically, see our [UniFi mDNS troubleshooting guide](../../general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md). - Back - What is secrets.yaml? Tutorial - Connect to Home Assistant +ESPHome logo Back - What is secrets.yaml? ESPHome logo Tutorial - Connect to Home Assistant --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-i2c.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-i2c.md index 182f9663b4..4756ba041d 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-i2c.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-i2c.md @@ -51,7 +51,7 @@ If you plug in a sensor and aren't sure of its address, the scan tells you. If t Ready to plug something in? The [Breakout Module](/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md) page covers the connectors, and the ESPHome docs list every supported I2C sensor. - ESPHome I2C docs +ESPHome logo ESPHome I2C docs --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-secrets-yaml.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-secrets-yaml.md index 3e1facfd3c..32db86a816 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-secrets-yaml.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-secrets-yaml.md @@ -40,7 +40,7 @@ Treat secrets.yaml like a password manager entry: Ready to put this into practice? The Using Secrets tutorial walks through opening secrets.yaml in the Device Builder, the `!secret` syntax, and what to store for every common case (Wi-Fi, Home Assistant API, OTA, web server auth, MQTT). - Using Secrets tutorial +ESPHome logo Using Secrets tutorial --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md index 51a1b33076..3adec0cdc8 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md @@ -117,7 +117,7 @@ You did not type any of that. The Builder wrote it when you clicked **Add**. Onc The official YAML site has the full specification, and the ESPHome docs walk through YAML in the context of ESPHome specifically. -YAML official site ESPHome YAML guide +YAML official site ESPHome logo ESPHome YAML guide --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md b/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md index 25570a451d..048091c469 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md @@ -21,7 +21,7 @@ Connect the Breakout Module to the ESP32-C6 using one of the FPC ribbon cables t 1\. Unplug the USB-C cable from the ESP32-C6 so it is powered off. -![](../../../assets/esphome-starter-kit-remove-usb.webp) +![Unplugging the USB-C cable from the ESP32-C6 board](../../../assets/esphome-starter-kit-remove-usb.webp) !!! warning "Handle the FPC connectors gently" @@ -29,11 +29,11 @@ Connect the Breakout Module to the ESP32-C6 using one of the FPC ribbon cables t 2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) +![Lifting the FPC connector latch on the ESP32-C6 and sliding in the ribbon cable, blue side up](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) 3\. Slide the ribbon cable into the Breakout Module with the blue side facing upwards then press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-fpc-to-breakout-module.webp) +![Sliding the ribbon cable into the Breakout Module FPC connector, blue side up, and closing the latch](../../../assets/esphome-starter-kit-attach-fpc-to-breakout-module.webp) 4\. Plug the ESP32-C6 back into your computer. @@ -41,7 +41,7 @@ Connect the Breakout Module to the ESP32-C6 using one of the FPC ribbon cables t The Breakout Module is covered in connectors, each labeled on the board. Most of them carry the same I2C bus at different voltages, plus a 1Wire port and a GPIO header for everything else. -![](/assets/esphome-starter-kit-breakout-module-pinout.webp) +![Breakout Module diagram labeling the I2C, FPC, 1Wire, STEMMA 3.3V, GPIO header, STEMMA 5V, Grove, and SEN6x connectors](/assets/esphome-starter-kit-breakout-module-pinout.webp) === "I2C" @@ -66,13 +66,13 @@ The Breakout Module is covered in connectors, each labeled on the board. Most of Plug your sensor's STEMMA QT (Qwiic) cable into the port. The connector is keyed, so it only fits one way. - ![](/assets/esphome-starter-kit-breakout-module-stemma-qt.webp) + ![Plugging a sensor's 4-wire STEMMA QT cable into the Breakout Module port labeled VStemma 5V](/assets/esphome-starter-kit-breakout-module-stemma-qt.webp) === "SEN6x" Sensirion SEN6x air quality sensors, like the SEN65, come with their own ribbon cable. Plug it into the **SEN6x** port at the bottom right, latch side facing up. The connector is keyed, so it only fits one way. - ![](/assets/esphome-starter-kit-breakout-module-sen6x.webp) + ![Plugging the SEN65 sensor's red cable into the SEN6x port on the Breakout Module](/assets/esphome-starter-kit-breakout-module-sen6x.webp) See the [SEN65 Air Quality Sensor](/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md) add-on page for the full walkthrough and what each reading means. @@ -91,7 +91,7 @@ The Breakout Module is covered in connectors, each labeled on the board. Most of Plug the probe's connector into the 1Wire port with the latch side facing up. - ![](/assets/esphome-starter-kit-breakout-module-dallas-probe.webp) + ![Plugging the DS18B20 temperature probe's 3.5mm plug into the 1Wire jack on the Breakout Module](/assets/esphome-starter-kit-breakout-module-dallas-probe.webp) See the [Temperature Probe](/products/ESPHome-Starter-Kit/modules/breakout-addons/temperature-probe.md) add-on page for the full walkthrough. @@ -109,7 +109,7 @@ The Breakout Module is covered in connectors, each labeled on the board. Most of The 2x6 header in the middle of the board breaks out power, the UART, and spare GPIOs for anything else you want to wire up. - ![](/assets/esphome-starter-kit-breakout-gpio-header-pinout.webp) + ![Breakout Module 2x6 GPIO header pinout: 5V, TX, RX, IO3, IO6, IO14 on top and 3.3V, SCL, SDA, IO2, IO7, GND below](/assets/esphome-starter-kit-breakout-gpio-header-pinout.webp) A few of these pins pull double duty: @@ -119,7 +119,7 @@ The Breakout Module is covered in connectors, each labeled on the board. Most of Connect your components to the header with standard jumper wires. - ![](/assets/esphome-starter-kit-breakout-module-gpio-header.webp) + ![Plugging a three-wire jumper cable into the Breakout Module GPIO header](/assets/esphome-starter-kit-breakout-module-gpio-header.webp) ??? note "Advanced: keeping 3.3V power on during sleep" @@ -127,7 +127,7 @@ The Breakout Module is covered in connectors, each labeled on the board. Most of If your project needs 3.3V that stays on through sleep, there's a solder jumper on the back of the board, top right, labeled **J5**. The existing bridge between the center pad and the **3vCTRL** pad looks like an H. Cut that bridge, then solder a new bridge from the center pad to the **3V** pad for always-on power. - ![](/assets/esphome-starter-kit-breakout-3v-select-jumper.webp) + ![Back of the Breakout Module with solder jumper J5 circled in red between the 3V and 3vCTRL pads](/assets/esphome-starter-kit-breakout-3v-select-jumper.webp) This involves cutting a trace and soldering on the board itself, so skip it unless you know you need it. Most projects are fine with the default. diff --git a/docs/products/ESPHome-Starter-Kit/modules/battery.md b/docs/products/ESPHome-Starter-Kit/modules/battery.md index 1fec90ca4b..48d59f106d 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/battery.md +++ b/docs/products/ESPHome-Starter-Kit/modules/battery.md @@ -24,7 +24,7 @@ The battery connector only fits one way, but check the wire colors before you pu Push the connector into the battery port until it seats fully. -![](/assets/esphome-starter-kit-attach-battery.webp) +![Plugging the flat battery's red and black wire connector into the battery port on the ESP32-C6](/assets/esphome-starter-kit-attach-battery.webp) ## Monitor the battery diff --git a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md index b7befba7ae..238e4d0527 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md +++ b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md @@ -14,7 +14,7 @@ It's part of Sensirion's SEN6x family. The SEN65 does not read CO₂ or formalde The SEN65 comes with its own ribbon cable. Plug it into the **SEN6x** port at the bottom right of the [Breakout Module](/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md#pinout), latch side facing up. The connector is keyed, so it only fits one way. -![](/assets/esphome-starter-kit-breakout-module-sen6x.webp) +![Plugging the SEN65 sensor's red cable into the SEN6x port on the Breakout Module](/assets/esphome-starter-kit-breakout-module-sen6x.webp) The SEN6x port is on the same I2C bus as the other connectors: **SCL on GPIO0**, **SDA on GPIO1**. @@ -48,7 +48,7 @@ The SEN65 needs three components in your device config: the accessory power swit 9. Click **Add**, then flash the device. The SEN65's readings show up alongside your other entities. -![](/assets/esphome-device-builder-add-sen6x-component.gif) +![Adding the I2C Bus component, then the SEN6x component with its SEN65 readings toggled on in ESPHome Device Builder](/assets/esphome-device-builder-add-sen6x-component.gif) Want a single air quality number on top of the individual readings? Add the AQI component too, see [NowCast AQI](#nowcast-aqi) below. diff --git a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/temperature-probe.md b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/temperature-probe.md index 04c8f49fe2..91048a7c2e 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/temperature-probe.md +++ b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/temperature-probe.md @@ -21,7 +21,7 @@ Both probes read -55°C to 85°C (-67°F to 185°F) with ±0.5°C accuracy. Pick Plug the probe's connector into the **1Wire** port at the top right of the [Breakout Module](/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md#pinout) with the latch side facing up. -![](/assets/esphome-starter-kit-breakout-module-dallas-probe.webp) +![Plugging the DS18B20 temperature probe's 3.5mm plug into the 1Wire jack on the Breakout Module](/assets/esphome-starter-kit-breakout-module-dallas-probe.webp) The probe's data line is on **GPIO6**. diff --git a/docs/products/ESPHome-Starter-Kit/modules/button-module.md b/docs/products/ESPHome-Starter-Kit/modules/button-module.md index 52cab3579d..0640e0c466 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/button-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/button-module.md @@ -21,7 +21,7 @@ Connect the button module to the ESP32-C6 using one of the FPC ribbon cables tha 1\. Unplug the USB-C cable from the ESP32-C6 so it is powered off. -![](../../../assets/esphome-starter-kit-remove-usb.webp) +![Unplugging the USB-C cable from the ESP32-C6 board](../../../assets/esphome-starter-kit-remove-usb.webp) !!! warning "Handle the FPC connectors gently" @@ -29,11 +29,11 @@ Connect the button module to the ESP32-C6 using one of the FPC ribbon cables tha 2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) +![Lifting the FPC connector latch on the ESP32-C6 and sliding in the ribbon cable, blue side up](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) 3\. Slide the ribbon cable into the button module with the blue side facing upwards then press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-fpc-to-button-module.webp) +![Sliding the ribbon cable from the ESP32-C6 into the Button module FPC connector and closing the latch](../../../assets/esphome-starter-kit-attach-fpc-to-button-module.webp) 4\. Plug the ESP32-C6 back into your computer. @@ -47,7 +47,7 @@ ESPHome Device Builder ships an **Add Component** flow that knows the pin layout 4. Search for **Button** and select the **Button Module**. 5. Click **Add**. Device Builder inserts the button's binary sensor block into your YAML. -![](../../../assets/esphome-device-builder-add-button-module.gif) +![Searching for button in the Add component dialog, choosing Button Module on GPIO6, and clicking Add](../../../assets/esphome-device-builder-add-button-module.gif) ??? note "What the button YAML does" @@ -91,19 +91,19 @@ Flash the device so the new button entity goes live. 3. Wait for the compile and flash to finish. First builds can take a few minutes. 4. The device reboots and reconnects to your Wi-Fi on its own. -![](../../../assets/esphome-device-builder-install-button-component.gif) +![Clicking Install in ESPHome Device Builder, choosing On the network, and watching the firmware compile log](../../../assets/esphome-device-builder-install-button-component.gif) ## Test the Button With the device back online, the button entity is live on the web server. Open it in a browser on the same network and watch it react in real time. -![](../../../assets/esphome-device-builder-launch-webserver-from-visit-button.gif) +![Clicking the Visit icon on the device card to open the esphome-starter-kit web server with Button Module](../../../assets/esphome-device-builder-launch-webserver-from-visit-button.gif) 1. In a browser, open `http://.local/`. If you used `esphome-starter-kit` as the device name in Getting Started, that's `http://esphome-starter-kit.local/`. 2. Find the **Button** entity in the binary sensor list. 3. Press the button on the module. The entity flips from **OFF** to **ON** while the button is held, then back to **OFF** when you release it. -![](../../../assets/esphome-device-builder-test-button-events.gif) +![Web server page where the Button Module indicator turns checked while the button is pressed](../../../assets/esphome-device-builder-test-button-events.gif) > Web server page showing the Button binary sensor toggling between ON and OFF as the button is pressed. @@ -115,8 +115,8 @@ With the device back online, the button entity is live on the web server. Button Controlled LEDs - Play a Tune - Press to Check Climate + ESPHome logo Button Controlled LEDs + ESPHome logo Play a Tune + ESPHome logo Press to Check Climate --8<-- "_snippets/community-help.md" \ No newline at end of file diff --git a/docs/products/ESPHome-Starter-Kit/modules/motion-module.md b/docs/products/ESPHome-Starter-Kit/modules/motion-module.md index e98ebfbc5d..c1dc7ebf4a 100755 --- a/docs/products/ESPHome-Starter-Kit/modules/motion-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/motion-module.md @@ -23,7 +23,7 @@ The PIR sensor (the small white dome on a tiny PCB) ships separately from the mo 2. Line up the **Out** name on each side as shown in the gif below. 3. Press it down firmly until the pins are fully seated. -![](../../../assets/esphome-starter-kit-attach-pir-to-motion-module.webp) +![Pressing the PIR sensor onto the motion module pins with the Out labels lined up](../../../assets/esphome-starter-kit-attach-pir-to-motion-module.webp) ## Attach Motion module @@ -31,7 +31,7 @@ Connect the motion module to the ESP32-C6 using one of the FPC ribbon cables tha 1\. Unplug the USB-C cable from the ESP32-C6 so it is powered off. -![](../../../assets/esphome-starter-kit-remove-usb.webp) +![Unplugging the USB-C cable from the ESP32-C6 board](../../../assets/esphome-starter-kit-remove-usb.webp) !!! warning "Handle the FPC connectors gently" @@ -39,11 +39,11 @@ Connect the motion module to the ESP32-C6 using one of the FPC ribbon cables tha 2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) +![Sliding the FPC ribbon cable, blue side up, into the ESP32-C6 connector and closing the latch](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) 3\. Slide the ribbon cable into the motion module with the blue side facing upwards then press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-fpc-to-motion-module.webp) +![Connecting the other end of the FPC ribbon cable to the motion module](../../../assets/esphome-starter-kit-attach-fpc-to-motion-module.webp) 4\. Plug the ESP32-C6 back into your computer. @@ -56,7 +56,7 @@ ESPHome Device Builder ships an **Add Component** flow that knows the pin layout 3. Search for **Motion** and select the Apollo Starter Kit PIR motion component. 4. Click **Add**. Device Builder inserts the PIR's binary sensor block into your YAML. -![](../../../assets/esphome-device-builder-add-motion-component.gif) +![ESPHome Device Builder Add component dialog: searching motion and adding the Motion Module](../../../assets/esphome-device-builder-add-motion-component.gif) ??? note "What the Motion YAML does" @@ -94,7 +94,7 @@ Flash the device so the new motion entity goes live. 3. Wait for the compile and flash to finish. First builds can take a few minutes. 4. The device reboots and reconnects to your Wi-Fi on its own. -![](../../../assets/esphome-device-builder-install-motion-component.gif) +![ESPHome Device Builder clicking Install, choosing On the network, and compiling the motion config](../../../assets/esphome-device-builder-install-motion-component.gif) ## Test Motion @@ -108,7 +108,7 @@ With the device back online, the Motion entity is live on the web server. Web server page showing the Motion binary sensor toggling between ON and OFF as motion is detected. @@ -120,6 +120,6 @@ With the device back online, the Motion entity is live on the web server. Motion-Activated Light + ESPHome logo Motion-Activated Light --8<-- "_snippets/community-help.md" \ No newline at end of file diff --git a/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md b/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md index 87f0d986ea..42c50344a7 100755 --- a/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/rgb-buzzer-module.md @@ -21,7 +21,7 @@ Connect the LED & Buzzer module to the ESP32-C6 using one of the FPC ribbon cabl 1\. Unplug the USB-C cable from the ESP32-C6 so it is powered off. -![](../../../assets/esphome-starter-kit-remove-usb.webp) +![Unplugging the USB-C cable from the ESP32-C6 board](../../../assets/esphome-starter-kit-remove-usb.webp) !!! warning "Handle the FPC connectors gently" @@ -29,11 +29,11 @@ Connect the LED & Buzzer module to the ESP32-C6 using one of the FPC ribbon cabl 2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) +![Sliding the FPC ribbon cable, blue side up, into the ESP32-C6 connector and closing the latch](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) 3\. Slide the ribbon cable into the LED & buzzer module with the blue side facing upwards then press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-fpc-to-rgb-buzzer-module.webp) +![Connecting the other end of the FPC ribbon cable to the LED & Buzzer module](../../../assets/esphome-starter-kit-attach-fpc-to-rgb-buzzer-module.webp) 4\. Plug the ESP32-C6 back into your computer. @@ -47,7 +47,7 @@ ESPHome Device Builder ships an **Add Component** flow that knows the pin layout 4. Select the **RGB LED + Buzzer Module Bundle** at the top. 5. Click **Add** -> Click **Add** -> Click **Add** -> Click **Add**. Each section lets you make changes but we will leave them at defaults for now. Device Builder inserts the light, output, and rtttl blocks into your YAML. -![](../../../assets/esphome-device-builder-add-rgb-buzzer-bundle-module.gif) +![ESPHome Device Builder adding the RGB LED + Buzzer Module bundle and clicking Add through each step](../../../assets/esphome-device-builder-add-rgb-buzzer-bundle-module.gif) ??? note "What the LED & Buzzer Module YAML does" @@ -107,7 +107,7 @@ Flash the device so the new RGB & Buzzer entities go live. 3. Wait for the compile and flash to finish. First builds can take a few minutes. 4. The device reboots and reconnects to your Wi-Fi on its own. -![](../../../assets/esphome-device-builder-install-rgb-buzzer-component.gif) +![ESPHome Device Builder clicking Install, choosing On the network, and compiling the LED and buzzer config](../../../assets/esphome-device-builder-install-rgb-buzzer-component.gif) ## Test the LEDs @@ -122,7 +122,7 @@ With the device back online, the RGB LED light entity is live on the web server. 1. There's a lot you can do with a light entity. See the [Light Effects tutorial](/products/ESPHome-Starter-Kit/tutorials/light-effects.md) for advanced configurations, or the [ESPHome light strip effects documentation](https://esphome.io/components/light/#strip-animations) to go deeper. -![](../../../assets/esphome-device-builder-test-rgb-leds.gif) +![Starter kit web server turning on the RGB LEDs and picking a new color](../../../assets/esphome-device-builder-test-rgb-leds.gif) !!! success "Your LED & Buzzer notification module is wired up!" @@ -134,9 +134,9 @@ With the device back online, the RGB LED light entity is live on the web server. Your notification module is ready. Drive it from any of these automations: - Button Controlled LEDs - Play a Tune - Temp-Reactive LEDs - Motion-Activated Light + ESPHome logo Button Controlled LEDs + ESPHome logo Play a Tune + ESPHome logo Temp-Reactive LEDs + ESPHome logo Motion-Activated Light --8<-- "_snippets/community-help.md" \ No newline at end of file diff --git a/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md b/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md index 63970f2d2d..909404b26c 100755 --- a/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md @@ -22,7 +22,7 @@ Connect the Temperature and Humidity module to the ESP32-C6 using one of the FPC 1\. Unplug the USB-C cable from the ESP32-C6 so it is powered off. -![](../../../assets/esphome-starter-kit-remove-usb.webp) +![Unplugging the USB-C cable from the ESP32-C6 board](../../../assets/esphome-starter-kit-remove-usb.webp) !!! warning "Handle the FPC connectors gently" @@ -30,11 +30,11 @@ Connect the Temperature and Humidity module to the ESP32-C6 using one of the FPC 2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) +![Sliding the FPC ribbon cable, blue side up, into the ESP32-C6 connector and closing the latch](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) 3\. Slide the ribbon cable into the temperature and humidity module with the blue side facing upwards then press the latch down to lock it in place. -![](../../../assets/esphome-starter-kit-attach-fpc-to-temp-hum-module.webp) +![Connecting the other end of the FPC ribbon cable to the temperature and humidity module](../../../assets/esphome-starter-kit-attach-fpc-to-temp-hum-module.webp) 4\. Plug the ESP32-C6 back into your computer. @@ -51,7 +51,7 @@ ESPHome Device Builder ships an **Add Component** flow that knows the pin layout 7. Toggle the **Humidity** and **Temperature** selections on. 8. Click **Add**. Device Builder inserts the AHT20F sensor block into your YAML. -![](../../../assets/esphome-device-builder-add-i2c-temp-hum-component.gif) +![ESPHome Device Builder adding the I2C bus, then the AHT20 module with Humidity and Temperature on](../../../assets/esphome-device-builder-add-i2c-temp-hum-component.gif) ??? note "What the temperature and humidity YAML does" @@ -99,7 +99,7 @@ Flash the device so the new temperature and humidity entities go live. 3. Wait for the compile and flash to finish. First builds can take a few minutes. 4. The device reboots and reconnects to your Wi-Fi on its own. -![](../../../assets/esphome-device-builder-install-temp-hum-component.gif) +![ESPHome Device Builder clicking Install, choosing On the network, and compiling the sensor config](../../../assets/esphome-device-builder-install-temp-hum-component.gif) ## Test the Temp and Humidity @@ -109,7 +109,7 @@ With the device back online, the temperature and humidity entities are live on t 2. Find the **Temperature** and **Humidity** entities in the sensor list. 3. Watch the values update on the interval you set. Cup your hand over the sensor or breathe on it, the humidity reading will respond within a few cycles. -![](../../../assets/esphome-device-builder-test-temp-humidity.gif) +![Starter kit web server showing live Humidity and Temperature readings](../../../assets/esphome-device-builder-test-temp-humidity.gif) > Web server page showing the Temperature and Humidity sensors with live readings. @@ -121,7 +121,7 @@ With the device back online, the temperature and humidity entities are live on t Your sensor is reporting. Now make it drive something: - Temp-Reactive LEDs - Press to Check Climate + ESPHome logo Temp-Reactive LEDs + ESPHome logo Press to Check Climate --8<-- "_snippets/community-help.md" \ No newline at end of file diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md index cf55aa211f..a10b95d790 100755 --- a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md +++ b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md @@ -33,7 +33,7 @@ ESPHome Device Builder is the app that gives you a user interface for writing, c Think of it like telling the starter kit about what devices it has connected and how to use them! - Learn more about ESPHome +ESPHome logo Learn more about ESPHome Pick the platform you'll be running ESPHome Device Builder on: @@ -48,7 +48,7 @@ Pick the platform you'll be running ESPHome Device Builder on: If a blue **Windows protected your PC** warning appears when you open the `.exe`, click **More info → Run anyway** to continue. - ![](../../../assets/esphome-builder-install-windows.gif) + ![Downloading the Windows installer from esphome.io, clicking Run anyway, and running setup](../../../assets/esphome-builder-install-windows.gif) The first launch takes a moment while it sets itself up, then the dashboard opens in your browser at http://localhost:6052/. An ESPHome icon lands in your notification area for getting back to it later. @@ -60,7 +60,7 @@ Pick the platform you'll be running ESPHome Device Builder on: Then take **Start guided tour** for a [five minute walkthrough](../learning-the-basics/device-builder-tour.md), or **Maybe later**. - ![](../../../assets/device-builder-first-time-install-pick-your-experience.gif) + ![ESPHome Device Builder setup wizard: picking Installation, then New to ESPHome, then Start guided tour](../../../assets/device-builder-first-time-install-pick-your-experience.gif) === "Mac" @@ -89,7 +89,7 @@ Pick the platform you'll be running ESPHome Device Builder on: Then take **Start guided tour** for a [five minute walkthrough](../learning-the-basics/device-builder-tour.md), or **Maybe later**. - ![](../../../assets/device-builder-first-time-install-pick-your-experience.gif) + ![ESPHome Device Builder setup wizard: picking Installation, then New to ESPHome, then Start guided tour](../../../assets/device-builder-first-time-install-pick-your-experience.gif) === "Home Assistant App" @@ -141,7 +141,7 @@ Pick the platform you'll be running ESPHome Device Builder on: Then take **Start guided tour** for a [five minute walkthrough](../learning-the-basics/device-builder-tour.md), or **Maybe later**. - ![](../../../assets/device-builder-first-time-install-pick-your-experience.gif) + ![ESPHome Device Builder setup wizard: picking Installation, then New to ESPHome, then Start guided tour](../../../assets/device-builder-first-time-install-pick-your-experience.gif) #### Add a new device @@ -149,7 +149,7 @@ With the app installed, it's time to tell it about your kit. If you took the gui 1\. Navigate back to the ESPHome Device Builder and click **Add new device** then click Create new project. -![](../../../assets/device-builder-add-new-device.gif) +![ESPHome Device Builder Add new device card opening Create new project and the board list](../../../assets/device-builder-add-new-device.gif)
@@ -159,7 +159,7 @@ With the app installed, it's time to tell it about your kit. If you took the gui 1. Remember the name you choose. You'll use it later to reach your device's web server at `http://your-name.local` (for example, http://esphome-starter-kit.local/). -![](../../../assets/device-builder-select-kit-name-kit-add-wifi.gif) +![Selecting the ESPHome Starter Kit board, naming the device, and entering Wi-Fi details](../../../assets/device-builder-select-kit-name-kit-add-wifi.gif) ### Configure Components @@ -177,7 +177,7 @@ The Onboard RGB LED is a small LED above the Reset button of your ESP32-C6. Usef 2. Click **Add component**. 3. Scroll to **Onboard RGB LED** and click **Add**. -![](../../../assets/device-builder-add-onboard-rgb-led-component.gif) +![ESPHome Device Builder Add component dialog adding the Onboard RGB LED with default settings](../../../assets/device-builder-add-onboard-rgb-led-component.gif) ### Boot Mode @@ -189,11 +189,11 @@ The device is required to be flashed via USB using the bootloader mode the very 1\. Hold the sides of the ESP32-C6 and gently push the USB-C cable firmly into the USB-C port. Plug in the other side of the USB-C cable into your computer. Please be careful not to snap or damage the FPC ribbon cable connectors located on the sides of the device. -![](../../../assets/esphome-starter-kit-plug-in-usb-c.webp) +![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. -![](../../../assets/esphome-starter-kit-boot-mode.webp) +![Holding the BOOT button on the ESP32-C6 while pressing and releasing RESET](../../../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. @@ -208,13 +208,13 @@ Before we continue, confirm that you installed the ESPHome Device Builder, confi 5. Wait for the software to compile and install. This usually takes two to five minutes. 6. Once it completes, click **Stop**, then press the **Reset** button on your device. Your device will reboot and it's now ready to test out! -![](../../../assets/device-builder-initial-firmware-install.gif) +![ESPHome Device Builder installing over USB: picking the serial port, compiling, and flashing](../../../assets/device-builder-initial-firmware-install.gif) !!! tip "Click Show details during the install to watch the compile and flash process" It's a great way to see what's happening under the hood. - Learn about Core Components +ESPHome logo Learn about Core Components ### Test your LED @@ -226,12 +226,12 @@ Your kit's default project includes the [**Web Server**](../learning-the-basics/ It should load your new device with the Onboard RGB LED listed. Click its toggle and the LED on your kit turns on and off. -![](../../../assets/device-builder-web-server-v3.gif) +![Starter kit web server toggling the Onboard RGB LED and moving its brightness slider](../../../assets/device-builder-web-server-v3.gif) The LED on the board, switching on and off. -![](../../../assets/esphome-starter-kit-onboard-rgb-led-light-up.webp) +![Onboard RGB LED next to the RESET button on the ESP32-C6 blinking on and off](../../../assets/esphome-starter-kit-onboard-rgb-led-light-up.webp) - Back - Start Here Add More Modules Connect to Home Assistant +ESPHome logo Back - Start Here ESPHome logo Add More Modules ESPHome logo Connect to Home Assistant --8<-- "_snippets/community-help.md" \ No newline at end of file diff --git a/docs/products/ESPHome-Starter-Kit/start-here.md b/docs/products/ESPHome-Starter-Kit/start-here.md index 51c144ec95..c1bbae3e11 100755 --- a/docs/products/ESPHome-Starter-Kit/start-here.md +++ b/docs/products/ESPHome-Starter-Kit/start-here.md @@ -8,7 +8,7 @@ Welcome to the start of your ESPHome journey with the all-new **ESPHome Starter [:material-cart: Buy the ESPHome Starter Kit](https://apolloautomation.com/products/esk-1-esphome-starter-kit){ .md-button .md-button--primary } -![](../../assets/esphome-starter-kit-exploded-with-box-1.png) +![ESPHome Starter Kit box beside the ESP32-C6, modules, PIR sensor, FPC cables, and LED & Buzzer module](../../assets/esphome-starter-kit-exploded-with-box-1.png) By the end of this wiki you'll know how to: @@ -19,7 +19,7 @@ By the end of this wiki you'll know how to: Your kit arrives as a single snap-apart panel that includes the ESP32-C6 along with a selection of interchangeable modules. The kit also includes three ribbon cables for connecting modules to the ESP32-C6, one more than any project uses at once so you always have a spare, plus a stand for the LED & Buzzer module. -![](../../assets/esphome-starter-kit-whats-in-the-box.png) +![Kit contents: ESP32-C6 board, snap-apart module panel, white stand, PIR sensor, and three FPC cables](../../assets/esphome-starter-kit-whats-in-the-box.png) ## Snapping the panel apart @@ -32,7 +32,7 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps 1. Hold the panel flat on a table with one hand on the module you want to remove. 2. Gently flex the panel along the tab line until the tab snaps cleanly. -![](../../assets/esphome-starter-kit-disassembly-final.gif) +![Snapping the modules and the LED & Buzzer module off the starter kit panel by hand](../../assets/esphome-starter-kit-disassembly-final.gif) ## Meet the modules @@ -40,7 +40,7 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps * The brain of every project you'll build with the kit. It handles Wi-Fi and Bluetooth, runs your ESPHome config, and exposes the GPIO pins the modules plug into. -![](../../assets/esphome-starter-kit-main-board-labeled.jpg) +![ESP32-C6 board labeled: two FPC connectors, RGB LED, Reset and Boot buttons, USB-C, battery connector](../../assets/esphome-starter-kit-main-board-labeled.jpg) --- @@ -48,7 +48,7 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps * The starter kit's notification module, a strip of ten addressable RGB LEDs and a small piezo buzzer behind the ESPHome logo silkscreen. *Use the included stand to show it off!* -![](../../assets/esphome-starter-kit-rgb-buzzer-module-only.jpg) +![LED & Buzzer module with RGB LEDs around the ESPHome logo, standing in its stand](../../assets/esphome-starter-kit-rgb-buzzer-module-only.jpg) --- @@ -56,7 +56,7 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps * Detects movement in a room and a great way to get started automating your home. It comes in two parts, and the PIR sensor easily plugs into the PIR module board. -![](../../assets/esphome-starter-kit-pir-module-only.jpg) +![Motion module with the round PIR sensor plugged into its header](../../assets/esphome-starter-kit-pir-module-only.jpg) --- @@ -64,7 +64,7 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps * Premium feel button perfect to trigger automations for lights and more. -![](../../assets/esphome-starter-kit-button-module-only.jpg) +![Button module with a large black push button and an FPC connector](../../assets/esphome-starter-kit-button-module-only.jpg) --- @@ -72,7 +72,7 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps * Extremely accurate temp and humidity sensor trustworthy enough to track a room comfort level with ease! -![](../../assets/esphome-starter-kit-temp-hum-module-only-1.jpg) +![Temperature and humidity module with its small sensor chip and an FPC connector](../../assets/esphome-starter-kit-temp-hum-module-only-1.jpg) --- @@ -80,12 +80,12 @@ Each module is connected to the panel by small breakaway tabs. Follow the steps * Each module connects to the ESP32-C6 through the FPC connector using one of the three provided cables. *Tear the brown paper bag open from one of the ends. Please DO NOT use scissors as you could accidentally cut the cables!* -![](../../assets/esphome-starter-kit-fpc-cables-only.jpg) +![Three FPC ribbon cables with blue ends, outlined in red](../../assets/esphome-starter-kit-fpc-cables-only.jpg) ## Next: bring it online Once you've identified your modules and snapped them off the panel, the next step is to connect the ESP32-C6 to your computer and walk through your first ESPHome configuration. - Next - First Steps + ESPHome logo Next - First Steps --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md b/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md index d259103174..056d5df6c0 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md @@ -27,7 +27,7 @@ Device Builder has an **Add Component** flow that drops the proxy into your conf 3. Search for **Bluetooth Proxy** and select it. 4. Click **Add**. Device Builder inserts the proxy into your YAML. -![](../../../assets/esphome-device-builder-add-ble-proxy-component.gif) +![ESPHome Device Builder Add component dialog: searching bluetooth proxy and adding it](../../../assets/esphome-device-builder-add-ble-proxy-component.gif) ??? note "Prefer to add it by hand? Here's the YAML" @@ -59,7 +59,7 @@ The proxy is saved in Device Builder, but the device is still running its old so 3. Wait for the compile and flash to finish. The device reboots once the install is done. -![](../../../assets/esphome-device-builder-add-ble-proxy-save-validate-install.gif) +![ESPHome Device Builder saving, validating, then installing the Bluetooth Proxy On the network](../../../assets/esphome-device-builder-add-ble-proxy-save-validate-install.gif) ## Verify it works diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md b/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md index e33db9d7f7..7ab6d10ac6 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md @@ -50,7 +50,7 @@ Open `secrets.yaml` in Device Builder, copy the `api_encryption_key` value, and Want to understand what just happened under the hood? Read [the Home Assistant integration](../learning-the-basics/how-esphome-talks-to-home-assistant.md). - Back - First Steps +ESPHome logo Back - First Steps --8<-- "_snippets/community-help.md" diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md b/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md index ee77db3961..c85162cc9d 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md @@ -32,7 +32,7 @@ Out of the box, your RGB module turns on, turns off, and changes color. ESPHome 6. Click **\+ Add** a second time and pick **Addressable Color Wipe**. -![](../../../assets/esphome-device-builder-add-effects.gif) +![ESPHome Device Builder adding Addressable Rainbow and Addressable Color Wipe effects to the light](../../../assets/esphome-device-builder-add-effects.gif) That gives the light two effects: a continuously cycling rainbow and a sweeping color wipe. Add as many as you like the same way, and click the **X** to the right of an effect's dropdown to drop one. @@ -67,7 +67,7 @@ The effects are saved in Device Builder, but the device is still running its old 1. We say software because it's the friendlier word. The technically correct term is firmware: code that runs directly on the chip instead of on a computer. That's the word ESPHome's own docs use. -![](../../../assets/esphome-device-builder-save-install-on-the-network.gif) +![ESPHome Device Builder clicking Save, then Install, choosing On the network, and compiling](../../../assets/esphome-device-builder-save-install-on-the-network.gif) 3\. Wait for the compile and flash to finish. The device reboots once the install is done. @@ -75,9 +75,9 @@ The effects are saved in Device Builder, but the device is still running its old With the device back online, open the local web page at `http://esphome-starter-kit.local/` (or whatever you named your device) in a browser on the same Wi-Fi network. Find the RGB light entity and pick **Rainbow** or **Color Wipe** from the **Effect** dropdown. The LEDs start animating right away. -![](../../../assets/esphome-starter-kit-effects-on-rgb-panel-showcase.webp) +![LED & Buzzer module LEDs cycling through colors with an effect running](../../../assets/esphome-starter-kit-effects-on-rgb-panel-showcase.webp) -![](../../../assets/esphome-device-builder-test-effects-web-server.gif) +![Starter kit web server turning on the RGB LEDs and picking Rainbow, then Color Wipe, from the Effect list](../../../assets/esphome-device-builder-test-effects-web-server.gif) If you've already followed [Connect to Home Assistant](/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md), the same **Effect** dropdown shows up on the light entity card in Home Assistant. diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md b/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md index 95d5d545bd..01639ca630 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md @@ -32,7 +32,7 @@ Start on your Windows PC. This is the machine that will do the compiling. 1. **Paired senders**, just below the toggle, lists every dashboard allowed to send builds here. It stays empty until you pair one. -![](../../../assets/esphome-device-builder-toggle-on-remote-build.gif) +![ESPHome Device Builder three-dot menu, Settings, Build server, turning on Enable remote build](../../../assets/esphome-device-builder-toggle-on-remote-build.gif) ## Pair the Two Dashboards @@ -56,7 +56,7 @@ On your Windows PC, open **Settings → Pairing requests**. It shows **Open** wi 3. **Pair request sent** appears with a row of emoji under **Your fingerprint**. Leave it on screen, you're about to compare it. -![](../../../assets/esphome-device-builder-initiate-build-server-pairing.gif) +![ESPHome Device Builder Send builds: clicking Pair, sending the pair request, and seeing the emoji fingerprint](../../../assets/esphome-device-builder-initiate-build-server-pairing.gif) #### Accept It on Your PC @@ -69,11 +69,11 @@ On your Windows PC, open **Settings → Pairing requests**. It shows **Open** wi 1. Accepting gives that dashboard code execution on your PC. Only accept a request you just sent yourself. -![](../../../assets/esphome-device-builder-review-accept-pair-request.gif) +![ESPHome Device Builder Pairing requests: clicking Review, comparing the emoji fingerprint, and clicking Accept](../../../assets/esphome-device-builder-review-accept-pair-request.gif) Back on the sending dashboard, your PC now sits under **Paired build servers** marked **Connected**. That's how you know it worked. The row reads **Pending** while it's waiting on you and flips over once you accept. -![](../../../assets/esphome-device-builder-successful-pairing.png) +![ESPHome Device Builder Send builds settings showing the paired build server marked Connected](../../../assets/esphome-device-builder-successful-pairing.png) The line underneath tells you which ESPHome version the build server runs, and which one your builds will use. The two don't have to match. Device Builder installs whatever your sending dashboard is on and builds with that. diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md b/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md index 0b4d65fa38..8b86f60707 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md @@ -24,7 +24,7 @@ In the ESPHome Device Builder dashboard, click the 3 dots menu in the top right 1. You'll see a YAML file with one key per line. If you followed First Steps you should already see `wifi_ssid` and `wifi_password` here. -![](../../../assets/esphome-device-builder-click-secrets.gif) +![ESPHome Device Builder three-dot menu opening Secrets, which lists wifi_ssid, wifi_password, and the API key](../../../assets/esphome-device-builder-click-secrets.gif) --- @@ -66,7 +66,7 @@ The Device Builder can turn a value into a secret for you, no hand editing requi The Device Builder moves the key into secrets.yaml and swaps the device YAML over to a `!secret` reference. You can now share your device YAML without exposing the key. -![](../../../assets/device-builder-native-api-show-api-key.gif) +![Native API settings: revealing the encryption key, then Use secret, then Make secret](../../../assets/device-builder-native-api-show-api-key.gif) --- diff --git a/docs/products/air1/addons/adding-co2-to-air-1-mesh-case-design.md b/docs/products/air1/addons/adding-co2-to-air-1-mesh-case-design.md index 25acdf420e..e5cf448355 100755 --- a/docs/products/air1/addons/adding-co2-to-air-1-mesh-case-design.md +++ b/docs/products/air1/addons/adding-co2-to-air-1-mesh-case-design.md @@ -6,7 +6,7 @@ description: Adding The SCD40 CO₂ Sensor from Sensirion To The AIR-1. 1\. Unplug your AIR-1 from power and remove the back -![IMG_3790.jpeg](/assets/img-3790.jpeg) +![AIR-1 with the back removed, showing the empty CO2 connector at the bottom center of the board](/assets/img-3790.jpeg) 2\. At the bottom center there is a black connector. There is an x in the lower right corner of the connector @@ -14,6 +14,6 @@ description: Adding The SCD40 CO₂ Sensor from Sensirion To The AIR-1. 4\. Align the connector on the back of the CO2 module with the connector on the AIR-1. Once aligned, push down so the CO2 module fully seats itself -![IMG_3791.jpeg](/assets/img-3791.jpeg) +![AIR-1 board with the SCD40 CO2 module seated on the bottom center connector](/assets/img-3791.jpeg) 5\. Put your AIR-1 cover on. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module. \ No newline at end of file diff --git a/docs/products/air1/addons/adding-co2-to-air-1.md b/docs/products/air1/addons/adding-co2-to-air-1.md index bf82eeeee2..260ca6a9ae 100755 --- a/docs/products/air1/addons/adding-co2-to-air-1.md +++ b/docs/products/air1/addons/adding-co2-to-air-1.md @@ -10,34 +10,34 @@ description: Adding The SCD40 CO₂ Sensor from Sensirion To The AIR-1. 1\. Unplug your AIR-1 from power and lift the top of the case or "lid". -![](/assets/air-1-add-co2-pic-1.jpg)![](/assets/air-1-add-co2-pic-2.jpg)![](/assets/air-1-add-co2-pic-3.jpg) +![Closed AIR-1 case seen from the side before the lid is removed](/assets/air-1-add-co2-pic-1.jpg)![Pulling the top edge of the AIR-1 lid away from the case](/assets/air-1-add-co2-pic-2.jpg)![AIR-1 lid partly lifted away from the case, exposing the PCB](/assets/air-1-add-co2-pic-3.jpg) 2\. Remove the lid completely by grabbing the lid from the other side and gently lifting upwards. -![](/assets/air-1-add-co2-pic-4.jpg) +![Gripping the AIR-1 lid from the other side and lifting it off the case](/assets/air-1-add-co2-pic-4.jpg) 3\. Hold the PCB and orient it correctly where Apollo (the dog) is facing you in. -![](/assets/air-1-add-co2-pic-5.jpg) +![AIR-1 PCB on the removed lid with the Apollo dog artwork facing up, cabled to the SEN55](/assets/air-1-add-co2-pic-5.jpg) 4\. Gently slide the pcb out by sliding it to the left as shown in the images below. -![](/assets/air-1-add-co2-pic-6.jpg)![](/assets/air-1-add-co2-pic-7.jpg) +![Starting to slide the AIR-1 PCB to the left out of the lid](/assets/air-1-add-co2-pic-6.jpg)![AIR-1 PCB sliding further out of the lid, still cabled to the SEN55](/assets/air-1-add-co2-pic-7.jpg) 5\. Flip the PCB over and identify the bottom right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the SCD40 CO2 sensor. There is an X on the SCD40 sensor's PCB as well, you can see it in the image below but it is slightly cut off on the PCB itself. There is also a "gold dot" in the top left of the SCD40 when oriented properly. -![](/assets/air-1-add-co2-pic-8.jpg) +![Back of the AIR-1 PCB showing the black mezzanine connector with an X beside it](/assets/air-1-add-co2-pic-8.jpg) 6\. Gently push the SCD40 CO2 module onto the black mezzanine connector. -![](/assets/air-1-add-co2-pic-9-1.jpg) +![Pressing the SCD40 CO2 module onto the AIR-1 mezzanine connector](/assets/air-1-add-co2-pic-9-1.jpg) 7\. Gently slide the PCB back into the 3d printed case as shown below. -![](/assets/air-1-add-co2-pic-10.jpg)![](/assets/air-1-add-co2-pic-11.jpg) +![Sliding the AIR-1 PCB back into the rails of the 3D printed lid](/assets/air-1-add-co2-pic-10.jpg)![AIR-1 PCB seated back in the lid with the Apollo dog artwork showing](/assets/air-1-add-co2-pic-11.jpg) 8\. Gently push the case back together as shown below. -![](/assets/air-1-add-co2-pic-12.jpg)![](/assets/air-1-add-co2-pic-13.jpg)![](/assets/air-1-add-co2-pic-14.jpg) +![Pressing the AIR-1 lid back onto the case](/assets/air-1-add-co2-pic-12.jpg)![AIR-1 lid nearly closed against the case](/assets/air-1-add-co2-pic-13.jpg)![AIR-1 case fully closed again after adding the CO2 module](/assets/air-1-add-co2-pic-14.jpg) 9\. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module after installation. This is required for all CO2 addons purchased from us separately from a product (such as buying it to addon to an existing Apollo device). \ No newline at end of file diff --git a/docs/products/air1/addons/adding-gpio-header-to-air-1.md b/docs/products/air1/addons/adding-gpio-header-to-air-1.md index 8c95facd6b..df24502e58 100755 --- a/docs/products/air1/addons/adding-gpio-header-to-air-1.md +++ b/docs/products/air1/addons/adding-gpio-header-to-air-1.md @@ -6,35 +6,35 @@ description: Adding Optional GPIO Header to AIR-1. 1\. Unplug your AIR-1 from power and lift the top of the case or "lid". -![](/assets/air-1-add-co2-pic-1.jpg)![](/assets/air-1-add-co2-pic-2.jpg)![](/assets/air-1-add-co2-pic-3.jpg) +![Closed AIR-1 case seen from the side before the lid is removed](/assets/air-1-add-co2-pic-1.jpg)![Pulling the top edge of the AIR-1 lid away from the case](/assets/air-1-add-co2-pic-2.jpg)![AIR-1 lid partly lifted away from the case, exposing the PCB](/assets/air-1-add-co2-pic-3.jpg) 2\. Remove the lid completely by grabbing the lid from the other side and gently lifting upwards. -![](/assets/air-1-add-co2-pic-4.jpg) +![Gripping the AIR-1 lid from the other side and lifting it off the case](/assets/air-1-add-co2-pic-4.jpg) 3\. Hold the PCB and orient it correctly where Apollo (the dog) is facing you in. -![](/assets/air-1-add-co2-pic-5.jpg) +![AIR-1 PCB on the removed lid with the Apollo dog artwork facing up, cabled to the SEN55](/assets/air-1-add-co2-pic-5.jpg) 4\. Gently slide the pcb out by sliding it to the left as shown in the images below. -![](/assets/air-1-add-co2-pic-6.jpg)![](/assets/air-1-add-co2-pic-7.jpg) +![Starting to slide the AIR-1 PCB to the left out of the lid](/assets/air-1-add-co2-pic-6.jpg)![AIR-1 PCB sliding further out of the lid, still cabled to the SEN55](/assets/air-1-add-co2-pic-7.jpg) 5\. Flip the PCB over and identify the Top Right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the PCB of the GPIO Header. There is an X on the GPIO Header's PCB as well, you can see it in the images below -![](/assets/air-1-gpio-header-wiki-pic-1.webp)![](/assets/air-1-gpio-header-wiki-pic-2.webp) +![AIR-1 PCB in the case with a probe pointing at the X beside the mezzanine connector](/assets/air-1-gpio-header-wiki-pic-1.webp)![GPIO Header add-on board with a probe pointing at its X marking](/assets/air-1-gpio-header-wiki-pic-2.webp) 6\. Match up the X on the PCB of the GPIO Header and the X on the AIR-1 PCB and then gently push the GPIO Header onto the black mezzanine connector. -![](/assets/air-1-gpio-header-wiki-pic-3.webp)![](/assets/air-1-gpio-header-wiki-pic-4.webp)![](/assets/air-1-gpio-header-wiki-pic-5.webp) +![GPIO Header held over the AIR-1 PCB with both X marks lined up](/assets/air-1-gpio-header-wiki-pic-3.webp)![Pressing the GPIO Header onto the AIR-1 mezzanine connector](/assets/air-1-gpio-header-wiki-pic-4.webp)![GPIO Header seated on the AIR-1 PCB inside the case](/assets/air-1-gpio-header-wiki-pic-5.webp) 7\. Flip the AIR-1 PCB over and gently slide it back into the new AIR-1 Lid which came with your GPIO Header addon! Please do not use much force, the PCB should slide in relatively smoothly, with a tiny bit of force needed. There are three channels in the plastic where the PCB slides into! -![](/assets/air-1-gpio-header-wiki-pic-6.webp)![](/assets/air-1-gpio-header-wiki-pic-7.webp) +![Sliding the AIR-1 PCB into the new lid with the Apollo dog artwork facing out](/assets/air-1-gpio-header-wiki-pic-6.webp)![AIR-1 PCB seated in the new lid, still cabled to the SEN55](/assets/air-1-gpio-header-wiki-pic-7.webp) 8\. Gently push the case back together as shown below. -![](/assets/air-1-gpio-header-wiki-pic-8.webp)![](/assets/air-1-gpio-header-wiki-pic-9.webp)![](/assets/air-1-gpio-header-wiki-pic-10.webp) +![Lowering the new lid onto the AIR-1 case with the GPIO Header lined up](/assets/air-1-gpio-header-wiki-pic-8.webp)![AIR-1 lid closing with the GPIO Header socket fitting through its opening](/assets/air-1-gpio-header-wiki-pic-9.webp)![Closed AIR-1 case with the GPIO Header socket exposed in the lid](/assets/air-1-gpio-header-wiki-pic-10.webp) 9\. You are now done and your AIR-1 is now able to be used with the GPIO Header addon! Here is the pinout image below and here's a great wiki article showing you how to add a small led strip! @@ -42,4 +42,4 @@ description: Adding Optional GPIO Header to AIR-1. If you plan to use a lot of leds or your gpio project requires a lot of power then you need to use a dedicated power supply and not try to use too much power (under 350mA) from the GPIO of the device! You can power the AIR-1 via the vcc (5v) and GND pins but please do not power it via the pins AND the USB-C port, it should be one or the other. -![](/assets/gpio-header-pinout.webp) \ No newline at end of file +![AIR-1 GPIO Header pinout. Left: GND, IO18, IO19, IO4, IO2, IO6. Right: 5V, IO7, SDA IO1, SCL IO0, GND, 3V](/assets/gpio-header-pinout.webp) \ No newline at end of file diff --git a/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md b/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md index 3d3ede92a3..e8e5ff2154 100755 --- a/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md +++ b/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md @@ -5,6 +5,6 @@ description: "Calibrate the AIR-1 temperature reading from its SEN55 to your roo ##### The AIR-1 uses the SEN55 for its temperature reading. Calibrating it to your environment is very similar to the MSR-1. See the link below for the temperature calibration guide. -![AIR-1 Temperature Offset.png](/assets/air-1-temperature-offset.png) +![AIR-1 device page in Home Assistant with the SEN55 temperature offset set to 5.0 °C and circled](/assets/air-1-temperature-offset.png) -![AIR-1 Temperature Offset 2.png](/assets/air-1-temperature-offset-2.png) \ No newline at end of file +![AIR-1 Configuration card close-up with the SEN55 Temperature Offset field set to 5.0 °C](/assets/air-1-temperature-offset-2.png) \ No newline at end of file diff --git a/docs/products/air1/examples/air1-dashboard-examples.md b/docs/products/air1/examples/air1-dashboard-examples.md index 41fe129dd2..14fe074c8c 100755 --- a/docs/products/air1/examples/air1-dashboard-examples.md +++ b/docs/products/air1/examples/air1-dashboard-examples.md @@ -6,7 +6,7 @@ description: AIR-1 Home Assistant Dashboard Examples Really neat dashboard for your AIR-1 by user "keex"! -![](/assets/air-1-keex-dashboard-image-1-1.png) +![Home Assistant dashboard by keex with AIR-1 particulate matter and air quality charts for two rooms](/assets/air-1-keex-dashboard-image-1-1.png) [https://community.home-assistant.io/t/apollo-air-1-dashboard/785311](https://community.home-assistant.io/t/apollo-air-1-dashboard/785311) @@ -14,7 +14,7 @@ Really neat dashboard for your AIR-1 by user "keex"! ##### Home Assistant Sensor -![CO 2 Graph.png](/assets/co-2-graph.png) +![Home Assistant sensor card showing a 24-hour Bedroom CO2 line graph at 1,000 ppm](/assets/co-2-graph.png) ```yaml graph: line @@ -27,7 +27,7 @@ hours_to_show: 24 #### Custom: Apexcharts Card -![](/assets/air-1-suggestions-co2-smarthomesellout.png) +![ApexCharts card showing 10-minute average CO2 levels for five rooms in Home Assistant](/assets/air-1-suggestions-co2-smarthomesellout.png) ```yaml type: custom:apexcharts-card @@ -159,7 +159,7 @@ series: ##### Custom: Plotly Graph Card -![Plotly CO2 Graph.png](/assets/plotly-co2-graph.png) +![Plotly Graph card showing 24 hours of Bedroom CO2 readings in ppm](/assets/plotly-co2-graph.png) ```plaintext type: custom:plotly-graph @@ -172,7 +172,7 @@ title: Bedroom CO2 ##### Home Assistant Guage -![CO2 Guage.png](/assets/co2-guage.png) +![Home Assistant needle gauge card showing MSR-1 CO2 at 1,063 ppm with green, yellow, and red ranges](/assets/co2-guage.png) ```plaintext type: gauge @@ -191,7 +191,7 @@ severity: ##### Home Assistant Sensor -![AIR-1 VOC HA Sensor.png](/assets/air-1-voc-ha-sensor.png) +![Home Assistant sensor card showing an AIR-1 SEN55 VOC line graph at 446](/assets/air-1-voc-ha-sensor.png) ``` graph: line @@ -204,7 +204,7 @@ name: Basement VOC ##### Custom: Plotly Graph Card -![AIR-1 VOC Plotly.png](/assets/air-1-voc-plotly.png) +![Plotly Graph card showing 24 hours of Basement VOC readings from the AIR-1](/assets/air-1-voc-plotly.png) ``` type: custom:plotly-graph @@ -217,7 +217,7 @@ title: Basement VOC ##### Home Assistant Guage -![AIR-1 VOC HA Guage.png](/assets/air-1-voc-ha-guage.png) +![Home Assistant needle gauge card showing a Basement VOC reading of 457](/assets/air-1-voc-ha-guage.png) ``` type: gauge diff --git a/docs/products/air1/examples/firstof9's-apex-charts.md b/docs/products/air1/examples/firstof9's-apex-charts.md index 2435d87fbc..81f0c53213 100755 --- a/docs/products/air1/examples/firstof9's-apex-charts.md +++ b/docs/products/air1/examples/firstof9's-apex-charts.md @@ -10,19 +10,19 @@ Firstof9 has created this beautiful responsive dashboard with [Apexcharts-card]( The colors will change as severity levels change for each of the sensors below. -![firstof9-dash-image-full.png](/assets/firstof9-dash-image-full.png) +![Firstof9 AIR-1 dashboard with color-coded CO2, VOC, NOx, PM, and gas history charts](/assets/firstof9-dash-image-full.png) This guide assumes you already have HACS installed. If you do not, please first [install HACS](https://hacs.xyz/docs/use/download/prerequisites/ "Install HACS"). First, you need to install apexcharts-card by going to the HACS tab and searching "apexcharts-card". -![image.png](/assets/xpUimage.png) +![HACS search results showing the apexcharts-card repository](/assets/xpUimage.png) Once downloaded, it is ready to be used for dashboards! Next, you need to edit the dashboards here. -![image.png](/assets/fBWimage.png) +![Home Assistant dashboard with the pencil edit icon circled in the top right](/assets/fBWimage.png) !!! danger "WARNING YOU ARE ABOUT TO BE ABLE TO WIPE OUT ALL YOUR DASHBOARDS PROCEED WITH CAUTION." @@ -30,21 +30,21 @@ Next, you need to edit the dashboards here. Now choose "raw configuration editor" -![image.png](/assets/EWyimage.png) +![Dashboard three-dot menu open with Raw configuration editor highlighted](/assets/EWyimage.png) Now you need to be VERY careful. You are editing all of your dashboards but we can avoid issues by scrolling to the very bottom and then copying and pasting the code seen below. (Picture below shows where we will paste the code) (Code below) -![AIR-1 Dashboard End.png](/assets/air-1-dashboard-end.png) +![Raw configuration editor scrolled to the empty last line where the code gets pasted](/assets/air-1-dashboard-end.png) **Be sure to change the entity ID to match your device or else the card will not work.** You can find your entity ID by going to the ESPHome Device Builder and selecting the Edit option. -![AIR-1 ID.png](/assets/air-1-id.png) +![ESPHome Device Builder AIR-1 YAML with the device name line circled](/assets/air-1-id.png) The easiest way to change all of the entity IDs in the code is by using AI (ChatGPT etc.) or by using a code editor like Visual Studio Code (VSC). In VSC you can Find (ctrl+f) the old ID and Replace (select the small arrow to toggle open the Replace box) it with your ID. Now you are ready to copy the code into the Raw configurator editor. (See code below) VSC Find/Replace -![AIR-1 Find and Replace.png](/assets/OQfair-1-find-and-replace.png) +![VS Code Find and Replace box swapping the example AIR-1 entity ID for your own](/assets/OQfair-1-find-and-replace.png) **This is the code!** @@ -491,14 +491,14 @@ VSC Find/Replace Now click save in the top right and remember to not hit any buttons or make any other edits before saving! -![image.png](/assets/jAwimage.png) +![Raw configuration editor with the Save button circled in the top right](/assets/jAwimage.png) Finally hit "done" in the top right. -![image.png](/assets/h9Iimage.png) +![Dashboard edit mode with the Done button circled in the top right](/assets/h9Iimage.png) Hit F5 on your keyboard or refresh your browser and then look for your new "Air Icon" as a new dashboard option and click on it! -![image.png](/assets/ssaimage.png) +![Home Assistant dashboard tabs with the new air quality dashboard icon circled](/assets/ssaimage.png) Lastly, we do want to thank [firstof9](https://github.com/firstof9 "Thank firstof9") for creating this dashboard and sharing it. \ No newline at end of file diff --git a/docs/products/air1/setup/general-tips.md b/docs/products/air1/setup/general-tips.md index 10b223ca9a..9e883b4332 100755 --- a/docs/products/air1/setup/general-tips.md +++ b/docs/products/air1/setup/general-tips.md @@ -152,11 +152,11 @@ The latest AIR-1 firmware keeps the SCD40 calibrated automatically. The sensor a If your AIR-1 sits in a space that rarely gets fresh air (a sealed office, a basement, a grow room), automatic self-calibration will slowly drag the CO2 readings down. Turn off the **CO2 Auto Calibration** switch on the device page and follow the [manual calibration guide](../../general/calibrating-and-updating/co2-calibration.md) every 1 to 2 years instead. -![](/assets/co2-levels-drop-after-hvac-on.png) +![CO2 chart showing levels dropping overnight after the HVAC turns on](/assets/co2-levels-drop-after-hvac-on.png) Wisconsin Department of Health CO2 Level Chart -![CO2 Health Department.png](/assets/air-1-co2-calibration-image-6.jpg) +![Wisconsin health department list of CO2 levels and health effects from 400 to 40,000 ppm](/assets/air-1-co2-calibration-image-6.jpg) !!! tip "We suggest triggering alert automations, hvac or a fan turning on, etc when CO2 is over 1000" diff --git a/docs/products/air1/troubleshooting/air1-boot-mode.md b/docs/products/air1/troubleshooting/air1-boot-mode.md index d896c384f4..9a88d2506d 100755 --- a/docs/products/air1/troubleshooting/air1-boot-mode.md +++ b/docs/products/air1/troubleshooting/air1-boot-mode.md @@ -12,7 +12,7 @@ description: Step by step guide for putting The AIR-1 In Boot Mode. 1\. Position the AIR-1 so that the USB-C port is facing you. On the left side of the USB-C port, locate a small opening to press the boot button (the right button). -![](/assets/air-1-boot-button.jpg) +![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\. 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 AIR-1 then let go of the button. @@ -26,6 +26,6 @@ description: Step by step guide for putting The AIR-1 In Boot Mode. 3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button. -![](/assets/air-1-reset-boot-buttons-arrows.jpg) +![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) 4\. Continue with uploading the firmware document. \ No newline at end of file diff --git a/docs/products/air1/troubleshooting/air1-code.md b/docs/products/air1/troubleshooting/air1-code.md index b764dc22dd..7c42086a17 100755 --- a/docs/products/air1/troubleshooting/air1-code.md +++ b/docs/products/air1/troubleshooting/air1-code.md @@ -12,29 +12,29 @@ If your device has already been connected to Home Assistant please Put your device in boot mode by holding down the boot button and then plugging in the USB cable. 1. Position the AIR-1 so that the USB-C port is facing you. On the left side of the USB-C port, locate a small opening to press the boot button (the right button). -![](/assets/air-1-boot-button.jpg) +![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 our installer page and click connect under Battery Firmware Apollo AIR-1 Installer. 3\. Click the big "Connect" button. -![](/assets/air-1-reflash-pic-1.png) +![Apollo AIR-1 Installer page with the Connect button highlighted](/assets/air-1-reflash-pic-1.png) 4\. Select the open com port then click Connect. -![](/assets/air-1-reflash-pic-2-1.png) +![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 ApolloAutomation.AIR-1". -![](/assets/air-1-reflash-pic-3.png) +![Installer Device Dashboard with the Install AIR-1 option highlighted](/assets/air-1-reflash-pic-3.png) 6\. Click "INSTALL". -![](/assets/air-1-reflash-pic-4.png) +![Install AIR-1 confirmation dialog with the Install button highlighted](/assets/air-1-reflash-pic-4.png) 7\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/air-1-reflash-pic-5.png) +![Installation complete message with the Next button highlighted](/assets/air-1-reflash-pic-5.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md b/docs/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md index 30ef052e8e..6c9299ba09 100755 --- a/docs/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md +++ b/docs/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md @@ -8,7 +8,7 @@ description: Step by step guide for resetting the Wi-Fi Credentials on your AIR- 2\. Press and hold the Boot button for 10 seconds. -![](/assets/air-1-boot-button.jpg) +![Tool pointing to the AIR-1 boot button, the right of two buttons beside the USB-C port](/assets/air-1-boot-button.jpg) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/products/apolloodroid/getting-started.md b/docs/products/apolloodroid/getting-started.md index cdf2fce7c4..17751d9985 100755 --- a/docs/products/apolloodroid/getting-started.md +++ b/docs/products/apolloodroid/getting-started.md @@ -17,13 +17,13 @@ This guide will walk you through setting up your Apollo Home Assistant hub aka t If you'd prefer, you can go into your router and find the IP address that your Odroid received and use the IP address with port 8123 at the end such as: http://192.168.1.30:8123 -![Screenshot 2024-06-14 at 2.42.08 PM.png](/assets/screenshot-2024-06-14-at-2-42-08-pm.png) +![UniFi Network client list showing the Odroid homeassistant device with its IP address highlighted](/assets/screenshot-2024-06-14-at-2-42-08-pm.png) -![Screenshot 2024-06-14 at 2.44.04 PM.png](/assets/screenshot-2024-06-14-at-2-44-04-pm.png) +![Home Assistant Welcome screen opened at the hub IP address on port 8123](/assets/screenshot-2024-06-14-at-2-44-04-pm.png) 4\. Click on "Create My Smart Home" and wait for the Home Assistant installer to finish. -![Screenshot 2024-06-14 at 2.42.41 PM.png](/assets/screenshot-2024-06-14-at-2-42-41-pm.png) +![Home Assistant onboarding screen showing Preparing Home Assistant with a progress bar](/assets/screenshot-2024-06-14-at-2-42-41-pm.png) 5\. Now that you've got Home Assistant running, your Apollo Automation devices are ready to use! diff --git a/docs/products/apolloodroid/introduction.md b/docs/products/apolloodroid/introduction.md index 3db4919537..fdfe50b231 100755 --- a/docs/products/apolloodroid/introduction.md +++ b/docs/products/apolloodroid/introduction.md @@ -2,7 +2,7 @@ title: Apollo Odroid Introduction description: The Apollo Odroid is a ready-to-use device designed to kickstart your smart home journey with ease. --- -![](/assets/apolloautomation-finals-15.jpg) +![Apollo Odroid in its white ventilated case sitting on a stone tray](/assets/apolloautomation-finals-15.jpg) The Apollo Odroid is a ready-to-use device designed to kickstart your smart home journey with ease. Built on the powerful ODROID-M1S platform with 8GB of RAM and 64GB of onboard eMMC storage, this unit comes pre-flashed with Home Assistant OS. This means that from the moment you unbox it, you can dive right into automating your home without any complex setup or flashing processes. diff --git a/docs/products/breakout-boards/scd40-breakout-board/introduction.md b/docs/products/breakout-boards/scd40-breakout-board/introduction.md index d61f4f08d0..e0ca2d5cad 100755 --- a/docs/products/breakout-boards/scd40-breakout-board/introduction.md +++ b/docs/products/breakout-boards/scd40-breakout-board/introduction.md @@ -2,13 +2,13 @@ title: Apollo SCD40 Breakout Board Introduction description: Apollo SCD40 Breakout Board Introduction --- -![](/assets/scd40-breakout-board.png) +![Apollo SCD40 breakout board on a blue PCB with a loose 5-pin header](/assets/scd40-breakout-board.png) The **SCD40 Breakout Board** is a compact PCB kit featuring the SCD40, making it easy to add CO2 monitoring to any new or existing project. Please go to this website and copy the randomly generated API key inside the code block as shown below then paste it in the code below where you see "use-a-randomly-generated-key-here". -![](/assets/api-key-example.png) +![ESPHome API docs page showing a randomly generated encryption key](/assets/api-key-example.png) **GPIO Pins Listed:** diff --git a/docs/products/breakout-boards/sen55-scd40-breakout-board/introduction.md b/docs/products/breakout-boards/sen55-scd40-breakout-board/introduction.md index 6e71912583..35601aebc6 100755 --- a/docs/products/breakout-boards/sen55-scd40-breakout-board/introduction.md +++ b/docs/products/breakout-boards/sen55-scd40-breakout-board/introduction.md @@ -2,13 +2,13 @@ title: Apollo SEN55 and SCD40 Breakout Board Introduction description: Apollo SEN55 and SCD40 Breakout Board Introduction --- -![](/assets/sen55-sdc40-breakout-board.png) +![Apollo SEN55 and SCD40 breakout board wired to a Sensirion SEN55 sensor, with a 5-pin header](/assets/sen55-sdc40-breakout-board.png) The **SEN55 and SCD40 Breakout Board** is a compact PCB kit featuring the SEN55 sensor and an optional SCD40, making it easy to add high-quality air monitoring to any new or existing project. Please go to this website and copy the randomly generated API key inside the code block as shown below then paste it in the code below where you see "use-a-randomly-generated-key-here". -![](/assets/api-key-example.png) +![ESPHome API docs page showing a randomly generated encryption key](/assets/api-key-example.png) **GPIO Pins Listed:** diff --git a/docs/products/btn1/examples/blueprint.md b/docs/products/btn1/examples/blueprint.md index 4c1f76a644..d4c7c5c695 100755 --- a/docs/products/btn1/examples/blueprint.md +++ b/docs/products/btn1/examples/blueprint.md @@ -14,15 +14,15 @@ description: >- 2\. Click **Preview** then click **Import blueprint**. -![](/assets/btn-1-blueprint-auto-import.gif) +![Home Assistant Import a blueprint dialog for the BTN-1 blueprint, clicking Preview then Import blueprint](/assets/btn-1-blueprint-auto-import.gif) 3\. Click on **Apollo Automation BTN-1 Blueprint** and click on **Select a device** then choose your **Apollo BTN-1** from the dropdown menu. -![](/assets/btn-1-blueprint-select-btn-1.gif) +![Choosing an Apollo BTN-1 from the Select a device dropdown in the BTN-1 blueprint](/assets/btn-1-blueprint-select-btn-1.gif) 4\. For the **Single Click** event, click **Add Action**, then search for **Light: Toggle** and select it. Next, choose the entity you want to control, such as **BTN-1 Light**, and click **Save**. Name your automation something like **Apollo BTN-1 Blueprint**. You can repeat this process for **Double Click**, **Triple Click**, and **Hold** events. -![](/assets/btn-1-blueprint-single-click-example.gif) +![Adding a Light Toggle action to Button 1 Single Click in the BTN-1 blueprint, then saving it](/assets/btn-1-blueprint-single-click-example.gif) !!! success "You can do this for all four buttons all in one blueprint!" @@ -34,19 +34,19 @@ description: >- 1\. Head to the automations page and click on **Blueprints** in the top right then select **Import Blueprint**. -![](/assets/btn-1-blueprint-manual-import.gif) +![Opening the Home Assistant Blueprints tab under Automations and scenes and clicking Import blueprint](/assets/btn-1-blueprint-manual-import.gif) 2\. Copy this link and paste it into the **Blueprint address** box and click **Preview** then click **Import blueprint**. -![](/assets/btn-1-blueprint-auto-import.gif) +![Home Assistant Import a blueprint dialog for the BTN-1 blueprint, clicking Preview then Import blueprint](/assets/btn-1-blueprint-auto-import.gif) 3\. Click on **Apollo Automation BTN-1 Blueprint** and click on **Select a device** then choose your **Apollo BTN-1** from the dropdown menu. -![](/assets/btn-1-blueprint-select-btn-1.gif) +![Choosing an Apollo BTN-1 from the Select a device dropdown in the BTN-1 blueprint](/assets/btn-1-blueprint-select-btn-1.gif) 3\. For the **Single Click** event, click **Add Action**, then search for **Light: Toggle** and select it. Next, choose the entity you want to control, such as **BTN-1 Light**, and click **Save**. Name your automation something like **Apollo BTN-1 Blueprint**. You can repeat this process for **Double Click**, **Triple Click**, and **Hold** events. -![](/assets/btn-1-blueprint-single-click-example.gif) +![Adding a Light Toggle action to Button 1 Single Click in the BTN-1 blueprint, then saving it](/assets/btn-1-blueprint-single-click-example.gif) !!! success "You can do this for all four buttons all in one blueprint!" diff --git a/docs/products/btn1/examples/example-automation.md b/docs/products/btn1/examples/example-automation.md index 9db477d129..6fa1c3d9cb 100755 --- a/docs/products/btn1/examples/example-automation.md +++ b/docs/products/btn1/examples/example-automation.md @@ -8,11 +8,11 @@ description: Example of how to use the BTN-1 Events to create an automation in H 2\. Click on **Add trigger** then select **Entity** and then **State**. Then search for your btn-1 and select the btn-1 event. Then select the **Event Type** attribute and select **Single Click** in the box labeled **To**. -![](/assets/btn-1-example-gif-1.gif) +![Creating a Home Assistant automation with a State trigger on the BTN-1 Button 1 event set to Single Click](/assets/btn-1-example-gif-1.gif) 3\. Next click on **Add action** and search **Light: Toggle** and select it. Then choose your entity to turn on such as btn-1 light. Check the box next to Brightness and type in 100 then click Save and name your automation. -![](/assets/btn-1-example-gif-2.gif) +![Adding a Light Toggle action for a BTN-1 light with brightness set, then saving the automation](/assets/btn-1-example-gif-2.gif) 4\. Your automation is now live. Click the button 1 button and it should toggle whatever light you selected in the automation! diff --git a/docs/products/btn1/setup/general-tips.md b/docs/products/btn1/setup/general-tips.md index 8de126e9b2..ab45910745 100755 --- a/docs/products/btn1/setup/general-tips.md +++ b/docs/products/btn1/setup/general-tips.md @@ -8,7 +8,7 @@ description: BTN-1 General Tips Your BTN-1 comes with two sets of 4 sticky pads or feet to stick on the bottom of the BTN-1 itself or on the optional BTN-1 Mount addon. These are great for just setting the device on your desk! -![](/assets/btn-1-general-tips-sticky-pads.webp) +![Peeling clear sticky pads and pressing them onto the four corners of the BTN-1 bottom](/assets/btn-1-general-tips-sticky-pads.webp) ### Mounting @@ -16,16 +16,16 @@ The BTN-1 with the stand addon allows you to mount the device using M3 screws to ###### **Under Desk** -![](/assets/btn-1-general-tips-under-desk-mount.jpg) +![BTN-1 in its mount attached to the underside of a desk](/assets/btn-1-general-tips-under-desk-mount.jpg) ###### Desk Mount I used a block of wood instead of mounting it directly to my desk in this example. -![](/assets/btn-1-general-tips-desk-mount.webp) +![BTN-1 sliding into its mount screwed to a wooden block on a desk](/assets/btn-1-general-tips-desk-mount.webp) ###### **Magnetic Mounting** -![](/assets/btn-1-general-tips-magnetic-mounting.webp) +![Placing the BTN-1 against a metal surface, where it holds in place magnetically](/assets/btn-1-general-tips-magnetic-mounting.webp)   \ No newline at end of file diff --git a/docs/products/btn1/setup/getting-started.md b/docs/products/btn1/setup/getting-started.md index e01ced341e..81db3961bd 100755 --- a/docs/products/btn1/setup/getting-started.md +++ b/docs/products/btn1/setup/getting-started.md @@ -12,19 +12,19 @@ This will guide you through adding on switches and keycaps to your BTN-1 then ad Line up the two gold pins with the holes on your BTN-1, then press down gently. Be careful, as the pins can bend or get damaged if too much force is used. -![](/assets/btn-1-install-switches-gif.webp) +![Pressing brown switches into the four sockets on the BTN-1 circuit board](/assets/btn-1-install-switches-gif.webp) ###### Installing Keycaps Line up the + on the keycap with the + on the top of the switch you installed. It may require a little pressure, but it should press on smoothly. Once placed, lightly tap to ensure the keycap is fully seated. -![](/assets/btn-1-getting-started-installing-keycaps-gif.webp) +![Pressing white keycaps onto the four switches of the BTN-1](/assets/btn-1-getting-started-installing-keycaps-gif.webp) ###### Flip Power Switch Only the battery version has a power switch. If yours has one, ensure it's **turned on**. With the device on its side, flipping the switch **away from you** turns it **on**, and flipping it **toward you** turns it **off**. -![](/assets/btn-1-flip-power-switch-on.webp) +![Sliding the BTN-1 power switch on the side of the case to the on position](/assets/btn-1-flip-power-switch-on.webp) ### Connecting Through Hotspot @@ -40,13 +40,13 @@ To connect through the sensor's onboard hotspot follow the below: 2\. On your phone or PC, open the WiFi settings and connect to "Apollo BTN-1 Hotspot". -![](/assets/btn-1-reset-wifi-screenshot.png) +![Phone Wi-Fi settings listing the BTN-1 hotspot network to join](/assets/btn-1-reset-wifi-screenshot.png) 3\. Once connected it should automatically open a dashboard for your sensor. If this does not automatically open the dashboard, please open your web browser and go to [http://192.168.4.1](http://192.168.4.1) 4\. Select the Wi-Fi network that you would like your sensor to connect to or scroll to the bottom and type in your Wi-Fi network then click "**Save**". -![](/assets/btn-1-getting-started-enter-wifi-details-hotspot.png) +![BTN-1 hotspot page at 192.168.4.1 with the SSID and password fields and Save button highlighted](/assets/btn-1-getting-started-enter-wifi-details-hotspot.png) !!! tip "Tip for Mesh Wi-Fi systems or multiple Access Points" @@ -64,15 +64,15 @@ To connect through the sensor's onboard hotspot follow the below: 1\. Navigate to settings -> integrations then click the "**ADD**" button below your new Apollo device then click **Submit**. -![](/assets/btn-1-improv-ble-add.gif) +![Adding the discovered BTN-1 with Improv via BLE on the Home Assistant integrations page](/assets/btn-1-improv-ble-add.gif) 2\. Once prompted, type in your Wi-Fi name and password in the two fields then click **Submit**. Click on **Close** once it finishes. -![](/assets/btn-1-improv-ble-wifi-setup.gif) +![Entering Wi-Fi credentials in the Improv via BLE dialog for the BTN-1 and closing on success](/assets/btn-1-improv-ble-wifi-setup.gif) 3\. Click on **Add** then click on **Submit**. Choose an area and then click **Finish**. -![](/assets/btn-1-improv-ble-esphome-integration.gif) +![Adding the BTN-1 to the ESPHome integration, choosing an area, and clicking Finish](/assets/btn-1-improv-ble-esphome-integration.gif) 4\. Your device is now added to your Wi-Fi and added to the ESPHome Integration in Home Assistant. You should now be ready to setup a blueprint and start using your BTN-1! @@ -86,7 +86,7 @@ You can add the ESPHome Device Builder app in Home Assistant to easily update yo Make sure to fill out your Wi-Fi details in the **secrets** section by clicking on the **secrets** button. -![](/assets/esphome-device-builder-secrets.png) +![ESPHome Device Builder dashboard with the cursor on the Secrets button in the top right](/assets/esphome-device-builder-secrets.png) ```yaml # Your Wi-Fi SSID and password - keep the quotes and just replace the name and password between the quotes! @@ -96,15 +96,15 @@ wifi_password: "your-wifi-pass-here" 1\. Open the ESPHome Device Builder dashboard. -![](/assets/esphome-device-builder-show-discovered-device.png) +![ESPHome Device Builder banner reading Discovered 1 device with the Show button on the right](/assets/esphome-device-builder-show-discovered-device.png) 2\. Click **Show** in the top right to show your discovered devices then click on **Take Control** then click **Install**. This can take multiple minutes or longer on low-end hardware. -![](/assets/btn-1-getting-started-take-control-gif.gif) +![Clicking Take Control on the discovered BTN-1 in ESPHome Device Builder, then Install](/assets/btn-1-getting-started-take-control-gif.gif) 3\. Once you see "**INFO OTA successful**" you are done. Click "**STOP**" to exit. -![](/assets/btn-1-getting-started-ota-successful.png) +![ESPHome Device Builder install log for the BTN-1 ending with INFO OTA successful](/assets/btn-1-getting-started-ota-successful.png) 4\. Your new device is now adopted into the ESPHome Device Builder and you can move on to Integrating with Home Assistant via the ESPHome Integration below! @@ -112,7 +112,7 @@ wifi_password: "your-wifi-pass-here" 1\. Head to the ESPHome Integration then click on **Add** then click **Submit**. When prompted click **Finish** then give it a location and click **Finish** or click **Skip and Finish**. -![](/assets/btn-1-getting-started-esphome-integration-gif.gif) +![Adding the discovered BTN-1 from the ESPHome integration page, setting an area, and opening its device page](/assets/btn-1-getting-started-esphome-integration-gif.gif) 2\. Your device is now added to home assistant via the ESPHome integration, and you can easily navigate to it by going to settings -> ESPHome integration -> click on the name of your new device! diff --git a/docs/products/btn1/troubleshooting/btn1-boot-mode.md b/docs/products/btn1/troubleshooting/btn1-boot-mode.md index 8bfb619098..58b2cd2f6b 100755 --- a/docs/products/btn1/troubleshooting/btn1-boot-mode.md +++ b/docs/products/btn1/troubleshooting/btn1-boot-mode.md @@ -18,7 +18,7 @@ description: Step by step guide for putting The BTN-1 In Boot Mode. 2\. Disconnect power from your BTN-1, then hold the right (boot) button while plugging in a USB-C data cable to the BTN-1. Once connected, release the button. -![](/assets/btn-1-boot-mode-method-1.webp) +![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! @@ -28,15 +28,15 @@ description: Step by step guide for putting The BTN-1 In Boot Mode. 1\. Plug in a USB cable that supports power and data into your computer and connect the other end to your BTN-1. -![](/assets/btn-1-plug-in-usb-c.webp) +![Plugging a USB-C cable into the port on the back of the BTN-1](/assets/btn-1-plug-in-usb-c.webp) 2\. With the device facing you, locate the reset (left) and boot (right) buttons. -![](/assets/btn-1-reset-boot-buttons.png) +![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. -![](/assets/btn-1-boot-mode-method-2.webp) +![Holding the BTN-1 boot button while pressing and releasing the reset button](/assets/btn-1-boot-mode-method-2.webp) 3\. You are now ready to reflash your device! diff --git a/docs/products/btn1/troubleshooting/btn1-reflash.md b/docs/products/btn1/troubleshooting/btn1-reflash.md index 0900ffd175..380fbf4ab0 100755 --- a/docs/products/btn1/troubleshooting/btn1-reflash.md +++ b/docs/products/btn1/troubleshooting/btn1-reflash.md @@ -10,27 +10,27 @@ description: Step by step guide for reflashing The BTN-1. 1\. Plug in a USB cable that supports power and data into your computer and connect the other end to your BTN-1. -![](/assets/btn-1-plug-in-usb-c.webp) +![Plugging a USB-C cable into the port on the back of the BTN-1](/assets/btn-1-plug-in-usb-c.webp) 2\. With the device facing you, locate the reset (left) and boot (right) buttons. -![](/assets/btn-1-reset-boot-buttons.png) +![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. -![](/assets/btn-1-boot-mode-method-2.webp) +![Holding the BTN-1 boot button while pressing and releasing the reset button](/assets/btn-1-boot-mode-method-2.webp) 4\. Navigate to our installer page using a chromium based browser such as Chrome or Edge and click **connect** under Apollo BTN-1 Installer. Select the open com port and click **connect**. -![](/assets/btn-1-reflash-installer-connect.gif) +![Apollo BTN-1 Installer page, clicking Connect and choosing the USB JTAG serial port](/assets/btn-1-reflash-installer-connect.gif) 5\. Click Install **BTN-1** then click **Install** again. -![](/assets/btn-1-reflash-install.gif) +![Clicking Install ApolloAutomation.BTN-1 in the Device Dashboard, then Install to confirm](/assets/btn-1-reflash-install.gif) 6\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/pump-1-reflash-install-complete.png) +![Web installer showing Installation complete with the Next button](/assets/pump-1-reflash-install-complete.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md b/docs/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md index 09e50f79ee..1deb6465c7 100755 --- a/docs/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md +++ b/docs/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md @@ -6,11 +6,11 @@ description: Step by step guide for resetting the Wi-Fi Credentials on your BTN- 1\. Plug the BTN-1 into power. -![](/assets/btn-1-plug-in-usb-c.webp) +![Plugging a USB-C cable into the port on the back of the BTN-1](/assets/btn-1-plug-in-usb-c.webp) 2\. Long press the Boot button (the button on the right) for 10 seconds. -![](/assets/btn-1-reset-boot-buttons.png) +![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\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/products/btn1/troubleshooting/btn1-teardown.md b/docs/products/btn1/troubleshooting/btn1-teardown.md index 9e6790132c..8004125a26 100755 --- a/docs/products/btn1/troubleshooting/btn1-teardown.md +++ b/docs/products/btn1/troubleshooting/btn1-teardown.md @@ -14,34 +14,34 @@ description: >- 1\. Flip the battery switch towards you to the off position. Users with no battery skip to step 2. -![](/assets/btn-1-flip-power-switch-off.webp) +![Sliding the BTN-1 battery power switch on the side of the case to the off position](/assets/btn-1-flip-power-switch-off.webp) 2\. With the BTN-1 USB-C port facing upwards, unplug the USB-C cable and remove the lid. -![](/assets/btn-1-remove-usb-c-lift-lid.webp) +![Unplugging the USB-C cable and prying the lid off the BTN-1 case with a pick](/assets/btn-1-remove-usb-c-lift-lid.webp) 3\. Gently lift the BTN-1 green PCB out of the device at an angle so the buttons clear the case easier. -![](/assets/btn-1-remove-pcb.webp) +![Lifting the BTN-1 circuit board out of the case at an angle, exposing the battery](/assets/btn-1-remove-pcb.webp) 4\. Remove the 2-pin JST connector and remove the battery. -![](/assets/btn-1-unplug-jst.webp) +![Unplugging the 2-pin JST battery connector from the BTN-1 circuit board](/assets/btn-1-unplug-jst.webp) ###### Reassembly 1\. Re-attach the 2-pin JST connector and place the battery writing side down with the wires on the left side of the case. -![](/assets/btn-1-plug-in-jst.webp) +![Plugging the 2-pin JST battery connector back into the BTN-1 circuit board](/assets/btn-1-plug-in-jst.webp) 2\. Gently place the BTN-1 green PCB back in the case at an angle so the buttons will slide into cutout in the case. -![](/assets/btn-1-replace-pcb.webp) +![Lowering the BTN-1 circuit board back into the case at an angle over the battery](/assets/btn-1-replace-pcb.webp) 3\. Line up the lid of the case with the holes for the rgb leds then gently press down to snap it into place. -![](/assets/btn-1-replace-lid.webp) +![Pressing the BTN-1 lid down over the keycaps until it snaps into place](/assets/btn-1-replace-lid.webp) 4\. Flip the power switch back on. -![](/assets/btn-1-flip-power-switch-on.webp) \ No newline at end of file +![Sliding the BTN-1 power switch on the side of the case to the on position](/assets/btn-1-flip-power-switch-on.webp) \ No newline at end of file diff --git a/docs/products/cast1/additional-info/esphome-device-builder.md b/docs/products/cast1/additional-info/esphome-device-builder.md index 56e8c41789..a131cdf517 100644 --- a/docs/products/cast1/additional-info/esphome-device-builder.md +++ b/docs/products/cast1/additional-info/esphome-device-builder.md @@ -25,7 +25,7 @@ Pick the platform you'll be running ESPHome Device Builder on: If a blue **Windows protected your PC** warning appears when you open the `.exe`, click **More info → Run anyway** to continue. - ![](/assets/esphome-builder-install-windows.gif) + ![Downloading the ESPHome Device Builder Windows installer, choosing Run anyway, and running setup](/assets/esphome-builder-install-windows.gif) The first launch takes a moment while it sets itself up, then the dashboard opens in your browser at http://localhost:6052/. An ESPHome icon lands in your notification area for getting back to it later. @@ -37,7 +37,7 @@ Pick the platform you'll be running ESPHome Device Builder on: Then take **Start guided tour** for a five minute walkthrough, or **Maybe later**. - ![](/assets/device-builder-first-time-install-pick-your-experience.gif) + ![ESPHome Device Builder first-run wizard, choosing local installation and New to ESPHome](/assets/device-builder-first-time-install-pick-your-experience.gif) === "Mac" @@ -64,7 +64,7 @@ Pick the platform you'll be running ESPHome Device Builder on: Then take **Start guided tour** for a five minute walkthrough, or **Maybe later**. - ![](/assets/device-builder-first-time-install-pick-your-experience.gif) + ![ESPHome Device Builder first-run wizard, choosing local installation and New to ESPHome](/assets/device-builder-first-time-install-pick-your-experience.gif) === "Home Assistant App" @@ -112,7 +112,7 @@ Pick the platform you'll be running ESPHome Device Builder on: Then take **Start guided tour** for a five minute walkthrough, or **Maybe later**. - ![](/assets/device-builder-first-time-install-pick-your-experience.gif) + ![ESPHome Device Builder first-run wizard, choosing local installation and New to ESPHome](/assets/device-builder-first-time-install-pick-your-experience.gif) ### Take Control of Your CAST-1 @@ -122,14 +122,14 @@ Pick the platform you'll be running ESPHome Device Builder on: 2\. Click **Show** next to **Discovered** at the top, then click **Take Control** next to your CAST-1. Change the **Name** and **Friendly Name** if you'd like, or leave them, then click **Take Control** again. -![](/assets/cast-1-esphome-device-builder.gif) +![Clicking Show, then Take control on the discovered CAST-1 in ESPHome Device Builder](/assets/cast-1-esphome-device-builder.gif) 3\. Click **Install** (the up arrow icon), then click **On the network** and watch it finish installing. (1) { .annotate } 1. This takes 5 to 10 minutes depending on how fast your device is. -![](/assets/cast-1-esphome-device-builder-install.gif) +![Clicking Install on the CAST-1, choosing On the network, and watching the build log](/assets/cast-1-esphome-device-builder-install.gif) 4\. Once it completes, click **Stop**, then press the **Reset** button on your device. Your CAST-1 will reboot and it's now ready to test out! diff --git a/docs/products/cast1/addons/ethernet-module.md b/docs/products/cast1/addons/ethernet-module.md index ae638a1fa6..2ff7739a38 100644 --- a/docs/products/cast1/addons/ethernet-module.md +++ b/docs/products/cast1/addons/ethernet-module.md @@ -15,7 +15,7 @@ The Ethernet add-on gives your CAST-1 a wired network connection. It's a small h 1. Press evenly on both ends. If the module won't sit flat against the case, lift it off and line the pins up again rather than forcing it. -![](/assets/cast-1-connect-ethernet-module.webp) +![Pressing the Ethernet module onto the two header rows on top of the CAST-1](/assets/cast-1-connect-ethernet-module.webp) 4\. Plug an Ethernet cable into the module, then plug the CAST-1 back into power. diff --git a/docs/products/cast1/examples/wizmote-blueprint.md b/docs/products/cast1/examples/wizmote-blueprint.md index b488125b17..7982ad3a08 100644 --- a/docs/products/cast1/examples/wizmote-blueprint.md +++ b/docs/products/cast1/examples/wizmote-blueprint.md @@ -37,7 +37,7 @@ Before the blueprint can control anything, pair your WizMote with the CAST-1. 1. Pairing a different WizMote later? Use **Clear WizMote Pairing** on the device to unpair, then turn **WizMote Auto-Discovery** back on and press a button on the new remote. -![](/assets/cast-1-pair-wizmote.gif) +![CAST-1 device page turning on WizMote Auto-Discovery until a WizMote MAC address appears](/assets/cast-1-pair-wizmote.gif) !!! note "Pairing takes longer on a CAST-1 running Ethernet only" @@ -59,4 +59,4 @@ Before the blueprint can control anything, pair your WizMote with the CAST-1. 6\. Name your automation something like **Apollo CAST-1 WizMote** and click **Save**. Your WizMote now controls your CAST-1! -![](/assets/cast-1-import-blueprint.gif) +![Importing the Apollo CAST-1 WizMote blueprint and selecting a CAST-1 in Home Assistant](/assets/cast-1-import-blueprint.gif) diff --git a/docs/products/cast1/introduction.md b/docs/products/cast1/introduction.md index 386bec16a1..0ef931c60f 100644 --- a/docs/products/cast1/introduction.md +++ b/docs/products/cast1/introduction.md @@ -4,7 +4,7 @@ description: Documentation for CAST-1, including setup, usage, and best practice --- # Introduction -![](/assets/cast-1-intro-image.webp) +![CAST-1 on a wooden table with a 3.5mm audio cable and USB-C power cable plugged in](/assets/cast-1-intro-image.webp) **Make Any Speakers Smart:** Plug the CAST-1 into a 3.5mm line-in, add it to Home Assistant, and it shows up in Music Assistant as a player you can stream to. diff --git a/docs/products/cast1/setup/getting-started.md b/docs/products/cast1/setup/getting-started.md index 21d3044224..3f069c7236 100644 --- a/docs/products/cast1/setup/getting-started.md +++ b/docs/products/cast1/setup/getting-started.md @@ -13,7 +13,7 @@ Run a 3.5mm cable from the CAST-1 into the line-in on your powered speakers, rec 1. The CAST-1 has no amplifier of its own, so it needs powered speakers or an amp. If your speakers use RCA or 6.35mm inputs, use a 3.5mm-to-RCA or 3.5mm-to-6.35mm adapter cable. -![](/assets/cast-1-physical-setup.webp) +![Plugging a 3.5mm audio cable and a USB-C power cable into the CAST-1](/assets/cast-1-physical-setup.webp) ### Connect to Your Network @@ -37,7 +37,7 @@ There are three ways to get your CAST-1 online. Pick whichever is easier, you on 3\. Select the Wi-Fi network that you would like your CAST-1 to connect to and type in your Wi-Fi password, then click "**Save**". - ![](/assets/cast-1-connect-to-hotspot.webp) + ![Joining the CAST-1 hotspot on a phone and entering Wi-Fi details in the captive portal](/assets/cast-1-connect-to-hotspot.webp) 4\. Once connected, the dashboard will automatically close. You've successfully connected your CAST-1 to your Wi-Fi. @@ -55,7 +55,7 @@ There are three ways to get your CAST-1 online. Pick whichever is easier, you on 3\. Click **Submit** again, give it an **Area**, then click **Finish**. - ![](/assets/cast-1-add-via-improv-ble.gif) + ![Adding the discovered CAST-1 with Improv via BLE in Home Assistant and entering Wi-Fi credentials](/assets/cast-1-add-via-improv-ble.gif) Improv adds your CAST-1 to Home Assistant as part of setup, so skip ahead to [installing Music Assistant](#music-assistant). @@ -63,7 +63,7 @@ There are three ways to get your CAST-1 online. Pick whichever is easier, you on With the CAST-1 unplugged, line the Ethernet module up with the two rows of female header pins on top of the case, pin side down, and press it straight down until it sits flat. - ![](/assets/cast-1-connect-ethernet-module.webp) + ![Pressing the Ethernet module onto the two header rows on top of the CAST-1](/assets/cast-1-connect-ethernet-module.webp) 1\. Plug an Ethernet cable into the module, then plug the CAST-1 into power. @@ -80,7 +80,7 @@ Open the ESPHome Integration, then click **Add** and **Submit**. Edit the name a Open your Home Assistant instance and show the ESPHome integration. -![](/assets/cast-1-home-assistant-integration.gif) +![Adding the discovered CAST-1 in the ESPHome integration, naming it, and choosing an area](/assets/cast-1-home-assistant-integration.gif) ### Music Assistant @@ -94,7 +94,7 @@ The CAST-1 streams through Apollo CAST-1 Installer. 5\. Click **Connect & Install**. In the browser popup, select **USB JTAG/serial debug unit** and click **Allow**. When the installer opens, click **Install** to flash the firmware, then click **Install** again to confirm. -![](/assets/cast-1-reflash-firmware.gif) +![Apollo CAST-1 web installer, clicking Connect and Install, allowing the serial port, and confirming](/assets/cast-1-reflash-firmware.gif) 6\. Once you see "**Installation complete!**" you are finished. Click **Next** then close out of the browser window. diff --git a/docs/products/cast1/troubleshooting/cast1-reset-wi-fi-credentials.md b/docs/products/cast1/troubleshooting/cast1-reset-wi-fi-credentials.md index 660195f0e7..25f5f284c0 100644 --- a/docs/products/cast1/troubleshooting/cast1-reset-wi-fi-credentials.md +++ b/docs/products/cast1/troubleshooting/cast1-reset-wi-fi-credentials.md @@ -12,7 +12,7 @@ description: Step by step guide for resetting the Wi-Fi Credentials on your CAST 2\. Long press the **boot** button (on the left) for 10 seconds. -![](/assets/cast-1-boot-reset-buttons.webp) +![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\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/products/dev1/introduction.md b/docs/products/dev1/introduction.md index b7051bc977..5caacf9afe 100755 --- a/docs/products/dev1/introduction.md +++ b/docs/products/dev1/introduction.md @@ -17,7 +17,7 @@ The DEV-1 does NOT come pre-flashed with ESPHome or WLED and requires you to fla Please go to this website and copy the randomly generated API key inside the code block as shown below then paste it in the code below where you see "use-a-randomly-generated-key-here". -![](/assets/apollo-dev-1-image-2.png) +![ESPHome API docs with a randomly generated encryption key highlighted in a red box](/assets/apollo-dev-1-image-2.png) **GPIO Pins Listed:** diff --git a/docs/products/dev2/introduction.md b/docs/products/dev2/introduction.md index 51fa371da7..629aa001e4 100755 --- a/docs/products/dev2/introduction.md +++ b/docs/products/dev2/introduction.md @@ -21,7 +21,7 @@ The DEV-2 does NOT come pre-flashed with ESPHome or WLED and requires you to fla Please go to this website and copy the randomly generated API key inside the code block as shown below then paste it in the code below where you see "use-a-randomly-generated-key-here". -![](/assets/apollo-dev-1-image-2.png) +![ESPHome API docs with a randomly generated encryption key highlighted in a red box](/assets/apollo-dev-1-image-2.png) **GPIO Pins Listed:** diff --git a/docs/products/general/battery-sensors/awake-ha-helper.md b/docs/products/general/battery-sensors/awake-ha-helper.md index c2c8b481cf..9eb96920c2 100755 --- a/docs/products/general/battery-sensors/awake-ha-helper.md +++ b/docs/products/general/battery-sensors/awake-ha-helper.md @@ -6,29 +6,29 @@ description: How to keep your sensor awake using the Home Assistant Helper. 1\. Open your Home Assistant dashboard and go to settings then select Devices and services and select helpers in the top right. Or click here to go straight there. -![](/assets/awake-ha-helper-pic-1.png) +![Home Assistant Settings with the cursor on Devices and services](/assets/awake-ha-helper-pic-1.png) -![](/assets/awake-ha-helper-pic-2.png) +![Helpers tab selected at the top of the Devices and services page](/assets/awake-ha-helper-pic-2.png) 2\. Select Create Helper in the bottom right.
-![](/assets/awake-ha-helper-pic-4.png) +![Create Helper button in the bottom right of the Helpers page](/assets/awake-ha-helper-pic-4.png)
3\. Scroll down to the bottom and select Toggle. -![](/assets/awake-ha-helper-pic-3-1.png) +![Create helper list in Home Assistant with the cursor on Toggle](/assets/awake-ha-helper-pic-3-1.png)
4\. For name use "apollo\_ota\_mode" and choose desired icon such as "mdi:sleep-off" then click Create. -![](/assets/awake-ha-helper-pic-5.png) +![Create Toggle dialog with name apollo_ota_mode, icon mdi:sleep-off, and the Create button](/assets/awake-ha-helper-pic-5.png) 5\. Search "apollo\_ota\_mode" and click on the helper shown. -![](/assets/awake-ha-helper-pic-6.png) +![Helpers list searched for apollo_ota_mode showing the input_boolean helper](/assets/awake-ha-helper-pic-6.png)
6\. Toggle the OTA mode on as shown below. -![](/assets/toggle-ota-mode-on.png) +![apollo_ota_mode helper dialog with the toggle switched On](/assets/toggle-ota-mode-on.png) 7\. Now when you reboot your Apollo device or when it wakes up on its wake timer, it will no longer go back to sleep. @@ -38,21 +38,21 @@ description: How to keep your sensor awake using the Home Assistant Helper. 8\. Create a new automation and select "add trigger" then select entity then select state. -![](/assets/toggle-ota-mode-automation-1.png) +![New automation with Add trigger and the Entity trigger option circled in red](/assets/toggle-ota-mode-automation-1.png) -![](/assets/toggle-ota-mode-automation-2.png) +![Entity trigger list with the State option circled in red](/assets/toggle-ota-mode-automation-2.png) 9\. Type in "apollo\_ota\_mode" in the box for entity and then select "On" and finally put a 1 in the hours box under "For". This is telling home assistant if the apollo\_ota\_mode is on for one hour then this trigger will fire (trigger). -![](/assets/toggle-ota-mode-automation-3.png) +![State trigger set to apollo_ota_mode, To On, and For 1 hour, circled in red](/assets/toggle-ota-mode-automation-3.png) 10\. Scroll down to "Then do" and click "Add Action" and type in "input boolean" and choose the option that says "Input Boolean: Turn off". -![](/assets/toggle-ota-mode-automation-4.png) +![Add action search for input boolean with Input boolean: Turn off circled in red](/assets/toggle-ota-mode-automation-4.png) 11\. Now select choose entity and select apollo\_ota\_mode as shown below. -![](/assets/toggle-ota-mode-automation-5.png) +![Input boolean Turn off action targeting the apollo_ota_mode entity](/assets/toggle-ota-mode-automation-5.png) 12\. Now you are done! You can toggle your OTA mode on so that you can update your devices and after one hour it will automatically be turned off for you! diff --git a/docs/products/general/battery-sensors/prevent-sleep.md b/docs/products/general/battery-sensors/prevent-sleep.md index 87ec099327..b0b2fe4ab6 100755 --- a/docs/products/general/battery-sensors/prevent-sleep.md +++ b/docs/products/general/battery-sensors/prevent-sleep.md @@ -12,11 +12,11 @@ description: How to disable Prevent Sleep and allow your Apollo device to sleep! 1\. Head to the ESPHome Integrations page and click on the name of your Apollo device. -![](/assets/prevent-sleep-integrations-page-gif.gif) +![Clicking an Apollo BTN-1 on the ESPHome integration page in Home Assistant to open its device page](/assets/prevent-sleep-integrations-page-gif.gif) 2\. Scroll down until you see **Prevent Sleep** and **Sleep Duration**. -![](/assets/prevent-sleep-and-sleep-duration.png) +![Home Assistant Configuration card showing the Prevent Sleep toggle and Sleep Duration box](/assets/prevent-sleep-and-sleep-duration.png) 3\. Type in the amount of minutes you want your sensor to sleep in the **Sleep Duration** box. Defaults to 5 minutes for some devices and longer for others. We recommend leaving the default values. diff --git a/docs/products/general/battery-sensors/sensor-connection-check.md b/docs/products/general/battery-sensors/sensor-connection-check.md index a5002a6e8b..4ac794027e 100755 --- a/docs/products/general/battery-sensors/sensor-connection-check.md +++ b/docs/products/general/battery-sensors/sensor-connection-check.md @@ -6,19 +6,19 @@ description: How to check if your device is connected to Wi-Fi, Home Assistant, 1\. Press the reset button and let go to restart the device
TEMP-1B reset button -![](/assets/temp-1-reset-button-lid-off.jpg) +![TEMP-1B with lid off, tweezers pointing at the RST reset button](/assets/temp-1-reset-button-lid-off.jpg) PLT-1B reset button -![](/assets/plt-boot-mode-pic-6-1.jpg) +![PLT-1B circuit board with tweezers pointing at the reset button](/assets/plt-boot-mode-pic-6-1.jpg) 2\. Press the boot button and let go
TEMP-1B boot button -![](/assets/temp-1b-boot-button-lid-off.jpg) +![TEMP-1B with lid off, tweezers pointing at the BOOT button](/assets/temp-1b-boot-button-lid-off.jpg) PLT-1B boot button -![](/assets/plt-boot-mode-pic-2.jpg) +![PLT-1B circuit board with tweezers pointing at the BOOT button next to the USB-C port](/assets/plt-boot-mode-pic-2.jpg) The RGB Light on your device should flash green if connected to Wi-Fi, blue if connected to Wi-Fi and Home Assistant, or yellow if no Wi-Fi or Home Assistant connection. diff --git a/docs/products/general/battery-sensors/wake-up-battery-sensor.md b/docs/products/general/battery-sensors/wake-up-battery-sensor.md index ca23452542..214ef1de38 100755 --- a/docs/products/general/battery-sensors/wake-up-battery-sensor.md +++ b/docs/products/general/battery-sensors/wake-up-battery-sensor.md @@ -8,11 +8,11 @@ There are two ways to wake a sleeping Apollo battery sensor: press the reset but **Method 1: Reset button.** Press and release the reset button to restart the device. - ![](/assets/temp-1-reset-button-lid-off.jpg) + ![TEMP-1B with lid off, tweezers pointing at the RST reset button](/assets/temp-1-reset-button-lid-off.jpg) **Method 2: Boot button.** Quickly press and hold the boot button for 4-5 seconds. - ![](/assets/temp-1b-boot-button-lid-off.jpg) + ![TEMP-1B with lid off, tweezers pointing at the BOOT button](/assets/temp-1b-boot-button-lid-off.jpg) Button locations: [TEMP-1B boot mode](https://wiki.apolloautomation.com/products/temp1b/troubleshooting/temp1b-boot-mode/). @@ -20,11 +20,11 @@ There are two ways to wake a sleeping Apollo battery sensor: press the reset but **Method 1: Reset button.** Press and release the reset button to restart the device. - ![](/assets/plt-boot-mode-pic-6-1.jpg) + ![PLT-1B circuit board with tweezers pointing at the reset button](/assets/plt-boot-mode-pic-6-1.jpg) **Method 2: Boot button.** Quickly press and hold the boot button for 4-5 seconds. - ![](/assets/plt-boot-mode-pic-2.jpg) + ![PLT-1B circuit board with tweezers pointing at the BOOT button next to the USB-C port](/assets/plt-boot-mode-pic-2.jpg) Button locations: [PLT-1B boot mode](https://wiki.apolloautomation.com/products/plt1b/troubleshooting/plt1b-boot-mode/). @@ -34,7 +34,7 @@ There are two ways to wake a sleeping Apollo battery sensor: press the reset but **Method 2: Boot button.** Quickly press and hold the boot (right) button for 4-5 seconds. - ![](/assets/btn-1-reset-boot-buttons.png) + ![Side of the BTN-1 with arrows marking the Reset button on the left and Boot button on the right](/assets/btn-1-reset-boot-buttons.png) Button locations: [BTN-1 boot mode](https://wiki.apolloautomation.com/products/btn1/troubleshooting/btn1-boot-mode/). @@ -48,7 +48,7 @@ There are two ways to wake a sleeping Apollo battery sensor: press the reset but **Method 2: Boot button.** Quickly press and hold the boot button for 4-5 seconds. - ![](/assets/screenshot-2024-11-01-015948.png) + ![H-1 tree-shaped circuit board with the Boot and Reset buttons circled in red](/assets/screenshot-2024-11-01-015948.png) Button locations: [H-1 boot mode](https://wiki.apolloautomation.com/products/h1/boot-mode/). @@ -62,7 +62,7 @@ There are two ways to wake a sleeping Apollo battery sensor: press the reset but **Method 2: Boot button.** Quickly press and hold the boot (right) button for 4-5 seconds. - ![](/assets/h-2-reset-and-boot-buttons-labeled.png) + ![H-2 snowflake-shaped circuit board with arrows marking the Reset and Boot buttons](/assets/h-2-reset-and-boot-buttons-labeled.png) Button locations: [H-2 boot mode](https://wiki.apolloautomation.com/products/h2/troubleshooting/boot-mode/). diff --git a/docs/products/general/calibrating-and-updating/calibrate-plt1.md b/docs/products/general/calibrating-and-updating/calibrate-plt1.md index 3d12ab542a..95cc828fc8 100644 --- a/docs/products/general/calibrating-and-updating/calibrate-plt1.md +++ b/docs/products/general/calibrating-and-updating/calibrate-plt1.md @@ -10,42 +10,42 @@ This guide will take you through calibrating your PLT-1's moisture sensor. The s 3\. Select Settings and then Devices & Services -![](/assets/5-1.png) +![Home Assistant Settings menu with Devices & services outlined in red](/assets/5-1.png) 4\. Select the ESPHome Integration -![](/assets/6.png) +![ESPHome integration tile in Home Assistant outlined in red](/assets/6.png) 5\. Select your PLT-1 device -![](/assets/7.png) +![ESPHome integration device list with the 1 device link under the PLT-1 outlined in red](/assets/7.png) 6\. Scroll down to the diagnostics section and select entity not shown. -![](/assets/1-5.png) +![PLT-1 Diagnostic card in Home Assistant with +1 entity not shown outlined in red](/assets/1-5.png) 7\. Select the entity "Soil ADC." -![](/assets/1-6.png) +![PLT-1 Diagnostic card in Home Assistant with the hidden Soil ADC entity outlined in red](/assets/1-6.png) 8\. Select the gear icon -![](/assets/2-1.png) +![Disabled Soil ADC entity dialog in Home Assistant with the gear icon outlined in red](/assets/2-1.png) 9\. Select Enable -![](/assets/3.png) +![Soil ADC entity settings in Home Assistant with the Enable button outlined in red](/assets/3.png) 10\. Give the sensor a minute for this new entity to populate. 11\. Once the Soil ADC value is populated, enter it into the "Dry Voltage" entity. -![](/assets/plt-1-calibration-pic-4.png) +![PLT-1 Configuration card with the 100% Water Voltage and Dry Voltage boxes outlined in red](/assets/plt-1-calibration-pic-4.png) 12\. Now, place the stake/probe portion of the PLT-1 into a cup of water. Be careful not to submerge the entire sensor—only the exposed PCB below the "Apollo" label and the horizontal line can be exposed to water. 13\. Grab the "Soil ADC" value again and enter it into the "100% Water Voltage" entity. -![](/assets/plt-1-calibration-pic-6.png) +![PLT-1 Diagnostic card in Home Assistant with the Soil ADC voltage reading outlined in red](/assets/plt-1-calibration-pic-6.png) 14\. You can now return your PLT-1 to your plant. Congratulations, your sensor is calibrated! diff --git a/docs/products/general/calibrating-and-updating/co2-calibration-quick.md b/docs/products/general/calibrating-and-updating/co2-calibration-quick.md index 19aeaebcfb..bf9a48e574 100755 --- a/docs/products/general/calibrating-and-updating/co2-calibration-quick.md +++ b/docs/products/general/calibrating-and-updating/co2-calibration-quick.md @@ -16,7 +16,7 @@ This article will guide you through a simple calibration of your CO2 1\. Plug in your sensor outdoors and leave it for at least 5 minutes to allow the readings to stabilize. This should be around 420 ppm per NASA. -![](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) +![AIR-1 plugged into USB power sitting on concrete outdoors](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) 2\. Go to your Home Assistant dashboard and hit the letter "e" - It will pop up with an entity filter then type in "Calibrate CO2" and select the correct device. @@ -24,8 +24,8 @@ This article will guide you through a simple calibration of your CO2 If you cannot get this menu to pop-up, click somewhere on the Home Assistant dashboard then press your "e" key. -![Image of popup with CO2 calibration choice circled in red](/assets/co2-calibration-quick-pic-1.png) +![Home Assistant entity search for Calibrate CO2 with the AIR-1 Calibrate SCD40 To 420ppm button circled](/assets/co2-calibration-quick-pic-1.png) 3\. Click on the button that says "PRESS" and then you are done. -![Image of popup with CO2 calibration press button circled in red](/assets/co2-calibration-quick-pic-2.png) \ No newline at end of file +![Calibrate SCD40 To 420ppm dialog with the Press button circled and an arrow to the new logbook entry](/assets/co2-calibration-quick-pic-2.png) \ No newline at end of file diff --git a/docs/products/general/calibrating-and-updating/co2-calibration.md b/docs/products/general/calibrating-and-updating/co2-calibration.md index a26c9c0340..6ec5c462cf 100755 --- a/docs/products/general/calibrating-and-updating/co2-calibration.md +++ b/docs/products/general/calibrating-and-updating/co2-calibration.md @@ -14,7 +14,7 @@ description: Step by step guide for re-calibrating your SCD40 CO2 sensor The SCD40 CO2 sensor has a long lifetime (over 10 years), but with automatic self-calibration turned off it needs re-calibration back to the 420 ppm baseline every 1 to 2 years. -![AIR-1 Shown Outdoors for CO2 Calibration Portrait Image](/assets/air-1-co2-calibration-portrait-image-1.jpg "AIR-1 Shown Outdoors for CO2 Calibration") +![AIR-1 plugged into USB power on an outdoor concrete step for CO2 calibration](/assets/air-1-co2-calibration-portrait-image-1.jpg "AIR-1 Shown Outdoors for CO2 Calibration") 1\. Bring your sensor outside and plug it in. You might need a USB battery bank if you live in an apartment or otherwise cannot get power outside of your building. @@ -22,17 +22,17 @@ description: Step by step guide for re-calibrating your SCD40 CO2 sensor 3\. Click device as shown in the image below. -![](/assets/air-1-co2-calibration-image-2-1.jpg) +![ESPHome integration device list in Home Assistant with the 1 device link under Kitchen AIR-1 circled](/assets/air-1-co2-calibration-image-2-1.jpg) 4\. Click the "Press" button next to Calibrate SCD40 to 420 ppm and you should see the CO2 readings at 420 ppm or near it. -![](/assets/air-1-co2-calibration-image-3.jpg) +![AIR-1 Controls card in Home Assistant with the Press button for Calibrate SCD40 circled](/assets/air-1-co2-calibration-image-3.jpg) It might take several attempts clicking the "Press" button for it to equalize correctly. If you don't see the SCD40 reporting 400-500 ppm then click the button again. 5\. Now your CO2 sensor should be calibrated! Be sure to setup some nice cards on your dashboard so you can monitor the CO2 levels. -![Image of CO2ppm on a graph](/assets/air-1-co2-calibration-image-4.jpg) +![Home Assistant CO2 10-minute average graph comparing readings from several rooms over a day](/assets/air-1-co2-calibration-image-4.jpg) !!! danger "Dangerous CO2 level considerations" @@ -40,14 +40,14 @@ It might take several attempts clicking the "Press" button for it to equalize co Note the steep decline in CO2 ppm detected due to the door and window being opened and fan turned on. -![CO2_8.jpg](/assets/air-1-co2-calibration-image-5.jpg) +![Home Assistant history graph of MSR-1 CO2 climbing overnight to about 2,500 ppm, then dropping sharply](/assets/air-1-co2-calibration-image-5.jpg) Wisconsin Department of Health CO2 Level Chart -![CO2 Health Department.png](/assets/air-1-co2-calibration-image-6.jpg) +![List of CO2 levels from 400 to 40,000 ppm and their potential health effects](/assets/air-1-co2-calibration-image-6.jpg) !!! example "CO2 levels dropping due to HVAC Fan on a schedule" This could be improved by increasing air exchange to get below 1000 ppm for a safer environment. -![Plotly CO2 Graph.png](/assets/plotly-co2-graph.png) \ No newline at end of file +![Bedroom CO2 graph in ppm with repeated drops from an HVAC fan running on a schedule](/assets/plotly-co2-graph.png) \ No newline at end of file diff --git a/docs/products/general/calibrating-and-updating/mmwave-videos.md b/docs/products/general/calibrating-and-updating/mmwave-videos.md index 2cb8021ec0..51073097aa 100755 --- a/docs/products/general/calibrating-and-updating/mmwave-videos.md +++ b/docs/products/general/calibrating-and-updating/mmwave-videos.md @@ -26,11 +26,11 @@ How to tune the mmWave sensor using radar engineering mode. 3\. Turn on Radar Engineering Mode (REM). -![](/assets/mmwave-tuning-pic-1.png) +![MSR-2 Configuration card in Home Assistant with the Radar Engineering Mode toggle turned on and circled](/assets/mmwave-tuning-pic-1.png) 4\. Scroll down to the Diagnostic section and you will see that REM shows the move and still energy for gates 0-8. -![](/assets/mmwave-tuning-pic-2-1.png) +![Diagnostic entities in Home Assistant showing gate move and still energy percentages](/assets/mmwave-tuning-pic-2-1.png) 5\. The gates are different distances from the sensor. @@ -38,11 +38,11 @@ How to tune the mmWave sensor using radar engineering mode. 6\. Moving the gate still and move threshold slider to the right increases the amount of energy needed to trigger the sensor. Do this if you want the gate to be less sensitive. -![](/assets/mmwave-tuning-pic-3.png) +![MSR-2 gate threshold sliders in Home Assistant with the g6 still threshold slider moved fully right and circled](/assets/mmwave-tuning-pic-3.png) 7\. Moving the gate still and move threshold slider to the left decreases the amount of energy needed to trigger the sensor. Do this if you want the gate to be more sensitive. -![](/assets/mmwave-tuning-pic-4.png) +![MSR-2 gate threshold sliders in Home Assistant with the g4 move threshold slider moved left and circled](/assets/mmwave-tuning-pic-4.png) !!! quote "Quote from popular Youtuber Make It Work Tech" diff --git a/docs/products/general/calibrating-and-updating/updating-firmware.md b/docs/products/general/calibrating-and-updating/updating-firmware.md index 5dbb2dbb9b..9893edd0bc 100755 --- a/docs/products/general/calibrating-and-updating/updating-firmware.md +++ b/docs/products/general/calibrating-and-updating/updating-firmware.md @@ -22,7 +22,7 @@ Use this route to build the firmware yourself, or if your device has no **Firmwa 1\. In Home Assistant open the ESPHome Device Builder**.** -[![](/assets/esphome-addon-image.svg)](https://my.home-assistant.io/redirect/supervisor_addon/?addon=5c53de3b_esphome&repository_url=https%3A%2F%2Fgithub.com%2Fesphome%2Fhome-assistant-addon) +[![Show add-on on My Home Assistant button for the ESPHome Device Builder](/assets/esphome-addon-image.svg)](https://my.home-assistant.io/redirect/supervisor_addon/?addon=5c53de3b_esphome&repository_url=https%3A%2F%2Fgithub.com%2Fesphome%2Fhome-assistant-addon) !!! tip "Make sure you are running the latest version of ESPHome" @@ -30,23 +30,23 @@ Use this route to build the firmware yourself, or if your device has no **Firmwa 2\. Find the sensor you want to update and click the three dots on the far right. -![](/assets/updating-firmware-pic-1.png) +![ESPHome Device Builder in Home Assistant with the three-dot menu on a device card circled](/assets/updating-firmware-pic-1.png) 3\. Select “**Validate**” from the list. -![](/assets/updating-firmware-pic-2.png) +![ESPHome Device Builder device menu open with the Validate option circled](/assets/updating-firmware-pic-2.png) 4\. Once the validation completes, click “**Install**” in the bottom right. -![](/assets/updating-firmware-pic-3.png) +![ESPHome Device Builder validation window with the Install button circled](/assets/updating-firmware-pic-3.png) 5\. Click "**Wirelessly**". -![](/assets/updating-firmware-pic-4.png) +![ESPHome Device Builder install options with Wirelessly outlined in red](/assets/updating-firmware-pic-4.png) 6\. Once you see "**INFO OTA successful**" you are done. Click "**STOP**" to exit. -![](/assets/updating-firmware-pic-5-1.png) +![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/updating-firmware-pic-5-1.png) ## If no update ever appears diff --git a/docs/products/general/introduction.md b/docs/products/general/introduction.md index 62d6ec0405..e08718771d 100755 --- a/docs/products/general/introduction.md +++ b/docs/products/general/introduction.md @@ -3,7 +3,7 @@ title: Introduction description: "Learn what Apollo Automation is all about, including our mission, our products, and how we empower smarter homes." --- -![](/assets/apollo-product-image-with-hub.jpg) +![Four white Apollo Automation devices arranged on a marble serving board](/assets/apollo-product-image-with-hub.jpg) Apollo Automation is a small startup based in Lexington, Kentucky, dedicated to creating innovative, high-quality, and affordable smart home automation hardware. Founded in 2023 by a group of friends, the company was born out of frustration with existing solutions that lacked transparency and customization options. Named after Trevor’s dog, Apollo, the team set out to build products that offer complete local control without reliance on cloud services or subscriptions! diff --git a/docs/products/general/piezo.md b/docs/products/general/piezo.md index bdb5d13b2e..f33ea64af8 100755 --- a/docs/products/general/piezo.md +++ b/docs/products/general/piezo.md @@ -18,7 +18,7 @@ This guide will walk you through using the buzzer on your Apollo Device. 4\. Input an RTTTL tone into the the string box such as one of the examples below. -![](/assets/buzzer-example-image.png) +![Home Assistant Developer tools Actions tab with numbered arrows marking the buzzer action steps](/assets/buzzer-example-image.png) ??? example "Mario" diff --git a/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md b/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md index 7fe9ae968b..dbb9347ff7 100755 --- a/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md +++ b/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md @@ -7,13 +7,13 @@ description: Tutorial for how to add Apollo Devices To Hidden Networks. 1\. Open the Esphome Device Builder. -![](/assets/bluetooth-proxy-tutorial-1.png) +![ESPHome Device Builder dashboard showing cards for several Apollo devices](/assets/bluetooth-proxy-tutorial-1.png) 2\. If you do not have it installed, [go here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Install Esphome Device Builder.") and then move on to step 3. 3\. Click "Edit" as shown below. -![](/assets/bluetooth-proxy-tutorial-2.png) +![MTR-1 device card in ESPHome Device Builder with the Edit button circled](/assets/bluetooth-proxy-tutorial-2.png) 4\. Copy the code inside the codeblock below. @@ -23,18 +23,18 @@ description: Tutorial for how to add Apollo Devices To Hidden Networks. 5\. Paste the code as shown below directly below the yaml you just edited above. Make sure the spaces look the same and there are no red lines under any of the code. -![](/assets/hidden-ssid-tutorial-1.png) +![MTR-1 YAML in ESPHome Device Builder with fast_connect: True added under wifi](/assets/hidden-ssid-tutorial-1.png) 6 Click save then Install in the top right. -![](/assets/hidden-ssid-tutorial-2.png) +![ESPHome Device Builder YAML editor with an arrow pointing to the Save and Install buttons](/assets/hidden-ssid-tutorial-2.png) 7\. Click "Wirelessly" and let it finish compiling then installing. -![](/assets/hidden-ssid-tutorial-3.png) +![ESPHome Device Builder install options with Wirelessly circled](/assets/hidden-ssid-tutorial-3.png) 8\. When you see this "OTA Successful" it has finished and you can click "Close" in the bottom right. -![](/assets/hidden-ssid-tutorial-4.png) +![ESPHome Device Builder install log with arrows marking INFO OTA successful and the Close button](/assets/hidden-ssid-tutorial-4.png) 9\. You are finished and your Apollo device is now able to connect to your Wi-Fi with a hidden SSID! Make sure you understand the downsides as [mentioned here](https://esphome.io/components/wifi.html "downsides of fast_connect: true").

**fast\_connect** (*Optional*, boolean): If enabled, directly connects to WiFi network without doing a full scan first. This is required for hidden networks and can significantly improve connection times. Defaults to `off`. The downside is that this option connects to the first network the ESP sees, even if that network is very far away and better ones are available. \ No newline at end of file diff --git a/docs/products/general/setup/adjusting-wifi-power.md b/docs/products/general/setup/adjusting-wifi-power.md index c559f12ced..d80ad24793 100755 --- a/docs/products/general/setup/adjusting-wifi-power.md +++ b/docs/products/general/setup/adjusting-wifi-power.md @@ -12,13 +12,13 @@ The ESP chips produce a significant amount of energy (heat) constantly using Wi- 1\. Open the ESPHome Device Builder. -![](/assets/power-save-tutorial-1.png) +![ESPHome Device Builder dashboard showing cards for several Apollo devices](/assets/power-save-tutorial-1.png) 2\. If you do not have it installed, [go here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Install Esphome Device Builder.") and then move on to step 3. 3\. Click "Edit" as shown below. -![](/assets/power-save-tutorial-2.png) +![MTR-1 device card in ESPHome Device Builder with the Edit button circled](/assets/power-save-tutorial-2.png) 4\. Copy the code inside the codeblock below. @@ -28,14 +28,14 @@ The ESP chips produce a significant amount of energy (heat) constantly using Wi- 5\. Paste the code as shown below - make sure the spaces look the same and there are no red lines under any of the code. -![](/assets/power-save-tutorial-3-1.png) +![MTR-1 YAML in ESPHome Device Builder with power_save_mode: HIGH added under wifi](/assets/power-save-tutorial-3-1.png) 6\. In the top right of the same screen click "SAVE" and then "INSTALL". -![](/assets/renaming-devices-pic-7-1.png) +![Save and Install buttons outlined in red at the top right of the ESPHome Device Builder editor](/assets/renaming-devices-pic-7-1.png) 7\. Once you see "INFO OTA successful" you are done. Click "STOP" to exit. -![](/assets/update-frequency-pic-3.png) +![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/update-frequency-pic-3.png) 8\. You are finished and your Apollo device now has power\_save\_mode set to high! \ No newline at end of file diff --git a/docs/products/general/setup/bluetooth-tracking.md b/docs/products/general/setup/bluetooth-tracking.md index 695d6e3f59..3e9945ca49 100755 --- a/docs/products/general/setup/bluetooth-tracking.md +++ b/docs/products/general/setup/bluetooth-tracking.md @@ -306,22 +306,22 @@ wifi: [Apple](https://apps.apple.com/us/app/home-assistant/id1099568401) 3. Navigate to the HA settings - ![Screenshot_20231109_235524_Photos.jpg](/assets/screenshot-20231109-235524-photos.jpg) + ![Home Assistant app side menu with Settings circled](/assets/screenshot-20231109-235524-photos.jpg) 4. Select Companion app - ![Screenshot_20231109_235557_Photos.jpg](/assets/screenshot-20231109-235557-photos.jpg) + ![Home Assistant Settings screen with Companion app circled](/assets/screenshot-20231109-235557-photos.jpg) 5. Select Manage sensors - ![Screenshot_20231109_235621_Photos.jpg](/assets/screenshot-20231109-235621-photos.jpg) + ![Companion app settings with Manage sensors circled](/assets/screenshot-20231109-235621-photos.jpg) 6. Turn on the "BLE Transmitter" - ![Screenshot_20231109_235702_Photos.jpg](/assets/screenshot-20231109-235702-photos.jpg) + ![BLE transmitter sensor page with the Enable sensor toggle circled](/assets/screenshot-20231109-235702-photos.jpg) 7. After opening BLE transmitter and turning it on, then scroll down to get the iBeacon unique ID - ![Screenshot_20231109_235757_Photos.jpg](/assets/screenshot-20231109-235757-photos.jpg) + ![BLE transmitter attributes with the iBeacon id field circled](/assets/screenshot-20231109-235757-photos.jpg) 8. Add it to the ESPHome yaml config for the MSR-1 - ![ESPHome YAML Edit.png](/assets/esphome-yaml-edit.png) + ![ESPHome dashboard with the Edit button highlighted on the MSR-1 card](/assets/esphome-yaml-edit.png) 9. Be sure to add "power\_save\_mode: LIGHT" to the wifi section ``` diff --git a/docs/products/general/setup/change-the-update-frequency-of-sensors.md b/docs/products/general/setup/change-the-update-frequency-of-sensors.md index b6914d08e3..4fe2046794 100755 --- a/docs/products/general/setup/change-the-update-frequency-of-sensors.md +++ b/docs/products/general/setup/change-the-update-frequency-of-sensors.md @@ -7,7 +7,7 @@ description: Tutorial for How To Change The Update Frequency Of Sensors. 1\. Select the ESPHome Builder in the sidebar then click "EDIT" on the device you want to change. -![](/assets/update-frequency-pic-1.png) +![ESPHome Builder in the Home Assistant sidebar with the Edit button on an AIR-1 card outlined](/assets/update-frequency-pic-1.png) 2\. Insert the YAML for the sensor you want to edit(The example below is for our AIR-1 SEN55 sensor). @@ -26,4 +26,4 @@ sensor: 4\. Once you see "INFO OTA successful" you are done. Click "STOP" to exit. -![](/assets/update-frequency-pic-3.png) \ No newline at end of file +![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/update-frequency-pic-3.png) \ No newline at end of file diff --git a/docs/products/general/setup/getting-started.md b/docs/products/general/setup/getting-started.md index 5592df2a50..7e73e858a7 100755 --- a/docs/products/general/setup/getting-started.md +++ b/docs/products/general/setup/getting-started.md @@ -14,7 +14,7 @@ To connect through the sensor's onboard hotspot follow the below: 2\. On your phone or PC, open the WiFi settings and connect to "Apollo MSR-2 Hotspot", it might take a minute for the WiFi network to show up. -![](/assets/getting-started-pic-1-1.png) +![Phone Wi-Fi settings with the Apollo MSR-2 hotspot network outlined in red](/assets/getting-started-pic-1-1.png) 3\. Once connected it should automatically open a dashboard for your sensor @@ -22,7 +22,7 @@ If this does not automatically open the dashboard, please open your web browser 4\. Select the WiFi network that you would like your sensor to connect to or scroll to the bottom and type in your Wi-Fi network then click "**Save**". -![](/assets/getting-started-pic-2.png) +![Sensor hotspot page at 192.168.4.1 with the SSID and Password fields and Save button marked](/assets/getting-started-pic-2.png) !!! tip "Tip for Mesh Wi-Fi systems or multiple Access Points" @@ -40,27 +40,27 @@ If this does not automatically open the dashboard, please open your web browser 1\. Navigate to settings -> integrations then click the "**ADD**" button below your new Apollo device! -![](/assets/improv-ble-pic-1.png) +![Discovered PLT-1B card in Home Assistant labeled Improv via BLE with an Add button](/assets/improv-ble-pic-1.png) 2\. Click submit when it asks if you want to setup your new device and shows you the hostname of your device. -![](/assets/temp1b-improv-ble-4.png) +![Home Assistant setup prompt for an Apollo TEMP-1 with the Submit button outlined in red](/assets/temp1b-improv-ble-4.png) 3\. Type in your Wi-Fi name and password in the two fields. -![](/assets/improv-ble-pic-3.png) +![Home Assistant Improv dialog asking for the Wi-Fi SSID and password](/assets/improv-ble-pic-3.png) 4\. Wait for it to finish, you will see the image below while it connects. -![](/assets/improv-ble-pic-4.png) +![Home Assistant dialog saying the device is connecting to the Wi-Fi network](/assets/improv-ble-pic-4.png) 5\. Click the link shown in the image below (do not click close). -![](/assets/improv-ble-pic-5-1.png) +![Home Assistant success message with a My Home Assistant link to finish ESPHome setup](/assets/improv-ble-pic-5-1.png) 6\. When successful, you will see this image appear! -![](/assets/improv-ble-pic-6.png) +![Home Assistant Success dialog showing the new PLT-1B and an Area field](/assets/improv-ble-pic-6.png) ### Connecting To ESPHome Device Builder @@ -72,7 +72,7 @@ You can add the ESPHome Device Builder app in Home Assistant to easily update yo Make sure to fill out your Wi-Fi details in the SECRETS section by clicking on the SECRETS Image below. -![esphome-device-compiler-dashboard-pic-1.png](/assets/esphome-device-compiler-dashboard-pic-1.png) +![ESPHome Device Builder dashboard with Apollo device cards and the Secrets button at the top right](/assets/esphome-device-compiler-dashboard-pic-1.png) ```yaml # Your Wi-Fi SSID and password - keep the quotes and just replace the name and password between the quotes! @@ -82,23 +82,23 @@ wifi_password: "your-wifi-pass-here" 1\. Click "Show" in the top right to show your discovered devices! -![](/assets/esphome-device-builder-show-discovered-device.png) +![ESPHome Device Builder banner reading Discovered 1 device with the Show button](/assets/esphome-device-builder-show-discovered-device.png) 2\. Click the ESPHome Builder in your sidebar then click "**TAKE CONTROL**" for your new Apollo Device! -![](/assets/esphome-device-builder-pic-1.png) +![ESPHome Builder in the Home Assistant sidebar and Take Control on a TEMP-1 card outlined](/assets/esphome-device-builder-pic-1.png) 3\. Rename your sensor here (this only renames the sensor in the ESPHome Device Compiler's Dashboard) or skip it and continue on by clicking "**TAKE CONTROL**" again as shown below. -![](/assets/esphome-device-builder-pic-2.png) +![ESPHome Device Builder Take Control dialog for an Apollo TEMP-1 with a name field and Take Control button](/assets/esphome-device-builder-pic-2.png) 4\. Click "**INSTALL**" (DO NOT click skip!) and let your device get adopted into the ESPHome Device Builder. Please have patience as this takes a few minutes to compile and then install to your new Apollo device! -![](/assets/esphome-device-builder-pic-3.png) +![ESPHome Device Builder Configuration created dialog for an Apollo TEMP-1 with the Install button outlined](/assets/esphome-device-builder-pic-3.png) 5\. Once you see "**INFO OTA successful**" you are done. Click "**STOP**" to exit. -![](/assets/getting-started-pic-4.png) +![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/getting-started-pic-4.png) 6\. Your new device is now adopted into the ESPHome Device Builder and you can move on to Integrating with Home Assistant via the ESPHome Integration below! @@ -106,23 +106,23 @@ wifi_password: "your-wifi-pass-here" 1\. Click the "**Notifications**" Icon in the bottom left. -![](/assets/getting-started-pic-5.png) +![Notifications bell icon in the bottom left of the Home Assistant sidebar](/assets/getting-started-pic-5.png) 2\. Click "**Check it out**" to go to the integrations page and see the new device that was found. -![](/assets/getting-started-pic-7.png) +![Home Assistant New devices discovered notification with the Check it out link outlined](/assets/getting-started-pic-7.png) 3\. Click "**ADD**" to begin adding the device to home assistant. -![](/assets/getting-started-pic-6-1.png) +![Discovered MSR-2 card in Home Assistant with the Add button outlined in red](/assets/getting-started-pic-6-1.png) 4\. Click "**SUBMIT**" to confirm you want to add your new Apollo device to home assistant. -![](/assets/getting-started-pic-8.png) +![Home Assistant Discovered ESPHome node dialog for an MSR-2 with Submit outlined](/assets/getting-started-pic-8.png) 5\. Give it an area and click "**FINISH**". -![](/assets/getting-started-pic-9.png) +![Home Assistant Success dialog for an MSR-2 with the Area field and Finish button marked](/assets/getting-started-pic-9.png) 6\. Your device is now added to home assistant via the ESPHome integration, and you can easily navigate to it by going to settings -> ESPHome integration -> click on the name of your new device! diff --git a/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md b/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md index 064c4f1896..90fefcc414 100755 --- a/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md +++ b/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md @@ -6,7 +6,7 @@ description: Tutorial for How To Add Temp And Humidity entities From the SCD40 C 1\. Select the ESPHome Builder in the sidebar then click "EDIT" on the device you want to change. -![](/assets/add-temp-hum-scd40-pic-1.png) +![ESPHome Builder in the Home Assistant sidebar with the Edit button on an AIR-1 card outlined](/assets/add-temp-hum-scd40-pic-1.png) 2\. Copy the YAML below and put it at the bottom on a new line with no spaces before it. @@ -56,14 +56,14 @@ number: mode: box ``` -![](/assets/add-temp-hum-scd40-pic-4.png) +![AIR-1 YAML in ESPHome Device Builder with the SCD40 sensor and offset number code outlined](/assets/add-temp-hum-scd40-pic-4.png) 3\. In the top right of the same screen click "SAVE" and then "INSTALL". 4\. Once you see "INFO OTA successful" you are done. Click "STOP" to exit. -![](/assets/add-temp-hum-scd40-pic-3.png) +![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/add-temp-hum-scd40-pic-3.png) 5\. Once you are finished, you will have two new boxes inside the Home Assistant ESPHome integration device page for your device where you can fill in an offset. Give them up to 1minute to take effect! -![](/assets/add-temp-hum-scd40-pic-5.png) \ No newline at end of file +![SCD40 Humidity and SCD40 Temperature offset boxes on the device page in Home Assistant](/assets/add-temp-hum-scd40-pic-5.png) \ No newline at end of file diff --git a/docs/products/general/setup/renaming-apollo-devices.md b/docs/products/general/setup/renaming-apollo-devices.md index 3d42f9f6ac..b64456d3d5 100755 --- a/docs/products/general/setup/renaming-apollo-devices.md +++ b/docs/products/general/setup/renaming-apollo-devices.md @@ -12,7 +12,7 @@ description: Tutorial for How To Rename Apollo Devices in the ESPHome integratio 2\. On the device you want to rename, click the pencil icon and enter a new name. Click **Update**, then select the name you just created. -![](/assets/esphome-integration-rename-device-gif.gif) +![Renaming a BTN-1 to Smart Keys with the pencil icon on the ESPHome integration page](/assets/esphome-integration-rename-device-gif.gif) 3\. Click the 3 dots in the top right and select **Recreate Entity IDs** then select **Update**. @@ -20,11 +20,11 @@ description: Tutorial for How To Rename Apollo Devices in the ESPHome integratio You will likely run into a popup showning that 2 entity IDs cannot be regenerated because they are not available. This is fine, we can manually fix these later or just ignore them as they are disabled entities and not expected to be used. -![](/assets/esphome-integration-recreate-entity-ids-gif.gif) +![Selecting Recreate entity IDs from the three-dot menu on a BTN-1 device page, then Update](/assets/esphome-integration-recreate-entity-ids-gif.gif) 4\. Scroll down to the Diagnostic section and click on **\+2 disabled entities**. Select each entity and replace the old name with the new name. Make sure to replace spaces with underscores as shown in the gif below! -![](/assets/esphome-integration-manually-rename-disabled-entities-gif.gif) +![Opening each disabled Diagnostic entity on the BTN-1 device page and editing its entity ID](/assets/esphome-integration-manually-rename-disabled-entities-gif.gif) ##### ESPHome Integration - Part 2 @@ -36,7 +36,7 @@ This section only changes the device name shown in the ESPHome integration page. 2\. On the device you would like to rename, click the 3 dots icon and select **Rename** and type in your new name then click **OK**. -![](/assets/esphome-integration-rename-device-for-integration-gif.gif) +![Using the three-dot menu Rename option on the ESPHome integration page to rename a BTN-1 entry](/assets/esphome-integration-rename-device-for-integration-gif.gif) !!! success "The next section is not necessary unless you use ESPHome Device Builder!" @@ -48,7 +48,7 @@ This section only changes the device name shown in the ESPHome integration page. 2\. Click the 3 dots next to your new Apollo device and select **Rename hostname** then enter in the new name of your sensor and click **Rename**. This cannot have any spaces or underscores only hyphens, numbers, and lowercase letters such as "**smart-keys**". Once it finishes it will say OTA successful and you can click close to get back to the main dashboard. -![](/assets/rename-hostname-esphome-device-builder-gif.gif) +![Using Rename hostname in ESPHome Device Builder to rename a BTN-1 and install the change](/assets/rename-hostname-esphome-device-builder-gif.gif) !!! null "We are now ready to rename the friendly_name to a new name such as Smart Keys" @@ -56,12 +56,12 @@ This section only changes the device name shown in the ESPHome integration page. 3\. Click **Edit** then replace the text after friendly\_name with your new name such as Smart Keys. Click Save and Install in the top right once you are done with the rename and it will save and install. Once it finishes it will say OTA successful and you can click close to get back to the main dashboard. -![](/assets/rename-friendiy-name-esphome-device-builder-gif.gif) +![Editing friendly_name to Smart Keys in ESPHome Device Builder, then installing wirelessly](/assets/rename-friendiy-name-esphome-device-builder-gif.gif) 4\. Finally we should delete the device from the ESPHome Integration in home assistant and then add it back! Head to the ESPHome Integrations page. Next to the device you would like to remove, click the three dots and then **Delete**. -![](/assets/delete-device-from-esphome-device-builder-gif2.gif) +![Deleting the renamed BTN-1 from the ESPHome integration page using the three-dot menu](/assets/delete-device-from-esphome-device-builder-gif2.gif) 5\. Scroll up and add the new auto-discovered device. The name should be the same Friendly name you put in the ESPHome Device builder and all of your entities should be the correct name to begin with! -![](/assets/auto-discover-and-add-esphome-device-gif.gif) \ No newline at end of file +![Adding the rediscovered Smart Keys BTN-1 from the ESPHome integration page in Home Assistant](/assets/auto-discover-and-add-esphome-device-gif.gif) \ No newline at end of file diff --git a/docs/products/general/setup/switch-to-beta-branch.md b/docs/products/general/setup/switch-to-beta-branch.md index dee2b739bb..2f323c7010 100755 --- a/docs/products/general/setup/switch-to-beta-branch.md +++ b/docs/products/general/setup/switch-to-beta-branch.md @@ -14,7 +14,7 @@ description: Tutorial for How To Switching to Beta branch with ESPHome Device Bu 2\. Find the sensor you want to edit and click the "**EDIT**". -![](/assets/switch-to-beta-pic-1.png) +![ESPHome Device Builder dashboard with the Edit button on a PLT-1 card outlined in red](/assets/switch-to-beta-pic-1.png) !!! danger "This is code and requires you to follow the directions carefully." @@ -22,9 +22,9 @@ description: Tutorial for How To Switching to Beta branch with ESPHome Device Bu 3\. Look for the line that starts with packages and the line below it and put a \# in front of each line as shown in the second image below. -![](/assets/switch-to-beta-pic-2.png) +![PLT-1 YAML in ESPHome Device Builder with the packages lines outlined in red](/assets/switch-to-beta-pic-2.png) -![](/assets/switch-to-beta-pic-3.png) +![PLT-1 YAML in ESPHome Device Builder with the two packages lines commented out using #](/assets/switch-to-beta-pic-3.png) 4\. Select your product below, copy the code, and paste it below the two lines you just commented out. @@ -159,12 +159,12 @@ description: Tutorial for How To Switching to Beta branch with ESPHome Device Bu Changing the name can cause the install to fail due to mDNS issues. If you want to rename your device, [follow this guide](https://wiki.apolloautomation.com/products/general/setup/renaming-apollo-devices/) instead. -![](/assets/switch-to-beta-pic-4.png) +![PLT-1 YAML in ESPHome Device Builder with the new beta packages block pasted below the commented lines](/assets/switch-to-beta-pic-4.png) 5\. Click save then install in the top right and click **Wirelessly** when prompted. -![](/assets/click-save-then-install-gif.gif) +![Clicking Save, then Install, then Wirelessly in ESPHome Device Builder to start the install](/assets/click-save-then-install-gif.gif) 6\. Once you see "**INFO OTA successful**" you are done. Click "**STOP**" in the bottom right to exit. -![](/assets/switch-to-beta-pic-7.png) +![ESPHome Device Builder install log with INFO OTA successful and the Stop button outlined](/assets/switch-to-beta-pic-7.png) diff --git a/docs/products/general/supported-platforms.md b/docs/products/general/supported-platforms.md index 437d8f7a5a..3e3b92d1b0 100755 --- a/docs/products/general/supported-platforms.md +++ b/docs/products/general/supported-platforms.md @@ -2,7 +2,7 @@ title: Supported Platforms description: A list of platforms compatible with Apollo Automation products. --- -![](/assets/apollo-logo.png) +![Apollo Automation logo in white on a blue background](/assets/apollo-logo.png) At Apollo, we are actively working on adding support for every smart home ecosystem out there. Although we are a works with Home Assistant partner and a Made for ESPHome partner, we want everyone to be able to use our sensors! Please take a look at the list of smart home ecosystems below to see the type of support we offer and the type of integration/functionality our sensors have. If you see any outdated info or have any questions/comments/concerns, please reach out to us at support@apolloautomation.com or come say hi in our [discord server](https://link.apolloautomation.com/discord)! diff --git a/docs/products/general/troubleshooting/connection-issues.md b/docs/products/general/troubleshooting/connection-issues.md index a1453d4fc1..ecdfcfd02e 100755 --- a/docs/products/general/troubleshooting/connection-issues.md +++ b/docs/products/general/troubleshooting/connection-issues.md @@ -26,7 +26,7 @@ wifi: 1\. Select the ESPHome app and then select Edit under your desired device. -![](/assets/screenshot-2024-10-25-at-5-14-48-pm.png) +![ESPHome in the Home Assistant sidebar and the Edit button on an MSR-2 card circled](/assets/screenshot-2024-10-25-at-5-14-48-pm.png) 2\. Add the code below to your devices yaml file. Then select Save and press Install. @@ -34,6 +34,6 @@ wifi: power_save_mode: none ``` -![](/assets/screenshot-2024-10-25-at-5-25-10-pm.png) +![MSR-2 YAML with power_save_mode: none added under wifi and the Save and Install buttons circled](/assets/screenshot-2024-10-25-at-5-25-10-pm.png) 3\. Now your device should have a stronger connection. (This will cause the sensors internal temperature to increase.) \ No newline at end of file diff --git a/docs/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md b/docs/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md index 92c91c1e18..423c8d6ddc 100755 --- a/docs/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md +++ b/docs/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md @@ -12,14 +12,14 @@ Install the mDNS Repeater 1\. Click System -> Click Firmware -> Click Plugins -> Search for "mdns" -> Click the “+” symbol to install os-mdns-repeater. -![](/assets/opnsense-mdns-guide-pic-1.png) +![OPNsense Firmware Plugins page with numbered steps to search for and install os-mdns-repeater](/assets/opnsense-mdns-guide-pic-1.png) 2\. Confirm that the installation was successful. -![](/assets/opnsense-mdns-guide-pic-2.png) +![OPNsense Firmware Updates log showing os-mdns-repeater installed successfully](/assets/opnsense-mdns-guide-pic-2.png) 3\. Refresh the page and then go to Services -> mDNS Repeater (if it isn't there after refreshing your screen, verify the plugin install was successful.)-> Check off "enable" -> select your networks containing Home Assistant / ESPHome IoT devices -> click save. -![](/assets/opnsense-mdns-guide-pic-3.png) +![OPNsense mDNS Repeater page with numbered steps: Enable checked, IOT and LAN interfaces selected, then Save](/assets/opnsense-mdns-guide-pic-3.png) Now the Home Assistant/ESPHome auto-discover issue should be fixed! \ No newline at end of file diff --git a/docs/products/general/troubleshooting/removing-device-from-home-assistant.md b/docs/products/general/troubleshooting/removing-device-from-home-assistant.md index bf8404df06..2b74b4c76f 100755 --- a/docs/products/general/troubleshooting/removing-device-from-home-assistant.md +++ b/docs/products/general/troubleshooting/removing-device-from-home-assistant.md @@ -14,14 +14,14 @@ This will cover how to remove an Apollo device from Home Assistant 1\. Navigate to Home Assistant and open your ESPHome Device Builder app. -![image.png](/assets/esphome-device-builder-addon-image.png) +![ESPHome Builder selected in the Home Assistant sidebar, showing the ESPHome Device Builder dashboard](/assets/esphome-device-builder-addon-image.png) 2\. On the device you would like to remove, click the three dots and select "Delete" then click Delete to confirm. -![](/assets/delete-device-from-esphome-device-builder-gif.gif) +![Deleting an H-1 in ESPHome Device Builder from the three-dot menu and confirming Delete](/assets/delete-device-from-esphome-device-builder-gif.gif) ##### ESPHome Integration 1\. Head to the ESPHome Integrations page. Next to the device you would like to remove, click the three dots and then "Delete". -![](/assets/delete-device-from-esphome-integration-gif.gif) \ No newline at end of file +![Deleting an H-1 from the ESPHome integration page in Home Assistant and confirming Delete](/assets/delete-device-from-esphome-integration-gif.gif) \ No newline at end of file diff --git a/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md b/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md index 6b6f92f6e0..1af8f41aea 100755 --- a/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md +++ b/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md @@ -14,23 +14,23 @@ description: Tutorial to help fix the Ubiquiti Unifi mDNS Auto Discover Issue. 2\. Select Network. -![mdns1.PNG](/assets/mdns1.PNG) +![UniFi OS Applications page with the Network application highlighted](/assets/mdns1.PNG) 3\. Select Settings. -![mdns2.PNG](/assets/mdns2.PNG) +![UniFi Network sidebar with the Settings gear icon highlighted](/assets/mdns2.PNG) 4\. Select Networks. -![mdns3.PNG](/assets/mdns3.PNG) +![UniFi Network settings menu with Networks highlighted](/assets/mdns3.PNG) 5\. Select the Default Network -![mdns4.PNG](/assets/mdns4.PNG) +![UniFi Networks list with the Default network highlighted](/assets/mdns4.PNG) 6\. Check Multicast DNS -![mdns5.PNG](/assets/78Kmdns5.PNG) +![UniFi Default network settings with the Multicast DNS checkbox checked and highlighted](/assets/78Kmdns5.PNG) 7\. Now the Home Assistant/ESPHome auto-discover issue should be fixed! @@ -38,22 +38,22 @@ description: Tutorial to help fix the Ubiquiti Unifi mDNS Auto Discover Issue. 1\. Open the UniFi app. -![mmdns1.PNG](/assets/mmdns1.PNG) +![UniFi Network app icon circled in the phone's app search results](/assets/mmdns1.PNG) 2\. Tap Settings/Gear Icon -![mmdns2.PNG](/assets/mmdns2.PNG) +![UniFi Network app Settings screen with the gear icon circled in the bottom bar](/assets/mmdns2.PNG) 3\. Tap Networks -![mmdns3.PNG](/assets/mmdns3.PNG) +![UniFi Network app Settings screen with Networks circled](/assets/mmdns3.PNG) 4\. Tap Default Network -![mmdns4.PNG](/assets/mmdns4.PNG) +![UniFi Network app Networks list with the Default network circled](/assets/mmdns4.PNG) 5\. Tap the Multicast DNS slider -![mmdns5.PNG](/assets/mmdns5.PNG) +![UniFi Network app Edit Default screen with the Multicast DNS toggle turned on and circled](/assets/mmdns5.PNG) 6\. Now the Home Assistant/ESPHome auto-discover issue should be fixed! \ No newline at end of file diff --git a/docs/products/general/tutorials/change-co2-update-interval.md b/docs/products/general/tutorials/change-co2-update-interval.md index d8a0607b2f..bd8778794e 100644 --- a/docs/products/general/tutorials/change-co2-update-interval.md +++ b/docs/products/general/tutorials/change-co2-update-interval.md @@ -16,7 +16,7 @@ This guide will show you how to edit the CO2 updates down to 5 second 1\. Select the ESPHome Builder in the sidebar then click "EDIT" on the device you want to change. -![image.png](/assets/update-frequency-pic-1.png) +![ESPHome Builder in the Home Assistant sidebar with the Edit button on an AIR-1 card outlined](/assets/update-frequency-pic-1.png) 2\. Copy this code and enter it just like shown in the next step. Make sure there are no extra spaces or any other characters. It needs to look just like the example in the next step. @@ -34,6 +34,6 @@ sensor: 5\. Once you see "INFO OTA successful" you are done. Click "STOP" to exit. -![](/assets/update-frequency-pic-3.png) +![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/update-frequency-pic-3.png) 6\. Once that is finished your sensor should now be reporting CO2 at your new update\_interval such as 5 seconds! diff --git a/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md b/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md index 2725e6eb44..dad0437d5c 100755 --- a/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md +++ b/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md @@ -12,7 +12,7 @@ This guide will show you how to edit the lux updates down to 5 seconds. 1\. Select the ESPHome Builder in the sidebar then click "EDIT" on the device you want to change. -![image.png](/assets/update-frequency-pic-1.png) +![ESPHome Builder in the Home Assistant sidebar with the Edit button on an AIR-1 card outlined](/assets/update-frequency-pic-1.png) 2\. Copy this code and enter it just like shown in the next step. Make sure there are no extra spaces or any other characters it needs to look just like the example in the next step. @@ -26,12 +26,12 @@ sensor: 3\. Paste the code you copied in step 2 below your sensor's existing yaml as shown below. -![image.png](/assets/QBoimage.png) +![MSR-2 YAML in ESPHome Device Builder with the ltr390 lux update_interval code pasted at the bottom](/assets/QBoimage.png) 4\. In the top right of the same screen click "SAVE" and then "INSTALL". 5\. Once you see "INFO OTA successful" you are done. Click "STOP" to exit. -![](/assets/update-frequency-pic-3.png) +![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/update-frequency-pic-3.png) 6\. Once that is finished your sensor should now be reporting at your new update\_interval such as 5 seconds! \ No newline at end of file diff --git a/docs/products/h1/boot-mode.md b/docs/products/h1/boot-mode.md index 745748819e..0bf8a92057 100755 --- a/docs/products/h1/boot-mode.md +++ b/docs/products/h1/boot-mode.md @@ -4,7 +4,7 @@ description: Step by step guide for putting The H-1 In Boot Mode. --- This will cover how to put the H-1 into boot mode. Sometimes, this is needed to upload new firmware if the device is struggling. -![](/assets/screenshot-2024-11-01-015948.png) +![Back of the H-1 board with the gold button, Boot button, and Reset button circled in red](/assets/screenshot-2024-11-01-015948.png) ## **Boot Button Only** diff --git a/docs/products/h1/faq.md b/docs/products/h1/faq.md index be14f043d4..bccfee50b3 100755 --- a/docs/products/h1/faq.md +++ b/docs/products/h1/faq.md @@ -2,7 +2,7 @@ title: H-1 FAQ description: Frequently asked questions about the H-1. --- -![](/assets/apollo-h-1-info.png) +![H-1 info card with how-to-use steps, contact details, and the charities it supports](/assets/apollo-h-1-info.png) 1\. **What songs are pre-loaded on the Apollo H-1?** diff --git a/docs/products/h1/getting-started.md b/docs/products/h1/getting-started.md index de095c42d7..1afba2ea1a 100755 --- a/docs/products/h1/getting-started.md +++ b/docs/products/h1/getting-started.md @@ -6,7 +6,7 @@ description: H-1 Getting Started tutorial. Insert a rechargeable RC-CR123A (16340) battery, preferably an 850 mAh model like the one available in our store, or plug it into a power source using the USB-C port. A normal CR123A will not work! -![](/assets/h-1-battery-insert.jpg) +![Hand placing a rechargeable 16340 battery into the H-1 battery holder](/assets/h-1-battery-insert.jpg) 2\. Turn on the Ornament: @@ -20,7 +20,7 @@ Once the ornament is awake, press the gold button (see image below) to play one * 2 Presses: Rudolph the Red-Nosed Reindeer * Long press: Let it Snow -![](/assets/screenshot-2024-11-01-015948-1.png) +![Back of the H-1 board with the gold button at lower left, the Boot button, and the Reset button circled in red](/assets/screenshot-2024-11-01-015948-1.png) 4\. Add to Home Assistant (Optional): diff --git a/docs/products/h1/introduction.md b/docs/products/h1/introduction.md index 8240bd6e61..8f32bde4b3 100755 --- a/docs/products/h1/introduction.md +++ b/docs/products/h1/introduction.md @@ -2,7 +2,7 @@ title: H-1 Introduction description: H-1 Introduction. --- -![](/assets/h-1-usa.png) +![Apollo H-1 tree-shaped ornament with red and green LEDs lit and a Made in USA badge](/assets/h-1-usa.png) The Apollo H-1 is our special holiday ornament, designed to bring festive cheer to your home while supporting a good cause. As the first in our annual series, this ornament is crafted with both functionality and community spirit in mind. All proceeds from the H-1 go directly to a local charity in Lexington, KY, reflecting our commitment to giving back and celebrating the season alongside our community. diff --git a/docs/products/h1/reflash.md b/docs/products/h1/reflash.md index 5ecdf3c93f..c3f938a1c6 100755 --- a/docs/products/h1/reflash.md +++ b/docs/products/h1/reflash.md @@ -10,17 +10,17 @@ If your device has already been connected to Home Assistant previously please re 2. Navigate to our installer page and click connect [\*\* Install Page \*\*](https://apolloautomation.github.io/H-1/) 3. Select your Apollo device, it will show with a similar name to the one below, and click connect. If you aren't sure which device it is, you can unplug the sensor and see which disappears. -![](/assets/comselection.png) +![Browser serial port dialog listing the USB JTAG/serial debug unit to connect](/assets/comselection.png) If no device shows, click cancel and then install the recommended driver that shows on the popup. If you have installed the driver, tried different cables, and it still won't work refer [here](https://wiki.apolloautomation.com/products/h1/boot-mode/) for putting the sensor in bootloader mode and then retry step 3. 4\. Choose to install the new firmware -![](/assets/image-1698806750134.png) +![Web installer Device Dashboard dialog with the Install option and Logs and Console](/assets/image-1698806750134.png) 5\. Wait for the installer to finish - if you see "ERROR Logger is not configured!" that is totally expected! The logger is disabled to make more room for other components on the microcontroller. -![](/assets/image-1698806082666.png) +![Web installer dialog showing a spinner while preparing the installation](/assets/image-1698806082666.png) 6\. VERY IMPORTANT - you need to unplug your device and plug it back in to leave boot mode! @@ -29,4 +29,4 @@ If no device shows, click cancel and then install the recommended driver that sh If you encounter the below error, please complete the [Putting H-1 In Boot Mode Document](https://wiki.apolloautomation.com/products/h1/boot-mode/) and go back to step 3. -![](/assets/image-1698806793309.png) \ No newline at end of file +![Web installer error: Failed to initialize, try holding the BOOT button while clicking Install](/assets/image-1698806793309.png) \ No newline at end of file diff --git a/docs/products/h2/setup/getting-started.md b/docs/products/h2/setup/getting-started.md index 5d53015591..47d8767876 100755 --- a/docs/products/h2/setup/getting-started.md +++ b/docs/products/h2/setup/getting-started.md @@ -8,7 +8,7 @@ description: H-2 Getting Started tutorial. Insert a rechargeable RC-CR123A (16340) battery, preferably an 850 mAh model like the one available in our store. A normal CR123A will not work! -![](/assets/h-2-insert-battery.webp) +![Hands pressing a rechargeable 16340 battery into the H-2 battery holder](/assets/h-2-insert-battery.webp) **2\. Turning On the Ornament** diff --git a/docs/products/h2/troubleshooting/boot-mode.md b/docs/products/h2/troubleshooting/boot-mode.md index 9306b75fc7..fda8f96739 100755 --- a/docs/products/h2/troubleshooting/boot-mode.md +++ b/docs/products/h2/troubleshooting/boot-mode.md @@ -18,7 +18,7 @@ description: Step by step guide for putting The H-2 In Boot Mode. 3\. Push and hold the boot button (the right button). While still holding the button down, plug in a USB-C cable into the USB-C port of your H-2 then let go of the button. -![](/assets/h-2-boot-mode-method-1-boot-button.webp) +![Holding the boot button on the H-2 while plugging a USB-C cable into it](/assets/h-2-boot-mode-method-1-boot-button.webp) 4\. You are now ready to reflash your device! @@ -28,11 +28,11 @@ description: Step by step guide for putting The H-2 In Boot Mode. 1\. Plug in a USB cable that supports power and data into your computer and connect the other end to your H-2. With the device facing you, locate the reset (left) and boot (right) buttons. -![](/assets/h-2-reset-and-boot-buttons-labeled.png) +![H-2 board with arrows marking the Reset button on the left and the Boot button on the right](/assets/h-2-reset-and-boot-buttons-labeled.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. -![](/assets/h-2-boot-mode-method-2-boot-reset-buttons.webp) +![Holding the H-2 boot button while pressing and releasing the reset button, with USB-C connected](/assets/h-2-boot-mode-method-2-boot-reset-buttons.webp) 3\. You are now ready to reflash your device! diff --git a/docs/products/h2/troubleshooting/reflash.md b/docs/products/h2/troubleshooting/reflash.md index 12c291d4ac..2bd64bb804 100755 --- a/docs/products/h2/troubleshooting/reflash.md +++ b/docs/products/h2/troubleshooting/reflash.md @@ -14,21 +14,21 @@ description: Step by step guide for re-flashing the H-2 back to factory firmware 3\. Push and hold the boot button (the right button). While still holding the button down, plug in a USB-C cable into the USB-C port of your H-2 then let go of the button. -![](/assets/h-2-boot-mode-method-1-boot-button.webp) +![Holding the boot button on the H-2 while plugging a USB-C cable into it](/assets/h-2-boot-mode-method-1-boot-button.webp) 4\. Navigate to our installer page using a chromium based browser such as Chrome or Edge and click **connect** under **H-2 Smart Wi-Fi Firmware** or **H-2 No Wi-Fi Firmware**. Select the open com port and click **connect**. [Click here to head to the reflashing site!](https://apolloautomation.github.io/H-2/){ .md-button .md-button--primary } -![](/assets/h-2-reflash-installer-connect.gif) +![Apollo H-2 Installer page: clicking Connect, picking the serial port, and the device menu opening](/assets/h-2-reflash-installer-connect.gif) 5\. Click Install **H-2** then click **Install** again. -![](/assets/h-2-reflash-install.gif) +![Clicking Install ApolloAutomation.H-2, confirming Install, and the installer erasing the device](/assets/h-2-reflash-install.gif) 6\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/pump-1-reflash-install-complete.png) +![Web installer dialog showing Installation complete with a Next button](/assets/pump-1-reflash-install-complete.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/led1/examples/led-1-controlling-govee-lights.md b/docs/products/led1/examples/led-1-controlling-govee-lights.md index 91a9b8dce9..de7d20d282 100755 --- a/docs/products/led1/examples/led-1-controlling-govee-lights.md +++ b/docs/products/led1/examples/led-1-controlling-govee-lights.md @@ -4,11 +4,11 @@ description: >- How to use the Apollo LED-1 to control your Govee/3rd Party permanent outdoor LED lights! --- -![](/assets/led-1-govee-barrel-1.jpg)This is a guide to show you how to use the Apollo LED-1 to control your Govee permanent outdoor lights fully locally and without the need of a cloud based app. +![LED-1 with red and black barrel plug wires in the WAGO input connector, tweezers pressing the lever](/assets/led-1-govee-barrel-1.jpg)This is a guide to show you how to use the Apollo LED-1 to control your Govee permanent outdoor lights fully locally and without the need of a cloud based app. 1\. Items we will need for this project. -![](/assets/led-1-govee-items.jpg) +![Project parts laid out: project box, LED-1, tweezers, wire strippers, hobby knife, screwdriver, and cables](/assets/led-1-govee-items.jpg) \- **Apollo LED-1:** https://apolloautomation.com/products/led-1-led-controller

\- **Govee permanent lights:** https://www.amazon.com/Govee-Permanent-Lighting-Waterproof-Assistant/dp/B0DX1WPB9J?th=1

\- **Project box:** https://www.amazon.com/dp/B075DJDT99?ref=fed\_asin\_title&th=1

\- **Barrel plug connector:** https://www.amazon.com/Tugermoola-Threaded-Female-Connector-Adapter/dp/B0D9B7WR23?crid=3OR009XXFZQEF&dib=eyJ2IjoiMSJ9.e5X\_-XWXnB0xBvcSvAvZ55hSjlvd6UzliF-J4c3T3lMAnN0l1TGidk3aJVGRL0GbuOtjayYg4geWqzYV0h6n5GExQBc\_M9LNQWkhMf3dM2\_terh12U-epCikbBTwuTlUmsTSHtmptZdq9Kgidev7ANMjC\_R273mJIMboppBQDsU5LGGll-Opu4SqA7A6hrqgXGDwY38FgtprDsGkQBKJ8ssuIcnegX2gWyZvRd\_tjqk.\_DEjYBsY9V-fP-UNB8aAmKPDi\_DfQ7wuw0-mqq2PtlE&dib\_tag=se&keywords=female%2Bbarrel%2Bplug%2Bconnector%2B24v&qid=1762897344&refinements=p\_85%3A2470955011&rnid=2470954011&rps=1&sprefix=female%2Bbarrel%2Bplug%2Bconnector%2B24v%2Caps%2C101&sr=8-5&th=1

\- **White 3 wire LED connecting wire:** https://www.amazon.com/NEWNEWLIU-Waterproof-Connector-Electrical-Outdoor/dp/B0D6RBKRGQ?ie=UTF8&th=1 @@ -18,21 +18,21 @@ description: >- 2\. Remove the project box lid by unscrewing the 4 screws. -![](/assets/led-1-govee-unscrew-lid-1.jpg) +![Screwdriver removing one of the four screws on the white project box lid](/assets/led-1-govee-unscrew-lid-1.jpg) 3\. Remove two of the rubber grommets and cut a small slit using the hobby knife to allow for the power and data connections. The two bottom grommets might be best for an outdoor setup to prevent any water from getting in. -![](/assets/led-1-govee-grommets.jpg) +![Hobby knife cutting a slit in a rubber grommet removed from the project box](/assets/led-1-govee-grommets.jpg) 4\. Connect the barrel plug to the WAGO connector. It is the large white compnent on the bottom left of the board below the USB-C port. Connect the RED (+) wire to the top terminal and the BLACK (-) wire to the bottom terminal. You can use the tweezers to depress the top of the WAGO connector, insert the wire, and then release to lock it in place. -![](/assets/led-1-govee-barrel-2.jpg) +![Tweezers pressing the WAGO lever on the LED-1 to insert the red and black barrel plug wires](/assets/led-1-govee-barrel-2.jpg) 5\. Remove the cable sheathing of the 3 pin LED connector using the hobby knife. Be careful when cutting, because the cable can roll. -![](/assets/led-1-govee-cable-cut.jpg) +![Hobby knife cutting the sheathing off the white 3-pin LED connector](/assets/led-1-govee-cable-cut.jpg) -![](/assets/led-1-govee-cable-off.jpg) +![White 3-pin LED connector with the sheathing removed, showing three brass pins](/assets/led-1-govee-cable-off.jpg) 6\. diff --git a/docs/products/led1/introduction.md b/docs/products/led1/introduction.md index c6632eb5bb..6fc998d72d 100755 --- a/docs/products/led1/introduction.md +++ b/docs/products/led1/introduction.md @@ -4,7 +4,7 @@ description: Documentation for LED-1, including setup, usage, and best practices --- # Introduction -![](/assets/led-1-pcb.png) +![3D render of the LED-1 board with USB-C port, switch, reset and boot buttons, and Wago connectors](/assets/led-1-pcb.png) The Apollo LED-1 is a compact, versatile LED Controller for Home Assistant. Fully open-source and expandable, the LED-1 offers seamless integration with Home Assistant using the WLED Integration, making it ideal for automating lighting. Access to support and customization resources is available via our Discord and GitHub. diff --git a/docs/products/led1/setup/getting-started-led1.md b/docs/products/led1/setup/getting-started-led1.md index 373a35bcb5..259d113051 100755 --- a/docs/products/led1/setup/getting-started-led1.md +++ b/docs/products/led1/setup/getting-started-led1.md @@ -48,7 +48,7 @@ The LED-1 can be powered via USB (5V up to 3 amps) or via USB Power Delivery (5V 1\. Grab a male JST-SM 3 pin connector such as the extra included with your led strips and carefully note the red wire for positive, the green for data, and the white for ground. -![](/assets/jst-sm-power-data-ground-labeled.png) +![Red, green, and white LED wires labeled Power, Data, and Ground](/assets/jst-sm-power-data-ground-labeled.png) 2\. Inspect the LED-1 and look for the two Wago connectors labeled "Output 1" and "Output 2". Insert the red power wire into the far left terminal of output 1 then the green wire into the middle terminal of Output 1 then the white wire into the third terminal for Output 1. @@ -60,7 +60,7 @@ Your device is now ready to connect to your Wi-Fi and begin controlling via Home 1\. Plug your power supply or usb-c power in and the LED-1 device will boot within a couple seconds. Head to the available Wi-Fi networks on your phone and select WLED-AP. It should pop up saying "Welcome to WLED!". If this popup does not occur, please open a web browser and navigate to http://4.3.2.1/ and you should be prompted with the same image seen below. -![](/assets/led-1-getting-started-pic-1.png) +![WLED Welcome to WLED page with WiFi Settings and To the Controls buttons](/assets/led-1-getting-started-pic-1.png) ### Join to Home Assistant diff --git a/docs/products/led1/setup/led1-replace-fuse.md b/docs/products/led1/setup/led1-replace-fuse.md index 7cec67a8e6..63f38fe332 100755 --- a/docs/products/led1/setup/led1-replace-fuse.md +++ b/docs/products/led1/setup/led1-replace-fuse.md @@ -6,39 +6,39 @@ description: Tutorial showing how to replace the 10 A Fuse on the LED-1. 1\. Gently pry open the lid - this can be a tight fit so you will want to use a small tool not your fingernail. Remove the lid and set aside. -![](/assets/led-1-pry-open-lid.jpg)![](/assets/led-1-case-with-lid-off.jpg) +![Tweezers prying the lid off the blue LED-1 case](/assets/led-1-pry-open-lid.jpg)![LED-1 board in the blue case with the lid removed and set aside](/assets/led-1-case-with-lid-off.jpg) 2\. Gently lift the LED-1 PCB out of the case - be careful not use a lot of force this could break components -![](/assets/led-1-lift-out-of-case.jpg) +![Fingers lifting the LED-1 board out of its blue case](/assets/led-1-lift-out-of-case.jpg) 3\. Flip the LED-1 PCB over and locate the replaceable fuse. -![](/assets/led-1-pcb-back-point-to-fuse.jpg) +![Back of the LED-1 board with tweezers pointing to the 10 A fuse in its holder](/assets/led-1-pcb-back-point-to-fuse.jpg) 4\. Gently remove the fuse using tweezers. -![](/assets/led-1-remove-fuse-1.jpg)![](/assets/led-1-remove-fuse-2.jpg) +![Tweezers gripping the fuse to pull it out of the LED-1 fuse holder](/assets/led-1-remove-fuse-1.jpg)![Tweezers lifting the old fuse clear of the LED-1 fuse holder](/assets/led-1-remove-fuse-2.jpg) 5\. Orient the new fuse with the writing facing up then place it inside the fuse bay. -![](/assets/led-1-place-new-fuse-1.jpg) +![Tweezers placing a new fuse, writing facing up, into the LED-1 fuse bay](/assets/led-1-place-new-fuse-1.jpg) 6\. Gently push down on the fuse to make sure it is fully seated. -![](/assets/led-1-place-new-fuse-2.jpg) +![Tweezers pressing the new fuse down until it is fully seated in the LED-1 fuse bay](/assets/led-1-place-new-fuse-2.jpg) 7\. Flip PCB over and angle it the same way you disassembled and rest the side of the pcb on the "shelf" as shown in the image below. -![](/assets/led-1-angle-back-in-case.jpg) +![LED-1 board angled back into the blue case, resting on the inner shelf](/assets/led-1-angle-back-in-case.jpg) 8\. Align the holes on the case so they line up with the Wago connectors. -![](/assets/led-1-align-case-lid.jpg) +![Lining up the blue lid openings with the Wago connectors on the LED-1](/assets/led-1-align-case-lid.jpg) 9\. Press down on the case lid to secure it to the bottom of the case. -![](/assets/led-1-secure-lid-to-case.jpg) +![Thumb pressing the blue lid onto the LED-1 case, with RST, BT, and terminal labels](/assets/led-1-secure-lid-to-case.jpg) 10\. You're all done - enjoy your LED-1! diff --git a/docs/products/led1/troubleshooting/led1-find-ip-address-and-hostname.md b/docs/products/led1/troubleshooting/led1-find-ip-address-and-hostname.md index ddbe4ec666..ea2291c9aa 100755 --- a/docs/products/led1/troubleshooting/led1-find-ip-address-and-hostname.md +++ b/docs/products/led1/troubleshooting/led1-find-ip-address-and-hostname.md @@ -18,7 +18,7 @@ description: Step by step guide for finding the IP address and the hostname of y 3\. Your LED-1 should be detected automatically. Select it, then click the **Config** tab in the top right corner. -![](/assets/m-1-find-ip-hostname-gif.webp) +![WLED Native app: selecting a device, tapping Config, then WiFi Setup to show the hostname and IP](/assets/m-1-find-ip-hostname-gif.webp) !!! danger "WARNING ~ DO NOT UPDATE IT ~ WARNING" @@ -26,10 +26,10 @@ description: Step by step guide for finding the IP address and the hostname of y 4\. Select **WiFi Setup** and at the bottom you will see a box with .local at the end. The letters inside of the box are your hostname and the IP is directly below it. You can change the hostname to whatever you like (using letters, numbers, and dashes only). Click Save and Connect when done. -![](/assets/m-1-wled-native-combined-wifi-ip-hostname.png) +![WLED Native Config menu with WiFi Setup highlighted, and the page showing the mDNS hostname and client IP](/assets/m-1-wled-native-combined-wifi-ip-hostname.png) 5\. You can now access your device from a browser at http://the-ip-address-here or http://the-hostname-you-entered.local 6\. Edit the User Interface settings section under the **Server description** with a friendly name that is shown for your device! -![](/assets/m-1-wled-native-app-server-description-name-change.png) \ No newline at end of file +![WLED Native User Interface settings with the Server description field highlighted](/assets/m-1-wled-native-app-server-description-name-change.png) \ No newline at end of file diff --git a/docs/products/led1/troubleshooting/led1-reflash.md b/docs/products/led1/troubleshooting/led1-reflash.md index cab11c4a05..b79ed21fe5 100755 --- a/docs/products/led1/troubleshooting/led1-reflash.md +++ b/docs/products/led1/troubleshooting/led1-reflash.md @@ -16,15 +16,15 @@ description: Step by step guide for re-flashing the LED-1 back to factory firmwa 5\. Click the **Serial Port** dropdown and choose the available COM port.. -![](/assets/m-1-select-open-com-port.png) +![ESP Flasher window with COM12 selected in the Serial port dropdown](/assets/m-1-select-open-com-port.png) 6\. Browse to the firmware file from Step 3 and select it. -![](/assets/m-1-select-firmware-you-downloaded.png) +![ESP Flasher Firmware field showing the downloaded WLED .bin file after clicking Browse](/assets/m-1-select-firmware-you-downloaded.png) 7\. Click **Flash ESP** and wait for the process to complete. Once it's done, it will appear as shown in the image below. -![](/assets/m-1-reflash-completed.png) +![ESP Flasher console reading Done! Flashing is complete after the write reaches 100 percent](/assets/m-1-reflash-completed.png) 8\. The device is still in **boot mode** and needs to be power cycled. To reboot it, either unplug the power cable or press the **reset button** on the back of the device (the button on the right). diff --git a/docs/products/m1/addons/adding-microphone-to-m-1.md b/docs/products/m1/addons/adding-microphone-to-m-1.md index c001a160a7..825008eb90 100755 --- a/docs/products/m1/addons/adding-microphone-to-m-1.md +++ b/docs/products/m1/addons/adding-microphone-to-m-1.md @@ -12,7 +12,7 @@ The microphone addon fits Rev6 and newer controllers. Rev4 boards do not have th 2\. Insert the microphone addon as shown in the image below. Make sure the Microphone image is facing to the right side and the GND pin is on the bottom right! -![](/assets/m-1-microphone-addon-image.jpg) +![Round microphone addon installed on the M-1 controller with the GND pin at the bottom right](/assets/m-1-microphone-addon-image.jpg) ###### Turn It On @@ -22,7 +22,7 @@ The microphone addon fits Rev6 and newer controllers. Rev4 boards do not have th If nothing reacts, confirm the microphone board is seated all the way into its connector, then click **Config**, then **Usermods**, and find **AudioReactive**. These are the settings your M-1 ships with, so use them to check nothing has been changed. - ![](/assets/wled-16-audio-microphone-settings.png) + ![WLED AudioReactive settings: Generic I2S with SD pin 10, WS pin 12, and SCK pin 11](/assets/wled-16-audio-microphone-settings.png) === "WLED-MM" @@ -30,10 +30,10 @@ The microphone addon fits Rev6 and newer controllers. Rev4 boards do not have th 4\. Select **10 digitalmic** for Pin I2s SD, select **12 digitalmic A5** for Pin I2S WS, and select **11 digitalmic** for Pin I2S SCK and click **Save**. - ![](/assets/m-1-audio-reactive-pin-settings.png) + ![WLED-MM AudioReactive settings with Generic I2S and digitalmic pins 10, 12, and 11 selected](/assets/m-1-audio-reactive-pin-settings.png) 5\. Scroll to the bottom of the **AudioReactive** settings and set the **Mode** to **Off** and click **Save**. - ![](/assets/m-1-audio-reactive-mode-off.png) + ![WLED-MM AudioReactive Sync Mode dropdown with Off selected](/assets/m-1-audio-reactive-mode-off.png) Then pick an effect with a musical note beside it and make some noise. diff --git a/docs/products/m1/addons/wizmote-remote.md b/docs/products/m1/addons/wizmote-remote.md index 5d08602330..a88be44d48 100644 --- a/docs/products/m1/addons/wizmote-remote.md +++ b/docs/products/m1/addons/wizmote-remote.md @@ -28,7 +28,7 @@ The M-1 has no IR receiver, but it does take a Giphy is an easy place to start, and the dancing cat below works as a test. -![](/assets/dancing-cat.gif) +![Animated GIF of a black and white cat standing upright and dancing](/assets/dancing-cat.gif) Getting it onto the matrix depends on your firmware. WLED converts and resizes on the device, WLED-MM needs an external tool first. @@ -27,15 +27,15 @@ Getting it onto the matrix depends on your firmware. WLED converts and resizes o 2\. Head to ezgif.com and click **Resize** then click Browse and choose your gif then click Upload! - ![](/assets/m-1-create-gifs-resize-gifs.gif) + ![ezgif.com Resize page: clicking Browse, choosing the dancing cat GIF, and clicking Upload](/assets/m-1-create-gifs-resize-gifs.gif) 3\. Set the **Width** to **64** and the **Height** to **64** then click **Resize image** then scroll down to the **Resized Image:** section and click the **Save** icon. - ![](/assets/m-1-create-gifs-resize-gifs-save.gif) + ![ezgif.com resize settings at 64 by 64, Resize image clicked, then the Save icon on the result](/assets/m-1-create-gifs-resize-gifs-save.gif) 4\. Rename the gif to something simple such as cat-dance. We will need to input the name as-is in a future step so renaming it to a simple name is best! - ![](/assets/m-1-create-gifs-rename-gif.gif) + ![Renaming the resized GIF file to cat-dance in File Explorer](/assets/m-1-create-gifs-rename-gif.gif) 5\. Open a web browser and navigate to `http://` or `http://.local`. @@ -45,23 +45,23 @@ Getting it onto the matrix depends on your firmware. WLED converts and resizes o 6\. Click **Config**, then scroll down and click **File System** then click **Browse** and select the resized and renamed gif we just created then click **Save**. - ![](/assets/m-1-create-gifs-upload-gif-to-wled.gif) + ![WLED Config, File System, then browsing to the cat-dance GIF and uploading it to the M-1](/assets/m-1-create-gifs-upload-gif-to-wled.gif) 7\. Click the back button on your browser and navigate back to the main page of the M-1 WLED interface. Click in the search bar and type in **image** and select it. - ![](/assets/m-1-create-gifs-select-image-effect.gif) + ![Typing image in the WLED Effect mode search and selecting the Image effect](/assets/m-1-create-gifs-select-image-effect.gif) 8\. Click the **arrow** next to Segment 0 and then click the pencil icon to edit the name. Type in the name exactly as you did in step 4 above such as cat-dance.gif - ![](/assets/m-1-create-gifs-enter-gif-name-as-segment-name.gif) + ![Renaming Segment 0 to cat-dance.gif in WLED so the M-1 plays the GIF](/assets/m-1-create-gifs-enter-gif-name-as-segment-name.gif) 9\. Click on **\+ Preset** and write in any name you want such as Cat Dance then click **Save**. - ![](/assets/m-1-create-gifs-save-gif-as-preset.gif) + ![Clicking + Preset in WLED, naming it Cat Dance, and saving it as preset 1](/assets/m-1-create-gifs-save-gif-as-preset.gif) 10\. To have the M-1 boot straight into this gif, head to **Config** then **LED Preferences** and scroll down until you see **Apply Preset** and put in your preset number for the effect you just made. If this is your first one then put in 1 and then click **Save**. - ![](/assets/m-1-create-gifs-set-preset-as-boot.gif) + ![WLED LED Preferences with the Apply preset at boot field set, then saving](/assets/m-1-create-gifs-set-preset-as-boot.gif) !!! warning "Use a browser, not the WLED phone app" diff --git a/docs/products/m1/examples/pixel-forge.md b/docs/products/m1/examples/pixel-forge.md index beeb4bf0e8..8a5cc4bb0a 100644 --- a/docs/products/m1/examples/pixel-forge.md +++ b/docs/products/m1/examples/pixel-forge.md @@ -12,7 +12,7 @@ Pixel Forge ships inside WLED and runs on the M-1 itself. It converts images to Open it from the icon below the color picker in the WLED interface, or go straight to `http:///pixelforge.htm`. -![](/assets/wled-16-open-pixel-forge.gif) +![Clicking the PixelForge icon below the WLED color picker to open the Pixel Forge Image Tool](/assets/wled-16-open-pixel-forge.gif) Pixel Forge has three of its own tabs: **Image Tool**, **Scrolling Text**, and **Other Tools**. @@ -35,7 +35,7 @@ Turns any image into a GIF the matrix can play. 1. Pixel Forge shows how much filesystem space is left as you go, which matters because the M-1 stores these images on the device. -![](/assets/wled-16-pixel-forge-image-tool.gif) +![Pixel Forge Image Tool: uploading a mountain photo, cropping it, setting 128 x 128, and converting](/assets/wled-16-pixel-forge-image-tool.gif) ## Scrolling Text @@ -47,7 +47,7 @@ Choose your segment under **Target Segment**, type into **Text to show**, and cl The useful part is **Available Tokens**. Insert date, time, or temperature and the text keeps itself current instead of showing a fixed string. For values that come from elsewhere in your house, [push them from Home Assistant over the JSON API](/products/m1/examples/share-data-from-home-assistant.md) instead. -![](/assets/wled-16-pixel-forge-scrolling-text.gif) +![Pixel Forge Scrolling Text tab: typing text, checking the preview, and applying it to a segment](/assets/wled-16-pixel-forge-scrolling-text.gif) ## Other Tools @@ -57,6 +57,6 @@ Downloads extra utilities onto the M-1. Whatever you download stays there until Pick your **Target Segment** and canvas size along the top. The color wheel and brush tools run down the left side, with **Size** and **Hard** sliders for the brush, and undo and redo above the canvas. When you are happy, type a **Name** and choose **Save as Preset** or **Save as GIF**. -![](/assets/wled-16-pixel-forge-pixel-paint-hi-mom.gif) +![Pixel Paint drawing Hi Mom in orange on the canvas, then saving it as a preset named hi-mom](/assets/wled-16-pixel-forge-pixel-paint-hi-mom.gif) On WLED-MM the equivalent workflow is [resizing a GIF externally and uploading it](/products/m1/examples/add-gifs-to-wled.md). diff --git a/docs/products/m1/examples/scrolling-text.md b/docs/products/m1/examples/scrolling-text.md index b35a71cac2..31ac283b45 100755 --- a/docs/products/m1/examples/scrolling-text.md +++ b/docs/products/m1/examples/scrolling-text.md @@ -18,23 +18,23 @@ description: Step by step guide to adding a WLED Preset for custom scrolling tex 1\. Open a web browser and navigate to `http://` or `http://.local`. -![](/assets/m-1-wled-gui.png) +![WLED web interface for the M-1 with color wheel, Effect mode list, Segments, and Presets](/assets/m-1-wled-gui.png) 2\. Click the search box under **Effect mode**, type **"Scrolling Text"**, and select it from the list. -![](/assets/m-1-wled-choose-scrolling-text.png) +![WLED Effect mode search with Scrolling Text typed in and the effect selected](/assets/m-1-wled-choose-scrolling-text.png) 3\. Once selected, your matrix will show the current date in orange text. -![](/assets/m-1-scrolling-text-stock-text.jpg) +![M-1 LED Matrix showing the default scrolling date text in red](/assets/m-1-scrolling-text-stock-text.jpg) 4\. Look on the right side of the screen and click the pencil icon beside "Segment 0". -![](/assets/m-1-wled-scrolling-text-edit-segment-name.png) +![Red arrow pointing to the pencil icon beside Segment 0 in WLED](/assets/m-1-wled-scrolling-text-edit-segment-name.png) 5\. Type in anything you want to scroll on the M-1 such as "Apollo Rocks!". Click on the Check button when you're done and it will update the M-1 LED Matrix with your new text. WLED caps this at 64 characters, and WLED-MM at 32. -![](/assets/m-1-wled-scrolling-text-check-box-to-save-scrolling-text.png) +![WLED segment renamed Apollo Rocks! with the check button highlighted to save it](/assets/m-1-wled-scrolling-text-check-box-to-save-scrolling-text.png) !!! example "Edit settings to fully customize your M-1 with Scrolling Text!" @@ -46,18 +46,18 @@ description: Step by step guide to adding a WLED Preset for custom scrolling tex 4\. **Font size**: Size of the font. 222 looks good! -![](/assets/m-1-wled-scrolling-text-effect-sliders.png) +![The four Scrolling Text effect sliders highlighted in red in WLED](/assets/m-1-wled-scrolling-text-effect-sliders.png) 6\. To customize the text's Color, Background Color, and Gradient, just click the Fx, Bg, and Gr circles and choose your colors using the color picker! -![](/assets/m-1-matrix-scrolling-text-example-fx-bg-gr-gif.gif) +![Choosing text, background, and gradient colors with the Fx, Bg, and Gr circles in WLED](/assets/m-1-matrix-scrolling-text-example-fx-bg-gr-gif.gif) 7\. Click on + Preset and write in a name for your new preset such as Apollo Rocks! then click Save. -![](/assets/m-1-matrix-scrolling-text-example-preset-save.gif) +![Clicking + Preset in WLED, naming it Apollo Rocks!, and saving it as preset 4](/assets/m-1-matrix-scrolling-text-example-preset-save.gif) 8\. Here's what your finished product looks like! -![](/assets/m-1-scrolling-text-finished-example-gif.webp) +![M-1 LED Matrix scrolling Apollo Rocks! in blue text across a pink background](/assets/m-1-scrolling-text-finished-example-gif.webp) Want four lines at once instead of one? Split the display first with [Segments](/products/m1/setup/m1-segments.md), then set text on each one. To drive the text from your house rather than typing it, see [Share Data From Home Assistant](/products/m1/examples/share-data-from-home-assistant.md). diff --git a/docs/products/m1/examples/sendspin.md b/docs/products/m1/examples/sendspin.md index 557441e531..c30e28dde8 100644 --- a/docs/products/m1/examples/sendspin.md +++ b/docs/products/m1/examples/sendspin.md @@ -20,7 +20,7 @@ description: Use the M-1 with SendSpin audio visualizers 2\. Head to the Music Assistant dashboard and select one of your media players. Then click the players icon then click the players icon again and check off your Apollo M-1 LED Matrix. -![](../../../assets/sendspin-add-m-1-as-player.gif) +![Music Assistant players panel with the Apollo M-1 checked to join the playing group](../../../assets/sendspin-add-m-1-as-player.gif) That is it. Play something and the matrix picks up the album art and the track title on its own, switching over every time the song changes. diff --git a/docs/products/m1/examples/share-data-from-home-assistant.md b/docs/products/m1/examples/share-data-from-home-assistant.md index df2aec1a16..24b1711492 100755 --- a/docs/products/m1/examples/share-data-from-home-assistant.md +++ b/docs/products/m1/examples/share-data-from-home-assistant.md @@ -20,7 +20,7 @@ Each line is capped at **64 characters** on WLED and **32** on WLED-MM, which is 1\. Install **Studio Code Server** from the App Store in Home Assistant. Click **Open Web UI** and navigate to your `configuration.yaml`. -![](/assets/m1-navigate-to-configuration-yaml.gif) +![Opening Studio Code Server from Home Assistant and selecting configuration.yaml](/assets/m1-navigate-to-configuration-yaml.gif) !!! danger "This file is used by Home Assistant and must be carefully edited." @@ -32,25 +32,25 @@ Each line is capped at **64 characters** on WLED and **32** on WLED-MM, which is 3\. Back in `configuration.yaml`, paste the generated YAML on a new line at the bottom of the file and save. -![](/assets/m-1-matrix-automation-example-yaml.png) +![configuration.yaml with a rest_command block sending four segment texts to the M-1](/assets/m-1-matrix-automation-example-yaml.png) 4\. Open **Developer Tools** and run **Check Configuration**. A green response means you are clear to continue. Then reload your new command from the **YAML** tab by clicking **RESTful Commands**, or restart Home Assistant. Until you do, the command will not show up in the next step. 5\. Still in **Developer Tools**, scroll down to **Restful Command**, click **Actions** at the top, type "matrix", select the command you just created, and click **Perform Action**. Your text should appear on the matrix straight away. -![](/assets/m1-config-check-restful-actions-gif.gif) +![Developer Tools: Check Configuration, reloading RESTful commands, then running matrix_all_segments](/assets/m1-config-check-restful-actions-gif.gif) 6\. Create an **Automation** with a time pattern trigger that fires every minute. -![](/assets/m-1-matrix-automation-example-trigger.gif) +![Creating a new automation with a time pattern trigger that fires every minute](/assets/m-1-matrix-automation-example-trigger.gif) 7\. Add an action, type *matrix*, and pick **RESTful command: matrix\_all\_segments**. Save and name the automation. The matrix now refreshes every minute. -![](/assets/m-1-matrix-automation-example-action.gif) +![Adding the RESTful command matrix_all_segments action and saving the automation](/assets/m-1-matrix-automation-example-action.gif) Here is the finished board on a two panel setup, four segments each pulling a different entity. -![](/assets/m1-share-data-home-assistant-result.webp) +![Two-panel M-1 showing weather, front door lock, CO2, and ping status lines in different colors](/assets/m1-share-data-home-assistant-result.webp) ###### Tuning It diff --git a/docs/products/m1/setup/getting-started-m1-esphome.md b/docs/products/m1/setup/getting-started-m1-esphome.md index fee7c0d367..7932e1157c 100644 --- a/docs/products/m1/setup/getting-started-m1-esphome.md +++ b/docs/products/m1/setup/getting-started-m1-esphome.md @@ -14,7 +14,7 @@ This guide walks you through replacing the stock WLED firmware with [hub75-studi Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damage in shipping. Gently attach the controller to the back of the M-1 LED Matrix panel as shown in the GIF below. -![](/assets/m1-matrix-attach-controller.webp) +![Hands pressing the M-1 controller onto the back of the M-1 LED Matrix panel](/assets/m1-matrix-attach-controller.webp) ### Flash the firmware @@ -26,13 +26,13 @@ Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damag 2\. Pick the **Rev6** firmware, click **Connect**, select the M-1's COM port, and follow the installer prompts to flash. -![](../../../assets/m-1-esphome-install-firmware.gif) +![HUB75 Studio installer: selecting M-1 Rev6, clicking Connect, choosing the port, and installing](../../../assets/m-1-esphome-install-firmware.gif) 3\. Confirm the M-1 BIOS screen Once the firmware finishes installing, the panel displays the **M-1 BIOS** splash showing the CPU, RAM, and the last 6 characters of the controller's MAC address. Seeing this screen confirms the firmware installed successfully. -![](../../../assets/m-1-esphome-firmware-installed-no-wifi.jpg) +![M-1 showing the M-1 BIOS screen with version, CPU, RAM, and ID after flashing](../../../assets/m-1-esphome-firmware-installed-no-wifi.jpg) ### Connect to Wi-Fi @@ -40,11 +40,11 @@ Once the firmware finishes installing, the panel displays the **M-1 BIOS** splas 2\. The captive portal opens automatically. Either pick your home network from the scanned list and enter the password, or scroll down and type your SSID and password manually. -![](../../../assets/m-1-esphome-firmware-connect-wifi.webp) +![Phone joining the apollo-m1-r6 hotspot and entering Wi-Fi details in the captive portal](../../../assets/m-1-esphome-firmware-connect-wifi.webp) 3\. Tap **Save**. The M-1 reboots and joins your home network. Once you see the screen with the clock move on to the next section to join to Home Assistant via the ESPHome integration! -![](../../../assets/m-1-esphome-firmware-wifi-connected.jpg) +![M-1 showing the clock and date after joining Wi-Fi](../../../assets/m-1-esphome-firmware-wifi-connected.jpg) ### Join to Home Assistant @@ -56,7 +56,7 @@ Your device should be auto-discovered by Home Assistant using the ESPHome Integr Head to the Integrations page in Home Assistant and accept the discovery prompt for your M-1. -![](../../../assets/m-1-esphome-firmware-add-to-esphome-integration.gif) +![Home Assistant ESPHome integration: adding the discovered Apollo M-1 and finishing setup](../../../assets/m-1-esphome-firmware-add-to-esphome-integration.gif) ### Optional Features @@ -72,11 +72,11 @@ Head to the settings -> Apps -> Click Install App -> 3 dots -> click repositories -> click Add -> paste in https://github.com/stuartparmenter/homeassistant-addons -![](../../../assets/add-media-proxy-custom-repo.gif) +![Home Assistant App store menu, Repositories, then adding the Media Proxy repository URL](../../../assets/add-media-proxy-custom-repo.gif) 2\. Click the back button then search Media Proxy and click on it. Click Install and let it install. -![](../../../assets/install-media-proxy-app.gif) +![Searching the Home Assistant App store for Media Proxy and clicking Install](../../../assets/install-media-proxy-app.gif) 3\. Check off Watchdog and Auto Update then click Start -![](../../../assets/media-proxy-start.gif) +![Media Proxy app page: turning on Watchdog and Auto update, then clicking Start](../../../assets/media-proxy-start.gif) 4\. To test that it's working, head to the ESPHome integration page then select your M-1 device from the list. Copy this url and paste it into the Media Source box. It should automatically start playing the gif! -![](../../../assets/m-1-esphome-media-proxy-confirm-working.gif) +![M-1 device page in the ESPHome integration with a GIF URL pasted into Media Source](../../../assets/m-1-esphome-media-proxy-confirm-working.gif) -![](../../../assets/matrix-gif-example.gif) +![M-1 LED Matrix playing a green-tinted Matrix movie GIF](../../../assets/matrix-gif-example.gif) [Click here to learn what all you can do with the Media Proxy!](https://wiki.apolloautomation.com/products/m1/examples/media-proxy/){ .md-button .md-button--primary } @@ -130,11 +130,11 @@ The M-1 ESPHome firmware has built-in support for the http://4.3.2.1/ or http://wled.me and you should be prompted with the same image seen below. - ![](/assets/m-1-getting-started.png) + ![Welcome to WLED page with the WIFI SETTINGS and TO THE CONTROLS buttons](/assets/m-1-getting-started.png) 2\. Tap on **WI-FI Settings** then input your Wi-Fi SSID where it shows **Your\_Network** and input your Wi-Fi password directly below it and then click **Save and Connect**. @@ -82,11 +82,11 @@ Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damag 1\. Click on **Config**, then **LED Preferences**. set **Chain Length** to **1** then uncheck the "enable automatic brightness limiter and click **Save**. Make sure to select **Hub75Matrix** is set to **64x64**. - ![](/assets/m-1-led-settings.gif) + ![WLED LED Preferences set to Hub75Matrix 64x64 and Chain Length 1, brightness limiter unchecked, then saved](/assets/m-1-led-settings.gif) 2\. Click on **Config**, then **2D Configuration**. Select **2D Matrix**, click the circle next to **Basic**, change the **Panel dimensions (WxH)** to **64 x 64** and click **Save**. - ![](/assets/m-1-2d-settings.gif) + ![WLED 2D Configuration set to 2D Matrix with Basic interface and 64 x 64 panel dimensions, then saved](/assets/m-1-2d-settings.gif) ### Join to Home Assistant @@ -96,11 +96,11 @@ Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damag Open your Home Assistant instance and show your integrations. - ![](/assets/m-1-home-assistant-integration-setup.gif) + ![Adding the discovered Apollo M-1 WLED device in Home Assistant, assigning an area, and finishing](/assets/m-1-home-assistant-integration-setup.gif) 2\. From this page you can control your M-1 in Home Assistant. Change the color, pick effects, run presets, and more. - ![](/assets/m-1-home-assistant-example-usage.gif) + ![Changing presets, intensity, and color palette on the M-1 device page in Home Assistant](/assets/m-1-home-assistant-example-usage.gif) === "WLED-MM" @@ -108,23 +108,23 @@ Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damag Open your Home Assistant instance and show your integrations. - ![](/assets/m-1-setup-wled-integration-add-device.png) + ![Discovered Apollo LED Matrix WLED device in Home Assistant with the Add button](/assets/m-1-setup-wled-integration-add-device.png) 2\. Click **Add**, then **Submit**. - ![](/assets/m-1-setup-wled-integration-click-submit.png) + ![Discovered WLED device dialog in Home Assistant with the Submit button highlighted](/assets/m-1-setup-wled-integration-click-submit.png) 3\. Give it a name and a location, then click **Skip** and **Finish**. - ![](/assets/m-1-setup-wled-integration-name-location-finish.png) + ![Home Assistant Device created dialog naming the M-1 Apollo Matrix, with an area set and the Skip and Finish button](/assets/m-1-setup-wled-integration-name-location-finish.png) 4\. Open the WLED integration page and click your M-1. - ![](/assets/m-1-setup-wled-integration-click-device-2.png) + ![Selecting the Apollo M-1 device on the WLED integration page in Home Assistant](/assets/m-1-setup-wled-integration-click-device-2.png) 5\. From here you can change the color, pick effects, run presets, and more. - ![](/assets/m-1-setup-wled-integration-test-device.png) + ![M-1 controls in Home Assistant with the power toggle, Playlist, and Preset menu](/assets/m-1-setup-wled-integration-test-device.png) #### What Next diff --git a/docs/products/m1/setup/m1-matrix-settings.md b/docs/products/m1/setup/m1-matrix-settings.md index 9d2d54248c..06ba9d6954 100755 --- a/docs/products/m1/setup/m1-matrix-settings.md +++ b/docs/products/m1/setup/m1-matrix-settings.md @@ -11,7 +11,7 @@ These are the settings that make the HUB75 panel display correctly. You need the Click on **Config**, then **User Interface**. In the **Server description** field, enter the name you want your M-1 device to display as in the WLED interface, such as **Apollo LED Matrix**. It ships as **Apollo M-1**, so this is only worth changing if you want something else. -![](/assets/m-1-user-interface-settings.gif) +![Setting the WLED Server description to Apollo LED Matrix under Config, User Interface, then saving](/assets/m-1-user-interface-settings.gif) ###### Hostname @@ -75,7 +75,7 @@ To change it, click on **Config**, then **WiFi Setup**. In the **mDNS address** Click on **Config**, then **LED Preferences**. Select **Hub75Matrix 64x64** and set **Chain Length** to **1** then uncheck the "enable automatic brightness limiter and click **Save**. - ![](/assets/m-1-led-settings.gif) + ![WLED LED Preferences set to Hub75Matrix 64x64 and Chain Length 1, brightness limiter unchecked, then saved](/assets/m-1-led-settings.gif) ###### 2D Settings @@ -91,7 +91,7 @@ To change it, click on **Config**, then **WiFi Setup**. In the **mDNS address** Click on **Config**, then **2D Configuration**. Select **2D Matrix**, click the circle next to **Basic**, change the **Panel dimensions (WxH)** to **64 x 64** and click **Save**. - ![](/assets/m-1-2d-settings.gif) + ![WLED 2D Configuration set to 2D Matrix with Basic interface and 64 x 64 panel dimensions, then saved](/assets/m-1-2d-settings.gif) ###### AudioReactive Settings @@ -111,10 +111,10 @@ To change it, click on **Config**, then **WiFi Setup**. In the **mDNS address** For the pins, select **10 digitalmic** for Pin I2s SD, select **12 digitalmic A5** for Pin I2S WS, and select **11 digitalmic** for Pin I2S SCK and click **Save**. - ![](/assets/m-1-audio-reactive-pin-settings.png) + ![WLED AudioReactive settings with Enabled checked, Generic I2S type, and digitalmic pins 10, 12, and 11](/assets/m-1-audio-reactive-pin-settings.png) Scroll to the bottom of the **AudioReactive** settings and set the **Mode** to **Off** and click **Save**. - ![](/assets/m-1-audio-reactive-mode-off.png) + ![WLED AudioReactive Sync Mode menu with Off selected](/assets/m-1-audio-reactive-mode-off.png)   diff --git a/docs/products/m1/setup/m1-multiple-panels.md b/docs/products/m1/setup/m1-multiple-panels.md index 9a4009d491..d4d133d0dc 100755 --- a/docs/products/m1/setup/m1-multiple-panels.md +++ b/docs/products/m1/setup/m1-multiple-panels.md @@ -22,43 +22,43 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a 1\. Set both of your M-1 panels face down - the M-1 controller panel should be on the far left. Start by connecting the data cable (ribbon cable) to the "JOUT" port on the far left panel into the "JIN" port on the second panel. - ![](/assets/two-panels-connect-data-cable.webp) + ![Connecting the ribbon data cable from JOUT on the M-1 controller panel to JIN on the second panel](/assets/two-panels-connect-data-cable.webp) 2\. Gently press the Matrix Power Module over the 4 pin header on the second panel as shown below. Make sure the USB-C port is facing to the right! - ![](/assets/two-panels-connect-power-module.webp) + ![Pressing the Matrix Power Module onto the 4 pin header of the second M-1 panel](/assets/two-panels-connect-power-module.webp) 3\. Plug in the USB-C cable into the M-1 LED Controller and the second Panel. - ![](/assets/two-panels-connect-usb-c.webp) + ![Plugging USB-C cables into the M-1 controller and the power module on the second panel](/assets/two-panels-connect-usb-c.webp) === "Three Panels" 1\. Set all three of your M-1 panels face down - the M-1 controller panel should be on the far left. Start by connecting the data cable (ribbon cable) to the "JOUT" port on the far left panel into the "JIN" port on the second panel. Repeat for connecting the third panel. - ![](/assets/three-panels-connect-data-cable.webp) + ![Connecting ribbon data cables from JOUT to JIN across three M-1 panels in a row](/assets/three-panels-connect-data-cable.webp) 2\. Gently press the Matrix Power Module over the 4 pin header on the second panel as shown below. Make sure the USB-C port is facing to the right! Repeat for connecting the third panel. - ![](/assets/three-panels-connect-power-module.webp) + ![Pressing Matrix Power Modules onto the second and third M-1 panels](/assets/three-panels-connect-power-module.webp) 3\. Plug in the USB-C cable into the M-1 LED Controller, the second panel power module, and the third panel power module. - ![](/assets/three-modules-connect-usb-c.webp) + ![Plugging USB-C cables into the M-1 controller and the power modules on the second and third panels](/assets/three-modules-connect-usb-c.webp) === "Four Panels" 1\. Set all four of your M-1 panels face down - the M-1 controller panel should be on the far left. Start by connecting the data cable (ribbon cable) to the "JOUT" port on the far left panel into the "JIN" port on the second panel. Repeat for connecting the third and fourth panel. - ![](/assets/four-panels-connect-data-cable.webp) + ![Connecting ribbon data cables from JOUT to JIN across four M-1 panels in a row](/assets/four-panels-connect-data-cable.webp) 2\. Gently press the Matrix Power Module over the 4 pin header on the second panel as shown below. Make sure the USB-C port is facing to the right! Repeat for connecting the third and fourth panels. - ![](/assets/four-panels-connect-power-module.webp) + ![Pressing Matrix Power Modules onto the second, third, and fourth M-1 panels](/assets/four-panels-connect-power-module.webp) 3\. Plug in the USB-C cable into the M-1 LED Controller and all three additional panels via the power module USB-C port. - ![](/assets/four-panels-connect-usb-c.webp) + ![Plugging USB-C cables into the M-1 controller and the power modules on the other three panels](/assets/four-panels-connect-usb-c.webp) === "2x2 Grid" @@ -74,7 +74,7 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a 3\. Press a Matrix Power Module onto each of the other three panels and give each one its own USB-C feed. - ![](/assets/m-1-2x2-grid-fully-wired.webp) + ![Back of four M-1 panels wired as a 2x2 grid in printed frames, with ribbon cables, power modules, and USB-C](/assets/m-1-2x2-grid-fully-wired.webp) A 3D printable wall mount system is available on Printables. @@ -84,7 +84,7 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a Click **Config**, then **LED Preferences**. Set **Type** to **HUB75 (Half Scan)** and **Panel (width x height)** to **64 x 64**, leave **Reversed** unchecked, then fill in the rest from your layout and click **Save**. - ![](/assets/wled-2x2-matrix-led-setup.png) + ![WLED LED setup with HUB75 (Half Scan), 64 x 64 panels, 4 panels, and rows x cols set to 2 and 2](/assets/wled-2x2-matrix-led-setup.png) **rows x cols** means what it says. The first box is how many panels **down**, the second is how many **across**, so a row of four panels is **1** then **4**. @@ -102,7 +102,7 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a 1. Set it to four panels here and your content repeats on every panel instead of spanning them. - ![](/assets/wled-2x2-matrix-2d-setup.png) + ![WLED 2D setup with one panel, 1st LED Top Left, Horizontal, Serpentine off, and 128 x 128 dimensions](/assets/wled-2x2-matrix-2d-setup.png) Set **Dimensions (WxH)** to the combined size of your layout. This field is width first, unlike **rows x cols** above. (1) { .annotate } @@ -126,17 +126,17 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a 2\. Click on **Config**, then **LED Preferences**. set **Chain Length** to **2** then **Save**. - ![](/assets/chain-length-2-gif.gif) + ![WLED-MM LED Preferences with Chain Length set to 2, then saved](/assets/chain-length-2-gif.gif) 3\. Click on **Config**, then **2D Configuration** and change the **Panel dimensions (WxH)** to **128 x 64** and click **Save**. Leave **Horizontal panels** and **Vertical panels** at **1**. The combined size goes in the panel dimensions, not the panel counts. **Matrix Dimensions** below should confirm your new total. - ![](/assets/2d-config-128-width.gif) + ![WLED-MM 2D Configuration with Panel dimensions set to 128 x 64, then saved](/assets/2d-config-128-width.gif) 4\. Reboot WLED before proceeding. Tap **Info** at the top, scroll down, and select **Reboot WLED**. When prompted, tap again to confirm the reboot. - ![](/assets/reboot-wled-gif.gif) + ![Opening Info in WLED-MM, selecting Reboot WLED, then confirming the reboot](/assets/reboot-wled-gif.gif) === "Three Panels" @@ -144,17 +144,17 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a 2\. Click on **Config**, then **LED Preferences**. set **Chain Length** to **3** then **Save**. - ![](/assets/chain-length-3-gif.gif) + ![WLED-MM LED Preferences with Chain Length set to 3, then saved](/assets/chain-length-3-gif.gif) 3\. Click on **Config**, then **2D Configuration** and change the **Panel dimensions (WxH)** to **192 x 64** and click **Save**. Leave **Horizontal panels** and **Vertical panels** at **1**. The combined size goes in the panel dimensions, not the panel counts. **Matrix Dimensions** below should confirm your new total. - ![](/assets/2d-config-192-width.gif) + ![WLED-MM 2D Configuration with Panel dimensions set to 192 x 64, then saved](/assets/2d-config-192-width.gif) 4\. Reboot WLED before proceeding. Tap **Info** at the top, scroll down, and select **Reboot WLED**. When prompted, tap again to confirm the reboot. - ![](/assets/reboot-wled-gif.gif) + ![Opening Info in WLED-MM, selecting Reboot WLED, then confirming the reboot](/assets/reboot-wled-gif.gif) === "Four Panels" @@ -162,17 +162,17 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a 2\. Click on **Config**, then **LED Preferences**. set **Chain Length** to **4** then **Save**. - ![](/assets/chain-length-4-gif.gif) + ![WLED-MM LED Preferences with Chain Length set to 4, then saved](/assets/chain-length-4-gif.gif) 3\. Click on **Config**, then **2D Configuration** and change the **Panel dimensions (WxH)** to **256 x 64** and click **Save**. Leave **Horizontal panels** and **Vertical panels** at **1**. The combined size goes in the panel dimensions, not the panel counts. **Matrix Dimensions** below should confirm your new total. - ![](/assets/2d-config-256-width.gif) + ![WLED-MM 2D Configuration with Panel dimensions set to 256 x 64, then saved](/assets/2d-config-256-width.gif) 4\. Reboot WLED before proceeding. Tap **Info** at the top, scroll down, and select **Reboot WLED**. When prompted, tap again to confirm the reboot. - ![](/assets/reboot-wled-gif.gif) + ![Opening Info in WLED-MM, selecting Reboot WLED, then confirming the reboot](/assets/reboot-wled-gif.gif) ###### Segment Setup @@ -192,27 +192,27 @@ If you grew an existing setup rather than starting fresh, the default segment ke 2\. Since we are using two panels, we will begin by editing Segment 0 and setting the Stop X to "128" and the Stop Y to "16" - ![](/assets/two-panels-setup-segment-0.gif) + ![Editing WLED Segment 0 to Stop X 128 and Stop Y 16 for two M-1 panels](/assets/two-panels-setup-segment-0.gif) 3\. Click on Add segment, give it a name (such as Segment 1) then set the Start Y to "16" and the Stop Y to "32". - ![](/assets/two-panels-setup-segment-1.gif) + ![Adding Segment 1 in WLED with Start Y set to 16 and Stop Y set to 32](/assets/two-panels-setup-segment-1.gif) 4\. Click on Add segment, give it a name (such as Segment 2) then set the Start Y to "32" and the Stop Y to "48". - ![](/assets/two-panels-setup-segment-2.gif) + ![Adding Segment 2 in WLED with Start Y set to 32 and Stop Y set to 48](/assets/two-panels-setup-segment-2.gif) 5\. Click on Add segment, give it a name (such as Segment 3) then set the Start Y to "48" and the Stop Y to "64". - ![](/assets/two-panels-setup-segment-3.gif) + ![Adding Segment 3 in WLED with Start Y set to 48 and Stop Y set to 64](/assets/two-panels-setup-segment-3.gif) 6\. You should see four equal segments 0-3 at the top of the screen. - ![](/assets/two-panels-4x-segments.png) + ![WLED segment preview showing four equal segments numbered 0 to 3 as colored bands](/assets/two-panels-4x-segments.png) 7\. Test it by changing the effect to "Scrolling Text" and editing the name of each segment to be any text you want! - ![](/assets/two-panels-example-scrolling-text-setup.gif) + ![Choosing the Scrolling Text effect in WLED and renaming each segment to set its text](/assets/two-panels-example-scrolling-text-setup.gif) !!! warning "Your segments need to be saved to a Preset or they will disappear when you reboot or run other presets." @@ -220,7 +220,7 @@ If you grew an existing setup rather than starting fresh, the default segment ke 8\. Save your segments by creating a new preset. Click on the + Preset button and typing in a name then clicking Save at the bottom. - ![](/assets/two-panels-save-preset.gif) + ![Saving the segments as a new WLED preset named Four Segments 2 Panels](/assets/two-panels-save-preset.gif) === "Three Panels" @@ -228,27 +228,27 @@ If you grew an existing setup rather than starting fresh, the default segment ke 2\. Since we are using three panels, we will begin by editing Segment 0 and setting the Stop X to "192" and the Stop Y to "16". - ![](/assets/three-panels-setup-segment-0.gif) + ![Editing WLED Segment 0 to Stop X 192 and Stop Y 16 for three M-1 panels](/assets/three-panels-setup-segment-0.gif) 3\. Click on Add segment, give it a name (such as Segment 1) then set the Start Y to "16" and the Stop Y to "32". - ![](/assets/three-panels-setup-segment-1-1.gif) + ![Adding Segment 1 in WLED with Start Y set to 16 and Stop Y set to 32](/assets/three-panels-setup-segment-1-1.gif) 4\. Click on Add segment, give it a name (such as Segment 2) then set the Start Y to "32" and the Stop Y to "48". - ![](/assets/three-panels-setup-segment-2-1.gif) + ![Adding Segment 2 in WLED with Start Y set to 32 and Stop Y set to 48](/assets/three-panels-setup-segment-2-1.gif) 5\. Click on Add segment, give it a name (such as Segment 3) then set the Start Y to "48" and the Stop Y to "64". - ![](/assets/three-panels-setup-segment-3.gif) + ![Adding Segment 3 in WLED with Start Y set to 48 and Stop Y set to 64](/assets/three-panels-setup-segment-3.gif) 6\. You should see four equal segments 0-3 at the top of the screen. - ![](/assets/two-panels-4x-segments.png) + ![WLED segment preview showing four equal segments numbered 0 to 3 as colored bands](/assets/two-panels-4x-segments.png) 7\. Test it by changing the effect to "Scrolling Text" and editing the name of each segment to be any text you want! 32 Character maximum limit in WLED. - ![](/assets/two-panels-example-scrolling-text-setup.gif) + ![Choosing the Scrolling Text effect in WLED and renaming each segment to set its text](/assets/two-panels-example-scrolling-text-setup.gif) !!! warning "Your segments need to be saved to a Preset or they will disappear when you reboot or run other presets." @@ -256,7 +256,7 @@ If you grew an existing setup rather than starting fresh, the default segment ke 8\. Save your segments by creating a new preset. Click on the + Preset button and typing in a name then clicking Save at the bottom. - ![](/assets/three-panels-save-preset.gif) + ![Saving the segments as a new WLED preset named Four Segments 3 Panels](/assets/three-panels-save-preset.gif) === "Four Panels" @@ -264,27 +264,27 @@ If you grew an existing setup rather than starting fresh, the default segment ke 2\. Since we are using four panels, we will begin by editing Segment 0 and setting the Stop X to "256" and the Stop Y to "16". - ![](/assets/four-panels-setup-segment-0-1.gif) + ![Editing WLED Segment 0 to Stop X 256 and Stop Y 16 for four M-1 panels](/assets/four-panels-setup-segment-0-1.gif) 3\. Click on Add segment, give it a name (such as Segment 1) then set the Start Y to "16" and the Stop Y to "32". - ![](/assets/four-panels-setup-segment-1.gif) + ![Adding Segment 1 in WLED with Start Y set to 16 and Stop Y set to 32](/assets/four-panels-setup-segment-1.gif) 4\. Click on Add segment, give it a name (such as Segment 2) then set the Start Y to "32" and the Stop Y to "48". - ![](/assets/four-panels-setup-segment-2.gif) + ![Adding Segment 2 in WLED with Start Y set to 32 and Stop Y set to 48](/assets/four-panels-setup-segment-2.gif) 5\. Click on Add segment, give it a name (such as Segment 3) then set the Start Y to "48" and the Stop Y to "64". - ![](/assets/four-panels-setup-segment-3.gif) + ![Adding Segment 3 in WLED with Start Y set to 48 and Stop Y set to 64](/assets/four-panels-setup-segment-3.gif) 6\. You should see four equal segments 0-3 at the top of the screen. - ![](/assets/two-panels-4x-segments.png) + ![WLED segment preview showing four equal segments numbered 0 to 3 as colored bands](/assets/two-panels-4x-segments.png) 7\. Test it by changing the effect to "Scrolling Text" and editing the name of each segment to be any text you want! 32 Character maximum limit in WLED. - ![](/assets/two-panels-example-scrolling-text-setup.gif) + ![Choosing the Scrolling Text effect in WLED and renaming each segment to set its text](/assets/two-panels-example-scrolling-text-setup.gif) !!! warning "Your segments need to be saved to a Preset or they will disappear when you reboot or run other presets." @@ -292,7 +292,7 @@ If you grew an existing setup rather than starting fresh, the default segment ke 8\. Save your segments by creating a new preset. Click on the + Preset button and typing in a name then clicking Save at the bottom. - ![](/assets/four-panels-save-preset.gif) + ![Saving the segments as a new WLED preset named Four Segments 4 Panels](/assets/four-panels-save-preset.gif) === "2x2 Grid" diff --git a/docs/products/m1/setup/m1-segments.md b/docs/products/m1/setup/m1-segments.md index 56baa4d17f..6acf89da20 100755 --- a/docs/products/m1/setup/m1-segments.md +++ b/docs/products/m1/setup/m1-segments.md @@ -18,27 +18,27 @@ Segments work the same on WLED and WLED-MM. The steps below split a single 64x64 2\. Since we are only using *one panel*, we will begin by editing **Segment 0** and setting the **Stop Y** to "16". -![](/assets/one-panel-setup-segment-0.gif) +![Editing WLED Segment 0 to Stop Y 16 on a single M-1 panel](/assets/one-panel-setup-segment-0.gif) 3\. Click on Add segment, give it a name such as **Segment 1** then set the **Start Y** to "16" and the **Stop Y** to "32". -![](/assets/one-panel-setup-segment-1.gif) +![Adding Segment 1 in WLED with Start Y set to 16 and Stop Y set to 32](/assets/one-panel-setup-segment-1.gif) 4\. Click on Add segment, give it a name such as Segment 2 then set the **Start Y** to "32" and the **Stop Y** to "48". -![](/assets/one-panel-setup-segment-2.gif) +![Adding Segment 2 in WLED with Start Y set to 32 and Stop Y set to 48](/assets/one-panel-setup-segment-2.gif) 5\. Click on Add segment, give it a name such as Segment 3 then set the **Start Y** to "48" and the **Stop Y** to "64". -![](/assets/one-panel-setup-segment-3.gif) +![Adding Segment 3 in WLED with Start Y set to 48 and Stop Y set to 64](/assets/one-panel-setup-segment-3.gif) 6\. You should see four equal segments 0-3 at the top of the screen. -![](/assets/two-panels-4x-segments.png) +![WLED segment preview showing four equal segments numbered 0 to 3 as colored bands](/assets/two-panels-4x-segments.png) 7\. Test it by changing the effect to **Scrolling Text** and editing the name of each segment to be any text you want! -![](/assets/two-panels-example-scrolling-text-setup.gif) +![Choosing the Scrolling Text effect in WLED and renaming each segment to set its text](/assets/two-panels-example-scrolling-text-setup.gif) !!! warning "Your segments need to be saved to a Preset or they will disappear when you reboot or run other presets." @@ -46,4 +46,4 @@ Segments work the same on WLED and WLED-MM. The steps below split a single 64x64 8\. Save your segments by creating a new preset. Click on the **\+ Preset** button and typing in a name then clicking **Save** at the bottom. -![](/assets/one-panel-save-preset.gif) +![Saving the four segments as a new WLED preset with the + Preset button](/assets/one-panel-save-preset.gif) diff --git a/docs/products/m1/setup/use-without-wifi.md b/docs/products/m1/setup/use-without-wifi.md index 60534b9c80..691938d332 100644 --- a/docs/products/m1/setup/use-without-wifi.md +++ b/docs/products/m1/setup/use-without-wifi.md @@ -10,7 +10,7 @@ The M-1 does not need a Wi-Fi network. Out of the box it makes its own, and the Plug the M-1 in. The Apollo dog appears for a few seconds, then the panel shows a setup card and keeps showing it until the device is set up. The card has the steps on it along with a QR code. -![](/assets/wled-16-boot-image-preset.webp) +![M-1 panel showing the setup card to join the Apollo M-1 hotspot, then scan the QR code or go to 4.3.2.1](/assets/wled-16-boot-image-preset.webp) 1\. On your phone or laptop, open the Wi-Fi list and join the open network named **Apollo M-1**. There is no password out of the box, though you should [set one](#put-a-password-on-the-hotspot) once you are up and running. (1) { .annotate } diff --git a/docs/products/m1/troubleshooting/m1-boot-mode.md b/docs/products/m1/troubleshooting/m1-boot-mode.md index 00da22d549..2e2a564f41 100755 --- a/docs/products/m1/troubleshooting/m1-boot-mode.md +++ b/docs/products/m1/troubleshooting/m1-boot-mode.md @@ -12,7 +12,7 @@ description: Step by step guide for putting The M-1 In Boot Mode. 2\. Push and hold the boot button (the left button). While still holding the button down, plug in a USB-C cable into the USB-C port of your M-1 LED Matrix then let go of the button. -![](/assets/m-1-hold-boot-webp.webp) +![Holding the boot button on the M-1 controller while plugging in the USB-C cable](/assets/m-1-hold-boot-webp.webp) 3\. You are now ready to reflash your device! diff --git a/docs/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md b/docs/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md index dfeec2d329..b037f9bf15 100755 --- a/docs/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md +++ b/docs/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md @@ -20,7 +20,7 @@ description: >- 3\. The M-1 LED Matrix should be detected automatically. Select it, then click the **Config** tab in the top right corner. -![](/assets/m-1-find-ip-hostname-gif.webp) +![Selecting the M-1 in the WLED Native app, then opening Config and WiFi Setup](/assets/m-1-find-ip-hostname-gif.webp) !!! danger "WARNING ~ DO NOT UPDATE IT ~ WARNING" @@ -28,12 +28,12 @@ description: >- 4\. Select **WiFi Setup** and at the bottom you will see a box with .local at the end. The letters inside of the box are your hostname and the IP is directly below it. You can change the hostname to whatever you like (using letters, numbers, and dashes only). Click Save and Connect when done. -![](/assets/m-1-wled-native-combined-wifi-ip-hostname.png) +![WLED Native app with WiFi Setup highlighted and the mDNS hostname and Client IP boxed at the bottom](/assets/m-1-wled-native-combined-wifi-ip-hostname.png) 5\. You can now access your device from a browser at http://the-ip-address-here or http://the-hostname-you-entered.local 6\. Edit the User Interface settings section under the **Server description** with a friendly name that is shown for your device! -![](/assets/m-1-wled-native-app-server-description-name-change.png) +![WLED Native app User Interface settings with the Server description field highlighted](/assets/m-1-wled-native-app-server-description-name-change.png) [Click here to learn how to add your own image or logo to the M-1](https://wiki.apolloautomation.com/products/m1/examples/pixel-forge/){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/m1/troubleshooting/m1-reflash-esphome.md b/docs/products/m1/troubleshooting/m1-reflash-esphome.md index 19451d2a22..b447df5e2b 100644 --- a/docs/products/m1/troubleshooting/m1-reflash-esphome.md +++ b/docs/products/m1/troubleshooting/m1-reflash-esphome.md @@ -12,7 +12,7 @@ description: Step by step guide for reflashing the M-1 with the hub75-studio ESP 2\. Push and hold the boot button (the left button) on the M-1 controller. While still holding the button, plug the USB-C cable into the M-1, then release the button. -![](/assets/m-1-hold-boot-webp.webp) +![Holding the boot button on the M-1 controller while plugging in the USB-C cable](/assets/m-1-hold-boot-webp.webp) 3\. Open https://pavlov-net.github.io/hub75-studio/ in your Chromium browser. diff --git a/docs/products/m1/troubleshooting/m1-reflash.md b/docs/products/m1/troubleshooting/m1-reflash.md index 45ffa3c950..6f03a5650d 100755 --- a/docs/products/m1/troubleshooting/m1-reflash.md +++ b/docs/products/m1/troubleshooting/m1-reflash.md @@ -12,7 +12,7 @@ description: Step by step guide for re-flashing the M-1 back to factory firmware 2\. Push and hold the boot button (the left button). While still holding the button down, plug in a USB-C cable into the USB-C port of your M-1 LED Matrix then let go of the button. -![](/assets/m-1-hold-boot-webp.webp) +![Holding the boot button on the M-1 controller while plugging in the USB-C cable](/assets/m-1-hold-boot-webp.webp) 3\. Open the Apollo M-1 installer and choose your firmware. New units ship with **WLED 16.0.1**, which is the default. @@ -26,7 +26,7 @@ description: Step by step guide for re-flashing the M-1 back to factory firmware 6\. Once you see "Installation complete!" you are finished. Click **Next**, then close the browser window. -![](/assets/wled-16-firmware-reflash.gif) +![Apollo M-1 installer with WLED 16.0.1 selected, clicking Connect & Install, then Install Apollo M-1 and confirming](/assets/wled-16-firmware-reflash.gif) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/msr1/additional-info/exposed-gpio.md b/docs/products/msr1/additional-info/exposed-gpio.md index 35215f0668..849639f2a3 100755 --- a/docs/products/msr1/additional-info/exposed-gpio.md +++ b/docs/products/msr1/additional-info/exposed-gpio.md @@ -3,7 +3,7 @@ description: "What each exposed GPIO pad on the back of the MSR-1 does, includin --- # Exposed GPIO -![Screenshot 2023-11-18 at 6.33.00 PM.png](/assets/screenshot-2023-11-18-at-6-33-00-pm.png) +![Back of the MSR-1 Rev 8 board with six GPIO pads labeled SLC, IO 5, 5V, GND, 3V3, and SDA](/assets/screenshot-2023-11-18-at-6-33-00-pm.png) The back of the Apollo MSR-1 has exposed GPIO for a variety of uses. diff --git a/docs/products/msr1/addons/adding-co2-to-msr-1.md b/docs/products/msr1/addons/adding-co2-to-msr-1.md index 723a866eea..42281325fb 100755 --- a/docs/products/msr1/addons/adding-co2-to-msr-1.md +++ b/docs/products/msr1/addons/adding-co2-to-msr-1.md @@ -5,18 +5,18 @@ description: "Fit the CO2 module to your MSR-1, with photos showing the connecto 1\. Unplug your MSR-1 from power and remove the back -![IMG_3784.jpeg](/assets/img-3784.jpeg) +![MSR-1 in its open case next to the removed back cover](/assets/img-3784.jpeg) 2\. Remove the board from the case and orientate it like the below image. In the bottom right there is a black connector. There is a x in the lower right corner of the connector -![IMG_3788.jpeg](/assets/img-3788.jpeg) +![MSR-1 board out of the case with the CN3 CO2 connector and its x marking at lower right](/assets/img-3788.jpeg) 3\. Orientate the CO2 module so the white x on the module is also in the lower right and the gold dot is in the upper left as seen below -![IMG_3787.jpeg](/assets/img-3787.jpeg) +![CO2 module oriented with its white x at lower right and gold dot at upper left](/assets/img-3787.jpeg) 4\. Align the connector on the back of the CO2 module with the connector on the MSR-1. Once aligned, push down so the CO2 module fully seats itself -![IMG_3789.jpeg](/assets/img-3789.jpeg) +![CO2 module fully seated on the MSR-1 board in the lower right corner](/assets/img-3789.jpeg) 5\. Put your MSR-1 back in the case and slide the back cover on. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module. \ No newline at end of file diff --git a/docs/products/msr1/examples/msr1-alarmo.md b/docs/products/msr1/examples/msr1-alarmo.md index 9f4a2f7385..e8ee3d2f6f 100755 --- a/docs/products/msr1/examples/msr1-alarmo.md +++ b/docs/products/msr1/examples/msr1-alarmo.md @@ -8,29 +8,29 @@ My grandmother wanted a security system that would alert her when there was move 1\. Install [HACS](https://hacs.xyz/docs/use/download/download/) 2\. Install [Alarmo](https://github.com/nielsfaber/alarmo?tab=readme-ov-file#installation) and the [Alarmo Card](https://github.com/nielsfaber/alarmo-card) (Pretty Arm and Disarm card for your HA dashboard) -![Alarmo 7.png](/assets/alarmo-7.png) +![Alarmo card on a Home Assistant dashboard showing Disarmed with Arm Away and Arm Home buttons](/assets/alarmo-7.png) -![Alarmo 1.png](/assets/alarmo-1.png) +![Alarmo alarm panel General tab in Home Assistant, with Alarmo listed in the sidebar](/assets/alarmo-1.png) 3\. Find Alarmo on the left, select the Sensors tab, and toggle on the sensor entities that you would like to use for your alarm system. -![Alarmo 2.png](/assets/alarmo-2.png) +![Alarmo Sensors tab with MSR-1 radar target entities enabled for the Home arm mode](/assets/alarmo-2.png) 4\. Now select the Actions tab and under Condition > Event > Select "Alarm is triggered". You can also select the device you would like to receive a notification on under Task > Target > Select Device (Phone, tablet, etc.) -![Alarmo 3.png](/assets/alarmo-3.png) +![Alarmo Configure notification screen with the Alarm is triggered event and a phone as the target](/assets/alarmo-3.png) 5\. You can change the Title, Message, and Name of the alarm notification. -![Alarmo 4.png](/assets/alarmo-4.png) +![Alarmo notification settings with the Movement Detected title, alarm message, and notification name](/assets/alarmo-4.png) 6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Uner Entity select your sensors RGB light. -![Alarmo 5.png](/assets/alarmo-5.png) +![Alarmo Configure action screen with the Alarm is triggered event and AIR-1 and MSR-1 RGB lights selected](/assets/alarmo-5.png) 7\. Under Action select Turn On and now your sensors RGB lights will turn on when the alarm is triggered. -![Alarmo 6.png](/assets/alarmo-6.png) +![Alarmo action with Turn On selected for the AIR-1 and MSR-1 RGB light entities](/assets/alarmo-6.png) 8\. And that's it, seriously... Now you can enjoy a free and local security system. diff --git a/docs/products/msr1/examples/msr1-dashboards.md b/docs/products/msr1/examples/msr1-dashboards.md index f9e33b63e3..c765a1a11a 100755 --- a/docs/products/msr1/examples/msr1-dashboards.md +++ b/docs/products/msr1/examples/msr1-dashboards.md @@ -6,7 +6,7 @@ description: "Example Home Assistant dashboard cards for the MSR-1, including an **Radar Scatter Plot With Apex Charts For MSR-1** -![JPE Apex Charts 3.png](/assets/jpe-apex-charts-3.png) +![ApexCharts scatter plot card of MSR-1 radar detection, moving, and still distances over time](/assets/jpe-apex-charts-3.png) ```plaintext type: custom:apexcharts-card @@ -46,7 +46,7 @@ series: **CO2 Charts** Home Assistant Sensor -![CO 2 Graph.png](/assets/co-2-graph.png) +![Home Assistant sensor card with a Bedroom CO2 line graph reading 1,000 ppm](/assets/co-2-graph.png) ```plaintext graph: line @@ -59,7 +59,7 @@ hours_to_show: 24 Custom: Plotly Graph Card -![Plotly CO2 Graph.png](/assets/plotly-co2-graph.png) +![Plotly graph card of Bedroom CO2 in ppm over 24 hours](/assets/plotly-co2-graph.png) ```plaintext type: custom:plotly-graph @@ -72,7 +72,7 @@ title: Bedroom CO2 Home Assistant Guage -![CO2 Guage.png](/assets/co2-guage.png) +![Home Assistant gauge card showing MSR-1 CO2 at 1,063 ppm with green, yellow, and red ranges](/assets/co2-guage.png) ```plaintext type: gauge diff --git a/docs/products/msr1/examples/using-msr-1-buzzer.md b/docs/products/msr1/examples/using-msr-1-buzzer.md index 6290d08cbb..cab4c2d456 100755 --- a/docs/products/msr1/examples/using-msr-1-buzzer.md +++ b/docs/products/msr1/examples/using-msr-1-buzzer.md @@ -7,7 +7,7 @@ This guide will walk you through using the buzzer on your MSR-1. You can also ca 1. Open Home Assistant and navigate to developer tools in the bottom left -![Screenshot 2023-11-01 at 10.52.38 PM.png](/assets/screenshot-2023-11-01-at-10-52-38-pm.png) +![Home Assistant sidebar with the Developer tools hammer icon highlighted in orange](/assets/screenshot-2023-11-01-at-10-52-38-pm.png) 2\. Click on services @@ -26,4 +26,4 @@ This guide will walk you through using the buzzer on your MSR-1. You can also ca 5\. Click on call service button in bottom right -![Screenshot 2023-11-01 at 10.57.33 PM.png](/assets/screenshot-2023-11-01-at-10-57-33-pm.png) \ No newline at end of file +![Developer tools Services tab with the MSR-1 play_buzzer service and an RTTTL song_str highlighted](/assets/screenshot-2023-11-01-at-10-57-33-pm.png) \ No newline at end of file diff --git a/docs/products/msr1/introduction.md b/docs/products/msr1/introduction.md index cc8dd6631c..da1e7c447e 100755 --- a/docs/products/msr1/introduction.md +++ b/docs/products/msr1/introduction.md @@ -1,6 +1,6 @@ --- description: "The Apollo MSR-1 multisensor: mmWave radar, LUX and UV, temperature, humidity, and optional CO2, running ESPHome for Home Assistant." --- -![](/assets/productimage.jpg) +![Apollo MSR-1 in its white case, with a feature list including mmWave, LUX/UV, CO2, RGB, and buzzer](/assets/productimage.jpg) The Apollo MSR-1 is a compact, community-driven multisensor designed for Home Assistant via ESPHome. Measuring just 40.5mm x 32mm, it features mmWave radar for motion detection, LUX/UV sensors, temperature/humidity monitoring, and optional CO2 sensing. Powered by USB-C, the MSR-1 allows for customizable alerts through RGB LEDs and a piezo buzzer. \ No newline at end of file diff --git a/docs/products/msr1/setup/general-tips.md b/docs/products/msr1/setup/general-tips.md index 17e8c463b0..33a2b7689b 100755 --- a/docs/products/msr1/setup/general-tips.md +++ b/docs/products/msr1/setup/general-tips.md @@ -5,13 +5,13 @@ description: "Placement and mounting tips for the MSR-1, including keeping the l ##### **MSR-1** -![apollo-automation-MSR-1-presence-multisensor-PCB-components-layout-1024x768.jpg.webp](/assets/apollo-automation-msr-1-presence-multisensor-pcb-components-layout-1024x768-jpg.webp) +![MSR-1 circuit board with labeled parts: ESP32-C3 Mini, LD2410B radar, LTR-390UV, BME280, SCD-40, buzzer, and USB-C](/assets/apollo-automation-msr-1-presence-multisensor-pcb-components-layout-1024x768-jpg.webp) Picture from Smart Home Scene ##### **Light Sensor (LTR-390UV)** -![Light holes.png](/assets/UWHlight-holes.png) +![3D render of the MSR-1 case with the light sensor holes outlined in red](/assets/UWHlight-holes.png) When mounting the MSR-1 be sure to position the device so that the two large holes are not covered. This allows more light to enter and will ensure better accuracy. @@ -23,17 +23,17 @@ When mounting the MSR-1 be sure to position the device so that the two large hol The MSR-1 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120degree FOV of the mmWave radar. -![LD2410 Gates.png](/assets/ld2410-gates.png)![LD2410 Zone map.png](/assets/ld2410-zone-map.png) +![LD2410 detection arcs for a wall mount at 1.5 to 2 m high and a ceiling mount at 2.6 to 3 m high](/assets/ld2410-gates.png)![Side-view diagram of radar coverage cones from a wall mount and a ceiling mount](/assets/ld2410-zone-map.png) -![ld2410_mounting_hor-1.jpeg](/assets/ld2410-mounting-hor-1.jpeg) +![HLK-LD2410B manual diagram of wall mounting at 1.5 to 2 m with a polar chart of detection range by angle](/assets/ld2410-mounting-hor-1.jpeg) The MSR-1 can also be mounted on the ceiling if you can provide power and mount our articulating stand on the ceiling. ##### **Gate and FOV Visualization** -**![ld2410 table.png](/assets/ld2410-table_1.png)![Gate, Zones and RR.png](/assets/gate-zones-and-rr.png)** +**![Table of LD2410 gates 0 to 8 with distance ranges and default move and still thresholds](/assets/ld2410-table_1.png)![Home Assistant radar settings with 0.75 m distance resolution and Zone 1, 2, and 3 distances in cm](/assets/gate-zones-and-rr.png)** -![MSR-1 radar map.png](/assets/msr-1-radar-map_1.png)![Radar gates Colored.png](/assets/radar-gates-colored.png) +![Top-down fan diagram of radar gates G1 to G7 marked in 0.75 m steps out to 5 m](/assets/msr-1-radar-map_1.png)![Radar gate fan diagram with Zone 1 in red, Zone 2 in blue, and Zone 3 in green](/assets/radar-gates-colored.png) !!! tip "These are some useful hints!" diff --git a/docs/products/msr1/setup/zones-ha.md b/docs/products/msr1/setup/zones-ha.md index 528828e617..f4c1e0ba58 100755 --- a/docs/products/msr1/setup/zones-ha.md +++ b/docs/products/msr1/setup/zones-ha.md @@ -19,15 +19,15 @@ Here is a video of how to tune the mmWave sensor using radar engineering mode, 2. Navigate to Settings>Devices & services>ESPHome>Select the MSR-1 3. Scroll down to the Configuration section 4. Turn on Radar Engineering Mode (REM) - ![Configuration.png](/assets/5l4configuration.png) + ![MSR-1 Configuration card in Home Assistant with the Radar Engineering Mode toggle turned on and highlighted](/assets/5l4configuration.png) 5. Scroll down to the Diagnostic section and you will see that REM shows the move and still energy for gates 0-8 - ![Diagnostic.png](/assets/diagnostic.png) + ![MSR-1 Diagnostic card showing move and still energy percentages for gates g0 through g8](/assets/diagnostic.png) 6. The gates are different distances from the sensor - ![ld2410 table.png](/assets/ld2410-table.png)![MSR-1 radar map.png](/assets/msr-1-radar-map.png) + ![LD2410 gate table listing each gate's distance range and default move and still thresholds](/assets/ld2410-table.png)![MSR-1 radar coverage diagram showing gates G1 to G7 as arcs spaced 0.75 m apart](/assets/msr-1-radar-map.png) 7. Moving the gate still and move threshold slider to the right increases the amount of energy needed to trigger the sensor. Do this if you want the gate to be less sensitive. - ![High Threshold.png](/assets/high-threshold.png) + ![g0 move and still threshold sliders moved all the way to the right](/assets/high-threshold.png) 8. Moving the gate still and move threshold slider to the left decreases the amount of energy needed to trigger the sensor. Do this if you want the gate to be more sensitive. - ![Low Threshold.png](/assets/low-threshold.png) + ![g0 move and still threshold sliders moved all the way to the left](/assets/low-threshold.png) **Alternate Method** diff --git a/docs/products/msr1/setup/zones-hlk.md b/docs/products/msr1/setup/zones-hlk.md index 3e88919b2e..33053810a1 100755 --- a/docs/products/msr1/setup/zones-hlk.md +++ b/docs/products/msr1/setup/zones-hlk.md @@ -8,41 +8,41 @@ description: "Tune the MSR-1 mmWave radar over Bluetooth with the HLKRadarTool p 2\. Ensure the mmWave radar you want to tune has Radar Control Bluetooth turned on. Home Assistant > Settings > Devices & services > ESPHome Devices > Select Device > Scroll down and toggle on Radar Control Bluetooth -![Radar Control Bluetooth.png](/assets/radar-control-bluetooth.png) +![Radar Control Bluetooth switch turned on in the MSR-1 Home Assistant device page, outlined in red](/assets/radar-control-bluetooth.png) 3\. Open the app and select your device -![Find Device.png](/assets/find-device.png) +![HLKRadarTool Device list showing the HLK-LD2410 radar found over Bluetooth](/assets/find-device.png) 4\. Turn on Engineering Mode -![EM.png](/assets/em.png) +![HLKRadarTool device screen with the Engineering mode toggle turned on and outlined in red](/assets/em.png) 5\. Select More and then select Parameter settings -![More and PS.png](/assets/more-and-ps.png) +![HLKRadarTool device screen with More and Parameter settings outlined in red](/assets/more-and-ps.png) 6\. Select Detect background noise -![DBN.png](/assets/dbn.png) +![HLKRadarTool Parameter settings with Detect background noise outlined in red](/assets/dbn.png) 7\. Insert Delay detection and Detection time values. (For iPhone users Delay detection cannot be 0). Then select Start. This will give us our reference values so we can auto-calibrate the mmWave sensor. -![DD, DT and Start.png](/assets/dd-dt-and-start.png) +![HLKRadarTool Bottom noise statistics with Delay detection, Detection time, and START outlined in red](/assets/dd-dt-and-start.png) 8\. Select Back to navigate to the Parameter settings. Then select one of the auto-calibration buttons. **Average** - Sets the gate sensitivity to the average move and still energy -![Average.png](/assets/average.png) +![HLKRadarTool Parameter settings with the Average one click setting button outlined in red](/assets/average.png) **Maximum** - Sets the gate sensitivity to the maximum move and still energy -![Max.png](/assets/max.png) +![HLKRadarTool Parameter settings with the Maximum one click setting button outlined in red](/assets/max.png) -**Intelligent** - Sets the gate sensitivity equal to or just above the maximum move and still energ**y** **![Intelligent.png](/assets/intelligent.png)** 9. Now your mmWave should be tuned to your environment! **Manual Calibration** 1. Follow steps 1-5 above +**Intelligent** - Sets the gate sensitivity equal to or just above the maximum move and still energ**y** **![HLKRadarTool Parameter settings with the Intelligent one click setting button outlined in red](/assets/intelligent.png)** 9. Now your mmWave should be tuned to your environment! **Manual Calibration** 1. Follow steps 1-5 above 2\. Select Motion or Static sensitivity, change it to your desired value, and select Set -![Manual.png](/assets/manual.png) +![HLKRadarTool gate sensitivity table with motion and static values and the Set button outlined in red](/assets/manual.png) 3\. Now your mmWave should be tuned to your environment! \ No newline at end of file diff --git a/docs/products/msr1/troubleshooting/msr1-boot-mode.md b/docs/products/msr1/troubleshooting/msr1-boot-mode.md index 19ba8509f6..ddc5ca3bc8 100755 --- a/docs/products/msr1/troubleshooting/msr1-boot-mode.md +++ b/docs/products/msr1/troubleshooting/msr1-boot-mode.md @@ -11,7 +11,7 @@ description: "Put the MSR-1 into boot mode using the boot button, which is neede 1\. Position the MSR-1 as shown in the image below and locate the small opening to press the boot button (the right button). -![](/assets/msr-1-top-shot-boot-button.jpg) +![MSR-1 case with the boot button opening highlighted in red among the top vents](/assets/msr-1-top-shot-boot-button.jpg) 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. @@ -25,6 +25,6 @@ description: "Put the MSR-1 into boot mode using the boot button, which is neede 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. -![](/assets/msr-1-buttons.jpg) +![Bare MSR-1 board with arrows marking the Boot and Reset buttons along the top edge](/assets/msr-1-buttons.jpg) 4\. Continue with uploading the firmware document. \ No newline at end of file diff --git a/docs/products/msr1/troubleshooting/msr1-code.md b/docs/products/msr1/troubleshooting/msr1-code.md index 0709e98735..f028d31734 100755 --- a/docs/products/msr1/troubleshooting/msr1-code.md +++ b/docs/products/msr1/troubleshooting/msr1-code.md @@ -11,33 +11,33 @@ If your device has already been connected to Home Assistant please press the boot button (the left button). -![](/assets/msr-1-top-shot-boot-button.jpg) +![MSR-1 case with the boot button opening highlighted in red among the top vents](/assets/msr-1-top-shot-boot-button.jpg) 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-1 then let go of the button. -![](/assets/air-1-boot-button.jpg) +![Pressing the boot button with a pin through the case opening beside the USB-C port](/assets/air-1-boot-button.jpg) 3\. Navigate to our installer page and click connect under Apollo MSR-1 Installer. 3\. Click the big "Connect" button. -![](/assets/msr-1-reflash-pic-1.png) +![Apollo MSR-1 Installer page with the Connect button](/assets/msr-1-reflash-pic-1.png) 3\. Select the open com port then click Connect. -![](/assets/msr-1-reflash-pic-2.png) +![Browser serial port prompt with the USB JTAG/serial debug unit selected and the Connect button](/assets/msr-1-reflash-pic-2.png) 4\. Click "Install MSR-1". -![](/assets/msr-1-reflash-pic-3.png) +![Device Dashboard menu with Install MSR-1 highlighted](/assets/msr-1-reflash-pic-3.png) 5\. Click "INSTALL". -![](/assets/msr-1-reflash-pic-4.png) +![Install msr-1 confirmation dialog warning that data will be erased, with the Install button](/assets/msr-1-reflash-pic-4.png) 6\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/air-1-reflash-pic-5.png) +![Installation complete message with the Next button highlighted](/assets/air-1-reflash-pic-5.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md b/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md index 0d0bd089f5..c9876d8829 100755 --- a/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md +++ b/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md @@ -7,9 +7,9 @@ description: "Reset the MSR-1 Wi-Fi credentials with a 10 second press of the Bo 2\. Long press the Boot button for 10 seconds -![MSR-1 Top Shot Boot Button.jpg](/assets/msr-1-top-shot-boot-button.jpg) +![MSR-1 case with the Boot button highlighted through a top vent slot](/assets/msr-1-top-shot-boot-button.jpg) -![MSR-1_Buttons.jpg](/assets/msr-1-buttons.jpg) +![MSR-1 board with arrows marking the Boot and Reset buttons](/assets/msr-1-buttons.jpg) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again diff --git a/docs/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md b/docs/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md index ef9a3ab0d3..f370b6e8ba 100755 --- a/docs/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md +++ b/docs/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md @@ -6,19 +6,19 @@ description: Step by step tutorial for adding 90 degree USB-C to MSR-2 1\. Gather the MSR-2 and 90 degree addon. -![](/assets/msr-2-90-degree-pic-0.jpg) +![MSR-2 in its case next to the 90 degree USB-C addon](/assets/msr-2-90-degree-pic-0.jpg) 2\. Align the MSR-2 with the USB-C port facing you and align the 90 degree addon with the shorter end facing the MSR-2 USB-C port. -![](/assets/msr-2-90-degree-pic-2.jpg) +![MSR-2 USB-C port lined up with the short end of the 90 degree addon](/assets/msr-2-90-degree-pic-2.jpg) 3\. Gently push the short end of the 90 degree addon into the MSR-2 side USB-C port. -![](/assets/msr-2-90-degree-pic-1.jpg) +![Pushing the short end of the 90 degree addon into the MSR-2 USB-C port](/assets/msr-2-90-degree-pic-1.jpg) 4\. Gently push the longer end of the 90 degree addon into a USB-C outlet. -![](/assets/msr-2-90-degree-pic-5.jpg) +![MSR-2 plugged into the USB-C port of a wall outlet through the 90 degree addon](/assets/msr-2-90-degree-pic-5.jpg) !!! success "You're ready to begin using your device!" diff --git a/docs/products/msr2/addons/adding-articulating-stand-to-msr-2.md b/docs/products/msr2/addons/adding-articulating-stand-to-msr-2.md index 32973140b9..a3e1eba3fb 100755 --- a/docs/products/msr2/addons/adding-articulating-stand-to-msr-2.md +++ b/docs/products/msr2/addons/adding-articulating-stand-to-msr-2.md @@ -6,18 +6,18 @@ description: Tutorial on adding the rear female usb-c port to your MSR-2. 1\. Unplug your MSR-2 from power and remove the back. -![](/assets/msr-2-add-co2-pic-1.jpg) +![Back of the MSR-2 case with the Apollo logo backplate in place](/assets/msr-2-add-co2-pic-1.jpg) -![](/assets/msr-2-add-co2-pic-2.jpg) +![Pressing on the edge of the MSR-2 backplate to pop it off the case](/assets/msr-2-add-co2-pic-2.jpg) -![](/assets/msr-2-add-co2-pic-3-1.jpg) +![MSR-2 with the backplate removed, showing the board inside the case](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Align the new backplate that came with the articulating stand addon and gently push down on two corners near the articulating ball mount then the other two corners until it seats flat. -![](/assets/msr-2-stand-pic-1.jpg) +![Pressing the articulating stand backplate onto the back of the MSR-2 case](/assets/msr-2-stand-pic-1.jpg) -![](/assets/msr-2-stand-pic-2.jpg) +![Articulating stand backplate seated flat on the back of the MSR-2](/assets/msr-2-stand-pic-2.jpg) 3\. Align the ball inside the articulating mount and then push down until it's fully seated. -![](/assets/msr-2-stand-pic-3.jpg) \ No newline at end of file +![Pushing the stand's ball into the articulating mount on the back of the MSR-2](/assets/msr-2-stand-pic-3.jpg) \ No newline at end of file diff --git a/docs/products/msr2/addons/adding-co2-to-msr-2.md b/docs/products/msr2/addons/adding-co2-to-msr-2.md index 75729e3c8e..b95bd00e89 100755 --- a/docs/products/msr2/addons/adding-co2-to-msr-2.md +++ b/docs/products/msr2/addons/adding-co2-to-msr-2.md @@ -6,26 +6,26 @@ description: Tutorial on adding the SCD40 CO2 sensor to your MSR-2. 1\. Unplug your MSR-2 from power and remove the back -![](/assets/msr-2-add-co2-pic-1.jpg)![](/assets/msr-2-add-co2-pic-2.jpg)![](/assets/msr-2-add-co2-pic-3-1.jpg) +![Back of the MSR-2 case with the Apollo logo backplate in place](/assets/msr-2-add-co2-pic-1.jpg)![Pressing on the edge of the MSR-2 backplate to pop it off the case](/assets/msr-2-add-co2-pic-2.jpg)![MSR-2 with the backplate removed, showing the board inside the case](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Flip the MSR-2 upside down and gently tap the case on the table and your MSR-2 should slide out of the case. -![](/assets/msr-2-add-co2-pic-4.jpg)![](/assets/msr-2-add-co2-pic-5.jpg)![](/assets/msr-2-add-co2-pic-6.jpg) +![MSR-2 case flipped upside down with the backplate off](/assets/msr-2-add-co2-pic-4.jpg)![Lifting the case off the MSR-2, showing the MSR-2 Rev 9 board](/assets/msr-2-add-co2-pic-5.jpg)![MSR-2 board sliding out of its case, with the mmWave module on top](/assets/msr-2-add-co2-pic-6.jpg) 3\. With the case removed, identify the bottom right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the SCD40 CO2 sensor. There is an X on the SCD40 sensor's PCB as well, you can see it in the image below but it is slightly cut off on the PCB itself. There is also a "gold dot" in the top left of the SCD40 when oriented properly. -![](/assets/msr-2-add-co2-pic-7.jpg)![](/assets/msr-2-add-co2-pic-8.jpg) +![MSR-2 Rev 9 board with the black CN1 mezzanine connector and the X marking beside it](/assets/msr-2-add-co2-pic-7.jpg)![SCD40 CO2 sensor lined up below the CN1 connector on the MSR-2 board](/assets/msr-2-add-co2-pic-8.jpg) 4\. Gently push the SCD40 CO2 module onto the black mezzanine connector. -![](/assets/msr-2-add-co2-pic-9.jpg)![](/assets/msr-2-add-co2-pic-10.jpg) +![Pressing the SCD40 CO2 module onto the mezzanine connector on the MSR-2 board](/assets/msr-2-add-co2-pic-9.jpg)![SCD40 CO2 module seated on the MSR-2 board beside the ESP32 module](/assets/msr-2-add-co2-pic-10.jpg) 5\. Slide the case back over the MSR-2, making sure that the case has the hole for the USB-C port facing the right direction. -![](/assets/msr-2-add-co2-pic-11.jpg)![](/assets/msr-2-add-co2-pic-12.jpg) +![Sliding the case back over the MSR-2 board](/assets/msr-2-add-co2-pic-11.jpg)![End of the MSR-2 case with the USB-C port showing through its opening](/assets/msr-2-add-co2-pic-12.jpg) 6\. Gently press the backplate of the MSR-2 case onto the MSR-2 until it lightly snaps into place. Please do not force it, if necessary please repeat steps above until it seats in the case without any force required. -![](/assets/msr-2-add-co2-pic-15.jpg) +![Pressing the backplate onto the MSR-2 case until it snaps into place](/assets/msr-2-add-co2-pic-15.jpg) 7\. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module after installation. This is required for all CO2 addons purchased from us separately from a product (such as buying it to addon to an existing Apollo device). \ No newline at end of file diff --git a/docs/products/msr2/addons/adding-gpio-header-to-msr-2.md b/docs/products/msr2/addons/adding-gpio-header-to-msr-2.md index 2532119bcd..7627c9bd96 100755 --- a/docs/products/msr2/addons/adding-gpio-header-to-msr-2.md +++ b/docs/products/msr2/addons/adding-gpio-header-to-msr-2.md @@ -6,27 +6,27 @@ description: Tutorial on adding the GPIO Header to your MSR-2. 1\. Unplug your MSR-2 from power and remove the back. -![](/assets/msr-2-add-co2-pic-1.jpg) +![Back of the MSR-2 with the vented Apollo back cover still attached](/assets/msr-2-add-co2-pic-1.jpg) -![](/assets/msr-2-add-co2-pic-2.jpg) +![Squeezing the sides of the MSR-2 back cover to unclip it from the case](/assets/msr-2-add-co2-pic-2.jpg) -![](/assets/msr-2-add-co2-pic-3-1.jpg) +![MSR-2 with the back cover removed, exposing the circuit board](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Identify the "X" on the PCB on the back of your MSR-2 and the "X" on the top left corner of the GPIO Header addon. -![](/assets/msr-2-gpio-header-pic-1.jpg) +![Tool pointing to the X mark on the MSR-2 board, with the GPIO Header addon beside it](/assets/msr-2-gpio-header-pic-1.jpg) -![](/assets/msr-2-gpio-header-pic-2.jpg) +![Close-up of the X marks on the MSR-2 board and on the GPIO Header addon](/assets/msr-2-gpio-header-pic-2.jpg) 3\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/msr-2-gpio-header-pic-3.jpg) +![GPIO Header addon seated in the MSR-2 mezzanine connector with the X marks aligned](/assets/msr-2-gpio-header-pic-3.jpg) 4\. Align the new back for your MSR-2 that came with the GPIO Header addon. Push down on the corners closest to the GPIO Header addon first, and then push the back on securely on the other two corners. -![](/assets/msr-2-gpio-header-pic-5.jpg) +![Pressing the new MSR-2 back cover down at the corners next to the GPIO Header](/assets/msr-2-gpio-header-pic-5.jpg) -![](/assets/msr-2-gpio-header-pic-4.jpg) +![MSR-2 with the new back cover fully attached around the GPIO Header](/assets/msr-2-gpio-header-pic-4.jpg) !!! tip "Make sure to check out our MSR-2 GPIO Header LED Strip Tutorial!" diff --git a/docs/products/msr2/addons/adding-rear-female-usb-to-msr-2.md b/docs/products/msr2/addons/adding-rear-female-usb-to-msr-2.md index a3b4dc52a5..8dfb9b5e64 100755 --- a/docs/products/msr2/addons/adding-rear-female-usb-to-msr-2.md +++ b/docs/products/msr2/addons/adding-rear-female-usb-to-msr-2.md @@ -6,26 +6,26 @@ description: Tutorial on adding the rear female usb-c port to your MSR-2. 1\. Unplug your MSR-2 from power and remove the back -![](/assets/msr-2-add-co2-pic-1.jpg) +![Back of the MSR-2 with the vented Apollo back cover still attached](/assets/msr-2-add-co2-pic-1.jpg) -![](/assets/msr-2-add-co2-pic-2.jpg) +![Squeezing the sides of the MSR-2 back cover to unclip it from the case](/assets/msr-2-add-co2-pic-2.jpg) -![](/assets/msr-2-add-co2-pic-3-1.jpg) +![MSR-2 with the back cover removed, exposing the circuit board](/assets/msr-2-add-co2-pic-3-1.jpg) 2\. Identify the "X" on the PCB on the back of your MSR-2 and the "X" on the top left corner of the Female Rear USB-C addon. -![](/assets/msr-2-female-usb-c-pic-1.jpeg) +![Tool pointing to the X mark on the MSR-2 board, with the Female USB-C addon beside it](/assets/msr-2-female-usb-c-pic-1.jpeg) -![](/assets/msr-2-female-usb-c-pic-2.jpeg) +![Close-up of the X mark on the Female USB-C addon next to the MSR-2 connector](/assets/msr-2-female-usb-c-pic-2.jpeg) 3\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/msr-2-female-usb-c-pic-3.jpeg) +![Female USB-C addon seated in the MSR-2 mezzanine connector with the X marks aligned](/assets/msr-2-female-usb-c-pic-3.jpeg) 4\. Align the new back for your MSR-2 that came with the Female USB-C addon. It's possible you might have a flat back version and you can print that yourself too! -![](/assets/msr-2-female-usb-c-pic-4.jpeg) +![Holding the new MSR-2 back cover in place with the rear USB-C port poking through](/assets/msr-2-female-usb-c-pic-4.jpeg) 5\. Push down on the corners closest to the USB-C addon first, and then push the back on securely on the other two corners. -![](/assets/msr-2-female-usb-c-pic-5.jpeg) \ No newline at end of file +![MSR-2 with the new back cover attached and the rear USB-C port exposed](/assets/msr-2-female-usb-c-pic-5.jpeg) \ No newline at end of file diff --git a/docs/products/msr2/addons/msr2-outlet-mount.md b/docs/products/msr2/addons/msr2-outlet-mount.md index eadb44536b..95f539142b 100755 --- a/docs/products/msr2/addons/msr2-outlet-mount.md +++ b/docs/products/msr2/addons/msr2-outlet-mount.md @@ -6,19 +6,19 @@ description: Tutorial for using the MSR-2 Outlet Mount. 1\. Gather a top facing usb-c plug, an MSR-2, and our MSR-2 Outlet Mount. -![](/assets/msr-2-outlet-mount-pic-1.jpg) +![Top facing USB-C wall plug, MSR-2 Outlet Mount, and MSR-2 laid out together](/assets/msr-2-outlet-mount-pic-1.jpg) 2\. Align the MSR-2 with the USB-C port facing the left side and align the MSR-2 Outlet Mount as shown in the image below. -![](/assets/msr-2-outlet-mount-pic-2.jpg) +![MSR-2 Outlet Mount lined up with the USB-C port on the left side of the MSR-2](/assets/msr-2-outlet-mount-pic-2.jpg) 3\. Push the MSR-2 Outlet Mount into the usb-c port until it's fully seated. Do not push hard, it will go in very smoothly. -![](/assets/msr-2-outlet-mount-pic-3.jpg) +![MSR-2 Outlet Mount fully seated in the MSR-2 USB-C port](/assets/msr-2-outlet-mount-pic-3.jpg) 4\. Gently push the other USB-C port of the MSR-2 Outlet Mount into the top of the USB-C top facing plug. -![](/assets/msr-2-outlet-mount-pic-4.jpg) +![MSR-2 on the Outlet Mount, plugged into the top of the USB-C wall plug](/assets/msr-2-outlet-mount-pic-4.jpg) !!! success "You're ready to plug it in and begin using your device!" diff --git a/docs/products/msr2/calibrating-co2.md b/docs/products/msr2/calibrating-co2.md index 503caaa143..2e54f8e291 100755 --- a/docs/products/msr2/calibrating-co2.md +++ b/docs/products/msr2/calibrating-co2.md @@ -16,7 +16,7 @@ This article will guide you through a simple calibration of your CO2 1\. Plug in your sensor outdoors and leave it for at least 5 minutes to allow the readings to stabilize. This should be around 420 ppm per NASA. -![](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) +![Apollo AIR-1 plugged in outdoors on concrete to read fresh air CO2 levels](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) 2\. Go to your Home Assistant dashboard and hit the letter "e" - It will pop up with an entity filter then type in "Calibrate CO2" and select the correct device. @@ -24,8 +24,8 @@ This article will guide you through a simple calibration of your CO2 If you cannot get this menu to pop-up, click somewhere on the Home Assistant dashboard then press your "e" key. -![Image of popup with CO2 calibration choice circled in red](/assets/co2-calibration-quick-pic-1.png) +![Home Assistant entity search with the Calibrate SCD40 To 420ppm button circled in red](/assets/co2-calibration-quick-pic-1.png) 3\. Click on the button that says "PRESS" and then you are done. -![Image of popup with CO2 calibration press button circled in red](/assets/co2-calibration-quick-pic-2.png) \ No newline at end of file +![Calibrate SCD40 To 420ppm entity dialog with the Press button circled in red](/assets/co2-calibration-quick-pic-2.png) \ No newline at end of file diff --git a/docs/products/msr2/examples/msr2-alarmo.md b/docs/products/msr2/examples/msr2-alarmo.md index 3f616396a5..92cfcff602 100755 --- a/docs/products/msr2/examples/msr2-alarmo.md +++ b/docs/products/msr2/examples/msr2-alarmo.md @@ -9,29 +9,29 @@ My grandmother wanted a security system that would alert her when there was move 1\. Install [HACS](https://hacs.xyz/docs/use/download/download/) 2\. Install [Alarmo](https://github.com/nielsfaber/alarmo?tab=readme-ov-file#installation) and the [Alarmo Card](https://github.com/nielsfaber/alarmo-card) (Pretty Arm and Disarm card for your HA dashboard) -![Alarmo 7.png](/assets/alarmo-7.png) +![Alarmo card on a Home Assistant dashboard showing Disarmed with Arm Away and Arm Home buttons](/assets/alarmo-7.png) -![Alarmo 1.png](/assets/alarmo-1.png) +![Alarmo General tab in Home Assistant showing global alarm settings and arm modes](/assets/alarmo-1.png) 3\. Find Alarmo on the left, select the Sensors tab, and toggle on the sensor entities that you would like to use for your alarm system. -![Alarmo 2.png](/assets/alarmo-2.png) +![Alarmo Sensors tab with MSR-1 radar target entities toggled on for Home mode](/assets/alarmo-2.png) 4\. Now select the Actions tab and under Condition > Event > Select "Alarm is triggered". You can also select the device you would like to receive a notification on under Task > Target > Select Device (Phone, tablet, etc.) -![Alarmo 3.png](/assets/alarmo-3.png) +![Alarmo notification action with the Alarm is triggered event and a phone selected as the target](/assets/alarmo-3.png) 5\. You can change the Title, Message, and Name of the alarm notification. -![Alarmo 4.png](/assets/alarmo-4.png) +![Alarmo notification settings showing the Title, Message, and Name fields filled in](/assets/alarmo-4.png) 6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Uner Entity select your sensors RGB light. -![Alarmo 5.png](/assets/alarmo-5.png) +![Alarmo action set to Alarm is triggered with AIR-1 and MSR-1 RGB light entities selected](/assets/alarmo-5.png) 7\. Under Action select Turn On and now your sensors RGB lights will turn on when the alarm is triggered. -![Alarmo 6.png](/assets/alarmo-6.png) +![Alarmo action with Turn On selected for the AIR-1 and MSR-1 RGB light entities](/assets/alarmo-6.png) 8\. And that's it, seriously... Now you can enjoy a free and local security system. diff --git a/docs/products/msr2/setup/msr2-general-tips.md b/docs/products/msr2/setup/msr2-general-tips.md index a7977e37e5..caa5161957 100755 --- a/docs/products/msr2/setup/msr2-general-tips.md +++ b/docs/products/msr2/setup/msr2-general-tips.md @@ -6,7 +6,7 @@ description: Multiple helpful images for mounting, lux/rgb, and gate and zone vi ##### **Light Sensor (LTR-390UV)** -![20240514_123742.jpg](/assets/20240514-123742.jpg) +![MSR-2 case with the light sensor visible through the center vent outlined in red](/assets/20240514-123742.jpg) When mounting the MSR-2 be sure to position the device so that the two large holes are not covered. This allows more light to enter and will ensure better accuracy. @@ -18,11 +18,11 @@ When mounting the MSR-2 be sure to position the device so that the two large hol The MSR-2 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120degree FOV of the mmWave radar. -![ld2410_mounting_hor-1.jpeg](/assets/ld2410-mounting-hor-1.jpeg) +![HLK-LD2410B manual diagram of wall mounting at 1.5 to 2 m with a polar chart of detection range by angle](/assets/ld2410-mounting-hor-1.jpeg) The MSR-2 can also be mounted on the ceiling if you can provide power and mount our articulating stand on the ceiling. -![LD2410 Gates.png](/assets/ld2410-gates.png) +![LD2410 detection arcs for a wall mount at 1.5 to 2 m high and a ceiling mount at 2.6 to 3 m high](/assets/ld2410-gates.png) !!! tip "These are some useful hints!" @@ -32,8 +32,8 @@ The MSR-2 can also be mounted on the ceiling if you can provide power and mount ##### **Gate and FOV Visualization** -**![ld2410 table.png](/assets/ld2410-table.png)![Gate, Zones and RR.png](/assets/gate-zones-and-rr.png)** +**![Table of LD2410 gates 0 to 8 with distance ranges and default move and still thresholds](/assets/ld2410-table.png)![Home Assistant radar settings with 0.75 m distance resolution and Zone 1, 2, and 3 distances in cm](/assets/gate-zones-and-rr.png)** -![MSR-1 radar map.png](/assets/msr-1-radar-map.png)![Radar gates Colored.png](/assets/radar-gates-colored.png) +![Top-down fan diagram of radar gates G1 to G7 marked in 0.75 m steps out to 5 m](/assets/msr-1-radar-map.png)![Radar gate fan diagram with Zone 1 in red, Zone 2 in blue, and Zone 3 in green](/assets/radar-gates-colored.png) ##### \ No newline at end of file diff --git a/docs/products/msr2/setup/msr2-tuning-dashboard.md b/docs/products/msr2/setup/msr2-tuning-dashboard.md index 9601be09cd..06113fab4d 100755 --- a/docs/products/msr2/setup/msr2-tuning-dashboard.md +++ b/docs/products/msr2/setup/msr2-tuning-dashboard.md @@ -22,7 +22,7 @@ This guide will create a beautiful and helpful dashboard to simplify configurati 4\. Head to your Home Assistant dashboard and Take control of your dashboard by clicking **Edit Dashboard** in the top right then the 3 dots from the **Edit Dashboard** menu and click **Take control**. (this step is only necessary for new Home Assistant users). -![](/assets/home-assistant-take-control-gif.gif) +![Opening the Home Assistant Edit dashboard 3 dots menu and choosing Take control](/assets/home-assistant-take-control-gif.gif) 5\. Use the YAML generator below and enter in your device name such as apollo\_msr\_2\_m4c4dd and then click **Generate YAML**. It will copy the YAML for you to use in the next step! @@ -39,8 +39,8 @@ This guide will create a beautiful and helpful dashboard to simplify configurati Home Assistant depends on this file to function correctly - it is what displays your dashboard "views". Only make the changes exactly as outlined below. Do not add extra spaces or modify anything beyond what is specified in the instructions. -![](/assets/msr-2-yaml-generator-copy-paste-raw-gif.gif) +![Pasting the generated YAML at the bottom of the Home Assistant Raw configuration editor and saving](/assets/msr-2-yaml-generator-copy-paste-raw-gif.gif) 7\. You should now have a new dashboard view called **MSR-2 Configuration** and you should be ready to configure your sensor! -![](/assets/msr-2-dashboard-example-finished.png) \ No newline at end of file +![Finished MSR-2 Configuration dashboard with LD2410 controls, gate energy chart, and gate sliders](/assets/msr-2-dashboard-example-finished.png) \ No newline at end of file diff --git a/docs/products/msr2/setup/zones-ha.md b/docs/products/msr2/setup/zones-ha.md index 6131517a42..f76207cda3 100755 --- a/docs/products/msr2/setup/zones-ha.md +++ b/docs/products/msr2/setup/zones-ha.md @@ -28,22 +28,22 @@ How to tune the mmWave sensor using radar engineering mode. 2\. Scroll down to the Configuration section and turn on "Radar Engineering Mode". -![Configuration.png](/assets/msr-2-toggle-on-rem-1.png) +![Home Assistant MSR-2 Configuration section with the Radar Engineering Mode toggle being switched on](/assets/msr-2-toggle-on-rem-1.png) 3\. Scroll down to the Diagnostic section and you will see that when REM is enabled, the move and still energy for gates 0-8 are shown. -![Diagnostic.png](/assets/msr-2-gate-energies.png) +![Home Assistant MSR-2 Diagnostic section listing move and still energy percentages for gates g0 to g4](/assets/msr-2-gate-energies.png) The gates are 0.75meter increments from the sensor - allowing you to "tune" each 0.75 meter section until your sensor works as intended! -![](/assets/msr-2-ld2410-gate-table.png) +![Table of LD2410 gates 0 to 8 with distance ranges and default move and still thresholds](/assets/msr-2-ld2410-gate-table.png) -![](/assets/msr-2-ld2410-gates-visualized.png) +![Diagram of the LD2410 detection area split into gates at 0.75 m steps](/assets/msr-2-ld2410-gates-visualized.png) Moving the gate still and move threshold slider to the right increases the amount of energy needed to trigger the sensor. Do this if you want the gate to be less sensitive. -![High Threshold.png](/assets/msr-2-gate-high-threshold-example.png) +![Gate 0 move and still threshold sliders moved all the way right to 100](/assets/msr-2-gate-high-threshold-example.png) Moving the gate still and move threshold slider to the left decreases the amount of energy needed to trigger the sensor. Do this if you want the gate to be more sensitive. -![Low Threshold.png](/assets/msr-2-gate-low-threshold-example.png) \ No newline at end of file +![Gate 0 move and still threshold sliders moved all the way to the left](/assets/msr-2-gate-low-threshold-example.png) \ No newline at end of file diff --git a/docs/products/msr2/setup/zones-hlk.md b/docs/products/msr2/setup/zones-hlk.md index 158e08d506..12201270e7 100755 --- a/docs/products/msr2/setup/zones-hlk.md +++ b/docs/products/msr2/setup/zones-hlk.md @@ -20,41 +20,41 @@ The default password to connect to the HLKRadarTool is "HiLink". 1\. Head to the ESPHome Integrations page then select your MSR-2 and scroll down until you see LD2410 Bluetooth. -![](/assets/msr-2-toggle-on-ld2410-bluetooth.png) +![Home Assistant MSR-2 device page with the LD2410 Bluetooth toggle switched on, outlined in red](/assets/msr-2-toggle-on-ld2410-bluetooth.png) 2\. Open the app and select your device -![Find Device.png](/assets/find-device.png) +![HLKRadarTool Device list showing the HLK-LD2410 radar found over Bluetooth](/assets/find-device.png) 3\. Turn on Engineering Mode -![EM.png](/assets/em.png) +![HLKRadarTool device screen with the Engineering mode toggle switched on, outlined in red](/assets/em.png) 4\. Select More and then select Parameter settings -![More and PS.png](/assets/more-and-ps.png) +![HLKRadarTool device screen with More and then Parameter settings outlined in red](/assets/more-and-ps.png) 5\. Select Detect background noise -![DBN.png](/assets/dbn.png) +![HLKRadarTool Parameter settings with the Detect background noise option outlined in red](/assets/dbn.png) 6\. Insert Delay detection and Detection time values. (For iPhone users Delay detection cannot be 0). Then select Start. This will give us our reference values so we can auto-calibrate the mmWave sensor. -![DD, DT and Start.png](/assets/dd-dt-and-start.png) +![HLKRadarTool Bottom noise statistics with Delay detection, Detection time, and Start outlined](/assets/dd-dt-and-start.png) 7\. Select Back to navigate to the Parameter settings. Then select one of the auto-calibration buttons. **Average** - Sets the gate sensitivity to the average move and still energy -![Average.png](/assets/average.png) +![HLKRadarTool Parameter settings with the Average one click setting outlined in red](/assets/average.png) **Maximum** - Sets the gate sensitivity to the maximum move and still energy -![Max.png](/assets/max.png) +![HLKRadarTool Parameter settings with the Maximum one click setting outlined in red](/assets/max.png) **Intelligent** - Sets the gate sensitivity equal to or just above the maximum move and still energy. -**![Intelligent.png](/assets/intelligent.png)** +**![HLKRadarTool Parameter settings with the Intelligent one click setting outlined in red](/assets/intelligent.png)** ###### Manual Calibration @@ -62,6 +62,6 @@ The default password to connect to the HLKRadarTool is "HiLink". 2\. Select Motion or Static sensitivity, change it to your desired value, and select Set. -![Manual.png](/assets/manual.png) +![HLKRadarTool gate table with motion and static sensitivity values and the Set button outlined](/assets/manual.png) 3\. Now your MSR-2 should be tuned to your environment! \ No newline at end of file diff --git a/docs/products/msr2/troubleshooting/msr2-boot-mode.md b/docs/products/msr2/troubleshooting/msr2-boot-mode.md index 72937708aa..b4dc6bb4e5 100755 --- a/docs/products/msr2/troubleshooting/msr2-boot-mode.md +++ b/docs/products/msr2/troubleshooting/msr2-boot-mode.md @@ -12,7 +12,7 @@ description: Step by step guide for putting The MSR-2 In Boot Mode. 1\. Position the MSR-2 as shown in the image below and locate the small opening to press the boot button (the right button). -![](/assets/msr-2-boot-button.jpg) +![Tool pointing to the MSR-2 boot button opening, the right of the two small slots](/assets/msr-2-boot-button.jpg) 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. @@ -26,6 +26,6 @@ description: Step by step guide for putting The MSR-2 In Boot Mode. 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. -![](/assets/msr-2-reset-button.jpg) +![Tool pointing to the MSR-2 reset button opening, the left of the two small slots](/assets/msr-2-reset-button.jpg) 4\. Continue with uploading the firmware document. \ No newline at end of file diff --git a/docs/products/msr2/troubleshooting/msr2-code.md b/docs/products/msr2/troubleshooting/msr2-code.md index e081444cd4..2fccb01b6e 100755 --- a/docs/products/msr2/troubleshooting/msr2-code.md +++ b/docs/products/msr2/troubleshooting/msr2-code.md @@ -12,7 +12,7 @@ If your device has already been connected to Home Assistant please 2 sensor. There is an X on the SCD40 sensor's PCB as well, you can see it in the image below. There is also a "gold dot" in the top left of the SCD40 when oriented properly. -![](/assets/mtr-1-add-co2-pic-6.jpg)![](/assets/mtr-1-add-co2-pic-7.jpg) +![Close-up of the X mark next to the CN1 mezzanine connector on the MTR-1 board](/assets/mtr-1-add-co2-pic-6.jpg)![SCD40 CO2 module with its X mark lined up below the MTR-1 mezzanine connector](/assets/mtr-1-add-co2-pic-7.jpg) 4\. Gently push the SCD40 CO2 module onto the black mezzanine connector. -![](/assets/mtr-1-add-co2-pic-8.jpg)![](/assets/mtr-1-add-co2-pic-9.jpg) +![Pressing the SCD40 CO2 module onto the MTR-1 mezzanine connector](/assets/mtr-1-add-co2-pic-8.jpg)![Side view of the SCD40 CO2 module seated flat on the MTR-1 board](/assets/mtr-1-add-co2-pic-9.jpg) 5\. Slide the case back over the MTR-1, making sure that the case has the hole for the LUX Sensor facing the right direction (to the right). -![](/assets/mtr-1-add-co2-pic-10.jpg) +![Sliding the case back down over the MTR-1 board](/assets/mtr-1-add-co2-pic-10.jpg) 6\. Flip the MTR-1 back over to prepare to put the back case on. -![](/assets/mtr-1-add-co2-pic-11.jpg) +![Back of the MTR-1 board in its case, flipped over and ready for the backplate](/assets/mtr-1-add-co2-pic-11.jpg) 7\. Gently press the backplate of the MTR-1 case onto the MTR-1 until it lightly snaps into place. Please do not force it, if necessary please repeat steps above until it seats in the case without any force required. -![](/assets/mtr-1-add-co2-pic-12.jpg)![](/assets/mtr-1-add-co2-pic-13.jpg) +![Pressing the backplate onto the MTR-1 case near the USB-C port](/assets/mtr-1-add-co2-pic-12.jpg)![Pressing the backplate down until it snaps into the MTR-1 case](/assets/mtr-1-add-co2-pic-13.jpg) 8\. Put the stand back on if applicable. -![](/assets/mtr-1-add-co2-pic-14.jpg) +![Reassembled MTR-1 with the stand attached beside the USB-C port](/assets/mtr-1-add-co2-pic-14.jpg) 9\. Please refer to our [CO2 calibration guide](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/ "CO2 Calibration") to calibrate the CO2 module after installation. This is required for all CO2 addons purchased from us separately from a product (such as buying it to addon to an existing Apollo device). \ No newline at end of file diff --git a/docs/products/mtr1/addons/adding-gpio-header-to-mtr-1.md b/docs/products/mtr1/addons/adding-gpio-header-to-mtr-1.md index 9e3dcc19f5..9bf63fb5d7 100755 --- a/docs/products/mtr1/addons/adding-gpio-header-to-mtr-1.md +++ b/docs/products/mtr1/addons/adding-gpio-header-to-mtr-1.md @@ -6,30 +6,30 @@ description: Step by step tutorial for adding the GPIO Header Addon to the MTR-1 1\. Unplug your MTR-1 from power and remove the stand if attached. -![](/assets/mtr-1-add-co2-pic-1.jpg) +![Back of the MTR-1 with the stand still attached beside the USB-C port](/assets/mtr-1-add-co2-pic-1.jpg) 2\. Remove the backplate of the MTR-1. -![](/assets/mtr-1-add-co2-pic-4.jpg) +![MTR-1 with the backplate removed, showing the circuit board inside the case](/assets/mtr-1-add-co2-pic-4.jpg) 3\. Identify the "X" on the PCB on the back of your MTR-1 and the "X" on the top left corner of the GPIO Header addon. -![](/assets/mtr-1-add-gpio-pic-1.jpg) +![Tool pointing to the X mark on the MTR-1 board, with the GPIO Header addon beside it](/assets/mtr-1-add-gpio-pic-1.jpg) -![](/assets/mtr-1-add-gpio-pic-2.jpg) +![Close-up of the X mark on the GPIO Header addon next to the MTR-1 connector](/assets/mtr-1-add-gpio-pic-2.jpg) 4\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/mtr-1-add-gpio-pic-3.jpg) +![Pressing the new MTR-1 back down around the installed GPIO Header](/assets/mtr-1-add-gpio-pic-3.jpg) 5\. Align the new back for your MTR-1 that came with the GPIO Header addon. Push down on the corners closest to the GPIO Header addon first, and then push the back on securely on the other two corners. -![](/assets/mtr-1-add-gpio-pic-4.jpg) +![GPIO Header addon seated on the MTR-1 board, with the new back set aside](/assets/mtr-1-add-gpio-pic-4.jpg) 6\. The case should sit flush and you're now ready to add functionality to your device! -![](/assets/mtr-1-add-gpio-pic-5.jpg) +![MTR-1 with the new back sitting flush around the GPIO Header](/assets/mtr-1-add-gpio-pic-5.jpg) -![](/assets/gpio-header-pinout.webp) +![GPIO Header pinout: GND, IO18, IO19, IO4, IO2, IO6 on the left; 5V, IO7, SDA, SCL, GND, 3V on the right](/assets/gpio-header-pinout.webp) [Click here to head to the GPIO Header LED Strip Tutorial!](https://wiki.apolloautomation.com/products/msr2/examples/gpio-header-control-an-led-strip/){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md b/docs/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md index cbd0458171..36246b478b 100755 --- a/docs/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md +++ b/docs/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md @@ -6,26 +6,26 @@ description: Step by step tutorial for adding the Rear Male USB addon to the MTR 1\. Unplug your MTR-1 from power and remove the stand if attached. -![](/assets/mtr-1-add-co2-pic-1.jpg) +![Back of the MTR-1 with the stand still attached beside the USB-C port](/assets/mtr-1-add-co2-pic-1.jpg) 2\. Remove the backplate of the MTR-1. -![](/assets/mtr-1-add-co2-pic-4.jpg) +![MTR-1 with the backplate removed, showing the circuit board inside the case](/assets/mtr-1-add-co2-pic-4.jpg) 3\. Identify the "X" on the PCB on the back of your MTR-1 and the "X" on the top left corner of the male Rear USB-C addon. -![](/assets/mtr-1-add-male-usb-pic-1.jpg) +![Tool pointing to the X mark on the MTR-1 board, with the Male USB-C addon beside it](/assets/mtr-1-add-male-usb-pic-1.jpg) -![](/assets/mtr-1-add-male-usb-pic-2.jpg) +![Close-up of the X mark on the Male USB-C addon next to the MTR-1 connector](/assets/mtr-1-add-male-usb-pic-2.jpg) 4\. Keep the "X" aligned on both sides and gently push down until it securely seats in the small mezzanine connector. -![](/assets/mtr-1-add-male-usb-pic-3.jpg) +![Male USB-C addon seated in the MTR-1 mezzanine connector with the X marks aligned](/assets/mtr-1-add-male-usb-pic-3.jpg) 5\. Align the new back for your MTR-1 that came with the Male USB-C addon. Push down on the corners closest to the USB-C addon first, and then push the back on securely on the other two corners. -![](/assets/mtr-1-add-male-usb-pic-4.jpg) +![Pressing the new MTR-1 back on with the rear USB-C plug poking through](/assets/mtr-1-add-male-usb-pic-4.jpg) 6\. The case should sit flush and you're now ready to plug into a USB-C Outlet! -![](/assets/mtr-1-add-male-usb-pic-5.jpg) \ No newline at end of file +![MTR-1 with the new back sitting flush and the rear USB-C plug exposed](/assets/mtr-1-add-male-usb-pic-5.jpg) \ No newline at end of file diff --git a/docs/products/mtr1/examples/mtr1-alarmo.md b/docs/products/mtr1/examples/mtr1-alarmo.md index 2d366f1d64..0b362ff0dd 100755 --- a/docs/products/mtr1/examples/mtr1-alarmo.md +++ b/docs/products/mtr1/examples/mtr1-alarmo.md @@ -9,29 +9,29 @@ My grandmother wanted a security system that would alert her when there was move 1\. Install [HACS](https://hacs.xyz/docs/use/download/download/) 2\. Install [Alarmo](https://github.com/nielsfaber/alarmo?tab=readme-ov-file#installation) and the [Alarmo Card](https://github.com/nielsfaber/alarmo-card) (Pretty Arm and Disarm card for your HA dashboard) -![Alarmo 7.png](/assets/alarmo-7.png) +![Alarmo Card on a Home Assistant dashboard showing Disarmed with Arm Away and Arm Home buttons](/assets/alarmo-7.png) -![Alarmo 1.png](/assets/alarmo-1.png) +![Alarmo panel General tab in Home Assistant with the arm modes list, Armed home enabled](/assets/alarmo-1.png) 3\. Find Alarmo on the left, select the Sensors tab, and toggle on the sensor entities that you would like to use for your alarm system. -![Alarmo 2.png](/assets/alarmo-2.png) +![Alarmo Sensors tab with MSR-1 radar target entities toggled on for Home arm mode](/assets/alarmo-2.png) 4\. Now select the Actions tab and under Condition > Event > Select "Alarm is triggered". You can also select the device you would like to receive a notification on under Task > Target > Select Device (Phone, tablet, etc.) -![Alarmo 3.png](/assets/alarmo-3.png) +![Alarmo Configure notification with the Alarm is triggered event and a phone selected as target](/assets/alarmo-3.png) 5\. You can change the Title, Message, and Name of the alarm notification. -![Alarmo 4.png](/assets/alarmo-4.png) +![Alarmo notification settings with the Title, Message, and Name fields filled in](/assets/alarmo-4.png) 6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Uner Entity select your sensors RGB light. -![Alarmo 5.png](/assets/alarmo-5.png) +![Alarmo Configure action with Alarm is triggered and AIR-1 and MSR-1 RGB light entities selected](/assets/alarmo-5.png) 7\. Under Action select Turn On and now your sensors RGB lights will turn on when the alarm is triggered. -![Alarmo 6.png](/assets/alarmo-6.png) +![Alarmo action Task with Turn On selected for the RGB lights and the action named](/assets/alarmo-6.png) 8\. And that's it, seriously... Now you can enjoy a free and local security system. diff --git a/docs/products/mtr1/setup/general-tips.md b/docs/products/mtr1/setup/general-tips.md index a5b6b2cc54..cb57b6d6cf 100755 --- a/docs/products/mtr1/setup/general-tips.md +++ b/docs/products/mtr1/setup/general-tips.md @@ -6,11 +6,11 @@ description: Multiple helpful images for mounting, lux/rgb, and zone visualizati ##### **MTR-1 PCB with Sensors** -![20240501_155316.jpg](/assets/20240501-155316.jpg)![20240501_155130.jpg](/assets/20240501-155130.jpg)![20240501_155248.jpg](/assets/20240501-155248.jpg) +![MTR-1 main PCB with the ESP32-C3 module, Boot and RST buttons, RGB LED, and buzzer](/assets/20240501-155316.jpg)![MTR-1 main PCB with the blue HLK-LD2450 mmWave radar board and the CO2 module attached](/assets/20240501-155130.jpg)![Back of the MTR-1 PCB with the Apollo logo and USB-C port](/assets/20240501-155248.jpg) ##### **Light Sensor (LTR-390UV)** -![Screenshot 2024-04-30 at 5.42.54 PM.png](/assets/screenshot-2024-04-30-at-5-42-54-pm.png) +![MTR-1 case render with the large light sensor opening outlined in red](/assets/screenshot-2024-04-30-at-5-42-54-pm.png) When mounting the MTR-1 be sure to position the device so that the large hole at the top is not covered. This allows more light to enter and will ensure better accuracy @@ -18,19 +18,19 @@ The onboard RGB LED will trigger the light sensor. Be cognizant of this when mak ##### **Mounting** -![Screenshot 2024-04-30 at 5.51.36 PM.png](/assets/screenshot-2024-04-30-at-5-51-36-pm.png) +![LD2450 datasheet diagrams for wall mounting height, angle orientation, and tracking range](/assets/screenshot-2024-04-30-at-5-51-36-pm.png) ##### **LD2450 Performance and Electrical Parameters** ##### [**LD2450 Datasheet**](https://www.tinytronics.nl/index.php?route=product/product/get_file&file=6000/HLK-LD2450-Instruction-Manual.pdf) -![Screenshot 2024-04-30 at 5.53.09 PM.png](/assets/screenshot-2024-04-30-at-5-53-09-pm.png) +![LD2450 datasheet table of performance and electrical parameters](/assets/screenshot-2024-04-30-at-5-53-09-pm.png) ##### **Expanding Horizontal Distance as Target Moves Further Away** The detection is 60 degrees from center on each side. So it is a cone when you are close to it but at 4 feet away to the side you might not be visible. If you are further from the wall it can detect further in a horizontal distance. -![image.png](/assets/9jtimage.png) +![Hi-Link radar demo tracking targets inside a detection cone that widens with distance](/assets/9jtimage.png) ##### **Increased ESP Temperature** diff --git a/docs/products/mtr1/setup/zones-ha.md b/docs/products/mtr1/setup/zones-ha.md index 88e75790eb..2a9d8de209 100755 --- a/docs/products/mtr1/setup/zones-ha.md +++ b/docs/products/mtr1/setup/zones-ha.md @@ -22,17 +22,17 @@ Below are steps to manually enter in the X and Y coordinates for each zone in Ho 4\. Head to a dashboard view and click the pencil icon to edit dashboard then click one of the large "+" signs, type in manual, and click on it. -![](/assets/ld2450-add-plotly-graph-gif.gif) +![Adding a Manual card to a Home Assistant dashboard and pasting the Plotly YAML](/assets/ld2450-add-plotly-graph-gif.gif) 5\. Delete any text in the custom card then paste the YAML you copied above and click save when finished. You should now have a custom card that looks just like the card below! -![](/assets/mtr-1-card-working-targets.png) +![Finished MTR-1 Target Positions Plotly card with the coverage area and three zones](/assets/mtr-1-card-working-targets.png) 6\. Head to the [ESPHome Integrations page](http://homeassistant.local:8123/config/integrations/integration/esphome "Click me to go to the ESPHome integrations page") 7\. Click device as shown in the image below -![](/assets/mtr-1-select-mtr-1.png) +![ESPHome integrations page with a red arrow pointing to the Apollo MTR-1 device link](/assets/mtr-1-select-mtr-1.png) 8\. Scroll down until you get to the Configuration section and you see the empty boxes for zones 1-3 for both X and Y coordinates. @@ -46,7 +46,7 @@ Below are steps to manually enter in the X and Y coordinates for each zone in Ho 9\. Now we can input our Zone 1-3 X and Y values to make our zones. Using the visual card from above, we can walk, sit, or stand in the area where we want to create a detection or non-detection zone. Input values for X are -7000 mm to 7000 mm, and the Y values are 0 mm to 7000 mm. -![](/assets/ld2450-zone-input.png) +![Target Positions chart with arrows marking the X axis and Y axis in millimeters](/assets/ld2450-zone-input.png) !!! tip "Helpful Hints to understand zones better!" @@ -62,23 +62,23 @@ Below are steps to manually enter in the X and Y coordinates for each zone in Ho 10\. If you use the imperial system (Freedom Units) then you will need to do this step. Metric users can skip this. For the targets to show up correctly we first need to update the Target 1-3 X and Y measurements from inches (in) to millimeters (mm). Find Target 1-3 X and Y under the Sensors section and select them. You will want to update all 3 X and Y target values. -![](/assets/r-pro-1-card-change-units-from-inches.png) +![LD2450 Target-1 X and Y sensors showing values in inches, outlined in red](/assets/r-pro-1-card-change-units-from-inches.png) 11\. Select the Settings cog in the top right. -![](/assets/r-pro-1-card-change-units-settings.png) +![LD2450 Target-1 X sensor dialog with the Settings cog in the top right selected](/assets/r-pro-1-card-change-units-settings.png) 12\. Change the unit of measurement to mm and select Update. -![](/assets/mtr-1-uom-mm-1.png) +![MTR-1 Target-1 X entity settings with the unit of measurement set to mm](/assets/mtr-1-uom-mm-1.png) 13\. Your X and Y Targets will now look like this. -![](/assets/mtr-1-zone-setup-pic-1.png) +![Target 1 to 3 X and Y sensors now reading in mm, outlined in red](/assets/mtr-1-zone-setup-pic-1.png) 14\. Now you should see targets on the card. -![](/assets/mtr-1-card-working-targets.png) +![MTR-1 Target Positions card with the coverage area, three named zones, and Target 1 to 3 in the legend](/assets/mtr-1-card-working-targets.png) 15\. Now we can make zones around the targets where you want to Detect presence or filter them out. diff --git a/docs/products/mtr1/setup/zones-hlk.md b/docs/products/mtr1/setup/zones-hlk.md index ec04c50ae7..bb0e722a2b 100755 --- a/docs/products/mtr1/setup/zones-hlk.md +++ b/docs/products/mtr1/setup/zones-hlk.md @@ -22,7 +22,7 @@ The ESPHome Integrations page then select your MTR-1 and scroll down until you see LD2450 Bluetooth. -![Screenshot 2024-05-14 at 10.30.31 AM.png](/assets/mtr-1-toggle-on-ld2450-bluetooth.png) +![LD2450 Bluetooth switch turned on in the MTR-1 Configuration card, outlined in red](/assets/mtr-1-toggle-on-ld2450-bluetooth.png) 2\. Open the HLKRadarTool App and select your device. @@ -30,11 +30,11 @@ The uploading the firmware document. \ No newline at end of file diff --git a/docs/products/mtr1/troubleshooting/mtr1-code.md b/docs/products/mtr1/troubleshooting/mtr1-code.md index aa9ef31e64..7a0fd41101 100755 --- a/docs/products/mtr1/troubleshooting/mtr1-code.md +++ b/docs/products/mtr1/troubleshooting/mtr1-code.md @@ -12,7 +12,7 @@ If your device has already been connected to Home Assistant please Apollo PUMP-1 Installer. -![](/assets/pump-1-reflash-connect-button.png) +![Apollo PUMP-1 Installer page with the cursor on the Connect button](/assets/pump-1-reflash-connect-button.png) 5\. Select the open com port then click Connect. -![](/assets/pump-1-reflash-com-port.png) +![Browser serial port prompt with USB JTAG/serial debug unit selected and the cursor on Connect](/assets/pump-1-reflash-com-port.png) 7\.. Click Install PUMP-1. -![](/assets/pump-1-reflash-click-install.png) +![Device Dashboard menu with the cursor on Install ApolloAutomation.PUMP-1](/assets/pump-1-reflash-click-install.png) 7\. Click Install. -![](/assets/pump-1-reflash-click-install-confirm.png) +![Install ApolloAutomation.PUMP-1 confirmation dialog with the cursor on Install](/assets/pump-1-reflash-click-install-confirm.png) 8\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/pump-1-reflash-install-complete.png) +![Installer dialog showing Installation complete! with a Next button](/assets/pump-1-reflash-install-complete.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/new-product-template/troubleshooting/productname-reset-wi-fi-credentials.md b/docs/products/new-product-template/troubleshooting/productname-reset-wi-fi-credentials.md index 6228f41331..ec352e0fbf 100755 --- a/docs/products/new-product-template/troubleshooting/productname-reset-wi-fi-credentials.md +++ b/docs/products/new-product-template/troubleshooting/productname-reset-wi-fi-credentials.md @@ -8,7 +8,7 @@ description: Step by step guide for resetting the Wi-Fi Credentials on your PUMP 2\. Long press the Boot button (the button on the right) for 10 seconds. -![](/assets/pump-1-buttons-labeled-2.jpg) +![PUMP-1 with red arrows labeling the boot button on the right and the reset button on the left](/assets/pump-1-buttons-labeled-2.jpg) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/products/new-product-template/troubleshooting/productname-teardown.md b/docs/products/new-product-template/troubleshooting/productname-teardown.md index b43e5c591f..095800a7bb 100755 --- a/docs/products/new-product-template/troubleshooting/productname-teardown.md +++ b/docs/products/new-product-template/troubleshooting/productname-teardown.md @@ -14,22 +14,22 @@ description: >- 1\. Unplug the USB-C cable and remove the lid. -![](/assets/pump-1-remove-usb-c-and-lid-webp.webp) +![Unplugging the USB-C cable from the PUMP-1 and lifting off its lid](/assets/pump-1-remove-usb-c-and-lid-webp.webp) 2\. Remove the 3 pin JST connectors using your fingers or needle nose pliers. -![](/assets/pump-1-remove-jst-sensor-connectors-webp.webp) +![Pulling the two JST sensor connectors out of the open PUMP-1 with needle nose pliers](/assets/pump-1-remove-jst-sensor-connectors-webp.webp) 3\. Detach both the inlet and outlet tubes by pinching near the connection point and twisting gently while pulling - this makes removal much easier. -![](/assets/pump-1-remove-tubes-webp.webp) +![Pinching and twisting to pull the inlet and outlet tubes off the PUMP-1](/assets/pump-1-remove-tubes-webp.webp) ###### Reassembly 1\. Attach the two tubes to the pump as shown below. The fluid input tube is the left tube on the same side as the USB-C port and the fluid output tube is the tube on the right on the side of the PUMP-1. -![](/assets/pump-1-install-tubes-webp.webp) +![Pushing the inlet and outlet tubes onto the fittings of the open PUMP-1](/assets/pump-1-install-tubes-webp.webp) 2\. Insert the JST connector coming from your bottle's sensor into the **right-side port** on your PUMP-1 device. Ensure it is fully seated for proper operation. The small bump on top of the white connector must be facing **upwards** when inserting it. This ensures proper alignment and a secure connection. Follow up by inserting the second JST connector from the optional fluid output sensor into the **left-side port** on your PUMP-1 device. Ensure it is fully seated for proper operation. Finally, place the lid on top of the pump-1 case and gently snap it in place. -![](/assets/pump-1-install-jst-sensor-connectors-and-lid-webp.webp) \ No newline at end of file +![Plugging both fluid sensor JST connectors into the PUMP-1 and snapping the lid back on](/assets/pump-1-install-jst-sensor-connectors-and-lid-webp.webp) \ No newline at end of file diff --git a/docs/products/plt1/examples/blueprint.md b/docs/products/plt1/examples/blueprint.md index 37721c53c0..8959f2d99a 100644 --- a/docs/products/plt1/examples/blueprint.md +++ b/docs/products/plt1/examples/blueprint.md @@ -14,17 +14,17 @@ description: >- 2\. Click **Preview** then click **Import blueprint**. -![](/assets/btn-1-blueprint-auto-import.gif) +![Home Assistant Import a blueprint dialog, clicking Preview then Import blueprint (BTN-1 example shown)](/assets/btn-1-blueprint-auto-import.gif) 3\. Click on **Apollo Automation PLT-1 Blueprint** and click on **Select a device** then choose your **Apollo PLT-1** or **PLT-1B** from the dropdown menu. -![](/assets/btn-1-blueprint-select-btn-1.gif) +![Home Assistant blueprint editor, picking an Apollo device from Select a device (BTN-1 example shown)](/assets/btn-1-blueprint-select-btn-1.gif) 4\. Enter your **plant's name** (this appears in notification messages), then select your **mobile device** for push notifications. 5\. Enable the sensor groups you want to monitor (e.g. Soil Moisture, Air Temperature, Light Intensity) and adjust the thresholds to suit your plant. -![](/assets/btn-1-blueprint-single-click-example.gif) +![Home Assistant blueprint editor adding a light toggle action and saving (BTN-1 example shown)](/assets/btn-1-blueprint-single-click-example.gif) !!! success "Each sensor group is disabled by default — enable only what matters!" @@ -41,19 +41,19 @@ description: >- 1\. Head to the automations page and click on **Blueprints** in the top right then select **Import Blueprint**. -![](/assets/btn-1-blueprint-manual-import.gif) +![Home Assistant Settings, Automations and scenes, Blueprints tab, then the Import blueprint button](/assets/btn-1-blueprint-manual-import.gif) 2\. Copy this link and paste it into the **Blueprint address** box and click **Preview** then click **Import blueprint**. -![](/assets/btn-1-blueprint-auto-import.gif) +![Home Assistant Import a blueprint dialog, clicking Preview then Import blueprint (BTN-1 example shown)](/assets/btn-1-blueprint-auto-import.gif) 3\. Click on **Apollo Automation PLT-1 Blueprint** and click on **Select a device** then choose your **Apollo PLT-1** or **PLT-1B** from the dropdown menu. -![](/assets/btn-1-blueprint-select-btn-1.gif) +![Home Assistant blueprint editor, picking an Apollo device from Select a device (BTN-1 example shown)](/assets/btn-1-blueprint-select-btn-1.gif) 4\. Enter your **plant's name**, select your **mobile device**, enable the sensor groups you want, and set your thresholds. -![](/assets/btn-1-blueprint-single-click-example.gif) +![Home Assistant blueprint editor adding a light toggle action and saving (BTN-1 example shown)](/assets/btn-1-blueprint-single-click-example.gif) !!! success "Each sensor group is disabled by default — enable only what matters!" diff --git a/docs/products/plt1/examples/flower-card.md b/docs/products/plt1/examples/flower-card.md index b0a9e29bd2..5be7eab68c 100755 --- a/docs/products/plt1/examples/flower-card.md +++ b/docs/products/plt1/examples/flower-card.md @@ -2,7 +2,7 @@ title: PLT-1 Flower Card description: This suggests using the Flower Card inside Home Assistant for your device! --- -![](/assets/screenshot-2024-09-26-at-10-17-09-am.png) +![Home Assistant Flower Card for a ZZ Plant with moisture, temperature, light, and humidity bars](/assets/screenshot-2024-09-26-at-10-17-09-am.png) Home Assistant Plant Integration

This integration can automatically fetch data from OpenPlantBook if you are a registered user. Registration is free.

Plants are set up in the UI and all configuration of your plants can be managed there or by automations and scripts. diff --git a/docs/products/plt1/general-tips.md b/docs/products/plt1/general-tips.md index f7953c6ed9..290d345d74 100755 --- a/docs/products/plt1/general-tips.md +++ b/docs/products/plt1/general-tips.md @@ -8,4 +8,4 @@ description: Helpful tips to get the most use out of your sensor. For the most accurate UV and LUX readings, be sure to expose the sensor circled in the image below to light. -![](/assets/screenshot-2024-10-22-at-3-35-46-pm.png) \ No newline at end of file +![Back of the PLT-1 with the LTR390 UV and light sensor circled in red at top left](/assets/screenshot-2024-10-22-at-3-35-46-pm.png) \ No newline at end of file diff --git a/docs/products/plt1/setup/prevent-sleep.md b/docs/products/plt1/setup/prevent-sleep.md index 388b657989..26a8381aee 100755 --- a/docs/products/plt1/setup/prevent-sleep.md +++ b/docs/products/plt1/setup/prevent-sleep.md @@ -14,11 +14,11 @@ description: Tutorial for how to enable/disable prevent sleep. 2\. Click on the name "1 device" below your Apollo device's name. -![](/assets/plt-1-prevent-sleep-pic-1.png) +![ESPHome integration entry for an Apollo PLT-1 with the 1 device link highlighted](/assets/plt-1-prevent-sleep-pic-1.png) 3\. Scroll down until you see "Prevent Sleep" and "Sleep Duration". -![](/assets/plt-1-prevent-sleep-pic-2.png) +![Prevent Sleep toggle and Sleep Duration box highlighted on the PLT-1 device page](/assets/plt-1-prevent-sleep-pic-2.png) 4\. Type in the amount of minutes you want your sensor to sleep in the "Sleep Duration" box. Defaults to 5 minutes. diff --git a/docs/products/plt1/troubleshooting/plt1-boot-mode.md b/docs/products/plt1/troubleshooting/plt1-boot-mode.md index 3084f12a70..1fa4b8fde6 100755 --- a/docs/products/plt1/troubleshooting/plt1-boot-mode.md +++ b/docs/products/plt1/troubleshooting/plt1-boot-mode.md @@ -12,7 +12,7 @@ description: Step by step guide for putting The PLT-1 In Boot Mode. 1\. Position the PLT-1 as shown in the image below and locate the small opening to press the boot button. -![](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) +![Side of the PLT-1 case with the boot button opening circled in red](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) 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. @@ -26,6 +26,6 @@ description: Step by step guide for putting The PLT-1 In Boot Mode. 3\. Hold down the boot button, then press and release the reset button while keeping the boot button pressed. Finally, release the boot button. -![](/assets/screenshot-2024-10-23-at-12-35-01-pm.png) +![PLT-1 with a USB-C cable plugged in and the reset button circled in red below the port](/assets/screenshot-2024-10-23-at-12-35-01-pm.png) 4\. Continue with uploading the firmware document. \ No newline at end of file diff --git a/docs/products/plt1/troubleshooting/plt1-code.md b/docs/products/plt1/troubleshooting/plt1-code.md index 2d9d8194b0..c0305644f8 100755 --- a/docs/products/plt1/troubleshooting/plt1-code.md +++ b/docs/products/plt1/troubleshooting/plt1-code.md @@ -12,29 +12,29 @@ If your device has already been connected to Home Assistant please Put your device in boot mode by holding down the boot button and then plugging in the USB cable. -![](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) +![Side of the PLT-1 case with the boot button opening circled in red](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) 2\. Navigate to our installer page and click connect under Non Battery Firmware Apollo PLT-1 Installer 3\. Click the big "Connect" button. -![](/assets/plt-1-reflash-pic-1-1.png) +![Apollo PLT-1 Installer with the Non Battery Firmware Connect button highlighted](/assets/plt-1-reflash-pic-1-1.png) 4\. Select the open com port then click Connect. -![](/assets/plt-1-reflash-pic-2-1.png) +![Browser serial port prompt with USB JTAG/serial debug unit selected and the cursor on Connect](/assets/plt-1-reflash-pic-2-1.png) 5\. Click "Install ApolloAutomation.PLT-1". -![](/assets/plt-1-reflash-pic-3.png) +![Device Dashboard menu with Install ApolloAutomation.PLT-1 highlighted](/assets/plt-1-reflash-pic-3.png) 6\. Click "INSTALL". -![](/assets/plt-1-reflash-pic-4.png) +![Install ApolloAutomation.PLT-1 confirmation dialog with the Install button highlighted](/assets/plt-1-reflash-pic-4.png) 7\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/plt-1-reflash-pic-5.png) +![Installer dialog showing Installation complete! with a Next button](/assets/plt-1-reflash-pic-5.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md b/docs/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md index 02cb8eddd5..8c99f3cf1b 100755 --- a/docs/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md +++ b/docs/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md @@ -8,7 +8,7 @@ description: Step by step guide for resetting the Wi-Fi Credentials on your PLT- 2\. Long press the Boot button for 10 seconds -![](/assets/plt-1-boot-button-pic-1.png) +![Side of the PLT-1 case with the boot button opening circled in red](/assets/plt-1-boot-button-pic-1.png) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/products/plt1b/additional-info/insert-battery.md b/docs/products/plt1b/additional-info/insert-battery.md index 2e16013b50..c31af6ef72 100644 --- a/docs/products/plt1b/additional-info/insert-battery.md +++ b/docs/products/plt1b/additional-info/insert-battery.md @@ -10,28 +10,28 @@ description: How to Insert Battery on PLT-1B. 1\. Gently press your thumb on the case above the stake and the lid should pop off. -![](/assets/plt-1b-remove-case-lid.webp) +![Pressing on the PLT-1B case lid above the stake until the lid pops off](/assets/plt-1b-remove-case-lid.webp) 2\. Hold the case and push the stake down a bit, then gently lift it out of the bottom case section. -![](/assets/plt-1b-lift-pcb-out-of-case.webp) +![Lifting the PLT-1B board out of its case and flipping it over to show the battery holder](/assets/plt-1b-lift-pcb-out-of-case.webp) 3\. Flip the PLT-1B over and identify the `+` and `-` markings. The `+` is on the left side and the `-` is on the right side. Double check before going any further. 4\. The top of the battery (the positive end, marked with a `+` and a small ring around the terminal) goes on the left side, matching the `+` on the PLT-1B. -![](/assets/plt-1b-identify-top-of-18650-battery.webp) +![Turning an 18650 battery to show its positive top end with the ringed terminal](/assets/plt-1b-identify-top-of-18650-battery.webp) 5\. Hold the PCB. You'll need to use a bit of force to push in the battery. Start with the right `-` side, then push in the left `+` side. -![](/assets/plt-1b-insert-battery.webp) +![Pressing an 18650 battery into the battery holder on the back of the PLT-1B board](/assets/plt-1b-insert-battery.webp) 6\. Flip the sensor back over and lay the PCB inside the case so it sits flat. -![](/assets/plt-1b-place-pcb-in-case.webp) +![Laying the PLT-1B board flat back inside the bottom of its case](/assets/plt-1b-place-pcb-in-case.webp) 7\. Line up the notch in the top left of the lid, then gently press down until the lid snaps into place. -![](/assets/plt-1b-replace-case-lid.webp) +![Lining up and snapping the lid back onto the PLT-1B case](/assets/plt-1b-replace-case-lid.webp) You have now installed or reinstalled the battery! \ No newline at end of file diff --git a/docs/products/plt1b/general-tips.md b/docs/products/plt1b/general-tips.md index 6e098b9fd5..a569e1de74 100755 --- a/docs/products/plt1b/general-tips.md +++ b/docs/products/plt1b/general-tips.md @@ -8,4 +8,4 @@ description: Helpful tips to get the most use out of your sensor. For the most accurate UV and LUX readings, be sure to expose the sensor circled in the image below to light. -![](/assets/plt-1b-buttons-1.png) \ No newline at end of file +![PLT-1B diagram with the LTR390 UV and light sensor circled in red at top left](/assets/plt-1b-buttons-1.png) \ No newline at end of file diff --git a/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md b/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md index 56712c6c7b..25ceb70bf1 100755 --- a/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md +++ b/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md @@ -8,15 +8,15 @@ description: Step by step guide for putting The PLT-1B In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -![](/assets/plt-1b-buttons-2.png) +![PLT-1B diagram labeling the reset button on the left and the USB-C port and boot button on the right](/assets/plt-1b-buttons-2.png) ##### Method 1: Boot Button Only 1\. Position the PLT-1B as shown in the image below and locate the small opening to press the boot button. -![](/assets/plt-boot-mode-pic-2.jpg) +![Open PLT-1B case with tweezers pointing at the boot button (SW1) next to the USB-C port](/assets/plt-boot-mode-pic-2.jpg) -![](/assets/plt-boot-mode-pic-4.jpg) +![Closed PLT-1B case with tweezers inserted into the boot button opening on the side](/assets/plt-boot-mode-pic-4.jpg) 2\. Use a pin to press and hold the boot button, while holding the boot button plug the PLT-1B back into your computer/power and then release the boot button @@ -28,8 +28,8 @@ description: Step by step guide for putting The PLT-1B In Boot Mode. 2\. Press and hold the boot button, while holding it press and release the reset button, then release the boot button -![](/assets/plt-boot-mode-pic-6.jpg) +![Open PLT-1B case with tweezers pointing near the reset button labeled SW2 RST](/assets/plt-boot-mode-pic-6.jpg) -![](/assets/plt-boot-mode-pic-7.jpg) +![Closed PLT-1B case with tweezers pointing at the reset button opening on the side](/assets/plt-boot-mode-pic-7.jpg) 3\. Continue with [uploading the firmware](https://wiki.apolloautomation.com/products/plt1b/troubleshooting/plt1b-code/) \ No newline at end of file diff --git a/docs/products/plt1b/troubleshooting/plt1b-code.md b/docs/products/plt1b/troubleshooting/plt1b-code.md index ae2534b6b8..e02b44a9e8 100755 --- a/docs/products/plt1b/troubleshooting/plt1b-code.md +++ b/docs/products/plt1b/troubleshooting/plt1b-code.md @@ -14,17 +14,17 @@ If your device has already been connected to Home Assistant please Put your device in boot mode by holding down the boot button and then plugging in the USB cable. -![](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) +![Side of a PLT-1 case with the boot button opening circled in red](/assets/screenshot-2024-10-23-at-12-32-55-pm.png) 2\. Navigate to our installer page and click connect under Battery Firmware Apollo PLT-1B Installer @@ -52,23 +52,23 @@ If your device has already been connected to Home Assistant please Apollo PUMP-1 Installer. -![](/assets/pump-1-reflash-connect-button.png) +![Apollo PUMP-1 Installer page with the cursor on the Connect button](/assets/pump-1-reflash-connect-button.png) 5\. Select the open com port then click Connect. -![](/assets/pump-1-reflash-com-port.png) +![Browser serial port prompt with USB JTAG/serial debug unit selected and the cursor on Connect](/assets/pump-1-reflash-com-port.png) 7\.. Click Install PUMP-1. -![](/assets/pump-1-reflash-click-install.png) +![Device Dashboard menu with the cursor on Install ApolloAutomation.PUMP-1](/assets/pump-1-reflash-click-install.png) 7\. Click Install. -![](/assets/pump-1-reflash-click-install-confirm.png) +![Install ApolloAutomation.PUMP-1 confirmation dialog with the cursor on Install](/assets/pump-1-reflash-click-install-confirm.png) 8\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/pump-1-reflash-install-complete.png) +![Installer dialog showing Installation complete! with a Next button](/assets/pump-1-reflash-install-complete.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md b/docs/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md index 6228f41331..ec352e0fbf 100755 --- a/docs/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md +++ b/docs/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md @@ -8,7 +8,7 @@ description: Step by step guide for resetting the Wi-Fi Credentials on your PUMP 2\. Long press the Boot button (the button on the right) for 10 seconds. -![](/assets/pump-1-buttons-labeled-2.jpg) +![PUMP-1 with red arrows labeling the boot button on the right and the reset button on the left](/assets/pump-1-buttons-labeled-2.jpg) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/products/pump1/troubleshooting/pump1-teardown.md b/docs/products/pump1/troubleshooting/pump1-teardown.md index b43e5c591f..095800a7bb 100755 --- a/docs/products/pump1/troubleshooting/pump1-teardown.md +++ b/docs/products/pump1/troubleshooting/pump1-teardown.md @@ -14,22 +14,22 @@ description: >- 1\. Unplug the USB-C cable and remove the lid. -![](/assets/pump-1-remove-usb-c-and-lid-webp.webp) +![Unplugging the USB-C cable from the PUMP-1 and lifting off its lid](/assets/pump-1-remove-usb-c-and-lid-webp.webp) 2\. Remove the 3 pin JST connectors using your fingers or needle nose pliers. -![](/assets/pump-1-remove-jst-sensor-connectors-webp.webp) +![Pulling the two JST sensor connectors out of the open PUMP-1 with needle nose pliers](/assets/pump-1-remove-jst-sensor-connectors-webp.webp) 3\. Detach both the inlet and outlet tubes by pinching near the connection point and twisting gently while pulling - this makes removal much easier. -![](/assets/pump-1-remove-tubes-webp.webp) +![Pinching and twisting to pull the inlet and outlet tubes off the PUMP-1](/assets/pump-1-remove-tubes-webp.webp) ###### Reassembly 1\. Attach the two tubes to the pump as shown below. The fluid input tube is the left tube on the same side as the USB-C port and the fluid output tube is the tube on the right on the side of the PUMP-1. -![](/assets/pump-1-install-tubes-webp.webp) +![Pushing the inlet and outlet tubes onto the fittings of the open PUMP-1](/assets/pump-1-install-tubes-webp.webp) 2\. Insert the JST connector coming from your bottle's sensor into the **right-side port** on your PUMP-1 device. Ensure it is fully seated for proper operation. The small bump on top of the white connector must be facing **upwards** when inserting it. This ensures proper alignment and a secure connection. Follow up by inserting the second JST connector from the optional fluid output sensor into the **left-side port** on your PUMP-1 device. Ensure it is fully seated for proper operation. Finally, place the lid on top of the pump-1 case and gently snap it in place. -![](/assets/pump-1-install-jst-sensor-connectors-and-lid-webp.webp) \ No newline at end of file +![Plugging both fluid sensor JST connectors into the PUMP-1 and snapping the lid back on](/assets/pump-1-install-jst-sensor-connectors-and-lid-webp.webp) \ No newline at end of file diff --git a/docs/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md b/docs/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md index 3ac4ddd8f5..68099dbb11 100755 --- a/docs/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md +++ b/docs/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md @@ -4,7 +4,7 @@ description: Tutorial on adding the LD2412 mmwave sensor to your R PRO-1 --- # Install the LD2412 in R PRO-1 -![](/assets/r-pro-1-ld2412-install.webp) +![Removing the R PRO-1 back, fitting the LD2412 onto its headers, and reassembling the case](/assets/r-pro-1-ld2412-install.webp) !!! tip "Check out the gif above or step by step directions below!" @@ -12,20 +12,20 @@ description: Tutorial on adding the LD2412 mmwave sensor to your R PRO-1 1\. Unplug your R PRO-1 from power and remove the back. -![](/assets/rpro-1-add-co2-lift-lid-1.webp)![](/assets/rpro-1-add-co2-remove-lid.webp) +![Prying the R PRO-1 back plate loose from the case with tweezers](/assets/rpro-1-add-co2-lift-lid-1.webp)![Lifting the R PRO-1 back plate off the case by hand](/assets/rpro-1-add-co2-remove-lid.webp) 2\. Gently remove the PCB from the case and flip it over. -![](/assets/r-pro-1-no-case-mmwave-facing-up.webp) +![R PRO-1 board out of its case, mmWave side up, with the LD2450 and LD2412 sensors](/assets/r-pro-1-no-case-mmwave-facing-up.webp) 3\. Place the LD2412 on the 4 and 3 pin headers (only fits one way). -![](/assets/r-pro-1-reassembly-install-ld2412.jpg) +![Lowering the LD2412 module onto its pin headers on the R PRO-1 board](/assets/r-pro-1-reassembly-install-ld2412.jpg) 4\. Place back into the case with the ethernet module facing up and the usb-c port facing you. -![](/assets/r-pro-1-lid-removed.jpg) +![R PRO-1 board seated in its case with the Ethernet port up and the USB-C port facing you](/assets/r-pro-1-lid-removed.jpg) 5\. Snap the lid back into place! -![](/assets/r-pro-1-lid-press-down.jpg) \ No newline at end of file +![Pressing the back plate down onto the R PRO-1 case until it snaps into place](/assets/r-pro-1-lid-press-down.jpg) \ No newline at end of file diff --git a/docs/products/rpro1/addons/adding-co2-to-r-pro-1.md b/docs/products/rpro1/addons/adding-co2-to-r-pro-1.md index 7fbc6d7335..ae85a328e3 100755 --- a/docs/products/rpro1/addons/adding-co2-to-r-pro-1.md +++ b/docs/products/rpro1/addons/adding-co2-to-r-pro-1.md @@ -6,7 +6,7 @@ description: Tutorial on adding the SCD40 CO2 sensor to your R-Pro-1. 1\. Unplug your R PRO-1 from power and remove the back. -![](/assets/rpro-1-add-co2-lift-lid-1.webp)![](/assets/rpro-1-add-co2-remove-lid.webp) +![Prying the R PRO-1 back plate loose from the case with tweezers](/assets/rpro-1-add-co2-lift-lid-1.webp)![Lifting the R PRO-1 back plate off the case by hand](/assets/rpro-1-add-co2-remove-lid.webp) 2\. With the back removed, identify the bottom left corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the SCD40 CO2 sensor. There is an X on the SCD40 sensor's PCB as well, you can see it in the image below but it is slightly cut off on the PCB itself. @@ -17,12 +17,12 @@ description: Tutorial on adding the SCD40 CO2 sensor to your R-Pro-1. 3\. Gently push the SCD40 CO2 module onto the black mezzanine connector. -![](/assets/rpro-1-add-co2-seat-scd40.jpg)![](/assets/rpro-1-add-co2-scd40-installed.jpg) +![Pressing the SCD40 CO2 module onto its connector on the R PRO-1 board](/assets/rpro-1-add-co2-seat-scd40.jpg)![SCD40 CO2 module installed beside the Ethernet port on the R PRO-1 board](/assets/rpro-1-add-co2-scd40-installed.jpg) 4\. Slide the case back over the R PRO-1, making sure that the case has the hole for the USB-C port and the SCD40 facing toward you. 5\. Gently press the backplate of the R PRO-1 case onto the R PRO-1 until it lightly snaps into place. Please do not force it, if necessary please repeat steps above until it seats in the case without any force required. -![](/assets/r-pro-1-scd40-installed-press-case-down.jpg) +![Pressing the R PRO-1 back plate into place with the SCD40 showing through its opening](/assets/r-pro-1-scd40-installed-press-case-down.jpg) [Click here to head to the CO2 calibration guide!](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md b/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md index fe7ef71573..43eeac1adc 100755 --- a/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md +++ b/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md @@ -8,11 +8,11 @@ description: Tutorial on adding the gang box mounts to your R-Pro-1. 1\. Unplug your R PRO-1 from power and remove the back. -![](/assets/rpro-1-add-co2-lift-lid-1.webp)![](/assets/rpro-1-add-co2-remove-lid.webp) +![Prying the R PRO-1 back plate loose from the case with tweezers](/assets/rpro-1-add-co2-lift-lid-1.webp)![Lifting the R PRO-1 back plate off the case by hand](/assets/rpro-1-add-co2-remove-lid.webp) 2\. Gently lift the PCB out of the case and set it face up with the USB-C port facing down. -![](/assets/r-pro-1-no-case-mmwave-facing-up.webp) +![R PRO-1 board out of its case, face up, with the LD2450 and LD2412 mmWave sensors](/assets/r-pro-1-no-case-mmwave-facing-up.webp) 3\. Take the two gang box mount pieces and identify the one labeled "TOP" and the other piece which is the bottom mount. @@ -22,26 +22,26 @@ description: Tutorial on adding the gang box mounts to your R-Pro-1. 3\. Gently push the top mount labeled "TOP" into the pcb as shown below. Make sure the orientation is identical to the image below! -![](/assets/r-pro-1-gang-box-top-mount.jpg) +![Clear gang box mount labeled TOP pushed onto the top edge of the R PRO-1 board](/assets/r-pro-1-gang-box-top-mount.jpg) 4\. Gently push the top mount into the pcb as shown below. Make sure the orientation is identical to the image below! -![](/assets/r-pro-1-gang-box-bottom-mount.jpg) +![Clear bottom gang box mount pushed onto the bottom edge of the R PRO-1 board below the LD2412](/assets/r-pro-1-gang-box-bottom-mount.jpg) 5\. The end result should look identical to the image below. You are now ready to install it inside of a 1 gang box. -![](/assets/r-pro-1-gang-box-mounts-installed.jpg) +![R PRO-1 board with the TOP mount on the top edge and the bottom mount on the bottom edge](/assets/r-pro-1-gang-box-mounts-installed.jpg) ###### Install in 1-Gang Box 1\. Line up the holes in your 1-gang box (yours will be attached to the wall already). -![](/assets/r-pro-1-gang-box-line-up-holes.jpg) +![R PRO-1 with mounts sitting in a 1-gang box, mount holes lined up with the box holes](/assets/r-pro-1-gang-box-line-up-holes.jpg) 2\. Place screws through the blank faceplate and gently place over the r-pro-1 mounting holes. -![](/assets/r-pro-1-gang-box-install-faceplate.jpg) +![Holding a blank faceplate with screws over the R PRO-1 mounted in a 1-gang box](/assets/r-pro-1-gang-box-install-faceplate.jpg) 3\. Screw in the screws slowly to make sure not to break the mounts or the blank faceplate. At the end yours will look just like the image below! -![](/assets/r-pro-1-gang-box-face-plate-installed-finished.jpg) \ No newline at end of file +![Blank white faceplate screwed onto the 1-gang box, covering the R PRO-1](/assets/r-pro-1-gang-box-face-plate-installed-finished.jpg) \ No newline at end of file diff --git a/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md b/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md index 58d271f9a2..0319f25329 100755 --- a/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md +++ b/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md @@ -12,13 +12,13 @@ Watch our step by step video on installing the R PRO-1 using the Ceiling Mount. 1\. Unplug your R PRO-1 from power and remove the back. -![](/assets/rpro-1-add-co2-lift-lid-1.webp) +![Small tool prying up the R PRO-1 back lid at the seam below the USB-C port](/assets/rpro-1-add-co2-lift-lid-1.webp) -![](/assets/rpro-1-add-co2-remove-lid.webp) +![R PRO-1 back lid lifted off by hand, exposing the PCB inside the case](/assets/rpro-1-add-co2-remove-lid.webp) 2\. Gently lift the PCB out of the case and set it face up with the USB-C port facing down. -![](/assets/r-pro-1-no-case-mmwave-facing-up.webp) +![R PRO-1 PCB out of its case, face up with the LD2450 and LD2412 mmWave sensors visible](/assets/r-pro-1-no-case-mmwave-facing-up.webp) 3\. Take the two ceiling mount pieces and identify the one labeled "TOP" and the other piece which is the bottom mount. @@ -28,15 +28,15 @@ Watch our step by step video on installing the R PRO-1 using the Ceiling Mount. 3\. Gently push the top mount labeled "TOP" into the pcb as shown below. Make sure the orientation is identical to the image below! -![](/assets/r-pro-1-ceiling-box-top-mount.webp) +![Ceiling mount piece labeled TOP pushed onto the top edge of the R PRO-1 PCB](/assets/r-pro-1-ceiling-box-top-mount.webp) 4\. Gently push the bottom mount into the pcb as shown below. Make sure the orientation is identical to the image below! -![](/assets/r-pro-1-ceiling-box-bottom-mount.webp) +![Bottom ceiling mount piece pushed onto the R PRO-1 PCB edge below the LD2412 sensor](/assets/r-pro-1-ceiling-box-bottom-mount.webp) 5\. The end result should look identical to the image below. You are now ready to install it inside of the ceiling mount. -![](/assets/r-pro-1-ceiling-box-mounts-installed.webp) +![R PRO-1 PCB with both the TOP and bottom ceiling mount pieces attached](/assets/r-pro-1-ceiling-box-mounts-installed.webp) ###### Cut the Ceiling Hole @@ -46,22 +46,22 @@ The Ceiling Mount needs a 3.5 inch (around 89mm) circular hole in the ceiling. C 1\. Remove the cover to expose the inside of the installed Ceiling Mount. -![](/assets/r-pro-1-ceiling-mount-cover-removed.webp) +![Ceiling mount installed in the ceiling with its cover removed, showing the opening](/assets/r-pro-1-ceiling-mount-cover-removed.webp) 2\. Plug in Ethernet cable or USB-C cable. -![](/assets/r-pro-1-ceiling-mount-plug-in-eth.webp) +![Ethernet cable plugged into the R PRO-1 with mounts attached, held at the ceiling mount](/assets/r-pro-1-ceiling-mount-plug-in-eth.webp) 3\. Gently slide R PRO-1 into the Ceiling Mount. -![](/assets/r-pro-1-ceiling-mount-insert-r-pro-1.webp) +![R PRO-1 with the TOP mount upward being slid into the ceiling mount](/assets/r-pro-1-ceiling-mount-insert-r-pro-1.webp) 4\. Push the R PRO-1 back 1inch (around 2.5cm) to make sure the lip of the cover fits over the Ceiling Mount. -![](/assets/r-pro-1-ceiling-mount-recess-r-pro-1.webp) +![R PRO-1 pushed back and recessed inside the ceiling mount](/assets/r-pro-1-ceiling-mount-recess-r-pro-1.webp) 5\. Gently press the ceiling mount cover until it is securely attached to the Ceiling Mount. -![](/assets/r-pro-1-ceiling-mount-replace-cover.webp) +![Hand pressing the cover onto the ceiling mount until it is secured](/assets/r-pro-1-ceiling-mount-replace-cover.webp)   \ No newline at end of file diff --git a/docs/products/rpro1/calibrating-co2.md b/docs/products/rpro1/calibrating-co2.md index 4427c558c6..e431278ba9 100755 --- a/docs/products/rpro1/calibrating-co2.md +++ b/docs/products/rpro1/calibrating-co2.md @@ -16,7 +16,7 @@ This article will guide you through a simple calibration of your CO2 1\. Plug in your sensor outdoors and leave it for at least 5 minutes to allow the readings to stabilize. This should be around 420 ppm per NASA. -![](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) +![Apollo AIR-1 plugged in by USB-C cable outdoors to read fresh air for CO2 calibration](/assets/air-1-co2-calibration-portrait-quick-pic-3.jpg) 2\. Go to your Home Assistant dashboard and hit the letter "e" - It will pop up with an entity filter then type in "Calibrate CO2" and select the correct device. @@ -24,8 +24,8 @@ This article will guide you through a simple calibration of your CO2 If you cannot get this menu to pop-up, click somewhere on the Home Assistant dashboard then press your "e" key. -![Image of popup with CO2 calibration choice circled in red](/assets/co2-calibration-quick-pic-1.png) +![Home Assistant entity search for Calibrate CO2 with the Calibrate SCD40 To 420ppm entity circled in red](/assets/co2-calibration-quick-pic-1.png) 3\. Click on the button that says "PRESS" and then you are done. -![Image of popup with CO2 calibration press button circled in red](/assets/co2-calibration-quick-pic-2.png) \ No newline at end of file +![AIR-1 Calibrate SCD40 To 420ppm dialog with PRESS circled and an arrow to the new logbook entry](/assets/co2-calibration-quick-pic-2.png) \ No newline at end of file diff --git a/docs/products/rpro1/setup/rpro1-general-tips.md b/docs/products/rpro1/setup/rpro1-general-tips.md index f3e2dfb474..0a40ee17f0 100755 --- a/docs/products/rpro1/setup/rpro1-general-tips.md +++ b/docs/products/rpro1/setup/rpro1-general-tips.md @@ -6,7 +6,7 @@ description: Multiple helpful images for mounting, lux/rgb, and gate and zone vi ##### **Light Sensor (LTR-390UV)** -![20240514_123742.jpg](/assets/rpro-ltr-390.jpg) +![Probe pointing at the LTR-390UV light sensor on the R PRO-1 board next to the RGB LED](/assets/rpro-ltr-390.jpg) The R PRO-1 doesn't have any slits on the front of the case, so UV rays can't directly reach the sensor for UV detection. However, light can still enter from around the edges or behind the front panel, allowing the lux readings to spike when ambient light is present. @@ -18,13 +18,13 @@ The R PRO-1 doesn't have any slits on the front of the case, so UV rays can't di The R PRO-1 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120 degree FOV for the LD2450 and 150 degree FOV for the LD2412. -![ld2410_mounting_hor-1.jpeg](/assets/ld2412-wall-mount-radar-cone.png) +![LD2412 wall mounting diagram with the radar 1.5 to 2 m high and a 9 m range](/assets/ld2412-wall-mount-radar-cone.png) ##### **Ceiling Mounting** The R PRO-1 should be mounted 2.6-3 meters (8-10 feet) high when mounted on the ceiling using our ceiling mount kit. -![LD2410 Gates.png](/assets/ld2412-ceiling-mount-radar-cone.png) +![LD2412 ceiling mounting diagram with the radar 2.6 to 3 m high above a person](/assets/ld2412-ceiling-mount-radar-cone.png) !!! tip "There are actually two sensors in your r-pro-1 if you bought the optional LD2412 addon!" @@ -50,4 +50,4 @@ The R PRO-1 should be mounted 2.6-3 meters (8-10 feet) high when mounted on the ##### **Gate Visualization** -![](/assets/ld2412-gate-visualization.png) \ No newline at end of file +![LD2412 gate table listing distance in meters and feet with default move and still thresholds](/assets/ld2412-gate-visualization.png) \ No newline at end of file diff --git a/docs/products/rpro1/setup/rpro1-switch-firmware.md b/docs/products/rpro1/setup/rpro1-switch-firmware.md index ac5aea3fb0..5ad4ae1d25 100755 --- a/docs/products/rpro1/setup/rpro1-switch-firmware.md +++ b/docs/products/rpro1/setup/rpro1-switch-firmware.md @@ -14,15 +14,15 @@ description: >- 1\. Navigate to the ESPHome integration by going to settings -> esphome integration -> click on "1 device" below your Apollo R PRO-1. -![](/assets/select-r-pro-1-device.png) +![Red arrow on the 1 device link under Apollo R PRO-1 in the Home Assistant ESPHome integration](/assets/select-r-pro-1-device.png) 2\. Scroll down until you see the "Firmware Type" dropdown and select "Ethernet". -![](/assets/r-pro-1-select-ethernet-2.png) +![Firmware Type dropdown set to Ethernet in the R PRO-1 Configuration card in Home Assistant](/assets/r-pro-1-select-ethernet-2.png) 3\. Locate the Firmware Update entity and click on "PRESS". -![](/assets/r-pro-1-click-press-on-firmware-update-button.png) +![R PRO-1 Configuration card in Home Assistant with the Firmware Update PRESS button highlighted](/assets/r-pro-1-click-press-on-firmware-update-button.png) 4\. Wait a few minutes - this will download the new firmware file from our github repo and then install the image. @@ -32,15 +32,15 @@ description: >- 1\. Navigate to the ESPHome integration by going to settings -> esphome integration -> click on "1 device" below your Apollo R PRO-1. -![](/assets/select-r-pro-1-device.png) +![Red arrow on the 1 device link under Apollo R PRO-1 in the Home Assistant ESPHome integration](/assets/select-r-pro-1-device.png) 2\. Scroll down until you see the "Firmware Type" dropdown and select "WiFi". -![](/assets/r-pro-1-select-wifi.png) +![Firmware Type dropdown open in Home Assistant with the WiFi option selected for the R PRO-1](/assets/r-pro-1-select-wifi.png) 3\. Locate the Firmware Update entity and click on "PRESS". -![](/assets/r-pro-1-click-press-on-firmware-update-button.png) +![R PRO-1 Configuration card in Home Assistant with the Firmware Update PRESS button highlighted](/assets/r-pro-1-click-press-on-firmware-update-button.png) 4\. Wait a few minutes - this will download the new firmware file from our github repo and then install the image. diff --git a/docs/products/rpro1/setup/zones-ha-new.md b/docs/products/rpro1/setup/zones-ha-new.md index 5f892d5ce1..942fe2e4e6 100755 --- a/docs/products/rpro1/setup/zones-ha-new.md +++ b/docs/products/rpro1/setup/zones-ha-new.md @@ -20,11 +20,11 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir 2\. Scroll down until you see "LD2450 Zone Type" and choose "Detection" from the drop-down menu. -![](/assets/r-pro-1-select-detection.png) +![LD2450 Zone Type dropdown in Home Assistant with Detection selected](/assets/r-pro-1-select-detection.png) 3\. Begin entering in the X and Y coordinates for each zone. -![](/assets/r-pro-1-enter-zone-coordinates-manually.png) +![LD2450 zone coordinate fields in Home Assistant, each entered in millimeters](/assets/r-pro-1-enter-zone-coordinates-manually.png) !!! null "Helpful Hints to understand LD2450 zones better!" diff --git a/docs/products/rpro1/setup/zones-ha.md b/docs/products/rpro1/setup/zones-ha.md index 3d7655f57f..e8f171658f 100755 --- a/docs/products/rpro1/setup/zones-ha.md +++ b/docs/products/rpro1/setup/zones-ha.md @@ -32,17 +32,17 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir 4\. Head to a dashboard view and click the pencil icon to edit dashboard then click one of the large "+" signs, type in manual, and click on it. -![](/assets/ld2450-add-plotly-graph-gif.gif) +![Home Assistant dashboard in edit mode adding a Manual card with the Plotly graph YAML](/assets/ld2450-add-plotly-graph-gif.gif) 5\. Delete any text in the custom card then paste the YAML you copied above and click save when finished. You should now have a custom card that looks just like the card below! -![](/assets/r-pro-1-plotly-graph-image.png) +![Plotly card showing R PRO-1 target positions, the radar coverage cone, and three zones](/assets/r-pro-1-plotly-graph-image.png) 6\. Head to the [ESPHome Integrations page](http://homeassistant.local:8123/config/integrations/integration/esphome "Click me to go to the ESPHome integrations page") 7\. Click device as shown in the image below -![](/assets/select-r-pro-1-device.png) +![Red arrow on the 1 device link under Apollo R PRO-1 in the Home Assistant ESPHome integration](/assets/select-r-pro-1-device.png) 8\. Scroll down until you get to the Configuration section and you see the empty boxes for zones 1-3 for both X and Y coordinates. @@ -56,7 +56,7 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir 9\. Now we can input our Zone 1-3 X and Y values to make our zones. Using the visual card from above, we can walk, sit, or stand in the area where we want to create a detection or non-detection zone. Input values for X are -7000 mm to 7000 mm, and the Y values are 0 mm to 7000 mm. -![](/assets/ld2450-zone-input.png) +![Plotly Target Positions chart with arrows marking the X axis and Y axis around three zones](/assets/ld2450-zone-input.png) !!! tip "Helpful Hints to understand zones better!" @@ -72,23 +72,23 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir 10\. If you use the imperial system (Freedom Units) then you will need to do this step. Metric users can skip this. For the targets to show up correctly we first need to update the Target 1-3 X and Y measurements from inches (in) to millimeters (mm). Find Target 1-3 X and Y under the Sensors section and select them. You will want to update all 3 X and Y target values. -![](/assets/r-pro-1-card-change-units-from-inches.png) +![LD2450 Target-1 X and Y sensors in Home Assistant with their inch values highlighted](/assets/r-pro-1-card-change-units-from-inches.png) 11\. Select the Settings cog in the top right. -![](/assets/r-pro-1-card-change-units-settings.png) +![LD2450 Target-1 X entity dialog in Home Assistant with the Settings cog selected](/assets/r-pro-1-card-change-units-settings.png) 12\. Change the unit of measurement to mm and select Update. -![](/assets/r-pro-1-card-change-units-select-mm.png) +![Unit of measurement dropdown for LD2450 Target-1 X with mm being selected](/assets/r-pro-1-card-change-units-select-mm.png) 13\. Your X and Y Targets will now look like this. -![](/assets/r-pro-1-card-change-units-all-changed-to-mm.png) +![LD2450 Target 1 to 3 X and Y sensors in Home Assistant now showing mm, highlighted](/assets/r-pro-1-card-change-units-all-changed-to-mm.png) 14\. Now you should see targets on the card. -![](/assets/r-pro-1-card-working-targets.png) +![Plotly Target Positions card for the R PRO-1 showing a live target and three zones](/assets/r-pro-1-card-working-targets.png) 15\. Now we can make zones around the targets where you want to Detect presence or filter them out. @@ -100,7 +100,7 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir 1\. Navigate to the ESPHome integration by going to settings -> esphome integration -> click on "1 device" below the Apollo R PRO-1. -![](/assets/select-r-pro-1-device.png) +![Red arrow on the 1 device link under Apollo R PRO-1 in the Home Assistant ESPHome integration](/assets/select-r-pro-1-device.png) 2\. Scroll down until you see "LD2412 Mode" and change it from "Normal" to "Engineering". @@ -112,14 +112,14 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir 3\. Scroll down to the Diagnostic section and you will see "LD2412 g00 move energy" through "LD2412 g13 still energy" are showing percentages from 0-100%. -![](/assets/r-pro-1-ld2412-move-still-energy.png) +![LD2412 g00 to g03 move and still energy percentages in the Home Assistant Diagnostic section](/assets/r-pro-1-ld2412-move-still-energy.png) 4\. Scroll up to the Configuration section and identify the threshold sliders for g0-g13 for both moving and still energy. Moving the gate still and move threshold slider to the right increases the amount of energy needed to trigger the sensor. Do this if you want the gate to be less sensitive. -![](/assets/ld2412-less-sensitive.png) +![LD2412 g01 move and still threshold sliders moved right to make the gate less sensitive](/assets/ld2412-less-sensitive.png) Moving the gate still and move threshold slider to the left decreases the amount of energy needed to trigger the sensor. Do this if you want the gate to be more sensitive. -![](/assets/ld2412-more-sensitive.png) \ No newline at end of file +![LD2412 g01 move and still threshold sliders moved left to make the gate more sensitive](/assets/ld2412-more-sensitive.png) \ No newline at end of file diff --git a/docs/products/rpro1/setup/zones-hlk.md b/docs/products/rpro1/setup/zones-hlk.md index c5bcfb48e9..0f63a5613e 100755 --- a/docs/products/rpro1/setup/zones-hlk.md +++ b/docs/products/rpro1/setup/zones-hlk.md @@ -24,7 +24,7 @@ The ESPHome Integrations page then select your R PRO-1 and scroll down until you see LD2450 Bluetooth. -![](/assets/mtr-1-toggle-on-ld2450-bluetooth.png) +![LD2450 Bluetooth toggle switched on in the Home Assistant Configuration card, highlighted](/assets/mtr-1-toggle-on-ld2450-bluetooth.png) 2\. Open the HLKRadarTool App and select your device. @@ -32,11 +32,11 @@ The ESPHome Integrations page then select your R PRO-1 and scroll down until you see **LD2412 Bluetooth**. Toggle it on. -![](/assets/r-pro-1-toggle-on-ld2412-bluetooth.gif) +![LD2412 Bluetooth toggle being switched on in the R PRO-1 Configuration card in Home Assistant](/assets/r-pro-1-toggle-on-ld2412-bluetooth.gif) 2\. Open the HLKRadarTool app. Your R PRO-1 should appear in the device list. Tap it to connect. @@ -104,7 +104,7 @@ The same HLKRadarTool app is used for both sensors. The LD2412 connects over Bluetooth, which means you need to be within a few feet of the sensor for it to appear in the app. If it doesn't show up, move closer and pull down to refresh the list. -![](/assets/r-pro-1-ld2412-connect-and-eng-mode.gif) +![HLKRadarTool app connecting to the HLK-LD2412 and turning on the Engineering mode energy graphs](/assets/r-pro-1-ld2412-connect-and-eng-mode.gif) 3\. Once connected, enable **Engineering Mode** as shown above. This turns on the live energy graph, which shows you what the sensor is actually seeing at each distance gate in real time. @@ -116,7 +116,7 @@ The same HLKRadarTool app is used for both sensors. 4\. Leave the room empty and make sure nothing is moving, then tap **Auto** in the app. The sensor scans the environment for about 10 seconds and automatically sets thresholds to filter out static interference from electronics, HVAC, and other background sources. When it's done you'll see **Completed** and the app will return to showing the detection distance. This gives you a clean baseline before any manual tuning. -![](/assets/r-pro-1-ld2412-auto-noise-detection.gif) +![HLKRadarTool app running Auto noise detection on the LD2412, then showing Detecting](/assets/r-pro-1-ld2412-auto-noise-detection.gif) 5\. Tap **Settings** in the top right and use the **Detection Range** slider to set which gates the sensor monitors. You can set both a start and end gate — for example, Gate 3 to Gate 6 means the sensor only looks between 2.25m and 4.5m from the device. Limiting the range prevents the sensor from picking up movement through walls or in adjacent rooms. @@ -124,14 +124,14 @@ The same HLKRadarTool app is used for both sensors. Each gate is 0.75m. Gate 1 = 0.75m, Gate 2 = 1.5m, Gate 3 = 2.25m, Gate 4 = 3m, Gate 5 = 3.75m, Gate 6 = 4.5m, Gate 7 = 5.25m, Gate 8 = 6m. -![](/assets/r-pro-1-ld2412-detection-range.gif) +![HLKRadarTool Settings screen with the LD2412 Detection range slider set to a start and end gate](/assets/r-pro-1-ld2412-detection-range.gif) 6\. To fine-tune which distances trigger detection, head to the ESPHome Integrations page, select your R PRO-1, and use the gate sensitivity sliders on the device page. - **Raise** a gate's sensitivity to make it harder to trigger at that distance (useful for ignoring a fan, HVAC vent, or a window where cars pass). - **Lower** a gate's sensitivity to make it more sensitive at that distance (useful for reliably detecting someone sitting still in a chair). -![](/assets/r-pro-1-ld2412-gate-sliders-ha.gif) +![LD2412 gate threshold sliders being adjusted on the R PRO-1 device page in Home Assistant](/assets/r-pro-1-ld2412-gate-sliders-ha.gif) 7\. Tap **Settings** at the top of the app and set the **Unmanned Duration**. This controls how many seconds the sensor waits after it stops detecting before it reports "no one present." The default is 10 seconds — increase it if you're getting false "nobody home" readings in your space. In Home Assistant, this same setting is called **LD2412 Timeout**. diff --git a/docs/products/rpro1/troubleshooting/rpro1-boot-mode.md b/docs/products/rpro1/troubleshooting/rpro1-boot-mode.md index 7c170e56cd..47633aa3b8 100755 --- a/docs/products/rpro1/troubleshooting/rpro1-boot-mode.md +++ b/docs/products/rpro1/troubleshooting/rpro1-boot-mode.md @@ -12,15 +12,15 @@ description: Step by step guide for putting The R PRO-1 In Boot Mode. 1\. Unplug your R PRO-1 from power and remove the back. -![](/assets/rpro-1-add-co2-lift-lid-1.webp)![](/assets/rpro-1-add-co2-remove-lid.webp) +![Small tool prying up the R PRO-1 back lid at the seam below the USB-C port](/assets/rpro-1-add-co2-lift-lid-1.webp)![R PRO-1 back lid lifted off by hand, exposing the PCB inside the case](/assets/rpro-1-add-co2-remove-lid.webp) 2\. Gently remove the PCB from the case and flip it over. -![](/assets/r-pro-1-no-case-mmwave-facing-up.webp) +![R PRO-1 PCB out of its case, face up with the LD2450 and LD2412 mmWave sensors visible](/assets/r-pro-1-no-case-mmwave-facing-up.webp) 3\. Locate the boot button on the bottom right side of the PCB. -![](/assets/r-pro-1-boot-button.jpg) +![Tool pointing to the SW6 boot button at the bottom right of the R PRO-1 PCB](/assets/r-pro-1-boot-button.jpg) 4\. 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 R PRO-1 then let go of the button. @@ -30,19 +30,19 @@ description: Step by step guide for putting The R PRO-1 In Boot Mode. 1\. Unplug your R PRO-1 from power and remove the back. -![](/assets/rpro-1-add-co2-lift-lid-1.webp)![](/assets/rpro-1-add-co2-remove-lid.webp) +![Small tool prying up the R PRO-1 back lid at the seam below the USB-C port](/assets/rpro-1-add-co2-lift-lid-1.webp)![R PRO-1 back lid lifted off by hand, exposing the PCB inside the case](/assets/rpro-1-add-co2-remove-lid.webp) 2\. Gently remove the PCB from the case and flip it over. -![](/assets/r-pro-1-no-case-mmwave-facing-up.webp) +![R PRO-1 PCB out of its case, face up with the LD2450 and LD2412 mmWave sensors visible](/assets/r-pro-1-no-case-mmwave-facing-up.webp) 3\. Locate the boot button on the bottom right side of the PCB. -![](/assets/r-pro-1-boot-button.jpg) +![Tool pointing to the SW6 boot button at the bottom right of the R PRO-1 PCB](/assets/r-pro-1-boot-button.jpg) 4\. Locate the reset button on the bottom left side of the PCB. -![](/assets/r-pro-1-reset-button.jpg) +![Tool pointing to the RST1 reset button at the bottom left of the R PRO-1 PCB](/assets/r-pro-1-reset-button.jpg) 5\. 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. diff --git a/docs/products/rpro1/troubleshooting/rpro1-code.md b/docs/products/rpro1/troubleshooting/rpro1-code.md index 6921bd527f..25be9c4cd9 100755 --- a/docs/products/rpro1/troubleshooting/rpro1-code.md +++ b/docs/products/rpro1/troubleshooting/rpro1-code.md @@ -12,29 +12,29 @@ If your device has already been connected to Home Assistant please as shown here. 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 R PRO-1 then let go of the button. -![](/assets/r-pro-1-boot-button.jpg) +![Tool pointing to the SW6 boot button at the bottom right of the R PRO-1 PCB](/assets/r-pro-1-boot-button.jpg) 3\. Navigate to our installer page and click connect under Apollo R PRO-1 Installer. 3\. Click the big "Connect" button. -![](/assets/r-pro-1-reflash-connect-button.png) +![Apollo R PRO-1 Installer page with the Ethernet Firmware CONNECT button highlighted](/assets/r-pro-1-reflash-connect-button.png) 3\. Select the open com port then click Connect. -![](/assets/r-pro-1-reflash-connect-comp-port.png) +![Browser serial port prompt with the USB JTAG serial debug unit COM port and Connect button](/assets/r-pro-1-reflash-connect-comp-port.png) 4\. Click "Install R PRO-1". -![](/assets/r-pro-1-reflash-click-install.png) +![Installer Device Dashboard with the install R PRO-1 Ethernet firmware option highlighted](/assets/r-pro-1-reflash-click-install.png) 5\. Click "INSTALL". -![](/assets/r-pro-1-reflash-click-install-to-install.png) +![Install confirmation dialog for the R PRO-1 Ethernet firmware with the INSTALL button](/assets/r-pro-1-reflash-click-install-to-install.png) 6\. Once you see "Installation complete!" you are finished. Click Next then close out of the browser window. -![](/assets/r-pro-1-reflash-installation-complete.png) +![Installer showing Installation complete with the NEXT button highlighted](/assets/r-pro-1-reflash-installation-complete.png) !!! warning "Power cycle your device before doing anything else!" diff --git a/docs/products/rpro1/troubleshooting/rpro1-reset-wi-fi-credentials.md b/docs/products/rpro1/troubleshooting/rpro1-reset-wi-fi-credentials.md index 2ca448b35b..ac8bc78031 100755 --- a/docs/products/rpro1/troubleshooting/rpro1-reset-wi-fi-credentials.md +++ b/docs/products/rpro1/troubleshooting/rpro1-reset-wi-fi-credentials.md @@ -8,7 +8,7 @@ description: Step by step guide for resetting the Wi-Fi Credentials on your R PR 2\. Long press the Boot button (the button on the right) for 10 seconds. -![](/assets/r-pro-1-boot-button.jpg) +![Tool pointing to the SW6 boot button at the bottom right of the R PRO-1 PCB](/assets/r-pro-1-boot-button.jpg) 3\. The Wi-Fi credentials should be reset and it will broadcast its hotspot again. diff --git a/docs/products/rpro1/troubleshooting/rpro1-teardown.md b/docs/products/rpro1/troubleshooting/rpro1-teardown.md index 245b726f68..3a91fa6c78 100755 --- a/docs/products/rpro1/troubleshooting/rpro1-teardown.md +++ b/docs/products/rpro1/troubleshooting/rpro1-teardown.md @@ -8,34 +8,34 @@ description: Step by step guide for tearing down your R PRO-1 to replace parts, 1\. Unplug your R PRO-1 from power and remove the back. -![](/assets/rpro-1-add-co2-lift-lid-1.webp)![](/assets/rpro-1-add-co2-remove-lid.webp) +![Small tool prying up the R PRO-1 back lid at the seam below the USB-C port](/assets/rpro-1-add-co2-lift-lid-1.webp)![R PRO-1 back lid lifted off by hand, exposing the PCB inside the case](/assets/rpro-1-add-co2-remove-lid.webp) 2\. Gently remove the PCB from the case and flip it over. -![](/assets/r-pro-1-no-case-mmwave-facing-up.webp) +![R PRO-1 PCB out of its case, face up with the LD2450 and LD2412 mmWave sensors visible](/assets/r-pro-1-no-case-mmwave-facing-up.webp) 3\. Gently remove the LD2412 as shown below. -![](/assets/r-pro-1-teardown-remove-ld2412.jpg) +![Fingers lifting the LD2412 mmWave module off its pin headers on the R PRO-1 PCB](/assets/r-pro-1-teardown-remove-ld2412.jpg) 4\. Gently remove the LD2450 as shown below. -![](/assets/r-pro-1-teardown-remove-ld2450.jpg) +![Fingers pulling the LD2450 mmWave module off its pin header on the R PRO-1 PCB](/assets/r-pro-1-teardown-remove-ld2450.jpg) ###### Reassembly 1\. Place the LD2450 on the 8 pin header. -![](/assets/r-pro-1-reassembly-install-ld2450.jpg) +![LD2450 module being pressed onto its pin header on the R PRO-1 PCB](/assets/r-pro-1-reassembly-install-ld2450.jpg) 2\. Place the LD2412 on the 4 and 3 pin headers (only fits one way). -![](/assets/r-pro-1-reassembly-install-ld2412.jpg) +![LD2412 module being lined up with its pin headers on the R PRO-1 PCB](/assets/r-pro-1-reassembly-install-ld2412.jpg) 3\. Place back into the case with the ethernet module facing up and the usb-c port facing you. -![](/assets/r-pro-1-lid-removed.jpg) +![R PRO-1 PCB back in its case with the Ethernet module facing up and the USB-C port in front](/assets/r-pro-1-lid-removed.jpg) 4\. Snap the lid back into place! -![](/assets/r-pro-1-lid-press-down.jpg) \ No newline at end of file +![Fingers pressing the lid onto the R PRO-1 case around the Ethernet and USB-C ports](/assets/r-pro-1-lid-press-down.jpg) \ No newline at end of file diff --git a/docs/products/temp1/addons/food-probe.md b/docs/products/temp1/addons/food-probe.md index 2a5b74e144..41964bdd64 100755 --- a/docs/products/temp1/addons/food-probe.md +++ b/docs/products/temp1/addons/food-probe.md @@ -6,13 +6,13 @@ description: Step by step guide for installing and using the optional Food Probe The TEMP-1 comes with an optional food probe which can be used to monitor food temperatures when baking, grilling, etc. It includes a heat-resistant cable but the TEMP-1 itself needs to stay in a cool environment. -![](/assets/temp1b-magnetic-mount-proper-mounting-explained-resized.png) +![Correct TEMP-1 mounting on the grill side shelf versus incorrect mounting on the hot grill lid](/assets/temp1b-magnetic-mount-proper-mounting-explained-resized.png) 1\. To use your food probe simply take it out of the package and insert it into the 3.5mm port on your TEMP-1. -![](/assets/temp-1-food-probe-insert-1.jpg) +![Food probe 3.5mm plug being inserted into the port on the TEMP-1](/assets/temp-1-food-probe-insert-1.jpg) -![](/assets/temp-1-food-probe-fully-inserted.jpg) +![Food probe plug fully inserted into the TEMP-1 3.5mm port](/assets/temp-1-food-probe-fully-inserted.jpg) 2\. Once inserted, proceed to step 3 unless you have a battery in it @@ -22,11 +22,11 @@ The TEMP-1 comes with an optional food probe which can be used to monitor food t   -![](/assets/temp-1-food-probe-pic-1.jpg) +![TEMP-1 with the food probe connected, showing the braided cable and steel probe tip](/assets/temp-1-food-probe-pic-1.jpg) 3\. Go to the device page of your TEMP-1 in Home Assistant and choose probe "Food". -![](/assets/temp1b-food-probe-pic-1-1.png) +![TEMP-1 Controls card in Home Assistant with Food chosen in the Select Probe dropdown](/assets/temp1b-food-probe-pic-1-1.png) !!! danger "Do not leave your sensor outside or let it get wet!" diff --git a/docs/products/temp1/addons/magnetic-mount.md b/docs/products/temp1/addons/magnetic-mount.md index 7a8eed8701..495caee00c 100755 --- a/docs/products/temp1/addons/magnetic-mount.md +++ b/docs/products/temp1/addons/magnetic-mount.md @@ -6,27 +6,27 @@ description: Step by step guide for installing and using the optional Magnetic M The TEMP-1 comes with an optional magnetic mount which can be used to secure the TEMP-1 to your fridge or grill as shown below. -![](/assets/temp1b-magnetic-mount-proper-mounting-explained-resized.png) +![Correct TEMP-1 mounting on the grill side shelf versus incorrect mounting on the hot grill lid](/assets/temp1b-magnetic-mount-proper-mounting-explained-resized.png) 1\. To use your magnetic mount place it with the magnet facing upwards as shown: -![](/assets/temp1b-magnetic-mount-pic-1.jpg) +![Empty TEMP-1 magnetic mount frame lying with the magnet facing up](/assets/temp1b-magnetic-mount-pic-1.jpg) 2\. Align the lid with the hole in the top right and place your TEMP-1 inside the magnetic mount and gently press down. -![](/assets/temp1-magnetic-mount-installed-pic-1.jpg) +![TEMP-1 seated in the magnetic mount, seen from above with the magnet strip visible](/assets/temp1-magnetic-mount-installed-pic-1.jpg) -![](/assets/temp1-magnetic-mount-installed-pic-2.jpg) +![Front view of the TEMP-1 seated in the magnetic mount above the magnet strip](/assets/temp1-magnetic-mount-installed-pic-2.jpg) 3\. It will sit flush as shown in the image below. -![](/assets/temp1-magnetic-mount-installed-pic-3.jpg) +![Side view of the TEMP-1 sitting flush in the magnetic mount](/assets/temp1-magnetic-mount-installed-pic-3.jpg) 4\. Affix your TEMP-1 to the outside of fridge or a safe cool place on the grill. -![](/assets/temp1-magnetic-mount-safe-fridge-mounting.jpg) +![TEMP-1 in its magnetic mount attached to the outside of a black fridge](/assets/temp1-magnetic-mount-safe-fridge-mounting.jpg) -![](/assets/temp1b-magnetic-mount-safe-grill-mounting.jpg) +![TEMP-1 magnetic mount on the grill side shelf with the probe cable running into the lid](/assets/temp1b-magnetic-mount-safe-grill-mounting.jpg) !!! danger "Do not leave your sensor outside or let it get wet!" diff --git a/docs/products/temp1/addons/multiple-probes.md b/docs/products/temp1/addons/multiple-probes.md index 9584f894db..d5af079fea 100755 --- a/docs/products/temp1/addons/multiple-probes.md +++ b/docs/products/temp1/addons/multiple-probes.md @@ -12,11 +12,11 @@ The TEMP-1 comes with an optional [3.5mm Multi-Probe Splitter](https://apolloaut 1\. To use your TEMP-1 Multi-Probe Splitter gently plug it into the 3.5mm port on your device. -![](/assets/temp-1-multi-probe-insert-multi-probe-splitter-gif.webp) +![Multi-Probe Splitter 3.5mm plug being inserted into the TEMP-1 probe port](/assets/temp-1-multi-probe-insert-multi-probe-splitter-gif.webp) 2\. Plug in your long or short temp probes into the Multi-Probe Splitter. -![](/assets/temp-1-multi-probe-insert-multiple-probes-gif.webp) +![Temp probe plugs being connected to the Multi-Probe Splitter sockets](/assets/temp-1-multi-probe-insert-multiple-probes-gif.webp) !!! success "Power on your TEMP-1 after plugging in all of your probes!" @@ -24,19 +24,19 @@ The TEMP-1 comes with an optional [3.5mm Multi-Probe Splitter](https://apolloaut 3\. Go to the device page of your TEMP-1 in Home Assistant and confirm the Temperature Probe is selected from the dropdown. -![](/assets/temp-1-multi-probe-select-temp-dropdown-gif.gif) +![TEMP-1 Controls card in Home Assistant with Temperature chosen in the Select Probe dropdown](/assets/temp-1-multi-probe-select-temp-dropdown-gif.gif) 4\. Enable the disabled 3rd and 4th temp probe entities if you have more than 2 probes! -![](/assets/temp-1-multi-probe-enable-disabled-probe-entities-gif.gif) +![TEMP-1 device page in Home Assistant enabling the disabled Temperature Probe 3 and 4 entities](/assets/temp-1-multi-probe-enable-disabled-probe-entities-gif.gif) 5\. Once completed you will see all four probes updating the temperature! -![](/assets/temp-1-multi-probe-see-all-four-probes-once-enabled.png) +![TEMP-1 sensors in Home Assistant showing readings from all four temperature probes](/assets/temp-1-multi-probe-see-all-four-probes-once-enabled.png) 6\. To rename the probes you can edit each probe and choose a unique name such as "Fridge Probe" and "Freezer Probe" as shown below! -![](/assets/temp-1-multi-probe-rename-entities.gif) +![Renaming TEMP-1 probe entities to Fridge Probe and Freezer Probe in Home Assistant](/assets/temp-1-multi-probe-rename-entities.gif) !!! danger "Do not leave your sensor outside or let it get wet!" diff --git a/docs/products/temp1/addons/temp-probe.md b/docs/products/temp1/addons/temp-probe.md index 7ec0bae253..86fe512fce 100755 --- a/docs/products/temp1/addons/temp-probe.md +++ b/docs/products/temp1/addons/temp-probe.md @@ -8,17 +8,17 @@ The TEMP-1 comes with an optional temp probe which can be used to monitor a frid 1\. To use your temp probe simply take it out of the package and insert it into the 3.5mm port on your TEMP-1. -![](/assets/temp1-temp-probe-insert-1.jpg) +![Temp probe 3.5mm plug being inserted into the port on the TEMP-1](/assets/temp1-temp-probe-insert-1.jpg) -![](/assets/temp1-probe-fully-inserted.jpg) +![Temp probe plug fully inserted into the TEMP-1 3.5mm port](/assets/temp1-probe-fully-inserted.jpg) 2\. Once inserted, proceed to step 3. -![](/assets/temp1-temp-probe-pic-1.jpg) +![TEMP-1 with the long temp probe connected and its cable coiled beside it](/assets/temp1-temp-probe-pic-1.jpg) 3\. Go to the device page of your TEMP-1 in Home Assistant and choose the Temperature Probe. -![](/assets/temp-1-select-temp-probe-example.png) +![Select Probe dropdown in Home Assistant with Temperature chosen for the TEMP-1](/assets/temp-1-select-temp-probe-example.png) !!! danger "Do not leave your sensor outside or let it get wet!" @@ -26,15 +26,15 @@ The TEMP-1 comes with an optional temp probe which can be used to monitor a frid **Example images of the long temperature probe in a mini freezer:** -![](/assets/temp1b-temp-probe-freezer-pic-1.jpg) +![Long temp probe cable routed into a mini freezer and hanging from the wire shelf](/assets/temp1b-temp-probe-freezer-pic-1.jpg) -![](/assets/temp1b-temp-probe-freezer-pic-2.jpg) +![Temp probe cable running out past the mini freezer door seal to the outside](/assets/temp1b-temp-probe-freezer-pic-2.jpg) ## Probe Pinout The 1.5m and 20cm DS18B20 temp probes use a standard 3.5mm TRS plug. Wire yours the same way if you're building your own probe or repairing a cut cable. -![](/assets/temp-1-temp-probe-pinout.png) +![Temp probe 3.5mm TRS plug labeled GND on the sleeve, Data on the ring, and 3V on the tip](/assets/temp-1-temp-probe-pinout.png) | Contact | Signal | | --- | --- | diff --git a/docs/products/temp1/examples/hot-water-recirculation.md b/docs/products/temp1/examples/hot-water-recirculation.md index 57c23ea354..9d3630c350 100644 --- a/docs/products/temp1/examples/hot-water-recirculation.md +++ b/docs/products/temp1/examples/hot-water-recirculation.md @@ -116,7 +116,7 @@ Donovan's whole system is one blueprint. Import it, pick your entities, set your 2\. Click **Preview**, then **Import blueprint**. -![](/assets/btn-1-blueprint-auto-import.gif) +![Home Assistant Import a blueprint dialog previewing, then importing, an example BTN-1 blueprint](/assets/btn-1-blueprint-auto-import.gif) 3\. Click **Apollo Automation Hot Water Recirculation (TEMP-1)**, create an automation from it, and fill in the inputs below. diff --git a/docs/products/temp1/examples/temp1-alert-example.md b/docs/products/temp1/examples/temp1-alert-example.md index fd8a60cbc0..6b9768a84a 100755 --- a/docs/products/temp1/examples/temp1-alert-example.md +++ b/docs/products/temp1/examples/temp1-alert-example.md @@ -12,12 +12,12 @@ This will guide you through how to setup the built in alarm using the temperatur 2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30F so I would want to go slightly above that range. However, in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. my minimums are around -20F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe with arrows at freezer highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2C and a min probe temp of -30C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![Home Assistant settings with Max Probe Temp set to 2.0 °C and Min Probe Temp set to -30.0 °C](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1 will play an audible alert with it's buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off -![](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file +![Home Assistant Controls card with the Alarm Outside Temp Range toggle switched on](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file diff --git a/docs/products/temp1/examples/temp1-automation-examples.md b/docs/products/temp1/examples/temp1-automation-examples.md index dbb0f7bd5f..1a6a448fb9 100755 --- a/docs/products/temp1/examples/temp1-automation-examples.md +++ b/docs/products/temp1/examples/temp1-automation-examples.md @@ -12,11 +12,11 @@ This will guide you through how to setup an automation in Home Assistant using t 2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. my minimums are around -20°F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe with arrows at freezer highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2°C and a min probe temp of -30°C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![Home Assistant settings with Max Probe Temp set to 2.0 °C and Min Probe Temp set to -30.0 °C](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. The automation is now ready to be created - @@ -24,11 +24,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you found in step 2 above. Advanced users skip to step 10. -![](/assets/temp-1-temp-probe-ex-automation-pic-3.png) +![Home Assistant numeric state trigger on TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png) 7\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action search for iphone with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -36,11 +36,11 @@ This will guide you through how to setup an automation in Home Assistant using t 8\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1 reached its max temperature and your freezer might be having issues." and "Check the freezer!". -![](/assets/temp-1-temp-probe-ex-automation-pic-5.png) +![Home Assistant notification action with the message and Check the freezer! title fields highlighted](/assets/temp-1-temp-probe-ex-automation-pic-5.png) 9\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-temp-probe-ex-automation-pic-6.png) +![Home Assistant save dialog for Freezer Over Max Temp Automation with name, description, and category filled in](/assets/temp-1-temp-probe-ex-automation-pic-6.png) --- @@ -72,7 +72,7 @@ This will guide you through how to setup an automation in Home Assistant using t 1\. Set your Max Probe Temp to 73.9°C. The offsets MUST be in Celsius even if you are using F in the automation below. -![](/assets/temp-1-food-probe-ex-automation-pic-1.png) +![Home Assistant setting with Max Probe Temp set to 73.9 °C highlighted](/assets/temp-1-food-probe-ex-automation-pic-1.png) 2\. Place the food probe inside your food once it's on the grill. Make sure your TEMP-1 is in a cool dry place - only the food probe and the wire can withstand temperatures on a grill, in the oven, etc. @@ -80,11 +80,11 @@ This will guide you through how to setup an automation in Home Assistant using t 4\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. -![](/assets/temp-1-food-probe-ex-automation-pic-3.png) +![Home Assistant numeric state trigger with the TEMP-1 Max Probe Temp entity and Above 165 fields highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png) 5\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action search for iphone with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -92,11 +92,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1 reached its max temperature and your food is ready." and "Check the food!". -![](/assets/temp-1-food-probe-ex-automation-pic-5.png) +![Home Assistant notification action with the message and Check the food! title fields highlighted](/assets/temp-1-food-probe-ex-automation-pic-5.png) 7\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-food-probe-ex-automation-pic-6.png) +![Home Assistant save dialog for Food over Max Temp Automation with name, description, category, and Save highlighted](/assets/temp-1-food-probe-ex-automation-pic-6.png) --- @@ -127,122 +127,122 @@ This will guide you through adding a button to your dashboard called "Chicken Mo 1\. Create a new toggle helper called "Chicken Monitor". Please click here for step by step directions on creating a toggle helper. -![](/assets/temp-1-cook-chicken-example-pic-1.png) +![Home Assistant Create Toggle dialog for a Chicken Monitor helper with the Create button highlighted](/assets/temp-1-cook-chicken-example-pic-1.png) 2\. Edit your dashboard, add a button card, select Chicken Monitor, and then save. -![](/assets/temp-1-cook-chicken-example-pic-3.png)![](/assets/temp-1-cook-chicken-example-pic-2.png) +![Home Assistant Add to dashboard dialog with button typed in the card search](/assets/temp-1-cook-chicken-example-pic-3.png)![Home Assistant Button card configuration with the Chicken Monitor entity and Save button highlighted](/assets/temp-1-cook-chicken-example-pic-2.png) 3\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left then "create new automation". Click here to go straight there! 4\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "On". Advanced users skip to step 25 for the YAML. -![](/assets/temp-1-cook-chicken-example-pic-4.png) +![Home Assistant state trigger for Chicken Monitor with the To field set to On](/assets/temp-1-cook-chicken-example-pic-4.png) 5\. Create a Trigger ID for this called "Chicken Monitor On". -![](/assets/temp-1-cook-chicken-example-pic-5.png)![](/assets/temp-1-cook-chicken-example-pic-6-1.png) +![Home Assistant trigger options menu open with Edit ID selected](/assets/temp-1-cook-chicken-example-pic-5.png)![Home Assistant Chicken Monitor trigger with Trigger ID set to Chicken Monitor On](/assets/temp-1-cook-chicken-example-pic-6-1.png) 6\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "Off". Create a Trigger ID for this called "Chicken Monitor Off". -![](/assets/temp-1-cook-chicken-example-pic-21.png) +![Home Assistant state trigger for Chicken Monitor set to Off with Trigger ID Chicken Monitor Off highlighted](/assets/temp-1-cook-chicken-example-pic-21.png) 7\. Click Add Trigger then Entity then Numeric state and search for your temp-1 food probe entity such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 160°F(71.1C) because the Chicken will rest and reach 165°F once removed from the oven/grill. -![](/assets/temp-1-cook-chicken-example-pic-7.png) +![Home Assistant numeric state trigger on TEMP-1 Food Probe with the Above field set to 160](/assets/temp-1-cook-chicken-example-pic-7.png) 8\. Create a Trigger ID for this called "Temp Reached". -![](/assets/temp-1-cook-chicken-example-pic-8.png) +![Home Assistant TEMP-1 Food Probe trigger with Trigger ID set to Temp Reached highlighted](/assets/temp-1-cook-chicken-example-pic-8.png) 9\. Click Add Action and search "choose" then select it. -![](/assets/temp-1-cook-chicken-example-pic-12.png) +![Home Assistant Add action dialog with choose searched and the Choose action listed](/assets/temp-1-cook-chicken-example-pic-12.png) 10\. Under option 1 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Home Assistant Add condition dialog with trigger id searched and Triggered by listed](/assets/temp-1-cook-chicken-example-pic-13.png) 11\. Check off the option "Button Pressed" that we created in step 5 above. -![](/assets/temp-1-cook-chicken-example-pic-14.png) +![Home Assistant Choose action Option 1 with the Button Pressed trigger checked and highlighted](/assets/temp-1-cook-chicken-example-pic-14.png) 12\. While still under Option 1 in the choose action: Click Add Action and search "light" then select Light: Turn on. -![](/assets/temp-1-cook-chicken-example-pic-9.png) +![Home Assistant Add action dialog with light searched and Light: Turn on highlighted](/assets/temp-1-cook-chicken-example-pic-9.png) 13\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-10.png) +![Home Assistant Choose entity search for TEMP-1 with the cursor on the Apollo TEMP-1 RGB Light entity](/assets/temp-1-cook-chicken-example-pic-10.png) 14\. Click "Advanced Options" and then click the check box for Color name then select a color from the dropdown such as Green. -![](/assets/temp-1-cook-chicken-example-pic-11.png) +![Home Assistant light action Advanced options with Color name checked and Green picked from the list](/assets/temp-1-cook-chicken-example-pic-11.png) 15\. While still under Option 1 in the choose action: Click Add Action and search "mobile" and then select your phone in the list. -![](/assets/temp-1-cook-chicken-example-pic-15.png) +![Home Assistant Add action dialog with mobile searched and the iPhone notification action highlighted](/assets/temp-1-cook-chicken-example-pic-15.png) 16\. Write in a custom title and or message- the message is required but the title is not. -![](/assets/temp-1-cook-chicken-example-pic-16.png) +![Home Assistant notification action with the title Chicken Monitoring Started and a custom message](/assets/temp-1-cook-chicken-example-pic-16.png) 17\. This is how option 1 will look when you are done with this part: -![](/assets/temp-1-cook-chicken-example-pic-17-1.png) +![Home Assistant Option 1 triggered by Chicken Monitor On with light turn on and notification actions](/assets/temp-1-cook-chicken-example-pic-17-1.png) 18\. Click "Add Option" at the bottom then under option 2 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Home Assistant Add condition dialog with trigger id searched and Triggered by listed](/assets/temp-1-cook-chicken-example-pic-13.png) 19\. Check off the option "Temp Reached" that we created in step 7 above. -![](/assets/temp-1-cook-chicken-example-pic-18-1.png) +![Home Assistant Option 2 Triggered by condition with only Temp Reached checked](/assets/temp-1-cook-chicken-example-pic-18-1.png) 20\. While still under Option 2 in the choose action: Click Add Action and search "repeat" then select "Until" in the dropdown. -![](/assets/temp-1-cook-chicken-example-pic-22.png) +![Home Assistant Add action dialog with repeat searched and the Repeat action listed](/assets/temp-1-cook-chicken-example-pic-22.png) 21\. Under Until Conditions, select "Add condition" then search "state". -![](/assets/temp-1-cook-chicken-example-pic-25.png) +![Home Assistant Add condition dialog with state searched and the State condition listed](/assets/temp-1-cook-chicken-example-pic-25.png) 22\. Type in Chicken Monitor and select it, then click "Off" in the dropdown for the state of the sensor. -![](/assets/temp-1-cook-chicken-example-pic-26.png) +![Home Assistant repeat until condition with Chicken Monitor entity and Off state highlighted](/assets/temp-1-cook-chicken-example-pic-26.png) 23\. Click "Add Action" under the "until" condition we created above. Be very careful to select the correct "Add Action" button as shown below. -![](/assets/temp-1-cook-chicken-example-pic-27.png) +![Home Assistant repeat until block with its inner Add Action button highlighted](/assets/temp-1-cook-chicken-example-pic-27.png) 24\. Search "light toggle" in the search bar shown then select "Choose entity" and select your the rgb led for your device -![](/assets/temp-1-cook-chicken-example-pic-28.png) +![Home Assistant Add action dialog with light toggle searched and Light: Toggle listed](/assets/temp-1-cook-chicken-example-pic-28.png) 25\. Head down to Add Action under Option 2 and search "mobile" then select your phone as you did above in step 15. Give it a message and a title as shown below. -![](/assets/temp-1-cook-chicken-example-pic-29.png) +![Home Assistant Option 2 notification action titled Time to check the Chicken! with its message](/assets/temp-1-cook-chicken-example-pic-29.png) 26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already setup. -![](/assets/temp-1-cook-chicken-example-pic-30.png)![](/assets/temp-1-cook-chicken-example-pic-31.png) +![Home Assistant Add action dialog with tts searched and the TTS Speak action listed](/assets/temp-1-cook-chicken-example-pic-30.png)![Home Assistant TTS Speak action on piper targeting Homepods with The Chicken is almost ready! message](/assets/temp-1-cook-chicken-example-pic-31.png) 27\. Click "Add Option" (this is now Option 3). We will choose add condition then search "triggered by" and then choose the "Chicken Monitor Off" Trigger ID that we created in step 6. 28\. While still under Option 3 in the choose action: Click Add Action and search "light" then select Light: Turn off. -![](/assets/temp-1-cook-chicken-example-pic-19.png) +![Home Assistant Add action dialog with light.turn searched and Light: Turn off selected](/assets/temp-1-cook-chicken-example-pic-19.png) 29\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-20.png) +![Home Assistant Light Turn off action targeting the Apollo TEMP-1 RGB Light](/assets/temp-1-cook-chicken-example-pic-20.png) 30\. Choose "Add Action" and search mobile like we did above and select your mobile phone. Give it an optional title and message as shown below. -![](/assets/temp-1-cook-chicken-example-pic-33.png) +![Home Assistant notification action titled Chicken Monitoring Stopped! with its message](/assets/temp-1-cook-chicken-example-pic-33.png) 31\. Click save in the bottom right then give it a name and save -![](/assets/temp-1-cook-chicken-example-pic-34.png) +![Home Assistant save dialog for TEMP-1 Chicken Automation in the Food category with Save clicked](/assets/temp-1-cook-chicken-example-pic-34.png) 32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to discord user RalphP for this example! \ No newline at end of file diff --git a/docs/products/temp1/setup/prevent-sleep.md b/docs/products/temp1/setup/prevent-sleep.md index 4cf9fac91d..d759dca993 100755 --- a/docs/products/temp1/setup/prevent-sleep.md +++ b/docs/products/temp1/setup/prevent-sleep.md @@ -14,11 +14,11 @@ description: Guide for setting up and using the prevent sleep toggle with the TE 2\. Click on the name "1 device" below your Apollo device's name. -![](/assets/prevent-sleep-pic-3.png) +![Home Assistant ESPHome integration entry for the Apollo TEMP-1B with the 1 device link highlighted](/assets/prevent-sleep-pic-3.png) 3\. Scroll down until you see "Prevent Sleep" and "Sleep Duration". -![](/assets/prevent-sleep-pic-2.png) +![Home Assistant device controls with the Prevent Sleep toggle and Sleep Duration box highlighted](/assets/prevent-sleep-pic-2.png) 4\. Type in the amount of minutes you want your sensor to sleep in the "Sleep Duration" box. Defaults to 8 minutes. diff --git a/docs/products/temp1/setup/temp1-change-temp-probe-update-interval.md b/docs/products/temp1/setup/temp1-change-temp-probe-update-interval.md index bfd2203d18..9ac30ecb0f 100644 --- a/docs/products/temp1/setup/temp1-change-temp-probe-update-interval.md +++ b/docs/products/temp1/setup/temp1-change-temp-probe-update-interval.md @@ -12,7 +12,7 @@ By default the TEMP-1 reports its **Temperature Probe** every 60 seconds. You ca 1\. Select the ESPHome Builder in the sidebar then click "EDIT" on your TEMP-1. -![](/assets/temp-1-click-edit-esphome-device-builder.png) +![ESPHome Device Builder card for the Apollo TEMP-1 with the Edit button clicked](/assets/temp-1-click-edit-esphome-device-builder.png) 2\. Paste this YAML below your device's existing config. The `!extend` keyword edits the probe that is already defined in the firmware, so you only need the lines you want to change. @@ -27,13 +27,13 @@ sensor: update_interval: 10s ``` -![](/assets/temp-1-change-probe-update-interval-yaml-edit.gif) +![ESPHome Device Builder editing the TEMP-1 YAML, adding the temp probe extend block, then starting the install](/assets/temp-1-change-probe-update-interval-yaml-edit.gif) 3\. In the top right click "SAVE" and then "INSTALL". When the install options appear, choose "On the network". 4\. Once you see the logs showing the new update interval of 10 seconds the flash has succeeded and you can click "STOP" to exit. -![](/assets/temp-1-new-update-interval-shown-in-logs.gif) +![ESPHome Device Builder logs for the TEMP-1 showing the Temperature Probe reporting every 10 seconds](/assets/temp-1-new-update-interval-shown-in-logs.gif) Your Temperature Probe will now report at the new interval. diff --git a/docs/products/temp1/troubleshooting/temp1-boot-mode.md b/docs/products/temp1/troubleshooting/temp1-boot-mode.md index 57cebc0484..b34bf40ebb 100755 --- a/docs/products/temp1/troubleshooting/temp1-boot-mode.md +++ b/docs/products/temp1/troubleshooting/temp1-boot-mode.md @@ -12,13 +12,13 @@ description: Step by step guide for putting The TEMP-1 In Boot Mode. 1\. Position the TEMP-1 so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. -![](/assets/temp-1-boot-button-side-view.jpg) +![Side of the TEMP-1 case with a tool pointing into the small opening for the boot button](/assets/temp-1-boot-button-side-view.jpg) If you prefer, please remove the lid by gently prying up on the small slit by the top of the case. -![](/assets/temp-1-pry-open.jpg) +![Metal tool prying the lid off the TEMP-1 case at the slit near the top](/assets/temp-1-pry-open.jpg) -![](/assets/temp-1b-boot-button-lid-off.jpg) +![TEMP-1 with the lid removed and a tool pointing at the BOOT button next to the buzzer](/assets/temp-1b-boot-button-lid-off.jpg) 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 TEMP-1 then let go of the button. @@ -32,6 +32,6 @@ If you prefer, please remove the lid by gently prying up on the small slit by th 3\. Hold down the boot button (shown above), then press and release the reset button (shown below) while keeping the boot button pressed. Finally, release the boot button. -![](/assets/temp-1-reset-button-lid-off.jpg) +![TEMP-1 with the lid removed and a tool pointing at the RST reset button](/assets/temp-1-reset-button-lid-off.jpg) 4\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/products/temp1/troubleshooting/temp1-code/). \ No newline at end of file diff --git a/docs/products/temp1/troubleshooting/temp1-code.md b/docs/products/temp1/troubleshooting/temp1-code.md index 23d0998876..f493d06e72 100755 --- a/docs/products/temp1/troubleshooting/temp1-code.md +++ b/docs/products/temp1/troubleshooting/temp1-code.md @@ -20,23 +20,23 @@ If your device has already been connected to Home Assistant please in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. my minimums are around -20F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe with arrows at freezer highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2C and a min probe temp of -30C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![Home Assistant settings with Max Probe Temp set to 2.0 °C and Min Probe Temp set to -30.0 °C](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1B will play an audible alert with it's buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off -![](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file +![Home Assistant Controls card with the Alarm Outside Temp Range toggle switched on](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file diff --git a/docs/products/temp1b/examples/temp1b-automation-examples.md b/docs/products/temp1b/examples/temp1b-automation-examples.md index 7f4d6b0bad..5448213591 100755 --- a/docs/products/temp1b/examples/temp1b-automation-examples.md +++ b/docs/products/temp1b/examples/temp1b-automation-examples.md @@ -12,11 +12,11 @@ This will guide you through how to setup an automation in Home Assistant using t 2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. my minimums are around -20°F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe with arrows at freezer highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2°C and a min probe temp of -30°C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![Home Assistant settings with Max Probe Temp set to 2.0 °C and Min Probe Temp set to -30.0 °C](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. The automation is now ready to be created - @@ -24,11 +24,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1B device such as "temp-1b max probe temp" then in the box labeled "Above" type in the max probe temp number you found in step 2 above. Advanced users skip to step 10. -![](/assets/temp-1-temp-probe-ex-automation-pic-3.png) +![Home Assistant numeric state trigger on TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png) 7\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action search for iphone with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -36,11 +36,11 @@ This will guide you through how to setup an automation in Home Assistant using t 8\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1B reached its max temperature and your freezer might be having issues." and "Check the freezer!". -![](/assets/temp-1-temp-probe-ex-automation-pic-5.png) +![Home Assistant notification action with the message and Check the freezer! title fields highlighted](/assets/temp-1-temp-probe-ex-automation-pic-5.png) 9\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-temp-probe-ex-automation-pic-6.png) +![Home Assistant save dialog for Freezer Over Max Temp Automation with name, description, and category filled in](/assets/temp-1-temp-probe-ex-automation-pic-6.png) --- @@ -72,7 +72,7 @@ This will guide you through how to setup an automation in Home Assistant using t 1\. Set your Max Probe Temp to 73.9°C. The offsets MUST be in Celsius even if you are using F in the automation below. -![](/assets/temp-1-food-probe-ex-automation-pic-1.png) +![Home Assistant setting with Max Probe Temp set to 73.9 °C highlighted](/assets/temp-1-food-probe-ex-automation-pic-1.png) 2\. Place the food probe inside your food once it's on the grill. Make sure your TEMP-1 is in a cool dry place - only the food probe and the wire can withstand temperatures on a grill, in the oven, etc. @@ -80,11 +80,11 @@ This will guide you through how to setup an automation in Home Assistant using t 4\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1b device such as "temp-1b max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. -![](/assets/temp-1-food-probe-ex-automation-pic-3.png) +![Home Assistant numeric state trigger with the TEMP-1 Max Probe Temp entity and Above 165 fields highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png) 5\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action search for iphone with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -92,11 +92,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1B reached its max temperature and your food is ready." and "Check the food!". -![](/assets/temp-1-food-probe-ex-automation-pic-5.png) +![Home Assistant notification action with the message and Check the food! title fields highlighted](/assets/temp-1-food-probe-ex-automation-pic-5.png) 7\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-food-probe-ex-automation-pic-6.png) +![Home Assistant save dialog for Food over Max Temp Automation with name, description, category, and Save highlighted](/assets/temp-1-food-probe-ex-automation-pic-6.png) --- @@ -127,122 +127,122 @@ This will guide you through adding a button to your dashboard called "Chicken Mo 1\. Create a new toggle helper called "Chicken Monitor". Please click here for step by step directions on creating a toggle helper. -![](/assets/temp-1-cook-chicken-example-pic-1.png) +![Home Assistant Create Toggle dialog for a Chicken Monitor helper with the Create button highlighted](/assets/temp-1-cook-chicken-example-pic-1.png) 2\. Edit your dashboard, add a button card, select Chicken Monitor, and then save. -![](/assets/temp-1-cook-chicken-example-pic-3.png)![](/assets/temp-1-cook-chicken-example-pic-2.png) +![Home Assistant Add to dashboard dialog with button typed in the card search](/assets/temp-1-cook-chicken-example-pic-3.png)![Home Assistant Button card configuration with the Chicken Monitor entity and Save button highlighted](/assets/temp-1-cook-chicken-example-pic-2.png) 3\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left then "create new automation". Click here to go straight there! 4\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "On". Advanced users skip to step 25 for the YAML. -![](/assets/temp-1-cook-chicken-example-pic-4.png) +![Home Assistant state trigger for Chicken Monitor with the To field set to On](/assets/temp-1-cook-chicken-example-pic-4.png) 5\. Create a Trigger ID for this called "Chicken Monitor On". -![](/assets/temp-1-cook-chicken-example-pic-5.png)![](/assets/temp-1-cook-chicken-example-pic-6-1.png) +![Home Assistant trigger options menu open with Edit ID selected](/assets/temp-1-cook-chicken-example-pic-5.png)![Home Assistant Chicken Monitor trigger with Trigger ID set to Chicken Monitor On](/assets/temp-1-cook-chicken-example-pic-6-1.png) 6\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "Off". Create a Trigger ID for this called "Chicken Monitor Off". -![](/assets/temp-1-cook-chicken-example-pic-21.png) +![Home Assistant state trigger for Chicken Monitor set to Off with Trigger ID Chicken Monitor Off highlighted](/assets/temp-1-cook-chicken-example-pic-21.png) 7\. Click Add Trigger then Entity then Numeric state and search for your temp-1 food probe entity such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 160°F(71.1C) because the Chicken will rest and reach 165°F once removed from the oven/grill. -![](/assets/temp-1-cook-chicken-example-pic-7.png) +![Home Assistant numeric state trigger on TEMP-1 Food Probe with the Above field set to 160](/assets/temp-1-cook-chicken-example-pic-7.png) 8\. Create a Trigger ID for this called "Temp Reached". -![](/assets/temp-1-cook-chicken-example-pic-8.png) +![Home Assistant TEMP-1 Food Probe trigger with Trigger ID set to Temp Reached highlighted](/assets/temp-1-cook-chicken-example-pic-8.png) 9\. Click Add Action and search "choose" then select it. -![](/assets/temp-1-cook-chicken-example-pic-12.png) +![Home Assistant Add action dialog with choose searched and the Choose action listed](/assets/temp-1-cook-chicken-example-pic-12.png) 10\. Under option 1 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Home Assistant Add condition dialog with trigger id searched and Triggered by listed](/assets/temp-1-cook-chicken-example-pic-13.png) 11\. Check off the option "Button Pressed" that we created in step 5 above. -![](/assets/temp-1-cook-chicken-example-pic-14.png) +![Home Assistant Choose action Option 1 with the Button Pressed trigger checked and highlighted](/assets/temp-1-cook-chicken-example-pic-14.png) 12\. While still under Option 1 in the choose action: Click Add Action and search "light" then select Light: Turn on. -![](/assets/temp-1-cook-chicken-example-pic-9.png) +![Home Assistant Add action dialog with light searched and Light: Turn on highlighted](/assets/temp-1-cook-chicken-example-pic-9.png) 13\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-10.png) +![Home Assistant Choose entity search for TEMP-1 with the cursor on the Apollo TEMP-1 RGB Light entity](/assets/temp-1-cook-chicken-example-pic-10.png) 14\. Click "Advanced Options" and then click the check box for Color name then select a color from the dropdown such as Green. -![](/assets/temp-1-cook-chicken-example-pic-11.png) +![Home Assistant light action Advanced options with Color name checked and Green picked from the list](/assets/temp-1-cook-chicken-example-pic-11.png) 15\. While still under Option 1 in the choose action: Click Add Action and search "mobile" and then select your phone in the list. -![](/assets/temp-1-cook-chicken-example-pic-15.png) +![Home Assistant Add action dialog with mobile searched and the iPhone notification action highlighted](/assets/temp-1-cook-chicken-example-pic-15.png) 16\. Write in a custom title and or message- the message is required but the title is not. -![](/assets/temp-1-cook-chicken-example-pic-16.png) +![Home Assistant notification action with the title Chicken Monitoring Started and a custom message](/assets/temp-1-cook-chicken-example-pic-16.png) 17\. This is how option 1 will look when you are done with this part: -![](/assets/temp-1-cook-chicken-example-pic-17-1.png) +![Home Assistant Option 1 triggered by Chicken Monitor On with light turn on and notification actions](/assets/temp-1-cook-chicken-example-pic-17-1.png) 18\. Click "Add Option" at the bottom then under option 2 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Home Assistant Add condition dialog with trigger id searched and Triggered by listed](/assets/temp-1-cook-chicken-example-pic-13.png) 19\. Check off the option "Temp Reached" that we created in step 7 above. -![](/assets/temp-1-cook-chicken-example-pic-18-1.png) +![Home Assistant Option 2 Triggered by condition with only Temp Reached checked](/assets/temp-1-cook-chicken-example-pic-18-1.png) 20\. While still under Option 2 in the choose action: Click Add Action and search "repeat" then select "Until" in the dropdown. -![](/assets/temp-1-cook-chicken-example-pic-22.png) +![Home Assistant Add action dialog with repeat searched and the Repeat action listed](/assets/temp-1-cook-chicken-example-pic-22.png) 21\. Under Until Conditions, select "Add condition" then search "state". -![](/assets/temp-1-cook-chicken-example-pic-25.png) +![Home Assistant Add condition dialog with state searched and the State condition listed](/assets/temp-1-cook-chicken-example-pic-25.png) 22\. Type in Chicken Monitor and select it, then click "Off" in the dropdown for the state of the sensor. -![](/assets/temp-1-cook-chicken-example-pic-26.png) +![Home Assistant repeat until condition with Chicken Monitor entity and Off state highlighted](/assets/temp-1-cook-chicken-example-pic-26.png) 23\. Click "Add Action" under the "until" condition we created above. Be very careful to select the correct "Add Action" button as shown below. -![](/assets/temp-1-cook-chicken-example-pic-27.png) +![Home Assistant repeat until block with its inner Add Action button highlighted](/assets/temp-1-cook-chicken-example-pic-27.png) 24\. Search "light toggle" in the search bar shown then select "Choose entity" and select your the rgb led for your device -![](/assets/temp-1-cook-chicken-example-pic-28.png) +![Home Assistant Add action dialog with light toggle searched and Light: Toggle listed](/assets/temp-1-cook-chicken-example-pic-28.png) 25\. Head down to Add Action under Option 2 and search "mobile" then select your phone as you did above in step 15. Give it a message and a title as shown below. -![](/assets/temp-1-cook-chicken-example-pic-29.png) +![Home Assistant Option 2 notification action titled Time to check the Chicken! with its message](/assets/temp-1-cook-chicken-example-pic-29.png) 26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already setup. -![](/assets/temp-1-cook-chicken-example-pic-30.png)![](/assets/temp-1-cook-chicken-example-pic-31.png) +![Home Assistant Add action dialog with tts searched and the TTS Speak action listed](/assets/temp-1-cook-chicken-example-pic-30.png)![Home Assistant TTS Speak action on piper targeting Homepods with The Chicken is almost ready! message](/assets/temp-1-cook-chicken-example-pic-31.png) 27\. Click "Add Option" (this is now Option 3). We will choose add condition then search "triggered by" and then choose the "Chicken Monitor Off" Trigger ID that we created in step 6. 28\. While still under Option 3 in the choose action: Click Add Action and search "light" then select Light: Turn off. -![](/assets/temp-1-cook-chicken-example-pic-19.png) +![Home Assistant Add action dialog with light.turn searched and Light: Turn off selected](/assets/temp-1-cook-chicken-example-pic-19.png) 29\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-20.png) +![Home Assistant Light Turn off action targeting the Apollo TEMP-1 RGB Light](/assets/temp-1-cook-chicken-example-pic-20.png) 30\. Choose "Add Action" and search mobile like we did above and select your mobile phone. Give it an optional title and message as shown below. -![](/assets/temp-1-cook-chicken-example-pic-33.png) +![Home Assistant notification action titled Chicken Monitoring Stopped! with its message](/assets/temp-1-cook-chicken-example-pic-33.png) 31\. Click save in the bottom right then give it a name and save -![](/assets/temp-1-cook-chicken-example-pic-34.png) +![Home Assistant save dialog for TEMP-1 Chicken Automation in the Food category with Save clicked](/assets/temp-1-cook-chicken-example-pic-34.png) 32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to discord user RalphP for this example! \ No newline at end of file diff --git a/docs/products/temp1b/setup/insert-battery.md b/docs/products/temp1b/setup/insert-battery.md index 88c0dbf2a2..2582aa8449 100755 --- a/docs/products/temp1b/setup/insert-battery.md +++ b/docs/products/temp1b/setup/insert-battery.md @@ -10,44 +10,44 @@ description: How to Insert Battery on TEMP-1B. 1\. Gently pry open the case lid as shown in the image below. -![](/assets/temp-1b-pry-open.jpg) +![Prying the TEMP-1B case lid open with a flat metal tool](/assets/temp-1b-pry-open.jpg) -![](/assets/temp-1b-lid-off.jpg) +![TEMP-1B with the lid removed, showing the circuit board in the case](/assets/temp-1b-lid-off.jpg) 2\. Once the lid is removed either lift the PCB out or gently dump the pcb out by turning it upside down. -![](/assets/temp-1b-lift-pcb-out-1.jpg) +![Lifting the TEMP-1B circuit board out of its case](/assets/temp-1b-lift-pcb-out-1.jpg) -![](/assets/temp-1b-remove-case.jpg) +![TEMP-1B case lifted away from the board, exposing the empty battery holder](/assets/temp-1b-remove-case.jpg) 3\. Align the battery as shown in the image below. -![](/assets/temp-1b-battery-insert-pic-1.jpg) +![16340 battery lined up with the TEMP-1B holder, + and - markings boxed in red](/assets/temp-1b-battery-insert-pic-1.jpg) 4\. Insert the battery with the positive terminal facing the + sign. -![](/assets/temp-1b-battery-insert-pic-3.jpg) +![16340 battery seated in the TEMP-1B battery holder](/assets/temp-1b-battery-insert-pic-3.jpg) -![](/assets/temp-1b-battery-insert-pic-4.jpg) +![Battery positive end lined up with the + mark on the TEMP-1B board](/assets/temp-1b-battery-insert-pic-4.jpg) 5\. Begin reassembly by placing the battery side down with the RGB led in the top right corner. -![](/assets/temp-1b-battery-insert-empty-case.jpg) +![Empty TEMP-1B case ready for the board to go back in](/assets/temp-1b-battery-insert-empty-case.jpg) -![](/assets/temp-1b-battery-insert-pcb-ledge.jpg) +![TEMP-1B board edge set on the case ledge, RGB LED in the top right corner](/assets/temp-1b-battery-insert-pcb-ledge.jpg) 6\. You will use the "ledge" of the case to set the PCB down and then it will lay down and rest on the ledge of the other side as well. -![](/assets/temp-1b-battery-insert-pcb-hinge.jpg) +![Lowering the TEMP-1B board into the case, battery side down, pivoting on the ledge](/assets/temp-1b-battery-insert-pcb-hinge.jpg) -![](/assets/temp-1b-battery-insert-pcb-flat.jpg) +![TEMP-1B board lying flat in the case with the RGB LED in the top right](/assets/temp-1b-battery-insert-pcb-flat.jpg) 7\. Align the RGB led in the top right with the small hole in the lid. -![](/assets/temp-1b-battery-insert-align-rgb.jpg) +![Lining up the small hole in the TEMP-1B lid with the RGB LED](/assets/temp-1b-battery-insert-align-rgb.jpg) 8\. Gently press down until it the lid seats. -![](/assets/temp-1b-battery-insert-press-case.jpg) +![Pressing the TEMP-1B lid down until it seats on the case](/assets/temp-1b-battery-insert-press-case.jpg) 9 You have now installed or reinstalled the battery! \ No newline at end of file diff --git a/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md b/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md index 231835f4c2..4027f9365b 100755 --- a/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md +++ b/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md @@ -12,13 +12,13 @@ description: Step by step guide for putting The TEMP-1B In Boot Mode. 1\. Position the TEMP-1B so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. -![](/assets/temp-1b-boot-button-side-view.jpg) +![Tool pointing at the boot button opening on the side of the TEMP-1B case](/assets/temp-1b-boot-button-side-view.jpg) If you prefer, please remove the lid by gently prying up on the small slit by the top of the case. -![](/assets/temp-1b-pry-open.jpg) +![Prying the TEMP-1B case lid open at the slit near the top](/assets/temp-1b-pry-open.jpg) -![](/assets/temp-1b-boot-button-lid-off.jpg) +![TEMP-1B with the lid off, tool pointing at the BOOT button](/assets/temp-1b-boot-button-lid-off.jpg) 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 TEMP-1B then let go of the button. @@ -32,6 +32,6 @@ If you prefer, please remove the lid by gently prying up on the small slit by th 3\. Hold down the boot button (shown above), then press and release the reset button (shown below) while keeping the boot button pressed. Finally, release the boot button. -![](/assets/temp-1-reset-button-lid-off.jpg) +![TEMP-1B with the lid off, tool pointing at the RST reset button](/assets/temp-1-reset-button-lid-off.jpg) 4\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/products/temp1b/troubleshooting/temp1b-code/). \ No newline at end of file diff --git a/docs/products/temp1b/troubleshooting/temp1b-code.md b/docs/products/temp1b/troubleshooting/temp1b-code.md index ec21ee2682..fc7993b017 100755 --- a/docs/products/temp1b/troubleshooting/temp1b-code.md +++ b/docs/products/temp1b/troubleshooting/temp1b-code.md @@ -20,7 +20,7 @@ If your device has already been connected to Home Assistant please in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. my minimums are around -20F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe, arrows at freezer highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2C and a min probe temp of -30C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![TEMP-1 Max Probe Temp set to 2.0 °C and Min Probe Temp set to -30.0 °C](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1 will play an audible alert with it's buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off -![](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file +![Alarm Outside Temp Range toggle switched on in the TEMP-1 Controls card](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file diff --git a/docs/products/temppro1/examples/temp1-automation-examples.md b/docs/products/temppro1/examples/temp1-automation-examples.md index dbb0f7bd5f..507a0b3ff2 100755 --- a/docs/products/temppro1/examples/temp1-automation-examples.md +++ b/docs/products/temppro1/examples/temp1-automation-examples.md @@ -12,11 +12,11 @@ This will guide you through how to setup an automation in Home Assistant using t 2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. my minimums are around -20°F. -![](/assets/temp-1-temp-probe-ex-automation-pic-1.png) +![Home Assistant history graph of the TEMP-1 temperature probe, arrows at freezer highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) 3\. We now need to convert F to C since the max and min temps are measured in Celsius. My new values I will input are max probe temp 2°C and a min probe temp of -30°C. Reminder, yours will likely be different values, especially your max probe temp. -![](/assets/temp-1-temp-probe-ex-automation-pic-2.png) +![TEMP-1 Max Probe Temp set to 2.0 °C and Min Probe Temp set to -30.0 °C](/assets/temp-1-temp-probe-ex-automation-pic-2.png) 4\. The automation is now ready to be created - @@ -24,11 +24,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you found in step 2 above. Advanced users skip to step 10. -![](/assets/temp-1-temp-probe-ex-automation-pic-3.png) +![Home Assistant numeric state trigger on Apollo TEMP-1 Max Probe Temp with Above set to 30](/assets/temp-1-temp-probe-ex-automation-pic-3.png) 7\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action search for iphone with the phone notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -36,11 +36,11 @@ This will guide you through how to setup an automation in Home Assistant using t 8\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1 reached its max temperature and your freezer might be having issues." and "Check the freezer!". -![](/assets/temp-1-temp-probe-ex-automation-pic-5.png) +![Notification action with the freezer warning message and Check the freezer! title](/assets/temp-1-temp-probe-ex-automation-pic-5.png) 9\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-temp-probe-ex-automation-pic-6.png) +![Save dialog for the Freezer Over Max Temp Automation with name, description, and category](/assets/temp-1-temp-probe-ex-automation-pic-6.png) --- @@ -72,7 +72,7 @@ This will guide you through how to setup an automation in Home Assistant using t 1\. Set your Max Probe Temp to 73.9°C. The offsets MUST be in Celsius even if you are using F in the automation below. -![](/assets/temp-1-food-probe-ex-automation-pic-1.png) +![TEMP-1 Max Probe Temp set to 73.9 °C, highlighted in red](/assets/temp-1-food-probe-ex-automation-pic-1.png) 2\. Place the food probe inside your food once it's on the grill. Make sure your TEMP-1 is in a cool dry place - only the food probe and the wire can withstand temperatures on a grill, in the oven, etc. @@ -80,11 +80,11 @@ This will guide you through how to setup an automation in Home Assistant using t 4\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. -![](/assets/temp-1-food-probe-ex-automation-pic-3.png) +![Numeric state trigger on Apollo TEMP-1 Max Probe Temp with Above set to 165](/assets/temp-1-food-probe-ex-automation-pic-3.png) 5\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. -![](/assets/temp-1-temp-probe-ex-automation-pic-4.png) +![Home Assistant Add action search for iphone with the phone notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) !!! tip "If you still do not see your device as shown in step 7 read this!" @@ -92,11 +92,11 @@ This will guide you through how to setup an automation in Home Assistant using t 6\. Type in your preferred message and if you want, check the box for title and type in your title for the message as well. Mine says: "The temperature probe on your TEMP-1 reached its max temperature and your food is ready." and "Check the food!". -![](/assets/temp-1-food-probe-ex-automation-pic-5.png) +![Notification action with the food ready message and Check the food! title](/assets/temp-1-food-probe-ex-automation-pic-5.png) 7\. Click save in the bottom right and then give it a Name and optionally a Description and a Category as well. You are done! -![](/assets/temp-1-food-probe-ex-automation-pic-6.png) +![Save dialog for the Food over Max Temp Automation with the cursor on Save](/assets/temp-1-food-probe-ex-automation-pic-6.png) --- @@ -127,122 +127,122 @@ This will guide you through adding a button to your dashboard called "Chicken Mo 1\. Create a new toggle helper called "Chicken Monitor". Please click here for step by step directions on creating a toggle helper. -![](/assets/temp-1-cook-chicken-example-pic-1.png) +![Home Assistant Create Toggle dialog for a Chicken Monitor helper, Create highlighted](/assets/temp-1-cook-chicken-example-pic-1.png) 2\. Edit your dashboard, add a button card, select Chicken Monitor, and then save. -![](/assets/temp-1-cook-chicken-example-pic-3.png)![](/assets/temp-1-cook-chicken-example-pic-2.png) +![Home Assistant Add to dashboard dialog searching for the Button card](/assets/temp-1-cook-chicken-example-pic-3.png)![Button card configuration with Chicken Monitor as the entity, Save highlighted](/assets/temp-1-cook-chicken-example-pic-2.png) 3\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left then "create new automation". Click here to go straight there! 4\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "On". Advanced users skip to step 25 for the YAML. -![](/assets/temp-1-cook-chicken-example-pic-4.png) +![Home Assistant state trigger for Chicken Monitor changing to On](/assets/temp-1-cook-chicken-example-pic-4.png) 5\. Create a Trigger ID for this called "Chicken Monitor On". -![](/assets/temp-1-cook-chicken-example-pic-5.png)![](/assets/temp-1-cook-chicken-example-pic-6-1.png) +![Trigger menu open with Edit ID selected on the Chicken Monitor trigger](/assets/temp-1-cook-chicken-example-pic-5.png)![Chicken Monitor trigger with the Trigger ID set to Chicken Monitor On](/assets/temp-1-cook-chicken-example-pic-6-1.png) 6\. Click Add Trigger then Entity then State and search for "Chicken Monitor" then in the box labeled "To" select "Off". Create a Trigger ID for this called "Chicken Monitor Off". -![](/assets/temp-1-cook-chicken-example-pic-21.png) +![Chicken Monitor state trigger set to Off with Trigger ID Chicken Monitor Off](/assets/temp-1-cook-chicken-example-pic-21.png) 7\. Click Add Trigger then Entity then Numeric state and search for your temp-1 food probe entity such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 160°F(71.1C) because the Chicken will rest and reach 165°F once removed from the oven/grill. -![](/assets/temp-1-cook-chicken-example-pic-7.png) +![Numeric state trigger on Apollo TEMP-1 Food Probe with Above set to 160](/assets/temp-1-cook-chicken-example-pic-7.png) 8\. Create a Trigger ID for this called "Temp Reached". -![](/assets/temp-1-cook-chicken-example-pic-8.png) +![Apollo TEMP-1 Food Probe trigger with Trigger ID set to Temp Reached](/assets/temp-1-cook-chicken-example-pic-8.png) 9\. Click Add Action and search "choose" then select it. -![](/assets/temp-1-cook-chicken-example-pic-12.png) +![Home Assistant Add action dialog searching choose, showing the Choose action](/assets/temp-1-cook-chicken-example-pic-12.png) 10\. Under option 1 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Add condition dialog searching trigger id, showing the Triggered by condition](/assets/temp-1-cook-chicken-example-pic-13.png) 11\. Check off the option "Button Pressed" that we created in step 5 above. -![](/assets/temp-1-cook-chicken-example-pic-14.png) +![Option 1 Triggered by condition with the Button Pressed trigger checked](/assets/temp-1-cook-chicken-example-pic-14.png) 12\. While still under Option 1 in the choose action: Click Add Action and search "light" then select Light: Turn on. -![](/assets/temp-1-cook-chicken-example-pic-9.png) +![Add action search for light with Light: Turn on highlighted](/assets/temp-1-cook-chicken-example-pic-9.png) 13\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-10.png) +![Choose entity search results listing the Apollo TEMP-1 RGB Light](/assets/temp-1-cook-chicken-example-pic-10.png) 14\. Click "Advanced Options" and then click the check box for Color name then select a color from the dropdown such as Green. -![](/assets/temp-1-cook-chicken-example-pic-11.png) +![Light advanced options with Color name checked and Green selected](/assets/temp-1-cook-chicken-example-pic-11.png) 15\. While still under Option 1 in the choose action: Click Add Action and search "mobile" and then select your phone in the list. -![](/assets/temp-1-cook-chicken-example-pic-15.png) +![Add action search for mobile with the iPhone notification action highlighted](/assets/temp-1-cook-chicken-example-pic-15.png) 16\. Write in a custom title and or message- the message is required but the title is not. -![](/assets/temp-1-cook-chicken-example-pic-16.png) +![Notification action titled Chicken Monitoring Started with a TEMP-1 message](/assets/temp-1-cook-chicken-example-pic-16.png) 17\. This is how option 1 will look when you are done with this part: -![](/assets/temp-1-cook-chicken-example-pic-17-1.png) +![Finished Option 1: Chicken Monitor On condition, TEMP-1 RGB Light on, and phone notification](/assets/temp-1-cook-chicken-example-pic-17-1.png) 18\. Click "Add Option" at the bottom then under option 2 select "Add Condition" then search "trigger id" and select Triggered by. -![](/assets/temp-1-cook-chicken-example-pic-13.png) +![Add condition dialog searching trigger id for Option 2, showing Triggered by](/assets/temp-1-cook-chicken-example-pic-13.png) 19\. Check off the option "Temp Reached" that we created in step 7 above. -![](/assets/temp-1-cook-chicken-example-pic-18-1.png) +![Triggered by condition with only Temp Reached checked](/assets/temp-1-cook-chicken-example-pic-18-1.png) 20\. While still under Option 2 in the choose action: Click Add Action and search "repeat" then select "Until" in the dropdown. -![](/assets/temp-1-cook-chicken-example-pic-22.png) +![Add action dialog searching repeat, with the Repeat action selected](/assets/temp-1-cook-chicken-example-pic-22.png) 21\. Under Until Conditions, select "Add condition" then search "state". -![](/assets/temp-1-cook-chicken-example-pic-25.png) +![Add condition dialog searching state, with the State condition selected](/assets/temp-1-cook-chicken-example-pic-25.png) 22\. Type in Chicken Monitor and select it, then click "Off" in the dropdown for the state of the sensor. -![](/assets/temp-1-cook-chicken-example-pic-26.png) +![Repeat until condition with Chicken Monitor entity and Off state highlighted](/assets/temp-1-cook-chicken-example-pic-26.png) 23\. Click "Add Action" under the "until" condition we created above. Be very careful to select the correct "Add Action" button as shown below. -![](/assets/temp-1-cook-chicken-example-pic-27.png) +![Repeat until block with its inner Add Action button highlighted](/assets/temp-1-cook-chicken-example-pic-27.png) 24\. Search "light toggle" in the search bar shown then select "Choose entity" and select your the rgb led for your device -![](/assets/temp-1-cook-chicken-example-pic-28.png) +![Add action dialog searching light toggle, with Light: Toggle selected](/assets/temp-1-cook-chicken-example-pic-28.png) 25\. Head down to Add Action under Option 2 and search "mobile" then select your phone as you did above in step 15. Give it a message and a title as shown below. -![](/assets/temp-1-cook-chicken-example-pic-29.png) +![Option 2 notification titled Time to check the Chicken! with a 160F message](/assets/temp-1-cook-chicken-example-pic-29.png) 26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already setup. -![](/assets/temp-1-cook-chicken-example-pic-30.png)![](/assets/temp-1-cook-chicken-example-pic-31.png) +![Add action dialog searching tts, with Text-to-speech (TTS): Speak selected](/assets/temp-1-cook-chicken-example-pic-30.png)![TTS Speak action on piper targeting Homepods with The Chicken is almost ready! message](/assets/temp-1-cook-chicken-example-pic-31.png) 27\. Click "Add Option" (this is now Option 3). We will choose add condition then search "triggered by" and then choose the "Chicken Monitor Off" Trigger ID that we created in step 6. 28\. While still under Option 3 in the choose action: Click Add Action and search "light" then select Light: Turn off. -![](/assets/temp-1-cook-chicken-example-pic-19.png) +![Add action dialog searching light.turn, with Light: Turn off selected](/assets/temp-1-cook-chicken-example-pic-19.png) 29\. Click choose entity then search for your device such as "Temp-1 RGB Light". -![](/assets/temp-1-cook-chicken-example-pic-20.png) +![Light Turn off action targeting the Apollo TEMP-1 RGB Light](/assets/temp-1-cook-chicken-example-pic-20.png) 30\. Choose "Add Action" and search mobile like we did above and select your mobile phone. Give it an optional title and message as shown below. -![](/assets/temp-1-cook-chicken-example-pic-33.png) +![Notification action titled Chicken Monitoring Stopped! with a no longer monitored message](/assets/temp-1-cook-chicken-example-pic-33.png) 31\. Click save in the bottom right then give it a name and save -![](/assets/temp-1-cook-chicken-example-pic-34.png) +![Save dialog naming the TEMP-1 Chicken Automation in the Food category](/assets/temp-1-cook-chicken-example-pic-34.png) 32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to discord user RalphP for this example! \ No newline at end of file diff --git a/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md b/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md index 71f2a9cfa4..ccbf87f961 100755 --- a/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md +++ b/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md @@ -12,11 +12,11 @@ description: Step by step guide for putting The TEMP Pro-1 In Boot Mode. 1\. Position the TEMP Pro-1 so that the USB-C port is facing you. Remove the lid by gently prying up on the small slit by the top of the case. -![](/assets/temp-pro-1-boot-button-lift-lid-jpg.jpeg) +![Prying up the TEMP Pro-1 lid at the slit above the USB-C port](/assets/temp-pro-1-boot-button-lift-lid-jpg.jpeg) 2\. Locate the boot button as show in the image below. -![](/assets/temp-pro-1-boot-button.jpeg) +![Tool pointing at the BOOT button on the TEMP Pro-1 board](/assets/temp-pro-1-boot-button.jpeg) 3\. 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 TEMP Pro-1 then let go of the button. @@ -30,6 +30,6 @@ description: Step by step guide for putting The TEMP Pro-1 In Boot Mode. 3\. Hold down the boot button (shown above), then press and release the reset button (shown below) while keeping the boot button pressed. Finally, release the boot button. -![](/assets/temp-pro-1-reset-button.jpeg) +![Tool pointing at the RST reset button on the TEMP Pro-1 board](/assets/temp-pro-1-reset-button.jpeg) 4\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/products/temppro1/troubleshooting/temp-pro1-code/). \ No newline at end of file diff --git a/docs/products/temppro1/troubleshooting/temp-pro1-code.md b/docs/products/temppro1/troubleshooting/temp-pro1-code.md index 7e4e7cf504..dd0b9f3746 100755 --- a/docs/products/temppro1/troubleshooting/temp-pro1-code.md +++ b/docs/products/temppro1/troubleshooting/temp-pro1-code.md @@ -16,23 +16,23 @@ If your device has already been connected to Home Assistant please - 1\. Gently pry open the case lid as shown in the image below. -![](/assets/temp-pro-1-boot-button-lift-lid-jpg.jpeg) +![Prying up the TEMP Pro-1 lid at the slit above the USB-C port](/assets/temp-pro-1-boot-button-lift-lid-jpg.jpeg) 2\. The teardown is complete! \ No newline at end of file From d7e5a0b21030f7629389229ebaa32b99588ea0f5 Mon Sep 17 00:00:00 2001 From: Justin Bunton <130115204+Bunton33@users.noreply.github.com> Date: Mon, 12 Oct 2026 06:27:58 -0400 Subject: [PATCH 2/4] docs: fix typos, grammar, and product and brand name casing One copy-edit pass over all 710 pages, clear errors only (no rewording for style, no technical changes). An independent reviewer per chunk checked every changed hunk against HEAD. - 151 typos (e.g. "sumamry", "Presense", "recieve"), 94 grammar fixes (e.g. "set up" as a verb, "comes", sentence capitals), 7 British to US spellings. - 43 product ID slips (Air-1, temp-1, btn-1, R-Pro-1 -> AIR-1, TEMP-1, BTN-1, R PRO-1) and 191 brand casing slips (esphome, home assistant, WiFi, Github, Youtuber, usb-c, bluetooth -> ESPHome, Home Assistant, Wi-Fi, GitHub, YouTuber, USB-C, Bluetooth). Wi-Fi is the dominant form in the repo (256 vs 64). - Untouched by design: code, YAML, URLs, entity IDs, hostnames, hotspot and device-reported names, on-screen labels, external video titles, and all numbers. A script checked every file against HEAD for this. Co-Authored-By: Claude Opus 5.5 --- docs/_snippets/bluetooth-proxy/intro.md | 2 +- docs/homey.md | 2 +- .../air1/addons/adding-co2-to-air-1.md | 2 +- .../addons/adding-gpio-header-to-air-1.md | 2 +- docs/homey/products/air1/air1-reviews.md | 2 +- .../air-quality-notification-example.md | 4 +-- .../air1/troubleshooting/air1-code.md | 2 +- .../co2-calibration.md | 2 +- .../calibrating-and-updating/mmwave-videos.md | 6 ++-- docs/homey/products/general/comparisons.md | 2 +- docs/homey/products/general/links.md | 2 +- .../mmwave-presence-sensor-comparison.md | 2 +- ...dding-apollo-devices-to-hidden-networks.md | 2 +- .../products/general/setup/getting-started.md | 6 ++-- ...ubiquiti-unifi-mdns-auto-discover-issue.md | 2 +- .../high-co2-notification-example.md | 4 +-- .../adding-articulating-stand-to-msr-2.md | 4 +-- .../addons/adding-rear-female-usb-to-msr-2.md | 2 +- .../products/msr2/addons/msr2-outlet-mount.md | 4 +-- .../products/msr2/examples/msr2-alarmo.md | 4 +-- .../products/msr2/examples/msr2-dashboards.md | 2 +- .../msr2/examples/using-msr-2-buzzer.md | 4 +-- docs/homey/products/msr2/faq.md | 6 ++-- docs/homey/products/msr2/msr2-reviews.md | 2 +- .../products/msr2/setup/mmwave-videos.md | 2 +- .../addons/adding-90-degree-usb-c-to-mtr-1.md | 2 +- ...mtr-1-home-assistant-dashboard-examples.md | 2 +- .../products/mtr1/examples/mtr1-alarmo.md | 2 +- .../mtr1/examples/using-mtr-1-buzzer.md | 4 +-- docs/homey/products/mtr1/faq.md | 4 +-- docs/homey/products/mtr1/mtr1-reviews.md | 2 +- .../homey/products/mtr1/setup/general-tips.md | 4 +-- .../mtr-1-temperature-&-humidity-offsets.md | 6 ++-- docs/homey/products/mtr1/setup/zones-hlk.md | 2 +- docs/homey/products/plt1/faq.md | 6 ++-- docs/homey/products/plt1/reviews.md | 2 +- .../products/plt1/setup/prevent-sleep.md | 2 +- .../plt1/troubleshooting/plt1-code.md | 2 +- docs/homey/products/plt1b/faq.md | 6 ++-- docs/homey/products/plt1b/reviews.md | 2 +- .../products/plt1b/setup/prevent-sleep.md | 2 +- .../plt1b/troubleshooting/plt1b-code.md | 4 +-- ...add-the-ld2412-mmwave-sensor-to-r-pro-1.md | 2 +- .../rpro1/addons/adding-co2-to-r-pro-1.md | 2 +- .../attaching-gang-box-mount-to-r-pro-1.md | 2 +- docs/homey/products/rpro1/faq.md | 2 +- docs/homey/products/rpro1/introduction.md | 2 +- docs/homey/products/rpro1/rpro1-reviews.md | 2 +- docs/homey/products/rpro1/setup/zones-hlk.md | 6 ++-- .../products/temp1/addons/magnetic-mount.md | 2 +- .../temp1/examples/temp1-alert-example.md | 6 ++-- .../examples/temp1-automation-examples.md | 22 +++++++-------- docs/homey/products/temp1/faq.md | 4 +-- docs/homey/products/temp1/reviews.md | 2 +- .../products/temp1/setup/prevent-sleep.md | 2 +- .../temp1/troubleshooting/temp1-code.md | 2 +- .../temp1/troubleshooting/temp1-teardown.md | 2 +- .../products/temp1b/addons/magnetic-mount.md | 2 +- .../temp1b/examples/temp1b-alert-example.md | 6 ++-- .../examples/temp1b-automation-examples.md | 18 ++++++------ docs/homey/products/temp1b/faq.md | 6 ++-- docs/homey/products/temp1b/reviews.md | 2 +- .../products/temp1b/setup/insert-battery.md | 2 +- .../products/temp1b/setup/prevent-sleep.md | 2 +- .../temp1b/troubleshooting/temp1b-code.md | 2 +- .../temp1b/troubleshooting/temp1b-teardown.md | 2 +- docs/index.md | 2 +- .../device-builder-tour.md | 2 +- .../learning-the-basics/what-is-yaml.md | 2 +- .../modules/apollo-breakout-module.md | 2 +- .../modules/button-module.md | 4 +-- .../modules/motion-module.md | 2 +- .../modules/rgb-buzzer-module.md | 4 +-- .../modules/temperature-humidity-module.md | 2 +- .../ESPHome-Starter-Kit/setup/first-steps.md | 2 +- .../tutorials/bluetooth-proxy.md | 2 +- .../tutorials/light-effects.md | 2 +- .../addons/adding-gpio-header-to-air-1.md | 2 +- docs/products/air1/air1-reviews.md | 2 +- .../air1/examples/air1-dashboard-examples.md | 4 +-- .../air1/examples/firstof9's-apex-charts.md | 4 +-- docs/products/air1/faq.md | 6 ++-- docs/products/air1/introduction.md | 2 +- .../air1/troubleshooting/air1-code.md | 2 +- docs/products/apolloodroid/faq.md | 2 +- docs/products/apolloodroid/getting-started.md | 2 +- .../btn1/examples/example-automation.md | 4 +-- docs/products/btn1/faq.md | 2 +- docs/products/btn1/setup/getting-started.md | 14 +++++----- .../btn1/troubleshooting/btn1-reflash.md | 2 +- docs/products/cast1/setup/getting-started.md | 2 +- .../cast1/troubleshooting/cast1-reflash.md | 2 +- docs/products/dev2/introduction.md | 2 +- .../battery-sensors/awake-ha-helper.md | 4 +-- .../general/battery-sensors/prevent-sleep.md | 2 +- .../co2-calibration-quick.md | 2 +- .../co2-calibration.md | 2 +- .../calibrating-and-updating/mmwave-videos.md | 6 ++-- docs/products/general/comparisons.md | 4 +-- docs/products/general/faq.md | 8 +++--- docs/products/general/links.md | 2 +- .../mmwave-presence-sensor-comparison.md | 4 +-- docs/products/general/piezo.md | 4 +-- ...dding-apollo-devices-to-hidden-networks.md | 4 +-- .../general/setup/adjusting-wifi-power.md | 14 +++++----- .../change-the-update-frequency-of-sensors.md | 2 +- .../products/general/setup/getting-started.md | 16 +++++------ ...how-to-add-temp-and-humidity-from-scd40.md | 2 +- .../general/setup/renaming-apollo-devices.md | 6 ++-- .../general/setup/switch-to-beta-branch.md | 8 +++--- docs/products/general/temp-hum-calibration.md | 6 ++-- .../troubleshooting/connection-issues.md | 8 +++--- .../firmware-updates-not-appearing.md | 2 +- .../removing-device-from-home-assistant.md | 2 +- ...ubiquiti-unifi-mdns-auto-discover-issue.md | 12 ++++---- .../tutorials/change-co2-update-interval.md | 2 +- ...-edit-your-sensor's-lux-update-interval.md | 4 +-- .../tutorials/smartthings-direct-control.md | 8 +++--- docs/products/h1/faq.md | 6 ++-- docs/products/h1/reflash.md | 4 +-- docs/products/h2/faq.md | 6 ++-- docs/products/h2/introduction.md | 2 +- docs/products/h2/troubleshooting/reflash.md | 2 +- docs/products/h3/introduction.md | 2 +- docs/products/h3/troubleshooting/reflash.md | 2 +- .../led-1-controlling-govee-lights.md | 2 +- .../led1/setup/getting-started-led1.md | 2 +- docs/products/led1/setup/led1-replace-fuse.md | 2 +- .../led1/troubleshooting/led1-reflash.md | 4 +-- docs/products/m1/examples/add-gifs-to-wled.md | 6 ++-- .../products/m1/examples/qr-code-generator.md | 2 +- docs/products/m1/examples/scrolling-text.md | 2 +- docs/products/m1/examples/sendspin.md | 6 ++-- docs/products/m1/faq.md | 4 +-- .../m1/setup/getting-started-m1-esphome.md | 4 +-- docs/products/m1/setup/getting-started-m1.md | 4 +-- docs/products/m1/setup/m1-matrix-settings.md | 2 +- docs/products/m1/setup/m1-multiple-panels.md | 28 +++++++++---------- docs/products/m1/setup/m1-segments.md | 2 +- docs/products/m1/setup/use-without-wifi.md | 2 +- .../m1-find-ip-address-and-hostname.md | 2 +- .../m1/troubleshooting/m1-panel-faults.md | 2 +- .../msr1/additional-info/exposed-gpio.md | 2 +- .../msr1/addons/adding-co2-to-msr-1.md | 2 +- docs/products/msr1/examples/msr1-alarmo.md | 2 +- .../products/msr1/examples/msr1-dashboards.md | 2 +- .../msr1/examples/using-msr-1-buzzer.md | 4 +-- docs/products/msr1/faq.md | 2 +- docs/products/msr1/setup/general-tips.md | 2 +- docs/products/msr1/setup/mmwave-videos.md | 2 +- .../msr1/troubleshooting/msr1-code.md | 2 +- .../addons/adding-90-degree-usb-c-to-msr-2.md | 2 +- .../adding-articulating-stand-to-msr-2.md | 4 +-- .../msr2/addons/adding-co2-to-msr-2.md | 2 +- .../addons/adding-rear-female-usb-to-msr-2.md | 4 +-- .../products/msr2/addons/msr2-outlet-mount.md | 4 +-- docs/products/msr2/examples/msr2-alarmo.md | 4 +-- docs/products/msr2/faq.md | 6 ++-- docs/products/msr2/msr2-reviews.md | 2 +- docs/products/msr2/setup/mmwave-videos.md | 2 +- docs/products/msr2/setup/msr2-general-tips.md | 2 +- .../msr2/setup/msr2-tuning-dashboard.md | 4 +-- docs/products/msr2/setup/zones-ha.md | 2 +- .../msr2/troubleshooting/msr2-code.md | 2 +- .../addons/adding-90-degree-usb-c-to-mtr-1.md | 2 +- .../mtr1/addons/adding-co2-to-mtr-1.md | 2 +- docs/products/mtr1/examples/mtr1-alarmo.md | 4 +-- docs/products/mtr1/faq.md | 4 +-- docs/products/mtr1/introduction.md | 2 +- docs/products/mtr1/mtr1-reviews.md | 2 +- docs/products/mtr1/setup/general-tips.md | 4 +-- docs/products/mtr1/setup/zones-hlk.md | 4 +-- .../mtr1/troubleshooting/mtr1-code.md | 2 +- .../productname-reviews.md | 2 +- .../setup/productname-general-tips.md | 2 +- .../troubleshooting/productname-reflash.md | 2 +- .../troubleshooting/productname-teardown.md | 2 +- docs/products/plt1/faq.md | 6 ++-- docs/products/plt1/introduction.md | 2 +- docs/products/plt1/reviews.md | 2 +- docs/products/plt1/setup/prevent-sleep.md | 2 +- .../plt1/troubleshooting/plt1-code.md | 2 +- docs/products/plt1b/faq.md | 12 ++++---- docs/products/plt1b/introduction.md | 2 +- docs/products/plt1b/reviews.md | 2 +- .../plt1b/troubleshooting/plt1b-code.md | 4 +-- .../pump1/setup/pump1-general-tips.md | 2 +- .../pump1/troubleshooting/pump1-reflash.md | 2 +- .../pump1/troubleshooting/pump1-teardown.md | 2 +- ...add-the-ld2412-mmwave-sensor-to-r-pro-1.md | 8 +++--- .../rpro1/addons/adding-co2-to-r-pro-1.md | 4 +-- .../attaching-gang-box-mount-to-r-pro-1.md | 6 ++-- docs/products/rpro1/calibrating-co2.md | 2 +- docs/products/rpro1/faq.md | 14 +++++----- docs/products/rpro1/introduction.md | 2 +- docs/products/rpro1/rpro1-reviews.md | 4 +-- .../rpro1/setup/rpro1-general-tips.md | 2 +- .../rpro1/setup/rpro1-switch-firmware.md | 8 +++--- docs/products/rpro1/setup/zones-ha-new.md | 6 ++-- docs/products/rpro1/setup/zones-ha.md | 6 ++-- docs/products/rpro1/setup/zones-hlk.md | 8 +++--- .../rpro1/troubleshooting/rpro1-code.md | 2 +- .../rpro1/troubleshooting/rpro1-teardown.md | 2 +- .../temp1/examples/temp1-alert-example.md | 6 ++-- .../examples/temp1-automation-examples.md | 22 +++++++-------- docs/products/temp1/faq.md | 10 +++---- docs/products/temp1/introduction.md | 2 +- docs/products/temp1/reviews.md | 2 +- docs/products/temp1/setup/prevent-sleep.md | 2 +- .../temp1/troubleshooting/temp1-code.md | 2 +- .../temp1b/examples/temp1b-alert-example.md | 6 ++-- .../examples/temp1b-automation-examples.md | 20 ++++++------- docs/products/temp1b/faq.md | 10 +++---- docs/products/temp1b/introduction.md | 2 +- docs/products/temp1b/reviews.md | 2 +- docs/products/temp1b/setup/insert-battery.md | 2 +- .../temp1b/troubleshooting/temp1b-code.md | 2 +- .../temppro1/examples/temp1-alert-example.md | 6 ++-- .../examples/temp1-automation-examples.md | 24 ++++++++-------- docs/products/temppro1/examples/use-cases.md | 2 +- docs/products/temppro1/faq.md | 10 +++---- docs/products/temppro1/introduction.md | 2 +- docs/products/temppro1/reviews.md | 2 +- .../setup/temp-pro-1-sensor-definitions.md | 2 +- .../troubleshooting/temp-pro1-boot-mode.md | 2 +- .../troubleshooting/temp-pro1-code.md | 2 +- 226 files changed, 447 insertions(+), 447 deletions(-) diff --git a/docs/_snippets/bluetooth-proxy/intro.md b/docs/_snippets/bluetooth-proxy/intro.md index af75c962ca..de9441ed76 100644 --- a/docs/_snippets/bluetooth-proxy/intro.md +++ b/docs/_snippets/bluetooth-proxy/intro.md @@ -1 +1 @@ -This guide shows you how to make your Apollo device act as a "BLE Proxy" which lets Bluetooth devices talk back to home assistant using Apollo devices as the "next hop"! +This guide shows you how to make your Apollo device act as a "BLE Proxy" which lets Bluetooth devices talk back to Home Assistant using Apollo devices as the "next hop"! diff --git a/docs/homey.md b/docs/homey.md index b891397706..03b610a5ec 100755 --- a/docs/homey.md +++ b/docs/homey.md @@ -29,7 +29,7 @@ description: Guide to integrating Apollo Automation devices with the Homey smart * [Understanding your AIR-1 and the various sensors it exposes](https://wiki.apolloautomation.com/products/air1/setup/general-tips/) * [How to re-calibrate your CO2 sensor](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) * [Put your Apollo devices to sleep!](https://wiki.apolloautomation.com/products/general/battery-sensors/prevent-sleep/) -* [Setup your new M-1 LED Matrix with Multiple Panels](https://wiki.apolloautomation.com/products/m1/setup/m1-multiple-panels/) +* [Set up your new M-1 LED Matrix with Multiple Panels](https://wiki.apolloautomation.com/products/m1/setup/m1-multiple-panels/) * [3D Print your own case in any color or material](https://wiki.apolloautomation.com/products/general/links/)

Community

diff --git a/docs/homey/products/air1/addons/adding-co2-to-air-1.md b/docs/homey/products/air1/addons/adding-co2-to-air-1.md index 0afab68d1b..048d3c77b9 100755 --- a/docs/homey/products/air1/addons/adding-co2-to-air-1.md +++ b/docs/homey/products/air1/addons/adding-co2-to-air-1.md @@ -1,5 +1,5 @@ --- -title: add SCD40 CO₂ Sensor +title: Add SCD40 CO₂ Sensor description: Adding The SCD40 CO₂ Sensor from Sensirion To The AIR-1. --- # Adding CO2 to AIR-1 diff --git a/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md b/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md index ff20050acd..8a0c535532 100755 --- a/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md +++ b/docs/homey/products/air1/addons/adding-gpio-header-to-air-1.md @@ -20,7 +20,7 @@ description: Adding Optional GPIO Header to AIR-1. ![AIR-1 circuit board being slid to the left out of the lid](/assets/air-1-add-co2-pic-6.jpg)![AIR-1 circuit board slid further left, almost free of the lid](/assets/air-1-add-co2-pic-7.jpg) -5\. Flip the PCB over and identify the Top Right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the PCB of the GPIO Header. There is an X on the GPIO Header's PCB as well, you can see it in the images below +5\. Flip the PCB over and identify the Top Right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the PCB of the GPIO Header. There is an X on the GPIO Header's PCB as well, you can see it in the images below. ![Back of the AIR-1 board with a tool pointing at the top right mezzanine connector](/assets/air-1-gpio-header-wiki-pic-1.webp)![GPIO header addon board with an X marked in one corner](/assets/air-1-gpio-header-wiki-pic-2.webp) diff --git a/docs/homey/products/air1/air1-reviews.md b/docs/homey/products/air1/air1-reviews.md index ee74ffbca6..c059259e25 100755 --- a/docs/homey/products/air1/air1-reviews.md +++ b/docs/homey/products/air1/air1-reviews.md @@ -1,4 +1,4 @@ --- -description: "Youtuber reviews and feedback about the AIR-1 sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the AIR-1 sensor from Apollo Automation." --- --8<-- "products/air1/air1-reviews.md:5:" \ No newline at end of file diff --git a/docs/homey/products/air1/examples/air-quality-notification-example.md b/docs/homey/products/air1/examples/air-quality-notification-example.md index ecba4f74a2..a048144f91 100755 --- a/docs/homey/products/air1/examples/air-quality-notification-example.md +++ b/docs/homey/products/air1/examples/air-quality-notification-example.md @@ -30,7 +30,7 @@ description: Example flow that sends alerts based on changing indoor air quality ![AIR-1 CO2 becomes greater than 999 ppm card in Homey](/assets/homey-flow-example-pic-7.png) -7\. Duplicate steps 4 and 5 above but this time select "CO2 becomes less than" and place it on your flow canvas.Make sure to fill in your less than ppm value such as 1000. +7\. Duplicate steps 4 and 5 above but this time select "CO2 becomes less than" and place it on your flow canvas. Make sure to fill in your less than ppm value such as 1000. ![AIR-1 CO2 cards for greater than 999 ppm and less than 1000 ppm in Homey](/assets/homey-flow-example-pic-5-1.png) @@ -38,7 +38,7 @@ description: Example flow that sends alerts based on changing indoor air quality ![Homey card search for set a color with the AIR-1 card highlighted](/assets/homey-flow-example-pic-6.png) -9\. Draw a line to connect "CO2 becomes greater than 999 ppm. Click the 3 dots and select a color - we have chosen red to indicate a problem. +9\. Draw a line to connect "CO2 becomes greater than 999 ppm". Click the 3 dots and select a color - we have chosen red to indicate a problem. ![Homey flow linking CO2 greater than 999 ppm to an AIR-1 Set a color card set to red](/assets/homey-flow-example-pic-8.png) diff --git a/docs/homey/products/air1/troubleshooting/air1-code.md b/docs/homey/products/air1/troubleshooting/air1-code.md index 8295fcae89..d89e3999d6 100755 --- a/docs/homey/products/air1/troubleshooting/air1-code.md +++ b/docs/homey/products/air1/troubleshooting/air1-code.md @@ -38,4 +38,4 @@ If your device has already been connected to Home Assistant please
proceed to the getting started guide and setup your sensor as a new device! \ No newline at end of file +8\. Please proceed to the getting started guide and set up your sensor as a new device! \ No newline at end of file diff --git a/docs/homey/products/general/calibrating-and-updating/co2-calibration.md b/docs/homey/products/general/calibrating-and-updating/co2-calibration.md index 47c8031525..b85ca3b92b 100755 --- a/docs/homey/products/general/calibrating-and-updating/co2-calibration.md +++ b/docs/homey/products/general/calibrating-and-updating/co2-calibration.md @@ -29,7 +29,7 @@ description: "Step by step guide for re-calibrating your SCD40 CO2 sensor" It might take several attempts clicking the "Press" button for it to equalize correctly. If you don't see the SCD40 reporting 400-500 ppm then click the button again. -5\. Now your CO2 sensor should be calibrated! Be sure to setup some nice flows and check out the insights so you can monitor the CO2 levels. +5\. Now your CO2 sensor should be calibrated! Be sure to set up some nice flows and check out the insights so you can monitor the CO2 levels. ![Homey CO2 graph for the Apollo AIR-1 with readings between 550 and 700 ppm](/assets/co2-calibration-homey-pic-3.png) diff --git a/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md b/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md index ccf5eb958e..f51f620716 100755 --- a/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md +++ b/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md @@ -1,5 +1,5 @@ --- -description: "Two short videos and a quick sumamry on how to best tune the LD2410B in the MSR-2!" +description: "Two short videos and a quick summary on how to best tune the LD2410B in the MSR-2!" --- # This needs to be redone for Homey if it can be duplicated. @@ -21,7 +21,7 @@ How to tune the mmWave sensor using radar engineering mode.
-1\. Navigate to the ESPHome integration by going to settings -> esphome integration -> click on the name of your new device! +1\. Navigate to the ESPHome integration by going to settings -> ESPHome integration -> click on the name of your new device! 2\. Scroll down to the Configuration section. @@ -45,7 +45,7 @@ How to tune the mmWave sensor using radar engineering mode. ![Home Assistant g4 move threshold slider moved toward the left and circled](/assets/mmwave-tuning-pic-4.png) -!!! quote "Quote from popular Youtuber Make It Work Tech" +!!! quote "Quote from popular YouTuber Make It Work Tech" I ended up maxing out the sliders on all gates and then bringing them down just enough to pick up human presence. Definitely easier than using the LD2410B app. - MakeItWorkTech diff --git a/docs/homey/products/general/comparisons.md b/docs/homey/products/general/comparisons.md index 24a61fd578..fbbbc366d5 100755 --- a/docs/homey/products/general/comparisons.md +++ b/docs/homey/products/general/comparisons.md @@ -1,4 +1,4 @@ --- -description: "mmWave Presense Sensor Comparison Chart." +description: "mmWave Presence Sensor Comparison Chart." --- --8<-- "products/general/comparisons.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/links.md b/docs/homey/products/general/links.md index 2d2812dcc3..35b4590933 100755 --- a/docs/homey/products/general/links.md +++ b/docs/homey/products/general/links.md @@ -1,4 +1,4 @@ --- -description: "Links to our github, printables, and discord!" +description: "Links to our GitHub, printables, and discord!" --- --8<-- "products/general/links.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/mmwave-presence-sensor-comparison.md b/docs/homey/products/general/mmwave-presence-sensor-comparison.md index a2ebbc2ed5..f4f1862367 100755 --- a/docs/homey/products/general/mmwave-presence-sensor-comparison.md +++ b/docs/homey/products/general/mmwave-presence-sensor-comparison.md @@ -1,4 +1,4 @@ --- -description: "mmWave Presense Sensor Comparison Chart." +description: "mmWave Presence Sensor Comparison Chart." --- --8<-- "products/general/mmwave-presence-sensor-comparison.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md b/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md index a4883721a1..0a5d7373cd 100755 --- a/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md +++ b/docs/homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md @@ -4,7 +4,7 @@ description: Tutorial for how to add Apollo Devices To Hidden Networks. --- # Adding Apollo Devices To Hidden Networks -1\. Open the Esphome Device Builder. +1\. Open the ESPHome Device Builder. ![ESPHome Device Builder dashboard listing Apollo devices](/assets/bluetooth-proxy-tutorial-1.png) diff --git a/docs/homey/products/general/setup/getting-started.md b/docs/homey/products/general/setup/getting-started.md index 09a1e77c33..7d0283e2a2 100755 --- a/docs/homey/products/general/setup/getting-started.md +++ b/docs/homey/products/general/setup/getting-started.md @@ -11,15 +11,15 @@ To get your new Apollo sensor connected to your Wi-Fi, follow the steps below! 1\. Plug the sensor into a quality power brick. They require 5v and under an amp so most phone chargers will be fine. ESP devices are sensitive to power fluctuations and users have had some issues with really cheap power bricks. If your device is restarting or unavailable please try a different power brick. -2\. On your phone or PC, open the WiFi settings and connect to "Apollo MSR-2 Hotspot", it might take a minute for the WiFi network to show up. +2\. On your phone or PC, open the Wi-Fi settings and connect to "Apollo MSR-2 Hotspot", it might take a minute for the Wi-Fi network to show up. ![Phone Wi-Fi settings with the Apollo MSR-2 hotspot network highlighted](/assets/getting-started-pic-1-1.png) -3\. Once connected it should automatically open a dashboard for your sensor +3\. Once connected it should automatically open a dashboard for your sensor. If this does not automatically open the dashboard, please open your web browser and go to [http://192.168.4.1](http://192.168.4.1) -4\. Select the WiFi network that you would like your sensor to connect to or scroll to the bottom and type in your Wi-Fi network then click "**Save**". +4\. Select the Wi-Fi network that you would like your sensor to connect to or scroll to the bottom and type in your Wi-Fi network then click "**Save**". ![Apollo hotspot page at 192.168.4.1 with the SSID and Password fields and Save button highlighted](/assets/getting-started-pic-2.png) diff --git a/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md b/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md index c3970305b9..2edaa97c12 100755 --- a/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md +++ b/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md @@ -1,4 +1,4 @@ --- -description: "Tutorial to help fix the Ubiquiti Unifi mDNS Auto Discover Issue." +description: "Tutorial to help fix the Ubiquiti UniFi mDNS Auto Discover Issue." --- --8<-- "products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/tutorials/high-co2-notification-example.md b/docs/homey/products/general/tutorials/high-co2-notification-example.md index 4ae4f55223..9712409f3c 100755 --- a/docs/homey/products/general/tutorials/high-co2-notification-example.md +++ b/docs/homey/products/general/tutorials/high-co2-notification-example.md @@ -31,7 +31,7 @@ description: Example flow for sending alerts when CO₂ levels exceed a defined ![AIR-1 CO2 becomes greater than card set to 999 ppm in Homey](/assets/homey-flow-example-pic-7.png) -7\. Duplicate steps 4 and 5 above but this time select "CO2 becomes less than" and place it on your flow canvas.Make sure to fill in your less than ppm value such as 1000. +7\. Duplicate steps 4 and 5 above but this time select "CO2 becomes less than" and place it on your flow canvas. Make sure to fill in your less than ppm value such as 1000. ![Homey AIR-1 CO2 cards set to greater than 999 ppm and less than 1000 ppm](/assets/homey-flow-example-pic-5-1.png) @@ -39,7 +39,7 @@ description: Example flow for sending alerts when CO₂ levels exceed a defined ![Homey card search for set a color with the AIR-1 option highlighted](/assets/homey-flow-example-pic-6.png) -9\. Draw a line to connect "CO2 becomes greater than 999 ppm. Click the 3 dots and select a color - we have chosen red to indicate a problem. +9\. Draw a line to connect "CO2 becomes greater than 999 ppm". Click the 3 dots and select a color - we have chosen red to indicate a problem. ![Homey CO2 greater than 999 ppm card connected to an AIR-1 Set a color card set to red](/assets/homey-flow-example-pic-8.png) diff --git a/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md b/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md index 11cc148f3d..6f85e42a2a 100755 --- a/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md @@ -1,6 +1,6 @@ --- -title: Add the rear female usb-c port to your MSR-2 -description: Tutorial on adding the rear female usb-c port to your MSR-2. +title: Add the rear female USB-C port to your MSR-2 +description: Tutorial on adding the rear female USB-C port to your MSR-2. --- # Adding Articulating Stand To MSR-2 diff --git a/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md b/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md index d3f5f354db..b5cc63f3ac 100755 --- a/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md @@ -1,5 +1,5 @@ --- -description: "Tutorial on adding the rear female usb-c port to your MSR-2." +description: "Tutorial on adding the rear female USB-C port to your MSR-2." --- # Adding Rear Female USB-C To MSR-2 diff --git a/docs/homey/products/msr2/addons/msr2-outlet-mount.md b/docs/homey/products/msr2/addons/msr2-outlet-mount.md index 4f4b5ae51b..c755968409 100755 --- a/docs/homey/products/msr2/addons/msr2-outlet-mount.md +++ b/docs/homey/products/msr2/addons/msr2-outlet-mount.md @@ -4,7 +4,7 @@ description: Tutorial for using the MSR-2 Outlet Mount. --- # MSR-2 Outlet Mount -1\. Gather a top facing usb-c plug, an MSR-2, and our MSR-2 Outlet Mount. +1\. Gather a top facing USB-C plug, an MSR-2, and our MSR-2 Outlet Mount. ![USB-C wall plug, L-shaped MSR-2 Outlet Mount, and MSR-2 laid out on a table](/assets/msr-2-outlet-mount-pic-1.jpg) @@ -12,7 +12,7 @@ description: Tutorial for using the MSR-2 Outlet Mount. ![MSR-2 Outlet Mount lined up with the MSR-2 USB-C port facing left](/assets/msr-2-outlet-mount-pic-2.jpg) -3\. Push the MSR-2 Outlet Mount into the usb-c port until it's fully seated. Do not push hard, it will go in very smoothly. +3\. Push the MSR-2 Outlet Mount into the USB-C port until it's fully seated. Do not push hard, it will go in very smoothly. ![MSR-2 Outlet Mount fully seated in the MSR-2 USB-C port](/assets/msr-2-outlet-mount-pic-3.jpg) diff --git a/docs/homey/products/msr2/examples/msr2-alarmo.md b/docs/homey/products/msr2/examples/msr2-alarmo.md index 21806af6b8..6db6a604ed 100755 --- a/docs/homey/products/msr2/examples/msr2-alarmo.md +++ b/docs/homey/products/msr2/examples/msr2-alarmo.md @@ -1,5 +1,5 @@ --- -description: "A tutorial for how To use the MSR-2 with Alarmo for an advanced DIY alarm system." +description: "A tutorial for how to use the MSR-2 with Alarmo for an advanced DIY alarm system." --- # MSR-2 + Alarmo Home Security Install @@ -24,7 +24,7 @@ My grandmother wanted a security system that would alert her when there was move ![Alarmo notification Title, Message, and Name fields filled in for a movement alert](/assets/alarmo-4.png) -6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Uner Entity select your sensors RGB light. +6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Under Entity select your sensors RGB light. ![Alarmo action setup for Alarm is triggered with AIR-1 and MSR-1 RGB light entities selected](/assets/alarmo-5.png) diff --git a/docs/homey/products/msr2/examples/msr2-dashboards.md b/docs/homey/products/msr2/examples/msr2-dashboards.md index ecf56115fd..60362ec128 100755 --- a/docs/homey/products/msr2/examples/msr2-dashboards.md +++ b/docs/homey/products/msr2/examples/msr2-dashboards.md @@ -70,7 +70,7 @@ refresh_interval: 10 title: Bedroom CO2 ``` -Home Assistant Guage +Home Assistant Gauge ![Home Assistant gauge card showing MSR-1 CO2 at 1,063 ppm with green, yellow, and red ranges](/assets/co2-guage.png) diff --git a/docs/homey/products/msr2/examples/using-msr-2-buzzer.md b/docs/homey/products/msr2/examples/using-msr-2-buzzer.md index c95afbb076..16cc491ad1 100755 --- a/docs/homey/products/msr2/examples/using-msr-2-buzzer.md +++ b/docs/homey/products/msr2/examples/using-msr-2-buzzer.md @@ -13,7 +13,7 @@ This guide will walk you through using the buzzer on your MSR-2. You can also us 3\. Choose your MSR-2's buzzer (You can type in buzzer to find it easier) -4\. Put a rtttl tone into the the string box +4\. Put an rtttl tone into the string box - - Mario: ``` smb:d=4,o=5,b=100:16e6,16e6,32p,8e6,16c6,8e6,8g6,8p,8g,8p,8c6,16p,8g,16p,8e,16p,8a,8b,16a#,8a,16g.,16e6,16g6,8a6,16f6,8g6,8e6,16c6,16d6,8b,16p,8c6,16p,8g,16p,8e,16p,8a,8b,16a#,8a,16g.,16e6,16g6,8a6,16f6,8g6,8e6,16c6,16d6,8b,8p,16g6,16f#6,16f6,16d#6,16p,16e6,16p,16g#,16a,16c6,16p,16a,16c6,16d6,8p,16g6,16f#6,16f6,16d#6,16p,16e6,16p,16c7,16p,16c7,16c7,p,16g6,16f#6,16f6,16d#6,16p,16e6,16p,16g#,16a,16c6,16p,16a,16c6,16d6,8p,16d#6,8p,16d6,8p,16c6 @@ -25,7 +25,7 @@ This guide will walk you through using the buzzer on your MSR-2. You can also us StarWars/Imp:d=4,o=5,b=112:8d.,16p,8d.,16p,8d.,16p,8a#4,16p,16f,8d.,16p,8a#4,16p,16f,d.,8p,8a.,16p,8a.,16p,8a.,16p,8a#,16p,16f,8c#.,16p,8a#4,16p,16f,d.,8p,8d.6,16p,8d,16p,16d,8d6,8p,8c#6,16p,16c6,16b,16a#,8b,8p,16d#,16p,8g#,8p,8g,16p,16f#,16f,16e,8f,8p,16a#4,16p,2c# ``` - Huge list: [https://picaxe.com/rtttl-ringtones-for-tune-command/](https://picaxe.com/rtttl-ringtones-for-tune-command/) - - This is a good site to test rttl tones: [https://adamonsoon.github.io/rtttl-play/](https://adamonsoon.github.io/rtttl-play/) + - This is a good site to test rtttl tones: [https://adamonsoon.github.io/rtttl-play/](https://adamonsoon.github.io/rtttl-play/) 5\. Click on the ACTIONS button in bottom right diff --git a/docs/homey/products/msr2/faq.md b/docs/homey/products/msr2/faq.md index c0bca19eaf..10c5898420 100755 --- a/docs/homey/products/msr2/faq.md +++ b/docs/homey/products/msr2/faq.md @@ -27,7 +27,7 @@ description: "Frequently asked questions about the MSR-2 mmWave sensor." 7\. **How do I connect the MSR-2 to Home Assistant?** -* The MSR-2 connects to your Home Assistant instance through ESPHome using WiFi. Once connected, you can monitor data from all the sensors and set up automations. +* The MSR-2 connects to your Home Assistant instance through ESPHome using Wi-Fi. Once connected, you can monitor data from all the sensors and set up automations. 8\. **What kind of automations can I create with the MSR-2?** @@ -67,7 +67,7 @@ description: "Frequently asked questions about the MSR-2 mmWave sensor." 17\. **Can I customize the MSR-2 functionality?** -* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the MSR-2. Our YAML is on Github and our .STEP and .STL CAD files are available for community use. +* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the MSR-2. Our YAML is on GitHub and our .STEP and .STL CAD files are available for community use. 18\. **How often does the MSR-2 report sensor data?** @@ -91,7 +91,7 @@ description: "Frequently asked questions about the MSR-2 mmWave sensor." 23\. **How do I install and configure the MSR-2?** -* Installation is straightforward, with the MSR-2 powered via USB-C and connecting to Home Assistant through WiFi. Configuration is done in ESPHome, where you can set sensor parameters, adjust automations, and more. We provide detailed documentation and support through our Discord community and GitHub. +* Installation is straightforward, with the MSR-2 powered via USB-C and connecting to Home Assistant through Wi-Fi. Configuration is done in ESPHome, where you can set sensor parameters, adjust automations, and more. We provide detailed documentation and support through our Discord community and GitHub. 24\. **What makes the MSR-2 stand out from other motion sensors?** diff --git a/docs/homey/products/msr2/msr2-reviews.md b/docs/homey/products/msr2/msr2-reviews.md index 484ee0b59d..78bb4b3e55 100755 --- a/docs/homey/products/msr2/msr2-reviews.md +++ b/docs/homey/products/msr2/msr2-reviews.md @@ -1,5 +1,5 @@ --- -description: "Youtuber reviews and feedback about the MSR-2 sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the MSR-2 sensor from Apollo Automation." --- # [Simon Says Home Assistant MSR-2 Review](https://www.youtube.com/watch?v=U4qUhFSAxbk) diff --git a/docs/homey/products/msr2/setup/mmwave-videos.md b/docs/homey/products/msr2/setup/mmwave-videos.md index 3945ce2d59..b651f38e90 100644 --- a/docs/homey/products/msr2/setup/mmwave-videos.md +++ b/docs/homey/products/msr2/setup/mmwave-videos.md @@ -1,4 +1,4 @@ --- -description: "Two short videos and a quick sumamry on how to best tune the LD2410B in the MSR-2!" +description: "Two short videos and a quick summary on how to best tune the LD2410B in the MSR-2!" --- --8<-- "homey/products/general/calibrating-and-updating/mmwave-videos.md" diff --git a/docs/homey/products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md b/docs/homey/products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md index 390cb4a67a..660955f1b5 100755 --- a/docs/homey/products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md +++ b/docs/homey/products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md @@ -16,7 +16,7 @@ description: Step by step tutorial for adding 90 degree USB-C to MTR-1. ![MTR-1 with the 90 degree addon lined up with a USB-C port on the wall plug](/assets/mtr-1-90-addon-pic-3.jpg) -4\. Gently push the connector into one of the top usb-c ports. +4\. Gently push the connector into one of the top USB-C ports. ![90 degree addon plugged into a USB-C port on the wall plug, with the MTR-1 attached](/assets/mtr-1-90-addon-pic-4.jpg) diff --git a/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md b/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md index 61e938d299..dfcdab55bb 100755 --- a/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md +++ b/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md @@ -70,7 +70,7 @@ refresh_interval: 10 title: Bedroom CO2 ``` -Home Assistant Guage +Home Assistant Gauge ![Home Assistant gauge card reading 1,063 ppm CO2 with green, yellow, and red severity bands](/assets/co2-guage.png) diff --git a/docs/homey/products/mtr1/examples/mtr1-alarmo.md b/docs/homey/products/mtr1/examples/mtr1-alarmo.md index 21b498137c..7dfdb31866 100755 --- a/docs/homey/products/mtr1/examples/mtr1-alarmo.md +++ b/docs/homey/products/mtr1/examples/mtr1-alarmo.md @@ -24,7 +24,7 @@ My grandmother wanted a security system that would alert her when there was move ![Alarmo notification Title, Message, and Name fields filled in for the alarm alert](/assets/alarmo-4.png) -6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Uner Entity select your sensors RGB light. +6\. After saving that action we can add another one that will turn on our sensor lights and/or make the onboard piezo buzzers play an alarm sound. Under Entity select your sensors RGB light. ![Alarmo action for Alarm is triggered with Apollo sensor RGB light entities selected](/assets/alarmo-5.png) diff --git a/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md b/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md index 8b36c5f29e..1ce165353a 100755 --- a/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md +++ b/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md @@ -13,7 +13,7 @@ This guide will walk you through using the buzzer on your MTR-1. You can also us 3\. Choose your MTR-1's buzzer (You can type in buzzer to find it easier) -4\. Put a rtttl tone into the the string box +4\. Put an rtttl tone into the string box - - Mario: ``` smb:d=4,o=5,b=100:16e6,16e6,32p,8e6,16c6,8e6,8g6,8p,8g,8p,8c6,16p,8g,16p,8e,16p,8a,8b,16a#,8a,16g.,16e6,16g6,8a6,16f6,8g6,8e6,16c6,16d6,8b,16p,8c6,16p,8g,16p,8e,16p,8a,8b,16a#,8a,16g.,16e6,16g6,8a6,16f6,8g6,8e6,16c6,16d6,8b,8p,16g6,16f#6,16f6,16d#6,16p,16e6,16p,16g#,16a,16c6,16p,16a,16c6,16d6,8p,16g6,16f#6,16f6,16d#6,16p,16e6,16p,16c7,16p,16c7,16c7,p,16g6,16f#6,16f6,16d#6,16p,16e6,16p,16g#,16a,16c6,16p,16a,16c6,16d6,8p,16d#6,8p,16d6,8p,16c6 @@ -25,7 +25,7 @@ This guide will walk you through using the buzzer on your MTR-1. You can also us StarWars/Imp:d=4,o=5,b=112:8d.,16p,8d.,16p,8d.,16p,8a#4,16p,16f,8d.,16p,8a#4,16p,16f,d.,8p,8a.,16p,8a.,16p,8a.,16p,8a#,16p,16f,8c#.,16p,8a#4,16p,16f,d.,8p,8d.6,16p,8d,16p,16d,8d6,8p,8c#6,16p,16c6,16b,16a#,8b,8p,16d#,16p,8g#,8p,8g,16p,16f#,16f,16e,8f,8p,16a#4,16p,2c# ``` - Huge list: [https://picaxe.com/rtttl-ringtones-for-tune-command/](https://picaxe.com/rtttl-ringtones-for-tune-command/) - - This is a good site to test rttl tones: [https://adamonsoon.github.io/rtttl-play/](https://adamonsoon.github.io/rtttl-play/) + - This is a good site to test rtttl tones: [https://adamonsoon.github.io/rtttl-play/](https://adamonsoon.github.io/rtttl-play/) 5\. Click on the ACTIONS button in bottom right diff --git a/docs/homey/products/mtr1/faq.md b/docs/homey/products/mtr1/faq.md index 82560cb9b4..0ab8bced99 100755 --- a/docs/homey/products/mtr1/faq.md +++ b/docs/homey/products/mtr1/faq.md @@ -35,7 +35,7 @@ description: "Frequently asked questions about the MTR-1 mmWave sensor." 9\. **How do I connect the MTR-1 to Home Assistant?** -* The MTR-1 connects to Home Assistant through ESPHome using WiFi. Once connected, you can access data from all the sensors and create automations based on the sensor readings. +* The MTR-1 connects to Home Assistant through ESPHome using Wi-Fi. Once connected, you can access data from all the sensors and create automations based on the sensor readings. 10\. **What kind of automations can I set up with the MTR-1?** @@ -95,7 +95,7 @@ description: "Frequently asked questions about the MTR-1 mmWave sensor." 24\. **How do I install the MTR-1?** -* Installation is simple. The MTR-1 is powered via USB-C and connects to your WiFi. From there, you configure it through ESPHome and integrate it into your Home Assistant setup. Detailed instructions are available on our documentation wiki, and we offer support via our Discord community. +* Installation is simple. The MTR-1 is powered via USB-C and connects to your Wi-Fi. From there, you configure it through ESPHome and integrate it into your Home Assistant setup. Detailed instructions are available on our documentation wiki, and we offer support via our Discord community. 25\. **How secure is the MTR-1?** diff --git a/docs/homey/products/mtr1/mtr1-reviews.md b/docs/homey/products/mtr1/mtr1-reviews.md index 18bd5105ed..0dbe31e433 100755 --- a/docs/homey/products/mtr1/mtr1-reviews.md +++ b/docs/homey/products/mtr1/mtr1-reviews.md @@ -1,5 +1,5 @@ --- -description: "Youtuber reviews and feedback about the MTR-1 sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the MTR-1 sensor from Apollo Automation." --- # [Home Tech Innovations MTR-1 Review](https://youtu.be/q5GejbxnByA?si=PMgK4ro6U8Q7idCm) diff --git a/docs/homey/products/mtr1/setup/general-tips.md b/docs/homey/products/mtr1/setup/general-tips.md index 838cad3f4d..7c6b61eb27 100755 --- a/docs/homey/products/mtr1/setup/general-tips.md +++ b/docs/homey/products/mtr1/setup/general-tips.md @@ -32,11 +32,11 @@ The detection is 60 degrees from center on each side. So it is a cone when you a ##### **Increased ESP Temperature** -If you are experiencing higher than normal ESP temperatures ~140+ degrees F then changing the wifi power save mode option might help decrease the temperature. Here is the link to the ESPHome WiFi Component [Power Save Mode](https://esphome.io/components/wifi.html#power-save-mode). +If you are experiencing higher than normal ESP temperatures ~140+ degrees F then changing the Wi-Fi power save mode option might help decrease the temperature. Here is the link to the ESPHome WiFi Component [Power Save Mode](https://esphome.io/components/wifi.html#power-save-mode). ##### **Improve Wi-Fi Connection** -The Wi-Fi interface of all ESP32 devices offer three power save modes to reduce the amount of power spent on Wi-Fi. While some options can reduce the power usage of the ESP, they generally also decrease the reliability of the Wi-Fi connection, with frequent disconnections from the router in the highest power saving mode. Switch to "none" to get the best Wi-Fi performance! +The Wi-Fi interface of all ESP32 devices offers three power save modes to reduce the amount of power spent on Wi-Fi. While some options can reduce the power usage of the ESP, they generally also decrease the reliability of the Wi-Fi connection, with frequent disconnections from the router in the highest power saving mode. Switch to "none" to get the best Wi-Fi performance! ```yaml wifi: diff --git a/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md b/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md index b55056f859..458d8ea29f 100755 --- a/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md +++ b/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md @@ -5,7 +5,7 @@ description: "Add temperature and humidity offsets to your MTR-1 so its readings #### **Simple Offsets for Temperature and Humidity:** -**Please add these to the bottom of your esphome yaml for your device then click save and install. Once you are finished, you will have two new boxes inside the home assistant esphome integration device page for your device where you can fill in an offset. Give them up to 1minute to take effect!** +**Please add these to the bottom of your ESPHome yaml for your device then click save and install. Once you are finished, you will have two new boxes inside the Home Assistant ESPHome integration device page for your device where you can fill in an offset. Give them up to 1minute to take effect!** ```yaml sensor: @@ -54,11 +54,11 @@ The DPS310 and SCD40 sensors are known for their precision in measuring temperat #### **Adjusting the DPS310 and SCD40 Temperature Offset** -For users who want to fine-tune their sensors, the DPS310 and SCD40 Temperature Offset entities can be manually adjusted to match the conditions in their home. The offset values are subtracted from the raw temperature & humidity readings in the firmware to update the sensor readings in the home assistant entity. For example: scd40\_temperature entity = raw scd40 temperature reading - scd40\_offset. +For users who want to fine-tune their sensors, the DPS310 and SCD40 Temperature Offset entities can be manually adjusted to match the conditions in their home. The offset values are subtracted from the raw temperature & humidity readings in the firmware to update the sensor readings in the Home Assistant entity. For example: scd40\_temperature entity = raw scd40 temperature reading - scd40\_offset. By default, these offsets are preset to values based on our NIST certified thermometer, it's important to note that these values are calibrated for our environment. They might not be accurate for all settings. Therefore, by using a reference thermometer, users can adjust the difference between the readings to get a more accurate representation. -Users will also notice the `dps310_temperature_calibrated`, `scd40_humidity_calibrated`, and `scd40_temperature_calibrated`entities. These values utilize the linear filter in the ESPHome firmware to adjust the readings based on our collected data. Again, due to environmental differences, these might not always be precise. +Users will also notice the `dps310_temperature_calibrated`, `scd40_humidity_calibrated`, and `scd40_temperature_calibrated` entities. These values utilize the linear filter in the ESPHome firmware to adjust the readings based on our collected data. Again, due to environmental differences, these might not always be precise. #### **Modeling the Relationship Between Sensors** diff --git a/docs/homey/products/mtr1/setup/zones-hlk.md b/docs/homey/products/mtr1/setup/zones-hlk.md index 9512e007ae..14ba096709 100755 --- a/docs/homey/products/mtr1/setup/zones-hlk.md +++ b/docs/homey/products/mtr1/setup/zones-hlk.md @@ -26,7 +26,7 @@ The YAML is on Github and our .STEP and .STL CAD files are available for community use. +* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the PLT-1B. Our YAML is on GitHub and our .STEP and .STL CAD files are available for community use. 11\. **What are the RGB LED and piezo buzzer used for?** diff --git a/docs/homey/products/plt1/reviews.md b/docs/homey/products/plt1/reviews.md index 15427b6d8b..57c6dcd7c3 100755 --- a/docs/homey/products/plt1/reviews.md +++ b/docs/homey/products/plt1/reviews.md @@ -1,5 +1,5 @@ --- -description: "Youtuber reviews and feedback about the PLT-1 sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the PLT-1 sensor from Apollo Automation." --- # [Simon Says Home Assistant PLT-1 Review](https://youtu.be/hocliw98_Gk?si=8TMFLD7xiYah1RmJ) diff --git a/docs/homey/products/plt1/setup/prevent-sleep.md b/docs/homey/products/plt1/setup/prevent-sleep.md index 7c97d5bd9a..209c26014c 100755 --- a/docs/homey/products/plt1/setup/prevent-sleep.md +++ b/docs/homey/products/plt1/setup/prevent-sleep.md @@ -5,7 +5,7 @@ description: "Tutorial for how to enable/disable prevent sleep." !!! tip "Put your sensors to sleep!" - All of our battery powered device are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. + All of our battery powered devices are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. The temperature offsets needed will be much lower for your sensors as the microcontroller will not put off as much heat when it is sleeping and then waking for short periods to report the sensor values. diff --git a/docs/homey/products/plt1/troubleshooting/plt1-code.md b/docs/homey/products/plt1/troubleshooting/plt1-code.md index f0ddbe66b1..03c65cad4d 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-code.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-code.md @@ -39,4 +39,4 @@ If your device has already been connected to Home Assistant please proceed to the getting started guide and setup your sensor as a new device! \ No newline at end of file +8\. Please proceed to the getting started guide and set up your sensor as a new device! \ No newline at end of file diff --git a/docs/homey/products/plt1b/faq.md b/docs/homey/products/plt1b/faq.md index 1eebfb8c94..352cba525b 100755 --- a/docs/homey/products/plt1b/faq.md +++ b/docs/homey/products/plt1b/faq.md @@ -31,7 +31,7 @@ description: "PLT-1B FAQ." 8\. **How does the PLT-1B connect to Home Assistant?** -* The PLT-1B connects via WiFi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. +* The PLT-1B connects via Wi-Fi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. 9\. **What kind of automations can I set up with the PLT-1B?** @@ -43,7 +43,7 @@ description: "PLT-1B FAQ." 11\. **Can I customize the PLT-1B functionality?** -* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the PLT-1B. Our YAML is on Github and our .STEP and .STL CAD files are available for community use. +* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the PLT-1B. Our YAML is on GitHub and our .STEP and .STL CAD files are available for community use. 12\. **What are the RGB LED and piezo buzzer used for?** @@ -79,7 +79,7 @@ description: "PLT-1B FAQ." 20\. **What’s the difference between the battery and non-battery versions?** -* The PLT-1B is battery-operated (18650) and slightly larger, while the non-battery (NB) version is compact and requires USB-C power at 5 volts using 1amp or less (5W). They both have all of the same components for measuring soil moisture, air temp/humdity, lux/uv, etc. +* The PLT-1B is battery-operated (18650) and slightly larger, while the non-battery (NB) version is compact and requires USB-C power at 5 volts using 1amp or less (5W). They both have all of the same components for measuring soil moisture, air temp/humidity, lux/uv, etc. 21\. **Can I use multiple PLT-1B sensors in one Home Assistant setup?** diff --git a/docs/homey/products/plt1b/reviews.md b/docs/homey/products/plt1b/reviews.md index 292c73f7fd..4b084d6c3d 100644 --- a/docs/homey/products/plt1b/reviews.md +++ b/docs/homey/products/plt1b/reviews.md @@ -1,4 +1,4 @@ --- -description: "Youtuber reviews and feedback about the PLT-1 sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the PLT-1 sensor from Apollo Automation." --- --8<-- "homey/products/plt1/reviews.md" diff --git a/docs/homey/products/plt1b/setup/prevent-sleep.md b/docs/homey/products/plt1b/setup/prevent-sleep.md index c313b857d5..40b0e78488 100755 --- a/docs/homey/products/plt1b/setup/prevent-sleep.md +++ b/docs/homey/products/plt1b/setup/prevent-sleep.md @@ -5,7 +5,7 @@ description: "Keep the PLT-1B awake instead of letting it sleep, and what that c !!! tip "Put your sensors to sleep!" - All of our battery powered device are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. + All of our battery powered devices are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. The temperature offsets needed will be much lower for your sensors as the microcontroller will not put off as much heat when it is sleeping and then waking for short periods to report the sensor values. diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-code.md b/docs/homey/products/plt1b/troubleshooting/plt1b-code.md index 0c2ea18589..37e0ad4420 100755 --- a/docs/homey/products/plt1b/troubleshooting/plt1b-code.md +++ b/docs/homey/products/plt1b/troubleshooting/plt1b-code.md @@ -29,7 +29,7 @@ If no device shows, click cancel and then install the recommended driver that sh Your device is still in boot mode and needs to be power cycled aka power removed to make it boot in a normal mode! -6\. Please proceed to the getting started guide and setup your sensor as a new device! +6\. Please proceed to the getting started guide and set up your sensor as a new device! # Factory Re-Flash PLT-1B @@ -73,4 +73,4 @@ If your device has already been connected to Home Assistant please proceed to the getting started guide and setup your sensor as a new device! \ No newline at end of file +8\. Please proceed to the getting started guide and set up your sensor as a new device! \ No newline at end of file diff --git a/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md b/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md index 7a7ed100d4..0697268a78 100644 --- a/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md +++ b/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md @@ -1,4 +1,4 @@ --- -description: "Tutorial on adding the LD2412 mmwave sensor to your R PRO-1" +description: "Tutorial on adding the LD2412 mmWave sensor to your R PRO-1" --- --8<-- "products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md:5:" diff --git a/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md b/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md index 24b490d1ba..ec2d6812f1 100644 --- a/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md +++ b/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md @@ -1,4 +1,4 @@ --- -description: "Tutorial on adding the SCD40 CO2 sensor to your R-Pro-1." +description: "Tutorial on adding the SCD40 CO2 sensor to your R PRO-1." --- --8<-- "products/rpro1/addons/adding-co2-to-r-pro-1.md:5:" diff --git a/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md b/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md index 46d4d3dfa3..bb31a9f7f8 100644 --- a/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md +++ b/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md @@ -1,4 +1,4 @@ --- -description: "Tutorial on adding the gang box mounts to your R-Pro-1." +description: "Tutorial on adding the gang box mounts to your R PRO-1." --- --8<-- "products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md:5:" diff --git a/docs/homey/products/rpro1/faq.md b/docs/homey/products/rpro1/faq.md index 861272d0aa..ac0890cccd 100644 --- a/docs/homey/products/rpro1/faq.md +++ b/docs/homey/products/rpro1/faq.md @@ -1,4 +1,4 @@ --- -description: "Frequently asked questions about the R-Pro-1 PoE mmWave sensor." +description: "Frequently asked questions about the R PRO-1 PoE mmWave sensor." --- --8<-- "products/rpro1/faq.md:5:" diff --git a/docs/homey/products/rpro1/introduction.md b/docs/homey/products/rpro1/introduction.md index ff1a64064e..3691e5a466 100644 --- a/docs/homey/products/rpro1/introduction.md +++ b/docs/homey/products/rpro1/introduction.md @@ -1,4 +1,4 @@ --- -description: "Documentation for R-Pro-1, including setup, usage, and best practices." +description: "Documentation for R PRO-1, including setup, usage, and best practices." --- --8<-- "products/rpro1/introduction.md:5:" diff --git a/docs/homey/products/rpro1/rpro1-reviews.md b/docs/homey/products/rpro1/rpro1-reviews.md index 0bb99c88c6..fbc0fb7165 100644 --- a/docs/homey/products/rpro1/rpro1-reviews.md +++ b/docs/homey/products/rpro1/rpro1-reviews.md @@ -1,4 +1,4 @@ --- -description: "Youtuber reviews and feedback about the R-Pro-1 sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the R PRO-1 sensor from Apollo Automation." --- --8<-- "products/rpro1/rpro1-reviews.md:5:" diff --git a/docs/homey/products/rpro1/setup/zones-hlk.md b/docs/homey/products/rpro1/setup/zones-hlk.md index b1c90dce45..0eea7225fd 100644 --- a/docs/homey/products/rpro1/setup/zones-hlk.md +++ b/docs/homey/products/rpro1/setup/zones-hlk.md @@ -1,5 +1,5 @@ --- -description: "Tutorial for R-Pro-1 HLKRadarTool app Zone Configuration." +description: "Tutorial for R PRO-1 HLKRadarTool app Zone Configuration." --- # How To Tune mmWave Using HLKRadarTool @@ -41,7 +41,7 @@ The **Disabled**: Disable multi-zone area detection and just tracks one big area.
**Detection**: Only detects targets within each of the three zones.
**Filter**: Excludes a zone from detection and detects presence everywhere else. + You can use any of these three choices to control your R PRO-1 differently. The most common option is "Detection" which lets you set up three areas and track three targets within them.
**Disabled**: Disables multi-zone area detection and just tracks one big area.
**Detection**: Only detects targets within each of the three zones.
**Filter**: Excludes a zone from detection and detects presence everywhere else. Disabled allows you to just use the sensor as a "basic" presence sensor and "Filter" lets you filter out an area and detect everything else, which is useful to avoid a fan! diff --git a/docs/homey/products/temp1/addons/magnetic-mount.md b/docs/homey/products/temp1/addons/magnetic-mount.md index 9de17e541a..752d9c0f01 100755 --- a/docs/homey/products/temp1/addons/magnetic-mount.md +++ b/docs/homey/products/temp1/addons/magnetic-mount.md @@ -21,7 +21,7 @@ The TEMP-1 comes with an optional magnetic mount which can be used to secure the ![TEMP-1 sitting flush in the magnetic mount, viewed from the end](/assets/temp1-magnetic-mount-installed-pic-3.jpg) -4\. Affix your TEMP-1 to the outside of fridge or a safe cool place on the grill. +4\. Affix your TEMP-1 to the outside of a fridge or a safe cool place on the grill. ![TEMP-1 in the magnetic mount attached to the outside of a fridge door](/assets/temp1-magnetic-mount-safe-fridge-mounting.jpg) diff --git a/docs/homey/products/temp1/examples/temp1-alert-example.md b/docs/homey/products/temp1/examples/temp1-alert-example.md index 00c46636b4..7b210a1178 100755 --- a/docs/homey/products/temp1/examples/temp1-alert-example.md +++ b/docs/homey/products/temp1/examples/temp1-alert-example.md @@ -5,11 +5,11 @@ description: "Step by step guide for alerting outside the set range with the TEM ###### -This will guide you through how to setup the built in alarm using the temperature probe in your freezer! +This will guide you through how to set up the built in alarm using the temperature probe in your freezer! 1\. Place the temperature probe into your freezer (not the entire TEMP-1, just the probe!) and then wait for it to normalize around 0 degrees F aka -18C. -2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30F so I would want to go slightly above that range. However,
in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. my minimums are around -20F. +2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30F so I would want to go slightly above that range. However, in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. My minimums are around -20F. ![Home Assistant history graph of the TEMP-1 temperature probe, with arrows marking the highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) @@ -17,6 +17,6 @@ This will guide you through how to setup the built in alarm using the temperatur ![TEMP-1 Max Probe Temp set to 2.0 and Min Probe Temp set to -30.0 degrees Celsius](/assets/temp-1-temp-probe-ex-automation-pic-2.png) -4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1 will play an audible alert with it's buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off +4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1 will play an audible alert with its buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off ![TEMP-1 Controls card with the Alarm Outside Temp Range toggle being switched on](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file diff --git a/docs/homey/products/temp1/examples/temp1-automation-examples.md b/docs/homey/products/temp1/examples/temp1-automation-examples.md index 0d61f133a9..10c24c297a 100755 --- a/docs/homey/products/temp1/examples/temp1-automation-examples.md +++ b/docs/homey/products/temp1/examples/temp1-automation-examples.md @@ -5,11 +5,11 @@ description: "Multiple automation examples with the TEMP-1." ###### Freezer Temperature Probe Example -This will guide you through how to setup an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. +This will guide you through how to set up an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. 1\. Place the temperature probe into your freezer and then wait for it to normalize around 0°F (-18°C). Make sure your TEMP-1 is in a cool dry place - only the temp probe and wire can withstand the temperatures in the fridge, freezer, etc. -2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. my minimums are around -20°F. +2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. My minimums are around -20°F. ![Home Assistant history graph of the TEMP-1 temperature probe, with arrows marking the highs and lows](/assets/temp-1-temp-probe-ex-automation-pic-1.png) @@ -21,11 +21,11 @@ This will guide you through how to setup an automation in Home Assistant using t 5\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left then "create new automation". Click here to go straight there! -6\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you found in step 2 above. Advanced users skip to step 10. +6\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you found in step 2 above. Advanced users skip to step 10. ![Numeric state trigger on Apollo TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png) -7\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. +7\. Click Add Action then type in "iPhone" and select your phone. If you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. ![Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) @@ -67,7 +67,7 @@ mode: single ###### Food Probe Example -This will guide you through how to setup an automation in Home Assistant using the food probe with Chicken(or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. +This will guide you through how to set up an automation in Home Assistant using the food probe with Chicken(or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. 1\. Set your Max Probe Temp to 73.9°C. The offsets MUST be in Celsius even if you are using F in the automation below. @@ -77,11 +77,11 @@ This will guide you through how to setup an automation in Home Assistant using t 3\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left. Click here to go straight there! -4\. Click Add Trigger then Entity then Numeric state and search for your temp-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. +4\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1 device such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. ![Numeric state trigger with the Apollo TEMP-1 Max Probe Temp entity and Above value of 165 highlighted](/assets/temp-1-food-probe-ex-automation-pic-3.png) -5\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. +5\. Click Add Action then type in "iPhone" and select your phone. If you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. ![Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) @@ -146,7 +146,7 @@ This will guide you through adding a button to your dashboard called "Chicken Mo ![State trigger with Trigger ID Chicken Monitor Off and To set to Off, both highlighted](/assets/temp-1-cook-chicken-example-pic-21.png) -7\. Click Add Trigger then Entity then Numeric state and search for your temp-1 food probe entity such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 160°F(71.1C) because the Chicken will rest and reach 165°F once removed from the oven/grill. +7\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1 food probe entity such as "temp-1 max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 160°F(71.1C) because the Chicken will rest and reach 165°F once removed from the oven/grill. ![Numeric state trigger for when Apollo TEMP-1 Food Probe is above 160](/assets/temp-1-cook-chicken-example-pic-7.png) @@ -214,7 +214,7 @@ This will guide you through adding a button to your dashboard called "Chicken Mo ![Repeat until block with the correct Add Action button highlighted under its Actions](/assets/temp-1-cook-chicken-example-pic-27.png) -24\. Search "light toggle" in the search bar shown then select "Choose entity" and select your the rgb led for your device +24\. Search "light toggle" in the search bar shown then select "Choose entity" and select the rgb led for your device ![Add action dialog searching light toggle, with Light: Toggle listed](/assets/temp-1-cook-chicken-example-pic-28.png) @@ -222,7 +222,7 @@ This will guide you through adding a button to your dashboard called "Chicken Mo ![Notification action under Option 2 titled Time to check the Chicken, with a 160F message](/assets/temp-1-cook-chicken-example-pic-29.png) -26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already setup. +26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already set up. ![Add action dialog searching tts, with Text-to-speech (TTS): Speak listed first](/assets/temp-1-cook-chicken-example-pic-30.png)![TTS Speak action on piper targeting Homepods with the message The Chicken is almost ready](/assets/temp-1-cook-chicken-example-pic-31.png) @@ -244,4 +244,4 @@ This will guide you through adding a button to your dashboard called "Chicken Mo ![Save dialog for the TEMP-1 Chicken Automation with Save being clicked](/assets/temp-1-cook-chicken-example-pic-34.png) -32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to discord user RalphP for this example! \ No newline at end of file +32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to Discord user RalphP for this example! \ No newline at end of file diff --git a/docs/homey/products/temp1/faq.md b/docs/homey/products/temp1/faq.md index cd65645c89..4e8d6a0cc9 100755 --- a/docs/homey/products/temp1/faq.md +++ b/docs/homey/products/temp1/faq.md @@ -21,7 +21,7 @@ Sensor Interface: Equipped with a 3.5mm jack for connecting optional external te 4\. **How does the TEMP-1 connect to Home Assistant?** -* The TEMP-1 connects via WiFi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. +* The TEMP-1 connects via Wi-Fi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. 5\. **How often does the TEMP-1 send sensor data?** @@ -29,7 +29,7 @@ Sensor Interface: Equipped with a 3.5mm jack for connecting optional external te 6\. **Can I customize the TEMP-1 functionality?** -* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the TEMP-1. Our YAML is on Github and our .STEP and .STL CAD files are available for community use. +* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the TEMP-1. Our YAML is on GitHub and our .STEP and .STL CAD files are available for community use. 7\. **What are the RGB LED and piezo buzzer used for?** diff --git a/docs/homey/products/temp1/reviews.md b/docs/homey/products/temp1/reviews.md index b6407266cb..1fdcabe333 100755 --- a/docs/homey/products/temp1/reviews.md +++ b/docs/homey/products/temp1/reviews.md @@ -1,5 +1,5 @@ --- -description: "Youtuber reviews and feedback about the TEMP-1 sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the TEMP-1 sensor from Apollo Automation." --- # [Simon Says Home Assistant](https://youtu.be/95etWGwEJPE?si=gdLCXFiWmuj2JUjD) diff --git a/docs/homey/products/temp1/setup/prevent-sleep.md b/docs/homey/products/temp1/setup/prevent-sleep.md index 05151144b8..d78b682d20 100755 --- a/docs/homey/products/temp1/setup/prevent-sleep.md +++ b/docs/homey/products/temp1/setup/prevent-sleep.md @@ -5,7 +5,7 @@ description: "Guide for setting up and using the prevent sleep toggle with the T !!! tip "Put your sensors to sleep!" - All of our battery powered device are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. + All of our battery powered devices are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. The temperature offsets needed will be much lower for your sensors as the microcontroller will not put off as much heat when it is sleeping and then waking for short periods to report the sensor values. diff --git a/docs/homey/products/temp1/troubleshooting/temp1-code.md b/docs/homey/products/temp1/troubleshooting/temp1-code.md index cc1847194c..fc6f61b086 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-code.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-code.md @@ -37,4 +37,4 @@ If your device has already been connected to Home Assistant please proceed to the getting started guide and setup your sensor as a new device! \ No newline at end of file +7\. Please proceed to the getting started guide and set up your sensor as a new device! \ No newline at end of file diff --git a/docs/homey/products/temp1/troubleshooting/temp1-teardown.md b/docs/homey/products/temp1/troubleshooting/temp1-teardown.md index 08df6e0463..4faa3ab9da 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-teardown.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-teardown.md @@ -19,7 +19,7 @@ description: "Step by step guide for tearing down your TEMP-1 to replace parts, ![TEMP-1 lid sliding onto the case, with the RGB LED visible in the bottom left corner](/assets/temp-1-align-lid.jpg) -4\. Make sure during reassembly that the RGB LED is in the bottom left as shown in image below then press on the lid as shown below until it snaps into place! +4\. Make sure during reassembly that the RGB LED is in the bottom left as shown in the image below then press on the lid as shown below until it snaps into place! ![Finger pressing the lid onto the TEMP-1 case until it snaps into place](/assets/temp-1-press-on-lid.jpg) diff --git a/docs/homey/products/temp1b/addons/magnetic-mount.md b/docs/homey/products/temp1b/addons/magnetic-mount.md index ca8a14a27e..3e70d04179 100755 --- a/docs/homey/products/temp1b/addons/magnetic-mount.md +++ b/docs/homey/products/temp1b/addons/magnetic-mount.md @@ -21,7 +21,7 @@ The TEMP-1B comes with an optional magnetic mount which can be used to secure th ![TEMP-1B standing on end with the magnetic mount sitting flush against the case](/assets/temp1b-magnetic-mount-installed-pic-3-1.jpg) -4\. Affix your TEMP-1B to the outside of fridge or a safe cool place on the grill. +4\. Affix your TEMP-1B to the outside of a fridge or a safe cool place on the grill. ![TEMP-1B in its magnetic mount attached to the outside of a fridge](/assets/temp1b-magnetic-mount-safe-outside-fridge-mounting.jpg) diff --git a/docs/homey/products/temp1b/examples/temp1b-alert-example.md b/docs/homey/products/temp1b/examples/temp1b-alert-example.md index ed40cafad0..2b143c7355 100755 --- a/docs/homey/products/temp1b/examples/temp1b-alert-example.md +++ b/docs/homey/products/temp1b/examples/temp1b-alert-example.md @@ -5,11 +5,11 @@ description: "Step by step guide for alerting outside the set range with the TEM ###### -This will guide you through how to setup the built in alarm using the temperature probe in your freezer! +This will guide you through how to set up the built in alarm using the temperature probe in your freezer! 1\. Place the temperature probe into your freezer (not the entire TEMP-1B, just the probe!) and then wait for it to normalize around 0 degrees F aka -18C. -2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30F so I would want to go slightly above that range. However, in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. my minimums are around -20F. +2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30F so I would want to go slightly above that range. However, in most freezers they should NOT reach above 0F so you will likely need to input a lower value than me. My minimums are around -20F. ![Home Assistant history graph of the temperature probe in a freezer, with arrows at a high and a low point](/assets/temp-1-temp-probe-ex-automation-pic-1.png) @@ -17,6 +17,6 @@ This will guide you through how to setup the built in alarm using the temperatur ![Max Probe Temp set to 2.0 and Min Probe Temp set to -30.0 degrees Celsius in Home Assistant](/assets/temp-1-temp-probe-ex-automation-pic-2.png) -4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1B will play an audible alert with it's buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off +4\. Enable the "Alarm Outside Temp Range" toggle and now your TEMP-1B will play an audible alert with its buzzer when the temp thresholds are reached. If the temp goes under the min or over the max the alarm will go off ![Alarm Outside Temp Range toggle being turned on in the Home Assistant Controls card](/assets/temp-1-alarm-outside-range-pic-1.png) \ No newline at end of file diff --git a/docs/homey/products/temp1b/examples/temp1b-automation-examples.md b/docs/homey/products/temp1b/examples/temp1b-automation-examples.md index 805ec8ef00..14d1bef0e5 100755 --- a/docs/homey/products/temp1b/examples/temp1b-automation-examples.md +++ b/docs/homey/products/temp1b/examples/temp1b-automation-examples.md @@ -5,11 +5,11 @@ description: "Multiple automation examples with the TEMP-1B." ###### Freezer Temperature Probe Example -This will guide you through how to setup an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. +This will guide you through how to set up an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. 1\. Place the temperature probe into your freezer and then wait for it to normalize around 0°F (-18°C). Make sure your TEMP-1B is in a cool dry place - only the temp probe and wire can withstand the temperatures in the fridge, freezer, etc. -2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. my minimums are around -20°F. +2\. Once normalized, look at the graph and determine a good value to set for both the maximum and minimum temperatures. My mini freezer seems to max out at 30°F so I would want to go slightly above that range. However, in most freezers, they should NOT reach above 0°F so you will likely need to input a lower value than me. My minimums are around -20°F. ![Home Assistant history graph of the temperature probe in a freezer, with arrows at a high and a low point](/assets/temp-1-temp-probe-ex-automation-pic-1.png) @@ -25,7 +25,7 @@ This will guide you through how to setup an automation in Home Assistant using t ![Home Assistant numeric state trigger for Apollo TEMP-1 Max Probe Temp with the Above field set to 30 highlighted](/assets/temp-1-temp-probe-ex-automation-pic-3.png) -7\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. +7\. Click Add Action then type in "iPhone" and select your phone. If you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. ![Home Assistant Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) @@ -67,7 +67,7 @@ mode: single ###### Food Probe Example -This will guide you through how to setup an automation in Home Assistant using the food probe with Chicken(or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. +This will guide you through how to set up an automation in Home Assistant using the food probe with Chicken(or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. 1\. Set your Max Probe Temp to 73.9°C. The offsets MUST be in Celsius even if you are using F in the automation below. @@ -77,11 +77,11 @@ This will guide you through how to setup an automation in Home Assistant using t 3\. Click Settings -> Automations & scenes -> click Create Automation in the bottom left. Click here to go straight there! -4\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1b device such as "temp-1b max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. +4\. Click Add Trigger then Entity then Numeric state and search for your TEMP-1B device such as "temp-1b max probe temp" then in the box labeled "Above" type in the max probe temp number you want for your food - In this example we will use 165°F(73.9C) such as the temperature it's safe to cook Chicken to. Advanced users skip to step 8. ![Home Assistant numeric state trigger for Apollo TEMP-1 Max Probe Temp with Above set to 165](/assets/temp-1-food-probe-ex-automation-pic-3.png) -5\. Click Add Action then type in "iPhone" and select your phone. if you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. +5\. Click Add Action then type in "iPhone" and select your phone. If you do not see your phone or have an Android, try typing in "notify" instead and scrolling down until you find your phone listed. ![Home Assistant Add action dialog searching iphone, with the mobile app notification action highlighted](/assets/temp-1-temp-probe-ex-automation-pic-4.png) @@ -214,7 +214,7 @@ This will guide you through adding a button to your dashboard called "Chicken Mo ![Add Action button inside the repeat until block in Home Assistant, highlighted](/assets/temp-1-cook-chicken-example-pic-27.png) -24\. Search "light toggle" in the search bar shown then select "Choose entity" and select your the rgb led for your device +24\. Search "light toggle" in the search bar shown then select "Choose entity" and select the rgb led for your device ![Home Assistant Add action dialog searching light toggle, with Light: Toggle shown](/assets/temp-1-cook-chicken-example-pic-28.png) @@ -222,7 +222,7 @@ This will guide you through adding a button to your dashboard called "Chicken Mo ![Home Assistant notification action titled Time to check the Chicken, below the repeat action](/assets/temp-1-cook-chicken-example-pic-29.png) -26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already setup. +26\. Optionally add another action here for speaking out loud on your smart speakers such as Homepods. Click add Action then search "TTS". This requires you to have piper and a few other things already set up. ![Home Assistant Add action dialog searching tts, with the Text-to-speech (TTS): Speak action selected](/assets/temp-1-cook-chicken-example-pic-30.png)![Home Assistant TTS Speak action on piper targeting Homepods with the message The Chicken is almost ready](/assets/temp-1-cook-chicken-example-pic-31.png) @@ -244,4 +244,4 @@ This will guide you through adding a button to your dashboard called "Chicken Mo ![Home Assistant Save dialog for the TEMP-1 Chicken Automation with the Save button](/assets/temp-1-cook-chicken-example-pic-34.png) -32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to discord user RalphP for this example! \ No newline at end of file +32\. You now have one automation which unifies the button you created in the dashboard and alerts you when your chicken is almost done via a phone notification, a blinking green led, and an optional TTS notification to your smart speakers! Thanks again to Discord user RalphP for this example! \ No newline at end of file diff --git a/docs/homey/products/temp1b/faq.md b/docs/homey/products/temp1b/faq.md index 7547a6e69a..86e25e7317 100755 --- a/docs/homey/products/temp1b/faq.md +++ b/docs/homey/products/temp1b/faq.md @@ -27,7 +27,7 @@ description: "Frequently asked questions about the TEMP-1B temperature sensor." 6\. **How does the TEMP-1B connect to Home Assistant?** -* The TEMP-1B connects via WiFi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. +* The TEMP-1B connects via Wi-Fi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. 7\. **How often does the TEMP-1B send sensor data?** @@ -35,7 +35,7 @@ description: "Frequently asked questions about the TEMP-1B temperature sensor." 8\. **Can I customize the TEMP-1B’s functionality?** -* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the TEMP-1B. Our YAML is on Github and our .STEP and .STL CAD files are available for community use. +* Absolutely! With ESPHome, users can modify firmware, settings, and even print custom cases for the TEMP-1B. Our YAML is on GitHub and our .STEP and .STL CAD files are available for community use. 9\. **What are the RGB LED and piezo buzzer used for?** @@ -55,7 +55,7 @@ description: "Frequently asked questions about the TEMP-1B temperature sensor." 13\. **What’s the difference between the battery and non-battery versions?** -* The TEMP-1B is battery-operated and slightly larger, while the non-battery (NB) version is compact and requires USB-C power at 5 volts using 1amp or less (5W). They both have all of the same components for measuring soil moisture, air temp/humdity, lux/uv, etc. +* The TEMP-1B is battery-operated and slightly larger, while the non-battery (NB) version is compact and requires USB-C power at 5 volts using 1amp or less (5W). They both have all of the same components for measuring soil moisture, air temp/humidity, lux/uv, etc. 14\. **Can I use multiple TEMP-1B sensors in one Home Assistant setup?** diff --git a/docs/homey/products/temp1b/reviews.md b/docs/homey/products/temp1b/reviews.md index fe12abb815..f3644bd6c5 100755 --- a/docs/homey/products/temp1b/reviews.md +++ b/docs/homey/products/temp1b/reviews.md @@ -1,5 +1,5 @@ --- -description: "Youtuber reviews and feedback about the TEMP-1B sensor from Apollo Automation." +description: "YouTuber reviews and feedback about the TEMP-1B sensor from Apollo Automation." --- # [Simon Says Home Assistant](https://youtu.be/95etWGwEJPE?si=gdLCXFiWmuj2JUjD) diff --git a/docs/homey/products/temp1b/setup/insert-battery.md b/docs/homey/products/temp1b/setup/insert-battery.md index 522fb603d5..4c0221cc1a 100755 --- a/docs/homey/products/temp1b/setup/insert-battery.md +++ b/docs/homey/products/temp1b/setup/insert-battery.md @@ -45,7 +45,7 @@ description: "How to Insert Battery on TEMP-1B." ![TEMP-1B lid sliding into place, with a tool pointing at the lid hole that lines up with the RGB LED](/assets/temp-1b-battery-insert-align-rgb.jpg) -8\. Gently press down until it the lid seats. +8\. Gently press down until the lid seats. ![Thumb pressing the lid down onto the TEMP-1B case until it seats](/assets/temp-1b-battery-insert-press-case.jpg) diff --git a/docs/homey/products/temp1b/setup/prevent-sleep.md b/docs/homey/products/temp1b/setup/prevent-sleep.md index f922c59acd..dc6e11ff08 100755 --- a/docs/homey/products/temp1b/setup/prevent-sleep.md +++ b/docs/homey/products/temp1b/setup/prevent-sleep.md @@ -5,7 +5,7 @@ description: "Keep the TEMP-1B awake instead of letting it sleep, and what that !!! tip "Put your sensors to sleep!" - All of our battery powered device are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. + All of our battery powered devices are able to go to sleep to save battery life. Our non-battery sensor devices like the AIR-1 and PLT-1 can also sleep to get better temperature and humidity measurements. The temperature offsets needed will be much lower for your sensors as the microcontroller will not put off as much heat when it is sleeping and then waking for short periods to report the sensor values. diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-code.md b/docs/homey/products/temp1b/troubleshooting/temp1b-code.md index c6f19b98bc..1172203fb5 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-code.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-code.md @@ -37,4 +37,4 @@ If your device has already been connected to Home Assistant please proceed to the getting started guide and setup your sensor as a new device! \ No newline at end of file +7\. Please proceed to the getting started guide and set up your sensor as a new device! \ No newline at end of file diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md b/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md index 7ea60870f0..037ac5e096 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md @@ -9,7 +9,7 @@ description: "Step by step guide for tearing down your TEMP-1B to replace parts, ![TEMP-1B case with the lid removed, showing the circuit board inside](/assets/temp-1b-lid-off.jpg) -2\. Once the lid is removed either lift the PCB out or gently dump the pcb out by turning it upside down. +2\. Once the lid is removed either lift the PCB out or gently dump the PCB out by turning it upside down. ![Lifting the TEMP-1B circuit board out of the open case](/assets/temp-1b-lift-pcb-out-1.jpg) diff --git a/docs/index.md b/docs/index.md index 56a9259df3..d71a7c1fe3 100755 --- a/docs/index.md +++ b/docs/index.md @@ -117,7 +117,7 @@ flowchart LR * [Understanding your AIR-1 and the various sensors it exposes](https://wiki.apolloautomation.com/products/air1/setup/general-tips/) * [How to re-calibrate your CO2 sensor](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) * [Put your Apollo devices to sleep!](https://wiki.apolloautomation.com/products/general/battery-sensors/prevent-sleep/) -* [Setup your new M-1 LED Matrix with Multiple Panels](https://wiki.apolloautomation.com/products/m1/setup/m1-multiple-panels/) +* [Set up your new M-1 LED Matrix with Multiple Panels](https://wiki.apolloautomation.com/products/m1/setup/m1-multiple-panels/) * [3D Print your own case in any color or material](https://wiki.apolloautomation.com/products/general/links/) ### Community diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md index 2ce3b324a6..be9c70d825 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/device-builder-tour.md @@ -61,7 +61,7 @@ Click anything in the navigator to see its settings here as a form. Every field #### YAML editor (right) -The right pane is the raw YAML for your device, colour-coded with line numbers. You can read it, scroll it, and edit it directly. +The right pane is the raw YAML for your device, color-coded with line numbers. You can read it, scroll it, and edit it directly. The form pane and the YAML editor are always in sync. Edit either side and the other updates instantly. You can learn [YAML](what-is-yaml.md) by reading what the forms produce. diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md index 3adec0cdc8..a9089183b0 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md @@ -6,7 +6,7 @@ description: A short primer on YAML, the configuration format ESPHome uses, with YAML is a plain-text format used to describe configuration in a way that is readable for both people and computers. ESPHome uses YAML to describe what your device is and what it should do. -You do not have to write YAML yourself when using the **ESPHome Device Builder**. The Builder generates it for you as you click around. Recognising what you are looking at when you peek at the YAML view helps you understand what your device is doing, and a little YAML opens up advanced settings the GUI does not expose. +You do not have to write YAML yourself when using the **ESPHome Device Builder**. The Builder generates it for you as you click around. Recognizing what you are looking at when you peek at the YAML view helps you understand what your device is doing, and a little YAML opens up advanced settings the GUI does not expose. ## The basics diff --git a/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md b/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md index 048091c469..012c61a7e0 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/apollo-breakout-module.md @@ -27,7 +27,7 @@ Connect the Breakout Module to the ESP32-C6 using one of the FPC ribbon cables t The latches are small and the ribbon cable is fragile. Lift the latch with a fingernail, slide the cable in, and press the latch down. Never pull on the cable itself. -2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. +2\. Flip up the latch on the FPC connector then gently slide the ribbon cable into the connector with the blue side facing upwards. Gently press the latch down to lock it in place. ![Lifting the FPC connector latch on the ESP32-C6 and sliding in the ribbon cable, blue side up](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) diff --git a/docs/products/ESPHome-Starter-Kit/modules/button-module.md b/docs/products/ESPHome-Starter-Kit/modules/button-module.md index 0640e0c466..c992ea7dc5 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/button-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/button-module.md @@ -27,7 +27,7 @@ Connect the button module to the ESP32-C6 using one of the FPC ribbon cables tha The latches are small and the ribbon cable is fragile. Lift the latch with a fingernail, slide the cable in, and press the latch down. Never pull on the cable itself. -2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. +2\. Flip up the latch on the FPC connector then gently slide the ribbon cable into the connector with the blue side facing upwards. Gently press the latch down to lock it in place. ![Lifting the FPC connector latch on the ESP32-C6 and sliding in the ribbon cable, blue side up](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) @@ -109,7 +109,7 @@ With the device back online, the button entity is live on the web server. - Wire up the ESPHome Starter Kit RGB & Buzzer module, add it through ESPHome - Device Builder, then turn the lights and off and change colors. + Device Builder, then turn the lights on and off and change colors. --- # Adding the LED & Buzzer Module @@ -27,7 +27,7 @@ Connect the LED & Buzzer module to the ESP32-C6 using one of the FPC ribbon cabl The latches are small and the ribbon cable is fragile. Lift the latch with a fingernail, slide the cable in, and press the latch down. Never pull on the cable itself. -2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. +2\. Flip up the latch on the FPC connector then gently slide the ribbon cable into the connector with the blue side facing upwards. Gently press the latch down to lock it in place. ![Sliding the FPC ribbon cable, blue side up, into the ESP32-C6 connector and closing the latch](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) diff --git a/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md b/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md index 909404b26c..ea674dbe33 100755 --- a/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md +++ b/docs/products/ESPHome-Starter-Kit/modules/temperature-humidity-module.md @@ -28,7 +28,7 @@ Connect the Temperature and Humidity module to the ESP32-C6 using one of the FPC The latches are small and the ribbon cable is fragile. Lift the latch with a fingernail, slide the cable in, and press the latch down. Never pull on the cable itself. -2\. Flip up the latch on the FPC connector then gently slide the ribbon cable in to the connector with the blue side facing upwards. Gently press the latch down to lock it in place. +2\. Flip up the latch on the FPC connector then gently slide the ribbon cable into the connector with the blue side facing upwards. Gently press the latch down to lock it in place. ![Sliding the FPC ribbon cable, blue side up, into the ESP32-C6 connector and closing the latch](../../../assets/esphome-starter-kit-attach-top-fpc-ribbon.webp) diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md index a10b95d790..cea209b7e7 100755 --- a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md +++ b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md @@ -181,7 +181,7 @@ The Onboard RGB LED is a small LED above the Reset button of your ESP32-C6. Usef ### Boot Mode -The device is required to be flashed via USB using the bootloader mode the very first time it is used. Once you flash it once, you do not have to do these steps again +The device is required to be flashed via USB using the bootloader mode the very first time it is used. Once you flash it once, you do not have to do these steps again. !!! tip "Use a quality USB-C cable and power source" diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md b/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md index 056d5df6c0..631ea1f561 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/bluetooth-proxy.md @@ -27,7 +27,7 @@ Device Builder has an **Add Component** flow that drops the proxy into your conf 3. Search for **Bluetooth Proxy** and select it. 4. Click **Add**. Device Builder inserts the proxy into your YAML. -![ESPHome Device Builder Add component dialog: searching bluetooth proxy and adding it](../../../assets/esphome-device-builder-add-ble-proxy-component.gif) +![ESPHome Device Builder Add component dialog: searching Bluetooth proxy and adding it](../../../assets/esphome-device-builder-add-ble-proxy-component.gif) ??? note "Prefer to add it by hand? Here's the YAML" diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md b/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md index c85162cc9d..01af581665 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/light-effects.md @@ -25,7 +25,7 @@ Out of the box, your RGB module turns on, turns off, and changes color. ESPHome 3. Turn on **Show advanced settings** near the bottom of the form. Effects are an advanced option, so the field stays hidden until you do. 4. Scroll to **Effects** and click **\+ Add**. -5. Pick **Addressable Rainbow** from the dropdown. Its own settings unfold underneath: **Name**, **Speed**, and **Width**. Leave them alone for now, the greyed-out values are the defaults ESPHome uses. (1) +5. Pick **Addressable Rainbow** from the dropdown. Its own settings unfold underneath: **Name**, **Speed**, and **Width**. Leave them alone for now, the grayed-out values are the defaults ESPHome uses. (1) { .annotate } 1. Want something other than rainbow? Everything in the dropdown works on your RGB module, and the full library is documented at esphome.io/components/light. The entries starting with "Addressable" animate each LED separately, which is what makes a rainbow or a wipe travel along the strip. The rest, like **Pulse**, **Strobe**, and **Flicker**, drive the whole strip as one color at a time. diff --git a/docs/products/air1/addons/adding-gpio-header-to-air-1.md b/docs/products/air1/addons/adding-gpio-header-to-air-1.md index df24502e58..23fbecc83b 100755 --- a/docs/products/air1/addons/adding-gpio-header-to-air-1.md +++ b/docs/products/air1/addons/adding-gpio-header-to-air-1.md @@ -20,7 +20,7 @@ description: Adding Optional GPIO Header to AIR-1. ![Starting to slide the AIR-1 PCB to the left out of the lid](/assets/air-1-add-co2-pic-6.jpg)![AIR-1 PCB sliding further out of the lid, still cabled to the SEN55](/assets/air-1-add-co2-pic-7.jpg) -5\. Flip the PCB over and identify the Top Right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the PCB of the GPIO Header. There is an X on the GPIO Header's PCB as well, you can see it in the images below +5\. Flip the PCB over and identify the Top Right corner where the small black mezzanine connector lives. You will see an "X" indicating which corner needs to be lined up with the PCB of the GPIO Header. There is an X on the GPIO Header's PCB as well, you can see it in the images below. ![AIR-1 PCB in the case with a probe pointing at the X beside the mezzanine connector](/assets/air-1-gpio-header-wiki-pic-1.webp)![GPIO Header add-on board with a probe pointing at its X marking](/assets/air-1-gpio-header-wiki-pic-2.webp) diff --git a/docs/products/air1/air1-reviews.md b/docs/products/air1/air1-reviews.md index 4956f52e4e..0706c6b187 100755 --- a/docs/products/air1/air1-reviews.md +++ b/docs/products/air1/air1-reviews.md @@ -1,6 +1,6 @@ --- title: AIR-1 Reviews -description: Youtuber reviews and feedback about the AIR-1 sensor from Apollo Automation. +description: YouTuber reviews and feedback about the AIR-1 sensor from Apollo Automation. --- # [The Bearded Tech Guy AIR-1 Review](https://youtu.be/k0SDJ6_SBqk?si=3uLfXC3GUDaYJNEs) diff --git a/docs/products/air1/examples/air1-dashboard-examples.md b/docs/products/air1/examples/air1-dashboard-examples.md index 14fe074c8c..985578172b 100755 --- a/docs/products/air1/examples/air1-dashboard-examples.md +++ b/docs/products/air1/examples/air1-dashboard-examples.md @@ -170,7 +170,7 @@ refresh_interval: 10 title: Bedroom CO2 ``` -##### Home Assistant Guage +##### Home Assistant Gauge ![Home Assistant needle gauge card showing MSR-1 CO2 at 1,063 ppm with green, yellow, and red ranges](/assets/co2-guage.png) @@ -215,7 +215,7 @@ refresh_interval: 10 title: Basement VOC ``` -##### Home Assistant Guage +##### Home Assistant Gauge ![Home Assistant needle gauge card showing a Basement VOC reading of 457](/assets/air-1-voc-ha-guage.png) diff --git a/docs/products/air1/examples/firstof9's-apex-charts.md b/docs/products/air1/examples/firstof9's-apex-charts.md index 81f0c53213..cee3404119 100755 --- a/docs/products/air1/examples/firstof9's-apex-charts.md +++ b/docs/products/air1/examples/firstof9's-apex-charts.md @@ -1,7 +1,7 @@ --- title: Firstof9's AIR-1 Apex Charts Dashboard description: >- - A custom dashboard made by discord/github user Firstof9 using Apex Charts for + A custom dashboard made by Discord/GitHub user Firstof9 using Apex Charts for a really neat AIR-1 dashboard. --- # Firstof9's AIR-1 Apex Charts Dashboard @@ -40,7 +40,7 @@ Now you need to be VERY careful. You are editing all of your dashboards but we c ![ESPHome Device Builder AIR-1 YAML with the device name line circled](/assets/air-1-id.png) -The easiest way to change all of the entity IDs in the code is by using AI (ChatGPT etc.) or by using a code editor like Visual Studio Code (VSC). In VSC you can Find (ctrl+f) the old ID and Replace (select the small arrow to toggle open the Replace box) it with your ID. Now you are ready to copy the code into the Raw configurator editor. (See code below) +The easiest way to change all of the entity IDs in the code is by using AI (ChatGPT etc.) or by using a code editor like Visual Studio Code (VSC). In VSC you can Find (ctrl+f) the old ID and Replace (select the small arrow to toggle open the Replace box) it with your ID. Now you are ready to copy the code into the Raw configuration editor. (See code below) VSC Find/Replace diff --git a/docs/products/air1/faq.md b/docs/products/air1/faq.md index 4f77bbef6f..e1a1979cb7 100755 --- a/docs/products/air1/faq.md +++ b/docs/products/air1/faq.md @@ -13,7 +13,7 @@ description: Frequently asked questions about the AIR-1 environmental sensor, in 3\. **How do I connect the AIR-1 to Home Assistant?** -* The AIR-1 connects via WiFi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. +* The AIR-1 connects via Wi-Fi to ESPHome on Home Assistant, enabling data monitoring, automations, and alerts directly within Home Assistant. 4\. **Does the AIR-1 require cloud connectivity or a subscription?** @@ -101,7 +101,7 @@ description: Frequently asked questions about the AIR-1 environmental sensor, in 25\. **What are the optional add-ons for the AIR-1?** -* The AIR-1 offers two optional add-ons: a SCD40 CO2 sensor and the MiCS gas sensor. These can be added to enhance air quality monitoring with very accurate CO2 measurements and the ability to detect multiple gases with the MiCS gas sensor. +* The AIR-1 offers two optional add-ons: an SCD40 CO2 sensor and the MiCS gas sensor. These can be added to enhance air quality monitoring with very accurate CO2 measurements and the ability to detect multiple gases with the MiCS gas sensor. 26\. **What's in the box?** @@ -121,7 +121,7 @@ description: Frequently asked questions about the AIR-1 environmental sensor, in 30\. **How long does it take to set up the AIR-1?** -* Setup typically takes around 5-10 minutes. Once powered and connected to WiFi, it can be configured quickly through ESPHome and Home Assistant. +* Setup typically takes around 5-10 minutes. Once powered and connected to Wi-Fi, it can be configured quickly through ESPHome and Home Assistant. 31\. **How secure is the AIR-1?** diff --git a/docs/products/air1/introduction.md b/docs/products/air1/introduction.md index 3890acd275..bf9f5db2ff 100755 --- a/docs/products/air1/introduction.md +++ b/docs/products/air1/introduction.md @@ -4,7 +4,7 @@ description: Documentation for AIR-1, including setup, usage, and best practices ---
-The Apollo AIR-1 is a compact, feature-rich air quality sensor designed for Home Assistant users. It operates locally over WiFi using ESPHome, without the need for a cloud or subscription. Powered by USB-C, the AIR-1 offers open-source software and CAD drawings for customization. +The Apollo AIR-1 is a compact, feature-rich air quality sensor designed for Home Assistant users. It operates locally over Wi-Fi using ESPHome, without the need for a cloud or subscription. Powered by USB-C, the AIR-1 offers open-source software and CAD drawings for customization. Key features include monitoring PM levels (dust, pollen), VOCs, CO2 (optional), temperature, humidity, and even gas levels with an optional sensor. The device also integrates RGB LEDs for notifications and Bluetooth tracking for added automation. diff --git a/docs/products/air1/troubleshooting/air1-code.md b/docs/products/air1/troubleshooting/air1-code.md index 7c42086a17..54511b76cb 100755 --- a/docs/products/air1/troubleshooting/air1-code.md +++ b/docs/products/air1/troubleshooting/air1-code.md @@ -40,4 +40,4 @@ If your device has already been connected to Home Assistant please proceed to the getting started guide and setup your sensor as a new device! \ No newline at end of file +8\. Please proceed to the getting started guide and set up your sensor as a new device! \ No newline at end of file diff --git a/docs/products/apolloodroid/faq.md b/docs/products/apolloodroid/faq.md index 36385d905f..c676264521 100755 --- a/docs/products/apolloodroid/faq.md +++ b/docs/products/apolloodroid/faq.md @@ -35,7 +35,7 @@ The Apollo Odroid comes equipped with: 6\. **Does the Apollo Odroid support wireless connectivity?** -* Yes, the ODROID-M1S platform supports both WiFi and Ethernet connections, giving you flexible options for integrating it into your network. +* Yes, the ODROID-M1S platform supports both Wi-Fi and Ethernet connections, giving you flexible options for integrating it into your network. 7\. **Can I customize the Home Assistant installation on the Apollo Odroid?** diff --git a/docs/products/apolloodroid/getting-started.md b/docs/products/apolloodroid/getting-started.md index 17751d9985..7e7922443a 100755 --- a/docs/products/apolloodroid/getting-started.md +++ b/docs/products/apolloodroid/getting-started.md @@ -13,7 +13,7 @@ This guide will walk you through setting up your Apollo Home Assistant hub aka t 3\.From a phone or computer connected to your home's internet open your web browser and navigate to http://homeassistant.local:8123. -!!! tip "You can also access your device from it's IP address instead of the default hostname of homeassistant.local" +!!! tip "You can also access your device from its IP address instead of the default hostname of homeassistant.local" If you'd prefer, you can go into your router and find the IP address that your Odroid received and use the IP address with port 8123 at the end such as: http://192.168.1.30:8123 diff --git a/docs/products/btn1/examples/example-automation.md b/docs/products/btn1/examples/example-automation.md index 6fa1c3d9cb..b74c3b26c4 100755 --- a/docs/products/btn1/examples/example-automation.md +++ b/docs/products/btn1/examples/example-automation.md @@ -6,11 +6,11 @@ description: Example of how to use the BTN-1 Events to create an automation in H 1\. Head to the automations page and click on **Create Automation** in the bottom right then select **Create new automation**. -2\. Click on **Add trigger** then select **Entity** and then **State**. Then search for your btn-1 and select the btn-1 event. Then select the **Event Type** attribute and select **Single Click** in the box labeled **To**. +2\. Click on **Add trigger** then select **Entity** and then **State**. Then search for your BTN-1 and select the BTN-1 event. Then select the **Event Type** attribute and select **Single Click** in the box labeled **To**. ![Creating a Home Assistant automation with a State trigger on the BTN-1 Button 1 event set to Single Click](/assets/btn-1-example-gif-1.gif) -3\. Next click on **Add action** and search **Light: Toggle** and select it. Then choose your entity to turn on such as btn-1 light. Check the box next to Brightness and type in 100 then click Save and name your automation. +3\. Next click on **Add action** and search **Light: Toggle** and select it. Then choose your entity to turn on such as BTN-1 light. Check the box next to Brightness and type in 100 then click Save and name your automation. ![Adding a Light Toggle action for a BTN-1 light with brightness set, then saving the automation](/assets/btn-1-example-gif-2.gif) diff --git a/docs/products/btn1/faq.md b/docs/products/btn1/faq.md index 1b546c0246..64c656ccb8 100755 --- a/docs/products/btn1/faq.md +++ b/docs/products/btn1/faq.md @@ -16,7 +16,7 @@ description: Frequently asked questions about the BTN-1 Macro Deck 4\. **How do I connect the BTN-1 to Home Assistant?** -* The BTN-1 connects to your Home Assistant instance through the ESPHome Integration using WiFi. +* The BTN-1 connects to your Home Assistant instance through the ESPHome Integration using Wi-Fi. 5\. **Does the BTN-1 support Zigbee firmware?** diff --git a/docs/products/btn1/setup/getting-started.md b/docs/products/btn1/setup/getting-started.md index 81db3961bd..ed13a00dbb 100755 --- a/docs/products/btn1/setup/getting-started.md +++ b/docs/products/btn1/setup/getting-started.md @@ -32,13 +32,13 @@ To connect through the sensor's onboard hotspot follow the below: 1\. Plug the BTN-1 in via USB-C. A 5v 1amp power supply will work fine -!!! success "If your sensor is restarting or not broadcasting Wi-Fi try another usb-c cable and power supply!" +!!! success "If your sensor is restarting or not broadcasting Wi-Fi try another USB-C cable and power supply!" The BTN-1 is sensitive to power fluctuations and needs constant 5v power. It draws 1amp or less so most used phone chargers will work, just make sure it's a quality one! Still no hotspot? Follow the Reset Wi-Fi Credentials guide to make it broadcast again. -2\. On your phone or PC, open the WiFi settings and connect to "Apollo BTN-1 Hotspot". +2\. On your phone or PC, open the Wi-Fi settings and connect to "Apollo BTN-1 Hotspot". ![Phone Wi-Fi settings listing the BTN-1 hotspot network to join](/assets/btn-1-reset-wifi-screenshot.png) @@ -60,7 +60,7 @@ To connect through the sensor's onboard hotspot follow the below: !!! note "Pre-requirement: Bluetooth proxy or Bluetooth Home Assistant hardware required" - Bluetooth built in such as a raspberry pi or at least one ESP32 BLE Proxy is required to use this to setup your Apollo device. If you have already followed the "Connecting through Hotspot" please skip this section. + Bluetooth built in such as a raspberry pi or at least one ESP32 BLE Proxy is required to use this to set up your Apollo device. If you have already followed the "Connecting through Hotspot" please skip this section. 1\. Navigate to settings -> integrations then click the "**ADD**" button below your new Apollo device then click **Submit**. @@ -74,7 +74,7 @@ To connect through the sensor's onboard hotspot follow the below: ![Adding the BTN-1 to the ESPHome integration, choosing an area, and clicking Finish](/assets/btn-1-improv-ble-esphome-integration.gif) -4\. Your device is now added to your Wi-Fi and added to the ESPHome Integration in Home Assistant. You should now be ready to setup a blueprint and start using your BTN-1! +4\. Your device is now added to your Wi-Fi and added to the ESPHome Integration in Home Assistant. You should now be ready to set up a blueprint and start using your BTN-1! ### Connecting To ESPHome Device Builder @@ -82,7 +82,7 @@ To connect through the sensor's onboard hotspot follow the below: Feel free to [skip to the next section by clicking here](https://wiki.apolloautomation.com/products/general/setup/getting-started/#connecting-to-home-assistant-via-esphome-integration "Click to jump to the ESPHome Integration steps!") unless you need to rename your sensor or do manual edits to the yaml -You can add the ESPHome Device Builder app in Home Assistant to easily update your device or edit the yaml. If you don't have the ESPHome Device Builder app installed you can search esphome device builder in the app store and install it. +You can add the ESPHome Device Builder app in Home Assistant to easily update your device or edit the yaml. If you don't have the ESPHome Device Builder app installed you can search ESPHome Device Builder in the app store and install it. Make sure to fill out your Wi-Fi details in the **secrets** section by clicking on the **secrets** button. @@ -114,6 +114,6 @@ wifi_password: "your-wifi-pass-here" ![Adding the discovered BTN-1 from the ESPHome integration page, setting an area, and opening its device page](/assets/btn-1-getting-started-esphome-integration-gif.gif) -2\. Your device is now added to home assistant via the ESPHome integration, and you can easily navigate to it by going to settings -> ESPHome integration -> click on the name of your new device! +2\. Your device is now added to Home Assistant via the ESPHome integration, and you can easily navigate to it by going to settings -> ESPHome integration -> click on the name of your new device! -[Click here to setup a blueprint and easily automate using your BTN-1! :simple-blueprint:](https://wiki.apolloautomation.com/products/btn1/examples/blueprint/){ .md-button .md-button--primary } \ No newline at end of file +[Click here to set up a blueprint and easily automate using your BTN-1! :simple-blueprint:](https://wiki.apolloautomation.com/products/btn1/examples/blueprint/){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/btn1/troubleshooting/btn1-reflash.md b/docs/products/btn1/troubleshooting/btn1-reflash.md index 380fbf4ab0..e916661a4d 100755 --- a/docs/products/btn1/troubleshooting/btn1-reflash.md +++ b/docs/products/btn1/troubleshooting/btn1-reflash.md @@ -36,4 +36,4 @@ description: Step by step guide for reflashing The BTN-1. Your device is still in boot mode and needs to be power cycled aka power removed to make it boot in a normal mode! -[Head to the Getting Started article to setup your BTN-1 as a new device!](https://wiki.apolloautomation.com/products/btn1/setup/getting-started/){ .md-button .md-button--primary } \ No newline at end of file +[Head to the Getting Started article to set up your BTN-1 as a new device!](https://wiki.apolloautomation.com/products/btn1/setup/getting-started/){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/cast1/setup/getting-started.md b/docs/products/cast1/setup/getting-started.md index 3f069c7236..b889868054 100644 --- a/docs/products/cast1/setup/getting-started.md +++ b/docs/products/cast1/setup/getting-started.md @@ -45,7 +45,7 @@ There are three ways to get your CAST-1 online. Pick whichever is easier, you on !!! note "Pre-requirement: Bluetooth proxy or Bluetooth Home Assistant hardware required" - Bluetooth built in such as a Raspberry Pi or at least one ESP32 BLE Proxy is required to use this to setup your Apollo device. + Bluetooth built in such as a Raspberry Pi or at least one ESP32 BLE Proxy is required to use this to set up your Apollo device. 1\. Open your integrations page in Home Assistant. diff --git a/docs/products/cast1/troubleshooting/cast1-reflash.md b/docs/products/cast1/troubleshooting/cast1-reflash.md index bf408646dd..5142547538 100644 --- a/docs/products/cast1/troubleshooting/cast1-reflash.md +++ b/docs/products/cast1/troubleshooting/cast1-reflash.md @@ -33,4 +33,4 @@ description: Step by step guide for reflashing The CAST-1. Your device is still in boot mode and needs to be power cycled, meaning power removed, to make it boot in a normal mode! -[Head to the Getting Started article to setup your CAST-1 as a new device!](https://wiki.apolloautomation.com/products/cast1/setup/getting-started/){ .md-button .md-button--primary } +[Head to the Getting Started article to set up your CAST-1 as a new device!](https://wiki.apolloautomation.com/products/cast1/setup/getting-started/){ .md-button .md-button--primary } diff --git a/docs/products/dev2/introduction.md b/docs/products/dev2/introduction.md index 629aa001e4..15f696c90d 100755 --- a/docs/products/dev2/introduction.md +++ b/docs/products/dev2/introduction.md @@ -12,7 +12,7 @@ The Apollo DEV-2 is a very small dev board that we use to prototype before creat The DEV-2 is a great starter device for tinkerers and can be purchased on its own or with a breadboard and dupont wires (jumper wires) if you need those too. -The DEV-2 does NOT come pre-flashed with ESPHome or WLED and requires you to flash it yourself, however there is a getting started video we've made here on the older DEV-1 board. The information is still the same except you'll be using a slightly differently yaml as shared below: +The DEV-2 does NOT come pre-flashed with ESPHome or WLED and requires you to flash it yourself, however there is a getting started video we've made here on the older DEV-1 board. The information is still the same except you'll be using a slightly different yaml as shared below:
-1\. Navigate to the ESPHome integration by going to settings -> esphome integration -> click on the name of your new device! +1\. Navigate to the ESPHome integration by going to settings -> ESPHome integration -> click on the name of your new device! 2\. Scroll down to the Configuration section. @@ -44,7 +44,7 @@ How to tune the mmWave sensor using radar engineering mode. ![MSR-2 gate threshold sliders in Home Assistant with the g4 move threshold slider moved left and circled](/assets/mmwave-tuning-pic-4.png) -!!! quote "Quote from popular Youtuber Make It Work Tech" +!!! quote "Quote from popular YouTuber Make It Work Tech" I ended up maxing out the sliders on all gates and then bringing them down just enough to pick up human presence. Definitely easier than using the LD2410B app. - MakeItWorkTech diff --git a/docs/products/general/comparisons.md b/docs/products/general/comparisons.md index 3cdd5f7fd3..aa11aecad0 100755 --- a/docs/products/general/comparisons.md +++ b/docs/products/general/comparisons.md @@ -1,6 +1,6 @@ --- -title: mmWave Presense Sensor Comparison Chart -description: mmWave Presense Sensor Comparison Chart. +title: mmWave Presence Sensor Comparison Chart +description: mmWave Presence Sensor Comparison Chart. ---

mmWave Presence Sensor Comparison

Apollo Automation

Apollo MSR-2

Everything Presence One Kit

Everything Presence Lite Kit

Apollo MTR-1

Screek Human Sensor 1U

Screek Human Sensor 2A

Aqara FP1

Aqara FP2

Price (USD)

$ 34.99

$ 78.00

$ 37.00

$ 36.99

$25.99

$29.99

$49.99

$82.99

mmWave

LD2410B

SEN0395

LD2450

LD2450

LD2410C

LD2450

BGT60TR13C

IWR6843

Detection Distance (m)

6

9

6

6

6

6

5

6 to 8

Detection Zones

3 zones and 9 gates (adjustable and distance based)

3 zones

3 zones

6

6

5

6 to 8

Target Tracking

1

1

2-3 (3 not great)

2-3 (3 not great)

x

x

x

PIR

Panasonic

x

x

x

ESP

ESP32-C3-MINI

ESP32-WROOM-32

ESP32-WROOM-32

ESP32-C3-MINI

ESP32-S2

ESP32-C3

ESP32-WROOM-32U

Country

USA

EU

EU

USA

China

China

China

China

CO2

SCD40 $20

SCD40 $20

UV/LUX

LTR390

LTR390

Buzzer

Piezo

Piezo

RGB LED

ws2812b

ws2812b

ws2812b

ws2812b

GPIO Header

$ 4.99 (Optional with GPIO Header)

Onboard

Onboard

$ 4.99 (Optional with GPIO Header)

Size (mm)

40x24x15

Stand

$4.99 (Optional)

Included

Product Link

Apollo MSR-2

Everything Presence One Kit

Everything Presence Lite Kit

Apollo MTR-1

Screek Human Sensor 1U

Screek Human Sensor 2A

Aqara FP1

Aqara FP2

diff --git a/docs/products/general/faq.md b/docs/products/general/faq.md index c1992752e6..bf7f4f3fcd 100755 --- a/docs/products/general/faq.md +++ b/docs/products/general/faq.md @@ -6,7 +6,7 @@ description: Frequently Asked Questions. ### 1\. How much power do your sensors use? -* All apollo sensors use 1amp or less, some of them 350-500mA. +* All Apollo sensors use 1amp or less, some of them 350-500mA. --- @@ -30,13 +30,13 @@ description: Frequently Asked Questions. ### **4\. My lux sensor doesn't seem to be working how do I fix it?** -* The default update\_interval is 60 seconds which isnt great for automations revolving around measuring lux values. [Please follow this short guide](https://wiki.apolloautomation.com/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval/ "How to Edit your lux sensor update interval") to edit the lux update\_interval down to a more responsive 3-5seconds. +* The default update\_interval is 60 seconds which isn't great for automations revolving around measuring lux values. [Please follow this short guide](https://wiki.apolloautomation.com/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval/ "How to Edit your lux sensor update interval") to edit the lux update\_interval down to a more responsive 3-5 seconds. --- -### **5\. Do I need to push the "Clean" button for my Air-1 or setup an automation for it?** +### **5\. Do I need to push the "Clean" button for my AIR-1 or set up an automation for it?** -* No, your Air-1 will self-clean once a week per this [recommended documentation from the manufacturer.](https://sensirion.com/media/documents/6791EFA0/62A1F68F/Sensirion_Datasheet_Environmental_Node_SEN5x.pdf) +* No, your AIR-1 will self-clean once a week per this [recommended documentation from the manufacturer.](https://sensirion.com/media/documents/6791EFA0/62A1F68F/Sensirion_Datasheet_Environmental_Node_SEN5x.pdf) --- diff --git a/docs/products/general/links.md b/docs/products/general/links.md index 89b7896ddf..8e6a63f7e1 100755 --- a/docs/products/general/links.md +++ b/docs/products/general/links.md @@ -1,6 +1,6 @@ --- title: Useful Links -description: Links to our github, printables, and discord! +description: Links to our GitHub, Printables, and Discord! --- # Useful Links diff --git a/docs/products/general/mmwave-presence-sensor-comparison.md b/docs/products/general/mmwave-presence-sensor-comparison.md index dd2ffc3a06..dc4f574df9 100755 --- a/docs/products/general/mmwave-presence-sensor-comparison.md +++ b/docs/products/general/mmwave-presence-sensor-comparison.md @@ -1,5 +1,5 @@ --- -title: mmWave Presense Sensor Comparison Chart -description: mmWave Presense Sensor Comparison Chart. +title: mmWave Presence Sensor Comparison Chart +description: mmWave Presence Sensor Comparison Chart. ---

mmWave Presence Sensor Comparison

Apollo Automation

Apollo MSR-2

Everything Presence One Kit

Everything Presence Lite Kit

Apollo MTR-1

Screek Human Sensor 1U

Screek Human Sensor 2A

Aqara FP1

Aqara FP2

Price (USD)

$ 34.99

$ 78.00

$ 37.00

$ 36.99

$25.99

$29.99

$49.99

$82.99

mmWave

LD2410B

SEN0395

LD2450

LD2450

LD2410C

LD2450

BGT60TR13C

IWR6843

Detection Distance (m)

6

9

6

6

6

6

5

6 to 8

Detection Zones

3 zones and 9 gates (adjustable and distance based)

3 zones

3 zones

6

6

5

6 to 8

Target Tracking

1

1

2-3 (3 not great)

2-3 (3 not great)

x

x

x

PIR

Panasonic

x

x

x

ESP

ESP32-C3-MINI

ESP32-WROOM-32

ESP32-WROOM-32

ESP32-C3-MINI

ESP32-S2

ESP32-C3

ESP32-WROOM-32U

Country

USA

EU

EU

USA

China

China

China

China

CO2

SCD40 $20

SCD40 $20

UV/LUX

LTR390

LTR390

Buzzer

Piezo

Piezo

RGB LED

ws2812b

ws2812b

ws2812b

ws2812b

GPIO Header

$ 4.99 (Optional with GPIO Header)

Onboard

Onboard

$ 4.99 (Optional with GPIO Header)

Size (mm)

40x24x15

Stand

$4.99 (Optional)

Included

Product Link

Apollo MSR-2

Everything Presence One Kit

Everything Presence Lite Kit

Apollo MTR-1

Screek Human Sensor 1U

Screek Human Sensor 2A

Aqara FP1

Aqara FP2

\ No newline at end of file diff --git a/docs/products/general/piezo.md b/docs/products/general/piezo.md index f33ea64af8..c57360628d 100755 --- a/docs/products/general/piezo.md +++ b/docs/products/general/piezo.md @@ -14,9 +14,9 @@ This guide will walk you through using the buzzer on your Apollo Device. 2\. Click Actions at the top of the page. -3\. Select your devices buzzer in the Action box by typing in "buzzer" and selecting it. +3\. Select your device's buzzer in the Action box by typing in "buzzer" and selecting it. -4\. Input an RTTTL tone into the the string box such as one of the examples below. +4\. Input an RTTTL tone into the string box such as one of the examples below. ![Home Assistant Developer tools Actions tab with numbered arrows marking the buzzer action steps](/assets/buzzer-example-image.png) diff --git a/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md b/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md index dbb9347ff7..e4011dd5ee 100755 --- a/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md +++ b/docs/products/general/setup/adding-apollo-devices-to-hidden-networks.md @@ -5,11 +5,11 @@ description: Tutorial for how to add Apollo Devices To Hidden Networks. # Adding Apollo Devices To Hidden Networks -1\. Open the Esphome Device Builder. +1\. Open the ESPHome Device Builder. ![ESPHome Device Builder dashboard showing cards for several Apollo devices](/assets/bluetooth-proxy-tutorial-1.png) -2\. If you do not have it installed, [go here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Install Esphome Device Builder.") and then move on to step 3. +2\. If you do not have it installed, [go here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Install ESPHome Device Builder.") and then move on to step 3. 3\. Click "Edit" as shown below. diff --git a/docs/products/general/setup/adjusting-wifi-power.md b/docs/products/general/setup/adjusting-wifi-power.md index d80ad24793..6bfb074dee 100755 --- a/docs/products/general/setup/adjusting-wifi-power.md +++ b/docs/products/general/setup/adjusting-wifi-power.md @@ -1,20 +1,20 @@ --- -title: Adjusting Wifi Power Save -description: Tutorial for how to Adjusting Wifi Power Save. +title: Adjusting Wi-Fi Power Save +description: Tutorial for how to adjust Wi-Fi Power Save. --- -# Adjusting Wifi Power Save +# Adjusting Wi-Fi Power Save -The ESP chips produce a significant amount of energy (heat) constantly using Wi-Fi. This guide explains how to adjust the wifi power save mode to high to combat this. +The ESP chips produce a significant amount of energy (heat) constantly using Wi-Fi. This guide explains how to adjust the Wi-Fi power save mode to high to combat this. -!!! warning "This will negatively effect your Wi-Fi performance!" +!!! warning "This will negatively affect your Wi-Fi performance!" - While some options *can* reduce the power usage of the ESP, they generally also decrease the reliability of the WiFi connection, with frequent disconnections from the router in the highest power saving mode. + While some options *can* reduce the power usage of the ESP, they generally also decrease the reliability of the Wi-Fi connection, with frequent disconnections from the router in the highest power saving mode. 1\. Open the ESPHome Device Builder. ![ESPHome Device Builder dashboard showing cards for several Apollo devices](/assets/power-save-tutorial-1.png) -2\. If you do not have it installed, [go here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Install Esphome Device Builder.") and then move on to step 3. +2\. If you do not have it installed, [go here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Install ESPHome Device Builder.") and then move on to step 3. 3\. Click "Edit" as shown below. diff --git a/docs/products/general/setup/change-the-update-frequency-of-sensors.md b/docs/products/general/setup/change-the-update-frequency-of-sensors.md index 4fe2046794..e1fb5d0448 100755 --- a/docs/products/general/setup/change-the-update-frequency-of-sensors.md +++ b/docs/products/general/setup/change-the-update-frequency-of-sensors.md @@ -9,7 +9,7 @@ description: Tutorial for How To Change The Update Frequency Of Sensors. ![ESPHome Builder in the Home Assistant sidebar with the Edit button on an AIR-1 card outlined](/assets/update-frequency-pic-1.png) -2\. Insert the YAML for the sensor you want to edit(The example below is for our AIR-1 SEN55 sensor). +2\. Insert the YAML for the sensor you want to edit (The example below is for our AIR-1 SEN55 sensor). ```yaml sensor: diff --git a/docs/products/general/setup/getting-started.md b/docs/products/general/setup/getting-started.md index 7e73e858a7..2685348c6b 100755 --- a/docs/products/general/setup/getting-started.md +++ b/docs/products/general/setup/getting-started.md @@ -12,7 +12,7 @@ To connect through the sensor's onboard hotspot follow the below: 1\. Plug the sensor into a quality power brick. They require 5v and under an amp so most phone chargers will be fine. ESP devices are sensitive to power fluctuations and users have had some issues with really cheap power bricks. If your device is restarting or unavailable please try a different power brick. -2\. On your phone or PC, open the WiFi settings and connect to "Apollo MSR-2 Hotspot", it might take a minute for the WiFi network to show up. +2\. On your phone or PC, open the Wi-Fi settings and connect to "Apollo MSR-2 Hotspot", it might take a minute for the Wi-Fi network to show up. ![Phone Wi-Fi settings with the Apollo MSR-2 hotspot network outlined in red](/assets/getting-started-pic-1-1.png) @@ -20,7 +20,7 @@ To connect through the sensor's onboard hotspot follow the below: If this does not automatically open the dashboard, please open your web browser and go to [http://192.168.4.1](http://192.168.4.1) -4\. Select the WiFi network that you would like your sensor to connect to or scroll to the bottom and type in your Wi-Fi network then click "**Save**". +4\. Select the Wi-Fi network that you would like your sensor to connect to or scroll to the bottom and type in your Wi-Fi network then click "**Save**". ![Sensor hotspot page at 192.168.4.1 with the SSID and Password fields and Save button marked](/assets/getting-started-pic-2.png) @@ -36,13 +36,13 @@ If this does not automatically open the dashboard, please open your web browser !!! note "Pre-requirement:" - Bluetooth built in such as a raspberry pi or at least one ESP32 BLE Proxy. If you have already followed the "Connecting through Hotspot" please skip this section. + Bluetooth built in such as a Raspberry Pi or at least one ESP32 BLE Proxy. If you have already followed the "Connecting through Hotspot" please skip this section. 1\. Navigate to settings -> integrations then click the "**ADD**" button below your new Apollo device! ![Discovered PLT-1B card in Home Assistant labeled Improv via BLE with an Add button](/assets/improv-ble-pic-1.png) -2\. Click submit when it asks if you want to setup your new device and shows you the hostname of your device. +2\. Click submit when it asks if you want to set up your new device and shows you the hostname of your device. ![Home Assistant setup prompt for an Apollo TEMP-1 with the Submit button outlined in red](/assets/temp1b-improv-ble-4.png) @@ -66,7 +66,7 @@ If this does not automatically open the dashboard, please open your web browser !!! tip "Skip the ESPHome Device Builder unless..." - Feel free to [skip to the next section by clicking here](https://wiki.apolloautomation.com/products/general/setup/getting-started/#connecting-to-home-assistant-via-esphome-integration "Click to jump to the ESPHome Integration steps!")unless you need to rename your sensor or do manual edits to the yaml + Feel free to [skip to the next section by clicking here](https://wiki.apolloautomation.com/products/general/setup/getting-started/#connecting-to-home-assistant-via-esphome-integration "Click to jump to the ESPHome Integration steps!") unless you need to rename your sensor or do manual edits to the yaml You can add the ESPHome Device Builder app in Home Assistant to easily update your device or edit the yaml. If you don't have the ESPHome Device Builder app installed you can [follow the steps here](https://esphome.io/guides/getting_started_hassio.html#installing-esphome-device-compiler "Getting Started guide for installing ESPHome Device Builder"). @@ -112,11 +112,11 @@ wifi_password: "your-wifi-pass-here" ![Home Assistant New devices discovered notification with the Check it out link outlined](/assets/getting-started-pic-7.png) -3\. Click "**ADD**" to begin adding the device to home assistant. +3\. Click "**ADD**" to begin adding the device to Home Assistant. ![Discovered MSR-2 card in Home Assistant with the Add button outlined in red](/assets/getting-started-pic-6-1.png) -4\. Click "**SUBMIT**" to confirm you want to add your new Apollo device to home assistant. +4\. Click "**SUBMIT**" to confirm you want to add your new Apollo device to Home Assistant. ![Home Assistant Discovered ESPHome node dialog for an MSR-2 with Submit outlined](/assets/getting-started-pic-8.png) @@ -124,6 +124,6 @@ wifi_password: "your-wifi-pass-here" ![Home Assistant Success dialog for an MSR-2 with the Area field and Finish button marked](/assets/getting-started-pic-9.png) -6\. Your device is now added to home assistant via the ESPHome integration, and you can easily navigate to it by going to settings -> ESPHome integration -> click on the name of your new device! +6\. Your device is now added to Home Assistant via the ESPHome integration, and you can easily navigate to it by going to settings -> ESPHome integration -> click on the name of your new device! [Click here to join our Discord for fast support! :simple-discord:](https://link.apolloautomation.com/discord){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md b/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md index 90fefcc414..494a015daa 100755 --- a/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md +++ b/docs/products/general/setup/how-to-add-temp-and-humidity-from-scd40.md @@ -64,6 +64,6 @@ number: ![ESPHome Device Builder install log with INFO OTA successful and the Stop button circled](/assets/add-temp-hum-scd40-pic-3.png) -5\. Once you are finished, you will have two new boxes inside the Home Assistant ESPHome integration device page for your device where you can fill in an offset. Give them up to 1minute to take effect! +5\. Once you are finished, you will have two new boxes inside the Home Assistant ESPHome integration device page for your device where you can fill in an offset. Give them up to 1 minute to take effect! ![SCD40 Humidity and SCD40 Temperature offset boxes on the device page in Home Assistant](/assets/add-temp-hum-scd40-pic-5.png) \ No newline at end of file diff --git a/docs/products/general/setup/renaming-apollo-devices.md b/docs/products/general/setup/renaming-apollo-devices.md index b64456d3d5..7f2af0e246 100755 --- a/docs/products/general/setup/renaming-apollo-devices.md +++ b/docs/products/general/setup/renaming-apollo-devices.md @@ -18,7 +18,7 @@ description: Tutorial for How To Rename Apollo Devices in the ESPHome integratio !!! success "It's okay if there are some entities that cannot be regenerated!" - You will likely run into a popup showning that 2 entity IDs cannot be regenerated because they are not available. This is fine, we can manually fix these later or just ignore them as they are disabled entities and not expected to be used. + You will likely run into a popup showing that 2 entity IDs cannot be regenerated because they are not available. This is fine, we can manually fix these later or just ignore them as they are disabled entities and not expected to be used. ![Selecting Recreate entity IDs from the three-dot menu on a BTN-1 device page, then Update](/assets/esphome-integration-recreate-entity-ids-gif.gif) @@ -52,13 +52,13 @@ This section only changes the device name shown in the ESPHome integration page. !!! null "We are now ready to rename the friendly_name to a new name such as Smart Keys" - This can have spaces and capital letters and will be the same name home assistant will give the device and all entity names! + This can have spaces and capital letters and will be the same name Home Assistant will give the device and all entity names! 3\. Click **Edit** then replace the text after friendly\_name with your new name such as Smart Keys. Click Save and Install in the top right once you are done with the rename and it will save and install. Once it finishes it will say OTA successful and you can click close to get back to the main dashboard. ![Editing friendly_name to Smart Keys in ESPHome Device Builder, then installing wirelessly](/assets/rename-friendiy-name-esphome-device-builder-gif.gif) -4\. Finally we should delete the device from the ESPHome Integration in home assistant and then add it back! Head to the ESPHome Integrations page. Next to the device you would like to remove, click the three dots and then **Delete**. +4\. Finally we should delete the device from the ESPHome Integration in Home Assistant and then add it back! Head to the ESPHome Integrations page. Next to the device you would like to remove, click the three dots and then **Delete**. ![Deleting the renamed BTN-1 from the ESPHome integration page using the three-dot menu](/assets/delete-device-from-esphome-device-builder-gif2.gif) diff --git a/docs/products/general/setup/switch-to-beta-branch.md b/docs/products/general/setup/switch-to-beta-branch.md index 2f323c7010..3d7ebc9766 100755 --- a/docs/products/general/setup/switch-to-beta-branch.md +++ b/docs/products/general/setup/switch-to-beta-branch.md @@ -1,6 +1,6 @@ --- -title: How To Switching to Beta branch with ESPHome Device Builder -description: Tutorial for How To Switching to Beta branch with ESPHome Device Builder. +title: How To Switch to Beta branch with ESPHome Device Builder +description: Tutorial for How To Switch to Beta branch with ESPHome Device Builder. --- # Switching to Beta branch with ESPHome Device Builder @@ -107,7 +107,7 @@ description: Tutorial for How To Switching to Beta branch with ESPHome Device Bu refresh: 1min ``` -=== "R_PRO-1" +=== "R PRO-1" **Ethernet:** @@ -120,7 +120,7 @@ description: Tutorial for How To Switching to Beta branch with ESPHome Device Bu refresh: 1min ``` - **WiFi:** + **Wi-Fi:** ```yaml packages: diff --git a/docs/products/general/temp-hum-calibration.md b/docs/products/general/temp-hum-calibration.md index 8c29d0b18f..ce977fcc45 100755 --- a/docs/products/general/temp-hum-calibration.md +++ b/docs/products/general/temp-hum-calibration.md @@ -6,7 +6,7 @@ description: Temp and Humidity Calibration and Offset Examples. ### **Simple Offsets for Temperature and Humidity:** -**Please add these to the bottom of your esphome yaml for your device then click save and install. Once you are finished, you will have two new boxes inside the home assistant esphome integration device page for your device where you can fill in an offset. Give them up to 1minute to take effect!** +**Please add these to the bottom of your ESPHome yaml for your device then click save and install. Once you are finished, you will have two new boxes inside the Home Assistant ESPHome integration device page for your device where you can fill in an offset. Give them up to 1 minute to take effect!** ```yaml sensor: @@ -55,11 +55,11 @@ The BME280 and SCD40 sensors are known for their precision in measuring temperat ### **Adjusting the BME280 and SCD40 Temperature Offset** -For users who want to fine-tune their sensors, the BME280 and SCD40 Temperature Offset entities can be manually adjusted to match the conditions in their home. The offset values are subtracted from the raw temperature & humidity readings in the firmware to update the sensor readings in the home assistant entity. For example: scd40\_temperature entity = raw scd40 temperature reading - scd40\_offset. +For users who want to fine-tune their sensors, the BME280 and SCD40 Temperature Offset entities can be manually adjusted to match the conditions in their home. The offset values are subtracted from the raw temperature & humidity readings in the firmware to update the sensor readings in the Home Assistant entity. For example: scd40\_temperature entity = raw scd40 temperature reading - scd40\_offset. By default, these offsets are preset to values based on our NIST certified thermometer, it's important to note that these values are calibrated for our environment. They might not be accurate for all settings. Therefore, by using a reference thermometer, users can adjust the difference between the readings to get a more accurate representation. -Users will also notice the `bme280_humidity_calibrated`, `scd40_humidity_calibrated`, `bme280_temperature_calibrated`, and `scd40_temperature_calibrated`entities. These values utilize the linear filter in the ESPHome firmware to adjust the readings based on our collected data. Again, due to environmental differences, these might not always be precise. +Users will also notice the `bme280_humidity_calibrated`, `scd40_humidity_calibrated`, `bme280_temperature_calibrated`, and `scd40_temperature_calibrated` entities. These values utilize the linear filter in the ESPHome firmware to adjust the readings based on our collected data. Again, due to environmental differences, these might not always be precise. ### **Modeling the Relationship Between Sensors** diff --git a/docs/products/general/troubleshooting/connection-issues.md b/docs/products/general/troubleshooting/connection-issues.md index ecdfcfd02e..a9aa0ee7f0 100755 --- a/docs/products/general/troubleshooting/connection-issues.md +++ b/docs/products/general/troubleshooting/connection-issues.md @@ -10,9 +10,9 @@ description: Suggestions for Connection Issues 4\. Disable [power save mode](https://esphome.io/components/wifi.html#power-save-mode) in ESPHome. (See directions below) -# WiFi Power Save Mode +# Wi-Fi Power Save Mode -The WiFi interface of all ESPs offer three power save modes to reduce the amount of power spent on WiFi. While some options *can* reduce the power usage of the ESP, they generally also decrease the reliability of the WiFi connection, with frequent disconnections from the router in the highest power saving mode. +The Wi-Fi interface of all ESPs offers three power save modes to reduce the amount of power spent on Wi-Fi. While some options *can* reduce the power usage of the ESP, they generally also decrease the reliability of the Wi-Fi connection, with frequent disconnections from the router in the highest power saving mode. * `NONE` (least power saving, Default for ESP8266) * `LIGHT` (Default for ESP32) @@ -28,7 +28,7 @@ wifi: ![ESPHome in the Home Assistant sidebar and the Edit button on an MSR-2 card circled](/assets/screenshot-2024-10-25-at-5-14-48-pm.png) -2\. Add the code below to your devices yaml file. Then select Save and press Install. +2\. Add the code below to your device's yaml file. Then select Save and press Install. ```yaml power_save_mode: none @@ -36,4 +36,4 @@ power_save_mode: none ![MSR-2 YAML with power_save_mode: none added under wifi and the Save and Install buttons circled](/assets/screenshot-2024-10-25-at-5-25-10-pm.png) -3\. Now your device should have a stronger connection. (This will cause the sensors internal temperature to increase.) \ No newline at end of file +3\. Now your device should have a stronger connection. (This will cause the sensor's internal temperature to increase.) \ No newline at end of file diff --git a/docs/products/general/troubleshooting/firmware-updates-not-appearing.md b/docs/products/general/troubleshooting/firmware-updates-not-appearing.md index ed0f7b66b6..33cfe83d96 100644 --- a/docs/products/general/troubleshooting/firmware-updates-not-appearing.md +++ b/docs/products/general/troubleshooting/firmware-updates-not-appearing.md @@ -12,7 +12,7 @@ Apollo devices check for new firmware by downloading a small manifest file from 2\. **Give it a moment after a reboot — or update your firmware.** -* On older firmware the very first update check after a boot can be skipped if WiFi isn't connected yet, and the next check only happens about 6 hours later. Newer firmware checks as soon as the network connects. +* On older firmware the very first update check after a boot can be skipped if Wi-Fi isn't connected yet, and the next check only happens about 6 hours later. Newer firmware checks as soon as the network connects. * If the entity looks stale right after a reboot, either wait, reboot once more while the network is up, or update to the latest firmware release. 3\. **Devices adopted in the ESPHome Device Builder update differently.** diff --git a/docs/products/general/troubleshooting/removing-device-from-home-assistant.md b/docs/products/general/troubleshooting/removing-device-from-home-assistant.md index 2b74b4c76f..49c6af74c0 100755 --- a/docs/products/general/troubleshooting/removing-device-from-home-assistant.md +++ b/docs/products/general/troubleshooting/removing-device-from-home-assistant.md @@ -1,6 +1,6 @@ --- title: Removing Device From Home Assistant -description: Tutorial to Removing Device From Home Assistant. +description: Tutorial for Removing Device From Home Assistant. --- # Removing Device From Home Assistant diff --git a/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md b/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md index 1af8f41aea..84275a51c7 100755 --- a/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md +++ b/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md @@ -1,16 +1,16 @@ --- -title: Ubiquiti Unifi mDNS Auto Discover Issue -description: Tutorial to help fix the Ubiquiti Unifi mDNS Auto Discover Issue. +title: Ubiquiti UniFi mDNS Auto Discover Issue +description: Tutorial to help fix the Ubiquiti UniFi mDNS Auto Discover Issue. --- -# Ubiquiti Unifi mDNS Auto Discover Issue +# Ubiquiti UniFi mDNS Auto Discover Issue !!! tip "If mDNS is unchecked then Home Assistant and ESPHome will not auto discover new devices" - If you have different networks that Homey and ESPHome devices are on, then you will need mDNS working across both networks and firewall rules allowing access between them. Below are guides for using your PC and the Unifi iOS app to fix this issue. + If you have different networks that Homey and ESPHome devices are on, then you will need mDNS working across both networks and firewall rules allowing access between them. Below are guides for using your PC and the UniFi iOS app to fix this issue. ##### **Method 1: Browser** -1\. Log into your Unifi network through your default IP address which is usually http://192.168.1.1 +1\. Log into your UniFi network through your default IP address which is usually http://192.168.1.1 2\. Select Network. @@ -34,7 +34,7 @@ description: Tutorial to help fix the Ubiquiti Unifi mDNS Auto Discover Issue. 7\. Now the Home Assistant/ESPHome auto-discover issue should be fixed! -##### **Method 2: Unifi iOS App.** +##### **Method 2: UniFi iOS App.** 1\. Open the UniFi app. diff --git a/docs/products/general/tutorials/change-co2-update-interval.md b/docs/products/general/tutorials/change-co2-update-interval.md index bd8778794e..4caed22372 100644 --- a/docs/products/general/tutorials/change-co2-update-interval.md +++ b/docs/products/general/tutorials/change-co2-update-interval.md @@ -8,7 +8,7 @@ This guide will show you how to edit the CO2 updates down to 5 second !!! tip "Your sensor is defaulting to 60 seconds for updates to the state of the CO2 sensor." - This is the default for all esphome devices using the SCD40 because it uses less Wi-Fi airtime fairness and writes less to your Home Assistant Database. 5 seconds is the minimum. The SCD40 hardware cannot produce a new reading faster than that. + This is the default for all ESPHome devices using the SCD40 because it uses less Wi-Fi airtime fairness and writes less to your Home Assistant Database. 5 seconds is the minimum. The SCD40 hardware cannot produce a new reading faster than that. !!! note "Sensor response time" diff --git a/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md b/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md index dad0437d5c..4bc97d5a92 100755 --- a/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md +++ b/docs/products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md @@ -8,13 +8,13 @@ This guide will show you how to edit the lux updates down to 5 seconds. !!! tip "Your sensor is defaulting to 60 seconds for updates to the state of the lux sensor." - This is the default for all esphome devices using lux because it uses less Wi-Fi airtime fairness and writes less to your Home Assistant Database. Suggested not to go below 5 seconds. + This is the default for all ESPHome devices using lux because it uses less Wi-Fi airtime fairness and writes less to your Home Assistant Database. Suggested not to go below 5 seconds. 1\. Select the ESPHome Builder in the sidebar then click "EDIT" on the device you want to change. ![ESPHome Builder in the Home Assistant sidebar with the Edit button on an AIR-1 card outlined](/assets/update-frequency-pic-1.png) -2\. Copy this code and enter it just like shown in the next step. Make sure there are no extra spaces or any other characters it needs to look just like the example in the next step. +2\. Copy this code and enter it just like shown in the next step. Make sure there are no extra spaces or any other characters. It needs to look just like the example in the next step. ```yaml #LUX sensor update interval diff --git a/docs/products/general/tutorials/smartthings-direct-control.md b/docs/products/general/tutorials/smartthings-direct-control.md index d4f85da066..048efbe9c9 100644 --- a/docs/products/general/tutorials/smartthings-direct-control.md +++ b/docs/products/general/tutorials/smartthings-direct-control.md @@ -120,7 +120,7 @@ Below is the complete, production-tested YAML. Replace all `YOUR_*` placeholders !!! tip "Key Design Decisions" 1. **`wifi: on_connect` instead of `on_boot`** — the ESP-IDF HTTP stack is not ready at boot time. Using `on_connect` with a 15-second delay guarantees the network is fully available before the first token refresh fires. - 2. **`script: mode: single`** — prevents a second token refresh from being triggered while the first one is still running. This is critical during router reboots or mesh WiFi reconnects where `wifi: on_connect` can fire multiple times in rapid succession. + 2. **`script: mode: single`** — prevents a second token refresh from being triggered while the first one is still running. This is critical during router reboots or mesh Wi-Fi reconnects where `wifi: on_connect` can fire multiple times in rapid succession. 3. **`restore_value: yes` on `st_refresh_token`** — saves the latest refresh token to NVS flash after every successful renewal. It survives reboots and power cuts. The `initial_value` in the YAML is only ever used on the very first flash. 4. **`body: !lambda |-`** — plain string bodies are silently ignored by the ESP-IDF HTTP client. The lambda syntax is required for the POST body to actually be sent. @@ -286,7 +286,7 @@ binary_sensor: esphome run your_config.yaml --device 192.168.x.x ``` -Within 15 seconds of connecting to WiFi, you should see in the logs: +Within 15 seconds of connecting to Wi-Fi, you should see in the logs: ```text [oauth] >>> WiFi ready, firing token refresh @@ -323,7 +323,7 @@ After the first flash, the `initial_value` in the YAML is never used again. The The refresh token was invalidated. This can happen if the device was offline for more than 30 days, or if a previous refresh failed mid-way. Re-run the browser OAuth flow from Part 2, update both `initial_value` fields in your YAML, flash once, and the self-sustaining chain resumes from there. !!! warning "400 `invalid_grant` after router reboot or power outage" - This is the trickiest failure mode. It happens when the device reconnects to WiFi multiple times in quick succession (e.g. during a router restart), causing two parallel token refresh calls. Both use the same refresh token — one succeeds, one invalidates it. The broken token then gets saved to NVS flash and survives every reboot. + This is the trickiest failure mode. It happens when the device reconnects to Wi-Fi multiple times in quick succession (e.g. during a router restart), causing two parallel token refresh calls. Both use the same refresh token — one succeeds, one invalidates it. The broken token then gets saved to NVS flash and survives every reboot. `mode: single` on the script prevents this going forward, but if you already have a broken NVS token, here is the recovery procedure (no USB required): @@ -340,7 +340,7 @@ After the first flash, the `initial_value` in the YAML is never used again. The If that returns 400 too, use the browser OAuth flow from Part 2 to get a completely fresh pair. - **Step 2 — Flash 1: add an `on_boot` override** (priority 600 runs after NVS load but before WiFi): + **Step 2 — Flash 1: add an `on_boot` override** (priority 600 runs after NVS load but before Wi-Fi): ```yaml esphome: diff --git a/docs/products/h1/faq.md b/docs/products/h1/faq.md index bccfee50b3..8a65b1b7f9 100755 --- a/docs/products/h1/faq.md +++ b/docs/products/h1/faq.md @@ -33,7 +33,7 @@ description: Frequently asked questions about the H-1. 7\. **How do I set up the Apollo H-1 with Home Assistant?** -* To integrate the H-1 with Home Assistant, follow getting started guide or reach out to our support team for assistance. Once connected, you can unlock additional functionality and customization. +* To integrate the H-1 with Home Assistant, follow the getting started guide or reach out to our support team for assistance. Once connected, you can unlock additional functionality and customization. 8\. **Does the ornament require any additional power source?** @@ -43,9 +43,9 @@ description: Frequently asked questions about the H-1. * Yes, the H-1 makes a wonderful gift! It’s unique, festive, and supports a good cause, making it a great option for holiday gifting. -10\. **My H-1 is draining battery too fast- how do i fix this?** +10\. **My H-1 is draining battery too fast- how do I fix this?** -* Please make sure if you are on the smart firmware to disable the "prevent sleep" option on the home assistant device page! +* Please make sure if you are on the smart firmware to disable the "prevent sleep" option on the Home Assistant device page! 11\. **Where can I find more information about the Apollo H-1 and similar products?** diff --git a/docs/products/h1/reflash.md b/docs/products/h1/reflash.md index c3f938a1c6..9b7abf7389 100755 --- a/docs/products/h1/reflash.md +++ b/docs/products/h1/reflash.md @@ -6,7 +6,7 @@ If your device becomes unresponsive and you've exhausted the other troubleshooti If your device has already been connected to Home Assistant previously please refer to Removing Device From Home Assistant first before proceeding -1. Hold the boot button then plug your sensor into your computer with a quality USB-C cable that supports data transfer. Let go of the boot button once you plug the usb cable in! +1. Hold the boot button then plug your sensor into your computer with a quality USB-C cable that supports data transfer. Let go of the boot button once you plug the USB cable in! 2. Navigate to our installer page and click connect [\*\* Install Page \*\*](https://apolloautomation.github.io/H-1/) 3. Select your Apollo device, it will show with a similar name to the one below, and click connect. If you aren't sure which device it is, you can unplug the sensor and see which disappears. @@ -24,7 +24,7 @@ If no device shows, click cancel and then install the recommended driver that sh 6\. VERY IMPORTANT - you need to unplug your device and plug it back in to leave boot mode! -1. After finishing, check for the Apollo hotspot and connect. This might not show if you previously had the H-1 connected to your wifi +1. After finishing, check for the Apollo hotspot and connect. This might not show if you previously had the H-1 connected to your Wi-Fi 2. Log into Home Assistant and go to the ESPHome app check to see if you can adopt the device. If you encounter the below error, please complete the [Putting H-1 In Boot Mode Document](https://wiki.apolloautomation.com/products/h1/boot-mode/) and go back to step 3. diff --git a/docs/products/h2/faq.md b/docs/products/h2/faq.md index 0f93fb26ee..761b21f261 100755 --- a/docs/products/h2/faq.md +++ b/docs/products/h2/faq.md @@ -32,15 +32,15 @@ description: Frequently asked questions about the H-2. 8\. **Does the ornament require any additional power source?** -* The Apollo H-2 can operate on battery power, making it easy to hang and place wherever you'd like in your holiday decorations. It uses a 16340 rechargeable battery. It can also be powered by the USB-C port. The H-2 USB-C port will not charge the battery you need a dedicated 16340 charger such as this nitecore model. +* The Apollo H-2 can operate on battery power, making it easy to hang and place wherever you'd like in your holiday decorations. It uses a 16340 rechargeable battery. It can also be powered by the USB-C port. The H-2 USB-C port will not charge the battery. You need a dedicated 16340 charger such as this nitecore model. 9\. **Can I gift the Apollo H-2 to friends or family?** * Yes, the H-2 makes a wonderful gift! It’s unique, festive, and supports a good cause, making it a great option for holiday gifting. -10\. **My H-2 is draining battery too fast- how do i fix this?** +10\. **My H-2 is draining battery too fast- how do I fix this?** -* Please make sure if you are on the smart firmware to disable the "prevent sleep" option on the home assistant device page! +* Please make sure if you are on the smart firmware to disable the "prevent sleep" option on the Home Assistant device page! 11\. **Where can I find more information about the Apollo H-2 and similar products?** diff --git a/docs/products/h2/introduction.md b/docs/products/h2/introduction.md index b1eb4bb499..63e5c9d404 100755 --- a/docs/products/h2/introduction.md +++ b/docs/products/h2/introduction.md @@ -10,6 +10,6 @@ The Apollo H-2 is the second edition of our annual holiday ornament! It's our wa The H-2 ships pre-flashed with a basic firmware featuring four classic holiday tunes. Simply press any of the four buttons on the back to play: Button 1 for Jingle Bells, Button 2 for Rudolph the Red-Nosed Reindeer, Button 3 for Let it Snow, and Button 4 for Blue Christmas. The LEDs light up with unique effects to match each tune! -You can also integrate it with Home Assistant to unlock more features, such as changing the songs and LED effects, bluetooth proxy, and bluetooth tracking. You will need to reflash it to the smart firmware first! +You can also integrate it with Home Assistant to unlock more features, such as changing the songs and LED effects, Bluetooth proxy, and Bluetooth tracking. You will need to reflash it to the smart firmware first! **New for 2025:** The H-2 features four dedicated song buttons (no more multi-click!), upgraded ESP32-C6 processor with 8MB flash, 58 RGB LEDs (up from 22), and a logo light for enhanced visual appeal. \ No newline at end of file diff --git a/docs/products/h2/troubleshooting/reflash.md b/docs/products/h2/troubleshooting/reflash.md index 2bd64bb804..a3519beeed 100755 --- a/docs/products/h2/troubleshooting/reflash.md +++ b/docs/products/h2/troubleshooting/reflash.md @@ -34,4 +34,4 @@ description: Step by step guide for re-flashing the H-2 back to factory firmware Your device is still in boot mode and needs to be power cycled aka power removed to make it boot in a normal mode! -[Head to the Getting Started article to setup your H-2 as a new device!](https://wiki.apolloautomation.com/products/h2/setup/getting-started/){ .md-button .md-button--primary } \ No newline at end of file +[Head to the Getting Started article to set up your H-2 as a new device!](https://wiki.apolloautomation.com/products/h2/setup/getting-started/){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/h3/introduction.md b/docs/products/h3/introduction.md index 6748dc30fc..8cf3beeb95 100644 --- a/docs/products/h3/introduction.md +++ b/docs/products/h3/introduction.md @@ -14,6 +14,6 @@ The H-3 ships pre-flashed with a basic firmware and six holiday tunes. Press one Each tune comes with its own LED effect. -You can also integrate it with Home Assistant to unlock more features, such as changing the songs and LED effects, bluetooth proxy, and bluetooth tracking. You will need to reflash it to the smart firmware first! +You can also integrate it with Home Assistant to unlock more features, such as changing the songs and LED effects, Bluetooth proxy, and Bluetooth tracking. You will need to reflash it to the smart firmware first! **New for 2026:** The H-3 has 37 RGB LEDs split into five zones you can control separately (body, hat, eyes, nose, and mouth), six songs across three buttons, and runs on two AA batteries. diff --git a/docs/products/h3/troubleshooting/reflash.md b/docs/products/h3/troubleshooting/reflash.md index 3bf4d6e767..67b6787325 100644 --- a/docs/products/h3/troubleshooting/reflash.md +++ b/docs/products/h3/troubleshooting/reflash.md @@ -23,4 +23,4 @@ description: "Step by step guide for re-flashing the H-3 back to factory firmwar Your device is still in boot mode and needs to be power cycled aka power removed to make it boot in a normal mode! -[Head to the Getting Started article to setup your H-3 as a new device!](https://wiki.apolloautomation.com/products/h3/setup/getting-started/){ .md-button .md-button--primary } +[Head to the Getting Started article to set up your H-3 as a new device!](https://wiki.apolloautomation.com/products/h3/setup/getting-started/){ .md-button .md-button--primary } diff --git a/docs/products/led1/examples/led-1-controlling-govee-lights.md b/docs/products/led1/examples/led-1-controlling-govee-lights.md index de7d20d282..fe41ac099c 100755 --- a/docs/products/led1/examples/led-1-controlling-govee-lights.md +++ b/docs/products/led1/examples/led-1-controlling-govee-lights.md @@ -24,7 +24,7 @@ description: >- ![Hobby knife cutting a slit in a rubber grommet removed from the project box](/assets/led-1-govee-grommets.jpg) -4\. Connect the barrel plug to the WAGO connector. It is the large white compnent on the bottom left of the board below the USB-C port. Connect the RED (+) wire to the top terminal and the BLACK (-) wire to the bottom terminal. You can use the tweezers to depress the top of the WAGO connector, insert the wire, and then release to lock it in place. +4\. Connect the barrel plug to the WAGO connector. It is the large white component on the bottom left of the board below the USB-C port. Connect the RED (+) wire to the top terminal and the BLACK (-) wire to the bottom terminal. You can use the tweezers to depress the top of the WAGO connector, insert the wire, and then release to lock it in place. ![Tweezers pressing the WAGO lever on the LED-1 to insert the red and black barrel plug wires](/assets/led-1-govee-barrel-2.jpg) diff --git a/docs/products/led1/setup/getting-started-led1.md b/docs/products/led1/setup/getting-started-led1.md index 259d113051..1dc0ea93a7 100755 --- a/docs/products/led1/setup/getting-started-led1.md +++ b/docs/products/led1/setup/getting-started-led1.md @@ -58,7 +58,7 @@ The LED-1 can be powered via USB (5V up to 3 amps) or via USB Power Delivery (5V Your device is now ready to connect to your Wi-Fi and begin controlling via Home Assistant, the WLED app for iPhone and Android, or via a web browser! -1\. Plug your power supply or usb-c power in and the LED-1 device will boot within a couple seconds. Head to the available Wi-Fi networks on your phone and select WLED-AP. It should pop up saying "Welcome to WLED!". If this popup does not occur, please open a web browser and navigate to http://4.3.2.1/ and you should be prompted with the same image seen below. +1\. Plug your power supply or USB-C power in and the LED-1 device will boot within a couple seconds. Head to the available Wi-Fi networks on your phone and select WLED-AP. It should pop up saying "Welcome to WLED!". If this popup does not occur, please open a web browser and navigate to http://4.3.2.1/ and you should be prompted with the same image seen below. ![WLED Welcome to WLED page with WiFi Settings and To the Controls buttons](/assets/led-1-getting-started-pic-1.png) diff --git a/docs/products/led1/setup/led1-replace-fuse.md b/docs/products/led1/setup/led1-replace-fuse.md index 63f38fe332..771dd070d1 100755 --- a/docs/products/led1/setup/led1-replace-fuse.md +++ b/docs/products/led1/setup/led1-replace-fuse.md @@ -8,7 +8,7 @@ description: Tutorial showing how to replace the 10 A Fuse on the LED-1. ![Tweezers prying the lid off the blue LED-1 case](/assets/led-1-pry-open-lid.jpg)![LED-1 board in the blue case with the lid removed and set aside](/assets/led-1-case-with-lid-off.jpg) -2\. Gently lift the LED-1 PCB out of the case - be careful not use a lot of force this could break components +2\. Gently lift the LED-1 PCB out of the case - be careful not to use a lot of force this could break components ![Fingers lifting the LED-1 board out of its blue case](/assets/led-1-lift-out-of-case.jpg) diff --git a/docs/products/led1/troubleshooting/led1-reflash.md b/docs/products/led1/troubleshooting/led1-reflash.md index b79ed21fe5..c3e680803f 100755 --- a/docs/products/led1/troubleshooting/led1-reflash.md +++ b/docs/products/led1/troubleshooting/led1-reflash.md @@ -14,7 +14,7 @@ description: Step by step guide for re-flashing the LED-1 back to factory firmwa 4\. Download ESP Flasher (Windows EXE) and open it. -5\. Click the **Serial Port** dropdown and choose the available COM port.. +5\. Click the **Serial Port** dropdown and choose the available COM port. ![ESP Flasher window with COM12 selected in the Serial port dropdown](/assets/m-1-select-open-com-port.png) @@ -28,4 +28,4 @@ description: Step by step guide for re-flashing the LED-1 back to factory firmwa 8\. The device is still in **boot mode** and needs to be power cycled. To reboot it, either unplug the power cable or press the **reset button** on the back of the device (the button on the right). -[Head to the Getting Started article to setup your M-1 as a new device!](https://wiki.apolloautomation.com/products/m1/setup/getting-started-m1/){ .md-button .md-button--primary } \ No newline at end of file +[Head to the Getting Started article to set up your M-1 as a new device!](https://wiki.apolloautomation.com/products/m1/setup/getting-started-m1/){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/products/m1/examples/add-gifs-to-wled.md b/docs/products/m1/examples/add-gifs-to-wled.md index 4cebbd9ed9..aec9388dea 100755 --- a/docs/products/m1/examples/add-gifs-to-wled.md +++ b/docs/products/m1/examples/add-gifs-to-wled.md @@ -39,9 +39,9 @@ Getting it onto the matrix depends on your firmware. WLED converts and resizes o 5\. Open a web browser and navigate to `http://` or `http://.local`. - !!! null "If you need help figuring out your hostname you can edit it from the wled wifi settings" + !!! null "If you need help figuring out your hostname you can edit it from the WLED Wi-Fi settings" - You can use an app like "wled-native" on iOS to auto-discover your WLED devices and then go into wifi settings to see your IP and hostname! Here's a step-by-step guide. + You can use an app like "wled-native" on iOS to auto-discover your WLED devices and then go into Wi-Fi settings to see your IP and hostname! Here's a step-by-step guide. 6\. Click **Config**, then scroll down and click **File System** then click **Browse** and select the resized and renamed gif we just created then click **Save**. @@ -65,6 +65,6 @@ Getting it onto the matrix depends on your firmware. WLED converts and resizes o !!! warning "Use a browser, not the WLED phone app" - The app's file picker greys out image files, so uploading a GIF from it does not work. That is a bug in the app rather than anything on the M-1. Open the device in any browser instead. + The app's file picker grays out image files, so uploading a GIF from it does not work. That is a bug in the app rather than anything on the M-1. Open the device in any browser instead. GIFs live on the M-1 itself and the space is limited. Delete images you are not using from **Config**, then **File System**. diff --git a/docs/products/m1/examples/qr-code-generator.md b/docs/products/m1/examples/qr-code-generator.md index bace8124c0..7ec7d1ecf4 100755 --- a/docs/products/m1/examples/qr-code-generator.md +++ b/docs/products/m1/examples/qr-code-generator.md @@ -12,7 +12,7 @@ description: Step by step guide to setting up your own QR code for Wi-Fi, link t The WLED firmware on your device will allow you to call these presets in automations or make buttons to control them on your Home Assistant dashboard! -1\. Fill in the SSID (your Wi-FI name) and your Wi-FI password then click Generate QR Code and finally click Download. +1\. Fill in the SSID (your Wi-Fi name) and your Wi-Fi password then click Generate QR Code and finally click Download.
-The TEMP Pro-1 can be used with an optional temperature probe which come in two lengths and or dust-proof temp and humidity probe (SHT20). It also features an AHT20-F air temperature and humidity sensor, 4x RGB LEDs, and a piezo buzzer. +The TEMP Pro-1 can be used with an optional temperature probe which comes in two lengths and/or dust-proof temp and humidity probe (SHT20). It also features an AHT20-F air temperature and humidity sensor, 4x RGB LEDs, and a piezo buzzer. It includes two mezzanine connectors for our GPIO Header addon, CO2 addon, and any future addons using that port. It also includes a Sen5x/Sen6x port which is used to connect the SEN55 on our AIR-1. It even includes a DFrobot port (MiCS port on AIR-1) and a QWIIC port! diff --git a/docs/products/temppro1/reviews.md b/docs/products/temppro1/reviews.md index 4b58230364..d5439c23e8 100755 --- a/docs/products/temppro1/reviews.md +++ b/docs/products/temppro1/reviews.md @@ -1,6 +1,6 @@ --- title: TEMP Pro-1 Reviews -description: Youtuber reviews and feedback about the TEMP Pro-1 sensor from Apollo Automation. +description: YouTuber reviews and feedback about the TEMP Pro-1 sensor from Apollo Automation. --- These Reviews need to be swapped for new ones diff --git a/docs/products/temppro1/setup/temp-pro-1-sensor-definitions.md b/docs/products/temppro1/setup/temp-pro-1-sensor-definitions.md index 9b126c95ca..f93d5191db 100755 --- a/docs/products/temppro1/setup/temp-pro-1-sensor-definitions.md +++ b/docs/products/temppro1/setup/temp-pro-1-sensor-definitions.md @@ -79,7 +79,7 @@ Once added to Home Assistant you can configure different settings for your senso **Prevent Sleep** - * Prevents the TEMP-1 from going to sleep. When sleeping, your TEMP-1 will NOT respond to home assistant it is effectively off until it wakes up again. + * Prevents the TEMP-1 from going to sleep. When sleeping, your TEMP-1 will NOT respond to Home Assistant it is effectively off until it wakes up again. * Click on the toggle to turn on or off. Defaults to ON. **Probe Temp Difference Threshold** diff --git a/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md b/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md index ccbf87f961..fb25fe7acf 100755 --- a/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md +++ b/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md @@ -14,7 +14,7 @@ description: Step by step guide for putting The TEMP Pro-1 In Boot Mode. ![Prying up the TEMP Pro-1 lid at the slit above the USB-C port](/assets/temp-pro-1-boot-button-lift-lid-jpg.jpeg) -2\. Locate the boot button as show in the image below. +2\. Locate the boot button as shown in the image below. ![Tool pointing at the BOOT button on the TEMP Pro-1 board](/assets/temp-pro-1-boot-button.jpeg) diff --git a/docs/products/temppro1/troubleshooting/temp-pro1-code.md b/docs/products/temppro1/troubleshooting/temp-pro1-code.md index dd0b9f3746..ba2e70174e 100755 --- a/docs/products/temppro1/troubleshooting/temp-pro1-code.md +++ b/docs/products/temppro1/troubleshooting/temp-pro1-code.md @@ -38,4 +38,4 @@ If your device has already been connected to Home Assistant please proceed to the getting started guide and setup your sensor as a new device! \ No newline at end of file +7\. Please proceed to the getting started guide and set up your sensor as a new device! \ No newline at end of file From 402915c9263d2256869f26613d17a9a1e1830896 Mon Sep 17 00:00:00 2001 From: Justin Bunton <130115204+Bunton33@users.noreply.github.com> Date: Mon, 12 Oct 2026 06:31:36 -0400 Subject: [PATCH 3/4] docs: fix headings, front matter, and broken includes - Add the missing front matter title to 273 pages, from the page's H1 or, for pages without one, its nav label (which MkDocs already shows as the title, so nothing visible changes). - Renumber 431 headings on 134 pages so levels no longer skip (e.g. "##### Method 1" directly under the H1 becomes "## Method 1") and each page keeps one H1. Relative hierarchy is kept, so these sections now appear in the sidebar table of contents. The two landing pages keep their designed heading sizes. - Bump 19 snippet include line offsets so they still start at the same content line after the title insertion. - Fix 4 includes that pulled in another page's front matter, which rendered a stray "description: ..." heading (Homey PLT-1B reviews and Flower Card, Homey MSR-2 mmWave videos, Homey zone configuration). - Replace 14 front matter descriptions that were the literal string ">-" (a flattened YAML folded scalar) with the description of the page they include. - Remove a stray empty code fence in bluetooth-tracking.md that turned the whole Android section (links, 10 steps, 6 screenshots) into one code block, and a stray horizontal rule on the Homey AIR-1 tips page. Verified by diffing the rendered text of all 686 pages before and after: only the 6 pages fixed above changed visible text. Co-Authored-By: Claude Opus 5.5 --- ...g-the-mics-4514-gas-sensor-to-the-air-1.md | 1 + docs/homey/products/air1/air1-reviews.md | 1 + docs/homey/products/air1/faq.md | 1 + docs/homey/products/air1/introduction.md | 1 + .../homey/products/air1/setup/general-tips.md | 30 +++++++++---------- .../products/air1/setup/prevent-sleep.md | 1 + .../products/air1/setup/sensor-definitions.md | 1 + .../air1/troubleshooting/air1-boot-mode.md | 5 ++-- .../air1/troubleshooting/air1-code.md | 1 + .../air1-reset-wi-fi-credentials.md | 1 + .../air1/troubleshooting/air1-teardown.md | 1 + .../btn1/additional-info/prevent-sleep.md | 1 + docs/homey/products/btn1/addons/btn1-addon.md | 1 + .../battery-sensors/wake-up-battery-sensor.md | 1 + .../homey/products/btn1/examples/blueprint.md | 3 +- .../btn1/examples/example-automation.md | 1 + docs/homey/products/btn1/faq.md | 1 + docs/homey/products/btn1/introduction.md | 1 + .../homey/products/btn1/setup/general-tips.md | 1 + .../products/btn1/setup/getting-started.md | 1 + .../products/btn1/setup/sensor-definitions.md | 1 + .../btn1/troubleshooting/btn1-boot-mode.md | 1 + .../btn1/troubleshooting/btn1-reflash.md | 1 + .../btn1-reset-wi-fi-credentials.md | 1 + .../btn1/troubleshooting/btn1-teardown.md | 3 +- .../co2-calibration.md | 1 + .../calibrating-and-updating/mmwave-videos.md | 1 + .../zone-configuration/zones-hlk.md | 2 +- docs/homey/products/general/comparisons.md | 1 + .../products/general/contact-us/Facebook.md | 2 +- .../products/general/contact-us/GitHub.md | 2 +- .../products/general/contact-us/Instagram.md | 2 +- .../products/general/contact-us/Reddit.md | 2 +- .../products/general/contact-us/YouTube.md | 2 +- .../contact-us/apollo-automation-shop.md | 2 +- .../general/contact-us/contact-us-support.md | 3 +- .../products/general/contact-us/our-team.md | 2 +- docs/homey/products/general/faq.md | 1 + docs/homey/products/general/links.md | 1 + docs/homey/products/general/resellers.md | 1 + .../general/setup/getting-started-air1.md | 3 +- .../general/setup/getting-started-msr1.md | 2 +- .../general/setup/getting-started-msr2.md | 3 +- .../general/setup/getting-started-mtr1.md | 3 +- .../general/setup/getting-started-plt1.md | 3 +- .../general/setup/getting-started-temp1.md | 2 +- .../products/general/setup/getting-started.md | 7 +++-- .../general/setup/renaming-apollo-devices.md | 1 + .../opnsense-mdns-auto-discover-issue.md | 1 + .../removing-device-from-homey.md | 1 + ...ubiquiti-unifi-mdns-auto-discover-issue.md | 1 + .../led-1-controlling-govee-lights.md | 2 +- .../m1/addons/adding-microphone-to-m-1.md | 1 + .../products/m1/addons/wizmote-remote.md | 1 + .../homey/products/m1/choose-your-firmware.md | 1 + .../products/m1/examples/add-gifs-to-wled.md | 3 +- .../homey/products/m1/examples/pixel-forge.md | 1 + .../products/m1/examples/qr-code-generator.md | 1 + .../products/m1/examples/scrolling-text.md | 1 + .../share-data-from-home-assistant.md | 3 +- docs/homey/products/m1/faq.md | 1 + docs/homey/products/m1/introduction.md | 1 + docs/homey/products/m1/m1-reviews.md | 1 + .../products/m1/setup/getting-started-m1.md | 1 + .../products/m1/setup/m1-general-tips.md | 1 + .../products/m1/setup/m1-matrix-settings.md | 3 +- .../products/m1/setup/m1-multiple-panels.md | 1 + docs/homey/products/m1/setup/m1-segments.md | 3 +- .../products/m1/setup/upgrade-to-wled.md | 1 + .../products/m1/setup/use-without-wifi.md | 1 + .../m1/troubleshooting/m1-boot-mode.md | 1 + .../m1-find-ip-address-and-hostname.md | 3 +- .../m1/troubleshooting/m1-panel-faults.md | 1 + .../products/m1/troubleshooting/m1-reflash.md | 1 + .../addons/adding-90-degree-usb-c-to-msr-2.md | 1 + .../msr2/addons/adding-co2-to-msr-2.md | 1 + .../addons/adding-gpio-header-to-msr-2.md | 1 + .../addons/adding-rear-female-usb-to-msr-2.md | 1 + .../gpio-header-control-an-led-strip.md | 1 + .../products/msr2/examples/msr2-alarmo.md | 1 + .../products/msr2/examples/msr2-dashboards.md | 1 + .../msr2/examples/using-msr-2-buzzer.md | 1 + docs/homey/products/msr2/faq.md | 1 + docs/homey/products/msr2/introduction.md | 1 + .../home-tech-innovations-msr-2-review.md | 1 + .../michael-leen-msr-2-review.md | 1 + .../msr-2-reviews/mostlychris-msr-2-review.md | 1 + .../simon-says-home-assistant-msr-2-review.md | 1 + .../smart-home-australia-msr-2-review.md | 1 + .../smart-home-scene-msr-2-review.md | 1 + docs/homey/products/msr2/msr2-reviews.md | 11 +++---- .../msr2/setup/co2-calibration-for-msr-2.md | 3 +- ...-change-the-update-frequency-of-sensors.md | 3 +- .../products/msr2/setup/mmwave-videos.md | 3 +- .../products/msr2/setup/msr2-general-tips.md | 7 +++-- .../msr2/setup/msr2-sensor-definitions.md | 1 + .../msr2/setup/updating-msr-2-firmware.md | 3 +- docs/homey/products/msr2/setup/zones-ha.md | 1 + docs/homey/products/msr2/setup/zones-hlk.md | 1 + .../msr2/troubleshooting/msr2-boot-mode.md | 5 ++-- .../msr2/troubleshooting/msr2-code.md | 1 + .../msr2-reset-wi-fi-credentials.md | 1 + .../msr2/troubleshooting/msr2-teardown.md | 1 + .../products/mtr1/examples/crookedtoe-mtr1.md | 1 + ...mtr-1-home-assistant-dashboard-examples.md | 1 + .../products/mtr1/examples/mtr1-alarmo.md | 1 + .../mtr1/examples/using-mtr-1-buzzer.md | 1 + docs/homey/products/mtr1/faq.md | 1 + docs/homey/products/mtr1/introduction.md | 1 + .../home-tech-innovations-mtr-1-review.md | 1 + .../michael-leen-mtr-1-review.md | 3 +- .../simon-says-home-assistant-mtr-1-review.md | 1 + .../smart-home-australia-mtr-1-review.md | 1 + .../smart-home-scene-mtr-1-review.md | 1 + docs/homey/products/mtr1/mtr1-reviews.md | 9 +++--- .../mtr1/setup/co2-calibration-for-mtr-1.md | 3 +- .../homey/products/mtr1/setup/general-tips.md | 17 ++++++----- .../mtr-1-temperature-&-humidity-offsets.md | 13 ++++---- .../products/mtr1/setup/sensor-definitions.md | 1 + .../mtr1/setup/updating-mtr-1-firmware.md | 3 +- docs/homey/products/mtr1/setup/zones-hlk.md | 5 ++-- .../mtr1/troubleshooting/mtr1-boot-mode.md | 5 ++-- .../mtr1/troubleshooting/mtr1-code.md | 1 + .../mtr1-reset-wi-fi-credentials.md | 1 + .../mtr1/troubleshooting/mtr1-teardown.md | 1 + docs/homey/products/plt1/calibrate-plt1.md | 1 + .../products/plt1/examples/flower-card.md | 1 + docs/homey/products/plt1/faq.md | 1 + docs/homey/products/plt1/general-tips.md | 1 + docs/homey/products/plt1/introduction.md | 1 + docs/homey/products/plt1/reviews.md | 13 ++++---- .../plt1/setup/plt1-sensor-definitions.md | 1 + .../products/plt1/setup/prevent-sleep.md | 1 + .../plt1/troubleshooting/plt1-boot-mode.md | 5 ++-- .../plt1/troubleshooting/plt1-code.md | 1 + .../plt1-reset-wi-fi-credentials.md | 1 + .../plt1/troubleshooting/plt1-teardown.md | 1 + .../plt1b/additional-info/insert-battery.md | 1 + .../sensor-connection-check.md | 1 + .../battery-sensors/wake-up-battery-sensor.md | 1 + docs/homey/products/plt1b/calibrate-plt1.md | 1 + .../products/plt1b/examples/flower-card.md | 3 +- docs/homey/products/plt1b/faq.md | 1 + docs/homey/products/plt1b/general-tips.md | 1 + docs/homey/products/plt1b/introduction.md | 1 + docs/homey/products/plt1b/reviews.md | 3 +- .../plt1b/setup/getting-started-plt1.md | 3 +- .../plt1b/setup/plt1b-sensor-definitions.md | 1 + .../products/plt1b/setup/prevent-sleep.md | 1 + .../plt1b/troubleshooting/plt1b-boot-mode.md | 5 ++-- .../plt1b/troubleshooting/plt1b-code.md | 3 +- .../plt1b-reset-wi-fi-credentials.md | 1 + .../plt1b/troubleshooting/plt1b-teardown.md | 1 + .../addons/attaching-bottle-to-pump-1.md | 1 + .../attaching-fluid-level-sensors-pump-1.md | 1 + .../pump1/addons/attaching-tubes-to-pump-1.md | 1 + docs/homey/products/pump1/faq.md | 1 + docs/homey/products/pump1/introduction.md | 1 + .../pump1/setup/pump1-general-tips.md | 3 +- .../pump1/setup/pump1-sensor-definitions.md | 1 + .../pump1/troubleshooting/pump1-boot-mode.md | 1 + .../pump1/troubleshooting/pump1-reflash.md | 1 + .../pump1-reset-wi-fi-credentials.md | 1 + .../pump1/troubleshooting/pump1-teardown.md | 3 +- ...add-the-ld2412-mmwave-sensor-to-r-pro-1.md | 1 + .../rpro1/addons/adding-co2-to-r-pro-1.md | 1 + .../attaching-gang-box-mount-to-r-pro-1.md | 1 + .../install-ceiling-mount-for-r-pro-1.md | 1 + docs/homey/products/rpro1/faq.md | 1 + docs/homey/products/rpro1/introduction.md | 1 + docs/homey/products/rpro1/rpro1-reviews.md | 1 + .../rpro1/setup/rpro1-general-tips.md | 1 + .../rpro1/setup/rpro1-sensor-definitions.md | 1 + .../rpro1/setup/rpro1-switch-firmware.md | 3 +- docs/homey/products/rpro1/setup/zones-hlk.md | 5 ++-- .../rpro1/troubleshooting/rpro1-boot-mode.md | 1 + .../rpro1/troubleshooting/rpro1-code.md | 1 + .../rpro1-reset-wi-fi-credentials.md | 1 + .../rpro1/troubleshooting/rpro1-teardown.md | 1 + .../homey/products/temp1/addons/food-probe.md | 1 + .../products/temp1/addons/magnetic-mount.md | 1 + .../products/temp1/addons/multiple-probes.md | 1 + .../homey/products/temp1/addons/temp-probe.md | 1 + .../sensor-connection-check.md | 1 + .../battery-sensors/wake-up-battery-sensor.md | 1 + .../temp1/examples/temp1-alert-example.md | 1 + .../examples/temp1-automation-examples.md | 7 +++-- .../products/temp1/examples/use-cases.md | 1 + docs/homey/products/temp1/faq.md | 1 + docs/homey/products/temp1/introduction.md | 1 + docs/homey/products/temp1/reviews.md | 9 +++--- .../temp1/setup/getting-started-temp1.md | 1 + .../products/temp1/setup/prevent-sleep.md | 1 + .../temp1/setup/temp1-sensor-definitions.md | 1 + .../temp1/troubleshooting/temp1-boot-mode.md | 5 ++-- .../temp1/troubleshooting/temp1-code.md | 1 + .../temp1-reset-wi-fi-credentials.md | 1 + .../temp1/troubleshooting/temp1-teardown.md | 1 + .../products/temp1b/addons/food-probe.md | 1 + .../products/temp1b/addons/magnetic-mount.md | 1 + .../products/temp1b/addons/multiple-probes.md | 1 + .../products/temp1b/addons/temp-probe.md | 1 + .../sensor-connection-check.md | 1 + .../battery-sensors/wake-up-battery-sensor.md | 1 + .../temp1b/examples/temp1b-alert-example.md | 1 + .../examples/temp1b-automation-examples.md | 7 +++-- .../products/temp1b/examples/use-cases.md | 1 + docs/homey/products/temp1b/faq.md | 1 + docs/homey/products/temp1b/introduction.md | 1 + docs/homey/products/temp1b/reviews.md | 9 +++--- .../temp1b/setup/getting-started-temp1.md | 3 +- .../products/temp1b/setup/insert-battery.md | 1 + .../products/temp1b/setup/prevent-sleep.md | 1 + .../temp1b/setup/temp1b-sensor-definitions.md | 1 + .../troubleshooting/temp1b-boot-mode.md | 5 ++-- .../temp1b/troubleshooting/temp1b-code.md | 1 + .../temp1b-reset-wi-fi-credentials.md | 1 + .../temp1b/troubleshooting/temp1b-teardown.md | 1 + .../automations/motion-activated-light.md | 4 +-- .../automations/press-to-check-climate.md | 6 ++-- .../automations/temp-reactive-leds.md | 6 ++-- .../learning-the-basics/core-components.md | 10 +++---- .../device-builder-tour.md | 10 +++---- .../learning-the-basics/explaining-esphome.md | 4 +-- .../learning-the-basics/what-is-yaml.md | 10 +++---- .../ESPHome-Starter-Kit/modules/battery.md | 2 +- .../sen65-air-quality-sensor.md | 6 ++-- .../ESPHome-Starter-Kit/setup/first-steps.md | 14 ++++----- .../tutorials/connect-to-home-assistant.md | 4 +-- .../tutorials/remote-build-server.md | 10 +++---- .../tutorials/using-secrets.md | 24 +++++++-------- .../air-quality-sensor-comparison.md | 2 +- docs/products/air1/air1-reviews.md | 12 ++++---- .../air-1-temp-calibration.md | 3 +- .../air1/examples/air1-dashboard-examples.md | 18 +++++------ docs/products/air1/setup/general-tips.md | 26 ++++++++-------- .../air1/troubleshooting/air1-boot-mode.md | 4 +-- .../battery-sensors/wake-up-battery-sensor.md | 1 + docs/products/btn1/examples/blueprint.md | 4 +-- docs/products/btn1/setup/general-tips.md | 10 +++---- docs/products/btn1/setup/getting-started.md | 16 +++++----- .../btn1/troubleshooting/btn1-boot-mode.md | 4 +-- .../btn1/troubleshooting/btn1-teardown.md | 4 +-- .../additional-info/esphome-device-builder.md | 4 +-- .../cast1/examples/tts-announcements.md | 10 +++---- .../cast1/examples/wizmote-blueprint.md | 4 +-- docs/products/cast1/setup/getting-started.md | 14 ++++----- .../cast1/troubleshooting/cast1-boot-mode.md | 4 +-- .../radar-tuning/zones-ha.md | 5 ++-- .../radar-tuning/zones-hlk.md | 3 +- .../zone-configuration/zones-ha.md | 1 + .../zone-configuration/zones-hlk.md | 1 + docs/products/general/contact-us/Facebook.md | 1 + docs/products/general/contact-us/GitHub.md | 1 + docs/products/general/contact-us/Instagram.md | 1 + docs/products/general/contact-us/Reddit.md | 1 + docs/products/general/contact-us/YouTube.md | 1 + .../contact-us/apollo-automation-shop.md | 1 + .../general/contact-us/contact-us-support.md | 1 + docs/products/general/contact-us/our-team.md | 3 +- docs/products/general/faq.md | 20 ++++++------- .../products/general/setup/bluetooth-proxy.md | 4 +-- .../general/setup/bluetooth-tracking.md | 3 +- .../general/setup/getting-started-air1.md | 1 + .../general/setup/getting-started-msr1.md | 1 + .../general/setup/getting-started-msr2.md | 1 + .../general/setup/getting-started-mtr1.md | 1 + .../general/setup/getting-started-plt1.md | 1 + .../general/setup/getting-started-pump1.md | 1 + .../general/setup/getting-started-rpro1.md | 1 + .../general/setup/getting-started-temp1.md | 1 + .../products/general/setup/getting-started.md | 8 ++--- .../general/setup/renaming-apollo-devices.md | 6 ++-- docs/products/general/temp-hum-calibration.md | 12 ++++---- .../removing-device-from-home-assistant.md | 4 +-- ...ubiquiti-unifi-mdns-auto-discover-issue.md | 4 +-- .../battery-sensors/wake-up-battery-sensor.md | 1 + docs/products/h1/reviews.md | 8 ++--- .../battery-sensors/wake-up-battery-sensor.md | 1 + docs/products/h2/examples/holiday-songs.md | 3 +- docs/products/h2/h2-reviews.md | 8 ++--- .../led1/setup/getting-started-led1.md | 8 ++--- docs/products/led1/setup/led1-general-tips.md | 8 ++--- .../m1/addons/adding-microphone-to-m-1.md | 4 +-- docs/products/m1/addons/wizmote-remote.md | 8 ++--- docs/products/m1/choose-your-firmware.md | 2 +- .../share-data-from-home-assistant.md | 2 +- .../m1/setup/getting-started-m1-esphome.md | 16 +++++----- docs/products/m1/setup/getting-started-m1.md | 8 ++--- docs/products/m1/setup/m1-matrix-settings.md | 10 +++---- docs/products/m1/setup/m1-multiple-panels.md | 12 ++++---- docs/products/m1/setup/m1-wall-mounting.md | 10 +++---- docs/products/m1/setup/upgrade-to-wled.md | 2 +- docs/products/m1/setup/use-without-wifi.md | 6 ++-- .../m1/troubleshooting/m1-panel-faults.md | 2 +- .../msr1/additional-info/exposed-gpio.md | 1 + .../msr1/addons/adding-co2-to-msr-1.md | 1 + .../msr1/examples/msr-1-automation-guide.md | 1 + .../examples/msr-1-examples-from-github.md | 3 +- docs/products/msr1/examples/msr1-alarmo.md | 1 + .../products/msr1/examples/msr1-dashboards.md | 1 + .../msr1/examples/using-msr-1-buzzer.md | 1 + docs/products/msr1/faq.md | 1 + docs/products/msr1/introduction.md | 1 + .../beardedtinker-msr-1-review.md | 3 +- .../msr1/msr-1-reviews/drzzs-msr-1-review.md | 3 +- .../make-it-work-tech-msr-1-review.md | 5 ++-- .../msr-1-reviews/mostlychris-msr-1-review.md | 1 + .../simon-says-home-assistant-msr-1-review.md | 1 + .../smart-home-scene-msr-1-review.md | 3 +- docs/products/msr1/msr1-reviews.md | 11 +++---- .../msr1/setup/co2-calibration-for-msr-1.md | 3 +- docs/products/msr1/setup/general-tips.md | 9 +++--- docs/products/msr1/setup/mmwave-videos.md | 1 + .../msr1/setup/updating-msr-1-firmware.md | 3 +- docs/products/msr1/setup/zones-ha.md | 1 + docs/products/msr1/setup/zones-hlk.md | 1 + .../msr1/troubleshooting/msr1-boot-mode.md | 5 ++-- .../msr1/troubleshooting/msr1-code.md | 1 + .../msr1-reset-wi-fi-credentials.md | 1 + .../msr1/troubleshooting/msr1-teardown.md | 1 + docs/products/msr2/msr2-reviews.md | 10 +++---- docs/products/msr2/setup/mmwave-videos.md | 1 + docs/products/msr2/setup/msr2-general-tips.md | 6 ++-- docs/products/msr2/setup/zones-hlk.md | 4 +-- .../msr2/troubleshooting/msr2-boot-mode.md | 4 +-- docs/products/mtr1/mtr1-reviews.md | 8 ++--- docs/products/mtr1/setup/general-tips.md | 16 +++++----- docs/products/mtr1/setup/zones-hlk.md | 4 +-- .../mtr1/troubleshooting/mtr1-boot-mode.md | 4 +-- .../setup/productname-general-tips.md | 4 +-- .../troubleshooting/productname-boot-mode.md | 4 +-- .../troubleshooting/productname-teardown.md | 4 +-- docs/products/plt1/examples/blueprint.md | 4 +-- docs/products/plt1/general-tips.md | 2 +- docs/products/plt1/reviews.md | 12 ++++---- .../plt1/troubleshooting/plt1-boot-mode.md | 4 +-- .../plt1b/battery-sensors/awake-ha-helper.md | 1 + .../sensor-connection-check.md | 1 + .../battery-sensors/wake-up-battery-sensor.md | 1 + docs/products/plt1b/examples/flower-card.md | 1 + docs/products/plt1b/general-tips.md | 2 +- docs/products/plt1b/reviews.md | 1 + .../plt1b/setup/getting-started-plt1.md | 1 + .../plt1b/troubleshooting/plt1b-boot-mode.md | 4 +-- .../plt1b/troubleshooting/plt1b-code.md | 2 +- .../attaching-fluid-level-sensors-pump-1.md | 6 ++-- .../pump1/setup/pump1-general-tips.md | 6 ++-- .../pump1/troubleshooting/pump1-boot-mode.md | 4 +-- .../pump1/troubleshooting/pump1-teardown.md | 4 +-- .../attaching-gang-box-mount-to-r-pro-1.md | 4 +-- .../install-ceiling-mount-for-r-pro-1.md | 6 ++-- docs/products/rpro1/rpro1-reviews.md | 6 ++-- .../rpro1/setup/rpro1-general-tips.md | 8 ++--- .../rpro1/setup/rpro1-switch-firmware.md | 4 +-- docs/products/rpro1/setup/zones-ha-new.md | 4 +-- docs/products/rpro1/setup/zones-ha.md | 4 +-- docs/products/rpro1/setup/zones-hlk.md | 6 ++-- .../rpro1/troubleshooting/rpro1-boot-mode.md | 4 +-- .../rpro1/troubleshooting/rpro1-teardown.md | 4 +-- .../temp1/battery-sensors/awake-ha-helper.md | 1 + .../sensor-connection-check.md | 1 + .../battery-sensors/wake-up-battery-sensor.md | 1 + .../examples/temp1-automation-examples.md | 6 ++-- docs/products/temp1/reviews.md | 8 ++--- .../temp1/setup/temp1-general-tips.md | 4 +-- .../temp1/troubleshooting/temp1-boot-mode.md | 4 +-- .../temp1b/battery-sensors/awake-ha-helper.md | 1 + .../sensor-connection-check.md | 1 + .../battery-sensors/wake-up-battery-sensor.md | 1 + .../examples/temp1b-automation-examples.md | 6 ++-- docs/products/temp1b/reviews.md | 8 ++--- .../temp1b/setup/getting-started-temp1.md | 1 + .../temp1b/setup/temp1-general-tips.md | 3 +- .../troubleshooting/temp1b-boot-mode.md | 4 +-- .../examples/temp1-automation-examples.md | 6 ++-- docs/products/temppro1/reviews.md | 8 ++--- .../troubleshooting/temp-pro1-boot-mode.md | 4 +-- 378 files changed, 741 insertions(+), 470 deletions(-) diff --git a/docs/homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md b/docs/homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md index bf06f7aba1..58c9c1b4ab 100755 --- a/docs/homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md +++ b/docs/homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md @@ -1,4 +1,5 @@ --- +title: MiCS Addon description: "Adding Optional MiCS-4514 Gas Sensor To The AIR-1." --- --8<-- "products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md:5:" \ No newline at end of file diff --git a/docs/homey/products/air1/air1-reviews.md b/docs/homey/products/air1/air1-reviews.md index c059259e25..eb39db52b2 100755 --- a/docs/homey/products/air1/air1-reviews.md +++ b/docs/homey/products/air1/air1-reviews.md @@ -1,4 +1,5 @@ --- +title: Reviews description: "YouTuber reviews and feedback about the AIR-1 sensor from Apollo Automation." --- --8<-- "products/air1/air1-reviews.md:5:" \ No newline at end of file diff --git a/docs/homey/products/air1/faq.md b/docs/homey/products/air1/faq.md index 4217d12669..3c3356e4be 100755 --- a/docs/homey/products/air1/faq.md +++ b/docs/homey/products/air1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently asked questions about the AIR-1 environmental sensor, including setup, features, and troubleshooting." --- --8<-- "products/air1/faq.md:5:" \ No newline at end of file diff --git a/docs/homey/products/air1/introduction.md b/docs/homey/products/air1/introduction.md index 54a62886e6..c23a20abcb 100755 --- a/docs/homey/products/air1/introduction.md +++ b/docs/homey/products/air1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for AIR-1, including setup, usage, and best practices." --- --8<-- "products/air1/introduction.md:5:" \ No newline at end of file diff --git a/docs/homey/products/air1/setup/general-tips.md b/docs/homey/products/air1/setup/general-tips.md index 20907994f9..f2ffaa8d21 100755 --- a/docs/homey/products/air1/setup/general-tips.md +++ b/docs/homey/products/air1/setup/general-tips.md @@ -1,16 +1,16 @@ --- -description: ">-" ---- +title: AIR-1 General Tips +description: Guide to help you understand which sensors you should be concerned with and expected safe or not safe thresholds to alert or automate on. --- # AIR-1 General Tips The AIR-1 has multiple different types of sensors and this guide will help you understand which ones you should be concerned with and expected safe or not safe thresholds to alert or automate on. -###### SEN55 Environmental Sensor +## SEN55 Environmental Sensor The SEN55 is the powerhouse of the AIR-1 with multiple sensors such as particulate matter, volatile organic compounds (VOCs), oxidizing gases, such as nitrogen oxides (NOx), as well as humidity & temperature. -###### Particulate Matter +## Particulate Matter Per the EPA: particulate matter (also called particle pollution): the term for a mixture of solid particles and liquid droplets found in the air. Some particles, such as dust, dirt, soot, or smoke, are large or dark enough to be seen with the naked eye. Others are so small they can only be detected using an electron microscope. Sources of pm particles here. @@ -24,11 +24,11 @@ The SEN55 is the powerhouse of the AIR-1 with multiple sensors such as particula This article goes over lots of ways to reduce pm particles in your home! -###### Safe PM Levels +## Safe PM Levels Particulate Matter (PM) refers to a mixture of solid particles and liquid droplets found in the air. These are often classified by size, as smaller particles pose greater risks to health due to their ability to penetrate deeper into the lungs. -###### What Do PM1, PM2.5, PM4, and PM10 Mean? +## What Do PM1, PM2.5, PM4, and PM10 Mean?

PM Type

Size (µm)

Description

PM1

≤ 1.0

Ultrafine particles that can reach deep into the lungs and bloodstream.

PM2.5

≤ 2.5

Fine particles; linked to respiratory and cardiovascular issues.

PM4

≤ 4.0

Less commonly regulated; typically used in industrial settings.

PM10

≤ 10

Inhalable particles; may irritate eyes, nose, and throat.

@@ -38,7 +38,7 @@ Particulate Matter (PM) refers to a mixture of solid particles and liquid drople --- -###### Recommended Safe Exposure Limits +## Recommended Safe Exposure Limits The **World Health Organization (WHO)** provides the following exposure limits for particulate matter: @@ -46,7 +46,7 @@ The **World Health Organization (WHO)** defines safety thresholds for PM2.5 based on a 24-hour average: @@ -54,7 +54,7 @@ The **U.S. Environmental Protection Agency (EPA)**NowCast AQI takes your PM2.5 and PM10 readings and converts them into a single 0–500 number using the EPA's formula. That number maps directly to the AQI categories in the table above: bigger = worse. @@ -66,7 +66,7 @@ The AIR-1 calculates this automatically and exposes it as a sensor in Home Assis --- -###### Indoor Air Quality Notes +## Indoor Air Quality Notes * **PM1** and **PM2.5** are especially important for indoor air monitoring since these smaller particles are more likely to come from cooking, candles, smoking, or inadequate ventilation. * Use an **air purifier with a HEPA filter** to reduce PM1–PM2.5 concentrations indoors. @@ -78,7 +78,7 @@ The AIR-1 calculates this automatically and exposes it as a sensor in Home Assis --- -###### VOC Index +## VOC Index Per Sensirion, @@ -100,7 +100,7 @@ Per Sensirion, > > that there are fewer VOCs compared to the average -###### VOC Quality +## VOC Quality This uses the VOC index and a scale to output an easier to use variable. @@ -110,7 +110,7 @@ This uses the NOX Index +## NOX Index Per Sensirion, @@ -140,7 +140,7 @@ Per Sensirion, --- -##### SCD40 CO2 sensor +## SCD40 CO2 sensor The optional CO2 sensor addon is a great way to add the ability to track CO2. CO2 levels in a closed, poorly ventilated bedroom can quickly rise to concentrations that may impair focus or even pose health risks. Notice the CO2 levels dropping in the image below when the HVAC was turned on overnight! @@ -162,6 +162,6 @@ The latest AIR-1 firmware keeps the SCD40 calibrated automatically. The sensor a --- -##### MiCS-4514 Gas Sensor +## MiCS-4514 Gas Sensor The MiCS-4514 is a very unique sensor able to distinguish between multiple gases such as Carbon Monoxide, Nitrogen, Ethanol, Hydrogen, Ammonia, and Methane. \ No newline at end of file diff --git a/docs/homey/products/air1/setup/prevent-sleep.md b/docs/homey/products/air1/setup/prevent-sleep.md index 8a3fcb9108..0b19805ee3 100755 --- a/docs/homey/products/air1/setup/prevent-sleep.md +++ b/docs/homey/products/air1/setup/prevent-sleep.md @@ -1,4 +1,5 @@ --- +title: Prevent Sleep description: "How to disable Prevent Sleep and allow your Apollo device to sleep!" --- --8<-- "products/general/battery-sensors/prevent-sleep.md:5:" \ No newline at end of file diff --git a/docs/homey/products/air1/setup/sensor-definitions.md b/docs/homey/products/air1/setup/sensor-definitions.md index 56f412b4c4..07bd0cef9e 100755 --- a/docs/homey/products/air1/setup/sensor-definitions.md +++ b/docs/homey/products/air1/setup/sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "Full list of definitions for the AIR-1 and its various sensors." --- --8<-- "products/air1/setup/sensor-definitions.md:5:" diff --git a/docs/homey/products/air1/troubleshooting/air1-boot-mode.md b/docs/homey/products/air1/troubleshooting/air1-boot-mode.md index 11abae830e..ab98853111 100755 --- a/docs/homey/products/air1/troubleshooting/air1-boot-mode.md +++ b/docs/homey/products/air1/troubleshooting/air1-boot-mode.md @@ -1,4 +1,5 @@ --- +title: AIR-1 Boot Mode description: "Step by step guide for putting The AIR-1 In Boot Mode." --- @@ -6,7 +7,7 @@ description: "Step by step guide for putting The AIR-1 In Boot Mode." This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the AIR-1 so that the USB-C port is facing you. On the left side of the USB-C port, locate a small opening to press the boot button (the right button). @@ -16,7 +17,7 @@ description: "Step by step guide for putting The AIR-1 In Boot Mode." 3\. Continue with uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/homey/products/air1/troubleshooting/air1-code.md b/docs/homey/products/air1/troubleshooting/air1-code.md index d89e3999d6..15b8580eb8 100755 --- a/docs/homey/products/air1/troubleshooting/air1-code.md +++ b/docs/homey/products/air1/troubleshooting/air1-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash AIR-1 description: "Step by step guide for re-flashing the AIR-1 back to factory firmware." --- diff --git a/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md b/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md index 5441054255..0e61ec6b15 100755 --- a/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md +++ b/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials description: "Step by step guide for resetting the Wi-Fi Credentials on your AIR-1." --- diff --git a/docs/homey/products/air1/troubleshooting/air1-teardown.md b/docs/homey/products/air1/troubleshooting/air1-teardown.md index d651623100..3285d8c638 100755 --- a/docs/homey/products/air1/troubleshooting/air1-teardown.md +++ b/docs/homey/products/air1/troubleshooting/air1-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown and Reassembly Of AIR-1 description: "Step by step guide for tearing down your AIR-1 to replace parts, clean it, swap cases, etc." --- --8<-- "products/air1/troubleshooting/air1-teardown.md:5:" \ No newline at end of file diff --git a/docs/homey/products/btn1/additional-info/prevent-sleep.md b/docs/homey/products/btn1/additional-info/prevent-sleep.md index 10abf6ec4d..94f9bb0931 100644 --- a/docs/homey/products/btn1/additional-info/prevent-sleep.md +++ b/docs/homey/products/btn1/additional-info/prevent-sleep.md @@ -1,4 +1,5 @@ --- +title: Prevent Sleep description: "How to prevent the BTN-1 from sleeping to maintain functionality" --- --8<-- "products/btn1/additional-info/prevent-sleep.md:5:" diff --git a/docs/homey/products/btn1/addons/btn1-addon.md b/docs/homey/products/btn1/addons/btn1-addon.md index 5cafa6caf6..8abc70fddc 100644 --- a/docs/homey/products/btn1/addons/btn1-addon.md +++ b/docs/homey/products/btn1/addons/btn1-addon.md @@ -1,4 +1,5 @@ --- +title: BTN-1 Addon description: "BTN-1 attaching keys to the BTN-1" --- --8<-- "products/btn1/addons/btn1-addon.md:5:" diff --git a/docs/homey/products/btn1/battery-sensors/wake-up-battery-sensor.md b/docs/homey/products/btn1/battery-sensors/wake-up-battery-sensor.md index 023266d9c9..e5adaf6759 100644 --- a/docs/homey/products/btn1/battery-sensors/wake-up-battery-sensor.md +++ b/docs/homey/products/btn1/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/homey/products/btn1/examples/blueprint.md b/docs/homey/products/btn1/examples/blueprint.md index 4566a0bb0a..11421f6b9f 100644 --- a/docs/homey/products/btn1/examples/blueprint.md +++ b/docs/homey/products/btn1/examples/blueprint.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Blueprint +description: Example of how to use the BTN-1 Events with the BTN-1 4 Event Blueprint in Home Assistant! --- --8<-- "products/btn1/examples/blueprint.md:7:" diff --git a/docs/homey/products/btn1/examples/example-automation.md b/docs/homey/products/btn1/examples/example-automation.md index d04468c7ac..cba1105380 100644 --- a/docs/homey/products/btn1/examples/example-automation.md +++ b/docs/homey/products/btn1/examples/example-automation.md @@ -1,4 +1,5 @@ --- +title: Example Automation description: "Example of how to use the BTN-1 Events to create an automation in Home Assistant!" --- --8<-- "products/btn1/examples/example-automation.md:5:" diff --git a/docs/homey/products/btn1/faq.md b/docs/homey/products/btn1/faq.md index b1d1ed1e5c..e5372f66bf 100644 --- a/docs/homey/products/btn1/faq.md +++ b/docs/homey/products/btn1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently asked questions about the BTN-1 Macro Deck" --- --8<-- "products/btn1/faq.md:5:" diff --git a/docs/homey/products/btn1/introduction.md b/docs/homey/products/btn1/introduction.md index a44c1a5761..9ae474dbb5 100644 --- a/docs/homey/products/btn1/introduction.md +++ b/docs/homey/products/btn1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for BTN-1, including setup, usage, and best practices." --- --8<-- "products/btn1/introduction.md:5:" diff --git a/docs/homey/products/btn1/setup/general-tips.md b/docs/homey/products/btn1/setup/general-tips.md index 5811e926ec..3a3e0b1baa 100644 --- a/docs/homey/products/btn1/setup/general-tips.md +++ b/docs/homey/products/btn1/setup/general-tips.md @@ -1,4 +1,5 @@ --- +title: General Tips description: "BTN-1 General Tips" --- --8<-- "products/btn1/setup/general-tips.md:5:" diff --git a/docs/homey/products/btn1/setup/getting-started.md b/docs/homey/products/btn1/setup/getting-started.md index a94406a60e..59a16cdfd3 100644 --- a/docs/homey/products/btn1/setup/getting-started.md +++ b/docs/homey/products/btn1/setup/getting-started.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Step by step guide to getting started with your BTN-1!" --- --8<-- "products/btn1/setup/getting-started.md:5:" diff --git a/docs/homey/products/btn1/setup/sensor-definitions.md b/docs/homey/products/btn1/setup/sensor-definitions.md index 8ff3e68113..f2654c4ea2 100644 --- a/docs/homey/products/btn1/setup/sensor-definitions.md +++ b/docs/homey/products/btn1/setup/sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "These are all of the entities exposed by the BTN-1 to automate on!" --- --8<-- "products/btn1/setup/sensor-definitions.md:5:" diff --git a/docs/homey/products/btn1/troubleshooting/btn1-boot-mode.md b/docs/homey/products/btn1/troubleshooting/btn1-boot-mode.md index 990cdbaaae..e36820acb1 100644 --- a/docs/homey/products/btn1/troubleshooting/btn1-boot-mode.md +++ b/docs/homey/products/btn1/troubleshooting/btn1-boot-mode.md @@ -1,4 +1,5 @@ --- +title: BTN-1 Boot Mode description: "Step by step guide for putting The BTN-1 In Boot Mode." --- --8<-- "products/btn1/troubleshooting/btn1-boot-mode.md:5:" diff --git a/docs/homey/products/btn1/troubleshooting/btn1-reflash.md b/docs/homey/products/btn1/troubleshooting/btn1-reflash.md index 11e5d5d6f7..1c26655c07 100644 --- a/docs/homey/products/btn1/troubleshooting/btn1-reflash.md +++ b/docs/homey/products/btn1/troubleshooting/btn1-reflash.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash BTN-1 description: "Step by step guide for reflashing The BTN-1." --- --8<-- "products/btn1/troubleshooting/btn1-reflash.md:5:" diff --git a/docs/homey/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md b/docs/homey/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md index 7f35d47f8c..f76c591b53 100644 --- a/docs/homey/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md +++ b/docs/homey/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials description: "Step by step guide for resetting the Wi-Fi Credentials on your BTN-1." --- --8<-- "products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md:5:" diff --git a/docs/homey/products/btn1/troubleshooting/btn1-teardown.md b/docs/homey/products/btn1/troubleshooting/btn1-teardown.md index ce36a67f05..2f6402aa1e 100644 --- a/docs/homey/products/btn1/troubleshooting/btn1-teardown.md +++ b/docs/homey/products/btn1/troubleshooting/btn1-teardown.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Teardown and Reassembly Of BTN-1 +description: Step by step guide for tearing down your BTN-1 to replace parts, clean it, swap cases, etc. --- --8<-- "products/btn1/troubleshooting/btn1-teardown.md:7:" diff --git a/docs/homey/products/general/calibrating-and-updating/co2-calibration.md b/docs/homey/products/general/calibrating-and-updating/co2-calibration.md index b85ca3b92b..e2dd377814 100755 --- a/docs/homey/products/general/calibrating-and-updating/co2-calibration.md +++ b/docs/homey/products/general/calibrating-and-updating/co2-calibration.md @@ -1,4 +1,5 @@ --- +title: CO₂ Calibration description: "Step by step guide for re-calibrating your SCD40 CO2 sensor" --- # CO2 Calibration diff --git a/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md b/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md index f51f620716..99e0eb01c8 100755 --- a/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md +++ b/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md @@ -1,4 +1,5 @@ --- +title: This needs to be redone for Homey if it can be duplicated. description: "Two short videos and a quick summary on how to best tune the LD2410B in the MSR-2!" --- # This needs to be redone for Homey if it can be duplicated. diff --git a/docs/homey/products/general/calibrating-and-updating/zone-configuration/zones-hlk.md b/docs/homey/products/general/calibrating-and-updating/zone-configuration/zones-hlk.md index f4326efd3e..b9bb9a130b 100644 --- a/docs/homey/products/general/calibrating-and-updating/zone-configuration/zones-hlk.md +++ b/docs/homey/products/general/calibrating-and-updating/zone-configuration/zones-hlk.md @@ -1,4 +1,4 @@ --- description: "Tutorial for MTR-1 HLKRadarTool app Zone Configuration." --- ---8<-- "homey/products/mtr1/setup/zones-hlk.md" +--8<-- "homey/products/mtr1/setup/zones-hlk.md:5:" diff --git a/docs/homey/products/general/comparisons.md b/docs/homey/products/general/comparisons.md index fbbbc366d5..1e91903c4f 100755 --- a/docs/homey/products/general/comparisons.md +++ b/docs/homey/products/general/comparisons.md @@ -1,4 +1,5 @@ --- +title: Sensor Comparisons description: "mmWave Presence Sensor Comparison Chart." --- --8<-- "products/general/comparisons.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/contact-us/Facebook.md b/docs/homey/products/general/contact-us/Facebook.md index 3a350bb448..093d7ee258 100755 --- a/docs/homey/products/general/contact-us/Facebook.md +++ b/docs/homey/products/general/contact-us/Facebook.md @@ -1,4 +1,4 @@ --- description: "Join the Apollo Automation community group on Facebook." --- ---8<-- "products/general/contact-us/Facebook.md:4:" \ No newline at end of file +--8<-- "products/general/contact-us/Facebook.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/contact-us/GitHub.md b/docs/homey/products/general/contact-us/GitHub.md index bd58a7239b..527ecb6526 100755 --- a/docs/homey/products/general/contact-us/GitHub.md +++ b/docs/homey/products/general/contact-us/GitHub.md @@ -1,4 +1,4 @@ --- description: "Apollo Automation on GitHub, where the firmware and hardware files live." --- ---8<-- "products/general/contact-us/GitHub.md:4:" \ No newline at end of file +--8<-- "products/general/contact-us/GitHub.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/contact-us/Instagram.md b/docs/homey/products/general/contact-us/Instagram.md index a590953bb8..66fd25ff69 100755 --- a/docs/homey/products/general/contact-us/Instagram.md +++ b/docs/homey/products/general/contact-us/Instagram.md @@ -1,4 +1,4 @@ --- description: "Follow Apollo Automation on Instagram." --- ---8<-- "products/general/contact-us/Instagram.md:4:" \ No newline at end of file +--8<-- "products/general/contact-us/Instagram.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/contact-us/Reddit.md b/docs/homey/products/general/contact-us/Reddit.md index 64833617d3..4c3948a0d6 100755 --- a/docs/homey/products/general/contact-us/Reddit.md +++ b/docs/homey/products/general/contact-us/Reddit.md @@ -1,4 +1,4 @@ --- description: "The Apollo Automation subreddit." --- ---8<-- "products/general/contact-us/Reddit.md:4:" \ No newline at end of file +--8<-- "products/general/contact-us/Reddit.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/contact-us/YouTube.md b/docs/homey/products/general/contact-us/YouTube.md index 8768c2dc70..ce5f1d7297 100755 --- a/docs/homey/products/general/contact-us/YouTube.md +++ b/docs/homey/products/general/contact-us/YouTube.md @@ -1,4 +1,4 @@ --- description: "The Apollo Automation YouTube channel, with setup guides, reviews, and live streams." --- ---8<-- "products/general/contact-us/YouTube.md:4:" \ No newline at end of file +--8<-- "products/general/contact-us/YouTube.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/contact-us/apollo-automation-shop.md b/docs/homey/products/general/contact-us/apollo-automation-shop.md index 0911d59535..71a25363d5 100755 --- a/docs/homey/products/general/contact-us/apollo-automation-shop.md +++ b/docs/homey/products/general/contact-us/apollo-automation-shop.md @@ -1,4 +1,4 @@ --- description: "The Apollo Automation shop, where you can buy sensors, probes, and accessories." --- ---8<-- "products/general/contact-us/apollo-automation-shop.md:5:" \ No newline at end of file +--8<-- "products/general/contact-us/apollo-automation-shop.md:6:" \ No newline at end of file diff --git a/docs/homey/products/general/contact-us/contact-us-support.md b/docs/homey/products/general/contact-us/contact-us-support.md index 700cdcc684..579b27502e 100755 --- a/docs/homey/products/general/contact-us/contact-us-support.md +++ b/docs/homey/products/general/contact-us/contact-us-support.md @@ -1,4 +1,5 @@ --- +title: Contact Us / Support description: "How to reach Apollo Automation support, by email, on Discord, or through the community forum." --- ---8<-- "products/general/contact-us/contact-us-support.md:4:" +--8<-- "products/general/contact-us/contact-us-support.md:5:" diff --git a/docs/homey/products/general/contact-us/our-team.md b/docs/homey/products/general/contact-us/our-team.md index 18531ad1ec..75f6eda4a6 100755 --- a/docs/homey/products/general/contact-us/our-team.md +++ b/docs/homey/products/general/contact-us/our-team.md @@ -1,4 +1,4 @@ --- description: "Meet the people behind Apollo Automation." --- ---8<-- "products/general/contact-us/our-team.md:4:" \ No newline at end of file +--8<-- "products/general/contact-us/our-team.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/faq.md b/docs/homey/products/general/faq.md index 499607b41c..fd9c122898 100755 --- a/docs/homey/products/general/faq.md +++ b/docs/homey/products/general/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently Asked Questions." --- --8<-- "products/general/faq.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/links.md b/docs/homey/products/general/links.md index 35b4590933..a01ff17494 100755 --- a/docs/homey/products/general/links.md +++ b/docs/homey/products/general/links.md @@ -1,4 +1,5 @@ --- +title: Source Code and 3D Files description: "Links to our GitHub, printables, and discord!" --- --8<-- "products/general/links.md:5:" \ No newline at end of file diff --git a/docs/homey/products/general/resellers.md b/docs/homey/products/general/resellers.md index 4ba7ed859e..6fd824ed6e 100644 --- a/docs/homey/products/general/resellers.md +++ b/docs/homey/products/general/resellers.md @@ -1,4 +1,5 @@ --- +title: Resellers description: "A list of resellers across the globe for Apollo Automation products!" --- --8<-- "products/general/resellers.md:5:" diff --git a/docs/homey/products/general/setup/getting-started-air1.md b/docs/homey/products/general/setup/getting-started-air1.md index aebb27e377..d2c7773472 100755 --- a/docs/homey/products/general/setup/getting-started-air1.md +++ b/docs/homey/products/general/setup/getting-started-air1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" \ No newline at end of file +--8<-- "homey/products/general/setup/getting-started.md:6:" \ No newline at end of file diff --git a/docs/homey/products/general/setup/getting-started-msr1.md b/docs/homey/products/general/setup/getting-started-msr1.md index aebb27e377..52a15b418e 100755 --- a/docs/homey/products/general/setup/getting-started-msr1.md +++ b/docs/homey/products/general/setup/getting-started-msr1.md @@ -1,4 +1,4 @@ --- description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" \ No newline at end of file +--8<-- "homey/products/general/setup/getting-started.md:6:" \ No newline at end of file diff --git a/docs/homey/products/general/setup/getting-started-msr2.md b/docs/homey/products/general/setup/getting-started-msr2.md index aebb27e377..d2c7773472 100755 --- a/docs/homey/products/general/setup/getting-started-msr2.md +++ b/docs/homey/products/general/setup/getting-started-msr2.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" \ No newline at end of file +--8<-- "homey/products/general/setup/getting-started.md:6:" \ No newline at end of file diff --git a/docs/homey/products/general/setup/getting-started-mtr1.md b/docs/homey/products/general/setup/getting-started-mtr1.md index aebb27e377..d2c7773472 100755 --- a/docs/homey/products/general/setup/getting-started-mtr1.md +++ b/docs/homey/products/general/setup/getting-started-mtr1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" \ No newline at end of file +--8<-- "homey/products/general/setup/getting-started.md:6:" \ No newline at end of file diff --git a/docs/homey/products/general/setup/getting-started-plt1.md b/docs/homey/products/general/setup/getting-started-plt1.md index aebb27e377..d2c7773472 100755 --- a/docs/homey/products/general/setup/getting-started-plt1.md +++ b/docs/homey/products/general/setup/getting-started-plt1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" \ No newline at end of file +--8<-- "homey/products/general/setup/getting-started.md:6:" \ No newline at end of file diff --git a/docs/homey/products/general/setup/getting-started-temp1.md b/docs/homey/products/general/setup/getting-started-temp1.md index aebb27e377..52a15b418e 100755 --- a/docs/homey/products/general/setup/getting-started-temp1.md +++ b/docs/homey/products/general/setup/getting-started-temp1.md @@ -1,4 +1,4 @@ --- description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" \ No newline at end of file +--8<-- "homey/products/general/setup/getting-started.md:6:" \ No newline at end of file diff --git a/docs/homey/products/general/setup/getting-started.md b/docs/homey/products/general/setup/getting-started.md index 7d0283e2a2..513f14bcb1 100755 --- a/docs/homey/products/general/setup/getting-started.md +++ b/docs/homey/products/general/setup/getting-started.md @@ -1,11 +1,12 @@ --- +title: Getting Started description: "Generic getting started article." --- # Getting Started This will walk you through the process of connecting your new Apollo Automation sensor to Homey. If at any point you get stuck, join our Discord for some help. -### Connecting Through Hotspot: +## Connecting Through Hotspot: To get your new Apollo sensor connected to your Wi-Fi, follow the steps below! @@ -29,7 +30,7 @@ If this does not automatically open the dashboard, please open your web browser 5\. Once connected, the sensor's dashboard will automatically close. You've successfully connected your sensor to your Wi-Fi. -### Adding Apollo Automation App in Homey: +## Adding Apollo Automation App in Homey: 1\. Navigate to this website and click "Install App". For now this needs to be done from a desktop PC or a browser. @@ -41,7 +42,7 @@ If this does not automatically open the dashboard, please open your web browser 3\. Your device will install the Apollo Automation Homey App then move to the next section. -### Connecting to Homey: +## Connecting to Homey: 1\. Open the Homey App on your phone and navigate to the Devices tab at the bottom then select the (+) icon in the top right and choose "**New Device**". Choose "Allow" if it pops up asking to find Bluetooth devices, or you can change this later in settings. diff --git a/docs/homey/products/general/setup/renaming-apollo-devices.md b/docs/homey/products/general/setup/renaming-apollo-devices.md index 7b999505c3..d75ec0c440 100755 --- a/docs/homey/products/general/setup/renaming-apollo-devices.md +++ b/docs/homey/products/general/setup/renaming-apollo-devices.md @@ -1,4 +1,5 @@ --- +title: Renaming Apollo Devices description: "Rename an Apollo device from the Homey app or the Homey dashboard." --- # Renaming Apollo Devices diff --git a/docs/homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md b/docs/homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md index a8e6af74f0..a278dfe620 100755 --- a/docs/homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md +++ b/docs/homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md @@ -1,4 +1,5 @@ --- +title: OPNsense Auto Discover Device mDNS Issue description: "Tutorial to help fix the OPNsense mDNS Auto Discover Issue" --- --8<-- "products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md:5:" diff --git a/docs/homey/products/general/troubleshooting/removing-device-from-homey.md b/docs/homey/products/general/troubleshooting/removing-device-from-homey.md index f66388dac5..181122b140 100755 --- a/docs/homey/products/general/troubleshooting/removing-device-from-homey.md +++ b/docs/homey/products/general/troubleshooting/removing-device-from-homey.md @@ -1,4 +1,5 @@ --- +title: Removing Devices from Homey description: "Remove an Apollo device from Homey through the app or the dashboard." --- # Removing Devices from Homey diff --git a/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md b/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md index 2edaa97c12..2f27c950ce 100755 --- a/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md +++ b/docs/homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md @@ -1,4 +1,5 @@ --- +title: UniFi Auto Discover Device mDNS Issue description: "Tutorial to help fix the Ubiquiti UniFi mDNS Auto Discover Issue." --- --8<-- "products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md:5:" \ No newline at end of file diff --git a/docs/homey/products/led1/examples/led-1-controlling-govee-lights.md b/docs/homey/products/led1/examples/led-1-controlling-govee-lights.md index 6c69032cc8..9b9d60d88d 100644 --- a/docs/homey/products/led1/examples/led-1-controlling-govee-lights.md +++ b/docs/homey/products/led1/examples/led-1-controlling-govee-lights.md @@ -1,4 +1,4 @@ --- -description: ">-" +description: How to use the Apollo LED-1 to control your Govee/3rd Party permanent outdoor LED lights! --- --8<-- "products/led1/examples/led-1-controlling-govee-lights.md:7:" diff --git a/docs/homey/products/m1/addons/adding-microphone-to-m-1.md b/docs/homey/products/m1/addons/adding-microphone-to-m-1.md index 897ade6658..533e209d80 100644 --- a/docs/homey/products/m1/addons/adding-microphone-to-m-1.md +++ b/docs/homey/products/m1/addons/adding-microphone-to-m-1.md @@ -1,4 +1,5 @@ --- +title: Microphone description: "Step by Step directions for adding a microphone to your M-1 LED Matrix" --- --8<-- "products/m1/addons/adding-microphone-to-m-1.md:5:" diff --git a/docs/homey/products/m1/addons/wizmote-remote.md b/docs/homey/products/m1/addons/wizmote-remote.md index 15f7643c40..0594cb100c 100644 --- a/docs/homey/products/m1/addons/wizmote-remote.md +++ b/docs/homey/products/m1/addons/wizmote-remote.md @@ -1,4 +1,5 @@ --- +title: WizMote Remote description: "Pair a WizMote remote to your M-1 over ESP-NOW for physical control without Home Assistant." --- --8<-- "products/m1/addons/wizmote-remote.md:5:" diff --git a/docs/homey/products/m1/choose-your-firmware.md b/docs/homey/products/m1/choose-your-firmware.md index db7ba0aa0c..96e51be804 100644 --- a/docs/homey/products/m1/choose-your-firmware.md +++ b/docs/homey/products/m1/choose-your-firmware.md @@ -1,4 +1,5 @@ --- +title: Choose Your Firmware description: "Find out which firmware your M-1 runs and what each one gives you." --- --8<-- "products/m1/choose-your-firmware.md:5:" diff --git a/docs/homey/products/m1/examples/add-gifs-to-wled.md b/docs/homey/products/m1/examples/add-gifs-to-wled.md index fa760cfd14..41621516e3 100644 --- a/docs/homey/products/m1/examples/add-gifs-to-wled.md +++ b/docs/homey/products/m1/examples/add-gifs-to-wled.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Add GIFs +description: Step by step guide to adding an animated GIF to the M-1 LED Matrix. --- --8<-- "products/m1/examples/add-gifs-to-wled.md:7:" diff --git a/docs/homey/products/m1/examples/pixel-forge.md b/docs/homey/products/m1/examples/pixel-forge.md index b52d9e63b7..d4c9c7b778 100644 --- a/docs/homey/products/m1/examples/pixel-forge.md +++ b/docs/homey/products/m1/examples/pixel-forge.md @@ -1,4 +1,5 @@ --- +title: Pixel Forge description: "Convert images and build scrolling text directly on your M-1 using WLED's built-in Pixel Forge tool." --- --8<-- "products/m1/examples/pixel-forge.md:5:" diff --git a/docs/homey/products/m1/examples/qr-code-generator.md b/docs/homey/products/m1/examples/qr-code-generator.md index 6e317ffaa0..e1ef36e4df 100644 --- a/docs/homey/products/m1/examples/qr-code-generator.md +++ b/docs/homey/products/m1/examples/qr-code-generator.md @@ -1,4 +1,5 @@ --- +title: QR Code Generator description: "Step by step guide to setting up your own QR code for Wi-Fi, link to a website, etc." --- --8<-- "products/m1/examples/qr-code-generator.md:5:" diff --git a/docs/homey/products/m1/examples/scrolling-text.md b/docs/homey/products/m1/examples/scrolling-text.md index fdd064ea94..313dfc3387 100644 --- a/docs/homey/products/m1/examples/scrolling-text.md +++ b/docs/homey/products/m1/examples/scrolling-text.md @@ -1,4 +1,5 @@ --- +title: Scrolling Text description: "Step by step guide to adding a WLED Preset for custom scrolling text on the M-1 LED Matrix!" --- --8<-- "products/m1/examples/scrolling-text.md:5:" diff --git a/docs/homey/products/m1/examples/share-data-from-home-assistant.md b/docs/homey/products/m1/examples/share-data-from-home-assistant.md index ac67077c4d..8ebed6f1ae 100644 --- a/docs/homey/products/m1/examples/share-data-from-home-assistant.md +++ b/docs/homey/products/m1/examples/share-data-from-home-assistant.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Share Data From Home Assistant +description: Step by step guide for custom scrolling text using the states of Home Assistant entities! --- --8<-- "products/m1/examples/share-data-from-home-assistant.md:9:" diff --git a/docs/homey/products/m1/faq.md b/docs/homey/products/m1/faq.md index 3cfc58381e..d556c747ef 100644 --- a/docs/homey/products/m1/faq.md +++ b/docs/homey/products/m1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently asked questions about the M-1 controller." --- --8<-- "products/m1/faq.md:5:" diff --git a/docs/homey/products/m1/introduction.md b/docs/homey/products/m1/introduction.md index e5edb5fe49..ad1d4baaa1 100644 --- a/docs/homey/products/m1/introduction.md +++ b/docs/homey/products/m1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for M-1, including setup, usage, and best practices." --- --8<-- "products/m1/introduction.md:5:" diff --git a/docs/homey/products/m1/m1-reviews.md b/docs/homey/products/m1/m1-reviews.md index 88e48f89f1..92a2dca6f6 100644 --- a/docs/homey/products/m1/m1-reviews.md +++ b/docs/homey/products/m1/m1-reviews.md @@ -1,4 +1,5 @@ --- +title: Reviews description: "YouTube reviews and feedback about the M-1 LED Matrix from Apollo Automation." --- --8<-- "products/m1/m1-reviews.md:5:" diff --git a/docs/homey/products/m1/setup/getting-started-m1.md b/docs/homey/products/m1/setup/getting-started-m1.md index 7a76cc58f8..c8d754c759 100644 --- a/docs/homey/products/m1/setup/getting-started-m1.md +++ b/docs/homey/products/m1/setup/getting-started-m1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Getting started with your new M-1 LED Matrix on WLED or WLED-MM." --- --8<-- "products/m1/setup/getting-started-m1.md:5:" diff --git a/docs/homey/products/m1/setup/m1-general-tips.md b/docs/homey/products/m1/setup/m1-general-tips.md index e222ec3a31..7619908d36 100644 --- a/docs/homey/products/m1/setup/m1-general-tips.md +++ b/docs/homey/products/m1/setup/m1-general-tips.md @@ -1,4 +1,5 @@ --- +title: General Tips description: "Multiple helpful tips to use your M-1 LED Matrix to the fullest!" --- --8<-- "products/m1/setup/m1-general-tips.md:5:" diff --git a/docs/homey/products/m1/setup/m1-matrix-settings.md b/docs/homey/products/m1/setup/m1-matrix-settings.md index a89318fbed..ac7ae872a1 100644 --- a/docs/homey/products/m1/setup/m1-matrix-settings.md +++ b/docs/homey/products/m1/setup/m1-matrix-settings.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Matrix Settings +description: Settings needed to get your M-1 LED Matrix driving the HUB75 panel correctly. --- --8<-- "products/m1/setup/m1-matrix-settings.md:7:" diff --git a/docs/homey/products/m1/setup/m1-multiple-panels.md b/docs/homey/products/m1/setup/m1-multiple-panels.md index ed5555c446..97a0bfc986 100644 --- a/docs/homey/products/m1/setup/m1-multiple-panels.md +++ b/docs/homey/products/m1/setup/m1-multiple-panels.md @@ -1,4 +1,5 @@ --- +title: Multiple Panels description: "Tutorial for wiring and configuring multiple panels with your M-1 LED Matrix." --- --8<-- "products/m1/setup/m1-multiple-panels.md:5:" diff --git a/docs/homey/products/m1/setup/m1-segments.md b/docs/homey/products/m1/setup/m1-segments.md index 88f2e2b0d9..95a2ea764d 100644 --- a/docs/homey/products/m1/setup/m1-segments.md +++ b/docs/homey/products/m1/setup/m1-segments.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Segments +description: Step by step guide for splitting your M-1 Matrix into multiple segments to display more information. --- --8<-- "products/m1/setup/m1-segments.md:7:" diff --git a/docs/homey/products/m1/setup/upgrade-to-wled.md b/docs/homey/products/m1/setup/upgrade-to-wled.md index f92585b2b2..48a4c8b40c 100644 --- a/docs/homey/products/m1/setup/upgrade-to-wled.md +++ b/docs/homey/products/m1/setup/upgrade-to-wled.md @@ -1,4 +1,5 @@ --- +title: Migrate to WLED description: "Move an M-1 from WLED-MM 14.5.1 to WLED 16.0.1 over the air, keeping your settings." --- --8<-- "products/m1/setup/upgrade-to-wled.md:5:" diff --git a/docs/homey/products/m1/setup/use-without-wifi.md b/docs/homey/products/m1/setup/use-without-wifi.md index 6a775061ed..2f3a777b36 100644 --- a/docs/homey/products/m1/setup/use-without-wifi.md +++ b/docs/homey/products/m1/setup/use-without-wifi.md @@ -1,4 +1,5 @@ --- +title: Use Without Wi-Fi description: "Run and control the M-1 with no network at all, using its own hotspot." --- --8<-- "products/m1/setup/use-without-wifi.md:5:" diff --git a/docs/homey/products/m1/troubleshooting/m1-boot-mode.md b/docs/homey/products/m1/troubleshooting/m1-boot-mode.md index d3b6faaebf..90fc07d76b 100644 --- a/docs/homey/products/m1/troubleshooting/m1-boot-mode.md +++ b/docs/homey/products/m1/troubleshooting/m1-boot-mode.md @@ -1,4 +1,5 @@ --- +title: M-1 Boot Mode description: "Step by step guide for putting The M-1 In Boot Mode." --- --8<-- "products/m1/troubleshooting/m1-boot-mode.md:5:" diff --git a/docs/homey/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md b/docs/homey/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md index 7c710efafa..f12eb8bca7 100644 --- a/docs/homey/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md +++ b/docs/homey/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Find IP and Hostname +description: Step by step guide for finding the IP address and the hostname of your M-1 device. --- --8<-- "products/m1/troubleshooting/m1-find-ip-address-and-hostname.md:7:" diff --git a/docs/homey/products/m1/troubleshooting/m1-panel-faults.md b/docs/homey/products/m1/troubleshooting/m1-panel-faults.md index 1151c24d4c..436e75732d 100644 --- a/docs/homey/products/m1/troubleshooting/m1-panel-faults.md +++ b/docs/homey/products/m1/troubleshooting/m1-panel-faults.md @@ -1,4 +1,5 @@ --- +title: Panel Troubleshooting description: "Match what your M-1 panel is showing to the likely cause and the fix." --- --8<-- "products/m1/troubleshooting/m1-panel-faults.md:5:" diff --git a/docs/homey/products/m1/troubleshooting/m1-reflash.md b/docs/homey/products/m1/troubleshooting/m1-reflash.md index 0c75af5988..3b94e101b6 100644 --- a/docs/homey/products/m1/troubleshooting/m1-reflash.md +++ b/docs/homey/products/m1/troubleshooting/m1-reflash.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash M-1 description: "Step by step guide for re-flashing the M-1 back to factory firmware." --- --8<-- "products/m1/troubleshooting/m1-reflash.md:5:" diff --git a/docs/homey/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md b/docs/homey/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md index ee14383f41..29d4c48402 100755 --- a/docs/homey/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md @@ -1,4 +1,5 @@ --- +title: 90 Degree Addon description: "Step by step tutorial for adding 90 degree USB-C to MSR-2" --- --8<-- "products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md:5:" diff --git a/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md b/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md index 310b86f431..3b6028426e 100755 --- a/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-co2-to-msr-2.md @@ -1,4 +1,5 @@ --- +title: Adding CO₂ To MSR-2 description: "Tutorial on adding the SCD40 CO2 sensor to your MSR-2." --- # Adding CO2 To MSR-2 diff --git a/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md b/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md index ca4f2cfad8..7fb68dcc91 100755 --- a/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-gpio-header-to-msr-2.md @@ -1,4 +1,5 @@ --- +title: Adding GPIO Header To MSR-2 description: "Tutorial on adding the GPIO Header to your MSR-2." --- # Adding GPIO Header To MSR-2 diff --git a/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md b/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md index b5cc63f3ac..3701facaf2 100755 --- a/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md +++ b/docs/homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md @@ -1,4 +1,5 @@ --- +title: Adding Rear Female USB-C To MSR-2 description: "Tutorial on adding the rear female USB-C port to your MSR-2." --- # Adding Rear Female USB-C To MSR-2 diff --git a/docs/homey/products/msr2/examples/gpio-header-control-an-led-strip.md b/docs/homey/products/msr2/examples/gpio-header-control-an-led-strip.md index becdf0d1b7..ad27a83637 100755 --- a/docs/homey/products/msr2/examples/gpio-header-control-an-led-strip.md +++ b/docs/homey/products/msr2/examples/gpio-header-control-an-led-strip.md @@ -1,4 +1,5 @@ --- +title: GPIO Header LED Strip description: "Wire a WS2812B LED strip to the Apollo GPIO Header and control it from Home Assistant." --- --8<-- "products/msr2/examples/gpio-header-control-an-led-strip.md:5:" diff --git a/docs/homey/products/msr2/examples/msr2-alarmo.md b/docs/homey/products/msr2/examples/msr2-alarmo.md index 6db6a604ed..30dd0ebf07 100755 --- a/docs/homey/products/msr2/examples/msr2-alarmo.md +++ b/docs/homey/products/msr2/examples/msr2-alarmo.md @@ -1,4 +1,5 @@ --- +title: MSR-2 + Alarmo Home Security Install description: "A tutorial for how to use the MSR-2 with Alarmo for an advanced DIY alarm system." --- # MSR-2 + Alarmo Home Security Install diff --git a/docs/homey/products/msr2/examples/msr2-dashboards.md b/docs/homey/products/msr2/examples/msr2-dashboards.md index 60362ec128..705b048605 100755 --- a/docs/homey/products/msr2/examples/msr2-dashboards.md +++ b/docs/homey/products/msr2/examples/msr2-dashboards.md @@ -1,4 +1,5 @@ --- +title: MSR-2 Home Assistant Dashboard Examples description: "Example dashboard cards for the MSR-2, including an ApexCharts scatter plot of radar distance you can copy and paste." --- # MSR-2 Home Assistant Dashboard Examples diff --git a/docs/homey/products/msr2/examples/using-msr-2-buzzer.md b/docs/homey/products/msr2/examples/using-msr-2-buzzer.md index 16cc491ad1..e6c8d0adbf 100755 --- a/docs/homey/products/msr2/examples/using-msr-2-buzzer.md +++ b/docs/homey/products/msr2/examples/using-msr-2-buzzer.md @@ -1,4 +1,5 @@ --- +title: Using MSR-2 Buzzer description: "Trigger the MSR-2 buzzer from developer tools, then reuse the same call in an automation." --- # Using MSR-2 Buzzer diff --git a/docs/homey/products/msr2/faq.md b/docs/homey/products/msr2/faq.md index 10c5898420..a39d5609fb 100755 --- a/docs/homey/products/msr2/faq.md +++ b/docs/homey/products/msr2/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently asked questions about the MSR-2 mmWave sensor." --- 1\. **What sensors are included in the MSR-2?** diff --git a/docs/homey/products/msr2/introduction.md b/docs/homey/products/msr2/introduction.md index 4cb78c5722..bd3a8193aa 100755 --- a/docs/homey/products/msr2/introduction.md +++ b/docs/homey/products/msr2/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for MSR-2, including setup, usage, and best practices." --- --8<-- "products/msr2/introduction.md:5:" \ No newline at end of file diff --git a/docs/homey/products/msr2/msr-2-reviews/home-tech-innovations-msr-2-review.md b/docs/homey/products/msr2/msr-2-reviews/home-tech-innovations-msr-2-review.md index 3f5e22c202..6beb8a94df 100755 --- a/docs/homey/products/msr2/msr-2-reviews/home-tech-innovations-msr-2-review.md +++ b/docs/homey/products/msr2/msr-2-reviews/home-tech-innovations-msr-2-review.md @@ -1,4 +1,5 @@ --- +title: Home Tech Innovations MSR-2 Review description: "Home Tech Innovations sets up the Apollo MSR-2 in three steps." --- # Home Tech Innovations MSR-2 Review diff --git a/docs/homey/products/msr2/msr-2-reviews/michael-leen-msr-2-review.md b/docs/homey/products/msr2/msr-2-reviews/michael-leen-msr-2-review.md index 9cd4674848..d7f3ca9737 100755 --- a/docs/homey/products/msr2/msr-2-reviews/michael-leen-msr-2-review.md +++ b/docs/homey/products/msr2/msr-2-reviews/michael-leen-msr-2-review.md @@ -1,4 +1,5 @@ --- +title: Michael Leen MSR-2 Review description: "Michael Leen reviews the Apollo MSR-2 mmWave multisensor." --- # Michael Leen MSR-2 Review diff --git a/docs/homey/products/msr2/msr-2-reviews/mostlychris-msr-2-review.md b/docs/homey/products/msr2/msr-2-reviews/mostlychris-msr-2-review.md index e8445e19d7..823dbf7381 100755 --- a/docs/homey/products/msr2/msr-2-reviews/mostlychris-msr-2-review.md +++ b/docs/homey/products/msr2/msr-2-reviews/mostlychris-msr-2-review.md @@ -1,4 +1,5 @@ --- +title: MostlyChris MSR-2 Review description: "MostlyChris reviews the Apollo MSR-2 presence sensor." --- # MostlyChris MSR-2 Review diff --git a/docs/homey/products/msr2/msr-2-reviews/simon-says-home-assistant-msr-2-review.md b/docs/homey/products/msr2/msr-2-reviews/simon-says-home-assistant-msr-2-review.md index 6c58a76ee7..ab3f35b3a2 100755 --- a/docs/homey/products/msr2/msr-2-reviews/simon-says-home-assistant-msr-2-review.md +++ b/docs/homey/products/msr2/msr-2-reviews/simon-says-home-assistant-msr-2-review.md @@ -1,4 +1,5 @@ --- +title: Simon Says Home Assistant MSR-2 Review description: "Simon Says Home Assistant reviews the Apollo MSR-2." --- # Simon Says Home Assistant MSR-2 Review diff --git a/docs/homey/products/msr2/msr-2-reviews/smart-home-australia-msr-2-review.md b/docs/homey/products/msr2/msr-2-reviews/smart-home-australia-msr-2-review.md index 4e098a6d4b..6d2dce1220 100755 --- a/docs/homey/products/msr2/msr-2-reviews/smart-home-australia-msr-2-review.md +++ b/docs/homey/products/msr2/msr-2-reviews/smart-home-australia-msr-2-review.md @@ -1,4 +1,5 @@ --- +title: Smart Home Australia MSR-2 Review description: "Smart Home Australia reviews the Apollo MSR-2 radar motion sensor." --- # Smart Home Australia MSR-2 Review diff --git a/docs/homey/products/msr2/msr-2-reviews/smart-home-scene-msr-2-review.md b/docs/homey/products/msr2/msr-2-reviews/smart-home-scene-msr-2-review.md index 15f6f465cb..42354520b9 100755 --- a/docs/homey/products/msr2/msr-2-reviews/smart-home-scene-msr-2-review.md +++ b/docs/homey/products/msr2/msr-2-reviews/smart-home-scene-msr-2-review.md @@ -1,4 +1,5 @@ --- +title: Smart Home Scene MSR-2 Review description: "The Smart Home Scene written review of the Apollo MSR-2." --- # Smart Home Scene MSR-2 Review diff --git a/docs/homey/products/msr2/msr2-reviews.md b/docs/homey/products/msr2/msr2-reviews.md index 78bb4b3e55..04fce09dd1 100755 --- a/docs/homey/products/msr2/msr2-reviews.md +++ b/docs/homey/products/msr2/msr2-reviews.md @@ -1,14 +1,15 @@ --- +title: Simon Says Home Assistant MSR-2 Review description: "YouTuber reviews and feedback about the MSR-2 sensor from Apollo Automation." --- # [Simon Says Home Assistant MSR-2 Review](https://www.youtube.com/watch?v=U4qUhFSAxbk) -# [Smart Home Scene MSR-2 Review](https://smarthomescene.com/reviews/apollo-msr-2-review-the-smallest-presence-sensor-ever-made/) +## [Smart Home Scene MSR-2 Review](https://smarthomescene.com/reviews/apollo-msr-2-review-the-smallest-presence-sensor-ever-made/) -# [Home Tech Innovations MSR-2 Review](https://www.youtube.com/watch?v=K3j2rR2dsY0) +## [Home Tech Innovations MSR-2 Review](https://www.youtube.com/watch?v=K3j2rR2dsY0) -# [MostlyChris MSR-2 Review](https://www.youtube.com/watch?v=nQpi2n5UWoQ) +## [MostlyChris MSR-2 Review](https://www.youtube.com/watch?v=nQpi2n5UWoQ) -# [Smart Home Australia MSR-2 Review](https://www.youtube.com/watch?v=EzVyzFwdgN4) +## [Smart Home Australia MSR-2 Review](https://www.youtube.com/watch?v=EzVyzFwdgN4) -# [Michael Leen MSR-2 Review](https://www.youtube.com/watch?v=VdVR8Gs002Q) \ No newline at end of file +## [Michael Leen MSR-2 Review](https://www.youtube.com/watch?v=VdVR8Gs002Q) \ No newline at end of file diff --git a/docs/homey/products/msr2/setup/co2-calibration-for-msr-2.md b/docs/homey/products/msr2/setup/co2-calibration-for-msr-2.md index 752c7ce470..2f758a8e11 100755 --- a/docs/homey/products/msr2/setup/co2-calibration-for-msr-2.md +++ b/docs/homey/products/msr2/setup/co2-calibration-for-msr-2.md @@ -1,6 +1,7 @@ --- +title: CO2 Calibration For MSR-2 description: "CO2 calibration for the MSR-2, covered by the general calibration guide." --- # CO2 Calibration For MSR-2 -##### Please refer to the [General CO2 Calibration](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) article \ No newline at end of file +## Please refer to the [General CO2 Calibration](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) article \ No newline at end of file diff --git a/docs/homey/products/msr2/setup/how-to-change-the-update-frequency-of-sensors.md b/docs/homey/products/msr2/setup/how-to-change-the-update-frequency-of-sensors.md index 388babcd44..9efe6ad0b5 100755 --- a/docs/homey/products/msr2/setup/how-to-change-the-update-frequency-of-sensors.md +++ b/docs/homey/products/msr2/setup/how-to-change-the-update-frequency-of-sensors.md @@ -1,6 +1,7 @@ --- +title: How To Change The Update Frequency Of Sensors description: "Changing how often the MSR-2 sensors report readings, covered by the general guide." --- # How To Change The Update Frequency Of Sensors -#### [How To Change The Update Frequency Of Sensors](https://wiki.apolloautomation.com/products/general/setup/change-the-update-frequency-of-sensors/) \ No newline at end of file +## [How To Change The Update Frequency Of Sensors](https://wiki.apolloautomation.com/products/general/setup/change-the-update-frequency-of-sensors/) \ No newline at end of file diff --git a/docs/homey/products/msr2/setup/mmwave-videos.md b/docs/homey/products/msr2/setup/mmwave-videos.md index b651f38e90..1161e50431 100644 --- a/docs/homey/products/msr2/setup/mmwave-videos.md +++ b/docs/homey/products/msr2/setup/mmwave-videos.md @@ -1,4 +1,5 @@ --- +title: mmWave Tuning Videos description: "Two short videos and a quick summary on how to best tune the LD2410B in the MSR-2!" --- ---8<-- "homey/products/general/calibrating-and-updating/mmwave-videos.md" +--8<-- "homey/products/general/calibrating-and-updating/mmwave-videos.md:5:" diff --git a/docs/homey/products/msr2/setup/msr2-general-tips.md b/docs/homey/products/msr2/setup/msr2-general-tips.md index 1c5cb28d5e..fbaaf90537 100755 --- a/docs/homey/products/msr2/setup/msr2-general-tips.md +++ b/docs/homey/products/msr2/setup/msr2-general-tips.md @@ -1,9 +1,10 @@ --- +title: General Tips description: "Multiple helpful images for mounting, lux/rgb, and gate and zone visualization." --- # General Tips -##### **Light Sensor (LTR-390UV)** +## **Light Sensor (LTR-390UV)** ![MSR-2 enclosure with the light sensor visible through the vent slots, outlined in red](/assets/20240514-123742.jpg) @@ -13,7 +14,7 @@ When mounting the MSR-2 be sure to position the device so that the two large hol Make sure that your automations do not interfere with each other. This includes being aware that your onboard LED can trigger the lux reading but not the uv reading of the LTR390 in your device. -##### **Mounting** +## **Mounting** The MSR-2 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120degree FOV of the mmWave radar. @@ -29,7 +30,7 @@ The MSR-2 can also be mounted on the ceiling if you can provide power and mount * Gates are pre-defined by the radar module and are in 0.75 meter increments. * Zones are user-configurable and are in cm. -##### **Gate and FOV Visualization** +## **Gate and FOV Visualization** **![Table of LD2410 gates 0 to 8 with distances in meters and feet and default move and still thresholds](/assets/ld2410-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)** diff --git a/docs/homey/products/msr2/setup/msr2-sensor-definitions.md b/docs/homey/products/msr2/setup/msr2-sensor-definitions.md index 8776754714..4f238d5098 100755 --- a/docs/homey/products/msr2/setup/msr2-sensor-definitions.md +++ b/docs/homey/products/msr2/setup/msr2-sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "These are all of the entities exposed by the MSR-2 to automate on!" --- --8<-- "products/msr2/setup/msr2-sensor-definitions.md:5:" diff --git a/docs/homey/products/msr2/setup/updating-msr-2-firmware.md b/docs/homey/products/msr2/setup/updating-msr-2-firmware.md index 6369a50dbc..35d0cfba78 100755 --- a/docs/homey/products/msr2/setup/updating-msr-2-firmware.md +++ b/docs/homey/products/msr2/setup/updating-msr-2-firmware.md @@ -1,6 +1,7 @@ --- +title: Updating MSR-2 Firmware description: "Updating MSR-2 firmware, covered by the general firmware update guide." --- # Updating MSR-2 Firmware -##### Please refer to the [general firmware update](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/updating-firmware/ "Updating Firmware") article \ No newline at end of file +## Please refer to the [general firmware update](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/updating-firmware/ "Updating Firmware") article \ No newline at end of file diff --git a/docs/homey/products/msr2/setup/zones-ha.md b/docs/homey/products/msr2/setup/zones-ha.md index ef72cb59f2..4a899335ef 100755 --- a/docs/homey/products/msr2/setup/zones-ha.md +++ b/docs/homey/products/msr2/setup/zones-ha.md @@ -1,4 +1,5 @@ --- +title: How To Tune mmWave Using Home Assistant description: "Tune the MSR-2 mmWave radar using Radar Engineering Mode to find which gates cause false triggers and raise their thresholds." --- # How To Tune mmWave Using Home Assistant diff --git a/docs/homey/products/msr2/setup/zones-hlk.md b/docs/homey/products/msr2/setup/zones-hlk.md index 1c09558b6c..a9e4bf6221 100755 --- a/docs/homey/products/msr2/setup/zones-hlk.md +++ b/docs/homey/products/msr2/setup/zones-hlk.md @@ -1,4 +1,5 @@ --- +title: How To Tune mmWave Using HLKRadarTool description: "Tutorial for MSR-2 HLKRadarTool app Zone Configuration." --- # How To Tune mmWave Using HLKRadarTool diff --git a/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md b/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md index 97d924b021..f4b96a2cb0 100755 --- a/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md +++ b/docs/homey/products/msr2/troubleshooting/msr2-boot-mode.md @@ -1,4 +1,5 @@ --- +title: Putting The MSR-2 In Boot Mode description: "Step by step guide for putting The MSR-2 In Boot Mode." --- # Putting The MSR-2 In Boot Mode @@ -7,7 +8,7 @@ description: "Step by step guide for putting The MSR-2 In Boot Mode." This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the MSR-2 as shown in the image below and locate the small opening to press the boot button (the right button). @@ -17,7 +18,7 @@ description: "Step by step guide for putting The MSR-2 In Boot Mode." 3\. Continue with uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/homey/products/msr2/troubleshooting/msr2-code.md b/docs/homey/products/msr2/troubleshooting/msr2-code.md index c213fa1e99..8fddc15467 100755 --- a/docs/homey/products/msr2/troubleshooting/msr2-code.md +++ b/docs/homey/products/msr2/troubleshooting/msr2-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash MSR-2 description: "Step by step guide for re-flashing the MSR-2 back to factory firmware." --- # Factory Re-Flash MSR-2 diff --git a/docs/homey/products/msr2/troubleshooting/msr2-reset-wi-fi-credentials.md b/docs/homey/products/msr2/troubleshooting/msr2-reset-wi-fi-credentials.md index a07d2359d4..7b25e1ea86 100755 --- a/docs/homey/products/msr2/troubleshooting/msr2-reset-wi-fi-credentials.md +++ b/docs/homey/products/msr2/troubleshooting/msr2-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials on your MSR-2 description: "Step by step guide for resetting the Wi-Fi Credentials on your MSR-2." --- # Reset Wi-Fi Credentials on your MSR-2 diff --git a/docs/homey/products/msr2/troubleshooting/msr2-teardown.md b/docs/homey/products/msr2/troubleshooting/msr2-teardown.md index c193571212..6ec62fa0a1 100755 --- a/docs/homey/products/msr2/troubleshooting/msr2-teardown.md +++ b/docs/homey/products/msr2/troubleshooting/msr2-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown and Reassembly Of MSR-2 description: "Step by step guide for tearing down your MSR-2 to replace parts, clean it, swap cases, etc." --- # Teardown and Reassembly Of MSR-2 diff --git a/docs/homey/products/mtr1/examples/crookedtoe-mtr1.md b/docs/homey/products/mtr1/examples/crookedtoe-mtr1.md index bc76aec51f..18ae4a0aeb 100755 --- a/docs/homey/products/mtr1/examples/crookedtoe-mtr1.md +++ b/docs/homey/products/mtr1/examples/crookedtoe-mtr1.md @@ -1,4 +1,5 @@ --- +title: MTR-1 Corner Mount STL by user CrookedToe description: "MTR-1 Corner Mount STL file" --- # MTR-1 Corner Mount STL by user CrookedToe diff --git a/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md b/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md index dfcdab55bb..852613bd33 100755 --- a/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md +++ b/docs/homey/products/mtr1/examples/mtr-1-home-assistant-dashboard-examples.md @@ -1,4 +1,5 @@ --- +title: MTR-1 Home Assistant Dashboard Examples description: "Example dashboard cards for the MTR-1, including an ApexCharts radar scatter plot you can copy and paste." --- # MTR-1 Home Assistant Dashboard Examples diff --git a/docs/homey/products/mtr1/examples/mtr1-alarmo.md b/docs/homey/products/mtr1/examples/mtr1-alarmo.md index 7dfdb31866..2ab0e3ad13 100755 --- a/docs/homey/products/mtr1/examples/mtr1-alarmo.md +++ b/docs/homey/products/mtr1/examples/mtr1-alarmo.md @@ -1,4 +1,5 @@ --- +title: MTR-1 + Alarmo Home Security Install description: "MTR-1 Alarmo setup" --- # MTR-1 + Alarmo Home Security Install diff --git a/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md b/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md index 1ce165353a..a470d6284a 100755 --- a/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md +++ b/docs/homey/products/mtr1/examples/using-mtr-1-buzzer.md @@ -1,4 +1,5 @@ --- +title: Using MTR-1 Buzzer description: "Trigger the MTR-1 buzzer from developer tools, then reuse the same call in an automation." --- # Using MTR-1 Buzzer diff --git a/docs/homey/products/mtr1/faq.md b/docs/homey/products/mtr1/faq.md index 0ab8bced99..8dbc852d39 100755 --- a/docs/homey/products/mtr1/faq.md +++ b/docs/homey/products/mtr1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently asked questions about the MTR-1 mmWave sensor." --- 1\. **What sensors are included in the MTR-1?** diff --git a/docs/homey/products/mtr1/introduction.md b/docs/homey/products/mtr1/introduction.md index 8a1eebf424..0ffd86b5f7 100755 --- a/docs/homey/products/mtr1/introduction.md +++ b/docs/homey/products/mtr1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for MTR-1, including setup, usage, and best practices." --- --8<-- "products/mtr1/introduction.md:5:" \ No newline at end of file diff --git a/docs/homey/products/mtr1/mtr-1-reviews/home-tech-innovations-mtr-1-review.md b/docs/homey/products/mtr1/mtr-1-reviews/home-tech-innovations-mtr-1-review.md index 50bee3838f..9ab6ac9986 100755 --- a/docs/homey/products/mtr1/mtr-1-reviews/home-tech-innovations-mtr-1-review.md +++ b/docs/homey/products/mtr1/mtr-1-reviews/home-tech-innovations-mtr-1-review.md @@ -1,4 +1,5 @@ --- +title: Home Tech Innovations MTR-1 Review description: "Home Tech Innovations sets up the Apollo MTR-1 in three steps." --- # Home Tech Innovations MTR-1 Review diff --git a/docs/homey/products/mtr1/mtr-1-reviews/michael-leen-mtr-1-review.md b/docs/homey/products/mtr1/mtr-1-reviews/michael-leen-mtr-1-review.md index c6a057f508..3193ba63b3 100755 --- a/docs/homey/products/mtr1/mtr-1-reviews/michael-leen-mtr-1-review.md +++ b/docs/homey/products/mtr1/mtr-1-reviews/michael-leen-mtr-1-review.md @@ -1,7 +1,8 @@ --- +title: Michael Leen MTR-1 Review description: "Michael Leen reviews presence detection on the Apollo MTR-1 multi-target radar." --- # Michael Leen MTR-1 Review -### PRECISE Presence Detection: Apollo MTR-1 Multi-Target Radar +## PRECISE Presence Detection: Apollo MTR-1 Multi-Target Radar diff --git a/docs/homey/products/mtr1/mtr-1-reviews/simon-says-home-assistant-mtr-1-review.md b/docs/homey/products/mtr1/mtr-1-reviews/simon-says-home-assistant-mtr-1-review.md index e3ad4bebf0..19ca249bbf 100755 --- a/docs/homey/products/mtr1/mtr-1-reviews/simon-says-home-assistant-mtr-1-review.md +++ b/docs/homey/products/mtr1/mtr-1-reviews/simon-says-home-assistant-mtr-1-review.md @@ -1,4 +1,5 @@ --- +title: Simon Says Home Assistant MTR-1 Review description: "Simon Says Home Assistant reviews the Apollo MTR-1 multi-target radar." --- # Simon Says Home Assistant MTR-1 Review diff --git a/docs/homey/products/mtr1/mtr-1-reviews/smart-home-australia-mtr-1-review.md b/docs/homey/products/mtr1/mtr-1-reviews/smart-home-australia-mtr-1-review.md index 2bfacd9f79..2cd7f96605 100755 --- a/docs/homey/products/mtr1/mtr-1-reviews/smart-home-australia-mtr-1-review.md +++ b/docs/homey/products/mtr1/mtr-1-reviews/smart-home-australia-mtr-1-review.md @@ -1,4 +1,5 @@ --- +title: Smart Home Australia MTR-1 Review description: "Smart Home Australia reviews the Apollo MTR-1, from installation through dashboards." --- # Smart Home Australia MTR-1 Review diff --git a/docs/homey/products/mtr1/mtr-1-reviews/smart-home-scene-mtr-1-review.md b/docs/homey/products/mtr1/mtr-1-reviews/smart-home-scene-mtr-1-review.md index b8befe62a1..0beadc5390 100755 --- a/docs/homey/products/mtr1/mtr-1-reviews/smart-home-scene-mtr-1-review.md +++ b/docs/homey/products/mtr1/mtr-1-reviews/smart-home-scene-mtr-1-review.md @@ -1,4 +1,5 @@ --- +title: Smart Home Scene MTR-1 Review description: "The Smart Home Scene written review of the Apollo MTR-1 multi-target tracking radar." --- # Smart Home Scene MTR-1 Review diff --git a/docs/homey/products/mtr1/mtr1-reviews.md b/docs/homey/products/mtr1/mtr1-reviews.md index 0dbe31e433..d8646f5b5d 100755 --- a/docs/homey/products/mtr1/mtr1-reviews.md +++ b/docs/homey/products/mtr1/mtr1-reviews.md @@ -1,12 +1,13 @@ --- +title: Home Tech Innovations MTR-1 Review description: "YouTuber reviews and feedback about the MTR-1 sensor from Apollo Automation." --- # [Home Tech Innovations MTR-1 Review](https://youtu.be/q5GejbxnByA?si=PMgK4ro6U8Q7idCm) -# [Simon Says Home Assistant MTR-1 Review](https://www.youtube.com/watch?v=FFN-vIkDRLk) +## [Simon Says Home Assistant MTR-1 Review](https://www.youtube.com/watch?v=FFN-vIkDRLk) -# [Smart Home Australia MTR-1 Review](https://www.youtube.com/watch?v=xyxgk7WGHCY) +## [Smart Home Australia MTR-1 Review](https://www.youtube.com/watch?v=xyxgk7WGHCY) -# [Smart Home Scene MTR-1 Review](https://smarthomescene.com/reviews/apollo-mtr-1-multi-target-tracking-radar-review/) +## [Smart Home Scene MTR-1 Review](https://smarthomescene.com/reviews/apollo-mtr-1-multi-target-tracking-radar-review/) -# [Michael Leen MTR-1 Review](https://www.youtube.com/watch?v=7qFvqRw1uds) \ No newline at end of file +## [Michael Leen MTR-1 Review](https://www.youtube.com/watch?v=7qFvqRw1uds) \ No newline at end of file diff --git a/docs/homey/products/mtr1/setup/co2-calibration-for-mtr-1.md b/docs/homey/products/mtr1/setup/co2-calibration-for-mtr-1.md index e36922b7f8..edc004c3b6 100755 --- a/docs/homey/products/mtr1/setup/co2-calibration-for-mtr-1.md +++ b/docs/homey/products/mtr1/setup/co2-calibration-for-mtr-1.md @@ -1,6 +1,7 @@ --- +title: CO2 Calibration For MTR-1 description: "CO2 calibration for the MTR-1, covered by the general calibration guide." --- # CO2 Calibration For MTR-1 -##### Please refer to the [General CO2 Calibration](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) article \ No newline at end of file +## Please refer to the [General CO2 Calibration](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) article \ No newline at end of file diff --git a/docs/homey/products/mtr1/setup/general-tips.md b/docs/homey/products/mtr1/setup/general-tips.md index 7c6b61eb27..94a42bca94 100755 --- a/docs/homey/products/mtr1/setup/general-tips.md +++ b/docs/homey/products/mtr1/setup/general-tips.md @@ -1,12 +1,13 @@ --- +title: General Tips description: "Multiple helpful images for mounting, lux/rgb, and zone visualization." --- -##### **MTR-1 PCB with Sensors** +## **MTR-1 PCB with Sensors** ![MTR-1 main board with the ESP32-C3, Boot and Reset buttons, RGB LED, and buzzer](/assets/20240501-155316.jpg)![MTR-1 with the HLK-LD2450 radar module laid out beside the ESP32-C3 board](/assets/20240501-155130.jpg)![Back of the MTR-1 board with the Apollo logo and USB-C port](/assets/20240501-155248.jpg) -##### **Light Sensor (LTR-390UV)** +## **Light Sensor (LTR-390UV)** ![MTR-1 case render with the light sensor opening at the top circled in red](/assets/screenshot-2024-04-30-at-5-42-54-pm.png) @@ -14,27 +15,27 @@ When mounting the MTR-1 be sure to position the device so that the large hole at The onboard RGB LED will trigger the light sensor. Be cognizant of this when making automations based on light/LUX. -##### **Mounting** +## **Mounting** ![LD2450 datasheet diagrams of wall mounting at 1.5 to 2 m, mounting angle, and tracking range](/assets/screenshot-2024-04-30-at-5-51-36-pm.png) -##### **LD2450 Performance and Electrical Parameters** +## **LD2450 Performance and Electrical Parameters** -##### [**LD2450 Datasheet**](https://www.tinytronics.nl/index.php?route=product/product/get_file&file=6000/HLK-LD2450-Instruction-Manual.pdf) +## [**LD2450 Datasheet**](https://www.tinytronics.nl/index.php?route=product/product/get_file&file=6000/HLK-LD2450-Instruction-Manual.pdf) ![LD2450 datasheet table of performance and electrical parameters](/assets/screenshot-2024-04-30-at-5-53-09-pm.png) -##### **Expanding Horizontal Distance as Target Moves Further Away** +## **Expanding Horizontal Distance as Target Moves Further Away** The detection is 60 degrees from center on each side. So it is a cone when you are close to it but at 4 feet away to the side you might not be visible. If you are further from the wall it can detect further in a horizontal distance. ![HLK-LD2450 demo app tracking two targets inside the wide radar detection cone](/assets/9jtimage.png) -##### **Increased ESP Temperature** +## **Increased ESP Temperature** If you are experiencing higher than normal ESP temperatures ~140+ degrees F then changing the Wi-Fi power save mode option might help decrease the temperature. Here is the link to the ESPHome WiFi Component [Power Save Mode](https://esphome.io/components/wifi.html#power-save-mode). -##### **Improve Wi-Fi Connection** +## **Improve Wi-Fi Connection** The Wi-Fi interface of all ESP32 devices offers three power save modes to reduce the amount of power spent on Wi-Fi. While some options can reduce the power usage of the ESP, they generally also decrease the reliability of the Wi-Fi connection, with frequent disconnections from the router in the highest power saving mode. Switch to "none" to get the best Wi-Fi performance! diff --git a/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md b/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md index 458d8ea29f..0b62981839 100755 --- a/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md +++ b/docs/homey/products/mtr1/setup/mtr-1-temperature-&-humidity-offsets.md @@ -1,9 +1,10 @@ --- +title: "MTR-1 Temperature & Humidity Offsets" description: "Add temperature and humidity offsets to your MTR-1 so its readings match the room it sits in." --- # MTR-1 Temperature & Humidity Offsets -#### **Simple Offsets for Temperature and Humidity:** +## **Simple Offsets for Temperature and Humidity:** **Please add these to the bottom of your ESPHome yaml for your device then click save and install. Once you are finished, you will have two new boxes inside the Home Assistant ESPHome integration device page for your device where you can fill in an offset. Give them up to 1minute to take effect!** @@ -48,11 +49,11 @@ number: mode: box ``` -#### **DPS310 & SCD40 Sensors: Overcoming Temperature & Humidity Reading Challenges** +## **DPS310 & SCD40 Sensors: Overcoming Temperature & Humidity Reading Challenges** The DPS310 and SCD40 sensors are known for their precision in measuring temperature and humidity. However, like all sensor systems, they can sometimes provide inaccurate readings due to various factors. In the case of the DPS310 and SCD40 sensors, one significant challenge arises from the heat produced by the ESP chip, which can alter the environment inside its enclosure, thereby skewing the readings. -#### **Adjusting the DPS310 and SCD40 Temperature Offset** +## **Adjusting the DPS310 and SCD40 Temperature Offset** For users who want to fine-tune their sensors, the DPS310 and SCD40 Temperature Offset entities can be manually adjusted to match the conditions in their home. The offset values are subtracted from the raw temperature & humidity readings in the firmware to update the sensor readings in the Home Assistant entity. For example: scd40\_temperature entity = raw scd40 temperature reading - scd40\_offset. @@ -60,7 +61,7 @@ By default, these offsets are preset to values based on our NIST certified therm Users will also notice the `dps310_temperature_calibrated`, `scd40_humidity_calibrated`, and `scd40_temperature_calibrated` entities. These values utilize the linear filter in the ESPHome firmware to adjust the readings based on our collected data. Again, due to environmental differences, these might not always be precise. -#### **Modeling the Relationship Between Sensors** +## **Modeling the Relationship Between Sensors** Another approach to getting accurate readings is to model the relationship between the ESP temperature and the other sensors compared against a reference temperature. This can be achieved by creating a template sensor in Home Assistant that employs a decision tree or our regression coefficients. @@ -129,10 +130,10 @@ notify: ``` -#### **The Interrelation of Temperature and Humidity** +## **The Interrelation of Temperature and Humidity** It's important to understand that temperature and humidity share an interdependent relationship. When the air temperature rises, its capacity to hold moisture increases, which can decrease relative humidity levels. Conversely, when the temperature falls, the air's capacity to hold moisture decreases, leading to increased humidity. This relationship plays a significant role in how sensors detect and interpret readings, making it even more crucial to ensure accuracy. -#### **Advanced Accuracy with GPIO** +## **Advanced Accuracy with GPIO** For those seeking the highest accuracy, an advanced solution is available. The exposed mezzanine connector on the back of our Apollo boards can be utilized to connect a temperature/humidity sensor. This modification can dramatically improve both temperature and humidity readings, providing data that's as accurate as possible. \ No newline at end of file diff --git a/docs/homey/products/mtr1/setup/sensor-definitions.md b/docs/homey/products/mtr1/setup/sensor-definitions.md index 077b174b60..63401b29c5 100755 --- a/docs/homey/products/mtr1/setup/sensor-definitions.md +++ b/docs/homey/products/mtr1/setup/sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "These are all of the entities exposed by the MTR-1 to automate on!" --- --8<-- "products/mtr1/setup/sensor-definitions.md:5:" \ No newline at end of file diff --git a/docs/homey/products/mtr1/setup/updating-mtr-1-firmware.md b/docs/homey/products/mtr1/setup/updating-mtr-1-firmware.md index 5ea0d77366..bdc3355358 100755 --- a/docs/homey/products/mtr1/setup/updating-mtr-1-firmware.md +++ b/docs/homey/products/mtr1/setup/updating-mtr-1-firmware.md @@ -1,6 +1,7 @@ --- +title: Updating MTR-1 Firmware description: "Updating MTR-1 firmware, covered by the general firmware update guide." --- # Updating MTR-1 Firmware -##### Please refer to the [general firmware update](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/updating-firmware/ "Updating Firmware") article \ No newline at end of file +## Please refer to the [general firmware update](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/updating-firmware/ "Updating Firmware") article \ No newline at end of file diff --git a/docs/homey/products/mtr1/setup/zones-hlk.md b/docs/homey/products/mtr1/setup/zones-hlk.md index 14ba096709..e59da59cdd 100755 --- a/docs/homey/products/mtr1/setup/zones-hlk.md +++ b/docs/homey/products/mtr1/setup/zones-hlk.md @@ -1,8 +1,9 @@ --- +title: (Better) HLK Radar Tool App description: "Tutorial for MTR-1 HLKRadarTool app Zone Configuration." --- -###### Configure Zones +## Configure Zones !!! note "Ensure that the LD2450 firmware version is V2.02.23090617 or later for proper integration functionality. " @@ -62,7 +63,7 @@ The uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/homey/products/mtr1/troubleshooting/mtr1-code.md b/docs/homey/products/mtr1/troubleshooting/mtr1-code.md index d7bf76630f..28eedab404 100755 --- a/docs/homey/products/mtr1/troubleshooting/mtr1-code.md +++ b/docs/homey/products/mtr1/troubleshooting/mtr1-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash MTR-1 description: "Step by step guide for re-flashing the MTR-1 back to factory firmware." --- # Factory Re-Flash MTR-1 diff --git a/docs/homey/products/mtr1/troubleshooting/mtr1-reset-wi-fi-credentials.md b/docs/homey/products/mtr1/troubleshooting/mtr1-reset-wi-fi-credentials.md index dcd5095501..a9707a90f0 100755 --- a/docs/homey/products/mtr1/troubleshooting/mtr1-reset-wi-fi-credentials.md +++ b/docs/homey/products/mtr1/troubleshooting/mtr1-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials description: "Step by step guide for resetting the Wi-Fi Credentials on your AIR-1." --- # Reset Wi-Fi Credentials diff --git a/docs/homey/products/mtr1/troubleshooting/mtr1-teardown.md b/docs/homey/products/mtr1/troubleshooting/mtr1-teardown.md index ad84dc8be3..8051dd8ec6 100755 --- a/docs/homey/products/mtr1/troubleshooting/mtr1-teardown.md +++ b/docs/homey/products/mtr1/troubleshooting/mtr1-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown and Reassembly of the MTR-1 description: "Step by step guide for tearing down your MTR-1 to replace parts, clean it, swap cases, etc." --- # Teardown and Reassembly of the MTR-1 diff --git a/docs/homey/products/plt1/calibrate-plt1.md b/docs/homey/products/plt1/calibrate-plt1.md index f165429c83..a288b3aee2 100644 --- a/docs/homey/products/plt1/calibrate-plt1.md +++ b/docs/homey/products/plt1/calibrate-plt1.md @@ -1,4 +1,5 @@ --- +title: Calibrating Soil Moisture description: "Step by step guide for calibrating the PLT-1." --- --8<-- "products/plt1/calibrate-plt1.md:5:" diff --git a/docs/homey/products/plt1/examples/flower-card.md b/docs/homey/products/plt1/examples/flower-card.md index 126d3424e5..400829088f 100755 --- a/docs/homey/products/plt1/examples/flower-card.md +++ b/docs/homey/products/plt1/examples/flower-card.md @@ -1,4 +1,5 @@ --- +title: Flower Card description: "Show PLT-1 readings with the Flower Card, using the Plant integration and OpenPlantBook." --- ![Flower Card for a ZZ Plant showing moisture, temperature, light, and humidity bars](/assets/screenshot-2024-09-26-at-10-17-09-am.png) diff --git a/docs/homey/products/plt1/faq.md b/docs/homey/products/plt1/faq.md index 812c2fa7b0..ceabd7d43d 100755 --- a/docs/homey/products/plt1/faq.md +++ b/docs/homey/products/plt1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "PLT-1 FAQ." --- 1\. **What sensors are included in the PLT-1?** diff --git a/docs/homey/products/plt1/general-tips.md b/docs/homey/products/plt1/general-tips.md index 5639c365ef..15d192ca4b 100755 --- a/docs/homey/products/plt1/general-tips.md +++ b/docs/homey/products/plt1/general-tips.md @@ -1,4 +1,5 @@ --- +title: General Tips description: "Helpful tips to get the most use out of your sensor." --- # General Tips diff --git a/docs/homey/products/plt1/introduction.md b/docs/homey/products/plt1/introduction.md index 7323265ba4..75749a2ee4 100755 --- a/docs/homey/products/plt1/introduction.md +++ b/docs/homey/products/plt1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "PLT-1 Introduction." --- --8<-- "products/plt1/introduction.md:5:" \ No newline at end of file diff --git a/docs/homey/products/plt1/reviews.md b/docs/homey/products/plt1/reviews.md index 57c6dcd7c3..934bb5feed 100755 --- a/docs/homey/products/plt1/reviews.md +++ b/docs/homey/products/plt1/reviews.md @@ -1,4 +1,5 @@ --- +title: Simon Says Home Assistant PLT-1 Review description: "YouTuber reviews and feedback about the PLT-1 sensor from Apollo Automation." --- # [Simon Says Home Assistant PLT-1 Review](https://youtu.be/hocliw98_Gk?si=8TMFLD7xiYah1RmJ) @@ -7,22 +8,22 @@ description: "YouTuber reviews and feedback about the PLT-1 sensor from Apollo A   -# [Michael Leen PLT-1 Review](https://youtu.be/tSYUJESNyFM?si=9k0OBns9XvNzYjyz) +## [Michael Leen PLT-1 Review](https://youtu.be/tSYUJESNyFM?si=9k0OBns9XvNzYjyz)
  -# [Mostly Chris PLT-1 Review](https://youtu.be/9TtLOLbf9zI?si=0wRhrtZ8f9KXqAhB) +## [Mostly Chris PLT-1 Review](https://youtu.be/9TtLOLbf9zI?si=0wRhrtZ8f9KXqAhB)
  -# Bearded Tinker PLT-1 Review +## Bearded Tinker PLT-1 Review -# Hands On Katie PLT-1 Review +## Hands On Katie PLT-1 Review -# Smart Home Scene PLT-1 Review +## Smart Home Scene PLT-1 Review -# Smart Home Australia PLT-1 Review \ No newline at end of file +## Smart Home Australia PLT-1 Review \ No newline at end of file diff --git a/docs/homey/products/plt1/setup/plt1-sensor-definitions.md b/docs/homey/products/plt1/setup/plt1-sensor-definitions.md index fed35695a1..4d8f86717a 100755 --- a/docs/homey/products/plt1/setup/plt1-sensor-definitions.md +++ b/docs/homey/products/plt1/setup/plt1-sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "Full list of definitions for the PLT-1 and its various sensors." --- --8<-- "products/plt1/setup/plt1-sensor-definitions.md:5:" diff --git a/docs/homey/products/plt1/setup/prevent-sleep.md b/docs/homey/products/plt1/setup/prevent-sleep.md index 209c26014c..85f032a75c 100755 --- a/docs/homey/products/plt1/setup/prevent-sleep.md +++ b/docs/homey/products/plt1/setup/prevent-sleep.md @@ -1,4 +1,5 @@ --- +title: Prevent Sleep description: "Tutorial for how to enable/disable prevent sleep." --- # Prevent Sleep diff --git a/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md b/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md index 860e57d6dd..28885aaa39 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-boot-mode.md @@ -1,4 +1,5 @@ --- +title: Putting The PLT-1 In Boot Mode description: "Step by step guide for putting The PLT-1 In Boot Mode." --- # Putting The PLT-1 In Boot Mode @@ -7,7 +8,7 @@ description: "Step by step guide for putting The PLT-1 In Boot Mode." This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the PLT-1 as shown in the image below and locate the small opening to press the boot button. @@ -17,7 +18,7 @@ description: "Step by step guide for putting The PLT-1 In Boot Mode." 3\. Continue with uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/homey/products/plt1/troubleshooting/plt1-code.md b/docs/homey/products/plt1/troubleshooting/plt1-code.md index 03c65cad4d..9cb9033934 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-code.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash PLT-1 description: "Step by step guide for re-flashing the PLT-1 back to factory firmware." --- # Factory Re-Flash PLT-1 diff --git a/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md b/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md index 45628b1c7a..42b2e4a932 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials on your PLT-1 description: "Step by step guide for resetting the Wi-Fi Credentials on your PLT-1." --- # Reset Wi-Fi Credentials on your PLT-1 diff --git a/docs/homey/products/plt1/troubleshooting/plt1-teardown.md b/docs/homey/products/plt1/troubleshooting/plt1-teardown.md index f6d86506b1..dd42896629 100755 --- a/docs/homey/products/plt1/troubleshooting/plt1-teardown.md +++ b/docs/homey/products/plt1/troubleshooting/plt1-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown and Reassembly Of PLT-1 description: "Step by step guide for tearing down your PLT-1 to replace parts, clean it, swap cases, etc." ---
\ No newline at end of file diff --git a/docs/homey/products/plt1b/additional-info/insert-battery.md b/docs/homey/products/plt1b/additional-info/insert-battery.md index 0e3317fff3..e309cf77bc 100644 --- a/docs/homey/products/plt1b/additional-info/insert-battery.md +++ b/docs/homey/products/plt1b/additional-info/insert-battery.md @@ -1,4 +1,5 @@ --- +title: Insert Battery description: "How to Insert Battery on PLT-1B." --- --8<-- "products/plt1b/additional-info/insert-battery.md:5:" diff --git a/docs/homey/products/plt1b/battery-sensors/sensor-connection-check.md b/docs/homey/products/plt1b/battery-sensors/sensor-connection-check.md index 225f658b14..6bc40dbe4f 100644 --- a/docs/homey/products/plt1b/battery-sensors/sensor-connection-check.md +++ b/docs/homey/products/plt1b/battery-sensors/sensor-connection-check.md @@ -1,4 +1,5 @@ --- +title: Sensor Connection Check description: "How to check if your device is connected to Wi-Fi, Home Assistant, or nothing." --- --8<-- "homey/products/general/battery-sensors/sensor-connection-check.md:5:" diff --git a/docs/homey/products/plt1b/battery-sensors/wake-up-battery-sensor.md b/docs/homey/products/plt1b/battery-sensors/wake-up-battery-sensor.md index 2f31e4f239..3055a66043 100644 --- a/docs/homey/products/plt1b/battery-sensors/wake-up-battery-sensor.md +++ b/docs/homey/products/plt1b/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "homey/products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/homey/products/plt1b/calibrate-plt1.md b/docs/homey/products/plt1b/calibrate-plt1.md index f520a79c5c..2967f8d81b 100644 --- a/docs/homey/products/plt1b/calibrate-plt1.md +++ b/docs/homey/products/plt1b/calibrate-plt1.md @@ -1,4 +1,5 @@ --- +title: Calibrating Soil Moisture description: "Step by step guide for calibrating the PLT-1B." --- --8<-- "products/plt1b/calibrate-plt1.md:5:" diff --git a/docs/homey/products/plt1b/examples/flower-card.md b/docs/homey/products/plt1b/examples/flower-card.md index 3c33a32344..f107ae590e 100644 --- a/docs/homey/products/plt1b/examples/flower-card.md +++ b/docs/homey/products/plt1b/examples/flower-card.md @@ -1,4 +1,5 @@ --- +title: Flower Card description: "Show PLT-1 readings with the Flower Card, using the Plant integration and OpenPlantBook." --- ---8<-- "homey/products/plt1/examples/flower-card.md" +--8<-- "homey/products/plt1/examples/flower-card.md:5:" diff --git a/docs/homey/products/plt1b/faq.md b/docs/homey/products/plt1b/faq.md index 352cba525b..aa6003d37d 100755 --- a/docs/homey/products/plt1b/faq.md +++ b/docs/homey/products/plt1b/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "PLT-1B FAQ." --- 1\. **What sensors are included in the PLT-1B?** diff --git a/docs/homey/products/plt1b/general-tips.md b/docs/homey/products/plt1b/general-tips.md index b686642dab..683dace8a2 100755 --- a/docs/homey/products/plt1b/general-tips.md +++ b/docs/homey/products/plt1b/general-tips.md @@ -1,4 +1,5 @@ --- +title: General Tips description: "Helpful tips to get the most use out of your sensor." --- # General Tips diff --git a/docs/homey/products/plt1b/introduction.md b/docs/homey/products/plt1b/introduction.md index d67a0475a4..13161ffb36 100755 --- a/docs/homey/products/plt1b/introduction.md +++ b/docs/homey/products/plt1b/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "PLT-1B Introduction." --- --8<-- "products/plt1b/introduction.md:5:" \ No newline at end of file diff --git a/docs/homey/products/plt1b/reviews.md b/docs/homey/products/plt1b/reviews.md index 4b084d6c3d..b8524b41a9 100644 --- a/docs/homey/products/plt1b/reviews.md +++ b/docs/homey/products/plt1b/reviews.md @@ -1,4 +1,5 @@ --- +title: Reviews description: "YouTuber reviews and feedback about the PLT-1 sensor from Apollo Automation." --- ---8<-- "homey/products/plt1/reviews.md" +--8<-- "homey/products/plt1/reviews.md:5:" diff --git a/docs/homey/products/plt1b/setup/getting-started-plt1.md b/docs/homey/products/plt1b/setup/getting-started-plt1.md index 04159bd0e3..340c9b1ac9 100644 --- a/docs/homey/products/plt1b/setup/getting-started-plt1.md +++ b/docs/homey/products/plt1b/setup/getting-started-plt1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" +--8<-- "homey/products/general/setup/getting-started.md:6:" diff --git a/docs/homey/products/plt1b/setup/plt1b-sensor-definitions.md b/docs/homey/products/plt1b/setup/plt1b-sensor-definitions.md index 8feb720b72..cd4d57f7ba 100755 --- a/docs/homey/products/plt1b/setup/plt1b-sensor-definitions.md +++ b/docs/homey/products/plt1b/setup/plt1b-sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "Full list of definitions for the PLT-1B and its various sensors." --- --8<-- "products/plt1b/setup/plt1b-sensor-definitions.md:5:" diff --git a/docs/homey/products/plt1b/setup/prevent-sleep.md b/docs/homey/products/plt1b/setup/prevent-sleep.md index 40b0e78488..442dc6c6ea 100755 --- a/docs/homey/products/plt1b/setup/prevent-sleep.md +++ b/docs/homey/products/plt1b/setup/prevent-sleep.md @@ -1,4 +1,5 @@ --- +title: Prevent Sleep description: "Keep the PLT-1B awake instead of letting it sleep, and what that costs in battery life." --- # Prevent Sleep diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md b/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md index 2172554c0d..b6da440c1d 100755 --- a/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md +++ b/docs/homey/products/plt1b/troubleshooting/plt1b-boot-mode.md @@ -1,4 +1,5 @@ --- +title: Putting The PLT-1B In Boot Mode description: "Step by step guide for putting The PLT-1B In Boot Mode." --- # Putting The PLT-1B In Boot Mode @@ -9,7 +10,7 @@ description: "Step by step guide for putting The PLT-1B In Boot Mode." ![PLT-1B diagram labeling the reset button on the left and the boot button and USB-C port on the right](/assets/plt-1b-buttons-2.png) -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the PLT-1B as shown in the image below and locate the small opening to press the boot button. @@ -21,7 +22,7 @@ description: "Step by step guide for putting The PLT-1B In Boot Mode." 3\. Continue with [uploading the firmware](https://wiki.apolloautomation.com/products/plt1b/troubleshooting/plt1b-code/) -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Plug in the device diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-code.md b/docs/homey/products/plt1b/troubleshooting/plt1b-code.md index 37e0ad4420..8bac3c6fcf 100755 --- a/docs/homey/products/plt1b/troubleshooting/plt1b-code.md +++ b/docs/homey/products/plt1b/troubleshooting/plt1b-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash PLT-1B description: "Step by step guide for re-flashing the PLT-1B back to factory firmware." --- # Factory Re-Flash PLT-1B @@ -31,7 +32,7 @@ If no device shows, click cancel and then install the recommended driver that sh 6\. Please proceed to the getting started guide and set up your sensor as a new device! -# Factory Re-Flash PLT-1B +## Factory Re-Flash PLT-1B !!! info "If your device becomes unresponsive and you've exhausted the other troubleshooting methods you can reflash the factory firmware by following the below guide." diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-reset-wi-fi-credentials.md b/docs/homey/products/plt1b/troubleshooting/plt1b-reset-wi-fi-credentials.md index 1d0a4cdb53..bb79f458ae 100755 --- a/docs/homey/products/plt1b/troubleshooting/plt1b-reset-wi-fi-credentials.md +++ b/docs/homey/products/plt1b/troubleshooting/plt1b-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials on your PLT-1B description: "Step by step guide for resetting the Wi-Fi Credentials on your PLT-1B." --- # Reset Wi-Fi Credentials on your PLT-1B diff --git a/docs/homey/products/plt1b/troubleshooting/plt1b-teardown.md b/docs/homey/products/plt1b/troubleshooting/plt1b-teardown.md index 0828ccc563..b0d1294e6d 100755 --- a/docs/homey/products/plt1b/troubleshooting/plt1b-teardown.md +++ b/docs/homey/products/plt1b/troubleshooting/plt1b-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown and Reassembly Of PLT-1B description: "Step by step guide for tearing down your PLT-1B to replace parts, clean it, swap cases, etc." ---
\ No newline at end of file diff --git a/docs/homey/products/pump1/addons/attaching-bottle-to-pump-1.md b/docs/homey/products/pump1/addons/attaching-bottle-to-pump-1.md index 761f46727e..5694ab10d9 100644 --- a/docs/homey/products/pump1/addons/attaching-bottle-to-pump-1.md +++ b/docs/homey/products/pump1/addons/attaching-bottle-to-pump-1.md @@ -1,4 +1,5 @@ --- +title: Bottle Addon description: "Tutorial for Attaching the bottle to the PUMP-1" --- --8<-- "products/pump1/addons/attaching-bottle-to-pump-1.md:5:" diff --git a/docs/homey/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md b/docs/homey/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md index f15fb2a33b..8341d1965f 100644 --- a/docs/homey/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md +++ b/docs/homey/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md @@ -1,4 +1,5 @@ --- +title: Fluid Sensor Addons description: "Tutorial for Attaching The Input and Output Fluid Level Sensors to the PUMP-1" --- --8<-- "products/pump1/addons/attaching-fluid-level-sensors-pump-1.md:5:" diff --git a/docs/homey/products/pump1/addons/attaching-tubes-to-pump-1.md b/docs/homey/products/pump1/addons/attaching-tubes-to-pump-1.md index e62b74f020..f1016354b2 100644 --- a/docs/homey/products/pump1/addons/attaching-tubes-to-pump-1.md +++ b/docs/homey/products/pump1/addons/attaching-tubes-to-pump-1.md @@ -1,4 +1,5 @@ --- +title: Inlet and Outlet Tube Addons description: "Tutorial for attaching both the Inlet and the Outlet tubes for the PUMP-1" --- --8<-- "products/pump1/addons/attaching-tubes-to-pump-1.md:5:" diff --git a/docs/homey/products/pump1/faq.md b/docs/homey/products/pump1/faq.md index 43a1250b7b..3965c5590f 100644 --- a/docs/homey/products/pump1/faq.md +++ b/docs/homey/products/pump1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently asked questions about the PUMP-1 Fluid Pump Sensor" --- --8<-- "products/pump1/faq.md:5:" diff --git a/docs/homey/products/pump1/introduction.md b/docs/homey/products/pump1/introduction.md index 04544f6f9f..b6fd0561f4 100644 --- a/docs/homey/products/pump1/introduction.md +++ b/docs/homey/products/pump1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for PUMP-1, including setup, usage, and best practices." --- --8<-- "products/pump1/introduction.md:5:" diff --git a/docs/homey/products/pump1/setup/pump1-general-tips.md b/docs/homey/products/pump1/setup/pump1-general-tips.md index af9345f69e..061c7ea708 100644 --- a/docs/homey/products/pump1/setup/pump1-general-tips.md +++ b/docs/homey/products/pump1/setup/pump1-general-tips.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: General Tips +description: Multiple helpful images for mounting, lux/rgb, and gate and zone visualization. --- --8<-- "products/pump1/setup/pump1-general-tips.md:7:" diff --git a/docs/homey/products/pump1/setup/pump1-sensor-definitions.md b/docs/homey/products/pump1/setup/pump1-sensor-definitions.md index 0ef7103291..59368e8247 100644 --- a/docs/homey/products/pump1/setup/pump1-sensor-definitions.md +++ b/docs/homey/products/pump1/setup/pump1-sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "These are all of the entities exposed by the PUMP-1 to automate on!" --- --8<-- "products/pump1/setup/pump1-sensor-definitions.md:5:" diff --git a/docs/homey/products/pump1/troubleshooting/pump1-boot-mode.md b/docs/homey/products/pump1/troubleshooting/pump1-boot-mode.md index 0a36dab9e1..6fd615e6a1 100644 --- a/docs/homey/products/pump1/troubleshooting/pump1-boot-mode.md +++ b/docs/homey/products/pump1/troubleshooting/pump1-boot-mode.md @@ -1,4 +1,5 @@ --- +title: PUMP-1 Boot Mode description: "Step by step guide for putting The PUMP-1 In Boot Mode." --- --8<-- "products/pump1/troubleshooting/pump1-boot-mode.md:5:" diff --git a/docs/homey/products/pump1/troubleshooting/pump1-reflash.md b/docs/homey/products/pump1/troubleshooting/pump1-reflash.md index 47e081e156..1c632aa880 100644 --- a/docs/homey/products/pump1/troubleshooting/pump1-reflash.md +++ b/docs/homey/products/pump1/troubleshooting/pump1-reflash.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash PUMP-1 description: "Step by step guide for reflashing The PUMP-1." --- --8<-- "products/pump1/troubleshooting/pump1-reflash.md:5:" diff --git a/docs/homey/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md b/docs/homey/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md index ec62dd7602..eb726a7958 100644 --- a/docs/homey/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md +++ b/docs/homey/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials description: "Step by step guide for resetting the Wi-Fi Credentials on your PUMP-1." --- --8<-- "products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md:5:" diff --git a/docs/homey/products/pump1/troubleshooting/pump1-teardown.md b/docs/homey/products/pump1/troubleshooting/pump1-teardown.md index 28696d065e..041aaa0718 100644 --- a/docs/homey/products/pump1/troubleshooting/pump1-teardown.md +++ b/docs/homey/products/pump1/troubleshooting/pump1-teardown.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Teardown and Reassembly Of PUMP-1 +description: Step by step guide for tearing down your PUMP-1 to replace parts, clean it, swap cases, etc. --- --8<-- "products/pump1/troubleshooting/pump1-teardown.md:7:" diff --git a/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md b/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md index 0697268a78..bb8b25162c 100644 --- a/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md +++ b/docs/homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md @@ -1,4 +1,5 @@ --- +title: LD2412 Addon description: "Tutorial on adding the LD2412 mmWave sensor to your R PRO-1" --- --8<-- "products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md:5:" diff --git a/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md b/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md index ec2d6812f1..9006a28d76 100644 --- a/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md +++ b/docs/homey/products/rpro1/addons/adding-co2-to-r-pro-1.md @@ -1,4 +1,5 @@ --- +title: CO₂ Addon description: "Tutorial on adding the SCD40 CO2 sensor to your R PRO-1." --- --8<-- "products/rpro1/addons/adding-co2-to-r-pro-1.md:5:" diff --git a/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md b/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md index bb31a9f7f8..916bc16ae1 100644 --- a/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md +++ b/docs/homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md @@ -1,4 +1,5 @@ --- +title: 1-Gang Box Mount description: "Tutorial on adding the gang box mounts to your R PRO-1." --- --8<-- "products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md:5:" diff --git a/docs/homey/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md b/docs/homey/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md index 25c80bbcbd..6a374ff6c7 100644 --- a/docs/homey/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md +++ b/docs/homey/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md @@ -1,4 +1,5 @@ --- +title: Ceiling Mount description: "Tutorial on installing the ceiling mount addon for the R PRO-1." --- --8<-- "products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md:5:" diff --git a/docs/homey/products/rpro1/faq.md b/docs/homey/products/rpro1/faq.md index ac0890cccd..c67ff78dd2 100644 --- a/docs/homey/products/rpro1/faq.md +++ b/docs/homey/products/rpro1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Frequently asked questions about the R PRO-1 PoE mmWave sensor." --- --8<-- "products/rpro1/faq.md:5:" diff --git a/docs/homey/products/rpro1/introduction.md b/docs/homey/products/rpro1/introduction.md index 3691e5a466..1c301c49fe 100644 --- a/docs/homey/products/rpro1/introduction.md +++ b/docs/homey/products/rpro1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for R PRO-1, including setup, usage, and best practices." --- --8<-- "products/rpro1/introduction.md:5:" diff --git a/docs/homey/products/rpro1/rpro1-reviews.md b/docs/homey/products/rpro1/rpro1-reviews.md index fbc0fb7165..a86ceefdf1 100644 --- a/docs/homey/products/rpro1/rpro1-reviews.md +++ b/docs/homey/products/rpro1/rpro1-reviews.md @@ -1,4 +1,5 @@ --- +title: Reviews description: "YouTuber reviews and feedback about the R PRO-1 sensor from Apollo Automation." --- --8<-- "products/rpro1/rpro1-reviews.md:5:" diff --git a/docs/homey/products/rpro1/setup/rpro1-general-tips.md b/docs/homey/products/rpro1/setup/rpro1-general-tips.md index 17811f5d14..745d845a21 100644 --- a/docs/homey/products/rpro1/setup/rpro1-general-tips.md +++ b/docs/homey/products/rpro1/setup/rpro1-general-tips.md @@ -1,4 +1,5 @@ --- +title: General Tips description: "Multiple helpful images for mounting, lux/rgb, and gate and zone visualization." --- --8<-- "products/rpro1/setup/rpro1-general-tips.md:5:" diff --git a/docs/homey/products/rpro1/setup/rpro1-sensor-definitions.md b/docs/homey/products/rpro1/setup/rpro1-sensor-definitions.md index e655d151bd..abc349d912 100644 --- a/docs/homey/products/rpro1/setup/rpro1-sensor-definitions.md +++ b/docs/homey/products/rpro1/setup/rpro1-sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "These are all of the entities exposed by the R PRO-1 to automate on!" --- --8<-- "products/rpro1/setup/rpro1-sensor-definitions.md:5:" diff --git a/docs/homey/products/rpro1/setup/rpro1-switch-firmware.md b/docs/homey/products/rpro1/setup/rpro1-switch-firmware.md index fc8e8f1f35..96cc862e88 100644 --- a/docs/homey/products/rpro1/setup/rpro1-switch-firmware.md +++ b/docs/homey/products/rpro1/setup/rpro1-switch-firmware.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Switch Firmware +description: Step by step guide to switching between Wi-Fi and Ethernet firmware on R PRO-1. --- --8<-- "products/rpro1/setup/rpro1-switch-firmware.md:7:" diff --git a/docs/homey/products/rpro1/setup/zones-hlk.md b/docs/homey/products/rpro1/setup/zones-hlk.md index 0eea7225fd..f4f5a45935 100644 --- a/docs/homey/products/rpro1/setup/zones-hlk.md +++ b/docs/homey/products/rpro1/setup/zones-hlk.md @@ -1,4 +1,5 @@ --- +title: How To Tune mmWave Using HLKRadarTool description: "Tutorial for R PRO-1 HLKRadarTool app Zone Configuration." --- # How To Tune mmWave Using HLKRadarTool @@ -17,7 +18,7 @@ description: "Tutorial for R PRO-1 HLKRadarTool app Zone Configuration." If the `.local` address doesn't load, use your router to find the device's IP address and use that instead. -###### LD2450 Configuration +## LD2450 Configuration !!! note "Ensure that the LD2450 firmware version is V2.02.23090617 or later for proper integration functionality. " @@ -71,7 +72,7 @@ The   -# [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/) +## [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/)   -# [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W) +## [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W)
  -# [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0) +## [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0)
\ No newline at end of file diff --git a/docs/homey/products/temp1/setup/getting-started-temp1.md b/docs/homey/products/temp1/setup/getting-started-temp1.md index ab09481604..7e77e91c4a 100644 --- a/docs/homey/products/temp1/setup/getting-started-temp1.md +++ b/docs/homey/products/temp1/setup/getting-started-temp1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- --8<-- "homey/products/general/setup/getting-started-temp1.md:5:" diff --git a/docs/homey/products/temp1/setup/prevent-sleep.md b/docs/homey/products/temp1/setup/prevent-sleep.md index d78b682d20..2eeea90ed5 100755 --- a/docs/homey/products/temp1/setup/prevent-sleep.md +++ b/docs/homey/products/temp1/setup/prevent-sleep.md @@ -1,4 +1,5 @@ --- +title: Prevent Sleep description: "Guide for setting up and using the prevent sleep toggle with the TEMP-1." --- # Prevent Sleep diff --git a/docs/homey/products/temp1/setup/temp1-sensor-definitions.md b/docs/homey/products/temp1/setup/temp1-sensor-definitions.md index 2701c7e83f..38e8ff2b62 100755 --- a/docs/homey/products/temp1/setup/temp1-sensor-definitions.md +++ b/docs/homey/products/temp1/setup/temp1-sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "Full list of definitions for the TEMP-1 and its various sensors." --- --8<-- "products/temp1/setup/temp1-sensor-definitions.md:5:" diff --git a/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md b/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md index bf8da66557..765fb4f692 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-boot-mode.md @@ -1,4 +1,5 @@ --- +title: Putting The TEMP-1 In Boot Mode description: "Step by step guide for putting The TEMP-1 In Boot Mode." --- # Putting The TEMP-1 In Boot Mode @@ -7,7 +8,7 @@ description: "Step by step guide for putting The TEMP-1 In Boot Mode." This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the TEMP-1 so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. @@ -23,7 +24,7 @@ If you prefer, please remove the lid by gently prying up on the small slit by th 3\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/homey/products/temp1/troubleshooting/temp1-code/). -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and remove the case as shown in the images above diff --git a/docs/homey/products/temp1/troubleshooting/temp1-code.md b/docs/homey/products/temp1/troubleshooting/temp1-code.md index fc6f61b086..5b5511e7ad 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-code.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash TEMP-1 description: "Step by step guide for re-flashing the TEMP-1 back to factory firmware." --- # Factory Re-Flash TEMP-1 diff --git a/docs/homey/products/temp1/troubleshooting/temp1-reset-wi-fi-credentials.md b/docs/homey/products/temp1/troubleshooting/temp1-reset-wi-fi-credentials.md index c46abde386..e4d198b3f7 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-reset-wi-fi-credentials.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials on your TEMP-1 description: "Step by step guide for resetting the Wi-Fi Credentials on your TEMP-1." --- # Reset Wi-Fi Credentials on your TEMP-1 diff --git a/docs/homey/products/temp1/troubleshooting/temp1-teardown.md b/docs/homey/products/temp1/troubleshooting/temp1-teardown.md index 4faa3ab9da..6bb0a66537 100755 --- a/docs/homey/products/temp1/troubleshooting/temp1-teardown.md +++ b/docs/homey/products/temp1/troubleshooting/temp1-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown Of TEMP-1 description: "Step by step guide for tearing down your TEMP-1 to replace parts, clean it, swap cases, etc." --- # Teardown Of TEMP-1 diff --git a/docs/homey/products/temp1b/addons/food-probe.md b/docs/homey/products/temp1b/addons/food-probe.md index d81db62e97..fa776a744f 100755 --- a/docs/homey/products/temp1b/addons/food-probe.md +++ b/docs/homey/products/temp1b/addons/food-probe.md @@ -1,4 +1,5 @@ --- +title: TEMP-1B Food Probe description: "Step by step guide for installing and using the optional Food Probe with the TEMP-1B." --- # TEMP-1B Food Probe diff --git a/docs/homey/products/temp1b/addons/magnetic-mount.md b/docs/homey/products/temp1b/addons/magnetic-mount.md index 3e70d04179..d7c12c7d1e 100755 --- a/docs/homey/products/temp1b/addons/magnetic-mount.md +++ b/docs/homey/products/temp1b/addons/magnetic-mount.md @@ -1,4 +1,5 @@ --- +title: TEMP-1B Magnetic Mount description: "Step by step guide for installing and using the optional Magnetic Mount with the TEMP-1B." --- # TEMP-1B Magnetic Mount diff --git a/docs/homey/products/temp1b/addons/multiple-probes.md b/docs/homey/products/temp1b/addons/multiple-probes.md index f38cb36351..13a6a9fd19 100644 --- a/docs/homey/products/temp1b/addons/multiple-probes.md +++ b/docs/homey/products/temp1b/addons/multiple-probes.md @@ -1,4 +1,5 @@ --- +title: Multi-Probe Splitter description: "Step by step guide for installing and using the TEMP-1 Multi-Probe Splitter addon." --- --8<-- "products/temp1/addons/multiple-probes.md:5:" diff --git a/docs/homey/products/temp1b/addons/temp-probe.md b/docs/homey/products/temp1b/addons/temp-probe.md index 7f9fe289d9..d753836006 100755 --- a/docs/homey/products/temp1b/addons/temp-probe.md +++ b/docs/homey/products/temp1b/addons/temp-probe.md @@ -1,4 +1,5 @@ --- +title: Temp Probe description: "Step by step guide for installing and using the optional Temp Probe with the TEMP-1B." --- --8<-- "products/temp1b/addons/temp-probe.md:5:" diff --git a/docs/homey/products/temp1b/battery-sensors/sensor-connection-check.md b/docs/homey/products/temp1b/battery-sensors/sensor-connection-check.md index 225f658b14..6bc40dbe4f 100644 --- a/docs/homey/products/temp1b/battery-sensors/sensor-connection-check.md +++ b/docs/homey/products/temp1b/battery-sensors/sensor-connection-check.md @@ -1,4 +1,5 @@ --- +title: Sensor Connection Check description: "How to check if your device is connected to Wi-Fi, Home Assistant, or nothing." --- --8<-- "homey/products/general/battery-sensors/sensor-connection-check.md:5:" diff --git a/docs/homey/products/temp1b/battery-sensors/wake-up-battery-sensor.md b/docs/homey/products/temp1b/battery-sensors/wake-up-battery-sensor.md index 2f31e4f239..3055a66043 100644 --- a/docs/homey/products/temp1b/battery-sensors/wake-up-battery-sensor.md +++ b/docs/homey/products/temp1b/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "homey/products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/homey/products/temp1b/examples/temp1b-alert-example.md b/docs/homey/products/temp1b/examples/temp1b-alert-example.md index 2b143c7355..eccc8681b4 100755 --- a/docs/homey/products/temp1b/examples/temp1b-alert-example.md +++ b/docs/homey/products/temp1b/examples/temp1b-alert-example.md @@ -1,4 +1,5 @@ --- +title: TEMP-1B Alert Outside Temp Range Example description: "Step by step guide for alerting outside the set range with the TEMP-1B." --- # TEMP-1B Alert Outside Temp Range Example diff --git a/docs/homey/products/temp1b/examples/temp1b-automation-examples.md b/docs/homey/products/temp1b/examples/temp1b-automation-examples.md index 14d1bef0e5..108cca7f5d 100755 --- a/docs/homey/products/temp1b/examples/temp1b-automation-examples.md +++ b/docs/homey/products/temp1b/examples/temp1b-automation-examples.md @@ -1,9 +1,10 @@ --- +title: Automation Examples using a TEMP-1B description: "Multiple automation examples with the TEMP-1B." --- # Automation Examples using a TEMP-1B -###### Freezer Temperature Probe Example +## Freezer Temperature Probe Example This will guide you through how to set up an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -65,7 +66,7 @@ actions: mode: single ``` -###### Food Probe Example +## Food Probe Example This will guide you through how to set up an automation in Home Assistant using the food probe with Chicken(or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -120,7 +121,7 @@ actions: mode: single ``` -###### Cook Chicken Example +## Cook Chicken Example This will guide you through adding a button to your dashboard called "Chicken Monitor" and an automation that runs when the button is pressed! This will turn the RGB LED Green when running, message your phone when it starts and when it finishes, plus when the temperature is reached, then turn the RGB LED off. Thanks to Discord user RalphP for this! diff --git a/docs/homey/products/temp1b/examples/use-cases.md b/docs/homey/products/temp1b/examples/use-cases.md index 456fcc13b0..922bd1ab1e 100755 --- a/docs/homey/products/temp1b/examples/use-cases.md +++ b/docs/homey/products/temp1b/examples/use-cases.md @@ -1,4 +1,5 @@ --- +title: Use Cases for the TEMP-1B description: "List of use cases for the TEMP-1B." --- # Use Cases for the TEMP-1B diff --git a/docs/homey/products/temp1b/faq.md b/docs/homey/products/temp1b/faq.md index 86e25e7317..9469fbc1b9 100755 --- a/docs/homey/products/temp1b/faq.md +++ b/docs/homey/products/temp1b/faq.md @@ -1,4 +1,5 @@ --- +title: TEMP-1B FAQ description: "Frequently asked questions about the TEMP-1B temperature sensor." --- # **TEMP-1B FAQ** diff --git a/docs/homey/products/temp1b/introduction.md b/docs/homey/products/temp1b/introduction.md index ee6918a5d1..475a6e1375 100755 --- a/docs/homey/products/temp1b/introduction.md +++ b/docs/homey/products/temp1b/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "Documentation for TEMP-1B, including setup, usage, and best practices." --- --8<-- "products/temp1b/introduction.md:5:" \ No newline at end of file diff --git a/docs/homey/products/temp1b/reviews.md b/docs/homey/products/temp1b/reviews.md index f3644bd6c5..8262f9d9cf 100755 --- a/docs/homey/products/temp1b/reviews.md +++ b/docs/homey/products/temp1b/reviews.md @@ -1,4 +1,5 @@ --- +title: Simon Says Home Assistant description: "YouTuber reviews and feedback about the TEMP-1B sensor from Apollo Automation." --- # [Simon Says Home Assistant](https://youtu.be/95etWGwEJPE?si=gdLCXFiWmuj2JUjD) @@ -7,22 +8,22 @@ description: "YouTuber reviews and feedback about the TEMP-1B sensor from Apollo   -# [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti) +## [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti)
  -# [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/) +## [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/)   -# [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W) +## [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W)
  -# [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0) +## [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0)
\ No newline at end of file diff --git a/docs/homey/products/temp1b/setup/getting-started-temp1.md b/docs/homey/products/temp1b/setup/getting-started-temp1.md index 04159bd0e3..340c9b1ac9 100644 --- a/docs/homey/products/temp1b/setup/getting-started-temp1.md +++ b/docs/homey/products/temp1b/setup/getting-started-temp1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- ---8<-- "homey/products/general/setup/getting-started.md:5:" +--8<-- "homey/products/general/setup/getting-started.md:6:" diff --git a/docs/homey/products/temp1b/setup/insert-battery.md b/docs/homey/products/temp1b/setup/insert-battery.md index 4c0221cc1a..917e662bc0 100755 --- a/docs/homey/products/temp1b/setup/insert-battery.md +++ b/docs/homey/products/temp1b/setup/insert-battery.md @@ -1,4 +1,5 @@ --- +title: How to Insert the Battery description: "How to Insert Battery on TEMP-1B." --- # How to Insert the Battery diff --git a/docs/homey/products/temp1b/setup/prevent-sleep.md b/docs/homey/products/temp1b/setup/prevent-sleep.md index dc6e11ff08..49c48de5c2 100755 --- a/docs/homey/products/temp1b/setup/prevent-sleep.md +++ b/docs/homey/products/temp1b/setup/prevent-sleep.md @@ -1,4 +1,5 @@ --- +title: Prevent Sleep description: "Keep the TEMP-1B awake instead of letting it sleep, and what that costs in battery life." --- # Prevent Sleep diff --git a/docs/homey/products/temp1b/setup/temp1b-sensor-definitions.md b/docs/homey/products/temp1b/setup/temp1b-sensor-definitions.md index a1840d40a5..38a3171403 100755 --- a/docs/homey/products/temp1b/setup/temp1b-sensor-definitions.md +++ b/docs/homey/products/temp1b/setup/temp1b-sensor-definitions.md @@ -1,4 +1,5 @@ --- +title: Sensor Definitions description: "Full list of definitions for the TEMP-1B and its various sensors." --- --8<-- "products/temp1b/setup/temp1b-sensor-definitions.md:5:" diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md b/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md index a4992032ad..02146f5d1e 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-boot-mode.md @@ -1,4 +1,5 @@ --- +title: Putting The TEMP-1B In Boot Mode description: "Step by step guide for putting The TEMP-1B In Boot Mode." --- # Putting The TEMP-1B In Boot Mode @@ -7,7 +8,7 @@ description: "Step by step guide for putting The TEMP-1B In Boot Mode." This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the TEMP-1B so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. @@ -23,7 +24,7 @@ If you prefer, please remove the lid by gently prying up on the small slit by th 3\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/homey/products/temp1b/troubleshooting/temp1b-code/). -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and remove the case as shown in the images above diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-code.md b/docs/homey/products/temp1b/troubleshooting/temp1b-code.md index 1172203fb5..4f5e59e328 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-code.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash TEMP-1B description: "Step by step guide for re-flashing the TEMP-1B back to factory firmware." --- # Factory Re-Flash TEMP-1B diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-reset-wi-fi-credentials.md b/docs/homey/products/temp1b/troubleshooting/temp1b-reset-wi-fi-credentials.md index f49e9280eb..391698c438 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-reset-wi-fi-credentials.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials on your TEMP-1B description: "Step by step guide for resetting the Wi-Fi Credentials on your TEMP-1B." --- # Reset Wi-Fi Credentials on your TEMP-1B diff --git a/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md b/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md index 037ac5e096..06fd327083 100755 --- a/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md +++ b/docs/homey/products/temp1b/troubleshooting/temp1b-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown Of TEMP-1B description: "Step by step guide for tearing down your TEMP-1B to replace parts, clean it, swap cases, etc." --- # Teardown Of TEMP-1B diff --git a/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md b/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md index f6d1d724fa..d272c240a5 100644 --- a/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md +++ b/docs/products/ESPHome-Starter-Kit/automations/motion-activated-light.md @@ -23,7 +23,7 @@ This tutorial uses the Motion module and the LED & Buzzer module connected to th ESPHome Device Builder has a GUI for building
automations, so you can wire a trigger to an action without hand-writing YAML. The trigger is the *when*, the thing that makes it fire. The action is the *then do*, what happens when it fires. You'll build two automations on the same Motion module: one that turns the lights on when motion is detected, and one that turns them off when motion stops. -#### Turn the lights on +### Turn the lights on 1. Open your starter kit device in ESPHome Device Builder and click **Edit**. If you need a refresher on the editor, see the [Device Builder Tour](../learning-the-basics/device-builder-tour.md#editor). 2. In the editor's left pane, expand the **Automations** dropdown and click **Add Automation**. @@ -79,7 +79,7 @@ ESPHome Device Builder has a GUI for building esphome-starter-kit.local (or the device's IP address) in any browser on your network, on a phone or PC, and you can toggle the LED, view sensor readings, and control the device directly. No Home Assistant required. See the [Web Server in Core Components](core-components.md#web-server) for more. -#### From Home Assistant +### From Home Assistant Home Assistant discovers your device automatically through the **ESPHome integration**. Each of your device's sensors, switches, and lights then appears in Home Assistant as an entity you can use in dashboards and automations. diff --git a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md index a9089183b0..08dbf72e69 100644 --- a/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md +++ b/docs/products/ESPHome-Starter-Kit/learning-the-basics/what-is-yaml.md @@ -12,7 +12,7 @@ You do not have to write YAML yourself when using the **ESPHome Device Builder** YAML is built from three ideas: key-value pairs, indentation, and lists. -#### Key and value +### Key and value Most lines are a name, a colon, then a value: @@ -21,7 +21,7 @@ name: esphome-starter-kit platform: ESP32 ``` -#### Indentation groups things together +### Indentation groups things together Indentation shows which settings belong to which item: @@ -33,7 +33,7 @@ wifi: Here, `ssid` and `password` belong to `wifi`. The two spaces in front are what links them. -#### Lists use dashes +### Lists use dashes A dash at the start of a line means "this is one item in a list": @@ -47,7 +47,7 @@ sensor: That is two sensors, each with its own settings. -#### Comments +### Comments A `#` starts a comment. Anything after it on that line is ignored, which makes it useful for leaving yourself notes: @@ -58,7 +58,7 @@ light: pin: GPIO8 ``` -#### Quoting strings +### Quoting strings Most text values do not need quotes. You only need quotes if your value contains special characters, starts with a number, or could be confused for something else (like the word `yes` or `no`). When in doubt, quotes are always safe: diff --git a/docs/products/ESPHome-Starter-Kit/modules/battery.md b/docs/products/ESPHome-Starter-Kit/modules/battery.md index 48d59f106d..a89ee56c04 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/battery.md +++ b/docs/products/ESPHome-Starter-Kit/modules/battery.md @@ -118,7 +118,7 @@ A few things to know before you rely on it: One difference for the starter kit: the Button module's pin reads LOW when pressed (it uses a pull-up), the opposite of the BTN-1's buttons. So on the starter kit you'd wake on `mode: ALL_LOW` with GPIO6 as the only pin. -#### Add a Prevent Sleep switch +### Add a Prevent Sleep switch A sleeping device is a hard one to update. Every Apollo battery device ships with a **Prevent Sleep** switch for exactly this reason, and you can build the same thing into your starter kit config. It's a template switch that holds the device awake while it's on: diff --git a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md index 238e4d0527..1243569c11 100644 --- a/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md +++ b/docs/products/ESPHome-Starter-Kit/modules/breakout-addons/sen65-air-quality-sensor.md @@ -172,11 +172,11 @@ If the SEN65's temperature or humidity doesn't agree with another thermometer or 1. Sensirion's SEN6x temperature compensation application note explains the self-heating effect and the math behind correcting it. -#### Measure your offsets +### Measure your offsets Let the kit run in its normal spot for at least half an hour, out of sunlight and away from vents. Put a thermometer you trust next to it and note how far off each reading is. Reading 23.5 °C in a 21.5 °C room means your temperature offset is 2 °C. One caution on the reference: dial-style analog hygrometers are commonly off by ±5 %RH or more, so a disagreement with one of those may say more about the dial than the SEN65. -#### Fixed offsets +### Fixed offsets Open your device in Device Builder, click **Edit**, and add a `filters:` block under `temperature:` and `humidity:` in the sen6x component: @@ -193,7 +193,7 @@ Open your device in Device Builder, click **Edit**, and add a `filters:` block u The `offset` filter adds its value to every reading: a temperature that reads 2 °C high gets `-2.0`, a humidity that reads 5 % low gets `5.0`. Save, install, and the corrected values flow to Home Assistant. -#### Adjustable offsets from Home Assistant +### Adjustable offsets from Home Assistant Apollo's [AIR-1](/products/air1/introduction.md) exposes its offsets as number entities instead, so you can dial them in from the device page in Home Assistant without reflashing. The same trick works on the starter kit. (1) { .annotate } diff --git a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md index cea209b7e7..9165b21fdb 100755 --- a/docs/products/ESPHome-Starter-Kit/setup/first-steps.md +++ b/docs/products/ESPHome-Starter-Kit/setup/first-steps.md @@ -24,7 +24,7 @@ By the end you'll have your ESPHome Starter Kit flashed with a working configura --- -### ESPHome Device Builder +## ESPHome Device Builder ESPHome Device Builder is the app that gives you a user interface for writing, compiling, and flashing ESPHome YAML configurations. You'll use it to build the software for your kit. (1) { .annotate } @@ -143,7 +143,7 @@ Pick the platform you'll be running ESPHome Device Builder on: ![ESPHome Device Builder setup wizard: picking Installation, then New to ESPHome, then Start guided tour](../../../assets/device-builder-first-time-install-pick-your-experience.gif) -#### Add a new device +### Add a new device With the app installed, it's time to tell it about your kit. If you took the guided tour, these next steps will look familiar. @@ -161,7 +161,7 @@ With the app installed, it's time to tell it about your kit. If you took the gui ![Selecting the ESPHome Starter Kit board, naming the device, and entering Wi-Fi details](../../../assets/device-builder-select-kit-name-kit-add-wifi.gif) -### Configure Components +## Configure Components !!! tip "We're now ready to add your first component and turn your project into a smart device!" @@ -169,7 +169,7 @@ With the app installed, it's time to tell it about your kit. If you took the gui When you create a new ESPHome Starter Kit project in ESPHome Device Builder, the **Web Server** and **Accessory Power Rail** components are already configured for you, so there's nothing extra to do for those. In this tutorial we'll add one more component: the **Onboard RGB LED**. -#### Onboard RGB LED +### Onboard RGB LED The Onboard RGB LED is a small LED above the Reset button of your ESP32-C6. Useful for testing automations and doubles as a status light. @@ -179,7 +179,7 @@ The Onboard RGB LED is a small LED above the Reset button of your ESP32-C6. Usef ![ESPHome Device Builder Add component dialog adding the Onboard RGB LED with default settings](../../../assets/device-builder-add-onboard-rgb-led-component.gif) -### Boot Mode +## Boot Mode The device is required to be flashed via USB using the bootloader mode the very first time it is used. Once you flash it once, you do not have to do these steps again. @@ -197,7 +197,7 @@ The device is required to be flashed via USB using the bootloader mode the very 3\. Your device is now in boot mode - The ESP32-C6 will now stay in bootloader mode until you flash it. -### Installing Software +## Installing Software Before we continue, confirm that you installed the ESPHome Device Builder, configured your components, and put your device in boot mode. @@ -216,7 +216,7 @@ Before we continue, confirm that you installed the ESPHome Device Builder, confi ESPHome logo Learn about Core Components -### Test your LED +## Test your LED Your kit's default project includes the [**Web Server**](../learning-the-basics/core-components.md#web-server) component, which lets you navigate to the IP address of your device or the hostname.local such as http://esphome-starter-kit.local/ diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md b/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md index 7ab6d10ac6..e2221d4d0b 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/connect-to-home-assistant.md @@ -33,13 +33,13 @@ Toggle the **Onboard RGB LED** light entity and confirm the LED responds on the ## Troubleshooting -#### The device never appears under Discovered +### The device never appears under Discovered * Confirm Home Assistant is on the same Wi-Fi network as the device. * Some routers and VLAN setups block mDNS broadcasts across subnets. If you run UniFi, turning on mDNS in your network settings usually fixes this. See the [UniFi mDNS guide](../../general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md). Otherwise, add the integration manually using the device's IP address. Look the IP up on your router's client list or in the **Device Information** section of the ESPHome Device Builder info panel. * The device's web page should still load at the hostname or IP. If it does not, the device is not reachable from your computer yet and Home Assistant will not find it either. -#### The encryption key is rejected +### The encryption key is rejected Open `secrets.yaml` in Device Builder, copy the `api_encryption_key` value, and paste it back into the Home Assistant prompt. If the value in Device Builder has changed since you last flashed, install the software again so the device knows the new key. (1) { .annotate } diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md b/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md index 01639ca630..fe0b5fab71 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/remote-build-server.md @@ -38,14 +38,14 @@ Start on your Windows PC. This is the machine that will do the compiling. Pairing goes in one direction: the sending dashboard asks, your PC accepts. Both machines show the same row of emoji partway through, and comparing them by eye is what proves you're pairing with your own PC. -#### Open the Pairing Window on Your PC +### Open the Pairing Window on Your PC On your Windows PC, open **Settings → Pairing requests**. It shows **Open** with a countdown beside it. (1) { .annotate } 1. Requests only arrive while that countdown is running. Click **Extend** if it runs out before you've finished. -#### Send the Request From the Other Dashboard +### Send the Request From the Other Dashboard 1. Go to **Settings → Send builds**. Your PC appears under **Known dashboards** with its address and ESPHome version. Click **Pair**. @@ -58,7 +58,7 @@ On your Windows PC, open **Settings → Pairing requests**. It shows **Open** wi ![ESPHome Device Builder Send builds: clicking Pair, sending the pair request, and seeing the emoji fingerprint](../../../assets/esphome-device-builder-initiate-build-server-pairing.gif) -#### Accept It on Your PC +### Accept It on Your PC 1. The request shows up under **Pairing requests** with the sender's name and **From IP**. Click **Review**. @@ -77,7 +77,7 @@ Back on the sending dashboard, your PC now sits under **Paired build servers** m The line underneath tells you which ESPHome version the build server runs, and which one your builds will use. The two don't have to match. Device Builder installs whatever your sending dashboard is on and builds with that. -#### If Your PC Isn't Listed +### If Your PC Isn't Listed Device Builder finds other dashboards over mDNS, which doesn't cross subnets or VLANs and which some networks block outright. Enter the address yourself instead. @@ -103,7 +103,7 @@ Plugging a device in over USB still works. Your PC compiles and sends the firmwa To stop using the build server, turn off the toggle on its row under **Paired build servers**. Builds go back to compiling locally, and the pairing stays in place for when you want it again. -#### Keeping It Working +### Keeping It Working * Your PC has to be awake and running Device Builder. If it's asleep, builds queue until it comes back. * The two machines don't need the same ESPHome version. If you'd rather they matched, **Settings → Send builds** has a version-match setting to enforce it. diff --git a/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md b/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md index 8b86f60707..cdc69748e1 100644 --- a/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md +++ b/docs/products/ESPHome-Starter-Kit/tutorials/using-secrets.md @@ -14,7 +14,7 @@ When you set up your kit in [First Steps](../setup/first-steps.md), the Device B --- -### Open Secrets +## Open Secrets
@@ -28,7 +28,7 @@ In the ESPHome Device Builder dashboard, click the 3 dots menu in the top right --- -### Syntax +## Syntax Each entry is a `key: "value"` pair: @@ -50,7 +50,7 @@ When the device compiles, ESPHome substitutes the value from secrets.yaml in pla --- -### Make a Secret in the GUI +## Make a Secret in the GUI
@@ -70,11 +70,11 @@ The Device Builder moves the key into secrets.yaml and swaps the device YAML ove --- -### What to store +## What to store Each section below shows the line you add to secrets.yaml and the line in your device YAML that references it. -#### Wi-Fi credentials +### Wi-Fi credentials You set these up in [First Steps](../setup/first-steps.md). They're the baseline every device needs. @@ -93,7 +93,7 @@ wifi: password: !secret wifi_password ``` -#### Fallback hotspot password +### Fallback hotspot password If you want the device's fallback hotspot to require a password instead of being open, store that here too. @@ -114,7 +114,7 @@ wifi: password: !secret ap_password ``` -#### Home Assistant API encryption key +### Home Assistant API encryption key ESPHome encrypts the connection between your device and Home Assistant. The key is a 32-byte base64 string, and the Device Builder generates one for every new device. The easiest way to make it a secret is the **Use secret** button covered in [Make a Secret in the GUI](#make-a-secret-in-the-gui) above, which names the entry after your device. If you'd rather add it by hand, it looks like this: @@ -136,7 +136,7 @@ api: Using the same `api_encryption_key` for every Apollo device on your network is fine and keeps your secrets file short. Home Assistant prompts for the key the first time it discovers a device, then remembers it. -#### OTA password +### OTA password OTA (over-the-air) updates let you re-flash a device wirelessly after the first USB flash. The password protects that endpoint so a stranger on your network can't push software to your device. (1) { .annotate } @@ -157,7 +157,7 @@ ota: password: !secret ota_password ``` -#### Web server username and password +### Web server username and password If you enable the optional `web_server:` component to access your device at `http://device-name.local/`, you can require a login. @@ -178,7 +178,7 @@ web_server: password: !secret web_server_password ``` -#### MQTT broker, username, and password +### MQTT broker, username, and password If you publish to an MQTT broker instead of (or in addition to) the Home Assistant API, all three of these belong in secrets.yaml. @@ -201,7 +201,7 @@ mqtt: --- -### Complete Example +## Complete Example Putting it all together, a fully loaded secrets.yaml looks like this: @@ -231,7 +231,7 @@ You don't have to include every entry. If a device doesn't use MQTT, leave those --- -#### Good practice +### Good practice !!! info "Treat secrets.yaml like a password manager" diff --git a/docs/products/air1/additional-info/air-quality-sensor-comparison.md b/docs/products/air1/additional-info/air-quality-sensor-comparison.md index bc6368f455..1f2a6fe27d 100755 --- a/docs/products/air1/additional-info/air-quality-sensor-comparison.md +++ b/docs/products/air1/additional-info/air-quality-sensor-comparison.md @@ -5,4 +5,4 @@ description: A technical comparison of air quality sensors used with the AIR-1, # Air Quality Sensor Comparison -#### [Air Quality Sensor Comparison](https://apolloautomation-my.sharepoint.com/:x:/p/trevor/Ea1--coB6rNKvRX07CGsVHEBUF-zUPuyyFvRED-WdjCC_Q?e=NFjC1Y) \ No newline at end of file +## [Air Quality Sensor Comparison](https://apolloautomation-my.sharepoint.com/:x:/p/trevor/Ea1--coB6rNKvRX07CGsVHEBUF-zUPuyyFvRED-WdjCC_Q?e=NFjC1Y) \ No newline at end of file diff --git a/docs/products/air1/air1-reviews.md b/docs/products/air1/air1-reviews.md index 0706c6b187..bbd046c453 100755 --- a/docs/products/air1/air1-reviews.md +++ b/docs/products/air1/air1-reviews.md @@ -5,14 +5,14 @@ description: YouTuber reviews and feedback about the AIR-1 sensor from Apollo Au # [The Bearded Tech Guy AIR-1 Review](https://youtu.be/k0SDJ6_SBqk?si=3uLfXC3GUDaYJNEs) -# [Smart Home Scene AIR-1 Review](https://smarthomescene.com/reviews/apollo-air-1-review-complete-air-quality-monitoring-for-home-assistant/) +## [Smart Home Scene AIR-1 Review](https://smarthomescene.com/reviews/apollo-air-1-review-complete-air-quality-monitoring-for-home-assistant/) -# [Simon Says Home Assistant AIR-1 Review](https://youtu.be/WCaYAvYPgqc?si=Uo4qQtRia7ZoaBYc) +## [Simon Says Home Assistant AIR-1 Review](https://youtu.be/WCaYAvYPgqc?si=Uo4qQtRia7ZoaBYc) -# [BeardedTinker AIR-1 Review](https://youtu.be/3JjV3oo3FMU?si=RZueY1j6gHUSi8OC) +## [BeardedTinker AIR-1 Review](https://youtu.be/3JjV3oo3FMU?si=RZueY1j6gHUSi8OC) -# [Hands On Katie AIR-1 Review](https://www.youtube.com/watch?v=dQhwOuFlFWo) +## [Hands On Katie AIR-1 Review](https://www.youtube.com/watch?v=dQhwOuFlFWo) -# [MostlyChris AIR-1 Review](https://youtu.be/1-lTbOyfvVI?si=NfIgSMSN-f6aNeah) +## [MostlyChris AIR-1 Review](https://youtu.be/1-lTbOyfvVI?si=NfIgSMSN-f6aNeah) -# [Michael Leen AIR-1 Review](https://youtu.be/zdvcg1i6fGU?si=4wqaDjEBiA5qfH8q) \ No newline at end of file +## [Michael Leen AIR-1 Review](https://youtu.be/zdvcg1i6fGU?si=4wqaDjEBiA5qfH8q) \ No newline at end of file diff --git a/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md b/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md index e8e5ff2154..972245db89 100755 --- a/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md +++ b/docs/products/air1/calibrating-and-updating/air-1-temp-calibration.md @@ -1,9 +1,10 @@ --- +title: AIR-1 Temperature Calibration description: "Calibrate the AIR-1 temperature reading from its SEN55 to your room using a temperature offset in Home Assistant." --- # AIR-1 Temperature Calibration -##### The AIR-1 uses the SEN55 for its temperature reading. Calibrating it to your environment is very similar to the MSR-1. See the link below for the temperature calibration guide. +## The AIR-1 uses the SEN55 for its temperature reading. Calibrating it to your environment is very similar to the MSR-1. See the link below for the temperature calibration guide. ![AIR-1 device page in Home Assistant with the SEN55 temperature offset set to 5.0 °C and circled](/assets/air-1-temperature-offset.png) diff --git a/docs/products/air1/examples/air1-dashboard-examples.md b/docs/products/air1/examples/air1-dashboard-examples.md index 985578172b..3e24b92fae 100755 --- a/docs/products/air1/examples/air1-dashboard-examples.md +++ b/docs/products/air1/examples/air1-dashboard-examples.md @@ -10,9 +10,9 @@ Really neat dashboard for your AIR-1 by user "keex"! [https://community.home-assistant.io/t/apollo-air-1-dashboard/785311](https://community.home-assistant.io/t/apollo-air-1-dashboard/785311) -#### **CO2 Charts** +## **CO2 Charts** -##### Home Assistant Sensor +### Home Assistant Sensor ![Home Assistant sensor card showing a 24-hour Bedroom CO2 line graph at 1,000 ppm](/assets/co-2-graph.png) @@ -25,7 +25,7 @@ name: Bedroom CO2 hours_to_show: 24 ``` -#### Custom: Apexcharts Card +## Custom: Apexcharts Card ![ApexCharts card showing 10-minute average CO2 levels for five rooms in Home Assistant](/assets/air-1-suggestions-co2-smarthomesellout.png) @@ -157,7 +157,7 @@ series: value: 0 ``` -##### Custom: Plotly Graph Card +### Custom: Plotly Graph Card ![Plotly Graph card showing 24 hours of Bedroom CO2 readings in ppm](/assets/plotly-co2-graph.png) @@ -170,7 +170,7 @@ refresh_interval: 10 title: Bedroom CO2 ``` -##### Home Assistant Gauge +### Home Assistant Gauge ![Home Assistant needle gauge card showing MSR-1 CO2 at 1,063 ppm with green, yellow, and red ranges](/assets/co2-guage.png) @@ -187,9 +187,9 @@ severity: red: 2000 ``` -#### **VOC Charts** +## **VOC Charts** -##### Home Assistant Sensor +### Home Assistant Sensor ![Home Assistant sensor card showing an AIR-1 SEN55 VOC line graph at 446](/assets/air-1-voc-ha-sensor.png) @@ -202,7 +202,7 @@ hours_to_show: 24 name: Basement VOC ``` -##### Custom: Plotly Graph Card +### Custom: Plotly Graph Card ![Plotly Graph card showing 24 hours of Basement VOC readings from the AIR-1](/assets/air-1-voc-plotly.png) @@ -215,7 +215,7 @@ refresh_interval: 10 title: Basement VOC ``` -##### Home Assistant Gauge +### Home Assistant Gauge ![Home Assistant needle gauge card showing a Basement VOC reading of 457](/assets/air-1-voc-ha-guage.png) diff --git a/docs/products/air1/setup/general-tips.md b/docs/products/air1/setup/general-tips.md index 9e883b4332..ec1609069f 100755 --- a/docs/products/air1/setup/general-tips.md +++ b/docs/products/air1/setup/general-tips.md @@ -8,11 +8,11 @@ description: >- The AIR-1 has multiple different types of sensors and this guide will help you understand which ones you should be concerned with and expected safe or not safe thresholds to alert or automate on. -###### SEN55 Environmental Sensor +## SEN55 Environmental Sensor The SEN55 is the powerhouse of the AIR-1 with multiple sensors such as particulate matter, volatile organic compounds (VOCs), oxidizing gases, such as nitrogen oxides (NOx), as well as humidity & temperature. -###### Particulate Matter +## Particulate Matter Per the EPA: particulate matter (also called particle pollution): the term for a mixture of solid particles and liquid droplets found in the air. Some particles, such as dust, dirt, soot, or smoke, are large or dark enough to be seen with the naked eye. Others are so small they can only be detected using an electron microscope. Sources of pm particles here. @@ -26,11 +26,11 @@ The SEN55 is the powerhouse of the AIR-1 with multiple sensors such as particula This article goes over lots of ways to reduce pm particles in your home! -###### Safe PM Levels +## Safe PM Levels Particulate Matter (PM) refers to a mixture of solid particles and liquid droplets found in the air. These are often classified by size, as smaller particles pose greater risks to health due to their ability to penetrate deeper into the lungs. -###### What Do PM1, PM2.5, PM4, and PM10 Mean? +## What Do PM1, PM2.5, PM4, and PM10 Mean?

PM Type

Size (µm)

Description

PM1

≤ 1.0

Ultrafine particles that can reach deep into the lungs and bloodstream.

PM2.5

≤ 2.5

Fine particles; linked to respiratory and cardiovascular issues.

PM4

≤ 4.0

Less commonly regulated; typically used in industrial settings.

PM10

≤ 10

Inhalable particles; may irritate eyes, nose, and throat.

@@ -40,7 +40,7 @@ Particulate Matter (PM) refers to a mixture of solid particles and liquid drople --- -###### Recommended Safe Exposure Limits +## Recommended Safe Exposure Limits The **World Health Organization (WHO)** provides the following exposure limits for particulate matter: @@ -48,7 +48,7 @@ The **World Health Organization (WHO)** defines safety thresholds for PM2.5 based on a 24-hour average: @@ -56,7 +56,7 @@ The **U.S. Environmental Protection Agency (EPA)**NowCast AQI takes your PM2.5 and PM10 readings and converts them into a single 0–500 number using the EPA's formula. That number maps directly to the AQI categories in the table above: bigger = worse. @@ -68,7 +68,7 @@ The AIR-1 calculates this automatically and exposes it as a sensor in Home Assis --- -###### Indoor Air Quality Notes +## Indoor Air Quality Notes * **PM1** and **PM2.5** are especially important for indoor air monitoring since these smaller particles are more likely to come from cooking, candles, smoking, or inadequate ventilation. * Use an **air purifier with a HEPA filter** to reduce PM1–PM2.5 concentrations indoors. @@ -80,7 +80,7 @@ The AIR-1 calculates this automatically and exposes it as a sensor in Home Assis --- -###### VOC Index +## VOC Index Per Sensirion, @@ -102,7 +102,7 @@ Per Sensirion, > > that there are fewer VOCs compared to the average -###### VOC Quality +## VOC Quality This uses the VOC index and a scale to output an easier to use variable. @@ -112,7 +112,7 @@ This uses the NOX Index +## NOX Index Per Sensirion, @@ -142,7 +142,7 @@ Per Sensirion, --- -##### SCD40 CO2 sensor +## SCD40 CO2 sensor The optional CO2 sensor addon is a great way to add the ability to track CO2. CO2 levels in a closed, poorly ventilated bedroom can quickly rise to concentrations that may impair focus or even pose health risks. Notice the CO2 levels dropping in the image below when the HVAC was turned on overnight! @@ -164,6 +164,6 @@ The latest AIR-1 firmware keeps the SCD40 calibrated automatically. The sensor a --- -##### MiCS-4514 Gas Sensor +## MiCS-4514 Gas Sensor The MiCS-4514 is a very unique sensor able to distinguish between multiple gases such as Carbon Monoxide, Nitrogen, Ethanol, Hydrogen, Ammonia, and Methane. \ No newline at end of file diff --git a/docs/products/air1/troubleshooting/air1-boot-mode.md b/docs/products/air1/troubleshooting/air1-boot-mode.md index 9a88d2506d..b3f9ebcedb 100755 --- a/docs/products/air1/troubleshooting/air1-boot-mode.md +++ b/docs/products/air1/troubleshooting/air1-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The AIR-1 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the AIR-1 so that the USB-C port is facing you. On the left side of the USB-C port, locate a small opening to press the boot button (the right button). @@ -18,7 +18,7 @@ description: Step by step guide for putting The AIR-1 In Boot Mode. 3\. Continue with uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/products/btn1/battery-sensors/wake-up-battery-sensor.md b/docs/products/btn1/battery-sensors/wake-up-battery-sensor.md index 023266d9c9..e5adaf6759 100644 --- a/docs/products/btn1/battery-sensors/wake-up-battery-sensor.md +++ b/docs/products/btn1/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/products/btn1/examples/blueprint.md b/docs/products/btn1/examples/blueprint.md index d4c7c5c695..7017f1a799 100755 --- a/docs/products/btn1/examples/blueprint.md +++ b/docs/products/btn1/examples/blueprint.md @@ -6,7 +6,7 @@ description: >- --- # Blueprint Setup -### Automatic Import +## Automatic Import 1\. Click the Import Blueprint button below and then click **Open link**. @@ -30,7 +30,7 @@ description: >- 5\. Your blueprint is now live. Click the button 1 button and it should toggle whatever light you selected in the blueprint. This can be anything in Home Assistant such as your light, fan, scene, etc! -### Manual Import +## Manual Import 1\. Head to the automations page and click on **Blueprints** in the top right then select **Import Blueprint**. diff --git a/docs/products/btn1/setup/general-tips.md b/docs/products/btn1/setup/general-tips.md index ab45910745..71f9dac1f9 100755 --- a/docs/products/btn1/setup/general-tips.md +++ b/docs/products/btn1/setup/general-tips.md @@ -4,27 +4,27 @@ description: BTN-1 General Tips --- # General Tips -### Sticky Pads +## Sticky Pads Your BTN-1 comes with two sets of 4 sticky pads or feet to stick on the bottom of the BTN-1 itself or on the optional BTN-1 Mount addon. These are great for just setting the device on your desk! ![Peeling clear sticky pads and pressing them onto the four corners of the BTN-1 bottom](/assets/btn-1-general-tips-sticky-pads.webp) -### Mounting +## Mounting The BTN-1 with the stand addon allows you to mount the device using M3 screws to attach using one of three mounting scenarios as shown below. It also allows for magnetic mounting from one orientation! -###### **Under Desk** +### **Under Desk** ![BTN-1 in its mount attached to the underside of a desk](/assets/btn-1-general-tips-under-desk-mount.jpg) -###### Desk Mount +### Desk Mount I used a block of wood instead of mounting it directly to my desk in this example. ![BTN-1 sliding into its mount screwed to a wooden block on a desk](/assets/btn-1-general-tips-desk-mount.webp) -###### **Magnetic Mounting** +### **Magnetic Mounting** ![Placing the BTN-1 against a metal surface, where it holds in place magnetically](/assets/btn-1-general-tips-magnetic-mounting.webp) diff --git a/docs/products/btn1/setup/getting-started.md b/docs/products/btn1/setup/getting-started.md index ed13a00dbb..07947a9514 100755 --- a/docs/products/btn1/setup/getting-started.md +++ b/docs/products/btn1/setup/getting-started.md @@ -6,27 +6,27 @@ description: Step by step guide to getting started with your BTN-1! This will guide you through adding on switches and keycaps to your BTN-1 then adding it to your Wi-Fi and Home Assistant! -### Physical Setup +## Physical Setup -###### Installing Brown Switches +### Installing Brown Switches Line up the two gold pins with the holes on your BTN-1, then press down gently. Be careful, as the pins can bend or get damaged if too much force is used. ![Pressing brown switches into the four sockets on the BTN-1 circuit board](/assets/btn-1-install-switches-gif.webp) -###### Installing Keycaps +### Installing Keycaps Line up the + on the keycap with the + on the top of the switch you installed. It may require a little pressure, but it should press on smoothly. Once placed, lightly tap to ensure the keycap is fully seated. ![Pressing white keycaps onto the four switches of the BTN-1](/assets/btn-1-getting-started-installing-keycaps-gif.webp) -###### Flip Power Switch +### Flip Power Switch Only the battery version has a power switch. If yours has one, ensure it's **turned on**. With the device on its side, flipping the switch **away from you** turns it **on**, and flipping it **toward you** turns it **off**. ![Sliding the BTN-1 power switch on the side of the case to the on position](/assets/btn-1-flip-power-switch-on.webp) -### Connecting Through Hotspot +## Connecting Through Hotspot To connect through the sensor's onboard hotspot follow the below: @@ -56,7 +56,7 @@ To connect through the sensor's onboard hotspot follow the below: [Click here for next steps!](https://wiki.apolloautomation.com/products/btn1/setup/getting-started/#connecting-to-home-assistant-via-esphome-integration){ .md-button .md-button--primary } -### Connecting with Improv via BLE +## Connecting with Improv via BLE !!! note "Pre-requirement: Bluetooth proxy or Bluetooth Home Assistant hardware required" @@ -76,7 +76,7 @@ To connect through the sensor's onboard hotspot follow the below: 4\. Your device is now added to your Wi-Fi and added to the ESPHome Integration in Home Assistant. You should now be ready to set up a blueprint and start using your BTN-1! -### Connecting To ESPHome Device Builder +## Connecting To ESPHome Device Builder !!! tip "Skip the ESPHome Device Builder unless..." @@ -108,7 +108,7 @@ wifi_password: "your-wifi-pass-here" 4\. Your new device is now adopted into the ESPHome Device Builder and you can move on to Integrating with Home Assistant via the ESPHome Integration below! -### Connecting to Home Assistant via ESPHome Integration: +## Connecting to Home Assistant via ESPHome Integration: 1\. Head to the ESPHome Integration then click on **Add** then click **Submit**. When prompted click **Finish** then give it a location and click **Finish** or click **Skip and Finish**. diff --git a/docs/products/btn1/troubleshooting/btn1-boot-mode.md b/docs/products/btn1/troubleshooting/btn1-boot-mode.md index 58b2cd2f6b..5c55f22aac 100755 --- a/docs/products/btn1/troubleshooting/btn1-boot-mode.md +++ b/docs/products/btn1/troubleshooting/btn1-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The BTN-1 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only !!! success "If you have the battery model skip to Method 2!" @@ -24,7 +24,7 @@ description: Step by step guide for putting The BTN-1 In Boot Mode. [Click here to go to the reflashing guide!](https://wiki.apolloautomation.com/products/btn1/troubleshooting/btn1-reflash/){ .md-button .md-button--primary } -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Plug in a USB cable that supports power and data into your computer and connect the other end to your BTN-1. diff --git a/docs/products/btn1/troubleshooting/btn1-teardown.md b/docs/products/btn1/troubleshooting/btn1-teardown.md index 8004125a26..6748548f43 100755 --- a/docs/products/btn1/troubleshooting/btn1-teardown.md +++ b/docs/products/btn1/troubleshooting/btn1-teardown.md @@ -6,7 +6,7 @@ description: >- --- # Teardown and Reassembly Of BTN-1 -###### Disassembly +## Disassembly !!! warning "If you have a BTN-1 with a battery you should flip the power switch to off" @@ -28,7 +28,7 @@ description: >- ![Unplugging the 2-pin JST battery connector from the BTN-1 circuit board](/assets/btn-1-unplug-jst.webp) -###### Reassembly +## Reassembly 1\. Re-attach the 2-pin JST connector and place the battery writing side down with the wires on the left side of the case. diff --git a/docs/products/cast1/additional-info/esphome-device-builder.md b/docs/products/cast1/additional-info/esphome-device-builder.md index a131cdf517..6609318d6e 100644 --- a/docs/products/cast1/additional-info/esphome-device-builder.md +++ b/docs/products/cast1/additional-info/esphome-device-builder.md @@ -10,7 +10,7 @@ description: Optional. Use ESPHome Device Builder to rename your CAST-1 or edit ESPHome Device Builder is the software that gives you a user interface for editing, compiling, and flashing ESPHome YAML. You'll use it to take control of your CAST-1 and edit its configuration. -### Install ESPHome Device Builder +## Install ESPHome Device Builder Pick the platform you'll be running ESPHome Device Builder on: @@ -114,7 +114,7 @@ Pick the platform you'll be running ESPHome Device Builder on: ![ESPHome Device Builder first-run wizard, choosing local installation and New to ESPHome](/assets/device-builder-first-time-install-pick-your-experience.gif) -### Take Control of Your CAST-1 +## Take Control of Your CAST-1 1\. Open the ESPHome Device Builder. diff --git a/docs/products/cast1/examples/tts-announcements.md b/docs/products/cast1/examples/tts-announcements.md index d55564f045..eb2a35b6ba 100644 --- a/docs/products/cast1/examples/tts-announcements.md +++ b/docs/products/cast1/examples/tts-announcements.md @@ -8,14 +8,14 @@ Your CAST-1 can speak. Send it a text-to-speech message and it plays over whatev You'll need a text-to-speech engine set up in Home Assistant first. The examples below use Piper, which runs locally and sounds good, but any engine works since the CAST-1 just plays what Home Assistant sends it. -### Which Player to Use +## Which Player to Use Your CAST-1 has two media players and either one handles announcements. * **Apollo CAST-1 Player** is the ESPHome media player with the announcement pipeline. * **Apollo CAST-1 Sendspin Player** is the Music Assistant streaming target. Announcements sent here get forwarded to the announcement pipeline, so your music still ducks. -### Send an Announcement +## Send an Announcement 1\. Open **Developer Tools** in Home Assistant and go to the **Actions** tab. @@ -35,13 +35,13 @@ data: 3\. Run it with music playing and you'll hear the music drop, the message play, then the music come back. -### What Happens During an Announcement +## What Happens During an Announcement The CAST-1 ducks the music by 40 dB the instant an announcement starts, so speech stays clear without the music stopping. The onboard LEDs turn cyan while it's talking. When the message finishes, the music fades back over a second and the LEDs go out. That LED change is a handy way to tell an announcement from a glitch when you're across the room. -### Announce a Sound Instead of Speech +## Announce a Sound Instead of Speech Anything you can play can be an announcement, not just speech. A doorbell chime works the same way, ducking the music and lighting the LEDs: @@ -57,7 +57,7 @@ data: The `announce: true` is what routes it to the announcement pipeline. Leave it out and the sound replaces your music instead of playing over it. -### Use It in an Automation +## Use It in an Automation ??? example "Announce when the washing machine finishes" diff --git a/docs/products/cast1/examples/wizmote-blueprint.md b/docs/products/cast1/examples/wizmote-blueprint.md index 7982ad3a08..5bc69a4173 100644 --- a/docs/products/cast1/examples/wizmote-blueprint.md +++ b/docs/products/cast1/examples/wizmote-blueprint.md @@ -22,7 +22,7 @@ Every button ships with a sensible default, so your WizMote works the moment you Each dropdown offers the same choices: Nothing, Play, Pause, Play / Pause, Next Track, Previous Track, Volume Up, Volume Down, Toggle Light, or Send HA Event. -### Pair Your WizMote +## Pair Your WizMote Before the blueprint can control anything, pair your WizMote with the CAST-1. @@ -43,7 +43,7 @@ Before the blueprint can control anything, pair your WizMote with the CAST-1. A CAST-1 that's on Ethernet and not joined to any Wi-Fi network has no channel to follow, so it hops through radio channels 1 through 13 hunting for the WizMote, moving on every couple of seconds until it hears one. Keep pressing a button and it should pair within a minute. -### Import the Blueprint +## Import the Blueprint 1\. Click the Import Blueprint button below then click **Open link**. diff --git a/docs/products/cast1/setup/getting-started.md b/docs/products/cast1/setup/getting-started.md index b889868054..db4151771b 100644 --- a/docs/products/cast1/setup/getting-started.md +++ b/docs/products/cast1/setup/getting-started.md @@ -6,7 +6,7 @@ description: Step by step guide to getting started with your CAST-1! This will guide you through connecting your CAST-1 to your speakers, adding it to your Wi-Fi and Home Assistant, and streaming to it with Music Assistant. -### Physical Setup +## Physical Setup Run a 3.5mm cable from the CAST-1 into the line-in on your powered speakers, receiver, or active soundbar, then plug the CAST-1 into power with USB-C. A 5V 1A power supply is plenty. (1) { .annotate } @@ -15,7 +15,7 @@ Run a 3.5mm cable from the CAST-1 into the line-in on your powered speakers, rec ![Plugging a 3.5mm audio cable and a USB-C power cable into the CAST-1](/assets/cast-1-physical-setup.webp) -### Connect to Your Network +## Connect to Your Network There are three ways to get your CAST-1 online. Pick whichever is easier, you only need to do one. @@ -74,7 +74,7 @@ There are three ways to get your CAST-1 online. Pick whichever is easier, you on 3\. Home Assistant discovers your CAST-1 automatically. Add it below, then check the **Network Connection** sensor on the device page to confirm it reads **Ethernet**. -### Add to Home Assistant +## Add to Home Assistant Open the ESPHome Integration, then click **Add** and **Submit**. Edit the name and choose an **Area** then click **Finish**. @@ -82,11 +82,11 @@ Open the ESPHome Integration, then click **Add** and **Submit**. Edit the name a ![Adding the discovered CAST-1 in the ESPHome integration, naming it, and choosing an area](/assets/cast-1-home-assistant-integration.gif) -### Music Assistant +## Music Assistant The CAST-1 streams through Music Assistant. Once Music Assistant is running, your CAST-1 shows up as a player automatically, no extra configuration needed. -###### Install Music Assistant +### Install Music Assistant 1\. Head to the App Store to install Music Assistant. @@ -100,7 +100,7 @@ The CAST-1 streams through Open your Home Assistant instance and show your integrations. -###### Stream To Your CAST-1 +### Stream To Your CAST-1 1\. Open **Music Assistant** from the Home Assistant sidebar. @@ -110,7 +110,7 @@ The CAST-1 streams through Discord for some help. -### Connecting Through Hotspot +## Connecting Through Hotspot To connect through the sensor's onboard hotspot follow the below: @@ -32,7 +32,7 @@ If this does not automatically open the dashboard, please open your web browser [Click here for next steps!](https://wiki.apolloautomation.com/products/general/setup/getting-started/#connecting-to-home-assistant-via-esphome-integration){ .md-button .md-button--primary } -### Connecting with Improv via BLE +## Connecting with Improv via BLE !!! note "Pre-requirement:" @@ -62,7 +62,7 @@ If this does not automatically open the dashboard, please open your web browser ![Home Assistant Success dialog showing the new PLT-1B and an Area field](/assets/improv-ble-pic-6.png) -### Connecting To ESPHome Device Builder +## Connecting To ESPHome Device Builder !!! tip "Skip the ESPHome Device Builder unless..." @@ -102,7 +102,7 @@ wifi_password: "your-wifi-pass-here" 6\. Your new device is now adopted into the ESPHome Device Builder and you can move on to Integrating with Home Assistant via the ESPHome Integration below! -### Connecting to Home Assistant via ESPHome Integration: +## Connecting to Home Assistant via ESPHome Integration: 1\. Click the "**Notifications**" Icon in the bottom left. diff --git a/docs/products/general/setup/renaming-apollo-devices.md b/docs/products/general/setup/renaming-apollo-devices.md index 7f2af0e246..23e56c22c2 100755 --- a/docs/products/general/setup/renaming-apollo-devices.md +++ b/docs/products/general/setup/renaming-apollo-devices.md @@ -4,7 +4,7 @@ description: Tutorial for How To Rename Apollo Devices in the ESPHome integratio --- # Renaming Apollo Devices -##### ESPHome Integration - Part 1 +## ESPHome Integration - Part 1 1\. Click the button below to open the ESPHome Integrations page. @@ -26,7 +26,7 @@ description: Tutorial for How To Rename Apollo Devices in the ESPHome integratio ![Opening each disabled Diagnostic entity on the BTN-1 device page and editing its entity ID](/assets/esphome-integration-manually-rename-disabled-entities-gif.gif) -##### ESPHome Integration - Part 2 +## ESPHome Integration - Part 2 This section only changes the device name shown in the ESPHome integration page. It is safe to skip, but we recommend doing it to keep naming consistent. @@ -42,7 +42,7 @@ This section only changes the device name shown in the ESPHome integration page. The next section is for ESPHome device builder which is for tinkerers and advanced users to take control of their device and edit the yaml. Please skip the next section if you do not use ESPHome Device Builder! -##### ESPHome Device Builder +## ESPHome Device Builder 1\. Make sure you are already using the ESPHome Device Builder app as gone over in the getting started wiki articles. diff --git a/docs/products/general/temp-hum-calibration.md b/docs/products/general/temp-hum-calibration.md index ce977fcc45..bc2979a685 100755 --- a/docs/products/general/temp-hum-calibration.md +++ b/docs/products/general/temp-hum-calibration.md @@ -4,7 +4,7 @@ description: Temp and Humidity Calibration and Offset Examples. --- # Simple and Advanced Examples of Temperature & Humidity Offsets -### **Simple Offsets for Temperature and Humidity:** +## **Simple Offsets for Temperature and Humidity:** **Please add these to the bottom of your ESPHome yaml for your device then click save and install. Once you are finished, you will have two new boxes inside the Home Assistant ESPHome integration device page for your device where you can fill in an offset. Give them up to 1 minute to take effect!** @@ -49,11 +49,11 @@ number: mode: box ``` -### **BME280 & SCD40 Sensors: Overcoming Temperature & Humidity Reading Challenges** +## **BME280 & SCD40 Sensors: Overcoming Temperature & Humidity Reading Challenges** The BME280 and SCD40 sensors are known for their precision in measuring temperature and humidity. However, like all sensor systems, they can sometimes provide inaccurate readings due to various factors. In the case of the BME280 and SCD40 sensors, one significant challenge arises from the heat produced by the ESP chip, which can alter the environment inside its enclosure, thereby skewing the readings. -### **Adjusting the BME280 and SCD40 Temperature Offset** +## **Adjusting the BME280 and SCD40 Temperature Offset** For users who want to fine-tune their sensors, the BME280 and SCD40 Temperature Offset entities can be manually adjusted to match the conditions in their home. The offset values are subtracted from the raw temperature & humidity readings in the firmware to update the sensor readings in the Home Assistant entity. For example: scd40\_temperature entity = raw scd40 temperature reading - scd40\_offset. @@ -61,7 +61,7 @@ By default, these offsets are preset to values based on our NIST certified therm Users will also notice the `bme280_humidity_calibrated`, `scd40_humidity_calibrated`, `bme280_temperature_calibrated`, and `scd40_temperature_calibrated` entities. These values utilize the linear filter in the ESPHome firmware to adjust the readings based on our collected data. Again, due to environmental differences, these might not always be precise. -### **Modeling the Relationship Between Sensors** +## **Modeling the Relationship Between Sensors** Another approach to getting accurate readings is to model the relationship between the ESP temperature and the other sensors compared against a reference temperature. This can be achieved by creating a template sensor in Home Assistant that employs a decision tree or our regression coefficients. @@ -134,10 +134,10 @@ notify: ``` -### **The Interrelation of Temperature and Humidity** +## **The Interrelation of Temperature and Humidity** It's important to understand that temperature and humidity share an interdependent relationship. When the air temperature rises, its capacity to hold moisture increases, which can decrease relative humidity levels. Conversely, when the temperature falls, the air's capacity to hold moisture decreases, leading to increased humidity. This relationship plays a significant role in how sensors detect and interpret readings, making it even more crucial to ensure accuracy. -### **Advanced Accuracy with GPIO** +## **Advanced Accuracy with GPIO** For those seeking the highest accuracy, an advanced solution is available. The exposed mezzanine connector on the back of our Apollo boards can be utilized to connect a temperature/humidity sensor. This modification can dramatically improve both temperature and humidity readings, providing data that's as accurate as possible. \ No newline at end of file diff --git a/docs/products/general/troubleshooting/removing-device-from-home-assistant.md b/docs/products/general/troubleshooting/removing-device-from-home-assistant.md index 49c6af74c0..f95551958a 100755 --- a/docs/products/general/troubleshooting/removing-device-from-home-assistant.md +++ b/docs/products/general/troubleshooting/removing-device-from-home-assistant.md @@ -4,7 +4,7 @@ description: Tutorial for Removing Device From Home Assistant. --- # Removing Device From Home Assistant -##### ESPHome app +## ESPHome app This will cover how to remove an Apollo device from Home Assistant @@ -20,7 +20,7 @@ This will cover how to remove an Apollo device from Home Assistant ![Deleting an H-1 in ESPHome Device Builder from the three-dot menu and confirming Delete](/assets/delete-device-from-esphome-device-builder-gif.gif) -##### ESPHome Integration +## ESPHome Integration 1\. Head to the ESPHome Integrations page. Next to the device you would like to remove, click the three dots and then "Delete". diff --git a/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md b/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md index 84275a51c7..8e0916c602 100755 --- a/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md +++ b/docs/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md @@ -8,7 +8,7 @@ description: Tutorial to help fix the Ubiquiti UniFi mDNS Auto Discover Issue. If you have different networks that Homey and ESPHome devices are on, then you will need mDNS working across both networks and firewall rules allowing access between them. Below are guides for using your PC and the UniFi iOS app to fix this issue. -##### **Method 1: Browser** +## **Method 1: Browser** 1\. Log into your UniFi network through your default IP address which is usually http://192.168.1.1 @@ -34,7 +34,7 @@ description: Tutorial to help fix the Ubiquiti UniFi mDNS Auto Discover Issue. 7\. Now the Home Assistant/ESPHome auto-discover issue should be fixed! -##### **Method 2: UniFi iOS App.** +## **Method 2: UniFi iOS App.** 1\. Open the UniFi app. diff --git a/docs/products/h1/battery-sensors/wake-up-battery-sensor.md b/docs/products/h1/battery-sensors/wake-up-battery-sensor.md index 023266d9c9..e5adaf6759 100644 --- a/docs/products/h1/battery-sensors/wake-up-battery-sensor.md +++ b/docs/products/h1/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/products/h1/reviews.md b/docs/products/h1/reviews.md index ecee5b8da8..1abea53cca 100755 --- a/docs/products/h1/reviews.md +++ b/docs/products/h1/reviews.md @@ -6,18 +6,18 @@ description: H-1 Reviews.
-#
Michael Lean +##
Michael Lean
-#
Mostly Chris +##
Mostly Chris
-#
Smart Home Sellout +##
Smart Home Sellout
-#
Smart Home Australia +##
Smart Home Australia
\ No newline at end of file diff --git a/docs/products/h2/battery-sensors/wake-up-battery-sensor.md b/docs/products/h2/battery-sensors/wake-up-battery-sensor.md index 023266d9c9..e5adaf6759 100644 --- a/docs/products/h2/battery-sensors/wake-up-battery-sensor.md +++ b/docs/products/h2/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/products/h2/examples/holiday-songs.md b/docs/products/h2/examples/holiday-songs.md index 58f9bcfd94..3c0f86774c 100644 --- a/docs/products/h2/examples/holiday-songs.md +++ b/docs/products/h2/examples/holiday-songs.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: Holiday Songs +description: List of Holiday Songs to use with the Holiday ornaments or any Apollo device with a buzzer. --- --8<-- "products/general/holiday-songs.md:7:" diff --git a/docs/products/h2/h2-reviews.md b/docs/products/h2/h2-reviews.md index 3f0e510db5..87be955321 100755 --- a/docs/products/h2/h2-reviews.md +++ b/docs/products/h2/h2-reviews.md @@ -9,18 +9,18 @@ these need to be updated
-#
Michael Lean +##
Michael Lean
-#
Mostly Chris +##
Mostly Chris
-#
Smart Home Sellout +##
Smart Home Sellout
-#
Smart Home Australia +##
Smart Home Australia
\ No newline at end of file diff --git a/docs/products/led1/setup/getting-started-led1.md b/docs/products/led1/setup/getting-started-led1.md index 1dc0ea93a7..f66166414a 100755 --- a/docs/products/led1/setup/getting-started-led1.md +++ b/docs/products/led1/setup/getting-started-led1.md @@ -6,7 +6,7 @@ description: Getting started with your new LED-1! Congrats on your new LED-1! Below we will go through steps to get you up and running in no time. -### Choose how to power it +## Choose how to power it The LED-1 can be powered via USB (5V up to 3 amps) or via USB Power Delivery (5V or 12V up to 3 amps) or a dedicated power supply using either 5V, 12V, or 24V. @@ -40,7 +40,7 @@ The LED-1 can be powered via USB (5V up to 3 amps) or via USB Power Delivery (5V Before proceeding to the next steps, make sure to unplug your device! -### Wire up LEDs +## Wire up LEDs !!! danger "Before proceeding, consider double checking your power supply and leds use the same voltage!" @@ -54,7 +54,7 @@ The LED-1 can be powered via USB (5V up to 3 amps) or via USB Power Delivery (5V 3\. Repeat step 2 for a second led strip using Output 2 if you have a second led strip! -### Connect to Wi-Fi +## Connect to Wi-Fi Your device is now ready to connect to your Wi-Fi and begin controlling via Home Assistant, the WLED app for iPhone and Android, or via a web browser! @@ -62,7 +62,7 @@ Your device is now ready to connect to your Wi-Fi and begin controlling via Home ![WLED Welcome to WLED page with WiFi Settings and To the Controls buttons](/assets/led-1-getting-started-pic-1.png) -### Join to Home Assistant +## Join to Home Assistant 1\. Your device should be auto-discovered by Home Assistant using the WLED Integration as shown below! diff --git a/docs/products/led1/setup/led1-general-tips.md b/docs/products/led1/setup/led1-general-tips.md index 27dc91a04d..2c3f4ed5e4 100755 --- a/docs/products/led1/setup/led1-general-tips.md +++ b/docs/products/led1/setup/led1-general-tips.md @@ -4,7 +4,7 @@ description: Multiple helpful tips to use your LED-1 to the fullest! --- # General Tips -##### Power Supplies +## Power Supplies Meanwell power supplies are best but most power supplies off Amazon will be sufficient. As a rule of thumb, over 80% usage on a power supply is bad. So if you want to run with 3amps, buy a 4 or 5amp power supply so that the power supply is not running at its maximum potential amperage. @@ -14,7 +14,7 @@ Most power supplies will have a barrel connector only rated for 3 amps on it, so The LED-1 will protect itself, but not the led strips connected to it. So if you connect a 24 volt power supply to the device, it will send 24v out to the LED strips. Make sure to pair your LEDs and Power supplies with the same voltage! -##### LED Strips +## LED Strips * WS2812B which are 5V RGB LED strips. * SK6812 which are 5V RGBW LED strips. @@ -24,13 +24,13 @@ Most power supplies will have a barrel connector only rated for 3 amps on it, so We suggest buying only BTF Lighting off of amazon or directly from us (we source only BTF Lighting). They also have an Aliexpress store! -##### LED Connectors +## LED Connectors JST-SM 3 pin connectors are helpful to connect multiple led strips or to solder them onto led strips to create multiple smaller sections. These have a maximum rating of 3 amps. 10mm Width Transparent Connector Kit You might want to use these 24v FCOB connectors for the WS2814 LEDs suggested above. Make sure to choose the same width of led strip + connector (10mm, 12mm, etc). -##### Additional Tools +## Additional Tools Wago Connectors are a great option for connecting wires together without soldering. diff --git a/docs/products/m1/addons/adding-microphone-to-m-1.md b/docs/products/m1/addons/adding-microphone-to-m-1.md index 825008eb90..e84bdbe8d1 100755 --- a/docs/products/m1/addons/adding-microphone-to-m-1.md +++ b/docs/products/m1/addons/adding-microphone-to-m-1.md @@ -6,7 +6,7 @@ This will guide you through installing and configuring the microphone on your M- The microphone addon fits Rev6 and newer controllers. Rev4 boards do not have the connector for it. The revision is printed on the controller board. -###### Install the Hardware +## Install the Hardware 1\. Unplug your M-1 from power and set the matrix side face down with the M-1 Controller PCB facing you. @@ -14,7 +14,7 @@ The microphone addon fits Rev6 and newer controllers. Rev4 boards do not have th ![Round microphone addon installed on the M-1 controller with the GND pin at the bottom right](/assets/m-1-microphone-addon-image.jpg) -###### Turn It On +## Turn It On === "WLED" diff --git a/docs/products/m1/addons/wizmote-remote.md b/docs/products/m1/addons/wizmote-remote.md index a88be44d48..6e9ea56402 100644 --- a/docs/products/m1/addons/wizmote-remote.md +++ b/docs/products/m1/addons/wizmote-remote.md @@ -10,7 +10,7 @@ The M-1 has no IR receiver, but it does take a WLED ESP-NOW documentation covers the button codes if you want something other than the defaults. -###### Troubleshooting +## Troubleshooting If nothing shows up in **Last device seen**, start with a fresh battery in the WizMote and confirm you saved the page after ticking **Enable ESP-NOW**. When the field stays blank after that, reboot the M-1 and press a button on the remote again. diff --git a/docs/products/m1/choose-your-firmware.md b/docs/products/m1/choose-your-firmware.md index c55a26963c..c519c8cd58 100644 --- a/docs/products/m1/choose-your-firmware.md +++ b/docs/products/m1/choose-your-firmware.md @@ -6,7 +6,7 @@ description: Find out which firmware your M-1 runs and what each one gives you. Most M-1 pages on this wiki have a **WLED** and a **WLED-MM** tab. Pick your firmware once and the rest of the wiki follows it, so this page is only here to help you work out which one you have. -#### Which One Do I Have? +## Which One Do I Have? Open your M-1 in a browser and tap **Info**. The version is at the top. diff --git a/docs/products/m1/examples/share-data-from-home-assistant.md b/docs/products/m1/examples/share-data-from-home-assistant.md index 24b1711492..abcecc77ed 100755 --- a/docs/products/m1/examples/share-data-from-home-assistant.md +++ b/docs/products/m1/examples/share-data-from-home-assistant.md @@ -52,7 +52,7 @@ Here is the finished board on a two panel setup, four segments each pulling a di ![Two-panel M-1 showing weather, front door lock, CO2, and ping status lines in different colors](/assets/m1-share-data-home-assistant-result.webp) -###### Tuning It +## Tuning It A minute suits temperatures and forecasts. For something that changes faster, like a countdown timer, drop the time pattern to every ten or thirty seconds. Going much below that gains you little, since the text has to finish scrolling before anyone can read it anyway. diff --git a/docs/products/m1/setup/getting-started-m1-esphome.md b/docs/products/m1/setup/getting-started-m1-esphome.md index a46ccc56b4..a1b9eb0da5 100644 --- a/docs/products/m1/setup/getting-started-m1-esphome.md +++ b/docs/products/m1/setup/getting-started-m1-esphome.md @@ -10,13 +10,13 @@ description: Getting started with your new M-1 running the hub75-studio ESPHome This guide walks you through replacing the stock WLED firmware with [hub75-studio](https://github.com/pavlov-net/hub75-studio), an ESPHome firmware tailored for the M-1, and getting it onto your home network and into Home Assistant. -### Attach M-1 LED Controller +## Attach M-1 LED Controller Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damage in shipping. Gently attach the controller to the back of the M-1 LED Matrix panel as shown in the GIF below. ![Hands pressing the M-1 controller onto the back of the M-1 LED Matrix panel](/assets/m1-matrix-attach-controller.webp) -### Flash the firmware +## Flash the firmware !!! success "Use the Rev6 build unless you have an older M-1 Controller!" @@ -34,7 +34,7 @@ Once the firmware finishes installing, the panel displays the **M-1 BIOS** splas ![M-1 showing the M-1 BIOS screen with version, CPU, RAM, and ID after flashing](../../../assets/m-1-esphome-firmware-installed-no-wifi.jpg) -### Connect to Wi-Fi +## Connect to Wi-Fi 1\. On your phone, open Wi-Fi settings and join the network **apollo-m1-r6-XXXXXX**, where the last 6 characters match the MAC suffix shown on the BIOS screen. @@ -46,7 +46,7 @@ Once the firmware finishes installing, the panel displays the **M-1 BIOS** splas ![M-1 showing the clock and date after joining Wi-Fi](../../../assets/m-1-esphome-firmware-wifi-connected.jpg) -### Join to Home Assistant +## Join to Home Assistant !!! tip "Your device should be auto-discovered by Home Assistant using the ESPHome Integration as shown below!" @@ -58,9 +58,9 @@ Head to the Media Proxy app allows you to view gifs, still images, YouTube videos, and even use Sendspin with album art when using Music Assistant! @@ -120,7 +120,7 @@ The WiZ WizMote remote, so you can change pages, dim the panel, and toggle it on/off without your phone. diff --git a/docs/products/m1/setup/getting-started-m1.md b/docs/products/m1/setup/getting-started-m1.md index 403bd95737..8cda38bb86 100644 --- a/docs/products/m1/setup/getting-started-m1.md +++ b/docs/products/m1/setup/getting-started-m1.md @@ -8,13 +8,13 @@ Congrats on your new M-1! Pick your firmware below and the rest of the M-1 wiki New units ship with **WLED**. Units shipped earlier came with **WLED-MM**. Open your M-1 in a browser and tap **Info** to see which you have: 16.0.1 or newer is WLED, 14.5.1 is WLED-MM. Running ESPHome instead? Head to [Set Up ESPHome](/products/m1/setup/getting-started-m1-esphome.md). -### Attach M-1 LED Controller +## Attach M-1 LED Controller Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damage in shipping. Gently attach the M-1 controller by lining up its power and data headers to the back of the LED Matrix panel as shown below. ![Pressing the M-1 controller onto the power and data headers on the back of the LED matrix panel](/assets/m1-matrix-attach-controller.webp) -### Connect to Wi-Fi +## Connect to Wi-Fi === "WLED" @@ -88,7 +88,7 @@ Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damag ![WLED 2D Configuration set to 2D Matrix with Basic interface and 64 x 64 panel dimensions, then saved](/assets/m-1-2d-settings.gif) -### Join to Home Assistant +## Join to Home Assistant === "WLED" @@ -126,7 +126,7 @@ Your M-1 LED Matrix and M-1 controller were shipped separately to minimize damag ![M-1 controls in Home Assistant with the power toggle, Playlist, and Preset menu](/assets/m-1-setup-wled-integration-test-device.png) -#### What Next +### What Next === "WLED" diff --git a/docs/products/m1/setup/m1-matrix-settings.md b/docs/products/m1/setup/m1-matrix-settings.md index 60f1053090..25899a24b9 100755 --- a/docs/products/m1/setup/m1-matrix-settings.md +++ b/docs/products/m1/setup/m1-matrix-settings.md @@ -7,13 +7,13 @@ description: >- These are the settings that make the HUB75 panel display correctly. You need them if you reflashed your M-1, wiped its settings, or changed the number of panels. Units that ship on WLED arrive already configured for one 64x64 panel. -###### Friendly Name +## Friendly Name Click on **Config**, then **User Interface**. In the **Server description** field, enter the name you want your M-1 device to display as in the WLED interface, such as **Apollo LED Matrix**. It ships as **Apollo M-1**, so this is only worth changing if you want something else. ![Setting the WLED Server description to Apollo LED Matrix under Config, User Interface, then saving](/assets/m-1-user-interface-settings.gif) -###### Hostname +## Hostname Your M-1 already has one. It ships as **apollo-led-matrix-xxxxxx**, with the last six characters unique to your unit, so several M-1s can sit on the same network without clashing. @@ -49,7 +49,7 @@ To change it, click on **Config**, then **WiFi Setup**. In the **mDNS address** * Hostnames are **not case sensitive** (`HostName` = `hostname`). -###### LED Settings +## LED Settings === "WLED" @@ -77,7 +77,7 @@ To change it, click on **Config**, then **WiFi Setup**. In the **mDNS address** ![WLED LED Preferences set to Hub75Matrix 64x64 and Chain Length 1, brightness limiter unchecked, then saved](/assets/m-1-led-settings.gif) -###### 2D Settings +## 2D Settings === "WLED" @@ -93,7 +93,7 @@ To change it, click on **Config**, then **WiFi Setup**. In the **mDNS address** ![WLED 2D Configuration set to 2D Matrix with Basic interface and 64 x 64 panel dimensions, then saved](/assets/m-1-2d-settings.gif) -###### AudioReactive Settings +## AudioReactive Settings !!! success "The Audioreactive is only available on a rev6 PCB with the optional microphone addon" diff --git a/docs/products/m1/setup/m1-multiple-panels.md b/docs/products/m1/setup/m1-multiple-panels.md index e8d83cda5d..c05edcef9d 100755 --- a/docs/products/m1/setup/m1-multiple-panels.md +++ b/docs/products/m1/setup/m1-multiple-panels.md @@ -10,11 +10,11 @@ description: Tutorial for wiring and configuring multiple panels with your M-1 L Using panels you sourced yourself rather than Apollo ones? They need to match the M-1's own: **64x64 half scan**, sometimes written 1/32. Indoor P2.5 and P3 64x64 panels usually qualify. Quarter-scan panels, often sold as outdoor, do not work. -###### Power +## Power A 64x64 panel can pull about 3A at 5V at full white. The M-1's onboard 5V rail passes roughly 3A, which is one panel's worth, so every panel beyond the first needs its own feed from a Matrix Power Module. Skipping it gives you dim output, color shifts, and random reboots on bright content. -###### Hardware Setup +## Hardware Setup Wiring is the same whichever firmware you run. Choose the number of panels you are using below to get started! @@ -78,7 +78,7 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a A 3D printable wall mount system is available on Printables. -###### Software Setup +## Software Setup === "WLED" @@ -174,7 +174,7 @@ Wiring is the same whichever firmware you run. Choose the number of panels you a ![Opening Info in WLED-MM, selecting Reboot WLED, then confirming the reboot](/assets/reboot-wled-gif.gif) -###### Segment Setup +## Segment Setup !!! success "WLED works using segments and your device now has different stop and end pixels for each segment since you have added more LEDs with each additional panel" @@ -308,7 +308,7 @@ If you grew an existing setup rather than starting fresh, the default segment ke 5\. Save the layout as a preset, or it disappears on the next reboot. -###### What to Expect +## What to Expect Driving four panels asks a lot more of the controller than one, and a few things change that are worth knowing before you decide something is broken. @@ -318,7 +318,7 @@ The LED memory gauge on the LED Preferences page reads high with four panels. Th Ghosting shows up more readily. Four chained panels load the drive lines harder than one, so faint red fringing behind bright content or at a seam appears at a lower brightness than you are used to. It is harmless. Drop the global brightness a step if it bothers you. -###### Going Bigger Than Four Panels +## Going Bigger Than Four Panels Four panels per M-1 is the limit, in any arrangement that multiplies to four or fewer. That is a real constraint rather than an artificial cap: the display driver keeps its frame buffer in the fastest part of the chip's memory and four panels already fill most of it, the panel hardware refreshes more slowly as the chain grows, and eight panels of bright content would need something like a 25 amp supply. diff --git a/docs/products/m1/setup/m1-wall-mounting.md b/docs/products/m1/setup/m1-wall-mounting.md index e17492dc9e..0923a60a4a 100644 --- a/docs/products/m1/setup/m1-wall-mounting.md +++ b/docs/products/m1/setup/m1-wall-mounting.md @@ -12,7 +12,7 @@ Download the files from the These cheap ones off Amazon work great. @@ -37,7 +37,7 @@ Make sure to use M3 8mm screws. 2 To MSR-1 diff --git a/docs/products/msr1/examples/msr-1-automation-guide.md b/docs/products/msr1/examples/msr-1-automation-guide.md index 1edb86c5ab..b08e40cec2 100755 --- a/docs/products/msr1/examples/msr-1-automation-guide.md +++ b/docs/products/msr1/examples/msr-1-automation-guide.md @@ -1,4 +1,5 @@ --- +title: MSR-1 Automation Guide description: "A walkthrough of building Home Assistant automations around the MSR-1." --- # MSR-1 Automation Guide diff --git a/docs/products/msr1/examples/msr-1-examples-from-github.md b/docs/products/msr1/examples/msr-1-examples-from-github.md index 91a4f28f62..999250c903 100755 --- a/docs/products/msr1/examples/msr-1-examples-from-github.md +++ b/docs/products/msr1/examples/msr-1-examples-from-github.md @@ -1,6 +1,7 @@ --- +title: MSR-1 Examples From GitHub description: "Example MSR-1 configurations and automations published in the Apollo GitHub repository." --- # MSR-1 Examples From GitHub -#### [https://github.com/ApolloAutomation/MSR-1/tree/main/Examples](https://github.com/ApolloAutomation/MSR-1/tree/main/Examples) \ No newline at end of file +## [https://github.com/ApolloAutomation/MSR-1/tree/main/Examples](https://github.com/ApolloAutomation/MSR-1/tree/main/Examples) \ No newline at end of file diff --git a/docs/products/msr1/examples/msr1-alarmo.md b/docs/products/msr1/examples/msr1-alarmo.md index f8e8dd05d0..bad5916018 100755 --- a/docs/products/msr1/examples/msr1-alarmo.md +++ b/docs/products/msr1/examples/msr1-alarmo.md @@ -1,4 +1,5 @@ --- +title: MSR-1 + Alarmo Home Security Install description: "Build a home security system from three MSR-1 sensors and Alarmo in Home Assistant, installed through HACS." --- # MSR-1 + Alarmo Home Security Install diff --git a/docs/products/msr1/examples/msr1-dashboards.md b/docs/products/msr1/examples/msr1-dashboards.md index 4254c0855f..767296005d 100755 --- a/docs/products/msr1/examples/msr1-dashboards.md +++ b/docs/products/msr1/examples/msr1-dashboards.md @@ -1,4 +1,5 @@ --- +title: MSR-1 Home Assistant Dashboard Examples description: "Example Home Assistant dashboard cards for the MSR-1, including an ApexCharts scatter plot of radar detection distance you can copy and paste." --- # MSR-1 Home Assistant Dashboard Examples diff --git a/docs/products/msr1/examples/using-msr-1-buzzer.md b/docs/products/msr1/examples/using-msr-1-buzzer.md index 063e1a430c..907853a848 100755 --- a/docs/products/msr1/examples/using-msr-1-buzzer.md +++ b/docs/products/msr1/examples/using-msr-1-buzzer.md @@ -1,4 +1,5 @@ --- +title: Using MSR-1 Buzzer description: "Trigger the MSR-1 buzzer from Home Assistant developer tools, then reuse the same call in an automation." --- # Using MSR-1 Buzzer diff --git a/docs/products/msr1/faq.md b/docs/products/msr1/faq.md index d33f9aea2f..cb3760bc7e 100755 --- a/docs/products/msr1/faq.md +++ b/docs/products/msr1/faq.md @@ -1,4 +1,5 @@ --- +title: FAQ description: "Common MSR-1 questions answered: which sensors are inside, what the mmWave radar detects, and how the device talks to Home Assistant." --- 1\. **What sensors are included in the MSR-1?** diff --git a/docs/products/msr1/introduction.md b/docs/products/msr1/introduction.md index da1e7c447e..27f146f0e7 100755 --- a/docs/products/msr1/introduction.md +++ b/docs/products/msr1/introduction.md @@ -1,4 +1,5 @@ --- +title: Introduction description: "The Apollo MSR-1 multisensor: mmWave radar, LUX and UV, temperature, humidity, and optional CO2, running ESPHome for Home Assistant." --- ![Apollo MSR-1 in its white case, with a feature list including mmWave, LUX/UV, CO2, RGB, and buzzer](/assets/productimage.jpg) diff --git a/docs/products/msr1/msr-1-reviews/beardedtinker-msr-1-review.md b/docs/products/msr1/msr-1-reviews/beardedtinker-msr-1-review.md index 94bbb7de06..9317053bf7 100755 --- a/docs/products/msr1/msr-1-reviews/beardedtinker-msr-1-review.md +++ b/docs/products/msr1/msr-1-reviews/beardedtinker-msr-1-review.md @@ -1,7 +1,8 @@ --- +title: BeardedTinker MSR-1 Review description: "BeardedTinker's video review of the Apollo MSR-1." --- # BeardedTinker MSR-1 Review -##### BeardedTinker YouTube Video review - MSR-1 +## BeardedTinker YouTube Video review - MSR-1 diff --git a/docs/products/msr1/msr-1-reviews/drzzs-msr-1-review.md b/docs/products/msr1/msr-1-reviews/drzzs-msr-1-review.md index b01b89e93b..efbbaad4f5 100755 --- a/docs/products/msr1/msr-1-reviews/drzzs-msr-1-review.md +++ b/docs/products/msr1/msr-1-reviews/drzzs-msr-1-review.md @@ -1,9 +1,10 @@ --- +title: DrZzs MSR-1 Review description: "The DrZzs review of the Apollo MSR-1, starting at 19:53 in the stream." --- # DrZzs MSR-1 Review -##### +## diff --git a/docs/products/msr1/msr-1-reviews/make-it-work-tech-msr-1-review.md b/docs/products/msr1/msr-1-reviews/make-it-work-tech-msr-1-review.md index 2bacf1201c..bcfda6a39f 100755 --- a/docs/products/msr1/msr-1-reviews/make-it-work-tech-msr-1-review.md +++ b/docs/products/msr1/msr-1-reviews/make-it-work-tech-msr-1-review.md @@ -1,11 +1,12 @@ --- +title: Make It Work Tech MSR-1 Review description: "The Make It Work Tech review of the Apollo MSR-1, starting at 31:22 in the video." --- # Make It Work Tech MSR-1 Review -##### +## -##### Apollo MSR-1 Review starts at [31:22](https://www.youtube.com/watch?v=Kt1FpRM8R18&t=1882s). \ No newline at end of file +## Apollo MSR-1 Review starts at [31:22](https://www.youtube.com/watch?v=Kt1FpRM8R18&t=1882s). \ No newline at end of file diff --git a/docs/products/msr1/msr-1-reviews/mostlychris-msr-1-review.md b/docs/products/msr1/msr-1-reviews/mostlychris-msr-1-review.md index c7756232be..ea48311429 100755 --- a/docs/products/msr1/msr-1-reviews/mostlychris-msr-1-review.md +++ b/docs/products/msr1/msr-1-reviews/mostlychris-msr-1-review.md @@ -1,4 +1,5 @@ --- +title: MostlyChris MSR-1 Review description: "MostlyChris reviews the Apollo MSR-1." --- # MostlyChris MSR-1 Review diff --git a/docs/products/msr1/msr-1-reviews/simon-says-home-assistant-msr-1-review.md b/docs/products/msr1/msr-1-reviews/simon-says-home-assistant-msr-1-review.md index 047af30665..917a23542c 100755 --- a/docs/products/msr1/msr-1-reviews/simon-says-home-assistant-msr-1-review.md +++ b/docs/products/msr1/msr-1-reviews/simon-says-home-assistant-msr-1-review.md @@ -1,4 +1,5 @@ --- +title: Simon Says Home Assistant MSR-1 Review description: "Simon Says Home Assistant reviews the Apollo MSR-1." --- # Simon Says Home Assistant MSR-1 Review diff --git a/docs/products/msr1/msr-1-reviews/smart-home-scene-msr-1-review.md b/docs/products/msr1/msr-1-reviews/smart-home-scene-msr-1-review.md index 70ab1157b2..6269fba402 100755 --- a/docs/products/msr1/msr-1-reviews/smart-home-scene-msr-1-review.md +++ b/docs/products/msr1/msr-1-reviews/smart-home-scene-msr-1-review.md @@ -1,6 +1,7 @@ --- +title: Smart Home Scene MSR-1 Review description: "The Smart Home Scene written review of the Apollo MSR-1." --- # Smart Home Scene MSR-1 Review -#### [Smart Home Scene MSR-1 Review](https://smarthomescene.com/reviews/apollo-msr-1-review-miniature-multi-sensor-for-presence-and-co2-monitoring/) \ No newline at end of file +## [Smart Home Scene MSR-1 Review](https://smarthomescene.com/reviews/apollo-msr-1-review-miniature-multi-sensor-for-presence-and-co2-monitoring/) \ No newline at end of file diff --git a/docs/products/msr1/msr1-reviews.md b/docs/products/msr1/msr1-reviews.md index 394e625c8d..7e607d5768 100755 --- a/docs/products/msr1/msr1-reviews.md +++ b/docs/products/msr1/msr1-reviews.md @@ -1,14 +1,15 @@ --- +title: Make It Work Tech MSR-1 Review description: "Video and written reviews of the Apollo MSR-1 from across the community." --- # [Make It Work Tech MSR-1 Review](https://youtu.be/Kt1FpRM8R18?si=GgMGCjpbSwpSqIsr) -# [Smart Home Scene MSR-1 Review](https://smarthomescene.com/reviews/apollo-msr-1-review-miniature-multi-sensor-for-presence-and-co2-monitoring/) +## [Smart Home Scene MSR-1 Review](https://smarthomescene.com/reviews/apollo-msr-1-review-miniature-multi-sensor-for-presence-and-co2-monitoring/) -# [DrZzs MSR-1 Review](https://www.youtube.com/live/YGNCw1nFwjg?si=gmdQTtnY2XdzVHV3) +## [DrZzs MSR-1 Review](https://www.youtube.com/live/YGNCw1nFwjg?si=gmdQTtnY2XdzVHV3) -# [BeardedTinker MSR-1 Review](https://youtu.be/vz1oWhPoIwA?si=Gk8p8S_LUIsMC7D-) +## [BeardedTinker MSR-1 Review](https://youtu.be/vz1oWhPoIwA?si=Gk8p8S_LUIsMC7D-) -# [Simon Says Home Assistant MSR-1 Review](https://youtu.be/M-HAuPH9KOk?si=Fy7RkfsOJdjaodkr) +## [Simon Says Home Assistant MSR-1 Review](https://youtu.be/M-HAuPH9KOk?si=Fy7RkfsOJdjaodkr) -# [MostlyChris MSR-1 Review](https://youtu.be/u8q3lMIkolc?si=aWrkRHIru_eOY1jw) \ No newline at end of file +## [MostlyChris MSR-1 Review](https://youtu.be/u8q3lMIkolc?si=aWrkRHIru_eOY1jw) \ No newline at end of file diff --git a/docs/products/msr1/setup/co2-calibration-for-msr-1.md b/docs/products/msr1/setup/co2-calibration-for-msr-1.md index e2f786007f..46ac167148 100755 --- a/docs/products/msr1/setup/co2-calibration-for-msr-1.md +++ b/docs/products/msr1/setup/co2-calibration-for-msr-1.md @@ -1,6 +1,7 @@ --- +title: CO2 Calibration For MSR-1 description: "CO2 calibration for the MSR-1, covered by the general calibration guide." --- # CO2 Calibration For MSR-1 -##### Please refer to the [General CO2 Calibration](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) article \ No newline at end of file +## Please refer to the [General CO2 Calibration](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/co2-calibration/) article \ No newline at end of file diff --git a/docs/products/msr1/setup/general-tips.md b/docs/products/msr1/setup/general-tips.md index a7a76ac2d7..0a031ed1b8 100755 --- a/docs/products/msr1/setup/general-tips.md +++ b/docs/products/msr1/setup/general-tips.md @@ -1,15 +1,16 @@ --- +title: General Tips description: "Placement and mounting tips for the MSR-1, including keeping the light sensor holes clear and stopping the RGB LED from skewing LUX readings." --- # General Tips -##### **MSR-1** +## **MSR-1** ![MSR-1 circuit board with labeled parts: ESP32-C3 Mini, LD2410B radar, LTR-390UV, BME280, SCD-40, buzzer, and USB-C](/assets/apollo-automation-msr-1-presence-multisensor-pcb-components-layout-1024x768-jpg.webp) Picture from Smart Home Scene -##### **Light Sensor (LTR-390UV)** +## **Light Sensor (LTR-390UV)** ![3D render of the MSR-1 case with the light sensor holes outlined in red](/assets/UWHlight-holes.png) @@ -19,7 +20,7 @@ When mounting the MSR-1 be sure to position the device so that the two large hol Make sure that your automations do not interfere with each other. This includes being aware that your onboard LED can trigger the lux reading but not the uv reading of the LTR390 in your device. -##### **Mounting** +## **Mounting** The MSR-1 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120-degree FOV of the mmWave radar. @@ -29,7 +30,7 @@ The MSR-1 should be mounted 1.5-2 meters off the ground which will then provide The MSR-1 can also be mounted on the ceiling if you can provide power and mount our articulating stand on the ceiling. -##### **Gate and FOV Visualization** +## **Gate and FOV Visualization** **![Table of LD2410 gates 0 to 8 with distance ranges and default move and still thresholds](/assets/ld2410-table_1.png)![Home Assistant radar settings with 0.75 m distance resolution and Zone 1, 2, and 3 distances in cm](/assets/gate-zones-and-rr.png)** diff --git a/docs/products/msr1/setup/mmwave-videos.md b/docs/products/msr1/setup/mmwave-videos.md index 873d3e483e..9c7703ff14 100644 --- a/docs/products/msr1/setup/mmwave-videos.md +++ b/docs/products/msr1/setup/mmwave-videos.md @@ -1,4 +1,5 @@ --- +title: mmWave Tuning Videos description: "Two short videos and a quick summary on how to best tune the LD2410B in the MSR-2!" --- --8<-- "products/general/calibrating-and-updating/mmwave-videos.md:5:" diff --git a/docs/products/msr1/setup/updating-msr-1-firmware.md b/docs/products/msr1/setup/updating-msr-1-firmware.md index 9c4ec26938..2f9485b6be 100755 --- a/docs/products/msr1/setup/updating-msr-1-firmware.md +++ b/docs/products/msr1/setup/updating-msr-1-firmware.md @@ -1,6 +1,7 @@ --- +title: Updating MSR-1 Firmware description: "Updating MSR-1 firmware, covered by the general firmware update guide." --- # Updating MSR-1 Firmware -##### Please refer to the [general firmware update](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/updating-firmware/ "Updating Firmware") article \ No newline at end of file +## Please refer to the [general firmware update](https://wiki.apolloautomation.com/products/general/calibrating-and-updating/updating-firmware/ "Updating Firmware") article \ No newline at end of file diff --git a/docs/products/msr1/setup/zones-ha.md b/docs/products/msr1/setup/zones-ha.md index f4c1e0ba58..226ceed6b3 100755 --- a/docs/products/msr1/setup/zones-ha.md +++ b/docs/products/msr1/setup/zones-ha.md @@ -1,4 +1,5 @@ --- +title: How To Tune mmWave Using Home Assistant description: "Tune the MSR-1 mmWave radar from Home Assistant using Radar Engineering Mode to find which gates cause false triggers and raise their thresholds." --- # How To Tune mmWave Using Home Assistant diff --git a/docs/products/msr1/setup/zones-hlk.md b/docs/products/msr1/setup/zones-hlk.md index 33053810a1..909fcaedf5 100755 --- a/docs/products/msr1/setup/zones-hlk.md +++ b/docs/products/msr1/setup/zones-hlk.md @@ -1,4 +1,5 @@ --- +title: How To Tune mmWave Using HLKRadarTool description: "Tune the MSR-1 mmWave radar over Bluetooth with the HLKRadarTool phone app, covering both auto-calibration and manual gate settings." --- # How To Tune mmWave Using HLKRadarTool diff --git a/docs/products/msr1/troubleshooting/msr1-boot-mode.md b/docs/products/msr1/troubleshooting/msr1-boot-mode.md index ddc5ca3bc8..f6e27566e8 100755 --- a/docs/products/msr1/troubleshooting/msr1-boot-mode.md +++ b/docs/products/msr1/troubleshooting/msr1-boot-mode.md @@ -1,4 +1,5 @@ --- +title: Putting The MSR-1 In Boot Mode description: "Put the MSR-1 into boot mode using the boot button, which is needed before reflashing its firmware." --- # Putting The MSR-1 In Boot Mode @@ -7,7 +8,7 @@ description: "Put the MSR-1 into boot mode using the boot button, which is neede This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the MSR-1 as shown in the image below and locate the small opening to press the boot button (the right button). @@ -17,7 +18,7 @@ description: "Put the MSR-1 into boot mode using the boot button, which is neede 3\. Continue with uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/products/msr1/troubleshooting/msr1-code.md b/docs/products/msr1/troubleshooting/msr1-code.md index 7b35cd12a1..20ad00bd2c 100755 --- a/docs/products/msr1/troubleshooting/msr1-code.md +++ b/docs/products/msr1/troubleshooting/msr1-code.md @@ -1,4 +1,5 @@ --- +title: Factory Re-Flash MSR-1 description: "Reflash the MSR-1 back to factory firmware from a Chromium based browser when it stops responding." --- # Factory Re-Flash MSR-1 diff --git a/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md b/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md index c9876d8829..2f3d03f6a1 100755 --- a/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md +++ b/docs/products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md @@ -1,4 +1,5 @@ --- +title: Reset Wi-Fi Credentials description: "Reset the MSR-1 Wi-Fi credentials with a 10 second press of the Boot button, then reconnect through its hotspot." --- # Reset Wi-Fi Credentials diff --git a/docs/products/msr1/troubleshooting/msr1-teardown.md b/docs/products/msr1/troubleshooting/msr1-teardown.md index 1ae2408de1..39d115ecb2 100755 --- a/docs/products/msr1/troubleshooting/msr1-teardown.md +++ b/docs/products/msr1/troubleshooting/msr1-teardown.md @@ -1,4 +1,5 @@ --- +title: Teardown and Reassembly Of MSR-1 description: "Video walkthrough of taking an MSR-1 apart." ---
\ No newline at end of file diff --git a/docs/products/msr2/msr2-reviews.md b/docs/products/msr2/msr2-reviews.md index 7d6ded79ba..5ba7fce8e2 100755 --- a/docs/products/msr2/msr2-reviews.md +++ b/docs/products/msr2/msr2-reviews.md @@ -4,12 +4,12 @@ description: YouTuber reviews and feedback about the MSR-2 sensor from Apollo Au --- # [Simon Says Home Assistant MSR-2 Review](https://www.youtube.com/watch?v=U4qUhFSAxbk) -# [Smart Home Scene MSR-2 Review](https://smarthomescene.com/reviews/apollo-msr-2-review-the-smallest-presence-sensor-ever-made/) +## [Smart Home Scene MSR-2 Review](https://smarthomescene.com/reviews/apollo-msr-2-review-the-smallest-presence-sensor-ever-made/) -# [Home Tech Innovations MSR-2 Review](https://www.youtube.com/watch?v=K3j2rR2dsY0) +## [Home Tech Innovations MSR-2 Review](https://www.youtube.com/watch?v=K3j2rR2dsY0) -# [MostlyChris MSR-2 Review](https://www.youtube.com/watch?v=nQpi2n5UWoQ) +## [MostlyChris MSR-2 Review](https://www.youtube.com/watch?v=nQpi2n5UWoQ) -# [Smart Home Australia MSR-2 Review](https://www.youtube.com/watch?v=EzVyzFwdgN4) +## [Smart Home Australia MSR-2 Review](https://www.youtube.com/watch?v=EzVyzFwdgN4) -# [Michael Leen MSR-2 Review](https://www.youtube.com/watch?v=VdVR8Gs002Q) \ No newline at end of file +## [Michael Leen MSR-2 Review](https://www.youtube.com/watch?v=VdVR8Gs002Q) \ No newline at end of file diff --git a/docs/products/msr2/setup/mmwave-videos.md b/docs/products/msr2/setup/mmwave-videos.md index 873d3e483e..9c7703ff14 100644 --- a/docs/products/msr2/setup/mmwave-videos.md +++ b/docs/products/msr2/setup/mmwave-videos.md @@ -1,4 +1,5 @@ --- +title: mmWave Tuning Videos description: "Two short videos and a quick summary on how to best tune the LD2410B in the MSR-2!" --- --8<-- "products/general/calibrating-and-updating/mmwave-videos.md:5:" diff --git a/docs/products/msr2/setup/msr2-general-tips.md b/docs/products/msr2/setup/msr2-general-tips.md index 92aa8740d2..fc35b509e7 100755 --- a/docs/products/msr2/setup/msr2-general-tips.md +++ b/docs/products/msr2/setup/msr2-general-tips.md @@ -4,7 +4,7 @@ description: Multiple helpful images for mounting, lux/rgb, and gate and zone vi --- # General Tips -##### **Light Sensor (LTR-390UV)** +## **Light Sensor (LTR-390UV)** ![MSR-2 case with the light sensor visible through the center vent outlined in red](/assets/20240514-123742.jpg) @@ -14,7 +14,7 @@ When mounting the MSR-2 be sure to position the device so that the two large hol Make sure that your automations do not interfere with each other. This includes being aware that your onboard LED can trigger the lux reading but not the uv reading of the LTR390 in your device. -##### **Mounting** +## **Mounting** The MSR-2 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120-degree FOV of the mmWave radar. @@ -30,7 +30,7 @@ The MSR-2 can also be mounted on the ceiling if you can provide power and mount * Gates are pre-defined by the radar module and are in 0.75 meter increments. * Zones are user-configurable and are in cm. -##### **Gate and FOV Visualization** +## **Gate and FOV Visualization** **![Table of LD2410 gates 0 to 8 with distance ranges and default move and still thresholds](/assets/ld2410-table.png)![Home Assistant radar settings with 0.75 m distance resolution and Zone 1, 2, and 3 distances in cm](/assets/gate-zones-and-rr.png)** diff --git a/docs/products/msr2/setup/zones-hlk.md b/docs/products/msr2/setup/zones-hlk.md index 12201270e7..eab46fe25a 100755 --- a/docs/products/msr2/setup/zones-hlk.md +++ b/docs/products/msr2/setup/zones-hlk.md @@ -4,7 +4,7 @@ description: Tutorial for MSR-2 HLKRadarTool app Zone Configuration. --- # How To Tune MSR-2 Using HLKRadarTool -###### **Auto-Calibration** +## **Auto-Calibration** 1\. Download the HLKRadarTool app. @@ -56,7 +56,7 @@ The default password to connect to the HLKRadarTool is "HiLink". **![HLKRadarTool Parameter settings with the Intelligent one click setting outlined in red](/assets/intelligent.png)** -###### Manual Calibration +## Manual Calibration 1\. Repeat steps 1-5 above. diff --git a/docs/products/msr2/troubleshooting/msr2-boot-mode.md b/docs/products/msr2/troubleshooting/msr2-boot-mode.md index b4dc6bb4e5..f876bd6a41 100755 --- a/docs/products/msr2/troubleshooting/msr2-boot-mode.md +++ b/docs/products/msr2/troubleshooting/msr2-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The MSR-2 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the MSR-2 as shown in the image below and locate the small opening to press the boot button (the right button). @@ -18,7 +18,7 @@ description: Step by step guide for putting The MSR-2 In Boot Mode. 3\. Continue with uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/products/mtr1/mtr1-reviews.md b/docs/products/mtr1/mtr1-reviews.md index 9ecbdcaaa6..8b8a119fac 100755 --- a/docs/products/mtr1/mtr1-reviews.md +++ b/docs/products/mtr1/mtr1-reviews.md @@ -5,10 +5,10 @@ description: YouTuber reviews and feedback about the MTR-1 sensor from Apollo Au # [Home Tech Innovations MTR-1 Review](https://youtu.be/q5GejbxnByA?si=PMgK4ro6U8Q7idCm) -# [Simon Says Home Assistant MTR-1 Review](https://www.youtube.com/watch?v=FFN-vIkDRLk) +## [Simon Says Home Assistant MTR-1 Review](https://www.youtube.com/watch?v=FFN-vIkDRLk) -# [Smart Home Australia MTR-1 Review](https://www.youtube.com/watch?v=xyxgk7WGHCY) +## [Smart Home Australia MTR-1 Review](https://www.youtube.com/watch?v=xyxgk7WGHCY) -# [Smart Home Scene MTR-1 Review](https://smarthomescene.com/reviews/apollo-mtr-1-multi-target-tracking-radar-review/) +## [Smart Home Scene MTR-1 Review](https://smarthomescene.com/reviews/apollo-mtr-1-multi-target-tracking-radar-review/) -# [Michael Leen MTR-1 Review](https://www.youtube.com/watch?v=7qFvqRw1uds) \ No newline at end of file +## [Michael Leen MTR-1 Review](https://www.youtube.com/watch?v=7qFvqRw1uds) \ No newline at end of file diff --git a/docs/products/mtr1/setup/general-tips.md b/docs/products/mtr1/setup/general-tips.md index 297edbce26..51290b8977 100755 --- a/docs/products/mtr1/setup/general-tips.md +++ b/docs/products/mtr1/setup/general-tips.md @@ -4,11 +4,11 @@ description: Multiple helpful images for mounting, lux/rgb, and zone visualizati --- # General Tips -##### **MTR-1 PCB with Sensors** +## **MTR-1 PCB with Sensors** ![MTR-1 main PCB with the ESP32-C3 module, Boot and RST buttons, RGB LED, and buzzer](/assets/20240501-155316.jpg)![MTR-1 main PCB with the blue HLK-LD2450 mmWave radar board and the CO2 module attached](/assets/20240501-155130.jpg)![Back of the MTR-1 PCB with the Apollo logo and USB-C port](/assets/20240501-155248.jpg) -##### **Light Sensor (LTR-390UV)** +## **Light Sensor (LTR-390UV)** ![MTR-1 case render with the large light sensor opening outlined in red](/assets/screenshot-2024-04-30-at-5-42-54-pm.png) @@ -16,27 +16,27 @@ When mounting the MTR-1 be sure to position the device so that the large hole at The onboard RGB LED will trigger the light sensor. Be cognizant of this when making automations based on light/LUX. -##### **Mounting** +## **Mounting** ![LD2450 datasheet diagrams for wall mounting height, angle orientation, and tracking range](/assets/screenshot-2024-04-30-at-5-51-36-pm.png) -##### **LD2450 Performance and Electrical Parameters** +## **LD2450 Performance and Electrical Parameters** -##### [**LD2450 Datasheet**](https://www.tinytronics.nl/index.php?route=product/product/get_file&file=6000/HLK-LD2450-Instruction-Manual.pdf) +## [**LD2450 Datasheet**](https://www.tinytronics.nl/index.php?route=product/product/get_file&file=6000/HLK-LD2450-Instruction-Manual.pdf) ![LD2450 datasheet table of performance and electrical parameters](/assets/screenshot-2024-04-30-at-5-53-09-pm.png) -##### **Expanding Horizontal Distance as Target Moves Further Away** +## **Expanding Horizontal Distance as Target Moves Further Away** The detection is 60 degrees from center on each side. So it is a cone when you are close to it but at 4 feet away to the side you might not be visible. If you are further from the wall it can detect further in a horizontal distance. ![Hi-Link radar demo tracking targets inside a detection cone that widens with distance](/assets/9jtimage.png) -##### **Increased ESP Temperature** +## **Increased ESP Temperature** If you are experiencing higher than normal ESP temperatures ~140+ degrees F then changing the Wi-Fi power save mode option might help decrease the temperature. Here is the link to the ESPHome WiFi Component [Power Save Mode](https://esphome.io/components/wifi.html#power-save-mode). -##### **Improve Wi-Fi Connection** +## **Improve Wi-Fi Connection** The Wi-Fi interface of all ESP32 devices offers three power save modes to reduce the amount of power spent on Wi-Fi. While some options can reduce the power usage of the ESP, they generally also decrease the reliability of the Wi-Fi connection, with frequent disconnections from the router in the highest power saving mode. Switch to "none" to get the best Wi-Fi performance! diff --git a/docs/products/mtr1/setup/zones-hlk.md b/docs/products/mtr1/setup/zones-hlk.md index f0d89d1e78..5f9efd9e04 100755 --- a/docs/products/mtr1/setup/zones-hlk.md +++ b/docs/products/mtr1/setup/zones-hlk.md @@ -4,7 +4,7 @@ description: Tutorial for MTR-1 HLKRadarTool app Zone Configuration. ---
-###### Configure Zones +## Configure Zones !!! note "Ensure that the LD2450 firmware version is V2.02.23090617 or later for proper integration functionality. " @@ -64,7 +64,7 @@ The uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/products/new-product-template/setup/productname-general-tips.md b/docs/products/new-product-template/setup/productname-general-tips.md index d91c021636..57e68a472a 100755 --- a/docs/products/new-product-template/setup/productname-general-tips.md +++ b/docs/products/new-product-template/setup/productname-general-tips.md @@ -6,10 +6,10 @@ description: >- --- # General Tips -###### Fluid Sensor +## Fluid Sensor The fluid level sensor should be securely taped or mounted flat against the surface of your chosen water reservoir. The fluid sensor is rated to go through up to 5mm of plastic but could possibly go further. -###### Pump Control +## Pump Control There is a disabled entity by default called **Pump Control** which will just turn the pump on or off and run it instead of using the **Run Pump** entity. The **Pump Control** entity will ignore the **Pump Run Seconds** however this entity is still affected by the **Max Safe Run Time**. For example, if **Max Safe Run Time** is set to 120 seconds, then when you turn on the **Pump Control** entity, it will run for 120 seconds and then turn off unless you manually turn it off sooner. \ No newline at end of file diff --git a/docs/products/new-product-template/troubleshooting/productname-boot-mode.md b/docs/products/new-product-template/troubleshooting/productname-boot-mode.md index 7dc1b3ddd3..f46c35b72f 100755 --- a/docs/products/new-product-template/troubleshooting/productname-boot-mode.md +++ b/docs/products/new-product-template/troubleshooting/productname-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The PUMP-1 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only !!! danger "Empty the water reservoir and make sure no water is present in the tubes" @@ -26,7 +26,7 @@ description: Step by step guide for putting The PUMP-1 In Boot Mode. [Click here to go to the reflashing guide!](https://wiki.apolloautomation.com/products/pump1/troubleshooting/pump1-reflash/){ .md-button .md-button--primary } -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Plug in a USB cable that supports power and data into your computer and connect the other end to your PUMP-1. With the device facing you, locate the reset (left) and boot (right) buttons. diff --git a/docs/products/new-product-template/troubleshooting/productname-teardown.md b/docs/products/new-product-template/troubleshooting/productname-teardown.md index a30a77f0f8..d4f0bfc131 100755 --- a/docs/products/new-product-template/troubleshooting/productname-teardown.md +++ b/docs/products/new-product-template/troubleshooting/productname-teardown.md @@ -6,7 +6,7 @@ description: >- --- # Teardown and Reassembly Of PUMP-1 -###### Disassembly +## Disassembly !!! danger "Drain all liquid from the PUMP-1 before disassembling!" @@ -24,7 +24,7 @@ description: >- ![Pinching and twisting to pull the inlet and outlet tubes off the PUMP-1](/assets/pump-1-remove-tubes-webp.webp) -###### Reassembly +## Reassembly 1\. Attach the two tubes to the pump as shown below. The fluid input tube is the left tube on the same side as the USB-C port and the fluid output tube is the tube on the right on the side of the PUMP-1. diff --git a/docs/products/plt1/examples/blueprint.md b/docs/products/plt1/examples/blueprint.md index 8959f2d99a..55195553b2 100644 --- a/docs/products/plt1/examples/blueprint.md +++ b/docs/products/plt1/examples/blueprint.md @@ -6,7 +6,7 @@ description: >- --- # Blueprint Setup -### Automatic Import +## Automatic Import 1\. Click the Import Blueprint button below and then click **Open link**. @@ -37,7 +37,7 @@ description: >- 7\. Click **Save**. Your blueprint is now live and will send push notifications whenever your plant needs attention! -### Manual Import +## Manual Import 1\. Head to the automations page and click on **Blueprints** in the top right then select **Import Blueprint**. diff --git a/docs/products/plt1/general-tips.md b/docs/products/plt1/general-tips.md index 290d345d74..27a51d468b 100755 --- a/docs/products/plt1/general-tips.md +++ b/docs/products/plt1/general-tips.md @@ -4,7 +4,7 @@ description: Helpful tips to get the most use out of your sensor. --- # General Tips -###### LTR390 UV +## LTR390 UV For the most accurate UV and LUX readings, be sure to expose the sensor circled in the image below to light. diff --git a/docs/products/plt1/reviews.md b/docs/products/plt1/reviews.md index bc5670e645..b07eb2d6ba 100755 --- a/docs/products/plt1/reviews.md +++ b/docs/products/plt1/reviews.md @@ -8,22 +8,22 @@ description: YouTuber reviews and feedback about the PLT-1 sensor from Apollo Au   -# [Michael Leen PLT-1 Review](https://youtu.be/tSYUJESNyFM?si=9k0OBns9XvNzYjyz) +## [Michael Leen PLT-1 Review](https://youtu.be/tSYUJESNyFM?si=9k0OBns9XvNzYjyz)
  -# [Mostly Chris PLT-1 Review](https://youtu.be/9TtLOLbf9zI?si=0wRhrtZ8f9KXqAhB) +## [Mostly Chris PLT-1 Review](https://youtu.be/9TtLOLbf9zI?si=0wRhrtZ8f9KXqAhB)
  -# Bearded Tinker PLT-1 Review +## Bearded Tinker PLT-1 Review -# Hands On Katie PLT-1 Review +## Hands On Katie PLT-1 Review -# Smart Home Scene PLT-1 Review +## Smart Home Scene PLT-1 Review -# Smart Home Australia PLT-1 Review \ No newline at end of file +## Smart Home Australia PLT-1 Review \ No newline at end of file diff --git a/docs/products/plt1/troubleshooting/plt1-boot-mode.md b/docs/products/plt1/troubleshooting/plt1-boot-mode.md index 1fa4b8fde6..7cfc9fc9fa 100755 --- a/docs/products/plt1/troubleshooting/plt1-boot-mode.md +++ b/docs/products/plt1/troubleshooting/plt1-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The PLT-1 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the PLT-1 as shown in the image below and locate the small opening to press the boot button. @@ -18,7 +18,7 @@ description: Step by step guide for putting The PLT-1 In Boot Mode. 3\. Continue with uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and locate the boot and reset buttons as shown in the image above. diff --git a/docs/products/plt1b/battery-sensors/awake-ha-helper.md b/docs/products/plt1b/battery-sensors/awake-ha-helper.md index b4be1fbaed..4b683b4871 100644 --- a/docs/products/plt1b/battery-sensors/awake-ha-helper.md +++ b/docs/products/plt1b/battery-sensors/awake-ha-helper.md @@ -1,4 +1,5 @@ --- +title: Keep Your Sensor Awake With HA Helper description: "How to keep your sensor awake using the Home Assistant Helper." --- --8<-- "products/general/battery-sensors/awake-ha-helper.md:5:" diff --git a/docs/products/plt1b/battery-sensors/sensor-connection-check.md b/docs/products/plt1b/battery-sensors/sensor-connection-check.md index 4c138fe50e..dc0b58396d 100644 --- a/docs/products/plt1b/battery-sensors/sensor-connection-check.md +++ b/docs/products/plt1b/battery-sensors/sensor-connection-check.md @@ -1,4 +1,5 @@ --- +title: Sensor Connection Check description: "How to check if your device is connected to Wi-Fi, Home Assistant, or nothing." --- --8<-- "products/general/battery-sensors/sensor-connection-check.md:5:" diff --git a/docs/products/plt1b/battery-sensors/wake-up-battery-sensor.md b/docs/products/plt1b/battery-sensors/wake-up-battery-sensor.md index 023266d9c9..e5adaf6759 100644 --- a/docs/products/plt1b/battery-sensors/wake-up-battery-sensor.md +++ b/docs/products/plt1b/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/products/plt1b/examples/flower-card.md b/docs/products/plt1b/examples/flower-card.md index 0f6385fb3e..b9b4204653 100644 --- a/docs/products/plt1b/examples/flower-card.md +++ b/docs/products/plt1b/examples/flower-card.md @@ -1,4 +1,5 @@ --- +title: Flower Card description: "This suggests using the Flower Card inside Home Assistant for your device!" --- --8<-- "products/plt1/examples/flower-card.md:5:" diff --git a/docs/products/plt1b/general-tips.md b/docs/products/plt1b/general-tips.md index a569e1de74..7e460a7683 100755 --- a/docs/products/plt1b/general-tips.md +++ b/docs/products/plt1b/general-tips.md @@ -4,7 +4,7 @@ description: Helpful tips to get the most use out of your sensor. --- # General Tips -###### LTR390 UV +## LTR390 UV For the most accurate UV and LUX readings, be sure to expose the sensor circled in the image below to light. diff --git a/docs/products/plt1b/reviews.md b/docs/products/plt1b/reviews.md index 6f242e2559..a6fbeb2c0b 100644 --- a/docs/products/plt1b/reviews.md +++ b/docs/products/plt1b/reviews.md @@ -1,4 +1,5 @@ --- +title: Reviews description: "YouTuber reviews and feedback about the PLT-1 sensor from Apollo Automation." --- --8<-- "products/plt1/reviews.md:5:" diff --git a/docs/products/plt1b/setup/getting-started-plt1.md b/docs/products/plt1b/setup/getting-started-plt1.md index 3bf2f82d6e..4fd0d4228d 100644 --- a/docs/products/plt1b/setup/getting-started-plt1.md +++ b/docs/products/plt1b/setup/getting-started-plt1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- --8<-- "products/general/setup/getting-started.md:5:" diff --git a/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md b/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md index 25ceb70bf1..90fd3d95a6 100755 --- a/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md +++ b/docs/products/plt1b/troubleshooting/plt1b-boot-mode.md @@ -10,7 +10,7 @@ description: Step by step guide for putting The PLT-1B In Boot Mode. ![PLT-1B diagram labeling the reset button on the left and the USB-C port and boot button on the right](/assets/plt-1b-buttons-2.png) -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the PLT-1B as shown in the image below and locate the small opening to press the boot button. @@ -22,7 +22,7 @@ description: Step by step guide for putting The PLT-1B In Boot Mode. 3\. Continue with [uploading the firmware](https://wiki.apolloautomation.com/products/plt1b/troubleshooting/plt1b-code/) -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Plug in the device diff --git a/docs/products/plt1b/troubleshooting/plt1b-code.md b/docs/products/plt1b/troubleshooting/plt1b-code.md index 67c3a789ff..d2a751e2b1 100755 --- a/docs/products/plt1b/troubleshooting/plt1b-code.md +++ b/docs/products/plt1b/troubleshooting/plt1b-code.md @@ -32,7 +32,7 @@ If no device shows, click cancel and then install the recommended driver that sh 6\. Please proceed to the getting started guide and set up your sensor as a new device! -# Factory Re-Flash PLT-1B +## Factory Re-Flash PLT-1B !!! info "If your device becomes unresponsive and you've exhausted the other troubleshooting methods you can reflash the factory firmware by following the below guide." diff --git a/docs/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md b/docs/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md index 3067fd7ebe..1e383e9806 100755 --- a/docs/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md +++ b/docs/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md @@ -4,7 +4,7 @@ description: Tutorial for Attaching The Input and Output Fluid Level Sensors to --- # Attaching Fluid Level Sensors to the PUMP-1 -##### Installing Fluid Input Sensor +## Installing Fluid Input Sensor 1\. Begin by placing the small white connector through the hole in the base of the water bottle and gently press the input fluid level sensor into place. @@ -14,13 +14,13 @@ description: Tutorial for Attaching The Input and Output Fluid Level Sensors to ![Fitting the input fluid level sensor into the PUMP-1 bottle base, then sliding the bottle in](/assets/pump-1-install-fluid-input-sensor-webp.webp) -##### Connecting Fluid Input Sensor +## Connecting Fluid Input Sensor 1\. Insert the small white connector into the **right-side port** on your PUMP-1 device. Ensure it is fully seated for proper operation. The small bump on top of the white connector must be facing **upwards** when inserting it. This ensures proper alignment and a secure connection. ![Plugging the input fluid sensor connector into the right-side port of the open PUMP-1](/assets/pump-1-connect-fluid-input-sensor-webp.webp) -##### Connecting Fluid Output Sensor +## Connecting Fluid Output Sensor 1\. Insert the small white connector into the **left-side port** on your PUMP-1 device. Ensure it is fully seated for proper operation. The small bump on top of the white connector must be facing **upwards** when inserting it. This ensures proper alignment and a secure connection. diff --git a/docs/products/pump1/setup/pump1-general-tips.md b/docs/products/pump1/setup/pump1-general-tips.md index 3f0b012b45..2b2f457593 100755 --- a/docs/products/pump1/setup/pump1-general-tips.md +++ b/docs/products/pump1/setup/pump1-general-tips.md @@ -6,17 +6,17 @@ description: >- --- # General Tips -###### Fluid Sensor +## Fluid Sensor The fluid level sensor is a non-contact capacitive sensor. It detects water through the wall of the container, so it should be securely taped or mounted flat against the outside surface of your chosen water reservoir. The sensor is rated to read through up to 5mm of plastic and often manages more. Do not submerge the fluid level sensor or place it inside your reservoir. It is not sealed against water, and submerging one can damage both the sensor and the PUMP-1 it is plugged into. -###### Pump Control +## Pump Control There is a disabled entity by default called **Pump Control** which will just turn the pump on or off and run it instead of using the **Run Pump** entity. The **Pump Control** entity will ignore the **Pump Run Seconds** however this entity is still affected by the **Max Safe Run Time**. For example, if **Max Safe Run Time** is set to 120 seconds, then when you turn on the **Pump Control** entity, it will run for 120 seconds and then turn off unless you manually turn it off sooner. -###### Siphon Concerns +## Siphon Concerns If you plan to use the PUMP-1 with the output reservoir positioned lower than the input reservoir, please note that a siphon-like effect can occur. In this setup, small amounts of water may continue to drip even when the pump is turned off. diff --git a/docs/products/pump1/troubleshooting/pump1-boot-mode.md b/docs/products/pump1/troubleshooting/pump1-boot-mode.md index 7dc1b3ddd3..f46c35b72f 100755 --- a/docs/products/pump1/troubleshooting/pump1-boot-mode.md +++ b/docs/products/pump1/troubleshooting/pump1-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The PUMP-1 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only !!! danger "Empty the water reservoir and make sure no water is present in the tubes" @@ -26,7 +26,7 @@ description: Step by step guide for putting The PUMP-1 In Boot Mode. [Click here to go to the reflashing guide!](https://wiki.apolloautomation.com/products/pump1/troubleshooting/pump1-reflash/){ .md-button .md-button--primary } -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Plug in a USB cable that supports power and data into your computer and connect the other end to your PUMP-1. With the device facing you, locate the reset (left) and boot (right) buttons. diff --git a/docs/products/pump1/troubleshooting/pump1-teardown.md b/docs/products/pump1/troubleshooting/pump1-teardown.md index a30a77f0f8..d4f0bfc131 100755 --- a/docs/products/pump1/troubleshooting/pump1-teardown.md +++ b/docs/products/pump1/troubleshooting/pump1-teardown.md @@ -6,7 +6,7 @@ description: >- --- # Teardown and Reassembly Of PUMP-1 -###### Disassembly +## Disassembly !!! danger "Drain all liquid from the PUMP-1 before disassembling!" @@ -24,7 +24,7 @@ description: >- ![Pinching and twisting to pull the inlet and outlet tubes off the PUMP-1](/assets/pump-1-remove-tubes-webp.webp) -###### Reassembly +## Reassembly 1\. Attach the two tubes to the pump as shown below. The fluid input tube is the left tube on the same side as the USB-C port and the fluid output tube is the tube on the right on the side of the PUMP-1. diff --git a/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md b/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md index d8315a76a6..86f84335ca 100755 --- a/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md +++ b/docs/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md @@ -4,7 +4,7 @@ description: Tutorial on adding the gang box mounts to your R PRO-1. --- # Adding Gang Box Mounts To R PRO-1 -###### Attaching Mounts +## Attaching Mounts 1\. Unplug your R PRO-1 from power and remove the back. @@ -32,7 +32,7 @@ description: Tutorial on adding the gang box mounts to your R PRO-1. ![R PRO-1 board with the TOP mount on the top edge and the bottom mount on the bottom edge](/assets/r-pro-1-gang-box-mounts-installed.jpg) -###### Install in 1-Gang Box +## Install in 1-Gang Box 1\. Line up the holes in your 1-gang box (yours will be attached to the wall already). diff --git a/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md b/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md index 0319f25329..ff52b3bcc8 100755 --- a/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md +++ b/docs/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md @@ -8,7 +8,7 @@ Watch our step by step video on installing the R PRO-1 using the Ceiling Mount.
-###### Attaching Mounts +## Attaching Mounts 1\. Unplug your R PRO-1 from power and remove the back. @@ -38,11 +38,11 @@ Watch our step by step video on installing the R PRO-1 using the Ceiling Mount. ![R PRO-1 PCB with both the TOP and bottom ceiling mount pieces attached](/assets/r-pro-1-ceiling-box-mounts-installed.webp) -###### Cut the Ceiling Hole +## Cut the Ceiling Hole The Ceiling Mount needs a 3.5 inch (around 89mm) circular hole in the ceiling. Cut that hole before you install the mount. A [2 in. to 7 in. adjustable hole saw](https://www.homedepot.com/p/Milwaukee-2-in-to-7-in-Black-Oxide-Adjustable-Hole-Saw-Cutter-49-56-0320/205744284) set to 3.5 inches is what we used. -###### Install in Ceiling Mount +## Install in Ceiling Mount 1\. Remove the cover to expose the inside of the installed Ceiling Mount. diff --git a/docs/products/rpro1/rpro1-reviews.md b/docs/products/rpro1/rpro1-reviews.md index b1660dce05..9d6dbba611 100755 --- a/docs/products/rpro1/rpro1-reviews.md +++ b/docs/products/rpro1/rpro1-reviews.md @@ -6,8 +6,8 @@ description: YouTuber reviews and feedback about the R PRO-1 sensor from Apollo # Simon Says Home Assistant R PRO-1 Review -# [Smart Home Scene R PRO-1 Review](https://smarthomescene.com/reviews/apollo-r-pro-1-review-dual-mmwave-presence-multisensor-with-poe-support/) +## [Smart Home Scene R PRO-1 Review](https://smarthomescene.com/reviews/apollo-r-pro-1-review-dual-mmwave-presence-multisensor-with-poe-support/) -# [MostlyChris R PRO-1 Review](https://www.youtube.com/watch?v=wVgNE8UtsAM) +## [MostlyChris R PRO-1 Review](https://www.youtube.com/watch?v=wVgNE8UtsAM) -# Pete Scargill R PRO-1 Review \ No newline at end of file +## Pete Scargill R PRO-1 Review \ No newline at end of file diff --git a/docs/products/rpro1/setup/rpro1-general-tips.md b/docs/products/rpro1/setup/rpro1-general-tips.md index fa26dd23b8..05f240fbfa 100755 --- a/docs/products/rpro1/setup/rpro1-general-tips.md +++ b/docs/products/rpro1/setup/rpro1-general-tips.md @@ -4,7 +4,7 @@ description: Multiple helpful images for mounting, lux/rgb, and gate and zone vi --- # General Tips -##### **Light Sensor (LTR-390UV)** +## **Light Sensor (LTR-390UV)** ![Probe pointing at the LTR-390UV light sensor on the R PRO-1 board next to the RGB LED](/assets/rpro-ltr-390.jpg) @@ -14,13 +14,13 @@ The R PRO-1 doesn't have any slits on the front of the case, so UV rays can't di Make sure that your automations do not interfere with each other. This includes being aware that your onboard LED can trigger the lux reading but not the uv reading of the LTR390 in your device. -##### **Wall Mounting** +## **Wall Mounting** The R PRO-1 should be mounted 1.5-2 meters off the ground which will then provide a nice even 120 degree FOV for the LD2450 and 150 degree FOV for the LD2412. ![LD2412 wall mounting diagram with the radar 1.5 to 2 m high and a 9 m range](/assets/ld2412-wall-mount-radar-cone.png) -##### **Ceiling Mounting** +## **Ceiling Mounting** The R PRO-1 should be mounted 2.6-3 meters (8-10 feet) high when mounted on the ceiling using our ceiling mount kit. @@ -48,6 +48,6 @@ The R PRO-1 should be mounted 2.6-3 meters (8-10 feet) high when mounted on the * The vertical FOV angle is -35 to 35 degrees - 70 degrees total. * Gates are pre-defined by the radar module and are in 0.75 meter increments. -##### **Gate Visualization** +## **Gate Visualization** ![LD2412 gate table listing distance in meters and feet with default move and still thresholds](/assets/ld2412-gate-visualization.png) \ No newline at end of file diff --git a/docs/products/rpro1/setup/rpro1-switch-firmware.md b/docs/products/rpro1/setup/rpro1-switch-firmware.md index eeb32889c8..fe4eda823d 100755 --- a/docs/products/rpro1/setup/rpro1-switch-firmware.md +++ b/docs/products/rpro1/setup/rpro1-switch-firmware.md @@ -10,7 +10,7 @@ description: >- Your device needs to be able to connect to the internet to switch between firmware files. If you are connecting to an IoT network on a subnet/vlan unable to access github.com then this will not work. You can also manually reflash your device serially (usb) by following our flashing guide! -###### Switch to Ethernet +## Switch to Ethernet 1\. Navigate to the ESPHome integration by going to settings -> ESPHome integration -> click on "1 device" below your Apollo R PRO-1. @@ -28,7 +28,7 @@ description: >- 5\. Your device is now on the Ethernet firmware and is ready to configure! -###### Switch to Wi-Fi +## Switch to Wi-Fi 1\. Navigate to the ESPHome integration by going to settings -> ESPHome integration -> click on "1 device" below your Apollo R PRO-1. diff --git a/docs/products/rpro1/setup/zones-ha-new.md b/docs/products/rpro1/setup/zones-ha-new.md index f319fa91f0..ecb7d33ad0 100755 --- a/docs/products/rpro1/setup/zones-ha-new.md +++ b/docs/products/rpro1/setup/zones-ha-new.md @@ -12,7 +12,7 @@ description: Tutorial for R PRO-1 Home Assistant Zone Configuration. The optional LD2412 mmWave sensor allows you to have perfect still detection for one target at up to 9 meters so it's a great addition to the sensor. -###### LD2450 Configuration +## LD2450 Configuration Manually enter in the X and Y coordinates for each zone in Home Assistant or directly from the device's webserver by visiting the IP address or hostname.local. It's much easier to tune using the HLK Radartool App and we suggest using that to set up your LD2450 instead. @@ -40,6 +40,6 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir   -###### LD2412 Configuration +## LD2412 Configuration   \ No newline at end of file diff --git a/docs/products/rpro1/setup/zones-ha.md b/docs/products/rpro1/setup/zones-ha.md index 9da17659d1..b7619768be 100755 --- a/docs/products/rpro1/setup/zones-ha.md +++ b/docs/products/rpro1/setup/zones-ha.md @@ -18,7 +18,7 @@ description: Tutorial for R PRO-1 Home Assistant Zone Configuration. Manually enter in the X and Y coordinates for each zone in Home Assistant or directly from the device's webserver by visiting the IP address or hostname.local. It's much easier to tune using the HLK Radartool App and we suggest using that to set up your R PRO-1 LD2450. -###### LD2450 Configuration +## LD2450 Configuration 1\. Install [HACS](https://hacs.xyz/docs/use/). @@ -96,7 +96,7 @@ Manually enter in the X and Y coordinates for each zone in Home Assistant or dir If your zone configurations are not saved when restarting the device then try turning on the LD2450 Bluetooth for a few seconds and then turning it off again. You can also try to toggle on Multi Target Radar. This should wake up the mmWave module and retrieve your saved zones -###### LD2412 Configuration +## LD2412 Configuration 1\. Navigate to the ESPHome integration by going to settings -> ESPHome integration -> click on "1 device" below the Apollo R PRO-1. diff --git a/docs/products/rpro1/setup/zones-hlk.md b/docs/products/rpro1/setup/zones-hlk.md index 35eaa54038..69c66d28aa 100755 --- a/docs/products/rpro1/setup/zones-hlk.md +++ b/docs/products/rpro1/setup/zones-hlk.md @@ -6,7 +6,7 @@ description: Tutorial for R PRO-1 HLKRadarTool app Zone Configuration.
-###### LD2450 Configuration +## LD2450 Configuration !!! note "Ensure that the LD2450 firmware version is V2.02.23090617 or later for proper integration functionality. " @@ -60,7 +60,7 @@ The uploading the firmware document. -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug your R PRO-1 from power and remove the back. diff --git a/docs/products/rpro1/troubleshooting/rpro1-teardown.md b/docs/products/rpro1/troubleshooting/rpro1-teardown.md index bae62ef410..a70d5b9c04 100755 --- a/docs/products/rpro1/troubleshooting/rpro1-teardown.md +++ b/docs/products/rpro1/troubleshooting/rpro1-teardown.md @@ -4,7 +4,7 @@ description: Step by step guide for tearing down your R PRO-1 to replace parts, --- # Teardown and Reassembly Of R PRO-1 -###### Disassembly: +## Disassembly: 1\. Unplug your R PRO-1 from power and remove the back. @@ -22,7 +22,7 @@ description: Step by step guide for tearing down your R PRO-1 to replace parts, ![Fingers pulling the LD2450 mmWave module off its pin header on the R PRO-1 PCB](/assets/r-pro-1-teardown-remove-ld2450.jpg) -###### Reassembly +## Reassembly 1\. Place the LD2450 on the 8 pin header. diff --git a/docs/products/temp1/battery-sensors/awake-ha-helper.md b/docs/products/temp1/battery-sensors/awake-ha-helper.md index b4be1fbaed..4b683b4871 100644 --- a/docs/products/temp1/battery-sensors/awake-ha-helper.md +++ b/docs/products/temp1/battery-sensors/awake-ha-helper.md @@ -1,4 +1,5 @@ --- +title: Keep Your Sensor Awake With HA Helper description: "How to keep your sensor awake using the Home Assistant Helper." --- --8<-- "products/general/battery-sensors/awake-ha-helper.md:5:" diff --git a/docs/products/temp1/battery-sensors/sensor-connection-check.md b/docs/products/temp1/battery-sensors/sensor-connection-check.md index 4c138fe50e..dc0b58396d 100644 --- a/docs/products/temp1/battery-sensors/sensor-connection-check.md +++ b/docs/products/temp1/battery-sensors/sensor-connection-check.md @@ -1,4 +1,5 @@ --- +title: Sensor Connection Check description: "How to check if your device is connected to Wi-Fi, Home Assistant, or nothing." --- --8<-- "products/general/battery-sensors/sensor-connection-check.md:5:" diff --git a/docs/products/temp1/battery-sensors/wake-up-battery-sensor.md b/docs/products/temp1/battery-sensors/wake-up-battery-sensor.md index 023266d9c9..e5adaf6759 100644 --- a/docs/products/temp1/battery-sensors/wake-up-battery-sensor.md +++ b/docs/products/temp1/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/products/temp1/examples/temp1-automation-examples.md b/docs/products/temp1/examples/temp1-automation-examples.md index cb8ba5fead..1a35daa3d9 100755 --- a/docs/products/temp1/examples/temp1-automation-examples.md +++ b/docs/products/temp1/examples/temp1-automation-examples.md @@ -4,7 +4,7 @@ description: Multiple automation examples with the TEMP-1. --- # Automation Examples using a TEMP-1 -###### Freezer Temperature Probe Example +## Freezer Temperature Probe Example This will guide you through how to set up an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -66,7 +66,7 @@ actions: mode: single ``` -###### Food Probe Example +## Food Probe Example This will guide you through how to set up an automation in Home Assistant using the food probe with Chicken (or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -121,7 +121,7 @@ actions: mode: single ``` -###### Cook Chicken Example +## Cook Chicken Example This will guide you through adding a button to your dashboard called "Chicken Monitor" and an automation that runs when the button is pressed! This will turn the RGB LED Green when running, message your phone when it starts and when it finishes, plus when the temperature is reached, then turn the RGB LED off. Thanks to Discord user RalphP for this! diff --git a/docs/products/temp1/reviews.md b/docs/products/temp1/reviews.md index 8aeaaaebdd..7c448be335 100755 --- a/docs/products/temp1/reviews.md +++ b/docs/products/temp1/reviews.md @@ -8,22 +8,22 @@ description: YouTuber reviews and feedback about the TEMP-1 sensor from Apollo A   -# [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti) +## [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti)
  -# [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/) +## [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/)   -# [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W) +## [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W)
  -# [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0) +## [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0)
\ No newline at end of file diff --git a/docs/products/temp1/setup/temp1-general-tips.md b/docs/products/temp1/setup/temp1-general-tips.md index 884b3c5998..bb9c9b180a 100755 --- a/docs/products/temp1/setup/temp1-general-tips.md +++ b/docs/products/temp1/setup/temp1-general-tips.md @@ -8,10 +8,10 @@ description: >- The TEMP-1 has an optional Dallas temperature probe (long or short variants) and an optional food-safe probe. -###### Physical Buffered Temperature +## Physical Buffered Temperature For accurate vaccine storage monitoring, the CDC recommends using buffered temperature probes—a principle the Dallas temperature probe can follow using a glycol or glass bead vial. Buffering mimics the thermal behavior of stored vaccines, filtering out brief air temp fluctuations (e.g., door openings) that don’t reflect true vaccine exposure. This results in more reliable, regulation-aligned readings when using Dallas sensors like the DS18B20 in a buffered medium. You can also achieve better results by just placing the probe inside a bottle of water (for the fridge not freezer). -###### Virtual Temperature Buffering +## Virtual Temperature Buffering Instead of placing your Dallas temperature probe (like a DS18B20) in a vial of glycol or glass beads to mimic how vaccines warm up or cool down, you can use a software method called **Virtual Temperature Buffering**. It filters out quick air temperature changes—like when you open the fridge door—and gives a more stable, realistic reading similar to a physical buffer. This means you get accurate, regulation-friendly temps without needing messy liquids or bulky containers. \ No newline at end of file diff --git a/docs/products/temp1/troubleshooting/temp1-boot-mode.md b/docs/products/temp1/troubleshooting/temp1-boot-mode.md index b34bf40ebb..1beb60a6ab 100755 --- a/docs/products/temp1/troubleshooting/temp1-boot-mode.md +++ b/docs/products/temp1/troubleshooting/temp1-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The TEMP-1 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the TEMP-1 so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. @@ -24,7 +24,7 @@ If you prefer, please remove the lid by gently prying up on the small slit by th 3\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/products/temp1/troubleshooting/temp1-code/). -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and remove the case as shown in the images above diff --git a/docs/products/temp1b/battery-sensors/awake-ha-helper.md b/docs/products/temp1b/battery-sensors/awake-ha-helper.md index b4be1fbaed..4b683b4871 100644 --- a/docs/products/temp1b/battery-sensors/awake-ha-helper.md +++ b/docs/products/temp1b/battery-sensors/awake-ha-helper.md @@ -1,4 +1,5 @@ --- +title: Keep Your Sensor Awake With HA Helper description: "How to keep your sensor awake using the Home Assistant Helper." --- --8<-- "products/general/battery-sensors/awake-ha-helper.md:5:" diff --git a/docs/products/temp1b/battery-sensors/sensor-connection-check.md b/docs/products/temp1b/battery-sensors/sensor-connection-check.md index 4c138fe50e..dc0b58396d 100644 --- a/docs/products/temp1b/battery-sensors/sensor-connection-check.md +++ b/docs/products/temp1b/battery-sensors/sensor-connection-check.md @@ -1,4 +1,5 @@ --- +title: Sensor Connection Check description: "How to check if your device is connected to Wi-Fi, Home Assistant, or nothing." --- --8<-- "products/general/battery-sensors/sensor-connection-check.md:5:" diff --git a/docs/products/temp1b/battery-sensors/wake-up-battery-sensor.md b/docs/products/temp1b/battery-sensors/wake-up-battery-sensor.md index 023266d9c9..e5adaf6759 100644 --- a/docs/products/temp1b/battery-sensors/wake-up-battery-sensor.md +++ b/docs/products/temp1b/battery-sensors/wake-up-battery-sensor.md @@ -1,4 +1,5 @@ --- +title: How To Wake Up Your Sensor description: "How to wake up your Apollo device which is currently sleeping." --- --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:" diff --git a/docs/products/temp1b/examples/temp1b-automation-examples.md b/docs/products/temp1b/examples/temp1b-automation-examples.md index ffa9635304..7fa9be146a 100755 --- a/docs/products/temp1b/examples/temp1b-automation-examples.md +++ b/docs/products/temp1b/examples/temp1b-automation-examples.md @@ -4,7 +4,7 @@ description: Multiple automation examples with the TEMP-1B. --- # Automation Examples using a TEMP-1B -###### Freezer Temperature Probe Example +## Freezer Temperature Probe Example This will guide you through how to set up an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -66,7 +66,7 @@ actions: mode: single ``` -###### Food Probe Example +## Food Probe Example This will guide you through how to set up an automation in Home Assistant using the food probe with Chicken (or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -121,7 +121,7 @@ actions: mode: single ``` -###### Cook Chicken Example +## Cook Chicken Example This will guide you through adding a button to your dashboard called "Chicken Monitor" and an automation that runs when the button is pressed! This will turn the RGB LED Green when running, message your phone when it starts and when it finishes, plus when the temperature is reached, then turn the RGB LED off. Thanks to Discord user RalphP for this! diff --git a/docs/products/temp1b/reviews.md b/docs/products/temp1b/reviews.md index 7eba564dbb..0d5b9bfbfe 100755 --- a/docs/products/temp1b/reviews.md +++ b/docs/products/temp1b/reviews.md @@ -8,22 +8,22 @@ description: YouTuber reviews and feedback about the TEMP-1B sensor from Apollo   -# [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti) +## [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti)
  -# [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/) +## [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/)   -# [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W) +## [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W)
  -# [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0) +## [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0)
\ No newline at end of file diff --git a/docs/products/temp1b/setup/getting-started-temp1.md b/docs/products/temp1b/setup/getting-started-temp1.md index 3bf2f82d6e..4fd0d4228d 100644 --- a/docs/products/temp1b/setup/getting-started-temp1.md +++ b/docs/products/temp1b/setup/getting-started-temp1.md @@ -1,4 +1,5 @@ --- +title: Getting Started description: "Generic getting started article." --- --8<-- "products/general/setup/getting-started.md:5:" diff --git a/docs/products/temp1b/setup/temp1-general-tips.md b/docs/products/temp1b/setup/temp1-general-tips.md index 82fc08d105..3adb8932c4 100644 --- a/docs/products/temp1b/setup/temp1-general-tips.md +++ b/docs/products/temp1b/setup/temp1-general-tips.md @@ -1,4 +1,5 @@ --- -description: ">-" +title: General Tips +description: General tips for the TEMP-1 device and suggestions for improving the usability of the temp and food probe sensor. --- --8<-- "products/temp1/setup/temp1-general-tips.md:7:" diff --git a/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md b/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md index 4027f9365b..df52384215 100755 --- a/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md +++ b/docs/products/temp1b/troubleshooting/temp1b-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The TEMP-1B In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the TEMP-1B so that the USB-C port is facing you. On the right side of the device, locate a small opening where you can use a paperclip to press the boot button. @@ -24,7 +24,7 @@ If you prefer, please remove the lid by gently prying up on the small slit by th 3\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/products/temp1b/troubleshooting/temp1b-code/). -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and remove the case as shown in the images above diff --git a/docs/products/temppro1/examples/temp1-automation-examples.md b/docs/products/temppro1/examples/temp1-automation-examples.md index 3dcfee4687..938327c916 100755 --- a/docs/products/temppro1/examples/temp1-automation-examples.md +++ b/docs/products/temppro1/examples/temp1-automation-examples.md @@ -4,7 +4,7 @@ description: Multiple automation examples with the TEMP-1. --- # Automation Examples using a TEMP-1 -###### Freezer Temperature Probe Example +## Freezer Temperature Probe Example This will guide you through how to set up an automation in Home Assistant using the temperature probe in your freezer! At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -66,7 +66,7 @@ actions: mode: single ``` -###### Food Probe Example +## Food Probe Example This will guide you through how to set up an automation in Home Assistant using the food probe with Chicken (or anything) cooking to 165°F(73.9C). At the end, you will have an automation that sends your phone a notification when your temp is exceeded. @@ -121,7 +121,7 @@ actions: mode: single ``` -###### Cook Chicken Example +## Cook Chicken Example This will guide you through adding a button to your dashboard called "Chicken Monitor" and an automation that runs when the button is pressed! This will turn the RGB LED Green when running, message your phone when it starts and when it finishes, plus when the temperature is reached, then turn the RGB LED off. Thanks to Discord user RalphP for this! diff --git a/docs/products/temppro1/reviews.md b/docs/products/temppro1/reviews.md index d5439c23e8..0a84601755 100755 --- a/docs/products/temppro1/reviews.md +++ b/docs/products/temppro1/reviews.md @@ -12,22 +12,22 @@ These Reviews need to be swapped for new ones   -# [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti) +## [Digiblur DIY](https://youtu.be/HhyBVV27sqM?si=klFlZ5TAtmob88ti)
  -# [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/) +## [Smart Home Scene](https://smarthomescene.com/reviews/apollo-temp-1-probe-temperature-sensor-review/)   -# [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W) +## [Smart Home Solver](https://youtu.be/OWiPaKARNcU?si=5fCiOV4kA2KZ5i6W)
  -# [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0) +## [Michael Leen](https://youtu.be/FJjD0iZZhHY?si=pkQlUNpIASznIeD0)
\ No newline at end of file diff --git a/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md b/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md index fb25fe7acf..ec6f4c6b30 100755 --- a/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md +++ b/docs/products/temppro1/troubleshooting/temp-pro1-boot-mode.md @@ -8,7 +8,7 @@ description: Step by step guide for putting The TEMP Pro-1 In Boot Mode. This is needed to force the device into boot mode to reflash the firmware. -##### Method 1: Boot Button Only +## Method 1: Boot Button Only 1\. Position the TEMP Pro-1 so that the USB-C port is facing you. Remove the lid by gently prying up on the small slit by the top of the case. @@ -22,7 +22,7 @@ description: Step by step guide for putting The TEMP Pro-1 In Boot Mode. 3\. Continue with [uploading the firmware document](https://wiki.apolloautomation.com/products/temppro1/troubleshooting/temp-pro1-code/). -##### Method 2: Boot and Reset Buttons +## Method 2: Boot and Reset Buttons 1\. Unplug the device and remove the case as shown in the images above From 12130b9a8ef7bffa7b20dbc9000cc497b8ed123a Mon Sep 17 00:00:00 2001 From: Justin Bunton <130115204+Bunton33@users.noreply.github.com> Date: Mon, 12 Oct 2026 06:31:44 -0400 Subject: [PATCH 4/4] docs: alphabetize nav groups and use one section order per product Nav only: no page is added, removed, or moved to a new URL. All 736 entries are kept (checked by script). - One section order for every product, in both the Home Assistant and Homey trees: Introduction, FAQ, Getting Started, setup groups, Additional Info, Addons, Examples, Troubleshooting, Reviews. Reviews moved to the end on 9 products; Addons now precede Examples on M-1. - Homey MTR-1 Zone Configuration and Homey MSR-2 Radar Tuning move out of Additional Info to sit after Getting Started, as they do in the Home Assistant tree and for Homey R PRO-1. - Products within a category are alphabetical (mmWave: MSR-1, MSR-2, MTR-1, R PRO-1). - Items within Additional Info, Addons, Examples, Troubleshooting, Battery Sensors, Calibrating, and Example Flows are alphabetical, with General Tips and Sensor Definitions kept first. Sequential sections (Getting Started, ESPHome Starter Kit lessons, Zone Configuration's Good/Better/Best) keep their order. - Labels: PLT-1B troubleshooting entries said "PLT-1" (6 entries, both trees); WiFi -> Wi-Fi (3); Unifi -> UniFi (2). Co-Authored-By: Claude Opus 5.5 --- mkdocs.yml | 334 ++++++++++++++++++++++++++--------------------------- 1 file changed, 167 insertions(+), 167 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index b9b96add06..106101073d 100755 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -197,11 +197,14 @@ nav: - FAQ: products/general/faq.md - Getting Started: products/general/setup/getting-started.md - Additional Info: + - Adding SCD40 Temp/Hum: products/general/setup/how-to-add-temp-and-humidity-from-scd40.md + - Adjusting Wi-Fi Power: products/general/setup/adjusting-wifi-power.md + - Bluetooth Proxy: products/general/setup/bluetooth-proxy.md + - Bluetooth Tracking: products/general/setup/bluetooth-tracking.md - Calibrating: + - Calibrate PLT-1 Soil Moisture: products/general/calibrating-and-updating/calibrate-plt1.md - CO2: products/general/calibrating-and-updating/co2-calibration.md - CO2 Quick: products/general/calibrating-and-updating/co2-calibration-quick.md - - Temperature and Humidity: products/general/temp-hum-calibration.md - - Calibrate PLT-1 Soil Moisture: products/general/calibrating-and-updating/calibrate-plt1.md - Radar Tuning: - (Best) Apollo mmWave Dashboard: - Setup: products/general/setup/apollo-mmwave-dashboard-setup.md @@ -209,36 +212,33 @@ nav: - Home Assistant: products/general/calibrating-and-updating/radar-tuning/zones-ha.md - HLK Radar Tool App: products/general/calibrating-and-updating/radar-tuning/zones-hlk.md - mmWave Tuning Videos: products/general/calibrating-and-updating/mmwave-videos.md + - Temperature and Humidity: products/general/temp-hum-calibration.md - Zone Configuration: - (Best) Apollo mmWave Dashboard: /products/general/setup/apollo-mmwave-dashboard/#draw-zones-on-the-r-pro-1-and-mtr-1 - (Good) Home Assistant: products/general/calibrating-and-updating/zone-configuration/zones-ha.md - (Better) HLK Radar Tool App: products/general/calibrating-and-updating/zone-configuration/zones-hlk.md - (Better) Zone Mapper Tool: products/general/calibrating-and-updating/zone-configuration/zone-mapper-tool.md - - Updating: products/general/calibrating-and-updating/updating-firmware.md - - Renaming Devices: products/general/setup/renaming-apollo-devices.md - - Change Update Frequency: products/general/setup/change-the-update-frequency-of-sensors.md - - Change Lux Update Interval: products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md - Change CO2 Update Interval: products/general/tutorials/change-co2-update-interval.md + - Change Lux Update Interval: products/general/tutorials/how-to-edit-your-sensor's-lux-update-interval.md + - Change Update Frequency: products/general/setup/change-the-update-frequency-of-sensors.md + - Hidden Wi-Fi Networks: products/general/setup/adding-apollo-devices-to-hidden-networks.md - Minimize mmWave Activity Spam: products/general/tutorials/minimize-mmwave-activity-spam.md - - SmartThings Direct Control: products/general/tutorials/smartthings-direct-control.md - - Adding SCD40 Temp/Hum: products/general/setup/how-to-add-temp-and-humidity-from-scd40.md - - Adjusting WiFi Power: products/general/setup/adjusting-wifi-power.md - - Hidden WiFi Networks: products/general/setup/adding-apollo-devices-to-hidden-networks.md - - Bluetooth Proxy: products/general/setup/bluetooth-proxy.md - - Bluetooth Tracking: products/general/setup/bluetooth-tracking.md - Piezo Buzzer: products/general/piezo.md + - Renaming Devices: products/general/setup/renaming-apollo-devices.md + - SmartThings Direct Control: products/general/tutorials/smartthings-direct-control.md - Switch to Beta: products/general/setup/switch-to-beta-branch.md + - Updating: products/general/calibrating-and-updating/updating-firmware.md - Troubleshooting: - - Removing Devices: products/general/troubleshooting/removing-device-from-home-assistant.md - Connection Issues: products/general/troubleshooting/connection-issues.md - Firmware Updates Not Appearing: products/general/troubleshooting/firmware-updates-not-appearing.md - - Unifi Auto Discover Device mDNS Issue: products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md - OPNsense Auto Discover Device mDNS Issue: products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md + - Removing Devices: products/general/troubleshooting/removing-device-from-home-assistant.md + - UniFi Auto Discover Device mDNS Issue: products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md - Battery Sensors: - How To Wake Up Your Sensor: products/general/battery-sensors/wake-up-battery-sensor.md - Keep Your Sensor Awake With HA Helper: products/general/battery-sensors/awake-ha-helper.md - - Sensor Connection Check: products/general/battery-sensors/sensor-connection-check.md - Prevent Sleep: products/general/battery-sensors/prevent-sleep.md + - Sensor Connection Check: products/general/battery-sensors/sensor-connection-check.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 @@ -252,15 +252,15 @@ nav: - General Tips: products/btn1/setup/general-tips.md - Sensor Definitions: products/btn1/setup/sensor-definitions.md - Bluetooth Proxy: products/btn1/additional-info/bluetooth-proxy.md - - Prevent Sleep: products/btn1/additional-info/prevent-sleep.md - How To Wake Up Your Sensor: products/btn1/battery-sensors/wake-up-battery-sensor.md + - Prevent Sleep: products/btn1/additional-info/prevent-sleep.md - Examples: - Blueprint: products/btn1/examples/blueprint.md - Troubleshooting: - BTN-1 Boot Mode: products/btn1/troubleshooting/btn1-boot-mode.md - Factory Re-Flash BTN-1: products/btn1/troubleshooting/btn1-reflash.md - - Teardown and Reassembly Of BTN-1: products/btn1/troubleshooting/btn1-teardown.md - Reset Wi-Fi Credentials: products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of BTN-1: products/btn1/troubleshooting/btn1-teardown.md - CAST-1: - Introduction: products/cast1/introduction.md - FAQ: products/cast1/faq.md @@ -295,14 +295,14 @@ nav: - Additional Info: - General Tips: products/air1/setup/general-tips.md - Sensor Definitions: products/air1/setup/sensor-definitions.md - - Prevent Sleep: products/air1/additional-info/prevent-sleep.md + - Bluetooth Proxy: products/air1/additional-info/bluetooth-proxy.md - LED Indicator: products/air1/additional-info/led-indicator.md - Predicted Temp & Humidity: products/air1/additional-info/predicted-room-temp-humidity.md - - Bluetooth Proxy: products/air1/additional-info/bluetooth-proxy.md + - Prevent Sleep: products/air1/additional-info/prevent-sleep.md - Addons: - CO2 Addon: products/air1/addons/adding-co2-to-air-1.md - - MiCS Addon: products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md - GPIO Addon: products/air1/addons/adding-gpio-header-to-air-1.md + - MiCS Addon: products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md - Examples: - Air Quality Dashboard: products/air1/examples/air1-dashboard-examples.md - Firstof9's Apex Charts: products/air1/examples/firstof9's-apex-charts.md @@ -310,8 +310,8 @@ nav: - Troubleshooting: - AIR-1 Boot Mode: products/air1/troubleshooting/air1-boot-mode.md - Factory Re-Flash AIR-1: products/air1/troubleshooting/air1-code.md - - Teardown and Reassembly Of AIR-1: products/air1/troubleshooting/air1-teardown.md - Reset Wi-Fi Credentials: products/air1/troubleshooting/air1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of AIR-1: products/air1/troubleshooting/air1-teardown.md - Reviews: products/air1/air1-reviews.md - TEMP-1: - Introduction: products/temp1/introduction.md @@ -320,27 +320,27 @@ nav: - Additional Info: - General Tips: products/temp1/setup/temp1-general-tips.md - Sensor Definitions: products/temp1/setup/temp1-sensor-definitions.md + - Bluetooth Proxy: products/temp1/additional-info/bluetooth-proxy.md - Change Temp Probe Update Interval: products/temp1/setup/temp1-change-temp-probe-update-interval.md - - Prevent Sleep: products/temp1/additional-info/prevent-sleep.md - How To Wake Up Your Sensor: products/temp1/battery-sensors/wake-up-battery-sensor.md - Keep Your Sensor Awake With HA Helper: products/temp1/battery-sensors/awake-ha-helper.md + - Prevent Sleep: products/temp1/additional-info/prevent-sleep.md - Sensor Connection Check: products/temp1/battery-sensors/sensor-connection-check.md - - Bluetooth Proxy: products/temp1/additional-info/bluetooth-proxy.md - Addons: - - Magnetic Mount: products/temp1/addons/magnetic-mount.md - - Temp Probe: products/temp1/addons/temp-probe.md - Food Probe: products/temp1/addons/food-probe.md + - Magnetic Mount: products/temp1/addons/magnetic-mount.md - Multi-Probe Splitter: products/temp1/addons/multiple-probes.md + - Temp Probe: products/temp1/addons/temp-probe.md - Examples: - Alert Outside Range: products/temp1/examples/temp1-alert-example.md - - Use Cases: products/temp1/examples/use-cases.md - Automations: products/temp1/examples/temp1-automation-examples.md - Hot Water Recirculation: products/temp1/examples/hot-water-recirculation.md + - Use Cases: products/temp1/examples/use-cases.md - Troubleshooting: - - TEMP-1 Boot Mode: products/temp1/troubleshooting/temp1-boot-mode.md - Factory Re-Flash TEMP-1: products/temp1/troubleshooting/temp1-code.md - - Teardown and Reassembly Of TEMP-1: products/temp1/troubleshooting/temp1-teardown.md - Reset Wi-Fi Credentials: products/temp1/troubleshooting/temp1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of TEMP-1: products/temp1/troubleshooting/temp1-teardown.md + - TEMP-1 Boot Mode: products/temp1/troubleshooting/temp1-boot-mode.md - Reviews: products/temp1/reviews.md - TEMP-1B: - Introduction: products/temp1b/introduction.md @@ -349,27 +349,27 @@ nav: - Additional Info: - General Tips: products/temp1b/setup/temp1-general-tips.md - Sensor Definitions: products/temp1b/setup/temp1b-sensor-definitions.md - - Prevent Sleep: products/temp1b/additional-info/prevent-sleep.md + - Bluetooth Proxy: products/temp1b/additional-info/bluetooth-proxy.md - How To Wake Up Your Sensor: products/temp1b/battery-sensors/wake-up-battery-sensor.md - - Keep Your Sensor Awake With HA Helper: products/temp1b/battery-sensors/awake-ha-helper.md - Insert Battery: products/temp1b/setup/insert-battery.md + - Keep Your Sensor Awake With HA Helper: products/temp1b/battery-sensors/awake-ha-helper.md + - Prevent Sleep: products/temp1b/additional-info/prevent-sleep.md - Sensor Connection Check: products/temp1b/battery-sensors/sensor-connection-check.md - - Bluetooth Proxy: products/temp1b/additional-info/bluetooth-proxy.md - Addons: - - Magnetic Mount: products/temp1b/addons/magnetic-mount.md - - Temp Probe: products/temp1b/addons/temp-probe.md - Food Probe: products/temp1b/addons/food-probe.md + - Magnetic Mount: products/temp1b/addons/magnetic-mount.md - Multi-Probe Splitter: products/temp1b/addons/multiple-probes.md + - Temp Probe: products/temp1b/addons/temp-probe.md - Examples: - Alert Outside Range: products/temp1b/examples/temp1b-alert-example.md - - Use Cases: products/temp1b/examples/use-cases.md - Automations: products/temp1b/examples/temp1b-automation-examples.md - Hot Water Recirculation: products/temp1b/examples/hot-water-recirculation.md + - Use Cases: products/temp1b/examples/use-cases.md - Troubleshooting: - - TEMP-1B Boot Mode: products/temp1b/troubleshooting/temp1b-boot-mode.md - Factory Re-Flash TEMP-1B: products/temp1b/troubleshooting/temp1b-code.md - - Teardown and Reassembly Of TEMP-1B: products/temp1b/troubleshooting/temp1b-teardown.md - Reset Wi-Fi Credentials: products/temp1b/troubleshooting/temp1b-reset-wi-fi-credentials.md + - Teardown and Reassembly Of TEMP-1B: products/temp1b/troubleshooting/temp1b-teardown.md + - TEMP-1B Boot Mode: products/temp1b/troubleshooting/temp1b-boot-mode.md - Reviews: products/temp1b/reviews.md - ESPHome Starter Kit: - Start Here: products/ESPHome-Starter-Kit/start-here.md @@ -421,24 +421,24 @@ nav: - Getting Started: products/h1/getting-started.md - Additional Info: - How To Wake Up Your Sensor: products/h1/battery-sensors/wake-up-battery-sensor.md - - Reviews: products/h1/reviews.md - Examples: - Holiday Songs: products/general/holiday-songs.md - Troubleshooting: - - H-1 Boot Mode: products/h1/boot-mode.md - Factory Re-Flash H-1: products/h1/reflash.md + - H-1 Boot Mode: products/h1/boot-mode.md + - Reviews: products/h1/reviews.md - H-2: - Introduction: products/h2/introduction.md - FAQ: products/h2/faq.md - Getting Started: products/h2/setup/getting-started.md - Additional Info: - How To Wake Up Your Sensor: products/h2/battery-sensors/wake-up-battery-sensor.md - - Reviews: products/h2/h2-reviews.md - Examples: - Holiday Songs: products/h2/examples/holiday-songs.md - Troubleshooting: - - H-2 Boot Mode: products/h2/troubleshooting/boot-mode.md - Factory Re-Flash H-2: products/h2/troubleshooting/reflash.md + - H-2 Boot Mode: products/h2/troubleshooting/boot-mode.md + - Reviews: products/h2/h2-reviews.md - M-1 (LED Matrix): - Introduction: products/m1/introduction.md - FAQ: products/m1/faq.md @@ -450,23 +450,23 @@ nav: - Multiple Panels: products/m1/setup/m1-multiple-panels.md - Segments: products/m1/setup/m1-segments.md - Additional Info: - - Wall Mounting your Panels: products/m1/setup/m1-wall-mounting.md - - Use Without Wi-Fi: products/m1/setup/use-without-wifi.md - General Tips: products/m1/setup/m1-general-tips.md + - Use Without Wi-Fi: products/m1/setup/use-without-wifi.md + - Wall Mounting your Panels: products/m1/setup/m1-wall-mounting.md + - Addons: + - Microphone: products/m1/addons/adding-microphone-to-m-1.md + - WizMote Remote: products/m1/addons/wizmote-remote.md - Examples: - - Pixel Forge: products/m1/examples/pixel-forge.md - Add GIFs: products/m1/examples/add-gifs-to-wled.md - - Scrolling Text: products/m1/examples/scrolling-text.md + - Pixel Forge: products/m1/examples/pixel-forge.md - QR Code Generator: products/m1/examples/qr-code-generator.md + - Scrolling Text: products/m1/examples/scrolling-text.md - Share Data From Home Assistant: products/m1/examples/share-data-from-home-assistant.md - - Addons: - - Microphone: products/m1/addons/adding-microphone-to-m-1.md - - WizMote Remote: products/m1/addons/wizmote-remote.md - Troubleshooting: - - Panel Troubleshooting: products/m1/troubleshooting/m1-panel-faults.md - - M-1 Boot Mode: products/m1/troubleshooting/m1-boot-mode.md - Factory Re-Flash M-1: products/m1/troubleshooting/m1-reflash.md - Find IP and Hostname: products/m1/troubleshooting/m1-find-ip-address-and-hostname.md + - M-1 Boot Mode: products/m1/troubleshooting/m1-boot-mode.md + - Panel Troubleshooting: products/m1/troubleshooting/m1-panel-faults.md - Using ESPHome: - Set Up ESPHome: products/m1/setup/getting-started-m1-esphome.md - Reflash: products/m1/troubleshooting/m1-reflash-esphome.md @@ -475,6 +475,32 @@ nav: - SendSpin: products/m1/examples/sendspin.md - Reviews: products/m1/m1-reviews.md - mmWave Sensors: + - MSR-1: + - Introduction: products/msr1/introduction.md + - FAQ: products/msr1/faq.md + - Getting Started: products/general/setup/getting-started-msr1.md + - Additional Info: + - General Tips: products/msr1/setup/general-tips.md + - Sensor Definitions: products/msr1/setup/sensor-definitions.md + - Bluetooth Proxy: products/msr1/additional-info/bluetooth-proxy.md + - Exposed GPIO: products/msr1/additional-info/exposed-gpio.md + - Radar Tuning: + - (Best) Apollo mmWave Dashboard: + - Setup: products/msr1/setup/apollo-mmwave-dashboard-setup.md + - Calibrate and Tune: products/msr1/setup/apollo-mmwave-dashboard.md + - Home Assistant: products/msr1/setup/zones-ha.md + - HLK Radar Tool App: products/msr1/setup/zones-hlk.md + - mmWave Tuning Videos: products/msr1/setup/mmwave-videos.md + - Addons: products/msr1/addons/adding-co2-to-msr-1.md + - Examples: + - MSR-1 Alarmo: products/msr1/examples/msr1-alarmo.md + - MSR-1 Dashboards: products/msr1/examples/msr1-dashboards.md + - Troubleshooting: + - Factory Re-Flash MSR-1: products/msr1/troubleshooting/msr1-code.md + - MSR-1 Boot Mode: products/msr1/troubleshooting/msr1-boot-mode.md + - Reset Wi-Fi Credentials: products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of MSR-1: products/msr1/troubleshooting/msr1-teardown.md + - Reviews: products/msr1/msr1-reviews.md - MSR-2: - Introduction: products/msr2/introduction.md - FAQ: products/msr2/faq.md @@ -492,20 +518,20 @@ nav: - Sensor Definitions: products/msr2/setup/msr2-sensor-definitions.md - Bluetooth Proxy: products/msr2/additional-info/bluetooth-proxy.md - Addons: + - 90 Degree Addon: products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md - Articulating Stand: products/msr2/addons/adding-articulating-stand-to-msr-2.md - CO2 Addon: products/msr2/addons/adding-co2-to-msr-2.md - Female Rear USB-C: products/msr2/addons/adding-rear-female-usb-to-msr-2.md - GPIO Addon: products/msr2/addons/adding-gpio-header-to-msr-2.md - Outlet Mount: products/msr2/addons/msr2-outlet-mount.md - - 90 Degree Addon: products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md - Examples: - - MSR-2 Alarmo: products/msr2/examples/msr2-alarmo.md - GPIO Header LED Strip: products/msr2/examples/gpio-header-control-an-led-strip.md + - MSR-2 Alarmo: products/msr2/examples/msr2-alarmo.md - Troubleshooting: - - MSR-2 Boot Mode: products/msr2/troubleshooting/msr2-boot-mode.md - Factory Re-Flash MSR-2: products/msr2/troubleshooting/msr2-code.md - - Teardown and Reassembly Of MSR-2: products/msr2/troubleshooting/msr2-teardown.md + - MSR-2 Boot Mode: products/msr2/troubleshooting/msr2-boot-mode.md - Reset Wi-Fi Credentials: products/msr2/troubleshooting/msr2-reset-wi-fi-credentials.md + - Teardown and Reassembly Of MSR-2: products/msr2/troubleshooting/msr2-teardown.md - Reviews: products/msr2/msr2-reviews.md - MTR-1: - Introduction: products/mtr1/introduction.md @@ -523,19 +549,19 @@ nav: - Sensor Definitions: products/mtr1/setup/sensor-definitions.md - Bluetooth Proxy: products/mtr1/additional-info/bluetooth-proxy.md - Addons: + - 90 Degree Addon: products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md - Articulating Stand: products/mtr1/addons/adding-articulating-stand-to-mtr-1.md - CO2 Addon: products/mtr1/addons/adding-co2-to-mtr-1.md - - Male Rear USB-C: products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md - GPIO Addon: products/mtr1/addons/adding-gpio-header-to-mtr-1.md - - 90 Degree Addon: products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md + - Male Rear USB-C: products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md - Examples: - - MTR-1 Corner Mount: products/mtr1/examples/crookedtoe-mtr1.md - MTR-1 Alarmo: products/mtr1/examples/mtr1-alarmo.md + - MTR-1 Corner Mount: products/mtr1/examples/crookedtoe-mtr1.md - Troubleshooting: - - MTR-1 Boot Mode: products/mtr1/troubleshooting/mtr1-boot-mode.md - Factory Re-Flash MTR-1: products/mtr1/troubleshooting/mtr1-code.md - - Teardown and Reassembly Of MTR-1: products/mtr1/troubleshooting/mtr1-teardown.md + - MTR-1 Boot Mode: products/mtr1/troubleshooting/mtr1-boot-mode.md - Reset Wi-Fi Credentials: products/mtr1/troubleshooting/mtr1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of MTR-1: products/mtr1/troubleshooting/mtr1-teardown.md - Reviews: products/mtr1/mtr1-reviews.md - R PRO-1: - Introduction: products/rpro1/introduction.md @@ -549,47 +575,21 @@ nav: - (Better) HLK Radar Tool App: products/rpro1/setup/zones-hlk.md - (Better) Zone Mapper Tool: products/rpro1/setup/r-pro-1-zone-mapper-tool.md - Additional Info: - - Switch Firmware: products/rpro1/setup/rpro1-switch-firmware.md - General Tips: products/rpro1/setup/rpro1-general-tips.md - Sensor Definitions: products/rpro1/setup/rpro1-sensor-definitions.md - Bluetooth Proxy: products/rpro1/additional-info/bluetooth-proxy.md + - Switch Firmware: products/rpro1/setup/rpro1-switch-firmware.md - Addons: - - CO2 Addon: products/rpro1/addons/adding-co2-to-r-pro-1.md - 1-Gang Box Mount: products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md - Ceiling Mount: products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md + - CO2 Addon: products/rpro1/addons/adding-co2-to-r-pro-1.md - LD2412 Addon: products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md - Troubleshooting: - - R PRO-1 Boot Mode: products/rpro1/troubleshooting/rpro1-boot-mode.md - Factory Re-Flash R PRO-1: products/rpro1/troubleshooting/rpro1-code.md - - Teardown and Reassembly Of R PRO-1: products/rpro1/troubleshooting/rpro1-teardown.md + - R PRO-1 Boot Mode: products/rpro1/troubleshooting/rpro1-boot-mode.md - Reset Wi-Fi Credentials: products/rpro1/troubleshooting/rpro1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of R PRO-1: products/rpro1/troubleshooting/rpro1-teardown.md - Reviews: products/rpro1/rpro1-reviews.md - - MSR-1: - - Introduction: products/msr1/introduction.md - - FAQ: products/msr1/faq.md - - Getting Started: products/general/setup/getting-started-msr1.md - - Additional Info: - - General Tips: products/msr1/setup/general-tips.md - - Sensor Definitions: products/msr1/setup/sensor-definitions.md - - Radar Tuning: - - (Best) Apollo mmWave Dashboard: - - Setup: products/msr1/setup/apollo-mmwave-dashboard-setup.md - - Calibrate and Tune: products/msr1/setup/apollo-mmwave-dashboard.md - - Home Assistant: products/msr1/setup/zones-ha.md - - HLK Radar Tool App: products/msr1/setup/zones-hlk.md - - mmWave Tuning Videos: products/msr1/setup/mmwave-videos.md - - Exposed GPIO: products/msr1/additional-info/exposed-gpio.md - - Bluetooth Proxy: products/msr1/additional-info/bluetooth-proxy.md - - Addons: products/msr1/addons/adding-co2-to-msr-1.md - - Examples: - - MSR-1 Dashboards: products/msr1/examples/msr1-dashboards.md - - MSR-1 Alarmo: products/msr1/examples/msr1-alarmo.md - - Troubleshooting: - - MSR-1 Boot Mode: products/msr1/troubleshooting/msr1-boot-mode.md - - Factory Re-Flash MSR-1: products/msr1/troubleshooting/msr1-code.md - - Teardown and Reassembly Of MSR-1: products/msr1/troubleshooting/msr1-teardown.md - - Reset Wi-Fi Credentials: products/msr1/troubleshooting/msr1-reset-wi-fi-credentials.md - - Reviews: products/msr1/msr1-reviews.md - Plant Sensors: - PLT-1: - Introduction: products/plt1/introduction.md @@ -598,17 +598,17 @@ nav: - Additional Info: - General Tips: products/plt1/general-tips.md - Sensor Definitions: products/plt1/setup/plt1-sensor-definitions.md + - Bluetooth Proxy: products/plt1/additional-info/bluetooth-proxy.md - Calibrating Soil Moisture: products/plt1/calibrate-plt1.md - Prevent Sleep: products/plt1/additional-info/prevent-sleep.md - - Bluetooth Proxy: products/plt1/additional-info/bluetooth-proxy.md - Examples: - - Flower Card: products/plt1/examples/flower-card.md - Blueprint: products/plt1/examples/blueprint.md + - Flower Card: products/plt1/examples/flower-card.md - Troubleshooting: - - PLT-1 Boot Mode: products/plt1/troubleshooting/plt1-boot-mode.md - Factory Re-Flash PLT-1: products/plt1/troubleshooting/plt1-code.md - - Teardown and Reassembly Of PLT-1: products/plt1/troubleshooting/plt1-teardown.md + - PLT-1 Boot Mode: products/plt1/troubleshooting/plt1-boot-mode.md - Reset Wi-Fi Credentials: products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of PLT-1: products/plt1/troubleshooting/plt1-teardown.md - Reviews: products/plt1/reviews.md - PLT-1B: - Introduction: products/plt1b/introduction.md @@ -617,21 +617,21 @@ nav: - Additional Info: - General Tips: products/plt1b/general-tips.md - Sensor Definitions: products/plt1b/setup/plt1b-sensor-definitions.md + - Bluetooth Proxy: products/plt1b/additional-info/bluetooth-proxy.md - Calibrating Soil Moisture: products/plt1b/calibrate-plt1.md - - Prevent Sleep: products/plt1b/additional-info/prevent-sleep.md - How To Wake Up Your Sensor: products/plt1b/battery-sensors/wake-up-battery-sensor.md - - Keep Your Sensor Awake With HA Helper: products/plt1b/battery-sensors/awake-ha-helper.md - Insert Battery: products/plt1b/additional-info/insert-battery.md + - Keep Your Sensor Awake With HA Helper: products/plt1b/battery-sensors/awake-ha-helper.md + - Prevent Sleep: products/plt1b/additional-info/prevent-sleep.md - Sensor Connection Check: products/plt1b/battery-sensors/sensor-connection-check.md - - Bluetooth Proxy: products/plt1b/additional-info/bluetooth-proxy.md - Examples: - - Flower Card: products/plt1b/examples/flower-card.md - Blueprint: products/plt1b/examples/blueprint.md + - Flower Card: products/plt1b/examples/flower-card.md - Troubleshooting: - - PLT-1 Boot Mode: products/plt1b/troubleshooting/plt1b-boot-mode.md - - Factory Re-Flash PLT-1: products/plt1b/troubleshooting/plt1b-code.md - - Teardown and Reassembly Of PLT-1: products/plt1b/troubleshooting/plt1b-teardown.md + - Factory Re-Flash PLT-1B: products/plt1b/troubleshooting/plt1b-code.md + - PLT-1B Boot Mode: products/plt1b/troubleshooting/plt1b-boot-mode.md - Reset Wi-Fi Credentials: products/plt1b/troubleshooting/plt1b-reset-wi-fi-credentials.md + - Teardown and Reassembly Of PLT-1B: products/plt1b/troubleshooting/plt1b-teardown.md - Reviews: products/plt1b/reviews.md - PUMP-1: - Introduction: products/pump1/introduction.md @@ -643,13 +643,13 @@ nav: - Bluetooth Proxy: products/pump1/additional-info/bluetooth-proxy.md - Addons: - Bottle Addon: products/pump1/addons/attaching-bottle-to-pump-1.md - - Inlet and Outlet Tube Addons: products/pump1/addons/attaching-tubes-to-pump-1.md - Fluid Sensor Addons: products/pump1/addons/attaching-fluid-level-sensors-pump-1.md + - Inlet and Outlet Tube Addons: products/pump1/addons/attaching-tubes-to-pump-1.md - Troubleshooting: - - PUMP-1 Boot Mode: products/pump1/troubleshooting/pump1-boot-mode.md - Factory Re-Flash PUMP-1: products/pump1/troubleshooting/pump1-reflash.md - - Teardown and Reassembly Of PUMP-1: products/pump1/troubleshooting/pump1-teardown.md + - PUMP-1 Boot Mode: products/pump1/troubleshooting/pump1-boot-mode.md - Reset Wi-Fi Credentials: products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of PUMP-1: products/pump1/troubleshooting/pump1-teardown.md - Contact Us / Support: products/general/contact-us/contact-us-support.md #### ***START OF HOMEY SECTION*** - Homey: @@ -667,13 +667,13 @@ nav: - CO2: homey/products/general/calibrating-and-updating/co2-calibration.md - Radar Tuning: - mmWave Tuning Videos: homey/products/general/calibrating-and-updating/mmwave-videos.md - - Hidden WiFi Networks: homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md + - Hidden Wi-Fi Networks: homey/products/general/setup/adding-apollo-devices-to-hidden-networks.md - Renaming Devices: homey/products/general/setup/renaming-apollo-devices.md - Troubleshooting: - - Removing Devices: homey/products/general/troubleshooting/removing-device-from-homey.md - Connection Issues: homey/products/general/troubleshooting/connection-issues.md - - Unifi Auto Discover Device mDNS Issue: homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md - OPNsense Auto Discover Device mDNS Issue: homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md + - Removing Devices: homey/products/general/troubleshooting/removing-device-from-homey.md + - UniFi Auto Discover Device mDNS Issue: homey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md - Battery Sensors: - 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 @@ -689,8 +689,8 @@ nav: - Additional Info: - General Tips: homey/products/btn1/setup/general-tips.md - Sensor Definitions: homey/products/btn1/setup/sensor-definitions.md - - Prevent Sleep: homey/products/btn1/additional-info/prevent-sleep.md - How To Wake Up Your Sensor: homey/products/btn1/battery-sensors/wake-up-battery-sensor.md + - Prevent Sleep: homey/products/btn1/additional-info/prevent-sleep.md - Addons: - BTN-1 Addon: homey/products/btn1/addons/btn1-addon.md - Examples: @@ -699,8 +699,8 @@ nav: - Troubleshooting: - BTN-1 Boot Mode: homey/products/btn1/troubleshooting/btn1-boot-mode.md - Factory Re-Flash BTN-1: homey/products/btn1/troubleshooting/btn1-reflash.md - - Teardown and Reassembly Of BTN-1: homey/products/btn1/troubleshooting/btn1-teardown.md - Reset Wi-Fi Credentials: homey/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of BTN-1: homey/products/btn1/troubleshooting/btn1-teardown.md - Environmental Sensors: - AIR-1: - Introduction: homey/products/air1/introduction.md @@ -712,65 +712,65 @@ nav: - Prevent Sleep: homey/products/air1/setup/prevent-sleep.md - Addons: - CO2 Addon: homey/products/air1/addons/adding-co2-to-air-1.md - - MiCS Addon: homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md - GPIO Addon: homey/products/air1/addons/adding-gpio-header-to-air-1.md - - Reviews: homey/products/air1/air1-reviews.md + - MiCS Addon: homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md - Examples: - Air Quality Dashboard: homey/products/air1/examples/air-quality-notification-example.md - Troubleshooting: - AIR-1 Boot Mode: homey/products/air1/troubleshooting/air1-boot-mode.md - Factory Re-Flash AIR-1: homey/products/air1/troubleshooting/air1-code.md - - Teardown and Reassembly Of AIR-1: homey/products/air1/troubleshooting/air1-teardown.md - Reset Wi-Fi Credentials: homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of AIR-1: homey/products/air1/troubleshooting/air1-teardown.md + - Reviews: homey/products/air1/air1-reviews.md - TEMP-1: - Introduction: homey/products/temp1/introduction.md - FAQ: homey/products/temp1/faq.md - Getting Started: homey/products/temp1/setup/getting-started-temp1.md - Additional Info: - Sensor Definitions: homey/products/temp1/setup/temp1-sensor-definitions.md - - Prevent Sleep: homey/products/temp1/setup/prevent-sleep.md - How To Wake Up Your Sensor: homey/products/temp1/battery-sensors/wake-up-battery-sensor.md + - Prevent Sleep: homey/products/temp1/setup/prevent-sleep.md - Sensor Connection Check: homey/products/temp1/battery-sensors/sensor-connection-check.md - Addons: - - Magnetic Mount: homey/products/temp1/addons/magnetic-mount.md - - Temp Probe: homey/products/temp1/addons/temp-probe.md - Food Probe: homey/products/temp1/addons/food-probe.md + - Magnetic Mount: homey/products/temp1/addons/magnetic-mount.md - Multi-Probe Splitter: homey/products/temp1/addons/multiple-probes.md - - Reviews: homey/products/temp1/reviews.md + - Temp Probe: homey/products/temp1/addons/temp-probe.md - Examples: - Alert Outside Range: homey/products/temp1/examples/temp1-alert-example.md - - Use Cases: homey/products/temp1/examples/use-cases.md - Automations: homey/products/temp1/examples/temp1-automation-examples.md + - Use Cases: homey/products/temp1/examples/use-cases.md - Troubleshooting: - - TEMP-1 Boot Mode: homey/products/temp1/troubleshooting/temp1-boot-mode.md - Factory Re-Flash TEMP-1: homey/products/temp1/troubleshooting/temp1-code.md - - Teardown and Reassembly Of TEMP-1: homey/products/temp1/troubleshooting/temp1-teardown.md - Reset Wi-Fi Credentials: homey/products/temp1/troubleshooting/temp1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of TEMP-1: homey/products/temp1/troubleshooting/temp1-teardown.md + - TEMP-1 Boot Mode: homey/products/temp1/troubleshooting/temp1-boot-mode.md + - Reviews: homey/products/temp1/reviews.md - TEMP-1B: - Introduction: homey/products/temp1b/introduction.md - FAQ: homey/products/temp1b/faq.md - Getting Started: homey/products/temp1b/setup/getting-started-temp1.md - Additional Info: - Sensor Definitions: homey/products/temp1b/setup/temp1b-sensor-definitions.md - - Prevent Sleep: homey/products/temp1b/setup/prevent-sleep.md - How To Wake Up Your Sensor: homey/products/temp1b/battery-sensors/wake-up-battery-sensor.md - Insert Battery: homey/products/temp1b/setup/insert-battery.md + - Prevent Sleep: homey/products/temp1b/setup/prevent-sleep.md - Sensor Connection Check: homey/products/temp1b/battery-sensors/sensor-connection-check.md - Addons: - - Magnetic Mount: homey/products/temp1b/addons/magnetic-mount.md - - Temp Probe: homey/products/temp1b/addons/temp-probe.md - Food Probe: homey/products/temp1b/addons/food-probe.md + - Magnetic Mount: homey/products/temp1b/addons/magnetic-mount.md - Multi-Probe Splitter: homey/products/temp1b/addons/multiple-probes.md - - Reviews: homey/products/temp1b/reviews.md + - Temp Probe: homey/products/temp1b/addons/temp-probe.md - Examples: - Alert Outside Range: homey/products/temp1b/examples/temp1b-alert-example.md - - Use Cases: homey/products/temp1b/examples/use-cases.md - Automations: homey/products/temp1b/examples/temp1b-automation-examples.md + - Use Cases: homey/products/temp1b/examples/use-cases.md - Troubleshooting: - - TEMP-1B Boot Mode: homey/products/temp1b/troubleshooting/temp1b-boot-mode.md - Factory Re-Flash TEMP-1B: homey/products/temp1b/troubleshooting/temp1b-code.md - - Teardown and Reassembly Of TEMP-1B: homey/products/temp1b/troubleshooting/temp1b-teardown.md - Reset Wi-Fi Credentials: homey/products/temp1b/troubleshooting/temp1b-reset-wi-fi-credentials.md + - Teardown and Reassembly Of TEMP-1B: homey/products/temp1b/troubleshooting/temp1b-teardown.md + - TEMP-1B Boot Mode: homey/products/temp1b/troubleshooting/temp1b-boot-mode.md + - Reviews: homey/products/temp1b/reviews.md - M-1 (LED Matrix): - Introduction: homey/products/m1/introduction.md - FAQ: homey/products/m1/faq.md @@ -782,77 +782,77 @@ nav: - Multiple Panels: homey/products/m1/setup/m1-multiple-panels.md - Segments: homey/products/m1/setup/m1-segments.md - Additional Info: - - Use Without Wi-Fi: homey/products/m1/setup/use-without-wifi.md - General Tips: homey/products/m1/setup/m1-general-tips.md + - Use Without Wi-Fi: homey/products/m1/setup/use-without-wifi.md + - Addons: + - Microphone: homey/products/m1/addons/adding-microphone-to-m-1.md + - WizMote Remote: homey/products/m1/addons/wizmote-remote.md - Examples: - - Pixel Forge: homey/products/m1/examples/pixel-forge.md - Add GIFs: homey/products/m1/examples/add-gifs-to-wled.md - - Scrolling Text: homey/products/m1/examples/scrolling-text.md + - Pixel Forge: homey/products/m1/examples/pixel-forge.md - QR Code Generator: homey/products/m1/examples/qr-code-generator.md + - Scrolling Text: homey/products/m1/examples/scrolling-text.md - Share Data From Home Assistant: homey/products/m1/examples/share-data-from-home-assistant.md - - Addons: - - Microphone: homey/products/m1/addons/adding-microphone-to-m-1.md - - WizMote Remote: homey/products/m1/addons/wizmote-remote.md - Troubleshooting: - - Panel Troubleshooting: homey/products/m1/troubleshooting/m1-panel-faults.md - - M-1 Boot Mode: homey/products/m1/troubleshooting/m1-boot-mode.md - Factory Re-Flash M-1: homey/products/m1/troubleshooting/m1-reflash.md - Find IP and Hostname: homey/products/m1/troubleshooting/m1-find-ip-address-and-hostname.md + - M-1 Boot Mode: homey/products/m1/troubleshooting/m1-boot-mode.md + - Panel Troubleshooting: homey/products/m1/troubleshooting/m1-panel-faults.md - Reviews: homey/products/m1/m1-reviews.md - mmWave Sensors: - MSR-2: - Introduction: homey/products/msr2/introduction.md - FAQ: homey/products/msr2/faq.md - Getting Started: homey/products/general/setup/getting-started-msr2.md + - Radar Tuning: + - Home Assistant: homey/products/msr2/setup/zones-ha.md + - HLK Radar Tool App: homey/products/msr2/setup/zones-hlk.md + - mmWave Tuning Videos: homey/products/msr2/setup/mmwave-videos.md - Additional Info: - General Tips: homey/products/msr2/setup/msr2-general-tips.md - Sensor Definitions: homey/products/msr2/setup/msr2-sensor-definitions.md - - Radar Tuning: - - Home Assistant: homey/products/msr2/setup/zones-ha.md - - HLK Radar Tool App: homey/products/msr2/setup/zones-hlk.md - - mmWave Tuning Videos: homey/products/msr2/setup/mmwave-videos.md - Addons: + - 90 Degree Addon: homey/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md - Articulating Stand: homey/products/msr2/addons/adding-articulating-stand-to-msr-2.md - CO2 Addon: homey/products/msr2/addons/adding-co2-to-msr-2.md - Female Rear USB-C: homey/products/msr2/addons/adding-rear-female-usb-to-msr-2.md - GPIO Addon: homey/products/msr2/addons/adding-gpio-header-to-msr-2.md - Outlet Mount: homey/products/msr2/addons/msr2-outlet-mount.md - - 90 Degree Addon: homey/products/msr2/addons/adding-90-degree-usb-c-to-msr-2.md - - Reviews: homey/products/msr2/msr2-reviews.md - Examples: - - MSR-2 Dashboards: homey/products/msr2/examples/msr2-dashboards.md - - MSR-2 Alarmo: homey/products/msr2/examples/msr2-alarmo.md - GPIO Header LED Strip: homey/products/msr2/examples/gpio-header-control-an-led-strip.md + - MSR-2 Alarmo: homey/products/msr2/examples/msr2-alarmo.md + - MSR-2 Dashboards: homey/products/msr2/examples/msr2-dashboards.md - Troubleshooting: - - MSR-2 Boot Mode: homey/products/msr2/troubleshooting/msr2-boot-mode.md - Factory Re-Flash MSR-2: homey/products/msr2/troubleshooting/msr2-code.md - - Teardown and Reassembly Of MSR-2: homey/products/msr2/troubleshooting/msr2-teardown.md + - MSR-2 Boot Mode: homey/products/msr2/troubleshooting/msr2-boot-mode.md - Reset Wi-Fi Credentials: homey/products/msr2/troubleshooting/msr2-reset-wi-fi-credentials.md + - Teardown and Reassembly Of MSR-2: homey/products/msr2/troubleshooting/msr2-teardown.md + - Reviews: homey/products/msr2/msr2-reviews.md - MTR-1: - Introduction: homey/products/mtr1/introduction.md - FAQ: homey/products/mtr1/faq.md - Getting Started: homey/products/general/setup/getting-started-mtr1.md + - Zone Configuration: + - (Better) HLK Radar Tool App: homey/products/mtr1/setup/zones-hlk.md + - (Best) Zone Mapper Tool: homey/products/mtr1/setup/mtr-1-zone-mapper-tool.md - Additional Info: - General Tips: homey/products/mtr1/setup/general-tips.md - Sensor Definitions: homey/products/mtr1/setup/sensor-definitions.md - - Zone Configuration: - - (Better) HLK Radar Tool App: homey/products/mtr1/setup/zones-hlk.md - - (Best) Zone Mapper Tool: homey/products/mtr1/setup/mtr-1-zone-mapper-tool.md - Addons: + - 90 Degree Addon: homey/products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md - Articulating Stand: homey/products/mtr1/addons/adding-articulating-stand-to-mtr-1.md - CO2 Addon: homey/products/mtr1/addons/adding-co2-to-mtr-1.md - - Male Rear USB-C: homey/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md - GPIO Addon: homey/products/mtr1/addons/adding-gpio-header-to-mtr-1.md - - 90 Degree Addon: homey/products/mtr1/addons/adding-90-degree-usb-c-to-mtr-1.md - - Reviews: homey/products/mtr1/mtr1-reviews.md + - Male Rear USB-C: homey/products/mtr1/addons/adding-rear-male-usb-to-mtr-1.md - Examples: - - MTR-1 Corner Mount: homey/products/mtr1/examples/crookedtoe-mtr1.md - MTR-1 Alarmo: homey/products/mtr1/examples/mtr1-alarmo.md + - MTR-1 Corner Mount: homey/products/mtr1/examples/crookedtoe-mtr1.md - Troubleshooting: - - MTR-1 Boot Mode: homey/products/mtr1/troubleshooting/mtr1-boot-mode.md - Factory Re-Flash MTR-1: homey/products/mtr1/troubleshooting/mtr1-code.md - - Teardown and Reassembly Of MTR-1: homey/products/mtr1/troubleshooting/mtr1-teardown.md + - MTR-1 Boot Mode: homey/products/mtr1/troubleshooting/mtr1-boot-mode.md - Reset Wi-Fi Credentials: homey/products/mtr1/troubleshooting/mtr1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of MTR-1: homey/products/mtr1/troubleshooting/mtr1-teardown.md + - Reviews: homey/products/mtr1/mtr1-reviews.md - R PRO-1: - Introduction: homey/products/rpro1/introduction.md - FAQ: homey/products/rpro1/faq.md @@ -860,19 +860,19 @@ nav: - (Better) HLK Radar Tool App: homey/products/rpro1/setup/zones-hlk.md - (Best) Zone Mapper Tool: homey/products/rpro1/setup/r-pro-1-zone-mapper-tool.md - Additional Info: - - Switch Firmware: homey/products/rpro1/setup/rpro1-switch-firmware.md - General Tips: homey/products/rpro1/setup/rpro1-general-tips.md - Sensor Definitions: homey/products/rpro1/setup/rpro1-sensor-definitions.md + - Switch Firmware: homey/products/rpro1/setup/rpro1-switch-firmware.md - Addons: - - CO2 Addon: homey/products/rpro1/addons/adding-co2-to-r-pro-1.md - 1-Gang Box Mount: homey/products/rpro1/addons/attaching-gang-box-mount-to-r-pro-1.md - Ceiling Mount: homey/products/rpro1/addons/install-ceiling-mount-for-r-pro-1.md + - CO2 Addon: homey/products/rpro1/addons/adding-co2-to-r-pro-1.md - LD2412 Addon: homey/products/rpro1/addons/add-the-ld2412-mmwave-sensor-to-r-pro-1.md - Troubleshooting: - - R PRO-1 Boot Mode: homey/products/rpro1/troubleshooting/rpro1-boot-mode.md - Factory Re-Flash R PRO-1: homey/products/rpro1/troubleshooting/rpro1-code.md - - Teardown and Reassembly Of R PRO-1: homey/products/rpro1/troubleshooting/rpro1-teardown.md + - R PRO-1 Boot Mode: homey/products/rpro1/troubleshooting/rpro1-boot-mode.md - Reset Wi-Fi Credentials: homey/products/rpro1/troubleshooting/rpro1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of R PRO-1: homey/products/rpro1/troubleshooting/rpro1-teardown.md - Reviews: homey/products/rpro1/rpro1-reviews.md - Plant Sensors: - PLT-1: @@ -884,14 +884,14 @@ nav: - Sensor Definitions: homey/products/plt1/setup/plt1-sensor-definitions.md - Calibrating Soil Moisture: homey/products/plt1/calibrate-plt1.md - Prevent Sleep: homey/products/plt1/setup/prevent-sleep.md - - Reviews: homey/products/plt1/reviews.md - Examples: - Flower Card: homey/products/plt1/examples/flower-card.md - Troubleshooting: - - PLT-1 Boot Mode: homey/products/plt1/troubleshooting/plt1-boot-mode.md - Factory Re-Flash PLT-1: homey/products/plt1/troubleshooting/plt1-code.md - - Teardown and Reassembly Of PLT-1: homey/products/plt1/troubleshooting/plt1-teardown.md + - PLT-1 Boot Mode: homey/products/plt1/troubleshooting/plt1-boot-mode.md - Reset Wi-Fi Credentials: homey/products/plt1/troubleshooting/plt1-reset-wi-fi-credentials.md + - Teardown and Reassembly Of PLT-1: homey/products/plt1/troubleshooting/plt1-teardown.md + - Reviews: homey/products/plt1/reviews.md - PLT-1B: - Introduction: homey/products/plt1b/introduction.md - FAQ: homey/products/plt1b/faq.md @@ -900,18 +900,18 @@ nav: - General Tips: homey/products/plt1b/general-tips.md - Sensor Definitions: homey/products/plt1b/setup/plt1b-sensor-definitions.md - Calibrating Soil Moisture: homey/products/plt1b/calibrate-plt1.md - - Prevent Sleep: homey/products/plt1b/setup/prevent-sleep.md - How To Wake Up Your Sensor: homey/products/plt1b/battery-sensors/wake-up-battery-sensor.md - Insert Battery: homey/products/plt1b/additional-info/insert-battery.md + - Prevent Sleep: homey/products/plt1b/setup/prevent-sleep.md - Sensor Connection Check: homey/products/plt1b/battery-sensors/sensor-connection-check.md - - Reviews: homey/products/plt1b/reviews.md - Examples: - Flower Card: homey/products/plt1b/examples/flower-card.md - Troubleshooting: - - PLT-1 Boot Mode: homey/products/plt1b/troubleshooting/plt1b-boot-mode.md - - Factory Re-Flash PLT-1: homey/products/plt1b/troubleshooting/plt1b-code.md - - Teardown and Reassembly Of PLT-1: homey/products/plt1b/troubleshooting/plt1b-teardown.md + - Factory Re-Flash PLT-1B: homey/products/plt1b/troubleshooting/plt1b-code.md + - PLT-1B Boot Mode: homey/products/plt1b/troubleshooting/plt1b-boot-mode.md - Reset Wi-Fi Credentials: homey/products/plt1b/troubleshooting/plt1b-reset-wi-fi-credentials.md + - Teardown and Reassembly Of PLT-1B: homey/products/plt1b/troubleshooting/plt1b-teardown.md + - Reviews: homey/products/plt1b/reviews.md - PUMP-1: - Introduction: homey/products/pump1/introduction.md - FAQ: homey/products/pump1/faq.md @@ -920,11 +920,11 @@ nav: - Sensor Definitions: homey/products/pump1/setup/pump1-sensor-definitions.md - Addons: - Bottle Addon: homey/products/pump1/addons/attaching-bottle-to-pump-1.md - - Inlet and Outlet Tube Addons: homey/products/pump1/addons/attaching-tubes-to-pump-1.md - Fluid Sensor Addons: homey/products/pump1/addons/attaching-fluid-level-sensors-pump-1.md + - Inlet and Outlet Tube Addons: homey/products/pump1/addons/attaching-tubes-to-pump-1.md - Troubleshooting: - - PUMP-1 Boot Mode: homey/products/pump1/troubleshooting/pump1-boot-mode.md - Factory Re-Flash PUMP-1: homey/products/pump1/troubleshooting/pump1-reflash.md - - Teardown and Reassembly Of PUMP-1: homey/products/pump1/troubleshooting/pump1-teardown.md + - PUMP-1 Boot Mode: homey/products/pump1/troubleshooting/pump1-boot-mode.md - Reset Wi-Fi Credentials: homey/products/pump1/troubleshooting/pump1-reset-wi-fi-credentials.md - - Contact Us / Support: homey/products/general/contact-us/contact-us-support.md \ No newline at end of file + - Teardown and Reassembly Of PUMP-1: homey/products/pump1/troubleshooting/pump1-teardown.md + - Contact Us / Support: homey/products/general/contact-us/contact-us-support.md