Wince USB otg驱动中关于函数CHub::HubStatusChangeThread
该函数是USB驱动中,监视hub状态改变的线程函数。
Root hub的监视线程在OTG_Init函数被调用时创建。
External Hub的监视线程在External Hub插入到Root Hub时被创建。
在线程刚启动的时候(在线程循环体之外),需要进行一些操作。
// before we can process port changes, we need
// to power all ports
// 函数PowerAllHubPorts在CRootHub类中的实现为空。
// 在类CExternalHub中,遍历Hub上的所有Port,
// 调用函数SetOrClearFeature设置各个Port的Feature。
// 函数SetOrClearFeature中,调用Control Pipe的IssueTransfer函数进行设置
// status = m_ppCPipe[ ENDPOINT0_CONTROL_PIPE ]->IssueTransfer
// 然后等待设置的完成
// WaitForSingleObject( m_hHubStatusChangeEvent, INFINITE );
// 然后调用Control Pipe的AbortTransfer函数结束传输
// m_ppCPipe[ ENDPOINT0_CONTROL_PIPE ]->AbortTransfer
fSuccess = PowerAllHubPorts();
// Sleep 一段时间,等待Hub上电完成。
Sleep( 2 * m_usbHubDescriptor.bPowerOnToPowerGood );
// 设置External Hub的remove wakeup feature。
// 因为该设置只是针对External Hub的,所以Root Hub中该函数为空
// External Hub中,调用Control Pipe的IssueTransfer函数进行设置
// status = m_ppCPipe[ ENDPOINT0_CONTROL_PIPE ]->IssueTransfer
// 然后等待设置的完成
// WaitForSingleObject( m_hHubStatusChangeEvent, INFINITE );
// 然后调用Control Pipe的AbortTransfer函数结束传输
// m_ppCPipe[ ENDPOINT0_CONTROL_PIPE ]->AbortTransfer
// 下面进入线程循环体
// m_fHubThreadClosing在函数CHub::HandleDetach中被设置为True
while ( !m_fHubThreadClosing )
// 等待事件m_hHubSuspendBlockEvent
// 该事件在函数CHub::HandleDetach和函数CHub::ResumeNotification中被设置
fSuccess = (WaitForSingleObject(m_hHubSuspendBlockEvent,INFINITE) == WAIT_OBJECT_0);
// 调用函数WaitForPortStatusChange等待Port状态改变
// 函数WaitForPortStatusChange在Root Hub和External Hub中有不同的实现。
// 在Root Hub中,首先看HCD中是否支持Root Hub Status Change,若不支持,则在此处等待m_hHubStatusChangeEvent。
// 然后遍历Hub上的每个Port,调用函数CHW::DidPortStatusChange检查Port状态是否改变。
// 若改变,调用函数GetStatus获取Port状态。
// 在External Hub中,首先调用函数GetStatusChangeBitmap等待直到Port状态改变的发生
// (通过调用control Pipe的IssueTransfer函数)。
// 通过获取的BitMap处理所有的状态改变。
// 调用函数GetStatus获取状态改变port的状态,然后调用函数SetOrClearFeature清除Feature。
fSuccess = WaitForPortStatusChange( port, hubStatus );
// 判断Port是否为over current(过电流)
if (hubStatus.change.port.OverCurrentChange ) {
if ( hubStatus.status.port.PortOverCurrent ) {
// 如果port为over current,调用函数DetachDevice去Detach port上的device
DetachDevice( port );
// 然后调用函数SetOrClearFeature清除Feature
SetOrClearFeature( port, USB_REQUEST_CLEAR_FEATURE, USB_HUB_FEATURE_PORT_POWER );
else
// 如果port为over current
hubStatus.change.port.ConnectStatusChange = 1;
// 判断是否为suspend change,若是,进行Resume Notification
m_ppCDeviceOnPort[port-1]->ResumeNotification();
// 判断是否是Enable change
if ( hubStatus.change.port.PortEnableChange &&
!hubStatus.status.port.PortEnabled &&
hubStatus.status.port.PortConnected ) {
// 若是,并且Device is present,调用函数DetachDevice,并设置ConnectStatusChange
DetachDevice( port );
hubStatus.change.port.ConnectStatusChange = 1;
// 检查connect changes
// 如果是连接change,并且设备已经存在,需要调用DetachDevice函数
DetachDevice(port);
// 在一个循环体中调用函数GetStatus获取Port状态(防抖动处理de-bouncing)
// 如果获取失败,设置port connect状态,并退出循环
hubStatus.status.port.PortConnected = FALSE;
// 如果获取成功,并且为连接状态改变,调用函数SetOrClearFeature清除Feature,并且继续循环
// ack the status change and wait again
// 否则,跳出循环
// 接下来需要Reset port并重新获取speed information
// 函数ResetAndEnablePort在root hub和external hub中的实现不同
// root hub中,直接调用了HCD对象的ResetAndEnablePort函数
// BOOL fSuccess = m_pCHcd->ResetAndEnablePort( port );
// external hub中,调用SetOrClearFeature函数,
// 首先,设置USB_HUB_FEATURE_PORT_RESET
// 然后,清除USB_HUB_FEATURE_C_PORT_RESET
// 函数ResetAndEnablePort的注释:
// reset/enable device on the given port so that when this
// function completes, the device is listening on address 0
ResetAndEnablePort( port );
Sleep(20);
GetStatus(port , hubStatus);
// 判断获取的状态是否为连接状态
if ( hubStatus.status.port.PortConnected ) {
// 若是
// 判断是否为root hub上的otg port
// 若是
::OTGHNP_EventNotify(HNP_EVENT_HOST_CONNECT);
// 调用函数AttachDevice
AttachDevice( port,
hubStatus.status.port.DeviceIsLowSpeed,
m_fIsHighSpeed?hubStatus.status.port.DeviceIsHighSpeed:FALSE );
追加个参考结构体:
typedef struct _USB_HUB_DESCRIPTOR {
UCHAR bDescriptorLength; // Length of this descriptor
UCHAR bDescriptorType; // Hub configuration type
UCHAR bNumberOfPorts; // number of ports on this hub
USHORT wHubCharacteristics; // Hub Charateristics
UCHAR bPowerOnToPowerGood; // port power on till power good in 2ms
UCHAR bHubControlCurrent; // max current in mA
//
// room for 255 ports power control and removable bitmask
UCHAR bRemoveAndPowerMask[64];
} USB_HUB_DESCRIPTOR, *PUSB_HUB_DESCRIPTOR;
成员变量m_usbHubDescriptor的赋值是在构造函数中进行的。
Root Hub的该成员,是在函数CEhcd::DeviceInitialize中初始化结构体的各成员,然后以其为参数创建Root Hub对象。
External Hub的该成员,是在函数CHub::AttachDevice中,调用函数CHub::GetDescriptor获取,然后以其为参数创建External Hub对象。函数CHub::GetDescriptor中通过调用Control Pipe的函数IssueTransfer来获取Descriptor。