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 ~45 seconds).

Caution

When configuring, ensure that you don’t physically connect multiple cameras with the same IP address 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-2234AB12:

   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-2234AB12
   

   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-2022C0DE.local
           - NetworkCamera:
               Host: zivid-two.local
           - NetworkCamera:
               Host: zivid-two-alt-1.local
           - NetworkCamera:
               Host: zivid-two-alt-2.local
   

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

Note

The first time the camera is connected to in a process can take 10-20 seconds.

Tip

If you cannot find your camera after IP configuration, check out How do I find the camera? (requires SDK 2.7 or later).

If you are using an earlier SDK version or don’t know the hostname of the camera, 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.

Holding the reset button too long (more than 10 seconds) will reset the camera firmware to the factory default. If the firmware is reset, a Firmware Update might be required.