Merge branch 'current' into next

This commit is contained in:
Franck Nijhof 2021-02-11 12:56:20 +01:00
commit b560023787
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
27 changed files with 156 additions and 129 deletions

View File

@ -57,7 +57,7 @@ jobs:
- name: Check out files from GitHub
uses: actions/checkout@v2
- name: Setting up Ruby 2.6
uses: actions/setup-ruby@v1.1.2
uses: ruby/setup-ruby@v1.64.1
with:
ruby-version: 2.6
- name: Setup Ruby Gems cache
@ -76,7 +76,9 @@ jobs:
uses: actions/cache@v2.1.4
with:
path: source/.jekyll-cache
key: jekyll-${{ hashFiles('**/Gemfile.lock') }}-${{ hashFiles('**/_config.yml') }}
key:
jekyll-${{ hashFiles('**/Gemfile.lock') }}-${{
hashFiles('**/_config.yml') }}
restore-keys: |
jekyll-${{ hashFiles('**/Gemfile.lock') }}-
jekyll-

View File

@ -102,8 +102,8 @@ social:
# Home Assistant release details
current_major_version: 2021
current_minor_version: 2
current_patch_version: 2
date_released: 2021-02-09
current_patch_version: 3
date_released: 2021-02-11
# Either # or the anchor link to latest release notes in the blog post.
# Must be prefixed with a # and have double quotes around it.

View File

@ -53,7 +53,7 @@ automation:
action:
- service: notify.notify
data:
message: Testing conditional actions
message: "Testing conditional actions"
- condition: or
conditions:
- condition: numeric_state
@ -63,6 +63,7 @@ automation:
- condition: state
entity_id: sensor.office_illuminance
below: 10
- service: scene.turn_on
entity_id: scene.office_at_evening
- service: scene.turn_on
target:
entity_id: scene.office_at_evening
```

View File

@ -21,13 +21,17 @@ automation:
condition:
condition: or
conditions:
- condition: template
value_template: "{{ state_attr('sun.sun', 'elevation') < 4 }}"
- condition: template
value_template: "{{ states('sensor.sensorluz_7_0') < 10 }}"
- condition: numeric_state
entity_id: sun.sun
attribute: elevation
below: 4
- condition: numeric_state
entity_id: sensor.sensorluz_7_0
below: 10
action:
- service: scene.turn_on
entity_id: scene.DespiertaDespacho
target:
entity_id: scene.DespiertaDespacho
```
{% endraw %}
@ -46,7 +50,8 @@ automation:
condition: "{{ state_attr('sun.sun', 'elevation') < 4 }}"
action:
- service: scene.turn_on
entity_id: scene.DespiertaDespacho
target:
entity_id: scene.DespiertaDespacho
```
{% endraw %}

View File

@ -30,4 +30,3 @@ message: Sensor value greater than 10
```
Don't forget to save your new automation rule. For your saved automation rule to come into effect, you will need to go to the **Configuration** page and click on **Reload Automation**.

View File

@ -10,11 +10,13 @@ Automations support [templating](/docs/configuration/templating/) in the same wa
Be aware that if you reference a `trigger` state object in templates of an automation' `action` or `condition` sections, attempting to test that automation by calling the `automation.trigger` service or by clicking EXECUTE in the More Info box for the automation will not work. This is because the trigger state object doesn't exist in those contexts. One way to test automations like these is to manually check that the templates work as expected by pasting them in Developer Tools > Template together with your trigger's definition like:
{%raw%}
```yaml
{% set trigger={'to_state':{'state': 'heat'}} %}
{% set option = trigger.to_state.state %}
{{ 'on' if option == 'heat' else 'off' }}
```
{%endraw%}
</div>
@ -119,6 +121,7 @@ The following tables show the available trigger data per platform.
## Examples
{% raw %}
```yaml
# Example configuration.yaml entries
automation:
@ -155,10 +158,11 @@ automation 3:
for: "00:10:00"
action:
- service: light.turn_off
data:
target:
# Turn off whichever entity triggered the automation.
entity_id: "{{ trigger.entity_id }}"
```
{% endraw %}
[state object]: /docs/configuration/state_object/

