1. Summary

1.1 Assumptions

1. ZC702 Evaluation board with required licenses
2. A Linux development PC with the ARM GNU tools installed
3. A Windows 7 PC with vivado 2013.2
4. Ease Us Partition Master 9.2.2 software installed on Windows 7 PC. Please refer to Appendix A for downloading this software.
5. A 8 GB or larger SD card
6. A SD card reader and Win32DiskImager.exe tool for writing the precompiled *.img. provided with this tech tip.Please refer to Appendix A for downloading this software

2. Implementation

3. Attachments

4. Step by Step Instructions

1. Building the FPGA Hardware Bit stream and FSBL
2. Installing peta-Linux and Building BSP for Base TRD
3. Customizing Linux Device tree blob (devicetree.dtb)
4. Setting up the SD card
5. Obtaining Linaro Ubuntu Desktop (rootfs)
6. Running the Ubuntu Desktop
7. Applying the required packages

4.1 Details

1. Building the FPGA Hardware Bit stream and FSBL:
   Sections 3 and 4 of Base TRD would explain "how to build the FPGA Hardware Bit stream and FSBL" using Vivado 2013.2 tool. The output of this process is a system.bit file and zynq_fsbl.elf files.
2. Installing peta-Linux and Building BSP for Base TRD: Peta-Linux SDK BSPs provide a complete, integrated and tested, Linux operating system for Xilinx devices. Follow Section 5 till 8 of Base TRD to obtain the installation tar ball of peta-Linux SDK on your Linux System and build the BSP for Base TRD. Then Follow section 10 and 11 to build the peta-Linux and generate the boot Image for the design provided. The output of the section should yield boot.bin and image.ub.
3. Customizing Linux Device tree:
   The Linux Device tree blob generated can be found at

$PETALINUX/software/linux-2.6.x/arch/arm/boot/dts/Xilinx-zc702.dts

• "root=/dev/mmcblk0p2".

• "setenv bootargs console=tty0 console=ttyPS0,115200 root=/dev/mmcblk0p2 rw earlyprintk mem=768M".

• fatload mmc 0 0x3000000 ${kernel_image} && fatload mmc 0 0x2A00000 ${devicetree_image}; bootm 0x3000000 - 0x2A00000.
  
  Save the current changes and Recompile to generate a new peta Linux binaries. Compilation steps are mentioned in section 10 of Base TRD.
  
  

4.1.1 Setting up the SD card

1. A FAT32 partition for Zynq Boot Images and
2. An ext3 or ext4 partition for root file system.

1. Extract the content (*.img) file present in the zc702_precompiled_image.zip file to local disc.
2. Place the SD card in card reader and connect to the windows pc.
3. Now execute the "Win32DiskImager.exe" and provide location of the image file and select the SD card Drive.
4. click on write. Wait for few seconds to finish the operation.
5. SD card is ready with the requested image programmed on it.

• Launch the Ease US Partition master tool by clicking on start > All programs > EaseUS Partition Master 9.x.x
• Select partition Manager option available on the left side as shown in figure 1.0 below

Figure 1.0: Launch Ease US

4.1.2 Creating Partitions

Click on apply and to reflect the changes and perform the requested operations on the SD card as shown in figure 5.0.

4.1.3 Obtaining Linaro Ubuntu Desktop (rootfs)

4.1.4 Running the Ubuntu Desktop

4.1.5 Applying the required packages

1. Fractal viewer running Mandelbrot set
2. Doom Game
3. Launches a Shell with Top command running in it
4. Libre Office running a power point presentation.

5. Appendix A

1. Peta-Linux Installation and other resources:
   Information related to Peta Linux and other resouces can be found at http://www.xilinx.com/tools/petalinux-sdk.htm.
2. Ease us partition Tool
   The tool can be downloaded and installed from http://www.easeus.com/partition-manager/
3. win32DiskImager.exe Tool
   The tool can be downloaded and installed from http://sourceforge.net/projects/win32diskimager/
