AIMLinux/AddOn/Edge AI
Contents
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.
If the key is valid, you are able to see camera preview screen from the application.
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.
For more details, please refer to the IVS user guide document.
[Traffic]
[License Recognition]
[People Counting]
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:
How to Run Samples
PyeIQ Manager Tool
- Start the manager tool:
<code># pyeiq
- 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 |