Static 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

ZividNetworkCameraConfigurator.exe -h

Set the IP address of the camera

  1. Open a terminal/Command Prompt.

  2. Connect a Zivid Two camera.

  3. Verify that your camera is found by running:

    ZividListCameras.exe

  4. Set static IP on camera:

    To set the camera in static IP mode with a specific IP address, subnet mask and gateway:

    ZividNetworkCameraConfigurator.exe set-config <host> --static --ip <ip> --subnet-mask <mask> --gateway <gateway>

    For example, changing the static IP from 172.28.60.5 to 172.28.60.6:

    ZividNetworkCameraConfigurator.exe set-config 172.28.60.5 --static --ip 172.28.60.6 --subnet-mask 255.255.255.0 --gateway 172.28.60.1

    Caution

    When changing static IP, make sure it is not colliding with something else on your network and that it is not in the DHCP range.

  5. Disconnect the camera.

  6. If you are configuring IP addresses of multiple cameras, repeat steps 2 to 5 with an IP address different for each camera but in the same subnet range.

    For multiple cameras, remember to give each camera a unique IP, e.g. with 3 cameras, use 172.28.60.5, 172.28.60.6, and 172.28.60.7.

  7. If you used IP address(es) outside the default subnet range, e.g., 192.168.100.23 with gateway 192.168.100.1, you need to change your network interface configuration again. To do that, follow Static IP Network Configuration - PC steps but with the IP address in the same subnet range as the camera(s), e.g., 192.168.100.2 and gateway 192.168.100.1.

  8. Connect your camera(s).

  9. Download the Cameras.yml file and edit it with the new IP address/addresses.

    For example, the configuration file for connecting to 3 cameras looks like this:

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

Note

The Cameras.yml file is necessary even if you use a single camera if its IP address is different from the default IP.

  1. Place the configuration file in the following directory:

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

  2. Verify that your camera is found by running:

    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.

    ZividNetworkCameraConfigurator.exe info <host>

Once you have configured both the camera and the PC 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.