View File

@ -6,7 +6,8 @@ description: "How to create automations based off blueprints."
Automation blueprints are pre-made automations that you can easily add to your Home Assistant instance. Each blueprint can be added as many times as you want.
Quick links:
- [Blueprints in the Home Assistant forums][blueprint-forums]
- [Blueprints in the Home Assistant forums][blueprint-forums]
## Blueprint Automations

View File

@ -26,6 +26,7 @@ You can add as many labeled `automation` blocks as you want.
Example of a YAML based automation that you can add to `configuration.yaml`.
{% raw %}
```yaml
# Example of entry in configuration.yaml
automation my_lights:
@ -53,7 +54,8 @@ automation my_lights:
action:
# With a single service call, we don't need a '-' before service - though you can if you want to
service: homeassistant.turn_on
entity_id: group.living_room
target:
entity_id: group.living_room
# Turn off lights when everybody leaves the house
- alias: "Rule 2 - Away Mode"
@ -63,7 +65,8 @@ automation my_lights:
to: "not_home"
action:
service: light.turn_off
entity_id: all
target:
entity_id: all
# Notify when Paulus leaves the house in the evening
- alias: "Leave Home notification"
@ -94,6 +97,7 @@ automation my_lights:
title: "Cube event detected"
message: "Cube has triggered this event: {{ trigger.event }}"
```
{% endraw %}
@ -124,18 +128,18 @@ If you want to migrate your manual automations to use the editor, you'll have to
- id: my_unique_id # <-- Required for editor to work, for automations created with the editor the id will be automatically generated.
alias: Hello world
trigger:
- platform: state
entity_id: sun.sun
from: below_horizon
to: above_horizon
- platform: state
entity_id: sun.sun
from: below_horizon
to: above_horizon
condition:
- condition: numeric_state
entity_id: sensor.temperature
above: 17
below: 25
value_template: "{{ float(state.state) + 2 }}"
- condition: numeric_state
entity_id: sensor.temperature
above: 17
below: 25
value_template: "{{ float(state.state) + 2 }}"
action:
- service: light.turn_on
- service: light.turn_on
```
{% endraw %}

View File

@ -12,7 +12,7 @@
<img alt="Google Cast" src="https://brands.home-assistant.io/cast/logo.png"/>
</a>
<a href="/integrations/google_assistant/">
<img alt="Google Cast" src="https://brands.home-assistant.io/google_assistant/logo.png"/>
<img alt="Google Assistant" src="https://brands.home-assistant.io/google_assistant/logo.png"/>
</a>
<a href="/integrations/mqtt/">
<img alt="MQTT" src="https://brands.home-assistant.io/mqtt/logo.png"/>
@ -30,19 +30,19 @@
<img alt="Plex" src="https://brands.home-assistant.io/plex/logo.png"/>
</a>
<a href="/integrations/tradfri/">
<img alt="IKEA" src="https://brands.home-assistant.io/tradfri/logo.png"/>
<img alt="IKEA Tradfri" src="https://brands.home-assistant.io/tradfri/logo.png"/>
</a>
<a href="/integrations/vera/">
<img alt="Vera" src="https://brands.home-assistant.io/vera/logo.png"/>
</a>
<a href="/integrations/sonos/">
<img alt="OpenWRT" src="https://brands.home-assistant.io/sonos/logo.png"/>
<img alt="Sonos" src="https://brands.home-assistant.io/sonos/logo.png"/>
</a>
<a href="/integrations/zha/">
<img alt="Arduino" src="https://brands.home-assistant.io/zha/logo.png"/>
<img alt="Zigbee Home Automation" src="https://brands.home-assistant.io/zha/logo.png"/>
</a>
<a href="/integrations/ozw/">
<img alt="Arduino" src="https://brands.home-assistant.io/ozw/logo.png"/>
<a href="/integrations/zwave_js/">
<img alt="Z-Wave JS" src="https://brands.home-assistant.io/zwave_js/logo.png"/>
</a>
</div>

View File

@ -1,21 +0,0 @@
{% if page.hide_github_edit != true %}
<div class="material-card text feedback">
<b>Help us to improve our documentation</b><br />
Suggest an edit to this page, or provide/view feedback for this page.
<div class="links">
<a
href="{{ site.netlify.repository_url }}/tree/{{ site.netlify.head }}/source/{{ page.path }}"
><i class="icon-edit" /> Edit</a
>
<a
href="{{ site.netlify.repository_url }}/issues/new?template=feedback.yml&url={{ site.netlify.url | url_encode }}{{ page.url | url_encode }}&version={{ site.current_major_version }}.{{
site.current_minor_version }}.{{ site.current_patch_version }}&labels={{ site.netlify.branch }}"
><i class="icon-comment" /> Provide feedback</a
>
<a
href="{{ site.netlify.repository_url }}/issues?utf8=%E2%9C%93&q=%22{{ site.netlify.url | url_encode }}{{ page.url | url_encode }}%22&in=body"
><i class="icon-comments" /> View pending feedback</a
>
</div>
</div>
{% endif %}

View File

@ -0,0 +1,38 @@
{% unless page.feedback == false %}
<div class="material-card text feedback">
<b>Help us to improve our documentation</b><br />
Suggest an edit to this page, or provide/view feedback for this page.
<div class="links">
<a
href="{{ site.netlify.repository_url }}/tree/{{ site.netlify.head }}/source/{{ page.path }}"
target="_blank"
><i class="icon-edit" /> Edit</a
>
{% if page.ha_domain %}
<a
href="{{ site.netlify.repository_url }}/issues/new?template=feedback.yml&url={{ site.netlify.url | url_encode }}{{ page.url | url_encode }}&version={{ site.current_major_version }}.{{
site.current_minor_version }}.{{ site.current_patch_version }}&labels={{ site.netlify.branch }},integration%3A%20{{ page.ha_domain }}"
target="_blank"
><i class="icon-comment" /> Provide feedback</a
>
<a
href="{{ site.netlify.repository_url }}/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22integration%3A+{{ page.ha_domain }}%22"
target="_blank"
><i class="icon-comments" /> View pending feedback</a
>
{% else %}
<a
href="{{ site.netlify.repository_url }}/issues/new?template=feedback.yml&url={{ site.netlify.url | url_encode }}{{ page.url | url_encode }}&version={{ site.current_major_version }}.{{
site.current_minor_version }}.{{ site.current_patch_version }}&labels={{ site.netlify.branch }}"
target="_blank"
><i class="icon-comment" /> Provide feedback</a
>
<a
href="{{ site.netlify.repository_url }}/issues?utf8=%E2%9C%93&q=%22{{ page.url | url_encode }}%22&in=body"
target="_blank"
><i class="icon-comments" /> View pending feedback</a
>
{% endif %}
</div>
</div>
{% endunless %}

View File

@ -130,12 +130,6 @@ If you want to apply additional IP filtering, and automatically ban brute force
After a ban is added a Persistent Notification is populated to the Home Assistant frontend.
<div class='note warning'>
Please note, that sources from `trusted_networks` won't be banned automatically.
</div>
## Hosting files
If you want to use Home Assistant to host or serve static files then create a directory called `www` under the configuration path (`/config`). The static files in `www/` can be accessed by the following URL `http://your.domain:8123/local/`, for example `audio.mp3` would be accessed as `http://your.domain:8123/local/audio.mp3`.

