SylixOS 中断系统分析

SylixOS中断系统分析

中断向量表

在SylixOS中，系统默认存在一张大小为256（可以手动配置）的中断向量表，用于管理SylixOS中的每一个中断向量。该向量表存在于k_globalvar.h文件中，其定义格式如程序清单1-1所示。

程序清单1-1 系统中断向量表定义

/*********************************************************************************************************
  系统中断向量表
*********************************************************************************************************/
__KERNEL_EXT  LW_CLASS_INTDESC        _K_idescTable[LW_CFG_MAX_INTER_SRC];
__KERNEL_EXT  LW_SPINLOCK_DEFINE     (_K_slVectorTable);

_K_idescTable是大小为256的数组，数组元素为256个中断向量，_K_slVectorTable是一个自旋锁，用于对中断向量表的互斥访问。

_K_idescTable的类型为LW_CLASS_INTDESC，该类型是SylixOS的中断向量表结构，定义如程序清单1-2所示。

程序清单1-2 中断向量表结构定义

typedef struct {
    LW_LIST_LINE_HEADER   IDESC_plineAction;                            /*  判断中断服务函数列表        */
    ULONG                 IDESC_ulFlag;                                 /*  中断向量选项                */
    LW_SPINLOCK_DEFINE   (IDESC_slLock);                                /*  自旋锁                      */
} LW_CLASS_INTDESC;
typedef LW_CLASS_INTDESC *PLW_CLASS_INTDESC;

LW_CLASS_INTDESC类型的原型分析如下：

• IDESC_plineAction是用于管理中断服务函数的链表，通常情况下，一个中断号对应一个中断服务函数，那么该链表内只有一个成员；但有些特殊情况，一个中断号可以对应多个中断服务函数，则该链表有多个成员。
• IDESC_ulFlag 中断向量选项。
• IDESC_slLock 中断向量自旋锁

中断向量的选项如表1-1所示。

表1-1 中断向量类型

1.2中断描述符

在SylixOS中，每一个中断服务函数对应一个中断描述符结构，并将该中断描述符结构加入到中断向量表对应的表项中，如果一个中断向量对应多个中断服务函数，则这些中断服务函数对应的中断描述符就组成了一个链表，并由中断向量表对应的表项来进行管理。中断描述符结构如程序清单1-3所示。

程序清单1-3 中断描述符结构体定义

typedef struct {
    LW_LIST_LINE          IACT_plineManage;                             /*  管理链表                    */
    INT64                 IACT_iIntCnt[LW_CFG_MAX_PROCESSORS];          /*  中断计数器                  */
    PINT_SVR_ROUTINE      IACT_pfuncIsr;                                /*  中断服务函数                */
    VOIDFUNCPTR           IACT_pfuncClear;                              /*  中断清理函数                */
    PVOID                 IACT_pvArg;                                   /*  中断服务函数参数            */
    CHAR                  IACT_cInterName[LW_CFG_OBJECT_NAME_SIZE];
} LW_CLASS_INTACT;                                                      /*  中断描述符                  */
typedef LW_CLASS_INTACT  *PLW_CLASS_INTACT;

中断描述符类型的原型分析：

• IACT_plineManage 管理链表，用于将中断描述符加入到中断向量表表项
• IACT_iIntCnt 中断计数器，每一次中断该数值加1
• IACT_pfuncIsr 中断服务函数
• IACT_pfuncClear 中断清理函数
• IACT_pvArg 中断服务函数参数
• IACT_cInterName 中断服务函数名字

1.3SylixOS中断服务函数流程

1.3.1总中断服务函数

以ARM体系为例，当ARM内核检测到中断时，会自动将PC指向中断异常入口处去执行中断异常函数，SylixoS的中断异常函数定义为archIntEntry，它是由汇编语言编写，可以用ctrl+h来全局查找该函数进行详细分析。这就是SylixOS的总中断服务函数，也就是说，无论是哪一个中断向量产生中断，都会先进入archIntEntry函数。实际上，在执行工程师自己定义的中断服务函数之前，需要进行一些准备工作，比如上下文的保存，中断嵌套的判断等；执行完工程师自己定义的中断服务函数后，还需要进行上下文的恢复等操作；这些都是由archIntEntry函数来完成，archIntEntry函数就相当于一层外壳，它对底层工程师隐藏了整个中断响应复杂的细节。

