Part 1 - Setup environment

1. Pre-requisites

Part 2 - Move Zedboard Linux project from 2023.2 to 2024.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 v19.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 8 - Make the changes permanent

18. Edit the Apache2 configuration
19. Edit the System webpage to fix the MAC address issue

Part 9 - Revision Control

20. Commit new & updated files
21. Create production release

Part 10 - Hardware Deployment

22. Copy BOOT files to the SD-Card
23. Reload the Operating System using the Webserver

Part 11 - Check everything is working as expected

24. Final checks

Part 12 - Final resulting build file(s)

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

Tools are as follows :-

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

petalinux login:


• 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.

• Uncomment the LoadModule cgi_module entry.

#
# File .......... apache2_%.bbappend
# Author ........ Steve Haywood
# Website ....... http://www.spacewire.co.uk
# Project ....... Zedboard Linux (SpaceWire UK Tutorial)
# Date .......... 16 Mar 2026
# Version ....... 4.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 cgi_module /usr/libexec/apache2/modules/mod_cgi.so@LoadModule cgi_module /usr/libexec/apache2/modules/mod_cgi.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

}

• Change the net_mac assignment.

<?php
//
// File .......... index.php
// Author ........ Steve Haywood
// Website ....... http://www.spacewire.co.uk
// Project ....... Zedboard Linux (SpaceWire UK Tutorial)
// Date .......... 16 Mar 2026
// Version ....... 12.0
// History .......
//   9.0 zedboard_linux/os/petalinux/project-spec/meta-user/recipes-apps/website/files/cgi-bin/index.php
//   7.0 zedboard_linux/os/petalinux/project-spec/meta-user/recipes-apps/website/files/cgi-bin/index.cgi
// Description ...
//   Webpage for System Information & Operating System / Firmware Load.
//
?>

<?php
// Get information
$sys_host = exec('hostname', $retval);
$sys_time = exec('date', $retval);
$sys_load = exec('awk \'{print $1}\' /proc/loadavg', $retval);
$sys_up = exec('awk \'{print $1}\' /proc/uptime', $retval);
$cpu_model = exec('grep model /proc/cpuinfo | cut -d : -f2 | tail -1 | sed \'s/\s//\'', $retval);
$cpu_cores = exec('grep -c ^processor /proc/cpuinfo', $retval);
$mem_total = (int)((int)exec('free | awk \'NR==2{print $2}\'', $retval) / 1024);
$mem_used = (int)((int)exec('free | awk \'NR==2{print $3}\'', $retval) / 1024);
$mem_free = (int)((int)exec('free | awk \'NR==2{print $4}\'', $retval) / 1024);
$net_mac = exec("cat /sys/class/net/$(ip route show default | awk '/default/ {print $5}')/address", $retval);
$net_ip_loc = exec('ip a | grep inet | grep -vw lo | grep -v inet6 | cut -d \/ -f1 | sed \'s/[^0-9\.]*//g\'', $retval);
$net_ip_ext = exec('wget -q -O- http://ipecho.net/plain', $retval);
?>

<?php require '../share/header.php'; ?>

<div class=content>

<div class=inner>
<?php
$tables = array("Operating System", "Firmware");
$id = array("os", "fw");
$fields = array("Description", "Company", "Author", "Version", "Timestamp", "Hash");
for ($table = 0 ; $table < count($tables) ; $table++) {
echo "
<table>
<tr>
<th colspan=2>$tables[$table] Information</th><th><button id=$id[$table]_read>Read</button></th>
</tr>
";
for ($field = 0 ; $field < count($fields) ; $field++) {
echo "
<tr>
<td style='text-align:right'>$fields[$field]</td>
<td style='text-align:left' id=$id[$table]_id_$field>Unknown</td>
<td><img id=$id[$table]_id_status_$field style='vertical-align:middle' src='../share/amber.gif' title='Unknown!' alt='Missing Image!'></td>
</tr>
";
}
echo "
</table>
";
}
?>
</div>

<div class=inner>
<?php
for ($table = 0 ; $table < count($tables) ; $table++) {
$colspan = ($table == 0) ? 6 : 5;
echo "
<table>
<tr><th colspan=$colspan>Reload $tables[$table]</th></tr>
<tr>
<td style='text-align:right'>Select</td>
<td style='text-align:left'>
<select id=$id[$table]_select>
<option value=none>N/A</option>
";
$location = ($table == 0) ? '/media/sd-mmcblk0p1/petalinux/*' : '/media/sd-mmcblk0p1/firmware/*.bin';
foreach(glob("$location") as $file) {
  if (($table == 0) ? is_dir($file) : is_file($file)) {
    $basename = pathinfo($file)["basename"];
    $filename = ($table == 0) ? $basename : pathinfo($file)["filename"];
    echo "<option value=$basename>$filename</option>";
  }
}
$count = ($table == 0) ? "<td id=$id[$table]_count>0/120s</td>" : "";
echo "
</select>
<td id=$id[$table]_action>Idle</td>
</td><td><progress id=$id[$table]_progress value=0 max=120></progress></td>
$count
<td><img id=$id[$table]_status style='vertical-align:middle' src='../share/amber.gif' title='Unknown!' alt='Missing Image!'></td>
</tr>
</table>
";
}
?>
</div>

<div class=inner>

<table>
<tr><th colspan=2>System</th></tr>
<tr><td style='text-align:right'>Hostname</td>
<td style='text-align:left'><?php echo $sys_host ?></td>
</tr><tr><td style='text-align:right'>Time</td><td style='text-align:left'><?php echo $sys_time ?></td></tr>
<tr><td style='text-align:right'>Uptime</td><td style='text-align:left'><span id=ut_text><?php echo $sys_up ?></span> seconds <button id=ut_refresh>Refresh</button> Auto :
<select id=ut_select>
  <option value=0>Off</option>
  <option value=1>1s</option>
  <option value=5>5s</option>
</select>
</td></tr>
</table>

<table>
<tr><th colspan=2>CPU</th></tr>
<tr><td style='text-align:right'>Model</td>
<td style='text-align:left'><?php echo $cpu_model ?></td></tr>
<tr><td style='text-align:right'>Cores</td><td style='text-align:left'><?php echo $cpu_cores ?></td></tr>
<tr><td style='text-align:right'>Load</td><td style='text-align:left'><?php echo $sys_load ?></td></tr>
</table>

<table>
<tr><th colspan=2>Memory</th></tr>
<tr><td style='text-align:right'>Total</td><td style='text-align:right'><?php echo $mem_total ?> Mb</td></tr>
<tr><td style='text-align:right'>Used</td><td style='text-align:right'><?php echo $mem_used ?> Mb</td></tr>
<tr><td style='text-align:right'>Free</td><td style='text-align:right'><?php echo $mem_free ?> Mb</td></tr>
</table>

<table>
<tr><th colspan=2>Network</th></tr>
<tr><td style='text-align:right'>MAC Address</td><td style='text-align:left'><?php echo $net_mac ?></td></tr>
<tr><td style='text-align:right'>Internal IP</td><td style='text-align:left'><?php echo $net_ip_loc ?></td></tr>
<tr><td style='text-align:right'>External IP</td><td style='text-align:left'><?php echo $net_ip_ext ?></td></tr>
</table>

</div>

</div>

<?php require '../share/footer.php'; ?>