From 13400d5e6eba7524b84071a99a639a9334eb1472 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 Date: Thu, 19 Oct 2023 11:03:22 +0200 Subject: [PATCH] Voice tutorials: add HA OS to prereqs - fix some typos --- .../voice_control/create_wake_word.markdown | 4 +-- .../thirteen-usd-voice-remote.markdown | 4 +-- .../using_voice_assistants_overview.markdown | 2 +- .../voice_remote_local_assistant.markdown | 4 +++ ...rlds-most-private-voice-assistant.markdown | 31 ++++++++++--------- 5 files changed, 25 insertions(+), 20 deletions(-) diff --git a/source/voice_control/create_wake_word.markdown b/source/voice_control/create_wake_word.markdown index 4b47634aecdb..32a940146571 100644 --- a/source/voice_control/create_wake_word.markdown +++ b/source/voice_control/create_wake_word.markdown @@ -10,9 +10,9 @@ Depending on the word, training a model on your own wake word may take a few ite ## Prerequisites -- latest version of Home Assistant +- Latest version of Home Assistant, installed with the Home Assistant Operating System - [M5Stack ATOM Echo Development Kit](https://shop.m5stack.com/products/atom-echo-smart-speaker-dev-kit?ref=NabuCasa) -- successfully completed the [$13 voice assistant for Home Assistant](/voice_control/thirteen-usd-voice-remote/) tutorial +- Successfully completed the [$13 voice assistant for Home Assistant](/voice_control/thirteen-usd-voice-remote/) tutorial ## To create your own wake word diff --git a/source/voice_control/thirteen-usd-voice-remote.markdown b/source/voice_control/thirteen-usd-voice-remote.markdown index 0623ce13d41a..4e103e3c5871 100644 --- a/source/voice_control/thirteen-usd-voice-remote.markdown +++ b/source/voice_control/thirteen-usd-voice-remote.markdown @@ -9,9 +9,9 @@ your smart home. Issue commands and get responses! -## Required material +## Prerequisites -- Home Assistant 2023.10 +- Home Assistant 2023.10, installed with the Home Assistant Operating System - [Home Assistant Cloud](https://www.nabucasa.com) or a manually configured [Assist Pipeline](/voice_control/voice_remote_local_assistant) - The password to your 2.4 GHz Wi-Fi network - Chrome (or a Chromium-based browser like Edge) on desktop (not Android/iOS) diff --git a/source/voice_control/using_voice_assistants_overview.markdown b/source/voice_control/using_voice_assistants_overview.markdown index e16fef23162f..018f30b3bbd5 100644 --- a/source/voice_control/using_voice_assistants_overview.markdown +++ b/source/voice_control/using_voice_assistants_overview.markdown @@ -9,7 +9,7 @@ But you can make Assist the default digital assistant and [start it on an Androi You can also create your own [custom sentences](/voice_control/custom_sentences/#adding-a-custom-sentence-to-trigger-an-automation) to start an automation. For example, you could say "Clean the floor when I'm gone" to start the vacuum after you left your home zone. For the full list of new features and some videos, head over to the [chapter 3 blog post](/blog/2023/07/20/year-of-the-voice-chapter-3/) or watch the stream. - + While the video below does not include these latest changes, it gives a good overview of some of the basics. diff --git a/source/voice_control/voice_remote_local_assistant.markdown b/source/voice_control/voice_remote_local_assistant.markdown index 0949593a1691..aef06fd6bdae 100644 --- a/source/voice_control/voice_remote_local_assistant.markdown +++ b/source/voice_control/voice_remote_local_assistant.markdown @@ -10,6 +10,10 @@ The speech-to-text option is [Whisper](https://github.com/openai/whisper). It's For text-to-speech we have developed [Piper](https://github.com/rhasspy/piper). Piper is a fast, local neural text-to-speech system that sounds great and is optimized for the Raspberry Pi 4. It supports [many languages](https://rhasspy.github.io/piper-samples/). On a Raspberry Pi, using medium quality models, it can generate 1.6s of voice in a second. +## Prerequisites + +- Home Assistant Operating System + ## Installing a local Assist pipeline For the quickest way to get your local Assist pipeline started, follow these steps: diff --git a/source/voice_control/worlds-most-private-voice-assistant.markdown b/source/voice_control/worlds-most-private-voice-assistant.markdown index 49fc00e55425..748a1181f0d8 100644 --- a/source/voice_control/worlds-most-private-voice-assistant.markdown +++ b/source/voice_control/worlds-most-private-voice-assistant.markdown @@ -1,5 +1,5 @@ --- -title: "World's Most Private Voice Assistant" +title: "World's most private voice assistant" --- This tutorial will guide you to turn your old landline phone into the @@ -12,7 +12,7 @@ your smart home and issue commands and get responses. - Home Assistant 2023.5 or later - An [analog phone](#about-the-analog-phone) with an RJ11 socket -- An analog telephone adapter +- An analog telephone adapter [Grandstream HT801](https://amzn.to/40k7mRa) - includes a 5 V power adapter and an Ethernet cable - RJ11 phone cable to connect the phone to the Grandstream @@ -22,15 +22,15 @@ your smart home and issue commands and get responses. 1. Connect the RJ11 cable from the phone to the green socket on the Grandstream. ![Grandstream HT801 ports](/images/assist/grandstream-ht801-interfaces.png) -2. Connect the Grandstream to your network: +2. Connect the Grandstream to your network: - Plug the Ethernet cable into the blue socket and connect it to your router. 3. Start up the Grandstream. - Connect the power supply. - Once the Grandstream has booted, the two LEDs for power and Ethernet light up solid blue. The phone LED won't light up. 4. Identify the IP address of the Grandstream. - If your phone has a star * key, you can get your phone to tell you it's IP address: - - Press *** (press the star key three times) and wait until you hear *Enter the menu option*. - - Press 02 and the phone will tell you its IP address. + - Press *** (press the star key three times) and wait until you hear *Enter the menu option*. + - Press 02 and the phone will tell you its IP address. - If your phone does not have a star * key, log onto your router to find the IP address. 5. Enter the IP address into a browser window and log onto the Grandstream *Device Configuration* software. - The default credentials are: @@ -41,7 +41,7 @@ your smart home and issue commands and get responses. - \*47192\*168\*1\*100\*5060 ![Define IP for autodial](/images/assist/grandstream_autodial.png) - Note: instead of 192\*168\*1\*100\*, enter the IP address of your Home Assistant instance. - - At the bottom of the page, select **Apply**. + - At the bottom of the page, select **Apply**. ![Define IP for autodial](/images/assist/grandstream_apply.png) - *Offhook Auto-Dial* means that when you pick up the phone, it directly calls Home Assistant. No need to dial. @@ -57,13 +57,13 @@ your smart home and issue commands and get responses. 3. Allow calls. - Calls from new devices are blocked by default since voice commands could be used to control sensitive devices, such as locks and garage doors. - In the **Voice over IP** integration, select the **device** link. - - To allow this phone to control your smart home, under **Configuration**, enable **Allow calls**. - ![Voice over IP integration - allow calls](/images/assist/voip_configuration.png) -4. Congratulations! You set up your analog phone to work with Home Assistant. Now pick up the phone and control your device. + - To allow this phone to control your smart home, under **Configuration**, enable **Allow calls**. + ![Voice over IP integration - allow calls](/images/assist/voip_configuration.png) +4. Congratulations! You set up your analog phone to work with Home Assistant. Now pick up the phone and control your device. - Say a [supported voice command](/voice_control/builtin_sentences/). For example, *Turn off the light in the kitchen*. - You can also ask a question, such as - - *Is the front door locked?* - - *Which lights are on in the living room?* + - *Is the front door locked?* + - *Which lights are on in the living room?* - Make sure you're using the area name as you defined it in Home Assistant. If you have a room called *bathroom*, the phrase *Turn on the lights in the bath* won't work. - Your command is not supported? [Add your own commands](/integrations/conversation/). @@ -89,9 +89,9 @@ Note: this procedure requires an OpenAI account. To just run the example, the fr If you’re unable to call Home Assistant, confirm the following settings in your Grandstream device’s web interface. -1. On the **FXS Port** tab, check the **Preferred Vocoder** list. +1. On the **FXS Port** tab, check the **Preferred Vocoder** list. - Make sure that **OPUS** is selected for one of the choices: - ![Vocoder OPUS option](/images/assist/grandstream_vocoder.png) + ![Vocoder OPUS option](/images/assist/grandstream_vocoder.png) 2. Under **OPUS Payload type**, make sure the value is `123`. It's the default option. ![Vocoder OPUS payload type](/images/assist/grandstream_opus_payload.png) 3. At the bottom of the page, select **Apply**. @@ -104,11 +104,12 @@ You were able to control Home Assistant over the phone but it no longer works. W The [debug information](/voice_control/troubleshooting#view-debug-information) shows no runs. **Potential remedy** + 1. Log onto the Grandstream *Device Configuration* software. 2. On the **Status** page, check if the **Hook** status changes from **On Hook** to **In Use** after you picked up the phone. - ![Check the Grandstream status](/images/assist/grandstream-troubleshoot-10.png) + ![Check the Grandstream status](/images/assist/grandstream-troubleshoot-10.png) - The software is quite slow. Refresh the page and wait for a while before hanging up again. -3. If the status does not change, reboot the Grandstream and try calling Home Assistant again. +3. If the status does not change, reboot the Grandstream and try calling Home Assistant again. ## Other troubleshooting steps