For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configure a subscription

Overview

Fig. 1 – Creating a new subscription
Icon
Description
Details

[A]

Topic preview

In this section you see a preview of the incoming data

[A1]

Entering the topic preview

Enter an MQTT topic here. Its data will appear in the preview. Important: In this field, you enter NOT the topic for which you want to create a subscription – this is done in [C]

[B]

Name

Give the subscription a name. The subscription will be displayed under this name in the subscription list (in the broker details)

[C]

Topic

Enter the MQTT topic here for which you want to create a subscription.

[D]

QoS (Quality of Service)

Select a value. QoS indicates the level of message delivery between the MQTT broker and the connected clients

[E]

One or more formats

Choose whether a single format or multiple formats should be applied to the data. -> One or more formats

[F]

Create format

If you want to define a new format, click here. The window opens ↗ Format configure

[G]

Select existing format

As an alternative to [F] you can also select an existing format

[H]

Save

Click to save the subscription

One or more formats

Choose whether a single format or multiple formats should be applied to the incoming data.

◈ If you select Single the same format will be used for all incoming data.

◈ If you select Multiple select, you can differentiate the data processing – depending on Topic. This means: Within a subscription, different topics can be processed with different formats. For this, use Patternto define which data belongs to which format.

Example:

You subscribe to the topic levels/+. There are two actual topics:

  • levels/level1 → this data should be processed with Decoder A be processed

  • levels/level2 → this data should be processed with Decoder B be processed

Then in Multiple mode, enter two pairs:

Pattern
format

levels/level1

Decoder A

levels/level2

Decoder B

▷ This way, the data is automatically decoded with the appropriate format depending on the topic.

Was this helpful?