📚 课程目录第3章相机驱动开发环境搭建

3、相机驱动开发环境搭建：Linux与Windows双平台开发环境配置、交叉编译工具链安装、CMake与Makefile工程管理

做工业相机驱动开发，第一道坎就是环境搭建。很多人觉得这事简单，装个IDE就能写代码。但实际项目里，你面对的往往是嵌入式Linux平台，或者需要同时在Windows上调试、在ARM板上运行。环境配不好，后面全是坑。

我个人习惯是双平台并行开发。Windows用来写代码、做初步调试，Linux用来做交叉编译和最终验证。今天我就把这套流程拆开讲，从工具链安装到工程管理，一步不落。

3.1 双平台开发环境概览

先看整体架构。我画了张图，帮你快速建立全局认知。

这张图里，Windows和Linux各司其职。Windows上我主要用VS2022配合CMake做本地编译，Linux上则用交叉编译工具链生成ARM架构的可执行文件。目标板通过SSH接收编译产物，跑起来验证。

3.2 Windows 环境配置

Windows环境配置，核心就三样：编译器、构建工具、驱动开发包。

3.2.1 编译器选择

我推荐两套方案，看项目需求选。

方案	编译器	适用场景	备注
MSVC	Visual Studio 2022	Windows原生驱动调试	集成调试器，方便单步
MinGW-w64	GCC 12+	跨平台代码验证	与Linux GCC行为一致

我个人习惯用MinGW-w64。为什么？因为我们的代码最终要在Linux上交叉编译，用MinGW能提前发现GCC特有的语法问题。MSVC对C标准的支持有时跟GCC有差异，等移植到Linux再改就晚了。

小技巧： 安装MinGW-w64时，记得选posix线程模型和seh异常处理。这两个选项能保证更好的C++标准兼容性。

3.2.2 CMake 安装

CMake是必须的。别用老版本，至少3.20以上。

# 下载地址：https://cmake.org/download/
# 安装时勾选 "Add CMake to system PATH"
# 验证安装
cmake --version
# 输出示例：cmake version 3.28.1

装完后，我习惯在Windows上配一个环境变量 CMAKE_TOOLCHAIN_FILE，指向MinGW的toolchain文件。这样每次新建项目不用重复指定。

3.2.3 驱动开发包

工业相机通常用USB3.0或GigE接口。Windows上需要对应的SDK。

USB相机： 安装libusb或WinUSB驱动。我用Zadig工具给设备绑定WinUSB驱动，简单粗暴。
GigE相机： 安装GenICam参考实现。记得把网卡巨帧设为9000字节，不然高带宽下丢包。

注意： 别在Windows上直接装厂商提供的闭源SDK做开发。我吃过亏——换了个相机型号，SDK不兼容，代码全废。用libusb或GenICam这种标准接口，换相机只需改设备描述符。

3.3 Linux 环境配置

Linux环境是主战场。我推荐Ubuntu 22.04 LTS，稳定，包新。

3.3.1 基础工具安装

sudo apt update
sudo apt install build-essential cmake git \
  libusb-1.0-0-dev libudev-dev \
  libopencv-dev  # 可选，用于图像验证

这里有个细节：libudev-dev 很多人会漏掉。没有它，你没法在用户态监听USB热插拔事件。相机掉线重连时，驱动需要重新枚举设备，这个库就是干这个的。

3.3.2 交叉编译工具链安装

目标板是ARM架构，所以需要交叉编译器。以ARM Cortex-A72为例：

# 安装ARM交叉编译器
sudo apt install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

# 验证
arm-linux-gnueabihf-gcc --version
# 输出示例：gcc (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0

为什么用 gnueabihf 而不是 gnueabi？hf 代表硬浮点。工业相机要做图像处理，浮点运算量大，硬浮点能快30%以上。我刚开始做时用了软浮点，结果ISP算法跑起来卡成PPT，换了硬浮点才正常。

  关键点： 交叉编译工具链必须与目标板的glibc版本匹配。用 readelf -l /lib/arm-linux-gnueabihf/libc.so.6 | grep INTERP 查看目标板的动态链接器路径，然后在工具链里找到对应的 ld-linux。

3.4 CMake 工程管理

CMake是我最推荐的构建工具。它比Makefile更抽象，跨平台支持好。

3.4.1 基础CMakeLists.txt

一个工业相机驱动项目，CMakeLists.txt长这样：

cmake_minimum_required(VERSION 3.20)
project(CameraDriver VERSION 1.0.0 LANGUAGES C CXX)

# 设置C标准
set(CMAKE_C_STANDARD 11)
set(CMAKE_CXX_STANDARD 17)

# 查找依赖
find_package(PkgConfig REQUIRED)
pkg_check_modules(LIBUSB REQUIRED libusb-1.0)

# 添加可执行文件
add_executable(camera_driver
  src/main.c
  src/usb_device.c
  src/sensor_config.c
  src/isp_pipeline.c
)

# 链接库
target_link_libraries(camera_driver PRIVATE
  ${LIBUSB_LIBRARIES}
  pthread
)

# 包含头文件
target_include_directories(camera_driver PRIVATE
  ${LIBUSB_INCLUDE_DIRS}
  include
)

