Page History

...

...

For general structure and of the reference design, see Project Delivery - Xilinx AMD devices

Design Sources

...

Trenz Electronic provides a tcl based built environment based on Xilinx Design Flow.

See also:

• Xilinx AMD Development ToolsTools#XilinxSoftware-BasicUserGuides
• Vivado Projects - TE Reference Design
• Project Delivery.

The Trenz Electronic FPGA Reference Designs are TCL-script based project. Command files for execution will be generated with "_create_win_setup.cmd" on Windows OS and "_create_linux_setup.sh" on Linux OS.

TE Scripts are only needed to generate the vivado project, all other additional steps are optional and can also executed by Xilinx Vivado/SDK GUI.  For currently Scripts limitations on Win and Linux OS see: Project Delivery Currently limitations of functionality

1. _create_win_setup.cmd/_create_linux_setup.sh and follow instructions on shell:
   
2. Press 0 and enter to start "Module Selection Guide"
3. (optional Win OS) Generate Virtual Drive or use short directory  for the reference design (for example x:\<design name>)
4. Create Project (follow instruction of the product selection guide), settings file will be configured automatically during this process)
   
   1. (optional for manual changes) Select correct device and Xilinx install path on "design_basic_settings.cmd" and create Vivado project with "vivado_create_project_guimode.cmd"
      Note: Select correct one, see alsoTE Board Part Files
      1. Important: Use Board Part Files, which ends with *_tebf0808
5. Create XSA and export to prebuilt folder
   
   1. Run on Vivado TCL: TE::hw_build_design -export_prebuilt
      Note: Script generate design and export files into \prebuilt\hardware\<short dir>. Use GUI is the same, except file export to prebuilt folder
6. Create Linux (bl31.elf, uboot.elf , Image and system.dtb) with exported XSA
   
   1. XSA is exported to "prebuilt\hardware\<short name>"
      Note: HW Export from Vivado GUI create another path as default workspace.
   2. Create Linux images on VM, see PetaLinux KICKstart
      1. Use TE Template from /os/petalinux/
      2. Execute the script file for Debian/Ubuntu
7. Add Linux files (bl31.elf, uboot.elf , Image and system.dtb) to prebuilt folder
   
   1. "prebuilt\os\petalinux\<ddr size>" or "prebuilt\os\petalinux\<short name>"
8. Generate Programming Files with Vitis
   
   1. Run on Vivado TCL: TE::sw_run_vitis -all
      Note: Scripts generate applications and bootable files, which are defined in "sw_lib\apps_list.csv"
   2. (alternative) Start SDK with Vivado GUI or start with TE Scripts on Vivado TCL: TE::sw_run_vitis
      Note:  TCL scripts generate also platform project, this must be done manuelly in case GUI is used. See Vitis
9. Preparing SD card for SD Filesystem and hard disk for HD Filesystem → See Programming section

...

Xilinx documentation for programming and debugging: Vivado/SDK/SDSoC-Xilinx Software Programming and Debugging

Get prebuilt boot binaries

...

1. Format the SD Card with SD Card Formatter or other tool
2. Write the Debian image or Ubuntu image file on SD Card with Win32DiskImager
3. select the device tree depending on your ROOTFS location: It will automatically in BOOT directory two DTB file generated
   
   1. system_sd.dtb : This file ist used , if the root file system is located on SD card.
   2. system_harddisk.dtb : This file ist used , if the root file system is located on hard disk.
   3. Note: To use one of the DTB files, this file must be renamed to system.dtb
4. Rename the system_sd.dtb file in BOOT directory to system.dtbselected device tree to system.dtb  (for Hard Disk usage, see also "Hard Disk (optional)")
5. Copy Petalinux  Image (not use image.ub), system.dtb and Boot.bin files on SD-Card.
   • use files from (<project foler>/_binaries_<Articel Name>)/boot_linux from generated binary folder,see: Get prebuilt boot binaries
   • or use prebuilt file location, see <design_name>/prebuilt/readme_file_location.txt
6. Set Boot Mode to SD-Boot.
   • Depends on Carrier, see carrier TRM.
7. Insert SD-Card in SD-Slot.

...

1. Plug in SD Card that you have prepared mit root file systemIt will automatically in BOOT directory two DTB file generated
2. Plug in Hard Disk in Sata port on the carrier board
3. Format the hard disk by the following command:
   1. mkfs.ext4 /dev/sda
4. Edit the fstab file in directory /etc/ to mount hard disk by the following commands:
   1. mkdir /media/harddisk
   2. nano /etc/fstab
   3. Add this line to the fstab file and save it : /dev/sda  /media/harddisk/   defaults  0  3
   4. Reboot
5. Copy entire root file system in direcroty directory ROOTFS from SD card to hard disk by the following commands:
   1. cd /media/ROOTFS
   2. cp -r ./ /media/harddisk
6. Edit the fstab file in directory /media/harddisk/etc/ by the following commands and save it:
   1. nano /media/harddisk/etc/fstab
   2. Edit this line to the fstab file : /dev/sda  /media/harddisk/   defaults  0  1
   3. Comment this line: #/dev/mmcblk1p2   /media/ROOTFS     defaults  0  1
7. Shutdown the system
8. Format the SD card
9. Rename the Device Tree Blob file system_harddisk.dtb to system.dtb
10. Copy the following files to SD Card:
    1. Image
    2. BOOT.bin
    3. system.dtb
11. Plug in the SD Card and turn on the system

...

...