4. Workaround for Permission issues on generic Linux PC while Extracting the RootFs
   Sometimes due to permissions, the root file system might not extract as expected, here is a workaround to bypass this problem with generic Linux machines. The workaround is to extract them on the Zynq board itself. The steps are given below.
   
   a) Copy the tar ball on to FAT file system of the SD card.
   b) Download the 14.5 pre-built images and copy them to SD card.
   c) Now Set the Boot Mode to SD and power on the board by inserting the SD card.
   d) Mount both the partitions (FAT32 and ext3) of the card as stated
   
   Mkdir –p /mnt/boot
   Mkdir –p /mnt/rootfs
   Mount /dev/mmcblk0p1 /mnt/boot
   Mount /dev/mmcblk0p2 /mnt/rootfs
   cd /mnt/boot;sudo tar --strip-components=3 -C /mnt/rootfs –xzpf linaro-precise-ubuntu-desktop-20120626-247.tar.gz binary/boot/filesystem.dir
   
   
5. Applications integrated with the precompiled rootfs

• XaoS: Xaos is an interactive fractal viewer, allowing the user to continuously zoom in or out of a fractal in real-time. XaoS can display many common fractal types, including Mandelbrot, Barnsley, Newton, Phoenix, and even your own custom formulas. XaoS also supports switching between Julia and Mandelbrot sets for each formula. To Install Xaos, Edit the /etc/apt/sources.list file as root

• PrBoom: This Classic PC Doom game. There are multiple Doom engines available for linux, including zdoom, dooms­day and prboom. Prboom is released under the GPL and includes the game engine and free game media (maps, en­emies, wea­pons, …).

• Libre-Office : Libre Office is a free and open source office suite, It was forked from Open Office. The Libre Office suite comprises following meta-packages

• libreoffice-writer:Word processor
• libreoffice-calc:Spreadsheet
• libreoffice-impress:Presentation
• libreoffice-draw:Drawing
• libreoffice-base:Database
• libreoffice-math: Equation editor
• libreoffice-filter-mobiledev: Mobile Devices filters
• libreoffice-filter-binfilter: legacy filters (e.g. StarOffice 5.2)

6. Appendix B - using 2015.2 TRD and newer Ubuntu rootfs

1. Get the 2015.2 Base TRD files: http://www.wiki.xilinx.com/Zynq+Base+TRD+2015.2
2. Get the Linaro 2014.10 release developer build, which is based on Ubuntu 14.04 (an LTS version): Go to page http://releases.linaro.org/14.10/ubuntu/trusty-images/developer/ and get linaro-trusty-developer-20141024-684.tar.gz
3. If you have a Windows machine, you can prepare your SD card according to steps 4.1.1 and 4.1.2 above to partition & set them to the correct type (fat32 for boot and ext4 for rootfs). On a Linux workstation, you can use the tool "gparted" to partition & set the type.
4. Untar the rootfs image into the rootfs partition:
   • sudo tar --strip-components=1 -C /media/nathalie/rootfs -xzpf linaro-trusty-developer-20141024-684.tar.gz binary
5. If you build the design yourself with the Xylon IP, you'll have your display timing out after about an hour, due to the evaluation version of the IP being used. Since we want to add stuff to the rootfs that will take longer than an hour to install everything, we will start off by using the pre-built BOOT.BIN that is included in the 2015.2 base TRD files "ready_to_test" folder, which has the non-evaluation version compiled in. For the moment, we don't need to modify the FSBL ELF, U-Boot ELF, nor HW bitstream, so we can use the pre-built BOOT.BIN. Copy <TRD directory>/ready_to_test/BOOT.BIN to the boot partition of your SD card.
6. We do need to modify the kernel because some kernel options are needed so that the X-windowing doesn't fail with the newer Ubuntu rootfs. Follow the instructions in section 5 of this page http://www.wiki.xilinx.com/Zynq+Base+TRD+2015.2 for PetaLinux up to
   • ln -sf zc702-base-trd.dts system-top.dts
   in 5.2.1 (b). When you get to the part "ln -sf zc702-base-trd.dts system-top.dts", modify system-top.dts to use the rootfs that you will put on the rootfs partition: change so that root=/dev/mmcblk0p2 in the bootargs instead of using /dev/ram. Then do
   • petalinux-config -c kernel
   and do these 2 steps:
   • (1) Disable PCI (CONFIG_PCI=n) because otherwise Xorg will segfault
   • (2) Set CMA_SIZE_MBYTES to 128 so that Xorg doesn't throw an error: Device Drivers > Generic Driver Options > DMA Contiguous Memory Allocator > Size in Mega Bytes.
