HERO Doucment Demonstration Manual English

From Terasic Wiki

(Difference between revisions)
Jump to: navigation, search
Line 11: Line 11:
This document describes how to run a HERO platform built in sample, the sample will be a model using googlenet (SSD - GoogleNetV2) object recognition, deployed through HERO platform. The image source from USB camera connected to the platform of HERO, HERO platform will be the input image for object recognition, and real-time display the results on the application. The image on the label will be displayed in the name of the object recognition.
This document describes how to run a HERO platform built in sample, the sample will be a model using googlenet (SSD - GoogleNetV2) object recognition, deployed through HERO platform. The image source from USB camera connected to the platform of HERO, HERO platform will be the input image for object recognition, and real-time display the results on the application. The image on the label will be displayed in the name of the object recognition.
-
[[File:Hero-Figure 1-1.jpg]]
+
[[File:Hero-Figure 1-1.png]]
Figure 1-1 the image of the object recognition  
Figure 1-1 the image of the object recognition  
Line 34: Line 34:
* USB HUB  (It is not neccessry. As shown in figure 1-3, there are only two USB ports in Host PC interface on HERO platform, but as shown in figure 1-4, this DEMO needs to use many USB devices, although not all of them need to be used at the same time, but a USB HUB can avoid repeatedly unplugging USB devices)
* USB HUB  (It is not neccessry. As shown in figure 1-3, there are only two USB ports in Host PC interface on HERO platform, but as shown in figure 1-4, this DEMO needs to use many USB devices, although not all of them need to be used at the same time, but a USB HUB can avoid repeatedly unplugging USB devices)
-
[[File:Hero-Figure1-2.jpg]]
+
[[File:Hero-Figure1-2.png]]
Figure 1-2  USB Webcam
Figure 1-2  USB Webcam
-
[[File:Hero-Figure1-3.jpg]]
+
[[File:Hero-Figure1-3.png]]
Figure 1-3  USB ports in Host PC interface on HERO platform  
Figure 1-3  USB ports in Host PC interface on HERO platform  
   
   
-
[[File:Hero-Figure1-4.jpg]]
+
[[File:Hero-Figure1-4.png]]
Figure 1-4 Status of the USB connections in HERO Host PC
Figure 1-4 Status of the USB connections in HERO Host PC
Line 58: Line 58:
2.Connect the FPGA accelerated USB Blaster II Port to the HERO's USB Port by using the Mini USB cable (see figure 1-5).
2.Connect the FPGA accelerated USB Blaster II Port to the HERO's USB Port by using the Mini USB cable (see figure 1-5).
-
[[File:Hero-Figure1-5.jpg]]
+
[[File:Hero-Figure1-5.png]]
Figure 1-5  USB Blaster connection
Figure 1-5  USB Blaster connection
Line 65: Line 65:
4.Turn on the FPGA power switch.
4.Turn on the FPGA power switch.
-
[[File:Hero-Figure1-6.jpg]]
+
[[File:Hero-Figure1-6.png]]
Figure 1-6 Turn on the HERO platform power switch
Figure 1-6 Turn on the HERO platform power switch
Line 72: Line 72:
5. Open the Host PC motherboard power.
5. Open the Host PC motherboard power.
-
[[File:Hero-Figure1-7.jpg]]
+
[[File:Hero-Figure1-7.png]]
  Figure 1-7 Open the Host PC motherboard power
  Figure 1-7 Open the Host PC motherboard power
