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

Libmetal and OpenAMP User Guide (UG1186)

Document ID
UG1186
Release Date
2024-06-26
Version
2024.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 will use 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 flag 'OPENAMP_WITH_PROXY' to true.

      Note: To Use External Repo for OpenAMP or Libmetal libraries use the following steps:
      1. Create 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_v2024.1/ThirdParty/sw_services/openamp/data/openamp.yaml or https://github.com/xilinx/embeddedsw/blob/xlnx_rel_v2024.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 dropdown.
  4. Build BSP: View > Flow > Click 'Build' In Flow View.
  5. Create Application: File > New Component > From Examples > Select one of the following:
    Table 1. New Components Supported Demos
    Name
    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 > Click 'Build' In Flow View.