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函数将热插拔消息保存至缓存区。