jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-25 10:17:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

m-integrations 1/2: restart HA after changing config (#32646)

Browse Source
This commit is contained in:
c0ffeeca7 2024-05-08 22:47:43 +02:00 committed by GitHub
parent 97edda3db4
commit 73242324d2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
16 changed files with 97 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
source/_integrations/manual.markdown
View File

@ -10,13 +10,17 @@ ha_iot_class: Calculated
ha_platforms:
- alarm_control_panel
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `manual` alarm control panel platform enables you to create an alarm system in Home Assistant.
The `manual` alarm control panel {% term integration %} enables you to create an alarm system in Home Assistant.
## Configuration
To enable this, add the following lines to your `configuration.yaml` file:
To enable this {% term integration %}, add the following lines to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

10
source/_integrations/manual_mqtt.markdown
View File

@ -9,13 +9,16 @@ ha_iot_class: Local Push
ha_platforms:
- alarm_control_panel
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `mqtt` platform extends the [manual alarm](/integrations/manual) by adding support for MQTT control of the alarm by a remote device. It can be used to create external keypads which simply change the state of the manual alarm in Home Assistant.
The `mqtt` {% term integration %} extends the [manual alarm](/integrations/manual) by adding support for MQTT control of the alarm by a remote device. It can be used to create external keypads which simply change the state of the manual alarm in Home Assistant.
It's essentially the opposite of the [MQTT Alarm Panel](/integrations/alarm_control_panel.mqtt/) which allows Home Assistant to observe an existing, fully-featured alarm where all of the alarm logic is embedded in that physical device.
The integration will accept the following commands from your Alarm Panel via the `command_topic`:
The {% term integration %} will accept the following commands from your Alarm Panel via the `command_topic`:
- `DISARM`
- `ARM_HOME`
@ -37,7 +40,8 @@ When the state of the manual alarm changes, Home Assistant will publish one of t
## Configuration
To use your panel in your installation, add the following to your `configuration.yaml` file:
To use your panel in your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

8
source/_integrations/marytts.markdown
View File

@ -9,13 +9,17 @@ ha_domain: marytts
ha_platforms:
- tts
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `marytts` text-to-speech platform uses [MaryTTS](http://mary.dfki.de/) text-to-speech engine to read a text with natural sounding voices.
The `marytts` text-to-speech {% term integration %} uses [MaryTTS](http://mary.dfki.de/) text-to-speech engine to read a text with natural sounding voices.
## Configuration
To enable text-to-speech with MaryTTS, add the following lines to your `configuration.yaml`:
To enable text-to-speech with MaryTTS, add the following lines to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

6
source/_integrations/mastodon.markdown
View File

@ -11,6 +11,9 @@ ha_iot_class: Cloud Push
ha_platforms:
- notify
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `mastodon` platform uses [Mastodon](https://joinmastodon.org/) to deliver notifications from Home Assistant.
@ -22,7 +25,8 @@ If you want to grant only required accesses, uncheck all checkboxes then check o
### Configuration
To add Mastodon to your installation, add the following to your `configuration.yaml` file:
To add Mastodon to your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

8
source/_integrations/matrix.markdown
View File

@ -12,9 +12,12 @@ ha_platforms:
ha_integration_type: integration
ha_codeowners:
- '@PaarthShah'
related:
- docs: /docs/configuration/
title: Configuration file
---
This integration allows you to send messages to matrix rooms, as well as to react to messages in matrix rooms. Reacting to commands is accomplished by firing an event when one of the configured commands is triggered.
This {% term integration %} allows you to send messages to matrix rooms, as well as to react to messages in matrix rooms. Reacting to commands is accomplished by firing an event when one of the configured commands is triggered.
There is currently support for the following device types within Home Assistant:
@ -22,6 +25,9 @@ There is currently support for the following device types within Home Assistant:
## Configuration
To enable the Matrix {% term integration %}, add it to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry
matrix:

6
source/_integrations/maxcube.markdown
View File

@ -11,6 +11,9 @@ ha_platforms:
- binary_sensor
- climate
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
[eQ-3 MAX!](https://www.eq-3.com/products/homematic/detail/max-cube-lan-gateway.html) integration for Home Assistant allows you to connect eQ-3 MAX! components via the eQ-3 MAX! Cube. The components connects to the eQ-3 MAX! Cube via TCP and automatically makes all supported integrations available in Home Assistant. The name for each device is created by concatenating the MAX! room and device names.
@ -34,7 +37,8 @@ Supported Devices:
### One gateway
A `maxcube` section must be present in the `configuration.yaml` file and contain the following options as required:
A `maxcube` section must be present in the {% term "`configuration.yaml`" %} file and contain the following options as required:
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

16
source/_integrations/media_extractor.markdown
View File

@ -10,15 +10,19 @@ ha_domain: media_extractor
ha_integration_type: integration
ha_codeowners:
- '@joostlek'
related:
- docs: /docs/configuration/
title: Configuration file
---
The `media_extractor` integration gets a stream URL and sends it to a media player entity. This integration can extract entity specific streams if configured accordingly.
The `media_extractor` {% term integration %} gets a stream URL and sends it to a media player entity. This integration can extract entity specific streams if configured accordingly.
<div class='note'>
Media extractor doesn't transcode streams, it just tries to find a stream that matches the requested query.
</div>
To use the media extractor service in your installation, add the following to your `configuration.yaml` file:
To use the media extractor service in your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry
@ -81,10 +85,10 @@ This will download the file from the given URL.
There is also a service that will directly return the URL in the response of the service.
| Service data attribute | Optional | Description |
|-----------------------| -------- |-----------------------------------------------------------------------------------------------------------|
| `url` | no | The URL of the media to extract. |
| `format_query` | yes | The query that will be used to select the right media. |
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ------------------------------------------------------ |
| `url` | no | The URL of the media to extract. |
| `format_query` | yes | The query that will be used to select the right media. |
### Cookies

8
source/_integrations/mediaroom.markdown
View File

@ -11,11 +11,15 @@ ha_domain: mediaroom
ha_platforms:
- media_player
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `mediaroom` integration allows you to control a [Mediaroom](https://en.wikipedia.org/wiki/Ericsson_Mediaroom) Set-Top Box (STB) from Home Assistant.
The `mediaroom` {% term integration %} allows you to control a [Mediaroom](https://en.wikipedia.org/wiki/Ericsson_Mediaroom) Set-Top Box (STB) from Home Assistant.
To add a Mediaroom STB to your installation, add the following to your `configuration.yaml` file:
To add a Mediaroom STB to your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

8
source/_integrations/melissa.markdown
View File

@ -12,9 +12,12 @@ ha_domain: melissa
ha_platforms:
- climate
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `melissa` integration is the main integration to connect to a [Melissa Climate](https://seemelissa.com/) A/C control.
The `melissa` {% term integration %} is the main integration to connect to a [Melissa Climate](https://seemelissa.com/) A/C control.
There is currently support for the following device types within Home Assistant:
@ -24,7 +27,8 @@ The climate platform will be automatically configured if Melissa integration is
## Configuration
To set the Melissa integration up, add the following information to your `configuration.yaml` file:
To set the Melissa {% term integration %} up, add the following information to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

6
source/_integrations/meraki.markdown
View File

@ -9,6 +9,9 @@ ha_domain: meraki
ha_platforms:
- device_tracker
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
Use your Meraki AP as device tracker. Note that Meraki will see all devices, not only connected to the network.
@ -26,7 +29,8 @@ Use your Meraki AP as device tracker. Note that Meraki will see all devices, not
## Configuration
After you configure access to the Meraki CMX API, add the following to your `configuration.yaml` file:
After you configure access to the Meraki CMX API, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

8
source/_integrations/message_bird.markdown
View File

@ -9,9 +9,12 @@ ha_domain: message_bird
ha_platforms:
- notify
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `MessageBird` notification platform sends notifications as SMS messages using [MessageBird](https://www.messagebird.com/) to your mobile phone.
The `MessageBird` notification {% term integration %} sends notifications as SMS messages using [MessageBird](https://www.messagebird.com/) to your mobile phone.
## Setup
@ -19,7 +22,8 @@ Go to [MessageBird](https://www.messagebird.com/) to retrieve your API key.
## Configuration
To enable MessageBird notifications in your installation, add the following to your `configuration.yaml` file:
To enable MessageBird notifications in your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

8
source/_integrations/mfi.markdown
View File

@ -12,6 +12,9 @@ ha_platforms:
- sensor
- switch
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
There is currently support for the following device types within Home Assistant:
@ -21,9 +24,10 @@ There is currently support for the following device types within Home Assistant:
## Sensor
The `mfi` sensor platform to allow you to monitor [mFi mPort interface and sensors](https://www.ubnt.com/mfi/mport/).
The `mfi` sensor {% term integration %} to allow you to monitor [mFi mPort interface and sensors](https://www.ubnt.com/mfi/mport/).
To add this platform to your installation, add the following to your `configuration.yaml` file:
To add this {% term integration %} to your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

8
source/_integrations/microsoft.markdown
View File

@ -9,13 +9,17 @@ ha_domain: microsoft
ha_platforms:
- tts
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `microsoft` text-to-speech platform uses the [TTS engine of the Microsoft Speech Service](https://learn.microsoft.com/azure/cognitive-services/speech-service/text-to-speech) to read a text with natural sounding voices. This integration uses an API that is part of the Cognitive Services offering and is known as the Microsoft Speech API. For this integration to work, you need a free API key. You can use your [Azure subscription](https://azure.microsoft.com) to create an [Azure Speech resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices).
The `microsoft` text-to-speech {% term integration %} uses the [TTS engine of the Microsoft Speech Service](https://learn.microsoft.com/azure/cognitive-services/speech-service/text-to-speech) to read a text with natural sounding voices. This integration uses an API that is part of the Cognitive Services offering and is known as the Microsoft Speech API. For this integration to work, you need a free API key. You can use your [Azure subscription](https://azure.microsoft.com) to create an [Azure Speech resource](https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices).
## Configuration
To enable text-to-speech with Microsoft, add the following lines to your `configuration.yaml`:
To enable text-to-speech with Microsoft, add the following lines to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry

4
source/_integrations/microsoft_face.markdown
View File

@ -9,7 +9,7 @@ ha_domain: microsoft_face
ha_integration_type: integration
---
The `microsoft_face` integration platform is the main integration for Microsoft
The `microsoft_face` integration {% term integration %} is the main integration for Microsoft
Azure Cognitive service
[Face](https://azure.microsoft.com/products/cognitive-services/vision-services).
All data are stored in your own private instance in the Azure cloud.
@ -26,7 +26,7 @@ Please note that all keys on cognitive services must be recreated every 90 days.
## Configuration
To enable the Microsoft Face integration,
To enable the Microsoft Face {% term integration %},
add the following to your `configuration.yaml` file:
```yaml

8
source/_integrations/microsoft_face_detect.markdown
View File

@ -7,9 +7,12 @@ ha_iot_class: Cloud Push
ha_release: 0.38
ha_domain: microsoft_face_detect
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `microsoft_face_detect` image processing platform allows you to use the
The `microsoft_face_detect` image processing {% term integration %} allows you to use the
[Microsoft Face Identify](https://azure.microsoft.com/products/cognitive-services/)
API through Home Assistant. This platform enables you to detect face on camera
and fire an event with attributes.
@ -28,6 +31,9 @@ The free version of the Microsoft Face identify API limits the number of request
### Configuration
To enable the integration, add it to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry
image_processing:

8
source/_integrations/microsoft_face_identify.markdown
View File

@ -7,9 +7,12 @@ ha_iot_class: Cloud Push
ha_release: 0.37
ha_domain: microsoft_face_identify
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
---
The `microsoft_face_identify` image processing platform lets you use
The `microsoft_face_identify` image processing {% term integration %} lets you use
[Microsoft Face identify](https://azure.microsoft.com/products/cognitive-services/)
API through Home Assistant. This platform allow you do identify persons on
camera and fire an event with attributes.
@ -28,6 +31,9 @@ The free version of the Microsoft Face identify API limits the number of request
### Configuration
To enable this integration, add it to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry
image_processing: