This guide will show you how to setup your development board and computer to get started using PYNQ. Any questions can be posted to the PYNQ support forum.
If you have one of the following boards, you can follow the quick start guide.
.. toctree:: :maxdepth: 1 getting_started/pynq_z1_setup.rst getting_started/pynq_z2_setup.rst getting_started/zcu104_setup.rst
If you have another Zynq board see the following guide:
.. toctree:: :maxdepth: 1 getting_started/other_boards.rst
.. toctree:: :maxdepth: 1 :hidden: getting_started/pynq_image.rst
Connecting to Jupyter Notebook
Once your board is setup, to connect to Jupyter Notebooks open a web browser and navigate to:
- http://192.168.2.99 If your board is connected to a computer via a static IP address
If your board is configured correctly you will be presented with a login screen. The username is xilinx and the password is also xilinx.
After logging in, you will see the following screen:
The default hostname is pynq and the default static IP address is 192.168.2.99. If you changed the static IP of the board, you will need to change the address you browse to.
The first time you connect, it may take a few seconds for your computer to resolve the hostname/IP address.
PYNQ uses the Jupyter Notebook environment to provide examples and documentation. Using your browser you can view and run the notebook documentation interactively.
The Getting_Started folder in the Jupyter home area includes some introductory Jupyter notebooks.
The example notebooks have been divided into categories
- common: examples that are not overlay specific
Depending on your board, and the PYNQ image you are using, other folders may be available with examples related to Overlays. E.g. The base directory will have examples related to the base overlay. If you install any additional overlays, a folder with example notebooks will usually be copied here.
When you open a notebook and make any changes, or execute cells, the notebook document will be modified. It is recommended that you "Save a copy" when you open a new notebook. If you want to restore the original versions, you can download all the example notebooks from GitHub.
Accessing Files on The Board
Samba, a file sharing service, is running on the board. This allows you to access the Pynq home area as a network drive, to transfer files to and from the board.
In the examples below change the hostname or IP address to match your board settings.
To access the Pynq home area in Windows Explorer type one of the following in the navigation bar.
\\192.168.2.99\xilinx # If connected to a Computer with a Static IP
When prompted, the username is xilinx and the password is xilinx. The following screen should appear:
To access the home area in Ubuntu, open a file broswer, click Go -> Enter Location and type one of the following in the box:
smb://192.168.2.99/xilinx # If connected to a Computer with a Static IP
When prompted, the username is xilinx and the password is xilinx
Change the Hostname
If you are on a network where other PYNQ boards may be connected, you should change your hostname immediately. This is a common requirement in a work or university environment. You can change the hostname from a terminal. You can use the USB cable to connect a terminal. A terminal is also available in the Jupyter environment and can be used from an internet browser.
To access the Jupyter terminal, in the Jupyter portal home area, select New >> Terminal.
This will open a terminal inside the browser as root.
Use the preloaded pynq_hostname.sh script to change your board's hostname.
pynq_hostname.sh <NEW HOSTNAME>
The board must be restarted for the changes to be applied.
shutdown -r now
Note that as you are logged in as root, sudo is not required. If you connect a terminal from the USB connection, you will be logged in as the xilinx user and sudo must be added to these commands.
When the board reboots, reconnect using the new hostname.
If you can't connect to your board, see the step below to open a terminal using the micro USB cable.
Configure Proxy Settings
If your board is connected to a network that uses a proxy, you need to set the proxy variables on the board. Open a terminal as above and enter the following where you should replace "my_http_proxy:8080" and "my_https_proxy:8080" with your settings.
set http_proxy=my_http_proxy:8080 set https_proxy=my_https_proxy:8080