Table of Contents

Prerequisites

  1. You have a ZCU102 development board.
  2. You have used the SDK to build.

PM Hello World

This is an empty application that does PM initialization and prints "Hello World!" to the UART. Please use this as a starting point for creating new PM applications for other design examples provided here.
Steps to create and build this example
  1. Download these source files.
    For SDK 2017.4 and older version: hello_source_2017_4.zip
    For SDK 2018.1 and newer version: hello_source_2017_4.zip

  2. Extract the zip file. The source directory contains application main.c file and other required files.
  3. Start Xilinx SDK 2017.1.
  4. Go to File → New Application Project.
  5. Give a project name Ex. Hello-world.


  6. Select standalone in OS Platform category. Select ZCU102_hw_platform in Hardware Platform category. Select appropriate processor (e.g. psu_cortextr5_0) from the processor list. Then select next.
  7. Select empty application from the template then select finish to create project. Wait for the BSP to complete building before proceeding.
  8. Now from system.mss file click on “Modify this BSP's Settings”. Select xilpm library from Board Support Package Settings dialog box and click OK. Re-generate BSP Sources.


  9. Now right click on hello-world from Project Explorer window, select Properties from drop-down menu and go to Resource. A location of the project will be displayed.
  10. Go to that location, a folder named “src” will be present. Copy all the files extracted from source.zip file into src folder. Refresh the project by right clicking on hello-world from Project Explorer and selecting refresh option.
  11. From the Project Explorer window, right click on hello-world, select Properties, expand C/C++ General, and go to Paths and Symbols.


  12. Add ../hello-world/src path in includes section. Click OK.
  13. Hello-world example will be build automatically.


Configuration Object

Configuration Object file Generated by PetaLinux tool chain and Vivado is attached below.
pm_cfg_obj.c

Note: Add this file in the src folder of the application in order to use configuration object.

Subsystems -
1) Linux Subsystem
Master -
  1. APU
Slaves -
  1. DDR
  2. L2 Cache
  3. OCM Bank 0, 1, 2 and 3
  4. I2C0
  5. I2C1
  6. SD1
  7. QSPI
  8. PL

2) R5-0 Subsystem
Master -
  1. RPU0
Slaves -
  1. TCM Bank 0 - A
  2. TCM Bank 0 - B

3) R5-1 Subsystem
Master -
  1. RPU1
Slaves -
  1. TCM Bank 1 - A
  2. TCM Bank 1 - B


RPU to run from TCM

By default, RPU applications are compiled to run from the DDR memory. In many cases, it may be desirable to run RPU applications from the TCM. For example, when the APU is not running, the RPU may run from the TCM so that the DDR can be powered down or put into retention mode to save power.

Steps to modify code memory
  1. Open lscript.ld file.
  2. Navigate to "Section to Memory Region Mapping" and select "psu_r5_0_atcm_MEM_0" memory region for all sections as shown below.
    (Default HDF has split mode, So RPU will run in split mode. If RPU running in split mode than user has to select "psu_r5_0_atcm_MEM_0" or "psu_r5_0_btcm_MEM_0". If RPU running in lock step mode than user has to select "psu_r5_tcm_ram_0_MEM_0".)
  3. If RPU is running in split mode, it may happen that application doesn't fit into default memory region. For that user may need to divide the sections for ATCM and BTCM memory regions in lscript.ld file. For more information please see Table 4-5: TCM Address Map in TRM. When running in split mode, each R5 processor has 64KB ATCM and 64KB BTCM. So user has to divide sections across ATCM and BTCM as per below snapshot (vectors and text sections are in ATCM and other sections are in BTCM)
  4. Save lscript.ld file and clean build the project.

Note: To run this example on board, FSBL and PMU needs to be run along with application elf.