Skip to content

物理相机发现、许可证与资源管理 ​

从“工具 > 管理员服务配置”打开设备配置,点击顶部的“物理相机管理”,可扫描相机、创建物理资源,并维护许可证、校正文件和还原点。管理窗口在 MySQL 已连接时读取业务数据库,未连接时读取本地配置库,扫描会调用相机 SDK;创建、导入和恢复还可能写配置、文件及关联服务,应在已明确目标和操作范围的环境执行。采集步骤与完成判据见相机服务,参数编辑和同步覆盖见相机配置。

相机控制面板的连接与视频按钮同一行最右侧提供齿轮按钮,直接打开物理相机管理,并选中当前逻辑相机关联的物理相机、显示其详情;未关联物理相机时沿用管理窗口的默认选择。该入口复用已有的管理员权限检查。

离线配置与许可证 ​

未连接 MySQL 时,物理相机、设备及许可证沿用现有字段写入 ColorVision.Local.db 配置文档;没有服务器数据同步。许可证导入、替换、删除和过期清理使用同一来源;过期清理仍在删除时重查有效期,续期不会重建已有物理相机。本地相机连接由程序读取关联许可证的 ExpiryDate 判断是否到期,具体开关与检查时机见相机服务。具体创建步骤见离线设备配置。

扫描相机并创建资源 ​

  1. 点击“扫描”,选择要搜索的型号。默认勾选 QHY_USB、HK_USB、HK_CARD、HK_FG_CARD,也可用“全选”“清除”调整。未选择型号不能开始,取消型号窗口不会扫描。
  2. 点击“搜索”,在结果窗口先查看各型号的数量、耗时和状态。SDK 返回成功但数量为 0,与型号搜索失败是两种结果;某个型号失败不会阻止其它已选型号继续搜索。搜索进行中再次发起会被拒绝。
  3. 在下方相机列表核对 CameraID、MD5 和识别型号。托管发现按“型号 + CameraID”去重,结果窗口又将相同 MD5 的条目合并,所以各型号数量之和可能大于窗口的相机总数。
  4. 对未创建的条目点击“创建”,在创建窗口核对代码、ID、型号与物理参数,再确认。该入口预填扫描结果,不要求数据库中事先已有空配置候选。确认会插入或更新物理资源,并进入下文的目录请求和关联流程。

工具栏的“添加相机”在 MySQL 模式列出 Type == 101 且 Value 为空的物理相机资源,候选与许可证是否过期无关。没有候选时提示并转入扫描。本地模式允许直接填写相机代码与 ID。CreateWindow 保存失败时不继续创建流程;窗口关闭或行显示已创建仍不能代替硬件与绑定验收。

创建窗口与“修改配置”复用同一参数面板:顶部设置型号、模式、位深与通道,左侧切换相机参数、电机配置、参数限制和文件服务;CV 模式另有 CFW 分类。创建窗口额外保留相机代码选择和默认取图模式,底部提供属性编辑、提交与取消。两处使用相同的深浅主题文字、背景、边框和选中颜色,分类内容独立滚动;取消不会执行创建保存。

管理列表与扫描结果的含义 ​

PhyCameraManager.LoadPhyCamera 查询当前配置库中的 ServiceTypes.PhyCamera 资源,有非空配置的记录才新建物理对象。PhyCamera 持有配置、许可证、校准资源和逻辑设备关联。

已有资源 ID 会复用原对象,只刷新名称、资源模型和相机身份,不重载全部参数或子资源;配置库中不存在或配置为空的旧对象会被移除。首次加载与复用对象采用同一身份读取规则:优先取配置 JSON 的 CameraID,缺失时兼容旧 Name;空 Name 不覆盖已有 ID。若旧值与物理 Code 不匹配,而其他旧字段存在完整 MD5 匹配的 ID,则取匹配值修复;不能把界面显示用的 Code 当作 CameraID。物理配置保存时同时保持资源 Name 与配置中的 ID 一致。

