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

4 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.

Resolution

Scale

1280 × 800 (16:10)

100%

1920 × 1080 (16:9)

100% or 125%

2560 × 1440 (16:9)

125% or 150%

3840 × 2160 (16:9)

150% or 175%

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:

  1. Copy the installation package to a specified directory on the device that will run the software, such as D:/.

  2. Decompress the installation package. After decompression, you will obtain the software installer (Mech-Eye SDK Installer 2.3.2.exe).

  3. Open 7-Zip, and use the address bar to navigate to the directory where the software installation package is located.

  4. Select the software installation package, and in the context menu, select File  CRC  CRC-32 to calculate the CRC-32 value.

  5. Check the calculated CRC-32 value against the one on the download page. The two values should be identical.

  6. 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.


If you are using Mech-Eye SDK for the first time, refer to Install Mech-Eye SDK to complete the software installation.

If you have already installed Mech-Eye SDK, refer to Upgrade Mech-Eye SDK to upgrade the software to the latest version.

Install Mech-Eye SDK

To install Mech-Eye SDK, follow these steps:

  1. Double-click the downloaded installer to open the Mech-Eye SDK setup wizard.

  2. In the Welcome window, browse the software information and click Next.

  3. 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.

  4. 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.

  5. In the Set Path window, change the installation path as required, and then click Next.

    Default installation path: C:/Mech-Mind/Mech-Eye SDK-x.x.x.

  6. In the Confirm window, confirm that the installation path is correct and then click Install.

  7. In the Install window, wait for the installation to complete.

  8. 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

  • If you have Mech-Eye SDK above 1.6.1 installed, use the later version of setup wizard to upgrade.

  • If you have Mech-Eye SDK 1.6.1 or below installed, please uninstall the lower version and then install the new version.

To upgrade Mech-Eye SDK, follow these steps:

  1. Double-click Mech-Eye SDK Installer x.x.x.exe to open the Mech-Eye SDK setup wizard.

  2. In the Upgrade window, click either Upgrade and keep history versions or Upgrade and delete history versions.

  3. Upgrade the software according to the prompts in the setup wizard.

  4. After the software is upgraded, in the Finish window, click Finish to exit the setup wizard.

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:

  1. Double-click Mech-Eye SDK Installer x.x.x.exe to open the Mech-Eye SDK setup wizard.

  2. In the Maintain window, click Uninstall.

  3. In the Uninstall window, click either Keep user configuration files or Do not keep user configuration files.

  4. 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:

  1. Open the Control Panel on the computer.

  2. Choose Program  Uninstall or change a program.

  3. Right-click Mech-Eye SDK, and then select Uninstall. The Mech-Eye SDK setup wizard will be opened.

  4. In the Maintain window, click Uninstall.

  5. In the Uninstall window, click either Keep user configuration files or Do not keep user configuration files.

  6. 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

Only Mech-Eye SDK setup wizard 2.0.0 and above supports this function.

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:

  1. Double-click Mech-Eye SDK Installer x.x.x.exe to open the Mech-Eye SDK setup wizard.

  2. In the Maintain window, click Repair.

  3. 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

Only Mech-Eye SDK setup wizard 2.0.0 and above supports this function.

After installation, you can use the setup wizard to change the installed components of the software. To modify installed components, follow these steps:

  1. Double-click Mech-Eye SDK Installer x.x.x.exe to open the Mech-Eye SDK setup wizard.

  2. In the Maintain window, click Modify.

  3. In the Select Product window, select the products or components to install, or deselect the products or components to uninstall.

  4. Install the software according to the prompts in the setup wizard.

  5. After the software is installed, in the Finish window, click Finish to exit the setup wizard.

Software License Agreement

For the license agreement of Mech-Eye SDK, refer to End-User License Agreement.

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:

  1. 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.

  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.

  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.

  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.