相机配置说明

1. 概述

本文档详细说明SISO系统中相机设备的配置方法，包括配置文件格式、参数说明以及配置示例。相机配置文件采用JSON格式，存储在DeviceLibrary/Config/目录下。

2. 配置文件格式

相机配置文件采用JSON格式，每个相机对应一个配置文件，文件名格式为Camera[相机标识].json，例如CameraA.json。

2.1 基本结构

{
  "CameraInfo": {
    "CameraId": "CameraA",
    "Model": "HIKVISION_MV-CA050-10GC",
    "IpAddress": "192.168.1.10",
    "Port": 8000,
    "Manufacturer": "HIKVISION",
    "FirmwareVersion": "V3.2.0"
  },
  "ImageSettings": {
    "Width": 2592,
    "Height": 2048,
    "PixelFormat": "Mono8",
    "AcquisitionMode": "Continuous",
    "ExposureTime": 5000,
    "Gain": 0.0,
    "FrameRate": 25.0,
    "TriggerMode": "Off"
  },
  "ROI": {
    "Enable": false,
    "OffsetX": 0,
    "OffsetY": 0,
    "Width": 2592,
    "Height": 2048
  },
  "Processing": {
    "EnableBinning": false,
    "BinX": 1,
    "BinY": 1,
    "EnableDecimation": false,
    "DecimationX": 1,
    "DecimationY": 1
  },
  "Advanced": {
    "BalanceRatioRed": 1.0,
    "BalanceRatioGreen": 1.0,
    "BalanceRatioBlue": 1.0,
    "Gamma": 1.0,
    "BlackLevel": 0,
    "WhiteBalanceMode": "Off",
    "Sharpness": 0.0
  },
  "Storage": {
    "SaveRawImages": false,
    "SaveProcessedImages": false,
    "ImageSavePath": "Images",
    "ImageFormat": "PNG"
  }
}

3. 配置参数说明

3.1 CameraInfo 部分

参数	类型	说明	是否必需
CameraId	String	相机唯一标识，必须与文件名对应	是
Model	String	相机型号	是
IpAddress	String	相机IP地址（对于网络相机）	对于网络相机必需
Port	Integer	相机端口（对于网络相机）	对于网络相机必需
Manufacturer	String	相机制造商	否
FirmwareVersion	String	相机固件版本	否

3.2 ImageSettings 部分

参数	类型	说明	是否必需	默认值
Width	Integer	图像宽度（像素）	是	相机默认分辨率
Height	Integer	图像高度（像素）	是	相机默认分辨率
PixelFormat	String	像素格式（Mono8, RGB8, BGR8等）	是	Mono8
AcquisitionMode	String	采集模式（Continuous, SingleFrame, MultiFrame）	是	Continuous
ExposureTime	Integer	曝光时间（微秒）	是	10000
Gain	Double	增益值（dB）	是	0.0
FrameRate	Double	帧率（FPS）	是	30.0
TriggerMode	String	触发模式（Off, On）	是	Off

3.3 ROI 部分

参数	类型	说明	是否必需	默认值
Enable	Boolean	是否启用ROI	否	false
OffsetX	Integer	ROI起始点X坐标	否	0
OffsetY	Integer	ROI起始点Y坐标	否	0
Width	Integer	ROI宽度	否	图像宽度
Height	Integer	ROI高度	否	图像高度

3.4 Processing 部分

参数	类型	说明	是否必需	默认值
EnableBinning	Boolean	是否启用Binning	否	false
BinX	Integer	X方向Binning系数	否	1
BinY	Integer	Y方向Binning系数	否	1
EnableDecimation	Boolean	是否启用Decimation	否	false
DecimationX	Integer	X方向Decimation系数	否	1
DecimationY	Integer	Y方向Decimation系数	否	1

3.5 Advanced 部分

参数	类型	说明	是否必需	默认值
BalanceRatioRed	Double	红色通道平衡比例	否	1.0
BalanceRatioGreen	Double	绿色通道平衡比例	否	1.0
BalanceRatioBlue	Double	蓝色通道平衡比例	否	1.0
Gamma	Double	伽马校正系数	否	1.0
BlackLevel	Integer	黑电平值	否	0
WhiteBalanceMode	String	白平衡模式（Off, Continuous, Once）	否	Off
Sharpness	Double	锐度调整值	否	0.0

3.6 Storage 部分

参数	类型	说明	是否必需	默认值
SaveRawImages	Boolean	是否保存原始图像	否	false
SaveProcessedImages	Boolean	是否保存处理后图像	否	false
ImageSavePath	String	图像保存路径	否	Images
ImageFormat	String	图像保存格式（PNG, JPG, BMP等）	否	PNG

