CSDIOControllerBase类实现了主控制器驱动的硬件实现

CSDIOControllerBase类实现了主控制器驱动的硬件实现,定义了很多成员变量和函数,原型如下:
class CSDIOControllerBase { public: explicit CSDIOControllerBase( PSDCARD_HC_CONTEXT pHCContext ); virtual ~CSDIOControllerBase(); PSDCARD_HC_CONTEXT GetHostContext() const; virtual BOOL InterpretCapabilities( LPCTSTR pszRegistryPath ); void OnPowerUp(); void OnPowerDown(); void PreDeinit(); protected: // override to customize for specific hardware virtual BOOL InitializeHardware( BOOL bOnPowerUp = FALSE ) = 0; virtual void DeinitializeHardware( BOOL bOnPowerDown = FALSE ) = 0; virtual BOOL CustomSetup( LPCTSTR pszRegistryPath ) = 0; virtual BOOL IsCardWriteProtected() = 0; virtual BOOL IsCardPresent() = 0; protected: volatile S3C2410X_SDI_REG *vm_pSDIReg; // pointer to the SDI special registers volatile S3C2410X_IOPORT_REG *vm_pIOPreg; // pointer to the GPIO control registers volatile S3C2410X_CLKPWR_REG *vm_pCLKPWR; // pointer to the clock control register volatile S3C2410X_DMA_REG *vm_pDMAreg; // pointer to the DMA special registers DWORD m_dwSDIOIrq; // SDIO IRQ DWORD m_dwSDIOSysIntr; // SDIO SysIntr PBYTE m_pDMABuffer; // pointer to buffers used for DMA transfers PHYSICAL_ADDRESS m_pDMABufferPhys; // physical address of the SMA buffer DWORD m_dwDMAChannel; // DMA channel to use for data transfers DWORD m_dwDMAIrq; // DMA IRQ DWORD m_dwDMASysIntr; // DMA SysIntr DWORD m_dwPollingTimeout; // card detect thread polling timeout char m_chCardDetectGPIO; // GPIO used for card detection DWORD m_dwCardDetectMask; DWORD m_dwCardDetectFlag; DWORD m_dwCardDetectControlMask; DWORD m_dwCardDetectControlFlag; DWORD m_dwCardDetectPullupMask; DWORD m_dwCardDetectPullupFlag; char m_chCardReadWriteGPIO; // GPIO used for card read/write detection DWORD m_dwCardReadWriteMask; DWORD m_dwCardReadWriteFlag; DWORD m_dwCardReadWriteControlMask; DWORD m_dwCardReadWriteControlFlag; DWORD m_dwCardReadWritePullupMask; DWORD m_dwCardReadWritePullupFlag; PSDCARD_HC_CONTEXT m_pHCContext; // the host controller context HANDLE m_hResponseReceivedEvent; // Used to post command response info asynchronously int m_nCardDetectIstThreadPriority; // controller IST thread priority HANDLE m_hCardInsertInterruptEvent; // card insert/remove interrupt event HANDLE m_hCardInsertInterruptThread; // card insert/remove interrupt event int m_nSDIOIstThreadPriority; // SDIO IST thread priority HANDLE m_hSDIOInterruptEvent; // SDIO Interrupt event HANDLE m_hSDIOInterruptThread; // SDIO Interrupt Thread Event int m_nControllerIstThreadPriority; // controller IST thread priority HANDLE m_hControllerInterruptEvent; // controller interrupt event HANDLE m_hControllerInterruptThread; // controller interrupt thread int m_DMAIstThreadPriority; // DMA IST thread priority HANDLE m_hDMAInterruptEvent; // DMA interrupt event HANDLE m_hDMAInterruptThread; // DMA interrupt thread BOOL m_bReinsertTheCard; // Indicates if a card insertion should be simulated now BOOL m_bUseDMAForTransfer; // Indicates whether DMA is used for I/O requests BOOL m_bDriverShutdown; // controller shutdown CRITICAL_SECTION m_ControllerCriticalSection; // controller critical section BOOL m_bDevicePresent; // indicates if device is present in the slot WCHAR m_rgchRegPath[256]; // reg path SDHCDSTATE m_CurrentState; // current transfer state BOOL m_bSendInitClocks; // indicates if this is the first command sent DWORD m_dwLastTypeOfTransfer; // inidcates the last type of data transfer initiated DWORD m_dwNumBytesToTransfer; // # of bytes that still need to be transferred DWORD m_dwNumBytesUnaligned; // # of bytes from a DWORD-aligned address DWORD m_dwNumBytesExtra; // # of extra bytes in buffer that aren't a multiple of sizeof(DWORD) DWORD m_dwSDIBusWidth; // SD data transfer mode (1 bit or 4 bit) flag DWORD m_dwClockRate; // current clock rate BOOL m_fCardInTheSlot; // TRUE - a card is inserted in the slot, FALSE otherwise BOOL m_fHandleBusyCheckOnCommand38; DWORD m_dwDMATransferTimeoutFactor; DWORD m_dwDMATransferTimeoutConstant; SD_API_STATUS SendCommand(UINT16 Cmd, UINT32 Arg, UINT16 respType, BOOL bDataTransfer); SD_API_STATUS GetCommandResponse(PSD_BUS_REQUEST pRequest); DWORD SetClockRate(DWORD dwClockRate); BOOL IsCardBusy(UINT16 inData); BOOL SetupDmaXfer(PSD_BUS_REQUEST pRequest); BOOL SetupPollingXfer(PSD_BUS_REQUEST pRequest); BOOL PollingTransmit(PSD_BUS_REQUEST pRequest, DWORD dwLen); BOOL PollingReceive(PSD_BUS_REQUEST pRequest, DWORD dwLen); inline void MMC_Hardware_PowerUp(); inline void MMC_Hardware_PowerDown(); inline void Stop_SDI_Hardware(); inline void Set_SDI_Bus_Width_1Bit(); inline void Set_SDI_Bus_Width_4Bit(); inline DWORD Get_SDI_Bus_Width(); inline void Wait_80_SDI_Clock_Cycles(); inline void Start_SDI_Clock(); inline void Stop_SDI_Clock(); inline BOOL Is_SDI_Clock_Running(); inline void Enable_SDIO_Interrupts(); inline void Disable_SDIO_Interrupts(); inline BOOL Is_SDIO_Interrupt_Enabled(); inline void Ack_SDIO_Interrupts(); inline void Enable_SDIO_DMA_Channel(); inline void Disable_SDIO_DMA_Channel(); inline void Stop_SDIO_DMA_Channel(); // thread routines virtual DWORD CardDetectThread(); virtual DWORD IOInterruptIstThread(); virtual DWORD TransferIstThread(); // implementation of the callbacks for the SD Bus driver SD_API_STATUS Deinitialize(); SD_API_STATUS Initialize(); BOOLEAN CancelIoHandler(DWORD dwSlot, PSD_BUS_REQUEST pRequest); SD_API_STATUS BusRequestHandler(DWORD dwSlot, PSD_BUS_REQUEST pRequest); SD_API_STATUS SlotOptionHandler(DWORD dwSlot, SD_SLOT_OPTION_CODE Option, PVOID pData, ULONG OptionSize); // thread start routines static DWORD SD_CardDetectThread(CSDIOControllerBase *pController); static DWORD SD_IOInterruptIstThread(CSDIOControllerBase *pController); static DWORD SD_TransferIstThread(CSDIOControllerBase *pController); // SD Bus driver callback functions static SD_API_STATUS SDHCDDeinitialize(PSDCARD_HC_CONTEXT pHCContext); static SD_API_STATUS SDHCDInitialize(PSDCARD_HC_CONTEXT pHCContext); static BOOLEAN SDHCDCancelIoHandler(PSDCARD_HC_CONTEXT pHCContext, DWORD dwSlot, PSD_BUS_REQUEST pRequest); static SD_API_STATUS SDHCDBusRequestHandler(PSDCARD_HC_CONTEXT pHCContext, DWORD dwSlot, PSD_BUS_REQUEST pRequest); static SD_API_STATUS SDHCDSlotOptionHandler(PSDCARD_HC_CONTEXT pHCContext, DWORD dwSlot, SD_SLOT_OPTION_CODE Option, PVOID pData, ULONG OptionSize); };
其中有几个纯虚函数是由继承类实现的(CSDIOController类,sdiocontroller.cpp)
    virtual BOOL InitializeHardware( BOOL bOnPowerUp = FALSE ) = 0;
    virtual void DeinitializeHardware( BOOL bOnPowerDown = FALSE ) = 0;
    virtual BOOL CustomSetup( LPCTSTR pszRegistryPath ) = 0;
    virtual BOOL IsCardWriteProtected() = 0;
    virtual BOOL IsCardPresent() = 0;
下面我们来一一看看每个成员函数:
1.构造函数CSDIOControllerBase
初始化成员变量,大部分初始化为0或NULL,当前状态m_CurrentState设为Idle
CSDIOControllerBase::CSDIOControllerBase( PSDCARD_HC_CONTEXT pHCContext ) { vm_pSDIReg = NULL; vm_pIOPreg = NULL; vm_pCLKPWR = NULL; vm_pDMAreg = NULL; m_pDMABuffer = NULL; m_dwDMAChannel = 0; m_pHCContext = pHCContext; m_hResponseReceivedEvent = NULL; m_nCardDetectIstThreadPriority = 0; m_hCardInsertInterruptEvent = NULL; m_hCardInsertInterruptThread = NULL; m_nSDIOIstThreadPriority = 0; m_hSDIOInterruptEvent = NULL; m_hSDIOInterruptThread = NULL; m_nControllerIstThreadPriority = 0; m_hControllerInterruptEvent = NULL; m_hControllerInterruptThread = NULL; m_DMAIstThreadPriority = 0; m_hDMAInterruptEvent = NULL; m_hDMAInterruptThread = NULL; m_bUseDMAForTransfer = FALSE; m_bDriverShutdown = FALSE; m_bDevicePresent = FALSE; m_CurrentState = Idle; m_bSendInitClocks = TRUE; m_dwLastTypeOfTransfer = SD_READ; m_dwNumBytesToTransfer = 0; m_dwNumBytesUnaligned = 0; m_dwNumBytesExtra = 0; m_rgchRegPath[0] = 0; m_dwSDIBusWidth = 0; m_bReinsertTheCard = FALSE; m_fHandleBusyCheckOnCommand38 = FALSE; m_dwDMATransferTimeoutFactor = 8; m_dwDMATransferTimeoutConstant = 3000; m_fCardInTheSlot = FALSE; }  

2.~CSDIOControllerBase
未做任何工作.

3.PreDeinit
这个函数被SDH_PreDeinit调用,m_bDriverShutdown为FALSE时调用Deinitialize进行资源释放.
void CSDIOControllerBase::PreDeinit() { if( !m_bDriverShutdown ) { Deinitialize(); } } 
4.Initialize
该函数被SDHCDInitialize调用.
(1)设置crtical section临界访问,然后映射GPIO寄存器空SDI控制器,时钟能源管理寄存器,DMA控制器IO地址空间. 然后分配内存给DMA传输(64KB大小).
接着初始化寄存器
(2).MMC_Hardware_PowerUp设置CLKCONN使能SDI PCLK.
(3).设置GPIO寄存器使能SDI功能
(4).SetClockRate设置SDI时钟(100HZ)
(5).设置SDI寄存器模式,little edian,512 bytes per block,设置timeout,reset fifo
(6).创建SD卡检测事件m_hCardInsertInterruptEvent及线程SD_CardDetectThread
(7).创建接收应答事件m_hResponseReceivedEvent
(8).创建IST线程m_hSDIOInterruptThread处理SDIO数据传输中断事件m_hSDIOInterruptEvent,并初始化中断
(9).设置DMA传输中断事件m_hDMAInterruptEvent和线程m_hDMAInterruptThread
(10).调用继承类InitializeHardware函数.
(11).出错处理,调用Deinitialize
SD_API_STATUS CSDIOControllerBase::Initialize() { DEBUGMSG (SDCARD_ZONE_INIT,(TEXT("SDHCDInitialize starts"))); SD_API_STATUS status = SD_API_STATUS_SUCCESS; // intermediate status DWORD threadID; // thread ID InitializeCriticalSection(&m_ControllerCriticalSection); //----- 1. Map the GPIO registers needed to enable the SDI controller ----- vm_pIOPreg = (S3C2410X_IOPORT_REG *)VirtualAlloc(0, sizeof(S3C2410X_IOPORT_REG), MEM_RESERVE, PAGE_NOACCESS); if (vm_pIOPreg == NULL) { DEBUGMSG (1,(TEXT("GPIO registers not allocated"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } if (!VirtualCopy((PVOID)vm_pIOPreg, (PVOID)(S3C2410X_BASE_REG_PA_IOPORT >> 8), sizeof(S3C2410X_IOPORT_REG), PAGE_PHYSICAL | PAGE_READWRITE | PAGE_NOCACHE)) { DEBUGMSG (1,(TEXT("GPIO registers not mapped"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } DEBUGMSG (1,(TEXT("GPIO registers mapped to %x"), vm_pIOPreg)); //----- 2. Map the SDI control registers into the device drivers address space ----- vm_pSDIReg = (S3C2410X_SDI_REG *)VirtualAlloc(0, sizeof(S3C2410X_SDI_REG), MEM_RESERVE, PAGE_NOACCESS); if (vm_pSDIReg == NULL) { DEBUGMSG (1,(TEXT("SDI control registers not allocated/n/r"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } if (!VirtualCopy((PVOID)vm_pSDIReg, (PVOID)(S3C2410X_BASE_REG_PA_SDI >> 8), sizeof(S3C2410X_SDI_REG), PAGE_PHYSICAL | PAGE_READWRITE | PAGE_NOCACHE)) { DEBUGMSG (1,(TEXT("SDI control registers not mapped/n/r"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } DEBUGMSG (1,(TEXT("SDI control registers mapped to %x/n/r"), vm_pSDIReg)); vm_pCLKPWR = (S3C2410X_CLKPWR_REG *)VirtualAlloc(0, sizeof(S3C2410X_CLKPWR_REG), MEM_RESERVE, PAGE_NOACCESS); if (vm_pCLKPWR == NULL) { DEBUGMSG (1,(TEXT("Clock & Power Management Special Register not allocated/n/r"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } if (!VirtualCopy((PVOID)vm_pCLKPWR, (PVOID)(S3C2410X_BASE_REG_PA_CLOCK_POWER >> 8), sizeof(S3C2410X_CLKPWR_REG), PAGE_PHYSICAL | PAGE_READWRITE | PAGE_NOCACHE)) { DEBUGMSG (1,(TEXT("Clock & Power Management Special Register not mapped/n/r"))); goto INIT_ERROR; } DEBUGMSG (1,(TEXT("Clock & Power Management Special Register mapped to %x/n/r"), vm_pCLKPWR)); if( m_dwDMAChannel != 0xffffffff ) { //----- 3. Map the DMA control registers used for SDI data transfers ----- vm_pDMAreg = (S3C2410X_DMA_REG *)VirtualAlloc(0, sizeof(S3C2410X_DMA_REG), MEM_RESERVE, PAGE_NOACCESS); if (vm_pDMAreg == NULL) { DEBUGMSG (1,(TEXT("DMA Register not allocated/n/r"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } if (!VirtualCopy((PVOID)vm_pDMAreg, (PVOID)(S3C2410X_BASE_REG_PA_DMA >> 8), sizeof(S3C2410X_DMA_REG), PAGE_PHYSICAL | PAGE_READWRITE | PAGE_NOCACHE)) { DEBUGMSG (1,(TEXT("DMA Register not mapped/n/r"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } DEBUGMSG (1,(TEXT("DMA Register mapped to %x/n/r"), vm_pDMAreg)); //----- 4. Allocate a block of memory for DMA transfers ----- DMA_ADAPTER_OBJECT dmaAdapter; dmaAdapter.ObjectSize = sizeof(dmaAdapter); dmaAdapter.InterfaceType = Internal; dmaAdapter.BusNumber = 0; m_pDMABuffer = (PBYTE)HalAllocateCommonBuffer( &dmaAdapter, MAXIMUM_DMA_TRANSFER_SIZE, &m_pDMABufferPhys, FALSE ); if( m_pDMABuffer == NULL ) { RETAILMSG(1, (TEXT("SHCDriver: - Unable to allocate memory for DMA buffers!/r/n"))); status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } } // Supply the clock to the SDI controller MMC_Hardware_PowerUp(); //----- 6. Configure the GPIO lines for SDI mode and enable the pullup resistor ----- vm_pIOPreg->GPEUP &= 0xF83F; vm_pIOPreg->GPECON |= 0x2AA800; //----- 7. Set the SD/SDI controller to some reasonable default values ----- SetClockRate(SD_DEFAULT_CARD_ID_CLOCK_RATE); // 100Khz vm_pSDIReg->SDICON |= LITTLE_ENDIAN_BYTE_ORDER; // Windows CE is always Little Endian. vm_pSDIReg->SDICON |= RESET_FIFO; // Reset the FIFO vm_pSDIReg->SDIBSIZE = BYTES_PER_SECTOR; vm_pSDIReg->SDIDTIMER = MAX_DATABUSY_TIMEOUT; // Data/busy timeout //----- 8. Setup the thread for detecting card insertion/deletion ----- m_hCardInsertInterruptEvent = CreateEvent(NULL, FALSE, FALSE,NULL); if(NULL == m_hCardInsertInterruptEvent) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } m_bDevicePresent = FALSE; m_hCardInsertInterruptThread = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)SD_CardDetectThread, this, 0, &threadID); if(NULL == m_hCardInsertInterruptThread) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } //----- 9 . Setup an event used for signaling our response thread ----- m_hResponseReceivedEvent = CreateEvent(NULL, FALSE, FALSE,NULL); if(NULL == m_hResponseReceivedEvent) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } //----- 10. Setup the IST for handling SDIO data transfer interrupts ----- m_hSDIOInterruptEvent = CreateEvent(NULL, FALSE, FALSE,NULL); if(NULL == m_hSDIOInterruptEvent) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } // initialize the card insertion interrupt event if(!InterruptInitialize (m_dwSDIOSysIntr, m_hSDIOInterruptEvent, NULL, 0)) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } m_hSDIOInterruptThread = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)SD_IOInterruptIstThread, this, 0, &threadID); if(NULL == m_hSDIOInterruptThread) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } //----- 11. Setup the interrupt event for handling SDIO DMA data transfers ----- m_hDMAInterruptEvent = CreateEvent(NULL, FALSE, FALSE,NULL); if(NULL == m_hDMAInterruptEvent) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } // initialize the dma transfer interrupt event if(!InterruptInitialize (m_dwDMASysIntr, m_hDMAInterruptEvent, NULL, 0)) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } m_hDMAInterruptThread = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)SD_TransferIstThread, this, 0, &threadID); if(NULL == m_hDMAInterruptThread) { status = SD_API_STATUS_INSUFFICIENT_RESOURCES; goto INIT_ERROR; } m_dwLastTypeOfTransfer = SD_READ; m_bUseDMAForTransfer = FALSE; if( !InitializeHardware() ) { DEBUGMSG (1,(TEXT("InitializeHardware failed!/n/r"))); status = SD_API_STATUS_UNSUCCESSFUL; goto INIT_ERROR; } INIT_ERROR: if(!SD_API_SUCCESS(status)) { Deinitialize(); } DEBUGMSG (SDCARD_ZONE_INIT,(TEXT("SDHCDInitialize ends"))); return status; }
5.Deinitialize
Deinitialize用来关闭Initialize创建的事件IST线程,释放DMA buffer,关闭SDI power等
SD_API_STATUS CSDIOControllerBase::Deinitialize() { DEBUGMSG (SDCARD_ZONE_INIT,(TEXT("SDHCDDeinitialize starts"))); //----- 1. Set the controller state to "shutdown" ----- m_bDriverShutdown = TRUE; //----- 2. Disable and cleanup the ISTs/events ------ InterruptDisable (m_dwSDIOSysIntr); SetEvent(m_hResponseReceivedEvent); InterruptDisable (m_dwDMASysIntr); if(NULL != m_hResponseReceivedEvent) { CloseHandle(m_hResponseReceivedEvent); m_hResponseReceivedEvent = NULL; } if(NULL != m_hSDIOInterruptThread) { WaitForSingleObject(m_hSDIOInterruptThread, INFINITE); CloseHandle(m_hSDIOInterruptThread); m_hSDIOInterruptThread = NULL; } if(NULL != m_hSDIOInterruptEvent) { CloseHandle(m_hSDIOInterruptEvent); m_hSDIOInterruptEvent = NULL; } if(NULL != m_hDMAInterruptThread) { WaitForSingleObject(m_hDMAInterruptThread, INFINITE); CloseHandle(m_hDMAInterruptThread); m_hDMAInterruptThread = NULL; } if(NULL != m_hDMAInterruptEvent) { CloseHandle(m_hDMAInterruptEvent); m_hDMAInterruptEvent = NULL; } if(NULL != m_hCardInsertInterruptThread) { WaitForSingleObject(m_hCardInsertInterruptThread, INFINITE); CloseHandle(m_hCardInsertInterruptThread); m_hCardInsertInterruptThread = NULL; } if(NULL != m_hCardInsertInterruptEvent) { CloseHandle(m_hCardInsertInterruptEvent); m_hCardInsertInterruptEvent = NULL; } if( m_dwDMAChannel != 0xffffffff ) { //----- 3. Free the DMA memory ----- HalFreeCommonBuffer( NULL, 0, m_pDMABufferPhys, m_pDMABuffer, FALSE ); } //----- 4. Close the handle to the utility driver (used for fast driver-->driver calling ----- MMC_Hardware_PowerDown(); DeleteCriticalSection(&m_ControllerCriticalSection); DEBUGMSG (SDCARD_ZONE_INIT,(TEXT("SDHCDDeinitialize ends"))); return SD_API_STATUS_SUCCESS; }
6.CancelIoHandler
CancelIoHandler被SDHCDCancelIoHandler调用.首先调用Stop_SDI_Hardware设置SDIDCON强制停止数据传输.调用SDHCDReleaseHCLock释放lock,最后调用SDHCDIndicateBusRequestComplete使用Cancel状态(SD_API_STATUS_CANCELED)来完成Bus请求.
BOOLEAN CSDIOControllerBase::CancelIoHandler(DWORD dwSlot, PSD_BUS_REQUEST pRequest) { DEBUGMSG (SDCARD_ZONE_FUNC,(TEXT("SDHCDCancelIoHandler starts"))); //--- Stop hardware, cancel the request! Stop_SDI_Hardware(); // release the lock before we complete the request SDHCDReleaseHCLock(m_pHCContext); // complete the request with a cancelled status SDHCDIndicateBusRequestComplete(m_pHCContext, pRequest,SD_API_STATUS_CANCELED); DEBUGMSG (SDCARD_ZONE_FUNC,(TEXT("SDHCDCancelIoHandler ends"))); return TRUE; }
7.SlotOptionHandler
CancelIoHandler被SDHCDSlotOptionHandler调用.Slot选项变化时该函数被调用.
(1)SDHCDSetSlotPower:设置slot power,因为系统一直工作在3.3V,不会变化,这里不做任何处理.
(2)SDHCDSetSlotInterface:设置slot接口模式,根据输入数据(pData)设置4bit还是1bit bus模式,调用SetClockRate设置SDI时钟频率.
(3)SDHCDEnableSDIOInterrupts:调用Enable_SDIO_Interrupts使能SDIO中断.
(4)SDHCDDisableSDIOInterrupts:调用Disable_SDIO_Interrupts禁止SDIO中断.
(5)SDHCDAckSDIOInterrupt:调用Ack_SDIO_Interrupts和InterruptDone(m_dwSDIOSysIntr)确认SDIO中断完成.
(6)SDHCDGetWriteProtectStatus:调用IsCardWriteProtected获得写保护状态.
(7)SDHCDQueryBlockCapability:查询Block性能参数.通过输入参数pData来获得ReadBlockSize,WriteBlockSize并根据设定的最大最小值进行修正.
(8)SDHCDGetSlotInfo:获得特定slot的信息.调用SDHCDSetSlotCapabilities等函数设置slot参数,如电压,时钟频率,上电延时等.
SD_API_STATUS CSDIOControllerBase::SlotOptionHandler(DWORD dwSlot, SD_SLOT_OPTION_CODE Option, PVOID pData, ULONG OptionSize) { DEBUGMSG (SDCARD_ZONE_FUNC,(TEXT("SDHCDSlotOptionHandler starts"))); SD_API_STATUS status = SD_API_STATUS_SUCCESS; // status PSD_HOST_BLOCK_CAPABILITY pBlockCaps; // block capabilities switch(Option) { case SDHCDSetSlotPower: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDSetSlotPower"))); // Nothing to do because this system only operates at the reported 3.3V break; case SDHCDSetSlotInterface: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDSetSlotInterface"))); // First set the bus width if(((PSD_CARD_INTERFACE)pData)->InterfaceMode == SD_INTERFACE_SD_4BIT) { Set_SDI_Bus_Width_4Bit(); }else { // Standard (i.e. 1bit) bus width Set_SDI_Bus_Width_1Bit(); } // Next, set the clock rate ((PSD_CARD_INTERFACE)pData)->ClockRate = SetClockRate(((PSD_CARD_INTERFACE)pData)->ClockRate); break; case SDHCDEnableSDIOInterrupts: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDEnableSDIOInterrupts"))); Enable_SDIO_Interrupts(); break; case SDHCDDisableSDIOInterrupts: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDDisableSDIOInterrupts"))); Disable_SDIO_Interrupts(); break; case SDHCDAckSDIOInterrupt: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDAckSDIOInterrupt"))); //----- 2. Clear the SDIO interrupt pending bit ----- Ack_SDIO_Interrupts(); InterruptDone(m_dwSDIOSysIntr); break; case SDHCDGetWriteProtectStatus: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDGetWriteProtectStatus"))); ((PSD_CARD_INTERFACE)pData)->WriteProtected = IsCardWriteProtected(); break; case SDHCDQueryBlockCapability: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDQueryBlockCapability"))); pBlockCaps = (PSD_HOST_BLOCK_CAPABILITY)pData; DEBUGMSG(SDCARD_ZONE_INFO, (TEXT("SDHCD:SDHCDSlotOptionHandler() - Read Block Length: %d , Read Blocks: %d/n"), pBlockCaps->ReadBlockSize, pBlockCaps->ReadBlocks)); DEBUGMSG(SDCARD_ZONE_INFO, (TEXT("SDHCD:SDHCDSlotOptionHandler() - Write Block Length: %d , Write Blocks: %d/n"), pBlockCaps->WriteBlockSize, pBlockCaps->WriteBlocks)); pBlockCaps = (PSD_HOST_BLOCK_CAPABILITY)pData; //----- Validate block transfer properties ----- if (pBlockCaps->ReadBlockSize < MINIMUM_BLOCK_TRANSFER_SIZE ) { pBlockCaps->ReadBlockSize = MINIMUM_BLOCK_TRANSFER_SIZE; } if (pBlockCaps->WriteBlockSize < MINIMUM_BLOCK_TRANSFER_SIZE ) { pBlockCaps->WriteBlockSize = MINIMUM_BLOCK_TRANSFER_SIZE; } if (pBlockCaps->ReadBlockSize > MAXIMUM_BLOCK_TRANSFER_SIZE ) { pBlockCaps->ReadBlockSize = MAXIMUM_BLOCK_TRANSFER_SIZE; } if (pBlockCaps->WriteBlockSize > MAXIMUM_BLOCK_TRANSFER_SIZE ) { pBlockCaps->WriteBlockSize = MAXIMUM_BLOCK_TRANSFER_SIZE; } break; case SDHCDGetSlotInfo: DEBUGMSG (SDCARD_ZONE_INFO,(TEXT("SDHCDSlotOptionHandler option=SDHCDGetSlotInfo"))); if( OptionSize != sizeof(SDCARD_HC_SLOT_INFO) || pData == NULL ) { status = SD_API_STATUS_INVALID_PARAMETER; } else { PSDCARD_HC_SLOT_INFO pSlotInfo = (PSDCARD_HC_SLOT_INFO)pData; // set the slot capabilities SDHCDSetSlotCapabilities(pSlotInfo, SD_SLOT_SD_4BIT_CAPABLE | SD_SLOT_SD_1BIT_CAPABLE | SD_SLOT_SDIO_CAPABLE | SD_SLOT_SDIO_INT_DETECT_4BIT_MULTI_BLOCK); SDHCDSetVoltageWindowMask(pSlotInfo, (SD_VDD_WINDOW_3_2_TO_3_3 | SD_VDD_WINDOW_3_3_TO_3_4)); // Set optimal voltage SDHCDSetDesiredSlotVoltage(pSlotInfo, SD_VDD_WINDOW_3_2_TO_3_3); SDHCDSetMaxClockRate(pSlotInfo, MAX_SDI_BUS_TRANSFER_SPEED); // Set power up delay. We handle this in SetVoltage(). SDHCDSetPowerUpDelay(pSlotInfo, 300); } break; default: DEBUGMSG (SDCARD_ZONE_WARN,(TEXT("SDHCDSlotOptionHandler option=SD_API_STATUS_INVALID_PARAMETER"))); status = SD_API_STATUS_INVALID_PARAMETER; } DEBUGMSG (SDCARD_ZONE_FUNC,(TEXT("SDHCDSlotOptionHandler ends"))); return status; }
8.BusRequestHandler
BusRequestHandler被SDHCDBusRequestHandler调用,用来处理总线请求.
首先复位FIFO和状态寄存器,然后使能SDI CLOCK,