SearchCameraIds 在后台依次调用所选型号的 SDK 枚举,再加载管理对象。底层搜索只返回 ID/MD5,不负责保存 WPF 配置。PhysicalCameraIdentity 将成功搜索的完整 MD5(CameraID) 与已有物理 Code 匹配,保存物理 ID 及兼容 Name,并同步同一配置库中逻辑相机、校准设备的 ID 镜像;不会改 Code、自动切换绑定、重置参数或重启设备。身份更新使用最新读取的配置 JSON 并保留其他字段,删除或尚未配置的物理记录不被搜索重新创建。

原生枚举返回 CV_ERR_CAM_SCAN (-10005) 时,搜索结果显示未发现相机,数量为 0;其它失败保留返回码或异常信息。未发现、搜索失败或 MD5 不匹配时保留原 ID。身份同步持久化失败会报告错误;物理与各逻辑记录分开保存,重复搜索可补齐未完成的同步。

打开管理窗口时,已在相机面板连接的物理相机显示“已打开”,计入在线数。其余相机按清单中实际配置的海康和 QHY 型号在后台各枚举一次。仅配置一台未打开的 HK_USB 时只调用 HK_USB 枚举。型号和相机 Code 匹配时显示在线,枚举成功但未找到时显示离线,枚举失败或无扫描结果时显示未知。列表、详情、在线数与排序使用同一内存状态,重新打开或手动扫描可刷新。状态不读写数据库 Remark。

找到所需操作 ​

先在左侧选择目标物理相机,再使用对应位置的操作。左侧相机卡片在型号和模式旁显示位深与通道数,例如 16 bit · 3 ch。末行左侧显示许可证到期日期,右侧显示状态提示。列表与详情均以相机型号为主标题,详情下方保留可复制的相机代码、参数与许可证状态。许可证更新、在线下载、复制和导出集中在许可证区域右侧。下方按“相机配置”“校正管理”“备份与恢复”分组,相机配置的“修改配置”“打开配置文件”“编辑滤光轮配置”按等宽三列排列,其它组沿用四列,详情区较窄时切为两列。中英文长文案在按钮内换行,操作区可独立滚动。列表右键菜单提供编辑与删除,编辑进入相同的物理配置窗口。清单宽度可拖动调整,没有选中相机时显示选择提示。“重置”位于备份与恢复区底部,会清除当前相机的校正资源与模板,执行前仍需确认。

“相机配置 → 编辑滤光轮配置”维护孔位索引与名称,默认依次为 0: ND0、1: ND8、2: ND64、3: ND1000、4: EMPTY、5: Spectrum。孔位行按编辑框内容自动计算高度,名称列随窗口宽度伸缩;列表空间不足时纵向滚动。窗口右上角的“重置”只恢复当前编辑列表,点击“提交”才写回物理相机配置;取消或关闭会丢弃本次编辑。升级保留已保存的孔位映射,旧配置需要补齐 ND0 时可在这里重置后提交;孔位名称与实际装片仍需按设备核对。

详情许可证区域保留后面的“开始日期 - 结束日期”,仅给前面状态提示中的结束日期补上时间。扣除日期范围占用的宽度后,依次显示 yyyy-MM-dd HH:mm:ss、yyyy-MM-dd HH:mm 或 yyyy-MM-dd HH;较窄时日期范围沿用原有换行布局,悬停状态提示始终可查看到秒的完整时间。结束时间来自许可证记录的 ExpiryDate,本地相机打开时的到期判断也使用该字段,具体开关见相机服务。

位置与名称用途
顶部“导入许可证”批量读取 .lic / .zip;已有相机只替换许可证,未创建相机进入创建流程,见下文
顶部“许可证管理”直接打开许可证管理窗口;与导入入口一同常驻工具栏
当前相机的许可证区域使用当前相机的许可证更新入口;按相机代码匹配
详情区“修改配置”编辑选中相机的物理配置
详情区“打开配置文件”实际打开 FileBasePath / Code 文件夹,目录存在时才可用
详情区“上传校正文件”解包校正资源到当前相机目录并更新数据库,见下文
详情区“创建还原点” / “加载还原点”通过保存/打开窗口创建或直接载入 .cvcal,见下文
顶部“设备管理器”打开 Windows 设备管理器
顶部“MVS 日志”打开本机 MVS 日志工具,检测到 LogViewer 时显示

