SylixOS热插拔子系统分析（二）

1. 系统与驱动

    热插拔子系统中，系统与驱动层的交互分为热插拔事件和循环检测。热插拔事件是针对设备能够产生热插拔中断通知的情况，SylixOS可以将通知以异步的方式来处理；而循环检测是设备不能产生一个热插拔中断通知的情况，需要轮询检测某些事件标志，来获取设备的插入或拔出状态。

1.1 热插拔事件

    能够产生热插拔事件的设备，在驱动层调用API_HotplugEvent函数即可，SylixOS热插拔系统中对热插拔事件处理是通过JobQueue来实现，SylixOS定义工作队列如下：

static  LW_JOB_QUEUE            _G_jobqHotplug;static  LW_JOB_MSG              _G_jobmsgHotplug[LW_CFG_HOTPLUG_MAX_MSGS];

    热插拔事件通过API_HotplugEvent函数中向工作队列中添加工作：

#include <SylixOS.h>INT  API_HotplugEvent (VOIDFUNCPTR  pfunc,                        PVOID         pvArg0,                      PVOID         pvArg1,                       PVOID         pvArg2,                       PVOID         pvArg3,                       PVOID         pvArg4,                       PVOID         pvArg5){        ……    if (_jobQueueAdd( &_G_jobqHotplug,  pfunc,  pvArg0,  pvArg1,  pvArg2,  pvArg3,  pvArg4,  pvArg5)) {        _ErrorHandle(ERROR_EXCE_LOST);        return (PX_ERROR);    }    ……}

    函数API_HotplugEvent原型分析：

•  函数成功返回ERROR_NONE，失败返回PX_ERROE；
•  参数pfunc表示函数指针；
•  参数pvArg0 ~ pvArg5为函数参数。

    设备驱动创建时，驱动层调用API_HotplugEvent函数完成工作队列的添加，热插拔内核线程在检测该工作队列时会检测到工作，并调用其中的执行函数，向应用层提供热插拔消息。

1.2 循环检测

    针对不能产生一个热插拔中断事件的设备，驱动层可调用API_HotplugPollAdd函数将驱动中的轮询检测函数来添加到系统中，这样系统会在一个确定的时间间隔轮询检测设备状态。

    轮询检测节点结构如下，函数指针和函数参数两个成员是驱动设计者所要关心的，也就是驱动的轮询检测函数，全局链表头_G_plineHotplugPoll连接所有的热插拔节点。

typedef struct {        LW_LIST_LINE     HPPN_lineManage;         /*  节点链表                    */        VOIDFUNCPTR     HPPN_pfunc;                  /*  函数指针                    */        PVOID             HPPN_pvArg;                  /*  函数参数                    */        LW_RESOURCE_RAW HPPN_resraw;                 /*  资源管理节点                      */} LW_HOTPLUG_POLLNODE;

SylixOS下热插拔驱动支持提供API_HotplugPollAdd接口添加轮询检测函数，如下：

#include <SylixOS.h>INT  API_HotplugPollAdd (VOIDFUNCPTR   pfunc, PVOID  pvArg){    ……    phppn->HPPN_pfunc = pfunc;    phppn->HPPN_pvArg = pvArg;    ……}

    API_HotplugPollAdd函数原型分析：

• 函数成功返回ERROR_NONE，失败返回PX_ERROR；
•  参数pfunc表示函数指针；
•  参数pvArg为函数参数。

1.3 内核线程

    SylixOS下热插拔子系统中会创建“t_hotplug”内核线程，内核线程代码实现如下：

#include <SylixOS.h>static VOID  _hotplugThread (VOID){    ……    for (;;) {        ulError = _jobQueueExec(&_G_jobqHotplug, LW_HOTPLUG_SEC * LW_TICK_HZ);        if (ulError) {            ……            for (plineTemp  = _G_plineHotplugPoll;                 plineTemp  != LW_NULL;                 plineTemp   = _list_line_get_next(plineTemp)) {                if (phppn->HPPN_pfunc) {                    phppn->HPPN_pfunc(phppn->HPPN_pvArg);                }            }            ……        }    }}

    “t_hotplug”内核线程每隔“LW_HOTPLUG_SEC * LW_TICK_HZ”时间间隔会遍历执行工作队列中的工作，若工作队列中没有工作则内核线程遍历循环检测链表，检测到节点则调用其中的循环检测函数。

2. 系统与应用层

     系统与应用层的交互是系统将热插拔消息通知给应用层，这样用户层可以感知到设备的插入和拔出。应用层通过调用函数API_HotplugEventMessage即可将热插拔消息通知出去，然后应用层通过读设备“/dev/hotplug”即可获得热插拔消息。

    实现原理分两部分，一是热插拔设备部分，二是消息传递部分。

2.1 热插拔设备

    热插拔设备的创建涉及到SylixOS设备驱动的知识，这里不再详述，在之后的设备驱动文章中将做详细介绍。

2.2 消息传递

    消息传递部分调用HotplugEventMessage函数将热插拔消息存放在设备缓存区中，代码片段如下：

#include <SylixOS.h>INT  API_HotplugEventMessage (INT       iMsg,                                BOOL    bInsert,                                CPCHAR    pcPath,                                UINT32    uiArg0,                                UINT32    uiArg1,                                UINT32    uiArg2,                                UINT32    uiArg3){    ……_hotplugDevPutMsg(iMsg, ucBuffer, i);    ……}

    函数API_HotplugEventMessage原型分析：

• 函数成功返回ERROR_NONE，失败返回PX_ERROR；
• 参数iMsg为消息号；
• 参数bInsert表示是否为插入，否则为拔出；
• 参数pcPath表示设备路径或名称；
• 参数uiArg0 ~ uiArg3为附加参数。

    函数HotplugEventMessage根据SylixOS定义的热插拔消息格式，将传入参数封装为热插拔消息，并调用_hotplugDevPutMsg函数将热插拔消息保存至缓存区。