Prerequisites

Before running your first application, you must ensure that you have the minimum set of required tools and components:

Toolchain for your specific microcontroller.
Development board.
µC/TCP-IP stack must be installed properly (a running project). See Installing the µC/TCP-IP Stack for further details on how to install µC/TCP-IP.
Source code for µC/MQTT-client.

Additional Modules

µC/MQTT-client depends on other modules to run. It requires the presence of an RTOS, the modules for µC/CPU, µC/LIB, µC/Common and µC/TCP-IP.

If you are using one of the two Micriµm OS's, complete documentation can be found for µC/OS-II and µC/OS-III. Refer to those guides for more information on requirements, installation, configuration and running of each RTOS.

The µC/CPU module regroups the processor's hardware-dependent code. It includes ports for the many CPU architectures Micriµm supports. Therefore, you must use the port corresponding to your specific CPU.

The µC/LIB module is Micriµm's run-time library, implementing the most common standard library functions, macros, and constants.

The µC/TCP-IP stack is a compact, reliable, high-performance TCP/IP protocol stack which provides the socket for the MQTT application layer.

µC/Common regroups modules used commonly by all the Micrium products. It must therefore also be included in your project.

Downloading the Source Code

The source code is available as open-source on Github: https://github.com/weston-embedded

Installing the Files

Once all the distribution packages have been downloaded to your host machine, extract all the files to your computer (for instance, at the root of your C:\ drive). The package may be extracted to any location. After extracting all the files, the directory structure should look as illustrated below in Figure - MQTT-client Folder Tree. In the example, all Micriµm products sub-folders will be located in C:\Micrium\Software\. The Micriµm µC/OS-III RTOS has been chosen for this example.

Figure - MQTT-client Folder Tree

MQTTc Files