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 ContainerThis 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™ CameraThis 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™ ProfilerThis 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 FastMappingThis 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.
- TurtlesimThis 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® oneAPIThis 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™ ToolkitThis 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 CPUThis 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 VPUThis 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 VPUThis 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* VideoThis 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* AudioThis 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 - DisplayThis 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 pluginThis 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:
- Select the configuration
- Click onNext, until you get to step 4. Check that Intel® Edge Software Device Qualification is checked.
- Click onNextandDownload.
- Follow the steps from Install Edge Insights for Autonomous Mobile Robots chapters:
- 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
- Change directory:cd $HOME/edge_software_device_qualification/Edge_Software_Device_Qualification_For_AMR_*/esdq
- Run Intel® ESDQ test and generate report:./esdq run -rThe 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
For issues, go to: General Troubleshooting for Robot Tutorials.
Support Forum
If you’re unable to resolve your issues, contact the Support Forum.