创建资源时的目录请求与自动关联 ​

创建窗口和管理器许可证导入在保存新增物理相机配置前,使用 Directory.CreateDirectory 确保本机 FileBasePath/<相机Code>/cfg 存在;目录已存在时保留其中的全部校正文件,创建失败则报错并停止保存该物理相机配置。已配置相机的许可证重导只更新许可证,不重新创建相机或覆盖路径配置。

保存成功后,CompletePhysicalCameraCreation 统一处理扫描/手动创建与许可证导入的首次创建收尾,刷新本地集合、维护许可证记录并补齐空设备绑定,不再发送 PhysicalCamera_Load:旧版服务收到这个事件会递归删除整台物理相机的目录,不能把它当作无损的目录创建或配置刷新请求。首次创建 MySQL 物理相机配置成功后,PhysicalCameraCreationBatch 通过 ColorVisionServiceHost 在后台正常重启本机 RegistrationCenterService,让注册中心重新加载包含新增相机的文件资源列表,保留磁盘文件;不弹重启提示或确认框。该路径适用于注册中心与客户端同机部署,需要本机服务和 Service Host 已安装且可用;失败只记录日志,不宣称配置已经在后端生效,也不回退到清目录的消息。普通“重启设备”MQTT 消息不会重建这份文件资源列表,不能代替注册中心重启。

首次创建按保存前是否已有非空物理相机配置判断,保存失败、离线配置、重复导入已有相机许可证都不触发该重启。一次多文件 / ZIP 许可证导入在处理完成后合并为一次后台重启;批次并发时串行执行,避免 Windows 服务启停重叠。原有相机的日常使用不因本流程重启,许可证变更原有的设备服务重启确认仍由许可证入口单独管理。

首次保存物理相机配置后,若已配置物理相机仅一台,维护其许可证记录,并由 PhysicalCameraInitialBinding 为同一存储中的现有设备补齐空绑定:普通设备的空 SN 填入物理相机 Code,相机与校正设备还补齐空 CameraCode,对应 ID 统一取物理配置,替换残留的旧逻辑 ID。初始化数据库中已存在的默认相机、默认算法、默认校正同样覆盖;绑定不依赖许可证存在或有效,运行授权仍由驱动校验。已有其他 SN / CameraCode、光谱仪及另一存储的设备保持不变,仅对发生补齐或 ID 修复的设备调用原有保存和重载链,再执行批次的注册中心重启。已有物理配置的重复导入以及第二台物理相机创建不触发首次绑定。普通设备的单独新建入口仍按设备资源配置主题选择到期时间最晚的可用许可证。

许可证字段与界面状态 ​

LicenseModel 映射 t_scgd_camera_license:res_dev_cam_pid / res_dev_cali_pid 是可空的相机/校准资源 ID,value 保存编码许可证,expired 保存过期时间元数据。查询许可证时优先使用必要的 ID、型号与时间字段,不输出编码或解码后的许可证载荷。

PhyCamera.LicenseState 使用解码对象的 ColorVisionLicense.ExpiryDateTime 与本机时间比较,不直接用数据库 expired 列判断。按 expired < CURRENT_TIMESTAMP 查到的是数据库会话时间下的过期元数据记录,NULL 值也不会命中;不能据此断言界面许可状态、永久许可或硬件授权。排查差异时区分存储列、已载入对象、解码结果与时间基准,不默认通过重新导入来验证。

许可证导入的两个入口 ​

入口匹配、持久化与副作用
PhyCameraManager.Import支持 .lic / .zip;ZIP 中只处理 .lic 项,以文件名(不含扩展名)作为 MacAddress,解析许可证并保存许可证/物理资源
PhyCamera.SetLicense更新当前相机,文件名必须匹配该物理资源 Code;只有保存返回 1 且许可证内容确实变化时才提示用户是否重启当前节点的后端服务,使相机、校准、算法、光谱与滤光轮等模块统一重新加载许可证;保存未替换或新旧内容相同时不重启

