Skip to content

Commit c26eb49

Browse files
authored
Merge pull request #33 from ALionTiger/patch-1
Moved MQTT description + added data-target link
2 parents 78788e3 + b744af4 commit c26eb49

File tree

1 file changed

+2
-25
lines changed

1 file changed

+2
-25
lines changed

source/iot-data-handling/iot-data-handling.rst

Lines changed: 2 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -77,30 +77,7 @@ For each IoT-Device, it is up to the user to select an appropriate payload decod
7777

7878
At the time of writing, there is no retry mechanism in OS2iot over HTTP(s). It uses a "fire-and-forget" / "at most once delivery" pattern.
7979

80-
MQTT data-target
81-
^^^^^^^^^^^^^^^^
82-
83-
OS2iot supports publishing data to a broker when it's received using MQTT. MQTT is a standard, lightweight messaging protocol based on the publish/subscribe pattern.
84-
85-
When configuring such a data-target, there's a few terms and keywords to be aware of:
86-
87-
- **QoS**: The QoS (Quality of Service) level determines the guarantee of delivery for a specific message. Different network environments may require different QoS levels.
88-
Ideally, the level should be set to match the network reliability and application logic. This is the main point of MQTT.
89-
90-
There are 3 QoS levels:
91-
92-
- 0 (at most once)
93-
- 1 (at least once)
94-
- 2 (exactly once)
95-
96-
There are a number of well written articles regarding QoS. One such example is
97-
`this blog entry <https://www.hivemq.com/blog/mqtt-essentials-part-6-mqtt-quality-of-service-levels/>`_.
98-
- **Topic**: The MQTT data-target must be provided a topic with which it can label the data. This is used by the MQTT broker to filter messages from
99-
MQTT clients. Here, OS2iot is a client.
100-
- **Connection authentication**: The most common methods of authentication are username and password and/or client certificates. At the time of writing, username and password
101-
authentication is supported, but it can be extended to implement other methods.
102-
103-
You can read more on MQTT `here <https://mqtt.org/>`_
80+
For more info on the different data-target options, look `here <.../external-interface-design/external-interface-design.html?highlight=data%20target#id2>`_
10481

10582
.. |image2| image:: ./media/image8.png
106-
83+

0 commit comments

Comments
 (0)