IP Configuration Tool
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 laser profiler 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.
-
Windows: Mech-Eye SDK Installation Guide
The IP configuration tool is an executable file named ip_configurator, located in the following path:
-
Windows: xxx/Mech-Eye SDK-2.4.0/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 laser profiler:
-
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.0/API/bin/ip_configurator.exe
sudo /opt/mech-mind/mech-eye-sdk/bin/ip_configurator
-
-
Input the index of the laser profiler whose IP configuration needs to be modified according to the instruction, and press Enter to connect to the laser profiler.
-
Select the IP address assignment method based on the prompt:
0
is to assign the IP address dynamically, and1
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.
-
-
Enter the IP address to be set and press the Enter key.
-
Enter the subnet mask to be set and press the Enter key. To set the subnet mask to
255.255.255.0
, you can enter0
and then press the Enter key. -
The old and new IP configuration of the laser profiler 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 laser profilers 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 laser profiler is needed to specify the laser profiler whose IP configuration you want to modify.
The serial number of the controller should be used. -
Only one laser profiler‘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 laser profiler for modifying the IP configuration. |
|
--host-sn |
Use the serial number of the controller to specify the laser profiler for modifying the IP configuration. |
|
--dhcp |
Dynamically assign an IP address. |
- |
--static |
Assign a static IP address. |
The |
--ip |
Specify the new IP address. |
Must be used with the |
--subnet-mask |
Specify the new subnet mask. |
Must be used with the |
--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 laser profiler by the serial number of the controller and dynamically assign an IP address:
-
Windows
-
Ubuntu
xxx/Mech-Eye SDK-2.4.0/API/bin/ip_configurator.exe --host-sn LCA00233A201YA15 --dhcp
sudo /opt/mech-mind/mech-eye-sdk/bin/ip_configurator --host-sn LCA00233A201YA15 --dhcp
-
-
Specify the laser profiler by the current IP address and assign a static IP address:
-
Windows
-
Ubuntu
xxx/Mech-Eye SDK-2.4.0/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.0/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
-