Line 79: Line 79:
7. When starting up completed, using a U-disk to copy the '''OpenVINO_Demo.tar.gz''' and paste it to the desktop, unzip the file.  
7. When starting up completed, using a U-disk to copy the '''OpenVINO_Demo.tar.gz''' and paste it to the desktop, unzip the file.  
-
[[File:Hero-Figure1-8.jpg]]
+
[[File:Hero-Figure1-8.png]]
Figure 1-8 Paste the Demo script onto the desktop and unzip it
Figure 1-8 Paste the Demo script onto the desktop and unzip it
Line 85: Line 85:
8.The unzipped directory contains two script files. '''Download_bitstream.sh''' is the configuration file for the FPGA development kit.''' Openvino_fpga.sh''' is the script file to execute this example.
8.The unzipped directory contains two script files. '''Download_bitstream.sh''' is the configuration file for the FPGA development kit.''' Openvino_fpga.sh''' is the script file to execute this example.
-
[[File:Hero-Figure1-9.jpg]]
+
[[File:Hero-Figure1-9.png]]
Figure 1-9 Demo Scripts
Figure 1-9 Demo Scripts
Line 91: Line 91:
The project described in this chapter has been written to the hard disk as factory setting, and it is located in the path '''/home/data/hero-demo/'''. Users who are interested it can enter this path for the details.
The project described in this chapter has been written to the hard disk as factory setting, and it is located in the path '''/home/data/hero-demo/'''. Users who are interested it can enter this path for the details.
-
[[File:Hero-Figure1-10.jpg]]
+
[[File:Hero-Figure1-10.png]]
Figure 1-10 Demo path
Figure 1-10 Demo path
Line 97: Line 97:
9. Open the Terminal to access the upzip directory (Path: ~/Desktop/OpenVINO_Demo).
9. Open the Terminal to access the upzip directory (Path: ~/Desktop/OpenVINO_Demo).
-
[[File:Hero-Figure1-11.jpg]]
+
[[File:Hero-Figure1-11.png]]
Figure 1-11 Script Path
Figure 1-11 Script Path
Line 104: Line 104:
10.Enter the command:''' source download_bitstream.sh''' in the terminal, and the script will download the FPGA configuration file into the FPGA accelerator in the HERO platform.(Make sure that the Mini USB cable is connected as described in step 2 before downloading).
10.Enter the command:''' source download_bitstream.sh''' in the terminal, and the script will download the FPGA configuration file into the FPGA accelerator in the HERO platform.(Make sure that the Mini USB cable is connected as described in step 2 before downloading).
-
[[File:Hero-Figure1-12.jpg]]
+
[[File:Hero-Figure1-12.png]]
Figure 1-12 Execute the FPGA configuration script  
Figure 1-12 Execute the FPGA configuration script  
Line 110: Line 110:
See below Figure 1-13 for the downloading completed.
See below Figure 1-13 for the downloading completed.
-
[[File:Hero-Figure1-13.jpg]]
+
[[File:Hero-Figure1-13.png]]
Figure 1-13 FPGA configuration successfully
Figure 1-13 FPGA configuration successfully
Line 116: Line 116:
11. Continue to enter the command''' ./OpenVINO_FPGA.sh'''. It will to execute the demo script. (Please confirm that the usb camera has been connected correctly with the HERO before execution).
11. Continue to enter the command''' ./OpenVINO_FPGA.sh'''. It will to execute the demo script. (Please confirm that the usb camera has been connected correctly with the HERO before execution).
-
[[File:Hero-Figure1-14.jpg]]
+
[[File:Hero-Figure1-14.png]]
Figure 1-14 Execute the Demo script  
Figure 1-14 Execute the Demo script  
Line 122: Line 122:
12. When the DEMO is running, you can see an image window that shows a real-time image captured by the USB camera with the current speed of the FPS on running the DEMO.
12. When the DEMO is running, you can see an image window that shows a real-time image captured by the USB camera with the current speed of the FPS on running the DEMO.
-
[[File:Hero-Figure1-15.jpg]]
+
[[File:Hero-Figure1-15.png]]
Figure 1-15 The output result on the display window
Figure 1-15 The output result on the display window
Line 129: Line 129:
Users can show the photos of cars or birds in front of camera. The system will immediately box out the specific objects and use label to identify object names, as shown in Figure. 1-16 and Figure. 1-17
Users can show the photos of cars or birds in front of camera. The system will immediately box out the specific objects and use label to identify object names, as shown in Figure. 1-16 and Figure. 1-17
-
[[File:Hero-Figure1-16.jpg]]
+
[[File:Hero-Figure1-16.png]]
Figure 1-16 Identify the bird  
Figure 1-16 Identify the bird  
-
[[File:Hero-Figure1-17.jpg]]
+
[[File:Hero-Figure1-17.png]]
Figure 1-17 Identify the car
Figure 1-17 Identify the car
10. If close the demo, enter CTRL+C on the Terminal.
10. If close the demo, enter CTRL+C on the Terminal.

Revision as of 13:43, 26 September 2018

1 . demo介紹

2 . demo需求

3 . demo 步驟

4 . demo說明

1 . Indrodution

