Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
CoreMQTT-Bibliothek
Wichtig
Dies ist eine archivierte Version des FreeRTOS-Benutzerhandbuchs zur Verwendung mit der FreeRTOS-Version 202012.00. Die neueste Version dieses Dokuments finden Sie im FreeRTOS-Benutzerhandbuch.
Einführung
Die CoreMQTT-Bibliothek ist eine Client-Implementierung des MQTT-Standards
Die CoreMQTT-Bibliothek entspricht dem MQTT 3.1.1-Protokollstandard.
Die Bibliothek ist in C geschrieben und so konzipiert, dass sie ISO C90 und MISRA C:2012
Die Standard-C-Bibliothek
Eine vom Kunden implementierte Netzwerktransportschnittstelle
(Optional) Eine vom Benutzer implementierte Plattformzeitfunktion
Die Bibliothek ist durch die Bereitstellung einer einfachen Spezifikation für die Sende- und Empfangsschnittstelle von den zugrunde liegenden Netzwerktreibern entkoppelt. Der Anwendungsautor kann je nach Anwendung eine vorhandene Transportschnittstelle auswählen oder eine eigene Schnittstelle implementieren.
Die Bibliothek bietet eine High-Level-API, um eine Verbindung zu einem MQTT-Broker herzustellen, ein Thema zu abonnieren/abzubestellen, eine Nachricht zu einem Thema zu veröffentlichen und eingehende Nachrichten zu empfangen. Diese API verwendet die oben beschriebene Transportschnittstelle als Parameter und verwendet sie zum Senden und Empfangen von Nachrichten an und vom MQTT-Broker.
Die Bibliothek stellt auch eine serializer/deserializer API. This API can be used to build a simple IoT application consisting of only the required a subset of MQTT functionality, without any other overhead. The serializer/deserializer Low-Level-API zur Verfügung, die in Verbindung mit jeder verfügbaren Transportschicht-API, wie Sockets, verwendet werden kann, um Nachrichten an und vom Broker zu senden und zu empfangen.
Bei der Verwendung von MQTT-Verbindungen in IoT-Anwendungen empfehlen wir, eine sichere Transportschnittstelle zu verwenden, z. B. eine, die das TLS-Protokoll verwendet.
Diese MQTT-Bibliothek hat keine Plattformabhängigkeiten wie Threading oder Synchronisation. Diese Bibliothek verfügt über Beweise
Codegröße von CoreMQTT (mit GCC für ARM Cortex-M generiertes Beispiel) | ||
---|---|---|
Datei | Mit -O1-Optimierung | Mit -Os-Optimierung |
core_mqtt.c | 3,0K | 2,6 K |
core_mqtt_state.c | 1,4 K | 1,1 K |
core_mqtt_serializer.c | 2,5 K | 2,0 K |
Schätzungen insgesamt | 6,9 K | 5,7 K |