Example Design Software - 2.3 English

Video Processing Subsystem Product Guide (PG231)

Document ID
PG231
Release Date
2022-04-27
Version
2.3 English

The synthesizable example design requires both Vivado® and Xilinx® Vitis software platform.

The first step is to run synthesis, implementation and bitstream generation in Vivado. After all those steps are done, select File > Export > Export Hardware. In the window, select Include bitstream, select an export directory and click OK.

Perform the following to generate the elf file (executable and linkable file) from the Vitis software platform.

1.Open the Vitis software platform.

X-Ref Target - Figure 5-2

1.png

2.Go to File > New Application Project.

X-Ref Target - Figure 5-3

2.png

3.Select a platform to create the project.

X-Ref Target - Figure 5-4

3.png

4.Select the required xsa.

X-Ref Target - Figure 5-5

4.png

5.Click Next.

X-Ref Target - Figure 5-6

5.png

6.Name the application.

X-Ref Target - Figure 5-7

6.png

 

7.Select the processor and click Next.

X-Ref Target - Figure 5-8

7.png

 

8.Select the empty application.

X-Ref Target - Figure 5-9

8.png

9.Import the required files.

X-Ref Target - Figure 5-10

1_usefor_vpss_and_mix.png

X-Ref Target - Figure 5-11

2_usefor_vpss.png

10.Build the project.

X-Ref Target - Figure 5-12

10.png

11.For the elf file, check the debug folder.

X-Ref Target - Figure 5-13

11.png

 

Next, perform the following to run the application:

1.Connect a USB cable from the host PC to the USB JTAG port. Ensure the appropriate device drivers are installed.

2.Connect a second USB cable from the host PC to the USB UART port. Ensure that USB UART drivers are installed.

3.Connect the evaluation board to the power supply slot.

4.Switch on the board.

5.Start a terminal program (e.g., Hyper Terminal) on the host PC with the following settings for the standard COM port:

a.Baud Rate: 115200

b.Data Bits: 8

c.Parity: None

d.Stop Bits: 1

e.Flow Control: None

6.Right-click the xv_procss_example application in the project explorer window and click Build Project.

7.Right-click the xv_procss_example application and click Run As > Run Configurations.

Figure 5-14:      Running the Application

X-Ref Target - Figure 5-14

running_app.JPG

8.In the Run Configurations window, right-click Xilinx C/C++ application (System Debugger) and click New.

Figure 5-15:      Run Configurations Window

X-Ref Target - Figure 5-15

configure_options.JPG

9.Enable Program FPGA, if targeting ZCU102/ZCU104/ZCU106, ensure to enable Run psu_init.

Figure 5-16:      Run Options

X-Ref Target - Figure 5-16

run_cfg_window.JPG

10.Click Run to program the FPGA and launch application on the board.

Next, perform the following steps to run the software application:

 

IMPORTANT:   To do so, make sure that the hardware is powered on and a Digilent Cable or an USB Platform Cable is connected to the host PC. Also, ensure that a USB cable is connected to the UART port of the board.

1.Launch Vitis software platform.

2.Set workspace to vpss_example folder in prompted window. The Vitis project opens automatically. (If a welcome page shows up, close that page.)

3.Download the bitstream into the FPGA by selecting Xilinx Tools > Program FPGA. The Program FPGA dialog box opens.

4.Ensure that the Bitstream field shows the bitstream file generated by Tcl script, and then click Program.

Note:   The DONE LED on the board turns green if the programming is successful.

5.A terminal program (HyperTerminal or PuTTY) is needed for UART communication. Open the program, choose appropriate port, set baud rate to 115200 and establish Serial port connection.

6.Select and right-click the application vpss_example_design in Project_Explorer panel.

7.Select Run As > Launch on Hardware (GDB).

8.Select Binaries and Qualifier in window and click OK.

The example design test result are shown in terminal program.

For more information, visit https://www.xilinx.com/products/design-tools/vitis.html. 

When executed on the board, the example application determines the Video Processing Subsystem topology and sets the input and output stream configuration accordingly. The test pattern generator IP is used to generate the input stream. Video Lock Monitor IP then monitors the output of the subsystem (to vidout) to determine if lock is achieved and present the status (Pass/Fail) on the terminal.