Create and Build OpenAMP Applications in Vitis (Unified IDE) - 2025.1 English - UG1186

Libmetal and OpenAMP User Guide (UG1186)

Document ID
UG1186
Release Date
2025-05-29
Version
2025.1 English
  1. Start AMD Vitis™ unified software platform.
  2. Create BSP: File > New Component > Platform
    1. Select Name and Location.
    2. Select Design.
    3. Select Standalone for Operating System.
    4. Select Processor.
    5. Select Finish.
  3. Add Libmetal and OpenAMP Libraries.
    1. In Vitis Components View select the created platform > processor > domain > Board Support Package
      1. Check Libmetal and OpenAMP libraries.
      Note: To Build OpenAMP RPC demo such that the demo uses OpenAMP provided proxy information, do the following:

      After 3: Navigate to Vitis Components View select the created platform processor > domain > Board Support Package > openamp and set the flag OPENAMP_WITH_PROXY to true.

      Note: To use external repo for OpenAMP or Libmetal libraries, use the following steps:
      1. Create a new directory with the following structure:
        'libmetal' or 'openamp'
        - data
        - src
        
      2. Within data, copy over the YAML at https://github.com/xilinx/embeddedsw/blob/xlnx_rel_v2025.1/ThirdParty/sw_services/openamp/data/openamp.yaml or https://github.com/xilinx/embeddedsw/blob/xlnx_rel_v2025.1/ThirdParty/sw_services/libmetal/data/libmetal.yaml.
      3. Within src:

        copy over your modified copy of the OpenAMP or Libmetal Repo.

        copy over the sdt directory from the https://gitenterprise.xilinx.com/embeddedsw/embeddedsw/tree/master/ThirdParty/sw_services/libmetal/src/sdt.

      4. Point to your local copy: AMD Vitis™ > Embedded SW Repositories > Local Repositories > click '+' > add top level new directory that has data and src therein. Next click OK.
      5. Click 'Rescan Repositories'.
      6. When adding library below, select your local copy from the drop down menu.
  4. Build BSP: View > Flow then click Build in the flow view.
  5. Create Application: File > New Component > From Examples then select one of the following new components supported demos:
    • OpenAMP RPC Demo
    • OpenAMP matrix multiplication Demo
    • OpenAMD echo-test
    • Libmetal AMP Demo

    Select Create Application Component from Template > Next > Select platform with libraries > Next > Finish.

  6. Build Application: View > Flow. Select application project name then click Build in the flow view.