This tutorial details the steps required to enable and install the pre-existing peek & poke applications and check they are working as expected.

The aims of this tutorial are as follows :-

Part 1 - Project Setup

1. Setup environment
2. Change present working directory

Part 2 - Enable existing application

3. Enable peek/poke application

Part 3 - Build & package PetaLinux

4. Build PetaLinux
5. Package PetaLinux

Part 4 - Hardware Deployment

6. Setup Zedboard hardware
7. Launch MiniCom terminal emulator
8. Run PetaLinux on Zedboard via JTAG
9. Check everything is working as expected

Part 6 - Revision Control

10. Commit to repository

Part 5 - Quickstart

11. Obtain tutorial files from Bitbucket, create & build project, deploy on Zedboard

Setup Xilinx design environment for the 2021.2 toolset.

Change the present working directory to be the project directory.

The Peek/Poke application is enabled through the configuration tool. Launch the tool to begin. The configuration tools should now present the root menu. Tip: Use the up & down arrow keys to nagivate the heirarchy, the left & right arrow keys to navigate the bottom menu, the enter key to select heirarchy/menu items, and the y & n keys to enable/disable components.

Navigate to apps and select it to enter the apps menu. Enable the peekpoke application. Exit the apps menu. Exit the configuration tool by exiting the root menu. Save the configuration on exit.

Rebuild the project to include the updated files.

Package up the project ready for deployment.

Connect up the hardware as follows :-

1. Xubuntu PC USB ⇄ Zedboard USB JTAG/Debug
2. Xubuntu PC USB ⇄ Zedboard USB UART
3. Zedboard Ethernet ⇄ Router
4. Xubuntu PC Ethenet ⇄ Router
5. Router ⇄ Internet

Set the boot mode jumpers on the Zedboard for JTAG. Power on the Zedboard.

If not already running, open up a new terminal and launch the MiniCom terminal emulator.

Power cycle the Zedboard and deploy the project via JTAG.

When the PetaLinux login prompt appears login using the root credentials.

Check the peek & poke applications have installed correctly by launching them. Check the peek application works by setting the outer two slides switches to their on position and reading the slide switch register. Check the poke application works by writing to the LED register, illuminating the outer four LED's and then the inner four.

Commit the updated files, create an annotated tag and push the commit & tag up to the remote repository.

The source files relating to this tutorial for the OS can be obtained from Bitbucket. The OS repository contains both PetaLinux and a local copy of the exported hardware (firmware).

The instructions below assume that Part 1 - Installation of tools, setup of environment and creation of project area has been completed in full and that the environment has been setup as per 1. Setup environment. The root project area ~/projects should be present and contain the common project. The zedboard_linux projects should NOT be present. Adjust the commands below to suit if the above differs.

Obtain OS source, build & deploy on Zedboard. Do something with the OS (if required) then perform the following steps :-

4. Build PetaLinux
5. Package PetaLinux
6. Setup Zedboard hardware
7. Launch MiniCom terminal emulator
8. Run PetaLinux on Zedboard via JTAG
9. Check everything is working as expected