Arm Linux身份证读卡器开发实战：从交叉编译到so库生成全流程
Arm Linux身份证读卡器开发实战：从交叉编译到so库生成全流程
最近在开发一款基于Arm架构的身份证读卡器时，发现网上关于完整流程的参考资料比较零散。作为一个踩过不少坑的开发者，我决定把整个开发过程整理成文档，希望能帮到有类似需求的同行。本文将重点介绍如何在Arm Linux环境下完成从交叉编译环境搭建到最终生成so库的全过程，特别是那些容易被忽略的细节问题。
1. 开发环境准备
在开始之前，我们需要准备一台x86_64架构的开发机（推荐Ubuntu 18.04或更高版本）和目标Arm开发板。开发板上需要运行Linux系统，建议使用较新的内核版本（4.x以上）以更好地支持USB设备。
1.1 安装交叉编译工具链
首先需要获取适合目标平台的交叉编译工具链。对于AArch64架构，Linaro提供的GCC工具链是个不错的选择：
wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz解压工具链到指定目录：
sudo tar -Jxvf gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz -C /opt提示：使用-J选项处理.xz压缩包，-z用于.gz，-j用于.bz2
配置环境变量让系统识别交叉编译工具：
echo 'export PATH=$PATH:/opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin' >> ~/.bashrc source ~/.bashrc验证安装是否成功：
aarch64-linux-gnu-gcc -v应该能看到类似这样的输出：
gcc version 7.5.0 (Linaro GCC 7.5-2019.12)1.2 基础依赖安装
在开发机上安装必要的构建工具：
sudo apt update sudo apt install build-essential git make cmake2. libusb库的交叉编译
身份证读卡器通常通过USB接口通信，因此我们需要交叉编译libusb库以提供USB设备访问能力。
2.1 获取libusb源码
从官网下载最新稳定版源码：
wget https://github.com/libusb/libusb/releases/download/v1.0.24/libusb-1.0.24.tar.bz2 tar -jxvf libusb-1.0.24.tar.bz2 cd libusb-1.0.242.2 配置交叉编译选项
创建安装目录并配置编译参数：
mkdir -p /opt/libusb-arm64 ./configure --host=aarch64-linux-gnu \ --prefix=/opt/libusb-arm64 \ CC=aarch64-linux-gnu-gcc \ CXX=aarch64-linux-gnu-g++关键参数说明：
--host：指定目标平台架构--prefix：设置库的安装路径CC/CXX：指定交叉编译器
2.3 编译与安装
执行编译和安装：
make -j$(nproc) sudo make install验证生成的库文件：
file /opt/libusb-arm64/lib/libusb-1.0.so.0.3.0正确输出应包含"ARM aarch64"字样，表明这是针对Arm架构编译的库。
3. 身份证读卡器SDK集成
不同厂商的身份证读卡器通常提供各自的SDK，这里我们以常见的某型号读卡器为例。
3.1 SDK文件结构
典型的SDK包含以下文件：
sdk/ ├── include/ │ ├── donsee.h │ └── utf.h ├── lib/ │ └── libdonsee.a └── samples/ └── donseeTest.c3.2 交叉编译SDK
创建CMakeLists.txt文件：
cmake_minimum_required(VERSION 3.10) project(DonseeSDK) set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc) set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++) include_directories( ${PROJECT_SOURCE_DIR}/include /opt/libusb-arm64/include/libusb-1.0 ) link_directories( ${PROJECT_SOURCE_DIR}/lib /opt/libusb-arm64/lib ) add_library(donsee SHARED donsee.c dllMain.c utf.c) target_link_libraries(donsee usb-1.0 dl) add_executable(donsee_test donseeTest.c) target_link_libraries(donsee_test donsee)编译项目：
mkdir build && cd build cmake .. make3.3 常见问题解决
问题1：找不到libusb头文件
解决方案：确保libusb的头文件路径已正确包含，或手动复制：
sudo cp -r /opt/libusb-arm64/include/libusb-1.0 /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/aarch64-linux-gnu/libc/usr/include问题2：链接时找不到libusb库
解决方案：将编译好的libusb库文件复制到工具链的库目录：
sudo cp /opt/libusb-arm64/lib/libusb-1.0.* /opt/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/aarch64-linux-gnu/libc/usr/lib4. 目标板部署与测试
4.1 文件传输
将生成的文件传输到目标板：
scp libdonsee.so donsee_test user@target-ip:/home/user4.2 运行时依赖
在目标板上安装运行时依赖：
sudo apt update sudo apt install libusb-1.0-0或者将libusb库也复制到目标板的/usr/lib目录下。
4.3 运行测试程序
在目标板上执行：
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:. ./donsee_test如果一切正常，程序应该能够检测到连接的身份证读卡器并读取卡片信息。
5. 性能优化与调试技巧
5.1 编译优化选项
在CMakeLists.txt中添加优化标志：
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -O2 -pipe -march=armv8-a")各优化级别对比：
| 优化级别 | 编译时间 | 代码大小 | 执行速度 | 适用场景 |
|---|---|---|---|---|
| -O0 | 最快 | 最大 | 最慢 | 调试 |
| -O1 | 较快 | 较小 | 较快 | 开发 |
| -O2 | 较慢 | 小 | 快 | 发布 |
| -O3 | 最慢 | 最小 | 最快 | 性能关键 |
5.2 调试技巧
使用gdbserver进行远程调试：
目标板：
gdbserver :2345 ./donsee_test开发机：
aarch64-linux-gnu-gdb donsee_test (gdb) target remote target-ip:23455.3 内存检测
交叉编译时链接AddressSanitizer：
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fsanitize=address -fno-omit-frame-pointer")在目标板上需要安装对应的运行时库：
sudo apt install libasan56. 实际开发中的经验分享
在开发过程中，我发现几个特别需要注意的点：
- USB权限问题：目标板上的普通用户可能没有访问USB设备的权限，需要添加udev规则：
echo 'SUBSYSTEM=="usb", ATTR{idVendor}=="xxxx", ATTR{idProduct}=="xxxx", MODE="0666"' | sudo tee /etc/udev/rules.d/99-donsee.rules版本兼容性：不同版本的libusb可能有API变化，建议锁定特定版本。
线程安全：如果SDK需要在多线程环境下使用，确保正确处理锁和资源竞争。
日志系统：实现一个完善的日志系统对后期调试非常有帮助，可以考虑使用syslog或自定义日志文件。