Follow the step-by-step instructions below to setup your Intel® Neural Compute Stick 2 (Intel® NCS 2) or the original Intel® Movidius™ NCS. Also, check out the getting started videos for your platform:
Start: Linux* Start: Raspbian* Start: Windows*
Step 1. Gather Your Equipment
Before you start, make sure you have the following:
- An x86-64 host computer with Windows 10® or Ubuntu* (16.04 or 18.04) for the Intel® Distribution of OpenVINO™ toolkit.
- Intel® Neural Compute Stick 2 (Intel® NCS 2). Buy Now
- An internet connection to download and install the Intel® Distribution of OpenVINO™ toolkit.
Note This article is based on the 2019 R1 release of the Intel® Distribution of OpenVINO™ toolkit.
Note To use a Raspberry Pi as the host for the Intel® NCS 2, it’s recommended that you still follow the getting started instructions on this page to install the full Intel® Distribution of the OpenVINO™ toolkit on one of the supported platforms (Windows, Linux*) and then install the Inference Engine on your Raspberry Pi and review the Raspberry Pi workflow.
Migrate your projects: The Intel® Distribution of OpenVINO™ toolkit also supports the original Intel® Movidius™ Neural Compute Stick (NCS). Existing Intel® Movidius™ Neural Compute SDK (NCSDK) projects can be transitioned to The Intel® Distribution of OpenVINO™ toolkit.
Step 2. Install the OpenVINO™ Toolkit
Download the appropriate version of the Intel® Distribution of the OpenVINO™ toolkit for your host computer (Windows or Linux.). This guide assumes the full package installation is downloaded. Then, follow the installation instructions for your OS and customize the installation as shown in the image below.
For Linux
Run the following commands:
cd ~/Downloads
tar xvf l_openvino_toolkit_<VERSION>.tgz
cd l_openvino_toolkit_<VERSION>
sudo -E ./install_openvino_dependencies.sh
./install_GUI.sh
For Windows
Double click the downloaded w_openvino_toolkit_<VERSION>.exe file.
Follow the on-screen instructions to continue the installation process and customize the installation as desired. Install any dependencies shown during the installation prior to continuing to step 3.
Return to this page and continue with Step 3 after successful installation to assure your installation is correct.
Step 3. Configure Neural Compute Stick USB Driver
Windows Users Can Skip to Step 4.
The USB driver on Linux must be configured for the Intel® Neural Compute Stick. To do this run the following commands in a terminal window:
source ~/intel/openvino/bin/setupvars.sh
cd ~/intel/openvino/install_dependencies
./install_NCS_udev_rules.sh
Step 4. Test the Installation
Plug in the Neural Compute Stick to a USB port on your computer.
Run the following commands for your OS in the terminal and look for the results in the image below.
Linux
cd ~/intel/openvino/deployment_tools/model_optimizer/install_prerequisites/
./install_prerequisites.sh
cd ~/intel/openvino/deployment_tools/demo
./demo_squeezenet_download_convert_run.sh -d MYRIAD
Windows
C:
cd C:\"Program Files (x86)"\IntelSWTools\openvino\deployment_tools\demo
.\demo_squeezenet_download_convert_run.bat –d MYRIAD
Look for results like this which indicate successful installation
Next Steps: The ncappzoo
The ncappzoo is an open source to github repository that contains numerous examples with a simple layout and easy to use Makefiles. This repository is tailored for the Intel® NCS 2 developer community and helps developers get started quickly by focusing on application code that use pretrained neural networks. Visit the repository's README file via your browser or jump in and clone it now with this command:
git clone http://github.com/movidius/ncappzoo
After you've cloned it you can navigate into any app directory (all in the ncappzoo/apps dir) from a terminal window and type:
make run
This is an easy way to explore the examples in the ncappzoo.
Other Examples
There are also other examples in Intel® Distribution of OpenVINO™ Toolkit that you can run. Here are a few sample commands and their output.
Traffic Camera (Object Detection)
Linux
cd ~/intel/openvino/deployment_tools/demo
./demo_security_barrier_camera.sh -d MYRIAD
Windows
C:
cd C:\"Program Files (x86)"\IntelSWTools\openvino\deployment_tools\demo
.\demo_security_barrier_camera.bat -d MYRIAD
This example runs multiple neural networks, such as vehicle attribute and license plate detection and recognition. The demo script runs a command with multiple options. To run the same program manually, enter these commands below in a terminal window or command prompt window.
Linux
source ~/intel/openvino/bin/setupvars.sh
cd ~/inference_engine_samples_build/intel64/Release
./security_barrier_camera_demo -i ~/intel/openvino/deployment_tools/demo/car_1.bmp -d MYRIAD -m ~/openvino_models/ir/FP16/Security/object_detection/barrier/0106/dldt/vehicle-license-plate-detection-barrier-0106-fp16.xml -d_va MYRIAD -m_va ~/openvino_models/ir/FP16/Security/object_attributes/vehicle/resnet10_update_1/dldt/vehicle-attributes-recognition-barrier-0039-fp16.xml -d_lpr MYRIAD -m_lpr ~/openvino_models/ir/FP16/Security/optical_character_recognition/license_plate/dldt/license-plate-recognition-barrier-0001-fp16.xml
Windows
C:
C:\"Program Files (x86)"\IntelSWTools\openvino\bin\setupvars.bat
cd %USERPROFILE%\Documents\Intel\OpenVINO\inference_engine_samples_build_2017\intel64\Release
.\security_barrier_camera_demo.exe -i "C:\Program Files (x86)\IntelSWTools\openvino\deployment_tools\demo\car_1.bmp" -d MYRIAD -m "%USERPROFILE%\Documents\Intel\OpenVINO\openvino_models\ir\FP16\Security\object_detection\barrier\0106\dldt\vehicle-license-plate-detection-barrier-0106-fp16.xml" -d_va MYRIAD -m_va "%USERPROFILE%\Documents\Intel\OpenVINO\openvino_models\ir\FP16\Security\object_attributes\vehicle\resnet10_update_1\dldt\vehicle-attributes-recognition-barrier-0039-fp16.xml" -d_lpr MYRIAD -m_lpr "%USERPROFILE%\Documents\Intel\OpenVINO\openvino_models\ir\FP16\Security\optical_character_recognition\license_plate\dldt\license-plate-recognition-barrier-0001-fp16.xml"
References
- Complete OpenVINO™ toolkit Installation Guides for Linux, Windows, and Raspbian
- The ncappzoo now supports the Intel® NCS 2 and the OpenVINO™ toolkit
- Other OpenVINO™ toolkit code samples
- OpenVINO™ toolkit Open Model Zoo
- Migrate NCSDK Applications to OpenVINO™ toolkit
- Optimize Networks for the Intel® Neural Compute Stick (Intel® NCS 2) Device
- Community Forum and Technical Support