Difference between revisions of "AIMLinux/AddOn/Edge AI"

From ESS-WIKI
Jump to: navigation, search
Line 228: Line 228:
  
 
===== <span style="color:#0070c0">How to Run Samples</span> =====
 
===== <span style="color:#0070c0">How to Run Samples</span> =====
 +
 
1. Start the manager tool:
 
1. Start the manager tool:
 +
 
  $ pyeiq
 
  $ pyeiq
 +
 
2. The above command returns the PyeIQ manager tool options:
 
2. The above command returns the PyeIQ manager tool options:
  
 +
{| border="1" cellspacing="1" cellpadding="1" style="width:500px;"
 +
|-
 +
| '''Manager Tool Command'''<br/>
 +
| '''Description'''<br/>
 +
| '''Example'''<br/>
 +
|-
 +
| pyeiq --list-apps<br/>
 +
| List the available applications.<br/>
 +
| <br/>
 +
|-
 +
| pyeiq --list-demos<br/>
 +
| List the available demos.<br/>
 +
| <br/>
 +
|-
 +
| pyeiq --run &lt;app_name/demo_name&gt;<br/>
 +
| Run the application or demo.<br/>
 +
| # pyeiq --run object_detection_tflite<br/>
 +
|-
 +
| pyeiq --info &lt;app_name/demo_name&gt;<br/>
 +
| Application or demo short description and usage.<br/>
 +
| <br/>
 +
|-
 +
| pyeiq --clear-cache<br/>
 +
| Clear cached media generated by demos.<br/>
 +
| # pyeiq --info object_detection_dnn<br/>
 +
|}
  
 
===== <span style="color:#0070c0">Run Applications and Demos</span> =====
 
===== <span style="color:#0070c0">Run Applications and Demos</span> =====
  
 
==  ==
 
==  ==

Revision as of 08:36, 6 October 2020

Applications

Face Recognition

FaceView

Advantech FaceView application powered by CyberLink's FaceMe®, an industry-leading facial recognition engine, Advantech’s FaceView application provides precise and scalable real-time facial recognition for various AIoT applications in the retail, hospitality, and public safety fields.

Supported Platforms

  • nVidia TX2: EPC-R7000

Installation

0. Before we start for FaceView, please make sure SDK components are installed well on your TX2 device.

1. Get the program file by contact with Advantech, e.g. FaceView_1.0.2.0522_aarch64.run

2. Put the self-extractable file into your device and execute it. Note: Make sure the network is connected!

$ chmod +x FaceView_1.0.2.0522_aarch64.run
$ ./FaceView_1.0.2.0522_aarch64.run

Verifying archive integrity...  100%   All good.
Uncompressing FaceView  100%  
installing FaceView application
Press the ENTER key to continue.
************************************************************************
 Installing Package...
************************************************************************

...

Preparing to unpack FaceView_1.0.2.0522_aarch64.deb ...
Unpacking faceview (1.0.2.0522) ...
Setting up faceview (1.0.2.0522) ...
************************************************************************
 Done!
************************************************************************

3. Once it's done, you can find the FaceView application in /usr/local/FaceView/ folder.

4. If you want to uninstall FaceView application, use the command below.

$ sudo dpkg --remove FaceView

Setup Camera

We support two kinds of camera on EPC-R7000. One is USB webcam and the other is IP camera.

[USB Webcam]

It's easy to setup webcam by connecting USB with TX2 device.

The two camera products below are verified, but it's OK to use other products which support 1920x1080 or 1280x720 resolution.

  • Microsoft LifeCam HD-3000
  • Logitech BRIO V-U0040

[IP Camera]

EPC-R7000 supports PoE function, so you can run FaceView with IP camera for more flexible camera configurations.

The IP camera below is verified. We will take it as an example to set up.

  • Vivotek_IB9360H

To configure IP camera for FaceView, we have to route RTSP streaming to video device.

1. Connect IP camera with TX2 device via Ethernet cable.

2. Assign corresponding IP address for the PoE port, e.g. 169.254.111.1/16.

3. Install V4L2Loopback utility & drivers.

$ sudo apt-get install v4l2loopback-utils

4. Route RTSP streaming to video device.

$ sudo modprobe v4l2loopback
$ export RTSP_PATH="rtsp://viewer:inventec2017@169.254.6.42:5554/live.sdp"
$ gst-launch-1.0 rtspsrc location="$RTSP_PATH" latency=300 ! rtph264depay ! h264parse ! omxh264dec ! videoconvert ! tee ! v4l2sink device=/dev/video0

Run Application

To execute FaceView application, navigate to /usr/local/FaceView/ folder and double-click FaceView icon, or run the application by command mode.

$ cd /usr/local/FaceView/
$ ./FaceView

Then, you will be asked to input license key. Note: Please make sure your network connection is OK to activate the license successfully.

Input License

