网络配置

小心

网络配置的正确说明取决于您的SDK版本。在左上角的下拉菜单中选择您的SDK版本。

默认配置

基于以太网的 Zivid 相机设置了默认的静态 IP，如下表所列。要连接到相机，接口网卡的 IP 必须与相机处于同一子网范围内。

假设您在本教程之前尚未以任何方式配置相机，或者您知道相机仍处于默认配置。此时，您可以在配置好PC的接口网卡后进行连接。转到 静态IP网络配置 - PC 来执行此操作。

默认的Zivid 2网络配置

IP

子网掩码

网关

主机名

Zivid相机

172.28.60.5

255.255.255.0

172.28.60.1

zivid-<serial number>

电脑

172.28.60.2 [1]

255.255.255.0

172.28.60.1

自定义配置

例如，在以下情况下需要自定义配置：

  • 您想更改相机的IP或主机名

  • 相机不在其默认配置中

  • 您想连接到多个相机

  • 您想限制Zivid SDK可以连接的相机

这可能涉及更改相机和PC的静态IP，但也将它们配置为动态模式。自定义配置分为静态IP和动态IP配置。

这是相机的默认配置，带有静态 IP 172.28.60.5 。以下指南介绍了如何更改和配置相机和 PC 的静态 IP：

该相机还支持使用 DHCP 或本地链路的自动 IP 配置。当配置为使用自动 IP 时，相机将首先尝试使用 DHCP 获取 IP 地址（约 45 秒内）。从 DHCP 服务器获取 IP 地址需要在网络路由器上或本地 PC 上运行 DHCP 服务器。

下面的指南介绍了如何使用DHCP或link-local为PC和相机配置动态IP：

连接到相机

假设您遵循了 默认配置 或 自定义配置 ，您现在应该能够连接到相机。请注意，在进程中首次连接相机时，可能需要 10-20 秒才能连接。有两种推荐的方法来发现并连接到相机。

打开 Zivid Studio 并检查它是否可以发现并连接到相机。

../../_images/zivid-studio-connect-camera.png

使用 ZividListCameras CLI 工具测试连接。该工具在 Windows 上与 Zivid SDK 一起安装，在 Ubuntu 上与 Zivid Tools 包一起安装。

ZividListCameras --test-connect
../../_images/zivid-list-cameras-test-connect.png

表现

捕获时间将取决于相机和网络接口之间的连接速度。为了获得最佳性能，建议使用 10 Gbps 接口。如果您的计算机没有 10 Gigabit 以太网端口，在这种情况下，您可以使用一个 Thunderbolt 3 到 10GbE 的适配器进行连接。在允许降低性能的情况下，您还可以使用 5GbE、2.5GbE 或 1GbE。

提示

相机背面的 状态LED 显示了当前的链路容量。

表现

网络

界面

连接

最佳（推荐）

10GbE (10Gbps)

PCIe 卡

直连

很好

10GbE

Thunderbolt雷电适配器

直连

性能下降

5GbE或2.5GbE

PCIe/USB/Thunderbolt适配器

直连/交换机

最差

1GbE (1Gbps)

PCIe/USB适配器

直连/交换机

小心

基于USB的网络适配器会降低捕获速度，并会带来较大的波动，在使用相机时偶尔会出错。

Cameras.yml以及如何限制可发现的相机

配置 Cameras.yml 可用于限制 Zivid SDK 可以连接的 IP 地址和主机名。使用下面的下拉菜单了解有关 Zivid SDK 如何发现相机以及如何使用 Cameras.yml 的更多信息。

Cameras.yml 以及 Zivid SDK 如何发现相机

Zivid SDK如何找到相机？

Zivid SDK 使用多播 DNS (mDNS) 自动发现网络上的相机。在 SDK 2.7 及更早版本中，具有非默认 IP 的相机必须列在 Zivid 配置文件夹中的 Cameras.yml 文件中，SDK 通过搜索该文件来发现相机。

即使 mDNS 取代了 Cameras.yml 的功能，该文件仍可用于覆盖 SDK 可以连接到的相机。因此 Cameras.yml 具有限制 PC 可以连接哪些相机（如果提供）的功能。

Cameras.yml

如果您希望限制Zivid SDK搜索的IP，请下载 Cameras.yml 并将其放在Zivid配置文件夹中，如下所示。

mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Cameras.yml %LOCALAPPDATA%\Zivid\API\

mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Cameras.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

小心

任何现有的配置文件都将被覆盖。

小心

Zivid配置文件必须使用.yml文件扩展名（而不是.yaml）。

下面是 Cameras.yml 的一些示例，使用主机名或IP地址进行配置。

Cameras.yml文件（主机名）的示例
__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: zivid-2152D404.local
        - NetworkCamera:
              Host: zivid-20205M19.local
        - NetworkCamera:
              Host: zivid-21389K63.local
Cameras.yml文件（IP地址）的示例
__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: 172.28.60.5
        - NetworkCamera:
              Host: 172.28.60.6
        - NetworkCamera:
              Host: 172.28.60.7

版本历史

SDK

变更

2.11.0

改进了网络发现，用于列出和配置所有可用和不可用的相机。

2.8.0

添加了对使用多播DNS进行自动发现的支持，移除了必须使用 Cameras.yml 来发现具有非默认IP的相机的要求。 提高了Zivid 2的数据传输速度。

2.7.0

添加了对使用多播DNS以 local 标签结尾的名称查询的支持。