coreMQTT Agent library
Note
The content on this page may not be up-to-date. Please refer to the
FreeRTOS.org library page
Introduction
The coreMQTT Agent library is a high level API that adds thread safety to the coreMQTT library. It lets you create a dedicated MQTT agent task that manages an MQTT connection in the background and doesn't need any intervention from other tasks. The library provides thread safe equivalents to the coreMQTT's APIs, so it can be used in multi-threaded environments.
The MQTT agent is an independent task (or thread of execution). It achieves thread safety by being the only task that is permitted to access the MQTT library's API. It serializes access by isolating all MQTT API calls to a single task, and it removes the need for semaphores or any other synchronization primitives.
The library uses a thread safe messaging queue (or other inter-process communication mechanism) to serialize all requests to call MQTT APIs. The messaging implementation is decoupled from the library through a messaging interface, which allows the library to be ported to other operating systems. The messaging interface is composed of functions to send and receive pointers to the agent's command structures, and functions to allocate these command objects, which allows the application writer to decide the memory allocation strategy appropriate for their application.
The library is written in C and designed to be compliant with ISO C90
This library can be freely used and is distributed under the
MIT open source license
| Code Size of coreMQTT Agent (example generated with GCC for ARM Cortex-M) | ||
|---|---|---|
| File | With -O1 Optimization | With -Os Optimization |
| core_mqtt_agent.c | 1.7K | 1.5K |
| core_mqtt_agent_command_functions.c | 0.3K | 0.2K |
| core_mqtt.c (coreMQTT) | 4.0K | 3.4K |
| core_mqtt_state.c (coreMQTT) | 1.7K | 1.3K |
| core_mqtt_serializer.c (coreMQTT) | 2.8K | 2.2K |
| Total estimates | 10.5K | 8.6K |
