ATF EL3 Runtime Service

1. 介绍
什么叫运行时服务了?干了写啥?下面听我慢慢道来.
在正常世界和安全世界中执行的软件低于EL3的级别将使用安全监视器请求运行时服务呼叫（SMC）指令。
运行时服务的接口和操作在很大程度上取决于[SMCCC]中描述的概念和定义，特别是SMC功能ID，所有实体号码（OEN），快速和标准呼叫以及SMC32和SMC64调用约定。常见的运行时服务框架确保将SMC功能调度到其各自的服务的实现。

SMC 功能表示符号包含一个ONE字段, 见下图,具体可以参考SMCC手册中有所描述。快速调用不可中断,而标准调用可以抢占。 大多数所有者实
体仅分配了快速调用的范围,标准调用仅为受信任的操作系统提供程序保留。

Type        OEN        Service
    Fast     0      ARM Architecture calls
    Fast     1      CPU Service calls
    Fast     2      SiP Service calls
    Fast     3      OEM Service calls
    Fast     4      Standard Service calls
    Fast    5-47    Reserved for future use
    Fast   48-49    Trusted Application calls
    Fast   50-63    Trusted OS calls

    Std     0- 1    Reserved for existing ARMv7 calls
    Std     2-63    Trusted OS Standard Calls

EL3 运行时服务框架使用调用类型和 OEN 来标识每个 SMC 调用的特定处理程序。

2. 揭开神秘面纱
ARM 可信固件在源树中有一个 services 目录,每个拥有实体可以在其中放置其运行时服务的实现。 PSCI 实现位于 lib / psci 目录中。运行时服务源将需要包括 runtime_svc.h 头文件。

3. 注册运行时服务
使用DECLARE_RT_SVC（）宏指定运行时服务服务的名称，所覆盖的OEN的范围，服务的类型和初始化和调用处理函数。
该宏用来在编译的时候将EL3中的service编译进rt_svc_descs段中，该宏定义如下：

 #define DECLARE_RT_SVC(_name, _start, _end, _type, _setup, _smch)

 static const rt_svc_desc_t __svc_desc_ ## _name \  
        __section("rt_svc_descs") __used = { \  
            .start_oen = _start, \  
            .end_oen = _end, \  
            .call_type = _type, \  
            .name = #_name, \  
            .init = _setup, \  
            .handle = _smch }  


 1. `_name` is used to identify the data structure declared by this macro, and is also used for diagnostic purposes
 2. `_start` and `_end` values must be based on the `OEN_*` values defined in [`smcc_helpers.h`]
 3. `_setup` is the initialization function with the `rt_svc_init` signature:
        typedef int32_t (*rt_svc_init)(void);
 4. _smch` is the SMC handler function with the `rt_svc_handle` signature:
        typedef uint64_t (*rt_svc_handle)(
         uint32_t smc_fid,
         uint64_t x1, uint64_t x2,
         uint64_t x3, uint64_t x4,
         void *cookie,
         void *handle,
         uint64_t flags);

start_oen：该service的起始内部number

end.oen: 该service的末尾number

call_type: 调用的smc的类型

name: 该service的名字

init: 该service在执行之前需要被执行的初始化操作

handle: 当触发了call type的调用时调用的handle该请求的函数

在初始化期间,服务框架验证每个声明的服务,以确保满足以下条件:
1. _start OEN 不大于_end OEN
2. _end OEN 不超过最大 OEN 值(63)
3. _type 是 SMC_TYPE_FAST 或 SMC_TYPE_STD 之一
4. 指定了_setup 和_smch 例程

std_svc_setup.c 提供了注册运行时服务的示例:

 /* 将标准服务注册到运行时服务*/
    DECLARE_RT_SVC(
            std_svc,
            OEN_STD_START,
            OEN_STD_END,
            SMC_TYPE_FAST,
            std_svc_setup,
            std_svc_smc_handler
    );

ps: 先写到这里把,有时间在接着写完成,并且持续更新