PYNQ-ZU support

PYNQ support

Questions about using PYNQ on the PYNQ-ZU can be posted to the PYNQ support forum:

You can also post your own projects in the Community Corner on the PYNQ support forum.

Xilinx support

Questions related to Xilinx tools and building designs for your board, including HLS design, can be posted on the Xilinx technical support forums:

Hardware problems

Follow the troubleshooting guide below, and post questions on the PYNQ support forum. If you have a problem with you board and you suspect the board is damaged, please contact the manufacturer TUL.


Check the PYNQ Documentation for FAQs related to PYNQ.


  • I do not see any LEDs after turning on the board

    This indicates there is no power going to the board, or the board is dead.

    • Check the power cables, and switches

    • Check the power switch is in the correct position


    This indicates the PS is not booting the PYNQ image

    • Check the SD card is inserted, and has a valid PYNQ image
  • I do not see the DONE LED or the white flashing LEDs

    This indicates the PS has not booted properly.

    • Check the SD card has a valid PYNQ image

    • Connect a serial terminal and check the boot console

      If the boot process stalls, or continuously restarts, try to capture the console information and post it to the PYNQ support forum.

  • I have no Ethernet connection/I do not see the new connection on my computer

    • On your host computer, check if a new Ethernet device is available in your network connections. You may need to check hardware manager in Windows, and the equivalent in other operating systems, to see if the Ethernet device was recognized, and if the driver was automatically loaded.

    • Check the Micro USB 3.0 cable is connected to your host PC and board.

  • I cannot connect to Jupyter

    • I get a “404” or the webpage for the board doesn’t load

    • Connect a serial terminal, and check the boot log. Check if Jupyter Notebook server has started, and that it is still running.

      You can do this by checking if the following command returns something:

      ps -ef | grep Jupyter


      root    1434  1405  0 09:16 pts/0   00:00:00