6.1. Edge AI Gallery - User Guide

6.1.1. Overview

The AM68A SK board has a QT based Out of Box application setup so that user can test the prepackaged models, with sample images, videos and optionally with a connected camera. The Demo also allows users to add their custom models, images, and videos to extend the functionality.

All of the necessary equipment requirement and instructions are provided here.

6.1.2. Hardware Prerequisites

• TI AM68A SK

• PC (Windows or Linux, to use serial terminal console)

• HDMI Monitor (to view the Demo on Display)

• IMX219 Camera

• USB Mouse

• SD card (minimum 16GB)

• Ethernet connection (if serial terminal console is not accessible)

6.1.3. Launching and Using the edge AI gallery

The edge AI gallery launches on Linux startup. Follow the below instructions to use it.

1. Connect the Display, IMX219 Camera, Mouse, Ethernet and Power on the board. The application will launch when the Device is fully booted.

2. Once started, You can click on one of the Image Classification, Object Detection or Semantic Segmentation to validate the models with a fixed GStreamer pipeline.

3. To switch to a new pipeline, click on the same button again to stop the currently running pipeline.

4. To create and run a custom pipeline, click on Custom button. You’ll be provided with a popup menu to choose the below options.

   • Input Type: Image, Video or Camera

   • Input: Image/Video file or Camera Device (For Image or Video files, the path displayed next to the dropdown heading is where you can add your custom files)

   • Model: Models available in the file system (The path displayed next to the dropdown heading is where you can add your custom models)

5. Select the 4 options as described above and click on Start to generate and start the pipeline.

   Note

   As the note suggests, it might take a while for custom pipeline to start.

6. Click on Custom button again to stop the custom pipeline.

7. For ease of use, the IP addr of the device is displayed at the bottom right when Network is connected.

   Note

   The IP addr is polled only for the first 100 seconds after the application has started.

8. To close the application and go to the Wallpaper screen, use the close button on the top right corner.

9. To add new images, videos and models, you should add them in the below directories respectively

   • Images - /opt/edgeai-test-data/images/

   • Videos - /opt/edgeai-test-data/videos/

   • Models - /opt/model_zoo/

10. To change the videos in the prebuilt pipelines used for Image Classification, Object Detection, Semantic Segmentation & Multi Channel, you can replace the video files oob-gui-video*.h264 under /opt/oob-demo-assets/.

11. To relaunch the application, you should run

/etc/init.d/edgeai-launcher.sh start

12. And to stop the application again, you should run

/etc/init.d/edgeai-launcher.sh stop

13. For more information on edge AI software stack, refer Edge AI Documentation

6.1.4. Building the edge AI gallery

The edge AI gallery application is enabled by default in yocto for AM68A Linux and RT-Linux.

The source code is available at edgeai-gui-app and can be recompiled with the following steps

1. To setup the environment, from the root of the SDK installation directory, source environment-setup script.

   $ source linux-devkit/environment-setup
   

2. Go to the root of edgeai-gui-app repository and run the following command to build the application.

   $ qmake; make
   

3. Copy the compiled binary to /usr/bin directory of the device

   $ scp edgeai-gui-app root@<ip-addr-of-device>:/usr/bin/