Skip to content

Wink service updates and water heater support #3455

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Sep 29, 2017
Merged

Wink service updates and water heater support #3455

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 8 additions & 7 deletions source/_components/climate.wink.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: page
title: "Wink Thermostat"
description: "Instructions how to setup the Wink binary sensors within Home Assistant."
title: "Wink Climate"
description: "Instructions how to setup the Wink climate devices within Home Assistant."
date: 2016-11-01 22:36
sidebar: true
comments: false
Expand All @@ -14,20 +14,21 @@ ha_iot_class: "Cloud Polling"
---


The Wink climate platform allows you to get data from your [Wink](http://www.wink.com/) thermostats.
The Wink climate platform allows you to get data from your [Wink](http://www.wink.com/) thermostats, Air Conditioners, and Water Heaters.

The requirement is that you have setup [Wink](/components/wink/).


### {% linkable_title Supported climate devices %}

- Nest (No wink hub required)
- Ecobee (No wink hub required)
- Sensi (No wink hub required)
- Nest (No Wink hub required)
- Ecobee (No Wink hub required)
- Sensi (No Wink hub required)
- Carrier (Unconfirmed)
- Honeywell (No wink hub required)
- Honeywell (No Wink hub required)
- Generic Z-Wave
- Quirky Aros window AC unit
- Rheem Econet water heaters (No Wink hub required)

<p class='note'>
The above devices are confimed to work, but others may work as well.
Expand Down
16 changes: 15 additions & 1 deletion source/_components/lock.wink.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ script:
sequence:
- service: wink.wink_set_lock_alarm_state
data:
enabled: false
enabled: false
```

### {% linkable_title Service `wink_set_lock_beeper_state` %}
Expand Down Expand Up @@ -130,6 +130,20 @@ script:
enabled: false
```

### {% linkable_title Service `wink_add_new_lock_key_code` %}

You can use the service wink/wink_add_new_lock_key_code to add a new user code to your Wink lock.

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | no | String or list of strings that point at `entity_id`s of locks.
| `name` | no | the name of the new key code
| `code` | no | The new code. Must match length of existing codes.


<p class='note'>
Calling service wink/pull_newly_added_wink_devices will add the new key code to Home Assistant. The device will also show up on the next restart of Home Assistant.
</p>

<p class='note'>
If supported by your lock, a binary sensor will be created for each user key code you have defined. These key codes will turn on when the code is entered and automatically turn off after a few seconds.
Expand Down
45 changes: 40 additions & 5 deletions source/_components/wink.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ This method will require you to setup a developer account with Wink. This proces
This form of authentication doesn't require any settings in the configuration.yaml other than `wink:` this is because you will be guided through setup via the configurator on the frontend.

<p class='note'>
When using the configurator make sure the initial setup is performed on the same local network as the Home Assistant server, if not from the same box Home Assistant is running on. This will allow for authentication redirects to happen correctly.
When using the configurator make sure the initial setup is performed on the same local network as the Home Assistant server, if not from the same box Home Assistant is running on. This will allow for authentication redirects to happen correctly.
</p>

```yaml
Expand Down Expand Up @@ -79,7 +79,7 @@ Local control:

- Using local control doesn't appear to make commands any quicker, but does function in an internet/Wink outage.

- Local control is also only available for the Wink hub v1 and v2, not the Wink relay.
- Local control is also only available for the Wink hub v1 and v2, not the Wink relay.

- Local control isn't used during start-up of Home Assistant; this means initial setup requires an active internet connection.

Expand All @@ -98,15 +98,50 @@ Error sending local control request. Sending request online

### {% linkable_title Service `refresh_state_from_wink` %}

The Wink component only obtains the device states from the Wink API once, during startup. All updates after that are pushed via a third party called PubNub. On rare occasions where an update isn't pushed device states can be out of sync.
The Wink component only obtains the device states from the Wink API once, during startup. All updates after that are pushed via a third party called PubNub. On rare occasions where an update isn't pushed device states can be out of sync.

You can use the service wink/refresh_state_from_wink to pull the most recent state from the Wink API for all devices. If `local_control` is set to `True` states will be pulled from the devices controlling hub, not the online API.

### {% linkable_title Service `add_new_devices` %}
### {% linkable_title Service `pull_newly_added_devices_from_wink` %}

You can use the service wink/add_new_devices to pull any newly paired Wink devices to an already running instance of Home-Assistant. Any new devices will also be added if Home-Assistant is restarted.

### {% linkable_title Service `delete_wink_device` %}

You can use the service wink/delete_wink_device to remove/unpair a device from Wink.

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | no | String that points at the `entity_id` of device to delete.

### {% linkable_title Service `pair_new_device` %}

You can use the service wink/pair_new_device to pair a new device to your Wink hub/relay

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `hub_name` | no | The name of the hub to pair a new device to.
| `pairing_mode` | no | One of the following [zigbee, zwave, zwave_exclusion, zwave_network_rediscovery, lutron, bluetooth, kidde]
| `kidde_radio_code` | conditional | A string of 8 1s and 0s one for each dip switch on the kidde device left --> right = 1 --> 8 (Required if pairing_mode = kidde)

<p class='note'>
Calling service wink/pull_newly_added_wink_devices after a device is paired will add that new device to Home Assistant. The device will also show up on the next restart of Home Assistant.
</p>

### {% linkable_title Service `rename_wink_device` %}

You can use the service wink/rename_wink_device to change the name of a device.

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | no | String that points at the `entity_id` of device to rename.
| `name` | no | The name to change it to.

<p class='note'>
Home Assistant entity_ids for Wink devices are based on the Wink device's name. Calling this service will not change the entity_id of the deivce until Home Assistant is restarted.
</p>

<p class='note'>
The Wink hub, by default, can only be accessed via the cloud. This means it requires an active internet connection and you will experience delays when controlling and updating devices (~3s).
The Wink hub, by default, can only be accessed via the cloud. This means it requires an active internet connection and you will experience delays when controlling and updating devices (~3s).
</p>