Part 1 - Setup environment

1. Pre-requisites

Part 2 - Move Zedboard Linux project from 2024.2 to 2025.2

2. Create PetaLinux project
3. Add hardware platform
4. Align PetaLinux - 1
5. Check GIT status
6. Align PetaLinux - 2
7. Bump version

Part 3 - Build & package PetaLinux

8. Build PetaLinux
9. Package PetaLinux

Part 4 - Hardware Deployment

10. Copy files to SD-Card
11. Reload OS into Zedboard PetaLinux v20.0

Part 5 - Check everything is working as expected

12. Check BOOT sequence
13. Check Apache2, PHP & CGI
14. Check SQLite
15. Check phpLiteAdmin
16. Check HDMI
17. Check Userspace I/O

Part 9 - Revision Control

18. Commit new & updated files
19. Create production release

Part 10 - Hardware Deployment

20. Copy BOOT files to the SD-Card
21. Reload the Operating System using the Webserver

Part 11 - Check everything is working as expected

22. Final checks

Part 12 - Final resulting build file(s)

23. Resulting BOOT files

• Customize the tutorial to match your own setup (optional).
  
    : SWUK Tutorial project location
    : SWUK Tutorial user location
    : Remote repository location (IP)
    : Linux user (whoami)
    : Linux host (hostname)
    : Zedboard location (IP)

• The (remote) SpaceWire UK Tutorial repository is present on your server at say git@192.168.2.20:swuk_tutorial.git or at say ~/repos/swuk_tutorial.git.
  
  Note: Only perform the following if not continuing from the previous tutorial.
  Example: Setup the remote repository (on the local machine). This is required to perform GIT push commands.
  steve@Desktop:~$ mkdir ~/repos
steve@Desktop:~$ git clone --mirror https://bitbucket.org/spacewire_firmware/swuk_tutorial.git ~/repos/swuk_tutorial.git


• The (local) cloned SpaceWire UK Tutorial repository is present, located at say ~/swuk_tutorial.
  
  Note: Only perform the following if not continuing from the previous tutorial.
  Example: Setup the local repository.
  
  1. Clone from the remote repository.
  2. Create a new branch and switch to it.
  3. Revert to the required previous commit.
  4. Set the upstream link.
  
  steve@Desktop:~$ git clone ~/repos/swuk_tutorial ~/swuk_tutorial
steve@Desktop:~$ cd ~/swuk_tutorial
steve@Desktop:~/swuk_tutorial$ git switch -c my_master
steve@Desktop:~/swuk_tutorial$ git reset --hard zedboard_linux_v19.0
steve@Desktop:~/swuk_tutorial$ git push -u origin my_master


• The (global) shell initialisation script is set-up to source the (local) SpaceWire UK Tutorial shell initialisation script.

  .bashrc (partial)

  200. # SpaceWire UK Tutorial
       
  201. source $HOME/swuk_tutorial/common/other/src/script/swuk_sis
       

• The (global) shell initialisation script has been sourced (so it sources the SWUK local SIS).
  steve@Desktop:~/swuk_tutorial$ source ~/.bashrc


• PetaLinux 2025.2 is installed & set-up (ideally in /opt/Xilinx).
  steve@Desktop:~$ swuk_xilinx 2025.2

Tools are as follows :-

Vivado @ /opt/Xilinx/Vivado/2025.2/bin/vivado
SDK @ Not available!
Vitis @ /opt/Xilinx/Vitis/2025.2/bin/vitis
PetaLinux @ /opt/Xilinx/PetaLinux/2025.2/tool/tools/common/petalinux/bin/petalinux-build


• The other support applications are installed and set-up; minicom, git, sublime-text & sshpass. See Part 1 for more information.

• Plugged into the ZedBoard is a FAT32 formatted SD card containing the PetaLinux v18.0 (or higher) boot files (generated in Part 20).
  
     sd-mmcblk0p1/
     ├── BOOT.BIN
     ├── boot.scr
     ├── image.ub
     ├── database
     └── firmware
  

• The Zedboard boot mode jumpers are configured for SD Card boot.

• The Zedboard hardware is connected up for comms & internet.
  
  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.
  

• The Zedboard is now powered-up & present on the LAN.
  steve@Desktop:~/swuk_tutorial$ ping -c 1 192.168.2.87
PING 192.168.2.87 (192.168.2.87) 56(84) bytes of data.
64 bytes from 192.168.2.87: icmp_seq=1 ttl=64 time=0.149 ms

--- 192.168.2.87 ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 0.149/0.149/0.149/0.000 ms


• The debug terminal emulator is up and running.
  steve@Desktop:~/swuk_tutorial$ swuk_terminal

Welcome to minicom 2.7.1

OPTIONS: I18n
Compiled on Dec 23 2019, 02:06:26.
Port /dev/ttyACM0, 06:34:25

Press CTRL-A Z for help on special keys


PetaLinux 2025.2 petalinux /dev/ttyPS0

petalinux login:


1. Router sets the IP address based on the MAC address.
2. PetaLinux sets its own IP address.

• project-spec/configs/rootfs_config
• project-spec/meta-user/conf/petalinuxbsp.conf
• project-spec/meta-user/conf/user-rootfsconfig
• project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi

#
# File .......... petalinuxbsp.conf
# Author ........ Steve Haywood
# Website ....... http://www.spacewire.co.uk
# Project ....... Zedboard Linux (SpaceWire UK Tutorial)
# Date .......... 28 Feb 2026
# Version ....... 3.0
# Description ...
#   Updated to install the following :-
# -- ntp ....... Network Time Protocol
# -- ntpdate ... Set the date and time via NTP
# -- ntpq ...... Standard NTP query program
# -- sntp ...... Simple Network Time Protocol
# -- nano ...... Text editor
# Updated to install a LAMP style stack :-
# -- Apache .... HTTP server
# -- SQLite .... SQL database engine
# -- PHP ....... Scripting language
#

#User Configuration

#OE_TERMINAL = "tmux"

IMAGE_INSTALL:append = " ntp ntpdate ntpq sntp nano"
PACKAGECONFIG:append:pn-php = " apache2"
IMAGE_INSTALL:append = " apache2 sqlite3 php-modphp"

#User Configuration

#OE_TERMINAL = "tmux"

#Note: Mention Each package in individual line
#These packages will get added into rootfs menu entry

CONFIG_gpio-demo
CONFIG_peekpoke
CONFIG_led-runner
CONFIG_website
CONFIG_peekpokecgi
CONFIG_axi-gpio-zed-test
CONFIG_adv7511-config
CONFIG_boot-extras

#Note: Mention Each package in individual line
#These packages will get added into rootfs menu entry

CONFIG_gpio-demo
CONFIG_peekpoke

/*
 * File .......... system-user.dtsi
 * Author ........ Steve Haywood
 * Website ....... http://www.spacewire.co.uk
 * Project ....... Zedboard Linux (SpaceWire UK Tutorial)
 * Date .......... 29 Oct 2022
 * Version ....... 2.0
 * History .......
 *   1.0 TEMPLATE
 * Description ...
 *   Added User Space I/O (UIO) for the AXI GPIO Zed module.
 */

/include/ "system-conf.dtsi"

/ {
    chosen
    {
      bootargs = "uio_pdrv_genirq.of_id=generic-uio";
    };
};

&axi_gpio_zed_0
{
  #interrupt-cells = <2>;
  interrupt-controller;
  interrupts = <0 29 1>;
  compatible = "generic-uio";
};

/include/ "system-conf.dtsi"

/ {




};

1. The Apache2 server is up and running.
2. The PHP interpreter is working.
3. The CGI binaries are operating as expected.