This document describes how to run a HERO platform built in sample, the sample will be a model using googlenet (SSD - GoogleNetV2) object recognition, deployed through HERO platform. The image source from USB camera connected to the platform of HERO, HERO platform will be the input image for object recognition, and real-time display the results on the application. The image on the label will be displayed in the name of the object recognition.

Hero-Figure 1-1.png

Figure 1-1 the image of the object recognition


2 . Equipment Requirements

Operating the example in this chapter, the equipments and Settings are required as below:

  • Hardware
  • HERO Platform
  • Mini USB Cable x1 (For FPGA configuration)
  • USB webcam x1 (See Figure 1-2, for recognizing the images immediately)
  • USB Mouse & Keyboard x1
  • HDMI Monitor
  • USB HUB (It is not neccessry. As shown in figure 1-3, there are only two USB ports in Host PC interface on HERO platform, but as shown in figure 1-4, this DEMO needs to use many USB devices, although not all of them need to be used at the same time, but a USB HUB can avoid repeatedly unplugging USB devices)

Hero-Figure1-2.png

Figure 1-2 USB Webcam

Hero-Figure1-3.png

Figure 1-3 USB ports in Host PC interface on HERO platform

Hero-Figure1-4.png

Figure 1-4 Status of the USB connections in HERO Host PC

  • Software

OpenVINO_Demo.tar.gz : The zip file for the example script. The user can download this file and copy it to the operating system desktop of the HERO platform under the link below.

Download link: http://mail.terasic.com.tw/~johnny/release/hero/OpenVINO_Demo.tar.gz[1]

3.Operating Steps

1.Follow steps 1 to 3 in the quick start guide to connect the HERO platform with a USB keyboard mouse, an HDMI display, and the 12V DC power supply.

2.Connect the FPGA accelerated USB Blaster II Port to the HERO's USB Port by using the Mini USB cable (see figure 1-5).

Hero-Figure1-5.png Figure 1-5 USB Blaster connection

3.Connect the USB webcam to the USB interface on the PC of HERO platform.

4.Turn on the FPGA power switch.

Hero-Figure1-6.png

Figure 1-6 Turn on the HERO platform power switch


5. Open the Host PC motherboard power.

Hero-Figure1-7.png

Figure 1-7 Open the Host PC motherboard power

6. Access the Ubuntu login, enter Intel123 as password.

7. When starting up completed, using a U-disk to copy the OpenVINO_Demo.tar.gz and paste it to the desktop, unzip the file.

Hero-Figure1-8.png

Figure 1-8 Paste the Demo script onto the desktop and unzip it

8.The unzipped directory contains two script files. Download_bitstream.sh is the configuration file for the FPGA development kit. Openvino_fpga.sh is the script file to execute this example.

Hero-Figure1-9.png

Figure 1-9 Demo Scripts

The project described in this chapter has been written to the hard disk as factory setting, and it is located in the path /home/data/hero-demo/. Users who are interested it can enter this path for the details.

Hero-Figure1-10.png

Figure 1-10 Demo path

9. Open the Terminal to access the upzip directory (Path: ~/Desktop/OpenVINO_Demo).

Hero-Figure1-11.png

Figure 1-11 Script Path


10.Enter the command: source download_bitstream.sh in the terminal, and the script will download the FPGA configuration file into the FPGA accelerator in the HERO platform.(Make sure that the Mini USB cable is connected as described in step 2 before downloading).

Hero-Figure1-12.png

Figure 1-12 Execute the FPGA configuration script

See below Figure 1-13 for the downloading completed.

Hero-Figure1-13.png

Figure 1-13 FPGA configuration successfully

11. Continue to enter the command ./OpenVINO_FPGA.sh. It will to execute the demo script. (Please confirm that the usb camera has been connected correctly with the HERO before execution).

Hero-Figure1-14.png

Figure 1-14 Execute the Demo script

12. When the DEMO is running, you can see an image window that shows a real-time image captured by the USB camera with the current speed of the FPS on running the DEMO.

Hero-Figure1-15.png

Figure 1-15 The output result on the display window


Users can show the photos of cars or birds in front of camera. The system will immediately box out the specific objects and use label to identify object names, as shown in Figure. 1-16 and Figure. 1-17

Hero-Figure1-16.png

Figure 1-16 Identify the bird


Hero-Figure1-17.png

Figure 1-17 Identify the car

10. If close the demo, enter CTRL+C on the Terminal.

Personal tools