企业官网建设流程全解析

简介：这份《海康工业相机软件MVS用户手册》面向工业视觉开发、设备调试与机器视觉应用人员，用于快速掌握海康机器人工业相机客户端MVS的安装配置、相机接入与图像采集流程。压缩包内仅含1个PDF文件，大小约5.11MB，篇幅完整、便于随查随用。手册围绕软件产品说明、运行环境、主界面与菜单展开，重点覆盖网口相机、U3V相机及Camera Link相机的环境配置，并讲解文件、视图、设置、工具等菜单，以及通用设置、录像与抓图、网络、缓存、重发包和快捷键等参数。读者可据此完成相机连接、参数调整、图像采集与常见问题排查，也能对照目录理解设备管理、功能模块和操作规范。该手册已有5886人学习，适合作为工业相机选型验证、现场部署和日常运维的参考文档。

1. 装之前先分清：MVS 3.3.0 是 Windows 版，别在 Linux 机器上找安装包

有人拿着这份手册去 Linux 工控机上敲包管理命令，翻遍安装目录也没找到可执行文件——手册里那句“支持多平台运行”，说的是 Windows XP 32 位和 Windows 7/10 的 32/64 位，不是跨操作系统。MVS 3.3.0 的适用产品写得很直白：Windows 版本工业相机客户端。这套环境在视觉现场太常见了，一台工控机、两三台 GigE 相机、一根网线，装不好就是设备列表空着、相机显示不可达、预览一片黑。这篇按我实际装的顺序走：先对版本，再装包，然后按接口配环境，中间穿插踩过的坑，最后落到“怎么验证这套东西是真的通了”，而不是装完看图标出现就算完事。

2. 安装与首次启动：装包前核对的三张表和两个开关

装 MVS 这件事本身不复杂，复杂的是装之前的机器状态。我这里遇到过的翻车，八成不是安装包的问题——是工控机太老、网卡太杂、系统盘权限被策略锁住。所以动手之前先把机器摸一遍，比装完再回头找原因省事得多。

2.1 系统、CPU、网卡：先照着表对一遍

手册给了推荐配置和最低配置两档，实际现场我基本按推荐配置卡，最低配置只在老设备凑合时用。差别最大的是内存和网卡：1 GB 内存跑单相机预览勉强，开四画面就开始卡；网卡则是直接影响丢包率的东西。

网卡这一行值得单独说。GigE 相机走的是千兆链路，板载 Realtek 网卡在开启巨帧后经常出现协商不上、跑几分钟就掉线的情况，换成 Intel I210 或 I350 独立网卡之后同样的相机和线材就稳了。这不是玄学，是网卡驱动对巨帧和中断合并的处理差别。

2.2 安装包执行：那个“内置调试功能”选项别乱勾

安装包双击之后基本一路下一步，唯一需要停一下的是 MVS 3.1.0 起加的“是否开启内置调试功能”选项。这个开关打开后会保留更多运行时信息，排错时有用，但日常生产机上我一般不勾——日志量上来之后，磁盘小的工控机容易被写满。

安装过程中还有一个默认行为：安装程序会尝试把机器上所有网卡的巨型包打开。这个对 GigE 相机是好事，但如果这台机器同时跑着别的网络业务，开巨帧之后跟交换机、跟其他设备的通信可能出问题。所以我的习惯是安装时不依赖这个默认动作，装完之后用网卡配置工具单独确认，只对连相机的那张网卡开巨帧。

从 MVS 3.0.0 开始，安装包带升级、修改、修复、版本回退能力。这意味着装坏了不用卸载重来：控制面板里找到客户端，选“修复”走一遍，注册表和运行库会被重新写一遍；如果是升级之后行为不对，选“版本回退”退回上一版，比手动找旧安装包靠谱。

# 装机前先摸清网卡型号和链路速率，确认哪张卡接相机 Get-NetAdapter | Where-Object Status -eq 'Up' | Format-Table Name, InterfaceDescription, LinkSpeed, MacAddress -AutoSize

