Add instructions for setting using discovery with the Harmony hub (#2700)

* Add instructions for setting using discovery with the Harmony hub

* Leave the default example to be manual configuration and separate advanced configuration into separate section.

* Add note that the  config variable is optional

* Revert deletion of example comment

* Revert deletion of example comment
This commit is contained in:
Anthony Hughes 2017-07-05 11:05:20 +02:00 committed by Fredrik Lindqvist
parent 05904361e6
commit 2170d07c04

View File

@ -24,20 +24,34 @@ Supported units:
- Harmony Elite - Harmony Elite
To use your Harmony remote in your installation, add the following to your `configuration.yaml` file: The preferred way to setup the Harmony remote is by enabling the [discovery component](/components/discovery/).
However, if you want to manually configure the device, you will need to add its settings to your `configuration.yaml`.
```yaml ```yaml
# Example configuration.yaml entry # Example configuration.yaml entry
remote: remote:
- platform: harmony - platform: harmony
name: Bedroom name: Bedroom
host: 10.168.1.13 host: 10.168.1.13 # The IP of your hub
```
You can override some default configuration values on a discovered hub (e.g. the `port` or `activity`) by adding
a `configuration.yaml` setting. In this case leave the `host` setting empty so the platform will
discover the host IP automatically, but set the `name` in the config to match exactly the name you have
set for your Hub so the platform knows what Hub you are trying to configure.
```yaml
# Example configuration.yaml entry with discovery
- platform: harmony
name: Living Room # This name must match the name you have set on the Hub
activity: Watch TV # Overriding the 'activity' setting for this discovered hub
``` ```
Configuration variables: Configuration variables:
- **name** (*Required*): The hub's name to display in the frontend. - **name** (*Required*): The hub's name to display in the frontend.
- **host** (*Required*): The Harmony device's IP address. - **host** (*Optional*): The Harmony device's IP address. Leave empty for the IP to be discovered automatically.
- **port** (*Optional*): The Harmony device's port. Defaults to 5222. - **port** (*Optional*): The Harmony device's port. Defaults to 5222.
- **activity** (*Optional*): Activity to use when turnon service is called without any data. - **activity** (*Optional*): Activity to use when turnon service is called without any data.
- **scan_interval** (*Optional*): Amount in seconds in between polling for device's current activity. Defaults to 30 seconds. - **scan_interval** (*Optional*): Amount in seconds in between polling for device's current activity. Defaults to 30 seconds.