Libmetal and OpenAMP User Guide (UG1186) - 2025.2 English - Getting started guide for AMD OpenAMP framework. - UG1186

Document ID: UG1186
Release Date: 2025-11-26
Version: 2025.2 English

Overview
Introduction
Software Tools Requirements
Prerequisites
Introduction to the New Upstream remoteproc Driver
Attach-detach Feature in the remoteproc Subsystem
Libmetal
Overview
Access Devices with Libmetal
Start Libmetal Environment, Add, and Open the Devices
Register the Interrupt, Write, and Read Device Registers
Close Device and Close Libmetal Environment
Access IP Integrator and Shared Memory with Libmetal
Zynq UltraScale+ MPSoC IP Integrator Hardware
Shared Memory
AMD Libmetal AMP Demo
Build Libmetal Baremetal Firmware with AMD Vitis Unified IDE
Build Libmetal Firmware and Linux Application with Yocto Tools
Build Libmetal Linux Demo in AMD Vitis (Optional)
Build the Linux Demo Application and the Linux Project
Testing on Hardware
Straight Line Speculation Vulnerability
OpenAMP
Overview
Components in OpenAMP
Connection between OpenAMP and Libmetal
Writing a Simple OpenAMP Application
OpenAMP Demos
OpenAMP Quick Try
Building and Booting OpenAMP Images
Linux Boot from U‑Boot and OpenAMP Application Run
Running the Demos
Demo to Run Zephyr on R52-0 for Versal-2ve-2vm
Building OpenAMP Application for RPU Firmware
Introduction
Building Remote Applications in AMD Vitis
Create and Build OpenAMP Applications in Vitis (Unified IDE)
OpenAMP AMD Vitis Key Source Files
Running the Example Applications
Running the Echo Test
Debugging an OpenAMP Application
Debugging RPU Firmware
Running the Matrix Multiplication Test
Running the Proxy Application
Creating a Boot.bin File
Testing on Hardware
Deprecated Platforms for OpenAMP
System Design Consideration
Supported Configuration
Other Considerations
Known Limitations
Linux RPMsg Buffer Size
Known Issues
After a Software Reboot, Remoteproc RPU Start/Stop Fails
OpenAMP Custom Subsystem Use Case: Start/Stop Failure and False Attach Occurrence
Libmetal APIs
Libmetal API Functions
OpenAMP APIs
OpenAMP library APIs
Additional Resources and Legal Notices
Finding Additional Documentation
Support Resources
References
Revision History
Please Read: Important Legal Notices

Back to home page