Document mandatory emulated_hue port setting (#10289)

* Document mandatory emulated_hue port setting

Since 2019 August/September firmware updates for Echo and Echo Dot v1.

* Amazon Alexa/Echo emulated hue port doc changes

* ✏️ Tweaks


Co-authored-by: Franck Nijhof <frenck@addons.community>
This commit is contained in:
clach04 2019-12-05 08:43:45 -08:00 committed by Franck Nijhof
parent 9af4bd95c0
commit 9354ed8809

View File

@ -55,9 +55,8 @@ emulated_hue:
```yaml
# Amazon Echo example configuration.yaml entry
emulated_hue:
host_ip: YOUR.HASSIO.IP.ADDRESS
listen_port: 80
# Alexa stopped working on different ports. Search for "Philipps Hue Bridge V1 (round)" in the Alexa App to discover devices.
# Amazon Echo/Alexa stopped working on different ports. Search for "Philips Hue Bridge V1 (round)" in the Alexa App to discover devices.
```
{% configuration %}
@ -71,7 +70,7 @@ host_ip:
required: false
type: string
listen_port:
description: "The port the Hue bridge API web server will run on. This can be any free port on your system. However, all new Alexa devices require listen_port: 80."
description: "The port the Hue bridge API web server will run on. This can be any free port on your system. However, all new Alexa devices require listen_port: 80. See `setcap` note below if this is set below `1024` when Home Assistant is ran as a non-root user."
required: false
type: integer
default: 8300
@ -146,16 +145,19 @@ These attributes used to be found under the `customize` section of `homeassistan
You can verify that the `emulated_hue` integration has been loaded and is responding by pointing a local browser to the following URL:
- `http://<HA IP Address>:8300/description.xml` - This URL should return a descriptor file in the form of an XML file.
- `http://<HA IP Address>:8300/api/pi/lights` - This will return a list of devices, lights, scenes, groups, etc.. that `emulated_hue` is exposing to Alexa.
- `http://<HA IP Address>:8300/description.xml` - This URL should return a descriptor file in the form of an XML file.
- `http://<HA IP Address>:8300/api/pi/lights` - This will return a list of devices, lights, scenes, groups, etc.. that `emulated_hue` is exposing to Alexa.
For Google Home, verify that the URLs above are using port 80, rather than port 8300 (i.e. `http://<HA IP Address>:80/description.xml`).
For Amazon Alexa/Echo, verify that the URLs above are using port 80, rather than port 8300 (i.e. `http://<HA IP Address>:80/description.xml`). Since 2019-08 Amazon Echo firmware, Alexa no longer works with port 8300.
An additional step is required to run Home Assistant as a non-root user and use port 80 when using the AiO script. Execute the following command to allow `emulated_hue` to use port 80 as a non-root user.
```bash
sudo setcap 'cap_net_bind_service=+ep' /srv/homeassistant/homeassistant_venv/bin/python3
```
Please note that your path may be different depending on your installation method. For example, if you followed the [Virtualenv instructions](/docs/installation/virtualenv/), your path will be `/srv/homeassistant/bin/python3`.
### License