简介这份《海康机器人VM算法开发平台-用户手册-4.3.1》面向机器视觉工程师、算法应用开发者和设备集成人员围绕定位、尺寸测量、缺陷检测与信息识别等典型视觉任务系统说明VM平台的使用方法。压缩包内为1个PDF文件大小约29.73MB便于在电脑端查阅与检索。手册内容覆盖产品简介、版本更新、运行环境、相机能力集、软件许可本机加密狗、授权码、远程加密狗、界面介绍及方案搭建相关说明可帮助读者理解平台140模块、近千个图像处理算子、拖拽式图形化交互和GigE Vision/USB3 Vision相机接入等能力。已有827人学习适合需要快速熟悉软件架构、完成授权部署、掌握运行界面定制与视觉方案搭建的初中级用户查阅。1. 一份 4.3.1 版用户手册能解决什么从产线换型看图像处理算法平台的落地价值图像处理算法平台真正的价值不在算子数量而在产线换型时能不能把相机、光源、定位、通信这几件事快速拼成一条可复现的链路。这份 4.3.1 版用户手册对应的机器视觉算法平台走的是图形化拖拽路线左侧选模块中间连流程右侧看结果定位、测量、缺陷检测、信息识别都能在同一个方案里配出来。它适合设备集成商里负责视觉方案的工程师也适合刚接手视觉项目、需要一本能按目录查参数的工具书的人。手册从运行环境、许可、界面、方案组成一路写到 140 模块和全局脚本读法不该是从第一页翻到最后一页而是先搭一个最小方案再按问题回查章节。2. 平台架构与目录结构界面分区、方案流程和 140 模块怎么组织这套平台的架构不复杂但第一次打开界面容易把“方案”“流程”“模块”混成一件事。手册第 5 章把界面拆成启动引导、主界面、运行界面、编辑运行界面四块第 8 章才讲方案组成第 9 章讲全局功能第 10 章讲外部设备第 11 章铺开模块库。这个顺序不是随便排的先让你看见界面再告诉你方案怎么组织最后才让你去翻具体算子。真正落地时建议反过来读——先明确一个工位要几条流程再回界面里找对应配置。2.1 主界面不是装饰菜单栏、图像区、结果区与运行态的分工主界面里最容易被忽略的是“当前处于编辑态还是运行态”。菜单栏负责方案新建、保存、导出、权限和软件设置快捷工具条放的是高频动作比如运行一次、连续运行、停止、保存图像图像显示区域负责 ROI 框选、结果叠加、缩放和平移结果显示区域则把每个模块的运行状态、耗时、输出值列出来。很多现场问题不是算法不对而是人在编辑态改了参数却没切到运行态看真实触发下的结果。图像显示区域要重点关注坐标。模板匹配、圆查找、直线查找输出的都是图像坐标系下的值如果你后面要发给 PLC必须经过标定或位置修正把图像坐标换成物理坐标。结果显示区域里看三样东西就够了模块是否绿色通过、单模块耗时、关键输出值。耗时突然从几毫秒涨到几十毫秒通常是搜索区域放大、金字塔层数变少或者图像分辨率变了不是玄学。运行界面和编辑运行界面是两套东西。运行界面给操作员看可以自定义控件、背景图、公司 Logo编辑运行界面给工程师调布局和导出程序。导出程序时要把运行策略、权限、控件绑定一起带走否则现场机打开后按钮是灰的。手册第 5.4 节把导出程序和控件功能放在一起讲就是提醒你界面不是画完就行控件要绑到流程和模块输出上才有意义。2.2 方案、流程、模块三层结构为什么一个方案能挂多条流程方案是最大的容器对应一个工位或一台设备的视觉工程流程是一次触发到出结果的执行单元模块是最小算子节点。一个方案可以挂多条流程常见于多相机、多工位或者“定位测量通信”分开跑的场景。多流程配置的关键不是数量而是触发源和全局资源的隔离哪条流程用全局相机哪条流程用本地图像哪条流程的全局变量会被另一条流程读取这些要在方案设置里先定好。层级作用配置位置常见改动方案一个工位或一台设备的视觉工程方案设置运行策略、权限、路径流程一次触发到出结果的执行单元流程管理触发源、多流程并行模块最小算子节点模块参数ROI、阈值、输出绑定全局资源跨流程共享的相机、变量、脚本全局功能相机绑定、变量命名、脚本入口模块通用配置里有基本参数、运行参数、结果显示三块。基本参数决定这个模块“看哪里”比如 ROI、坐标系、输入图像源运行参数决定“怎么跑”比如超时、失败重试、是否跳过结果显示决定“输出什么”比如把 X/Y/角度写到哪个全局变量。很多人只改基本参数结果通信模块拿不到值回头怪通信配置其实是结果显示没勾选。多流程配置还要注意运行策略。串行跑适合流程之间有依赖的场景比如先定位再测量并行跑适合多相机独立采集但全局变量写入要加锁或排队否则两条流程同时写同一个变量现场表现就是“偶发坐标跳变”。手册第 6.4 节把运行策略单独拎出来值得在方案设计阶段就定不要等到现场再改。2.3 手册章节顺序就是落地顺序准备工作、外部设备、全局功能、模块库怎么排手册第 4 章准备工作讲运行环境、相机能力集和软件许可第 5 章界面介绍第 6 章设置第 7 章工具第 8 章方案组成第 9 章方案全局功能第 10 章外部设备管理第 11 章模块介绍。这个顺序基本就是落地顺序先把环境和许可弄通再认界面再配方案再接相机和通信最后才调模块参数。新手最容易犯的错是直接翻第 11 章找模板匹配结果许可没激活、相机没加、流程没建模块拖进去也是灰的。第 7 章的工具介绍容易被跳过但里面的几个工具在现场很实用一键标定引导分静态、动态、映射标定标定板生成工具用来生成对应规格的标定板自定义模块生成工具用来封装自己的算子运行异常采集机器人用来抓异常现场版本切换工具用来回滚读取加密狗序列号工具用来排查许可。这些工具不是每天用但翻车时能省很多时间。第 9 章方案全局功能是整套平台的“总线”全局相机让多条流程共享相机全局变量让模块之间传值全局触发让外部信号统一入口全局脚本做流程控制和参数设置数据队列做异步缓冲。第 10 章外部设备管理把相机、控制器、通信分开管通信管理里又分设备管理、接收事件、发送事件、心跳管理、响应配置。读手册时可以把第 9 章和第 10 章连起来看全局变量是内部总线通信事件是外部总线两边靠脚本或模块输出绑定接上。3. 跑通第一个视觉方案许可、相机接入、图像源与模板匹配的完整步骤第一次跑通不要贪多就做一个单相机定位方案相机采图模板匹配找目标输出 X/Y/角度到结果显示区再导出一个运行程序。这个最小闭环能把你需要的大部分配置都摸一遍许可、相机、流程、模块参数、运行策略、导出。手册第 4 章到第 5 章的内容足够支撑这个闭环不需要一上来就研究多流程和通信。3.1 运行环境与许可准备三种许可方式怎么选许可放在第一步因为它决定后面模块能不能拖、方案能不能保存。手册第 4.3 节给了三种方式本机加密狗、授权码、远程加密狗。本机加密狗适合单机固定工位插上后在本机识别授权码适合没有物理狗或者狗不方便插的场景但要注意绑定关系和系统时间远程加密狗适合多台机器共用许可前提是网络稳定、远程服务可达。三种方式没有绝对优劣看部署形态。许可方式适用场景注意点本机加密狗单机固定工位换 USB 口后重新识别别用延长线授权码无物理狗、授权绑定系统时间不能乱改换机前先确认迁移规则远程加密狗多机共用、集中管理网络断开后模块可能变灰要有重连预案装完软件先别急着建方案打开许可页面确认状态。手册第 7.6 节的读取加密狗序列号工具可以用来核对狗有没有被识别。如果模块全是灰的先看许可不要怀疑安装包。授权码方式还要注意系统时间现场机如果被改成未来时间许可校验可能不过表现就是昨天还能跑今天打开全灰。提示许可相关操作尽量在断网前做完现场调试时把加密狗序列号、授权码、远程服务地址记在方案交付文档里换机时不用猜。3.2 相机接入GigE Vision、USB3 Vision、采集卡三条路径相机接入走第 10.1 节。平台兼容 GigE Vision 和 USB3 Vision 协议也支持通过 Dalsa 图像采集卡、迈创采集卡连接相机。GigE 相机重点看网卡、IP 段、巨帧USB3 相机重点看线缆和供电采集卡相机重点看驱动和采集卡配置。添加相机后要在全局相机里绑定否则图像源模块选不到。GigE 相机最常见的翻车是 IP 不在同一网段或者网卡开了节能模式导致偶发丢帧。USB3 相机最常见的是线太长、供电不足表现是预览几秒后黑屏。采集卡路径多一步驱动配置手册第 10.1.3 和 10.1.4 节分别讲了 Dalsa 和迈创采集卡的配置装完驱动后在相机管理里能看到设备才算通。相机能预览不等于方案能采图预览走的是相机客户端方案走的是全局相机绑定两件事要分开查。3.3 图像源与模板匹配一个定位方案的参数怎么配建好方案后先加流程再在流程里加图像源模块。图像源模块选择全局相机设置触发模式、超时时间和缓存策略。如果是硬触发触发源要跟全局触发配置对上如果是软触发运行一次看能不能出图。图像源通了再加模板匹配顺序不要反。模板匹配的参数重点是模板 ROI、搜索区域、角度范围、分数阈值、金字塔层数和位置修正。模板 ROI 要包含稳定特征不要把会变化的背景框进去搜索区域不要一上来就全图先限制在目标可能出现的范围角度范围按机械重复精度给不要直接给 ±180分数阈值太低会匹配到相似纹理太高现场稍有光照变化就失败。金字塔层数影响速度和稳定性层数多速度快但小目标容易丢层数少稳定但耗时上来。参数作用调整建议模板 ROI定义匹配特征包含稳定边缘避开反光和运动部件搜索区域限制搜索范围先小后大按机械误差给余量角度范围允许旋转按实际重复精度给别默认全角度分数阈值判定匹配成功先看实际分数分布再定阈值金字塔层数速度与稳定性权衡小目标少降采样大目标可适当增加模板匹配出结果后把 X/Y/角度绑定到结果显示或全局变量。需要物理坐标就接位置修正或标定不要直接拿像素值发给 PLC。手册第 11.2.1 节把模板匹配单独列了一节参数页比较多第一次配只盯住 ROI、搜索区域、角度、分数四项其余先用默认值跑通再调。3.4 运行界面与导出程序从调试态到现场态调试态跑通后切到编辑运行界面做操作员界面。把运行按钮、结果显示、图像显示、报警状态摆到一屏里控件绑定到对应流程和模块输出。背景图和 Logo 是锦上添花先保证按钮能用、结果能看。导出程序时把运行策略、权限、控件配置一起导出手册第 5.4.1 节讲导出程序第 5.4.2 节讲控件功能两节要对照看。导出后在现场机打开先检查三件事许可是否有效、相机是否连上、方案路径是否一致。现场机如果没装运行环境程序会缺依赖如果路径写死到调试机的盘符图像缓存和日志会写不进去如果权限不够通信端口可能绑不上。导出不是终点导出后能在现场机连续跑半小时不出错才算这个最小方案闭环。4. 核心模块拆解采集、定位、测量、通信四类链路的参数怎么串手册第 11 章模块介绍是整本手册最厚的部分采集、定位、测量、检测、识别都有独立小节。真正做方案时不需要背模块而是记住几条链路的先后关系采集链路决定图像质量定位链路决定坐标系测量链路决定精度通信链路决定结果能不能送出去。链路顺序错了单个模块参数调得再漂亮也没用。4.1 采集与光源图像源、多图采集、缓存图像、光源模块的先后关系采集链路一般按“光源→图像源→缓存图像/多图采集→输出图像”排。光源模块控制打光时序图像源负责取图缓存图像用来暂存某一帧给后续模块复用多图采集用于一次触发拿多张图做融合或对比输出图像把处理后的图传给显示或保存。顺序反了会出现“光源还没稳定就采图”或者“缓存拿到上一帧”的问题。多图采集适合动态场景或者多曝光融合但要注意每张图的超时和同步。缓存图像适合需要反复用同一帧做多个分析的场景比如先定位再测量测量模块直接读缓存图不用重新采。光源模块如果支持亮度调节和触发输出尽量把打光与相机曝光对齐现场表现就是图像灰度稳定模板匹配分数不会忽高忽低。采集链路还要看相机能力集。手册第 4.2 节讲相机能力集不同相机支持的触发模式、曝光范围、增益不一样。GigE 相机长距离传输要关注丢包USB3 相机关注带宽采集卡相机关注驱动版本。采集不稳后面所有算法都是黑匣子。4.2 定位类模块模板匹配、图形定位、位置修正与 BLOB 分析的配合定位链路常见组合是“模板匹配→位置修正→测量模块”。模板匹配给出目标的大致位置和角度位置修正把后续模块的 ROI 跟着目标移动测量模块只在修正后的 ROI 里找边。没有位置修正产品稍微偏一点测量 ROI 就框到背景上结果自然飘。图形定位适合有明确几何特征的场景BLOB 分析适合连通域计数、面积、中心点BLOB 标签分析适合给不同连通域分类。模板匹配和图形定位不是二选一有时先用模板匹配粗定位再用图形定位精定位。位置修正的输入要绑到模板匹配的输出输出坐标系要跟测量模块一致。BLOB 分析对光照和阈值敏感阈值给太宽会把反光也算成目标给太窄会丢小目标。定位链路的核心不是单个模块分数多高而是后续测量模块的 ROI 是否稳定跟着目标走。4.3 测量与检测类模块圆查找、直线查找、边缘交点怎么串测量链路常见组合是“圆查找/直线查找→边缘交点→距离/角度计算”。圆查找适合孔位、圆弧、圆角直线查找适合边线、台阶、缝隙多直线查找和直线查找组合适合多条边同时找边缘交点把两条边或线与圆的交点算出来再交给尺寸计算。阵列圆查找适合规则排布的孔阵。卡尺方向和搜索范围是测量模块的关键参数。卡尺方向要垂直于边缘搜索范围要覆盖边缘可能出现的区间边缘阈值要看灰度跳变。圆查找的拟合方法、剔除离群点、最小内点数会影响圆度直线查找的拟合方式会影响直线度。测量精度不只取决于算法还取决于标定和图像分辨率。像素当量没标定测出来的值只能做相对比较。4.4 通信与脚本全局变量、全局脚本、通信管理如何把结果送出去结果送出去有两条路模块输出绑定到全局变量再由通信模块发送或者全局脚本里主动读模块结果、写变量、触发发送事件。手册第 9.4 节讲全局脚本包含 VS 调试、脚本接口、SDK 调用、程序集添加、第三方库调用第 10.3 节讲通信管理包含设备管理、接收事件、发送事件、心跳管理、响应配置。两条路不冲突简单绑定用第一条带逻辑判断的用第二条。下面这段 C# 脚本是示意函数名要按手册第 9.4.2 节的接口表替换模块名要跟方案树里的实际命名一致// 流程结束后读取匹配结果写入全局变量并触发发送事件 public void OnFlowFinished(int flowId) { // 1. 按方案里的模块名取结果名字大小写要一致 var match GetModuleResult(Match_1); if (match null || !match.IsSuccess) { SetGlobalVariable(ResultOK, false); return; } // 2. 写全局变量供通信模块或其他流程读取 SetGlobalVariable(X, match.CenterX); SetGlobalVariable(Y, match.CenterY); SetGlobalVariable(Angle, match.Angle); SetGlobalVariable(ResultOK, true); // 3. 触发发送事件事件名要和通信管理里配置的一致 TriggerSendEvent(PLC_RESULT); }逻辑说明OnFlowFinished是流程结束回调的示意入口实际入口名和参数以手册接口表为准GetModuleResult取模块输出失败时直接写失败标志避免把上一帧的旧值发出去SetGlobalVariable写全局变量变量名要和通信模块的绑定一致TriggerSendEvent触发发送事件事件名、方向、地址在通信管理里配置。参数说明flowId用来区分多流程单流程可以忽略Match_1是模块名不是模块类型ResultOK是布尔变量PLC 侧要按位或按字解析。通信配置常见做法是用一份设备配置描述连接参数和事件映射。下面这段 JSON 是示意IP 和端口按现场改{ deviceName: PLC_1, protocol: TCP, remoteIp: 192.168.1.10, remotePort: 9000, heartbeatMs: 3000, reconnectMs: 5000, events: [ { name: trigger, direction: receive, address: D100 }, { name: result, direction: send, address: D200 } ] }参数说明deviceName是通信管理里的设备名脚本触发事件时要用同一个名字remoteIp和remotePort是示意现场按 PLC 实际地址改heartbeatMs是心跳间隔太小会增加网络负担太大断线发现慢reconnectMs是重连间隔现场拔插网线后要靠它恢复events里direction决定是接收事件还是发送事件address要跟 PLC 侧地址表对上。通信管理里还有响应配置和心跳管理别只配发送不配心跳否则 PLC 侧可能认为连接假死。注意高频流程里不要在脚本回调里做文件读写、弹窗或长时间等待现场表现是流程周期被拖长严重时直接超时。5. 避坑与排查许可、相机、匹配、脚本、导出五个高频翻车点这套平台的模块化程度高好处是搭方案快坏处是出了问题容易在错误的地方找原因。下面五条是现场最常见的翻车点每条按“现象→原因→解决”写照着排查比盲改参数快。5.1 许可到期或换机后模块全灰现象软件能打开方案也能加载但模块库全是灰的拖不进去已有模块运行报许可错误。原因通常有三种本机加密狗换了 USB 口没重新识别授权码绑定关系变了或者系统时间被改远程加密狗网络断了。解决先用读取加密狗序列号工具确认狗是否被识别再看许可页面状态本机狗换回原 USB 口或重新插拔授权码方式核对系统时间和绑定信息远程狗检查网络、服务地址和端口。换机前把许可方式记进交付文档别到现场才试。5.2 相机能预览但方案采不到图现象相机客户端能预览平台里图像源模块运行后一直超时或黑图。原因多半是全局相机没绑定、图像源选错相机、触发模式不一致、缓存图像没清。解决先到全局相机里确认相机在线并绑定再检查图像源模块选的相机名是不是全局相机里的名字硬触发看全局触发配置和外部信号软触发先手动运行一次缓存图像模块如果开了保持先清缓存再采。GigE 相机还要看 IP 段和巨帧USB3 相机看线缆和供电。5.3 模板匹配分数高却定位偏现象模板匹配分数 0.9 以上但输出的 X/Y 跟实际位置差一截或者角度偶尔跳。原因可能是模板原点定义偏了、搜索区域太大匹配到相似纹理、没有接位置修正、图像坐标没标定。解决把模板 ROI 缩小到稳定特征搜索区域先限制在目标附近检查模板原点是不是设在目标中心后续测量模块接位置修正需要物理坐标就先做标定。分数高只说明相似度高不说明坐标准。5.4 全局脚本改完不生效现象脚本里改了变量或逻辑运行结果还是旧值。原因可能是脚本没编译、没保存、流程没重新加载或者异常被吞了。解决用 VS 调试附加到进程看脚本入口有没有进在关键分支加日志或写全局变量确认程序集版本和脚本引用一致改完脚本后重新加载流程或重启运行。脚本里不要空 catch异常吞掉后现场只能看到“没反应”。5.5 导出程序到现场跑不起来现象调试机正常导出到现场机后按钮灰、图像不出、通信连不上。原因可能是现场机缺运行环境、许可不对、路径写死、权限不够、分辨率或控件布局不匹配。解决现场机先装对应运行环境确认许可方式把方案、图像缓存、日志路径改成相对路径或现场存在的路径通信端口用管理员权限试一次运行界面控件按现场分辨率重新排。导出前用版本切换工具留一个可回滚版本别把自己后路堵死。6. 二次开发与改造全局脚本、SDK 和自定义模块的扩展路径二次开发先分清边界流程内的轻量逻辑放全局脚本外部系统集成走 SDK算法级扩展用自定义模块生成工具封装第三方库。全局脚本适合做结果判断、变量组装、流程跳转、简单通信触发SDK 适合上位机、MES、运动控制卡这类外部程序加载方案、触发执行、取结果自定义模块适合把已有算法包封装成平台里的模块节点。三条路不要混着用脚本里做重算法会拖慢流程SDK 里重复实现平台已有模块是浪费。6.1 从全局脚本到 SDK两条扩展路径的取舍全局脚本的优点是离流程近能直接读模块结果、写全局变量、控制流程缺点是调试环境依赖平台复杂逻辑不好做单元测试。SDK 的优点是外部程序可控能集成到既有软件里缺点是要自己管理会话、超时、异常和资源释放。常见做法是平台内做方案和调试外部程序只负责加载方案、传参数、触发、取结果不在外部重写算法。# 示意外部程序通过 SDK 加载方案并触发一次执行 import vision_sdk as vs # 实际库名按手册 SDK 章节替换 session vs.Session() try: session.load_solution(rD:\solutions\locate.sol) session.set_string(Global.CameraName, Cam_1) session.trigger_once(timeout_ms3000) result session.get_module_result(Match_1) print(result.center_x, result.center_y, result.angle) finally: session.close()逻辑说明先加载方案再设全局变量再触发一次最后取模块结果try/finally保证异常时也能关闭会话。参数说明load_solution的路径不要写中文和空格Global.CameraName是示意变量名按方案里的全局变量改timeout_ms要大于单次流程耗时get_module_result的模块名要和方案树一致。库名和方法名以手册第 9.4.3 节 SDK 调用说明为准不要照抄示例里的名字。6.2 自定义模块与第三方库封装一个自己的算子自定义模块生成工具适合把成熟算法包封装成平台节点。封装时注意三点输入输出类型要跟平台模块通用配置对齐依赖库的位数要跟平台一致异常要转成模块失败状态不要把进程带崩。第三方库调用还要注意线程安全平台多流程并行时同一个算法实例不要被两条流程同时调用。手册第 9.4.5 节讲第三方库调用方法第 7.3 节讲自定义模块生成工具两节对照看能少走弯路。6.3 版本切换与异常采集现场升级前的验证清单现场升级前用版本切换工具留回滚版本用运行异常采集机器人抓异常现场。验证清单可以按下面这张表走别只测“我这边能跑”。验证项检查内容通过标准许可本机狗/授权码/远程狗模块可拖拽方案可保存相机全局相机绑定、触发、超时连续采图 30 分钟不丢帧模块定位、测量、检测链路结果稳定耗时在节拍内通信发送、接收、心跳、重连拔插网线后能自动恢复脚本入口、异常、全局变量改动能生效异常有日志导出运行界面、路径、权限现场机连续运行半小时无报错从那以后我每次把方案拷到现场机之前都强制走一遍许可、相机、通信、导出四步检查不再相信“我这台机器能跑”。希望帮到你。本文还有配套的精品资源点击获取
