diff --git a/Gemfile.lock b/Gemfile.lock index 887b6f3aa0e..2aabf6447fd 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -79,7 +79,7 @@ GEM forwardable-extended (~> 2.6) public_suffix (4.0.7) racc (1.6.0) - rack (2.2.3) + rack (2.2.3.1) rack-protection (2.2.0) rack rake (13.0.6) diff --git a/source/_dashboards/picture-elements.markdown b/source/_dashboards/picture-elements.markdown index e74ea22f40a..35da24d469c 100644 --- a/source/_dashboards/picture-elements.markdown +++ b/source/_dashboards/picture-elements.markdown @@ -135,41 +135,6 @@ state_color: description: Set to `true` to have icons colored when entity is active. type: boolean default: true -tap_action: - required: false - description: Action to take on tap. - type: map - keys: - action: - required: true - description: "Action to perform (`more-info`, `toggle`, `call-service`, `navigate`, `url`, `none`)." - type: string - default: "`more-info`" - navigation_path: - required: false - description: "Path to navigate to (e.g., `/lovelace/0/`) when `action` defined as `navigate`." - type: string - default: none - url_path: - required: false - description: "Path to navigate to (e.g., `https://www.home-assistant.io`) when `action` defined as `url`." - type: string - default: none - service: - required: false - description: "Service to call (e.g., `media_player.media_play_pause`) when `action` defined as `call-service`." - type: string - default: none - data: - required: false - description: "Service data to include (e.g., `entity_id: media_player.bedroom`) when `action` defined as `call-service`." - type: string - default: none - confirmation: - required: false - description: "Present a confirmation dialog to confirm the action. See `confirmation` object below." - type: [boolean, map] - default: "false" tap_action: required: false description: Action taken on card tap. See [action documentation](/dashboards/actions/#tap-action). diff --git a/source/_integrations/calendar.markdown b/source/_integrations/calendar.markdown index 872d09e9c02..783c9e470b7 100644 --- a/source/_integrations/calendar.markdown +++ b/source/_integrations/calendar.markdown @@ -36,11 +36,22 @@ automation: offset: -00:15:00 ``` -### Example Automation +Calendar triggers should should generally not use automation mode `single` to ensure the trigger +can fire when multiple events start at the same time (e.g. use `queued` or `parallel` instead) -This is an example of an automation that sends a notification with details about the event that -triggered the automation. See [Automation Trigger Variables: Calendar](/docs/automation/templating/#calendar) for additional trigger data available for conditions or actions. +See [Automation Trigger Variables: Calendar](/docs/automation/templating/#calendar) for additional trigger data available for conditions or actions. +### Automation Recipes + +Below are a few example ways you can use Calendar triggers. + +{% details "Example: Calendar Event Notification " %} + +This example automation consists of: +- For the calendar entity `calendar.personal` +- At the start of any calendar event +- Send a notification with the title and start time of the event +- Allowing multiple events starting at the same time {% raw %} ```yaml @@ -56,6 +67,42 @@ automation: message: >- Event {{ trigger.calendar_event.summary }} @ {{ trigger.calendar_event.start }} - mode: single + mode: queued ``` {% endraw %} + +{% enddetails %} + +{% details "Example: Calendar Event Light Schedule " %} + +This example consists of: +- For the calendar entity ` calendar.device_automation` +- When event summary contains `Front Lights` +- Turn on and off light named `light.front` when the event starts and ends + +{% raw %} +```yaml +automation: + alias: Front Light Schedule + trigger: + - platform: calendar + event: start + entity_id: calendar.device_automation + - platform: calendar + event: end + entity_id: calendar.device_automation + condition: + - condition: template + value_template: "{{ 'Front Lights' in trigger.calendar_event.summary }}" + action: + - if: + - "{{ trigger.event == 'start' }}" + then: + - service: light.turn_on + else: + - service: light.turn_off + mode: queued +``` +{% endraw %} + +{% enddetails %} diff --git a/source/_posts/2022-05-29-matter-in-home-assistant-workshop-announcement.markdown b/source/_posts/2022-05-29-matter-in-home-assistant-workshop-announcement.markdown new file mode 100644 index 00000000000..6343dba8a2d --- /dev/null +++ b/source/_posts/2022-05-29-matter-in-home-assistant-workshop-announcement.markdown @@ -0,0 +1,38 @@ +--- +layout: post +title: "Matter in Home Assistant workshop announcement" +description: "On June 15 we're showing how Matter will work and guide you in getting it set up." +date: 2022-05-29 00:00:00 +date_formatted: "May 29, 2022" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: +- Announcements +og_image: /images/blog/2022-05-matter-in-home-assistant-workshop-announcement/social.png +--- + +Decorative header. + +Matter is a new [smart home standard](https://csa-iot.org/all-solutions/matter/) that is scheduled to launch in fall. Across the industry, companies like Hue, IKEA, Google and Apple are working together to try and solve connectivity, ease of setup and interoperability once and for all. Development is happening as part of the [Connectivity Standards Alliance](https://csa-iot.org/) (CSA) of which we ([Nabu Casa](https://www.nabucasa.com)) are also a participating member. + +
Matter logo

+ +We’ve been hard at work on Matter support for Home Assistant. The [Home Assistant Yellow](/yellow/) hub will come with a radio that supports Thread, required to talk to low power Matter devices. We also have some tricks up our sleeves for devices used to run Home Assistant without such a radio, like Raspberry Pi’s. We want to show what we’re up to and allow you to test it out. + +**On June 15 @ 12:00 PDT / 21:00 CET we will be hosting our free Matter in Home Assistant workshop.** + +The workshop will be held on YouTube. [Go to the listing to set a reminder to be notified when we start.](https://www.youtube.com/watch?v=9fOHBl5w0_k) + +The workshop will contain two parts. In the first part we will talk about what Matter is and how it will work in Home Assistant. In the second part we will walk you through how to add experimental Matter support to your Home Assistant installation and integrate your first Wi-Fi based Matter device. + +The workshop will be free but you will need a couple of things if you want to be able to follow along with the second part: + +- Home Assistant OS 8.0 or newer (Matter relies on an add-on and Bluetooth) +- [Home Assistant Community Store](https://hacs.xyz/) installed +- Espressif ESP32-C3-DevKitM-1 ($9 @ [Mouser](https://www.mouser.com/ProductDetail/356-ESP32-C3DEVKITM1), €13.50 @ [Reichelt](https://www.reichelt.com/nl/en/developmentkit-esp32-c3-mini-1-esp32c3devkitm-p311730.html)) +- Bluetooth. If you use a Raspberry Pi to run Home Assistant you’re set. If you have a Home Assistant Blue or another device without Bluetooth, get a Bluetooth USB adapter that is supported by Home Assistant OS ([like this one](https://www.amazon.com/gp/product/B09DMP6T22/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=B09DMP6T22&linkCode=as2&tag=homeassista0e-20&linkId=c5046239bf04d5b21835299dfb393f0e)). + +Even if you can’t follow along, it will still be an informative session! + +_It is possible to get the experimental Matter support working with other Home Assistant installation methods and other dev kits, but we won’t be covering those in our workshop._ diff --git a/source/dashboards/actions.markdown b/source/dashboards/actions.markdown index eb916d9b7b3..a54b7b4a0cd 100644 --- a/source/dashboards/actions.markdown +++ b/source/dashboards/actions.markdown @@ -28,7 +28,7 @@ tap_action: {% configuration tap-action %} tap_action: required: false - description: Action to take on tap. + description: Action taken on tap. type: map keys: action: @@ -75,7 +75,7 @@ hold_action: {% configuration hold_action %} hold_action: required: false - description: Action to take on tap-and-hold + description: Action taken on tap-and-hold type: map keys: action: @@ -122,7 +122,7 @@ double_tap_action: {% configuration double_tap_action %} double_tap_action: required: false - description: Action to take on double tap + description: Action taken on double tap type: map keys: action: diff --git a/source/dashboards/header-footer.markdown b/source/dashboards/header-footer.markdown index 36c3abe675e..a3c0c586fdd 100644 --- a/source/dashboards/header-footer.markdown +++ b/source/dashboards/header-footer.markdown @@ -34,11 +34,11 @@ tap_action: type: map hold_action: required: false - description: Action to take on tap-and-hold. See [action documentation](/dashboards/actions/#hold-action). + description: Action taken on tap-and-hold. See [action documentation](/dashboards/actions/#hold-action). type: map double_tap_action: required: false - description: Action to take on double tap. See [action documentation](/dashboards/actions/#double-tap-action). + description: Action taken on double tap. See [action documentation](/dashboards/actions/#double-tap-action). type: map {% endconfiguration %} @@ -79,6 +79,29 @@ entities: required: false description: Label for the button. type: string + show_icon: + required: false + description: Show entity icon. + type: boolean + default: "true" + show_name: + required: false + description: Show entity name. + type: boolean + default: "false" + tap_action: + required: false + description: Action taken on button tap. See [action documentation](/dashboards/actions/#tap-action). + type: map + hold_action: + required: false + description: Action taken on tap-and-hold. See [action documentation](/dashboards/actions/#hold-action). + type: map + double_tap_action: + required: false + description: Action taken on double tap. See [action documentation](/dashboards/actions/#double-tap-action). + type: map + {% endconfiguration %} ## Graph header & footer diff --git a/source/help/index.markdown b/source/help/index.markdown index ef62f8a9a8a..219fc5e0468 100644 --- a/source/help/index.markdown +++ b/source/help/index.markdown @@ -34,8 +34,8 @@ Have you found an issue in your Home Assistant installation? Please report it. R - [Why we can't have the Internet of Nice Things: A home automation primer](https://www.openwest.org/custom/description.php?id=92) at [OpenWest 2017](https://www.openwest.org) - July 2017 - [Home Automation with Home Assistant](https://github.com/jjmontesl/talk-hass-pydaygalicia2017) at [PyDay Galicia 2017](https://pyday2017.python-vigo.es/gl/) - June 2017 - [Home Automation with Python](https://www.youtube.com/watch?v=KNFZSSCPUyM) at [GLT 2017](https://glt17.linuxtage.at) - April 2017 -- [Home Assistant workshop](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2017-clt-workshop) at [CLT 2017](https://chemnitzer.linux-tage.de/2017/de/) - March 2017 -- [Home Assistant - Erweiterungen (Platforms/Components)](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2016-puzzle) at [Puzzle ITC](https://www.puzzle.ch/de/) - December 2016 +- [Home Assistant workshop](https://github.com/home-assistant-ecosystem/workshops/tree/main/2017-clt-workshop) at [CLT 2017](https://chemnitzer.linux-tage.de/2017/de/) at [CLT 2017](https://chemnitzer.linux-tage.de/2017/de/) - March 2017 +- [Home Assistant - Erweiterungen (Platforms/Components)](https://github.com/home-assistant-ecosystem/workshops/tree/main/2016-puzzle) at [Puzzle ITC](https://www.puzzle.ch/de/) - December 2016 - [Automating Your Life - Home Automation](https://slides.com/teagan42/life_automation#/) at Develop Denver 2016 - August - [Building Online Communities: Home Assistant](https://medium.com/@gitter/building-online-communities-home-assistant-8818dff671ad#.och4x4rhx) - July 2016 - [Home Assistant Support 101 - Getting around in Home Assistant](https://www.youtube.com/watch?v=dRfk9JAlPJk) (Slides) - June 2016 @@ -77,7 +77,6 @@ Don't miss the regular [Home Assistant podcasts](https://hasspodcast.io/). - [Castálio Podcast - Episódio 102: Marcelo Mello - Red Hat e Automação Residencial com Home Assistant](https://youtu.be/hZq8ucpzjCs) - May 2017 - [Paulus Schoutsen and Home Assistant - Episode 8](https://codepop.com/open-sourcecraft/episodes/paulus-schoutsen/) - March 2017 - [Zammad, Home Assistant and Freifunk - are the winner of the Thomas-Krenn-Awards 2017](https://www.thomas-krenn.com/de/tkmag/allgemein/zammad-home-assistant-und-freifunk-das-sind-die-gewinner-des-thomas-krenn-awards-2017/) - March 2017 -- [10 open source software tools for developing IoT applications](https://www.cbronline.com/news/internet-of-things/10-open-source-software-tools-developing-iot-applications/) - March 2017 - [Home Assistant with Paulus Schoutsen - Episode 94](https://www.podcastinit.com/episode-94-home-assistant-with-paulus-schoutsen/) - January 2017 - [Episode #11](https://pythonbytes.fm/episodes/show/11/django-2.0-is-dropping-python-2-entirely-pipenv-for-profile-functionality-and-pythonic-home-automation) at minute 15:20 by [Python Bytes](https://pythonbytes.fm/) - January 2017 - [Now you can hide your smart home on the darknet](https://www.wired.com/2016/07/now-can-hide-smart-home-darknet/) - July 2016 diff --git a/source/images/blog/2022-05-matter-in-home-assistant-workshop-announcement/header.png b/source/images/blog/2022-05-matter-in-home-assistant-workshop-announcement/header.png new file mode 100644 index 00000000000..0c7995788aa Binary files /dev/null and b/source/images/blog/2022-05-matter-in-home-assistant-workshop-announcement/header.png differ diff --git a/source/images/blog/2022-05-matter-in-home-assistant-workshop-announcement/social.png b/source/images/blog/2022-05-matter-in-home-assistant-workshop-announcement/social.png new file mode 100644 index 00000000000..7943acd5978 Binary files /dev/null and b/source/images/blog/2022-05-matter-in-home-assistant-workshop-announcement/social.png differ diff --git a/source/images/integrations/tuya/image_001.png b/source/images/integrations/tuya/image_001.png index 5a234b49f84..b5834f99d10 100644 Binary files a/source/images/integrations/tuya/image_001.png and b/source/images/integrations/tuya/image_001.png differ diff --git a/source/images/integrations/tuya/image_002.png b/source/images/integrations/tuya/image_002.png index d3140e7b50c..ce1eff1ed5e 100644 Binary files a/source/images/integrations/tuya/image_002.png and b/source/images/integrations/tuya/image_002.png differ diff --git a/source/images/supported_brands/matter.png b/source/images/supported_brands/matter.png new file mode 100644 index 00000000000..a397fec6ea8 Binary files /dev/null and b/source/images/supported_brands/matter.png differ