Build Images using PetaLinux 2018.1

1. Download and Install PetaLinux - 2018.1.
2. Based on the Evaluation board, download the ZCU102 BSP (prod-silicon) or ZCU102 Rev 1 ES2.

3. Refer UG1144 Petalinux Tools Reference Guide, to create a PetaLinux Project using appropriate BSP projects

   petalinux-create -t project -s <BSP_Project>

4. SATA is enabled by default in the Board templates used in PetaLinux BSP.

5. In PetaLinux Project, add following in platform-auto.h file to enable sataboot from u-boot.

   cd <petalinux-project>

• "sata_root=if test $scsidevs -gt 0; then setenv bootargs $bootargs root=/dev/sda rw rootfstype=ext4; fi\0" \
  "sataboot=scsi scan &&&& load scsi 0 ${netstart} ${kernel_img} &&&& bootm\0" \

• <Petalinux-Project>/project-spec/meta-plnx-generated/recipes-bsp/u-boot/configs/platform-auto.h

1. The first line sets bootargs to instruct the Linux kernel to find the root filesystem located on the SATA disk. This has no effect for default PetaLinux configuration as the default RootFS for PetaLinux is INITRAMFS. INITRAMFS (Initial RAM File System) is the successor of initrd. It is a cpio archive of the initial file system that gets loaded into memory during the PetaLinux startup process. The Linux kernel mounts it as RootFS and starts the initialization process.
2. The second line is to enable sataboot environment settings for u-boot.
3. Save and exit.
4. build PetaLinux project using petalinux-build command.
5. While PetaLinux builds, create an EXT (preferably EXT4) partition in the SATA disk.
6. Once built successfully, copy image.ub file from <petalinux-project>/images/linux/image.ub to EXT Partition of SATA disk.

7. Use following command to Create a Boot Image with partitions viz. FSBL, U-boot, PMU Firmware (PMUFW), and ATF (bl31.elf).

   cd <petalinux-project>/
   petalinux-package --boot --fsbl images/linux/zynqmp_fsbl.elf --u-boot

8. Copy the BOOT.BIN image to SD Card.

Build Images using PetaLinux 2016.4

petalinux-create -t project -s <BSP_Project>

1. build PetaLinux project using petalinux-build command.
2. While PetaLinux builds, create an EXT (preferably EXT4) partition in the SATA disk.
3. Once built successfully, copy Image file (<petalinux-project>/images/linux/Image) and the device tree file (<petalinux-project>/images/linux/system.dtb) to EXT Partition of SATA disk.

U-Boot 2016.4

Build Boot Image for 2016.4

Configuring the Board

Attaching the Hard Disk

1. Connect a Serial ATA (SATA) data cable from the SATA connector (P9) to your hard disk.
2. Connect a 4-pin ATX-to-SATA power cable from the 4-pin ATX power connector (J10) to your hard disk.
3. Insert the SD Card into the SD card slot on board.
4. Set SW6 Boot Switch to SD Boot mode (i.e. 1-ON 2-OFF 3-OFF 4-OFF).

Booting

1. Attach a micro-USB cable between the host PC and USB UART connector (J83) on the ZCU102.
2. Open the UART0 interface using a terminal emulation tool such as TeraTerm or PuTTY.
3. Power cycle the board or perform a system reboot with the POR_B (SW4) pushbutton
4. Once the board boots into U-Boot, ensure that the SATA interface is configured properly by using the following command:

scsi scan

run sataboot

Vivado Hardware Definition

1. SATA is enabled by default in Vivado 2018.1 Board files. Same holds true for the Default ZCU102 Board Template HDF used in Petalinux 2018.1 and SDK 2018.1.
2. Download and install the Vivado design tools.
3. Launch Vivado and create a new project using the ZCU102 Rev1.0 or RevD as the board template. If you do not see the ZCU102 listed in the available boards, double-check the installation steps above before proceeding
4. Once the project is created, create a new Vivado Block Diagram.
5. In the Block Diagram, right-click and select "Add IP"
   
6. In the search box that appears, type "Zynq" to filter to the "Zynq UltraScale+ MPSoC" IP. Press ENTER or double-click to select the IP and add it to the block diagram.
   
7. Once the Zynq UltraScale+ MPSoC IP is added to the block diagram, click on the Run Block Automation option at the top of the block diagram to automatically configure the Zynq block based on the board-level options. Once the board automation is complete, manually route the clock signal from the pl_clk0 pin to the maxihpm0_fpd_aclk and maxihpm1_fpd_aclk pin.
   
8. Double-click on the Zynq UltraScale+ MPSoC IP block to open the Re-customize IP GUI. Then, select I/O Configuration and expand the High Speed portion of the tree as shown. Note that SATA Lane 1 is enabled by default. Note that SATA Lane 1 on GT Lane 3 is the only valid configuration for SATA on the ZCU102.
   
9. When you are finished customizing the IP, click the OK button at the bottom of the GUI window.
10. In the main Vivado cockpit, select the Source tab in the Sources pane. Then, right-click on the block diagram .bd file (named design_1.bd by default unless you selected a different name for you block diagram) and select Create HDL Wrapper... When prompted, use the option Let Vivado manage wrapper and auto-update.
11. After the wrapper is created, click the option Run Implementation in the Flow Navigator pane on the Vivado cockpit. This process will take approximately 5 to 10 minutes to complete depending on the processing speed of your workstation.
12. After the implementation process is complete, select the Open Implemented Design option.
13. Next, select File-> Export-> Export Hardware to export the hardware design to a directory that you intend to use for the XSDK workspace. By default, this directory is inside the Vivado workspace but it can be located anywhere on disk. Since this design does not include a bitstream the Include Bitstream option can remain unchecked.
14. Launch XSDK by using File-> Launch SDK. Be sure to select the appropriate directory locations for the "Exported location" and "Workspace" options.

First Stage Boot Loader (FSBL)

1. Create a First Stage Boot Loader application project that targets either the APU CPU#0 or RPU CPU#0.
2. Build the FSBL application by right-clicking on the application and selecting Clean Project followed by Build Project.

PMU Firmware

Device Tree Compiler

ARM Trusted Firmware

Building the Final Boot Image

//arch = zynqmp; split = false; format = BIN
the_ROM_image:
{
    [fsbl_config]a53_x64
    [bootloader]fsbl_a53.elf
    [pmufw_image]pmufw.elf
    [destination_cpu = a53-0, exception_level = el-3, trustzone]bl31.elf
    [destination_cpu = a53-0, exception_level = el-2]u-boot.elf
}