这段命令列出所有已启用的网卡、驱动描述和协商速率。接相机的那张卡应该是 1 Gbps，如果显示 100 Mbps，先换网线（超五类以上、屏蔽），再看交换机和网口协商设置，别急着怀疑相机。多网卡的工控机上，还要记下接相机那张卡的名称，后面所有配置命令都要指名道姓地打在它上面。

2.3 首次启动：主界面六个区域各管什么

安装完成后桌面会出现 MVS 快捷方式，启动后主界面分成六块，第一次用的时候建议挨个点一遍，后面排错时才知道去哪儿看：

• 菜单栏：文件、视图、设置、工具、帮助五项，客户端级和相机级设置都从这里进。
• 控制工具条：画面布局切换、相机状态、水印信息、日志信息入口。
• 设备列表：按 GigE、USB、Camera Link、GenTL 四类分栏显示枚举到的设备，相机在不在，先看这里。
• 接口/设备信息：选中某个设备或接口后，这里显示它的具体参数，比如 IP、掩码、MAC、型号。
• 图像预览窗口：实时画面和本地文件预览都在这，十字辅助线、网格、直方图也挂在这块。
• 属性设置区：只有连上相机之后才出现，相机参数、文件存取、属性导入导出都在右侧这块。

第一次启动最容易误判的是属性设置区——没连相机时它是隐藏的，不少人以为装坏了或者权限不够。实际上这是设计如此：没设备就没有属性可配。判断安装是否成功，看设备列表能不能枚举出接口就够了。

2.4 通用设置里先动的两个参数

“设置”菜单下的“通用设置”里，MVS 3.3.0 新增了编码方式设置和 cti 默认路径设置，这两个东西平时不动，但一碰上中文路径和 GenTL 就会用到。

编码方式影响的是日志、导出文件的字符处理。工控机上有中文用户名、中文目录时，如果导出的属性文件打开是乱码，先来这里换成 UTF-8 再导一次。

cti 默认路径是给 GenTL 用的。GenTL 管理那一栏能加载厂商提供的 cti 文件，路径不对就枚举不到设备。我一般把 cti 放在纯英文、无空格的目录下，比如D:\MVS\cti\，然后在通用设置里把默认路径指过去，避免每次手动找。

# 确认安装目录和用户数据目录的写权限，避免属性导出失败 $paths = @("C:\Program Files", "$env:ProgramData") foreach ($p in $paths) { Get-Acl $p | Select-Object Path, Owner }

MVS 默认装在 Program Files 下，如果工控机开了 UAC 且当前账号不是管理员，导出属性文件、升级固件这类写操作会被拦下来，表现是点了没反应或者提示失败但不给原因。上面这段只是确认目录归属，真正要动的时候用管理员身份跑客户端更省事。

3. 三类接口的环境配置：网口、U3V、Camera Link 各管各的

MVS 支持 GigE、USB3.0、10GigE、CoaXPress 和 Camera Link 接口，但前四类在客户端的操作路径基本一致，Camera Link 是另一条线——它只支持参数配置和固件升级，不预览。三类接口的环境前置条件完全不同，混着配是最容易翻车的地方。

3.1 网口相机：巨帧 9014 和同网段静态 IP 缺一不可

网口相机要能被搜到并稳定出图，前提只有两条：PC 与相机在同一局域网，且 PC 网口已开启巨帧。手册里写得很干脆，实际执行时这两条经常只做到一条。

巨帧的开启有两种路径。一是安装时默认打开了所有网卡的巨型包，二是用网卡配置工具 NIC_Configurator 单独确认。工具里能看到每张网卡的巨型包状态，已启用就跳过，未启用就打开。如果工具里设置失败，去设备管理器里手动改：

# 查看接相机那张网卡的巨帧相关参数（名称按实际网卡改） Get-NetAdapterAdvancedProperty -Name "以太网 2" | Where-Object { $_.DisplayName -match 'Jumbo|巨帧|巨型' } | Format-Table DisplayName, DisplayValue, ValidDisplayValues -AutoSize # 设为 9014 字节（等价 9 KB），只对连相机的那张卡执行 Set-NetAdapterAdvancedProperty -Name "以太网 2" ` -DisplayName "Jumbo Packet" -DisplayValue "9014 Bytes"

