PLM Interface (XilPLMI) - 2021.2 English

Versal ACAP System Software Developers Guide (UG1304)

Document ID
UG1304
Release Date
2021-10-27
Version
2021.2 English

The PLM Interface (XilPLMI) is a low-level interface layer for the PLM main application and other PLM modules. XilPLMI provides the common functionality required for the modules that run with PLM. Each new module can register itself with the supported command handlers. These command handlers are executed based on the request received from other modules or from other subsystems.

XilPLMI also includes the CDO parser that parses and executes any CDO commands. XilPLMI implements the Generic Module that includes generic commands to be used by all other modules. The XilPLMI layer provides:

  • Interface for parsing CDO files
  • Implementation for general PLM CDO commands
  • Interface to register handlers for commands that can be part of CDO and IPI
  • Interface to set error actions and register notifications for error events
  • Interface to schedule timer events
  • Debug print levels and common utilities
Task Dispatcher Loop
XilPLMI uses a very simple run-to-completion, time-limited priority task loop model, to get real-time behavior. The main program is a simple loop that looks up the next task from a queue of tasks, and calls the function to execute the task.

This model is simple in the sense that because all tasks are executed until they are done, there are no critical regions and no locking needed. Any code in the PLM can access any global data without having to worry about any other tasks being in the middle of updating the data.

The complexity with the run-to-completion model comes when a particular task needs to run longer than for the maximum allowed time limit (GTL). If that happens, split the tasks into multiple events.

Figure 1. Task Dispatch Loop
Modules
XilPLMI provides an interface layer for modules to register the commands for PLM. Commands can come from the CDO or IPI.
Configurable Parameters
Modules
Configurable to include or exclude modules, boot drivers based on your needs.
Debug Prints
Configurable to include multiple levels of print statements. For more information, refer to PLM Build Flags.
CDO
The CDO file contains the configuration information generated by the tools in the form of CDO commands. The module that supports the CDO registers itself to the PLM during the module initialization phase. XilPLMI provides the API to parse the CDO file and propagates the commands and its payload to the respective modules.
IPI Handling
The PLM handles IPI interrupts, so that messages can be exchanged between the PLM and other processor on the Versal device. Data that is sent through IPI follows the CDO format.
Scheduler
This is a simple timer-based function scheduler to support execution of periodic tasks. A scheduler is required by modules such as XilSEM to support periodic tasks such as SEU detection scan operations.
Note: Accuracy of the PMC IRO clock affects the scheduler accuracy.
PLM Watchdog Timer
PLM has the framework to update the PLM health periodically. PLM toggles multiplexed I/Os (MIO) to update health to an external watchdog timer (WDT). The PMC MIO is preferred but if an LPD MIO is used, then it is important to note that this WDT will be disabled when the PS LPD goes down.

The WDT can be enabled in the Vivado CIPS, and CIPS generates all the preceding required commands to enable WDT in PLM.

The PLM WDT can be enabled by using the SetWdt CDO command with the parameters MIO PIN and periodicity. Before running the SetWdt CDO command, ensure that MIO is configured as GPIO and load the corresponding PMC / LPD CDO. PDI loading is considered as the configuration mode and WDT is not supported in the configuration mode. Other operations considered as configuration mode are boot, partial PDI loading, and subsystem restart/resume. The minimum periodicity is 20 ms.

The PLM implementation is as follows:

Normal Context
  • PLM will set a variable to indicate ALIVE in between every task.
  • During PDI load, the PLM mode is set to the configuration mode, and then reset to operational mode when the PDI is loaded.
  • If the LPD MIO is used, the WDT is disabled during LPD shutdown.
  • If any task takes longer than the WDT periodicity, the ALIVE bit will be set and external WDT can reset the device.
Interrupt Context
  • Current scheduler period is 10 ms. This period indicates that for every 10 ms, the PLM gets a timer interrupt to schedule the tasks.
  • The WDT handler is called in the scheduler.
  • When the WDT is enabled, the WDT handler performs following operation periodically based on configured periodicity (for example, for a periodicity of 100 ms, the following tasks run ~10 ms before expiry of periodicity)
    • When in configuration mode, the WDT handler toggles the MIO pin irrespective of the PLM alive status.
    • When in operation mode, the WDT handler toggles the MIO pin only when PLM alive status is set and clear the PLM alive status.
Table 1. Set PLM WDT
Command: Set PLM WDT
Reserved [31:24]=0 Length [23:16]=2 PLM=1 CMD_SET_PLM_WDT=22
NODE Idx - PMC MIO PIN / LPD MIO PIN
[31:16] Reserved [15:0] Periodicity in ms - Default = 100 ms