Skip to content

Commit 0ac6fd0

Browse files
balloobballoob
committed
Merge branch 'current' into next
2 parents 57701f8 + 245d428 commit 0ac6fd0

File tree

103 files changed

+1627
-743
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

103 files changed

+1627
-743
lines changed

‎_config.yml

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,8 @@ collections:
7575
output: true
7676
docs:
7777
output: true
78+
addons:
79+
output: true
7880

7981
# ----------------------- #
8082
# 3rd Party Settings #
@@ -139,9 +141,10 @@ social:
139141
# Home Assistant release details
140142
current_major_version: 0
141143
current_minor_version: 43
142-
current_patch_version: 0
143-
date_released: 2017-04-22
144+
current_patch_version: 2
145+
date_released: 2017-04-27
144146

145147
# Either # or the anchor link to latest release notes in the blog post.
146148
# Must be prefixed with a # and have double quotes around it.
147-
patch_version_notes: ""
149+
# Example #release-0431---april-25
150+
patch_version_notes: "#release-0432---april-27"

‎source/_addons/lets_encrypt.markdown

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
layout: page
3+
title: "Let's Encrypt"
4+
description: "Automatically manage your SSL certificate using Let's Encrypt."
5+
date: 2017-04-30 13:28
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
---
11+
12+
Setup and manage a [Let's Encrypt](https://letsencrypt.org/) certificate. This will create a certificate on the first run and renew it if the certificate is expiring in the next 30 days.
13+
14+
```json
15+
{
16+
"email": "example@example.com",
17+
"domains": ["example.com", "mqtt.example.com", "hass.example.com"]
18+
}
19+
```
20+
21+
Configuration variables:
22+
23+
- **email** (*Required*): Your email address for registration on Let's Encrypt.
24+
- **domains** (*Required*): A list of domains to create/renew the certificate.

‎source/_addons/mosquitto.markdown

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
layout: page
3+
title: "Mosquitto MQTT broker"
4+
description: "Fast and reliable MQTT broker."
5+
date: 2017-04-30 13:28
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
---
11+
12+
Set up a [mosquitto](https://mosquitto.org/) MQTT broker.
13+
14+
```json
15+
{
16+
"plain": true,
17+
"ssl": false,
18+
"anonymous": true,
19+
"logins": [
20+
{"username": "testuser", "password": "mypw"}
21+
]
22+
}
23+
```
24+
25+
Configuration variables:
26+
27+
- **plain** (*Optional*): Listen to broker on port 1883 without SSL/TLS. Defaults to `true`.
28+
- **ssl** (*Optional*): Listen to broker on port 8883 with SSL/TLS. This requires certificates. Defaults to `false`.
29+
- **anonymous** (*Optional*): Allow anonymous connection. If *logins* is set, anonymous user can only read data. Defaults to `true`.
30+
- **logins** (*Optional*): A list of user that will be created with *username* and *password*.

‎source/_addons/samba.markdown

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
layout: page
3+
title: "Samba"
4+
description: "Manage your Home Assistant and custom addons over Samba."
5+
date: 2017-04-30 13:28
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
---
11+
12+
This allows you to set up a [Samba](https://samba.org/) server to access hass.io folders using Windows network shares.
13+
14+
```json
15+
{
16+
"workgroup": "WORKGROUP",
17+
"guest": true,
18+
"map_config": true,
19+
"map_addons": true,
20+
"map_ssl": false,
21+
"username": "",
22+
"password": ""
23+
}
24+
```
25+
26+
Configuration variables:
27+
28+
- **workgroup** (*Optional*): default `WORKGROUP`. Set network workgroup.
29+
- **guest** (*Optional*): Allow login without a username or password. Defaults to `true`.
30+
- **map_config** (*Optional*): Expose Home Assistant configuration folder. Defaults to `true`.
31+
- **map_addons** (*Optional*): Expose local custom addons folder. Defaults to `true`.
32+
- **map_ssl** (*Optional*): Expose SSL folder. Be careful with this option! Defaults to `false`.
33+
- **username** (*Optional*): The username for logging in if guest login is not used.
34+
- **password** (*Optional*): Password for `username`. An empty password is not supported.

‎source/_addons/ssh.markdown

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
layout: page
3+
title: "SSH Server"
4+
description: "Allow logging in remotely to your server using SSH."
5+
date: 2017-04-30 13:28
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
---
11+
12+
Setting up a [SSH](https://openssh.org/) server allows access to hass.io folders with SSH client. It also allows tunneling for access from an external network. Please note that you only need to do this on a ResinOS platform as most Linux flavors have their own SSH server.
13+
14+
```json
15+
{
16+
"authorized_keys": [
17+
"ssh-rsa AKDJD3839...== my-key"
18+
]
19+
}
20+
```
21+
22+
Configuration variables:
23+
24+
- **authorized_keys** (*Required*): Your public-keys for authorized keyfile. Every element will be a line inside that file.

‎source/_components/alarm_control_panel.totalconnect.markdown

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ ha_release: 0.42
1414

1515
The `totalconnect` platform provides connectivity with the Honeywell TotalConnect alarm systems used by many alarm companies.
1616

17+
If you have issues running this component, you may require "libxml2-dev" and "libxmlsec1-dev". To install these on Hassbian, run the command `apt install libxml2-dev libxmlsec1-dev` with sudo
18+
1719
To enable this, add the following lines to your `configuration.yaml`:
1820

1921
```yaml

‎source/_components/alexa.markdown

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,34 @@ text: !include alexa_confirm.yaml
306306

307307
Alexa will now respond with a random phrase each time. You can use the include for as many different intents as you like so you only need to create the list once.
308308

309+
<p class='note'>
310+
As of April 2017, the random filter has been somewhat broken. You'll get a random response the first time this runs, but subsequent commands will reply with the same randomly-chosen phrase. On reboot, Home Assistant will pick a new random choice, but you're stuck with that choice till you reboot. To get around that, use the following code in alexa_confirm.yaml:
311+
</p>
312+
313+
```text
314+
{% raw %} >
315+
{% set responses = [
316+
"OK",
317+
"Sure",
318+
"If you insist",
319+
"Done",
320+
"No worries",
321+
"I can do that",
322+
"Leave it to me",
323+
"Consider it done",
324+
"As you wish",
325+
"By your command",
326+
"Affirmative",
327+
"Yes oh revered one",
328+
"I will",
329+
"As you decree, so shall it be",
330+
"No Problem"
331+
] %}
332+
{% set rindex = (range(0, (responses | length - 1) )|random) -%}
333+
{{responses[rindex]}}
334+
{% endraw %}
335+
```
336+
309337

310338
## {% linkable_title Flash Briefing Skills %}
311339

‎source/_components/binary_sensor.iss.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ footer: true
1010
logo: nasa.png
1111
ha_category: Binary Sensor
1212
ha_release: 0.36
13+
redirect_from: /components/sensor.iss/
1314
---
1415

1516
The `iss` platform uses the [Open Notify API](http://open-notify.org/Open-Notify-API/ISS-Location-Now/) to let you know if the station is above your home location. This means that ISS is 10° above the horizon of your home.

‎source/_components/binary_sensor.ping.markdown

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ comments: false
88
sharing: true
99
footer: true
1010
logo: home-assistant.png
11-
ha_category: Binary sensor
11+
ha_category: Binary Sensor
1212
ha_release: 0.43
1313
---
1414

‎source/_components/climate.tado.markdown

Lines changed: 3 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
layout: page
3-
title: "Tado"
3+
title: "Tado Thermostat"
44
description: "Instructions on how to integrate Tado thermostats with Home Assistant."
55
date: 2017-03-20 12:00
66
sidebar: true
@@ -13,20 +13,8 @@ ha_release: 0.41
1313
---
1414

1515

16-
The `tado` component platform is used as an interface to the my.tado.com website. It adds climate devices for every tado zone and sensors for some additional information of the zones.
16+
The `tado` climate platform is interact with your climate devices.
1717

18-
To use your tado thermostats in your installation, add the following to your `configuration.yaml` file:
1918

20-
```yaml
21-
# Example configuration.yaml entry
22-
tado:
23-
username: YOUR_USERNAME
24-
password: YOUR_PASSWORD
25-
```
19+
The requirement is that you have set up the [tado](/components/tado/) component.
2620

27-
- **username** (*Required*): Username for my.tado.com.
28-
- **password** (*Required*): Password for my.tado.com.
29-
30-
The tado thermostats are internet connected thermostats. There exists an unofficial api at my.tado.com, which is used by theire website and now by this component.
31-
32-
It currently supports presenting the current temperature, the setting temperature and the current operation mode. Switching the mode is also supported. If no user is at home anymore, the devices are showing the away-state. Switching to away-mode is not supported.

‎source/_components/cover.command_line.markdown

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,12 @@ To enable a command line cover in your installation, add the following to your `
2020
```yaml
2121
# Example configuration.yaml entry
2222
cover:
23-
- platform: command_line
24-
covers:
25-
garage_door:
26-
command_open: move_command up garage
27-
command_close: move_command down garage
28-
command_stop: move_command stop garage
23+
- platform: command_line
24+
covers:
25+
garage_door:
26+
command_open: move_command up garage
27+
command_close: move_command down garage
28+
command_stop: move_command stop garage
2929
```
3030
3131
Configuration variables:
@@ -48,18 +48,18 @@ In this section you find some real life examples of how to use this sensor.
4848
```yaml
4949
# Example configuration.yaml entry
5050
cover:
51-
- platform: command_line
52-
covers:
53-
garage_door:
54-
command_open: move_command up garage
55-
command_close: move_command down garage
56-
command_stop: move_command stop garage
57-
command_state: state_command garage
58-
value_template: {% raw %}>
59-
{% if value == 'open' %}
60-
100
61-
{% elif value == 'closed' %}
62-
0
63-
{% endif %}
64-
{% endraw %}
51+
- platform: command_line
52+
covers:
53+
garage_door:
54+
command_open: move_command up garage
55+
command_close: move_command down garage
56+
command_stop: move_command stop garage
57+
command_state: state_command garage
58+
value_template: {% raw %}>
59+
{% if value == 'open' %}
60+
100
61+
{% elif value == 'closed' %}
62+
0
63+
{% endif %}
64+
{% endraw %}
6565
```

‎source/_components/cover.garadget.markdown

Lines changed: 25 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -20,26 +20,25 @@ To enable Garadget Covers in your installation, add the following to your `confi
2020
```yaml
2121
# Example configuration.yaml entry
2222
cover:
23-
platform: garadget
24-
covers:
25-
190028001947343412342341:
26-
username: UseYourLogin@garadget.com
27-
password: abc123
28-
name: Left Garage Door
23+
- platform: garadget
24+
covers:
25+
190028001947343412342341:
26+
username: UseYourLogin@garadget.com
27+
password: abc123
2928
4c003f001151353432134214:
3029
access_token: df4cc785ff818f2b01396c44142342fccdef
3130
```
3231
3332
Configuration variables:
3433
3534
- **covers** array (*Required*): List of your doors.
36-
- **device** (*Required*): This is the device id from your Garadget portal.
35+
- **device** (*Required*): This is the device id from your Garadget portal.
3736
- Either:
3837
- **username** (*Required*): Your Garadget account username.
3938
- **password** (*Required*): Your Garadget account password.
4039
- Or:
41-
- **access_token** (*Required*): A generated access_token from your garadget account
42-
- **name** (*Optional*): Name to use in the Frontend, will use name configured in Garadget otherwise.
40+
- **access_token** (*Required*): A generated `access_token` from your Garadget account.
41+
- **name** (*Optional*): Name to use in the frontend, will use name configured in Garadget otherwise.
4342

4443

4544
If provided, the **access_token** will be used, otherwise the **username** and **password** will be used to automatically generate an access token at start time.
@@ -53,25 +52,25 @@ If provided, the **access_token** will be used, otherwise the **username** and *
5352
```yaml
5453
# Related configuration.yaml entry
5554
cover:
56-
platform: garadget
57-
covers:
58-
190028001947343412342341:
59-
access_token: !secret garadget_access_token
60-
name: Garage door
55+
- platform: garadget
56+
covers:
57+
190028001947343412342341:
58+
access_token: !secret garadget_access_token
59+
name: Garage door
6160
6261
sensor:
63-
platform: template
64-
sensors:
65-
garage_door_status:
66-
friendly_name: 'State of the door'
67-
value_template: {% raw %}'{{ states.cover.garage_door.state }}'{% endraw %}
68-
garage_door_time_in_state:
69-
friendly_name: 'Since'
70-
value_template: {% raw %}'{{ states.cover.garage_door.attributes["time in state"] }}'{% endraw %}
71-
garage_door_wifi_signal_strength:
72-
friendly_name: 'WiFi strength'
73-
value_template: {% raw %}'{{ states.cover.garage_door.attributes["wifi signal strength (dB)"] }}'{% endraw %}
74-
unit_of_measurement: 'dB'
62+
- platform: template
63+
sensors:
64+
garage_door_status:
65+
friendly_name: 'State of the door'
66+
value_template: {% raw %}'{{ states.cover.garage_door.state }}'{% endraw %}
67+
garage_door_time_in_state:
68+
friendly_name: 'Since'
69+
value_template: {% raw %}'{{ states.cover.garage_door.attributes["time in state"] }}'{% endraw %}
70+
garage_door_wifi_signal_strength:
71+
friendly_name: 'WiFi strength'
72+
value_template: {% raw %}'{{ states.cover.garage_door.attributes["wifi signal strength (dB)"] }}'{% endraw %}
73+
unit_of_measurement: 'dB'
7574
7675
group:
7776
garage_door:

0 commit comments

Comments
 (0)