Skip to content

Commit

Permalink
Merge pull request #75 from ApolloAutomation/dev
Browse files Browse the repository at this point in the history
  • Loading branch information
cloudcannon[bot] authored Oct 23, 2024
2 parents bb017c1 + b8f85d7 commit 8b326be
Show file tree
Hide file tree
Showing 8 changed files with 62 additions and 0 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/plt-1-buttons-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/plt-1-buttons-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 25 additions & 0 deletions docs/products/plt1/plt1-boot-mode.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Putting The PLT-1 In Boot Mode

This will cover how to put the PLT-1 into boot mode. Sometimes, this is needed to upload new firmware if the device is struggling.

## **Boot Button Only**

1\. See the photo below to help access the boot button through the side of the case on the non USB-C side.

![](../../assets/d5b149f5-a472-4628-804b-754fa9aa0601.png)

2\. Use a pin to press and hold the boot button, while holding the boot button plug the PLT-1 back into your computer/power and then release the boot button

3\. Continue with uploading the firmware

## **Boot and Reset Buttons**

1\. Plug in the device

2\. Press and hold the boot button, while holding it press and release the reset button, then release the boot button

![](../../assets/plt-1-buttons-3.png)

![](../../assets/3cd650db-75f1-4a5b-afaf-b7afc5892c00.png)

3\. Continue with uploading the firmware
30 changes: 30 additions & 0 deletions docs/products/plt1/plt1-code.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Manually Uploading Code Through ESPHome

If your device becomes unresponsive and you've exhausted the other troubleshooting methods you can upload a fresh set of firmware by following the below guide. The utility does need to be run from Chrome or Edge.

If your device has already been connected to Home Assistant previously please refer to Removing Device From Home Assistant first before proceeding

1. Plug your sensor into your computer with a quality USB-C cable that supports data transfer
2. Navigate to our installer page and click connect [\*\* Install Page \*\*](https://apolloautomation.github.io/PLT-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.

[![ComSelection.png](https://apolloautomation.github.io/docs/products/mtr1/assets/comselection.png)](https://apolloautomation.github.io/docs/products/mtr1/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 for putting the sensor in bootloader mode and then retry step 3. Putting sensor In Boot Mode Document

4\. Choose to install the new firmware

[![](https://apolloautomation.github.io/docs/products/mtr1/assets/image-1698806750134.png)](https://apolloautomation.github.io/docs/products/mtr1/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.

[![](https://apolloautomation.github.io/docs/products/mtr1/assets/image-1698806082666.png)](https://apolloautomation.github.io/docs/products/mtr1/assets/image-1698806082666.png)

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 MTR-1 connected to your wifi
2. Log into Home Assistant and go to the ESPHome addon check to see if you can adopt the device.

If you encounter the below error, please complete the Putting MTR-1 In Boot Mode Document and go back to step 3.

[![](https://apolloautomation.github.io/docs/products/mtr1/assets/image-1698806793309.png)](https://apolloautomation.github.io/docs/products/mtr1/assets/image-1698806793309.png)
3 changes: 3 additions & 0 deletions docs/products/plt1/plt1-teardown.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Teardown and Reassembly of PLT-1

Will make video soon.
4 changes: 4 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -178,6 +178,10 @@ nav:
- Reviews: products/plt1/reviews.md
- Examples:
- Flower Card: products/plt1/examples/flower-card.md
- Troubleshooting:
- PLT-1 Boot Mode: products/plt1/plt1-boot-mode.md
- Manually Uploading Code To PLT-1: products/plt1/plt1-code.md
- Teardown and Reassembly Of PLT-1: products/plt1/plt1-teardown.md
- Apollo ODroid:
- Introduction: products/apolloodroid/introduction.md
- FAQ: products/apolloodroid/faq.md
Expand Down

0 comments on commit 8b326be

Please sign in to comment.