SD Card Driver

安全性

SDA 中的SD Memory specification 有种机制可以在特定机器上锁定卡里面的内容。WINCE 5里并没有显示的支持该机制。但是可以自己来做，比如一个文件系统的FILTER等。

貌似此部分代码非微软原创：

// Copyright (c) 2002 BSQUARE Corporation.  All rights reserved.

// DO NOT REMOVE --- BEGIN EXTERNALLY DEVELOPED SOURCE CODE ID 40973--- DO NOT REMOVE

DWORD SDH_Init(DWORD dwContext)

{

// allocate the context

 status = SDHCDAllocateContext(SDH_SLOTS,  &pHostContext);

。。。。。。

    //Set a unique name for each host controller

    if (pController->ControllerIndex == 1)

    {

        SDHCDSetHCName(pHostContext, TEXT("MXARM11_1"));

    }

    else

    {

        SDHCDSetHCName(pHostContext, TEXT("MXARM11_2"));

    }

// set init handler

    SDHCDSetControllerInitHandler(pHostContext,SDInitialize); 

    // set deinit handler   

    SDHCDSetControllerDeinitHandler(pHostContext, SDDeinitialize);

    // set the bus request handler

    SDHCDSetBusRequestHandler(pHostContext,SDHBusRequestHandler);  

    // set the cancel I/O handler

    SDHCDSetCancelIOHandler(pHostContext, SDHCancelIoHandler);  

    // set the slot option handler

    SDHCDSetSlotOptionHandler(pHostContext, SDHSlotOptionHandler);

    // now register the host controller

    status = SDHCDRegisterHostController(pHostContext);

关于Standard Host Controller

SDA Host Working Group (MSFT executive member)

Defined Standard Host Register Specification to standardize the hardware interface from bus to controller

Currently ratified to v1.0 by SDA executive committee

MSFT strongly advocating this standard to all IHVs, ODMs, OEMs and Silicons

如何让镜像支持SD STACK

SYSGEN_SDBUS – SD bus driver (sdbus.dll)

SYSGEN_SDHC_STANDARD – Standard host controller (sdhc.dll)

SYSGEN_SD_MEMORY – SD Memory client (sdmemory.dll)

SYSGEN_BTH or SYSGEN_BTH_SDIO_ONLY – SDIO Bluetooth client (bthsdio.dll)

BSP variables will be added for CSP-specific host controllers

[HKEY_LOCAL_MACHINE\System\StorageManager\Profiles\SDMemory]

    "Name"="SD Memory Card"

    "Folder"="Storage Card"

    ;"PartitionDriver"=""          ; removable storage cannot have partitions

[HKEY_LOCAL_MACHINE\System\StorageManager\Profiles\MMC]

    "Name"="MMC Card"

    "Folder"="Storage Card"

    ;"PartitionDriver"=""          ; removable storage cannot have partitions

; SD Memory Storage class driver

[HKEY_LOCAL_MACHINE\Drivers\SDCARD\ClientDrivers\Class\SDMemory_Class]

   "Dll"="SDMemory.dll"

   "Prefix"="DSK"

   "BlockTransferSize"=dword:40  ; send no more than 64 blocks of data per bus transfer

   ;"SingleBlockWrites"=dword:1  ; alternatively force the driver to use single block access

   ;"IdleTimeout"=dword:7D0      ; 2000 milliseconds

   ;"IdlePowerState"=dword:2     ; 0 == D0, 1 == D1, etc.

   ;"DisablePowerManagement"=""  ; if value present, then disable (remove value to enable)

   "Profile"="SDMemory"

   "IClass"=multi_sz:"{A4E7EDDA-E575-4252-9D6B-4195D48BB865}",

                     "{A32942B7-920C-486b-B0E6-92A702A99B35}"

; MMC Storage Class Driver

[HKEY_LOCAL_MACHINE\Drivers\SDCARD\ClientDrivers\Class\MMC_Class]

   "Dll"="SDMemory.dll"

   "Prefix"="DSK"

   "BlockTransferSize"=dword:40  ; send no more than 64 blocks of data per bus transfer

   ;"SingleBlockWrites"=dword:1  ; alternatively force the driver to use single block access

   ;"IdleTimeout"=dword:7D0      ; milliseconds

   ;"IdlePowerState"=dword:2     ; 0 == D0, 1 == D1, etc.

   ;"DisablePowerManagement"=""  ; if value present, then disable (remove value to enable)

   "Profile"="MMC"

   "IClass"=multi_sz:"{A4E7EDDA-E575-4252-9D6B-4195D48BB865}",

                     "{A32942B7-920C-486b-B0E6-92A702A99B35}"

NAME SDMEMORY.DLL

EXPORTS

DSK_Close=SMC_Close

DSK_Deinit=SMC_Deinit

DSK_Init=SMC_Init

DSK_IOControl=SMC_IOControl

DSK_Open=SMC_Open

DSK_PowerDown=SMC_PowerDown

DSK_PowerUp=SMC_PowerUp

DSK_Read=SMC_Read

DSK_Seek=SMC_Seek

DSK_Write=SMC_Write

//

// SDDiskIO

//

//  SDMemCardConfig    - Initialise the memcard structure and card itself

DWORD SDMemCardConfig( PSD_MEMCARD_INFO pMemCard );

    //  SDMemRead          - Read data from card into pSG scatter gather buffers

DWORD SDMemRead( PSD_MEMCARD_INFO pMemCard, PSG_REQ pSG );

    //  SDMemWrite         - Write data to card from pSG scatter gather buffers

DWORD SDMemWrite( PSD_MEMCARD_INFO pMemCard, PSG_REQ pSG );

    //  SDMemErase         - Erase a contiguous set of blocks

DWORD SDMemErase( PSD_MEMCARD_INFO pMemCard, PDELETE_SECTOR_INFO pDSI );

    //  SDMemEraseAll      - Erase all blocks

DWORD SDMemEraseAll( PSD_MEMCARD_INFO pMemCard );

//

// SDCardIO

//

    //  SDMemDoBusRequest  - Perform a bus request, returns Windows Status

DWORD SDMemDoBusRequest( PSD_MEMCARD_INFO  pMemcard,

                         UCHAR             Command,

                         DWORD             Argument,

                         SD_TRANSFER_CLASS TransferClass,

                         SD_RESPONSE_TYPE  ResponseType,

                         ULONG             NumBlocks,

                         ULONG             BlockSize,

                         PUCHAR            pBuffer,

                         DWORD             Flags);

    //  SDMemSetBlockLen   - Sets read/write block length for SD memory card

DWORD SDMemSetBlockLen( PSD_MEMCARD_INFO pMemcard,

                        DWORD            BlockLen );

    //  SDMemReadMultiple  - Read multiple 512 byte blocks of data from card

DWORD SDMemReadMultiple( PSD_MEMCARD_INFO pHandle,

                         ULONG            StartBlock,

                         ULONG            NumBlocks,

                         PUCHAR           pBuffer );

    //  SDMemWriteMultiple - Write multiple 512 byte blocks of data to card

DWORD SDMemWriteMultiple( PSD_MEMCARD_INFO pHandle,

                          LONG             StartBlock,

                          LONG             NumBlocks,

                          PUCHAR           pBuffer );

    //  SDMemWriteUsingSingleBlocks - Write using single block writes

DWORD SDMemWriteUsingSingleBlocks( PSD_MEMCARD_INFO pHandle,

                                   LONG             StartBlock,

                                   LONG             NumBlocks,

                                   PUCHAR           pBuffer );

    //  SDMemDoErase - Erase a contiguous set of blocks

DWORD SDMemDoErase( PSD_MEMCARD_INFO pHandle,

                    LONG             StartBlock,

                    LONG             NumBlocks );

DWORD SDAPIStatusToErrorCode( SD_API_STATUS Status );

DWORD SDGetCardStatus(PSD_MEMCARD_INFO pMemCard , SD_CARD_STATUS *pCardStatus);

VOID HandleIoctlPowerSet(PSD_MEMCARD_INFO       pMemCard,

                         PCEDEVICE_POWER_STATE  pDevicePowerState);

VOID InitializePowerManagement(PSD_MEMCARD_INFO pMemCard);

VOID DeinitializePowerManagement(PSD_MEMCARD_INFO pMemCard);

SD_API_STATUS IssueCardSelectDeSelect(PSD_MEMCARD_INFO pMemCard, BOOL Select);

VOID RequestEnd(PSD_MEMCARD_INFO pMemCard);

SD_API_STATUS RequestPrologue(PSD_MEMCARD_INFO pMemCard, DWORD DeviceIoControl);

SDHC.DLL由以下源代码组成

『――――

微软代码

    c:\macallan\private\winceos\coreos\ceosutil\utiltree.cxx

    c:\macallan\public\common\sdk\inc\svsutil.hxx

    c:\macallan\private\winceos\coreos\ceosutil\utilmemf.cxx

    c:\macallan\public\common\sdk\inc\svsutil.hxx

    c:\macallan\private\winceos\coreos\ceosutil\utilmem.cxx

    c:\macallan\private\winceos\coreos\ceosutil\svsutil.cxx

    c:\macallan\public\common\oak\drivers\sdcard\sdcardlib\sdcardapistubs.cpp

    c:\macallan\public\common\oak\drivers\sdcard\sdcardlib\sddebug.cpp

    c:\macallan\public\common\oak\drivers\sdcard\sdcardlib\sdmemapi.cpp

    c:\macallan\public\common\oak\inc\block_allocator.hxx

c:\macallan\public\common\oak\drivers\sdcard\sdhclib\sdhclib.cpp

―――――』

d:\wince500\platform\mx31\src\drivers\sdhc\bspsdhc.c

    d:\wince500\public\common\oak\csp\arm\freescale\mxarm11\drivers\sdhc\main.cpp

    d:\wince500\public\common\oak\csp\arm\freescale\mxarm11\drivers\sdhc\sdcontrol.cpp

d:\wince500\public\common\sdk\inc\kfuncs.h

#if (defined BSP_SDHC1 || defined BSP_SDHC2)

[HKEY_LOCAL_MACHINE\Drivers\SDCARD\ClientDrivers\Class\SDMemory_Class]

"BlockTransferSize"=dword:100 ; Overwrite from default 64 blocks.

; "SingleBlockWrites"=dword:1 ; alternatively force the driver to use single block

access

[HKEY_LOCAL_MACHINE\Drivers\SDCARD\ClientDrivers\Class\MMC_Class]

"BlockTransferSize"=dword:100 ; Overwrite from default 64 blocks.

; "SingleBlockWrites"=dword:1 ; alternatively force the driver to use single block

access

[HKEY_LOCAL_MACHINE\System\StorageManager\Profiles\MMC]

"Name"="MMC Card"

"Folder"="MMC"

[HKEY_LOCAL_MACHINE\System\StorageManager\Profiles\SDMemory]

"Name"="SD Memory Card"

"Folder"="SD Memory"

#endif

IF BSP_SDHC1

[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SDHC_ARM11_1]

"Order"=dword:21

"Dll"="sdhc.dll"

"Prefix"="SDH"

"ControllerISTPriority"=dword:64

"Index"=dword:1

ENDIF ;BSP_SDHC1

IF BSP_SDHC2

[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SDHC_ARM11_2]

"Order"=dword:21

"Dll"="sdhc.dll"

"Prefix"="SDH"

"ControllerISTPriority"=dword:64

"Index"=dword:2

ENDIF ;BSP_SDHC

SDHC驱动支持DMA 和非DMA 2种数据传输模式，默认是DMA。For every request submitted to it, the driver attempts to build a DMA Scatter Gather Buffer Descriptor list for the buffer passed to it by the upper layer. For cases where this list cannot be built, the driver falls back to the non-DMA mode of transfer. The default configuration is maintained in the file bsp_cfg.h using the parameters BSP_SDMA_SUPPORT_SDHC1 and BSP_SDMA_SUPPORT_SDHC2. A value of TRUE means DMA is the default mode, and for cases where DMA cannot be used, the driver falls back to a non-DMA mode. A value of FALSE means non-DMA mode is the default and DMA mode will not be attempted. For the driver to attempt to build the Scatter Gather DMA Buffer Descriptors, the upper layer should ensure that the buffer meets the following criteria.

• Start of the buffer should be a word aligned address.

• Number of bytes to transfer should be word aligned.

Due to cache coherency issues arising due to processor and SDMA access of the memory, the above criteria is further stringent for the read or receive operation (it is not applicable for write or transmit):

• Start of the buffer should be a cache line size (32 bytes) aligned address.

• Number of bytes to transfer should be cache line size (32 bytes) aligned.

The primary methods for limiting power in SDHC module is to gate off all clocks to the controllers and to

cut off power to the card slot when no cards are inserted. When a card is inserted to any of the slots, that

slot alone is powered and the clocks to that controller alone are gated on. While using memory cards, the

clock to the host controller and the clock to memory cards are gated off when ever the controller is idle.

For SDIO cards, both the clocks stay on all the time.

SDHC driver supports the full power on and full power off states. In full power off state, the clocks to the

controllers and the power to the inserted cards are turned off. When powered on, all cards inserted before

and after the power down will be detected and mounted.

PowerUp

This function is implemented to support resuming a memory card operation that was previously terminated

by calling PowerDown() API. Power to the card is restored, clocks to the pertaining controller is restarted.

SDHC driver is notified of a device status change. This results in signaling the SD bus driver of a card

removal followed by a card insertion. The card is re-initialized and is mounted so that the all operations

scheduled during a power down resumes. SDIO cards will be initialized on resume.

The details of this architecture and its operation can be found in the Platform Builder Help under the

heading “Power On and Off Notifications for Secure Digital Card Drivers”, or in the online Microsoft

documentation at the following URL:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wceddk5/html/wce50conpoweronoffnot

ificationsforsecuredigitalcarddrivers.asp

Note that this function is intended to be called only by the Power Manager.

PowerDown

This function has been implemented to support suspending all currently active SD operations just before

the entire system enters the low power state. Note that this function is intended to be called only by the

Power Manager. This function gates off all clocks to the controllers and powers down all the card slots.