这里我用了 pkg_check_modules 而不是直接写路径。为什么？因为libusb在不同Linux发行版里安装位置不一样，用pkg-config能自动找到。Windows上也能用，只要装了pkg-config-lite。

3.4.2 交叉编译Toolchain文件

交叉编译时，需要告诉CMake用ARM编译器。我写了一个toolchain文件：

# arm-linux-gnueabihf.cmake
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)

set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)

set(CMAKE_FIND_ROOT_PATH /usr/arm-linux-gnueabihf)
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

使用时：

mkdir build-arm && cd build-arm
cmake .. -DCMAKE_TOOLCHAIN_FILE=../arm-linux-gnueabihf.cmake
make -j4

经验之谈： 我习惯在项目根目录建一个 cmake/ 文件夹，放所有toolchain文件。这样换平台时只需改一行 -DCMAKE_TOOLCHAIN_FILE，不用改CMakeLists.txt。

3.5 Makefile 工程管理

虽然CMake是主流，但有些场景还是得手写Makefile。比如嵌入式Linux内核模块编译，或者资源受限的MCU项目。

3.5.1 通用Makefile模板

CROSS_COMPILE ?= arm-linux-gnueabihf-
CC = $(CROSS_COMPILE)gcc
CFLAGS = -Wall -O2 -std=c11 -I./include
LDFLAGS = -lusb-1.0 -lpthread

SRCDIR = src
OBJDIR = obj
TARGET = camera_driver

SRCS = $(wildcard $(SRCDIR)/*.c)
OBJS = $(patsubst $(SRCDIR)/%.c, $(OBJDIR)/%.o, $(SRCS))

$(TARGET): $(OBJS)
	$(CC) $^ -o $@ $(LDFLAGS)

$(OBJDIR)/%.o: $(SRCDIR)/%.c | $(OBJDIR)
	$(CC) $(CFLAGS) -c $< -o $@

$(OBJDIR):
	mkdir -p $@

clean:
	rm -rf $(OBJDIR) $(TARGET)

.PHONY: clean

这个模板支持交叉编译。默认用ARM编译器，如果想在本地测试：

make CROSS_COMPILE=   # 清空交叉编译前缀，用本地gcc

3.5.2 条件编译与平台适配

工业相机驱动经常需要区分平台。我在Makefile里加条件判断：

UNAME_S := $(shell uname -s)
ifeq ($(UNAME_S), Linux)
    CFLAGS += -DPLATFORM_LINUX
    LDFLAGS += -ludev
endif
ifeq ($(UNAME_S), Darwin)
    CFLAGS += -DPLATFORM_MACOS
    LDFLAGS += -framework IOKit
endif
# Windows下用MinGW，uname返回MINGW64_NT-...
ifneq (,$(findstring MINGW,$(UNAME_S)))
    CFLAGS += -DPLATFORM_WINDOWS
    LDFLAGS += -lsetupapi
endif

避坑指南： 我曾经在Makefile里直接用 ifdef WINDOWS 判断，结果在Git Bash里环境变量被继承，导致Linux下也走了Windows分支。后来改用 uname -s 检测，再没出过问题。

3.6 环境验证与测试

环境搭好了，得跑个程序验证。我写了一个简单的相机枚举程序：

#include <libusb-1.0/libusb.h>
#include <stdio.h>

int main() {
    libusb_context *ctx = NULL;
    libusb_device **devs = NULL;
    ssize_t cnt;

    int ret = libusb_init(&ctx);
    if (ret < 0) {
        fprintf(stderr, "libusb init failed: %d\n", ret);
        return -1;
    }

    cnt = libusb_get_device_list(ctx, &devs);
    if (cnt < 0) {
        fprintf(stderr, "get device list failed\n");
        return -1;
    }

    printf("Found %zd USB devices\n", cnt);
    libusb_free_device_list(devs, 1);
    libusb_exit(ctx);
    return 0;
}

编译运行：

# Windows (MinGW)
gcc usb_enum.c -o usb_enum.exe -lusb-1.0
./usb_enum.exe

# Linux (本地)
gcc usb_enum.c -o usb_enum -lusb-1.0
./usb_enum

# Linux (交叉编译)
arm-linux-gnueabihf-gcc usb_enum.c -o usb_enum_arm -lusb-1.0
scp usb_enum_arm root@192.168.1.100:/tmp/
ssh root@192.168.1.100 /tmp/usb_enum_arm

如果输出 Found N USB devices，说明环境通了。如果报错找不到libusb，检查一下pkg-config路径。

  验证清单：
  Windows上能编译并运行USB枚举程序
Linux上能交叉编译生成ARM可执行文件
目标板上能运行交叉编译产物
CMake能正确找到libusb依赖
Makefile支持本地/交叉编译切换

环境搭建这块，说白了就是一次配置、长期受益。我刚开始做时，每换一个项目就重装一遍环境，后来把工具链、toolchain文件、CMake模板都整理到一个Git仓库里，新项目直接clone，改改CMakeLists.txt里的源文件列表就行。你也试试这个思路，能省不少时间。