mosquitto-2.0.14 交叉编译

在物联网开发中，MQTT 协议作为轻量级消息传输协议被广泛应用，而 mosquitto 作为开源的 MQTT 代理服务器，是实现物联网通信的重要组件。本文将详细介绍如何编译ARM32 和 ARM64 架构下mosquitto-2.0.14 版本，包括环境准备、编译过程及相关依赖说明。

一、环境准备

在开始编译前，需要确保已安装以下工具和依赖：

1. 交叉编译工具链
   • ARM32: arm-linux-gnueabihf-gcc/g++
   • ARM64: aarch64-linux-gnu-gcc/g++
2. OpenSSL 库（提供 TLS/SSL 支持）
   • 已分别为 ARM32 和 ARM64 架构编译好的 openssl-1.1.1q 版本

二、编译过程

首先，下载并解压 mosquitto 源码包：

tar -zxvf mosquitto-2.0.14.tar.gz
cd mosquitto-2.0.14

1. ARM32 架构编译

# 配置并编译ARM32版本
make WITH_CJSON=no CC=arm-linux-gnueabihf-gcc CXX=arm-linux-gnueabihf-g++ \
CFLAGS="-I /home/admin/CSCMain/deps/openssl-1.1.1q/arm/include" \
LDFLAGS="-L /home/admin/CSCMain/deps/openssl-1.1.1q/arm/lib -lssl -lcrypto"

# 安装ARM32版本到指定目录
make install WITH_CJSON=no DESTDIR=/home/admin/CSCMain/deps/mosquitto-2.0.14/arm

2. ARM64 架构编译

# 配置并编译ARM64版本
make WITH_CJSON=no CC=aarch64-linux-gnu-gcc CXX=aarch64-linux-gnu-g++ \
CFLAGS="-I /home/admin/CSCMain/deps/openssl-1.1.1q/arm64/include" \
LDFLAGS="-L /home/admin/CSCMain/deps/openssl-1.1.1q/arm64/lib -lssl -lcrypto"

# 安装ARM64版本到指定目录
make install WITH_CJSON=no DESTDIR=/home/admin/CSCMain/deps/mosquitto-2.0.14/arm64

三、编译选项说明

在编译过程中，我们使用了多个重要的编译选项，下面对这些选项进行详细说明：

主要依赖选项

1. cJSON 依赖

   • WITH_CJSON=no: 禁用 cJSON 支持，这样可以避免引入额外的依赖库。如果需要客户端支持 JSON 格式输出，可以移除该选项。

2. OpenSSL 依赖

   • 默认开启 TLS/SSL 支持，通过WITH_TLS=no可以禁用此功能
   • CFLAGS: 指定 OpenSSL 头文件的搜索路径
   • LDFLAGS: 指定 OpenSSL 库文件的搜索路径及链接选项

3. pthreads 依赖

   • Linux 系统默认支持 pthreads API，无需额外配置
   • mosquitto 依赖 pthreads 提供多线程支持

交叉编译选项

1. 编译器指定

   • CC: 指定 C 编译器，如 arm-linux-gnueabihf-gcc 或 aarch64-linux-gnu-gcc
   • CXX: 指定 C++ 编译器，如 arm-linux-gnueabihf-g++ 或 aarch64-linux-gnu-g++

2. 安装目录

   • DESTDIR: 指定编译产物的安装根目录，避免直接安装到系统目录

四、编译注意事项

1. OpenSSL 版本兼容性

   • 确保使用的 OpenSSL 版本与 mosquitto 兼容，本文使用的是 openssl-1.1.1q 版本
   • 不同架构的 OpenSSL 库需要分别编译并放置在对应的目录中

2. 库文件路径

   • 编译完成后，在目标设备上运行时，需要确保系统能够找到 OpenSSL 库文件
   • 可以通过设置 LD_LIBRARY_PATH 环境变量或修改 /etc/ld.so.conf.d/ 目录下的配置文件来实现

3. 编译错误处理

   • 如果编译过程中出现找不到头文件或库文件的错误，请检查 CFLAGS 和 LDFLAGS 参数是否正确
   • 确保交叉编译工具链已正确安装并添加到 PATH 环境变量中

五、验证编译结果

编译完成后，可以通过以下命令验证生成的可执行文件：

# ARM32版本验证
file /home/admin/CSCMain/deps/mosquitto-2.0.14/arm/usr/local/sbin/mosquitto

# ARM64版本验证
file /home/admin/CSCMain/deps/mosquitto-2.0.14/arm64/usr/local/sbin/mosquitto

输出结果应显示对应的架构信息。