Step Seven: Validate Your YAML - Step Seven: Validate Your YAML - 2026.1 English - UG1186

Libmetal and OpenAMP User Guide (UG1186)

Document ID
UG1186
Release Date
2026-06-24
Version
2026.1 English

Check for these common mistakes:

  • Mismatched region names: the vring and buffer names in carveouts must exactly match the node names in reserved-memory.
  • Missing no-map: 1: every shared reserved-memory entry must have no-map: 1.
  • IPI channel naming: the host and remote mbox values must refer to opposite ends of the same IPI channel pair.
  • remote and host confusion: the host domain uses remote: in its relations; the remote domain uses host:.
  • xlnx,ddr-boot correctness: must be true for OpenAMP IPC remote domains on R52 (XCVN3716 devices, Versal AI Edge Series Gen 2). Must be false (or omitted) for libmetal IPC remote domains, because PLM loads the firmware through TCM boot from Boot PDI. Do not set on R5 platforms.
  • TCM names: must exactly match the node labels in the system device tree. These differ between SoC families, for example, psu_r5_0_atcm_global on AMD Zynq™ UltraScale+™ MPSoCs and r52_0a_atcm_global on Versal AI Edge Series Gen 2.