交叉编译 MQTT/Mosquitto
交叉编译 MQTT/Mosquitto
概述
Eclipse Mosquitto 是一个开源（EPL/EDL许可）消息代理，它实现了 MQTT 协议版本 5.0、3.1.1 和 3.1。Mosquitto 重量轻，适用于从低功耗单板计算机到全服务器的所有设备。
MQTT 协议提供了一种使用发布/订阅模型执行消息传递的轻量级方法。这使得它适用于物联网消息传递，如低功耗传感器或移动设备，如手机、嵌入式计算机或微控制器。
Mosquitto 项目还提供了一个用于实现 MQTT 客户端的 C 库，以及非常流行的 mosquitto_pub 和 mosquitto_sub 命令行 MQTT 客户端。
- 官方网址：https://mosquitto.org
- GitHub: https://github.com/eclipse/mosquitto
下载
如果以商用量产为目的，一般选择正式的发行版本为佳。在官方网址 Download 页面下方会显示最新可下载的源码压缩包。根据需求选择合适的版本进行下载，以最新的 2.0.15 版本为例，在页面下方点击链接下载源码包 mosquitto-2.0.15.tar.gz。
也可以直接使用 wget 命令下载：
wget https://mosquitto.org/files/source/mosquitto-2.0.15.tar.gz
如果需要使用特定版本，可以在 https://mosquitto.org/files/ 位置找到 mosquitto 的历史发行版本。进入网页之后选择 source/ 链接，然后选择下载压缩包即可。
交叉编译
解压缩源码包：
tar -xvf mosquitto-2.0.15.tar.gz
解压缩源码包之后建议先阅读 README.md 与 README-compiling.md 文档，里面有关于编译的相关信息。
在 mosquitto 的文档及配置文件中有提及到依赖关系，最主要的是依赖 OpenSSL 与 cJSON 库，如果需要完整编译可以先参考「交叉编译 OpenSSL」与「交叉编译 cJSON」两篇文章。需要注意的点就是，需要使用 make DESTDIR=$BUILDSYSROOT install 将编译产物部署到 sysroot 目录便于 mosquitto 编译时依赖，效果类似于 apt install *-dev 安装开发依赖包。
在 README.md 文档中也提及到，如果不需要依赖 cJSON 可以使用 make WITH_CJSON=no 或者不需要依赖 OpenSSL 时使用 make WITH_TLS=no 的方式来禁用编译依赖。
首先创建一个环境配置文件 aarch64-environment-setup，配置最重要的交叉编译环境变量。
aarch64-environment-setup:
export TOOLCHAIN_ROOT=/opt/toolchains/aarch64--glibc--stable-2022.03-1
export BUILDSYSROOT=$TOOLCHAIN_ROOT/aarch64-buildroot-linux-gnu/sysroot
export PATH=$TOOLCHAIN_ROOT/bin:$PATHexport PREFIX=/usrexport CC="aarch64-linux-gcc --sysroot=$BUILDSYSROOT"
export CXX="aarch64-linux-g++ --sysroot=$BUILDSYSROOT"
export CPP="aarch64-linux-gcc -E --sysroot=$BUILDSYSROOT"
export LD="aarch64-linux-ld --sysroot=$BUILDSYSROOT"
export AR=aarch64-linux-ar
export AS=aarch64-linux-as
export NM=aarch64-linux-nm
export GDB=aarch64-linux-gdb
export OBJDUMP=aarch64-linux-objdump
export OBJCOPY=aarch64-linux-objcopy
export RANLIB=aarch64-linux-ranlib
export READELF=aarch64-linux-readelf
export STRIP=aarch64-linux-stripexport PKG_CONFIG_SYSROOT_DIR=$BUILDSYSROOT
export PKG_CONFIG_PATH=$BUILDSYSROOT/usr/lib/pkgconfig:$BUILDSYSROOT/usr/share/pkgconfig
在本示例中，交叉编译工具位于 /opt/toolchains/aarch64--glibc--stable-2022.03-1/bin 目录下，将该目录配置到 PATH 环境变量，让系统能够正确搜索到。同时在配置 CC，CXX，CPP 与 LD 环境变量时指定 --sysroot=<dir> 参数让交叉编译器搜索 dir 目录下的头文件与库文件，而不是 /usr/include 及 /usr/lib。
source aarch64-environment-setup
make
make prefix=/usr WITH_STRIP=yes DESTDIR=$BUILDSYSROOT install
- 在源码目录下创建环境配置文件并调用
source命令让环境变量生效； - 执行
make命令编译源码； - 在 config.mk 文件中定义了
prefix以及 WITH_STRIP 的默认值，根据实际需求在执行make指令时重新进行配置； - 使用 DESTDIR 参数作为安装目标文件的前缀变量，后面带上你希望安装到的文件夹路径，在本示例中，BUILDSYSROOT 指的是交叉编译工具链的 sysroot 目录，此环境变量在
aarch64-environment-setup中已定义。更详细介绍可以参考 DESTDIR 官方介绍，也可以参考「交叉编译 libcap」关于 DESTDIR 的用法说明。
最终你就可以在 $BUILDSYSROOT/usr 文件夹中找到交叉编译好的 mosquitto 头文件及库文件。如果需要以软件包的形式发布，可以指定 DESTDIR 为其他目录，比如 DESTDIR=/tmp/sysroot 则最终交叉编译出来的产物会在 /tmp/sysroot 文件夹下。Good luck.
欢迎关注我的公众号：飞翔的小黄鸭
也许会发现不一样的风景
△\triangle△ 交叉编译 cJSON