B4i Library MQTT - MQ Telemetry Transport for B4i

This library was made based on MQTT Protocol

Installation instructions:

- Copy the *.a and *.h files into the folder "Libs" in your MAC or in your MAC HOSTED by AnywhereSoftware, normally in "B4i-MacServer\Libs" folder

-Copy the iMQTT.xml to your custom libraries folder in B4i
- Select in your REFERENCED LIBRARIES

Version history:
V2.0.0 (First public release - Donationware):
- Initial version


iMQTT

Author: Alberto Iglesias (alberto@visualnet.inf.br)
Version: 2

• 
  
  
  • MQTT
    Events:
    • Received (Message As String)
    • onConnect (Status As Int)
    • onDisconnect (Status As Int)
    • onInitialized ( As )
    • onPublish (Status As Int)
    • onSubscribe (Topic as String As )
    Methods:
    • ClearWill
    • Connect (Broker As String, Username As String, Password As String, Port As String)
      Connect to Broker
    • Disconnect
      Disconnect from Broker
    • Initialize (EventName As String)
      Initializes the object.
    • IsConnected As BOOL
      Get status of connection
    • Publish: (Topic As String, Payload As String, qos As Int, Retained As BOOL)
      Publish a message to Topic
    • Reconnect
    • Subscribe2: (Topic As String, qos As int)
      Subscribe into a Topic with Quality of Service
    • Subscribe: (Topic As String)
      Subscribe into a Topic
    • Unsubscribe: (Topic As String)
      Unsubscribe a Topic
    Properties:
    • Author As String [read only]
      Author of this Library
    • ClientID As String
      Set/Get the Client ID for broker know who you are. Default = UUID from Device
    • DebugMode As BOOL
      Enable/Disable Debug mode from Library
    • QoS_AtLeastOnce As Int [read only]
      QoS1, At least once: The message is always delivered at least once. It might be delivered multiple times if there is a failure before an acknowledgment is received by the sender. The message must be stored locally at the sender, until the sender receives confirmation that the message has been published by the receiver. The message is stored in case the message must be sent again.
    • QoS_AtMostOnce As Int [read only]
      QoS0, At most once: The message is delivered at most once, or it may not be delivered at all. Its delivery across the network is not acknowledged. The message is not stored. The message could be lost if the client is disconnected, or if the server fails. QoS0 is the fastest mode of transfer. It is sometimes called "fire and forget".
    • QoS_ExactlyOnce As Int [read only]
      QoS2, Exactly once
    • Version As NSString* [read only]
      Library Version

How works the MQTT protocol

Communication Infrastructure

References:
http://mqtt.org/
http://public.dhe.ibm.com/software/dw/webservices/ws-mqtt/mqtt-v3r1.html
Mosquitto Broker: http://mosquitto.org/



* This version is fully functional, the only one difference is when publishing a message the text "Donationware" is delivery with your message.
Please consider a simple €10 donation and I send to you the Library without "Donationware" text in a publish method.

Already available in B4J too: look in https://www.b4x.com/android/forum/threads/mqtt-mq-telemetry-transport-for-b4j.48184/

Already available in B4A too: look in https://www.b4x.com/android/forum/threads/mqtt-mq-telemetry-transport-for-b4a.48167/

 

[klarsys]

Request a fix for this issue.

Gentle reminder.

 

[Alberto Iglesias]

Uhuuuuuu!!! I completely forgot! Sorry! Thanks for remember me!

This is the fix for this problem, please try with this new version

 

[klarsys]

Thank you, @Alberto Iglesias. Now setWill() is working!

However, these issues still remain:
1. onConnect() gets called only on connection success. There is no callback for connection failure. e.g. when broker is not available or if it is mis-typed.
2. After a successful connection, there is no connectionLost() event.
3. Topic is missing in Received() callback.
4. [Minor] Need APIs to set connection timeout and keep alive period.

Above functionality is needed to make error resilient MQTT app.

Thanks again for your support.

 

[klarsys]

Hi @Alberto Iglesias, please consider resolving above issues.