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-18 14:56:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

MQTT: fix markdown (#32495)

Browse Source
This commit is contained in:
c0ffeeca7 2024-04-28 15:22:08 +02:00 committed by GitHub
parent 782a2bc294
commit 5881b892fd
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 18 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
source/_integrations/mqtt.markdown
View File

@ -112,7 +112,6 @@ MQTT (aka MQ Telemetry Transport) is a machine-to-machine or "Internet of Things
{% enddetails %} {% enddetails %}
Your first step to get MQTT and Home Assistant working is to choose a broker. Your first step to get MQTT and Home Assistant working is to choose a broker.
## Setting up a broker ## Setting up a broker
@ -139,7 +138,12 @@ Add the MQTT integration, then provide your broker's hostname (or IP address) an
3. Select **Configure**, then **Re-configure MQTT**. 3. Select **Configure**, then **Re-configure MQTT**.
<div class='note'> <div class='note'>
<p>
If you experience an error message like `Failed to connect due to exception: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed`, then turn on `Advanced options` and set [Broker certificate validation](/integrations/mqtt/#broker-certificate-validation) to `Auto`. If you experience an error message like `Failed to connect due to exception: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed`, then turn on `Advanced options` and set [Broker certificate validation](/integrations/mqtt/#broker-certificate-validation) to `Auto`.
</p>
</div> </div>
### Advanced broker configuration ### Advanced broker configuration
@ -322,7 +326,6 @@ support_url:
description: Support URL of the application that supplies the discovered MQTT item. description: Support URL of the application that supplies the discovered MQTT item.
{% endconfiguration_basic %} {% endconfiguration_basic %}
{% details "Supported abbreviations" %} {% details "Supported abbreviations" %}
```txt ```txt
@ -594,7 +597,9 @@ support_url:
'sa': 'suggested_area', 'sa': 'suggested_area',
'sn': 'serial_number', 'sn': 'serial_number',
``` ```
{% enddetails %} {% enddetails %}
{% details "Supported abbreviations for origin info" %} {% details "Supported abbreviations for origin info" %}
```txt ```txt
@ -602,6 +607,7 @@ support_url:
'sw': 'sw_version', 'sw': 'sw_version',
'url': 'support_url', 'url': 'support_url',
``` ```
{% enddetails %} {% enddetails %}
### How to use discovery messages ### How to use discovery messages
@ -1049,16 +1055,15 @@ The MQTT notification support is different than for the other [notification](/in
``` ```
<p class='img'> <p class='img'>
<img src='/images/screenshots/mqtt-notify.png' /> <img src='/images/screenshots/mqtt-notify.png' alt='Screenshot showing how to publish a message to an MQTT topic'/>
</p> </p>
The same will work for automations. The same will work for automations.
<p class='img'> <p class='img'>
<img src='/images/screenshots/mqtt-notify-action.png' /> <img src='/images/screenshots/mqtt-notify-action.png' alt='Screenshot showing how to publish a message to an MQTT topic for automations' />
</p> </p>
### Examples ### Examples
#### REST API #### REST API
@ -1119,9 +1124,16 @@ The MQTT integration will register the service `mqtt.publish` which allows publi
| `qos` | yes | Quality of Service to use. (default: 0) | | `qos` | yes | Quality of Service to use. (default: 0) |
| `retain` | yes | If message should have the retain flag set. (default: false) | | `retain` | yes | If message should have the retain flag set. (default: false) |
<p class='note'>
<div class='note'>
<p>
You must include either `topic` or `topic_template`, but not both. If providing a payload, you need to include either `payload` or `payload_template`, but not both. You must include either `topic` or `topic_template`, but not both. If providing a payload, you need to include either `payload` or `payload_template`, but not both.
</p> </p>
</div>
```yaml ```yaml
topic: homeassistant/light/1/command topic: homeassistant/light/1/command