IP Configuration Tool

You are currently viewing the documentation for the latest version (2.4.1). To access a different version, click the "Switch version" button located in the upper-right corner of the page.

■ If you are not sure which version of the product you are currently using, please feel free to contact Mech-Mind Technical Support.

The IP configuration tool is independent from Mech-Eye SDK, and you can use it independently to modify the IP configurations (including the IP address assignment method, IP address, and subnet mask) of the camera on the Windows and Ubuntu operating systems. Meanwhile, this tool can be used in two modes:

  • Interactive mode: After running the tool, the IP configuration is completed step-by-step according to the prompt in the window.

  • Command mode: The IP configuration is modified by executing commands. This mode can be used to create your own graphical user interface for IP configuration.

Prerequisites

In order to use the IP configuration tool, the following prerequisites must be satisfied:

Download and install Mech-Eye SDK 2.2.0 or above to obtain the IP configuration tool.

The IP configuration tool is an executable file named ip_configurator, located in the following path:

  • Windows: xxx/Mech-Eye SDK-2.4.1/API/bin

  • Ubuntu: /opt/mech-mind/mech-eye-sdk/bin

The IP configuration tool is independent from Mech-Eye SDK. You can move this executable file to another location and run it on its own.

Instructions for Interactive Mode

Follow these steps to modify the IP configuration of the camera:

  1. Execute the following command to run the IP configuration tool: Replace the path with the actual path where the ip_configurator executable file is located.

    • Windows

    • Ubuntu

    xxx/Mech-Eye SDK-2.4.1/API/bin/ip_configurator.exe
    sudo /opt/mech-mind/mech-eye-sdk/bin/ip_configurator

  2. Input the index of the camera whose IP configuration needs to be modified according to the instruction, and press Enter to connect to the camera.

  3. Select the IP address assignment method based on the prompt: 0 is to assign the IP address dynamically, and 1 is to set a static IP address.

    • To assign an IP address dynamically, proceed to step 6.

    • To set a static IP address, proceed to the next step.

  4. Enter the IP address to be set and press the Enter key.

  5. Enter the subnet mask to be set and press the Enter key. To set the subnet mask to 255.255.255.0, you can enter 0 and then press the Enter key.

  6. The old and new IP configuration of the camera will be printed in the window. Please check if the new IP configuration is correct:

    • If correct, enter 1 and press the Enter key to complete the IP configuration.

    • If incorrect, enter 0 and press the Enter key. The program will list all the available cameras again. Please go back to step 2 and repeat the process.

Instructions for Command Mode

In the command mode, you only need to enter a command containing the path in which the IP configuration tool is located and the needed options to complete the corresponding modification of IP configuration.

  • The current IP address or serial number of the camera is needed to specify the camera whose IP configuration you want to modify.

  • Only one camera‘s IP configuration can be modified at a time.

The following table lists all the available options:

Option Function Note

--host-ip

Use the current IP address to specify the camera for modifying the IP configuration.

  • The current IP address of the camera must be entered after this option, separated by a space.

  • Either this option or the --host-sn option must be used to specify a camera, but not both.

--host-sn

Use the serial number to specify the camera for modifying the IP configuration.

  • The serial number of the camera must be entered after this option, separated by a space.

  • Either this option or the --host-ip option must be used to specify a camera, but not both.

--dhcp

Dynamically assign an IP address.

-

--static

Assign a static IP address.

The --ip and --subnet-mask options must be used at the same time to specify the new IP address and subnet mask.

--ip

Specify the new IP address.

Must be used with the --static and --subnet-mask options.

--subnet-mask

Specify the new subnet mask.

Must be used with the --static and --ip options.

--force

Ignore warning and execute the command forcibly.

When you assign a static IP address, if the new IP address is not in the same subnet as the current IP address, the IP configuration tool will terminate the operation automatically. Using this option can forcibly assign an IP address in a different subnet.

--h, --help

View the instructions.

-

Examples

The following are the command examples for commonly used operations:

  • Specify the camera by the serial number and dynamically assign an IP address:

    • Windows

    • Ubuntu

    xxx/Mech-Eye SDK-2.4.1/API/bin/ip_configurator.exe --host-sn QAA30228A403008 --dhcp
    sudo /opt/mech-mind/mech-eye-sdk/bin/ip_configurator --host-sn QAA30228A403008 --dhcp

  • Specify the camera by the current IP address and assign a static IP address:

    • Windows

    • Ubuntu

    xxx/Mech-Eye SDK-2.4.1/API/bin/ip_configurator.exe --host-ip 192.168.20.180 --static --ip 192.168.20.174 --subnet-mask 255.255.255.0
    sudo /opt/mech-mind/mech-eye-sdk/bin/ip_configurator --host-ip 192.168.20.180 --static --ip 192.168.20.174 --subnet-mask 255.255.255.0

  • Forcibly assign a new IP address not in the same subnet as the current IP address:

    • Windows

    • Ubuntu

    xxx/Mech-Eye SDK-2.4.1/API/bin/ip_configurator.exe --host-ip 192.168.20.180 --static --ip 192.168.16.174 --subnet-mask 255.255.255.0 --force
    sudo /opt/mech-mind/mech-eye-sdk/bin/ip_configurator --host-ip 192.168.20.180 --static --ip 192.168.16.174 --subnet-mask 255.255.255.0 --force

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.

  • Preference
  • I accept
  • I don't accept