mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 05:16:49 +00:00
Merge branch 'rc' into current
This commit is contained in:
commit
91af360b1c
20
CODEOWNERS
20
CODEOWNERS
@ -161,6 +161,7 @@ source/_integrations/config.markdown @home-assistant/core
|
||||
source/_integrations/configurator.markdown @home-assistant/core
|
||||
source/_integrations/control4.markdown @lawtancool
|
||||
source/_integrations/conversation.markdown @home-assistant/core @synesthesiam
|
||||
source/_integrations/cookidoo.markdown @miaucl
|
||||
source/_integrations/coolmaster.markdown @OnFreund
|
||||
source/_integrations/counter.markdown @fabaff
|
||||
source/_integrations/cover.markdown @home-assistant/core
|
||||
@ -223,6 +224,7 @@ source/_integrations/ecovacs.markdown @mib1185 @edenhaus @Augar
|
||||
source/_integrations/ecowitt.markdown @pvizeli
|
||||
source/_integrations/efergy.markdown @tkdrob
|
||||
source/_integrations/egardia.markdown @jeroenterheerdt
|
||||
source/_integrations/eheimdigital.markdown @autinerd
|
||||
source/_integrations/electrasmart.markdown @jafar-atili
|
||||
source/_integrations/electric_kiwi.markdown @mikey0000
|
||||
source/_integrations/elevenlabs.markdown @sorgfresser
|
||||
@ -329,7 +331,7 @@ source/_integrations/google_photos.markdown @allenporter
|
||||
source/_integrations/google_sheets.markdown @tkdrob
|
||||
source/_integrations/google_tasks.markdown @allenporter
|
||||
source/_integrations/google_travel_time.markdown @eifinger
|
||||
source/_integrations/govee_ble.markdown @bdraco @PierreAronnax
|
||||
source/_integrations/govee_ble.markdown @bdraco
|
||||
source/_integrations/govee_light_local.markdown @Galorhallen
|
||||
source/_integrations/gpsd.markdown @fabaff @jrieger
|
||||
source/_integrations/gree.markdown @cmroche
|
||||
@ -414,7 +416,7 @@ source/_integrations/intellifire.markdown @jeeftor
|
||||
source/_integrations/intesishome.markdown @jnimmo
|
||||
source/_integrations/ios.markdown @robbiet480
|
||||
source/_integrations/iotawatt.markdown @gtdiehl @jyavenard
|
||||
source/_integrations/iotty.markdown @pburgio @shapournemati-iotty
|
||||
source/_integrations/iotty.markdown @shapournemati-iotty
|
||||
source/_integrations/iperf3.markdown @rohankapoorcom
|
||||
source/_integrations/ipma.markdown @dgomes
|
||||
source/_integrations/iqvia.markdown @bachya
|
||||
@ -428,6 +430,7 @@ source/_integrations/israel_rail.markdown @shaiu
|
||||
source/_integrations/iss.markdown @DurgNomis-drol
|
||||
source/_integrations/ista_ecotrend.markdown @tr4nt0r
|
||||
source/_integrations/isy994.markdown @bdraco @shbatm
|
||||
source/_integrations/ituran.markdown @shmuelzon
|
||||
source/_integrations/izone.markdown @Swamp-Ig
|
||||
source/_integrations/jellyfin.markdown @j-stienstra @ctalkington
|
||||
source/_integrations/jewish_calendar.markdown @tsvi
|
||||
@ -545,6 +548,7 @@ source/_integrations/motioneye.markdown @dermotduffy
|
||||
source/_integrations/mqtt.markdown @emontnemery @jbouwh @bdraco
|
||||
source/_integrations/msteams.markdown @peroyvind
|
||||
source/_integrations/mullvad.markdown @meichthys
|
||||
source/_integrations/music_assistant.markdown @music-assistant
|
||||
source/_integrations/mutesync.markdown @currentoor
|
||||
source/_integrations/my.markdown @home-assistant/core
|
||||
source/_integrations/mysensors.markdown @MartinHjelmare @functionpointer
|
||||
@ -570,6 +574,7 @@ source/_integrations/nfandroidtv.markdown @tkdrob
|
||||
source/_integrations/nibe_heatpump.markdown @elupus
|
||||
source/_integrations/nice_go.markdown @IceBotYT
|
||||
source/_integrations/nightscout.markdown @marciogranzotto
|
||||
source/_integrations/niko_home_control.markdown @VandeurenGlenn
|
||||
source/_integrations/nilu.markdown @hfurubotten
|
||||
source/_integrations/nina.markdown @DeerMaximum
|
||||
source/_integrations/nissan_leaf.markdown @filcole
|
||||
@ -594,13 +599,14 @@ source/_integrations/nzbget.markdown @chriscla
|
||||
source/_integrations/obihai.markdown @dshokouhi @ejpenney
|
||||
source/_integrations/octoprint.markdown @rfleming71
|
||||
source/_integrations/ohmconnect.markdown @robbiet480
|
||||
source/_integrations/ohme.markdown @dan-r
|
||||
source/_integrations/ollama.markdown @synesthesiam
|
||||
source/_integrations/ombi.markdown @larssont
|
||||
source/_integrations/onboarding.markdown @home-assistant/core
|
||||
source/_integrations/oncue.markdown @bdraco @peterager
|
||||
source/_integrations/ondilo_ico.markdown @JeromeHXP
|
||||
source/_integrations/onewire.markdown @garbled1 @epenet
|
||||
source/_integrations/onkyo.markdown @arturpragacz
|
||||
source/_integrations/onkyo.markdown @arturpragacz @eclair4151
|
||||
source/_integrations/onvif.markdown @hunterjm
|
||||
source/_integrations/open_meteo.markdown @frenck
|
||||
source/_integrations/openai_conversation.markdown @balloob
|
||||
@ -626,6 +632,7 @@ source/_integrations/p1_monitor.markdown @klaasnicolaas
|
||||
source/_integrations/palazzetti.markdown @dotvav
|
||||
source/_integrations/panel_custom.markdown @home-assistant/frontend
|
||||
source/_integrations/pcs_lighting.markdown @gwww
|
||||
source/_integrations/peblar.markdown @frenck
|
||||
source/_integrations/peco.markdown @IceBotYT
|
||||
source/_integrations/peco_opower.markdown @tronikos
|
||||
source/_integrations/pegel_online.markdown @mib1185
|
||||
@ -646,6 +653,7 @@ source/_integrations/plum_lightpad.markdown @ColinHarrington @prystupa
|
||||
source/_integrations/point.markdown @fredrike
|
||||
source/_integrations/poolsense.markdown @haemishkyd
|
||||
source/_integrations/portlandgeneral.markdown @tronikos
|
||||
source/_integrations/powerfox.markdown @klaasnicolaas
|
||||
source/_integrations/powerwall.markdown @bdraco @jrester @daniel-simpson
|
||||
source/_integrations/private_ble_device.markdown @Jc2k
|
||||
source/_integrations/profiler.markdown @bdraco
|
||||
@ -773,6 +781,7 @@ source/_integrations/skybell.markdown @tkdrob
|
||||
source/_integrations/slack.markdown @tkdrob @fletcherau
|
||||
source/_integrations/sleepiq.markdown @mfugate1 @kbickar
|
||||
source/_integrations/slide.markdown @ualex73
|
||||
source/_integrations/slide_local.markdown @dontinelli
|
||||
source/_integrations/slimproto.markdown @marcelveldt
|
||||
source/_integrations/sma.markdown @kellerza @rklomp
|
||||
source/_integrations/smappee.markdown @bsmappee
|
||||
@ -808,11 +817,10 @@ source/_integrations/squeezebox.markdown @rajlaud @pssc @peteS-UK
|
||||
source/_integrations/srp_energy.markdown @briglx
|
||||
source/_integrations/starline.markdown @anonym-tsk
|
||||
source/_integrations/starlink.markdown @boswelja
|
||||
source/_integrations/statistics.markdown @ThomDietrich
|
||||
source/_integrations/statistics.markdown @ThomDietrich @gjohansson-ST
|
||||
source/_integrations/steam_online.markdown @tkdrob
|
||||
source/_integrations/steamist.markdown @bdraco
|
||||
source/_integrations/stiebel_eltron.markdown @fucm
|
||||
source/_integrations/stookalert.markdown @fwestenberg @frenck
|
||||
source/_integrations/stookwijzer.markdown @fwestenberg
|
||||
source/_integrations/stream.markdown @hunterjm @uvjustin @allenporter
|
||||
source/_integrations/stt.markdown @home-assistant/core
|
||||
@ -939,6 +947,7 @@ source/_integrations/wake_word.markdown @home-assistant/core @synesthesiam
|
||||
source/_integrations/wallbox.markdown @hesselonline
|
||||
source/_integrations/waqi.markdown @joostlek
|
||||
source/_integrations/water_heater.markdown @home-assistant/core
|
||||
source/_integrations/watergate.markdown @adam-the-hero
|
||||
source/_integrations/watson_tts.markdown @rutkai
|
||||
source/_integrations/watttime.markdown @bachya
|
||||
source/_integrations/waze_travel_time.markdown @eifinger
|
||||
@ -987,6 +996,7 @@ source/_integrations/yi.markdown @bachya
|
||||
source/_integrations/yolink.markdown @matrixd2
|
||||
source/_integrations/youless.markdown @gjong
|
||||
source/_integrations/youtube.markdown @joostlek
|
||||
source/_integrations/zabbix.markdown @kruton
|
||||
source/_integrations/zamg.markdown @killer0071234
|
||||
source/_integrations/zengge.markdown @emontnemery
|
||||
source/_integrations/zeroconf.markdown @bdraco
|
||||
|
@ -106,10 +106,10 @@ social:
|
||||
account: "https://fosstodon.org/@homeassistant"
|
||||
|
||||
# Home Assistant release details
|
||||
current_major_version: 2024
|
||||
current_minor_version: 12
|
||||
current_patch_version: 5
|
||||
date_released: 2024-12-20
|
||||
current_major_version: 2025
|
||||
current_minor_version: 1
|
||||
current_patch_version: 0
|
||||
date_released: 2025-01-03
|
||||
|
||||
# Either # or the anchor link to latest release notes in the blog post.
|
||||
# Must be prefixed with a # and have double quotes around it.
|
||||
|
@ -2,7 +2,7 @@
|
||||
type: card
|
||||
title: "Logbook card"
|
||||
sidebar_label: Logbook
|
||||
description: "The logbook card displays entries from the logbook for specific entities."
|
||||
description: "The logbook card displays entries from the logbook for specific entities, devices, areas, and/or labels."
|
||||
related:
|
||||
- docs: /integrations/frontend/
|
||||
title: Themes
|
||||
@ -10,7 +10,7 @@ related:
|
||||
title: Dashboard cards
|
||||
---
|
||||
|
||||
The logbook card displays entries from the logbook for specific entities.
|
||||
The logbook card displays entries from the logbook for specific entities, devices, areas, and/or labels.
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/dashboards/logbook.png' alt='Screenshot of the logbook card'>
|
||||
@ -22,8 +22,8 @@ The logbook card displays entries from the logbook for specific entities.
|
||||
## Card settings
|
||||
|
||||
{% configuration_basic %}
|
||||
Entities:
|
||||
description: The entities whose logbook entries will show in the card.
|
||||
Target:
|
||||
description: The entities, devices, areas and labels whose logbook entries will show in the card. See [target selector](/docs/blueprint/selectors/#target-selector) for more information.
|
||||
Title:
|
||||
description: The title that shows on the top of the card.
|
||||
Hours to show:
|
||||
@ -41,10 +41,10 @@ type:
|
||||
required: true
|
||||
description: "`logbook`"
|
||||
type: string
|
||||
entities:
|
||||
target:
|
||||
required: true
|
||||
description: The entities that will show in the card.
|
||||
type: list
|
||||
description: The target to use for the card.
|
||||
type: map
|
||||
title:
|
||||
required: false
|
||||
description: Title of the card.
|
||||
@ -64,9 +64,24 @@ theme:
|
||||
|
||||
```yaml
|
||||
type: logbook
|
||||
entities:
|
||||
- fan.ceiling_fan
|
||||
- fan.living_room_fan
|
||||
- light.ceiling_lights
|
||||
target:
|
||||
entity_id:
|
||||
- fan.ceiling_fan
|
||||
- fan.living_room_fan
|
||||
- light.ceiling_lights
|
||||
hours_to_show: 24
|
||||
```
|
||||
|
||||
```yaml
|
||||
type: logbook
|
||||
target:
|
||||
area_id: living_room
|
||||
device_id:
|
||||
- ff22a1889a6149c5ab6327a8236ae704
|
||||
- 52c050ca1a744e238ad94d170651f96b
|
||||
entity_id:
|
||||
- light.hallway
|
||||
- light.landing
|
||||
label_id:
|
||||
- lights
|
||||
```
|
||||
|
@ -125,7 +125,7 @@ name:
|
||||
label_mode:
|
||||
required: false
|
||||
default: name
|
||||
description: When set to `state`, renders the entity's state as the label for the map marker instead of the entity's name. This option doesn't apply to [zone](/integrations/zone/) entities because they don't use a label but an icon.
|
||||
description: When set to `icon`, renders the entity's icon in the marker instead of text. When set to `state`, renders the entity's state as the label for the map marker instead of the entity's name. This option doesn't apply to [zone](/integrations/zone/) entities because they don't use a label but an icon.
|
||||
type: string
|
||||
focus:
|
||||
required: false
|
||||
@ -143,6 +143,11 @@ source:
|
||||
required: true
|
||||
description: Name of a geolocation source, or `all`.
|
||||
type: string
|
||||
label_mode:
|
||||
required: false
|
||||
default: name
|
||||
description: When set to `icon`, renders the geolocation entity's icon in the marker instead of text. When set to `state`, renders the entity's state as the label for the map marker instead of the entity's name.
|
||||
type: string
|
||||
focus:
|
||||
required: false
|
||||
default: true
|
||||
|
@ -74,6 +74,19 @@ logarithmic_scale:
|
||||
description: If true, numerical values on the Y-axis will be displayed with a logarithmic scale.
|
||||
type: boolean
|
||||
default: false
|
||||
min_y_axis:
|
||||
required: false
|
||||
description: Lower bound for the Y-axis range.
|
||||
type: float
|
||||
max_y_axis:
|
||||
required: false
|
||||
description: Upper bound for the Y-axis range.
|
||||
type: float
|
||||
fit_y_data:
|
||||
required: false
|
||||
description: If true, configured Y-axis bounds would automatically extend (but not shrink) to fit the data.
|
||||
type: boolean
|
||||
default: false
|
||||
{% endconfiguration %}
|
||||
|
||||
### Options for entities
|
||||
|
@ -6,7 +6,7 @@ related:
|
||||
title: YAML syntax
|
||||
- docs: /docs/configuration/secrets
|
||||
title: Storing credentials in `secrets.yaml` file
|
||||
- docs: /common-tasks/os/#backups
|
||||
- docs: /common-tasks/general/#backups
|
||||
title: Creating and restoring backups
|
||||
- docs: /integrations/backup/docs/tools/dev-tools/#reloading-the-yaml-configuration
|
||||
title: Creating backups for Home Assistant Container and Core
|
||||
|
@ -18,9 +18,11 @@ Type these from anywhere in the application to launch the dialog.
|
||||
|
||||
| Mode | Hotkey | Switch Modes
|
||||
| ------------- | ------------- | ------------- |
|
||||
| Entity Filter | `e` | Type `>` at start of input to switch to command palette.
|
||||
| Entity Filter | `e` | Type `>` at start of input to switch to command palette. Type `#` at start of input to switch to device filter.
|
||||
| Command Palette | `c` | Remove `>` from start of input to switch to entity filter.
|
||||
| Device Filter | `d` | Remove `#` from start of input to switch to entity filter.
|
||||
| Create [`my`](/integrations/my) link | `m` | Open a new tab to create a my link to the page you are on.
|
||||
| Assist | `a` | Open the Home Assistant Assist dialog.
|
||||
|
||||
{% important %}
|
||||
The application must have focus for the hotkey to register. If the dialog doesn't launch, try clicking into an empty part of the main content area of Home Assistant and type it again.
|
||||
@ -41,6 +43,17 @@ Once launched, start typing your entity id (or ["bits and pieces" of your entity
|
||||
|
||||
This is helpful when, say, you are in the middle of writing an automation and need some quick insight about an entity but don't want to navigate away to Developer Tools.
|
||||
|
||||
## Device filter
|
||||
|
||||
*Hotkey: `d`*
|
||||
|
||||
Similar to {% my entities title="Settings -> Devices & Services -> Devices" %}, but accessible from anywhere in the frontend.
|
||||
|
||||
Once launched, start typing your device name to get back a filtered list of your devices. Clicking on a device (or hitting `enter` when the desired device is highlighted) will open the selected device detail page.
|
||||
|
||||
This is helpful when you need to quickly access a device's detail page without navigating your way through the menu.
|
||||
|
||||
|
||||
## Command palette
|
||||
|
||||
*Hotkey: `c`*
|
||||
@ -66,6 +79,15 @@ Type | Available |
|
||||
|
||||
Create [`my`](/integrations/my) links from any supported page in the user interface, when invoked on a supported page it will open a new tab that will allow you to share the link in different formats.
|
||||
|
||||
## Assist
|
||||
|
||||
*Hotkey: `a`*
|
||||
|
||||
Opens the Assist dialog to interact with Home Assistant using your voice or by text.
|
||||
This feature is only available if you have set up a voice assistant.
|
||||
|
||||
Learn more about [voice assistants](/voice_control).
|
||||
|
||||
## Disabling shortcuts
|
||||
|
||||
You can enable or disable all of Home Assistant's keyboard shortcuts by going to your User Profile and clicking the "Keyboard Shortcuts" toggle button.
|
||||
|
@ -1,8 +1,8 @@
|
||||
## Backups
|
||||
|
||||
Backup of your Home Assistant, add-on data, and configuration. Backups are used to [restore](#restoring-a-backup) a system or parts of it if a rollback is needed or to migrate your Home Assistant to new hardware. It is good practice to create a backup before updating.
|
||||
It is important to regularly back up your Home Assistant setup. You may have spent many hours configuring your system and creating automations. Keep your configurations safe so that you can [restore](#restoring-a-backup) a system or migrate your Home Assistant to new hardware.
|
||||
|
||||
Backups are made from the backups panel under {% my supervisor_backups title="**Settings** > **System** > **Backups**" %}. There is also an [action](/integrations/hassio/#action-hassiobackup_full) available that allows you to trigger the creation of a backup from an automation. Backups are stored in a compressed archive file (.tar) and by default, stored locally in the `/backup` directory.
|
||||
Backups are encrypted and stored in a compressed archive file (.tar) and by default, stored locally in the `/backup` directory.
|
||||
|
||||
A full backup includes the following directories:
|
||||
|
||||
@ -16,23 +16,68 @@ A partial backup consists of any number of the above default directories and ins
|
||||
|
||||
### Preparing for a backup
|
||||
|
||||
1. Before creating a backup, check if you can reduce the size of the backup.
|
||||
- Check if your configuration directory contains a large database file. Go to **{% my system_health title="Settings > System > Repairs" %}**. From the three dot menu, select **System information** and under the **Recorder** section, look for the **Estimated Database Size (MiB)**.
|
||||
Before creating a backup, check if you can reduce the size of the backup. This is especially important if you want to use the backup to migrate the system to new hardware, for example from a Raspberry Pi Compute Module 4 to a Raspberry Pi Compute Module 5.
|
||||
|
||||
1. Check if your configuration directory contains a large database file:
|
||||
- Go to {% my system_health title="**Settings** > **System** > **Repairs**" %}.
|
||||
- From the three dot menu, select **System information** and under the **Recorder** section, look for the **Estimated Database Size (MiB)**.
|
||||
- By default, the data is kept for 10 days. If you have modified that to a longer period, check the [`recorder`](/integrations/recorder/) integration page for options to keep your database data down to a size that won't cause issues.
|
||||
- Note the keep days, purge interval, and include/exclude options.
|
||||
2. To check how much space you've used in total, go to {% my system_health title="**Settings** > **System** > **Repairs**" %}.
|
||||
- From the three dot menu, select **System information**, and check under **Home Assistant Supervisor** > **Disk used**.
|
||||
- If you have add-ons installed that you no longer use, uninstall those add-ons. Some add-ons require quite a bit of space.
|
||||
2. Old backups are not included in the backup. However, while you are here, you could delete all old and unneeded backups.
|
||||
3. If you want to store the backup on your network storage instead of just locally on your system, follow the steps on [adding a new network storage](/common-tasks/os/#add-a-new-network-storage) and select the **Backup** option.
|
||||
|
||||
### Making a backup from the UI
|
||||
### Setting up an automatic backup process
|
||||
|
||||
1. Go to {% my supervisor_backups title="**Settings** > **System** > **Backups**" %} in the UI.
|
||||
2. Select the **Create backup** button in the lower right.
|
||||
3. Provide a name for the backup.
|
||||
4. Choose **Full backup** or **Partial backup**.
|
||||
- If you choose **Partial backup**, make sure to select Home Assistant and all the folders and add-ons you want to backup or migrate.
|
||||
- Note that the number of add-ons increases the size of the backup as well as the time it takes to restore from that backup.
|
||||
5. Optionally, enable password protection.
|
||||
6. Select **Create** to begin the backup.
|
||||
The automatic backup process creates a backup on a predefined schedule and also deletes old, redundant backups.
|
||||
|
||||
1. Go to {% my supervisor_backups title="**Settings** > **System** > **Backups**" %}.
|
||||
2. Under **Automatic backups**, select **Configure automatic backups**.
|
||||
3. Enable automatic backup.
|
||||
4. Define the backup schedule. It is recommended to back up daily.
|
||||
5. Define how many backups you want to keep.
|
||||
- Older backups will be automatically deleted.
|
||||
- For example: if you back up daily, and select 7 backups, then the backup from 8 days ago and older will be deleted.
|
||||
6. Define the data you want to back up.
|
||||
- It is recommended to disable media and the share folder to reduce the size of the backup.
|
||||
- A large backup also takes longer to restore.
|
||||
- Some add-ons may also be quite large.
|
||||
7. [Define the location for backups](#defining-backup-locations).
|
||||
8. Backups are encrypted. To be able to restore encrypted backups, download the emergency kit and store it somewhere safe.
|
||||
- To learn more, refer to the documentation on the [backup emergency kit](/more-info/backup-emergency-kit/).
|
||||
|
||||
### Defining backup locations
|
||||
|
||||
You might need a backup in case your system has crashed. If you only store backups on the device itself, you won't be able to access them easily. It is recommended to keep a copy on another system and ideally also one off-site.
|
||||
|
||||
#### About the backup storage on Home Assistant Cloud
|
||||
|
||||
If you have Home Assistant Cloud, you can store a backup of maximum 5 GB on Home Assistant Cloud. This cloud storage space is available for all existing and new Home Assistant Cloud subscribers without additional cost. It stores one backup file: the backup that was last saved to Home Assistant Cloud. Backups are always encrypted. To restore encrypted backups, you need the encryption key stored in the [backup emergency kit](/more-info/backup-emergency-kit/).
|
||||
|
||||
#### To define the backup location for automatic backups
|
||||
|
||||
1. Go to {% my supervisor_backups title="**Settings** > **System** > **Backups**" %} and under **Automatic backups**, select **Configure automatic backups**.
|
||||
2. Under **Locations**, enable all the backup locations you want to use.
|
||||
- If you don't see Home Assistant Cloud in the list, you are not [logged in](https://www.nabucasa.com/config/).
|
||||
- If you don't see a network storage, you haven't added one. Follow the steps on [adding a new network storage](/common-tasks/os/#add-a-new-network-storage) and select the **Backup** option.
|
||||

|
||||
|
||||
### Creating a manual backup
|
||||
|
||||
This creates a backup instantly. You can create a manual backup at any time, irrespective of any automatic backups you may have defined.
|
||||
|
||||
1. Go to {% my supervisor_backups title="**Settings** > **System** > **Backups**" %}.
|
||||
2. In the lower-right corner, select **Backup now** and select **Manual backup**.
|
||||
3. Define the data you want to back up.
|
||||
- It is recommended to disable media and the share folder to reduce the size of the backup.
|
||||
- A large backup also takes longer to restore.
|
||||
- Some add-ons may also be quite large.
|
||||
4. Provide a name for the backup.
|
||||
5. Choose the backup locations.
|
||||
- To learn more about the locations, refer to the section on [defining the backup location](#defining-backup-locations).
|
||||
6. Download the [backup emergency kit](/more-info/backup-emergency-kit/) and store it somewhere safe. Make sure you take note of the backup name it belongs to.
|
||||
7. To start the backup process, select **Create backup**.
|
||||
|
||||
### Alternative: Creating a backup using the Home Assistant Command Line Interface
|
||||
|
||||
@ -42,38 +87,50 @@ A partial backup consists of any number of the above default directories and ins
|
||||
|
||||
For additional information about command line usage, use the `ha help` command or refer to the [Home Assistant Command Line documentation](/common-tasks/os/#home-assistant-via-the-command-line).
|
||||
|
||||
### Copying your backups to another location
|
||||
### Downloading your local backups
|
||||
|
||||
You might need a backup in case your system has crashed. If you only store them on the device itself, you won't be able to access them easily. We recommend that you copy them from `/backup` to another machine on occasion.
|
||||
There are multiple ways to download your local backup from your Home Assistant instance and store it on another device:
|
||||
|
||||
There are multiple ways to store the backup on another device:
|
||||
**Option 1**: Download from the backup page:
|
||||
|
||||
- **Option 1**: Under {% my supervisor_backups title="**Settings** > **System** > **Backups**" %}, on the list, single-click or tap the backup of interest.
|
||||
- **Result**: The backup dialog opens.
|
||||
- In the dialog, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Download backup**.
|
||||
- **Result**: The selected backup is stored in the **Downloads** folder of your computer.
|
||||
- **Option 2**: If you haven't already done so, [configure access to files on Home Assistant](/common-tasks/{{page.installation}}/#configuring-access-to-files), using one of the methods listed there.
|
||||
- For example, [use the samba add-on](/common-tasks/{{page.installation}}/#installing-and-using-the-samba-add-on).
|
||||
- In your file explorer, access Home Assistant, open the `backup` folder and copy the file to your computer.
|
||||
- **Option 3**: You can also change the default location for backups:
|
||||
- [Add a network storage location](/common-tasks/{{page.installation}}/#network-storage) for backups.
|
||||
- [Change the default location](/common-tasks/{{page.installation}}/#change-default-backup-location) for backups.
|
||||
1. Under {% my supervisor_backups title="**Settings** > **System** > **Backups**" %}, select **Show all backups**.
|
||||
2. To select one backup, on the list, single-click or tap the backup of interest.
|
||||
- To select multiple backups, select the {% icon "mdi:order-checkbox-ascending" %} button.
|
||||
3. In the dialog, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Download backup**.
|
||||
- **Result**: The selected backup is stored in the **Downloads** folder of your computer.
|
||||
|
||||
- **Option 4**: Or even better, create an automation to handle that, using one of the [backup actions](/integrations/hassio/#action-hassiobackup_full).
|
||||
- **Option 5**: Make use of a third-party add-on:
|
||||
- [Google Drive Backup](https://github.com/sabeechen/hassio-google-drive-backup)
|
||||
- [OneDrive Backup](https://github.com/lavinir/hassio-onedrive-backup)
|
||||
- [Nextcloud Backup](https://github.com/Sebclem/hassio-nextcloud-backup)
|
||||
- [Remote Backup (scp/rsync/rclone)](https://github.com/ikifar2012/remote-backup-addon)
|
||||
- [Samba backup](https://github.com/thomasmauerer/hassio-addons/tree/master/samba-backup)
|
||||
- [Syncthing](https://github.com/Poeschl/Hassio-Addons/tree/main/syncthing)
|
||||
**Option 2**: Copy backups from the backups folder:
|
||||
|
||||
1. If you haven't already done so, [configure access to files on Home Assistant](/common-tasks/{{page.installation}}/#configuring-access-to-files), using one of the methods listed there.
|
||||
- For example, [use the samba add-on](/common-tasks/{{page.installation}}/#installing-and-using-the-samba-add-on).
|
||||
2. In your file explorer, access Home Assistant, open the `backup` folder and copy the file to your computer.
|
||||
|
||||
### Downloading a backup from Home Assistant Cloud
|
||||
|
||||
If you were logged in to Home Assistant Cloud and had Cloud backup enabled when creating a backup, your last backup is stored on Home Assistant Cloud.
|
||||
|
||||
1. To download the backup, log in to your [Home Assistant Cloud account](https://account.nabucasa.com/).
|
||||
2. Under **Stored files**, you can see the latest available backup file. Select the download button.
|
||||
|
||||
### Deleting obsolete backups
|
||||
|
||||
If you defined an automatic backup and backup purge schedule, old backups are deleted automatically. However, you might still have some old backups around that you want to delete.
|
||||
|
||||
To delete old backups, follow these steps:
|
||||
|
||||
1. Under {% my supervisor_backups title="**Settings** > **System** > **Backups**" %}, select **Show all backups**.
|
||||
2. To delete one backup, on the list, select the backup of interest.
|
||||
- Select the three dots {% icon "mdi:dots-vertical" %} menu and select **Delete**
|
||||
3. To delete multiple backups, select the {% icon "mdi:order-checkbox-ascending" %} button.
|
||||
- From the list of backups, select all the ones you want to delete and select **Delete selected**.
|
||||
- {% icon "mdi:information-outline" %} Consider keeping at least one recent backup for recovery purposes.
|
||||
|
||||
### Restoring a backup
|
||||
|
||||
There are two ways to use a backup:
|
||||
|
||||
- On your current system to recover your settings.
|
||||
- During onboarding, to migrate your setup to a new device or a to device on which you performed a factory reset and a new installation.
|
||||
- During onboarding, to migrate your setup to a new device or to device on which you performed a factory reset.
|
||||
|
||||
#### Estimated duration
|
||||
|
||||
@ -89,16 +146,17 @@ You can use a backup during the onboarding process to restore your configuration
|
||||
|
||||
- This procedure assumes you have already completed the [installation](/installation/) procedure on your target device and are now viewing the welcome screen as part of the [onboarding](/getting-started/onboarding/).
|
||||
- The login credentials of the device from which you made the backup.
|
||||
- The [backup emergency kit](/more-info/backup-emergency-kit/) that contains the key needed to decrypt the backup.
|
||||
- **Required storage capacity**: If you migrate the installation to a new device, make sure the new device has more storage capacity than the existing device.
|
||||
- Before migrating, on the old system, check how much storage you used.
|
||||
- Go to **{% my system_health title="Settings > System > Repairs -> ... -> System Information" %}**, and under **Home Assistant Supervisor**, look at the **Disk used** value.
|
||||
- The target device must have more free space than the source device.
|
||||
- If your target device is a Home Assistant Yellow, note that it is the size of the eMMC that is relevant.
|
||||
- The restore process mainly uses the eMMC, not the NVMe.
|
||||
- The size of the backup file is no indication of the size of your installation. To know the size of your installation, you need to check the **Disk used** value mentioned above.
|
||||
- Before migrating, on the old system, check how much storage you used.
|
||||
- Go to **{% my system_health title="Settings > System > Repairs > ... > System Information" %}**, and under **Home Assistant Supervisor**, look at the **Disk used** value.
|
||||
- The target device must have more free space than the source device.
|
||||
- If your target device is a Home Assistant Yellow, note that it is the size of the eMMC that is relevant.
|
||||
- The restore process mainly uses the eMMC, not the NVMe.
|
||||
- The size of the backup file is no indication of the size of your installation. To know the size of your installation, you need to check the **Disk used** value mentioned above.
|
||||
- If you are migrating to a new device:
|
||||
- You do not need to transfer the backup to a USB or SD card to bring it to your device.
|
||||
- You will be able to upload the backup file from the device you are accessing the onboarding from.
|
||||
- You do not need to transfer the backup to a USB or SD card to bring it to your device.
|
||||
- You will be able to upload the backup file from the device you are accessing the onboarding from.
|
||||
|
||||
##### To restore a backup during onboarding
|
||||
|
||||
@ -108,25 +166,32 @@ You can use a backup during the onboarding process to restore your configuration
|
||||
- Then, select **Upload backup**.
|
||||
- The file explorer opens on the device on which you are viewing the Home Assistant User interface.
|
||||
- You can access any connected network drive from there.
|
||||
3. Select the backup file, then, in the dialog, select **Full backup** and **Restore**.
|
||||
3. Select the backup file, then, in the dialog, select all parts you want to restore.
|
||||
- Your current system will be overwritten with the parts that you choose to restore.
|
||||
- If you want to restore the complete configuration with all directories and add-ons, select everything.
|
||||
4. Under **Backup password**, enter the encryption key stored in the [backup emergency kit](/more-info/backup-emergency-kit/).
|
||||
5. To start the process, select **Restore**.
|
||||
- The restore may take a while, depending on the amount of data.
|
||||
- To see if the restore is complete, reload the page from time to time.
|
||||
- If your previous installation had certificates enabled directly for the [`http` integration](/integrations/http), when the restore is complete, it will no longer respond to `http://` requests. In this case, use `https://` (added `s`) instead.
|
||||
4. On the login screen, enter the credentials of the system from which you took the backup.
|
||||
6. On the login screen, enter the credentials of the system from which you took the backup.
|
||||
- The login password and username must match the ones you used at the time the backup was taken.
|
||||
- Your dashboard should show all the elements as they were when you created the backup.
|
||||
- If some devices are shown as unavailable, you may need to wake the battery powered devices.
|
||||
5. If you had [network storage](/common-tasks/os/#network-storage) connected on the previous system, you may need to reconnect those.
|
||||
6. If you had Zigbee devices, and you migrated to a new device with its own Zigbee radio built-in:
|
||||
- If some devices are shown as unavailable, you may need to wake the battery-powered devices.
|
||||
7. If you had [network storage](/common-tasks/os/#network-storage) connected on the previous system, you may need to reconnect those.
|
||||
8. If you had Zigbee devices, and you migrated to a new device with its own Zigbee radio built-in:
|
||||
- Because this is now a different Zigbee radio, you need to [migrate Zigbee](/integrations/zha/#migrating-to-a-new-zigbee-coordinator-adapter-inside-zha).
|
||||
|
||||
#### To restore a backup on your current system
|
||||
|
||||
1. Go to **{% my backup title="Settings > System > Backups" %}**.
|
||||
2. From the list of backups, select the backup from which you want to restore.
|
||||
3. If you want to restore the complete configuration with all directories and add-ons, select **Full backup**.
|
||||
4. If you only want to restore specific elements, select **Partial backup**.
|
||||
- From the list, select the installation, folders, and add-ons you want to restore.
|
||||
5. Select **Restore**.
|
||||
- This may take a while, depending on how much you have to compress or decompress.
|
||||
6. Once the restore is complete, Home Assistant restarts to apply the new settings.
|
||||
3. Select what to restore:
|
||||
- Your current system will be overwritten with the parts that you choose to restore.
|
||||
- If you want to restore the complete configuration with all directories and add-ons, select everything.
|
||||
- If you only want to restore specific elements, only select the folders and add-ons you want to restore.
|
||||
4. Select **Restore**.
|
||||
- This may take a while, depending on how much there is to compress or decompress.
|
||||
5. Once the restore is complete, Home Assistant restarts to apply the new settings.
|
||||
- You will lose the connection to the UI and it will return once the restart is completed.
|
||||
6. On the login screen, enter the password and username as they were at the time the backup was taken.
|
||||
|
@ -66,7 +66,7 @@ This can be an option if the following elements apply to your use case:
|
||||
- You have another, new, Home Assistant instance (system 2).
|
||||
- You now want to use the data disk of system 1 on system 2 instead.
|
||||
|
||||
The aim is to migrate the data from system 1 to system 2. One way to do this is by [restoring a backup](/common-tasks/os/#restoring-a-backup). The other way is to move the data disk. This can be an interesting option if you have a large amount of data on your external disk or if your external disk has more storage capacity than your new system.
|
||||
The aim is to migrate the data from system 1 to system 2. One way to do this is by [restoring a backup](/common-tasks/general/#restoring-a-backup). The other way is to move the data disk. This can be an interesting option if you have a large amount of data on your external disk or if your external disk has more storage capacity than your new system.
|
||||
|
||||
#### Prerequisites
|
||||
|
||||
@ -77,7 +77,7 @@ The aim is to migrate the data from system 1 to system 2. One way to do this is
|
||||
|
||||
To migrate an external data disk from one system to another, follow these steps:
|
||||
|
||||
1. [Create a backup](/common-tasks/os/#backups) of both systems and store these backups on another system (not strictly necessary, but recommended just in case, at least for the important data).
|
||||
1. [Create a backup](/common-tasks/general/#backups) of both systems and store these backups on another system (not strictly necessary, but recommended just in case, at least for the important data).
|
||||
2. Shut down system 1 and remove the data disk.
|
||||
3. Make sure system 2 has Home Assistant OS installed, and Home Assistant is up and running. Home Assistant is using the data disk (partition) on the boot drive (e.g. SD card) at this point.
|
||||
4. Make sure system 2 has completed the basic [onboarding](/getting-started/onboarding/) steps, including the last steps where devices are discovered automatically.
|
||||
|
@ -71,31 +71,21 @@ Server:
|
||||
|
||||
{% configuration_basic "hassio.network_share.usage" %}
|
||||
Backup:
|
||||
description: This will become a target. You can use it in service calls or when manually creating a backup. The first storage you add of this type becomes your new default target. If you want to change the default target, [check out the documentation below](#change-default-backup-location).
|
||||
description: This will become a target. You can use it when creating an automatic or manual backup. The first storage you add of this type becomes your new default target. If you want to change the default target, [check out the documentation below](#change-default-local-backup-location).
|
||||
Media:
|
||||
description: A new directory with the name you gave your network storage will be created under `/media`. This directory can be accessed by Home Assistant and add-ons.
|
||||
Share:
|
||||
description: A new directory with the name you gave your network storage will be created under `/share`. This directory can be accessed by Home Assistant and add-ons.
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
### Change default backup location
|
||||
### Change default local backup location
|
||||
|
||||
By default, the first network storage of type **Backup** that you add will be set as your default backup target.
|
||||
By default, the first network storage of type **Backup** that you add is used as your local default backup location.
|
||||
|
||||
If you want to change the default backup target, you can do the following:
|
||||
If you want to change the local network storage that is used to store your backups, follow these steps:
|
||||
|
||||
1. Go to **{% my backup title="Settings > System > Backups" %}** in the UI.
|
||||
2. Select the menu in the top right of the screen and select the **Change default backup location** option.
|
||||
3. In the dialog, there is a single option to set the default backup target.
|
||||
4. Choose the one you want from the list.
|
||||
5. Select **Save**.
|
||||
|
||||
This list will contain all the network storage targets you have added of usage type **Backup**. It also contains another option to set it back to use `/backup` again.
|
||||
|
||||
<p class='img'>
|
||||
<picture>
|
||||
<source srcset="/images/screenshots/network-storage/change_backup_dark.png" media="(prefers-color-scheme: dark)">
|
||||
<img src="/images/screenshots/network-storage/change_backup_light.png">
|
||||
</picture>
|
||||
Screenshot of changing the default backup target.
|
||||
</p>
|
||||
1. Go to **{% my backup title="Settings > System > Backups" %}**.
|
||||
2. In the top-right corner, select the three dots {% icon "mdi:dots-vertical" %} menu and select **Change local backup location**.
|
||||
3. Select your preferred network location and save your changes.
|
||||

|
||||
4. **Troubleshooting**: Don't see your external storage location? This list contains only the network storage targets you have added of type **Backup**.
|
||||
|
@ -20,7 +20,7 @@ ha core update --version {{current_version}} --backup
|
||||
|
||||
_The_ `--backup` _flag here ensures that you have a partial backup of your current setup in case you need to downgrade later._
|
||||
|
||||
To downgrade your installation, do a [partial restore of a backup](/common-tasks/os/#backups) instead.
|
||||
To downgrade your installation, do a [partial restore of a backup](/common-tasks/general/#backups) instead.
|
||||
|
||||
{% elsif page.installation == "container" %}
|
||||
|
||||
|
@ -1,6 +1,6 @@
|
||||
Best practice for updating Home Assistant Core:
|
||||
|
||||
1. Backup your installation{% if page.installation == "os" or page.installation == "supervised" %}, using the [backup functionality](/common-tasks/os/#backups) Home Assistant offers{% endif %}.
|
||||
1. Back up your installation{% if page.installation == "os" or page.installation == "supervised" %}, using the [backup functionality](/common-tasks/general/#backups) Home Assistant offers{% endif %}.
|
||||
2. Check the release notes for backward-incompatible changes on [Home Assistant release notes](/blog/categories/core/). Be sure to check all release notes between the version you are running and the one you are upgrading to. Use the search function in your browser (`CTRL + f` / `CMD + f`) and search for **Backward-incompatible changes**.
|
||||
{% if page.installation == "os" or page.installation == "supervised" %}
|
||||
3. Select **Create backup before updating** in case you encounter an issue that requires a rollback.
|
||||
|
@ -18,6 +18,7 @@ ha_bluetooth: true
|
||||
ha_codeowners:
|
||||
- '@zweckj'
|
||||
ha_integration_type: device
|
||||
ha_quality_scale: platinum
|
||||
---
|
||||
|
||||
The **Acaia** {% term integration %} allows you to control [Acaia](https://acaia.co/) scales through Home Assistant.
|
||||
|
@ -10,6 +10,7 @@ ha_config_flow: true
|
||||
ha_domain: aemet
|
||||
ha_platforms:
|
||||
- diagnostics
|
||||
- image
|
||||
- sensor
|
||||
- weather
|
||||
ha_integration_type: integration
|
||||
|
@ -323,7 +323,7 @@ alexa:
|
||||
type: map
|
||||
keys:
|
||||
locale:
|
||||
description: The locale of your Alexa devices. Supported locales are `de-DE`, `en-AU`, `en-CA`, `en-GB`, `en-IN`, `en-US`, `es-ES`, `es-MX`, `fr-CA`, `fr-FR`, `it-IT`, `ja-JP`, `pt-BR`. See [Alexa Locale](#alexa-locale) for additional information.
|
||||
description: The locale of your Alexa devices. Supported locales are `de-DE`, `en-AU`, `en-CA`, `en-GB`, `en-IN`, `en-US`, `es-ES`, `es-MX`, `es-US`,`fr-CA`, `fr-FR`, `hi-IN`, `it-IT`, `ja-JP`, `nl-NL`, and `pt-BR`. See [Alexa Locale](#alexa-locale) for additional information.
|
||||
required: false
|
||||
type: string
|
||||
default: en-US
|
||||
@ -416,6 +416,7 @@ The supported locales are:
|
||||
- `hi-IN`
|
||||
- `it-IT`
|
||||
- `ja-JP`
|
||||
- `nl-NL`
|
||||
- `pt-BR`
|
||||
|
||||
See [List of Capability Interfaces and Supported Locales][alexa-supported-locales].
|
||||
|
@ -11,25 +11,25 @@ ha_codeowners:
|
||||
ha_iot_class: Calculated
|
||||
ha_integration_type: system
|
||||
related:
|
||||
- docs: /installation/#advanced-installation-methods
|
||||
title: Home Assistant installation methods
|
||||
- docs: /common-tasks/general/#backups
|
||||
title: Backups
|
||||
- docs: /getting-started/onboarding/
|
||||
title: Recover from backup during onboarding
|
||||
- docs: /docs/configuration/
|
||||
title: Configuration file
|
||||
- docs: /common-tasks/os/#restoring-a-backup
|
||||
title: Home Assistant Operating System- Restoring a backup
|
||||
- docs: /more-info/backup-emergency-kit/
|
||||
title: backup emergency kit
|
||||
---
|
||||
|
||||
The **Backup** {% term integration %} is used for {% term "Home Assistant Core" %} and {% term "Home Assistant Container" %} installations to create and download backups. This backup file can be used if you migrate to {% term "Home Assistant Operating System" %}.
|
||||
The **Backup** {% term integration %} is used by all [installation types](/installation/#advanced-installation-methods) to create and restore backups.
|
||||
|
||||
Note: If you use {% term "Home Assistant Operating System" %} or {% term "Home Assistant Supervised" %} installation, this page is not for you. Instead, refer to the documentation on using the [built-in back up](/common-tasks/os/#backups).
|
||||
To learn how to create and restore a backup, refer to the backup section under [common tasks](/common-tasks/general/#backups).
|
||||
|
||||
## Actions
|
||||
|
||||
The **Backup** integration exposes an action that can be used to automate the backup
|
||||
process.
|
||||
|
||||
However, it is no longer needed to create your own automation. Follow these steps to [set up an automatic backup from the UI](/common-tasks/general/#setting-up-an-automatic-backup-process).
|
||||
|
||||
### Action {% my developer_call_service service="backup.create" %}
|
||||
|
||||
The {% my developer_call_service service="backup.create" %} action can be used
|
||||
@ -61,20 +61,4 @@ automation:
|
||||
|
||||
## Restoring a backup
|
||||
|
||||
Backups created via the **Backup** integration are in a subdirectory `backups`, located in your [configuration directory](/docs/configuration/#editing-configurationyaml).
|
||||
The {% term "Home Assistant Container" %} installation typically mounts this directory via `docker-compose.yml` or `docker run` to a directory of your choice.
|
||||
|
||||
The steps on recovering from a backup depend on the installation type and use case. Follow one of these steps:
|
||||
|
||||
1. If you use {% term "Home Assistant Operating System" %} or {% term "Home Assistant Supervised" %}:
|
||||
- Follow the steps described in [Restoring a backup](/common-tasks/os/#restoring-a-backup).
|
||||
2. If you use a {% term "Home Assistant Core" %} or {% term "Home Assistant Container" %} installation:
|
||||
- A Home Assistant backup is just a tar file of the [configuration directory](/docs/configuration/#editing-configurationyaml), plus some metadata.
|
||||
- To manually restore a backup, use the following command:
|
||||
|
||||
```shell
|
||||
tar -xOf <backup_tar_file> "./homeassistant.tar.gz" | tar --strip-components=1 -zxf - -C <restore_directory>
|
||||
```
|
||||
|
||||
3. If you migrate from a {% term "Home Assistant Core" %} or {% term "Home Assistant Container" %} installation to {% term "Home Assistant Operating System" %}:
|
||||
- You can use these backup files during [onboarding](/getting-started/onboarding/) to recover your installation from backup.
|
||||
To restore a backup, follow the steps described in [Restoring a backup](/common-tasks/general/#restoring-a-backup).
|
||||
|
@ -285,15 +285,70 @@ data:
|
||||
|
||||
### Custom actions
|
||||
|
||||
The Bang & Olufsen integration additionally supports different custom actions
|
||||
The Bang & Olufsen integration additionally supports different custom actions for Beolink.
|
||||
|
||||
[Beolink](https://support.bang-olufsen.com/hc/en-us/articles/4411572883089-What-is-Beolink-Multiroom) is Bang & Olufsen's advanced multiroom audio solution. This integration supports Home Assistant's `media_player` grouping, but to fully benefit from Beolink, such as being able to join legacy devices not added in Home Assistant, custom actions have been defined.
|
||||
|
||||
Attempting to execute an invalid Beolink action will result in either a Home Assistant error or an audible error indication from your device.
|
||||
|
||||
#### `bang_olufsen.beolink_join`
|
||||
|
||||
Join a Beolink experience.
|
||||
|
||||
| Action data attribute | Optional | Description |
|
||||
| --------------------- | -------- | ------------------------------------- |
|
||||
| `beolink_jid` | yes | Manually specify Beolink JID to join. |
|
||||
| Action data attribute | Optional | Description |
|
||||
| --------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `beolink_jid` | yes | Manually specify Beolink JID to join. |
|
||||
| `source_id` | yes | Specify which source to join, behavior varies between hardware platforms. Source names prefaced by a platform name can only be used when connecting to that platform. For example "ASE Beoradio" can only be used when joining an ASE device, while ”ASE / Mozart Deezer” can be used with ASE or Mozart devices. A defined Beolink JID is required. |
|
||||
|
||||
##### Join a currently active beolink experience or device playing compatible source
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_join
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
```
|
||||
|
||||
Repeatedly calling this will cycle through available devices.
|
||||
|
||||
Will also be triggered by calling the `media_player.join` action with an empty list of `group_members`:
|
||||
|
||||
```yaml
|
||||
action: media_player.join
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
group_members:
|
||||
```
|
||||
|
||||
##### Join a specific active beolink experience
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_join
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
beolink_jid: 1111.2222222.33333333@products.bang-olufsen.com
|
||||
```
|
||||
|
||||
##### Join the "radio" source on a Beolink Converter NL/ML
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_join
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
beolink_jid: 1111.2222222.33333333@products.bang-olufsen.com
|
||||
source_id: radio
|
||||
```
|
||||
|
||||
A limited selection of `source_id`s are available. The below table shows which `source_id` can be joined on which hardware platform:
|
||||
|
||||
| Hardware platform | Compatible source_ids |
|
||||
| ----------------------- | ------------------------------------------ |
|
||||
| ASE | `beoradio` |
|
||||
| ASE and Mozart | `deezer`, `spotify` |
|
||||
| Mozart | `tidal` |
|
||||
| Beolink Converter NL/ML | `radio`, `tp1`, `tp2`, `cd`, `aux_a`, `ph` |
|
||||
|
||||
#### `bang_olufsen.beolink_expand`
|
||||
|
||||
@ -304,6 +359,62 @@ Expand current Beolink experience.
|
||||
| `all_discovered` | yes | Expand Beolink experience to all discovered devices. |
|
||||
| `beolink_jids` | yes | Specify which Beolink JIDs will join current Beolink experience. |
|
||||
|
||||
##### Expand an active Beolink experience to all other devices discovered by the defined device
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_expand
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
all_discovered: true
|
||||
```
|
||||
|
||||
##### Expand an active Beolink experience to a specific device
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_expand
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
beolink_jids:
|
||||
- 1111.2222222.33333333@products.bang-olufsen.com
|
||||
```
|
||||
|
||||
Will also be triggered by calling the `media_player.join` action, with the entity_id of a `media_player` entity from this integration in `group_members`:
|
||||
|
||||
```yaml
|
||||
action: media_player.join
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
group_members:
|
||||
- media_player.beosound_balance_33333333
|
||||
```
|
||||
|
||||
##### Expand an active Beolink experience to specific devices
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_expand
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
beolink_jids:
|
||||
- 1111.2222222.33333333@products.bang-olufsen.com
|
||||
- 4444.5555555.66666666@products.bang-olufsen.com
|
||||
```
|
||||
|
||||
Will also be triggered by calling the `media_player.join` action, with the entity_ids of `media_player` entities from this integration in `group_members`:
|
||||
|
||||
```yaml
|
||||
action: media_player.join
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
group_members:
|
||||
- media_player.beosound_balance_33333333
|
||||
- media_player.beosound_balance_66666666
|
||||
```
|
||||
|
||||
#### `bang_olufsen.beolink_unexpand`
|
||||
|
||||
Unexpand from current Beolink experience.
|
||||
@ -312,14 +423,61 @@ Unexpand from current Beolink experience.
|
||||
| --------------------- | -------- | ---------------------------------------------------------------------- |
|
||||
| `beolink_jids` | no | Specify which Beolink JIDs will leave from current Beolink experience. |
|
||||
|
||||
##### Remove a device from an active Beolink experience
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_unexpand
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
beolink_jids:
|
||||
- 1111.2222222.33333333@products.bang-olufsen.com
|
||||
```
|
||||
|
||||
##### Remove devices from an active Beolink experience
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_unexpand
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
data:
|
||||
beolink_jids:
|
||||
- 1111.2222222.33333333@products.bang-olufsen.com
|
||||
- 4444.5555555.66666666@products.bang-olufsen.com
|
||||
```
|
||||
|
||||
#### `bang_olufsen.beolink_leave`
|
||||
|
||||
Leave a Beolink experience.
|
||||
|
||||
##### Action usage example
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_leave
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
```
|
||||
|
||||
Same behavior as calling the `media_player.unjoin` action:
|
||||
|
||||
```yaml
|
||||
action: media_player.unjoin
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
```
|
||||
|
||||
#### `bang_olufsen.beolink_allstandby`
|
||||
|
||||
Set all connected Beolink devices to standby.
|
||||
|
||||
##### Action usage example
|
||||
|
||||
```yaml
|
||||
action: bang_olufsen.beolink_allstandby
|
||||
target:
|
||||
entity_id: media_player.beosound_balance_12345678
|
||||
```
|
||||
|
||||
## Automations
|
||||
|
||||
WebSocket notifications received from the device are fired as events in Home Assistant. These can be received by listening to `bang_olufsen_websocket_event` event types, where `device_id` or `serial_number` can be used to differentiate devices.
|
||||
|
@ -117,11 +117,22 @@ This {% term integration %} provides the following {% term platforms %}:
|
||||
|
||||
{% warning %}
|
||||
Every platform except **binary sensors** and **sensors** can change the state of your vehicle. Once you change the state in Home Assistant, a command is sent to your car.
|
||||
{% endwarning %}
|
||||
|
||||
|
||||
|
||||
**Use with care!**
|
||||
{% endwarning %}
|
||||
{% important %}
|
||||
The `North America` and `Rest of world` regions require a captcha challenge to be solved, i.e. you need to verify that you are a human.
|
||||
After entering your login data, a second step will ask for a `Captcha token` and provide you with a link to a website.
|
||||
Please open this link, solve the "are you a human?" challenge and press `Submit`.
|
||||
Copy the resulting token into Home Assistant and continue.
|
||||
|
||||
No data of your Home Assistant instance is shared with any third party during this step.
|
||||
{% endimportant %}
|
||||
|
||||
{% note %}
|
||||
For `china`, it is mandatory to prefix your username/phone number with `86`, i.e. `8612345678`.
|
||||
{% endnote %}
|
||||
|
||||
### Notifications
|
||||
|
||||
|
@ -17,6 +17,7 @@ ha_codeowners:
|
||||
ha_config_flow: true
|
||||
ha_integration_type: device
|
||||
ha_zeroconf: true
|
||||
ha_quality_scale: platinum
|
||||
---
|
||||
|
||||
The **Cambridge Audio** {% term integration %} allows you to control all receivers and streamers that support the [StreamMagic](https://www.cambridgeaudio.com/usa/en/products/streammagic) app.
|
||||
@ -104,6 +105,12 @@ data:
|
||||
media_content_type: "internet_radio"
|
||||
media_content_id: "https://example.com/internet-radio/station_abcd.mp3"
|
||||
```
|
||||
|
||||
## Browsing media
|
||||
|
||||
The Cambridge Audio integration allows you to browse saved presets from your dashboard.
|
||||
All stored presets will be categorized into playlists, artists, and tracks.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### The buttons to skip, shuffle, and repeat the track are missing
|
||||
|
76
source/_integrations/cookidoo.markdown
Normal file
76
source/_integrations/cookidoo.markdown
Normal file
@ -0,0 +1,76 @@
|
||||
---
|
||||
title: Cookidoo
|
||||
description: Instructions on how to integrate the Cookidoo todo list with Home Assistant.
|
||||
ha_category:
|
||||
- To-do list
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_release: 2025.1
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@miaucl'
|
||||
ha_domain: cookidoo
|
||||
ha_integration_type: service
|
||||
ha_platforms:
|
||||
- todo
|
||||
related:
|
||||
- docs: /integrations/todo
|
||||
title: To-do list integration documentation
|
||||
- docs: /integrations/#to-do-list
|
||||
title: List of to-do list integrations
|
||||
- docs: /dashboards/todo-list/
|
||||
title: To-do list card
|
||||
- url: https://cookidoo.international/
|
||||
title: Cookidoo the official Thermomix recipe platform
|
||||
- url: https://www.vorwerk.com/
|
||||
title: Vorwerk GmbH
|
||||
ha_quality_scale: silver
|
||||
---
|
||||
|
||||
The **Cookidoo** {% term integration %} allows you to interact with your shopping lists of [Cookidoo the official Thermomix recipe platform](https://cookidoo.international/) within Home Assistant.
|
||||
|
||||
{% configuration_basic %}
|
||||
Email:
|
||||
description: "Enter the email address associated with your Cookidoo."
|
||||
Password:
|
||||
description: "Enter the password for your Cookidoo account."
|
||||
Localization:
|
||||
description: "Select the language and country for your Cookidoo account (e.g., English - United States)."
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
## To-do lists
|
||||
|
||||
This integration provides two non-sortable to-do lists:
|
||||
|
||||
1. **Shopping list**
|
||||
- Contains ingredients from recipes
|
||||
- Items can only be `checked`
|
||||
- Items cannot be `created`, `deleted`, or `renamed`
|
||||
|
||||
2. **Additional purchases**
|
||||
- Contains user-added items to purchase
|
||||
- Items can be `created`, `deleted`, and `updated`
|
||||
- Items do not have a `description` field
|
||||
|
||||
For example, if you add a pasta recipe, ingredients like "500g pasta" and "2 tomatoes" will appear in your "Shopping list". You can check these items off as you shop, but you cannot modify the label.
|
||||
|
||||
In contrast, in your "Additional purchases" list, you can freely add items like "Kitchen towels" or "Dish soap", and modify or remove them as needed.
|
||||
|
||||
## Known Limitations
|
||||
|
||||
{% important %}
|
||||
As Cookidoo cannot share shopping lists between accounts and everybody interacting with it uses the same credentials, make sure you protect your credentials accordingly. All users of your Home Assistant instance will have access to the same Cookidoo account.
|
||||
{% endimportant %}
|
||||
|
||||
The Home Assistant to-do list interface allows both renaming items and changing their state. However, for the "Shopping list", only state changes (checking/unchecking items) are supported. Any attempts to rename items will not be saved.
|
||||
|
||||
## Data updates
|
||||
|
||||
The Cookidoo integration fetches data from the device every 90 seconds by default.
|
||||
|
||||
## Remove integration
|
||||
|
||||
This integration follows standard integration removal, no extra steps are required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
@ -33,7 +33,17 @@ ha_integration_type: hub
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
Please do not change the URL provided in the advanced mode unless you know what you are doing.
|
||||
{% configuration_basic %}
|
||||
Email / mydevolo ID:
|
||||
description: "Email address you used to register the central unit at mydevolo."
|
||||
Password:
|
||||
description: "Password of your mydevolo account."
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
{% note %}
|
||||
Your mydevolo account is only used to acquire local credentials. Afterward, communication is completely local as long as the gateway is within the same network.
|
||||
{% endnote %}
|
||||
|
||||
|
||||
## Supported devices and functions
|
||||
|
||||
|
@ -18,6 +18,7 @@ ha_platforms:
|
||||
- sensor
|
||||
- switch
|
||||
ha_iot_class: Local Polling
|
||||
ha_dhcp: true
|
||||
ha_zeroconf: true
|
||||
---
|
||||
|
||||
|
@ -13,7 +13,7 @@ ha_domain: easyenergy
|
||||
ha_platforms:
|
||||
- diagnostics
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
ha_integration_type: service
|
||||
---
|
||||
|
||||
The **easyEnergy** {% term integration %} integrates the [easyEnergy](https://www.easyenergy.com) API platform with Home Assistant.
|
||||
@ -228,4 +228,4 @@ template:
|
||||
|
||||
This integration follows standard integration removal steps. If you also use the template sensors, you need to remove them manually.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
||||
{% include integrations/remove_device_service.md %}
|
||||
|
47
source/_integrations/eheimdigital.markdown
Normal file
47
source/_integrations/eheimdigital.markdown
Normal file
@ -0,0 +1,47 @@
|
||||
---
|
||||
title: EHEIM Digital
|
||||
description: Instructions on how to set up EHEIM Digital with Home Assistant.
|
||||
ha_category:
|
||||
- Light
|
||||
ha_release: 2025.1
|
||||
ha_iot_class: Local Polling
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@autinerd'
|
||||
ha_domain: eheimdigital
|
||||
ha_integration_type: hub
|
||||
ha_platforms:
|
||||
- light
|
||||
ha_quality_scale: bronze
|
||||
ha_zeroconf: true
|
||||
---
|
||||
|
||||
The **EHEIM Digital** {% term integration %} allows you to control your [EHEIM Digital](https://eheim.com/en_GB/aquatics/eheim-digital/) smart aquarium devices from Home Assistant.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
{% configuration_basic %}
|
||||
Host:
|
||||
description: "The IP address or hostname of your EHEIM Digital main device. Defaults to `eheimdigital.local`, an IP address should only be necessary if the hostname doesn't work."
|
||||
required: true
|
||||
type: string
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
## Supported devices and entities
|
||||
|
||||
Currently, the following devices and entities are supported:
|
||||
|
||||
### [EHEIM classicLEDcontrol+e](https://eheim.com/en_GB/aquatics/technology/lighting-control/classicledcontrol-e/classicledcontrol-e)
|
||||
|
||||
#### Lights
|
||||
|
||||
- **Brightness**: Controlling the brightness of both light channels
|
||||
- **Daycycle mode effect**: Automatically controls the brightness based on the daytime as configured on the device
|
||||
|
||||
Support for additional EHEIM Digital devices and entities will be added in future updates.
|
||||
|
||||
## Remove integration
|
||||
|
||||
This integration follows standard integration removal, no extra steps are required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
@ -12,7 +12,7 @@ ha_domain: energyzero
|
||||
ha_platforms:
|
||||
- diagnostics
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
ha_integration_type: service
|
||||
---
|
||||
|
||||
The **EnergyZero** {% term integration %} integrates the [EnergyZero](https://www.energyzero.nl/) API platform with Home Assistant.
|
||||
|
@ -132,6 +132,11 @@ For Enphase Ensemble systems with the Enpower/IQ System Controller and Encharge/
|
||||
- Metering status for storage <abbr title="current transformers">CT</abbr> (aggregate and phase)
|
||||
- Count of meter status flags active storage <abbr title="current transformers">CT</abbr> (aggregate and phase)
|
||||
|
||||
For system with both older type ACB batteries and Encharge/IQ Batteries:
|
||||
|
||||
- Sensors for ACB Battery State of Charge in %, battery state (charging, idle, discharging), current available energy in Wh and current power flow in W.
|
||||
- Sensors for aggregated ACB and Encharge battery status for current State of Charge in %, current available energy in Wh and total battery capacity in Wh.
|
||||
|
||||
*: The load shedding and on/off-grid functions are only available with the Enpower/IQ System Controller installed. In battery installations without load-shedding and off-grid functionality, used in many EU countries, these sensors and switches are not available.
|
||||
|
||||
**: When used with Enpower/IQ System Controller, the entities to charge from the grid, battery storage mode, and reserve battery level are connected to the Enpower device with the Enpower serial number in their entity and unique IDs. When no Enpower is installed, these are connected to the Envoy itself and the Envoy serial number is used in the IDs.
|
||||
|
@ -18,6 +18,7 @@ ha_domain: esphome
|
||||
ha_zeroconf: true
|
||||
ha_platforms:
|
||||
- alarm_control_panel
|
||||
- assist_satellite
|
||||
- binary_sensor
|
||||
- button
|
||||
- camera
|
||||
|
@ -15,6 +15,7 @@ ha_platforms:
|
||||
- sensor
|
||||
ha_dhcp: true
|
||||
ha_integration_type: integration
|
||||
ha_quality_scale: gold
|
||||
---
|
||||
|
||||
The Fronius integration polls a [Fronius](https://www.fronius.com/) solar inverter or datalogger for details of a Fronius SolarNet setup and integrate it in your Home Assistant installation.
|
||||
|
@ -13,6 +13,8 @@ ha_platforms:
|
||||
- diagnostics
|
||||
- sensor
|
||||
ha_integration_type: hub
|
||||
ha_quality_scale: platinum
|
||||
ha_dhcp: true
|
||||
---
|
||||
|
||||
The **FYTA** {% term integration %} uses the open API of [FYTA](https://www.fyta.de) to obtain the data from your plant sensors and integrate these into Home Assistant.
|
||||
|
@ -11,7 +11,7 @@ ha_domain: go2rtc
|
||||
ha_integration_type: system
|
||||
related:
|
||||
- docs: /installation/
|
||||
ha_quality_scale: legacy
|
||||
ha_quality_scale: internal
|
||||
---
|
||||
|
||||
go2rtc is an open source project providing a camera streaming application that supports formats such as RTSP, WebRTC, HomeKit, FFmpeg, RTMP. The **go2rtc** {% term integration %} connects to a go2rtc instance and provides a WebRTC proxy for all your cameras. To learn more about go2rtc, refer to the [project's GitHub page](https://github.com/AlexxIT/go2rtc/).
|
||||
|
@ -10,7 +10,6 @@ ha_release: 2022.8
|
||||
ha_iot_class: Local Push
|
||||
ha_codeowners:
|
||||
- '@bdraco'
|
||||
- '@PierreAronnax'
|
||||
ha_domain: govee_ble
|
||||
ha_config_flow: true
|
||||
ha_platforms:
|
||||
|
@ -86,8 +86,8 @@ Verify SSL certificate:
|
||||
- **Mana**: Displays the current mana points of your character (for example, "61 MP").
|
||||
- **Max. mana**: Indicates the maximum mana points your character can have at the current level (for example, "70 MP").
|
||||
- **Next level**: Indicates the remaining experience points needed to reach the next level (for example, "440 XP").
|
||||
- **Ha Dispbits**: Shows the number of habits being tracked (for example, "4 tasks").
|
||||
- **Rewards**:lays the rewards that can be redeemed (for example, "1 task")
|
||||
- **Habits**: Shows the number of habits being tracked (for example, "4 tasks").
|
||||
- **Rewards**: Displays the rewards that can be redeemed (for example, "1 task")
|
||||
- **Gems**: Shows the total number of gems currently owned by your Habitica character, used for purchasing items and customizations.
|
||||
- **Mystic hourglasses**: Displays the number of mystic hourglasses earned as a subscriber, which can be redeemed for exclusive items from past events.
|
||||
- **Strength, intelligence, constitution, perception**: Display your character's attribute points (stats). The sensors' attributes provide a breakdown of contributions from level, battle gear, class equip bonus, allocation, and buffs.
|
||||
|
19
source/_integrations/harvey.markdown
Normal file
19
source/_integrations/harvey.markdown
Normal file
@ -0,0 +1,19 @@
|
||||
---
|
||||
title: Harvey
|
||||
description: Integrate Harvey water softeners with Home Assistant using the AquaCell integration.
|
||||
ha_category:
|
||||
- Sensor
|
||||
ha_domain: harvey
|
||||
ha_release: 2025.1
|
||||
ha_integration_type: virtual
|
||||
ha_supporting_domain: aquacell
|
||||
ha_supporting_integration: AquaCell
|
||||
ha_codeowners:
|
||||
- '@Jordi1990'
|
||||
ha_config_flow: true
|
||||
ha_platforms:
|
||||
- sensor
|
||||
ha_iot_class: Cloud Polling
|
||||
---
|
||||
|
||||
{% include integrations/supported_brand.md %}
|
@ -21,6 +21,8 @@ It uses the Python module [holidays](https://pypi.org/project/holidays/) to inco
|
||||
|
||||
A calendar entity has a state and attributes that represent the next upcoming event (only). A calendar trigger is a much more flexible way to power automations with fewer limitations than using the entity state.
|
||||
|
||||
Some countries provides additional categories to be configured besides the public holidays. See the details for each country in the [holidays](https://pypi.org/project/holidays/) library. If the country does not support additional categories, the option to configure categories will not be displayed.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
## Holiday calendar automations
|
||||
|
@ -35,7 +35,6 @@ The integration will add one Home Assistant device for each connected home appli
|
||||
|
||||
- A power switch
|
||||
- If the device has programs:
|
||||
- Switches for each of the individual programs will be added. Note that program options cannot be configured currently.
|
||||
- Two select entities that will allow you to select and start a program between the available ones.
|
||||
- A timestamp sensor for remaining time and a numeric sensor for the progress percentage.
|
||||
- Light:
|
||||
|
@ -160,7 +160,7 @@ homekit:
|
||||
required: false
|
||||
type: string
|
||||
linked_doorbell_sensor:
|
||||
description: The `entity_id` of a `binary_sensor` or `event` entity to use as the doorbell sensor of the camera accessory to enable doorbell notifications.
|
||||
description: The `entity_id` of a `binary_sensor` or `event` entity to use as the doorbell sensor of a `lock` or `camera` accessory to enable doorbell notifications.
|
||||
required: false
|
||||
type: string
|
||||
linked_humidity_sensor:
|
||||
@ -421,7 +421,7 @@ The following integrations are currently supported:
|
||||
| fan | Fan | All fans that support `speed` and `speed_list` through value mapping: `speed_list` is assumed to contain values in ascending order. The numeric ranges of HomeKit map to a corresponding entry of `speed_list`. The first entry of `speed_list` should be equivalent to `off` to match HomeKit's concept of fan speeds. (Example: `speed_list` = [`off`, `low`, `high`]; `off` -> `<= 33`; `low` -> between `33` and `66`; `high` -> `> 66`) |
|
||||
| humidifier | HumidifierDehumidifier | Humidifier and Dehumidifier devices. |
|
||||
| light | Light | Support for `on / off`, `brightness` and `rgb_color`. |
|
||||
| lock | DoorLock | Support for `lock / unlock`. |
|
||||
| lock | DoorLock | Support for `lock / unlock`. A doorbell event / sensor can be linked with `linked_doorbell_sensor`. |
|
||||
| media_player | MediaPlayer | Represented as a series of switches which control `on / off`, `play / pause`, `play / stop`, or `mute` depending on `supported_features` of entity and the `mode` list specified in `entity_config`. |
|
||||
| media_player | TelevisionMediaPlayer | All media players that have `tv` as their `device_class`. Represented as Television and Remote accessories in HomeKit to control `on / off`, `play / pause`, `select source`, or `volume increase / decrease`, depending on `supported_features` of entity. Requires iOS 12.2/macOS 10.14.4 or later. |
|
||||
| media_player | ReceiverMediaPlayer | All media players that have `receiver` as their `device_class`. Represented as Receiver and Remote accessories in HomeKit to control `on / off`, `play / pause`, `select source`, or `volume increase / decrease`, depending on `supported_features` of entity. Requires iOS 12.2/macOS 10.14.4 or later. |
|
||||
|
@ -14,6 +14,7 @@ ha_domain: honeywell
|
||||
ha_platforms:
|
||||
- climate
|
||||
- diagnostics
|
||||
- humidifier
|
||||
- sensor
|
||||
- switch
|
||||
ha_integration_type: integration
|
||||
@ -27,6 +28,7 @@ If your system is compatible with this integration, then you will be able access
|
||||
- [Climate](#climate)
|
||||
- [Sensor](#sensor)
|
||||
- [Switch](#switch)
|
||||
- [Humidifier](#humidifier)
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
@ -48,7 +50,7 @@ Other devices like Security systems are not currently supported by this integrat
|
||||
|
||||
The climate platform integrates Honeywell US-based thermostats into Home Assistant, allowing control of the thermostat through the user interface. The current inside temperature, operating mode, and fan state are also displayed on the thermostat card.
|
||||
|
||||
All [climate actions](/integrations/climate) are supported except set_swing_mode.
|
||||
All [climate actions](/integrations/climate) are supported except `set_swing_mode`.
|
||||
|
||||
Due to the instability of the Honeywell total connect system, actions within automations should repeat until success similar to the following example:
|
||||
|
||||
@ -98,3 +100,39 @@ This integration will add a switch for the following:
|
||||
|Switch|Value|
|
||||
--- | ---
|
||||
|Emergency Heat | Activates second stage heat source as primary heat|
|
||||
|
||||
## Humidifier
|
||||
|
||||
If the discovered device supports humidity control, the integration will add a humidifier and/or dehumidifier for each device.
|
||||
|
||||
### Available Actions
|
||||
|
||||
| Action | Description |
|
||||
|--------|-------------|
|
||||
| `humidifier.set_humidity` | Set target humidity level |
|
||||
| `humidifier.turn_on` | Enable humidity control |
|
||||
| `humidifier.turn_off` | Disable humidity control |
|
||||
| `humidifier.toggle` | Toggle humidity control |
|
||||
|
||||
For more details, see the [humidifier](/integrations/humidifier) integration documentation.
|
||||
|
||||
### Configuration Example
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
automation:
|
||||
- alias: "Maintain Comfortable Humidity"
|
||||
trigger:
|
||||
- platform: numeric_state
|
||||
entity_id: sensor.indoor_humidity
|
||||
below: 30 # Trigger when humidity drops below 30%
|
||||
action:
|
||||
- service: humidifier.turn_on
|
||||
target:
|
||||
entity_id: humidifier.living_room
|
||||
- service: humidifier.set_humidity
|
||||
target:
|
||||
entity_id: humidifier.living_room
|
||||
data:
|
||||
humidity: 35 # Set target humidity to 35% (recommended for comfort)
|
||||
```
|
||||
|
@ -29,6 +29,7 @@ ha_platforms:
|
||||
- switch
|
||||
ha_integration_type: integration
|
||||
ha_domain: husqvarna_automower
|
||||
ha_quality_scale: silver
|
||||
---
|
||||
|
||||
The Husqvarna Automower integration provides connectivity with Husqvarna Automowers lawn mowers through Husqvarna's cloud API. Only mowers with *Automower® Connect* or with the *Automower® Connect Module* are supported.
|
||||
|
@ -12,7 +12,7 @@ ha_platforms:
|
||||
- button
|
||||
- cover
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
ha_integration_type: device
|
||||
ha_codeowners:
|
||||
- '@abmantis'
|
||||
---
|
||||
|
@ -2,6 +2,7 @@
|
||||
title: Image upload
|
||||
description: The image upload integration handle image assets in Home Assistant.
|
||||
ha_category:
|
||||
- Media source
|
||||
- Other
|
||||
ha_release: 0.115
|
||||
ha_codeowners:
|
||||
@ -14,6 +15,8 @@ ha_integration_type: system
|
||||
The **Image upload** {% term integration %} allows Home Assistant to handle image assets in
|
||||
Home Assistant, for example, the profile photos of your systems account.
|
||||
|
||||
Uploaded images are also viewable in the media browser.
|
||||
|
||||
## Configuration
|
||||
|
||||
This integration is by default enabled, unless you've disabled or removed the
|
||||
|
@ -8,7 +8,6 @@ ha_category:
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@pburgio'
|
||||
- '@shapournemati-iotty'
|
||||
ha_domain: iotty
|
||||
ha_platforms:
|
||||
|
@ -2,7 +2,9 @@
|
||||
title: IronOS
|
||||
description: Instructions on how to integrate IronOS-based Pinecil V2 devices with Home Assistant.
|
||||
ha_category:
|
||||
- Binary sensor
|
||||
- Number
|
||||
- Select
|
||||
- Sensor
|
||||
- Update
|
||||
ha_iot_class: Local Polling
|
||||
@ -13,7 +15,9 @@ ha_codeowners:
|
||||
ha_domain: iron_os
|
||||
ha_integration_type: integration
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- number
|
||||
- select
|
||||
- sensor
|
||||
- update
|
||||
---
|
||||
@ -51,6 +55,10 @@ Home Assistant will detect nearby IronOS devices. Discovered devices will show u
|
||||
|
||||
- **Setpoint temperature:** Allows to set the desired target temperature for the soldering iron tip.
|
||||
|
||||
## Binary sensors
|
||||
|
||||
- **Soldering tip:** Indicates whether a soldering tip is currently connected to the device.
|
||||
|
||||
## Sensors
|
||||
|
||||
- **Tip temperature:** Monitors the current temperature of the soldering iron tip.
|
||||
@ -71,6 +79,49 @@ Home Assistant will detect nearby IronOS devices. Discovered devices will show u
|
||||
|
||||
- **Firmware:** The update entity indicates if the firmware is up-to-date or if there is a newer IronOS version available for your device. For more information on how to update your device, please refer to the [IronOS documentation](https://ralim.github.io/IronOS/).
|
||||
|
||||
## Device settings and configuration
|
||||
|
||||
The following controls allow you to customize the settings and options for your soldering device. Some controls are deactivated by default, as they are either advanced settings, less critical, or usually do not require adjustment.
|
||||
|
||||
### Basic settings
|
||||
|
||||
- **Boost temperature:** Sets the temperature for boost mode, which temporarily overrides the soldering temperature when the front button is held down.
|
||||
- **Sleep temperature:** The temperature the device drops to after a specified period of inactivity (no movement or button presses).
|
||||
- **Sleep timeout:** The duration of inactivity required before the device enters sleep mode and drops to the sleep temperature.
|
||||
|
||||
- **Long-press temperature step:** The temperature adjustment increment when holding down a button. Defaults to 10°.
|
||||
- **Short-press temperature step:** The temperature adjustment increment when briefly pressing a button. Defaults to 1°.
|
||||
- **Motion sensitivity:** Controls how sensitive the device is to movement. Higher values increase sensitivity (for example, 0 = motion detection is off).
|
||||
- **Hall effect sensitivity:** Configures the sensitivity of the hall effect sensor (if present) for detecting a magnet to activate sleep mode.
|
||||
- **Display brightness:** Adjusts the brightness of the soldering iron's display.
|
||||
- **Button locking mode:** Configures whether buttons can be locked to prevent accidental presses, with options for disabled, full locking, or boost only.
|
||||
- **Display orientation mode:** Sets the display orientation with options for left-handed, right-handed, or automatic adjustment.
|
||||
- **Startup behavior:** Defines the mode the device enters on power-up: disabled, sleeping mode, idle mode (heat-off until moved), or soldering mode.
|
||||
|
||||
### User interface settings
|
||||
|
||||
- **Scrolling speed:** Adjusts the speed of the description text scrolling in the menu, with options for slow or fast.
|
||||
- **Temperature display unit:** Sets the unit for displaying temperature as Celsius (C°) or Fahrenheit (F°).
|
||||
- **Animation speed:** Adjusts the pace of icon animations in the menu, with options for off, slow, medium, or fast.
|
||||
- **Boot logo duration:** Sets the duration for the boot logo, with options for off, 1–5 seconds, or loop.
|
||||
|
||||
### Power management
|
||||
|
||||
- **Keep-awake pulse duration:** Specifies the duration of the power pulse to keep connected power banks awake. Shorter durations minimize power waste and unnecessary heating.
|
||||
- **Keep-awake pulse delay:** Adjusts the interval between power pulses. Longer delays reduce unwanted heating, but must be short enough to prevent the power bank from shutting off.
|
||||
- **Keep-awake pulse intensity:** Enables and sets the wattage of the power pulse. The power pulse briefly activates the heater to draw sufficient power, preventing connected power banks from entering sleep mode.
|
||||
- **Power source:** Sets the power source type, with options for an external power supply or 3S to 6S battery configurations.
|
||||
- **Min. voltage per cell:** Sets the minimum voltage per battery cell before shutdown. This value is multiplied by the cell count (for example, 3S: 3–3.7V, 4–6S: 2.4–3.7V).
|
||||
- **Power Delivery timeout:** Defines how long the firmware will attempt to negotiate USB-PD before switching to Quick Charge. Lower values are recommended for faster PD negotiation.
|
||||
- **Power limit:** Sets a custom wattage cap for the device to maintain the **average** power below this value. Note: Peak power cannot be controlled. When using USB-PD, the limit will be the lower of this setting and the power supply's advertised wattage.
|
||||
- **Quick Charge voltage:** Adjusts the maximum voltage for Quick Charge negotiation. Does not affect USB-PD. Ensure the setting aligns with the current rating of your power supply for safety.
|
||||
|
||||
### Advanced settings
|
||||
|
||||
These settings are intended for technically experienced users and require careful consideration before changes.
|
||||
|
||||
- **Voltage divider:** Fine-tunes the measured voltage to account for variations in the voltage sense resistors between units.
|
||||
- **Calibration offset:** Adjusts the calibration of the thermocouple measurements, which determine the temperature displayed for the tip.
|
||||
## Automations
|
||||
|
||||
Get started with this automation example for IronOS with a ready-to-use blueprint!
|
||||
|
66
source/_integrations/ituran.markdown
Normal file
66
source/_integrations/ituran.markdown
Normal file
@ -0,0 +1,66 @@
|
||||
---
|
||||
title: Ituran
|
||||
description: Instructions on how to add Ituran to Home Assistant.
|
||||
ha_category:
|
||||
- Car
|
||||
- Device Tracker
|
||||
- Presence detection
|
||||
ha_release: '2025.1'
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@shmuelzon'
|
||||
ha_domain: ituran
|
||||
ha_platforms:
|
||||
- device_tracker
|
||||
- sensor
|
||||
ha_integration_type: hub
|
||||
---
|
||||
|
||||
The **Ituran** {% term integration %} allows you to retrieve information from your Ituran-equipped vehicle using the [Ituran APP service](https://www.ituran.co.il/ituranfront/comfort-services-2/ituran-app-comfort). It pulls information from the Ituran web service regarding the vehicle's location.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
You must have an Ituran account for use with the Ituran APP ([Android](https://play.google.com/store/apps/details?id=com.ituran.forall)/[iOS](https://apps.apple.com/app/id1227756834)). All devices that work with the app, should work with this integration as well.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
{% configuration_basic %}
|
||||
ID or passport number:
|
||||
description: Your government ID or passport number used to sign-up with Ituran.
|
||||
Mobile phone number:
|
||||
description: The mobile phone number used to sign-up with Ituran. A one-time-password will be sent to this number.
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
## Data updates
|
||||
|
||||
The information is pulled every 5 minutes from the Ituran web service; however, the data is updated at intervals determined by Ituran based on whether the vehicle is stationary or not.
|
||||
|
||||
## Supported functionality
|
||||
|
||||
### Device tracker
|
||||
|
||||
The Ituran {% term integration %} will track the location of each vehicle registered to your account.
|
||||
|
||||
### Sensor
|
||||
|
||||
The Ituran {% term integration %} also exposes the following sensor for each registered vehicle:
|
||||
|
||||
- **Address** - The address that corresponds with the vehicle's location, as determined by Ituran
|
||||
- **Battery voltage** - The measured voltage (V) of the car battery. If not supported by the installation, the value will be set to `-1`
|
||||
- **Heading** - The direction (0-359°) that the vehicle is pointing to
|
||||
- **Last update from vehicle** - The time from when the vehicle last published its information to the Ituran cloud
|
||||
- **Mileage** - The distance (km) the vehicle has traveled
|
||||
- **Speed** - The current speed (km/h) of the vehicle
|
||||
|
||||
## Known limitations
|
||||
|
||||
- While this integration is configured with your account, you won't be able to use the official app, as only one connection at a time is supported
|
||||
- The vehicle's heading value is unreliable when it's not in motion
|
||||
- The mileage value is not read from the vehicle's odometer but is calculated from GPS, which may result in slight variations from the actual odometer reading
|
||||
|
||||
## Removing the integration
|
||||
|
||||
This integration follows standard integration removal. No extra steps are required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
@ -2015,6 +2015,10 @@ device_class:
|
||||
| 16.000 | string | 14 | ASCII | |
|
||||
| 16.001 | latin_1 | 14 | ISO 8859-1 / Latin-1 | |
|
||||
| 17.001 | scene_number | 1 | 1 ... 64 | |
|
||||
| 29 | 8byte_signed | 8 | ±9223372036854775807 | |
|
||||
| 29.010 | active_energy_8byte | 8 | ±9223372036854775807 | Wh |
|
||||
| 29.011 | apparant_energy_8byte | 8 | ±9223372036854775807 | VAh |
|
||||
| 29.012 | reactive_energy_8byte | 8 | ±9223372036854775807 | VARh |
|
||||
|
||||
### More examples
|
||||
|
||||
@ -2294,7 +2298,7 @@ address_day_night:
|
||||
required: false
|
||||
type: [string, list]
|
||||
address_air_pressure:
|
||||
description: KNX address reading current air pressure. *DPT 9.006*
|
||||
description: KNX address reading current air pressure. *DPT 9.006 or 14.058*
|
||||
required: false
|
||||
type: [string, list]
|
||||
address_humidity:
|
||||
|
@ -28,6 +28,7 @@ ha_dhcp: true
|
||||
ha_codeowners:
|
||||
- '@zweckj'
|
||||
ha_integration_type: device
|
||||
ha_quality_scale: platinum
|
||||
---
|
||||
|
||||
This integration interacts with [La Marzocco](https://lamarzocco.com/it/en/) coffee machines through calls to the La Marzocco cloud API. Optionally, local API calls, which include a WebSocket connection for (near) real-time updates and a Bluetooth connection, can be utilized for local connections.
|
||||
@ -86,7 +87,6 @@ Use Bluetooth:
|
||||
| **Preinfusion time** | Duration of preinfusion | `Linea Micra`, `Linea Mini`, `GS3 AV` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %} | `GS3` has this multiple times, one for each physical key (1-4), and the entities are disabled by default |
|
||||
| **Smart standby time** | Time until the machine will automatically stand by (if enabled) | `all` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %} | - |
|
||||
|
||||
|
||||
## Switches
|
||||
|
||||
| Switch name | Description | Available for machines | Controllable through |
|
||||
@ -102,6 +102,7 @@ Use Bluetooth:
|
||||
| **Water tank empty** | Indicates whether the water tank needs a refill. | `all` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %} {% icon "material-symbols:wifi" title="Local connection" %} | - |
|
||||
| **Brewing active** | Is on if you are in the process of making coffee. | `all` | {% icon "material-symbols:wifi" title="Local connection" %} | Only available when the `Host` was set during component configuration. |
|
||||
| **Backflush enabled** | Is on if you started the backflushing process. | `all` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %} {% icon "material-symbols:wifi" title="Local connection" %} | - |
|
||||
| **Connectivity** | Whether the LM Acaia scale is currently connected to the machine. | `Linea Mini` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %} | Only available if you have the Acaia LM scale and configured it with your machine. |
|
||||
|
||||
## Sensors
|
||||
|
||||
@ -112,6 +113,7 @@ Use Bluetooth:
|
||||
| **Total coffees made** | Counter for total coffees made| `all` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %} | - |
|
||||
| **Total flushes made** | Counter for total flushes done | `all` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %}| - |
|
||||
| **Shot timer** | Time the current brew is running | `all` | {% icon "material-symbols:wifi" title="Local connection" %} | Only available when the `Host` was set during component configuration. |
|
||||
| **Battery** | Battery level of the LM Acaia scale | `Linea Mini` | {% icon "material-symbols:cloud-outline" title="La Marzocco Cloud" %} | Only available if you have the Acaia LM scale and configured it with your machine. |
|
||||
|
||||
## Updates
|
||||
|
||||
|
@ -106,10 +106,10 @@ To delete multiple devices at once, enable selection mode. Select the desired e
|
||||
|
||||
### Configuring entities
|
||||
|
||||
Entities configured for all devices are listed on the **Entities** tab.
|
||||
Entities configured for all devices are listed on the **Entities** tab.
|
||||
|
||||
To view entities for a specific device (module or group), in the **Modules / Groups** tab, select the device entry.
|
||||
- **Result**: The **Entities** tab opens, showing entities of the selected device.
|
||||
- **Result**: The **Entities** tab opens, showing entities of the selected device.
|
||||
- To apply custom filters, enable the filter option.
|
||||
|
||||

|
||||
@ -128,13 +128,13 @@ To view entities for a specific device (module or group), in the **Modules / Gro
|
||||
#### Deleting entities
|
||||
|
||||
To delete a single entity, select the trash can icon next to it.
|
||||
- **Result**: This removes the entity from the list and from Home Assistant.
|
||||
- **Result**: This removes the entity from the list and from Home Assistant.
|
||||
|
||||
To delete multiple entities, enable selection mode, select the desired entries, and select **Delete Selected** in the upper right.
|
||||
|
||||
#### Displaying entity properties
|
||||
|
||||
Once an entity is created, you can view and configure its properties.
|
||||
Once an entity is created, you can view and configure its properties.
|
||||
|
||||
Select the entity in the entity list.
|
||||
- This opens the Home Assistant dialog for entity properties, allowing you to configure the entity as you would from the general Home Assistant entity configuration panel.
|
||||
@ -431,13 +431,15 @@ For an explanation of the attributes refer to the corresponding [events](#events
|
||||
In order to directly interact with the LCN system, and invoke commands which are not covered by the implemented platforms, the following actions can be used.
|
||||
Refer to the [Performing actions](/docs/scripts/service-calls) page for examples on how to use them.
|
||||
|
||||
When actions are linked to a particular device, the device is identified by its `device_id`. This `device_id` is a unique identifier supplied by Home Assistant.
|
||||
|
||||
### Action: `output_abs`
|
||||
|
||||
Set absolute brightness of output port in percent.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | --------------------------------- | --------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `output` | No | Output port of module | [OUTPUT_PORT](#ports) |
|
||||
| `brightness` | Yes | Absolute brightness in percent | 0..100 |
|
||||
| `transition` | Yes | Transition (ramp) time in seconds | 0..486 |
|
||||
@ -447,7 +449,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.output_abs
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
output: output1
|
||||
brightness: 100
|
||||
transition: 0
|
||||
@ -457,9 +459,9 @@ data:
|
||||
|
||||
Set relative brightness of output port in percent.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | --------------------------------- | --------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `output` | No | Output port of module | [OUTPUT_PORT](#ports) |
|
||||
| `brightness` | Yes | Relative brightness in percent | -100..100 |
|
||||
| `transition` | Yes | Transition (ramp) time in seconds | 0..486 |
|
||||
@ -469,7 +471,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.output_rel
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
output: output1
|
||||
brightness: 30
|
||||
```
|
||||
@ -478,9 +480,9 @@ data:
|
||||
|
||||
Toggle output port.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | --------------------------------- | --------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `output` | No | Output port of module | [OUTPUT_PORT](#ports) |
|
||||
| `transition` | Yes | Transition (ramp) time in seconds | 0..486 |
|
||||
|
||||
@ -489,7 +491,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.output_toggle
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
output: output1
|
||||
transition: 0
|
||||
```
|
||||
@ -501,17 +503,17 @@ Each character represents the state change of a relay (1=on, 0=off, t=toggle, -=
|
||||
|
||||
Example states: `t---001-`
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | ------ |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `state` | No | Relay states as string |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `state` | No | Relay states as string ||
|
||||
|
||||
Example:
|
||||
|
||||
```yaml
|
||||
action: lcn.relays
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
state: t---001-
|
||||
```
|
||||
|
||||
@ -519,9 +521,9 @@ data:
|
||||
|
||||
Set the LED status.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | -------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `state` | No | LED state as string | [LED_STATE](#states) |
|
||||
|
||||
Example:
|
||||
@ -529,7 +531,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.led
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
led: led6
|
||||
state: blink
|
||||
```
|
||||
@ -540,9 +542,9 @@ Set the absolute value of a variable or setpoint.
|
||||
If `value` is not defined, it is assumed to be 0.
|
||||
If `unit_of_measurement` is not defined, it is assumed to be `native`.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | ------------------------------------------------------------------ |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `variable` | No | Variable name | [VARIABLE](#variables-and-units), [SETPOINT](#variables-and-units) |
|
||||
| `value` | Yes | Variable value | _any positive number_ |
|
||||
| `unit_of_measurement` | Yes | Variable unit | [VAR_UNIT](#variables-and-units) |
|
||||
@ -552,7 +554,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.var_abs
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
variable: var1
|
||||
value: 75
|
||||
unit_of_measurement: %
|
||||
@ -569,9 +571,9 @@ Set the relative value of a variable or setpoint.
|
||||
If `value` is not defined, it is assumed to be 0.
|
||||
If `unit_of_measurement` is not defined, it is assumed to be `native`.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | ----------------------------------------------------------------------------------------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `variable` | No | Variable name | [VARIABLE](#variables-and-units), [SETPOINT](#variables-and-units), [THRESHOLD](#variables-and-units) |
|
||||
| `value` | Yes | Variable value | _any positive or negative number_ |
|
||||
| `unit_of_measurement` | Yes | Variable unit | [VAR_UNIT](#variables-and-units) |
|
||||
@ -581,7 +583,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.var_rel
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
variable: var1
|
||||
value: 10
|
||||
unit_of_measurement: %
|
||||
@ -596,9 +598,9 @@ Otherwise the module might show unexpected behavior or return error messages.
|
||||
|
||||
Reset value of variable or setpoint.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | ------------------------------------------------------------------ |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `variable` | No | Variable name | [VARIABLE](#variables-and-units), [SETPOINT](#variables-and-units) |
|
||||
|
||||
Example:
|
||||
@ -606,7 +608,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.var_reset
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
variable: var1
|
||||
```
|
||||
|
||||
@ -620,9 +622,9 @@ Otherwise the module might show unexpected behavior or return error messages.
|
||||
Locks a regulator setpoint.
|
||||
If `state` is not defined, it is assumed to be `False`.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | -------------------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `setpoint` | No | Setpoint name | [SETPOINT](#variables-and-units) |
|
||||
| `state` | Yes | Lock state | true, false |
|
||||
|
||||
@ -631,7 +633,7 @@ Example:
|
||||
```yaml
|
||||
action: lcn.lock_regulator
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
setpoint: r1varsetpoint
|
||||
state: true
|
||||
```
|
||||
@ -644,9 +646,9 @@ If `state` is not defined, it is assumed to be `hit`.
|
||||
The command allows the sending of keys immediately or deferred. For a deferred sending the attributes `time` and `time_unit` have to be specified. For deferred sending, the only key state allowed is `hit`.
|
||||
If `time_unit` is not defined, it is assumed to be `seconds`.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | --------------------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `keys` | No | Keys string |
|
||||
| `state` | Yes | Keys state | [KEY_STATE](#states) |
|
||||
| `time` | Yes | Deferred time | 0.. |
|
||||
@ -658,7 +660,7 @@ Send keys immediately:
|
||||
```yaml
|
||||
action: lcn.send_keys
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
keys: a1a5d8
|
||||
state: hit
|
||||
```
|
||||
@ -667,7 +669,7 @@ Send keys deferred:
|
||||
```yaml
|
||||
action: lcn.send_keys
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
keys: a1a5d8
|
||||
time: 5
|
||||
time_unit: s
|
||||
@ -681,10 +683,10 @@ The key lock states are defined as a string with eight characters. Each characte
|
||||
The command allows the locking of keys for a specified time period. For a time period, the attributes `time` and `time_unit` have to be specified. For a time period, only table `a` is allowed.
|
||||
If `time_unit` is not defined, it is assumed to be `seconds`.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | --------------------------------- |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `table` | Yes | Table with keys to lock |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `table` | Yes | Table with keys to lock ||
|
||||
| `state` | No | Key lock states as string | [KEY_STATE](#states) |
|
||||
| `time` | Yes | Time period to lock | 0.. |
|
||||
| `time_unit` | Yes | Time unit | [TIME_UNIT](#variables-and-units) |
|
||||
@ -695,7 +697,7 @@ Lock keys forever:
|
||||
```yaml
|
||||
action: lcn.lock_keys
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
table: a
|
||||
state: 1---t0--
|
||||
```
|
||||
@ -704,7 +706,7 @@ Lock keys for a specified time period:
|
||||
```yaml
|
||||
action: lcn.lock_keys
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
state: 1---t0--
|
||||
time: 10
|
||||
time_unit: s
|
||||
@ -716,19 +718,18 @@ Send dynamic text to LCN-GTxD displays.
|
||||
The displays support four rows for text messages.
|
||||
Each row can be set independently and can store up to 60 characters (encoded in UTF-8).
|
||||
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ---------------------------------- | ------ |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `row` | No | Text row 1..4 |
|
||||
| `text` | No | Text to send for the specified row |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `row` | No | Text row 1-4 ||
|
||||
| `text` | No | Text to send for the specified row ||
|
||||
|
||||
Example:
|
||||
|
||||
```yaml
|
||||
action: lcn.dyn_text
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
row: 1
|
||||
text: "text in row 1"
|
||||
```
|
||||
@ -737,17 +738,17 @@ data:
|
||||
|
||||
Send arbitrary PCK command. Only the command part of the PCK command has to be specified in the `pck` string.
|
||||
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| Data attribute | Optional | Description | Values |
|
||||
| ---------------------- | -------- | ----------------------------- | ------ |
|
||||
| `address` | No | [LCN address](#lcn-addresses) |
|
||||
| `pck` | No | PCK command |
|
||||
| `device_id` | No | Home Assistant device id ||
|
||||
| `pck` | No | PCK command ||
|
||||
|
||||
Example:
|
||||
|
||||
```yaml
|
||||
action: lcn.pck
|
||||
data:
|
||||
address: myhome.0.7
|
||||
device_id: 91aa039a2fb6e0b9f9ec7eb219a6b7d2
|
||||
pck: PIN4
|
||||
```
|
||||
|
||||
|
@ -7,7 +7,7 @@ ha_release: 2024.12
|
||||
ha_iot_class: Local Push
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@music_assistant'
|
||||
- '@music-assistant'
|
||||
ha_domain: music_assistant
|
||||
ha_platforms:
|
||||
- media_player
|
||||
@ -15,7 +15,7 @@ ha_zeroconf: true
|
||||
ha_integration_type: integration
|
||||
---
|
||||
|
||||
The **Music Assistant**(MA) {% term integrations %} allows you to connect Home Assistant to a [Music Assistant Server](https://music-assistant.io/). Once configured, all [MA Players](https://music-assistant.io/player-support/) show up as Home Assistant [media player entities](/integrations/media_player/). Media players will allow you to control media playback and see the currently playing item.
|
||||
The **Music Assistant** (MA) {% term integration %} allows you to connect Home Assistant to a [Music Assistant Server](https://music-assistant.io/). Once configured, all [MA Players](https://music-assistant.io/player-support/) show up as Home Assistant [media player entities](/integrations/media_player/). Media players will allow you to control media playback and see the currently playing item.
|
||||
|
||||
There is currently support for the following Home Assistant Platforms:
|
||||
|
||||
@ -27,11 +27,11 @@ All of the Home Assistant [Media Player Control Actions](https://www.home-assist
|
||||
|
||||
### Manual configuration
|
||||
|
||||
Under normal circumstances, Home Assistant automatically discovers your running Music Assistant Server. If something special about the HA or MA setup (for example, the MA server is running as a remote Docker container) or discovery is not working, you can manually specify the URL to your Music Assistant server.
|
||||
Under normal circumstances, Home Assistant automatically discovers your running Music Assistant Server. If there is something special about the HA or MA setup (for example, the MA server is running as a remote Docker container) or discovery is not working, you can manually specify the URL to your Music Assistant server. If the Music Assistant Server is not installed then follow these [installation instructions](https://music-assistant.io/installation/).
|
||||
|
||||
## Media player
|
||||
|
||||
The Music Assistant media player creates media player entities for all players available in MA including those imported from Home Assistant. This is needed to provide the full functionality Music Assistant has to offer. These entities will display media information, playback progress, and playback controls.
|
||||
The Music Assistant integration creates media player entities for all players available in MA including those imported from Home Assistant. This is needed to provide the full functionality Music Assistant has to offer. These entities will display media information, playback progress, and playback controls.
|
||||
|
||||
### Action `media_player.play_media`
|
||||
|
||||
@ -85,11 +85,11 @@ Play media on a Music Assistant player with more fine-grained control options.
|
||||
- **Example**: `playlist`
|
||||
- **Data attribute**: `artist`
|
||||
- **Optional**: Yes.
|
||||
- **Description**: When specifying a track or album in the Media ID field, you can optionally restrict results by this artist name.
|
||||
- **Description**: When specifying a track or album by name in the Media ID field, you can optionally restrict results by this artist name.
|
||||
- **Example**: `Queen`
|
||||
- **Data attribute**: `album`
|
||||
- **Optional**: Yes.
|
||||
- **Description**: When specifying a track in the Media ID field, you can optionally restrict results by this album name.
|
||||
- **Description**: When specifying a track by name in the Media ID field, you can optionally restrict results by this album name.
|
||||
- **Example**: `News of the world`
|
||||
- **Data attribute**: `enqueue`
|
||||
- **Optional**: Yes.
|
||||
@ -122,6 +122,19 @@ Play announcement on a Music Assistant player with more fine-grained control opt
|
||||
- **Description**: Use a forced volume level for the announcement. Omit to use the player default.
|
||||
- **Example**: `75`
|
||||
|
||||
### Action `music_assistant.transfer_queue`
|
||||
|
||||
Transfer the player's queue to another player.
|
||||
|
||||
- **Data attribute**: `source_player`
|
||||
- **Optional**: Yes.
|
||||
- **Description**: The source media player which has the queue to be transferred. When omitted, the first playing player will be used.
|
||||
- **Example**: `media_player.kitchen_speaker`
|
||||
- **Data attribute**: `auto_play`
|
||||
- **Optional**: Yes.
|
||||
- **Description**: Start playing the queue on the target player. Omit to use the default behavior.
|
||||
- **Example**: `true`
|
||||
|
||||
## Notes
|
||||
|
||||
- Any Home Assistant players added to Music Assistant will appear duplicated as the MA version of the player is created. The original HA player can be hidden if desired.
|
||||
|
@ -27,6 +27,7 @@ ha_integration_type: integration
|
||||
related:
|
||||
- url: https://myuplink.com/
|
||||
title: myUplink web portal
|
||||
ha_quality_scale: silver
|
||||
---
|
||||
|
||||
The **myUplink** {% term integration %} lets you get information about and control heat-pump devices supporting myUplink using the [official cloud API](https://dev.myuplink.com).
|
||||
|
@ -1,37 +1,24 @@
|
||||
---
|
||||
title: Niko Home Control
|
||||
description: Instructions on how to integrate Niko Home Control lights into Home Assistant.
|
||||
ha_codeowners:
|
||||
- '@VandeurenGlenn'
|
||||
ha_config_flow: true
|
||||
ha_category:
|
||||
- Cover
|
||||
- Light
|
||||
ha_iot_class: Local Polling
|
||||
ha_iot_class: Local Push
|
||||
ha_release: 0.82
|
||||
ha_domain: niko_home_control
|
||||
ha_platforms:
|
||||
- cover
|
||||
- light
|
||||
ha_integration_type: integration
|
||||
related:
|
||||
- docs: /docs/configuration/
|
||||
title: Configuration file
|
||||
ha_quality_scale: legacy
|
||||
---
|
||||
|
||||
The `niko_home_control` {% term integration %} allows you to integrate your [Niko Home Control](https://www.niko.eu/enus/products/niko-home-control) into Home Assistant.
|
||||
|
||||
## Configuration
|
||||
|
||||
To enable this lights, add the following lines to your {% term "`configuration.yaml`" %} file.
|
||||
{% include integrations/restart_ha_after_config_inclusion.md %}
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
light:
|
||||
- platform: niko_home_control
|
||||
host: IP_ADDRESS
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
host:
|
||||
description: The IP address of the Niko Home light.
|
||||
required: false
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
{% include integrations/config_flow.md %}
|
||||
|
@ -15,6 +15,7 @@ ha_platforms:
|
||||
- diagnostics
|
||||
- sensor
|
||||
ha_integration_type: hub
|
||||
ha_quality_scale: platinum
|
||||
---
|
||||
|
||||
The **Nord Pool** {% term integration %} integrates [Nord Pool Group](https://www.nordpoolgroup.com/) energy prices into Home Assistant.
|
||||
@ -65,6 +66,8 @@ The integration will create entities showing today's energy prices for the confi
|
||||
| Previous price | [Currency]/kWh | The price of the previous hour. |
|
||||
| Next price | [Currency]/kWh | The price of the next hour. |
|
||||
| Daily average | [Currency]/kWh | The average of today's energy prices. |
|
||||
| Lowest price | [Currency]/kWh | Today's lowest price (start and end time are provided in state attributes) |
|
||||
| Highest price | [Currency]/kWh | Today's highest price (start and end time are provided in state attributes) |
|
||||
|
||||
### Peak & off-peak sensors
|
||||
|
||||
@ -96,6 +99,52 @@ The block price sensors are not enabled by default.
|
||||
| Exchange rate | Integer | The exchange rate between the configure currency and Euro's. |
|
||||
| Last updated | Datetime | The time when the market prices were last updated. |
|
||||
|
||||
## Actions
|
||||
|
||||
### Get price for date
|
||||
|
||||
The integration entities provide price information only for the current date. Use the "Get price for date" action to retrieve pricing information for any date within the last two months or for tomorrow.
|
||||
|
||||
The areas and currency parameters are optional. If omitted, the values configured in the integration will be used.
|
||||
|
||||
See [examples](#examples) how to use in a trigger template sensor.
|
||||
|
||||
{% configuration_basic %}
|
||||
Nord Pool configuration entry:
|
||||
description: Select the Nord Pool configuration entry to target.
|
||||
Date:
|
||||
description: Pick the date to fetch prices for (see note about possible dates below).
|
||||
Areas:
|
||||
description: Select one market area to create output for. If omitted it will use the areas from the configuration entry.
|
||||
Currency:
|
||||
description: Currency to display prices in. EUR is the base currency in Nord Pool prices. If omitted it will use the currency from the configuration entry.
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
{% note %}
|
||||
|
||||
The public API only allows us to see past pricing information for up to 2 months.
|
||||
|
||||
Tomorrow's prices are typically released around 13:00 CET, and trying to get them before that time will generate an error that needs to be considered in such a case.
|
||||
|
||||
{% endnote %}
|
||||
|
||||
#### Example action with data
|
||||
|
||||
{% raw %}
|
||||
|
||||
```yaml
|
||||
action: nordpool.get_prices_for_date
|
||||
data:
|
||||
config_entry: 1234567890a
|
||||
date: "2024-11-10"
|
||||
areas:
|
||||
- SE3
|
||||
- SE4
|
||||
currency: SEK
|
||||
```
|
||||
|
||||
{% endraw %}
|
||||
|
||||
## Examples
|
||||
|
||||
A template sensor to add VAT and fixed cost is useful to get the actual energy cost in the energy dashboard.
|
||||
@ -138,6 +187,65 @@ template:
|
||||
|
||||
{% endraw %}
|
||||
|
||||
### Tomorrow's lowest price
|
||||
|
||||
Using a trigger template, you can create a template sensor to calculate tomorrow's lowest price which also puts the list of all prices in the attributes of the sensor. All prices are returned in [Currency]/MWh.
|
||||
|
||||
{% note %}
|
||||
You need to replace the `config_entry` with your own Nord Pool config entry id.
|
||||
|
||||
Below example will convert the action call response to kWh prices in the selected currency and add all prices for tomorrow as a list in an attribute.
|
||||
{% endnote %}
|
||||
|
||||
{% raw %}
|
||||
|
||||
```yaml
|
||||
template:
|
||||
- trigger:
|
||||
- trigger: time_pattern
|
||||
minutes: /10
|
||||
- trigger: homeassistant
|
||||
event: start
|
||||
action:
|
||||
- action: nordpool.get_prices_for_date
|
||||
data:
|
||||
config_entry: 01JEDAR1YEHJ6DZ376MP24MRDG
|
||||
date: "{{ now().date() + timedelta(days=1) }}"
|
||||
areas: SE3
|
||||
currency: SEK
|
||||
response_variable: tomorrow_price
|
||||
sensor:
|
||||
- name: Tomorrow lowest price
|
||||
unique_id: se3_tomorrow_low_price
|
||||
state: >
|
||||
{% if not tomorrow_price %}
|
||||
unavailable
|
||||
{% else %}
|
||||
{% set data = namespace(prices=[]) %}
|
||||
{% for state in tomorrow_price['SE3'] %}
|
||||
{% set data.prices = data.prices + [(state.price / 1000)] %}
|
||||
{% endfor %}
|
||||
{{min(data.prices)}}
|
||||
{% endif %}
|
||||
attributes:
|
||||
data: >
|
||||
{% if not tomorrow_price %}
|
||||
[]
|
||||
{% else %}
|
||||
{% set data = namespace(prices=[]) %}
|
||||
{% for state in tomorrow_price['SE3'] %}
|
||||
{% set data.prices = data.prices + [{'start':state.start, 'end':state.end, 'price': state.price/1000}] %}
|
||||
{% endfor %}
|
||||
{{data.prices}}
|
||||
{% endif %}
|
||||
```
|
||||
|
||||
{% endraw %}
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/integrations/nordpool/nordpool_tomorrow_lowest_price.png' alt='Screenshot: Trigger template: Tomorrow lowest price'>
|
||||
</p>
|
||||
|
||||
### Energy Dashboard
|
||||
|
||||
To use the Nordpool integration in the **Energy** dashboard, when configuring grid consumption and production, use the **Use an entity with current price** option.
|
||||
|
@ -51,8 +51,8 @@ The following device classes are supported for numbers:
|
||||
- **data_rate**: Data rate in bit/s, kbit/s, Mbit/s, Gbit/s, B/s, kB/s, MB/s, GB/s, KiB/s, MiB/s, or GiB/s
|
||||
- **data_size**: Data size in bit, kbit, Mbit, Gbit, B, kB, MB, GB, TB, PB, EB, ZB, YB, KiB, MiB, GiB, TiB, PiB, EiB, ZiB, or YiB
|
||||
- **distance**: Generic distance in km, m, cm, mm, mi, yd, or in
|
||||
- **energy**: Energy in Wh, kWh, MWh, GWh, TWh, MJ, or GJ
|
||||
- **energy_storage**: Stored energy in Wh, kWh, MWh, GWh, TWh, MJ, or GJ
|
||||
- **energy**: Energy in J, kJ, MJ, GJ, mWh, Wh, kWh, MWh, GWh, TWh, cal, kcal, Mcal, or Gcal
|
||||
- **energy_storage**: Stored energy in J, kJ, MJ, GJ, mWh, Wh, kWh, MWh, GWh, TWh, cal, kcal, Mcal, or Gcal
|
||||
- **frequency**: Frequency in Hz, kHz, MHz, or GHz
|
||||
- **gas**: Gasvolume in m³, ft³, or CCF
|
||||
- **humidity**: Percentage of humidity in the air
|
||||
@ -69,7 +69,7 @@ The following device classes are supported for numbers:
|
||||
- **pm10**: Concentration of particulate matter less than 10 micrometers in µg/m³
|
||||
- **pm25**: Concentration of particulate matter less than 2.5 micrometers in µg/m³
|
||||
- **power_factor**: Power factor(unitless), unit may be `None` or %
|
||||
- **power**: Power in W, kW, MW, GW or TW
|
||||
- **power**: Power in mW, W, kW, MW, GW or TW
|
||||
- **precipitation**: Accumulated precipitation in cm, in or mm
|
||||
- **precipitation_intensity**: Precipitation intensity in in/d, in/h, mm/d, or mm/h
|
||||
- **pressure**: Pressure in Pa, kPa, hPa, bar, cbar, mbar, mmHg, inHg, or psi
|
||||
|
81
source/_integrations/ohme.markdown
Normal file
81
source/_integrations/ohme.markdown
Normal file
@ -0,0 +1,81 @@
|
||||
---
|
||||
title: Ohme
|
||||
description: Instructions to configure the Ohme integration into Home Assistant.
|
||||
ha_category:
|
||||
- Car
|
||||
- Sensor
|
||||
ha_release: 2025.1
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_codeowners:
|
||||
- '@dan-r'
|
||||
ha_config_flow: true
|
||||
ha_domain: ohme
|
||||
ha_platforms:
|
||||
- button
|
||||
- sensor
|
||||
ha_quality_scale: silver
|
||||
ha_integration_type: device
|
||||
---
|
||||
|
||||
The **Ohme** {% term integration %} allows you to connect your [Ohme](https://ohme-ev.com/) EV charger to Home Assistant.
|
||||
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Ah Ohme account. If you signed up to Ohme with a third party account like Google, you will need to [reset your password](https://api.ohme.io/fleet/index.html#/authentication/forgotten-password) before configuring this integration.
|
||||
|
||||
|
||||
## Supported devices
|
||||
|
||||
The following devices are known to be supported by the integration:
|
||||
- Ohme Home Pro
|
||||
- Ohme Home
|
||||
- Ohme Go
|
||||
- Ohme ePod
|
||||
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
{% configuration_basic %}
|
||||
Email:
|
||||
description: "Email to log in to your Ohme account."
|
||||
Password:
|
||||
description: "Password to log in to your Ohme account."
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
|
||||
## Supported functionality
|
||||
|
||||
### Entities
|
||||
|
||||
The Ohme integration provides the following entities.
|
||||
|
||||
#### Buttons
|
||||
|
||||
- **Approve charge**
|
||||
- **Description**: If sensor **Status** is `Pending approval`, this will approve the charge.
|
||||
- **Available for devices**: all
|
||||
|
||||
#### Sensors
|
||||
|
||||
- **Status**
|
||||
- **Description**: Current status of the charger. Possible states: `Unplugged`, `Pending approval`, `Plugged in`, `Charging`.
|
||||
- **Available for devices**: all
|
||||
- **Power**
|
||||
- **Description**: Power draw from the charger in kW.
|
||||
- **Available for devices**: all
|
||||
- **Current**
|
||||
- **Description**: Current draw from the charger in amperes.
|
||||
- **Available for devices**: all
|
||||
- **Energy**
|
||||
- **Description**: Energy consumption of the charger in kWh.
|
||||
- **Available for devices**: all
|
||||
- **CT current**
|
||||
- **Description**: If a current transformer (CT) was installed with your charger, this will show the current used by your whole home.
|
||||
- **Available for devices**: Home Pro, ePod
|
||||
|
||||
|
||||
## Removing the integration
|
||||
|
||||
This integration follows standard integration removal. No extra steps are required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
@ -5,6 +5,7 @@ ha_category:
|
||||
- Media player
|
||||
ha_codeowners:
|
||||
- '@arturpragacz'
|
||||
- '@eclair4151'
|
||||
ha_config_flow: true
|
||||
ha_domain: onkyo
|
||||
ha_integration_type: device
|
||||
@ -12,6 +13,7 @@ ha_iot_class: Local Push
|
||||
ha_platforms:
|
||||
- media_player
|
||||
ha_release: 0.17
|
||||
ha_ssdp: true
|
||||
---
|
||||
|
||||
The `onkyo` {% term integration %} allows you to control [Onkyo](https://www.onkyo.com) and [Integra](http://www.integrahometheater.com) (from 2011 onward) and also [Pioneer](https://www.pioneerelectronics.com) (from 2016 onward) receivers using Home Assistant.
|
||||
|
@ -73,6 +73,14 @@ Floor Temperature:
|
||||
|
||||
### Button
|
||||
|
||||
The integration adds the following buttons to your Home Assistant instance:
|
||||
|
||||
#### Cancel Room Setpoint Override
|
||||
|
||||
Pressing this button, which can be found on the `OpenTherm Thermostat` device, cancels an active room setpoint override. Note that it does not change the target temperature, it only returns control to the thermostat.
|
||||
|
||||
#### Restart
|
||||
|
||||
The restart button on the `OpenTherm Gateway` device can be used to restart the OpenTherm Gateway.
|
||||
|
||||
### Select
|
||||
|
@ -12,6 +12,7 @@ ha_domain: palazzetti
|
||||
ha_platforms:
|
||||
- climate
|
||||
- diagnostics
|
||||
- number
|
||||
- sensor
|
||||
ha_integration_type: device
|
||||
ha_dhcp: true
|
||||
@ -39,14 +40,56 @@ This integration supports the following actions (see [Climate](/integrations/cli
|
||||
- `off` to turn the stove off
|
||||
- [`set_fan_mode`](/integrations/climate/#action-climateset_fan_mode)
|
||||
- `Silent` let the stove run in silent mode
|
||||
- `1`, `2`, `3`, `4`, `5` increasing fan speeds
|
||||
- `1` to `5` increasing fan speeds
|
||||
- `High` the highest available fan speed
|
||||
- `Auto` let the stove set the optimal fan speed
|
||||
|
||||
## Numbers
|
||||
|
||||
The Palazzetti integration offers control over the combustion power of the stove on a scale from `1` to `5`.
|
||||
|
||||
## Sensors
|
||||
|
||||
The Palazzetti integration offers the following sensors, for the products that provide them:
|
||||
|
||||
State sensors:
|
||||
|
||||
- Status (current operational state) can take the following values:
|
||||
- `off`: Off
|
||||
- `off_timer`: Timer-regulated switch off
|
||||
- `test_fire`: Ignition test
|
||||
- `heatup`: Pellet feed
|
||||
- `fueling`: Ignition
|
||||
- `ign_test`: Fuel check
|
||||
- `burning`: Operating
|
||||
- `burning_mod`: Operating - Modulating
|
||||
- `unknown`: Unknown
|
||||
- `cool_fluid`: Stand-by
|
||||
- `fire_stop`: Switch off
|
||||
- `clean_fire`: Burn pot cleaning
|
||||
- `cool`: Cooling in progress
|
||||
- `cleanup`: Final cleaning
|
||||
- `ecomode`: Ecomode
|
||||
- `chimney_alarm`: Chimney alarm
|
||||
- `grate_error`: Grate error
|
||||
- `pellet_water_error`: Pellet probe or return water error
|
||||
- `t05_error`: T05 error disconnected or faulty probe
|
||||
- `hatch_door_open`: Feed hatch or door open
|
||||
- `pressure_error`: Safety pressure switch error
|
||||
- `main_probe_failure`: Main probe failure
|
||||
- `flue_probe_failure`: Flue gas probe failure
|
||||
- `exhaust_temp_high`: Too high exhaust gas temperature
|
||||
- `pellet_finished`: Pellets finished or ignition failed
|
||||
- `firewood_finished`: Firewood finished
|
||||
- `cooling`: Cooling
|
||||
- `general_error`: General error
|
||||
- `door_open`: Door open
|
||||
- `temp_too_high`: Temperature too high
|
||||
- `cleaning_warning`: Cleaning warning
|
||||
- `fuel_error`: Fuel error
|
||||
|
||||
Temperature sensors:
|
||||
|
||||
- Outlet air temperature (°C)
|
||||
- Wood combustion temperature (°C)
|
||||
- Room temperature (°C)
|
||||
@ -54,5 +97,8 @@ The Palazzetti integration offers the following sensors, for the products that p
|
||||
- Tank water temperature (°C)
|
||||
- Hydro temperature 1 (°C)
|
||||
- Hydro temperature 2 (°C)
|
||||
- Pellet quantity (kg)
|
||||
- Pellet level (cm)
|
||||
|
||||
Fuel Sensors:
|
||||
|
||||
- Pellet quantity (kg - cumulative quantity consumed)
|
||||
- Pellet level (cm - current level)
|
||||
|
402
source/_integrations/peblar.markdown
Normal file
402
source/_integrations/peblar.markdown
Normal file
@ -0,0 +1,402 @@
|
||||
---
|
||||
title: Peblar
|
||||
description: Instructions on how to integrate Peblar Rocksolid EV Charger with Home Assistant.
|
||||
ha_category:
|
||||
- Car
|
||||
- Energy
|
||||
- Update
|
||||
ha_release: 2025.1
|
||||
ha_iot_class: Local Polling
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@frenck'
|
||||
ha_domain: peblar
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- button
|
||||
- diagnostics
|
||||
- number
|
||||
- select
|
||||
- sensor
|
||||
- switch
|
||||
- update
|
||||
ha_integration_type: device
|
||||
ha_zeroconf: true
|
||||
ha_quality_scale: platinum
|
||||
---
|
||||
|
||||
The Peblar {% term integration %} integrates your [Peblar Rocksolid EV Charger]
|
||||
with Home Assistant. Allowing you to monitor the charging status and energy
|
||||
consumption of your electric vehicle connected to the Peblar charger, while
|
||||
also providing the ability to add the charger to your Home Assistant
|
||||
energy dashboard.
|
||||
|
||||
[Peblar Rocksolid EV Charger]: https://peblar.com/
|
||||
|
||||
## Supported devices
|
||||
|
||||
The following rocksolid Pebler EV chargers are supported by this integration:
|
||||
|
||||
- Peblar Home
|
||||
- Peblar Home Plus
|
||||
- Peblar Business
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
### Configuration parameters
|
||||
|
||||
{% configuration_basic %}
|
||||
Host:
|
||||
description: The hostname or IP address of your Peblar charger on your home network.
|
||||
Password:
|
||||
description: The password as used to log in to the Peblar device' local web interface.
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
The above configuration can also be adjusted later via
|
||||
{% my integrations title="**Settings** > **Devices & services**" %},
|
||||
click {% icon "mdi:dots-vertical" %} and select **Reconfigure**.
|
||||
|
||||
## Use cases
|
||||
|
||||
This integration provides all the information about your rock-solid EV charger
|
||||
from Peblar. There are multiple use cases for this integration, such as:
|
||||
|
||||
- Monitoring the charging status of your electric vehicle.
|
||||
- Adding the charger to your Home Assistant energy dashboard, allowing you to
|
||||
monitor the energy consumption of your electric vehicle as part of your home
|
||||
energy usage.
|
||||
- Creating automations, for example:
|
||||
- To notify you when the charging of your electric vehicle is complete.
|
||||
- Turn off solar-only charging when the expected solar production is not
|
||||
sufficient today.
|
||||
- Notify when the charger has detected an error or has raised a warning.
|
||||
- See updates in Home Assistant when there are updates available for your
|
||||
Peblar charger.
|
||||
|
||||
## Supported functionality
|
||||
|
||||
The Peblar integration provides a whole lot of functionality to Home Assistant.
|
||||
All of them are provided as entities in Home Assistant. Below is an overview of
|
||||
the entities provided by this integration.
|
||||
|
||||
### Binary sensors
|
||||
|
||||
The binary sensors provided are used to indicate the health status of the
|
||||
charger. The following binary sensors are available:
|
||||
|
||||
- **Active error**: Indicates if the charger has detected an error. If this
|
||||
sensor is on ({% term state %}: `on`) an error has been detected, otherwise, it is off
|
||||
({% term state %}: `off`).
|
||||
- **Active warning**: Indicates if the charger has raised a warning. If this
|
||||
- sensor is on ({% term state %}: `on`) a warning has been raised, otherwise, it is off
|
||||
({% term state %}: `off`).
|
||||
|
||||
If any of these binary sensors are on, you should check the charger's local
|
||||
web interface for more information about the error or warning.
|
||||
|
||||
{% important %}
|
||||
These binary sensors are disabled by default. If you want to use them, you need
|
||||
to enable first. See the [enabling or disabling entities](/common-tasks/general/#enabling-or-disabling-entities)
|
||||
documentation for information on how to do this.
|
||||
{% endimportant %}
|
||||
|
||||
### Buttons
|
||||
|
||||
The buttons provided by this integration can be used to trigger an action on
|
||||
the charger. The following buttons are available:
|
||||
|
||||
- **Identify**: This button can be used to identify the charger. This can be
|
||||
useful if you have multiple chargers and want to identify which one is which.
|
||||
Once pressed, the LED on the charger will start blinking for a few seconds.
|
||||
- **Restart**: This button can be used to restart the charger. This can be
|
||||
useful if the charger is not responding as expected.
|
||||
|
||||
{% important %}
|
||||
These buttons are disabled by default. If you want to use them, you need
|
||||
to enable first. See the [enabling or disabling entities](/common-tasks/general/#enabling-or-disabling-entities)
|
||||
documentation for information on how to do this.
|
||||
{% endimportant %}
|
||||
|
||||
### Numbers
|
||||
|
||||
This integration provides a singles number entity: **Charge limit**.
|
||||
|
||||
Using this entity, you can set the maximum current the charger can provide to
|
||||
your electric vehicle. The value of this entity is in amperes (A).
|
||||
|
||||
The minimum value for this entity is 6A, and the maximum value is depending on
|
||||
your charger's configuration. The value can be set in increments of 1A.
|
||||
|
||||
### Selects
|
||||
|
||||
This integration provides a single select entity: **Smart charging**.
|
||||
|
||||
It reflects the same smart charging state as is shown on the charger's local
|
||||
web interface, and allows you to control the charging behavior of the charger.
|
||||
|
||||
The following options are available:
|
||||
|
||||
- **Default** ({% term state %}: `default`): The charger will charge the electric vehicle
|
||||
as soon as it is connected.
|
||||
- **Fast solar** ({% term state %}: `fast_solar`): The charger will fast charge the
|
||||
electric vehicle with the overproduction of solar energy, but will also use
|
||||
grid power if the solar production is not sufficient.
|
||||
- **Smart solar** ({% term state %}: `smart_solar`): The charger will charge the electric
|
||||
vehicle with the overproduction of solar energy, but will also use grid power
|
||||
if the solar production is not sufficient.
|
||||
- **Pure solar** ({% term state %}: `solar_only`): The charger will only charge the
|
||||
electric vehicle with the overproduction of solar energy.
|
||||
- **Scheduled** ({% term state %}: `scheduled`): The charger will charge the electric
|
||||
vehicle according to the schedule configured on the charger.
|
||||
|
||||
### Sensors
|
||||
|
||||
The Peblar integration provides a lot of sensors to Home Assistant.
|
||||
|
||||
{% tip %}
|
||||
The ability to add your charger to the Home Assistant energy dashboard is
|
||||
arguably the most useful feature of this integration. It is therefore
|
||||
recommended to add your Peblar charger to the Home Assistant energy dashboard,
|
||||
by adding the **Lifetime energy** sensor to the energy dashboard configuration
|
||||
as a device.
|
||||
{% endtip %}
|
||||
|
||||
- **Current**: The current current (in amperes) the charger is consuming to
|
||||
charge your electric vehicle. This is a combined value for all your phases.
|
||||
Additionally, three additionally sensors are available, if your charging is
|
||||
using multiple phases:
|
||||
- **Current Phase 1**\*\*: The current current (in amperes) the charger is
|
||||
consuming on phase 1.
|
||||
- **Current Phase 2**\*\*: The current current (in amperes) the charger is
|
||||
consuming on phase 2.
|
||||
- **Current Phase 3**\*\*: The current current (in amperes) the charger is
|
||||
consuming on phase 3.
|
||||
- **Lifetime energy**: The total energy (in kilowatt-hours) consumed by the
|
||||
charger since it was installed. **This is the recommended sensor to use in the
|
||||
Home Assistant energy dashboard.**
|
||||
- **Limit source**: The source/origin of the current charging limit that is
|
||||
in effect. The source can be one of the following:
|
||||
- _Charging cable_ ({% term state %}: `charging_cable`): The current limit is
|
||||
the maximum current the charging cable handle.
|
||||
- _Current limiter_ ({% term state %}: `current_limiter`): The current limit is
|
||||
set by the current limiter.
|
||||
- _Dynamic load balancing_ ({% term state %}: `dynamic_load_balancing`): The current
|
||||
limit is set by the dynamic load balancing feature.
|
||||
- _External power limit_ ({% term state %}: `external_power_limit`): The current
|
||||
limit is set by an external power limiter.
|
||||
- _Group load balancing_ ({% term state %}: `group_load_balancing`): The current
|
||||
limit is set by the group load balancing feature, which is a feature that
|
||||
allows multiple chargers to share the available power.
|
||||
- _Hardware limitation_ ({% term state %}: `hardware_limitation`): The current limit
|
||||
is limited by the hardware of the charger that can't provide more current.
|
||||
- _High temperature_ ({% term state %}: `high_temperature`): The current limit is
|
||||
limited due to high temperatures.
|
||||
- _Household power limit_ ({% term state %}: `household_power_limit`): The current
|
||||
limit is set by the household power limit feature, which is a feature that
|
||||
allows the charger to limit the current to prevent overloading the household
|
||||
power.
|
||||
- _Installer limitation_ ({% term state %}: `installer_limitation`): The current
|
||||
limit is set by the installer, for example, to prevent overloading the fuse
|
||||
of the house.
|
||||
- _Local Modbus API_ ({% term state %}: `local_modbus_api`): The current limit is
|
||||
set by software using the local Modbus API.
|
||||
- _Local REST API_ ({% term state %}: `local_rest_api`): The current limit is set
|
||||
by software using the local REST API. Home Assistant uses this API to set
|
||||
the current limit, so if you see this state, it means the current limit is
|
||||
likely set through Home Assistant.
|
||||
- _OCPP smart charging_ ({% term state %}: `ocpp_smart_charging`): The current limit
|
||||
is set by the OCPP smart charging feature.
|
||||
- _Overcurrent protection_ ({% term state %}: `overcurrent_protection`): The current
|
||||
limit is limited due to overcurrent protection.
|
||||
- _Phase imbalance_ ({% term state %}: `phase_imbalance`): The current limit is
|
||||
limited due to phase imbalance in the electrical installation.
|
||||
- _Power factor_ ({% term state %}: `power_factor`): The current limit is limited
|
||||
due to a low power factor in the electrical installation.
|
||||
- _Solar charging_ ({% term state %}: `solar_charging`): The current limit is set
|
||||
by the solar charging feature of the charger. This means the charger is
|
||||
awaiting an overproduction of solar energy to start charging.
|
||||
- **Power**: The current power (in Watts) the charger is consuming to charge
|
||||
your electric vehicle. This is a combined value for all your phases.
|
||||
Additionally, three additionally sensors are available, if your charging is
|
||||
using multiple phases:
|
||||
- **Power Phase 1**\*\*: The current power (in Watts) the charger is consuming
|
||||
on phase 1.
|
||||
- **Power Phase 2**\*\*: The current power (in Watts) the charger is consuming
|
||||
on phase 2.
|
||||
- **Power Phase 3**\*\*: The current power (in Watts) the charger is consuming
|
||||
on phase 3.
|
||||
- **Session energy**: The total energy (in kilowatt-hours) consumed by the
|
||||
charger during the current charging session. This sensor is reset when a
|
||||
new charging session starts. While you could, it is **not** recommended to
|
||||
use this sensor in the Home Assistant energy dashboard. Use the **Lifetime
|
||||
energy** sensor instead.
|
||||
- **State**: The current state of the charger. The state can be one of the
|
||||
following:
|
||||
- _Charging_ ({% term state %}: `charging`): The charger is currently charging the
|
||||
electric vehicle.
|
||||
- _Error_ ({% term state %}: `error`): The charger has detected an error and is
|
||||
currently not charging the electric vehicle.
|
||||
- _Fault_ ({% term state %}: `fault`): The charger has detected a fault and is
|
||||
currently not charging the electric vehicle.
|
||||
- _No EV connected_ ({% term state %}: `no_ev_connected`): The charger is currently not
|
||||
connected to an electric vehicle.
|
||||
- _Suspended_ ({% term state %}: `suspended`): The charger is currently not charging
|
||||
the electric vehicle, but is ready to start charging when needed.
|
||||
- _Invalid_ ({% term state %}: `invalid`): The charger is in an invalid state.
|
||||
- **Uptime**\*\*: The total time the charger has been running since the last
|
||||
restart. This sensor is reset when the charger is restarted.
|
||||
- **Voltage**: The current voltage (in volts) the charger is using to charge.
|
||||
Only available if your charger is connected to a single-phase power source.
|
||||
- **Voltage Phase 1**\*\*: The current voltage (in volts) on phase 1. Only
|
||||
available if your charger is connected to at least a two-phase power source.
|
||||
- **Voltage Phase 2**\*\*: The current voltage (in volts) on phase 2. Only
|
||||
available if your charger is connected to at least a two-phase power source.
|
||||
- **Voltage Phase 3**\*\*: The current voltage (in volts) on phase 3.
|
||||
Only available if your charger is connected to a three-phase power source.
|
||||
|
||||
{% important %}
|
||||
The sensors marked with \*\* are disabled by default. If you want to use them,
|
||||
you need to enable first. See the [enabling or disabling entities](/common-tasks/general/#enabling-or-disabling-entities)
|
||||
documentation for information on how to do this.
|
||||
{% endimportant %}
|
||||
|
||||
### Switches
|
||||
|
||||
This integration provides a single switch entity: **Force single phase**.
|
||||
|
||||
This switch can be used to force the charger to use a single phase for charging
|
||||
your electric vehicle. This can be useful if you want to limit your current
|
||||
draw from the charger to a single phase, for example, to prevent overloading
|
||||
your electrical installation.
|
||||
|
||||
Note that this switch is only available if your charger is connected to multiple
|
||||
phases. If your charger is connected to a single-phase power source, this switch
|
||||
will not be created.
|
||||
|
||||
### Updates
|
||||
|
||||
The Peblar integration provides two update entities for the Pebler charger:
|
||||
|
||||
- **Firmware**: Indicates if there is a firmware update available for the
|
||||
charger. The firmware can be thought of as the operating system of the charger.
|
||||
- **Customization**: Indicates if there is a customization update available for
|
||||
the charger. The customization can be thought as the user interface of the
|
||||
charger that you see when you log in to the charger's local web interface.
|
||||
|
||||
Software updates cannot be installed through Home Assistant. You need to log in
|
||||
to the charger's local web interface to install the updates.
|
||||
|
||||
## Data updates
|
||||
|
||||
This integration is a local polling integration, meaning it will check for
|
||||
changes to all the entities by frequently polling the Peblar charger on your
|
||||
home network.
|
||||
|
||||
There are three different polling frequencies used by this integration:
|
||||
|
||||
- **every 10 seconds**: For all sensors and binary sensors, ensuring you
|
||||
have the latest insights into your electric vehicle's charging status.
|
||||
- **every 5 minutes**: It will check for configuration changes to the charger,
|
||||
this affects all configuration entities, like the smart charging mode and
|
||||
the current limit.
|
||||
- **every 2 hours**: It will check for updates to the charger itself, ensuring
|
||||
you are aware of any updates available for your Peblar charger.
|
||||
|
||||
While this integration uses local polling, configuration changes made to the
|
||||
Peblar charger from Home Assistant will be reflected in the charger almost
|
||||
instantly.
|
||||
|
||||
## Actions
|
||||
|
||||
This integration does not provide additional actions. All actions available
|
||||
for this integration are provided by their respective entities.
|
||||
|
||||
## Examples
|
||||
|
||||
The following examples show how to use the Peblar integration in Home
|
||||
Assistant automations. These examples are just a starting point, and you can
|
||||
use them as inspiration to create your own automations.
|
||||
|
||||
Feel free to contribute more examples to this documentation ❤️.
|
||||
|
||||
### Notify when there is an software update available
|
||||
|
||||
The following example sends a notification to your mobile device when there is
|
||||
a software update available for your Peblar charger.
|
||||
|
||||
```yaml
|
||||
automation:
|
||||
- alias: "Peblar software update available"
|
||||
triggers:
|
||||
- trigger: state
|
||||
entity_id: sensor.peblar_firmware
|
||||
from: "off"
|
||||
to: "on"
|
||||
|
||||
actions:
|
||||
- action: notify.mobile_app_your_device
|
||||
data:
|
||||
title: "Peblar charger update available!"
|
||||
message: >
|
||||
There is a software update available for your Peblar charger.
|
||||
Please log in to the charger's local web interface to install the
|
||||
update.
|
||||
```
|
||||
|
||||
### Notify when an issue is detected
|
||||
|
||||
The following example automation will send out a notification when the charger
|
||||
detects an error or raises a warning.
|
||||
|
||||
```yaml
|
||||
automation:
|
||||
- alias: "Peblar software update available"
|
||||
triggers:
|
||||
- trigger: state
|
||||
entity_id:
|
||||
- binary_sensor.peblar_active_error
|
||||
- binary_sensor.peblar_active_warning
|
||||
from: "off"
|
||||
to: "on"
|
||||
- trigger: state
|
||||
entity_id: sensor.peblar_state
|
||||
to:
|
||||
- "error"
|
||||
- "fault"
|
||||
|
||||
actions:
|
||||
- action: notify.mobile_app_your_device
|
||||
data:
|
||||
title: "Peblar charger issue detected!"
|
||||
message: >
|
||||
An issue with your Peblar charger has been detected. Please check
|
||||
the charger's local web interface for more information.
|
||||
```
|
||||
|
||||
## Known limitations
|
||||
|
||||
Not all functionality of the Peblar charger is available through this
|
||||
integration. The following limitations are known:
|
||||
|
||||
- The Peblar APIs currently aren't communicating the charger is awaiting
|
||||
authentication (for example, using an RFID card) before it can start
|
||||
charging. As a result, you will see an suspended charging status in Home
|
||||
Assistant, while the charger is awaiting authentication.
|
||||
- Home Assistant uses and manages the charger's REST API. This means that
|
||||
the use of this integration will enable the REST API on the charger
|
||||
automatically. It is possible to use the REST API directly in parallel
|
||||
with this integration.
|
||||
- Peblar is also sold as white-label products, like the [CoolBlue BlueBuilt](https://www.coolblue.nl/en/charging-stations/our-charging-stations).
|
||||
This integration is tested with the Peblar branded products, and it is unknown
|
||||
if it works with white-label products.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
There are no commonly known issues with this integration.
|
||||
|
||||
## Removing the integration
|
||||
|
||||
This integration follows standard integration removal. No extra steps are
|
||||
required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
@ -2,7 +2,9 @@
|
||||
title: Pinecil
|
||||
description: Connect and control your Pinecil devices using the IronOS integration
|
||||
ha_category:
|
||||
- Binary sensor
|
||||
- Number
|
||||
- Select
|
||||
- Sensor
|
||||
- Update
|
||||
ha_release: 2024.8
|
||||
@ -14,7 +16,9 @@ ha_codeowners:
|
||||
- '@tr4nt0r'
|
||||
ha_config_flow: true
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- number
|
||||
- select
|
||||
- sensor
|
||||
- update
|
||||
ha_iot_class: Local Polling
|
||||
|
90
source/_integrations/powerfox.markdown
Normal file
90
source/_integrations/powerfox.markdown
Normal file
@ -0,0 +1,90 @@
|
||||
---
|
||||
title: Powerfox
|
||||
description: Instructions on how to integrate Powerfox within Home Assistant.
|
||||
ha_category:
|
||||
- Energy
|
||||
- Sensor
|
||||
ha_release: 2025.1
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@klaasnicolaas'
|
||||
ha_domain: powerfox
|
||||
ha_platforms:
|
||||
- diagnostics
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
ha_quality_scale: silver
|
||||
ha_zeroconf: true
|
||||
---
|
||||
|
||||
The **Powerfox** {% term integration %} allows you to gather data from your [Poweropti](https://shop.powerfox.energy/collections/frontpage) devices, by using their cloud API and fetch the data in Home Assistant.
|
||||
|
||||
[Powerfox](https://www.powerfox.energy/) is a German company that provides smart meters (Poweropti) for reading electricity, water, gas, and heat. They have their own cloud platform where you can monitor the usage of your devices and get insights into your energy consumption.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
### Configuration parameters
|
||||
|
||||
{% configuration_basic %}
|
||||
Email:
|
||||
description: The email address of your Powerfox account.
|
||||
Password:
|
||||
description: The password of your Powerfox account.
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
## Poweropti devices
|
||||
|
||||
Not all Poweropti devices are supported currently. Check the list below to see if your device is working with this integration. Create a [feature request](/help/) if your device is not supported yet.
|
||||
|
||||
| Device | Type | Supported |
|
||||
| --------------------- | ----------- | ---------- |
|
||||
| PA 201901 / PA 201902 | Power meter | Yes |
|
||||
| PB 202001 | Power meter | Not tested |
|
||||
| WA 201902 | Water meter | Yes |
|
||||
| Powerfox FLOW | Gas meter | No |
|
||||
| HA 201902 | Heat meter | No |
|
||||
|
||||
## Data updates
|
||||
|
||||
The integration will update its information by polling Powerfox every
|
||||
minute. This ensures the data in Home Assistant is up to date.
|
||||
|
||||
## Actions
|
||||
|
||||
This integration does not provide additional actions.
|
||||
|
||||
## Supported functionality
|
||||
|
||||
The Powerfox platform mainly provides sensors that you can use in your [energy dashboard](/energy).
|
||||
|
||||
### Power meter
|
||||
|
||||
It will create the following sensors:
|
||||
|
||||
- **Power (W)**: Active power that is measured.
|
||||
- **Energy usage (kWh)**: How much energy is used since the installation.
|
||||
- **Energy usage - low tariff (kWh)**: Energy usage on the low tariff.
|
||||
- **Energy usage - high tariff (kWh)**: Energy usage on the high tariff.
|
||||
- **Energy returned (kWh)**: Energy returned to the grid.
|
||||
|
||||
{% note %}
|
||||
The energy tariff sensors are only available if your Poweropti device supports it.
|
||||
{% endnote %}
|
||||
|
||||
### Water meter
|
||||
|
||||
It will create the following sensors:
|
||||
|
||||
- **Cold water (m³)**: How much cold water is used.
|
||||
- **Warm water (m³)**: How much warm water is used.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
There are no commonly known issues with this integration.
|
||||
|
||||
## Remove integration
|
||||
|
||||
This integration follows standard integration removal. No extra steps are required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
@ -21,6 +21,7 @@ ha_platforms:
|
||||
- select
|
||||
- sensor
|
||||
ha_integration_type: hub
|
||||
ha_quality_scale: silver
|
||||
---
|
||||
|
||||
The Renault integration offers integration with the **MyRenault** cloud service and provides sensors such as charger state and temperature.
|
||||
|
@ -1,5 +1,5 @@
|
||||
---
|
||||
title: Reolink IP NVR/camera
|
||||
title: Reolink
|
||||
description: Instructions on how to integrate Reolink devices (NVR/cameras) into Home Assistant.
|
||||
ha_category:
|
||||
- Camera
|
||||
@ -26,6 +26,7 @@ ha_platforms:
|
||||
- update
|
||||
ha_integration_type: integration
|
||||
ha_dhcp: true
|
||||
ha_quality_scale: platinum
|
||||
related:
|
||||
- docs: /dashboards/picture-glance/#creating-a-card-to-control-the-camera
|
||||
title: Controlling the camera from the dashboard
|
||||
|
@ -41,15 +41,13 @@ There is currently support for the following device types within Home Assistant:
|
||||
- [Camera](#camera)
|
||||
- [Saving the videos captured by your Ring Door Bell](#saving-the-videos-captured-by-your-ring-door-bell)
|
||||
- [Event](#event)
|
||||
- [Realtime event stability](#realtime-event-stability)
|
||||
- [Sensor](#sensor)
|
||||
- [Siren](#siren)
|
||||
- [Switch](#switch)
|
||||
- [Light](#light)
|
||||
- [Number](#number)
|
||||
|
||||
{% note %}
|
||||
This integration does NOT allow for live viewing of your Ring camera within Home Assistant.
|
||||
{% endnote %}
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
@ -65,22 +63,26 @@ Once you have enabled the [Ring integration](/integrations/ring), you can start
|
||||
|
||||
## Camera
|
||||
|
||||
{% important %}
|
||||
Please note that downloading and playing Ring video will require a Ring Protect plan.
|
||||
{% endimportant %}
|
||||
Once you have enabled the [Ring integration](/integrations/ring), you can start using the camera platform.
|
||||
Currently, it supports doorbells and stickup cameras.
|
||||
Two camera entities are provided: `live_view` and `last_recording`.
|
||||
`last_recording` is disabled by default.
|
||||
|
||||
Once you have enabled the [Ring integration](/integrations/ring), you can start using the camera platform. Currently, it supports doorbell and stickup cameras.
|
||||
{% important %}
|
||||
Please note that downloading and playing Ring video from the `last_recording` camera will require a Ring Protect plan.
|
||||
{% endimportant %}
|
||||
|
||||
### Saving the videos captured by your Ring Door Bell
|
||||
|
||||
You can save locally the latest video captured by your Ring Door Bell using the [downloader](/integrations/downloader) along with either an [automation](/integrations/automation) or [python_script](/integrations/python_script). First, enable the [downloader](/integrations/downloader) integration in your configuration by adding the following to your `configuration.yaml`.
|
||||
You can save locally the latest video captured by your Ring Door Bell using the [downloader](/integrations/downloader) along with either an [automation](/integrations/automation) or [python_script](/integrations/python_script).
|
||||
First, enable the [downloader](/integrations/downloader) integration in your configuration by adding the following to your `configuration.yaml`.
|
||||
|
||||
```yaml
|
||||
downloader:
|
||||
download_dir: downloads
|
||||
```
|
||||
|
||||
Then you can use the following automation, with the entities from your system, which will save the video file under `<config>/downloads/<camera_name>/<camera_name>/`:
|
||||
Then you can use the following automation, with the entities from your system, which will save the video file under `<config>/downloads/<camera_name>/<camera_name>.mp4`:
|
||||
|
||||
{% raw %}
|
||||
|
||||
@ -89,14 +91,20 @@ automation:
|
||||
alias: "Save the video when the doorbell is pushed"
|
||||
triggers:
|
||||
- trigger: state
|
||||
entity_id: binary_sensor.front_doorbell_ding
|
||||
to: "on"
|
||||
entity_id: event.front_doorbell_ding
|
||||
from: null
|
||||
actions:
|
||||
- delay:
|
||||
hours: 0
|
||||
minutes: 5
|
||||
seconds: 0
|
||||
milliseconds: 0
|
||||
- action: downloader.download_file
|
||||
data:
|
||||
url: "{{ state_attr('camera.front_door', 'video_url') }}"
|
||||
subdir: "{{state_attr('camera.front_door', 'friendly_name')}}"
|
||||
filename: "{{state_attr('camera.front_door', 'friendly_name')}}"
|
||||
overwrite: true
|
||||
url: "{{ state_attr('camera.front_door_last_recording', 'video_url') }}"
|
||||
subdir: "{{state_attr('camera.front_door_last_recording', 'friendly_name')}}"
|
||||
filename: "{{state_attr('camera.front_door_last_recording', 'friendly_name')}}.mp4"
|
||||
```
|
||||
|
||||
{% endraw %}
|
||||
@ -106,8 +114,8 @@ You may consider some modifications in the subdirectory and the filename to suit
|
||||
{% raw %}
|
||||
```yaml
|
||||
data:
|
||||
url: "{{ state_attr('camera.front_door', 'video_url') }}"
|
||||
subdir: "{{ state_attr('camera.front_door', 'friendly_name') }}/{{ now().strftime('%Y.%m') }}"
|
||||
url: "{{ state_attr('camera.front_door_last_recording', 'video_url') }}"
|
||||
subdir: "{{ state_attr('camera.front_door_last_recording', 'friendly_name') }}/{{ now().strftime('%Y.%m') }}"
|
||||
filename: "{{ now().strftime('%Y-%m-%d-at-%H-%M-%S') }}.mp4"
|
||||
```
|
||||
{% endraw %}
|
||||
@ -125,7 +133,7 @@ You can then use the following `python_script` to save the video file:
|
||||
```python
|
||||
# obtain ring doorbell camera object
|
||||
# replace the camera.front_door by your camera entity
|
||||
ring_cam = hass.states.get("camera.front_door")
|
||||
ring_cam = hass.states.get("camera.front_door_last_recording")
|
||||
|
||||
subdir_name = f"ring_{ring_cam.attributes.get('friendly_name')}"
|
||||
|
||||
|
@ -7,11 +7,13 @@ ha_release: 0.49
|
||||
ha_iot_class: Local Push
|
||||
ha_domain: russound_rio
|
||||
ha_platforms:
|
||||
- diagnostics
|
||||
- media_player
|
||||
ha_codeowners:
|
||||
- '@noahhusby'
|
||||
ha_config_flow: true
|
||||
ha_integration_type: integration
|
||||
ha_quality_scale: silver
|
||||
---
|
||||
|
||||
The Russound RIO {% term integration %} allows you to control Russound devices that make use of the RIO protocol.
|
||||
|
@ -17,6 +17,7 @@ ha_platforms:
|
||||
- number
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
ha_quality_scale: bronze
|
||||
---
|
||||
|
||||
The SABnzbd integration will allow you to monitor and control your downloads with [SABnzbd](https://sabnzbd.org) from within Home Assistant and setup automations based on the information.
|
||||
@ -72,4 +73,4 @@ This integration will create a number entity to set the download queue speed lim
|
||||
|
||||
This integration follows standard integration removal. No extra steps are required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
||||
{% include integrations/remove_device_service.md %}
|
||||
|
@ -62,8 +62,8 @@ The following device classes are supported for sensors:
|
||||
- **date**: Date string (ISO 8601)
|
||||
- **distance**: Generic distance in km, m, cm, mm, mi, nmi, yd, or in
|
||||
- **duration**: Duration in d, h, min, s, or ms
|
||||
- **energy**: Energy in J, kJ, MJ, GJ, Wh, kWh, MWh, cal, kcal, Mcal, or Gcal
|
||||
- **energy_storage**: Stored energy in J, kJ, MJ, GJ, Wh, kWh, MWh, cal, kcal, Mcal, or Gcal
|
||||
- **energy**: Energy in J, kJ, MJ, GJ, mWh, Wh, kWh, MWh, GWh, TWh, cal, kcal, Mcal, or Gcal
|
||||
- **energy_storage**: Stored energy in J, kJ, MJ, GJ, mWh, Wh, kWh, MWh, GWh, TWh, cal, kcal, Mcal, or Gcal
|
||||
- **enum**: Has a limited set of (non-numeric) states
|
||||
- **frequency**: Frequency in Hz, kHz, MHz, or GHz
|
||||
- **gas**: Gasvolume in m³, ft³ or CCF
|
||||
@ -81,7 +81,7 @@ The following device classes are supported for sensors:
|
||||
- **pm25**: Concentration of particulate matter less than 2.5 micrometers in µg/m³
|
||||
- **pm10**: Concentration of particulate matter less than 10 micrometers in µg/m³
|
||||
- **power_factor**: Power factor (unitless), unit may be `None` or %
|
||||
- **power**: Power in W, kW, MW, GW or TW
|
||||
- **power**: Power in mW, W, kW, MW, GW or TW
|
||||
- **precipitation**: Accumulated precipitation in cm, in or mm
|
||||
- **precipitation_intensity**: Precipitation intensity in in/d, in/h, mm/d or mm/h
|
||||
- **pressure**: Pressure in Pa, kPa, hPa, bar, cbar, mbar, mmHg, inHg or psi
|
||||
|
@ -1,109 +0,0 @@
|
||||
---
|
||||
title: Simulated
|
||||
description: Integration for simulating a numerical sensor.
|
||||
ha_category:
|
||||
- Sensor
|
||||
- Utility
|
||||
ha_iot_class: Local Polling
|
||||
ha_release: 0.65
|
||||
ha_quality_scale: internal
|
||||
ha_domain: simulated
|
||||
ha_platforms:
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
---
|
||||
|
||||
{% warning %}
|
||||
The `simulated` integration has been deprecated and will be removed in 2025.1
|
||||
{% endwarning %}
|
||||
|
||||
The `simulated` sensor platform provides a simulated sensor that generates a time-varying signal `V(t)` given by the [function](https://en.wikipedia.org/wiki/Sine_wave):
|
||||
|
||||
```text
|
||||
V(t) = M + A sin((2 pi (t - t_0) / w) + P) + N(s)
|
||||
```
|
||||
|
||||
where:
|
||||
|
||||
- **M** = the [mean](https://en.wikipedia.org/wiki/Mean) value of the sensor
|
||||
- **A** = the [amplitude](https://en.wikipedia.org/wiki/Amplitude) of the periodic contribution
|
||||
- **t** = the time when a value is generated
|
||||
- **t_0** = the time when the sensor is started
|
||||
- **w** = the time [period](https://en.wikipedia.org/wiki/Periodic_function) in seconds for a single complete cycle of the periodic contribution
|
||||
- **P** = the [phase](https://en.wikipedia.org/wiki/Phase_(waves)) offset to add to the periodic contribution, in units of degrees
|
||||
- **N(s)** = the random [Gaussian noise](https://en.wikipedia.org/wiki/Gaussian_noise) with spread **s**
|
||||
|
||||
The output will be limited to 3 decimals.
|
||||
|
||||
## Configuration
|
||||
|
||||
To add a simulated sensor to your installation, add the following to your {% term "`configuration.yaml`" %} file:
|
||||
|
||||
```yaml
|
||||
sensor:
|
||||
- platform: simulated
|
||||
```
|
||||
|
||||
{% configuration %}
|
||||
name:
|
||||
description: The name of the sensor.
|
||||
required: false
|
||||
default: simulated
|
||||
type: string
|
||||
unit:
|
||||
description: The unit to apply.
|
||||
required: false
|
||||
default: value
|
||||
type: string
|
||||
amplitude:
|
||||
description: The amplitude of periodic contribution.
|
||||
required: false
|
||||
default: 1
|
||||
type: float
|
||||
mean:
|
||||
description: The mean level of the sensor.
|
||||
required: false
|
||||
default: 0
|
||||
type: float
|
||||
period:
|
||||
description: The time in seconds for one complete oscillation of the periodic contribution.
|
||||
required: false
|
||||
default: 0
|
||||
type: integer
|
||||
phase:
|
||||
description: The phase offset (in degrees) to apply to the periodic component.
|
||||
required: false
|
||||
default: 0
|
||||
type: float
|
||||
seed:
|
||||
description: The [seed](https://docs.python.org/3.6/library/random.html#random.seed) value for the random noise component.
|
||||
required: false
|
||||
default: 999
|
||||
type: integer
|
||||
spread:
|
||||
description: The spread is the range of the randomly distributed values about their mean. This is sometimes referred to as the Full Width at Half Maximum ([FWHM](https://en.wikipedia.org/wiki/Full_width_at_half_maximum)) of the random distribution.
|
||||
required: false
|
||||
default: None
|
||||
type: float
|
||||
relative_to_epoch:
|
||||
description: Whether to simulate from epoch time (00:00:00, 1970-01-01), or relative to when the sensor was started.
|
||||
required: false
|
||||
default: true
|
||||
type: boolean
|
||||
{% endconfiguration %}
|
||||
|
||||
## Example
|
||||
|
||||
To give an example of simulating real world data, a simulated relative humidity sensor (in %) can be added using the following configuration:
|
||||
|
||||
```yaml
|
||||
sensor:
|
||||
- platform: simulated
|
||||
name: "simulated relative humidity"
|
||||
unit: "%"
|
||||
amplitude: 0 # Turns off the periodic contribution
|
||||
mean: 50
|
||||
spread: 10
|
||||
seed: 999
|
||||
relative_to_epoch: false
|
||||
```
|
84
source/_integrations/slide_local.markdown
Normal file
84
source/_integrations/slide_local.markdown
Normal file
@ -0,0 +1,84 @@
|
||||
---
|
||||
title: Slide Local
|
||||
description: Instructions on how to integrate the Innovation in Motion Slide covers with Home Assistant.
|
||||
ha_category:
|
||||
- Cover
|
||||
ha_iot_class: Local Polling
|
||||
ha_release: 2025.1
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@dontinelli'
|
||||
ha_domain: slide_local
|
||||
ha_platforms:
|
||||
- button
|
||||
- cover
|
||||
- diagnostics
|
||||
- switch
|
||||
ha_integration_type: device
|
||||
ha_zeroconf: true
|
||||
ha_quality_scale: gold
|
||||
---
|
||||
|
||||
The Slide Local {% term integration %} allows you to integrate your [Slide](https://slide.store/) devices in Home Assistant using the local API.
|
||||
|
||||
## Supported devices
|
||||
|
||||
The integration should work with all Slide covers (API version 1 and 2).
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Before you can use the integration, you have to make sure the slide is configured for the local API. By default, the Slide connects to the cloud API, but it is possible to use the local API, too (only one of them can be active). To switch between the cloud and local API, do the following:
|
||||
|
||||
Press the reset button 2x
|
||||
|
||||
LED flashes 5x fast: cloud API disabled, local API enabled
|
||||
LED flashes 2x slow: local API disabled, cloud API enabled
|
||||
|
||||

|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
To setup the integration you need the following information:
|
||||
|
||||
{% configuration_basic %}
|
||||
hostname:
|
||||
description: Hostname or IP of the slide device.
|
||||
password:
|
||||
description: The device code of your Slide (inside of your Slide or in the box, 8 characters). Only required for API 1, with API 2 you can fill in anything here.
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
{% include integrations/option_flow.md %}
|
||||
|
||||
{% configuration_basic %}
|
||||
Invert position:
|
||||
description: Check the box, if your cover uses inverted positions for open and closed.
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
## Supported functionality
|
||||
|
||||
### Cover
|
||||
|
||||
Your slide device will appear as cover.
|
||||
|
||||
### Button
|
||||
|
||||
You can start the calibration sequence for your slide by pushing on the Calibration button.
|
||||
|
||||
### Switch
|
||||
|
||||
You can enable/disable the Touch&Go functionality (open/close cover by a short pull on the cover) by using the TouchGo switch.
|
||||
|
||||
## Data updates
|
||||
|
||||
The integration fetches data from the device every 15 seconds.
|
||||
|
||||
## Known limitations
|
||||
|
||||
The integration only provides connection with Slide devices via the local API. For connecting via the cloud API, please use the [Slide](./slide) integration.
|
||||
|
||||
|
||||
## Remove integration
|
||||
|
||||
This integration can be removed by following these steps:
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
@ -41,6 +41,10 @@ The Starlink integration allows you to integrate your [Starlink](https://www.sta
|
||||
- Uplink throughput - The amount of data being uploaded through Starlink
|
||||
- Downlink throughput - The amount of data being downloaded through Starlink
|
||||
- Last boot time - The time Starlink was last turned on
|
||||
- Upload - Total number of bytes uploaded from the user terminal since reboot
|
||||
- Download - Total number of bytes downloaded to the user terminal since reboot
|
||||
- Power - Last measured power [W]
|
||||
- Energy - Measured energy consumption since reboot [kWh]
|
||||
|
||||
### Binary sensor
|
||||
|
||||
|
@ -10,6 +10,7 @@ ha_release: '0.30'
|
||||
ha_quality_scale: internal
|
||||
ha_codeowners:
|
||||
- '@ThomDietrich'
|
||||
- '@gjohansson-ST'
|
||||
ha_domain: statistics
|
||||
ha_config_flow: true
|
||||
ha_platforms:
|
||||
|
@ -1,22 +0,0 @@
|
||||
---
|
||||
title: RIVM Stookalert
|
||||
description: Instructions on how to use Stookalert data within Home Assistant
|
||||
ha_category:
|
||||
- Binary sensor
|
||||
- Environment
|
||||
ha_release: 0.104
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_codeowners:
|
||||
- '@fwestenberg'
|
||||
- '@frenck'
|
||||
ha_domain: stookalert
|
||||
ha_config_flow: true
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- diagnostics
|
||||
ha_integration_type: service
|
||||
---
|
||||
|
||||
The Stookalert integration queries the [RIVM Stookalert](https://www.rivm.nl/stookalert) API for unfavorable weather conditions or poor air quality. With a Stookalert, the RIVM calls on people not to burn wood. This can prevent health problems in people in the area.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
@ -13,6 +13,7 @@ ha_domain: suez_water
|
||||
ha_platforms:
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
ha_quality_scale: bronze
|
||||
---
|
||||
|
||||
The **Suez Water** {% term integration %} fetches your water consumption data from the French water provider [Tout Sur Mon Eau](https://www.toutsurmoneau.fr) website.
|
||||
|
@ -66,6 +66,9 @@ Some SwitchBot devices need to be configured within the app before being control
|
||||
- [Lock Pro (WoLockPro)](https://www.switch-bot.com/pages/switchbot-lock-pro)
|
||||
- [Blind Tilt (WoBlindTilt)](https://switch-bot.com/pages/switchbot-blind-tilt)
|
||||
- [Hub 2 (WoHub2)](https://switch-bot.com/pages/switchbot-hub-2) (currently only supports retrieving sensor data, does not yet support device control)
|
||||
- [Relay Switch 1](https://www.switch-bot.com/products/switchbot-relay-switch-1)
|
||||
- [Relay Switch 1PM](https://www.switch-bot.com/products/switchbot-relay-switch-1pm)
|
||||
- [Water Leak Detector](https://www.switch-bot.com/products/switchbot-water-leak-detector)
|
||||
|
||||
## SwitchBot Entity
|
||||
|
||||
@ -78,11 +81,11 @@ There are three attributes available on the SwitchBot entity to give you more in
|
||||
|
||||
- `Retry count`: How many times to retry sending commands to your SwitchBot devices.
|
||||
|
||||
## SwitchBot Lock / SwitchBot Lock Pro
|
||||
## SwitchBot Lock / SwitchBot Lock Pro / Relay Switch 1 / Relay Switch 1PM
|
||||
|
||||
The integration currently only uses the primary lock state; in dual lock mode, not all things might work properly.
|
||||
|
||||
A SwitchBot lock can be set up in Home Assistant in two different ways. You can enter the key id and encryption key yourself, or Home Assistant can import them from your SwitchBot account.
|
||||
A SwitchBot lock and relay switch can be set up in Home Assistant in two different ways. You can enter the key id and encryption key yourself, or Home Assistant can import them from your SwitchBot account.
|
||||
|
||||
### SwitchBot account (recommended)
|
||||
|
||||
|
@ -52,6 +52,8 @@ Please note, device names configured in the SwitchBot app are transferred into H
|
||||
- Outdoor Meter
|
||||
- Vacuum K10+, K10+ pro, S1, S1 Plus
|
||||
- Hub 2
|
||||
- Relay Switch 1
|
||||
- Relay Switch 1PM
|
||||
|
||||
## Important considerations
|
||||
|
||||
|
@ -18,7 +18,7 @@ ha_release: 2024.8
|
||||
ha_iot_class: Cloud Polling
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- "@Bre77"
|
||||
- '@Bre77'
|
||||
ha_domain: tesla_fleet
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
@ -36,30 +36,34 @@ ha_platforms:
|
||||
ha_integration_type: integration
|
||||
---
|
||||
|
||||
The Tesla Fleet API {% term integration %} exposes various sensors from Tesla vehicles and energy sites.
|
||||
The Tesla Fleet API {% term integration %} exposes various sensors from Tesla vehicles and energy sites using the [Tesla Fleet API](https://developer.tesla.com/).
|
||||
|
||||
## Prerequisites
|
||||
|
||||
You must have a [Tesla](https://tesla.com) account and a Tesla vehicle, PowerWall, Solar, or Wall Connector, and must not have disabled the [My Home Assistant](/integrations/my/) integration.
|
||||
You must have a [Tesla](https://tesla.com) account, and a [Developer Application](https://developer.tesla.com/en_AU/dashboard).
|
||||
|
||||
{% details "Use a custom OAuth application" %}
|
||||
### Developer Application
|
||||
|
||||
The integration has a built-in OAuth application that will be suitable for most users. However, you can [create your own application](https://developer.tesla.com/docs/fleet-api/getting-started/what-is-fleet-api#step-2-create-an-application) for the Tesla Fleet API and configure it as an [application credential](https://my.home-assistant.io/redirect/application_credentials).
|
||||
You must [create your own application](https://developer.tesla.com/docs/fleet-api/getting-started/what-is-fleet-api#step-2-create-an-application) for the Tesla Fleet API and configure it as an [application credential](https://my.home-assistant.io/redirect/application_credentials).
|
||||
When creating the application, you must set the redirect URL to `https://my.home-assistant.io/redirect/oauth`, but the other URLs can be set as desired. You must also complete both [step 3](https://developer.tesla.com/docs/fleet-api/getting-started/what-is-fleet-api#step-3-generate-a-public-private-key-pair) and [step 4](https://developer.tesla.com/docs/fleet-api/getting-started/what-is-fleet-api#step-4-call-the-register-endpoint) before the application will be able to make API calls.
|
||||
|
||||
You will be prompted to pick your custom application credential when creating a Tesla Fleet config entry.
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
## Scopes
|
||||
|
||||
When connecting your Tesla account to Home Assistant, you **must** select the `Vehicle Information` or `Energy Product Information` scope. It is recommended you select all scopes for full functionality.
|
||||
When connecting your Tesla account to Home Assistant, you **must** select the `Vehicle Information` or `Energy Product Information` scope. It is recommended you select all scopes for full functionality. The `Vehicle Location` scope was added in Home Assistant 2024.1, so any authorizations performed on previous releases that want this scope will need to be [modified](https://accounts.tesla.com/en_au/account-settings/security?tab=tpty-apps).
|
||||
|
||||
## Rate limits
|
||||
## Pay per use
|
||||
|
||||
Previously, Tesla restricted this integration to a very modest rate limit. However, from January 2025, accounts in eligible countries will be charged for every API call. Here's what you need to know:
|
||||
|
||||
Tesla restricts open-source integrations to the ["Discovery" plan](https://developer.tesla.com/docs/fleet-api/getting-started/subscription-plans) which only allows for 200 vehicle data requests per day. The integration will initially poll every 90 seconds, making vehicle data requests only when the vehicle is awake, and then dynamically slow down polling based on how many vehicle data requests have been made in the last 24 hours.
|
||||
- Tesla provides a $10 credit per developer account per calandar month
|
||||
- Every vehicle coordinator refresh, vehicle command, and wake up has a cost
|
||||
- This credit only allows for a maximum of 5000 coordinator refreshes
|
||||
- Energy product APIs are free to use at this time
|
||||
- To go beyond the free credit, you must provide payment details to Tesla
|
||||
|
||||
For more details please see [developer.tesla.com](https://developer.tesla.com).
|
||||
|
||||
## Command signing
|
||||
|
||||
|
@ -4,6 +4,7 @@ description: Instructions on integrating TP-Link Smart Home Devices to Home Assi
|
||||
ha_category:
|
||||
- Binary sensor
|
||||
- Button
|
||||
- Camera
|
||||
- Climate
|
||||
- Fan
|
||||
- Hub
|
||||
@ -24,6 +25,7 @@ ha_domain: tplink
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- button
|
||||
- camera
|
||||
- climate
|
||||
- diagnostics
|
||||
- fan
|
||||
@ -53,14 +55,19 @@ See [Supported Devices in python-kasa](https://python-kasa.readthedocs.io/en/sta
|
||||
Devices not listed below may work but if you encounter issues submit a bug report to [python-kasa](https://github.com/python-kasa/python-kasa).
|
||||
|
||||
{% note %}
|
||||
The hub attached Tapo buttons S200B and S200D do not currently support alerting when the button is pressed.
|
||||
The hub attached Tapo buttons S200B and S200D, which do not currently support alerting when the button is pressed.
|
||||
{% endnote %}
|
||||
|
||||
{% note %}
|
||||
Some firmware versions of Tapo Cameras will not authenticate unless you enable **Tapo Lab** > **Third-Party Compatibility** in the native Tapo app.
|
||||
Alternatively, you can factory reset and then prevent the device from accessing the internet.
|
||||
{% endnote %}
|
||||
|
||||
### Supported Kasa devices
|
||||
|
||||
- **Plugs**: EP10, EP25[^1], HS100[^2], HS103, HS105, HS110, KP100, KP105, KP115, KP125, KP125M[^1], KP401
|
||||
- **Power Strips**: EP40, EP40M[^1], HS107, HS300, KP200, KP303, KP400
|
||||
- **Wall Switches**: ES20M, HS200[^2], HS210, HS220[^2], KP405, KS200M, KS205[^1], KS220, KS220M, KS225[^1], KS230, KS240[^1]
|
||||
- **Wall Switches**: ES20M, HS200[^2], HS210, HS220[^2], KP405, KS200, KS200M, KS205[^1], KS220, KS220M, KS225[^1], KS230, KS240[^1]
|
||||
- **Bulbs**: KL110, KL120, KL125, KL130, KL135, KL50, KL60, LB110
|
||||
- **Light Strips**: KL400L5, KL420L5, KL430
|
||||
- **Hubs**: KH100[^1]
|
||||
@ -69,23 +76,28 @@ The hub attached Tapo buttons S200B and S200D do not currently support alerting
|
||||
### Supported Tapo[^1] devices
|
||||
|
||||
- **Plugs**: P100, P110, P110M, P115, P125M, P135, TP15
|
||||
- **Power Strips**: P300, P304M, TP25
|
||||
- **Power Strips**: P210M, P300, P304M, P306, TP25
|
||||
- **Wall Switches**: S500D, S505, S505D
|
||||
- **Bulbs**: L510B, L510E, L530E, L630
|
||||
- **Light Strips**: L900-10, L900-5, L920-5, L930-5
|
||||
- **Cameras**: C210, TC65
|
||||
- **Cameras**: C100, C210, C225, C325WB, C520WS, TC65, TC70
|
||||
- **Hubs**: H100, H200
|
||||
- **Hub-Connected Devices[^3]**: S200B, S200D, T100, T110, T300, T310, T315
|
||||
|
||||
|
||||
[^1]: Requires authentication
|
||||
[^2]: Newer versions require authentication
|
||||
[^1]: Model requires authentication
|
||||
[^2]: Newer versions require authentication
|
||||
[^3]: Devices may work across TAPO/KASA branded hubs
|
||||
|
||||
## Unavailable entities
|
||||
|
||||
Some entities might be showing as Unavailable if they have been removed from the integration.
|
||||
|
||||
## Cameras
|
||||
|
||||
Only Tapo cameras are currently supported.
|
||||
In order for live view to work, you will need to enable your camera account in the Tapo App > **Advanced Settings** > **Camera Account**.
|
||||
If you do not want to do this, keep **Live view** unchecked when adding the device.
|
||||
|
||||
### Total consumption
|
||||
|
||||
This entity is only reported by older kasa devices.
|
||||
|
@ -4,6 +4,7 @@ description: Connect and control your Tapo devices using the TP-Link Smart Home
|
||||
ha_category:
|
||||
- Binary sensor
|
||||
- Button
|
||||
- Camera
|
||||
- Climate
|
||||
- Fan
|
||||
- Hub
|
||||
@ -26,6 +27,7 @@ ha_config_flow: true
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- button
|
||||
- camera
|
||||
- climate
|
||||
- diagnostics
|
||||
- fan
|
||||
|
@ -56,7 +56,7 @@ Possible events are:
|
||||
- `transmission_started_torrent`
|
||||
- `transmission_removed_torrent`
|
||||
|
||||
Inside of the event, there is the name of the torrent that is started or completed, as it is seen in the Transmission User Interface.
|
||||
Inside the event, there is the name of the torrent that is started or completed and the path where the files are downloaded, as seen in the Transmission User Interface.
|
||||
|
||||
Example of an automation that notifies on successful download and removes the torrent from the client:
|
||||
|
||||
@ -71,7 +71,7 @@ Example of an automation that notifies on successful download and removes the to
|
||||
- action: notify.telegram_notifier
|
||||
data:
|
||||
title: "Torrent completed!"
|
||||
message: "{{trigger.event.data.name}}"
|
||||
message: "{{trigger.event.data.name}} downloaded to {{trigger.event.data.download_path}}"
|
||||
- action: transmission.remove_torrent
|
||||
data:
|
||||
entry_id: eeb52bc78e11d813a1e6bc68c8ff93c8
|
||||
@ -92,6 +92,7 @@ Adds a new torrent to download. It can either be a URL (HTTP, HTTPS or FTP), mag
|
||||
| ---------------------- | -------- | ------------------------ |
|
||||
| `entry_id` | no | The integration entry_id |
|
||||
| `torrent` | no | Torrent to download |
|
||||
| `download_path` | yes | Absolute path to the download directory. If not specified, the Transmission's default directory will be used. |
|
||||
|
||||
### Action `remove_torrent`
|
||||
|
||||
|
@ -16,6 +16,7 @@ ha_platforms:
|
||||
- diagnostics
|
||||
- sensor
|
||||
ha_integration_type: service
|
||||
ha_quality_scale: silver
|
||||
---
|
||||
|
||||
The Twente Milieu {% term integration %} enables you to monitor the upcoming
|
||||
|
@ -256,6 +256,40 @@ Use to remove a privacy zone from a camera.
|
||||
| `device_id` | No | Camera you want to remove privacy zone from. |
|
||||
| `name` | No | The name of the zone to remove. |
|
||||
|
||||
### Action unifiprotect.get_user_keyring_info
|
||||
|
||||
| Data attribute | Optional | Description |
|
||||
| -------------- | -------- | ----------------------------------------------------------------------------------------------------------- |
|
||||
| `device_id` | No | Any device from the UniFi Protect instance you want to retrieve keyring information for. |
|
||||
|
||||
#### Example Usage
|
||||
|
||||
```yaml
|
||||
service: unifiprotect.get_user_keyring_info
|
||||
data:
|
||||
device_id: your_device_id_here
|
||||
```
|
||||
|
||||
The response will include a list of users with their full names, statuses, and associated keys (fingerprint or NFC).
|
||||
|
||||
#### Example Response
|
||||
|
||||
```yaml
|
||||
users:
|
||||
- full_name: User One
|
||||
user_status: ACTIVE
|
||||
ulp_id: d23e27e0-a32a-41e5-9424-be646330c2d5
|
||||
keys: []
|
||||
- full_name: User Two
|
||||
user_status: ACTIVE
|
||||
ulp_id: a243ffdb-3ab2-4186-b2fe-0b53ccb29f24
|
||||
keys:
|
||||
- key_type: nfc
|
||||
nfc_id: ABCDEF12
|
||||
- key_type: fingerprint
|
||||
fingerprint_id: "1"
|
||||
```
|
||||
|
||||
## Views
|
||||
|
||||
The {% term integrations %} provides two proxy views to proxy media content from your Home Assistant instance so you can access thumbnails and video clips from within the context of Home Assistant without having to expose your UniFi Protect NVR Console. As with the media identifiers, all IDs are UniFi Protect IDs as they may not map to specific Home Assistant entities depending on how you have configured your {% term integrations %}.
|
||||
@ -380,9 +414,11 @@ actions:
|
||||
action: notify.mobile_app_your_device # Replace with your notification target
|
||||
```
|
||||
|
||||
You can obtain the `nfc_id` using the [Action unifiprotect.get_user_keyring_info](#action-unifiprotectget_user_keyring_info).
|
||||
|
||||
**Warning:**
|
||||
|
||||
When processing NFC scans, always validate the scanned ID. Unknown NFC cards also trigger the scan event. Additionally, this event was developed using third-party cards, as the developer did not have access to official UniFi cards at the time. With third-party cards, the scan relies on the card's serial number. While this approach is not uncommon, it is essential to note that the card's serial number is generally not considered a secure identifier and can be duplicated relatively easily.
|
||||
When processing NFC scans, always validate the scanned ID. Unknown NFC cards also trigger the scan event. Additionally, this event was developed using third-party cards, as the developer did not have access to official UniFi cards at the time. With third-party cards, the scan relies on the card's serial number. While this approach is not uncommon, it is essential to note that the card's serial number is generally not considered a secure identifier and can be duplicated relatively easily. When the device becomes unavailable and becomes available again in Home Assistant, repeated event processing can occur. The state change is not an issue with the integration but should be considered, mainly if the device is used for actions such as unlocking doors.
|
||||
|
||||
### Fingerprint Identified Event
|
||||
|
||||
@ -391,7 +427,9 @@ When processing NFC scans, always validate the scanned ID. Unknown NFC cards als
|
||||
- **event_type**: Either `identified` or `not_identified`
|
||||
- **event_id**: A unique ID that identifies the fingerprint event.
|
||||
- **ulp_id**: The ID used to identify the person. If no fingerprint match is found, the `ulp_id` will be empty and the `event_type` will be `not_identified`.
|
||||
- **Description**: This event is triggered when a fingerprint is scanned by a compatible device. If the fingerprint is recognized, it provides a `ulp_id`, which represents the a internal user ID. If the fingerprint is not recognized, the `event_type` will be set to `not_identified`, and no `ulp_id` will be provided.
|
||||
- **Description**: This event is triggered when a fingerprint is scanned by a compatible device. If the fingerprint is recognized, it provides a `ulp_id`, which represents the internal user ID. If the fingerprint is not recognized, the `event_type` will be set to `not_identified`, and no `ulp_id` will be provided.
|
||||
|
||||
You can obtain the `ulp_id` using the [Action unifiprotect.get_user_keyring_info](#action-unifiprotectget_user_keyring_info).
|
||||
|
||||
#### Example G4 Doorbell Fingerprint Identified Automation
|
||||
|
||||
@ -423,6 +461,36 @@ action:
|
||||
|
||||
**Warning:**
|
||||
|
||||
Similar to NFC, an event is triggered when a fingerprint is recognized and not recognized. However, unlike NFC, at the time of implementation, no fingerprint ID is included in the event if the fingerprint is unknown. When the device becomes unavailable and becomes available again in Home Assistant, repeated event processing can occur. The state change is not an issue with the integration but should be considered, mainly if the device is used for actions such as unlocking doors.
|
||||
|
||||
#### Example G4 Doorbell Fingerprint Identified Automation
|
||||
|
||||
```yaml
|
||||
alias: G4 Doorbell Fingerprint Identified Automation
|
||||
description: Automation that triggers when a fingerprint is successfully identified on the G4 Doorbell Pro
|
||||
trigger:
|
||||
- platform: event
|
||||
event_type: state_changed
|
||||
event_data:
|
||||
entity_id: event.g4_doorbell_pro_poe_fingerprint # Replace with your doorbell entity
|
||||
condition:
|
||||
- condition: template
|
||||
value_template: >
|
||||
{% raw %}{{
|
||||
trigger.event.data.new_state is not none and
|
||||
trigger.event.data.new_state.attributes.event_type == 'identified' and
|
||||
(trigger.event.data.new_state.attributes.ulp_id|default('')) != '' and
|
||||
trigger.event.data.new_state.attributes.ulp_id in ['ALLOWED_ID1', 'ALLOWED_ID2']
|
||||
}}{% endraw %}
|
||||
action:
|
||||
- service: notify.mobile_app_your_device # Replace with your notification target
|
||||
data:
|
||||
{% raw %}message: "Fingerprint identified with ID: {{ trigger.event.data.new_state.attributes.ulp_id }}"{% endraw %}
|
||||
title: "Fingerprint Scan Notification"
|
||||
```
|
||||
|
||||
**Warning:**
|
||||
|
||||
Similar to NFC, an event is triggered when a fingerprint is recognized and not recognized. However, unlike NFC, at the time of implementation, no fingerprint ID is included in the event if the fingerprint is unknown.
|
||||
|
||||
## Troubleshooting
|
||||
|
@ -12,6 +12,7 @@ ha_domain: voip
|
||||
ha_integration_type: integration
|
||||
ha_quality_scale: internal
|
||||
ha_platforms:
|
||||
- assist_satellite
|
||||
- binary_sensor
|
||||
- select
|
||||
- switch
|
||||
|
109
source/_integrations/watergate.markdown
Normal file
109
source/_integrations/watergate.markdown
Normal file
@ -0,0 +1,109 @@
|
||||
---
|
||||
title: Watergate
|
||||
description: Instructions on how to integrate Watergate with Home Assistant.
|
||||
ha_category:
|
||||
- Sensor
|
||||
- Valve
|
||||
- Water management
|
||||
ha_release: '2025.1'
|
||||
ha_iot_class: Local Push
|
||||
ha_config_flow: true
|
||||
ha_codeowners:
|
||||
- '@adam-the-hero'
|
||||
ha_domain: watergate
|
||||
ha_platforms:
|
||||
- sensor
|
||||
- valve
|
||||
ha_quality_scale: bronze
|
||||
ha_integration_type: integration
|
||||
---
|
||||
|
||||
The **Watergate** integration integrates your Watergate Devices (currently Sonic Wi-Fi) with your Home Assistant.
|
||||
With this integration, you are able to:
|
||||
|
||||
- Control your valve
|
||||
- Monitor live telemetry (water flow, water pressure, water temperature)
|
||||
- Monitor water usage
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- You need to have a Sonic device.
|
||||
- The Local API feature must be enabled in the Watergate application.
|
||||
|
||||
## Supported devices
|
||||
|
||||
The following devices are known to be supported by the integration:
|
||||
|
||||
- Watergate Sonic Wi-Fi
|
||||
|
||||
## Unsupported devices
|
||||
|
||||
The following devices are not supported by the integration:
|
||||
|
||||
- Watergate Sonic Pro
|
||||
|
||||
## Supported functionality
|
||||
|
||||
### Entities
|
||||
|
||||
The Watergate integration provides the following entities.
|
||||
|
||||
#### Sensors
|
||||
|
||||
- **Water meter volume**
|
||||
- **Description**: Water volume used by this device for the entire lifetime of a Sonic device.
|
||||
- **Remarks**: It can be used in the Energy Dashboard.
|
||||
|
||||
- **Water flow rate**
|
||||
- **Description**: The current flow rate of water through the device.
|
||||
- **Remarks**: Useful for monitoring real-time water usage.
|
||||
|
||||
- **Water pressure**
|
||||
- **Description**: The current water pressure in the system.
|
||||
- **Remarks**: Can be used to detect potential issues in the water supply.
|
||||
|
||||
- **Water temperature**
|
||||
- **Description**: The current temperature of the water.
|
||||
- **Remarks**: Useful for monitoring and ensuring safe water temperatures.
|
||||
|
||||
#### Valves
|
||||
|
||||
- **Water valve state**
|
||||
- **Description**: The current state of the water valve (open/closed).
|
||||
- **Remarks**: It is automatically updated when the valve state is changed.
|
||||
|
||||
## Data updates
|
||||
|
||||
The Watergate integration fetches data from the Sonic device every 2 minutes.
|
||||
Thanks to the webhook option, Sonic will provide live telemetry every second when water is flowing directly to Home Assistant.
|
||||
|
||||
## Known limitations
|
||||
|
||||
The integration does not provide the ability to set auto shut-off thresholds and does not report any events regarding automatically closed valves.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
{% configuration_basic %}
|
||||
IP address:
|
||||
description: "The IP address of your Sonic device."
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
## Removing the integration
|
||||
|
||||
This integration follows standard integration removal procedures. No extra steps are required.
|
||||
|
||||
{% include integrations/remove_device_service.md %}
|
||||
|
||||
## Examples
|
||||
|
||||
### Monitor water usage in the Energy Dashboard
|
||||
|
||||
The water meter volume entity can be added to the Energy Dashboard, allowing you to monitor water usage.
|
||||
|
||||
### Automation ideas
|
||||
|
||||
- Turn off the water when no one is at home.
|
||||
- Turn on the water when someone arrives home.
|
||||
- Send a notification when the water is too hot.
|
||||
- Send a notification when the water is too cold.
|
||||
- Send a notification when water is flowing for too long.
|
@ -12,6 +12,7 @@ ha_codeowners:
|
||||
- '@jesperraemaekers'
|
||||
ha_domain: weheat
|
||||
ha_platforms:
|
||||
- binary_sensor
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
---
|
||||
@ -45,6 +46,17 @@ The Weheat integration provides the following sensors:
|
||||
- **Current room temperature**: Current room temperature in °C
|
||||
- **Room temperature setpoint**: Setpoint for the room temperature in °C
|
||||
- **Electricity used**: Total electricity used in kWh
|
||||
- **Energy output**: Total output generated in kWh
|
||||
- **State**: The current heat pump state
|
||||
- **DHW top temperature**: The domestic hot water temperature in the top of the vessel in °C (optional)
|
||||
- **DHW bottom temperature"**: The domestic hot water temperature in the bottom of the vessel in °C (optional)
|
||||
- **Compressor RPM**: The rpm of the compressor fan.
|
||||
- **Compressor percentage**: The percentage of the compressor fan. Can exceed 100% for some models.
|
||||
|
||||
Depending on the model/installation, states for the Indoor Unit states are available:
|
||||
|
||||
- **Indoor unit water pump**
|
||||
- **Indoor unit auxiliary water pump**
|
||||
- **Indoor unit DHW valve or water pump**
|
||||
- **Indoor unit gas boiler heating allowed** - Note: This may be True even when no gas boiler is installed or active at this time.
|
||||
- **Indoor unit electric heater**
|
||||
|
@ -16,6 +16,7 @@ ha_platforms:
|
||||
- diagnostics
|
||||
- sensor
|
||||
ha_integration_type: integration
|
||||
ha_dhcp: true
|
||||
---
|
||||
|
||||
The **Withings** {% term integration %} consumes data from various health products produced by [Withings](https://www.withings.com).
|
||||
|
@ -11,6 +11,7 @@ ha_codeowners:
|
||||
ha_domain: wyoming
|
||||
ha_integration_type: service
|
||||
ha_platforms:
|
||||
- assist_satellite
|
||||
- binary_sensor
|
||||
- conversation
|
||||
- number
|
||||
|
@ -14,6 +14,8 @@ related:
|
||||
- docs: /docs/configuration/
|
||||
title: Configuration file
|
||||
ha_quality_scale: legacy
|
||||
ha_codeowners:
|
||||
- '@kruton'
|
||||
---
|
||||
|
||||
The **Zabbix** {% term integration %} is the main {% term integration %} to connect to a [Zabbix](https://www.zabbix.com/) monitoring instance via the Zabbix API.
|
||||
|
80
source/_posts/2025-01-03-3-2-1-backup.markdown
Normal file
80
source/_posts/2025-01-03-3-2-1-backup.markdown
Normal file
@ -0,0 +1,80 @@
|
||||
---
|
||||
layout: post
|
||||
title: "3…2…1… Backup"
|
||||
description: "Stop what you're doing and take 5 minutes to set up automatic encrypted backups to keep your smart home running smoothly."
|
||||
date: 2025-01-03 00:00:01
|
||||
date_formatted: "January 03, 2025"
|
||||
author: Paulus Schoutsen
|
||||
comments: true
|
||||
categories: Announcements
|
||||
og_image: /images/blog/2025-01-backups/art.jpg
|
||||
---
|
||||
|
||||
<img src='/images/blog/2025-01-backups/art.jpg' alt="3 2 1 backup">
|
||||
|
||||
Home Assistant is a powerful tool that can save you time and money by automating your home. Pretty important things around the home, from heating to an automatic fish feeder, need to depend on it. However, as your setup grows more complex, maintaining it—what we call *"digital housekeeping"*—can become a time-consuming task. Backups are a critical part of this maintenance, yet they’re often overlooked, especially by new users, often until it is too late when disaster strikes.
|
||||
|
||||
To make backups effortless, we’ve introduced new automated and off-site backup features in [the latest release of Home Assistant](/blog/2025/01/03/release-20251/). These improvements will make it easier than ever to safeguard your setup. As we step into the New Year, we would encourage you to adopt a simple yet crucial resolution: regularly back up your data. With our new tools, it takes just five minutes to set up and provides lasting peace of mind.
|
||||
|
||||
Learn more about our backups below, or get started now by [updating](https://my.home-assistant.io/redirect/updates/) and visiting the [backups](https://my.home-assistant.io/redirect/backup/) page.
|
||||
|
||||
<!--more-->
|
||||
|
||||
## What’s in a backup?
|
||||
Backups are essential for a reliable smart home. They protect your system from hardware failures, natural disasters, and cyberattacks, allowing you to quickly restore operations. A solid backup strategy follows the 3-2-1 rule:
|
||||
|
||||
- 3 copies of your data
|
||||
- 2 stored on different media
|
||||
- 1 kept off-site
|
||||
|
||||
While this may seem excessive, consider a scenario like a lightning strike: both your Home Assistant system and any local storage, like network-attached storage (NAS), could be destroyed. That’s why an off-site backup is non-negotiable for true resilience, and a comprehensive backup strategy should include:
|
||||
|
||||
- Regular and frequent backups of critical data
|
||||
- Following the 3-2-1 rule for redundancy
|
||||
- Encrypting backups to protect against theft and corruption
|
||||
- Testing backups to ensure they are functional
|
||||
- Defining how long backups should be retained
|
||||
|
||||
To support these best practices, we have worked hard to introduce Automatic Backups and seamless integration with off-site backup location providers, such as [Home Assistant Cloud](/cloud/). These updates, part of [our 2024 roadmap](/blog/2024/06/12/roadmap-2024h1/#home-assistant-cloud-peace-of-mind), make it easier than ever to provide peace of mind to our users, by implementing a robust backup strategy, and keep your smart home running smoothly.
|
||||
|
||||
## Backups have never been this easy
|
||||
|
||||
<img src='/images/blog/2025-01-backups/backups.png' style='border: 0;box-shadow: none;' alt="the backup page">
|
||||
|
||||
Home Assistant backups are incredibly good, backing up every setting and add-on, making restores feel a bit like magic. It even works across different CPU architectures! Up until recently setting up a 3-2-1 backup strategy in Home Assistant was not entirely straightforward. This changes with Home Assistant 2025.1, where we're elevating our backup experience with three new important features.
|
||||
|
||||
- **Automatic encrypted backups** - You can now schedule automatic backups every night or once a week, ensuring you always have a recent backup at hand.
|
||||
- **Automatic cleanup** - No longer worry about backups overrunning your disk space, as you can now set the maximum number of backups that should be stored.
|
||||
- **Backup locations** - We have added a new system for integrations to provide backup locations (also known as [backup agents](https://developers.home-assistant.io/docs/core/platform/backup)), allowing you to sync backups to both local or off-site storage. It's launching with support for [network shares](https://my.home-assistant.io/redirect/storage/) and [Home Assistant Cloud](https://my.home-assistant.io/redirect/cloud/) (included at no additional cost to subscribers), with more locations to follow.
|
||||
|
||||
### Get started with our Backup Wizard
|
||||
|
||||
<img src='/images/blog/2025-01-backups/wizard.png' style='border: 0;box-shadow: none;' alt="the backup wizard">
|
||||
|
||||
The new automatic backup feature in Home Assistant 2025.1 comes with a new easy to use backup wizard. With a couple of clicks, you can backup your Home Assistant system on a regular schedule and easily choose the places where backups are stored. New users will be prompted with a wizard to make sure they set up automatic encrypted backups. Selecting the recommended settings ensures that a backup is made every night, that three backups are kept, and that they are uploaded to all available locations.
|
||||
|
||||
### Backup locations
|
||||
|
||||
<img src='/images/blog/2025-01-backups/locations.png' style='border: 0;box-shadow: none;' alt="backup locations">
|
||||
|
||||
At launch, only a few backup locations will be available, but we've made it easy for developers to integrate more, so expect a lot of options to follow. As part of this renewed focus on smart home resilience set out in [our roadmap](/blog/2024/06/12/roadmap-2024h1/#next-priority-encrypted-cloud-backup), cloud backup has been added to [Home Assistant Cloud](/cloud/), which will be available day one to all subscribers for no additional cost. It will only store the latest backup, which must be under 5GB (you'll be notified to repair it if it is too large to upload). If you lose your other backups, you can always go to [your Cloud account page](https://account.nabucasa.com/) and download the latest backup.
|
||||
|
||||
New Home Assistant features like this supercharged backup capability is only possible with funding from our Home Assistant Cloud subscribers. Adding backup to the subscription at no additional cost, was the least we could do to thank them for their continued support.
|
||||
|
||||
### Secure by default
|
||||
|
||||
<img src='/images/blog/2025-01-backups/encrypt.png' style='border: 0;box-shadow: none;' alt="Encryption key page">
|
||||
|
||||
Backups contain all Home Assistant data, including all the keys to every integrated device in your smart home and the history of how you live your life. This data is very important to keep secure. With automatic backups and the 3-2-1 approach we are promoting to users to store their backups off-site. This is why all automatic backups are fully encrypted.
|
||||
|
||||
When a user configures automatic backups, they will be presented with the encryption key and the option to download an emergency kit. The emergency kit contains all the important information, including a link to [the instructions on how to use it to restore a backup](/more-info/backup-emergency-kit). If you were to ever delete your emergency kit, it is available to re-download in the [backup configuration page](https://my.home-assistant.io/redirect/backup/).
|
||||
|
||||
#### Apply 3-2-1 to your backups
|
||||
|
||||
<lite-youtube videoid="nSSkMVBqChM" videotitle="How to setup automatic backups"></lite-youtube>
|
||||
|
||||
Check out the above video tutorial or read our docs to learn more about setting up [automatic and off-site backups](/integrations/backup/).
|
||||
|
||||
## Conclusion
|
||||
|
||||
Too often, people just starting their smart home journey move forward a little too fast and make a mistake that causes some downtime. This impacts the household's confidence, as something that should be making their lives easier is actually seen as unreliable. Avoid this early pitfall and build a resilient smart home with 3-2-1 backups.
|
735
source/_posts/2025-01-03-release-20251.markdown
Normal file
735
source/_posts/2025-01-03-release-20251.markdown
Normal file
@ -0,0 +1,735 @@
|
||||
---
|
||||
layout: post
|
||||
title: "2025.1: Backing Up into 2025!"
|
||||
description: "A complete overhaul of the backup system, including Home Assistant Cloud backup storage, retention policies, and fully extendable by integrations. Lots of Month of 'What the Heck?!' improvements, new integrations, and more!"
|
||||
date: 2025-01-03 00:00:00
|
||||
date_formatted: "January 3, 2025"
|
||||
author: Franck Nijhof
|
||||
author_twitter: frenck
|
||||
comments: true
|
||||
categories:
|
||||
- Release-Notes
|
||||
- Core
|
||||
og_image: /images/blog/2025-01/social.jpg
|
||||
---
|
||||
|
||||
<lite-youtube videoid="qCd7RHprmc0" videotitle="Home Assistant 2025.1 Release Party"></lite-youtube>
|
||||
|
||||
Home Assistant 2025.1! 🥂
|
||||
|
||||
Happy New Year! The whole Home Assistant project wishes you and your loved ones
|
||||
a fantastic and healthy 2025! ❤️ Let's make this year even better than the last!
|
||||
|
||||
We are all super excited to kick off the new year with an absolute **massive**
|
||||
release! 🎆
|
||||
|
||||
This release brings a complete overhaul of the backup system in Home Assistant,
|
||||
which has been in the works for months! And I'm not just talking about some
|
||||
user interface changes—no, we are talking about a complete overhaul from front
|
||||
to back!
|
||||
|
||||
Automated backups, encrypted Home Assistant Cloud backup storage, retention
|
||||
policies, configuration wizards, and even the ability for integrations to offer
|
||||
backup storage locations! 🤯
|
||||
|
||||
But that is not all! We also had the [Month of “What the Heck?!”](/blog/2024/11/30/the-month-of-what-the-heck/)
|
||||
in December, which resulted in a lot of quality-of-life improvements raised
|
||||
by the community that month!
|
||||
|
||||
There is so much to unwrap in this release, seriously, let's just dive in!
|
||||
|
||||
Enjoy the release!
|
||||
|
||||
../Frenck
|
||||
|
||||
<!--more-->
|
||||
|
||||
- [Overhaul of the backup system](#overhaul-of-the-backup-system)
|
||||
- [Automated backups 🤖](#automated-backups-)
|
||||
- [Triggering an off-schedule automated backup 👆](#triggering-an-off-schedule-automated-backup-)
|
||||
- [Home Assistant Cloud backups 😎](#home-assistant-cloud-backups-)
|
||||
- [Backup locations are extendable by design 🧩](#backup-locations-are-extendable-by-design-)
|
||||
- [Encrypted backups by default 🔒](#encrypted-backups-by-default-)
|
||||
- [Restoring backups available to all installation methods 🤗](#restoring-backups-available-to-all-installation-methods-)
|
||||
- [Backup retention 🗑](#backup-retention-)
|
||||
- [Setting up backups for the first time 🚀](#setting-up-backups-for-the-first-time-)
|
||||
- [3…2…1… Backups 🎊](#321-backups-)
|
||||
- [Month of "What the Heck?!"](#month-of-what-the-heck)
|
||||
- [Setting categories and labels when creating automations and scripts](#setting-categories-and-labels-when-creating-automations-and-scripts)
|
||||
- [Quickly navigate to a device](#quickly-navigate-to-a-device)
|
||||
- [Zoom \& Pan for charts](#zoom--pan-for-charts)
|
||||
- [Controlling the default exposure of new entities to Assist](#controlling-the-default-exposure-of-new-entities-to-assist)
|
||||
- [More "What the Heck?!" improvements](#more-what-the-heck-improvements)
|
||||
- [Integrations](#integrations)
|
||||
- [New integrations](#new-integrations)
|
||||
- [Noteworthy improvements to existing integrations](#noteworthy-improvements-to-existing-integrations)
|
||||
- [Now available to set up from the UI](#now-available-to-set-up-from-the-ui)
|
||||
- [Farewell to the following](#farewell-to-the-following)
|
||||
- [Other noteworthy changes](#other-noteworthy-changes)
|
||||
- [Dashboard background settings](#dashboard-background-settings)
|
||||
- [Media player volume feature for Tile card](#media-player-volume-feature-for-tile-card)
|
||||
- [Need help? Join the community!](#need-help-join-the-community)
|
||||
- [Backward-incompatible changes](#backward-incompatible-changes)
|
||||
- [All changes](#all-changes)
|
||||
|
||||
## Overhaul of the backup system
|
||||
|
||||
Let’s talk about backups. Let’s be honest: they’re one of the most important yet
|
||||
often overlooked tasks. But when disaster strikes, like a hardware failure,
|
||||
having a reliable backup can save the day. Wouldn't you love to be back up and
|
||||
running after disaster strikes?
|
||||
|
||||
While Home Assistant's previous backup system has proven to be solid
|
||||
and reliable over the years, it didn't exactly make following best
|
||||
practices—like regular backups, encryption, and off-site
|
||||
storage—easy. Many of you had to rely on custom add-ons, automations,
|
||||
or blueprints for backups to fill the gaps.
|
||||
|
||||
**That changes with this release! 🎉**
|
||||
|
||||
We've completely reworked the Home Assistant backup experience to help you set
|
||||
up a solid backup strategy, using best practices in just a few clicks;
|
||||
giving you peace of mind when it comes to your backups.
|
||||
|
||||
No worries, if you are using any custom solution for backups, they will continue
|
||||
to work today. Even with everything new, we've made sure to keep everything
|
||||
backward compatible.
|
||||
|
||||
So, without further ado, let's dive into the new backup system!
|
||||
|
||||
### Automated backups 🤖
|
||||
|
||||
Yes, you read that right—Home Assistant now supports automated backups!
|
||||
|
||||
Using a schedule, backups will be created on a regular basis without you having
|
||||
to lift a finger. This ensures you always have a recent backup available,
|
||||
without having to worry about it.
|
||||
|
||||
<img class="no-shadow" alt="Screenshot showing the bew backup overview page which shows you exactly when your last backup took place" src="/images/blog/2025-01/backups-status.png" />
|
||||
|
||||
When you navigate to your backups in the settings menu, you will be
|
||||
greeted with a new overview page that shows you exactly when your last backup
|
||||
took place and when the next one is scheduled. Instant peace of mind!
|
||||
|
||||
Automated backups are taking place at 4:45 AM. So, while everyone in your home
|
||||
is sleeping, Home Assistant makes sure your data is safe and sound. Backing up
|
||||
at this early hour also means Home Assistant is done with its internal database
|
||||
maintenance, ensuring your backup is as compact as possible.
|
||||
|
||||
If something ever goes wrong during the automated scheduled backup process,
|
||||
Home Assistant will notify you through the repair center, ensuring you are
|
||||
aware of it and can take action.
|
||||
|
||||
### Triggering an off-schedule automated backup 👆
|
||||
|
||||
Automated backups on a schedule are great, but sometimes, you might want to
|
||||
trigger a backup **right now**! Maybe you are about to make big changes or
|
||||
upgrade a whole bunch of things during an evening of tinkering.
|
||||
|
||||
No worries! You can now trigger an off-schedule automated backup from the backup
|
||||
page at any time. This will immediately create a backup with the same
|
||||
configuration as your scheduled automated backups.
|
||||
|
||||
<img class="no-shadow" alt="Screenshot showing the backup now button + dialog that allows you to trigger an off-schedule backup at any time" src="/images/blog/2025-01/backups-backup-now.png" />
|
||||
|
||||
The ability to trigger an on-demand automated backup is excellent, as it covers
|
||||
all your backup settings in a single click. However, the ability to create
|
||||
manual backups also still exists. This allows you to create a very specific
|
||||
backup with the exact contents you want to have in it.
|
||||
|
||||
### Home Assistant Cloud backups 😎
|
||||
|
||||
Are you a [Home Assistant Cloud by Nabu Casa] subscriber? Then you're in for a
|
||||
treat! You can now automatically store your latest, fully encrypted, backup in
|
||||
your Home Assistant Cloud account.
|
||||
|
||||
**This feature provides 5GB of storage at no extra cost, offering fully
|
||||
encrypted off-site protection for your data! 🎁**
|
||||
|
||||
<img class="no-shadow" alt="Home Assistant Cloud is now a backup target location, that is included with the Home Assistant Cloud subscription at no additional costs" src="/images/blog/2025-01/backups-home-assistant-cloud.png" />
|
||||
|
||||
The backup can be downloaded from Home Assistant itself, but also from the
|
||||
[Home Assistant Cloud account page](https://account.nabucasa.com/) @ Nabu Casa
|
||||
in case you need it. This way, you can always access your latest backup, even
|
||||
in case your Home Assistant hardware completely fails.
|
||||
|
||||
[Home Assistant Cloud by Nabu Casa]: https://www.nabucasa.com/
|
||||
|
||||
### Backup locations are extendable by design 🧩
|
||||
|
||||
So, automated backups can be stored on your local disk and in Home Assistant
|
||||
Cloud, but what if you want to store your backups somewhere else?
|
||||
|
||||
Choice is an important aspect of Home Assistant; we want to make everything as
|
||||
flexible as possible without vendor lock-in. Therefore, the backup system
|
||||
is designed to be **extendable**.
|
||||
|
||||
This means **integrations** can offer new storage locations—such as NAS devices,
|
||||
Google Drive, Backblaze B2, or other storage providers—in the future.
|
||||
|
||||
<img class="no-shadow" alt="Screenshot showing an potential example storage provider provided by an integration" src="/images/blog/2025-01/backups-integration-location.png" />
|
||||
|
||||
Currently, this feature is brand new ✨, so **no** integrations offer additional
|
||||
locations yet. However, we expect to see a few more integrations that provide
|
||||
backup locations in the next release.
|
||||
|
||||
This extensibility ensures you can store your backups where you want them,
|
||||
giving you the flexibility and choice to choose the storage solution you
|
||||
prefer and trust.
|
||||
|
||||
### Encrypted backups by default 🔒
|
||||
|
||||
With the addition of Home Assistant Cloud as an off-site backup location, and
|
||||
the potential for integrations to offer even more (off-site) backup locations,
|
||||
security has become more important than ever. Your backups not only contain the
|
||||
access credentials to your smart home devices but also the history of your home,
|
||||
and no one should be able to access information that sensitive! **Ever!**
|
||||
|
||||
That is why all backups are now [AES-128] encrypted by default. To prioritize
|
||||
your backups’ security we replaced the previous optional password
|
||||
with a mandatory encryption key.
|
||||
|
||||
<img class="no-shadow" alt="The new backup overview page shows you exactly when your last backup took place" src="/images/blog/2025-01/backups-encryption.png" />
|
||||
|
||||
When you set up your backups for the first time, an encryption key will be
|
||||
generated for you. Make sure to store this key in a safe place, as you will need
|
||||
it to restore your backups. To make this easier, you can download the key as
|
||||
part of an emergency kit during setup—or anytime later from the backup settings
|
||||
page. Keep it safe! 🔑
|
||||
|
||||
[AES-128]: https://en.wikipedia.org/wiki/Advanced_Encryption_Standard
|
||||
|
||||
### Restoring backups available to all installation methods 🤗
|
||||
|
||||
More good news—restoring backups is now supported across
|
||||
**all installation methods!** 🎉
|
||||
|
||||
Previously, only Home Assistant OS installations could restore backups. But
|
||||
with this release, this feature is now available for all installation methods!
|
||||
No matter how you run Home Assistant, even if you use our containers in a Docker
|
||||
environment, you can now restore your Home Assistant backups.
|
||||
|
||||
This also means you can restore backups from local storage, Home Assistant
|
||||
Cloud, or any future backup locations added through integrations.
|
||||
|
||||
As a matter of fact, all backup features, including everything we release today,
|
||||
will be available regardless of the installation method you are using. We want
|
||||
everyone to have a solid backup strategy.
|
||||
|
||||
### Backup retention 🗑
|
||||
|
||||
Our previous backup system made solid backups, which was good, but if you didn't
|
||||
clean them up manually, eventually, you'd annoyingly run out of disk space. 😬
|
||||
|
||||
So! Backup retention is now a thing! You can now configure how many backups you
|
||||
want to keep, and Home Assistant will handle the rest.
|
||||
|
||||
<img class="no-shadow" alt="You can now configure a retention policy for your backups, allowing Home Assistant to clean it up automatically" src="/images/blog/2025-01/backups-retention.png" />
|
||||
|
||||
This cleanup will happen automatically after each backup. If you create a backup
|
||||
manually for whatever reason, those will remain untouched, giving you full
|
||||
control over special cases and workflows.
|
||||
|
||||
### Setting up backups for the first time 🚀
|
||||
|
||||
Getting started with the new backup system is quick and easy!
|
||||
|
||||
The first time you open the backup settings after upgrading, you will be greeted
|
||||
by a **setup wizard** that will guide you through setting up your backups
|
||||
step-by-step.
|
||||
|
||||
<img class="no-shadow" alt="Screenshot of the our friendly wizard that will help you setting up your backups" src="/images/blog/2025-01/backups-wizard.png" />
|
||||
|
||||
The wizard will help you set up your encryption key, configure your backup
|
||||
frequency, and set up your backup retention policy. And when it is ready, it
|
||||
will immediately kick off your first backup!
|
||||
|
||||
All set! One less thing to worry about 🎉
|
||||
|
||||
### 3…2…1… Backups 🎊
|
||||
|
||||
We are super excited about this new backup system! As we enter the new year,
|
||||
we encourage you to get serious about your backups.
|
||||
A good New Year’s resolution, maybe? 😉
|
||||
|
||||
So, stop what you are doing right now and set up your backups! Go ahead and set
|
||||
up that 3-2-1 backup strategy. Not sure what that is?
|
||||
|
||||
**You can read all about it in our [3…2…1… Backup blog post](/blog/2025/01/03/3-2-1-backup/).**
|
||||
|
||||
## Month of "What the Heck?!"
|
||||
|
||||
December’s **[Month of “What the Heck?!”](/blog/2024/11/30/the-month-of-what-the-heck/)**
|
||||
was an absolute blast! 🎉
|
||||
|
||||
A big thank you to everyone who contributed by sharing their “What the Heck?!”
|
||||
moments and ideas for improving Home Assistant. Your input is incredibly
|
||||
valuable and helps shape our roadmap and priorities moving forward.
|
||||
|
||||
Quite a bunch of shared "What the Heck?!" moments have been addressed in this
|
||||
release already 🚀 —and we’re not stopping there! Expect to see even more
|
||||
improvements inspired by your feedback in upcoming releases.
|
||||
|
||||
### Setting categories and labels when creating automations and scripts
|
||||
|
||||
For the first WTH item that has been resolved, we have [@jpbede] to thank!
|
||||
And this one is also one of the higher-voted ones, so it is a good one!
|
||||
Andrew Jackson wrote:
|
||||
|
||||
[_**"WTH can you not add categories, labels etc when creating an automation"**_](https://community.home-assistant.io/t/wth-can-you-not-add-categories-labels-etc-when-creating-an-automation/802562)
|
||||
|
||||
Yeah, that is a good WTH! Whenever you create a new automation or script, you
|
||||
probably want to organize it right away and not have to go back to the settings.
|
||||
**FIXED**! 🎉
|
||||
|
||||
<img class="no-shadow" alt="If you press the d on your keyboard, it will pop up the Quickbar for devices" src="/images/blog/2025-01/wth-category-labels-new-automation.png" />
|
||||
|
||||
When you create a new automation or script, and also when renaming it,
|
||||
you can now set the description, category, labels, and areas right away!
|
||||
🏷️ Nice!
|
||||
|
||||
### Quickly navigate to a device
|
||||
|
||||
You might be aware that you can bring up our quick navigation bar anywhere in
|
||||
Home Assistant by pressing the `c` key on your keyboard to navigate various
|
||||
places and the `e` key to search and navigate to any entity. However…
|
||||
|
||||
[_**"WTH is there no quick bar for devices?"**_](https://community.home-assistant.io/t/wth-is-there-no-quick-bar-for-devices/802310)
|
||||
|
||||
Well, that is a good question that Andreas Brett raised! There is indeed no
|
||||
such thing for devices. [@jpbede] to the rescue! You can now navigate to any
|
||||
device using the quick bar by pressing the `d` key on your keyboard.
|
||||
|
||||
<img class="no-shadow" alt="If you press the d on your keyboard, it will pop up the quick bar for devices" src="/images/blog/2025-01/wth-quickbar-devices.png"/>
|
||||
|
||||
### Zoom & Pan for charts
|
||||
|
||||
KNXBroker raised the following WTH topic:
|
||||
|
||||
[_**"WTH lets upgrade History Graphs"**_](https://community.home-assistant.io/t/wth-lets-upgrade-history-graphs/802568)
|
||||
|
||||
You are right! The history graphs in Home Assistant are basic but functional!
|
||||
Nevertheless, we can do better! 🚀
|
||||
|
||||
One of the bigger items in that WTH topic was the ability to zoom and pan...
|
||||
Thanks to [@MindFreeze], you can now zoom and pan in any graph
|
||||
in Home Assistant! 📈
|
||||
|
||||
<p class="img">
|
||||
<img class="no-shadow" alt="Zoom any graph in Home Assistant, by holding ctrl or command and scrolling your mouse wheel!" src="/images/blog/2025-01/wth-zoom-graphs.gif"/>
|
||||
Zoom and drag any graph in Home Assistant, by holding ctrl (or command on mac)
|
||||
and scrolling your mouse wheel!
|
||||
</p>
|
||||
|
||||
Hold the control key (or command on macOS) and scroll to zoom in and out using
|
||||
your mouse. You can also click and drag to pan around the zoomed graph.
|
||||
|
||||
In addition to this change, [@MindFreeze] enabled small micro-animation for the
|
||||
history graphs, making them look more alive and less static.
|
||||
|
||||
[@MindFreeze]: https://github.com/MindFreeze
|
||||
|
||||
### Controlling the default exposure of new entities to Assist
|
||||
|
||||
mathd made the following point in a Month of "What the Heck?!" topic:
|
||||
|
||||
[_"WTH Are all new entities exposed to Assist by default?"_](https://community.home-assistant.io/t/wth-are-all-new-entities-exposed-to-assist-by-default/803889)
|
||||
|
||||
We hear you! Thanks to [@jpbede], you can now control the default exposure of
|
||||
new entities to Assist. You can now toggle this on or off in the Home Assistant
|
||||
Voice Assistant settings.
|
||||
|
||||
<img class="no-shadow" alt="Zoom any graph in Home Assistant, by holding ctrl or command and scroll your mouse wheel!" src="/images/blog/2025-01/wth-default-expose-to-assist.png" />
|
||||
|
||||
### More "What the Heck?!" improvements
|
||||
|
||||
Many smaller improvements originate from the Month of “What the Heck?!” in this
|
||||
release. Here are some of the other noteworthy ones:
|
||||
|
||||
[_**"WTH there is no hotkey for Assist"**_](https://community.home-assistant.io/t/wth-there-is-no-hotkey-for-assist/802403)**
|
||||
|
||||
Well, thanks to [@jpbede], you can now press the `a` key on your keyboard
|
||||
anywhere in Home Assistant to summon Assist! 🎙️ Nice!
|
||||
|
||||
[_**"WTH doesn't HA ask if I want to save automations?"**_](https://community.home-assistant.io/t/wth-doesnt-ha-ask-if-i-want-to-save-automations/804030)
|
||||
|
||||
Whoa! That is a good one! Thanks to [@jpbede], Home Assistant will now ask if
|
||||
you want to save your automation before leaving the editor if there are unsaved
|
||||
changes. 🤖
|
||||
|
||||
[_**"WTH Is in Energy Dashboard the individual devices not able to reorder"**_](https://community.home-assistant.io/t/wth-is-in-energy-dashboard-the-individual-devices-not-able-to-reorder/805051)
|
||||
|
||||
Thanks for that one yormedia! Honestly, this one has been raised in previous
|
||||
editions of the Month of "What the Heck?!" a few times. Reason enough for
|
||||
[@karwosts] to pick this up and make it happen! You can now reorder them in
|
||||
the setting for categorization purposes. 🔡
|
||||
|
||||
[_**"WTH Can't I filter labels within a table filter?"**_](https://community.home-assistant.io/t/wth-cant-i-filter-labels-within-a-table-filter/802529)
|
||||
|
||||
Good question. If you have a lot of labels, scrolling through the list of labels
|
||||
in the filter option can be a bit cumbersome. Thanks to [@silamon], you can
|
||||
now search and filter through the labels in the filter option! 🔎
|
||||
|
||||
[_**WTH sentence trigger doesn't contain any context**_](https://community.home-assistant.io/t/wth-sentence-trigger-doesnt-contain-any-context/802386)
|
||||
|
||||
Great idea! Thanks to [@balloob], the full conversation input is now available
|
||||
to sentence triggers! 🗣️ This was actually the first WTH item to be resolved in
|
||||
this edition! 😎
|
||||
|
||||
[@balloob]: https://github.com/balloob
|
||||
[@jpbede]: https://github.com/jpbede
|
||||
[@karwosts]: https://github.com/karwosts
|
||||
[@silamon]: https://github.com/silamon
|
||||
|
||||
## Integrations
|
||||
|
||||
Thanks to our community for keeping pace with the new {% term integrations %}
|
||||
and improvements to existing ones! You’re all awesome 🥰
|
||||
|
||||
### New integrations
|
||||
|
||||
We welcome the following new integrations in this release:
|
||||
|
||||
- **[Cookidoo]**, added by [@miaucl]
|
||||
Interact with your shopping lists of [Cookidoo the official Thermomix recipe platform].
|
||||
- **[EHEIM Digital]**, added by [@autinerd]
|
||||
Control your [EHEIM Digital aquarium devices] with Home Assistant.
|
||||
- **[Ituran]**, added by [@shmuelzon]
|
||||
Retrieve and use information from your Ituran-equipped vehicle.
|
||||
- **[Ohme]**, added by [@dan-r]
|
||||
Get sensor information from your Ohme smart EV charger.
|
||||
- **[Peblar]**, added by [@frenck]
|
||||
Control and monitor the charging sessions of your [Peblar EV Charger].
|
||||
- **[Powerfox]**, added by [@klaasnicolaas]
|
||||
Gather data from your [Poweropti] devices reading electricity, water, gas, and heat.
|
||||
- **[Slide Local]**, added by [@dontinelli]
|
||||
Integrate your [Slide] cover device directly with Home Assistant using a local API.
|
||||
- **[Watergate]**, added by [@adam-the-hero]
|
||||
Integrate your Watergate Sonic Local with Home Assistant.
|
||||
|
||||
[@adam-the-hero]: https://github.com/adam-the-hero
|
||||
[@autinerd]: https://github.com/autinerd
|
||||
[@dan-r]: https://github.com
|
||||
[@dontinelli]: https://github.com/dontinelli
|
||||
[@frenck]: https://github.com/frenck
|
||||
[@klaasnicolaas]: https://github.com/klaasnicolaas
|
||||
[@miaucl]: https://github.com/miaucl
|
||||
[@shmuelzon]: https://github.com/shmuelzon
|
||||
[Cookidoo the official Thermomix recipe platform]: https://cookidoo.international/
|
||||
[Cookidoo]: /integrations/cookidoo
|
||||
[EHEIM Digital aquarium devices]: https://eheim.com/en_GB/aquatics/eheim-digital/
|
||||
[EHEIM Digital]: /integrations/eheimdigital
|
||||
[Ituran]: /integrations/ituran
|
||||
[Ohme]: /integrations/ohme
|
||||
[Peblar EV Charger]: https://www.peblar.com
|
||||
[Peblar]: /integrations/peblar
|
||||
[Powerfox]: /integrations/powerfox
|
||||
[Poweropti]: https://shop.powerfox.energy/collections/frontpage
|
||||
[Slide Local]: /integrations/slide_local
|
||||
[Slide]: https://slide.store/
|
||||
[Watergate]: /integrations/watergate
|
||||
|
||||
### Noteworthy improvements to existing integrations
|
||||
|
||||
It is not just new {% term integrations %} that have been added; existing
|
||||
integrations are also being constantly improved. Here are some of the noteworthy
|
||||
changes to existing integrations:
|
||||
|
||||
- The [TP-Link Smart Home] now has support for cameras! Nice work [@sdb9696]!
|
||||
- [@RaHehl] added [UniFi Protect AI Port] support to the
|
||||
[UniFi Protect integration]. Awesome!
|
||||
- The [Music Assistant integration] now has support for actions with response
|
||||
values from your [Music Assistant]. Thanks, [@marcelveldt]!
|
||||
- The [Cambridge Audio] integration now supports media browsing!
|
||||
Thanks, [@noahhusby]!
|
||||
- [@dotav] added the ability to control the combustion power of your
|
||||
[Palazzetti] pellet stove. Nice!
|
||||
- The [SwitchBot Bluetooth integration] now supports the SwitchBot Water Leak
|
||||
Detector and relay switch. Good work, [@luc-ass] and [@greyeee]!
|
||||
- [@davidrapan] has been working on the [Starlink integration], adding sensors
|
||||
reporting power, energy, and data usage. Nice!
|
||||
|
||||
[@davidrapan]: https://github.com/davidrapan
|
||||
[@dotav]: https://github.com/dotav
|
||||
[@greyeee]: https://github.com/greyeee
|
||||
[@luc-ass]: https://github.com/luc-ass
|
||||
[@marcelveldt]: https://github.com/marcelveldt
|
||||
[@noahhusby]: https://github.com/noahhusby
|
||||
[@RaHehl]: https://github.com/RaHehl
|
||||
[@sdb9696]: https://github.com/sdb9696
|
||||
[Cambridge Audio]: /integrations/cambridge_audio
|
||||
[Music Assistant integration]: /integrations/music_assistant
|
||||
[Music Assistant]: https://music-assistant.io/
|
||||
[Palazzetti]: /integrations/palazzetti
|
||||
[Starlink integration]: /integrations/starlink
|
||||
[SwitchBot Bluetooth integration]: /integrations/switchbot
|
||||
[TP-Link Smart Home]: /integrations/tplink
|
||||
[UniFi Protect AI Port]: https://store.ui.com/us/en/products/up-ai-port
|
||||
[UniFi Protect integration]: /integrations/unifiprotect
|
||||
|
||||
### Now available to set up from the UI
|
||||
|
||||
While most {% term integrations %} can be set up directly from the Home Assistant
|
||||
user interface, some were only available using YAML configuration. We keep moving
|
||||
more integrations to the UI, making them more accessible for everyone
|
||||
to set up and use.
|
||||
|
||||
The following integration is now available via the Home Assistant UI:
|
||||
|
||||
- **[Niko Home Control]**, done by [@VandeurenGlenn]
|
||||
|
||||
[@VandeurenGlenn]: https://github.com/VandeurenGlenn
|
||||
[Niko Home Control]: /integrations/niko_home_control
|
||||
|
||||
### Farewell to the following
|
||||
|
||||
The following {% term integrations %} are also no longer available as
|
||||
of this release:
|
||||
|
||||
- **DTE Energy Bridge** has been removed after being deprecated. The integration
|
||||
was no longer functional.
|
||||
- **Simulated** has been previously deprecated and is now removed.
|
||||
- **Stookalert** has been removed. The upstream data is no longer updated.
|
||||
The [Stookwijzer] integration is a good alternative to get the same information.
|
||||
|
||||
[Stookwijzer]: /integrations/stookwijzer
|
||||
|
||||
## Other noteworthy changes
|
||||
|
||||
There are many more improvements in this release; here are some of the other
|
||||
noteworthy changes:
|
||||
|
||||
- When viewing data tables and using `ctrl+f` in your browser to search, the
|
||||
search input will now be focused automatically. As native browser searches
|
||||
will not work on data tables. Thanks [@jpbede]!
|
||||
- [@marcinbauer85] adjusted the "Add card" dialog, to automatically focus on the
|
||||
search field when you add a card, so you can start typing to search
|
||||
right away! Nice touch!
|
||||
- Images uploaded through Home Assistant (for example, as background or as a
|
||||
user profile picture) are now browsable in the media browser.
|
||||
Thanks [@karwosts]!
|
||||
- The unit of measurement is now shown next to the numeric slider in the
|
||||
more-info dialog of number entities. Thanks, [@abmantis]!
|
||||
- Home Assistant now supports `mWh` as a unit of measurement for energy sensors
|
||||
and `mW` for electrical potential power sensors. Thanks [@agners]!
|
||||
- [@wendevlin] added settings and category overflow actions to the automation
|
||||
and script editor (the three-dotted menu in the top right corner), making
|
||||
it easier to access those straight from the editor. Nice!
|
||||
- The [logbook card] supports picking a target for things it should show
|
||||
events for. You can now pick based on entities, devices, areas, floors,
|
||||
and labels! Thanks, [@silamon]!
|
||||
|
||||
[@abmantis]: https://github.com/abmantis
|
||||
[@agners]: https://github.com/agners
|
||||
[@jpbede]: https://github.com/jpbede
|
||||
[@karwosts]: https://github.com/karwosts
|
||||
[@marcinbauer85]: https://github.com/marcinbauer85
|
||||
[@silamon]: https://github.com/silamon
|
||||
[@wendevlin]: https://github.com/wendevlin
|
||||
[logbook card]: /dashboards/logbook/
|
||||
|
||||
## Dashboard background settings
|
||||
|
||||
A few releases ago, we made adding a background image to your dashboard easier.
|
||||
This release, [@silamon] takes it a step further by adding a lot of settings
|
||||
to customize how the background image is displayed.
|
||||
|
||||
This includes support for tiled backgrounds, transparency, size settings,
|
||||
alignment, and allowing the background to scroll with the page or stay fixed.
|
||||
|
||||
<img class="no-shadow" alt="You can now fully customize the background of your dashboard, with the options to changing tiling, transparency, alignment, and size seettings" src="/images/blog/2025-01/dashboards-background-settings.png" />
|
||||
|
||||
Nice! Thanks, [@silamon]!
|
||||
|
||||
[@silamon]: https://github.com/silamon
|
||||
|
||||
## Media player volume feature for Tile card
|
||||
|
||||
This is a super nice addition from [@simon-zumbrunnen]! The Tile card now
|
||||
supports a media player volume slider feature. This feature allows you to
|
||||
control the volume of a media player directly from the Tile card. 🔉
|
||||
Nice work Simon!
|
||||
|
||||
<img class="no-shadow" alt="The tile card with a media player entity, having the volume feature slider enabled" src="/images/blog/2025-01/tile-card-feature-volume-slider.png" />
|
||||
|
||||
[@simon-zumbrunnen]: https://github.com/simon-zumbrunnen
|
||||
|
||||
## Need help? Join the community!
|
||||
|
||||
Home Assistant has a great community of users who are all more than willing
|
||||
to help each other out. So, join us!
|
||||
|
||||
Our very active [Discord chat server](/join-chat) is an excellent place to be
|
||||
at, and don't forget to join our amazing [forums](https://community.home-assistant.io/).
|
||||
|
||||
Found a bug or issue? Please report it in our [issue tracker](https://github.com/home-assistant/core/issues),
|
||||
to get it fixed! Or, check [our help page](/help) for guidance for more
|
||||
places you can go.
|
||||
|
||||
Are you more into email? [Sign-up for our Building the Open Home Newsletter](/newsletter)
|
||||
to get the latest news about features, things happening in our community and
|
||||
other news about building an Open Home; straight into your inbox.
|
||||
|
||||
## Backward-incompatible changes
|
||||
|
||||
We do our best to avoid making changes to existing functionality that might
|
||||
unexpectedly impact your Home Assistant installation. Unfortunately, sometimes,
|
||||
it is inevitable.
|
||||
|
||||
We always make sure to document these changes to make the transition as easy as
|
||||
possible for you. This release has the following backward-incompatible changes:
|
||||
|
||||
{% details "1-Wire" %}
|
||||
|
||||
The unit of measurement has been removed from 1-Wire counters because
|
||||
`count` is not a unit 😁
|
||||
|
||||
([@jrieger] - [#132076]) ([documentation](/integrations/onewire))
|
||||
|
||||
[@jrieger]: https://github.com/jrieger
|
||||
[#132076]: https://github.com/home-assistant/core/pull/132076
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "Denon HEOS" %}
|
||||
|
||||
Grouping a HEOS media player will now raise an exception if one of the members
|
||||
is not a valid HEOS player. Previously unknown or invalid members would be
|
||||
silently dropped.
|
||||
|
||||
([@andrewsayre] - [#132213]) ([documentation](/integrations/heos))
|
||||
|
||||
[@andrewsayre]: https://github.com/andrewsayre
|
||||
[#132213]: https://github.com/home-assistant/core/pull/132213
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "devolo Home Control" %}
|
||||
|
||||
The integration with devolo Home Control has been updated to remove the option
|
||||
to set the mydevolo URL. This option was used to integrate with the devolo
|
||||
Home Control Cloud for development purposes only.
|
||||
This option is no longer available.
|
||||
|
||||
([@Shutgun] - [#132821]) ([documentation](/integrations/devolo_home_control))
|
||||
|
||||
[@Shutgun]: https://github.com/Shutgun
|
||||
[#132821]: https://github.com/home-assistant/core/pull/132821
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "FXCOM RFXtrx" %}
|
||||
|
||||
The unit of measurement has been removed from FXCOM RFXtrx counters because
|
||||
`count` is not a unit 😁
|
||||
|
||||
([@jrieger] - [#133108]) ([documentation](/integrations/rfxtrx))
|
||||
|
||||
[@jrieger]: https://github.com/jrieger
|
||||
[#133108]: https://github.com/home-assistant/core/pull/133108
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "HomeWizard Energy" %}
|
||||
|
||||
The unit of measurement for the "Water usage" sensor has been updated from
|
||||
`l/min` to `L/min`. This change standardizes the unit to improve consistency
|
||||
across Home Assistant.
|
||||
|
||||
Any automations, scripts, or templates that rely on the old unit may need to be
|
||||
adjusted. Long-term statistics will remain intact, but repair issues will be
|
||||
created to ensure the data is updated with the new unit.
|
||||
|
||||
([@DCSBL] - [#132261]) ([documentation](/integrations/homewizard))
|
||||
|
||||
[@DCSBL]: https://github.com/DCSBL
|
||||
[#132261]: https://github.com/home-assistant/core/pull/132261
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "LIFX" %}
|
||||
|
||||
The options `color_temp` and `kelvin` are no longer valid arguments for LIFX
|
||||
actions. Please use `color_temp_kelvin` instead.
|
||||
|
||||
([@epenet] - [#132730]) ([documentation](/integrations/lifx))
|
||||
|
||||
[@epenet]: https://github.com/epenet
|
||||
[#132730]: https://github.com/home-assistant/core/pull/132730
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "Tesla Fleet" %}
|
||||
|
||||
The included OAuth application credentials have been removed, as Tesla no longer
|
||||
supports Open Source application registrations and is moving to a pay-per-use
|
||||
model.
|
||||
|
||||
Read more about this announcement in this [blog post](https://developer.tesla.com/docs/fleet-api/announcements#2024-11-27-pay-per-use-pricing).
|
||||
|
||||
([@Bre77] - [#132431]) ([documentation](/integrations/tesla_fleet))
|
||||
|
||||
[@Bre77]: https://github.com/Bre77
|
||||
[#132431]: https://github.com/home-assistant/core/pull/132431
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "UniFi Network" %}
|
||||
|
||||
The states of "Device State" sensors have been standardized to match
|
||||
Home Assistant core rules and be translatable. This affects the following
|
||||
UniFi sensor states:
|
||||
|
||||
- `Connected`, which now became `connected`
|
||||
- `Pending`, which now became `pending`
|
||||
- `Firmware Mismatch`, which now became `firmware_mismatch`
|
||||
- `Upgrading`, which now became `upgrading`
|
||||
- `Provisioning`, which now became `provisioning`
|
||||
- `Heartbeat Missed`, which now became `heartbeat_missed`
|
||||
- `Adopting`, which now became `adopting`
|
||||
- `Deleting`, which now became `deleting`
|
||||
- `Inform Error`, which now became `inform_error`
|
||||
- `Adoption Failed`, which now became `adoption_failed`
|
||||
- `Isolated`, which now became `isolated`
|
||||
- `Unknown`, which now became `unknown`
|
||||
|
||||
If you used those states directly in your automations, scripts, or templates;
|
||||
you will need to adjust those to match these changes.
|
||||
|
||||
([@bieniu] - [#131921]) ([documentation](/integrations/unifi))
|
||||
|
||||
[@bieniu]: https://github.com/bieniu
|
||||
[#131921]: https://github.com/home-assistant/core/pull/131921
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
{% details "Zabbix" %}
|
||||
|
||||
The integration now uses the official Zabbix Python API. Because of this, the
|
||||
minimum supported Zabbix version is now 5.0. This change drops support for
|
||||
Zabbix 4 and before.
|
||||
|
||||
([@kruton] - [#131674]) ([documentation](/integrations/zabbix))
|
||||
|
||||
[@kruton]: https://github.com/kruton
|
||||
[#131674]: https://github.com/home-assistant/core/pull/131674
|
||||
|
||||
{% enddetails %}
|
||||
|
||||
If you are a custom integration developer and want to learn about changes and
|
||||
new features available for your integration: Be sure to follow our
|
||||
[developer blog][devblog]. The following are the most notable for this release:
|
||||
|
||||
- [Changed name of WaterHeaterEntityDescription](https://developers.home-assistant.io/blog/2024/12/13/water-heater-entity-description)
|
||||
- [Climate entity now supports independent horizontal swing](https://developers.home-assistant.io/blog/2024/12/03/climate-horizontal-swing)
|
||||
- [Moving to Pydantic v2](https://developers.home-assistant.io/blog/2024/12/21/moving-to-pydantic-v2)
|
||||
- [New vacuum state property](https://developers.home-assistant.io/blog/2024/12/08/new-vacuum-state-property)
|
||||
- [Use Kelvin as the preferred color temperature unit](https://developers.home-assistant.io/blog/2024/12/14/kelvin-preferred-color-temperature-unit)
|
||||
- [New area device class](https://developers.home-assistant.io/blog/2024/12/26/area-squared-units/)
|
||||
|
||||
[devblog]: https://developers.home-assistant.io/blog/
|
||||
|
||||
## All changes
|
||||
|
||||
Of course, there is a lot more in this release. You can find a list of
|
||||
all changes made here: [Full changelog for Home Assistant Core 2025.1](/changelogs/core-2025.1)
|
@ -400,8 +400,9 @@ layout: null
|
||||
/cookbook/#infrastructure /examples/#infrastructure
|
||||
/cookbook/#automation-examples /examples
|
||||
/cookbook /examples
|
||||
/common-tasks/os/#snapshots /common-tasks/os/#backups
|
||||
/common-tasks/supervised/#snapshots /common-tasks/supervised/#backups
|
||||
/common-tasks/os/#snapshots /common-tasks/general/#backups
|
||||
/common-tasks/os/#backups /common-tasks/general/#backups
|
||||
/common-tasks/supervised/#snapshots /common-tasks/general/#backups
|
||||
/more-info/unsupported/container /more-info/unsupported/software
|
||||
/integrations/zigbee /integrations/zha
|
||||
/examples /
|
||||
@ -612,6 +613,7 @@ layout: null
|
||||
/integrations/shiftr /more-info/removed-integration 301
|
||||
/integrations/sht31 /more-info/removed-integration 301
|
||||
/integrations/simple_alarm /more-info/removed-integration 301
|
||||
/integrations/simulated /more-info/removed-integration 301
|
||||
/integrations/smarthab /more-info/removed-integration 301
|
||||
/integrations/sochain /more-info/removed-integration 301
|
||||
/integrations/socialblade /more-info/removed-integration 301
|
||||
@ -619,6 +621,7 @@ layout: null
|
||||
/integrations/spider /more-info/removed-integration 301
|
||||
/integrations/spotcrime /more-info/removed-integration 301
|
||||
/integrations/srp_energy /more-info/removed-integration 301
|
||||
/integrations/stookalert /more-info/removed-integration 301
|
||||
/integrations/synology /more-info/removed-integration 301
|
||||
/integrations/sytadin /more-info/removed-integration 301
|
||||
/integrations/tahoma /more-info/removed-integration 301
|
||||
|
2161
source/changelogs/core-2025.1.markdown
Normal file
2161
source/changelogs/core-2025.1.markdown
Normal file
File diff suppressed because it is too large
Load Diff
@ -4,6 +4,10 @@ description: "Common tasks for Home Assistant Container"
|
||||
installation: container
|
||||
---
|
||||
|
||||
## Backup
|
||||
|
||||
To learn how to back up the system or how to restore a system from a backup, refer to the backup documentation under [common tasks](/common-tasks/general/#backups).
|
||||
|
||||
## Update
|
||||
|
||||
{% include common-tasks/update.md %}
|
||||
|
@ -4,6 +4,10 @@ description: "Common tasks for Home Assistant Core"
|
||||
installation: core
|
||||
---
|
||||
|
||||
## Backup
|
||||
|
||||
To learn how to back up the system or how to restore a system from a backup, refer to the backup documentation under [common tasks](/common-tasks/general/#backups).
|
||||
|
||||
## Update
|
||||
|
||||
{% include common-tasks/update.md %}
|
||||
|
@ -5,6 +5,8 @@ installation_name: "Installation independent"
|
||||
---
|
||||
This section provides tasks that do not depend on a specific Home Assistant installation type or a specific integration. They may be referenced in other procedures.
|
||||
|
||||
{% include common-tasks/backups.md %}
|
||||
|
||||
{% include common-tasks/enable_entities.md %}
|
||||
|
||||
## Defining a custom polling interval
|
||||
|
@ -9,7 +9,6 @@ related:
|
||||
This section will provide guides to some common tasks and information which you will need in order to run, maintain, and edit your Home Assistant OS system. For further details on any particular subject, make sure to refer to the documentation for specific add-ons or topics listed here.
|
||||
|
||||
{% include common-tasks/file_access.md %}
|
||||
{% include common-tasks/backups.md %}
|
||||
|
||||
## Updating Home Assistant
|
||||
|
||||
@ -26,7 +25,7 @@ Updates of the {% term "Home Assistant Operating System" %} are independent of o
|
||||
|
||||
#### Prerequisites
|
||||
|
||||
- [Backup](/common-tasks/os/#backups) your installation.
|
||||
- [Backup](/common-tasks/general/#backups) your installation.
|
||||
- Make sure the backup is downloaded and stored outside of the system.
|
||||
- So that you can restore from that backup in case there is an issue with the system.
|
||||
|
||||
|
@ -9,7 +9,6 @@ related:
|
||||
|
||||
|
||||
{% include common-tasks/file_access.md %}
|
||||
{% include common-tasks/backups.md %}
|
||||
|
||||
## Update
|
||||
|
||||
|
@ -470,6 +470,27 @@ type:
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
## Media player volume slider
|
||||
|
||||
Widget that displays a slider to control the volume for a [media player](/integrations/media_player).
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/dashboards/features/media_player_volume_slider.png' alt='Screenshot of the tile card with media player volume slider feature'>
|
||||
Screenshot of the tile card with media player volume slider feature
|
||||
</p>
|
||||
|
||||
```yaml
|
||||
features:
|
||||
- type: "media-player-volume-slider"
|
||||
```
|
||||
|
||||
{% configuration features %}
|
||||
type:
|
||||
required: true
|
||||
description: "`media-player-volume-slider`"
|
||||
type: string
|
||||
{% endconfiguration %}
|
||||
|
||||
## Numeric input
|
||||
|
||||
Widget that displays a slider or buttons to set the value for a [number](/integrations/number) or [input number](/integrations/input_number).
|
||||
|
@ -193,7 +193,69 @@ Set a separate [theme](/integrations/frontend/#themes) for the view and its card
|
||||
|
||||
You can style the background of your views with a [theme](/integrations/frontend/#themes). You can use the CSS variable `lovelace-background`. For wallpapers you probably want to use the example below, more options can be found [here](https://developer.mozilla.org/en-US/docs/Web/CSS/background).
|
||||
|
||||
### Example
|
||||
### View-specific background settings
|
||||
|
||||
**Image** - Sets the background image to use behind the view:
|
||||
- **Upload picture** lets you pick an image from the system used to show your Home Assistant UI.
|
||||
- **Local path** lets you pick an image stored on Home Assistant. For example: `/homeassistant/images/lights_view_background_image.jpg`.
|
||||
- To store an image on Home Assistant, you need to [configure access to files](/common-tasks/os/#configuring-access-to-files), for example via [Samba](/common-tasks/os/#installing-and-using-the-samba-add-on) or the [Studio Code Server](/common-tasks/os/#installing-and-using-the-visual-studio-code-vsc-add-on) add-on.
|
||||
- **web URL** let you pick an image from the web. For example `https://www.home-assistant.io/images/frontpage/assist_wake_word.png`.
|
||||
|
||||
{% configuration views %}
|
||||
background:
|
||||
required: false
|
||||
description: Customize the view's background with options for image, transparency, size, alignment, repeat, and attachment.
|
||||
type: map
|
||||
keys:
|
||||
image:
|
||||
required: false
|
||||
description: Sets the background image to use behind the view.
|
||||
type: string
|
||||
opacity:
|
||||
required: false
|
||||
description: Adjust the background's opacity, from fully opaque to transparent.
|
||||
type: integer
|
||||
default: 100
|
||||
size:
|
||||
required: false
|
||||
description: Choose how the background fits the space. Defaults to the original picture size, fill view (`cover` in YAML) fills the view with cropping if necessary and fits view (`contain` in YAML) fits the image within the view, maintaining aspect ratio.
|
||||
type: string
|
||||
default: auto
|
||||
alignment:
|
||||
required: false
|
||||
description: Precisely position the background. Valid options can be anything between top left and bottom right, with center being the default.
|
||||
type: string
|
||||
default: center
|
||||
repeat:
|
||||
required: false
|
||||
description: Controls whether the background repeats across the view. Repeating is useful when a tiled background is being used.
|
||||
type: string
|
||||
default: no-repeat
|
||||
attachment:
|
||||
required: false
|
||||
description: Controls whether a background image's position is fixed within the view, or scrolls.
|
||||
type: string
|
||||
default: scroll
|
||||
{% endconfiguration %}
|
||||
|
||||
#### Example
|
||||
|
||||
```yaml
|
||||
# Example background section in view yaml
|
||||
background:
|
||||
image: /local/background.png
|
||||
opacity: 50 # any percentage between 0 and 100
|
||||
size: auto # auto, cover, contain
|
||||
alignment: center # top left, top center, top right, center left, center, center right, bottom left, bottom center, bottom right
|
||||
repeat: no-repeat # repeat, no-repeat
|
||||
attachment: scroll # scroll, fixed
|
||||
```
|
||||
|
||||
### Background theme variable
|
||||
|
||||
You can style the background of all your views with a [theme](/integrations/frontend/#themes). You can use the CSS variable `lovelace-background`. For wallpapers you probably want to use the example below, more options can be found [here](https://developer.mozilla.org/en-US/docs/Web/CSS/background).
|
||||
|
||||
#### Example
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
|
@ -8,7 +8,7 @@ related:
|
||||
title: configuration.yaml file
|
||||
- docs: /common-tasks/os/#network-storage
|
||||
title: Network storage
|
||||
- docs: /common-tasks/os/#backups
|
||||
- docs: /common-tasks/general/#backups
|
||||
title: Backups
|
||||
- docs: /voice_control/
|
||||
title: Voice control
|
||||
@ -40,8 +40,8 @@ You can back up your Home Assistant, add-on data, and configuration. Backups are
|
||||
|
||||
To learn how to create a backup of your Home Assistant installation, select the link below that matches your installation type.
|
||||
|
||||
- {% term "Home Assistant Operating System" %}: [Creating a backup from OS](/common-tasks/os/#backups)
|
||||
- {% term "Home Assistant Supervised" %}: [Creating a backup from Supervised](/common-tasks/supervised/#backups)
|
||||
- {% term "Home Assistant Operating System" %}: [Creating a backup from OS](/common-tasks/general/#backups)
|
||||
- {% term "Home Assistant Supervised" %}: [Creating a backup from Supervised](/common-tasks/general/#backups)
|
||||
- {% term "Home Assistant Core" %} or {% term "Home Assistant Container" %}: [Creating a backup from Core or Container](/integrations/backup/)
|
||||
|
||||
## Editing the configuration.yaml and configuring file access
|
||||
|
BIN
source/images/blog/2025-01-backups/art.jpg
Normal file
BIN
source/images/blog/2025-01-backups/art.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 26 KiB |
BIN
source/images/blog/2025-01-backups/backups.png
Normal file
BIN
source/images/blog/2025-01-backups/backups.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 29 KiB |
BIN
source/images/blog/2025-01-backups/encrypt.png
Normal file
BIN
source/images/blog/2025-01-backups/encrypt.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 54 KiB |
BIN
source/images/blog/2025-01-backups/locations.png
Normal file
BIN
source/images/blog/2025-01-backups/locations.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 34 KiB |
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user