Skip to content

Demonstrates use of coreMQTT-Agent for simple MQTT connection sharing among different threads of execution.

License

Notifications You must be signed in to change notification settings

jasonpcarroll/coreMQTT-Agent-Demos

 
 

Repository files navigation

MQTT Agent and Demo Tasks (including OTA) - Using coreMQTT

Note: The MQTT agent and associated example project are functional but not yet complete. Be aware the agent does not yet comply with our code quality standards and is not yet fully tested. There is a chance its APIs will change before its official first release. Feedback, suggestions and comments are welcome on the FreeRTOS support forum.

coreMQTT is an MIT licensed open source C MQTT client library for microcontrollers and small microprocessor based IoT devices. It’s design is intentionally simple to ensure it has no dependency on any other library or operating system, and to better enable static analysis including memory safety proofs. That simplicity and lack of operating system dependency (coreMQTT does not require multithreading at all) means coreMQTT does not build thread safety directly into its implementation. Instead thread safety must be provided by higher level software. This labs project implements a coreMQTT extension that provides that higher level functionality in the form of an MQTT agent (or MQTT daemon). While the implementation demonstrated here is currently specific to FreeRTOS, there are not many dependencies on FreeRTOS, meaning the implementation can easily be adapted for use with other operating systems.

Getting started

The documentation page for this repository contains information on the MQTT agent and the contained demo project. There is also a supplemental documentation page that describes how to run an Over the Air (OTA) update agent as one of the RTOS tasks that share the same MQTT connection.

Cloning this repository

This repo uses Git Submodules to bring in dependent components.

Note: If you download the ZIP file provided by the GitHub UI, you will not get the contents of the submodules. (The ZIP file is also not a valid git repository)

To clone using HTTPS:

git clone https://github.com/FreeRTOS/Lab-Project-coreMQTT-Agent.git --recurse-submodules

Using SSH:

git clone [email protected]:FreeRTOS/Lab-Project-coreMQTT-Agent.git --recurse-submodules

If you have downloaded the repo without using the --recurse-submodules argument, you need to run:

git submodule update --init --recursive

Getting help

You can use your Github login to get support from both the FreeRTOS community and directly from the primary FreeRTOS developers on our active support forum. The FAQ provides another support resource.

Security

See CONTRIBUTING for more information.

License

This library is licensed under the MIT License. See the LICENSE file.

About

Demonstrates use of coreMQTT-Agent for simple MQTT connection sharing among different threads of execution.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 86.5%
  • C++ 9.6%
  • Python 1.4%
  • JavaScript 1.1%
  • Makefile 0.8%
  • HTML 0.5%
  • Batchfile 0.1%