1 /* 2 * Copyright (C) 2013, Intel Corporation 3 * Copyright (C) 2014, Bin Meng <bmeng.cn@gmail.com> 4 * 5 * SPDX-License-Identifier: Intel 6 */ 7 8 #ifndef __FSP_API_H__ 9 #define __FSP_API_H__ 10 11 #include <linux/linkage.h> 12 13 /* 14 * FSP common configuration structure. 15 * This needs to be included in the platform-specific struct fsp_config_data. 16 */ 17 struct fsp_cfg_common { 18 struct fsp_header *fsp_hdr; 19 u32 stack_top; 20 u32 boot_mode; 21 }; 22 23 /* 24 * FspInit continuation function prototype. 25 * Control will be returned to this callback function after FspInit API call. 26 */ 27 typedef void (*fsp_continuation_f)(u32 status, void *hob_list); 28 29 struct fsp_init_params { 30 /* Non-volatile storage buffer pointer */ 31 void *nvs_buf; 32 /* Runtime buffer pointer */ 33 void *rt_buf; 34 /* Continuation function address */ 35 fsp_continuation_f continuation; 36 }; 37 38 struct common_buf { 39 /* 40 * Stack top pointer used by the bootloader. The new stack frame will be 41 * set up at this location after FspInit API call. 42 */ 43 u32 stack_top; 44 u32 boot_mode; /* Current system boot mode */ 45 void *upd_data; /* User platform configuraiton data region */ 46 u32 reserved[7]; /* Reserved */ 47 }; 48 49 enum fsp_phase { 50 /* Notification code for post PCI enuermation */ 51 INIT_PHASE_PCI = 0x20, 52 /* Notification code before transfering control to the payload */ 53 INIT_PHASE_BOOT = 0x40 54 }; 55 56 struct fsp_notify_params { 57 /* Notification phase used for NotifyPhase API */ 58 enum fsp_phase phase; 59 }; 60 61 /* FspInit API function prototype */ 62 typedef asmlinkage u32 (*fsp_init_f)(struct fsp_init_params *params); 63 64 /* FspNotify API function prototype */ 65 typedef asmlinkage u32 (*fsp_notify_f)(struct fsp_notify_params *params); 66 67 #endif 68