Part 1 - Setup environment

1. Pre-requisites

Part 2 - Move Zedboard Linux project from 2021.2 to 2022.2

2. Bump version
3. Initial build attempt
4. Bulk edit of files (short version)
5. Bulk edit of files (long version)
6. Resume build attempt
7. Copy files to SD Card

Part 3 - Check everything is working as expected

8. Check the Webserver

Part 4 - Make the changes permanent

9. Edit the Apache2 configuration
10. Create an auto-start application

Part 5 - Revision Control

11. Commit new & updated files
12. Create production release
13. Copy files to SD Card

Part 6 - Check everything is working as expected

14. OS boot & Firmware load

Part 7 - Final resulting build file(s)

15. 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_bram_id_v1.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 2022.2 is installed & set-up (ideally in /opt/Xilinx).
  steve@Desktop:~$ swuk_xilinx 2022.2

Tools are as follows :-

Vivado @ /opt/Xilinx/Vivado/2022.2/bin/vivado
SDK @ Not available!
Vitis @ /opt/Xilinx/Vitis/2022.2/bin/vitis
PetaLinux @ /opt/Xilinx/PetaLinux/2022.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 v14.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 2021.2 petalinux /dev/ttyPS0

petalinux login:


# We have a conf and classes directory, add to BBPATH
BBPATH .= ":${LAYERDIR}"

# We have recipes-* directories, add to BBFILES
BBFILES += "${LAYERDIR}/recipes-*/*/*.bb \
	${LAYERDIR}/recipes-*/*/*.bbappend"

BBFILE_COLLECTIONS += "meta-user"
BBFILE_PATTERN_meta-user = "^${LAYERDIR}/"
BBFILE_PRIORITY_meta-user = "7"
LAYERSERIES_COMPAT_meta-user = "honister"

• Change IMAGE_INSTALL_append to IMAGE_INSTALL:append
• Change PACKAGECONFIG_append_pn-php to PACKAGECONFIG:append:pn-php
• Change FILESEXTRAPATHS_prepend to FILESEXTRAPATHS:prepend
• Change CFLAGS_prepend to CFLAGS:prepend
• Change FILES_${PN} to FILES:${PN}
• Change SRC_URI_append to SRC_URI:append
• Change do_configure_append_microblaze to do_configure:append:microblaze
• Change do_configure_append to do_configure:append
• Change do_install_append to do_install:append
• Change KERNEL_FEATURES_append to KERNEL_FEATURES:append

• Uncomment & change the Scriptsock entry.
• Change the location of the ErrorLog & CustomLog to allow the Apache2 service to start automatically at boot time.

#
# File .......... apache2_%.bbappend
# Author ........ Steve Haywood
# Website ....... http://www.spacewire.co.uk
# Project ....... Zedboard Linux (SpaceWire UK Tutorial)
# Date .......... 28 Feb 2026
# Version ....... 3.0
# Description ...
#   Modified Apache 2 recipe to suite PetaLinux. Updated to allow Apache to run as
# root instead of deamon.
#

do_install:append() {

sed -i 's@^#LoadModule cgid_module /usr/libexec/apache2/modules/mod_cgid.so@LoadModule cgid_module /usr/libexec/apache2/modules/mod_cgid.so@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@^DocumentRoot "/usr/share/apache2/default-site/htdocs"@DocumentRoot "/srv/www"@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@^<Directory "/usr/share/apache2/default-site/htdocs">@<Directory "/srv/www">@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@^    ScriptAlias /cgi-bin/ "/usr/libexec/apache2/modules/cgi-bin/"@    ScriptAlias /cgi-bin/ "/srv/www/cgi-bin/"@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@^<Directory "/usr/libexec/apache2/modules/cgi-bin">@<Directory "/srv/www/cgi-bin">@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@^    DirectoryIndex index.html@    DirectoryIndex index.html index.php@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@^User daemon@#User daemon@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@^Group daemon@#Group daemon@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@#Scriptsock cgisock@Scriptsock /var/run/cgid.sock@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@ErrorLog "/var/log/apache2/error_log"@ErrorLog "/tmp/apache2_error_log"@' ${D}/${sysconfdir}/${BPN}/httpd.conf

sed -i 's@CustomLog "/var/log/apache2/access_log"@CustomLog "/tmp/apache2_access_log"@' ${D}/${sysconfdir}/${BPN}/httpd.conf

}