Python Productivity for ZYNQ
Switch branches/tags
Clone or download
Pull request Compare This branch is 28 commits ahead, 303 commits behind Xilinx:master.

README.md

alt tag


This fork of the open-source project PYNQ from Xilinx offers support for MicroZed boards (both versions, Zynq 7Z010 and 7Z020) from Avnet. All initial modifications made here are strongly based on Peter Odgens kind hints on the PYNQ google groups and Johannes Vanoverscheides fork. This work is used for further development on the open-source project FUSION project.

Feel free to experiment on your Microzed board:

  • either download the precompiled image here: version Zynq 7Z010 or version Zynq 7Z020
  • or, if desired, compile your own image following the instructions available in the PYNQ documentation (Do not forget to set the target to the desired board, for instance make REALEASE=MicroZed7020-Wily)

Initially the notebooks and overlays for the Zynq-Z1 are installed. These do not work for the Microzed. To install the modded notebooks and overlays of this fork open a terminal from your board and first remove all remains of the Pynq-Z1 board specific notebooks (note that the jupyter_notebooks must exist, otherwise setup.py will fail):

sudo rm /home/xilinx/jupyter_notebooks/* -r

This is necessary to prevent parts of the old overlays to remain in your installation. Then you can install the board specific overlays using:

sudo pip3.6 install --upgrade git+https://github.com/ticktronaut/PYNQ.git

Use the information on how to connect to Jupyter Notebooks of the Getting Started guide on the pynq website guide to connect to the Notebooks.


PYNQ is an open-source project from Xilinx that makes it easy to design embedded systems with Zynq All Programmable Systems on Chips (APSoCs). Using the Python language and libraries, designers can exploit the benefits of programmable logic and microprocessors in Zynq to build more capable and exciting embedded systems. PYNQ users can now create high performance embedded applications with

  • parallel hardware execution
  • high frame-rate video processing
  • hardware accelerated algorithms
  • real-time signal processing
  • high bandwidth IO
  • low latency control

See the PYNQ webpage for an overview of the project, and find documentation on ReadTheDocs to get started.

Precompiled Image

The project currently supports the PYNQ-Z1 board.

You can download the precompiled image, write the image to a micro SD card, and boot the board from the micro SD card.

Quick Start

See the Quickstart guide for details on writing the image to an SD card, and getting started with the PYNQ-Z1 board.

Python Source Code

All Python code for the pynq package can be found in the /pynq folder. This folder can be found on the board after the board boots with the precompiled image.

To update your PYNQ SD card to the latest pynq package, you can run the following command from a terminal connected to your board:

sudo pip3.6 install --upgrade git+https://github.com/Xilinx/PYNQ.git

SDK software projects and Python-C source codes are also stored along with the Python source code. After installing the pynq package, the compiled target files will be saved automatically into the pynq package.

Board Files and Overlays

All board related files including Vivado projects, bitstreams, and example notebooks, can be found in the /boards folder.

In Linux, you can rebuild the overlay by running make in the corresponding overlay folder (e.g. /boards/Pynq-Z1/base). In Windows, you need to source the appropriate tcl files in the corresponding overlay folder.

Contribute

Contributions to this repository are welcomed. To submit a project for inclusion:

  1. Fork this repository to your own github account using the fork button above.

  2. Clone (download) the fork to a local computer using git clone.

  3. You can modify the Vivado project, bitstream, SDK project, Python source code, or notebook in the corresponding folders.

  4. Modify the documentation if necessary.

  5. Use git add-->git commit-->git push to add changes to your fork.

  6. Then submit a pull request by clicking the pull request button on your github repo.

Check the guide to git for more information.

Support

Please ask questions on the PYNQ support forum.