jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-24 09:46:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'current' into next

Browse Source
This commit is contained in:
Paulus Schoutsen 2018-02-27 21:54:17 -08:00
commit 73fc2cebd2
12 changed files with 143 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
_config.yml
View File

@ -146,7 +146,7 @@ date_released: 2018-02-26
# Either # or the anchor link to latest release notes in the blog post.
# Must be prefixed with a # and have double quotes around it.
# Major release:
patch_version_notes: "#"
patch_version_notes: "#release-0641---february-27"
# Minor release (Example #release-0431---april-25):
# Date we moved to Discourse for comments

2
source/_components/deconz.markdown
View File

@ -101,6 +101,8 @@ Typical values for switches, the event codes are 4 numbers where the first and l
Where for example on a Philips Hue Dimmer, 2001 would be holding the dim up button.
For the IKEA Tradfri remote, 1 is the middle button, 2 is up, 3 is down, 4 is left, and 5 is right.
## {% linkable_title Examples %}
### {% linkable_title Step up and step down input number with wireless dimmer %}

2
source/_components/notify.nfandroidtv.markdown
View File

@ -52,7 +52,7 @@ This is a fully customized JSON you can use to test how the final notification w
"duration":2,
"transparency":"0%",
"color": "red",
"interrupt": 1,
"interrupt": 1
}
}
```

29
source/_components/recorder.markdown
View File

@ -156,13 +156,32 @@ If the `recorder` component is activated then some components support `restore_s
| PostgreSQL | `postgresql://scott:tiger@SERVER_IP/DB_NAME` |
| MS SQL Server | `mssql+pymssql://user:pass@SERVER_IP/DB_NAME?charset=utf8` |
+<p class='note'>
+If you are running a database server instance on the same server as Home Assistant then you must ensure that this service starts before Home Assistant. For a Linux instance running Systemd (Raspberry Pi, Debian, Ubuntu and others) then you should edit the file /etc/systemd/system/home-assistant@homeassistant.service as root (e.g. sudo nano /etc/systemd/system/home-assistant@homeassistant.service) and add the service - for PostgreSQL:
+```
+[Unit]
+Description=Home Assistant
+After=network.target postgresql.service
+```
+</p>
## {% linkable_title Installation notes %}
Not all Python bindings for the chosen database engine can be installed directly. This section contains additional details which should help you to get it working.
### {% linkable_title MariaDB and MySQL %}
For MariaDB you may have to install a few dependencies. On the Python side we use the `mysqlclient`:
If you are in a virtual environment, don't forget to activate it before installing the `mysqlclient` Python package described below.
```bash
pi@homeassistant:~ $ sudo su homeassistant -s /bin/bash
homeassistant@homeassistant:~$ source /srv/homeassistant/bin/activate
(homeassistant) homeassistant@homeassistant:~$ pip3 install mysqlclient
```
For MariaDB you may have to install a few dependencies. If you're using MariaDB version 10.2, libmariadbclient-dev was renamed to libmariadb-dev, please install the correct package based on your MariaDB version.
On the Python side we use the `mysqlclient`:
```bash
$ sudo apt-get install libmariadbclient-dev libssl-dev
@ -176,14 +195,6 @@ $ sudo apt-get install default-libmysqlclient-dev libssl-dev
$ pip3 install mysqlclient
```
If you are in a virtual environment, don't forget to activate it before installing the `mysqlclient` Python package.
```bash
pi@homeassistant:~ $ sudo su homeassistant -s /bin/bash
homeassistant@homeassistant:~$ source /srv/homeassistant/bin/activate
(homeassistant) homeassistant@homeassistant:~$ pip3 install mysqlclient
```
After installing the dependencies, it is required to create the database manually. During the startup, Home Assistant will look for the database specified in the `db_url`. If the database doesn't exist, it will not automatically create it for you.
Once Home Assistant finds the database, with right level of permissions, all the required tables will then be automatically created and the data will be populated accordingly.

20
source/_components/telegram_bot.markdown
View File