巨帧值统一用 9014 字节或 9 KB，这两个是同一档，别写成 9000 或 4088 之类的非标准值，某些网卡驱动会接受但实际协商不上。如果上面第二条命令报“找不到 DisplayName”，说明这张网卡的驱动里根本没有巨帧参数——这种情况换驱动或者换网卡，别在参数上纠缠，Realtek 消费级网卡很多就是不支持。

IP 这一段是丢包和不可达的高发区。PC 网口建议设静态 IP，相机也设静态 IP，两者在同一网段且掩码一致。Windows 默认的自动获取（APIPA 169.254.x.x）虽然有时也能搜到相机，但链路一抖动地址就变，现场调试时经常出现“昨天好好的今天搜不到”的情况。

# 给接相机的网卡配静态地址，示例网段 192.168.1.x New-NetIPAddress -InterfaceAlias "以太网 2" -IPAddress 192.168.1.100 ` -PrefixLength 24 -DefaultGateway 192.168.1.1 -ErrorAction SilentlyContinue # 如果这张卡不承担上网，去掉网关更干净，避免路由串到默认线路 Remove-NetRoute -InterfaceAlias "以太网 2" -DestinationPrefix "0.0.0.0/0" -Confirm:$false

第一段把网卡钉在 192.168.1.100/24，相机的出厂地址一般也在这个网段附近，改完就能枚举到。第二段是很多人忽略的一步：如果这台工控机还有一张卡连着办公网，两套默认网关会打架，相机流量可能被路由到办公网卡上，表现为能搜到但连不上、或者连着连着断。把相机网卡的默认路由删掉，只保留同网段直连，问题就消失了。

3.2 U3V 相机：设备管理器里那个 USB3 Vision Camera

U3V 相机插上之后，Windows 会自动识别新硬件并安装 USB 驱动，设备管理器里会多出一个“USB3 Vision Camera”类别。展开、右键属性，能看到驱动是否正常。这一步是判断 U3V 环境是否就绪的唯一标准，比在客户端里反复刷新设备列表有用得多。

驱动装失败的表现是设备管理器里出现带黄色感叹号的未知设备，或者 USB3 Vision Camera 下面带感叹号。原因通常三个：插在了 USB 2.0 口上、用了不带数据线的延长线、系统里残留了旧版驱动。处理顺序是先用驱动管理工具重装驱动（工具在“工具”菜单下），不行再换口换线。

这里有个容易被忽略的细节：MVS 支持多相机同时连接，但多个 U3V 相机挂在一个 USB 控制器上会平分带宽，四台以上就开始掉帧。工控机上如果有多个 USB 控制器，把相机分散插到不同控制器下的口上，比全部插在前面板要稳。

3.3 Camera Link：驱动根本不在 MVS 里

Camera Link 这条线最容易让人走弯路。MVS 只负责连接相机、读取和设置参数、升级固件，不负责预览图像。采集卡驱动和配套软件要找采集卡厂商拿，MVS 安装包里没有。

判断驱动是否装好，同样是看设备管理器：采集卡和串口信息会出现，不同厂商的采集卡显示内容不一样，以实际使用的卡为准。如果设备管理器里根本没有采集卡相关条目，先确认卡插稳了、PCIe 供电正常，再重装厂商驱动和配套软件。手册里那句“若安装异常，建议重装采集卡驱动和软件，或联系采集卡厂商”就是这个意思——这一段 MVS 帮不上忙。

还有一点：Camera Link 相机在设备列表里能枚举到、能连上、能改参数，但点预览没有画面，这是正常行为，不是装坏了。第一次接触这条线的人经常在这里卡半天。

3.4 用 NIC_Configurator 批量整理网卡，别一台台手改

