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

Libmetal and OpenAMP User Guide (UG1186)

Document ID
UG1186
Release Date
2026-06-24
Version
2026.1 English
  1. Launch the AMD Vitis™ unified software platform.
  2. In Vitis, click File > New Component > Platform
    1. Enter the name and location for the BSP.
    2. Select the design.
    3. For the operating system, select Standalone.
    4. Select the processor.
    5. Click Finish.
  3. Add the Libmetal and OpenAMP libraries.
    1. In the Vitis components view, select the created platform: Processor > Domain > Board Support Package.
    2. Check the boxes for the Libmetal and OpenAMP libraries.
      Note: You can optionally build an OpenAMP RPC demo that uses the OpenAMP provided proxy information. To do this, follow these instructions:
      1. Navigate to the Vitis components view.
      2. Select the created platform by clicking processor > domain > Board Support Package > openamp.
      3. Set the OPENAMP_WITH_PROXY flag to true.
      Note: To use an external repository for OpenAMP or Libmetal libraries, use the following steps:
      1. Create a new directory with the following structure:
        'libmetal' or 'openamp'
        - data
        - src
        
      2. Inside the data folder, copy the YAML from the openamp.yaml or libmetal.yaml GitHub repositories.
      3. Inside the src folder, copy your modified version of the OpenAMP or Libmetal repository and the sdt directory from the libmetal/src/sdt GitHub repository.
      4. Point Vitis to your local copy: Vitis > Embedded SW Repositories > Local Repositories. Click + to add the top level new directory with data and src inside and then click OK.
      5. Click Rescan Repositories.
      6. When adding the library, select the local copy from the drop down menu.
    Note: Instead of adding external libraries to Vitis, you should clone the upstream Libmetal and OpenAMP libraries and build them with native CMake.
  4. Build the BSP in the flow view by clicking Build in the View > Flow view.
  5. Create the application by selecting File > New Example > Libmetal AMP Demos.
    Note: OpenAMP demos (RPC, matrix multiplication, and echo-test) run only on Zynq UltraScale+ MPSoCs and Versal AI Core Series evaluation kits, and only with FreeRTOS.
  6. Select Example Application > Select Platform > Next > Select Domain > Finish.
  7. Build the application by selecting the application project mode in the View > Flow menu. Click Build in the flow view.