Skip to main content

MQTT

  • How to debug my MQTT communication
     
    Here is an article to help you debug your MQTT gateway.
    If you are not really familiar with MQTT environment we suggest you this really well designed website. 
     

    Test your MQTT connection with an MQTT client :

    If you're not seeing any connection from your Tower/Bridge after you have configured it.
    The first step would be to test your credential/parameters with an other MQTT client.
    Here is a list of potential MQTT client you can use:
    1. Mosquitto : https://mosquitto.org/
    2. MQTTFx : https://mqttfx.jensd.de/
    If you have the correct configuration and you can connect using an other MQTT client and not with the Box you can go on with the next step.
    If you are not able to connect to your MQTT broker even with on of those, that means your credential/parameters are either wrong or you are missing something.
     

    TEST WITH MQTTfx 1.7.1 TUTORIAL :

     

    PointDexclamationSmall.png AIM OF THIS TEST: Be sure that your MQTT broker is accessible with an MQTT client and correctly configured. Check also if an MQTT client (your laptop) can connect to it if the box cannot.

     

    If you can connect to the Broker after this test :
    -> The targeted MQTT broker is available and you have the right parameters.
    -> Then the issue would be :
              -> The Box MQTT gateway is not correctly setup. Please double check your MQTT config.
              -> The Box has an issue -> contact support.wattsense.com
     
    REQUIREMENTS: You'll need your MQTT broker connection information
    1. Broker Address
    2. MQTT Port (1883,8883,etc..)
    3. Client ID
    4. Authentication information (if required)
    5. Certificate (if required)
    -> Launch MQTTFX :
    Then create your new profile (MQTT client)
    mceclip0.png
    1. Change your profile name
    2. Select "MQTT Broker" in the profile Type
    3. Fill the information with your broker setup.
    4. If your MQTT broker authentication require a "Basic Authentication", switch to the User Credentials Tab and fill Username/Password.
    mceclip2.png
    -> If your MQTT broker requires a TLS secured connection click on the SSL/TLS.
     

     

    PointDexclamationSmall.png
    IMPORTANT INFORMATION ABOUT SECURITY IN MQTT SSL/TLS:
     
    The default port for MQTT TLS connection is : 8883
    This implies a connection using certificates.
    Certificates are security files that allows you to authenticate to your broker.
    If you are using a TLS secured authentication please be sure that you have loaded your CA certificate in the SSL/TLS tab for MQTTFX (see below) and that you have also load it in the Box during your first test.
     
     
    SSL/TLS COMMUNICATION:
     
    (1) -> Enable the SSL/TLS
    Choose the certificate you want to use :
    mceclip3.png

     

    PointDexclamationSmall.png
    TIPS
    It can happen that your broker is not using custom CA certificate but Public one.
    In that case, you will still have to load them in the Box. Because we do not stored them by default. Using MQTTFx, if you only enabled the SSL/TLS tickbox without specifying the CA certificate, it will automatically load the public certificate (as your laptop have access to them automatically).

     

     
    If you have any problem, please do not hesitate to contact us: Wattsense Support
     
    See more