4. 驱动开发环境搭建：Windows/Linux下的开发环境配置、CMake工程构建、GenICam与GenTL库的安装

说实话，驱动开发这件事，七分靠环境，三分靠代码。我见过太多新手在环境配置上卡了两三天，最后发现是路径写错了。这一章，我就带你把 Windows 和 Linux 两套环境都捋一遍，顺便把 CMake 和 GenICam/GenTL 这些基础库装好。

4.1 开发环境概览：你需要准备什么

先列个清单，心里有个底。我个人习惯把工具链分成三块：编译器、构建系统、SDK 库。

嗯，这里要注意：GenICam 和 GenTL 是两个不同的库。GenICam 负责相机抽象层，GenTL 负责传输层。你写驱动时，两个都得链接。

4.2 Windows 环境配置

4.2.1 安装 Visual Studio 与 CMake

Visual Studio 安装时记得勾选「使用 C++ 的桌面开发」和「Windows 10/11 SDK」。CMake 直接去官网下载 .msi 安装包，安装时勾选「Add CMake to system PATH」。

4.2.2 安装 GenICam 与 GenTL 库

从 EMVA 官网下载 GenICam 3.x Runtime 和 GenTL 1.5 SDK。解压后，目录结构大概是这样：

GenICam_Root/
├── bin/
│   ├── Win64/
│   │   ├── gcbase_dynamic.dll
│   │   └── ...
├── include/
│   ├── Base/
│   ├── GenApi/
│   └── ...
├── lib/
│   ├── Win64/
│   │   ├── gcbase_dynamic.lib
│   │   └── ...
└── ...

把 bin/Win64 加到系统 PATH 环境变量里。不然运行时找不到 DLL，程序直接崩。我曾经因为这个排查了半小时，最后发现是 PATH 没刷新。

4.2.3 配置环境变量

建议设置两个环境变量：

• GENICAM_ROOT = 你的 GenICam 安装根目录
• GENICAM_GENTL64_PATH = 你的 GenTL 生产者 .cti 文件所在目录

为什么要设 GENICAM_GENTL64_PATH？因为 GenTL 运行时需要根据这个变量去加载传输层插件。不设的话，系统找不到相机。

4.3 Linux 环境配置

4.3.1 安装编译工具链

Ubuntu/Debian 系直接一行搞定：

sudo apt update
sudo apt install build-essential cmake git libusb-1.0-0-dev

CentOS/RHEL 系用 yum：

sudo yum groupinstall "Development Tools"
sudo yum install cmake git libusb-devel

为什么装 libusb？因为很多工业相机走 USB3 Vision 协议，底层依赖 libusb 做异步传输。你想想看，没有这个库，相机连枚举都做不到。

4.3.2 安装 GenICam 与 GenTL 库

Linux 下 GenICam 提供的是 .so 动态库和 .h 头文件。解压后，建议把库文件放到 /usr/local/lib，头文件放到 /usr/local/include。然后运行 sudo ldconfig 刷新链接缓存。

4.4 CMake 工程构建

这是本章的重头戏。CMake 写得好，跨平台编译没烦恼。我直接给一个最小可用的 CMakeLists.txt，你拿去改改就能用。

4.4.1 最小 CMakeLists.txt 模板

cmake_minimum_required(VERSION 3.20)
project(IndustrialCameraDriver VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 查找 GenICam 库
find_path(GENICAM_INCLUDE_DIR
    NAMES GenApi/GenApi.h
    PATHS $ENV{GENICAM_ROOT}/include
          /usr/local/include
)

find_library(GENICAM_LIBRARY
    NAMES gcbase_dynamic
    PATHS $ENV{GENICAM_ROOT}/lib/Win64
          /usr/local/lib
)

# 查找 GenTL 库
find_library(GENTL_LIBRARY
    NAMES GenTL_Dynamic
    PATHS $ENV{GENICAM_ROOT}/lib/Win64
          /usr/local/lib
)

# 添加可执行文件
add_executable(camera_driver main.cpp)

# 链接库
target_include_directories(camera_driver PRIVATE ${GENICAM_INCLUDE_DIR})
target_link_libraries(camera_driver PRIVATE ${GENICAM_LIBRARY} ${GENTL_LIBRARY})

# 设置运行时 DLL 路径（Windows 专用）
if(WIN32)
    set_target_properties(camera_driver PROPERTIES
        VS_DEBUGGER_ENVIRONMENT "PATH=$ENV{GENICAM_ROOT}/bin/Win64;%PATH%"
    )
endif()

这个模板做了三件事：

1. 用 find_path 和 find_library 自动定位 GenICam 头文件和库文件
2. 链接 gcbase_dynamic 和 GenTL_Dynamic 两个库
3. Windows 下自动设置调试时的 PATH 环境变量，避免运行时找不到 DLL

4.4.2 编译与运行

Windows 下：

mkdir build && cd build
cmake .. -G "Visual Studio 17 2022" -A x64
cmake --build . --config Release

Linux 下：

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)

编译成功后，运行 ./camera_driver，如果控制台没有报错，说明环境搭建成功。

4.5 知识体系结构图

下面这张图把本章的知识点串起来了。你可以看到，从操作系统层到驱动应用层，每一层都有对应的工具和库。

4.6 验证环境是否搭建成功

写一个简单的 main.cpp，只做一件事：初始化 GenTL 系统。如果这一步能过，说明环境没问题。

#include <iostream>
#include <GenTL/GenTL.h>

int main() {
    GenTL::GC_ERROR err = GenTL::GCInitLib();
    if (err != GenTL::GC_ERR_SUCCESS) {
        std::cerr << "GenTL 初始化失败，错误码: " << err << std::endl;
        return -1;
    }
    std::cout << "GenTL 初始化成功！" << std::endl;
    GenTL::GCCloseLib();
    return 0;
}

编译运行后，如果输出「GenTL 初始化成功！」，恭喜你，环境搭建完成。如果报错，别慌，按下面的排查表来。

4.7 常见问题排查表