导读
本文针对 Dalsa Linea 系列网口线扫相机 （以 Linea C2048-7um-2 为例），提供了一套完整的配置与问题排查流程。从相机型号解读入手，详细介绍了网口巨帧包配置、单端/差分信号接线方案、相机软件各功能模块（感光芯片控制、IO 通道、计数器定时器、平场校正等）的配置方法，以及触发器采图、软件触发等多种采图模式的设置。
一、确认相机型号
首先确认当前使用的是网口相机
1、连接相机
使用如下工具，进行连接网口的相机配置
(1)、配置连接相机网口的IP地址
（2）、根据这个配置Dalsa相机的IP地址
二、前期准备
查看连接相机的网口配置，必须支持巨帧包数据传输：
三、相机配置
1、如何通过型号确认相机类型？
这里拿下面要使用的相机型号"Linea C2048-7um-2" 举例：
"Linea" 前缀 → 全线扫相机Linea 是 DALSA 专属线扫产品线；
" C ":表示是彩色相机 M：Mono 黑白灰度线扫（如 Linea M4096-10um）
" 2048"：单线像素宽度 2048 像素；
" 7um"：单个感光芯片像素尺寸 7 微米；
2、硬件信号接线介绍
信号模式区分（单端 / 差分 RS422）
- 单端接线（24V NPN/PNP 编码器 / 光电，现场最常用） 只接 LineX+ 信号正极，LineX- 悬空，信号负极统一接 Pin5 信号地。你当前编码器就是单端接入 Line1+（Pin1）。
- RS422 差分接线（长线、强电磁干扰环境）LineX+、LineX- 差分成对接线，抗干扰更强，适合几米以上远距离走线。
3、相机设置软件的使用配置介绍
3.1、相机软件界面功能介绍
3.1.1、 Camera Information 相机信息
|---------------------------|----------------------|
| 类别 | 详情 |
| Device User ID | 自定义相机名称 |
| Power-up Configuration | 开机加载预设 UserSet1 |
| Device Built-In Self Test | 设备自检结果 Passed（硬件无故障） |
| Device Reset | 相机软复位按钮 |
3.1.2、Sensor Control 感光芯片控制（核心成像参数）
|----------------------------|------------------------------------------------------------------------|
| 参数名称 | 说明 |
| Acquisition Line Rate | 最大采集行频（单位 Hz，行 / 秒），输送带速度越快，需要更高行频匹配，避免图像拉伸压缩 |
| Exposure Mode | 曝光模式，每行曝光时长固定为 Exposure Time；对比另一种 Encoder 模式：曝光时长随编码器脉冲动态调整，高速运动场景防拖影 |
| Exposure Time | 单行曝光时间，单位 μs（微秒），控制感光时长，数值越大画面越亮；过大会出现运动拖影，过小画面发黑，需配合光源亮度、产线速度调节 |
| Gain Selector | 增益作用通道选择，Digital All 代表 RGB 三色通道统一施加增益；可切换 Red/Green/Blue 单独调节，用于白平衡校正 |
| Gain | 数字增益倍数，放大图像整体亮度，＞1 提亮画面，＜1 压暗；增益越高噪点越明显，优先调光源再调增益 |
| Black Level Selector | 黑电平校正通道选择，黑电平偏移统一作用全部 RGB 通道；可单独分通道校正暗底色 |
| Black Level | 黑电平偏移值，校正传感器暗电流底色，暗场有灰雾、黑斑时小幅抬高数值，纯黑场景默认 0 |
| Line Spatial Corr | 行间空间校正系数，配合平场校正 FFC，补偿像素感光不均、镜头明暗差；1.0 为标准校正强度 |
| Sensor Scan Direction | 像素读出方向 = 正向，Forward 正向输出图像；切换 Reverse 会整幅图像左右翻转，用于安装方向匹配 |
| Parallax Correction | 视差校正启用红蓝通道补偿（彩色线扫独有），RGB 三线分光棱镜存在物理间距，物料边缘会出现 RGB 彩色重影；开启该功能做通道错位对齐 |
| Parallax Correction Offset | 视差校正偏移量，微调 RGB 通道横向偏移，出现彩边、重影时正负调整该数值，消除彩色错位 |
3.1.3、 I/O Controls 数字输入输出控制
|--------------------|------------------------------------------------------------------------|
| 参数名称 | 参数说明 |
| Trigger Selector | 触发方式选择，单行采集触发（线扫专属），每收到 1 路有效触发脉冲，相机输出 1 行图像；区别于 Frame Trigger（面阵整帧触发） |
| Trigger Mode | 触发模式开启，相机不再自由连续出图，仅等待外部触发信号才采集；关闭则 FreeRun 自由行频采集 |
| Trigger Source | Rotary Encoder，触发源为旋转编码器，靠输送带编码器脉冲同步采图，物料移动 1 个脉冲距离输出 1 行，保证横向分辨率恒定 |
| Trigger Overlap | Readout，触发重叠模式 = 读出重叠，曝光与图像读出并行执行，提升最大支持行频，高速产线必开 |
| Trigger Line Count | 1，每输出 1 行需要 1 个有效编码器脉冲，1 脉冲 = 1 行，匹配当前编码器分频配置 |
3.1.3.1、旋转编码器通道配置（Rotary Encoder 系列）
|-----------------------------------|----------------------------------------------------------------------------------|
| 参数 | 详情 |
| Rotary Encoder Mode | 编码器工作模式，Motion，运动采集模式，仅编码器有脉冲移动时才触发采图，静止时停止输出图像，节省带宽 |
| Rotary Encoder Line | 编码器 A 相脉冲接入相机 IO 通道 1，指定编码器信号输入硬件通道 |
| Rotary Encoder Polarity | GND，编码器信号基准电平 GND |
| Rotary Encoder Edge | Rising Edge，上升沿触发采样 |
| Rotary Encoder Divider/Multiplier | 1 / 1，编码器分频、倍频系数均为 1，原始脉冲不做缩放，1 个物理脉冲 = 1 个计数脉冲；如需压缩图像可增大 Divider（每 N 脉冲才触发 1 行） |
3.1.3.2、IO 输入通道硬件配置
|--------------------------|-----------------------------------------------------------------------------------|
| 配置项 | 详情 |
| Line Selector | IO 通道 1（编码器输入通道） |
| Line Format | SingleEnded（单端信号输入，普通 24V NPN/PNP 编码器，仅 A+GND 两根线；差分编码器选 Differential（抗干扰更强）） |
| Line Mode | Input（该通道为信号输入，接收编码器脉冲） |
| Input Line Threshold | Threshold for 24V（输入电平阈值适配 24V 工业传感器 / 编码器） |
| Line Status | False（当前通道无有效脉冲信号） |
| Line Inverter | False（信号不反转，若编码器是 NPN 输出，信号逻辑正常；PNP 输出需设 True 反转电平） |
| Input Line Debounce | 8（输入信号消抖滤波 8 个时钟周期，过滤脉冲杂波、电磁干扰，避免误触发） |
3.1.4、Counter And Timer Control 计数器与定时器
硬件计数器 Counter与 硬件定时器 Timer两大模块， 用于产线长度计数、外部 IO 时序控制、分段采集、光源延时触发，当前全部处于关闭闲置状态。
3.1.4.1、计数器配置
|-------------------------------------|---------------------------------------------------------------------------------------------|
| 参数 | 详情 |
| Counter Selector | Counter 1，选中相机内置 1 号硬件计数器进行参数配置，相机内置多路独立计数器，可分别统计编码器脉冲、光电触发次数、物料长度 |
| Counter mode | Off，计数器功能关闭，关闭后不进行脉冲累加计数；可选 Motion/Trigger 模式，用于物料长度统计、分段采集 |
| Counter Status | Counter idle，计数器闲置无工作，状态标识，开启计数后变为 Counting；触发复位后变为 Resetting |
| Counter Start Source | Line 2 / Rising Edge，数器启动信号为 IO 通道 2，上升沿触发启动，外部光电感应到物料头部（Line2 输入上升沿）时，计数器开始累加脉冲，用于单根物料长度测算 |
| Counter Increment Source | Line 2 / Rising Edge，计数增量脉冲来自 IO 通道 2 上升沿，每收到 1 个 Line2 上升沿，计数值 + 1；常规产线会绑定编码器通道用于长度换算 |
| Counter Reset Source | Reset Cmd / Not Enabled， 复位源为软件指令，硬件复位未开启，仅软件下发指令清零计数值；可切换 IO 通道实现外部自动复位 |
| Counter Duration | 1，单次计数持续周期 1，计数达到设定阈值后停止计数，多用于固定长度分段采集 |
| Counter Value / Counter Value Limit | 0 / 0， 当前计数值、计数上限阈值均为 0，Value 实时显示累计脉冲数；Limit 设置计数上限，到达上限自动停止计数 |
| Counter Reset | Not Enabled，自动复位功能关闭，开启后计数到达 Limit 阈值自动清零，循环统计物料 |
3.1.4.2、计时器配置
|--------------------|----------------------------------------------------------------------|
| 配置项 | 详情 |
| Timer Selector | Timer 1，选中 1 号硬件定时器配置，相机多路硬件定时器，用于光源延时、IO 输出延时、曝光时序同步 |
| Timer mode | Off，定时器功能关闭，开启后可实现 IO 延时输出，常用场景：触发信号延迟 N 微秒点亮光源 |
| Timer Status | Timer Idle，定时器闲置未启动，收到启动信号后状态变为 Running，计时结束回到 Idle |
| Timer Start Source | Line 1 / Rising Edge，定时器启动信号为 IO 通道 1 上升沿（编码器输入通道），编码器脉冲到来时触发定时器开始计时 |
| Timer Delay | 0，定时器启动后延时 0 个时钟周期再输出信号，调整光源与曝光的时序差，避免曝光前光源未稳定 |
| Timer Duration | 1，定时输出持续时长 1 个时钟周期，控制光源点亮、IO 输出信号的维持时间 |
| Timer Value | 0，当前计时数值，实时显示定时器已运行时长 |
| Timer Reset | Not Enabled，自动复位关闭，计时结束后不会自动清零，需外部信号或软件复位 |
3.1.5、Advanced Processing 高级图像处理（相机内置 FPGA 处理）
Flat Field Correction（平场校正 FFC） 、 LUT 查找表伽马校正，全部由相机 FPGA 硬件实时运算，不占用 PC 算力。
3.1.5.1、Flat Field Correction 平场校正
|-----------------------------------|-----------------------------------------------------------------|
| 参数 | 详情 |
| Flat Field Correction | Active（平场校正功能开启，消除镜头暗角、光源明暗不均、像素感光差异，让纯白背景横向亮度均匀，是线扫检测必备校正） |
| Flat Field Correction Source | Factory Flatfield（使用相机出厂预存的原厂校正系数，可切换User Flatfield加载用户现场自校准参数） |
| Calibration Algorithm | Basic（基础校准算法，现场自校准时使用的采集计算逻辑，基础模式适配绝大多数工业光源） |
| Flat field Calibration Line Count | 64（自校准时连续采集64行图像做平均，降低随机噪点对校正系数的干扰） |
| Flat field Calibration Width Min | 0（校准采集横向起始像素0） |
| Flat field Calibration Width Max | 2048（校准采集完整2048像素全宽，覆盖全部传感器视野） |
| Save Calibration | Not Enabled（现场自校完成后开启保存，将用户校正系数存入相机非易失内存，开机自动加载） |
| Reset Coefficients | Press...（一键复位校正系数，恢复原厂出厂校正数据） |
| Flat Field Correction Selector | Green（当前选中绿色通道查看校正系数；彩色线扫可切换Red/Green/Blue三色通道分别校准） |
| Flat Field Correction Offset | 0（绿色通道校正偏移量，原厂标准值0） |
| Flat Field Correction Coefficient | 0.998291（绿色通道像素增益校正系数，接近1代表原厂感光均匀度良好） |
3.1.6、Cycling Preset 采集预设组
该模块是 DALSA 相机多套成像参数快速切换功能，可存储多组曝光、增益、平场校正等参数，支持 IO / 软件触发一键切换，适配多材质、多工位混合检测场景。
|-------------------------------|-------------------------------------|------------------------------------------------------------------|
| 参数名称 | 参数说明 | 具体设置 |
| Cycling Preset Mode | 循环预设切换功能 | Off（关闭，开启后可自动 / 外部触发切换 Preset1/2 等多套参数） |
| Cycling Preset Index | 相机内置多组独立参数存储空间，Index 数值代表当前激活的预设编号 | 2 |
| Cycling Preset Trigger Source | 参数切换时机，保证参数切换在两行图像间隙完成，不会出现单张图像参数错乱 | Start of Exposure（可切换至帧起始、外部 IO 沿等时机） |
| Trigger Input Line Select | 是否绑定外部 IO 硬件通道作为预设切换触发 | Not Enabled（未绑定，若接入光电传感器 / 按钮到指定 IO 通道，可通过外部电平变化自动切换预设） |
| Cycling Preset Invert | 是否反转切换触发信号逻辑 | Not Enabled（不反转，NPN/PNP 信号电平不匹配时开启，反转上升 / 下降沿触发逻辑） |
| Cycling Preset Select | 当前预设切换方式 | Software（软件指令切换，上位机软件下发指令切换 Preset1/2；可切换为 Hardware（硬件 IO 自动切换）） |
| Cycling Preset Save | 保存当前所有成像参数到指定 Index 预设组 | Press... |
| Cycling Preset Recall | 一键加载指定组预设参数 | 1（一键加载第 1 组预设参数，点击后相机立刻切换到 Preset1 存储的全套成像配置） |
| Features Activator Select | 选中作为可保存到预设的参数项 | Exposure Time（可切换 Gain、Flat Field Correction 等，单独选择要存入预设的成像参数） |
| Features Activation | 选中的参数项是否开启预设存储功能 | Active（开启，修改 Exposure Time 会同步记录到当前 Index 预设；关闭则不保存该参数） |
| Preset Configuration Load | 开机是否自动加载预设组 | Not Enabled（开机不自动加载预设组，开启后相机上电自动加载指定 Index 的预设参数） |
3.1.7、Image Format Controls 图像格式控制
|--------------------|-----------------------------------------------------------------------------------------------|
| 参数 | 说明 |
| Pixel Format | RGB8，彩色线扫最终输出格式，上位机可直接读取标准 RGB 彩色图 |
| Horizontal Offset | 0，图像横向起始像素偏移 0，从传感器最左端开始采集 |
| Width | 1024，输出图像横向宽度 1024 像素，原生传感器 2048 像素，配合水平 2 倍 Binning，等效完整视野，带宽减半 |
| Height | 996，输出图像纵向行数 996 行，一帧图像缓存 996 行线扫数据 |
| Multiple ROI Mode | Off，多区域裁剪关闭，仅单块 ROI 输出图像 |
| Binning Selector | In Digital Domain，数字域合并（硬件后处理合并，不降低感光灵敏度），Sensor Domain 为芯片物理合并，会提升亮度；Digital 仅做像素求和压缩尺寸，亮度不变 |
| Binning Horizontal | 2，水平 2 像素合并，2 个相邻像素求和输出 1 个像素，原生 2048 像素 → 2048/2=1024 宽度，和上方 Width=1024 匹配，带宽直接减半 |
| Binning Vertical | 1，纵向不合并，每行像素独立输出 |
| Horizontal Flip | False，图像不做左右翻转；改为 True 可镜像画面，适配相机反向安装场景 |
| Negative Image | False，不输出负片（黑底白图），正常正向灰度图像 |
**图像尺寸逻辑：**原生 2048 像素 → 水平 2 倍数字合并 → 输出宽度 1024，纵向 996 行一帧，RGB8 彩色 8bit 输出；
3.1.8、 Acquisition And Transfer Control 采集与传输控制
采集控制（Acquisition） 、 图像传输控制（Transfer） 两大模块，用于管理相机启停、触发采集、数据流传输逻辑
|-----------------------|-----------------------------------------|
| 类别 | 详情 |
| Acquisition Status | Acquisition Triggered，相机当前采集状态为「等待外部触发」 |
| Acquisition Stop Mode | True，停止采集时完整输出当前缓存图像后再终止 |
3.1.9、Device Event Control 设备事件报警
时间戳，时间管理；
|--------------------------|----------------------------------------------------------------------|
| 模块 | 详细描述 |
| Event Selector | 当前选中「事件溢出」告警项；可切换故障类型，如 Image Lost（丢图）、Overheat（超温）、Trigger Error 等 |
| Event Notification | Off，事件告警关闭，异常不会触发 IO / 软件上报；调试排查丢帧时可开启 |
| Event Statistic Selector | Image Lost，丢图统计项，Event Statistic Value = 0 代表当前无丢帧，数值上涨即传输 / 缓存不足丢图像 |
| Event Statistic Reset | 清零故障统计计数，排查后重置观察新故障 |
正常生产：Event Notification 保持 Off，减少资源占用；
3.1.10、GigE Vision Transport Layer GigE 网口传输层（GigE 网口相机专属）
|-------------------------|-----------------------------------------------|
| 配置项 | 详情 |
| Device Link Speed | 1000千兆网链路速率，当前跑满 1000Mbps |
| PacketSize | 9000，启用巨帧 Jumbo Frame，大幅减少数据包分包，降低丢包概率，工业推荐配置 |
| Packet Resend Threshold | 25.0，丢包重传阈值，网络波动时自动补发丢失图像包，提升稳定性 |
| Interpacket Delay | 0，包间隔无延时，最大化传输带宽 |
| IP Configuration Mode | ForceIP，强制静态 IP 模式，相机固定 IP，开机不会自动变动 |
| Device Access Mode | Exclusive Access，独占访问，仅当前软件占用相机，避免多软件冲突抢设备 |
| Current Heartbeat | 3000ms，心跳保活周期 3 秒，超过无通讯相机自动断连释放资源 |
3.1.11、File Access Control 文件读写
略
3.1.12、GigE Vision Host Controls PC主机网卡控制
|----------------------|-----------|--------------------------------------------|
| 参数名称 | 参数值 | 说明 |
| Inter-Packet Time | 0.045 | 数据包发送间隔，用于限速，高行频丢帧可适当加大数值缓解网卡过载 |
| Maximum Packet Count | 100.0 | 单次批量发送最大数据包数量，平衡传输效率与系统负载 |
| Image Timeout | 0.7s | 图像完整接收超时阈值，0.7 秒未收完一帧图像判定为丢图，触发重传 |
| System Transfer Mode | Automatic | 自动分配 PC 接收缓存，无需手动设置；高带宽场景可手动调大缓存容量 10008.0 |
| Command Timeout | 200ms | 下发相机参数指令的等待超时时间 |
| Command Retry Count | 3 | 指令通讯失败自动重试 3 次，提升工业现场电磁干扰下的通讯稳定性 |
频繁丢图、超时报错：增大Image Timeout、调大接收缓存、小幅增加Inter-Packet Time；
4、相机采图配置
4.1、触发器采图配置：
|---------------------------------------------|------------------------|---------------------------------------|
| 类别 | 设置项 | 详情 |
| 触发核心（Acquisition And Transfer Control） | Trigger Mode | On 开启外部触发 |
| 触发核心（Acquisition And Transfer Control） | Trigger Source | Rotary Encoder 触发源设编码器 |
| 触发核心（Acquisition And Transfer Control） | Trigger Selector | Single Line Trigger 单行线扫触发 |
| 触发核心（Acquisition And Transfer Control） | Trigger Overlap | Readout 曝光读出并行，提升最大行频 |
| 触发核心（Acquisition And Transfer Control） | Line Trigger Increment | 每 N 个脉冲输出 1 行，控制横向像素密度 |
| 编码器 IO 硬件（I/O Controls） | Line Selector | 选中编码器接入通道（Line1） |
| 编码器 IO 硬件（I/O Controls） | Line Format | SingleEnded（24V 单端编码器） |
| 编码器 IO 硬件（I/O Controls） | Line Mode | Input |
| 编码器 IO 硬件（I/O Controls） | Rotary Encoder Mode | Motion 运动时才采图 |
| 编码器 IO 硬件（I/O Controls） | Rotary Encoder Edge | Rising Edge 上升沿计数 |
| 编码器 IO 硬件（I/O Controls） | Line Inverter | 根据 NPN/PNP 信号匹配电平 |
| 编码器 IO 硬件（I/O Controls） | Line Debounce | 消抖过滤脉冲干扰 |
| 成像基础（Sensor Control） | Acquisition Line Rate | 匹配产线速度设最大行频 |
| 成像基础（Sensor Control） | Exposure Time / Gain | 画面亮度参数 |
| 成像基础（Sensor Control） | Parallax Correction | 彩色线扫消除 RGB 重影 |
| 成像基础（Sensor Control） | Flat Field Correction | 开启平场校正消除明暗条纹 |
| 网络传输（GigE Vision Transport Layer GigE ） | PacketSize | 9000 巨帧开启 |
| 网络传输（GigE Vision Transport Layer GigE ） | Packet Resend | 丢包重传开启 |
| 网络传输（GigE Vision Transport Layer GigE ） | 其他设置 | 网卡静态 IP 与相机同网段，Image Timeout、接收缓存防止丢帧 |
| GigE Vision Host Controls | Inter-Packet Time | 数据包发送间隔，用于限速，高行频丢帧可适当加大数值缓解网卡过载 |
| GigE Vision Host Controls | Maximum Packet Count | 单次批量发送最大数据包数量，平衡传输效率与系统负载 |
| GigE Vision Host Controls | Image Timeout | 图像完整接收超时阈值 |
| 采集启动 | Acquisition Arm | 点击就绪，等待编码器脉冲出图 |
参考ccf文件：
通过网盘分享的文件：DALSA_C2048_Cam1.ccf
链接: 百度网盘 请输入提取码 提取码: cqc9
4.2、软件触发，自由触发配置
|---------------------------------------------|-----------------------|-----------------|
| 类别 | 设置项 | 详情 |
| 触发核心（Acquisition And Transfer Control） | Trigger Mode = Off | 关闭外部触发，切换自由连续采集 |
| 成像基础（Sensor Control） | Acquisition Line Rate | 设置固定自由行频 |
| 成像基础（Sensor Control） | Exposure Time / Gain | 亮度调节 |
| 网络传输（GigE Vision Transport Layer GigE ） | PacketSize | 9000 巨帧开启 |
| 网络传输（GigE Vision Transport Layer GigE ） | Packet Resend | 丢包重传开启 |
四、常见问题排查
1、网口配置没有巨帧包支持？
此时第一步网口配置就跳不过去，这里需要坚持网口配置，或者选用支持巨帧包设置的USB转网口，从而绕过网卡设置，也可以换用支持巨帧包的网卡设备
2、采集丢帧？如下图
当行频太小时，超时时间需要调大。
3、外部编码器，硬件接线故障？
如果"Counter And Timer Control/Courter Value = 0"，很有可能是外部接线硬件有问题，具体要分析什么原因。