1 Introduction
1.1 The Xillinux distribution
1.2 The Xillybus IP core
2 Prerequisites
2.1 Hardware
2.2 Downloading the distribution
2.3 Development software
2.4 Experience with FPGA design
3 Building Xillinux
3.1 Overview
3.2 Unzipping the boot partition kit
3.3 Generating the bitstream file
3.3.1 Introduction
3.3.2 Selecting the intended Zynq part (Z-Turn Lite only)
3.3.3 Preparing xillydemo.vhd (VHDL project only)
3.3.4 Generating the Vivado project
3.3.5 Implementation of the project
3.4 Loading the (Micro)SD with the image
3.4.1 General
3.4.2 Loading the image (Windows)
3.4.3 Loading the image (Linux)
3.4.4 Using the Zynq board for loading the image
3.5 Copying the files into the boot partition
3.6 The files in the boot partition
4 Kick off boot
4.1 Jumper settings
4.1.1 Zedboard
4.1.2 MicroZed
4.1.3 Zybo
4.1.4 Z-Turn Lite
4.2 Attaching peripherals
4.3 Powering up the board
4.3.1 Initial diagnostics
4.3.2 When the boot process completes
4.3.3 U-boot environment variables
4.3.4 Setting a custom Ethernet MAC address
4.3.5 Sample transcript during boot
4.4 To do soon after the first boot
4.4.1 Resize the file system
4.4.2 Allow remote SSH access
4.4.3 Compilation of locale definitions (if needed)
4.5 Using the desktop
4.6 Shutting down / rebooting
4.7 What to do from here
5 Making modifications
5.1 Integration with custom logic
5.2 Using other boards
5.3 Changing the frequencies of clocks in the system
5.4 Taking over GPIO I/O pins for PL logic
5.4.1 Z-Turn Lite
5.4.2 Zedboard and Zybo
5.5 Working with 7020 MicroZed
5.6 Pre-boot manipulation of hardware registers (“poke”)
6 Linux notes
6.1 General
6.2 Compilation of the Linux kernel
6.3 Compilation of kernel modules
6.4 Sound support
6.4.1 General
6.4.2 Usage details
6.4.3 Related boot scripts
6.4.4 Accessing /dev/xillybus_audio directly
6.4.5 Pulseaudio details
6.5 The OLED utility (Zedboard only)
6.6 Other notes
7 Troubleshooting
7.1 Errors during implementation
7.2 Problems with USB keyboard and mouse
7.3 Issues with file system mount
7.4 “startx” fails (Graphical desktop won’t start)
7.5 Black screen after screensaver with X desktop
