mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-24 17:57:14 +00:00
Merge branch 'current' into next
This commit is contained in:
Franck Nijhof
commit
3437d9eab2
@ -138,7 +138,7 @@ GEM
|
||||
rack-protection (= 4.0.0)
|
||||
rack-session (>= 2.0.0, < 3)
|
||||
tilt (~> 2.0)
|
||||
sorbet-runtime (0.5.11391)
|
||||
sorbet-runtime (0.5.11394)
|
||||
stringex (2.8.6)
|
||||
strscan (3.1.0)
|
||||
terminal-table (3.0.2)
|
||||
|
||||
@ -38,6 +38,14 @@ If you cannot access your Home Assistant installation remotely, remember to chec
|
||||
|
||||
<div class='note'>
|
||||
|
||||
Just putting a port up is not secure. You should definitely consider encrypting your traffic if you are accessing your Home Assistant installation remotely. For details please check the [set up encryption using Let's Encrypt](/blog/2017/09/27/effortless-encryption-with-lets-encrypt-and-duckdns/) blog post or this [detailed guide](/docs/ecosystem/certificates/lets_encrypt/) to using Let's Encrypt with Home Assistant.
|
||||
Just putting a port up is not secure. You should definitely consider encrypting your traffic if you are accessing your Home Assistant installation remotely. For details, please check the [set up encryption using Let's Encrypt](/blog/2017/09/27/effortless-encryption-with-lets-encrypt-and-duckdns/) blog post or this [detailed guide](https://community.home-assistant.io/t/certificate-authority-and-self-signed-certificate-for-ssl-tls/196970) to using Let's Encrypt with Home Assistant.
|
||||
|
||||
</div>
|
||||
|
||||
## Adding a remote URL to Home Assistant
|
||||
|
||||
To set the URL under which your Home Assistant can be accessed from outside your local network, follow these steps:
|
||||
|
||||
1. In the bottom left, select your username to go to your {% my profile title="**User profile**" %}, and make sure **Advanced mode** is enabled.
|
||||
2. Go to {% my network title="**Settings** > **System** > **Network**" %}.
|
||||
3. Under **Home Assistant URL**, enter the external URL that you previously set up for your instance.
|
||||
|
||||
@ -102,7 +102,7 @@ The only characters valid in entity names are:
|
||||
|
||||
The entity name must not start or end with an underscore. If you create an entity with other characters from the UI, Home Assistant validates the name. If you change the name directly in the YAML file, then Home Assistant may not generate an error for that entity. However, attempts to use that entity will generate errors (or possibly fail silently).
|
||||
|
||||
For instructions on how to change an entity name, refer to the section on [changing entity name and entity ID](/docs/configuration/customizing-devices/#changing-entity-name-and-entity-id).
|
||||
For instructions on how to change an entity name, refer to the section on [customizing entities](/docs/configuration/customizing-devices/).
|
||||
|
||||
## Debug logs and diagnostics
|
||||
|
||||
|
||||
1
source/_includes/integrations/device_class_intro.md
Normal file
1
source/_includes/integrations/device_class_intro.md
Normal file
@ -0,0 +1 @@
|
||||
A device class is a measurement categorization in Home Assistant. It influences how the entity is represented in the [dashboard](/dashboards/). This can be modified in the [customize section](/docs/configuration/customizing-devices/). For example, different states may be represented by different icons, colors, or text.
|
||||
@ -27,25 +27,21 @@ a binary sensor to detect room occupancy. Other binary sensors can be created
|
||||
manually using the [template integration](/integrations/template/)
|
||||
or using an [input boolean helper](/integrations/input_boolean).
|
||||
|
||||
|
||||
{% include integrations/building_block_integration.md %}
|
||||
|
||||
### Device class
|
||||
|
||||
Knowing a sensor is binary impacts how the sensor's current state may be
|
||||
represented in Home Assistant's UI (see [Dashboards](/dashboards/)). Opposing states
|
||||
may be given different icons, colors, and value labels to highlight a particular
|
||||
state over the other. This is set by the binary sensor's device class.
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
Here are a few examples of this representation in the UI:
|
||||
The screenshot shows a few examples of different device classes for binary sensors:
|
||||
|
||||
|
||||
|
||||
Example of various device classes icons in `on` and `off` state. The on image
|
||||
in this example has `state_color: true` specified in the Entities card
|
||||
in this example has `state_color: true` specified in the entities card
|
||||
configuration to receive the icon coloring.
|
||||
|
||||
The full list of supported binary sensor device classes is below
|
||||
*(note: these may also be modified in the [customizing section](/docs/configuration/customizing-devices)).*
|
||||
The following device classes are supported for binary sensors:
|
||||
|
||||
- **None**: Generic on/off. This is the default and doesn't need to be set.
|
||||
- **battery**: `on` means low, `off` means normal
|
||||
|
||||
@ -9,6 +9,11 @@ ha_domain: button
|
||||
ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
A button {% term entity %} is an entity that can fire an {% term event %} / trigger an {% term action %} towards
|
||||
@ -55,14 +60,17 @@ This service can be called to trigger a button press for that entity.
|
||||
|
||||
## Device class
|
||||
|
||||
The way these buttons are displayed in the frontend can be modified in the [customize section](/docs/configuration/customizing-devices/).
|
||||
The following device classes are supported for buttons:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The screenshot shows different icons representing different device classes for buttons:
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/screenshots/button_classes_icons.png' />
|
||||
Example of device class icons.
|
||||
</p>
|
||||
|
||||
The following device classes are supported for buttons:
|
||||
|
||||
- **None**: Generic button. This is the default and doesn't need to be set.
|
||||
- **identify**: The button is used to identify a device.
|
||||
- **restart**: The button restarts the device.
|
||||
|
||||
@ -9,6 +9,11 @@ ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_domain: cover
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
Home Assistant can give you an interface to control covers such as rollershutters, blinds, and garage doors.
|
||||
@ -17,7 +22,18 @@ Home Assistant can give you an interface to control covers such as rollershutter
|
||||
|
||||
## Device class
|
||||
|
||||
The way these {% term sensors %} are displayed in the {% term frontend %} can be modified in the [customize section](/docs/configuration/customizing-devices/). The following device classes are supported for covers:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The screenshot shows different icons representing different device classes for covers:
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/screenshots/cover_classes_icons.png' />
|
||||
List of cover examples.
|
||||
</p>
|
||||
|
||||
Example of various device classes icons in `open` and `closed` state. The open image in this example has `state_color: true` specified in the Entities card configuration to receive the icon coloring.
|
||||
|
||||
The following device classes are supported for covers.
|
||||
|
||||
- **None**: Generic cover. This is the default and doesn't need to be set.
|
||||
- **awning**: Control of an awning, such as an exterior retractable window, door, or patio cover.
|
||||
@ -31,11 +47,6 @@ The way these {% term sensors %} are displayed in the {% term frontend %} can be
|
||||
- **shutter**: Control of shutters, which are linked slats that swing out/in to covering an opening or may be tilted to partially cover an opening, such as indoor or exterior window shutters.
|
||||
- **window**: Control of a physical window that opens and closes or may tilt.
|
||||
|
||||
Here are a few examples of this representation in the UI:
|
||||
|
||||
|
||||
Example of various device classes icons in `open` and `closed` state. The open image in this example has `state_color: true` specified in the Entities card configuration to receive the icon coloring.
|
||||
|
||||
## Services
|
||||
|
||||
### Cover control services
|
||||
@ -43,8 +54,8 @@ Example of various device classes icons in `open` and `closed` state. The open i
|
||||
Available services: `cover.open_cover`, `cover.close_cover`, `cover.stop_cover`, `cover.toggle`, `cover.open_cover_tilt`, `cover.close_cover_tilt`, `cover.stop_cover_tilt`, `cover.toggle_tilt`
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all.
|
||||
| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
|
||||
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. |
|
||||
|
||||
#### Automation example
|
||||
|
||||
@ -64,9 +75,9 @@ automation:
|
||||
Set cover position of one or multiple covers.
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all.
|
||||
| `position` | no | Integer between 0 and 100.
|
||||
| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
|
||||
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. |
|
||||
| `position` | no | Integer between 0 and 100. |
|
||||
|
||||
#### Automation example
|
||||
|
||||
@ -88,9 +99,9 @@ automation:
|
||||
Set cover tilt position of one or multiple covers.
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all.
|
||||
| `tilt_position` | no | Integer between 0 and 100.
|
||||
| ---------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
|
||||
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of covers. Use `entity_id: all` to target all. |
|
||||
| `tilt_position` | no | Integer between 0 and 100. |
|
||||
|
||||
#### Automation example
|
||||
|
||||
|
||||
@ -9,6 +9,11 @@ ha_domain: event
|
||||
ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
Events are signals that are emitted when something happens, for example, when a user presses a physical button like a doorbell or when a button on a remote control is pressed.
|
||||
@ -75,7 +80,16 @@ action:
|
||||
|
||||
When creating automations in the automation editor in the UI, the event types are available as a dropdown list, depending on the event entity you are using. This means you don't have to remember the different event types and can easily select them.
|
||||
|
||||
## Device classes
|
||||
## Device class
|
||||
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The screenshot shows different icons representing device classes of the event entity:
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/integrations/event/device_class_event_icons.png' alt='Screenshot showing different icons representing device classes of the event entity' />
|
||||
Example of different icons representing device classes of the event entity.
|
||||
</p>
|
||||
|
||||
The following device classes are supported by event entities:
|
||||
|
||||
|
||||
@ -18,9 +18,9 @@ related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
---
|
||||
|
||||
The **Home Assistant Core** {% term integration %} provides generic implementations like the generic `homeassistant.turn_on`.
|
||||
The **Home Assistant Core** {% term integration %} provides generic implementations like the generic `homeassistant.turn_on` service.
|
||||
|
||||
## Editing the general settings in YAML
|
||||
## Editing the General Settings in YAML
|
||||
|
||||
The Home Assistant Core integration is also responsible for the general settings. These settings are defined during onboarding, but you can change them later under {% my general title="**Settings** > **System** > **General**" %}. For the detailed steps, refer to [Basic settings](/docs/configuration/basic/).
|
||||
|
||||
@ -143,12 +143,12 @@ debug:
|
||||
default: false
|
||||
{% endconfiguration %}
|
||||
|
||||
## Editing the entity settings in YAML
|
||||
## Editing entity settings in YAML
|
||||
|
||||
The Home Assistant Core integration is also responsible for the entity settings.
|
||||
The Home Assistant Core integration is also responsible for entity settings.
|
||||
By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities.
|
||||
|
||||
Most of these settings can be changed from the UI. For the detailed steps, refer to [Customizing entites](/docs/configuration/customizing-devices/).
|
||||
Most of these settings can be changed from the UI. For the detailed steps, refer to [Customizing entities](/docs/configuration/customizing-devices/).
|
||||
|
||||
If you prefer editing in YAML, you can define your general settings in the [`configuration.yaml` file](/docs/configuration/).
|
||||
|
||||
@ -191,16 +191,23 @@ initial_state:
|
||||
|
||||
### Device class
|
||||
|
||||
A device class represents a group of device types. The way a specific device class is shown in the user interface depends on the platform that is using it. For example, binary sensor and cover both support the device class "window". While for the binary sensor the window can only be open or closed, for cover, a window can also be tilted. For a given platform, the device class controls how the device is shown in the user interface. For example: humidifier has two device classes, humidifier and dehumidifier. If the device class is set to `humidifier`, the UI shows **Humidifying**. If it is set to `dehumidifier`, it shows **Drying**.
|
||||
|
||||
Device class is currently supported by the following platforms:
|
||||
|
||||
- [Binary sensor](/integrations/binary_sensor/)
|
||||
- [Button](/integrations/button/)
|
||||
- [Cover](/integrations/cover/)
|
||||
- [Humidifier](/integrations/humidifier/)
|
||||
- [Media player](/integrations/media_player/)
|
||||
- [Number](/integrations/number/)
|
||||
- [Sensor](/integrations/sensor/)
|
||||
- [Switch](/integrations/switch/)
|
||||
- [Binary sensor](/integrations/binary_sensor/#device-class)
|
||||
- [Button](/integrations/button/#device-class)
|
||||
- [Cover](/integrations/cover/#device-class)
|
||||
- [Event](/integrations/event/#device-class)
|
||||
- [Humidifier](/integrations/humidifier/#device-class)
|
||||
- [Media player](/integrations/media_player/#device-class)
|
||||
- [Number](/integrations/number/#device-class)
|
||||
- [Sensor](/integrations/sensor#device-class)
|
||||
- [Switch](/integrations/switch/#device-class)
|
||||
- [Update](/integrations/update/#device-class)
|
||||
- [Valve](/integrations/valve/#device-class)
|
||||
|
||||
For a list of the supported device classes, refer to the documentation of the platform.
|
||||
|
||||
### Manual customization
|
||||
|
||||
|
||||
@ -10,12 +10,33 @@ ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
- '@Shulyaka'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
The `humidifier` integration is built for the controlling and monitoring of humidifiers, dehumidifiers, and hygrostat devices.
|
||||
|
||||
{% include integrations/building_block_integration.md %}
|
||||
|
||||
## Device class
|
||||
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The screenshot shows different text and UI for different device classes for humidifiers:
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/screenshots/humidifier_device_class.png' />
|
||||
Humidifier device classes.
|
||||
</p>
|
||||
|
||||
The following device classes are supported for humidifiers:
|
||||
|
||||
- **Humidifier**: Adds humidity to the air around it.
|
||||
- **Dehumidifier**: Removes humidity from the air around it.
|
||||
|
||||
## Services
|
||||
|
||||
### Humidifier services
|
||||
|
||||
@ -117,6 +117,7 @@ Make sure you have all these components ready before trying to add a Matter devi
|
||||
- When prompted to **Select the connection method**:
|
||||
- If you run Home Assistant OS in a regular setup: select **Submit**.
|
||||
- This will install the official Matter server add-on.
|
||||
- Note that the official Matter server add-on is not supported on 32-bit platforms.
|
||||
- If you are already running the Matter server in another add-on, in or a custom container:
|
||||
- Deselect the checkbox, then select **Submit**.
|
||||
- In the next step, provide the URL to your Matter server.
|
||||
|
||||
@ -9,6 +9,11 @@ ha_domain: media_player
|
||||
ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
Interacts with media players on your network.
|
||||
@ -180,7 +185,16 @@ Allows to group media players together for synchronous playback. Only works on s
|
||||
|
||||
### Device class
|
||||
|
||||
The way media players are displayed in the frontend can be modified in the [customize section](/getting-started/customizing-devices/). The following device classes are supported for media players:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The screenshot shows different icons representing device classes of the media player entity:
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/screenshots/device_class_media_player_icons.png' alt='Screenshot showing different icons representing device classes of the media player entity' />
|
||||
Example of different icons representing device classes of the media player entity.
|
||||
</p>
|
||||
|
||||
The following device classes are supported for media players:
|
||||
|
||||
- `tv`: Device is a television type device.
|
||||
- `speaker`: Device is a speaker or stereo type device.
|
||||
|
||||
@ -10,6 +10,11 @@ ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
- '@Shulyaka'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
Keeps track on `number` entities in your environment, their state, and allows you to control them. This integration allows other integrations to get a value input from user within a range.
|
||||
@ -20,7 +25,9 @@ If you are looking for a way to create a number entity, please take a look at th
|
||||
|
||||
## Device class
|
||||
|
||||
The type of data a number represents impacts how it is displayed in the frontend. This is controlled by the number's device class designation. Built-in numbers and many created from an integration will have this designation predefined. Those can be modified in the [customize section](/docs/configuration/customizing-devices/). When manually creating a new number the device class may be optionally assigned. A full list of available number device classes is below:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The following device classes are supported for numbers:
|
||||
|
||||
- **None**: Generic number. This is the default and doesn't need to be set.
|
||||
- **apparent_power**: Apparent power in VA.
|
||||
|
||||
@ -59,7 +59,9 @@ verify ssl:
|
||||
|
||||
### API key
|
||||
For the integration to work, please check that in Octoprint, the [Discovery Plugin](https://docs.octoprint.org/en/master/bundledplugins/discovery.html) is enabled and in the **Settings** -> **Printer Notifications** menu that **Enable popups** is checked.
|
||||
The Octoprint integration will attempt to register itself via the [Application Keys Plugin](https://docs.octoprint.org/en/master/bundledplugins/appkeys.html). After submitting the configuration UI in Home Assistant, open the Octoprint UI and select **Allow** on the prompt. NOTE: You must be logged into Octoprint as the user which you are adding Home Assistant. Otherwise, the popup access prompt does not appear.
|
||||
The Octoprint integration will attempt to register itself via the [Application Keys Plugin](https://docs.octoprint.org/en/master/bundledplugins/appkeys.html). After submitting the configuration UI in Home Assistant, log in to Octoprint as the user whose credentials you just entered in Home Assistant, and select **Allow** on the prompt.
|
||||
|
||||
NOTE: You *must* be logged into Octoprint as the user which you are adding to Home Assistant. If you log in to Octoprint as any other user, you will not see the prompt to allow access.
|
||||
|
||||
## Binary sensor
|
||||
|
||||
|
||||
@ -9,6 +9,11 @@ ha_domain: sensor
|
||||
ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
Sensors are a basic integration in Home Assistant. They monitor the states and conditions of a variety of entities. An entity can be many things. This can include a physical device like a motion sensor that reports the battery level, a web service that retrieves the weather temperature, a built-in function that calculates the sun's elevation relative to your GPS position, or even a custom sensor you may have created to report the free space on your laptop. These are all _things_ reporting different types of information.
|
||||
@ -17,7 +22,16 @@ Some of these sensors are built-in to Home Assistant, some are created automatic
|
||||
|
||||
## Device class
|
||||
|
||||
The type of data a sensor returns impacts how it is displayed in the frontend. This is controlled by the sensor's device class designation. Built-in sensors and many created from an integration will have this designation predefined. Those can be modified in the [customize section](/docs/configuration/customizing-devices/). When manually creating a new sensor the device class may be optionally assigned. A full list of available sensor device classes is below:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The screenshot shows different icons representing different device classes for sensors:
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/screenshots/sensor_device_classes_icons.png' />
|
||||
Example of various device class icons for sensors.
|
||||
</p>
|
||||
|
||||
The following device classes are supported for sensors:
|
||||
|
||||
- **None**: Generic sensor. This is the default and doesn't need to be set.
|
||||
- **apparent_power**: Apparent power in VA.
|
||||
@ -71,8 +85,3 @@ The type of data a sensor returns impacts how it is displayed in the frontend. T
|
||||
- **water**: Water consumption in L, gal, m³, ft³, or CCF
|
||||
- **weight**: Generic mass in kg, g, mg, µg, oz, lb, or st
|
||||
- **wind_speed**: Wind speed in Beaufort, ft/s, km/h, kn, m/s, or mph
|
||||
|
||||
<p class='img'>
|
||||
<img src='/images/screenshots/sensor_device_classes_icons.png' />
|
||||
Example of various device class icons for sensors.
|
||||
</p>
|
||||
|
||||
@ -11,6 +11,11 @@ ha_platforms:
|
||||
ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
Keeps track which switches are in your environment, their state and allows you to control them.
|
||||
@ -22,10 +27,12 @@ Keeps track which switches are in your environment, their state and allows you t
|
||||
|
||||
## Device class
|
||||
|
||||
The way these switches are displayed in the frontend can be modified in the [customize section](/docs/configuration/customizing-devices/). The following device classes are supported for switches:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The following device classes are supported for switches:
|
||||
|
||||
- **None**: Generic switch. This is the default and doesn't need to be set.
|
||||
- **outlet**: This switch, switches a power outlet.
|
||||
- **outlet**: A switch for a power outlet.
|
||||
- **switch**: A generic switch.
|
||||
|
||||
## Use the services
|
||||
@ -37,5 +44,5 @@ In the frontend open the sidebar. At the bottom, under **Developer Tools**, clic
|
||||
```
|
||||
|
||||
| Service data attribute | Optional | Description |
|
||||
| ---------------------- | -------- | ----------- |
|
||||
| `entity_id` | no | String or list of strings that point at `entity_id`s of switches. To target all switches, set `entity_id` to `all`.
|
||||
| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
|
||||
| `entity_id` | no | String or list of strings that point at `entity_id`s of switches. To target all switches, set `entity_id` to `all`. |
|
||||
|
||||
@ -8,6 +8,11 @@ ha_domain: update
|
||||
ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
An update {% term entity %} is an entity that indicates if an update is available for a
|
||||
@ -49,10 +54,11 @@ information on the update state:
|
||||
- `release_summary`: A summary of the release notes for the update available.
|
||||
- `release_url`: A link to the full release announcement for the update available.
|
||||
|
||||
## Device classes
|
||||
## Device class
|
||||
|
||||
The way these update entities are displayed in the frontend depend on their
|
||||
device classes. The following device classes are supported for switches:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The following device classes are supported for update entities:
|
||||
|
||||
- **`None`**: A generic software update. This is the default and doesn't need
|
||||
to be set.
|
||||
|
||||
@ -9,6 +9,11 @@ ha_codeowners:
|
||||
- '@home-assistant/core'
|
||||
ha_domain: valve
|
||||
ha_integration_type: entity
|
||||
related:
|
||||
- docs: /docs/configuration/customizing-devices/
|
||||
title: Customizing devices
|
||||
- docs: /dashboards/
|
||||
title: Dashboard
|
||||
---
|
||||
|
||||
The valve entity in Home Assistant provides an interface to control valves such as water, gas, or air valves.
|
||||
@ -17,7 +22,9 @@ The valve entity in Home Assistant provides an interface to control valves such
|
||||
|
||||
## Device class
|
||||
|
||||
You can change the device class of the valve in the [customize section](/docs/configuration/customizing-devices/). Valves support the following device classes:
|
||||
{% include integrations/device_class_intro.md %}
|
||||
|
||||
The following device classes are supported for valves:
|
||||
|
||||
- **None**: Generic valve. This is the default and doesn't need to be set.
|
||||
- **water**: Valve that controls the flow of water through a system.
|
||||
|
||||
BIN
source/images/integrations/event/device_class_event_icons.png
Normal file
BIN
source/images/integrations/event/device_class_event_icons.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 24 KiB |
BIN
source/images/screenshots/device_class_media_player_icons.png
Normal file
BIN
source/images/screenshots/device_class_media_player_icons.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 15 KiB |
BIN
source/images/screenshots/humidifier_device_class.png
Normal file
BIN
source/images/screenshots/humidifier_device_class.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 118 KiB |
@ -21,12 +21,13 @@ If you are using Home Assistant in kiosk mode, for example if you have a tablet
|
||||
## To add an Assist button to the dashboard
|
||||
|
||||
1. On your dashboard, select **Add card** and select the **Button** card.
|
||||
2. Clear the **Entity** field and give the card a name, such as *Assist - listen*.
|
||||
3. Select an icon, such as `mdi:account-tie-voice`.
|
||||
4. From the **Action** dropdown menu, select **Assist**.
|
||||
5. From the **Assist** dropdown menu, select the assistant you want to use, for example **Home Assistant Cloud**.
|
||||
2. Clear the **Entity** field.
|
||||
3. Give the card a name, such as *Assist - listen*.
|
||||
4. Select an icon, such as `mdi:account-tie-voice`.
|
||||
5. From the **Action** dropdown menu, select **Assist**.
|
||||
6. From the **Assist** dropdown menu, select the assistant you want to use, for example **Home Assistant Cloud**.
|
||||
- You can use any assistant you have previously set up.
|
||||
- If you have assistants in different languages, you can add a button for each of these languages.
|
||||
6. If you are using Assist with your voice, enable **Start listening**.
|
||||
7. If you are using Assist with your voice, enable **Start listening**.
|
||||
- If you don't want to use voice but just want to type, you do not need to enable listening.
|
||||
7. **Save** your new button card.
|
||||
8. **Save** your new button card.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user