camera-ip-conf

camera-ip-conf is a tool that allows the ip configuration of GigE network cameras. Use it to configure the camera through the command line.

Cameras can be named using the following methods:

-s  --serial - The serial number of the camera
-m  --mac    - The mac of the camera
-n  --name   - The user defined name (assuming the name is not empty)

Arguments

-h, --help

Print a help message

-l, list

List available GigE cameras.

-i, info (-s SERIAL|-n NAME|-m MAC)

Print information about a certain camera.

set [ip=IP] [subnet=NETMASK] [gateway=GATEWAY] [dhcp={on,off}] [static={on,off}] [name=NAME] (-s SERIAL|-n NAME|-m MAC)

Configure one or more settings in the camera.

ip=IP

Option to set static IP settings IP.

subnet=NETMASK

Option to set static IP settings netmask.

gateway=GATEWAY

Option to set static IP settings gateway.

dhcp={on,off}

Toggle for usage of dynamic IP address settings.

static={on,off}

Toggle for usage of static IP address settings.

name=NAME

The maximum length of this name is 15 characters.

rescue [ip=IP] [subnet=NETMASK] [gateway=GATEWAY] (-s SERIAL|-m MAC)

Temporarily assign another address to a camera

ip=IP

IP address that shall be temporarily assigned.

subnet=NETMASK

Netmask address that shall be temporarily assigned.

gateway=GATEWAY

Gateway address that shall be temporarily assigned.

upload firmware=FILE -s SERIAL

Upload a firmware file to a camera.

firmware=FILE

.fw or .fwpack file that shall be used.

Examples

To list all cameras:

camera-ip-conf -l

To get information about a single camera:

camera-ip-conf -i -s <CAMERA_SERIAL>

To set the name of a camera:

camera-ip-conf set name="CAMERA_NAME" -s <CAMERA_SERIAL>

This name is restricted to 15 characters.

To delete the name, simply set it to an empty name:

camera-ip-conf set name="" -s <CAMERA_SERIAL>

To set the static ip configuration of a camera:

camera-ip-conf set ip=192.168.100.100 subnet=255.255.0.0 gateway=192.168.100.1

To toggle static ip usage:

camera-ip-conf set static=on -s <CAMERA_SERIAL>

To upload a new firmware:

camera-ip-conf upload firmware=<FILE> -s <CAMERA_SERIAL>

Warning

CAUTION: Failures when upgrading the firmware can make the camera unusable. Use at your own risk!

Troubleshooting

  • The camera is not detected. There might be several issues to consider:

    • Ensure the camera is responding as it should. This can be done via wireshark. If a gvcp pong arrives, the camera is responding correctly.

    • Turn off the firewall. The firewall might be blocking the packages.

    • Turn off rp_filter. rp_filter is a kernel module that drops packets from addresses that are not within the address range of the configured network. If the camera happens to use LLA (or a static IP not within the configured network). This may be the reason. To temporarily turn off the rp_filter, execute:

      sudo sysctl -w net.ipv4.conf.all.rp_filter=0
      

      Warning

      WARNING: These actions may pose a security threat to the computer. Please contact the system administrator before executing these actions. We take no responsibility for damage to persons, systems or environments. Use at your own risk.

    • The camera is misconfigured. If the camera has a temporary IP configuration and is not reachable, simply reconnecting the camera should reset the configuration.

      If the static ip is misconfigured and the camera has a address that can not be represented in a reliable way (e.g. broadcast addresses such as 192.168.0.255/24), execute

      camera-ip-conf rescue ip=<IP> subnet=<SUBNET> gateway=<GATEWAY> mac=<MAC>
      

    To get the mac address of the camera, use tools like wireshark to listen to incoming traffic. The camera should still send pong packets as a response to the discovery pings.