那么，archIntEntry函数，来查找中断服务函数。是如何找到工程师自己定义的中断服务函数呢?通过分析archIntEntry函数的源代码可知， archIntEntry函数通过调用bspIntHandle函数，bspIntHandle函数调用archIntHandle函数，来查找中断服务函数。

1.3.2查找中断服务函数

archIntHandle函数定义如程序清单1-4所示。

程序清单1-4 archIntHandle函数定义

LW_WEAK VOID  archIntHandle (ULONG  ulVector, BOOL  bPreemptive)

archIntHandle函数原型分析：

• 参数ulVector是中断向量号
• 参数bPreemptive表示是否允许中断抢占，这里只是根据是否允许抢占来判断是否打开中断，中断嵌套上下文的保存是在archIntEntry函数中处理的。

archIntHandle函数的大体流程如图1-1所示。

图1-1 中断服务函数流程

1.3.3中断服务函数返回值

archIntHandle函数在遍历中断服务函数链表时，会根据中断服务函数的返回值判断是否需要结束遍历，它的返回值有三种选项，如表1-2所示。

表1-2 中断服务函数返回值选项

可参考SylixOS GIT上的文档《TN0032_SylixOS共用中断号机制》，来对中断服务函数返回值做更详细的了解。

2.SylixOS中断的连接与释放

在SylixOS中，中断的连接与释放的函数分别是API_InterVectorConnect函数和API_InetrVectorDisable函数，下面介绍SylixOS中断的连接和释放过程。

2.1SylixOS中断连接函数简介

API_InterVectorConnect函数定义如程序清单2-1所示。

程序清单2-1 中断连接函数

LW_API ULONG            API_InterVectorConnect(ULONG                 ulVector,
                                               PINT_SVR_ROUTINE      pfuncIsr,
                                               PVOID                 pvArg,
                                               CPCHAR                pcName);
                                                                        /*  设置指定向量的服务程序      */

函数API_InterVectorConnect原型分析：

• 函数返回为连接成功或失败
• 参数ulVector是中断向量号
• 参数pfuncIsr是中断服务函数
• 参数pvArg是中断服务函数参数
• 参数pcName是中断服务名称

API_InterVectorConnect函数的功能是将中断向量号与中断服务函数进行连接。

API_InterVectorConnect函数的大体流程如图2-所示。

图2- 1 中断服务连接函数流程

SylixOS中断释放函数简介

API_InterVectorDisable函数的定义如程序清单2-2所示。

程序清单2-2 中断释放函数

LW_API ULONG    API_InterVectorDisconnect(ULONG                 ulVector,
                                          PINT_SVR_ROUTINE      pfuncIsr,
                                          PVOID                 pvArg);
                                                                        /*  删除指定向量的服务程序      */

API_InterVectorDisable函数原型分析：

• 函数返回值是释放成功或失败
• 参数ulVector是中断向量号
• 参数pfuncIsr是中断服务函数
• 参数pvArg是中断服务函数的参数

API_InterVectorDisable函数仅仅只是释放与参数pfuncIsr和参数pvArg相对应的中断服务函数，当一个向量对应多个函数时，它并不会释放该向量的所有中断服务函数。

如果要想一次性释放所有中断服务函数，SylixOS提供了另外的接口，API_InterVectorDisconnectEx函数，它的定义如程序清单2-3所示。

程序清单2-3 中断释放扩展函数

LW_API ULONG    API_InterVectorDisconnectEx(ULONG             ulVector,
                                            PINT_SVR_ROUTINE  pfuncIsr,
                                            PVOID             pvArg,
                                            ULONG             ulOption);
                                                                        /*  删除指定向量的服务程序      */

API_InterVectorDisconnectEx函数原型分析：

• 该函数的前三个参数与API_InterVectorDisable函数参数相同，实际上API_InterVectorDisable就是调用了该函数。
• 参数ulOption是删除选项

删除选项的选项如表2- 1所示。

表2- 1 中断释放函数的删除选项

API_InterVectorDisconnectEx函数的大体流程如图2-2所示。

图2-2 中断释放函数流程