@ -29,7 +29,7 @@ Send a notification.
|---------------------------|----------|--------------------------------------------------|
| `message` | no | Message body of the notification. |
| `title` | yes | Optional title for your notification. Will be composed as '%title\n%message'. |
| `target` | yes | An array of pre-authorized chat_ids to send the notification to. Defaults to the first allowed chat_id. |
| `target` | yes | An array of pre-authorized chat_ids or user_ids to send the notification to. Defaults to the first allowed chat_id. |
| `parse_mode` | yes | Parser for the message text: `html` or `markdown`. |
| `disable_notification` | yes | True/false for send the message silently. iOS users and web users will not receive a notification, Android users will receive a notification with no sound. Defaults to False. |
| `disable_web_page_preview`| yes | True/false for disable link previews for links in the message. |
@ -47,7 +47,7 @@ Send a photo.
| `username` | yes | Username for a URL which require HTTP basic authentication. |
| `password` | yes | Password for a URL which require HTTP basic authentication. |
| `authentication` | yes | Define which authentication method to use. Set to `digest` to use HTTP digest authentication. Defaults to `basic`. |
| `target` | yes | An array of pre-authorized chat_ids to send the notification to. Defaults to the first allowed chat_id. |
| `target` | yes | An array of pre-authorized chat_ids or user_ids to send the notification to. Defaults to the first allowed chat_id. |
| `disable_notification` | yes | True/false for send the message silently. iOS users and web users will not receive a notification, Android users will receive a notification with no sound. Defaults to False. |
| `keyboard` | yes | List of rows of commands, comma-separated, to make a custom keyboard. Example: `["/command1, /command2", "/command3"]` |
| `inline_keyboard` | yes | List of rows of commands, comma-separated, to make a custom inline keyboard with buttons with associated callback data. Example: `["/button1, /button2", "/button3"]` or `[[["Text btn1", "/button1"], ["Text btn2", "/button2"]], [["Text btn3", "/button3"]]]` |
@ -64,7 +64,7 @@ Send a video.
| `username` | yes | Username for a URL which requires HTTP basic authentication. |
| `password` | yes | Password for a URL which requires HTTP basic authentication. |
| `authentication` | yes | Define which authentication method to use. Set to `digest` to use HTTP digest authentication. Defaults to `basic`. |
| `target` | yes | An array of pre-authorized chat_ids to send the notification to. Defaults to the first allowed chat_id. |
| `target` | yes | An array of pre-authorized chat_ids or user_ids to send the notification to. Defaults to the first allowed chat_id. |
| `disable_notification` | yes | True/false to send the message silently. iOS users and web users will not receive a notification. Android users will receive a notification with no sound. Defaults to False. |
| `keyboard` | yes | List of rows of commands, comma-separated, to make a custom keyboard. Example: `["/command1, /command2", "/command3"]` |
| `inline_keyboard` | yes | List of rows of commands, comma-separated, to make a custom inline keyboard with buttons with associated callback data. Example: `["/button1, /button2", "/button3"]` or `[[["Text btn1", "/button1"], ["Text btn2", "/button2"]], [["Text btn3", "/button3"]]]` |
@ -80,7 +80,7 @@ Send a document.
| `username` | yes | Username for a URL which require HTTP basic authentication. |
| `password` | yes | Password for a URL which require HTTP basic authentication. |
| `authentication` | yes | Define which authentication method to use. Set to `digest` to use HTTP digest authentication. Defaults to `basic`. |
| `target` | yes | An array of pre-authorized chat_ids to send the notification to. Defaults to the first allowed chat_id. |
| `target` | yes | An array of pre-authorized chat_ids or user_ids to send the notification to. Defaults to the first allowed chat_id. |
| `disable_notification` | yes | True/false for send the message silently. iOS users and web users will not receive a notification, Android users will receive a notification with no sound. Defaults to False. |
| `keyboard` | yes | List of rows of commands, comma-separated, to make a custom keyboard. Example: `["/command1, /command2", "/command3"]` |
| `inline_keyboard` | yes | List of rows of commands, comma-separated, to make a custom inline keyboard with buttons with associated callback data. Example: `["/button1, /button2", "/button3"]` or `[[["Text btn1", "/button1"], ["Text btn2", "/button2"]], [["Text btn3", "/button3"]]]` |
@ -92,7 +92,7 @@ Send a location.
|---------------------------|----------|--------------------------------------------------|
| `latitude` | no | The latitude to send. |
| `longitude` | no | The longitude to send. |
| `target` | yes | An array of pre-authorized chat_ids to send the notification to. Defaults to the first allowed chat_id. |
| `target` | yes | An array of pre-authorized chat_ids or user_ids to send the notification to. Defaults to the first allowed chat_id. |
| `disable_notification` | yes | True/false for send the message silently. iOS users and web users will not receive a notification, Android users will receive a notification with no sound. Defaults to False. |
| `keyboard` | yes | List of rows of commands, comma-separated, to make a custom keyboard. Example: `["/command1, /command2", "/command3"]` |
| `inline_keyboard` | yes | List of rows of commands, comma-separated, to make a custom inline keyboard with buttons with associated callback data. Example: `["/button1, /button2", "/button3"]` or `[[["Text btn1", "/button1"], ["Text btn2", "/button2"]], [["Text btn3", "/button3"]]]` |
@ -316,7 +316,7 @@ Message editor:
- service: telegram_bot.edit_message
data_template:
message_id: {% raw %}'{{ trigger.event.data.message.message_id }}'{% endraw %}
chat_id: {% raw %}'{{ trigger.event.data.user_id }}'{% endraw %}
chat_id: {% raw %}'{{ trigger.event.data.chat_id }}'{% endraw %}
title: '*Message edit*'
inline_keyboard:
- "Edit message:/edit_msg, Don't:/do_nothing"
@ -344,7 +344,7 @@ Keyboard editor:
- service: telegram_bot.edit_replymarkup
data_template:
message_id: 'last'
chat_id: {% raw %}'{{ trigger.event.data.user_id }}'{% endraw %}
chat_id: {% raw %}'{{ trigger.event.data.chat_id }}'{% endraw %}
inline_keyboard:
- "Edit message:/edit_msg, Don't:/do_nothing"
```
@ -400,7 +400,7 @@ class TelegramBotEventListener(appapi.AppDaemon):
assert event_id == 'telegram_callback'
data_callback = payload_event['data']
callback_id = payload_event['id']
user_id = payload_event['user_id']
chat_id = payload_event['chat_id']
# keyboard = ["Edit message:/edit_msg, Don't:/do_nothing",
# "Remove this button:/remove button"]
keyboard = [[("Edit message", "/edit_msg"),
@ -420,7 +420,7 @@ class TelegramBotEventListener(appapi.AppDaemon):
title = '*Message edit*'
msg = 'Callback received from %s. Message id: %s. Data: ``` %s ```'
self.call_service('telegram_bot/edit_message',
chat_id=user_id,
chat_id=chat_id,
message_id=msg_id,
title=title,
message=msg % (user, msg_id, data_callback),
@ -436,7 +436,7 @@ class TelegramBotEventListener(appapi.AppDaemon):
# Edit the keyboard
new_keyboard = keyboard[:1]
self.call_service('telegram_bot/edit_replymarkup',
chat_id=user_id,
chat_id=chat_id,
message_id='last',
inline_keyboard=new_keyboard)

2
source/_components/verisure.markdown
View File

@ -45,4 +45,4 @@ Configuration variables:
- **mouse** (*Optional*): Set to 1 to show mouse detectors, 0 to disable. Default 1.
- **door_window** (*Optional*): Set to 1 to show door and window sensors, 0 to disable. Default 1.
- **code_digits** (*Optional*): Number of digits in PIN code. Default 4.
- **giid** (*Optional*): The GIID of your installation (If you have more then one alarm system).
- **giid** (*Optional*): The GIID of your installation (If you have more then one alarm system). To find the GIID for your systems run 'python verisure.py EMAIL PASSWORD installations'

10
source/_docs/automation/editor.markdown
View File

@ -65,6 +65,16 @@ automation old:
platform: ...
```
You can use the `automation:` and `automation old:` sections in the same time:
- `automation old:` to keep your manual designed automations
- `automation:` to save the automation created by the online editor
```yaml
automation: !include automations.yaml
automation old: !include_dir_merge_list automations
```
## {% linkable_title Migrating your automations to `automations.yaml` %}
If you want to migrate your old automations to use the editor, you'll have to copy them to `automations.yaml`. Make sure that `automations.yaml` remains a list! For each automation that you copy over you'll have to add an `id`. This can be any string as long as it's unique.