If the key is valid, you are able to see camera preview screen from the application.

FaceView Screen

For details of operations, please refer to the FaceView user guide.

Set Up Build Environment

To develop QT application with FaceMe SDK, you have to install the packages listed below.

1. Install FaceMe SDK, e.g.FaceMe_SDK_Ubuntu18_ARM64_3.18.0.run

$ chmod +x FaceMe_SDK_Ubuntu18_ARM64_3.18.0.run
$ ./FaceMe_SDK_Ubuntu18_ARM64_3.18.0.run
...
What path do you want to install? (Press ENTER to use default)[/home/advrisc]
Which detection models do you want to install? ML, and (Press ENTER to use default, DNN DNN-X)[DNN DNN-X]
Which extraction models do you want to install? (Press ENTER to use default, H1 H2 H3 VH UH UH3)[H1 H3 VH UH3]
Do you want to install Demo System? (Press ENTER to use default, yes(y)/no(n))[yes]
Do you want to install Sample code? (Press ENTER to use default, yes(y)/no(n))[yes]
Install SDK Path: /home/advrisc/FaceMeSDK
Install Detection Model: DNN DNN-X
Install Extraction Model: H1 H3 VH UH3
Install GPU support: no
Install DemoSystem: yes
Install Sample Code: yes
Are you sure? (Press ENTER to use default, yes(y)/no(n))[yes]

2. Install pre-built Qt 5.14.2 binaries

$ tar zxvf Qt-5.14.2-Ubuntu18.04-ARM64.tar.gz
$ cd Qt-5.14.2-U18.04-ARM64
$ sudo cp -a * /

$ sudo vim ~/.profile
PATH="/usr/local/Qt-5.14.2/bin:$PATH"
$ source ~/.profile

3. Install QT creator

$ sudo apt-get install qtcreator

4. Install pre-built OpenCV 3.4.2 with CUDA & Jpeg1.5.3 support

$ tar zxvf OpenCV-3.4.2-aarch64-U18.04-JPEG1.5.3.tar.gz
$ cd OpenCV-3.4.2-aarch64
$ sudo cp -a * /usr/local/


Traffic Analysis

IVS

IVS service is a web application which provides intelligent video analysis for traffic issues, such as vehicle detection, license recognition, car parking & traffic counting.

Supported Platforms

  • nVidia TX2: EPC-R7000

Run Application

You can connect the host PC with EPC-R7000 with microUSB cable (RNDIS) or Ethernet. Then, open browser with specific URL to access IVS service.

  • RNDIS: 192.168.55.1:5000/admin
  • Ethernet: <your device IP address>:5000/admin

After login with correct account/password, you can configure the monitor regions as your requirements.

Ivs-monitor.png

For more details, please refer to the IVS user guide document.

[Traffic]

Ivs-traffic.png

[License Recognition]

Ivs-lp.jpg

[People Counting]

Ivs-people.jpg


Inference Engines

Platform

nVidia TX2

NXP i.MX series

The i.MX 8M Plus family focuses on neural processing unit (NPU) and vision system, advance multimedia, andindustrial automation with high reliability.

  • The Neural Processing Unit (NPU) operating at up to 2.3 TOPS
    • Keyword detect, noise reduction, beamforming
    • Speech recognition (i.e. Deep Speech 2)
    • Image recognition (i.e. ResNet-50)

eIQ - A Python Framework for eIQ on i.MX Processors

PyeIQ is written on top of eIQ™ ML Software Development Environment and provides a set of Python classes

allowing the user to run Machine Learning applications in a simplified and efficiently way without spending time on

cross-compilations, deployments or reading extensive guides.

Installation
  • Method 1: Use pip3 tool to install the package located at PyPI repository:
$ pip3 install eiq

Collecting eiq
 Downloading [https://files.pythonhosted.org/packages/10/54/7a78fca1ce02586a91c88ced1c70acb16ca095779e5c6c8bdd379cd43077/eiq-2.1.0.tar.gz]
Installing collected packages: eiq
 Running setup.py install for eiq ... done
Successfully installed eiq-2.1.0
  • Method 2: Get the latest tarball  Download files  and copy it to the board:
$ pip3 install <tarball>

Other eiq versions:

eiq-1.0.0.tar.gz

eiq-2.0.0.tar.gz

eiq-2.1.0.tar.gz

How to Run Samples

1. Start the manager tool:

$ pyeiq

2. The above command returns the PyeIQ manager tool options:

Manager Tool Command
Description
Example
pyeiq --list-apps
List the available applications.

pyeiq --list-demos
List the available demos.

pyeiq --run <app_name/demo_name>
Run the application or demo.
# pyeiq --run object_detection_tflite
pyeiq --info <app_name/demo_name>
Application or demo short description and usage.

pyeiq --clear-cache
Clear cached media generated by demos.
# pyeiq --info object_detection_dnn
Run Applications and Demos