4. 配置示例

4.1 网络相机配置示例

{
  "CameraInfo": {
    "CameraId": "CameraA",
    "Model": "HIKVISION_MV-CA050-10GC",
    "IpAddress": "192.168.1.10",
    "Port": 8000,
    "Manufacturer": "HIKVISION",
    "FirmwareVersion": "V3.2.0"
  },
  "ImageSettings": {
    "Width": 2592,
    "Height": 2048,
    "PixelFormat": "Mono8",
    "AcquisitionMode": "Continuous",
    "ExposureTime": 10000,
    "Gain": 0.0,
    "FrameRate": 25.0,
    "TriggerMode": "Off"
  },
  "ROI": {
    "Enable": false,
    "OffsetX": 0,
    "OffsetY": 0,
    "Width": 2592,
    "Height": 2048
  },
  "Processing": {
    "EnableBinning": false,
    "BinX": 1,
    "BinY": 1,
    "EnableDecimation": false,
    "DecimationX": 1,
    "DecimationY": 1
  },
  "Advanced": {
    "BalanceRatioRed": 1.0,
    "BalanceRatioGreen": 1.0,
    "BalanceRatioBlue": 1.0,
    "Gamma": 1.0,
    "BlackLevel": 0,
    "WhiteBalanceMode": "Off",
    "Sharpness": 0.0
  },
  "Storage": {
    "SaveRawImages": false,
    "SaveProcessedImages": false,
    "ImageSavePath": "Images",
    "ImageFormat": "PNG"
  }
}

4.2 带ROI的相机配置示例

{
  "CameraInfo": {
    "CameraId": "CameraB",
    "Model": "HIKVISION_MV-CA020-10GC",
    "IpAddress": "192.168.1.11",
    "Port": 8000,
    "Manufacturer": "HIKVISION",
    "FirmwareVersion": "V3.1.0"
  },
  "ImageSettings": {
    "Width": 1920,
    "Height": 1200,
    "PixelFormat": "RGB8",
    "AcquisitionMode": "Continuous",
    "ExposureTime": 5000,
    "Gain": 0.0,
    "FrameRate": 30.0,
    "TriggerMode": "On"
  },
  "ROI": {
    "Enable": true,
    "OffsetX": 500,
    "OffsetY": 300,
    "Width": 1000,
    "Height": 800
  },
  "Processing": {
    "EnableBinning": false,
    "BinX": 1,
    "BinY": 1,
    "EnableDecimation": false,
    "DecimationX": 1,
    "DecimationY": 1
  },
  "Advanced": {
    "BalanceRatioRed": 1.2,
    "BalanceRatioGreen": 1.0,
    "BalanceRatioBlue": 0.9,
    "Gamma": 1.2,
    "BlackLevel": 5,
    "WhiteBalanceMode": "Continuous",
    "Sharpness": 0.1
  },
  "Storage": {
    "SaveRawImages": false,
    "SaveProcessedImages": true,
    "ImageSavePath": "Images/CameraB",
    "ImageFormat": "JPG"
  }
}

5. 配置文件管理

5.1 配置文件位置

相机配置文件存储在以下位置：

DeviceLibrary/
└── Config/
    ├── CameraA.json
    ├── CameraB.json
    └── ...

5.2 配置加载流程

1. 系统启动时，Camera.cs类会扫描Config目录下的所有相机配置文件
2. 根据配置文件中的信息初始化相应的相机设备
3. 如果配置文件不存在或格式错误，系统将使用默认配置

5.3 配置修改方法

1. 直接编辑对应的JSON配置文件
2. 通过系统的配置界面进行修改（如果有）
3. 修改完成后，需要重启系统才能使新配置生效

6. 常见问题与解决方案

6.1 相机无法连接

• 检查IP地址和端口是否正确配置
• 确认相机与计算机在同一网络中
• 验证相机是否已正确供电并处于工作状态

6.2 图像质量问题

• 调整曝光时间和增益参数
• 对于彩色相机，检查白平衡设置
• 考虑启用ROI功能，只关注感兴趣的区域

6.3 帧率不达标

• 降低图像分辨率
• 启用Binning或Decimation功能
• 检查网络带宽是否足够（对于网络相机）

6.4 配置文件无效

• 确认JSON格式是否正确，可以使用在线JSON验证工具检查
• 检查必需参数是否都已配置
• 确保文件名与CameraId字段匹配