Chapter 3: Alertwerks Plus Mqtt Features; Mqtt Supported Features; Mqtt Topics - Black Box EME160A User Manual

CHAPTER 3: ALERTWERKS PLUS MQTT FEATURES

3.1 MQTT SUPPORTED FEATURES

For AlertWerks Plus products, MQTT can be enabled in the Settings menu.
The current implementation supports MQTT v3.1.1 without encryption as described here:
https://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.pdf
AlertWerks Plus products use JSON strings to relay sensor information. The MQTT Data type is JSON.
The following features are supported:
• sending sensor status change events on appropriate events from ALL sensors (wired, virtual, etc.)
• periodically sending (updating) all sensor values via MQTT
NOTE: The interval is set on WebUI.
• defining up to 4 MQTT servers in settings
NOTE: The device will randomly select a server to send the MQTT values
The AlertWerks Plus units can queue up to 1,020 MQTT messages if the connection to the MQTT server is lost. These
messages contain status and value changes for all online sensors.
The messages in the queue are saved even when the device is powered off. They will be re-sent to the MQTT server
once the connection has been reestablished.

3.1.1 MQTT TOPICS

AlertWerks Plus topics:
spp/<DEVICE_MAC_ADDRESS>/sensor/status_change/<SENSOR_COMPOUND_ID>
spp/<DEVICE_MAC_ADDRESS>/sensor/value_change/<SENSOR_COMPOUND_ID>
NOTE: These topics are used for ALL sensor types.
8
1.877.877.2269 1.877.877.2269 BLACKBOX.COM BLACKBOX.COM
NEED HELP?
LEAVE THE TECH TO US
LIVE 24/7
TECHNICAL
SUPPORT
1.877.877.2269