Skip to content

Commit

Permalink
Update HA-MQTT.md
Browse files Browse the repository at this point in the history
Formatting updates.
  • Loading branch information
BigThunderSR authored Dec 28, 2024
1 parent 4ee3c5f commit 37ea812
Showing 1 changed file with 14 additions and 9 deletions.
23 changes: 14 additions & 9 deletions HA-MQTT.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ mode: single
**MQTT button auto discovery is enabled starting at v1.14.0 which sends/triggers the defaults of each command.**
* Buttons are added disabled by default because it's easy to accidentally press the wrong button and trigger an action at an inopportune time. Enable at your own risk and you assume all responsibility for your actions.
* Buttons are added disabled by default because it's easy to accidentally press the wrong button and trigger an action at an inopportune time.
* Enable at your own risk and you assume all responsibility for your actions.
* All available buttons for all vehicles are included for now, so only enable the buttons you need and/or work for your vehicle.
#### The following isn't strictly necessary starting at v1.14.0, but still available if needed or for sending customized commands
Expand Down Expand Up @@ -115,9 +116,10 @@ icon: 'mdi:map-marker'

* **MQTT Auto-Discovery for Polling Status Sensors for HA Added Starting at v1.16.0**
* Polling Status Message, Timestamp and True/False Sensor from last command run are published to MQTT auto-discovery topics and are grouped in a MQTT device grouping for all command status sensors for the same vehicle.
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0. Default is "false".
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0.
* Default is "false".

To add manually if wanted:
#### To add manually if wanted:
Create a MQTT binary sensor in Home Assistant

```yaml
Expand All @@ -141,9 +143,10 @@ mqtt:

* **MQTT Auto-Discovery for Polling Status Sensors for HA Added Starting at v1.16.0**
* Polling Status Message, Timestamp and True/False Sensor from last command run are published to MQTT auto-discovery topics and are grouped in a MQTT device grouping for all command status sensors for the same vehicle.
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0. Default is "false".
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0.
* Default is "false".

To add manually if wanted:
#### To add manually if wanted:
Create a MQTT sensor in Home Assistant

```yaml
Expand Down Expand Up @@ -172,9 +175,10 @@ mqtt:
Important Note: Command needs to be run at least once before the sensor is visible in HA.
```
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0. Default is "false".
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0.
* Default is "false".
To add manually if wanted:
#### To add manually if wanted:
Create a MQTT sensor in Home Assistant for each command status you want to monitor. Below is an example for the getLocation command and other commands follow a similar format.
```yaml
Expand All @@ -195,9 +199,10 @@ mqtt:
* **MQTT Auto-Discovery for Command Status Sensors for HA Added Starting at v1.15.0**
* Command Status and Timestamp from last command run are published to MQTT auto-discovery topics and are grouped in a MQTT device grouping for all command status sensors for the same vehicle.
* Command needs to be run at least once before the sensor is visible in HA.
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0. Default is "false".
* Set 'MQTT_LIST_ALL_SENSORS_TOGETHER="true"' to group all the sensors under one MQTT device starting at v1.17.0.
* Default is "false".
To add manually if wanted:
#### To add manually if wanted:
Create a MQTT sensor in Home Assistant for each command timestamp you want to monitor. Below is an example for the getLocation command and other commands follow a similar format.
```yaml
Expand Down

0 comments on commit 37ea812

Please sign in to comment.