2
source/_docs/configuration/entity-registry.markdown
View File

@ -18,7 +18,7 @@ The entity registry makes sure that entities get unique identifiers and allow
customizing the identifiers and names of these entities.
As this is still a very new part of Home Assistant, changes will require a
restart of Home Assistant to take affect. A config user interface will be added
restart of Home Assistant to take effect. A config user interface will be added
in a future version.
<p class='note'>

4
source/_docs/configuration/events.markdown
View File

@ -17,6 +17,10 @@ Home Assistant contains a few built-in events that are used to coordinate betwee
### {% linkable_title Event `homeassistant_start` %}
Event `homeassistant_start` is fired when all components from the configuration have been intitialized. This is the event that will start the timer firing off `time_changed` events.
<p class='note warning'>
Starting 0.42, it is no longer possible to listen for event `homeassistant_start`. Use the 'homeassistant' [platform](docs/automation/trigger) instead.
</p>
### {% linkable_title Event `homeassistant_stop` %}
Event `homeassistant_stop` is fired when Home Assistant is shutting down. It should be used to close any open connection or release any resources.

9
source/_docs/mqtt/broker.markdown
View File

@ -109,6 +109,15 @@ There is an issue with the Mosquitto package included in Ubuntu 14.04 LTS. Speci
If you get this error `AttributeError: module 'ssl' has no attribute 'PROTOCOL_TLS'` then you need to set `tls_version: '1.2'`.
</p>
<p class='note'>
If you are running a Mosquitto instance on the same server as Home Assistant then you must ensure that the Mosquitto service starts before Home Assistant. For a Linux instance running Systemd (Raspberry Pi, Debian, Ubuntu and others) then you should edit the file /etc/systemd/system/home-assistant@homeassistant.service as root (e.g. sudo nano /etc/systemd/system/home-assistant@homeassistant.service) and add the mosquitto service:
```
[Unit]
Description=Home Assistant
After=network.target mosquitto.service
```
</p>
<p class='note'>
If you are running a Mosquitto instance on a different server with proper SSL encryption using a service like Let's Encrypt you may have to set the certificate to the operating systems own `.crt` certificates file. In the instance of Ubuntu this would be `certificate: /etc/ssl/certs/ca-certificates.crt`
</p>

