# MQTT

The MQTT Device provides the ability to communicate with external systems by connecting to an external MQTT broker and using standard MQTT Publish / Subscribe methods to pass data to and from Designer.

Perform the following steps to add and configure an MQTT Device:

1. In the Project Explorer, find the MQTT category under Devices > Communications. Right-click on MQTT and select Add 'MQTT' Device:

2. Enter the configuration parameters required for connection to your MQTT broker:

   Property | Description
   --- | ---
   ID | You must use a unique string within the MQTT broker network. For example: “Designer-InspectionLine003”.
   IPAddress | The IP Address of the MQTT broker.
   Port | Specifies the port number over which to communicate. This TCP port must be open across all firewalls in order to work.
   UserName | The username configured on the MQTT broker. This is a required field.
   Password | The password required for the username configured on the MQTT broker. This is a required field.
   UseTLS | This configures the MQTT Device to communicate over TLS (Transport Layer Security). This setting should match the MQTT broker.
   RootCertificatePath | The Windows path to a Root Certificate file used for authentication. This should only be used if it is required by the MQTT broker.
   ClientCertificatePath | The Windows path to a Client Certificate file used for authentication. This should only be used if it is required by the MQTT broker.
   CertificatePassword | Enter the password if the Client Certificate used in the ClientCertificatePath requires a password.