Description:
ConfigureIP tool is used to configure the IP address of a FRAMOS Industrial Depth Camera.
Supported IP configurations are:
- Persistent IP - fixed IP address which is stored in camera non-volatile memory
- DHCP - camera attempts to acquire IP address via DHCP protocol
- LLA - camera attempts to acquire IP address via LLA protocol, always enabled
The camera and network interface card (NIC) that is used to connect to the camera need to be on the same subnet for the camera to be accessible by the software. For this reason, the ConfigureIP tool allows to temporarily change the current IP address of the camera. This is useful in situations where NIC and camera are on different
subnets, and IP configuration of the NIC cannot be changed.
Usage:
Launch the tool from command prompt.
The tool will prompt for configuration options when launched.
Usage example on Linux:
./ConfigureIp
Usage example on Windows:
ConfigureIp.exe
Non-Interactive mode
Tool can also be launched in non-interactive mode by passing appropriate arguments. The following examples show usage on Windows, the same options are available on Linux as well.
ConfigureIp.exe -help
Passing the argument "-help" to the ConfigureIp tool will give the user information about the tool and different arguments that can be passed to the tool.
ConfigureIp.exe -list
Passing the argument "-list" to the ConfigureIp tool will return the list of all the devices detected on the network.
ConfigureIp.exe -temp <Serial number of device> <New temporary IP address> <New subnet mask> <New default gateway>
Using the argument "-temp" together with the serial number of the device, new temporary IP address can be set for the device. Besides the mentioned argument, three more arguments are needed: New temporary IP address of the device, new subnet mask and a new default gateway (any of these new values can be equal to old value).
Temporary IP address is set until the device powers off.
Example: Change temporary IP of device with S/N 6CD146030036 to 169.254.54.21
with subnet mask 255.255.0.0 and default gateway 0.0.0.0:
ConfigureIp.exe -temp 6CD146030036 169.254.54.21 255.255.0.0 0.0.0.0
ConfigureIp.exe -perm <Serial number of device> <New permanent IP address> <New subnet mask> <New default gateway>
Executing the tool with these arguments does the same as executing it with the above arguments, except this changes the permanent IP of the device (the new IP stays on the device even after the device powers off). The device needs to be restarted before this change takes effect.
ConfigureIp.exe -perm <Serial number of device>
Passing these arguments to the tool, the tool prints "Enabled" or "Disabled" depending on whether the permanent IP address is enabled or disabled. The tool also returns STATUS_ENABLED which is equal to 2, if the option is enabled, and STATUS_DISABLED which is equal to 3, if the option is disabled.
ConfigureIp.exe -perm <Serial number of device> -t
Executing the tool with these arguments, the tools toggles the permanent IP address between enabled and disabled (changes whether the permanent IP address is used or not).
ConfigureIp.exe -dhcp <Serial number of device>
Passing these arguments to the tool, the tool prints "Enabled" or "Disabled" depending on whether the DHCP is enabled or disabled. The tool also returns STATUS_ENABLED which is equal to 2, if the option is enabled, and STATUS_DISABLED which is equal to 3, if the option is disabled.
ConfigureIp.exe -dhcp <Serial number of device> -t
Executing the tool with these arguments, the tool toggle DHCP between enabled and disabled (changes whether DHCP is used or not).
ConfigureIp.exe -restart <Serial number of device>
Using argument "-restart", the tool restarts the device with the specified serial number.
NOTE: Besides STATUS_ENABLED and STATUS_DISABLED that are used for checking whether the permanent IP address or DHCP are enabled, there are two more statuses. STATUS_OK signalizes that everything finished as it should have, and that the command was successfully executed. STATUS_ERROR signalizes that some error has occurred and
that the command wasn't able to execute.
Status codes:
STATUS_OK = 0
STATUS_ERROR = 1
STATUS_ENABLED = 2
STATUS_DISABLED = 3