Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Bibliothèque d'agents CoreMQTT
Important
Il s'agit d'une version archivée du guide de l'utilisateur de FreeRTOS à utiliser avec la version 202210.00 de FreeRTOS. Pour obtenir la dernière version de ce document, consultez le guide de l'utilisateur de FreeRTOS.
Introduction
La bibliothèque de l'agent CoreMQTT est une API de haut niveau qui renforce la sécurité des threads. bibliothèque CoreMQTT Il vous permet de créer une tâche d'agent MQTT dédiée qui gère une connexion MQTT en arrière-plan et ne nécessite aucune intervention de la part d'autres tâches. La bibliothèque fournit des équivalents thread-safe aux CoreMQTT APIs, de sorte qu'elle peut être utilisée dans des environnements multithread.
L'agent MQTT est une tâche indépendante (ou thread d'exécution). Elle garantit la sécurité des threads en étant la seule tâche autorisée à accéder à l'API de la bibliothèque MQTT. Il sérialise l'accès en isolant tous les appels d'API MQTT vers une seule tâche et élimine le besoin de sémaphores ou d'autres primitives de synchronisation.
La bibliothèque utilise une file d'attente de messagerie sécurisée par thread (ou un autre mécanisme de communication inter-processus) pour sérialiser toutes les demandes d'appel à MQTT. APIs L'implémentation de la messagerie est découplée de la bibliothèque via une interface de messagerie, ce qui permet de porter la bibliothèque vers d'autres systèmes d'exploitation. L'interface de messagerie est composée de fonctions pour envoyer et recevoir des pointeurs vers les structures de commande de l'agent, et de fonctions pour allouer ces objets de commande, ce qui permet au rédacteur de l'application de décider de la stratégie d'allocation de mémoire appropriée pour son application.
La bibliothèque est écrite en C et conçue pour être conforme aux normes ISO C90 et MISRA
Cette bibliothèque peut être utilisée librement et est distribuée sous la licence open source du MIT
| Taille du code de l'agent CoreMQTT (exemple généré avec GCC pour ARM Cortex-M) | ||
|---|---|---|
| Fichier | Avec optimisation -O1 | Avec l'optimisation -Os |
| core_mqtt_agent.c | 1,7 K | 1,5 KM |
| core_mqtt_agent_command_functions.c | 0,3 K | 0,2 K |
| core_mqtt.c (CoreMQTT) | 4,0 K | 3,4 KM |
| core_mqtt_state.c (CoreMQTT) | 1,7 K | 1,3 K |
| core_mqtt_serializer.c (CoreMQTT) | 2,8 K | 2,2 K |
| Estimations totales | 10,5 K | 8,6 K |
