13 USD voice: config must be deleted prior to install new firmware (#29387)

* 13 USD voice: config must be deleted prior to install new firmware

- Add procedure how to delete device and preexisting config
- Add troubleshooting step on what to do if prompted for connection settings of ESPHome node

* Remove redundant step. Fix typos

* Fix markdown

* Remove info on encryption key. It is not helpful at this stage

* Fix MD
This commit is contained in:
c0ffeeca7 2023-10-17 18:11:19 +02:00 committed by GitHub
parent 1771a0639a
commit 7da6610589
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -47,6 +47,20 @@ As a first step, you need to install the openWakeWord add on. This must be insta
## Installing the software onto the ATOM Echo
If you have used the ATOM Echo on Home Assistant before and have it installed via ESPHome add-on, you first need to remove its configuration.
### To delete the ATOM Echo configuration from ESPHome
1. Go to {% my integrations title="**Settings** > **Devices & Services**" %}, and select the ESPHome integration.
- Under **Devices**, next to the **M5Stack Atom Echo a61920** entry, select the three-dots menu.
- Select **Delete**.
2. Make sure you have [access to the configuration files](/common-tasks/os/#configuring-access-to-files).
- If you have never done this before, [install the file editor add-on](/common-tasks/os/#installing-and-using-the-file-editor-add-on).
3. Access the config files and open the **esphome** folder.
4. If there is a configuration file for the ATOM Echo, delete it.
### To install the software on your ATOM Echo
Before you can use this device with Home Assistant, you need to install a bit of software on it.
1. Make sure this page is opened in a Chromium-based browser on a desktop. It does not work on a tablet or phone.
@ -78,14 +92,18 @@ Before you can use this device with Home Assistant, you need to install a bit of
5. Select **OK**.
![Set up ESPHome](/images/assist/esp32-atom-flash-07.png)
6. To add the newly discovered device, select the ATOM Echo from the list.
6. If, at this stage, a dialog opens, prompting you to enter the connection settings of your ESPHome node, it means there is already a configuration set up for that ESPHome device.
- Close the dialog and perform the procedure on [deleting the ATOM Echo configuration from ESPHome](/voice_control/thirteen-usd-voice-remote/#to-delete-the-atom-echo-configuration-from-esphome).
- Restart Home Assistant.
- Then, under {% my integrations title="**Settings** > **Devices & Services**" %}, your ATOM Echo should be discovered.
7. To add the newly discovered device, select the ATOM Echo from the list.
- Add your ATOM Echo to a room and select **Finish**.
7. You should now see the **ESPHome** integration.
8. You should now see the **ESPHome** integration.
![New ESPHome device discovered](/images/assist/m5stack-atom-echo-discovered-33.png)
8. Select the **ESPHome** integration. Under **Devices**, you should see the **M5Stack Atom Echo** listed.
9. Select the **ESPHome** integration. Under **Devices**, you should see the **M5Stack Atom Echo** listed.
![ATOM Echo discovered](/images/assist/m5stack-atom-echo-discovered-new-03.png)
- Your ATOM Echo is connected to Home Assistant over Wi-Fi. You can now move it to any place in your home with a USB power supply.
9. Congratulations! You can now voice control Home Assistant using a button with a built-in microphone. Now give some commands.
10. Congratulations! You can now voice control Home Assistant using a button with a built-in microphone. Now give some commands.
## Controlling Home Assistant over the ATOM Echo
@ -111,6 +129,7 @@ Before you can use this device with Home Assistant, you need to install a bit of
2. Go to {% my integrations title="**Settings** > **Devices & Services**" %} and select the **ESPHome** integration.
- Under **M5Stack ATOM Echo**, select **1 device**.
3. Disable **Use wake word**.
![Toggle to enable/disable wake word](/images/assist/wake_word_disable_on_atom_echo.png)
4. To start using push-to-talk, press the flat button with rounded shape on your ATOM Echo.
- The rectangular button on the side is the reset button. Do not press that one.