Mech-Eye SDK Installation Guide
This topic guides you through the downloading, installation, upgrade, uninstallation, repair, and installation modification of Mech-Eye SDK (including Mech-Eye Viewer and Mech-Eye API) on Windows.
System Requirements
The computer on which Mech-Eye Viewer is installed should satisfy the following requirements:
Operating system |
Windows 10 or above |
|---|---|
CPU |
Intel i5-5300U or above IPCs with Intel CPUs are fully tested while IPCs with AMD CPUs are not yet tested. |
Memory |
8 GB or above |
GPU |
No requirement |
Hard disk |
128 GB SSD or larger |
|
Ensure that the hard disk where the software will be installed on your computer should have at least 5 GB free space; otherwise, installation may fail. |
|
When using Mech-Eye Viewer, the resolution and scaling of the screen should follow the correspondence in the table below. If the resolution and scale of your screen do not match those in the table below, some display problems may occur. If you are using dual monitors, make sure that both have the same resolution and scale.
|
Download Mech-Eye SDK Installation Package
You can download the Mech-Eye SDK installation package from Mech-Mind Download Center.
Verify the Integrity of Mech-Eye SDK Installation Package
Since the Mech-Eye SDK installation package may be corrupted during transmission or downloading, you need to verify the integrity of the installation package. The integrity of the installation package can be verified with the CRC-32 value, which is provided on the download page.
| Please install and use the 7-Zip software to calculate the CRC-32 value. |
To verify the integrity of the software installation package, follow these steps:
-
Copy the installation package to a specified directory on the device that will run the software, such as D:/.
-
Decompress the installation package. After decompression, you will obtain the software installer (Mech-Eye SDK Installer 2.4.0.exe).
-
Open 7-Zip, and use the address bar to navigate to the directory where the software installation package is located.
-
Select the software installation package, and in the context menu, select to calculate the CRC-32 value.
-
Check the calculated CRC-32 value against the one on the download page. The two values should be identical.
-
Repeat steps 3 to 5 to the software installer obtained after decompression.
If the calculated values do not match those provided on the download page, download the installation package again.
Install Mech-Eye SDK
To install Mech-Eye SDK, follow these steps:
-
Double-click Mech-Eye SDK Installer 2.4.0.exe to open the Mech-Eye SDK setup wizard.
-
In the Welcome window, browse the software information and click Next.
-
In the License Agreement window, read the license agreement carefully, check the I accept the terms and conditions in the license agreement check box, and then click Next.
-
In the Select Product window, select the components to install. If needed, check the Create desktop shortcut(s) option, and then click Next.
-
Make sure that the Add to PATH option is checked.
-
It is recommended to check the Mech-Eye SDK Docs option, which allows you to open the user manual without Internet connection.
-
-
In the Set Path window, change the installation path as required, and then click Next.
Default installation path: C:/Mech-Mind/Mech-Eye SDK-2.4.0.
-
In the Confirm window, confirm that the installation path is correct and then click Install.
-
In the Install window, wait for the installation to complete.
-
After the software is installed, in the Finish window, click Finish to exit the setup wizard.
| It is recommended to restart your computer after the installation. If not restarted, the environmental variable added to PATH may not be effective. |
Upgrade Mech-Eye SDK
Follow these steps to upgrade Mech-Eye SDK:
-
Double-click Mech-Eye SDK Installer 2.4.0.exe to open the Mech-Eye SDK setup wizard.
-
In the Upgrade window, click either Upgrade and keep history versions or Upgrade and delete history versions.
-
Upgrade the software according to the prompts in the setup wizard.
-
After the software is upgraded, in the Finish window, click Finish to exit the setup wizard.
|
After upgrading Mech-Eye SDK, to use Mech-Eye Viewer to connect to laser profiler, please first click the Upgrade button in the laser profiler information card to upgrade the firmware of laser profiler. |
Uninstall Mech-Eye SDK
You can uninstall Mech-Eye SDK either with the Mech-Eye SDK setup wizard or the Windows Control Panel.
Uninstall Using the Setup Wizard
To uninstall Mech-Eye SDK using the setup wizard, follow these steps:
-
Double-click Mech-Eye SDK Installer 2.4.0.exe to open the Mech-Eye SDK setup wizard.
-
In the Maintain window, click Uninstall.
-
In the Uninstall window, click either Keep user configuration files or Do not keep user configuration files.
-
Wait for the uninstallation to complete. After the software is uninstalled, in the Finish window, click Finish to exit the setup wizard.
Uninstall Using the Control Panel
To uninstall Mech-Eye SDK using the Control Panel, follow these steps:
-
Open the Control Panel on the computer.
-
Choose .
-
Right-click Mech-Eye SDK2.4.0, and then select Uninstall. The Mech-Eye SDK setup wizard will be opened.
-
In the Maintain window, click Uninstall.
-
In the Uninstall window, click either Keep user configuration files or Do not keep user configuration files.
-
Wait for the uninstallation to complete. After the software is uninstalled, in the Finish window, click Finish to exit the setup wizard.
Repair Mech-Eye SDK
If Mech-Eye SDK failed to work normally, you can repair it using the Mech-Eye SDK setup wizard.
To repair Mech-Eye SDK, follow these steps:
-
Double-click Mech-Eye SDK Installer 2.4.0.exe to open the Mech-Eye SDK setup wizard.
-
In the Maintain window, click Repair.
-
Wait for the repair to complete. After the software is repaired, in the Finish window, click Finish to exit the setup wizard.
Modify Installed Components
After installation, you can use the setup wizard to change the installed components of the software. To modify installed components, follow these steps:
-
Double-click Mech-Eye SDK Installer 2.4.0.exe to open the Mech-Eye SDK setup wizard.
-
In the Maintain window, click Modify.
-
In the Select Product window, select the products or components to install, or deselect the products or components to uninstall.
-
Install the software according to the prompts in the setup wizard.
-
After the software is installed, in the Finish window, click Finish to exit the setup wizard.
Troubleshoot Common Installation Problems
Failed to Start the Setup Wizard
Symptom:
After double-clicking on the installation package, the setup wizard could not be started properly or crashed.
Possible Cause:
There is not enough space available on the system drive.
Troubleshooting Procedure:
Check whether the available space on the system drive is larger than the size of the installer.
-
If the available space on the system drive is smaller than the size of the installer, delete unnecessary files to free up the space, and then reinstall. If the issue still exists, contact Mech-Mind Technical Support.
-
If there is enough space on the system drive, contact Mech-Mind Technical Support.
Installation Failed
Symptom:
An error message saying “Installation failed.” appeared in the Finish window during the installation.
Possible Causes:
-
Corrupted installer or missing files.
-
The current user does not have administrator access.
-
Another Wizard is performing the installation or the Windows system is being upgraded.
-
Other reasons.
Troubleshooting Procedure:
-
Obtain a new installer and check its integrity, and then try the installation again.
-
If the problem is resolved, the troubleshooting is completed.
-
Otherwise, proceed to step 2.
-
-
Right-click the installer and select Run as administrator to reinstall.
-
If the problem is resolved, the troubleshooting is completed.
-
Otherwise, proceed to Step 3.
-
-
Try the installation again after the installation of other software completes or after the Windows system upgrade completes.
-
If the problem is resolved, the troubleshooting is completed.
-
Otherwise, proceed to step 4.
-
-
Restart your computer and try the installation again.
-
If the problem is resolved, the troubleshooting is completed.
-
If the problem still exists, click the installation log link in the Finish window to collect installation logs and send them to Technical Support.
-