Page History
This document has only the specific information about the device connection settings and its address syntax.
Refer to the User Guide for more information on the Device Module.
On this page:
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Summary
Communication Driver Information
Driver name
MQTT
Assembly Name
T.ProtocolDriver.MQTT
Assembly Version
Any device compatible with the MQTT protocol
Driver Name: MQTT
Version 3.0.3.0
Available for Linux
False
Devices supported
Any device compatible with the MQTT protocol
Multiplatform runtime
Manufacturer:
Manufacturer
N/A (Not Applicable)
Protocol: MQTT
Interface: TCP/IP
Models:1756-L8X. Micro850. Others.
On This Page:
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Module Configuration
This document has only information about the device connection settings and its address syntax.
For further Information, see:
MQTT (Message Queuing Telemetry Transport) is a machine-to-machine (M2M)/"Internet of Things" connectivity protocol
Interface
TCP/IP
PC Requirements
Ethernet port
Implemented Methods
Channels Configuration
Protocol Options
Not used in this driver.
Nodes Configuration
Station Configuration
Station syntax: <BrokerURL>; <Port>; <ClientID>; [Username]; [Password]; [NetworkSecurity]; [X509Certificate]; <Qos>; <KeepAlive>
Where:
- <BrokerURL>: MQTT Broker (Server) name. It must be the same name is configured in the bind_address parameter in the Broker.
- <Port>: MQTT Broker port. It must be the same port is configured in the Broker to be listening. Default value is 1883.
- <ClientID>:Indicates the client identification used to connect to the MQTT Broker.
- [Username]: Optional.Username defined on MQTT Broker. This will be requested if the Broker has the allow_anonymous parameter as false. Whether this parameter is set as true on Broker, keep this field empty. Default value is empty.
- [Password]: Optional. Password defined on MTQQ Broker. This will be requested if the Broker has the allow_anonymous parameter as false. Whether this parameter is set as true on Broker, keep this field empty. Default value is empty.
- [NetworkSecurity]: Optional. If the Broker works using certificates, this field is mandatory and must match the same option defined in the Broker. Options are: None, TLSv1.0, TLSv1.1 and TLSv1.2.
- [X509Certificate]: Optional. Path of X509 Certificate using TLS v1.0. This must be the complete path of X509 certificate in the client computer. The certificate must be installed in the computer.
- <QoS>: Quality of Service (QoS) is an agreement between sender and receiver of a message regarding the guarantees of delivering a message. There are three QoS levels:
- AtMostOnce:This service level guarantees a best-effort delivery. However, there is no guarantee of delivery, due to the recipient not acknowledging the receipt of the message.
- AtLeastOnce:This service guarantees that a message is delivered at least one time to the receiver. Default Value.
- ExactlyOnce: Highest level of service. It is safer, but slower when compared to the others. When the message flow is complete, all parties involved in the communication are sure the message was sent and delivered with success.
- AtMostOnce:This service level guarantees a best-effort delivery. However, there is no guarantee of delivery, due to the recipient not acknowledging the receipt of the message.
| Info | ||
|---|---|---|
| ||
Use QoS 0 when:
Use QoS 1 when:
Use QoS 2 when:
|
- <KeepAlive>: Ensures that the connection between the Broker and Client is open and both parties are aware of the connection. Default value is 10 seconds.
| Info |
|---|
When creating solutions that the PrimaryStation IP will be set by script, using the Node properties, you can set the Broker URL to 1.1.1.1 to force it to try establish a connection, avoiding timeouts. |
| Info | ||
|---|---|---|
| ||
One of the easiest ways to install the certificate on client computer is to use the wizard to import the certificates is through the "Internet Options" to import the certificate in the "Trusted Root Certification Authorities”. You need to import the certificate in DER format. |
Station Examples
1. Broker configuration with no Username and Password and no SSL/TLS
Station Configuration
BrokerURL: test.mosquitto.org
Port: 1883
ClientID: MyClient1
Username: <empty>
Password: <empty>
NetworkSecurity: None
X509Certificate: <empty>
QoS: AtLeastOnce
KeepAlive: 10
2. Broker configuration with Username and Password and no SSL/TLS
Station Configuration
BrokerURL: MSI
Port: 1883
ClientID: MyClient1
Username: Guest
Password: 1234
NetworkSecurity: None
X509Certificate: <empty>
QoS: AtLeastOnce
KeepAlive: 10
3. Broker configuration with SSL/TLS and no Username and Password
Station Configuration
BrokerURL: MSI
Port: 8883
ClientID: MyClient1
Username: <empty>
Password: <empty>
NetworkSecurity: TLSv1.0
X509Certificate: C:/Certificates/mqtt_ca.der
QoS: AtLeastOnce
KeepAlive: 10
4. Broker configuration with SSL/TLS and Username and Password
Station Configuration
BrokerURL: MSI
Port: 8883
ClientID: MyClient1
Username: Guest
Password: 1234
NetworkSecurity: TLSv1.2
X509Certificate: C:/Certificates/mqtt_ca.der
QoS: AtLeastOnce
KeepAlive: 10
Points Configuration
Address
The syntax for the MQTT communication points is called Topic:
- Topic is a string that is used by the broker to filter messages for each connected client. A topic consists of one or more topic levels. Each topic level is separated by a forward slash (topic level separator). Wildcards are not supported.
E.g.: USA/Houston/Station1/Level
Driver Revision History
MQTT Revision History | |
|---|---|
Version | Notes |
3.0.0.3 | Initial release on new documentation standards. |
In this section...
| Page Tree | ||||
|---|---|---|---|---|
|