Zivid Two Network Configuration

The Zivid Two camera uses Ethernet communication and needs 10 Gbps for best performance. Your computer may not have a port for 10 Gigabit Ethernet. In that case, you can connect to it using a Thunderbolt 3 to 10GbE Adapter. At a reduced performance you can also use USB to 5GbE, 2.5GbE, or 1GbE adapters.

Default Zivid Two network configuration

Requirements

Performance

Network

Interface

Connection

Optimal (recommended)

10GbE (10Gbps)

PCIe card

Direct

Very good

10GbE

Thunderbolt Adapter

Direct

Reduced

5GbE or 2.5GbE

PCIe/USB/Thunderbolt Adapter

Direct/Switch

Minimum

1GbE (1Gbps)

PCIe/USB Adapter

Direct/Switch

Caution

USB-based network adapters have reduced and more variable capture speed, and can occasionally give errors when using the camera.

Default configuration

IP

Subnet mask

Gateway

Zivid Two

172.28.60.5

255.255.255.0

172.28.60.1

Possible PC

172.28.60.2 1

255.255.255.0

172.28.60.1

1

Any IP address in the subnet range is valid, except the network address (172.28.60.0) and the broadcast address (172.28.60.255). We also choose to avoid the gateway IP (172.28.60.1), even though we don’t currently require a gateway.

In order to use the camera with the default IP address your PC’s IP address must be in the same subnet, as listed in the table above. Go to Static IP Network Configuration - PC.

How does Zivid SDK find the camera?

The Zivid SDK knows the default IP address of the camera. In addition it will check all IP addresses listed in Cameras.yml

pseudo code to show how Zivid SDK looks for a connected camera

def find_camera():
  if exists(Cameras.yml):
    for IP in Cameras.yml:
      connect(IP)
  else:
    connect("172.28.60.5")
Sample Cameras.yml file
__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: 172.28.60.5
        - NetworkCamera:
              Host: 172.28.60.6
        - NetworkCamera:
              Host: 172.28.60.7

Path to Cameras.yml

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

Caution

Zivid configuration files must use .yml file extension ( not .yaml).

Custom configuration, single or multiple cameras

If you want to change the default IP of a single camera, you need to reconfigure the network settings. The same applies if you want to use multiple Zivid Two cameras connected to the same network card (each of them must have their unique IP address).

Note

There may be multiple reasons for why one wants to use custom static IPs. One may want to connect multiple cameras to the same network card or there may be an IP conflict with the IP range used by one’s internal network.

Network configuration for two Zivid Two cameras

Static

Dynamic

The Zivid Two supports both DHCP and link-local configuration. A DHCP setup requires a DHCP server, either running on a router on the network or running locally on the PC. Current logic on Zivid Two:

  1. Camera boots up

  2. Camera looks for a DHCP server for ~15 seconds.

  1. A DHCP server is found and an IP address is assigned.

  2. A DHCP server is not found and the camera defaults to link-local address.

It is possible to connect to the camera via a hostname. Connection via hostname requires a NetBIOS Naming Service.

Tip

It is highly recommended to use hostnames when using a dynamic IP. If not you have to list all possible IP addresses in Cameras.yml, or find the IP address assigned to the camera and list that. When you use hostnames you only have to list the expected hostnames, and it doesn’t matter if the IP address is reassigned.

Warning

If you are not careful it is easy to run into issues with DHCP. For example, running more than one DHCP server with overlapping address range on the same network.

The following guides walk through each configuration option step by step.