Get Started Guide

  • 2022.1
  • 04/18/2022
  • Public Content
Contents

Intel® Edge Software Device Qualification (Intel® ESDQ) for Autonomous Mobile Robots

Overview

Intel® Edge Software Device Qualification (Intel® ESDQ) for Autonomous Mobile Robots (AMR) provides customers with the capability to run an Intel provided test suite at the target system, with the goal of enabling partners to determine their platform’s compatibility with the Edge Insights for Autonomous Mobile Robots (EI for AMR).
The target of this self certification suite is the AMR compute systems. These platforms are the brain of the Robot Kit. They are responsible to get input from sensors, analyze them, and give instructions to the motors and wheels to move the AMR.

How It Works

The EI for AMR Test Modules interacts with the Intel® ESDQ CLI through a common test module interface layer (TMI) which is part of the Intel® ESDQ binary. Intel® ESDQ generates a complete test report in HTML format, along with detailed logs packaged as one zip file, which you can manually choose to email to: Edge.Software.Partners@intel.com
Each test and its pass/fail criteria is described below. To jump to the installation process, go to Download and Install Intel® ESDQ for EI for AMR.
Intel® ESDQ for AMR contains the following test modules.
  • Docker Container
    This module verifies that the EI for AMR comes as a Docker container and it can run on the target platform.
    For more information, go to the Docker website.
    The test is considered Pass if:
    • The Docker container can be opened.
  • Intel® RealSense™ Camera
    This module verifies the capabilities of the Intel® RealSense™ technology on the target platform.
    For more information, go to the Intel® RealSense™ website.
    The tests within this module verify that the following features are installed properly on the target platform and that EI for AMR and the Intel® RealSense™ camera are functioning properly:
    • The camera is detected and is working.
    • Intel® RealSense™ SDK.
    The tests are considered Pass if:
    • The Intel® RealSense™ SDK 2.0 libraries are present in Docker container.
    • A simple C++ file can be compiled using g++ and -lrealsense2 flag.
    • Intel® RealSense™ Topics are listed and published.
    • The number of FPS (Frames Per Second) are as expected.
  • Intel® VTune™ Profiler
    This module will run the Intel® VTune™ Profiler on the target system.
    For more information, go to the Intel® VTune™ Profiler website.
    The test is considered Pass if:
    • VTune™ Profiler runs without errors.
    • VTune™ Profiler collects Platform information.
  • Rviz and FastMapping
    This module will run the Fast Mapping application (the Intel-optimized version of octomap) on the target system and will use Rviz to check if it works as expected.
    For more information, go to the Rviz wiki.
    The test is considered Pass if:
    • Fast Mapping is able to create a map out of a pre-recorded ros2 bag.
  • Turtlesim
    This module will run the Turtlesim ROS2 application on the target system and will check if it works as expected.
    For more information, go to the Turtlesim wiki.
    The test is considered Pass if:
    • Turtlesim opens and runs without error.
  • Intel® oneAPI
    This module verifies some basic capabilities of Intel® oneAPI on the target platform.
    For more information, go to the Intel® OneAPI website.
    The tests within this module verify that the following features are functioning properly on the target platform:
    • DPC++ compiler
    • CUDA to DPC++ converter
    This test is considered Pass if:
    • A simple C++ file can be compiled using the DPC++ compiled and it runs as expected.
    • CUDA can be installed.
    • A CUDA specific file can be converted to DPC++ and it runs as expected.
  • OpenVINO™ Toolkit
    This module verifies two core features of the OpenVINO™ Toolkit:
    • OpenVINO™ model optimizer
    • Object detection using TensorFlow*
    The test is considered Pass if:
    • The OpenVINO™ model optimizer is capable to transform a TensorFlow model to an Intermediate Representation (IR) of the network, which can be inferred with the Inference Engine.
  • Object Detection on CPU
    This module verifies object detection using OpenVINO™ on CPU.
    The test is considered Pass if:
    • The object is detected.
    If the test is failed, you can check the expected picture and the actual picture obtained by the test.
  • Object Detection on VPU
    This module verifies object detection using OpenVINO™ on VPU.
    The test is considered Pass if:
    • The object is detected.
    If the test is failed, you can check the expected picture and the actual picture obtained by the test.
  • Object Detection on Intel® Movidius™ Myriad™ X VPU
    This module verifies object detection using OpenVINO™ on Intel® Movidius™ Myriad™ X VPU.
    The test is considered Pass if:
    • The object is detected.
    If the test is failed, you can check the expected picture and the actual picture obtained by the test.
  • GStreamer* Video
    This module verifies if a GStreamer* Video Pipeline using GStreamer* Plugins runs on the target system.
    The test is considered Pass if:
    • The Video Pipeline was opened on the host without errors.
  • GStreamer* Audio
    This module verifies if a GStreamer* Audio Pipeline using GStreamer* Plugins runs on the target system.
    The test is considered Pass if:
    • The Audio Pipeline was opened on the host without errors.
  • GStreamer* Autovideosink Plugin - Display
    This module verifies if a stream from a camera compatible with libv4l2 can be opened and displayed using GStreamer*.
    The test is considered Pass if:
    • No Error messages are displayed while running the gst-launch command.
    This test may FAIL, or it may be skipped if the target system does not have a Web Camera connected.
  • GStreamer* Intel® RealSense™ Video source plugin
    This module verifies if a GStreamer* Video Pipeline using the Intel® RealSense™ Plugin runs on the target system.
    The test is considered Pass if:
    • No Error messages are displayed while running the gst-launch command.
    This test may FAIL, or it may be skipped if the target system does not have a RealSense Camera connected.

Get Started

This step-by-step guide takes you through installing the Intel® ESDQ CLI tool, which is installed as part of the EI for AMR. Refer to the How It Works section before you get started with the installation. To use these instructions, you must download the Edge Insights for Autonomous Mobile Robots package. You can download the default packages or you can customize the package download depending upon your needs.

Download and Install Intel® ESDQ for EI for AMR

ESDQ for AMR comes bundled with the AMR robot solutions.
To download the ESDQ for AMR:
  1. Select the configuration



    • Click on
      Next
      , until you get to step 4. Check that Intel® Edge Software Device Qualification is checked.



    • Click on
      Next
      and
      Download
      .
    • Step 6: Extract the Edge Insights for Autonomous Mobile Robots Software
    • Step 7: Install the Edge Insights for Autonomous Mobile Robots Software

Run the Application

  1. Change directory:
    cd $HOME/edge_software_device_qualification/Edge_Software_Device_Qualification_For_AMR_*/esdq
  2. Run Intel® ESDQ test and generate report:
    ./esdq run -r
    The test report should look like the following example.
    The results shown below are for illustration only.
    The OpenVino Object Detection Myriad Test Failure above is shown for demonstration purposes only. The test is expected to pass.

Send Results to Intel

Once all the automated and manual tests are executed successfully, you can submit your test results and get your devices listed on the Intel® Edge Software Recommended Hardware site.
Send the zip file that is created after running ESDQ tests to: Edge.Software.Partners@intel.com.
For example, after one of our local runs the following file was generated:
esdqReport_2022-03-09_13:22:28.zip

Troubleshooting

Support Forum

If you’re unable to resolve your issues, contact the Support Forum.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.