From 81d49c3fcbbf97c0e7c21b3e8aa7204cf4e7f17d Mon Sep 17 00:00:00 2001 From: Brett Adams Date: Mon, 23 Sep 2024 16:39:05 +1000 Subject: [PATCH 01/29] Update tesla_fleet.markdown (#34859) --- source/_integrations/tesla_fleet.markdown | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/_integrations/tesla_fleet.markdown b/source/_integrations/tesla_fleet.markdown index 29c41abf116..7a60ff07240 100644 --- a/source/_integrations/tesla_fleet.markdown +++ b/source/_integrations/tesla_fleet.markdown @@ -5,6 +5,7 @@ ha_category: - Binary sensor - Car - Climate + - Cover - Device tracker - Number - Select @@ -19,6 +20,7 @@ ha_domain: tesla_fleet ha_platforms: - binary_sensor - climate + - cover - device_tracker - diagnostics - number @@ -90,6 +92,11 @@ These are the entities available in the Tesla Fleet integration. Not all entitie |Binary sensor|User present|Yes| |Climate|Cabin overheat protection|No| |Climate|Climate|Yes| +|Cover|Charge port door|Yes| +|Cover|Frunk|Yes| +|Cover|Sunroof|No| +|Cover|Trunk|Yes| +|Cover|Vent windows|Yes| |Device tracker|Location|Yes| |Device tracker|Route|Yes| |Number|Charge current|Yes| From 1170000e8fccdb40d385d1eab99ac508947b0f11 Mon Sep 17 00:00:00 2001 From: Brett Adams Date: Mon, 23 Sep 2024 16:39:53 +1000 Subject: [PATCH 02/29] Add media player to Tesla Fleet (#34861) --- source/_integrations/tesla_fleet.markdown | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/_integrations/tesla_fleet.markdown b/source/_integrations/tesla_fleet.markdown index 7a60ff07240..e066bca84e5 100644 --- a/source/_integrations/tesla_fleet.markdown +++ b/source/_integrations/tesla_fleet.markdown @@ -7,6 +7,7 @@ ha_category: - Climate - Cover - Device tracker + - Media player - Number - Select - Sensor @@ -23,6 +24,7 @@ ha_platforms: - cover - device_tracker - diagnostics + - media_player - number - select - sensor @@ -99,6 +101,7 @@ These are the entities available in the Tesla Fleet integration. Not all entitie |Cover|Vent windows|Yes| |Device tracker|Location|Yes| |Device tracker|Route|Yes| +|Media player|Media player|Yes| |Number|Charge current|Yes| |Number|Charge limit|Yes| |Select|Seat heater front left|Yes| From 10768bba01b1ddac1a6eaf7d2de94e1238c48ed3 Mon Sep 17 00:00:00 2001 From: starkillerOG Date: Mon, 23 Sep 2024 08:49:42 +0200 Subject: [PATCH 03/29] Add CPU usage docs (#34851) --- source/_integrations/reolink.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/reolink.markdown b/source/_integrations/reolink.markdown index f83326a2044..3557a4fb7fa 100644 --- a/source/_integrations/reolink.markdown +++ b/source/_integrations/reolink.markdown @@ -243,6 +243,7 @@ Depending on the supported features of the camera, the following sensor entities - PTZ pan position - Wi-Fi signal* +- CPU usage* - HDD/SD storage* - Battery percentage - Battery temperature* From 1bdc9ef0f19d16934461187e78c4d52caa22035b Mon Sep 17 00:00:00 2001 From: starkillerOG Date: Mon, 23 Sep 2024 08:50:24 +0200 Subject: [PATCH 04/29] Add Reolink hub volume number entities docs (#34852) --- source/_integrations/reolink.markdown | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/_integrations/reolink.markdown b/source/_integrations/reolink.markdown index 3557a4fb7fa..da20e5332df 100644 --- a/source/_integrations/reolink.markdown +++ b/source/_integrations/reolink.markdown @@ -89,7 +89,10 @@ Depending on the supported features of the camera, number entities are added for - Optical zoom control - Focus control - Floodlight turn on brightness -- Volume +- Volume (Camera) +- Alarm volume (Home Hub) +- Message volume (Home Hub) +- Chime volume - Guard return time - Motion sensitivity - PIR sensitivity @@ -116,7 +119,6 @@ Depending on the supported features of the camera, number entities are added for - Image saturation* (default 128) - Image sharpness* (default 128) - Image hue* (default 128) -- Chime volume **Floodlight turn on brightness** controls the brightness of the floodlight when it is turned on internally by the camera (see **Floodlight mode** select entity) or when using the **Floodlight** light entity. From f0585cc102ac2a16c0b0cf49dc595e030438323a Mon Sep 17 00:00:00 2001 From: starkillerOG Date: Mon, 23 Sep 2024 08:51:15 +0200 Subject: [PATCH 05/29] Add Reolink Home Hub ringtone control docs (#34853) --- source/_integrations/reolink.markdown | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/_integrations/reolink.markdown b/source/_integrations/reolink.markdown index da20e5332df..d93506fa02a 100644 --- a/source/_integrations/reolink.markdown +++ b/source/_integrations/reolink.markdown @@ -174,6 +174,8 @@ Depending on the supported features of the camera, select entities are added for - Chime motion ringtone - Chime person ringtone - Chime visitor ringtone +- Hub alarm ringtone +- Hub visitor ringtone **PTZ preset** positions can be set in the Reolink app/windows/web client, the names of the presets will be loaded into Home Assistant at the start of the integration. When adding new preset positions, please restart the Reolink integration. @@ -210,7 +212,7 @@ Depending on the supported features of the camera, switch entities are added for - Record - Manual record - Push notifications -- Buzzer on event +- Hub ringtone on event - Email on event - FTP upload - PIR enabled* @@ -219,7 +221,7 @@ Depending on the supported features of the camera, switch entities are added for When the **Infrared lights in night mode** entity is set to OFF, the infrared LEDs are always OFF. When the **Infrared lights in night mode** entity is set to ON, the infrared LEDs will be on when the camera is in night vision mode. For more information, see the **Day night mode** select entity. -For NVRs, a global switch for **Record**, **Push**, **Buzzer**, **Email**, and **FTP** will be available under the NVR device as well as a switch per channel of the NVR under the camera device. The respective feature will only be active for a given channel if both the global and that channel switch are enabled (as is also the case in the Reolink app/client). +For NVRs, a global switch for **Record**, **Push**, **Hub ringtone on event**, **Email**, and **FTP** will be available under the NVR device as well as a switch per channel of the NVR under the camera device. The respective feature will only be active for a given channel if both the global and that channel switch are enabled (as is also the case in the Reolink app/client). **Push** notifications to a phone will only be provided if the following conditions are met: - The **Push notifications** switch in Home Assistant is ON. From 4d29204f3e4a5078d78aafe3f39a39ffedfd108d Mon Sep 17 00:00:00 2001 From: G Johansson Date: Mon, 23 Sep 2024 08:52:00 +0200 Subject: [PATCH 06/29] Add autolock switch for yale_smart_alarm (#34847) --- source/_integrations/yale_smart_alarm.markdown | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/source/_integrations/yale_smart_alarm.markdown b/source/_integrations/yale_smart_alarm.markdown index 5529cb6603e..21297782e3d 100644 --- a/source/_integrations/yale_smart_alarm.markdown +++ b/source/_integrations/yale_smart_alarm.markdown @@ -7,6 +7,7 @@ ha_category: - Button - Lock - Sensor + - Switch ha_release: 0.78 ha_iot_class: Cloud Polling ha_config_flow: true @@ -20,6 +21,7 @@ ha_platforms: - diagnostics - lock - sensor + - switch ha_integration_type: integration --- @@ -32,6 +34,7 @@ There is currently support for the following device types within Home Assistant: - Button - Lock - Sensor +- Switch {% include integrations/config_flow.md %} @@ -57,4 +60,8 @@ The lock platform requires a code for unlocking but no code for locking. Provides support for smoke detector temperature sensors. +## Switch + +Provides support for enable/disable autolock on locks. Entity is only available for supported door locks. + The {% term integration %} can be configured to provide a default code that is used if no code is supplied and the number of digits required. From e7240fd3aecad376126d81d273b5b4572e0a0b66 Mon Sep 17 00:00:00 2001 From: Jason Hunter Date: Mon, 23 Sep 2024 02:59:24 -0400 Subject: [PATCH 07/29] Duke Energy Documentation (#34631) * Duke Energy Documentation * Style tweaks, add config flow and prereqs * fix markdown * tiny tweak * Update source/_integrations/duke_energy.markdown --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/duke_energy.markdown | 39 +++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 source/_integrations/duke_energy.markdown diff --git a/source/_integrations/duke_energy.markdown b/source/_integrations/duke_energy.markdown new file mode 100644 index 00000000000..20c144d2ef7 --- /dev/null +++ b/source/_integrations/duke_energy.markdown @@ -0,0 +1,39 @@ +--- +title: Duke Energy +description: Instructions on how to integrate Duke Energy within Home Assistant. +ha_category: + - Energy +ha_release: 2024.10 +ha_iot_class: Cloud Polling +ha_codeowners: + - '@hunterjm' +ha_domain: duke_energy +ha_config_flow: true +ha_integration_type: integration +--- + +The **Duke Energy** {% term integration %} allows you to get energy information from [Duke Energy](https://www.duke-energy.com/). + +## Supported devices + +Currently, this integration only supports electric meters. + +## Prerequisites + +You need a Duke Energy account to use this integration. During installation of the integration, you will need the username and password to access your account. + +{% include integrations/config_flow.md %} + +## Energy + +Because Duke Energy only releases usage data with around a 48-hour delay, the integration inserts data into statistic objects. +You can find the statistics in {% my developer_statistics title="**Developer Tools** > **Statistics**"%} and search for "duke_energy". +**This delay means that there will be no data in the energy dashboard for today and likely yesterday** (depending on time of day you are checking). + +At the initial setup, the integration pulls historical hourly usage since the account activation. Duke Energy typically only keeps this data for the past 3 years. +After the initial setup, the integration keeps pulling data (twice per day) for the past 30 days to allow for any corrections in the data. + +In the configuration of the energy dashboard ({% my config_energy title="**Settings** > **Dashboards** > **Energy**" %}): + +1. Select **Add consumption** for the **Electricity grid**. +2. Select **Duke Energy Electric {meter serial number} Consumption** for the **consumed energy**. From 76674d6b5e06dd2ec4a9c612cdb98f8444f93e36 Mon Sep 17 00:00:00 2001 From: YogevBokobza Date: Mon, 23 Sep 2024 10:06:17 +0300 Subject: [PATCH 08/29] Add Switcher Runner S11 support (#34269) * switcher update doc to runner S11 * Update source/_integrations/switcher_kis.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/switcher_kis.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/switcher_kis.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * fix Update switcher_kis.markdown * Update source/_integrations/switcher_kis.markdown Co-authored-by: Shay Levy * Update source/_integrations/switcher_kis.markdown Co-authored-by: Shay Levy * Update source/_integrations/switcher_kis.markdown Co-authored-by: Shay Levy * Tiny tweak --------- Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: Shay Levy Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/switcher_kis.markdown | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/source/_integrations/switcher_kis.markdown b/source/_integrations/switcher_kis.markdown index abe24ecd0e2..5483e7d680a 100644 --- a/source/_integrations/switcher_kis.markdown +++ b/source/_integrations/switcher_kis.markdown @@ -34,9 +34,27 @@ Supported devices: - Switcher V4 - Switcher Breeze - Switcher Runner +- Switcher Runner S11 + +Devices that require a token: + +- Switcher Runner S11 If you completed the integration setup but are still unable to control the device, please make sure your device's firmware is up-to-date. +## Prerequisites + +To enhance security, certain Switcher devices require a token for operation. In order to integrate your token-based Switcher devices with Home Assistant, you'll need the following information: + +- **The username of your Switcher Account**: To find the username, open the Switcher app. +- **Local control key token**: To find the local control key token, browse to the + [Switcher GetKey API][token], enter your Switcher account username (which is an email address), and press + **Send Me The Code**. + + The token will be sent to you by email. It will look something like this: `zvVvd7JxtN7CgvkD1Psujw==` + +[token]: https://switcher.co.il/GetKey/ + {% include integrations/config_flow.md %} ## Buttons @@ -87,5 +105,5 @@ Note: This does not affect the auto off timer. ## Notes -Make sure that Home Assistant host's firewall allows incoming traffic on UDP ports 10002, 20002 & 20003 and outgoing connections to Switcher device(s) on TCP ports 9957 & 10000. +Make sure that Home Assistant host's firewall allows incoming traffic on UDP ports 10002, 10003, 20002 & 20003 and outgoing connections to Switcher device(s) on TCP ports 9957 & 10000. If Home Assistant and the Switcher device(s) are not on the same network, you will also need to have their traffic properly forwarded between the two networks. From c391de6b51bc68213861c0f5955e5907e432f53a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marc=20H=C3=B6rsken?= Date: Mon, 23 Sep 2024 09:12:28 +0200 Subject: [PATCH 09/29] Add documentation for new WMS WebControl pro integration (#34353) * Add documentation for new WMS WebControl pro integration * Update source/_integrations/wmspro.markdown Co-authored-by: Joost Lekkerkerker * tiny tweak --------- Co-authored-by: Joost Lekkerkerker Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/wmspro.markdown | 36 ++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 source/_integrations/wmspro.markdown diff --git a/source/_integrations/wmspro.markdown b/source/_integrations/wmspro.markdown new file mode 100644 index 00000000000..22625d6474c --- /dev/null +++ b/source/_integrations/wmspro.markdown @@ -0,0 +1,36 @@ +--- +title: WMS WebControl pro +description: Instructions on how to integrate WAREMA devices via WMS WebControl pro within Home Assistant. +ha_category: + - Cover + - Hub +ha_release: "2024.10" +ha_iot_class: Local Polling +ha_codeowners: + - '@mback2k' +ha_domain: wmspro +ha_config_flow: true +ha_platforms: + - cover +ha_integration_type: integration +related: + - url: https://www.warema.com/en/smart-home/wms-webcontrol-pro/ + title: Consumer information about WMS WebControl pro + - url: https://smartbuildings.warema.com/en/control-systems/radio-systems/wms/wms-webcontrol-pro/ + title: Technical documentation for WMS WebControl pro +--- + +The **WMS WebControl pro** {% term integration %} allows you to integrate WAREMA devices into Home Assistant. + +This integration uses a local API which is available with firmware container version 11H. + +See device section for support information: [covers](#covers). + +{% include integrations/config_flow.md %} + +The WMS WebControl pro *may* also be discovered on your local network via DHCP. + +## Covers + +- *Patio awnings* can be opened, closed, set to a certain position and their movement stopped. +- The integration and library *may* already support other types of awnings with a single motor. From 2ec23ed10b9cac49e0cf077c3b0382dcbe57a721 Mon Sep 17 00:00:00 2001 From: Willem-Jan van Rootselaar Date: Mon, 23 Sep 2024 09:37:46 +0200 Subject: [PATCH 10/29] feat: Add Sensor platform to BSBLan integration (#34626) * feat: Add Sensor platform to BSBLan integration * docs: small fixes * Update source/_integrations/bsblan.markdown add comma Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/bsblan.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * tiny tweak --------- Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/bsblan.markdown | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/source/_integrations/bsblan.markdown b/source/_integrations/bsblan.markdown index dfee654e41a..15fd9cf5fc9 100644 --- a/source/_integrations/bsblan.markdown +++ b/source/_integrations/bsblan.markdown @@ -3,6 +3,7 @@ title: BSB-Lan description: Instructions on how to integrate BSBLan device into Home Assistant. ha_category: - Climate + - Sensor ha_release: '0.110' ha_iot_class: Local Polling ha_config_flow: true @@ -12,31 +13,32 @@ ha_domain: bsblan ha_platforms: - climate - diagnostics + - sensor ha_integration_type: device --- The **BSB-Lan** {% term integration %} integrates [BSBLan](https://github.com/fredlcore/BSB-LAN) devices into Home Assistant. -BSBLan is a device that is made by `Frederik Holst` and `Ulf Dieckmann` for documentation and with +BSBLan is a device that is made by `Frederik Holst` and with the help of many other contributors. -The new board v3 is designed for an Arduino Due with an Ethernet-Shield for web-based controlling +The board v3 is designed for an Arduino Due with an Ethernet-Shield for web-based controlling of heating systems such as `Elco Thision`, `Brötje` and similar systems. +Also, available is an ESP32 version of the board. It can interface with the heating system over Boiler-System-Bus, Local Process Bus and PPS (Punkt-zu-Punkt Schnittstelle) -For more information of which system it supports, have a look at their [documentation](https://1coderookie.github.io/BSB-LPB-LAN_EN/). +For more information of which system it supports, take a look at their [documentation](https://docs.bsb-lan.de). {% include integrations/config_flow.md %} +{% include integrations/config_flow.md %}, For authentication HTTP authentication using a username and password, or using a passkey is supported. Use either one. -For more documentation of the BSBLan device, check the [manual](https://1coderookie.github.io/BSB-LPB-LAN_EN/). +For more documentation of the BSBLan device, check the [manual](https://docs.bsb-lan.de). -To see a more detailed listing of the reported systems which are successfully used with BSB-LAN please follow the corresponding link: +To see a more detailed listing of the reported systems which are successfully used with BSB-LAN, please follow the corresponding link: -- [`Brötje`](https://1coderookie.github.io/BSB-LPB-LAN_EN/chap03.html#311-broetje) -- [`Elco`](https://1coderookie.github.io/BSB-LPB-LAN_EN/chap03.html#312-elco) -- [`Other Manufacturers (e.g. Fujitsu, Atlantic, Weishaupt)`](https://1coderookie.github.io/BSB-LPB-LAN_EN/chap03.html#313-other-manufacturers) +[Supported heating systems](https://docs.bsb-lan.de/supported_heating_systems.html) -The integration is tested with the stable firmware version `1.00`. A newer firmware versions will not work, because the parameters are changed of the specific info that is needed. -Please use the latest release. [release 1.0](https://github.com/fredlcore/BSB-LAN/releases/tag/v1.0) +The integration is tested with the stable firmware version `3.1.6-20230327101530`. A newer firmware version may not work because the API could have changed. +Please use this release. [release 3.1](https://github.com/fredlcore/BSB-LAN/releases/tag/v3.1) From f5c293f30d6dfc5e209487e142fa9f4630e0ee2f Mon Sep 17 00:00:00 2001 From: Adam Pasztor Date: Mon, 23 Sep 2024 09:43:06 +0200 Subject: [PATCH 11/29] Add ADS Valve documentation (#34666) * Add ADS Valve documentation * fix: remove not necessary TOC contents * tweak --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/ads.markdown | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/source/_integrations/ads.markdown b/source/_integrations/ads.markdown index 99cdeaf23e7..81aaab85623 100644 --- a/source/_integrations/ads.markdown +++ b/source/_integrations/ads.markdown @@ -8,6 +8,7 @@ ha_category: - Light - Sensor - Switch + - Valve ha_release: '0.60' ha_iot_class: Local Push ha_domain: ads @@ -17,6 +18,7 @@ ha_platforms: - light - sensor - switch + - valve ha_integration_type: integration related: - docs: /docs/configuration/ @@ -32,6 +34,7 @@ There is currently support for the following device types within Home Assistant: - [Sensor](#sensor) - [Switch](#switch) - [Cover](#cover) +- [Valve](#valve) ## Configuration @@ -253,3 +256,28 @@ device_class: description: Sets the [class of the device](/integrations/cover/), changing the device state and icon that is displayed on the frontend. type: device_class {% endconfiguration %} + +## Valve + +The `ads` valve entity accesses a boolean variable on the connected ADS device. The variable is identified by its name. + +To use your ADS device, you first have to set up your [ADS hub](#configuration) and then add the following to your {% term "`configuration.yaml`" %} +file: + +```yaml +# Example configuration.yaml entry +valve: + - platform: ads + adsvar: MAIN.bValveControl +``` + +{% configuration %} +adsvar: + required: true + description: The name of the variable which you want to access on the ADS device. + type: string +name: + required: false + description: An identifier for the valve in the frontend. + type: string +{% endconfiguration %} From 059b3eb1e32b1d7fc910eff5a717775545595d30 Mon Sep 17 00:00:00 2001 From: vhkristof Date: Mon, 23 Sep 2024 09:43:47 +0200 Subject: [PATCH 12/29] Add documentation for renault.ac set schedules (#34636) * Add documentation for renault.ac_set_schedules (cherry picked from commit 7751d4dc5424dd0568f3004c1ef4983d961a8c30) * Tiny style tweaks (cherry picked from commit 62b8bd7ba8488e10878e8df5d1b334cd3e17e5de) * Remove JSON examples and replace with YAML * tiny tweaks --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/renault.markdown | 57 ++++++++++++++++++++------- 1 file changed, 43 insertions(+), 14 deletions(-) diff --git a/source/_integrations/renault.markdown b/source/_integrations/renault.markdown index 84e7d51731b..138f4b0d56a 100644 --- a/source/_integrations/renault.markdown +++ b/source/_integrations/renault.markdown @@ -58,6 +58,37 @@ Cancel A/C on vehicle. | ---------------------- | -------- | ----------- | | `vehicle`| yes | device_id of the vehicle | +### Action `renault.ac_set_schedules` + +Update AC schedule on vehicle. + + | Data attribute | Required | Description | Example | + | ---------------------- | -------- | ----------- | ------- | + | `vehicle`| yes | device_id of the vehicle | | + | `schedules` | yes | Schedule details. Can be a single schedule or a list of schedules | see [example below](#ac_schedule_example) | + +Notes: + +- `schedules` can contain one or more schedules which are set within the same call. +- The `id` is compulsory on each `schedule` (should be 1 to 5, depending on the vehicle). +- The `activated` flag is an optional boolean. If it is not provided, then the existing flag will be kept as is. +- The `monday` to `sunday` elements are optional. If they are not provided, then the existing settings will be kept for each day. If they are provided as None, then the existing setting will be cleared. If a value is provided, it must contain the key `readyAtTime` (in UTC format). + +Example: + +```yaml +- id: 1 + activated: true + monday: + readyAtTime: 'T12:00Z' +- id: 2 + activated: false + monday: + readyAtTime: 'T12:00Z' + tuesday: + readyAtTime: 'T12:00Z' +``` + ### Action `renault.charge_set_schedules` Update charge schedule on vehicle. @@ -69,24 +100,22 @@ Update charge schedule on vehicle. Notes: -- `schedules` can be in the form `{'id':1,...}` when updating a single schedules, or in the form `[{'id':1,...},{'id':2,...},...]` when updating multiple schedules within the same call +- `schedules` can contain one or more schedules which are set within the same call - the `id` is compulsory on each `schedule` (should be 1 to 5 depending on the vehicle) - the `activated` flag is an optional boolean. If it is not provided, then the existing flag will be kept as is. -- the `monday` to `sunday` elements are optional. If they are not provided, then the existing settings will be kept for each day. If they are provided as None, then the existing setting will be cleared. If a value is provided, it must conform to this format `{'startTime':'T12:00Z','duration':15}` where start time is in UTC format and the duration is in minutes. +- the `monday` to `sunday` elements are optional. If they are not provided, then the existing settings will be kept for each day. If they are provided as None, then the existing setting will be cleared. If a value is provided, it must contain the keys `startTime` (in UTC format) and `duration` (in minutes). Example: ```yaml -[ - { - 'id': 1, - 'activated': true, - 'monday': {'startTime':'T12:00Z', 'duration':15} - }, - { - 'id': 2, - 'activated': false, - 'monday': {'startTime':'T12:00Z', 'duration':240} - }, -] +- id: 1 + activated: true + monday: + startTime: 'T12:00Z' + duration: 15 +- id: 1 + activated: false + monday: + startTime: 'T12:00Z' + duration: 15 ``` From caf3e954a39e2f5995b7f0ecb6f41ed83b53947f Mon Sep 17 00:00:00 2001 From: Adam Pasztor Date: Mon, 23 Sep 2024 09:48:23 +0200 Subject: [PATCH 13/29] Add ADS Select documentation (#34714) * Add ADS Select documentation * fix phrasing. Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/ads.markdown | 33 ++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/source/_integrations/ads.markdown b/source/_integrations/ads.markdown index 81aaab85623..c7ef4399a40 100644 --- a/source/_integrations/ads.markdown +++ b/source/_integrations/ads.markdown @@ -34,8 +34,10 @@ There is currently support for the following device types within Home Assistant: - [Sensor](#sensor) - [Switch](#switch) - [Cover](#cover) +- [Select](#select) - [Valve](#valve) + ## Configuration To enable ADS, add the following lines to your {% term "`configuration.yaml`" %} file. @@ -63,6 +65,7 @@ ip_address: type: string {% endconfiguration %} + ## Action The ADS integration will register the `write_by_name` action allowing you to write a value to a variable on your ADS device. @@ -257,6 +260,20 @@ device_class: type: device_class {% endconfiguration %} +## Select + +The `ads` select entity accesses an ENUM (int) variable on the connected ADS device. The variable is identified by its name. You have to set up a corresponding ENUM in the TwinCAT PLC. It is recommended to use explicit values starting from `0`. + +```yaml +TYPE E_SampleA : +( + e1 := 0, + e2 := 1, + e3 := 2, +); +END_TYPE +``` + ## Valve The `ads` valve entity accesses a boolean variable on the connected ADS device. The variable is identified by its name. @@ -266,6 +283,16 @@ file: ```yaml # Example configuration.yaml entry +select: + - platform: ads + adsvar: MAIN.eMyEnum + options: + - "Off" + - "Setup" + - "Automatic" + - "Manual" + - "Guest" + - "Error" valve: - platform: ads adsvar: MAIN.bValveControl @@ -276,8 +303,12 @@ adsvar: required: true description: The name of the variable which you want to access on the ADS device. type: string +options: + required: true + description: The available options to select from. + type: string name: required: false description: An identifier for the valve in the frontend. type: string -{% endconfiguration %} +{% endconfiguration %} \ No newline at end of file From 6ffeb91441b1336a3e4375238fff68905c2ee627 Mon Sep 17 00:00:00 2001 From: TimL Date: Mon, 23 Sep 2024 17:51:57 +1000 Subject: [PATCH 14/29] Document Smlight Zigbee router reconnect button (#34856) * Document Zigbee router reconnect button * tiny tweak --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/smlight.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/smlight.markdown b/source/_integrations/smlight.markdown index 51a440365ea..8d6673c5f8c 100644 --- a/source/_integrations/smlight.markdown +++ b/source/_integrations/smlight.markdown @@ -73,6 +73,7 @@ The following buttons will be created: - **Core restart** - Restart core ESP32 - **Zigbee restart** - Restart Zigbee CCCC2652 or EFR32 chip - **Zigbee flash mode** - Trigger the Zigbee chip into bootloader flash mode so it can be flashed. It is possible to flash Zigbee firmware over a network socket once this is activated. +- **Reconnect Zigbee router** - Place the router into pairing mode to join a new Zigbee network. This is only created if the SLZB-06x device is in Zibgee router mode. ### Switches From e814f5f7c577843c34cbdd4cda835a1b7fee256e Mon Sep 17 00:00:00 2001 From: Allen Porter Date: Mon, 23 Sep 2024 02:27:26 -0700 Subject: [PATCH 15/29] Update documentation for Google Photos integration (#34855) * Update documentation for Google Photos integration based on latest functionality * tiny tweak --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/google_photos.markdown | 22 +++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/source/_integrations/google_photos.markdown b/source/_integrations/google_photos.markdown index 03c8f2cff5c..fec4ea0bc41 100644 --- a/source/_integrations/google_photos.markdown +++ b/source/_integrations/google_photos.markdown @@ -21,8 +21,10 @@ related: title: Google Developers Console --- -The **Google Photos** integration allows you to connect your [Google Photos](https://photos.google.com/) to Home Assistant. The integration adds a [media source](/integrations/media_source) with -recent photos allowing you to view or cast your photos from the media browser. +The **Google Photos** integration allows you to upload photos to your [Google Photos](https://photos.google.com/) using Home Assistant. The integration adds an action for uploading photos and a +[media source](/integrations/media_source) to view or cast the content uploaded by +Home Assistant. This integration does not give Home Assistant access to your +entire Google Photos library. ## Prerequisites @@ -76,6 +78,22 @@ The integration setup will next give you instructions to enter the [Application {% enddetails %} + +### Action `google_photos.upload` + +You can use the `google_photos.upload` action to upload Photos from Home Assistant +to Google Photos. + +{% details "Create event action details" %} + +| Data attribute | Optional | Description | Example | +| ---------------------- | -------- | ----------- | --------| +| `filename` | no | Path to the image to upload. | /mnt/image.jpg +| `config_entry_id` | no | The ID of the Google Photos config entry. | a1bee602deade2b09bc522749bbce48e | + +{% enddetails %} + + ## Troubleshooting If you have an error with your credentials, you can delete them in the [Application Credentials](/integrations/application_credentials/) user interface. From 1993e7e08068f67353ded01763bbf93d05ae2375 Mon Sep 17 00:00:00 2001 From: Niklas Wagner Date: Mon, 23 Sep 2024 11:31:12 +0200 Subject: [PATCH 16/29] Offboard myself as prusalink codeowner (#34845) --- CODEOWNERS | 2 +- source/_integrations/prusalink.markdown | 1 - 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/CODEOWNERS b/CODEOWNERS index 23e63a7f9d1..fbfb50b6421 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -634,7 +634,7 @@ source/_integrations/prometheus.markdown @knyar source/_integrations/prosegur.markdown @dgomes source/_integrations/proximity.markdown @mib1185 source/_integrations/proxmoxve.markdown @jhollowe @Corbeno -source/_integrations/prusalink.markdown @balloob @Skaronator +source/_integrations/prusalink.markdown @balloob source/_integrations/ps4.markdown @ktnrg45 source/_integrations/pse.markdown @tronikos source/_integrations/psoklahoma.markdown @tronikos diff --git a/source/_integrations/prusalink.markdown b/source/_integrations/prusalink.markdown index e782883e9de..1e0a380f075 100644 --- a/source/_integrations/prusalink.markdown +++ b/source/_integrations/prusalink.markdown @@ -8,7 +8,6 @@ ha_release: '2022.9' ha_config_flow: true ha_codeowners: - '@balloob' - - '@Skaronator' ha_domain: prusalink ha_integration_type: integration ha_platforms: From e2addb84b578f342294a1cb41dc21a9432204d7b Mon Sep 17 00:00:00 2001 From: dontinelli <73341522+dontinelli@users.noreply.github.com> Date: Mon, 23 Sep 2024 11:57:25 +0200 Subject: [PATCH 17/29] Update solarlog documentation (#34753) * Update solarlog documentation Update documentation to reflect new features with upcoming PR * Update solarlog.markdown * Update solarlog.markdown * Update solarlog.markdown * tiny tweaks --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/solarlog.markdown | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/source/_integrations/solarlog.markdown b/source/_integrations/solarlog.markdown index 26681476f67..ceec10c716c 100644 --- a/source/_integrations/solarlog.markdown +++ b/source/_integrations/solarlog.markdown @@ -16,22 +16,26 @@ ha_platforms: ha_integration_type: integration --- -The `solarlog` integration uses the open JSON interface on [Solar-Log PV monitoring systems](https://www.solar-log.com/) to allow you to get details from your Solar-Log device and integrate these into your Home Assistant installation. +The **Solarlog** {% term integration %} uses the open JSON interface on [Solar-Log PV monitoring systems](https://www.solar-log.com/) to get details from your Solar-Log device and integrate these into your Home Assistant installation. -Before being able to use the integration, you have to activate the open JSON interface on your Solar-Log device. This can be activated from the Configuration | System | Access control menu of your Solar-Log device. -When activating the interface, a red warning triangle with security information and risks is displayed. +## Prerequisites + +Before you can use the integration, you either need the password of the Solar-Log user or you must activate the open JSON interface on your Solar-Log device. +- To activate the JSON interface on your Solar-Log device, on the device, go to the Configuration | System | Access control menu. +- When activating the interface, a red warning triangle with security information and risks is displayed. For security reasons, it is recommended to activate password protection and use the integration with the respective password. The `solarlog` integration uses the default host address "http://solar-log" if you don't specify a host. If your device isn't accessible on this address, use its IP Address instead. {% important %} -The open JSON interface is deactivated by default. To activate the open JSON interface, a user password should be set for security purposes. The password isn't needed for accessing the open JSON interface. +If password protection for the general user is deactivated, the open JSON interface is activated by default. For security reasons, it is recommended to activate the user's password. +Please note that the open JSON interface only exposes a limited amount of data. Even if the open JSON interface has been activated, without the user's password, only limited data is available in the integration [see available sensors](#sensors). For [full functionality](#additional-data), you either need the user's password or the user password should be deactivated (not recommended). {% endimportant %} {% include integrations/config_flow.md %} ## Additional template sensor -In case you would like to convert the values, for example, to Wh instead of the default kWh, you can use the [template platform](/integrations/template/). +In case you would like to get additional calculated sensors such as the amount of excess solar power available, you can use the [template platform](/integrations/template/). {% raw %} @@ -47,7 +51,7 @@ template: ## Sensors -The following sensors are available in the library: +The following sensors are available via the open JSON intervace: | name | Unit | Description | |-----------------------|--------|:-------------------------------------------| @@ -67,7 +71,6 @@ The following sensors are available in the library: | consumption_month | kWh | Total consumption for the month from all of the consumption meters. | | consumption_year | kWh | Total consumption for the year from all of the consumption meters. | | consumption_total | kWh | Accumulated total consumption from all consumption meters. | -| self_consumption_year | kWh | Accumulated total self-consumption. | | installed_peak_power | W | Installed solar peak power. | | alternator_loss | W | Altenator loss (equals to power_dc - power_ac) | | capacity | % | Capacity (equals to power_dc / total power) | @@ -78,11 +81,9 @@ The following sensors are available in the library: ## Additional data {% important %} -The additional data is only accessible if the user's password protection is deactivated. Obviously, deactivating password protection is a security risk and should only be done in specific circumstances. In any event, you do this at your own risk. +The additional data is only accessible if the user's password is available (or password protection is deactivated). Obviously, deactivating password protection is a security risk and should only be done in specific circumstances. In any event, you do this at your own risk. {% endimportant %} -You can get additional data from the Solar-Log device. To enable this, select the checkbox for extended data in the integration's system options. - The following additional sensor becomes available: | Name | Unit | Description | From c9be159a4248da051a72379bbd24d73d51ffa518 Mon Sep 17 00:00:00 2001 From: Brett Adams Date: Mon, 23 Sep 2024 20:52:30 +1000 Subject: [PATCH 18/29] Add lock platform to Tesla Fleet (#34860) Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/tesla_fleet.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_integrations/tesla_fleet.markdown b/source/_integrations/tesla_fleet.markdown index e066bca84e5..128e82eb8c0 100644 --- a/source/_integrations/tesla_fleet.markdown +++ b/source/_integrations/tesla_fleet.markdown @@ -7,6 +7,7 @@ ha_category: - Climate - Cover - Device tracker + - Lock - Media player - Number - Select @@ -24,6 +25,7 @@ ha_platforms: - cover - device_tracker - diagnostics + - lock - media_player - number - select @@ -101,6 +103,8 @@ These are the entities available in the Tesla Fleet integration. Not all entitie |Cover|Vent windows|Yes| |Device tracker|Location|Yes| |Device tracker|Route|Yes| +|Lock|Charge cable lock|Yes| +|Lock|Lock|Yes| |Media player|Media player|Yes| |Number|Charge current|Yes| |Number|Charge limit|Yes| From af9205ac8408ce79591afb8ec9664fc7d793fa23 Mon Sep 17 00:00:00 2001 From: Galorhallen <12990764+Galorhallen@users.noreply.github.com> Date: Mon, 23 Sep 2024 13:27:56 +0200 Subject: [PATCH 19/29] Govee light local update (#34735) * Update govee light documentation * Add missing commas --- .../_integrations/govee_light_local.markdown | 29 +++++++++++++++++-- 1 file changed, 27 insertions(+), 2 deletions(-) diff --git a/source/_integrations/govee_light_local.markdown b/source/_integrations/govee_light_local.markdown index d025249d8c6..720b032f990 100644 --- a/source/_integrations/govee_light_local.markdown +++ b/source/_integrations/govee_light_local.markdown @@ -33,23 +33,33 @@ H6062, H6065, H6066, H6067, +H606A, H6072, H6073, H6076, H6078, +H6079, +H607C, H6087, H6088, H608A, H608B, H610A, H610B, +H6110, H6117, H6159, +H615A, +H615B, +H615C, +H615D, H615E, H6163, H6168, H6172, H6173, +H6175, +H6176, H618A, H618C, H618E, @@ -68,25 +78,40 @@ H61A5, H61A8, H61B2, H61B5, +H61BA, H61BE, H61C3, +H61C5, H61D3, +H61D5, +H61E0, H61E1, H7012, H7013, H7020, H7021, H7028, +H7033, +H7037, +H7038, +H7039, H7041, H7042, H7050, H7051, +H7052, H7055, H705A, H705B, +H705C, H7060, H7061, H7062, +H7063, H7065, -H706A, -H70C1 +H7066, +H7075, +H70A1, +H70B1, +H70C1, +H70C2 \ No newline at end of file From 95a860ccff44d177c8462ced65d7d140b6a2a340 Mon Sep 17 00:00:00 2001 From: Antony Kurniawan Date: Mon, 23 Sep 2024 18:40:43 +0700 Subject: [PATCH 20/29] Update derivative docs for a new total_increasing handling (#33152) --- source/_integrations/derivative.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/derivative.markdown b/source/_integrations/derivative.markdown index 38675da77c2..07fc32a3744 100644 --- a/source/_integrations/derivative.markdown +++ b/source/_integrations/derivative.markdown @@ -21,7 +21,7 @@ ha_integration_type: helper The derivative ([Wikipedia](https://en.wikipedia.org/wiki/Derivative)) integration creates a sensor that estimates the derivative of the values provided by another sensor (the **source sensor**). Derivative sensors are updated upon changes of the **source sensor**. -For sensors that reset to zero after a power interruption and need a "non-negative derivative", such as bandwidth counters in routers, or rain gauges, consider using the [Utility Meter](/integrations/utility_meter/) integration instead. Otherwise, each reset will register a significant change in the derivative sensor. +For sensors that reset to zero after a power interruption and need a "non-negative derivative", such as bandwidth counters in routers, or rain gauges, you can now use this integration directly. Ensure that the input sensor has a `total_increasing` state class, as this is necessary for the integration to handle resets correctly without registering significant changes in the derivative sensor. {% include integrations/config_flow.md %} {% configuration_basic %} From 12f1e4d90c1b356df9bcd9f5b58e272063aec57f Mon Sep 17 00:00:00 2001 From: Fredrik Erlandsson Date: Mon, 23 Sep 2024 13:43:13 +0200 Subject: [PATCH 21/29] Add documentation for Point oauth2 (#32971) Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/point.markdown | 44 +++++++++++------------------ 1 file changed, 16 insertions(+), 28 deletions(-) diff --git a/source/_integrations/point.markdown b/source/_integrations/point.markdown index 15aff89863a..aa8baf5dc3d 100644 --- a/source/_integrations/point.markdown +++ b/source/_integrations/point.markdown @@ -19,44 +19,32 @@ ha_platforms: - sensor ha_integration_type: integration related: - - docs: /docs/configuration/ - title: Configuration file + - docs: /integrations/application_credentials/ + title: Application credentials --- -The Point hub enables integration with the [Minut Point](https://minut.com/). To connect with Point, you will have to [sign up for a developer account and have a Pro subscription](https://minut.com/community/developers/) and get a `client_id` and `client_secret` with the `callback url` configured as your Home Assistant URL + `/api/minut`, e.g., `http://homeassistant.local:8123/api/minut`. The `client_id` and `client_secret` should be used as below. +The Point hub enables integration with the [Minut Point](https://minut.com/). -Once Home Assistant is started, a configurator will pop up asking you to Authenticate your Point account via a link. When you follow the link and click on **Accept** you will be redirected to the `callback url` and the Point integration will be automatically configured and you can go back to the original dialog and press **Submit**. -There is currently support for the following device types within Home Assistant: +## Prerequisites -- [Alarm](#alarm) -- [Binary sensor](#binary-sensor) -- [Sensor](#sensor) +Before adding the integration to Home Assistant, you need to get Minut Point application credentials. -### Configuration +1. Navigate to the [API-client | Minut](https://web.minut.com/settings/api-clients) dashboard and **Create client**: -To use the Minut Point {% term integration %} in your installation, add it to your {% term "`configuration.yaml`" %} file. -{% include integrations/restart_ha_after_config_inclusion.md %} + - Enter a **Name** for your client (this is just an identifier). + - Enter `https://my.home-assistant.io/redirect/oauth` in the **Redirect URI** field. +2. Get the **ClientID** and **ClientSecret** for the new client and store them in a safe place. You need them to complete the integration setup in Home Assistant. -```yaml -# Example configuration.yaml entry -point: - client_id: CLIENT_ID - client_secret: CLIENT_SECRET -``` +
-{% configuration %} -client_id: - description: Your Minut Point developer client ID. - required: true - type: string -client_secret: - description: Your Minut Point developer client secret. - required: true - type: string -{% endconfiguration %} +If you are a Kickstarter backer, you need to send an email to hello@minut.com to retrieve the **ClientID** and **ClientSecret**. Don't forget to mention that the **Redirect URI** should be `https://my.home-assistant.io/redirect/oauth`. -# Device types +
+ +{% include integrations/config_flow.md %} + +## Device types The integration supports the following device types within Home Assistant: - [Alarm](#alarm) From 9c20edfcbb610ec09a16f4881e08634f21989925 Mon Sep 17 00:00:00 2001 From: Brett Adams Date: Mon, 23 Sep 2024 21:48:30 +1000 Subject: [PATCH 22/29] Add button platform (#34857) --- source/_integrations/tesla_fleet.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_integrations/tesla_fleet.markdown b/source/_integrations/tesla_fleet.markdown index 128e82eb8c0..097527458ca 100644 --- a/source/_integrations/tesla_fleet.markdown +++ b/source/_integrations/tesla_fleet.markdown @@ -3,6 +3,7 @@ title: Tesla Fleet description: Instructions on how to integrate the Tesla Fleet API within Home Assistant. ha_category: - Binary sensor + - Button - Car - Climate - Cover @@ -21,6 +22,7 @@ ha_codeowners: ha_domain: tesla_fleet ha_platforms: - binary_sensor + - button - climate - cover - device_tracker @@ -94,6 +96,12 @@ These are the entities available in the Tesla Fleet integration. Not all entitie |Binary sensor|Tire pressure warning rear right|No| |Binary sensor|Trip charging|No| |Binary sensor|User present|Yes| +|Button|Flash lights|Yes| +|Button|Homelink|Yes| +|Button|Honk horn|Yes| +|Button|Keyless driving|Yes| +|Button|Play fart|Yes| +|Button|Wake|Yes| |Climate|Cabin overheat protection|No| |Climate|Climate|Yes| |Cover|Charge port door|Yes| From f8b6109e119c4c862938792b6a66ada0de3da966 Mon Sep 17 00:00:00 2001 From: Adam Pasztor Date: Mon, 23 Sep 2024 13:50:46 +0200 Subject: [PATCH 23/29] Extend ADS Sensor documentation (#34665) --- source/_integrations/ads.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/ads.markdown b/source/_integrations/ads.markdown index c7ef4399a40..45f9852f903 100644 --- a/source/_integrations/ads.markdown +++ b/source/_integrations/ads.markdown @@ -145,7 +145,7 @@ name: ## Sensor -The `ads` sensor platform allows reading the value of a numeric variable on your ADS device. The variable can be of type *INT*, *UINT*, *BYTE*, *DINT* or *UDINT*. +The `ads` sensor platform allows reading the value of a numeric variable on your ADS device. The variable can be of type *BOOL*, *BYTE*, *INT*, *UINT*, *SINT*, *USINT*, *DINT*, *UDINT*, *WORD*, *DWORD*, *REAL*, or *LREAL*. To use your ADS device, you first have to set up your [ADS hub](#configuration) and then add the following to your {% term "`configuration.yaml`" %} file: @@ -166,7 +166,7 @@ adsvar: type: string adstype: required: false - description: The datatype of the ADS variable, possible values are int, uint, byte, dint, udint. + description: The datatype of the ADS variable, possible values are bool, byte, int, uint, sint, usint, dint, udint, word, dword, real and lreal. default: int type: string name: From 995eb2ccd08b1adb5c8e850733f1715f5b34c3d7 Mon Sep 17 00:00:00 2001 From: Martin Dybal Date: Mon, 23 Sep 2024 13:52:36 +0200 Subject: [PATCH 24/29] Added icon_hold_action and icon_double_tap_action for tile card (#34706) --- source/_dashboards/tile.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_dashboards/tile.markdown b/source/_dashboards/tile.markdown index ef962f71969..719c6cc247e 100644 --- a/source/_dashboards/tile.markdown +++ b/source/_dashboards/tile.markdown @@ -79,6 +79,14 @@ icon_tap_action: required: false description: Action taken on icon card tap. See [action documentation](/dashboards/actions/#tap-action). By default, it will `toggle` the entity (if possible), otherwise, show the "more-info" dialog. type: map +icon_hold_action: + required: false + description: Action taken on icon tap-and-hold. See [action documentation](/dashboards/actions/#hold-action). + type: map +icon_double_tap_action: + required: false + description: Action taken on icon double tap. See [action documentation](/dashboards/actions/#double-tap-action). + type: map features: required: false description: Additional widgets to control your entity. See [available features](/dashboards/features). From 2d0528c7af01c2442bc7d9a7795ae66a7eb72c9b Mon Sep 17 00:00:00 2001 From: Jeef Date: Mon, 23 Sep 2024 06:29:56 -0600 Subject: [PATCH 25/29] Adding Monarch Money docs (#34327) * Adding Monarch Money docs * adding finance category * Update source/_integrations/monarchmoney.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/monarchmoney.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Updated domain name * Update source/_integrations/monarch_money.markdown Co-authored-by: Joost Lekkerkerker * Apply suggestions from code review * Update source/_integrations/monarch_money.markdown * Update source/_integrations/monarch_money.markdown * Update source/_integrations/monarch_money.markdown * Update source/_integrations/monarch_money.markdown --------- Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: Joost Lekkerkerker Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/monarch_money.markdown | 34 +++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 source/_integrations/monarch_money.markdown diff --git a/source/_integrations/monarch_money.markdown b/source/_integrations/monarch_money.markdown new file mode 100644 index 00000000000..15731b14735 --- /dev/null +++ b/source/_integrations/monarch_money.markdown @@ -0,0 +1,34 @@ +--- +title: Monarch Money +description: Instructions on the Monarch Money Integration for personal finance. +ha_category: + - Sensor + - Finance +ha_iot_class: Cloud Polling +ha_release: "2024.10" +ha_codeowners: + - '@jeeftor' +ha_domain: monarch_money +ha_config_flow: true +ha_platforms: + - sensor +ha_integration_type: service +--- + +[Monarch Money](https://www.monarchmoney.com) is a personal finance aggregation and budgeting service that integrates with Plaid, MX, and FinCity, the three major financial backends. + +## Prerequisites + +- You need a Monarch Money account to use this integration. +- You need account credentials. This integration supports both `username` and `password` login, as well as accounts configured with `MFA`. + +{% include integrations/config_flow.md %} + +### Accounts & devices + +Each `account` is set up as a device in Home Assistant and contain the following sensors: + +|Sensor|Description| +|-------|---------------| +|Balance|Account balance| +|Age| This sensor shows when the data was retrieved by Monarch's back end | From b8563bfabe300d57258bbc85bf1fb519e1119266 Mon Sep 17 00:00:00 2001 From: Joost Lekkerkerker Date: Mon, 23 Sep 2024 14:36:44 +0200 Subject: [PATCH 26/29] Fix more releases (#34881) --- source/_integrations/aps.markdown | 2 +- source/_integrations/duke_energy.markdown | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/aps.markdown b/source/_integrations/aps.markdown index dd633c1d0f2..ee909278145 100644 --- a/source/_integrations/aps.markdown +++ b/source/_integrations/aps.markdown @@ -4,7 +4,7 @@ description: Get energy usage from Arizona Public Service (APS) using the Opower ha_category: - Energy - Sensor -ha_release: 2024.10 +ha_release: "2024.10" ha_domain: aps ha_integration_type: virtual ha_supporting_domain: opower diff --git a/source/_integrations/duke_energy.markdown b/source/_integrations/duke_energy.markdown index 20c144d2ef7..4004c645876 100644 --- a/source/_integrations/duke_energy.markdown +++ b/source/_integrations/duke_energy.markdown @@ -3,7 +3,7 @@ title: Duke Energy description: Instructions on how to integrate Duke Energy within Home Assistant. ha_category: - Energy -ha_release: 2024.10 +ha_release: "2024.10" ha_iot_class: Cloud Polling ha_codeowners: - '@hunterjm' From e76cfcfc65c1c7556d61538c0484deca91e1c85d Mon Sep 17 00:00:00 2001 From: Tal Taub Date: Mon, 23 Sep 2024 15:38:22 +0300 Subject: [PATCH 27/29] Tami4 Edge - add new actions (#34421) * add new actions * Updated based on design changes * Update source/_integrations/tami4.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --------- Co-authored-by: Klaas Schoute Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/tami4.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_integrations/tami4.markdown b/source/_integrations/tami4.markdown index 33e8a8b2cd3..74f24940665 100644 --- a/source/_integrations/tami4.markdown +++ b/source/_integrations/tami4.markdown @@ -18,6 +18,7 @@ ha_integration_type: integration Support for [Tami4 Edge / Edge+ by Strauss](https://www.tami4.co.il/tami4edge-collection) in Home Assistant. You can boil water and get filter / UV information, such as when you need to replace them. +Also, all of your personal drinks will be available as buttons for you to use. You can easily pair your device by confirming your phone number which is registered with your Edge app account. From db195750477865e3fa9ad93f5a5d0b79c0ed4983 Mon Sep 17 00:00:00 2001 From: Russell VanderMey Date: Mon, 23 Sep 2024 09:52:30 -0400 Subject: [PATCH 28/29] Add TRIGGERcmd integration documentation (#33575) * Added triggercmd documentation page * Tweaked doccumentation * Take control of blueprint: update to reflect current SW (#33556) * Update source/_integrations/triggercmd.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/triggercmd.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/triggercmd.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/triggercmd.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/triggercmd.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/triggercmd.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * Update source/_integrations/triggercmd.markdown Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> * remove unrelated changes in Gemfile.lcok * Apply suggestions from code review * Apply suggestions from code review * fix version Co-authored-by: Joost Lekkerkerker * Tiny style tweaks * Update source/_integrations/triggercmd.markdown * Update source/_integrations/triggercmd.markdown * Move config flow after prereqs * move info about token to prereqs * Update source/_integrations/triggercmd.markdown * Update source/_integrations/triggercmd.markdown * Update source/_integrations/triggercmd.markdown --------- Co-authored-by: vel1kan Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Co-authored-by: Joost Lekkerkerker --- source/_integrations/triggercmd.markdown | 36 ++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 source/_integrations/triggercmd.markdown diff --git a/source/_integrations/triggercmd.markdown b/source/_integrations/triggercmd.markdown new file mode 100644 index 00000000000..61f76fba98c --- /dev/null +++ b/source/_integrations/triggercmd.markdown @@ -0,0 +1,36 @@ +--- +title: TRIGGERcmd +description: How to integrate TRIGGERcmd with Home Assistant. +ha_category: + - Switch + - Automation +ha_release: "2024.10" +ha_iot_class: Cloud Polling +ha_config_flow: true +ha_codeowners: + - '@rvmey' +ha_domain: triggercmd +ha_platforms: + - switch +ha_zeroconf: false +ha_integration_type: integration +--- + +The TRIGGERcmd {% term integration %} allows you to run commands on computers via [TRIGGERcmd](https://triggercmd.com/) with Home Assistant. + + +## Prerequisites + +To use TRIGGERcmd, you need the following: + +- A [TRIGGERcmd account](https://www.triggercmd.com/user/auth/signup) +- A computer with the TRIGGERcmd agent running on it +- For instructions on installing and using TRIGGERcmd itself, refer to the [TRIGGERcmd Quick Start Guide](https://docs.triggercmd.com/#/./QuickStart). +- After adding the TRIGGERcmd integration, you will be prompted for your **user token**. This can be found at the bottom of your TRIGGERcmd profile page or the instructions page. +{% include integrations/config_flow.md %} + +## Using TRIGGERcmd with Home Assistant + +All of your TRIGGERcmd commands should show up as **switch** devices. You can change the rooms of your devices, or select **Finish** to leave them without rooms. + +Using the switch will trigger the respective command. If you have **Allow parameters** enabled, your command will run with an "on" or "off" parameter, depending on whether you flip the switch in Home Assistant on or off. From 5707b9388c24fa8d501a8e0282d20a729241e750 Mon Sep 17 00:00:00 2001 From: Joost Lekkerkerker Date: Mon, 23 Sep 2024 17:40:29 +0200 Subject: [PATCH 29/29] Add NYT Games documentation (#34868) * Add NYT Games documentation * Tiny tweaks --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/nyt_games.markdown | 29 +++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 source/_integrations/nyt_games.markdown diff --git a/source/_integrations/nyt_games.markdown b/source/_integrations/nyt_games.markdown new file mode 100644 index 00000000000..03b9909dd39 --- /dev/null +++ b/source/_integrations/nyt_games.markdown @@ -0,0 +1,29 @@ +--- +title: NYT Games +description: Instructions on how to setup NYT Games in Home Assistant. +ha_category: + - Sensor +ha_config_flow: true +ha_release: "2024.10" +ha_iot_class: Cloud Polling +ha_codeowners: + - '@joostlek' +ha_domain: nyt_games +ha_platforms: + - sensor +--- + +The [NYT Games](https://www.nytimes.com/crosswords) integration fetches data about your progress on their daily puzzles. + +## Prerequisites + +Before setting up the integration, you need to fetch the token from the dev tools of your browser. + +1. On your computer, go to [NYT Games](https://www.nytimes.com/crosswords). +2. Login with your account. +3. Open the developer tools via right-click or by pressing F12. +4. Open the network tab and refresh the page. +5. Select a request with `.json` in the name and go to the cookie tab. +6. The token can be found in the `NYT-S` cookie. + +{% include integrations/config_flow.md %}