xilplmi
Vitis Drivers API Documentation
xplmi.c File Reference

Overview

This file contains the PLMI module register functions.

MODIFICATION HISTORY:
Ver   Who  Date        Changes
----- ---- -------- -------------------------------------------------------
1.00  kc   02/07/2019 Initial release
1.01  ma   08/01/2019 Added LPD init code
1.02  kc   02/19/2020 Moved code to support PLM banner from PLM app
      bsv  04/04/2020 Code clean up
1.03  bsv  07/07/2020 Made functions used in single transaltion unit as
                                        static
      kc   07/28/2020 Moved LpdInitialized from xplmi_debug.c to xplmi.c
      bm   09/08/2020 Added RunTime Configuration Init API to XPlmi_Init
      bm   10/14/2020 Code clean up
      td   10/19/2020 MISRA C Fixes
1.04  bm   10/28/2020 Added ROM Version Print
      har  03/17/2021 Added code for run time initialization of Secure State
                      registers
      ma   03/24/2021 Print early logs
      bm   03/24/2021 Added RTCA initialization for Error Status registers
      har  03/31/2021 Added RTCA initialization for PDI ID
      bsv  04/16/2021 Add provision to store Subsystem Id in XilPlmi
      bm   05/05/2021 Added USR_ACCESS support for PLD0 image
      ma   05/21/2021 Copy secure boot state from PMC GLOBAL GEN STORAGE2
                      register to RTCA Secure State offset
1.05  td   07/08/2021 Fix doxygen warnings
      bsv  07/18/2021 Print PLM banner at the beginning of PLM execution
      bsv  07/24/2021 Clear RTC area at the beginning of PLM
      bsv  08/02/2021 Code clean up to reduce elf size
      rb   07/29/2021 Update reset reason during Init
      ma   08/23/2021 Do not clear Debug Log RTCA memory
      ma   09/13/2021 Set PLM prints log level during RTCA init
      tnt  11/11/2021 Add RTCA initialization for MIO Flush routine
      tnt  12/17/2021 Add RTCA initialization for PL_POR HDIO WA
1.06  bm   07/06/2022 Refactor versal and versal_net code
      kpt  07/19/2022 Added APIs to update or get KAT status from RTC area
      bm   07/22/2022 Update EAM logic for In-Place PLM Update
1.07  ng   11/11/2022 Updated doxygen comments
      kpt  01/04/2023 Added XPlmi_SetFipsKatMask command
      bm   01/14/2023 Remove bypassing of PLM Set Alive during boot
      bm   03/11/2023 Added status check for XPlmi_PreInit
1.08  sk   07/18/2023 Warn out for uart init fail
      sk   07/26/2023 Added redundant check for XPlmi_IsPlmUpdateDone
      dd   09/12/2023 MISRA-C violation Rule 10.3 fixed
1.09  ma   10/10/2023 Enable Slave Error for PSM_GLOBAL
      ng   01/28/2024 optimized u8 variables
      sk   02/18/2024 Added DDRMC Calib Check Status RTCA Register Init
      ng   03/20/2024 Added print to UART on log buffer full after LPD init
1.10  sk   06/05/2024 Added code to populate PLM version in RTCA Reg
      mss  06/13/2024 Added timestamp banner conditionally
      bm   07/15/2024 Fixed timestamp print in banner
1.11  sk   02/20/2025 Added EAM error config in LPDSLCR for Versal 2VE
                      and 2VM Devices
Note

Functions

int XPlmi_Init (void)
 This function will initialize the PLMI module. More...
 
int XPlmi_RunTimeConfigInit (void)
 This function initializes the Runtime Configuration Area with default values. More...
 
void XPlmi_LpdInit (void)
 This function calls all the PS LPD init functions of all the different modules. More...
 
void XPlmi_PrintPlmBanner (void)
 This function prints PLM banner. More...
 
void XPlmi_ResetLpdInitialized (void)
 This function resets LpdInitialized variable to 0. More...
 
void XPlmi_SetLpdInitialized (u32 Flag)
 This function sets LpdInitialized variable with given flag. More...
 
void XPlmi_UnSetLpdInitialized (u32 Flag)
 This function clears LpdInitialized variable with given flag. More...
 
void XPlmi_UpdateKatStatus (u32 PlmKatStatus)
 This function sets XPLMI_RTCFG_PLM_KAT_ADDR with PlmKatStatus. More...
 
u32 XPlmi_GetKatStatus (void)
 This function is called to get KAT status. More...
 
void XPlmi_SetKatMask (u32 PlmKatMask)
 This function sets XPLMI_RTCFG_PLM_KAT_ADDR with PlmKatMask. More...
 
void XPlmi_ClearKatMask (u32 PlmKatMask)
 This function clears XPLMI_RTCFG_PLM_KAT_ADDR with PlmKatMask. More...
 
u32 XPlmi_IsCryptoKatEn (void)
 This function will return the crypto kat enable status from efuse cache. More...