jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 17:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Reference box instead of box-3 (#30339)

Browse Source 
* Reference box instead of box-3

* Fix links
This commit is contained in:
Paulus Schoutsen 2023-12-14 11:43:20 -05:00 committed by GitHub
parent ce60966813
commit ffc1164c8e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 23 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
source/_posts/2023-12-13-year-of-the-voice-chapter-5.markdown
View File

@ -30,7 +30,7 @@ Happy holidays!
<p class='img'> <p class='img'>
<lite-youtube videoid="erf7HqTwCGs" videotitle="ESP32-S3-Box running Assist"></lite-youtube> <lite-youtube videoid="erf7HqTwCGs" videotitle="ESP32-S3-Box running Assist"></lite-youtube>
Assist running on the ESP32-S3-BOX-3. Assist running on the ESP32-S3-BOX.
</p> </p>
<!--more--> <!--more-->
@ -40,8 +40,8 @@ Assist running on the ESP32-S3-BOX-3.
Espressif recently released the [ESP32-S3-BOX-3], an update of the discontinued ESP32-S3-BOX (and "lite" variant). This "AIoT" development kit contains an ESP32-S3 chip, dual microphones, a small speaker, and a screen. Several docks are available in the box, which expose a USB-C power connector and GPIO pins for expanding the device. Espressif recently released the [ESP32-S3-BOX-3], an update of the discontinued ESP32-S3-BOX (and "lite" variant). This "AIoT" development kit contains an ESP32-S3 chip, dual microphones, a small speaker, and a screen. Several docks are available in the box, which expose a USB-C power connector and GPIO pins for expanding the device.
<p class='img'> <p class='img'>
<lite-youtube videoid="73QhFefsbbc" videotitle="Assist on the ESP32-S3-Box-3 with custom artwork"></lite-youtube> <lite-youtube videoid="73QhFefsbbc" videotitle="Assist on the ESP32-S3-Box with custom artwork"></lite-youtube>
Assist running on the ESP32-S3-BOX-3 with custom artwork. Assist running on the ESP32-S3-BOX with custom artwork.
</p> </p>
The [ESPHome] team has been hard at work adding support for the S3-BOX-3, including the ability to customize the display! Check out the [S3-BOX-3 tutorial][s3-box-tutorial] to get started. The [ESPHome] team has been hard at work adding support for the S3-BOX-3, including the ability to customize the display! Check out the [S3-BOX-3 tutorial][s3-box-tutorial] to get started.
@ -58,7 +58,7 @@ Starting all the way back in [Chapter 1], we added voice commands for:
- Turning lights and other devices on and off - Turning lights and other devices on and off
- Opening and closing doors, windows, etc. - Opening and closing doors, windows, etc.
- Setting the brightness and color of lights - Setting the brightness and color of lights
- Adding items to a shopping list - Adding items to a shopping list
- Asking questions, such as which windows are open in an area - Asking questions, such as which windows are open in an area
For Chapter 5, we've extended this list to include: For Chapter 5, we've extended this list to include:
@ -80,7 +80,7 @@ Voice satellites can be placed all around the house, and it's important to keep
Voice satellites make use of the area they're in. Voice satellites make use of the area they're in.
</p> </p>
This is a small start to satellites being aware of their *context*, and adjusting behavior accordingly. This is a small start to satellites being aware of their *context*, and adjusting behavior accordingly.
## Improved Raspberry Pi satellites ## Improved Raspberry Pi satellites
@ -120,22 +120,22 @@ Thanks to our language leaders for extending the sentence support to all the var
<img src='/images/blog/2023-12-13-year-of-the-voice-chapter-5/ha-support.png' alt="Thank you for supporting the Home Assistant project"> <img src='/images/blog/2023-12-13-year-of-the-voice-chapter-5/ha-support.png' alt="Thank you for supporting the Home Assistant project">
</p> </p>
[Year of the Voice]: https://www.home-assistant.io/blog/2022/12/20/year-of-voice/ [Year of the Voice]: /blog/2022/12/20/year-of-voice/
[Chapter 1]: https://www.home-assistant.io/blog/2023/01/26/year-of-the-voice-chapter-1/ [Chapter 1]: /blog/2023/01/26/year-of-the-voice-chapter-1/
[Chapter 4]: https://www.home-assistant.io/blog/2023/10/20/year-of-the-voice-chapter-4/ [Chapter 4]: /blog/2023/10/20/year-of-the-voice-chapter-4/
[Assist]: https://www.home-assistant.io/voice_control/ [Assist]: /voice_control/
[exposed]: https://www.home-assistant.io/voice_control/voice_remote_expose_devices/ [exposed]: /voice_control/voice_remote_expose_devices/
[alias]: https://www.home-assistant.io/voice_control/aliases [alias]: /voice_control/aliases
[wyoming]: https://github.com/rhasspy/wyoming [wyoming]: https://github.com/rhasspy/wyoming
[openWakeWord]: https://github.com/dscripka/openWakeWord [openWakeWord]: https://github.com/dscripka/openWakeWord
[Piper]: https://github.com/rhasspy/piper/ [Piper]: https://github.com/rhasspy/piper/
[community-wake-words]: https://github.com/fwartner/home-assistant-wakewords-collection [community-wake-words]: https://github.com/fwartner/home-assistant-wakewords-collection
[ESP32-S3-BOX-3]: https://www.espressif.com/en/news/ESP32-S3-BOX-3 [ESP32-S3-BOX-3]: https://www.espressif.com/en/news/ESP32-S3-BOX-3
[wyoming]: https://www.home-assistant.io/integrations/wyoming [wyoming]: /integrations/wyoming
[wyoming-satellite]: https://github.com/rhasspy/wyoming-satellite [wyoming-satellite]: https://github.com/rhasspy/wyoming-satellite
[rpi-zero-2w]: https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/ [rpi-zero-2w]: https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/
[s3-box-tutorial]: https://www.home-assistant.io/voice_control/s3_box_voice_assistant/ [s3-box-tutorial]: /voice_control/s3_box_voice_assistant/
[ESPHome]: https://esphome.io [ESPHome]: https://esphome.io
[nabucasa]: https://www.nabucasa.com [nabucasa]: https://www.nabucasa.com
[phone-tutorial]: https://www.home-assistant.io/voice_control/worlds-most-private-voice-assistant/ [phone-tutorial]: https://www.home-assistant.io/voice_control/worlds-most-private-voice-assistant/
[m5-tutorial]: http://localhost:4000/voice_control/thirteen-usd-voice-remote/ [m5-tutorial]: /voice_control/thirteen-usd-voice-remote/

8
source/voice_control/s3-box-customize.markdown
View File

@ -8,7 +8,7 @@ This tutorial will show you how to replace the Home Assistant status illustratio
You can either prepare your own illustrations or import some from a community repository. You can either prepare your own illustrations or import some from a community repository.
<lite-youtube videoid="HQQfaXTbhvc" videotitle="Okay Frenck! Open-source voice assistant running on an Espressif ESP32-S3-Box-3 <lite-youtube videoid="HQQfaXTbhvc" videotitle="Okay Frenck! Open-source voice assistant running on an Espressif ESP32-S3-Box
"></lite-youtube> "></lite-youtube>
## ESP32-S3-BOX-3 voice assistant status illustrations ## ESP32-S3-BOX-3 voice assistant status illustrations
@ -75,7 +75,7 @@ If you want to use your own images, skip this procedure and go to [Option 2: Usi
4. Save the changes and select **Install**: 4. Save the changes and select **Install**:
- Depending on your environment, the installation process can take a while. - Depending on your environment, the installation process can take a while.
![ESP32-S3-BOX-3 config file](/images/assist/esp32-s3-config-05.png) ![ESP32-S3-BOX-3 config file](/images/assist/esp32-s3-config-05.png)
5. Once the installation is complete, you can see the new image on the ESP32-S3-BOX-3. 5. Once the installation is complete, you can see the new image on the ESP32-S3-BOX-3.
- Now, speak a command to test the new setting. For example, *OK Nabu, turn off the living room lights*. - Now, speak a command to test the new setting. For example, *OK Nabu, turn off the living room lights*.
@ -99,7 +99,7 @@ In your images, you could use 2 different background colors:
- For loading and idle: use a dark background - For loading and idle: use a dark background
- For listening, thinking, and replying: use a light background - For listening, thinking, and replying: use a light background
- For error: As you like - For error: As you like
If your images have transparency, you can define the background color in the configuration. The procedure below shows how to change the background. If your images have transparency, you can define the background color in the configuration. The procedure below shows how to change the background.
#### Image dimensions and file format #### Image dimensions and file format
@ -110,7 +110,7 @@ If your images have transparency, you can define the background color in the con
### To prepare your own images ### To prepare your own images
1. Create your own images according to the specifications defined in the section [About the image specifications](#about-the-image-specifications). 1. Create your own images according to the specifications defined in the section [About the image specifications](#about-the-image-specifications).
- You could even draw your own! - You could even draw your own!
- There's a [template](#to-draw-your-own-images) for it. - There's a [template](#to-draw-your-own-images) for it.
2. Copy all 6 images into a folder. For example: `voice_assistant_gfx`. 2. Copy all 6 images into a folder. For example: `voice_assistant_gfx`.
3. Make sure you have [access to your configuration files](/common-tasks/os/#configuring-access-to-files). 3. Make sure you have [access to your configuration files](/common-tasks/os/#configuring-access-to-files).

10
source/voice_control/s3_box_voice_assistant.markdown
View File

@ -7,7 +7,7 @@ config_link: /voice_control/s3_box_voice_assistant/#to-delete-the-configuration-
This tutorial will guide you to turn an ESP32-S3-BOX-3 into a Home Assistant voice assistant. This tutorial will guide you to turn an ESP32-S3-BOX-3 into a Home Assistant voice assistant.
<lite-youtube videoid="erf7HqTwCGs" videotitle="Okay Nabu! Open-source voice assistant running on an Espressif ESP32-S3-Box-3 <lite-youtube videoid="erf7HqTwCGs" videotitle="Okay Nabu! Open-source voice assistant running on an Espressif ESP32-S3-Box
"></lite-youtube> "></lite-youtube>
## Prerequisites ## Prerequisites
@ -35,7 +35,7 @@ Before you can use this device with Home Assistant, you need to install a bit of
<esp-web-install-button manifest="https://firmware.esphome.io/voice-assistant/esp32-s3-box-3/manifest.json"></esp-web-install-button> <esp-web-install-button manifest="https://firmware.esphome.io/voice-assistant/esp32-s3-box-3/manifest.json"></esp-web-install-button>
- If you have an ESP32-S3-BOX or ESP32-S3-BOX-Lite, open the [ESPHome projects](https://esphome.io/projects/index.html) page, select your variant and follow the installation instructions. - If you have an ESP32-S3-BOX or ESP32-S3-BOX-Lite, open the [ESPHome projects](https://esphome.io/projects/index.html?type=voice) page, select your variant and follow the installation instructions.
- **For advanced users**: The configuration files are available on GitHub: - **For advanced users**: The configuration files are available on GitHub:
- [ESP32-S3-BOX-3](https://github.com/esphome/firmware/blob/main/voice-assistant/esp32-s3-box-3.yaml) - [ESP32-S3-BOX-3](https://github.com/esphome/firmware/blob/main/voice-assistant/esp32-s3-box-3.yaml)
@ -45,7 +45,7 @@ Before you can use this device with Home Assistant, you need to install a bit of
![ESP32-S3-BOX-3 discovered](/images/assist/s32-s3-box-3-discovered.png) ![ESP32-S3-BOX-3 discovered](/images/assist/s32-s3-box-3-discovered.png)
- Your ESP32-S3-BOX-3 is connected to Home Assistant over Wi-Fi. You can now move it to any place in your home with a USB power supply. - Your ESP32-S3-BOX-3 is connected to Home Assistant over Wi-Fi. You can now move it to any place in your home with a USB power supply.
10. Congratulations! You can now voice control Home Assistant via a ESP32 device with a display. Now give some commands. 10. Congratulations! You can now voice control Home Assistant via a ESP32 device with a display. Now give some commands.
## Controlling Home Assistant ## Controlling Home Assistant
@ -66,13 +66,13 @@ Before you can use this device with Home Assistant, you need to install a bit of
- Under **ESP32-S3-BOX-3**, select **1 device**. - Under **ESP32-S3-BOX-3**, select **1 device**.
- Enable **Mute**. - Enable **Mute**.
- The screen of the ESP32-S3-BOX-3 will turn off, too. - The screen of the ESP32-S3-BOX-3 will turn off, too.
![Toggle to enable/disable Mute](/images/assist/wake_word_disable.png) ![Toggle to enable/disable Mute](/images/assist/wake_word_disable.png)
2. If you want to just use the wake word, but do not want to use the screen, you can turn it off. 2. If you want to just use the wake word, but do not want to use the screen, you can turn it off.
- Go to {% my integrations title="**Settings** > **Devices & Services**" %} and select the **ESPHome** integration. - Go to {% my integrations title="**Settings** > **Devices & Services**" %} and select the **ESPHome** integration.
- Under **ESP32-S3-BOX-3**, select **1 device**. - Under **ESP32-S3-BOX-3**, select **1 device**.
- Disable **LCD Backlight**. - Disable **LCD Backlight**.
![Toggle to enable/disable wake word](/images/assist/s3-box-disable-screen.png) ![Toggle to enable/disable wake word](/images/assist/s3-box-disable-screen.png)
## Related topics ## Related topics