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

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

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

MQTT Communication Protocol Wilow® wireless sensors series

MQTT Communication Protocol Wilow® wireless sensors series 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 of...

Wilow® wireless sensors series Beanair GmbH Rethinking sensing technology'

Wilow® wireless sensors series Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors series Beanair GmbH “Rethinking sensing tech

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

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

MQTT Communication Protocol Wilow® wireless sensors series For general contact, technical support, to report documentation errors and to order manuals, contact Beanair Technical Support Center (BTSC) at: [email protected] 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 comments...

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

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

MQTT Communication Protocol Wilow® wireless sensors series 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. For a better understanding about Wilow® System, it is highly important to review the BEANDEVICE® WILOW® user Manual and Data acquisition modes available on the BeanDevice® Wilow® Technical note. Beanair GmbH “Rethinking sensing technolo

MQTT Communication Protocol MQTT module OTAC frames Wilow® wireless sensors series • 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

MQTT Communication Protocol Wilow® wireless sensors series 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'

MQTT Communication Protocol Wilow® wireless sensors series 5.2 START MODULE FRAME This command starts the MQTT module: Table 4: Stop module frame contents Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors series 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. 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...

MQTT Communication Protocol Wilow® wireless sensors series Table 7: Password and UserName set frame contents The LWT MQTT feature can be used to inform interested devices (Should be subscribed to Will Topic, mainly data collecting machines) that the WIF Access Point disconnects abnormally or unexpectedly from the Broker. Network failure causing disconnection is detected by a keep-Alive message absence (T > 1.5*KA) that the BeanGateway commits to send every KeepAlive time period specified at its connect attempt. The Will_Retain_flag and the Will_QoS describes how the message will be transferred...

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

MQTT Communication Protocol Wilow® wireless sensors series 5.10 DEVICE'S STREAMING TOPIC SET The streaming topic is the one used by the BeanDevice® Wilow® to send all its channels measured data through MQTT. The MQTT client (data consumer side) must parse the received frame to obtain the requested channels measurements separately. Table 11: OTAC Over MQTT topic set frame contents Beanair GmbH Rethinking sensing technology'

MQTT Communication Protocol Wilow® wireless sensors series 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'