MQTT Client SDK 二进制样例使用说明书
版本说明
适配：MQTT Client SDK V3.0.0 正式版
包含平台：Windows x64、Linux x64、ARM32、ARM64
每平台固定 4 个标准二进制包，无冗余、全覆盖商用测试场景。
一、整体目录结构
plaintext
bin/
├── windows/        # Windows x64 4个二进制
├── linux/          # Linux x64 4个二进制
├── arm32/          # ARM32 嵌入式Linux 4个二进制
├── arm64/          # ARM64 嵌入式Linux 4个二进制
└── stm32/          # 嵌入式STM32：仅库+头文件，无可执行bin
二、各平台 4 个二进制文件完整释义
通用命名规则（所有平台统一）
xxl_mqtt_client_cmd_demo_xxx
MQTT3.1.1 交互式命令行演示（日常调试首选）
xxl_mqtt_client_50_cmd_demo_xxx
MQTT5.0 交互式命令行演示（专测 5.0 协议特性）
xxl_mqtt_client_auto_test_xxx
MQTT3.1.1 自动化压力 / 回归测试（无交互，后台跑用例）
xxl_mqtt_client_auto_test_50_xxx
MQTT5.0 自动化压力 / 回归测试（5.0 协议专项稳定性测试）
1. Windows x64 平台
plaintext
xxl_mqtt_client_cmd_demo_windows.exe
xxl_mqtt_client_50_cmd_demo_windows.exe
xxl_mqtt_client_auto_test_windows.exe
xxl_mqtt_client_auto_test_50_windows.exe
运行方式：双击直接启动 / CMD/PowerShell 运行
自带 UTF-8 控制台编码，中文日志不乱码
无需额外依赖，纯静态编译
2. Linux x64 平台
plaintext
xxl_mqtt_client_cmd_demo_linux
xxl_mqtt_client_50_cmd_demo_linux
xxl_mqtt_client_auto_test_linux
xxl_mqtt_client_auto_test_50_linux
运行前需加执行权限：chmod +x 文件名
适配主流 CentOS / Ubuntu / OpenCloudOS
3. ARM32 嵌入式 Linux
plaintext
xxl_mqtt_client_cmd_demo_arm32
xxl_mqtt_client_50_cmd_demo_arm32
xxl_mqtt_client_auto_test_arm32
xxl_mqtt_client_auto_test_50_arm32
适用：工业网关、老款 ARM 工控机、32 位嵌入式 Linux
4. ARM64 嵌入式 Linux
plaintext
xxl_mqtt_client_cmd_demo_arm64
xxl_mqtt_client_50_cmd_demo_arm64
xxl_mqtt_client_auto_test_arm64
xxl_mqtt_client_auto_test_50_arm64
适用：树莓派 4/5、ARM 服务器、64 位高端工业网关
5. STM32 平台特殊说明
无独立可执行二进制
交付物：libxxl_mqtt_sdk.a 静态库 + mqtt_client_sdk.h 头文件 + 平台适配层
使用方式：集成到 STM32CubeIDE / Keil 工程，主任务轮询调用，无线程依赖
三、四类程序适用场景速选
表格
程序类型	适用场景	推荐人群
3.1.1 交互 demo	日常联调、功能验证、对接自建 Broker	开发 / 调试工程师
5.0 交互 demo	测试 MQTT5.0 独有特性：共享订阅、用户属性、消息过期	协议开发、高级物联网场景
3.1.1 自动化测试	批量回归、断网重连压力、长时间稳定性拷机	测试工程师、版本发布验收
5.0 自动化测试	MQTT5.0 协议兼容性、高并发长连接稳定性测试	协议测试、商用交付验收
四、快速使用教程（通用全平台）
1. 交互式 Demo 操作流程（cmd_demo 系列）
运行程序，自动打印完整用例菜单
必走基础流程：
输入 00 ：创建无加密单实例，连接 Broker
输入 00E：创建加密实例（加密发布必须先走这个）
输入 01 ：QoS0 发布普通消息
输入 05 ：订阅主题接收消息
输入 12 ：销毁实例释放内存
输入 99 ：安全退出程序
操作小技巧
直接回车：自动执行下一个递增用例
支持双 Broker 多实例隔离，互不干扰
纯主任务轮询，无多线程，可无缝移植嵌入式
2. 自动化 auto_test 系列
无菜单、无人工交互
启动后自动跑完预置全套测试用例
全程输出日志，可保存日志做版本验收依据
适合量产拷机、持续集成 CI 测试
五、关键功能说明
匿名免密连接：默认关闭账号密码，直接裸连 Broker
加密传输：Payload AES128 自动加解密，主题明文
完整 MQTT 标准：QoS0/QoS1/QoS2、Retain、遗嘱、通配符订阅全部支持
断网自愈：内置自动重连机制，可配置重连间隔、最大重连次数
零内存泄漏：实例销毁自动释放所有堆内存，适合长期运行
六、注意事项
Linux/ARM 平台必须先授权：chmod +x 程序名 再运行
加密功能前置要求：必须先执行 00E 创建加密实例，才能用 09 加密发布
MQTT5.0 程序只能对接支持 5.0 协议的 Broker，普通 3.1.1 Broker 无法兼容
STM32 只能用库集成方式，不能直接运行 bin 二进制
所有 demo 均为主任务轮询模式，无线程依赖，嵌入式可直接照搬架构