IntelFsp2Pkg/FspSecCore/X64/Fsp22ApiEntryS.nasm

   1 ;; @file
   2 ;  Provide FSP API entry points.
   3 ;
   4 ; Copyright (c) 2022, Intel Corporation. All rights reserved.<BR>
   5 ; SPDX-License-Identifier: BSD-2-Clause-Patent
   6 ;;
   7
   8     SECTION .text
   9
  10 ;
  11 ; Following functions will be provided in C
  12 ;
  13 extern ASM_PFX(FspApiCommon)
  14 extern ASM_PFX(FspMultiPhaseSiInitApiHandler)
  15
  16 STACK_SAVED_RAX_OFFSET       EQU   8 * 7 ; size of a general purpose register * rax index
  17
  18 ;----------------------------------------------------------------------------
  19 ; NotifyPhase API
  20 ;
  21 ; This FSP API will notify the FSP about the different phases in the boot
  22 ; process
  23 ;
  24 ;----------------------------------------------------------------------------
  25 global ASM_PFX(NotifyPhaseApi)
  26 ASM_PFX(NotifyPhaseApi):
  27   mov    eax,  2 ; FSP_API_INDEX.NotifyPhaseApiIndex
  28   jmp    ASM_PFX(FspApiCommon)
  29
  30 ;----------------------------------------------------------------------------
  31 ; FspSiliconInit API
  32 ;
  33 ; This FSP API initializes the CPU and the chipset including the IO
  34 ; controllers in the chipset to enable normal operation of these devices.
  35 ;
  36 ;----------------------------------------------------------------------------
  37 global ASM_PFX(FspSiliconInitApi)
  38 ASM_PFX(FspSiliconInitApi):
  39   mov    eax,  5 ; FSP_API_INDEX.FspSiliconInitApiIndex
  40   jmp    ASM_PFX(FspApiCommon)
  41
  42 ;----------------------------------------------------------------------------
  43 ; FspMultiPhaseSiInitApi API
  44 ;
  45 ; This FSP API provides multi-phase silicon initialization, which brings greater
  46 ; modularity beyond the existing FspSiliconInit() API.
  47 ; Increased modularity is achieved by adding an extra API to FSP-S.
  48 ; This allows the bootloader to add board specific initialization steps throughout
  49 ; the SiliconInit flow as needed.
  50 ;
  51 ;----------------------------------------------------------------------------
  52
  53 %include    "PushPopRegsNasm.inc"
  54
  55 global ASM_PFX(FspMultiPhaseSiInitApi)
  56 ASM_PFX(FspMultiPhaseSiInitApi):
  57   mov    eax,  6 ; FSP_API_INDEX.FspMultiPhaseSiInitApiIndex
  58   jmp    ASM_PFX(FspApiCommon)
  59
  60 ;----------------------------------------------------------------------------
  61 ; FspApiCommonContinue API
  62 ;
  63 ; This is the FSP API common entry point to resume the FSP execution
  64 ;
  65 ;----------------------------------------------------------------------------
  66 global ASM_PFX(FspApiCommonContinue)
  67 ASM_PFX(FspApiCommonContinue):
  68   ;
  69   ; Handle FspMultiPhaseSiInitApiIndex API
  70   ;
  71   cmp    eax, 6
  72   jnz    NotMultiPhaseSiInitApi
  73
  74   PUSHA_64
  75   mov    rdx, rcx           ; move ApiParam to rdx
  76   mov    rcx, rax           ; move ApiIdx to rcx
  77   call   ASM_PFX(FspMultiPhaseSiInitApiHandler)
  78   mov    qword  [rsp + STACK_SAVED_RAX_OFFSET], rax
  79   POPA_64
  80   ret
  81
  82 NotMultiPhaseSiInitApi:
  83   jmp $
  84   ret
  85
  86 ;----------------------------------------------------------------------------
  87 ; TempRamInit API
  88 ;
  89 ; Empty function for WHOLEARCHIVE build option
  90 ;
  91 ;----------------------------------------------------------------------------
  92 global ASM_PFX(TempRamInitApi)
  93 ASM_PFX(TempRamInitApi):
  94   jmp $
  95   ret
  96
  97 ;----------------------------------------------------------------------------
  98 ; Module Entrypoint API
  99 ;----------------------------------------------------------------------------
 100 global ASM_PFX(_ModuleEntryPoint)
 101 ASM_PFX(_ModuleEntryPoint):
 102   jmp $
 103