7. Build & package the kernel with the modified options:
   • petalinux-build
   • petalinux-package --image -c kernel --format uImage
8. Copy $ZYNQ_TRD_HOME/software/petalinux/images/linux/system.dtb to the boot partition of your SD card with the filename devicetree.dtb. $ZYNQ_TRD_HOME is defined on page http://www.wiki.xilinx.com/Zynq+Base+TRD+2015.2
9. Copy $ZYNQ_TRD_HOME/software/petalinux/images/linux/uImage to the boot partition of your SD card
10. In the boot partition of your SD card, create a file uEnv.txt with the contents:
    • uenvcmd=run ubuntu_sdboot
    • ubuntu_sdboot=echo Copying Linux from SD to RAM in uEnv... && fatload mmc 0 0x3000000 ${kernel_image} && fatload mmc 0 0x2A00000 ${devicetree_image} && if fatload mmc 0 0x2000000 ${ramdisk_image}; then bootm 0x3000000 0x2000000 0x2A00000; else bootm 0x3000000 - 0x2A00000; fi && echo Done uEnv
    • bootargs=console=ttyPS0,115200 root=/dev/mmcblk0p2 rw earlyprintk rootfstype=ext4 rootwait
11. In the rootfs partition of your SD card, create a file etc/init/ttyPS0.conf with the contents (you probably will need to use "sudo" for creating/modifying files on the rootfs partition of your SD card):
    • start on runlevel [23]
    • stop on runlevel [!23]
    • respawn
    • exec /sbin/getty -8 115200 ttyPS0
12. In the rootfs partition of your SD card, open up etc/securetty for editing. If ttyPS0 isn't there, add it. If tty1 isn't there, add it.
13. In the rootfs partition of your SD card, open up etc/apt/apt.conf for editing. If you need to use a proxy server, then add lines that look like:
    • Acquire::http::proxy "<your proxy server>:<port #>/";
    • Acquire::https::proxy "<your proxy server>:<port #>/";
14. To get started, let’s set apt up to just get the minimal required packages:
    • APT::Install-Recommends "0";
    • APT::Install-Suggests "0";
15. In the rootfs partition of your SD card, open up etc/network/interfaces. If missing, add this line:
    • iface eth0 inet dhcp
16. Execute the "sync" command to flush everything that needs to be written. When it completes, eject the SD card and but do not put it in your ZC702 board yet.
17. Make sure you have the console connected to the UART on your ZC702 board. Cutecom can be used on a Linux workstation. Power on the board with no SD card so that it can get detected & then power it off.
    • dmesg | grep ttyUSB -> look for which /dev/ttyUSBn has the USB UART
    for the "n" you found above, sudo chmod 666 /dev/ttyUSBn (otherwise you won't be able to make a connection). Connect to /dev/ttyUSBn in your console program
18. Put the SD card into the ZC702, make sure you are in SD boot mode, and turn it on. You should come up at tty1
19. Log in as root (password: linaro)
20. Disable console sleep:
    • setterm -blank 0 -powerdown 0 > /dev/tty1
21. Make sure the ZC702 is plugged in to Ethernet. Then execute
    • /usr/lib/klibc/bin/ipconfig eth0
22. Then you can start to get packages. Lubuntu-desktop is a lightweight desktop. Other options could be lubuntu-core, xubuntu-desktop, etc. Getting lubuntu-desktop installed takes a few hours. (This is why we don't want the Xylon IP timing out on us while installation is happening).
    • apt-get update
    • apt-get lubuntu-desktop
23. After the installation is complete, use the "reboot" command to reboot. You should come back up to the login prompt. You can log in as user linaro (password linaro).