Minor changes

This commit is contained in:
Fabian Affolter 2018-01-06 09:51:23 +01:00
parent 38b571562d
commit 81185518a3
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336

View File

@ -23,37 +23,33 @@ Supported units:
- Harmony Pro - Harmony Pro
- Harmony Elite - Harmony Elite
The preferred way to setup the Harmony remote is by enabling the [discovery component](/components/discovery/). 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`. However, if you want to manually configure the device, you will need to add its settings to your `configuration.yaml` file:
```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 # The IP of your hub host: 10.168.1.13
``` ```
You can override some default configuration values on a discovered hub (e.g. the `port` or `activity`) by adding 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.
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 ```yaml
# Example configuration.yaml entry with discovery # Example configuration.yaml entry with discovery
- platform: harmony - platform: harmony
name: Living Room # This name must match the name you have set on the Hub name: Living Room
activity: Watch TV # Overriding the 'activity' setting for this discovered hub activity: Watch TV
``` ```
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. This name must match the name you have set on the Hub.
- **host** (*Optional*): The Harmony device's IP address. Leave empty for the IP to be discovered automatically. - **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 `turn_on` service is called without any data. - **activity** (*Optional*): Activity to use when `turn_on` service is called without any data. Overrides the `activity` setting for this discovered hub.
- **delay_secs** (*Optional*): Default duration in seconds between sending commands to a device. - **delay_secs** (*Optional*): Default duration in seconds between sending commands to a device.
Configuration file: Configuration file:
@ -119,20 +115,23 @@ Synchronize the Harmony device with the Harmony web service if any changes are m
Template sensors can be utilized to display current activity in the frontend. Template sensors can be utilized to display current activity in the frontend.
{% raw %}
```yaml ```yaml
sensor: sensor:
- platform: template - platform: template
sensors: sensors:
family_room: family_room:
value_template: {% raw %}'{{ states.remote.family_room.attributes.current_activity }}'{% endraw %} value_template: '{{ states.remote.family_room.attributes.current_activity }}'
friendly_name: 'Family Room' friendly_name: 'Family Room'
bedroom: bedroom:
value_template: {% raw %}'{{ states.remote.bedroom.attributes.current_activity }}'{% endraw %} value_template: '{{ states.remote.bedroom.attributes.current_activity }}'
friendly_name: 'bedroom' friendly_name: 'bedroom'
``` ```
{% endraw %}
The example below shows how to control an `input_boolean` switch using the Harmony remote's current activity. The switch will turn on when the remote's state changes and the Kodi activity is started and off when the remote's state changes and the current activity is PowerOff. The example below shows how to control an `input_boolean` switch using the Harmony remote's current activity. The switch will turn on when the remote's state changes and the Kodi activity is started and off when the remote's state changes and the current activity is "PowerOff".
{% raw %}
```yaml ```yaml
automation: automation:
- alias: "Watch TV started from harmony hub" - alias: "Watch TV started from harmony hub"
@ -141,7 +140,7 @@ automation:
entity_id: remote.family_room entity_id: remote.family_room
condition: condition:
condition: template condition: template
value_template: {% raw %}'{{ trigger.to_state.attributes.current_activity == "Kodi" }}'{% endraw %} value_template: '{{ trigger.to_state.attributes.current_activity == "Kodi" }}'
action: action:
service: input_boolean.turn_on service: input_boolean.turn_on
entity_id: input_boolean.notify entity_id: input_boolean.notify
@ -151,8 +150,9 @@ automation:
entity_id: remote.family_room entity_id: remote.family_room
condition: condition:
condition: template condition: template
value_template: {% raw %}'{{ trigger.to_state.attributes.current_activity == "PowerOff" }}'{% endraw %} value_template: '{{ trigger.to_state.attributes.current_activity == "PowerOff" }}'
action: action:
service: input_boolean.turn_off service: input_boolean.turn_off
entity_id: input_boolean.notify entity_id: input_boolean.notify
```` ```
{% endraw %}