1. Basler pylon SDK 全景与开发环境搭建
Basler pylon 是 Basler 相机配套的软件套件，它把相机驱动、设备发现、图像采集、参数配置、图像显示与开发接口整合在同一套体系里。对开发者而言，pylon 不只是一个“驱动包”，而是从硬件识别到应用集成的完整工具链。理解它的组成与各层职责，是后续用 C++、C# 或 Python 调用相机 API 的前提。
pylon 软件套件的组成
pylon 套件通常包含以下几个关键部分：
- pylon 驱动与运行时：负责与相机通信，管理 GigE、USB3、Camera Link 等接口的底层传输，并向上提供统一的设备访问层。
- pylon Viewer：图形化相机工具，用于发现相机、连接、实时预览、调整曝光/增益、保存图像，是验证相机与驱动是否正常的第一站。
- pylon SDK：面向开发者的编程接口，提供 C++、C#、Python 等语言的 API，封装了设备枚举、流采集、参数读写、事件回调等能力。
- pylon IP Configurator：GigE 相机专用工具，用于查看和修改相机 IP、子网掩码、网关，解决网段不匹配导致的连接失败。
- GenICam 与 GenTL 支持：pylon 遵循 GenICam 标准，通过 GenTL 生产者与传输层交互，使不同接口相机在 API 层保持一致的访问方式。
从层次上看，应用代码调用 pylon SDK，SDK 通过 GenTL 传输层与具体接口驱动通信，最终到达相机硬件。这个分层关系决定了：无论使用 GigE 还是 USB3 相机，上层采集逻辑基本一致，差异主要体现在传输层配置与带宽特性上。
相机接口类型与选型要点
Basler 相机常见接口有三类，选择时主要看带宽、距离和现场条件。
| 接口 | 典型带宽 | 线缆距离 | 适用场景 |
|---|---|---|---|
| GigE Vision | 1 Gbps（约 125 MB/s） | 可达 100 m | 多相机、远距离、PoE 供电 |
| USB3 Vision | 5 Gbps（约 500 MB/s） | 约 3～5 m | 高帧率、单相机、桌面设备 |
| Camera Link | 取决于采集卡配置 | 约 10 m | 高可靠、高带宽、工业现场 |
举例来说，若使用一台 500 万像素、8 位灰度、30 fps 的 GigE 相机，单帧数据量约为 5 MB，30 fps 需要约 150 MB/s，已超过千兆网理论带宽，实际需降低帧率或使用压缩/ROI。而同样参数下 USB3 接口则有余量。这个估算在选型和配置时非常实用。
SDK 安装与许可证配置
在 Windows 上，从 Basler 官网下载 pylon 安装包，运行后选择“Developer”或“Runtime”安装类型。开发机建议勾选 SDK、Viewer 和驱动。安装完成后，pylon 会注册 GenTL 生产者，并在系统服务中启动 pylon GigE 相关组件。Linux 下通常使用 .deb 或 .tar.gz 包，安装后需将当前用户加入相应组，并配置 udev 规则以便非 root 访问 USB 相机。
许可证方面，pylon 基础 SDK 可免费使用；部分高级功能（如特定图像处理模块、pylon Supplementary Package）可能需要授权。安装后可在 pylon Viewer 的“Help → About”中查看版本与授权状态。若使用 pylon 的 .NET 或 Python 绑定，需确认对应组件已随安装包勾选。
Windows / Linux 开发环境验证
安装完成后，先做环境验证，再写代码。Windows 下可打开命令提示符，检查 pylon 环境变量与 GenTL 路径：
# Windows 检查 pylon 环境变量
echo %PYLON_ROOT%
# 典型输出：C:\Program Files\Basler\pylon 7\Development
# 查看 GenTL 生产者
dir "%PYLON_ROOT%\..\Runtime\x64\GenTL"Linux 下可检查库文件与设备节点：
# Linux 检查 pylon 库
ls /opt/pylon/lib
# 检查 USB 相机是否被识别
lsusb | grep -i basler
# 检查 GigE 网卡与相机是否同网段
ip addr show若使用 C++ 开发，可编译一个最小程序验证链接是否成功：
#include <pylon/PylonIncludes.h>
#include <iostream>
using namespace Pylon;
int main() {
PylonInitialize();
CTlFactory& tl = CTlFactory::GetInstance();
DeviceInfoList_t devices;
tl.EnumerateDevices(devices);
std::cout << "Found " << devices.size() << " camera(s)" << std::endl;
PylonTerminate();
return 0;
}编译时需链接 pylon 库，例如在 Linux 下使用 pylon-config 获取编译参数：
g++ main.cpp -o test $(pylon-config --cflags --libs)运行后若输出“Found 1 camera(s)”，说明 SDK 安装、驱动和相机连接均正常。若输出 0，则需检查相机供电、网线、IP 配置或 USB 驱动。
用 pylon Viewer 采集第一帧图像
pylon Viewer 是最快的验证工具。打开后，左侧设备树会列出已识别的相机。选中相机，点击“Open”连接。若为 GigE 相机且未出现在列表中，可使用 pylon IP Configurator 将相机 IP 设为与主机同网段，例如主机 192.168.1.10，相机设为 192.168.1.20，子网掩码 255.255.255.0。
连接成功后，在 Viewer 中点击“Continuous Shot”或“Single Shot”即可预览。若画面全黑，依次检查：镜头盖是否取下、曝光时间是否过短、增益是否过低、触发模式是否被设为外部触发。可在“Features”面板中把 ExposureTime 设为 5000 μs，Gain 设为 0 dB，TriggerMode 设为 Off，通常即可看到正常图像。
采集到第一帧后，可点击“Save Image”保存为 PNG 或 BMP，作为环境验证的凭证。此时再回到代码中调用 SDK，就能把 Viewer 中验证过的参数（曝光、增益、ROI）映射到 API 调用里，减少调试盲区。