Skip to content

Commit 8660f52

Browse files
balloobballoob
committed
Merge remote-tracking branch 'origin/current' into next
2 parents ebd6648 + e464238 commit 8660f52

File tree

64 files changed

+476
-264
lines changed

Some content is hidden

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

64 files changed

+476
-264
lines changed

‎sass/custom/_paulus.scss

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -101,23 +101,38 @@ $primary-color: #049cdb;
101101

102102
.frontpage {
103103

104-
.current-version {
105-
margin-bottom: 16px;
104+
.material-card {
105+
margin-bottom: 24px;
106+
}
106107

108+
.current-version {
107109
.release-date {
108110
white-space: nowrap;
109111
}
110112

111113
}
112114

113115
.recent-posts {
114-
margin-bottom: 16px;
115-
116116
.blog-date {
117117
white-space: nowrap;
118118
}
119119
}
120120

121+
.founder-vision {
122+
display: block;
123+
text-decoration: none;
124+
color: white;
125+
padding: 15px;
126+
font-size: 2.25rem;
127+
line-height: 1.33333;
128+
transition: background-color .5s;
129+
background-color: #038FC7;
130+
131+
&:hover {
132+
background-color: lighten(#038FC7, 10%);
133+
}
134+
}
135+
121136
.shirt-promo {
122137
display: block;
123138
padding-top: 30%;
@@ -162,6 +177,15 @@ $primary-color: #049cdb;
162177
}
163178
}
164179

180+
.seen-press {
181+
margin-top: 24px;
182+
183+
img {
184+
border: 0;
185+
box-shadow: none;
186+
margin: 15px;
187+
}
188+
}
165189
}
166190

167191
// https://fortawesome.github.io/Font-Awesome/3.2.1/icons/

‎source/_addons/dhcp_server.markdown

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Configuration variables:
4747
 - **range_end** (*Required*): End address for dhcp leases.
4848
 - **broadcast** (*Required*): Network broadcast address.
4949
 - **gateway** (*Required*): A List of gateways.
50-
- **interface** (*Required*): Inteface on that will be listen.
50+
- **interface** (*Required*): Inteface on that will be listen. Normaly is `eth0` for ethernet wired connection and `wlan0` for wireless connection.
5151
- **hosts** (*Optional*): A list of fixed IPs for devices.
5252
- **name** (*Required*): Name/hostname of your device.
5353
 - **mac** (*Required*): Mac address of your device.

‎source/_addons/dnsmasq.markdown

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,4 +33,4 @@ Configuration variables:
3333
- **defaults** (*Required*): A list of dns server to forward default requests.
3434
- **forwards** (*Optional*): A list of domains that will forward to a specific server.
3535
- **hosts** (*Optional*): A list of hosts to resolve it static.
36-
- **interface** (*Optional*): If a interface is set, it listen only on this interface. Need to set for resinos.
36+
- **interface** (*Optional*): If a interface is set, it listen only on this interface. Need to set for resinos. Normaly is `eth0` for ethernet wired connection and `wlan0` for wireless connection.

‎source/_addons/duckdns.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
[Duck DNS](https://duckdns.org/) is a free service which will point a DNS (sub domains of duckdns.org) to an IP of your choice.

‎source/_addons/google_assistant.markdown

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
layout: page
3+
title: "Google Assistant"
4+
description: "Enhance your Hass.io installation with Google Assistant."
5+
date: 2017-04-30 13:28
6+
sidebar: true
7+
comments: false
8+
sharing: true
9+
footer: true
10+
featured: true
11+
---
12+
13+
[Google Assistant][GoogleAssistant] is an AI-powered voice assistant that runs on the Raspberry Pi and x86 platforms and interact over [api.ai] with Home-Assistant. You can also use [Google Actions][GoogleActions] to extend its functionality.
14+
15+
To enable access to the Google Assistant API, do the following:
16+
17+
1. In the [Cloud Platform Console][project], go to the Projects page. Select an existing project or create a new project
18+
2. Open the project. In the top of the page search for Google Assistant API or use [this link][API] and enable it.
19+
3. Create an [OAuth Client ID][oauthclient], pick type "Other", click "Create" and download the JSON file by clicking the Download JSON button on the right side.
20+
21+
Now install and activate the [Samba] add-on so you can upload your credential file. Connect to the "share" Samba share and copy your credentials over. Name the file `google_assistant.json`.
22+
23+
Now it's time to start Google Assistant for the first time. When the Google Assistant add-on starts, it will output your audio devices in the "Logs" card. You might have to hit "refresh" to get the latest logs:
24+
25+
```text
26+
**** List of PLAYBACK Hardware Devices ****
27+
card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
28+
Subdevices: 8/8
29+
Subdevice #0: subdevice #0
30+
Subdevice #1: subdevice #1
31+
Subdevice #2: subdevice #2
32+
Subdevice #3: subdevice #3
33+
Subdevice #4: subdevice #4
34+
Subdevice #5: subdevice #5
35+
Subdevice #6: subdevice #6
36+
Subdevice #7: subdevice #7
37+
card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
38+
Subdevices: 1/1
39+
Subdevice #0: subdevice #0
40+
card 1: Microphone [Yeti Stereo Microphone], device 0: USB Audio [USB Audio]
41+
Subdevices: 1/1
42+
Subdevice #0: subdevice #0
43+
```
44+
45+
You need to use this information to point the add-on at the right speakers and microphone. The information describes different cards and devices. On a Raspberry Pi 3, card 0 - device 0 is the built-in headset port, card 0 - device 1 is the HDMI port. In the example above, the USB microphone showed up as card 1 - device 0.
46+
47+
Find the microphone and speakers that you want to use and note down their device and card number. We will need that to configure the add-on options `mic` (microphone to use) and `speaker` (speaker to use). The format for these options is `<card #>,<device #>`. Change the configuration options and click save.
48+
49+
The next step is to authenticate your Google account with Google Assistant. Start the add-on and click on the "OPEN WEB UI" button to start authentication.
50+
51+
### Add-On configuration
52+
53+
Configuration example that uses the USB microphone and use the built-in headset audio output on the Raspberry Pi. Note that card and device numbers can differ on your device.
54+
55+
```json
56+
{
57+
"mic": "1,0",
58+
"speaker": "0,0",
59+
"client_secrets": "google_assistant.json",
60+
}
61+
```
62+
63+
Configuration variables:
64+
65+
- **mic**: This is the hardware address of your microphone. Look at the add-on output
66+
- **speaker**: This is the hardware address of your speakers. Look at the add-on output
67+
68+
### {% linkable_title Home Assistant configuration %}
69+
70+
Use the Home Assistant [api.ai component][comp] to integrate the add-on into Home Assistant.
71+
72+
73+
[GoogleAssistant]: https://assistant.google.com/
74+
[GoogleActions]: https://actions.google.com/
75+
[api.ai]: https://api.ai/
76+
[Samba]: /addons/samba/
77+
[comp]: /components/apiai/
78+
[project]: https://console.cloud.google.com/project
79+
[API]: https://console.developers.google.com/apis/api/embeddedassistant.googleapis.com/overview
80+
[oauthclient]: https://console.developers.google.com/apis/credentials/oauthclient

‎source/_addons/lets_encrypt.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
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.

‎source/_addons/mosquitto.markdown

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
Set up a [mosquitto](https://mosquitto.org/) MQTT broker.
@@ -18,7 +19,11 @@ Set up a [mosquitto](https://mosquitto.org/) MQTT broker.
1819
"anonymous": true,
1920
"logins": [
2021
{"username": "testuser", "password": "mypw"}
21-
]
22+
],
23+
"customize": {
24+
"active": false,
25+
"folder": "mosquitto
26+
}
2227
}
2328
```
2429

@@ -30,6 +35,7 @@ Configuration variables:
3035
- **ssl** (*Optional*): Listen to broker on port 8883 with SSL/TLS. This requires certificates. Defaults to `false`.
3136
- **anonymous** (*Optional*): Allow anonymous connection. If *logins* is set, anonymous user can only read data. Defaults to `true`.
3237
- **logins** (*Optional*): A list of user that will be created with *username* and *password*.
38+
- **customize** (*Optional*): If you enable it, it read additional config files (`*.conf`) from `/share/mosquitto`.
3339

3440
### {% linkable_title Home Assistant configuration %}
3541

‎source/_addons/samba.markdown

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
This allows you to set up a [Samba](https://samba.org/) server to access hass.io folders using Windows network shares.
@@ -16,11 +17,16 @@ This allows you to set up a [Samba](https://samba.org/) server to access hass.io
1617
"name": "hassio",
1718
"workgroup": "WORKGROUP",
1819
"guest": true,
19-
"map_config": true,
20-
"map_addons": true,
21-
"map_ssl": false,
20+
"map": {
21+
"config": true,
22+
"addons": true,
23+
"share": true,
24+
"backup": true,
25+
"ssl": false,
26+
},
2227
"username": "",
23-
"password": ""
28+
"password": "",
29+
"interface": "eth0"
2430
}
2531
```
2632

@@ -29,8 +35,7 @@ Configuration variables:
2935
- **name** (*Optional*): default `hassio`. Set netbios name of hassio device.
3036
- **workgroup** (*Optional*): default `WORKGROUP`. Set network workgroup.
3137
- **guest** (*Optional*): Allow login without a username or password. Defaults to `true`.
32-
- **map_config** (*Optional*): Expose Home Assistant configuration folder. Defaults to `true`.
33-
- **map_addons** (*Optional*): Expose local custom addons folder. Defaults to `true`.
34-
- **map_ssl** (*Optional*): Expose SSL folder. Be careful with this option! Defaults to `false`.
38+
- **map** (*Optional*): Control whitch folder will be expose. `config` is for Home Assistant configuration folder. `addons` for local custom repositiory. `share` is a folder that can access from add-ons and Home Assistant too. `backup` for access to snapshot files. `ssl` for certificate storage, be careful with this option! Defaults to `true`.
3539
- **username** (*Optional*): The username for logging in if guest login is not used.
3640
- **password** (*Optional*): Password for `username`. An empty password is not supported.
41+
- **interface** (*Optional*): Interface on that will start the share. Normaly is `eth0` for ethernet wired connection and `wlan0` for wireless connection.

‎source/_addons/snips.markdown

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Now install and activate the [Samba] add-on so you can upload your training data
1717

1818
Now it's time to start Snips for the first time. When the Snips add-on starts, it will output your audio devices:
1919

20-
```plain
20+
```text
2121
**** List of PLAYBACK Hardware Devices ****
2222
card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
2323
Subdevices: 8/8
@@ -34,9 +34,11 @@ card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
3434
Subdevice #0: subdevice #0
3535
```
3636

37-
You need to use this information to configure the `mic` and `speaker` configuration options. The format is `<card #>,<device #>`. On a Raspberry Pi 3, `0,0` is the built-in headset port, `0,1` is the HDMI port.
37+
You need to use this information to point the add-on at the right speakers and microphone. The information describes different cards and devices. On a Raspberry Pi 3, card 0 - device 0 is the built-in headset port, card 0 - device 1 is the HDMI port. In the example above, the USB microphone showed up as card 1 - device 0.
3838

39-
Now that you've found the microphone and speaker addresses, it's time to configure Snips and restart the add-on.
39+
Find the microphone and speakers that you want to use and note down their device and card number. We will need that to configure the add-on options `mic` (microphone to use) and `speaker` (speaker to use). The format for these options is `<card #>,<device #>`. Change the configuration options and click save.
40+
41+
Now start the add-on.
4042

4143
### Add-On configuration
4244

‎source/_addons/ssh.markdown

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,13 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

12-
Setting up an [SSH](https://openssh.org/) server allows access to your Hass.io folders with any SSH client.
13+
Setting up an [SSH](https://openssh.org/) server allows access to your Hass.io folders with any SSH client. It include also a cli to access into Hass.IO api. Try it out:
14+
```bash
15+
$ hassio help
16+
```
1317

1418
<p class='note'>This add-on will not enable you to install packages or do anything as root. This is not allowed with Hass.io.</p>
1519

‎source/_components/binary_sensor.markdown

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,35 @@
11
---
22
layout: page
33
title: "Binary Sensor"
4-
description: "Instructions how to setup your binary sensors with Home Assistant."
4+
description: "Instructions on how-to setup binary sensors with Home Assistant."
55
date: 2015-11-20 14:00
66
sidebar: true
77
comments: false
88
sharing: true
99
footer: true
1010
---
1111

12-
Binary sensors are gathering information about state of switches, contacts, pins, and alike. The return value of those sensors is usually digital (1/0). This means that those sensors knows only two states: **0/off/low/closed/false** and **1/on/high/open/true**.
12+
Binary sensors gather information about state of switches, contacts, pins, and alike. The return value of those sensors is usually digital (1/0). This means that those sensors knows only two states: **0/off/low/closed/false** and **1/on/high/open/true**.
1313

14-
Knowing that there are only two states allows Home Assistant to represent the sensor better in the frontend.
14+
Knowing that there are only two states allows Home Assistant to represent these sensors in a better way in the frontend according to their functionality.
1515

16-
The display style of each entity can be modified in the [customize section](/getting-started/customizing-devices/). The following device classes are supported for binary sensors:
16+
The way these sensors are displayed in the frontend can be modified in the [customize section](/getting-started/customizing-devices/). The following device classes are supported for binary sensors:
1717

1818
- **None**: Generic on/off
19-
- **cold**: On means cold (or too cold)
20-
- **connectivity**: On means connection present, Off means no connection
21-
- **gas**: CO, CO2, etc
22-
- **heat**: On means hot (or too hot)
19+
- **cold**: `On` means cold
20+
- **connectivity**: `On` means connection present, `Off` means no connection
21+
- **gas**: `On` means gas detected
22+
- **heat**: `On` means hot
2323
- **light**: Lightness threshold
24-
- **moisture**: Specifically a wetness sensor
25-
- **motion**: Motion sensor
26-
- **moving**: On means moving, Off means stopped
27-
- **occupancy**: On means occupied, Off means not occupied
28-
- **opening**: Door, window, etc. On means open, Off means closed
29-
- **power**: Power, over-current, etc
30-
- **safety**: On means unsafe, Off means safe
31-
- **smoke**: Smoke detector
32-
- **sound**: On means sound detected, Off means no sound
33-
- **vibration**: On means vibration detected, Off means no vibration
24+
- **moisture**: `On` means wet
25+
- **motion**: `On` means motion detected
26+
- **moving**: `On` means moving, `Off` means stopped
27+
- **occupancy**: `On` means occupied, `Off` means not occupied
28+
- **opening**: `On` means open, `Off` means closed
29+
- **power**: Power, over-current, etc.
30+
- **safety**: `On` means unsafe, `Off` means safe
31+
- **smoke**: `On` means smoke detected
32+
- **sound**: `On` means sound detected, `Off` means no sound
33+
- **vibration**: `On` means vibration detected, `Off` means no vibration
3434

3535
For analog sensors please check the [component overview](https://home-assistant.io/components/#sensor).

‎source/_components/discovery.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,7 @@ Valid values for ignore are:
5454

5555
* `apple_tv`: Apple TV
5656
* `axis`: (Axis Communications security devices)
57+
* `bose_soundtouch`: Bose Soundtouch speakers
5758
* `denonavr`: Denon Network Receivers
5859
* `directv`: DirecTV
5960
* `flux_led`: Flux Led/MagicLight

0 commit comments

Comments
 (0)