资讯详情

深入了解 · 专业解读

嵌入式常用第三方库部署：libcurl、sqlite、mqtt 适配

发布时间：2026/7/22 17:44:07
嵌入式常用第三方库部署：libcurl、sqlite、mqtt 适配 嵌入式常用第三方库部署libcurl、sqlite、mqtt 适配一、引言前面的文章我们都在写裸代码——直接调系统 Call 或 dev 节点操作硬件。但真实的嵌入式项目不可能从轮子造起HTTP 上传数据你得用 libcurl本地存储你得用 sqlite3MQTT 消息推送你得用 mosquitto 客户端库。问题来了——你的代码是跑在 ARM 开发板上的而你的交叉编译工具链是 x86 主机上的。怎么把这些开源库交叉编译成 ARM 版本的 .so 库怎么把它们部署到嵌入式设备上怎么链接到自己的应用程序本文手把手带你搞一遍 libcurl、sqlite3、mosquitto 三个库的交叉编译与适配形成一套可复用的交叉编译方法论。二、交叉编译环境准备假设你的交叉编译器是arm-linux-gnueabihf-gcc树莓派/全志/瑞芯微常见工具链安装在/opt/gcc-linaro/下。exportTOOLCHAIN_PATH/opt/gcc-linaro/binexportCC${TOOLCHAIN_PATH}/arm-linux-gnueabihf-gccexportCXX${TOOLCHAIN_PATH}/arm-linux-gnueabihf-gexportAR${TOOLCHAIN_PATH}/arm-linux-gnueabihf-arexportLD${TOOLCHAIN_PATH}/arm-linux-gnueabihf-ld# 目标系统根目录从开发板上拷贝或使用 SDK 提供的 sysrootexportSYSROOT/opt/sysroot踩坑提醒很多人在交叉编译时不指定--sysroot或--prefix编译出来的库链接到了主机上的 x86 版本依赖放到开发板上根本跑不起来。三、libcurl 交叉编译libcurl 是 HTTP/HTTPS 客户端的行业标准库嵌入式设备用它上传传感器数据到云端。3.1 编译步骤# 下载源码wgethttps://curl.se/download/curl-8.4.0.tar.gztarxzf curl-8.4.0.tar.gzcdcurl-8.4.0# 配置./configure\--hostarm-linux-gnueabihf\--prefix/opt/arm_libs/curl\--disable-shared\--enable-static\--with-openssl/opt/arm_libs/openssl\--disable-ldap\--disable-ldaps\--disable-rtsp\--disable-dict\--disable-telnet\--disable-tftp\--disable-pop3\--disable-imap\--disable-smb\--disable-gopher\--disable-manual\--without-librtmp\--without-libssh2# 编译安装make-j$(nproc)makeinstall关键参数解释--hostarm-linux-gnueabihf告诉 autotools 这是交叉编译--disable-shared静态编译减少部署麻烦不用拷贝 .so--with-openssl如果需要 HTTPS必须依赖交叉编译好的 OpenSSL--disable-xxx裁剪不需要的协议削减库体积3.2 使用示例#includestdio.h#includestring.h#includecurl/curl.h/* 回调将服务器返回数据写入 buffer */staticsize_twrite_callback(void*ptr,size_tsize,size_tnmemb,void*userdata){size_ttotalsize*nmemb;strncat((char*)userdata,(char*)ptr,total);returntotal;}intmain(void){CURL*curl;CURLcode res;charresponse[4096]{0};curl_global_init(CURL_GLOBAL_DEFAULT);curlcurl_easy_init();if(curl){// 设置请求 URLcurl_easy_setopt(curl,CURLOPT_URL,http://api.example.com/sensor/upload);// 设置 POST 数据constchar*json{\temp\:26.5,\humidity\:65};curl_easy_setopt(curl,CURLOPT_POSTFIELDS,json);// 设置回调curl_easy_setopt(curl,CURLOPT_WRITEFUNCTION,write_callback);curl_easy_setopt(curl,CURLOPT_WRITEDATA,response);// 超时设置 (嵌入式环境尤其重要)curl_easy_setopt(curl,CURLOPT_TIMEOUT,10L);curl_easy_setopt(curl,CURLOPT_CONNECTTIMEOUT,5L);// 执行请求rescurl_easy_perform(curl);if(resCURLE_OK){printf(服务器响应: %s\n,response);}else{fprintf(stderr,curl error: %s\n,curl_easy_strerror(res));}curl_easy_cleanup(curl);}curl_global_cleanup();return0;}编译链接arm-linux-gnueabihf-gcc-oupload\upload.c\-I/opt/arm_libs/curl/include\-L/opt/arm_libs/curl/lib\-lcurl-lssl-lcrypto-lz-lpthread四、sqlite3 交叉编译sqlite3 是嵌入式设备上最流行的轻量级关系数据库整个库就是一个 C 文件几乎零依赖。4.1 编译步骤sqlite3 的编译极其简单因为它不依赖 autotools 体系# 下载 amalgamation 版本单文件版wgethttps://www.sqlite.org/2024/sqlite-autoconf-3440000.tar.gztarxzf sqlite-autoconf-3440000.tar.gzcdsqlite-autoconf-3440000 ./configure\--hostarm-linux-gnueabihf\--prefix/opt/arm_libs/sqlite\--disable-shared\--enable-staticmake-j$(nproc)makeinstall4.2 传感器数据存储实战#includestdio.h#includetime.h#includesqlite3.h#defineDB_PATH/var/data/sensor.dbintdb_init(sqlite3**db){intrcsqlite3_open(DB_PATH,db);if(rc!SQLITE_OK){fprintf(stderr,打开数据库失败: %s\n,sqlite3_errmsg(*db));return-1;}// 创建表如果不存在constchar*sqlCREATE TABLE IF NOT EXISTS sensor_data ( id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp DATETIME DEFAULT CURRENT_TIMESTAMP, temp REAL, humidity REAL, pressure REAL);;char*err_msgNULL;rcsqlite3_exec(*db,sql,NULL,NULL,err_msg);if(rc!SQLITE_OK){fprintf(stderr,建表失败: %s\n,err_msg);sqlite3_free(err_msg);return-1;}printf(数据库初始化完成\n);return0;}intdb_insert(sqlite3*db,floattemp,floathumidity,floatpressure){constchar*sqlINSERT INTO sensor_data (temp, humidity, pressure) VALUES (?, ?, ?);;sqlite3_stmt*stmt;sqlite3_prepare_v2(db,sql,-1,stmt,NULL);// 绑定参数防止 SQL 注入性能优于拼接字符串sqlite3_bind_double(stmt,1,temp);sqlite3_bind_double(stmt,2,humidity);sqlite3_bind_double(stmt,3,pressure);sqlite3_step(stmt);sqlite3_finalize(stmt);return0;}voiddb_query_recent(sqlite3*db,intlimit){constchar*sqlSELECT timestamp, temp, humidity FROM sensor_data ORDER BY id DESC LIMIT ?;;sqlite3_stmt*stmt;sqlite3_prepare_v2(db,sql,-1,stmt,NULL);sqlite3_bind_int(stmt,1,limit);printf(%-20s %8s %8s\n,时间,温度,湿度);printf(------------------------------------------\n);while(sqlite3_step(stmt)SQLITE_ROW){printf(%-20s %7.1f %7.1f%%\n,sqlite3_column_text(stmt,0),sqlite3_column_double(stmt,1),sqlite3_column_double(stmt,2));}sqlite3_finalize(stmt);}intmain(void){sqlite3*db;if(db_init(db)0)return-1;db_insert(db,26.5,65.0,1013.2);db_insert(db,26.8,64.5,1013.0);db_query_recent(db,10);sqlite3_close(db);return0;}编译arm-linux-gnueabihf-gcc-osensor_db\sensor_db.c\-I/opt/arm_libs/sqlite/include\-L/opt/arm_libs/sqlite/lib\-lsqlite3-lpthread-ldl五、MQTTmosquitto交叉编译与部署MQTT 是物联网的事实标准协议mosquitto 是其中最流行的开源实现。5.1 编译 mosquitto 客户端库# 依赖先交叉编译 OpenSSL# cd openssl-3.x# ./Configure linux-armv4 --cross-compile-prefixarm-linux-gnueabihf- ...# make -j$(nproc)# 编译 mosquittogitclone https://github.com/eclipse/mosquitto.gitcdmosquitto# 修改 config.mk 或直接传参makeCCarm-linux-gnueabihf-gcc\CXXarm-linux-gnueabihf-g\WITH_STATIC_LIBRARIESyes\WITH_SHARED_LIBRARIESno\CFLAGS-I/opt/arm_libs/openssl/include\LDFLAGS-L/opt/arm_libs/openssl/lib# 安装到目标目录makeinstallDESTDIR/opt/arm_libs/mosquitto5.2 MQTT 客户端代码#includestdio.h#includestring.h#includemosquitto.h#defineMQTT_BROKER192.168.1.100#defineMQTT_PORT1883#defineTOPIC_TEMPsensor/temperaturestaticvoidon_connect(structmosquitto*mosq,void*obj,intrc){if(rc0){printf(已连接 MQTT Broker\n);// 订阅主题mosquitto_subscribe(mosq,NULL,sensor/cmd,0);}else{fprintf(stderr,连接失败, 错误码%d\n,rc);}}staticvoidon_message(structmosquitto*mosq,void*obj,conststructmosquitto_message*msg){printf([收到指令] Topic%s, Payload%s\n,msg-topic,(char*)msg-payload);}intmain(void){structmosquitto*mosqNULL;intrc;// 初始化mosquitto_lib_init();// 创建客户端mosqmosquitto_new(sensor_node_001,true,NULL);if(!mosq){fprintf(stderr,创建客户端失败\n);return-1;}// 设置回调mosquitto_connect_callback_set(mosq,on_connect);mosquitto_message_callback_set(mosq,on_message);// 连接 Brokerrcmosquitto_connect(mosq,MQTT_BROKER,MQTT_PORT,60);if(rc!MOSQ_ERR_SUCCESS){fprintf(stderr,连接失败: %s\n,mosquitto_strerror(rc));return-1;}// 主循环intcount0;while(count10){rcmosquitto_loop(mosq,-1,1);if(rc!MOSQ_ERR_SUCCESS){fprintf(stderr,loop error: %s\n,mosquitto_strerror(rc));break;}// 发布温度数据charpayload[64];snprintf(payload,sizeof(payload),%.1f,26.5count*0.1);mosquitto_publish(mosq,NULL,TOPIC_TEMP,strlen(payload),payload,0,false);printf(发布: %s %s\n,TOPIC_TEMP,payload);count;sleep(5);}mosquitto_destroy(mosq);mosquitto_lib_cleanup();return0;}编译arm-linux-gnueabihf-gcc-omqtt_client\mqtt_client.c\-I/opt/arm_libs/mosquitto/include\-L/opt/arm_libs/mosquitto/lib\-lmosquitto-lssl-lcrypto-lpthread六、部署到嵌入式设备交叉编译完成后部署分两步# 1. 拷贝库文件到目标设备的 /usr/libscp/opt/arm_libs/curl/lib/*.so root192.168.1.200:/usr/lib/scp/opt/arm_libs/sqlite/lib/*.so root192.168.1.200:/usr/lib/scp/opt/arm_libs/mosquitto/lib/*.so root192.168.1.200:/usr/lib/# 2. 拷贝可执行程序scp./upload root192.168.1.200:/usr/local/bin/scp./sensor_db root192.168.1.200:/usr/local/bin/scp./mqtt_client root192.168.1.200:/usr/local/bin/# 3. 在开发板上验证sshroot192.168.1.200 ldd /usr/local/bin/upload# 检查动态链接是否完整/usr/local/bin/upload七、跨编译踩坑汇总问题原因解决File format not recognized用主机编译器编译的对象文件混入先 make clean确认 CC 指向交叉编译器运行时No such file or directory动态库不在搜索路径加/usr/lib或设LD_LIBRARY_PATHOpenSSL version mismatch主机和目标 OpenSSL 版本不同用同一套源码交叉编译所有依赖程序段错误结构体对齐差异ABI 不兼容确认-mfloat-abisoftfp/hard一致库文件太大符号表未 striparm-linux-strip *.so八、总结交叉编译核心--host指定目标架构CC/CXX/AR指向交叉工具链依赖链管理OpenSSL → libcurl / mosquitto从底层往上层编译静态 vs 动态开发阶段用静态编译省事生产环境用动态省空间部署三件套拷 .so 到 /usr/lib、拷可执行文件、ldd 验证瘦身建议裁剪不需要的功能curl 的 --disable-xxx、mosquitto 的 WITH_xxxno掌握了这套交叉编译方法论以后遇到任何第三方库的 ARM 适配都能从容应对。

相关新闻