Zybo Z7 -20 Pcam 5C Demo
Note: The demo contained in this repository has been moved and this repository is no longer being actively maintained. Check out the Zybo Z7-20 Pcam 5C Demo page on Digilent Reference for more information.
Description
The Zybo Z7 Pcam 5C project demonstrates the usage of the Pcam 5C as a video source by forwarding the streaming image data out to the HDMI TX port. Video data streams in through the Pcam port and out through the HDMI source (TX) port. A UART interface is available to configure the image sensor and additional post processing IP Cores.
First and foremost
- The Vivado projects are version-specific. Source files are not backward compatible and not automatically forward compatible. Release tags specify the targetted Vivado version. There is only one version targetted per year, as chosen by Digilent. Non-tagged commits on the master branch are either at the last tagged version or the next targeted version. This is not ideal and might be changed in the future adopting a better flow.
- Our projects use submodules to bring in libraries. Use --recursive when cloning or git submodule init, if cloned already non-recursively.
Requirements
Demo Setup
- Download the most recent release ZIP archive ("Zybo-Z7-20-Pcam-5C-2019.1-*.zip") from the repo's releases page.
- Extract the downloaded ZIP.
- Open the XPR project file, found at \<archive extracted location>/vivado_proj/Zybo-Z7-20-pcam-5c.xpr, included in the extracted release archive in Vivado 2019.1.
- In the toolbar at the top of the Vivado window, select File -> Export -> Export Hardware. Select \<Local to Project> as the Exported Location and make sure that the Include bitstream box is checked, then click OK.
- In the toolbar at the top of the Vivado window, select File -> Launch SDK. Select \<Local to Project> as both the workspace location and exported location, then click OK.
- With Vivado SDK opened, wait for the hardware platform exported by Vivado to be imported.
- In the toolbar at the top of the SDK window, select File -> New -> Application Project.
- Fill out the fields in the first page of the New Application Project Wizard as in the table below. Most of the listed values will be the wizard's defaults, but are included in the table for completeness.
Setting |
Value |
Project Name |
pcam_vdma_hdmi |
Use default location |
Checked box |
OS Platform |
standalone |
Target Hardware: Hardware Platform |
system_wrapper_hw_platform_0 |
Target Hardware: Processor |
(default) |
Target Software: Language |
C++ |
Target Software: Board Support Package |
Create New (pcam_vdma_hdmi_bsp) |
- Click Next.
- From the list of template applications, select "Empty Application", then click Finish.
- In the Project Explorer pane to the left of the SDK window, expand the new application project (named "pcam_vdma_hdmi").
- Right click on the "src" subdirectory of the application project and select Import.
- In the "Select an import wizard" pane of the window that pops up, expand General and select File System. Then click Next.
- Fill out the fields of the "File system" screen as in the table below. Most of the listed values will be the defaults, but are included in the table for completeness.
Setting |
Value |
From directory |
\<archive extracted location>/sdk_appsrc/pcam_vdma_hdmi |
Files to import pane: pcam_vdmi_hdmi |
Checked box |
Into folder |
pcam_vdma_hdmi/src |
Options: Overwrite existing resources without warning |
Checked box |
Options: Create top-level folder |
Unchecked box |
- Click Finish.
- Open a serial terminal application (such as TeraTerm) and connect it to the Zybo Z7's serial port, using a baud rate of 115200.
- In the toolbar at the top of the SDK window, select Xilinx -> Program FPGA. Leave all fields as their defaults and click "Program".
- In the Project Explorer pane, right click on the "pcam_vdma_hdmi" application project and select "Run As -> Launch on Hardware (System Debugger)".
- The application will now be running on the Zybo Z7. It can be interacted with as described in the first section of this README.
- If needed, create a first-stage bootloader (FSBL) using File -> New -> Application Project and choosing template Zynq FSBL.
Next Steps
This demo can be used as a basis for other projects by modifying the hardware platform in the Vivado project's block design or by modifying the SDK application project.
Check out the wiki page of the demo here.
For technical support or questions, please post on the Digilent Forum.
Additional Notes
Open the tcl file, found at \</src/other/sim_sources_workaround.tcl for updating all the library fields needed for running the simulation in "Edit IP packager".
For more information on how this project is version controlled, refer to the digilent-vivado-scripts repo.