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 ~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:

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 connected to the same network card using a switch, use 172.28.60.5, 172.28.60.6, and 172.28.60.7. For multiple cameras using individual network cards use 172.28.60.5, 172.28.61.5, and 172.28.62.5.

  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 on the same network card using a switch 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
    

    The configuration file for connecting to 3 cameras using 3 individual network cards looks like this:

    __version__: 1
    Cameras:
        NetworkCameras:
            - NetworkCamera:
                  Host: 172.28.60.5
            - NetworkCamera:
                  Host: 172.28.61.5
            - NetworkCamera:
                  Host: 172.28.62.5
    

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.

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.