From 07dcfc0555206dfe365b0b6372b2387341116847 Mon Sep 17 00:00:00 2001 From: Hamid Date: Mon, 19 Jun 2017 22:16:06 +0100 Subject: [PATCH] Owntracks compatibility Owntracks for be convinced to talk the correct protocol version (Protocol Level 4; MQTT 3.1.1) by setting it manually in the configuration JSON. I have tested this against my own Hassbian install (0.47.0). See the ticket that added the feature here; https://github.com/owntracks/ios/issues/444 --- source/_docs/mqtt/broker.markdown | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/source/_docs/mqtt/broker.markdown b/source/_docs/mqtt/broker.markdown index 55e3a8a1463..6a89113b26b 100644 --- a/source/_docs/mqtt/broker.markdown +++ b/source/_docs/mqtt/broker.markdown @@ -31,9 +31,13 @@ Home Assistant contains an embedded MQTT broker. If no broker configuration is g mqtt: ``` -

-This broker does not currently work with OwnTracks because of a protocol version issue. -

+### {% linkable_title Owntracks%} + +To use Owntracks with the internal broker a small configuration change must be made in order for the app to use MQTT protocol 3.1.1 (Protocol Level 4). + +In the Owntracks preferences (Android: v1.2.3+, iOS: v9.5.1+) open **Configuration Management**; Find the value named `mqttProtocolLevel` and set the value to `4`. The application will now use MQTT 3.1.1 to connect, which is compatible with the embedded broker. + +### {% linkable_title Settings %} If you want to customize the settings of the embedded broker, use `embedded:` and the values shown in the [HBMQTT Broker configuration](http://hbmqtt.readthedocs.org/en/latest/references/broker.html#broker-configuration). This will replace the default configuration.