管理器批量导入会按许可证文件名与物理相机 Code(忽略大小写)匹配。已存在且已有配置的物理相机只更新许可证及界面状态,不覆盖物理配置,也不请求创建目录;没有对应资源或只有空配置候选时,才写入默认 new ConfigPhyCamera() 并进入创建流程。

许可证解析/数据库保存与硬件运行授权是不同判据;不要因“导入成功”就宣称采集可用。当前相机入口会忽略新旧许可证首尾空白差异;内容变化且保存成功后由用户确认是否发送整体重启命令。该命令不等待各后端完成,RC 未连接或令牌不可用时也没有成功回执,因此仍须通过服务日志或实际算法调用确认新许可证已经生效。执行导入、更新、创建或恢复前,确认目标相机代码、可覆盖配置/许可证的范围、关联服务和写入授权;不要把重导许可证作为默认排障步骤。

校准资源上传 ​

在详情区点击“上传校正文件”进入 PhyCamera.UploadCalibration,目标是 Config.FileServerCfg.FileBasePath / Code / cfg。UploadDataAsync 使用每台相机独立的 CalibrationUploadRunner:同一相机拒绝并发,任务结束或异常后释放门禁,不会全局串行化其它相机。

上传会创建目标目录,由 7-Zip x64 后端在后台解包到独立临时工作区、读取 Calibration.cfg,覆盖目标同名文件并写入/更新数据库资源、分组。文件复制与数据库更新分步完成,失败不保证全部回滚;名称虽为“上传”,此入口的资源文件写入是本地文件系统操作。模板如何消费这些资源见校准服务。

不要把 UploadData() 返回、UploadDataAsync 结束或 UploadClosed 事件等同于全部成功:旧 UploadData 是 fire-and-forget,异步实现内部会捕获错误,失败路径也会发关闭事件。应检查 UploadList 的逐项状态、Msg、错误日志与目标资源;分组处理也可能单独报错。源码中的“上传完成”提示不是完整事务验收。

管理校正组和修正四色文件 ​

在“校正文件管理”可增删校正组,编辑组参数并选择、创建或上传校正文件。组修改在关闭窗口时保存。本机文件可定位,支持的类型可编辑。均匀场、DSNU、缺陷点和线性度使用二进制编辑器。缺失资源显示“本机缺失”。校正项顺序和文件类型见校正配置。

顶部“导出”在选定 ZIP 路径后显示百分比和当前文件,标准 Deflate ZIP 由 7-Zip x64 后端在后台多线程打包,期间不能重复导出或关闭窗口。导出先写入目标目录中的临时包,全部完成后才替换目标文件;失败时显示原因、清理临时包并保留原目标文件,避免留下不完整 ZIP。包内仍包含可用的校正资源、分组配置、Calibration.cfg、Camera.cfg 和可用许可证;本机缺失的资源不会写入文件内容。

从相机属性的“校准与校正”进入“用户校正”会带入当前相机。校正文件管理顶部、四色资源行和“应用与工具”也提供入口。采集、计算和替换文件步骤见用户校正。

创建与加载还原点 ​

点击“创建还原点”,在另存为窗口选择 {Code}.cvcal 的保存位置。CreateRestore() 与“导出校正”共用包清单和 7-Zip x64。.cvcal 是标准 Deflate ZIP,结构与 .zip 导出相同。创建时显示文件和进度,临时包完成后才替换目标,失败会保留已有文件。

“加载还原点”调用 LoadResotre()(源码保留此拼写),显示打开窗口并直接选择 .cvcal。加载按 ZIP 内容校验安全路径,再由同一个 7-Zip x64 后端在后台解包;随后恢复 Camera.cfg、与当前相机代码匹配的可选许可证、校正资源及包内分组。旧还原点中的 CameraConfig.cfg 继续兼容。恢复会覆盖同名资源文件、配置、许可证和同名分组关联,但不是跨文件系统与数据库的原子事务;失败时应根据进度项、消息、日志和实际资源分别确认。保存物理配置仍会触发绑定服务的同步副作用。

验证范围 ​

在获授权的现场环境核对相机发现、许可证导入、自动绑定、Windows 服务重启、资源文件与数据库一致性及真机校正恢复。

基于 MIT License 发布。