Configure MQTT for a device from the device's web UI

You can manually configure MQTT for a Connect Sensor.

Note If available, you can choose to apply an MQTT configuration that was created for a device group in which this device is included. See Apply a device group MQTT configuration.

  1. Access the web UI for Connect Sensor from the Device Summary page. The Automation Dashboard displays.

  2. Choose Services > MQTT. The MQTT Configuration page displays.

  3. From the Active MQTT Configuration list box, select Current Device Only.

  1. Click the MQTT Enabled slider button. When MQTT is enabled, the button is green. The MQTT Configuration page updates to display more options.

  2. Configure the options in the MQTT Configuration section.

    Field Description

    MQTT Spec

    Select the option that determines the format of the MQTT data and from where the data is sent. Options are:

    • MQTT on Device - No Formula Support: Raw data is sent. This is the default.

    • Digi Axess Single Value - Formula Support: A separate topic per value is sent, and includes only current data.

    • Digi Axess JSON - Formula Support: A single topic for all values is sent, and includes current and historical data.

    Send Sample Data to Digi Axess

    Enable Send Sample Data to Digi Axess if you want to send sample data to Digi Axess for further processing. This is disabled by default, and when it is disabled, no data is sent to Digi Axess.

    QoS

    Currently only one MQTT quality of service level is available.

    The 0 - at most once option is selected by default.
    Publish Retain Enable Publish Retain if you want to enable the retain flag on published messages. This is disabled by default.

    MQTT Version

    		Select the MQTT version that you want to use.

    MQTT Topic Prefix

    In the MQTT Topic Prefix field, enter the MQTT topic prefix to use. The following variables are supported: $Model, $LocationName, and $SerialNumber.

    The MQTT topic preview space previews what the topic will be when the variables are resolved and the postfix is added.

    MQTT Topic Preview

    		Previews what the topic will be when the variables defined in the MQTT Topic Prefix are resolved and the postfix is added.

  3. Configure the options in the Broker Configuration section.

    Field Description

    MQTT Broker Host

    Enter MQTT the broker host to which data is sent.

    The MQTT broker host must be unique.

    MQTT Broker Port

    Enter the number of the MQTT Broker port to which data should be sent.

    Username

    Enter the user name to authenticate with the broker.

    Password

    Enter the password to authenticate with the broker.

    Click the eye icon next to the field to toggle the password display.

    TLS Enabled

    Enable TLS.

    TLS Cert Check

    Enables checking the broker identity with a certificate.

  4. Click Update to save and apply the MQTT configuration.