Payload Mapping for API Calls to PMC - 2023.2 English

Versal Adaptive SoC System Software Developers Guide (UG1304)

Document ID
UG1304
Release Date
2023-10-18
Version
2023.2 English

The following data uniquely identifies each EEMI API call:

  • EEMI API identifier (ID)
  • EEMI API arguments

See BSP and Libraries Document Collection (UG643) for a list of all API identifiers as well as API argument values.

Before initiating an IPI to the PMC, the PU writes the information about the call into the IPI request buffer. Each data written into the IPI buffer is a 32-bit word. Total size of the payload is six 32-bit words—one word is reserved for the EEMI API identifier, while the remaining words are used for the arguments. Writing to the IPI buffer starts from offset zero. The information is mapped as follows:

  • Word [0] EEMI API ID
  • Word [1:5] EEMI API arguments

The IPI response buffer is used to return the status of the operation as well as up to three values.

  • Word [0] success or error code
  • Word [1:3] value 1..3