MQTT Communication Protocol
97Pages

MQTT Communication Protocol series Wilow® wireless se nsors MQTT – COMMUNICATION PROTOCOL Rethinking Sensing Technology Beanair GmbH “Rethinking sensing technology

Wilow® wireless sensors MQTT Communication Protocol Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol series Wilow® wireless se nsors Disclaimer The contents are confidential and any disclosure to persons other than the officers, employees, agents or subcontractors of the owner or licensee of this document, without the prior written consent of Beanair GmbH, is strictly prohibited. Beanair makes every effort to ensure the quality of the information it makes available. Notwithstanding the foregoing, Beanair does not make any warranty as to the information contained herein, and does not accept any liability for any injury, loss or damage of any kind incurred by use...

MQTT Communication Protocol series Wilow® wireless se nsors Beanair GmbH “Rethinking sensing

MQTT Communication Protocol series 7.3 Wilow® wireless se nsors Beanair GmbH “Rethinking sensing

MQTT Communication Protocol series Wilow® wireless se nsors Beanair GmbH “Rethinking sensing technology

MQTT Communication Protocol series Wilow® wireless se nsors Beanair GmbH “Rethinking sensing technology”

MQTT Communication Protocol series Wilow® wireless se nsors Beanair GmbH “Rethinking sensing technology”

MQTT Communication Protocol series Wilow® wireless se nsors For general contact, technical support, to report documentation errors and to order manuals, contact Beanair Technical Support Center (BTSC) at: tech-support@Beanair.com For detailed information about where you can buy the Beanair equipment/software or for recommendations on accessories and components visit: www.Beanair.com To register for product news and announcements or for product questions contact Beanair’s Technical Support Center (BTSC). Our aim is to make this user manual as helpful as possible. Keep us informed of your...

Wilow® wireless sensors MQTT Communication Protocol Beanair GmbH Rethinking sensing technology'

Wilow® wireless sensors MQTT Communication Protocol Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol series Wilow® wireless se nsors This document covers the different frames exchanged between BeanDevice ® Wilow® MQTT module and supervision softwares. Messages exchanged are OTAC, SubProfiles reporting/update frames and module commands. Useful extracted information from the data consumer side is described at the end of the document. In order to have clearer understanding of this document it is highly important to review the BEANDEVICE® WILOW® USER MANUAL Technical note. Beanair GmbH and Data acquisition modes available on the BeanDevice® Wilow® “Rethinking...

MQTT Communication Protocol series MQTT module OTAC frames Wilow® wireless se nsors • The different OTACs frames sent to configure the MQTT module. MQTT module SubProfiles • The different subprofiles frames sent by BeanDevice Wilow . OTAC Over MQTT structure • Description of the structure of the frame that the user have to build to control the Wilow device. Device channel's data format • How device channel's data are published using the MQTT protocol. Device profiles Beanair GmbH • The current configuration of the device “Rethinking sensing techn

Wilow® wireless sensors MQTT Communication Protocol The different OTAC frames sent to the MQTT module are identified using the MQTT module ID and the specific OTAC Id, where : MQTT_MODULE_CONFIG_MESS_ID = 0x90 The OATC IDs are presented as follow: Table 1: Different MQTT cartographies IDs Beanair GmbH Rethinking sensing technology'

Wilow® wireless sensors MQTT Communication Protocol 5.2 START MODULE FRAME This command starts the MQTT module: Table 4: Stop module frame contents 5.5 CLIENT ID AND KEEP-ALIVE TIMER SET The Client ID is used by the broker to distinguish each connected MQTT client, so it has to be unique to the broker. If the same Client ID is detected in a CONNECT frame, the broker will assume that the same client is resending a new CONNECT frame and will disconnect the socket. Beanair GmbH Rethinking sensing technology'

Wilow® wireless sensors MQTT Communication Protocol For this reason, the user is given the choice to supply his own ClientId or to generate it randomly in the BeanDevice® Wilow®. The randomly generated Client Id is a safer option. If the user supplies a ClientId with characters outside these "ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz0123456789" with a Length >23, an error should be prompt while typing. If the user supplies a zero-length ClientId, the Clean Session bit in the CONNECT frame must be set to 0, otherwise, the Broker will reject the connection and return a CONNACK...

MQTT Communication Protocol Wilow® wireless sensors Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors Table 11: OTAC Over MQTT topic set frame contents Beanair GmbH Rethinking sensing technology'

Wilow® wireless sensors MQTT Communication Protocol 6.1 BEANDEVICE® WILOW® MQTT MODULE SUB-PROFILE ID Below is the different message identifiers used to report SubProfiles to supervision software. The profile ID to target the MQTT module is fixed to MQTT_MODULE_PROFILE_ID = 0x90. Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors Table 17: LWT settings report frame contents If the user wants to "disable" Publishing a device's channel, the "Enable Publishing" byte must be set to 0x00. The device's channel topic can be updated on-the-fly, meaning the user doesn't need to stop the module to configure new one. If the (Retain_flag == true), the last device's channel data will be saved in the Broker and transmitted whenever a data consumer device subscribes to that Topic. Beanair GmbH Rethinking sensing technology'