View a markdown version of this page

Bibliothèque de l'agent CoreMQTT - FreeRTOS

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 de l'agent CoreMQTT

Note

Le contenu de cette page n'est peut-être pas à jour. Reportez-vous à la page de la FreeRTOS.org bibliothèque pour obtenir la dernière mise à jour.

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 API de CoreMQTT, 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 des API MQTT. 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 C:2012MISRA. La bibliothèque ne dépend d'aucune bibliothèque supplémentaire autre que bibliothèque CoreMQTT la bibliothèque C standard. La bibliothèque possède des preuves démontrant une utilisation sûre de la mémoire et l'absence d'allocation de tas. Elle peut donc être utilisée pour les microcontrôleurs IoT, mais elle est également entièrement portable sur d'autres plateformes.

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 K
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