文档coreMQTT Agent

已更新 2025年7月

coreMQTT Agent

适用于小型 IoT 设备（ MCU 或小型 MPU）的线程安全 MQTT C 客户端库

简介

coreMQTT Agent 库是一个高级 API，它为 coreMQTT 增加线程安全性。使用该库可创建一个专用的 MQTT Agent 任务，用于在后台管理 MQTT 连接， 不需要其他任务进行任何干预。该库为 coreMQTT 的 API 提供了线程安全等价物， 因此可以在多线程环境中使用。

MQTT Agent 是独立的任务（或执行线程）。它是唯一允许访问 MQTT 库 API 的任务， 因此可轻松实现线程安全。它通过将所有 MQTT API 调用隔离到单个任务来实现序列化访问， 而且无需使用信号量或任何其他同步原语。

该库使用线程安全的消息传递队列（或其他进程间通信机制）来序列化 所有调用 MQTT API 的请求。消息传递实现通过消息传递接口与库解耦， 该接口允许将库移植到其他操作系统。消息传递接口 由发送和接收指向代理的命令结构体的函数以及分配这些命令对象的函数组成， 这使得应用程序写入器可以决定适合其应用程序的内存分配策略 。

此库以 C 语言编写，其设计符合 ISO C90
和 MISRA C:2012 标准。该库没有除 coreMQTT 和标准 C 库以外，此库不依赖任何其他库。此库 已被证明具有安全使用内存，不具有堆分配， 因此适用于 IoT 微控制器，也可以完全移植到其他平台。

此库可自由使用，且根据 MIT 开源许可证发布。

coreMQTT Agent 的代码大小（使用适用于 ARM Cortex-M 的 GCC 生成的示例）

内存估算包括 coreMQTT 库