mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-19 15:26:59 +00:00
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:
parent
05904361e6
commit
2170d07c04
@ -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.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user