Skip to main content
Version: TAO v2.x

Using MQTT on windows

Using the internal MQTT broker​

This page explains how you can access your MQTT server under windows, retrieve uplink packets and send downlink packets using MQTTX (https://mqttx.app/downloads).

MQTTX connection​

  • Open the MQTTX application, and create a new connection
  • Configure it with:

    • Name : friendly name

    • Host protocol: mqtt://

    • Host ip: ip of server gateway

    • Port: 1883

    • Client ID: use the pre-configured one

    • Username: tao

    • Password: tao

    • SSL/TLS: off

    • MQTT Version: 3.1

    • let all others fields with the default settings

    • click Connect when finished

  • Default uplink topic is /uplink-topic on the MQTT server

  • On the MQTTX application

    • click on New Subscription
    • configure Topic: /uplink-topic

  • Each new uplink is added in the history panel:

  • As the payload is JSON based, you can select JSON in the upper left combo box to have it indented

  • Default topics are /downlink-topic and /downlink-status-topic

  • The different downlink delivery failure causes are described here (search for DeliveryFailedCause in the DevEUI_downlink_Sent report).

  • On the MQTTX application

    • click on New Subscription
    • configure Topic: /downlink-topic
    • click on New Subscription
    • configure Topic: /downlink-status-topic

  • At the end of the panel, you have a formular to send data

    • configure destination to /downlink-topic

    • copy and paste the following JSON extract :

      {
          "DevEUI_downlink": {
             "DevEUI": "70B3D53260001A75",
             "FPort": "2",
             "Confirmed": "0",
             "FlushDownlinkQueue": "1",
             "payload_hex": "0304FD"
          }
      }

    • press the arrow button to send the downlink message
    • you then receive a first message on the /downlink-topic, it is the exact sent message
    • you later on receive the transmission status in the /downlink-status-topic, in our exemple, the downlink is rejected due to an Invalid DevEUI