现场机器多的时候，逐台进设备管理器改巨帧和 IP 效率太低。网卡配置工具除了看状态，还能直接打开对应网卡的协议属性，跳进 Windows 的 IP 配置窗口，改完确定即可。MVS 3.2.0 起这个工具还加了批量设置功能，一次把多张网卡的巨帧、IP 一起处理掉。

批量设置的适用场景是：一台工控机上插了四张千兆卡，分别接四台相机，四张卡需要同一网段的不同地址。手工改一张两分钟，四张就是八分钟，还容易记混。批量设置里把起止地址和掩码填好，一次写完，改完在设备列表里逐台确认可达状态即可。

提示：批量改 IP 之前，先把当前网卡的配置截个图或者导出一份，改错了能对照着退回去。

4. 设备发现到出图：属性配置这条最小闭环

环境配好只是让相机“能看见”，真正出图靠的是属性配置。MVS 的属性树把相机参数分成常用属性、触发、图像处理三部分，右侧属性区从 3.0.0 起就挪到了这里。这一节按从枚举到出图的顺序走一遍，每一步给出判断标准和失败时先看哪里。

4.1 枚举、可达与不可达：状态行里藏着答案

设备列表里选中一台网口相机，接口/设备信息区会显示它的状态。可达状态下双击直接连接；不可达状态双击会弹出修改 IP 地址窗口，窗口里会提示一个有效 IP 范围，照着填就行。

不可达的成因基本就三种：PC 和相机不在同一网段、相机 IP 被别的设备占用、网线或供电有问题。第一种最常见，改 PC 网卡地址或者改相机地址都能解决；第二种换一个地址；第三种看网口指示灯，灯不亮就别在软件里找了。

# 改完 IP 之后先用 ping 确认链路层是通的，再回客户端连接 ping -n 4 192.168.1.64 # 想确认端口有没有被占用，可以看 ARP 表里这个地址对应的 MAC arp -a | grep 192.168.1.64

ping 通不代表相机一定能连上——GigE Vision 走的是 UDP 控制通道和数据通道，ping 只验证 ICMP。但 ping 不通的时候，客户端一定连不上，所以这一步是个快速排除法。ARP 表里如果有这个地址对应的 MAC，说明相机确实在链路上，问题出在上层配置；如果 ARP 里根本没有，那就是链路或地址的问题。

多相机场景下还有一个坑：几台相机的出厂 IP 相同，同时在网就会冲突。常见做法是先一台一台接上去改地址，改完贴标签，再全部挂上去。批量改 IP 用 IP 配置工具，支持单相机和多相机两种模式，多相机模式下可以按 MAC 地址匹配着改，比按顺序点安全。

4.2 传输层控制：包长、重发包和带宽这三件事

网口相机的出图质量，一半看传输层。属性树里的“传输层控制”下面有几个关键参数：

包长的取值逻辑很简单：网卡巨帧设了 9014，包长就可以往 8000 以上走；巨帧没开，包长最多 1500。见过不少现场网卡巨帧没开、包长还按 8000 配，结果丢包数一路涨、画面撕裂，来回折腾半天以为是相机坏了。

单相机独占链路时，包长拉满、包间隔归零、重发包开启，出图最稳。多相机共享一张网卡或者一台交换机时，就要反过来算总带宽：千兆链路理论 1000 Mbps，实际可用按 80% 算，八百万像素相机满帧跑很容易吃掉一大半，两台就顶到天花板。这时候用带宽管理工具限制每台相机的带宽，或者降帧率、开包间隔，比事后看丢包数猜测有效得多。

4.3 触发与数字 IO：外触发不出图先看这四项

相机能预览但一接外触发就没图，是现场最高频的问题之一。触发相关的配置分两块：采集控制里的触发模式、触发源，数字 IO 控制里的线路电平和防抖时间。MVS 3.3.0 在数字 IO 控制里新增了线路防抖时间参数，这个参数解决的就是信号毛刺导致的误触发和多触发。

按这个顺序查：

