You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/_addons/tellstick.markdown
+4-4Lines changed: 4 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -94,10 +94,10 @@ You can also use this to list devices or sensors and read the output in the add-
94
94
-`"function":"list-sensors"`
95
95
-`"function":"list-devices"`: Alternative devices/sensors listing: Shows devices and/or sensors using key=value format (with tabs as separators, one device/sensor per line, no header lines.)
96
96
97
-
-`"function":"on":"device":"x"`: Turns on device. ’x’ could either be an integer of the device-id, or the name of the device.
97
+
-`"function":"on","device":"x"`: Turns on device. ’x’ could either be an integer of the device-id, or the name of the device.
98
98
99
-
-`"function":"off":"device":"x"`: Turns off device. ’x’ could either be an integer of the device-id, or the name of the device.
99
+
-`"function":"off","device":"x"`: Turns off device. ’x’ could either be an integer of the device-id, or the name of the device.
100
100
101
-
-`"function":"bell":"device":"x"`: Sends bell command to devices supporting this. ’x’ could either be an integer of the device-id, or the name of the device.
101
+
-`"function":"bell","device":"x"`: Sends bell command to devices supporting this. ’x’ could either be an integer of the device-id, or the name of the device.
102
102
103
-
-`"function":"learn":"device":"x"`: Sends a special learn command to devices supporting this. This is normaly devices of ’selflearning’ type. ’x’ could either be an integer of the device-id, or the name of the device.
103
+
-`"function":"learn","device":"x"`: Sends a special learn command to devices supporting this. This is normaly devices of ’selflearning’ type. ’x’ could either be an integer of the device-id, or the name of the device.
Copy file name to clipboardExpand all lines: source/_components/alarm_control_panel.egardia.markdown
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ The `egardia` platform enables the ability to control an [Egardia](http://egardi
16
16
17
17
You will need to know the IP of your alarm panel on your local network. Test if you can login to the panel by browsing to the IP address and log in using your Egardia/Woonveilig account.
18
18
19
-
To enable this, add the following lines to your `configuration.yaml`:
19
+
To enable this, add the following lines to your `configuration.yaml` file:
You can find a list of frequently asked questions (and their answers) in [this blog post](https://home-assistant.io/blog/2017/12/17/introducing-home-assistant-cloud/#faq).
Copy file name to clipboardExpand all lines: source/_components/cover.zwave.markdown
+10-1Lines changed: 10 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
layout: page
3
3
title: "Z-Wave Cover"
4
4
description: "Instructions how to setup the Z-Wave covers within Home Assistant."
5
-
date: 2016-08-24 14:15
5
+
date: 2016-12-18 19:41
6
6
sidebar: true
7
7
comments: false
8
8
sharing: true
@@ -16,3 +16,12 @@ ha_iot_class: "Local Push"
16
16
Z-Wave garage doors, blinds, and roller shutters are supported as cover in Home Assistant.
17
17
18
18
To get your Z-Wave covers working with Home Assistant, follow the instructions for the general [Z-Wave component](/components/zwave/).
19
+
20
+
If you discover that you need to [invert the operation]](/docs/z-wave/installation/#invert_openclose_buttons) of open/close for a particular device, you may change this behavior in your Z-Wave section of your `configuration.yaml` file as follows:
Copy file name to clipboardExpand all lines: source/_components/device_tracker.unifi.markdown
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ Configuration variables:
33
33
- **password** (*Required*): The password for your given admin account.
34
34
- **site_id** (*Optional*): Allows you to specify a `site_id` for device tracking. Defaults to `default`. Found in the URL of the controller (i.e. https://CONTROLLER:PORT/manage/site/SITE_ID/dashboard).
35
35
- **verify_ssl** (*Optional*): Controls if the SSL certificate running on your Unifi webserver must be trusted by a known Certificate Authority on the server running Home Assistant. Defaults to 'True' but can also be a value that points to your custom cert "path/to/custom_cert.pem".
36
-
- **detection_time** (*Optional*): The Unifi component will not return a device that has not been seen by the controller in the last 180 seconds. You can adjust this threshold with this variable and accepts seconds or `00:00:00` time formats.
36
+
- **detection_time** (*Optional*): The Unifi component will only return devices that have been seen by the controller in the last 180 seconds. You can adjust this threshold with this variable and accepts seconds or `00:00:00` time formats.
37
37
38
38
See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked.
Copy file name to clipboardExpand all lines: source/_components/google_assistant.markdown
+26-20Lines changed: 26 additions & 20 deletions
Original file line number
Diff line number
Diff line change
@@ -13,14 +13,15 @@ featured: true
13
13
ha_release: 0.56
14
14
---
15
15
16
-
# Google Assistant Docs
16
+
The `google_assistant` component allows you to control things via Google Assistant (on your mobile or tablet) or a Google Home device.
17
+
17
18
The Google Assistant component requires a bit more setup than most due to the way Google requires Assistant Apps to be set up.
18
19
19
20
<pclass='note'>
20
21
To use Google Assistant your Home Assistant configuration has to be externally accessible, with a hostname and SSL certificate. If you haven't already configured that you should do so before continuing.
21
22
</p>
22
23
23
-
### {% linkable_title Configuration %}
24
+
To enable this, add the following lines to your `configuration.yaml` file:
24
25
25
26
```yaml
26
27
# Example configuration.yaml entry
@@ -36,20 +37,15 @@ google_assistant:
36
37
- group
37
38
```
38
39
39
-
*Note:* It's very important that you use very long strings for `client_id` and `access_token`. Those are essentially the credentials to your Home Assistant instance. You can generate them with the following command:
If you're not using Linux, you can use sites such as [this one](https://www.browserling.com/tools/random-string) to generate a random string (containing mixed case letters and numbers) of up to 80 characters.
40
+
Configuration variables:
44
41
45
-
*Configuration Variables:*
46
-
* *expose_by_default* (Optional): Expose devices in all supported domains by default.
47
-
* *project_id* (Required): Project ID from the Google Developer console (looks like `words-2ab12`)
48
-
* *client_id* (Required): A long random URL safe string (no spaces or special characters) that will be used for Implicit OAuth.
49
-
* *access_token* (Required): Another different long random URL safe string.
50
-
* *agent_user_id* (Optional): A string to identify the user, e.g., email address. If not provided, the component will generate one.
51
-
* *api_key* (Optional): An API Key generated for the project from [Google Console](https://console.cloud.google.com/apis/api/homegraph.googleapis.com/overview) which allows you to update devices without unlinking and relinking an account (see setup below). If not provided then the request_sync service is not exposed.
52
-
* *exposed_domains* (Optional): An array of Home Assistant domains to expose to Google Assistant. Options include:
42
+
- **expose_by_default** (*Optional*): Expose devices in all supported domains by default.
43
+
- **project_id** (*Required*): Project ID from the Google Developer console (looks like `words-2ab12`)
44
+
- **client_id** (*Required*): A long random URL safe string (no spaces or special characters) that will be used for Implicit OAuth.
45
+
- **access_token** (*Required*): Another different long random URL safe string.
46
+
- **agent_user_id** (*Optional*): A string to identify the user, e.g., email address. If not provided, the component will generate one.
47
+
- **api_key** (*Optional*): An API Key generated for the project from [Google Console](https://console.cloud.google.com/apis/api/homegraph.googleapis.com/overview) which allows you to update devices without unlinking and relinking an account (see setup below). If not provided then the request_sync service is not exposed.
48
+
- **exposed_domains** (*Optional*): An array of Home Assistant domains to expose to Google Assistant. Options include:
53
49
- `switch`
54
50
- `light`
55
51
- `cover`
@@ -60,6 +56,15 @@ If you're not using Linux, you can use sites such as [this one](https://www.brow
60
56
- `script`
61
57
- `climate`
62
58
59
+
It's very important that you use very long strings for `client_id` and `access_token`. Those are essentially the credentials to your Home Assistant instance. You can generate them with the following command:
If you're not using Linux, you can use sites such as [this one](https://www.browserling.com/tools/random-string) to generate a random string (containing mixed case letters and numbers) of up to 80 characters.
66
+
67
+
63
68
You can also customize your devices similar to other components by adding keys to entities:
64
69
65
70
```yaml
@@ -77,11 +82,12 @@ homeassistant:
77
82
google_assistant_type: light
78
83
```
79
84
80
-
*Entity Customization Keys:*
81
-
* *google_assistant*: True exposes entity, false will hide it
82
-
* *google_assistant_name*: Can be used to override the primary name of an entity. By default the `friendly_name` of an entity is used.
83
-
* *google_assistant_type*: Can be used to override the domain/type of an entity. For example a switch can be treated as a light
84
-
* *aliases*: Provides "nicknames" to Google Assistant. These function as alternate names for an entity that Assistant will understand when spoken.
85
+
Entity Customization Keys:
86
+
87
+
- **google_assistant**: True exposes entity, false will hide it.
88
+
- **google_assistant_name**: Can be used to override the primary name of an entity. By default the `friendly_name` of an entity is used.
89
+
- **google_assistant_type**: Can be used to override the domain/type of an entity. For example a switch can be treated as a light
90
+
- **aliases**: Provides "nicknames" to Google Assistant. These function as alternate names for an entity that Assistant will understand when spoken.
Copy file name to clipboardExpand all lines: source/_components/hue.markdown
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -127,15 +127,15 @@ script:
127
127
128
128
*Note*: `group_name` is not linked to Home Assistant group name.
129
129
130
-
*** Finding Group and Scene Names ***
130
+
### {% linkable_title Finding Group and Scene Names %}
131
131
132
132
How do you find these names?
133
133
134
134
The easiest way to do this is only use the scenes from the 2nd generation Hue app. That is organized by room (group) and scene Name. Use the values of room name and scene name that you see in the app. You can test these work on the `dev-service` console of your Home Assistant instance.
135
135
136
136
Alternatively, you can dump all rooms and scene names using this [gist](https://gist.github.com/sdague/5479b632e0fce931951c0636c39a9578). This does **not** tell you which groups and scenes work together but it's sufficient to get values that you can test in the `dev-service` console.
137
137
138
-
*** Caveats ***
138
+
### {% linkable_title Caveats %}
139
139
140
140
The Hue API doesn't activate scenes directly, only on a Hue Group (typically rooms, especially if using the 2nd gen app). But Hue Scenes don't actually reference their group. So heuristic matching is used.
0 commit comments