Network Configuration

조심

네트워크 구성에 대한 올바른 지침은 SDK 버전에 따라 다릅니다. 왼쪽 상단 드롭다운에서 SDK 버전을 선택합니다.

Default configuration

Ethernet-based Zivid cameras are shipped with the default static IP as listed in the table below. To connect to a camera, the interfacing network card must have an IP in the same subnet range as the camera.

Suppose you have not configured the camera in any way before this tutorial, or you know that the camera is still in its default configuration. In that case, you may connect to it after configuring the interfacing network card of your PC. Go to Static IP Network Configuration - PC to do this.

	IP	Subnet mask	Gateway	Hostname
Zivid camera	172.28.60.5	255.255.255.0	172.28.60.1	zivid-<serial number>
Possible PC	172.28.60.2 [1]	255.255.255.0	172.28.60.1

[1]

Subnet 범위내에서 어떤 IP 주소도 사용 가능하지만, network address(172.28.60.0)와 broadcast address(172.28.60.255) 또한 현재 게이트웨이가 필요하지 않더라도 gateway IP(172.28.60.1) 주소를 피해 선택합니다.

Custom configuration

다음과 같은 경우 사용자 지정 설정이 필요합니다.

• 카메라의 IP 또는 hostname을 변경하려는 경우,

• 카메라가 default 설정이 아닌 경우,

• 여러 대의 카메라에 연결하려는 경우,

• Zivid SDK가 연결할 수 있는 카메라를 제한하려는 경우,

여기에는 카메라와 PC의 고정 IP를 변경하는 것 외에도 동적 모드로 구성하는 작업이 포함될 수 있습니다. 사용자 지정 설정은 Static IP와 dynamic IP 설정으로 나뉩니다.

Static

This is the default configuration for the camera, which comes with static IP 172.28.60.5. The following guides describe how to change and configure static IP for both the camera and PC:

• Static IP Network Configuration - Camera
• Static IP Network Configuration - PC

Dynamic

The camera also supports automatic IP configuration using either DHCP or link-local. When configured to use an automatic IP, the camera will first try to obtain an IP address using DHCP (within ~45 seconds). Getting an IP address from a DHCP server requires a DHCP server running either on a router on the network or locally on the PC.

다음 가이드에서는 DHCP 또는 link-local을 사용하여 PC와 카메라 모두에 대해 Dynamic IP를 구성하는 방법을 설명합니다.

• DHCP or Link Local IP Network Configuration - Camera
• Link Local IP Network Configuration - PC
• DHCP Network Configuration - PC

Connecting to the camera

Assuming you have followed either Default configuration or Custom configuration, you should now be able to connect to the camera. Be aware that the first time a camera is connected to in a process, it can take 10-20 seconds before it connects. There are two recommended ways to discover and connect to the camera.

Zivid Studio

Zivid Studio 를 열고 카메라를 검색하고 연결할 수 있는지 확인합니다.

CLI Tool

Use the ZividListCameras CLI tool to test the connection. This tool is installed alongside the Zivid SDK on Windows, and with the Zivid Tools package on Ubuntu.

ZividListCameras --test-connect

If you are still not able to discover or connect to the camera, check out the troubleshooting article No cameras found in Zivid Studio.

Performance

The capture time will, among others, depend on the connection speed between the camera and the network interface and the capture settings used. For optimal performance, the camera needs 10 Gbps. Your computer may not have a port for 10 Gigabit Ethernet, but in that case, you can connect to it using a Thunderbolt 3 to 10GbE Adapter. At a reduced performance you can also use 5GbE, 2.5GbE, or 1GbE.

To check the maximum bandwidth of a specific capture setting (including presets), go to the Capture Speed Calculator.

힌트

카메라 뒷면의 status LEDs 는 현재 링크 용량이 표시됩니다.

Performance	Network	Interface	Connection
Optimal (recommended)	10GbE (10Gbps)	PCIe card	Direct
Very good	10GbE	Thunderbolt Adapter	Direct
Good	5GbE 또는 2.5GbE	PCIe/USB/Thunderbolt Adapter	Direct/Switch
Minimum	1GbE(1Gbps)	PCIe/USB Adapter	Direct/Switch

조심

USB 기반 네트워크 어댑터는 캡처 속도가 감소하고 가변적이어서 카메라를 사용할 때 가끔 오류가 발생할 수 있습니다.

Cameras.yml and how to restrict discoverable cameras

A configuration file Cameras.yml can be used to restrict which IP addresses and hostnames Zivid SDK can connect to. Use the drop-down below for more information about how Zivid SDK discovers cameras and how Cameras.yml can be used.

Cameras.yml and how Zivid SDK discovers cameras

How does Zivid SDK find cameras?

Zivid SDK uses Multicast DNS (mDNS) for auto-discovering cameras on the network. In SDK 2.7 and earlier, cameras with non-default IPs had to be listed in the Cameras.yml file in the Zivid configuration folder, which the SDK searched through to discover cameras.

Even though mDNS removes the requirement of Cameras.yml, this file may still be used to override which cameras the SDK can connect to. Cameras.yml therefore has the function of restricting which cameras the PC can connect to, if provided.

Cameras.yml

Zivid SDK가 검색하는 IP를 제한하려면 Cameras.yml 을 다운로드하여 Zivid 설정 폴더에 저장합니다.

Windows

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

Ubuntu

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

조심

Any existing Config file will be overwritten.

조심

Zivid 구성 파일은 .yaml이 아닌 .yml 파일 확장자를 사용해야 합니다.

Hostnames이나 IP 주소를 사용하여 Cameras.yml 이 어떻게 구성하는지에 대한 몇 가지 예가 아래에 나와 있습니다.

Sample Cameras.yml file (hostnames)

__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: zivid-2152D404.local
        - NetworkCamera:
              Host: zivid-20205M19.local
        - NetworkCamera:
              Host: zivid-21389K63.local

Sample Cameras.yml file (IP addresses)

__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: 172.28.60.5
        - NetworkCamera:
              Host: 172.28.60.6
        - NetworkCamera:
              Host: 172.28.60.7

Version History

SDK	Changes
2.13.0	Added support for network configuration in Zivid Studio and SDK.
2.11.0	Improved network discovery for listing and configuring all cameras, both available and unavailable.
2.8.0	멀티캐스트 DNS를 사용한 자동 검색에 대한 지원이 추가되어 기본 IP가 아닌 카메라를 검색하기 위한 Cameras.yml 의 요구 사항이 제거되었습니다. Zivid 2의 데이터 전송 속도가 향상되었습니다.
2.7.0	Multicast DNS를 사용하여 local 레이블로 끝나는 이름 쿼리에 대한 지원이 추가되었습니다.