1. 采集控制里的触发模式是否从“关闭”切到“开启”。只接线不开触发模式，相机照样按自由运行出图。
2. 触发源选的是不是实际接线的那一路。常见的是 Line0 和 Software 混淆，选了软触发却又在等硬件信号。
3. 触发极性对不对。上升沿触发接成了下降沿，表现是信号来了但相机没反应，用示波器或者 IO 监视能看出来。
4. 防抖时间是否过长。设成几十毫秒之后，高频触发信号会被过滤掉一部分，表现是出图数量比预期少。

# 触发配置的关键参数，设置顺序不能颠倒 cam.MV_CC_SetEnumValue("TriggerMode", 1) # 0=关闭 1=开启 cam.MV_CC_SetEnumValue("TriggerSource", 0) # 0=Line0 7=Software，按接线改 cam.MV_CC_SetEnumValue("LineSelector", 0) # 选中 Line0 cam.MV_CC_SetIntValue("LineDebouncerTime", 100) # 防抖时间，单位微秒 cam.MV_CC_SetCommandValue("TriggerSoftware") # 软触发时用这一句发一次

这几行是 SDK 层面的调用，客户端的属性树里对应的是同一批参数，只是点选操作更直观。顺序上必须先把 TriggerMode 打开，再设触发源，最后才能发触发命令；反过来设触发源是没有效果的。防抖时间的单位是微秒，100 就是 0.1 ms，先从小值试，出图数量对了再加。

同一台机器上有多个 IO 线路时，LineSelector 决定后面几行参数作用在哪一路上，改错了会调了半天没动到真正接线的通道。

4.4 属性导入导出与用户集：一次调好，批量复用

一台相机调好的参数，要复制到同型号的其他相机上，用属性导入导出。MVS 支持单相机和多相机两种导入方式，多相机导入可以一次选多台目标设备。3.2.0 起导入单个相机属性时还加了属性差异查看，导入前能看到哪些参数会变、哪些不一样，避免糊里糊涂把调试好的配置覆盖掉。

用户集控制是另一条思路：相机内部可以存几套参数，通过用户集切换。产线上换产品型号时切一下用户集，比重新导一遍文件快。3.3.0 对这一块的交互做了调整，切换入口比之前更直接。

导入导出有两个实操要点：一是不同固件版本的相机，属性项可能对不上，导入前用差异查看确认；二是导出的属性文件建议带相机型号和固件版本命名，比如型号加日期，三个月后回来看还能对上号。

5. 避坑与排查：装完打不开、搜不到、不出图的五条记录

这一节记的都是我自己在现场遇到的，按现象、原因、解决三段写。有些问题反复出现，写下来下次能省半小时。

5.1 设备列表里 GigE 一栏是空的，网卡配置工具显示巨帧未启用

现象：装完 MVS，插上网线，GigE 下面一台设备都没有，网卡配置工具里巨帧状态是未启用。

原因：安装时没有勾选打开所有网卡的巨型包，或者这张网卡的驱动里没有巨帧参数。后者在消费级网卡上很常见，工具里点了启用也会失败。

解决：先在网卡配置工具里对目标网卡开启巨帧，失败就去设备管理器手动设成 9014 字节。如果网卡高级属性里根本没有巨帧这一项，换 Intel I210 或 I350 系列网卡，或者更新到厂商的正式版驱动。换完之后设备列表里立刻就能枚举到。

5.2 相机显示不可达，双击改完 IP 还是不可达

现象：设备列表里能看到相机，状态是不可达，双击弹出修改 IP 窗口，按提示改了一个地址，确定之后状态没变。

原因：改的是相机地址，PC 网卡自己在另一个网段，两边始终不通。还有一种情况是这台工控机有两张网卡，PC 上配了办公网的默认网关，相机流量被路由到另一张卡上。

解决：先把 PC 网卡改成和相机同一网段的静态地址，掩码一致，再把相机网卡上的默认路由删掉，只留同网段直连。改完 ping 一下确认链路通，客户端会自动刷新状态。多网卡的机器一定要记住哪张卡接的是相机。

5.3 U3V 相机插上，设备管理器里是黄色感叹号

