From 97dc2bbf914721d9fe56616f616a93c4ff2c3e7c Mon Sep 17 00:00:00 2001 From: Gerard Hickey Date: Sun, 23 Aug 2026 16:59:16 -0400 Subject: [PATCH] docs: Update docs concerning waev.app broker authentication Signed-off-by: Gerard Hickey --- CHANGELOG.md | 1 + docs/packet-capture.md | 9 +++++++++ 2 files changed, 10 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 73f6da7..6a5ce29 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -158,6 +158,7 @@ semantic versioning. and Configuration now sit under a single **Settings** gear menu, leaving Dashboard, Real-time, Contacts, Mesh Graph and Logs on the bar. The current page is highlighted, including the gear when a settings page is open. +- Added notes on connecting to waev.app MQTT brokers to the `packet_capture.md` file. ### Added diff --git a/docs/packet-capture.md b/docs/packet-capture.md index d2d5c5e..8c01ae1 100644 --- a/docs/packet-capture.md +++ b/docs/packet-capture.md @@ -175,6 +175,13 @@ jwt_renewal_interval = 43200 # Default proactive refresh cadence (12 hours) # mqtt1_jwt_renewal_interval = 1800 ``` +**Note**: When connecting to waev.app brokers the default settings will cause the connection not to authenticate properly. Please use the following settings on the MQTT connection for the waev.app brokers. + +```ini +mqttN_jwt_ttl_seconds = 3600 +mqttN_jwt_renewal_interval = 3500 +``` + --- ## Packet Format @@ -310,6 +317,8 @@ Note that `rc=` on a *disconnect* is a paho `MQTT_ERR_*` code, not a CONNACK cod `rc=7` is a lost connection and `rc=2` is a protocol error. They do not mean the same thing as the numbers in a `Failed to connect` line. +**Note**: If the MQTT connection that is failing is attempting to connect to waev.app brokers, please see the [Status Publishing and MQTT auth (JWT)](#status-publishing-and-mqtt-auth-jwt) section. + ### No Packets Being Published 1. **Verify MQTT connection** - Check logs for "Connected to MQTT broker"