View File

@ -67,3 +67,4 @@ Instead of developing your own application, you can also use any of these alread
- [**room-assistant**](https://github.com/mKeRix/room-assistant): looks for Bluetooth LE beacons, based on Node.js
- [**Happy Bubbles Presence Server**](https://github.com/happy-bubbles/presence): presence detection server for Happy Bubbles BLE-scanning devices, based on Go
- [**ESP32-MQTT-room**](https://jptrsn.github.io/ESP32-mqtt-room/): runs on an ESP32, and looks for Bluetooth LE devices, based on C++/Arduino
- [**OpenMQTTGateway**](https://github.com/1technophile/OpenMQTTGateway): uses ESP32 Bluetooth Low Energy to scan BLE Broadcaster like smart watch/band and moch more to get sensor values

View File

@ -246,6 +246,8 @@ everything, however, you can leave out any feature you do not wish to use with H
- *Not receiving updates* typically means a problem with the subscriber configuration. Changes for things like sensors or thermostat temperature set points should be instantly published to a topic and received by the Home Assistant susbcriber when everything is configured correctly.
- *invalid_grant: Token has been expired or revoked* can mean the OAuth token was revoked by Google due to account changes like resetting a password. In addition, if the app is marked as "testing" and not "production" mode, the token may automatically expire after 7 days. Go to the project page to publish it to production mode.
- You can see stats about your subscriber in the [Cloud Console](https://console.cloud.google.com/cloudpubsub/subscription/list) which includes counts of messages published by your devices, and how many have been acknowledged by your Home Assistant subscriber. You can also `View Messages` to see examples of published. Many old unacknowledged messages indicate the subscriber is not receivng the messages and working properly or not connected at all. Double check the `subscriber_id` matches the `Subscription Name`
- To aid in diagnosing subscriber problems or camera stream issues it may help to turn up verbose logging by adding some or all of these to your `configuration.yaml` depending on where you are having trouble:

View File

@ -28,41 +28,6 @@ This platform has been tested and is confirmed to be working with the iRobot Roo
To add your Roomba to your installation, go to **Configuration** >> **Integrations** in the UI, click the button with + sign and from the list of integrations select iRobot Roomba.
To add your Roomba vacuum to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
roomba:
- host: IP_ADDRESS_OR_HOSTNAME
blid: BLID
password: PASSWORD
```
{% configuration %}
host:
description: The hostname or IP address of the Roomba.
required: true
type: string
blid:
description: The username (BLID) for your device.
required: true
type: string
password:
description: The password for your device.
required: true
type: string
continuous:
description: Whether to operate in continuous mode.
required: false
type: boolean
default: true
delay:
description: Custom connection delay (in seconds) for periodic mode
required: false
type: integer
default: 1
{% endconfiguration %}
<div class='note'>
The Roomba's MQTT server only allows a single connection. Enabling continuous mode will force the App to connect via the cloud to your Roomba. [More info here](https://github.com/NickWaterton/Roomba980-Python#firmware-2xx-notes)
@ -77,22 +42,7 @@ Sensors:
- roomba_battery_level : The status of your battery
- roomba_bin_full (if Roomba has the capacity to do) : Bin Full status
### Multiple Roomba vacuums
```yaml
# Example configuration.yaml entry
roomba:
- host: IP_ADDRESS_OR_HOSTNAME_1
blid: BLID_1
password: PASSWORD_1
- host: IP_ADDRESS_OR_HOSTNAME_2
blid: BLID_2
password: PASSWORD_2
continuous: false
delay: 5
```
### Retrieving your credentials
### Manually retrieving your credentials
Please refer to [here](https://github.com/NickWaterton/Roomba980-Python#how-to-get-your-usernameblid-and-password) or [here](https://github.com/koalazak/dorita980#how-to-get-your-usernameblid-and-password) to retrieve both the BLID (username) and the password.

View File

@ -22,7 +22,9 @@ Please note that UPnP or NAT-PMP needs to be enabled on your router for this int
## Configuration
To integrate this into Home Assistant, add the following section to your `configuration.yaml` file:
The UPnP integration can be set up via the user interface at **Configuration** -> **Integrations** -> **Add Integration**. From the list of available integrations, select UPnP and follow the on-screen instructions.
Alternatively, you can use YAML by adding the following section to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry

View File

@ -181,8 +181,7 @@ This integration is tested to work with the following models. If you have a diff
| `lamp1` | MJTD01YL | Xiaomi Mijia Smart LED Desk Lamp (autodiscovery isn't possible because the device doesn't support mDNS due to the small amount of RAM) |
| `ceiling1` | YLXD01YL | Yeelight Ceiling Light |
| `ceiling2` | YLXD03YL | Yeelight Ceiling Light - Youth Version |
| ? | YLXD62YI | Yeelight Ceiling Light (Jiaoyue 260) |
| ? | YLXD62YI | Yeelight Ceiling Light (Jiaoyue 260) |
| ?, may be `ceiling3` | YLXD04YL | Yeelight Ceiling Light (Jiaoyue 450) |
| `ceiling3` | YLXD05YL | Yeelight Ceiling Light (Jiaoyue 480) |
| `ceiling4` | YLXD02YL | Yeelight Ceiling Light (Jiaoyue 650) |

View File

@ -347,7 +347,3 @@ Correct. Only a few devices actually support having their name stored in the har
When trying to determine why something isn't working as you expect, or when reporting an issue with the integration, it is helpful to know what Z-Wave JS sees as the current state of your Z-Wave network. To get a dump of your current network state, follow the menu:
**Configuration** -> **Integrations** -> **Z-Wave JS** -> **Configure** -> **Download a dump of your network to help diagnose issues**
### Watch traffic between the server and the integration (Advanced Users)
Z-Wave JS Server comes with a client that can be used to see the messages that the server is sending and to check the state of a node/all nodes as well. Visit the [`zwave-js-server` repository](https://github.com/zwave-js/zwave-js-server/) and follow the instructions in the README.

View File

@ -13,6 +13,6 @@ layout: default
<hr class="divider" />
{% endif %}
{{ content }}
{% include edit_github.html %}
{% include feedback.html %}
</article>

View File

@ -51,6 +51,7 @@ Enjoy the release!
- [Integrations now available to set up from the UI](#integrations-now-available-to-set-up-from-the-ui)
- [Release 2021.2.1 - February 5](#release-202121---february-5)
- [Release 2021.2.2 - February 9](#release-202122---february-9)
- [Release 2021.2.3 - February 11](#release-202123---february-11)
- [If you need help...](#if-you-need-help)
- [Breaking Changes](#breaking-changes)
- [Farewell to the following](#farewell-to-the-following)
@ -444,6 +445,56 @@ The following integrations are now available via the Home Assistant UI:
[zwave docs]: /integrations/zwave/
[zwave_js docs]: /integrations/zwave_js/
## Release 2021.2.3 - February 11
- Fix SNMP engine memory leak in Brother integration ([@bieniu] - [#46272]) ([brother docs])
- Use oauthv3 for Tesla ([@alandtse] - [#45766]) ([tesla docs]) (breaking-change)
- Bump pymyq to 3.0.1 ([@ehendrix23] - [#46079]) ([myq docs])
- Revert transmission to check torrent lists by name rather than object ([@JPHutchins] - [#46190]) ([transmission docs])
- Update powerwall for new authentication requirements ([@bdraco] - [#46254]) ([powerwall docs])
- Fix Lutron Integration Protocol reconnect logic ([@bdraco] - [#46264]) ([lutron_caseta docs])
- Bump roonapi to 0.0.32 ([@pavoni] - [#46286]) ([roon docs])
- Add guards for missing value in binary_sensor platform of zwave_js integration ([@marcelveldt] - [#46293]) ([zwave_js docs])
- Add reauth support for tesla ([@bdraco] - [#46307]) ([tesla docs])
- Add `already_in_progress` string to roku config flow ([@bramkragten] - [#46333]) ([roku docs])
- Restore Google/Alexa extra significant change checks ([@balloob] - [#46335]) ([alexa docs]) ([google_assistant docs])
- Fix Shelly relay device set to light appliance type ([@thecode] - [#46181]) ([shelly docs])
[#45766]: https://github.com/home-assistant/core/pull/45766
[#46079]: https://github.com/home-assistant/core/pull/46079
[#46181]: https://github.com/home-assistant/core/pull/46181
[#46190]: https://github.com/home-assistant/core/pull/46190
[#46254]: https://github.com/home-assistant/core/pull/46254
[#46264]: https://github.com/home-assistant/core/pull/46264
[#46272]: https://github.com/home-assistant/core/pull/46272
[#46286]: https://github.com/home-assistant/core/pull/46286
[#46293]: https://github.com/home-assistant/core/pull/46293
[#46307]: https://github.com/home-assistant/core/pull/46307
[#46333]: https://github.com/home-assistant/core/pull/46333
[#46335]: https://github.com/home-assistant/core/pull/46335
[@JPHutchins]: https://github.com/JPHutchins
[@alandtse]: https://github.com/alandtse
[@balloob]: https://github.com/balloob
[@bdraco]: https://github.com/bdraco
[@bieniu]: https://github.com/bieniu
[@bramkragten]: https://github.com/bramkragten
[@ehendrix23]: https://github.com/ehendrix23
[@marcelveldt]: https://github.com/marcelveldt
[@pavoni]: https://github.com/pavoni
[@thecode]: https://github.com/thecode
[alexa docs]: /integrations/alexa/
[brother docs]: /integrations/brother/
[google_assistant docs]: /integrations/google_assistant/
[lutron_caseta docs]: /integrations/lutron_caseta/
[myq docs]: /integrations/myq/
[powerwall docs]: /integrations/powerwall/
[roku docs]: /integrations/roku/
[roon docs]: /integrations/roon/
[shelly docs]: /integrations/shelly/
[tesla docs]: /integrations/tesla/
[transmission docs]: /integrations/transmission/
[zwave_js docs]: /integrations/zwave_js/
## 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).

View File

@ -3,7 +3,7 @@ title: "Home Assistant Blue!"
description: "Where style and performance meet privacy"
sidebar: false
is_homepage: true
hide_github_edit: true
feedback: false
body_id: blue
show_title: false
og_image: /images/blue/blue_hero.jpg

View File

@ -1,8 +1,7 @@
---
title: Home Assistant Conference 2020
show_title: false
# is_homepage: true
hide_github_edit: true
feedback: false
description: December 13, 2020 we will host the first online Home Assistant Conference.
og_image: /images/conference/social.png
---

View File

@ -3,7 +3,7 @@ title: "Cookbook"
description: "Community maintained list of different ways to use Home Assistant."
sidebar: false
regenerate: true
hide_github_edit: true
feedback: false
---
This is a community curated list of different ways to use Home Assistant. Most

View File

@ -1,6 +1,7 @@
---
title: "Documentation"
description: "Documentation for Home Assistant"
feedback: false
---
The documentation covers beginner to advanced topics around the installation, setup, configuration, and usage of Home Assistant.

View File

@ -2,7 +2,7 @@
title: "FAQ"
description: "Home Assistant's FAQ"
regenerate: true
hide_github_edit: true
feedback: false
---
This is a community curated list of frequently asked questions (FAQ) about the installation, setup, and usage of Home Assistant. If you want to get details about a term, please check the [glossary](/docs/glossary/).
@ -23,4 +23,3 @@ This is a community curated list of frequently asked questions (FAQ) about the i
{% endif %}
{% endfor %}
{% endfor %}

View File

@ -4,7 +4,7 @@ sidebar: false
hero_unit: true
is_homepage: true
regenerate: true
hide_github_edit: true
feedback: false
description:
Open source home automation that puts local control and privacy first.
---

View File

@ -3,7 +3,7 @@ title: "Integrations"
description: "List of the built-in integrations of Home Assistant."
sidebar: false
is_homepage: true
hide_github_edit: true
feedback: false
body_id: components-page
regenerate: false
---