DHCP or Link Local IP Network Configuration - Camera

The CLI tool ZividNetworkCameraConfigurator allows you to change the camera network configuration of one camera at a time. This tool is installed alongside the Zivid SDK on Windows, and with the zivid-tools package on Ubuntu. If you are unsure whether this tool has been installed, follow the Software Installation guide. The camera can be configured in static IP mode or DHCP mode (defaults to link-local after ~15 seconds).

Caution

When configuring, ensure that you physically connect only one camera with the same IP at a time.

Help/Menu

To view the help text with information about all inputs and outputs, type

WindowsUbuntu (including headless)

C:\> ZividNetworkCameraConfigurator.exe -h

Enable DHCP mode on the camera

1. Open a terminal/Command Prompt.

2. Connect a Zivid Two camera.

3. Verify that your camera is found by running:

   WindowsUbuntu (including headless)

   C:\> ZividListCameras.exe
   

4. Enable DHCP mode on camera:

   To set the camera in DHCP mode, type:

   WindowsUbuntu (including headless)

   C:\> ZividNetworkCameraConfigurator.exe set-config <host> --dhcp [--hostname <hostname>]
   

   For example, changing to DHCP with hostname zivid-two:

   Note

   The default hostname has the following format: zivid-serialnumber, e.g., zivid-2234AB12.

   WindowsUbuntu (including headless)

   C:\> ZividNetworkCameraConfigurator.exe set-config 172.28.60.5 --dhcp --hostname zivid-two
   

   Note

   The hostname (optional) is limited to maximum 15 characters.

5. Disconnect the camera.

6. If you are configuring IP addresses of multiple cameras, repeat steps 2 to 5.

   For multiple cameras, we recommend that you give each camera a unique hostname. Make sure each hostname is listed in Cameras.yml.

   For example:

   __version__: 1
   Cameras:
       NetworkCameras:
           - NetworkCamera:
               Host: zivid-two
           - NetworkCamera:
               Host: zivid-two-alt-1
           - NetworkCamera:
               Host: zivid-two-alt-2
           - NetworkCamera:
               Host: zivid-two-2022C0DE
   

   WindowsUbuntu (including headless)

   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).

7. Before you connect the camera

   Link-LocalDHCP

   1. Make sure a DHCP is not active on the network.

   2. Connect your camera(s), and then wait > 15 seconds.

8. Verify that your camera is found by running:

   WindowsUbuntu (including headless)

   C:\> ZividListCameras.exe
   

   Alternatively, run the info command to try to connect to an IP or hostname. If successful it prints serial number and MAC address.

   WindowsUbuntu (including headless)

   C:\> ZividNetworkCameraConfigurator.exe info <host>
   

Once you have configured both the camera and the PC (Link-Local or DHCP) you can open Zivid Studio and the camera will be found automatically.

Tip

In case you cannot find your camera after IP configuration, do a network reset.

1. Locate the reset button below the power connector.

2. Use the pointed end of a paper clip or something similar to press and hold the button for 5 to 10 (no longer!) seconds until the LED goes from red to green.

3. The camera will go back to its factory default IP 172.28.60.5.

Do not hold the reset button too long (more than 10 seconds) because that will reset the camera firmware. In case of an unwanted firmware reset, you might have to do a Firmware Update.