Direct MQTT Connector

  • 1 minute(s) read

Servitly includes an MQTT Broker that you can use to establish a direct connection with your products.

To use it, select the Servitly Thing Connector (STC) within the Connection configuration tab.

Connection Configuration

Within the Connection tab, under the editing page of a customer, location, or thing you can configure the Servitly Thing Connector by providing the following credentials (generated by you):

  • Username: the unique username used to open the MQTT connection.

  • Password: the password requested during the MQTT channel authentication; it must be at least 8 characters long, and it must contain at least one lower case letter, one upper case letter, and one number.

Moreover, it is possible to specify the payload format, by default only JSON is available, but depending on the enabled plugins (e.g. Asem) it is possible to use other formats.

The Connection tab is available on the Location and Customer level, and the configured IoT connector is inherited by the sublevels. In this way you can configure an IoT connection for a single thing, single location or an entire customer.

Thing Connection Mapping

At the thing level, in the Connection tab you can configure the specific mapping for the thing.

  • THING_MAPPING_ASSET_ID: this is the Asset Id configured within the Connection Mapping tab of the product.

  • THING_MAPPING_PATH: (optional). It can be used for more structured MQTT topics, needed when the same gateway is managing multiple things. In this case, the Asset Id will identify the gateway, instead the thing is identified by the Path.

IoT Connector Username, Asset Id and Path are used to compute the full topic for metric publishing and subscribing.

<USERNAME>/<THING_MAPPING_ASSET_ID>/<THING_MAPPING_PATH>/<METRIC_PATH>

Publishing Limits

Connected products can publish data with a limited rate, for more details refer to the Publishing Rate Limit article.