60
source/_posts/2018-02-26-release-64.markdown
View File

@ -60,6 +60,28 @@ Major new integration by [@snjoetw]: August locks and door bells! Lock and unloc
- Spotcrime ([@jcconnell] - [#12460]) ([sensor.spotcrime docs]) (new-platform)
- Add Tahoma scenes ([@bakedraccoon] - [#12498]) ([scene docs]) ([tahoma docs]) (new-platform)
## {% linkable_title Release 0.64.1 - February 27 %}
- Frontend: Don't put unit of sensor on new line ([@NovapaX])
- Frontend: Fix display issues on iOS 9.3.5 ([@NovapaX])
- Frontend: Fix chart legend not showing correctly when data has 1 serie ([@fanthos])
- Frontend: Fix cards not getting updated ([@balloob])
- Cast automatically drop connection ([@OttoWinter] - [#12635]) ([media_player.cast docs])
- Roomba timeout ([@kellerza] - [#12645]) ([vacuum.roomba docs])
- Fix a problem with calling `deconz.close` ([@aronsky] - [#12657]) ([deconz docs])
- Harmony: make activity optional ([@balloob] - [#12679]) ([remote.harmony docs])
- Fix getting state from iglo ([@jesserockz] - [#12685]) ([light.iglo docs])
- Fix mysensor defaults ([@balloob] - [#12687]) ([mysensors docs])
- Component deconz: Fix dark attribute on presence sensors ([@tumik] - [#12691]) ([binary_sensor.deconz docs])
- Bugfix: Update of sources for non AVR-X devices always fails ([@scarface-4711] - [#12711]) ([media_player.denonavr docs])
- Don't allow to use a old unsecure library ([@pvizeli] - [#12715])
- Unbreak tahoma ([@bakedraccoon] - [#12719]) ([tahoma docs])
- fix for https://github.com/home-assistant/home-assistant/issues/12673 ([@ChristianKuehnel] - [#12726]) ([sensor.alpha_vantage docs])
- Fix harmony duplicate detection ([@amelchio] - [#12729]) ([remote.harmony docs])
- Update ZHA deps ([@balloob] - [#12737]) ([zha docs])
- MQTT: Fix doing async inside sync context ([@OttoWinter])
- Fix DarSky humidity precision ([@PhilRW])
## {% linkable_title If you need help... %}
...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks.
@ -546,3 +568,41 @@ Experiencing issues introduced by this release? Please report them in our [issue
[weblink docs]: https://home-assistant.io/components/weblink/
[xiaomi_aqara docs]: https://home-assistant.io/components/xiaomi_aqara/
[zha docs]: https://home-assistant.io/components/zha/
[#12635]: https://github.com/home-assistant/home-assistant/pull/12635
[#12645]: https://github.com/home-assistant/home-assistant/pull/12645
[#12657]: https://github.com/home-assistant/home-assistant/pull/12657
[#12679]: https://github.com/home-assistant/home-assistant/pull/12679
[#12685]: https://github.com/home-assistant/home-assistant/pull/12685
[#12687]: https://github.com/home-assistant/home-assistant/pull/12687
[#12691]: https://github.com/home-assistant/home-assistant/pull/12691
[#12711]: https://github.com/home-assistant/home-assistant/pull/12711
[#12715]: https://github.com/home-assistant/home-assistant/pull/12715
[#12719]: https://github.com/home-assistant/home-assistant/pull/12719
[#12726]: https://github.com/home-assistant/home-assistant/pull/12726
[#12729]: https://github.com/home-assistant/home-assistant/pull/12729
[#12737]: https://github.com/home-assistant/home-assistant/pull/12737
[@ChristianKuehnel]: https://github.com/ChristianKuehnel
[@NovapaX]: https://github.com/NovapaX
[@OttoWinter]: https://github.com/OttoWinter
[@amelchio]: https://github.com/amelchio
[@aronsky]: https://github.com/aronsky
[@bakedraccoon]: https://github.com/bakedraccoon
[@balloob]: https://github.com/balloob
[@jesserockz]: https://github.com/jesserockz
[@kellerza]: https://github.com/kellerza
[@pvizeli]: https://github.com/pvizeli
[@scarface-4711]: https://github.com/scarface-4711
[@tumik]: https://github.com/tumik
[@fanthos]: https://github.com/fanthos
[@PhilRW]: https://github.com/PhilRW
[binary_sensor.deconz docs]: https://home-assistant.io/components/binary_sensor.deconz/
[deconz docs]: https://home-assistant.io/components/deconz/
[light.iglo docs]: https://home-assistant.io/components/light.iglo/
[media_player.cast docs]: https://home-assistant.io/components/media_player.cast/
[media_player.denonavr docs]: https://home-assistant.io/components/media_player.denonavr/
[mysensors docs]: https://home-assistant.io/components/mysensors/
[remote.harmony docs]: https://home-assistant.io/components/remote.harmony/
[sensor.alpha_vantage docs]: https://home-assistant.io/components/sensor.alpha_vantage/
[tahoma docs]: https://home-assistant.io/components/tahoma/
[vacuum.roomba docs]: https://home-assistant.io/components/vacuum.roomba/
[zha docs]: https://home-assistant.io/components/zha/

24
source/hassio/index.markdown
View File

@ -54,3 +54,27 @@ Hass.io upgrade process from the SSH command line
[ResinOS]: https://resinos.io/
[Docker]: https://www.docker.com/
[install]: /hassio/installation/
## {% linkable_title hassio command %}
On the SSH command line tyou can use the `hassio` command to retrieve logs, check the details of connected hardware, and more.
HomeAssistant:
``` $ hassio homeassistant logs
$ hassio homeassistant restart
$ hassio homeassistant stop
$ hassio homeassistant start
$ hassio homeassistant update
$ hassio homeassistant check```
Host:
``` $ hassio host hardware
$ hassio host reboot
$ hassio host shutdown
$ hassio host update```
Supervisor
``` $ hassio supervisor logs
$ hassio supervisor info
$ hassio supervisor reload
$ hassio supervisor update```