kozhukalov/artyz7

Prerequisites

!!! CAUTION !!! If you are not experienced Linux user it probably better to run the build procedure on a VM because at some point while preparing the root file system it mounts recursively /sys and /dev filesystems from the host to this root file system being built. If something goes wrong then you have to be able to umount the manually. Moreover some GUI enviroments like Gnome can expose all these /dev and /sys subdirectories in GUI utilities which can be confusing.

Sudo

The procedure assumes the user running the script is able to mount/umount filesystems. This usually means the user must be able to run some commands with root permissions using sudo.

If you use Fedora 39+

dnf install uboot-tools dtc libuuid-devel libuuid
dnf install kernel-modules-extra
modprobe ftdi_sio

Bootgen

Xilinx bootgen command line tool must be installed (provided by Vitis) and it must be available in one of the directories listed in $PATH.

Prepare repository

git clone https://github.com/kozhukalov/artyz7.git
cd artyz7
git submodule init
git submodule update

Build boot file system

This will create a directory ./build/bootfs that will contain FSBL, BOOT.BIN, U-boot binary, U-boot script, Linux kernel binary and busybox based initramfs.

make bootfs

Build root file system

This will create a directory ./build/rootfs that contains Ubuntu Base Jammy with kernel modules system installed into it.

make rootfs

Prepare SD

Partitioning and formatting

Insert an SD card (32GB) in a card reader and figure out the device name. E.g. if the SD device name is /dev/sdb then run the following

#!!! CAUTION !!! DESTROYS ALL THE DATA ON THE DEVICE
./sd/format_sd.sh /dev/sdb

Once the SD card is formatted, check that it is NOT mounted to any point and follow next steps

Sync bootfs on SD

This will mount the SD boot partition (e.g. /dev/sdb1) to ./build/mnt_boot and copy all the files from ./build/bootfs to this mount point and then unmounts it.

make bootsd _SD_DEVICE_BOOT=/dev/sdb1

Sync rootfs on SD

This will mount the SD root partition (e.g. /dev/sdb2) to ./build/mnt_root and copy all the files from ./build/rootfs to this mount point and then unmounts it.

make rootsd _SD_DEVICE_ROOT=/dev/sdb2

Boot ArtyZ7

Now insert the SD to the ArtyZ7 SD slot and set JP4 to boot from SD. To connect using the serial console via USB use the following command:

sudo screen /dev/ttyUSB1 115200

Once the OS is booted you can log in using username root and password root (it is set during build time).

Network

Let's assume ArtyZ7 is connected to the workstation with Ethernet cable and the workstation itself is connected by means of something else to the public Internet. In this case you can configure both the ArtyZ7 board and the workstation so that ArtyZ7 has access to the Internet and you can use apt to install packages.

Configure workstation

eth0 - connected to the Internet eth1 - connected to ArtyZ7

ip a add 192.168.150.1/24 dev eth1
iptables -t nat -I POSTROUTING -s 192.168.150.10 -o eth0 -j MASQUERADE

Configure ArtyZ7 (while connected using serial console)

eth0 - connected to workstation

ip a add 192.168.150.10/24 dev eth0
ip r add via 192.168.150.1 dev eth0