现象：USB 相机接上后 MVS 搜不到，设备管理器里有个带感叹号的未知设备，USB3 Vision Camera 类别不出现。

原因：USB 驱动没装上。常见诱因是插在了 USB 2.0 口、用了延长线导致供电不足、系统里残留旧版驱动。

解决：先用“工具”菜单里的驱动管理工具重装驱动，重装后拔插一次相机。还不行就换到主板后置的原生 USB3.0 口，去掉延长线，换一根带屏蔽的短数据线。驱动管理工具装完如果设备管理器里的类别出来了，但带感叹号，右键卸载设备再扫描硬件改动，让它重新枚举一次。

5.4 预览正常，接上外部触发信号就不出图

现象：相机自由运行时画面正常，切到触发模式、接上外部信号之后一张图都拿不到。

原因：按概率排，最常见的是触发模式没开、触发源选错、触发极性反了，其次是 IO 接线共地问题，最后才是防抖时间设得太长把信号滤掉了。

解决：按采集控制到数字 IO 的顺序逐项确认，触发模式开启、触发源对应实际接线、极性匹配。用 IO 监视看信号有没有进来，进来了但相机不响应就是参数问题，信号根本没进来就是接线问题。防抖时间先归零试一次，能出图再逐步加上去。

5.5 多相机同时预览，丢包数一路涨、画面卡顿撕裂

现象：单台相机预览正常，接上第二台、第三台之后控制工具条里的丢包数和错误数持续增长，画面出现条带和撕裂。

原因：千兆链路总带宽被吃满，包长配置又超出了链路的实际承载能力。这一条在多相机、高分辨率、高帧率同时出现时几乎是必然。

解决：先开带宽管理工具看每台相机实际占用多少带宽，按总带宽 80% 的上限分配。然后统一降包长、加包间隔，重发包保持开启。相机数量多的时候把预览布局从九画面降到四画面，一次只看几路，其余后台采集。链路要真不够用，就上 10GigE 或者多网卡分流，别在单张千兆卡上硬挤。

6. 装完怎么验证：五项检查跑完才算这套环境通了

装完看到桌面图标、设备列表里能看到相机，这两条只能说明安装包执行完了，不能说明环境配好了。我自己的验收清单是五项，全过才算这套环境真的能交给产线用。

具体怎么做：接上相机、连上客户端之后，先看控制工具条上的取流状态，里面有带宽占用、丢包数、错误数的实时数值。正常出图时丢包数应该稳定在一个很小的值不动；如果它一直在涨，说明链路或传输层参数有问题，别急着往下走。

然后做一次抓图加一段十秒左右的录像，落地到本地磁盘，双击打开确认文件完整。这一步验证的是客户端的写权限和录像与抓图设置，比看预览更能暴露问题。MVS 3.3.0 对支持的格式做过扩充，格式选错了会导出失败但不一定有明确提示。

最后一步最容易被跳过：把当前相机的属性导出成文件，再重新导回去一次，看相机行为有没有变化。这一步能提前发现固件版本差异导致的属性错位，避免换批次相机时集体翻车。多相机项目里，我会把这套流程在每台相机上都走一遍，而不是只验第一台。

抓图、录像、属性文件都落地之后，顺手翻一眼日志。客户端的日志和 SDK 日志是分开的，位置在设置里能看到，出现“连接失败”“取流超时”这类记录时，日志比界面提示靠谱得多——界面只告诉你失败了，日志会告诉你是哪一步失败、错误码多少。这个习惯是被坑出来的：有一次现场相机每隔二十分钟断一次，界面只显示断开，翻日志才看到是心跳超时，最后查出是交换机某个口的节能策略把链路休眠了。

从那以后我每次装完一套视觉环境，这五项检查都强制走一遍，哪怕客户催着上线也先跑完——省下来的返工时间比这十分钟多得多。你在自己机器上装的时候也照这个顺序来一次，哪一项卡住就回去看对应那一节。希望帮到你。

本文还有配套的精品资源，点击获取