友我科技PCSC雙界面讀寫器YW-606開發(fā)指南

          友我科技PCSC雙界面讀寫器YW-606開發(fā)指南

 

 

1．建立資源管理器的上下文

函數(shù)ScardEstablishContext()用于建立將在其中進行設(shè)備數(shù)據(jù)庫操作的資源管理器上下文（范圍）。

函數(shù)原型：LONG SCardEstablishContext(DWORD dwScope,  LPCVOID pvReserved1,  LPCVOID pvReserved2,  LPSCARDCONTEXT phContext);

各個參數(shù)的含義：

（1）dwScope：輸入類型；表示資源管理器上下文范圍，取值為：SCARD_SCOPE_USER（在用戶域中完成設(shè)備數(shù)據(jù)庫操作）、SCARD_SCOPE_SYSTEM（在系統(tǒng)域中完成設(shè)備數(shù)據(jù)庫操作）。要求應(yīng)用程序具有相應(yīng)的操作權(quán)限。

（2）pvReserved1：輸入類型；保留，必須為NULL。

（3）pvReserved2：輸入類型；保留，必須為NULL。

（4）phContext：輸出類型；建立的資源管理器上下文的句柄。 

 

 

下面是建立資源管理器上下文的代碼：

SCARDCONTEXT hSC;

LONG lReturn;

lReturn = SCardEstablishContext(SCARD_SCOPE_USER, NULL, NULL, &hSC);

if ( lReturn!=SCARD_S_SUCCESS )

printf("Failed SCardEstablishContext\n");

 

2． 獲得系統(tǒng)中安裝的讀卡器列表

函數(shù)ScardListReaders()可以列出系統(tǒng)中安裝的讀卡器的名字。

函數(shù)原型：LONG SCardListReaders(SCARDCONTEXT hContext,  LPCTSTR mszGroups,  LPTSTR mszReaders,  LPDWORD pcchReaders);

各個參數(shù)的含義：

（1）hContext：輸入類型；ScardEstablishContext()建立的資源管理器上下文的句柄，不能為NULL。

（2）mszGroups：輸入類型；讀卡器組名，為NULL時，表示列出所有讀卡器。

（3）mszReaders：輸出類型；系統(tǒng)中安裝的讀卡器的名字，各個名字之間用’\0’分隔，后一個名字后面為兩個連續(xù)的’\0’。

（4）pcchReaders：輸入輸出類型；mszReaders的長度。

系統(tǒng)中可能安裝多個讀卡器，因此，需要保存各個讀卡器的名字，以便以后與需要的讀卡器建立連接。

下面是獲得系統(tǒng)中安裝的讀卡器列表的代碼：

char mszReaders[1024];

LPTSTR pReader, pReaderName[2];

DWORD dwLen=sizeof(mzsReaders);

int nReaders=0;

lReturn = SCardListReaders(hSC, NULL, (LPTSTR)mszReaders, &dwLen);

if ( lReturn==SCARD_S_SUCCESS )

{

pReader = (LPTSTR)pmszReaders;

while (*pReader !='\0'  )

{

if ( nReaders<2 ) //使用系統(tǒng)中前2個讀卡器

pReaderName[nReaders++]=pReader;

printf("Reader: %S\n", pReader );

//下一個讀卡器名

pReader = pReader + strlen(pReader) + 1;

}

}

 

3． 與讀卡器（智能卡）連接

函數(shù)ScardConnect()在應(yīng)用程序與讀卡器上的智能卡之間建立一個連接。

函數(shù)原型：LONG SCardConnect(SCARDCONTEXT hContext,  LPCTSTR szReader,  DWORD dwShareMode,  DWORD dwPreferredProtocols,  LPSCARDHANDLE phCard,  LPDWORD pdwActiveProtocol);

各個參數(shù)的含義：

（1）hContext：輸入類型；ScardEstablishContext()建立的資源管理器上下文的句柄。

（2）szReader：輸入類型；包含智能卡的讀卡器名稱（讀卡器名稱由ScardListReaders()給出）。

（3）dwShareMode：輸入類型；應(yīng)用程序?qū)χ悄芸ǖ牟僮鞣绞�，SCARD_SHARE_SHARED（多個應(yīng)用共享同一個智能卡）、SCARD_SHARE_EXCLUSIVE（應(yīng)用獨占智能卡）、SCARD_SHARE_DIRECT（應(yīng)用將智能卡作為私有用途，直接操縱智能卡，不允許其它應(yīng)用訪問智能卡）。

（4）dwPreferredProtocols：輸入類型；連接使用的協(xié)議，SCARD_PROTOCOL_T0（使用T=0協(xié)議）、SCARD_PROTOCOL_T1（使用T=1協(xié)議）。

（5）phCard：輸出類型；與智能卡連接的句柄。

（6）PdwActiveProtocol：輸出類型；實際使用的協(xié)議。

下面是與智能卡建立連接的代碼：

SCARDHANDLE hCardHandle[2];

DWORD dwAP;

lReturn = SCardConnect( hContext, pReaderName[0],    SCARD_SHARE_SHARED,

SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1, &hCardHandle[0], &dwAP );

if ( lReturn!=SCARD_S_SUCCESS )

{

printf("Failed SCardConnect\n");

exit(1);

}

與智能卡建立連接后，就可以向智能卡發(fā)送指令，與其交換數(shù)據(jù)了。

 

 

 

 

 

4． 斷開與讀卡器（智能卡）的連接

在與智能卡的數(shù)據(jù)交換完成后，可以使用函數(shù)ScardDisconnect()終止應(yīng)用與智能卡之間的連接。

函數(shù)原型：LONG SCardDisconnect(SCARDHANDLE hCard, DWORD dwDisposition);

各個參數(shù)的含義：

（1）hCard：輸入類型；與智能卡連接的句柄。

（2）dwDisposition：輸入類型；斷開連接時，對智能卡的操作，SCARD_LEAVE_CARD（不做任何操作）、SCARD_RESET_CARD（復(fù)位智能卡）、SCARD_UNPOWER_CARD（給智能卡掉電）、SCARD_EJECT_CARD（彈出智能卡）。

下面是斷開與智能卡連接的代碼：

lReturn = SCardDisconnect(hCardHandle[0], SCARD_LEAVE_CARD);

if ( lReturn != SCARD_S_SUCCESS )

{

printf("Failed SCardDisconnect\n");

exit(1);

}

 

5． 釋放資源管理上下文

在應(yīng)用程序終止前時，應(yīng)該調(diào)用函數(shù)ScardReleaseContext()釋放資源管理器的上下文。

函數(shù)原型：LONG SCardReleaseContext(SCARDCONTEXT hContext);

各個參數(shù)含義：

（1）hContext：輸入類型；ScardEstablishContext()建立的資源管理器上下文的句柄，不能為NULL。

下面是釋放資源管理上下文的代碼：

lReturn = SCardReleaseContext(hSC);

if ( lReturn!=SCARD_S_SUCCESS )

printf("Failed SCardReleaseContext\n");

  

 

以上介紹的通過PC/SC來操作智能卡的流程，可以封裝在一個類中。例如，我們可以設(shè)計一個類:

class CYOWORFIDReader

{

private:

SCARDCONTEXT hSC;

LONG lReturn;

char mszReaders[1024];

LPTSTR pReader, pReaderName[2];

DWORD dwLen;

int nReaders, nCurrentReader;

SCARDHANDLE hCardHandle[2];

DWORD dwAP;

public:

CSmartReader(); //建立上下文、取讀卡器列表

~CSmartReader(); //釋放上下文

void SetCurrentReader(int currentReader);

int GetReaders(); //獲得讀卡器數(shù)目

int ConnectReader(); //與當(dāng)前讀卡器建立連接

int DisConnectReader(); //與當(dāng)前讀卡器斷開連接

int SendCommand(BYTE command[], int commandLength, BYTE result[], int *resultLength); //向讀卡器發(fā)送命令，并接收返回的數(shù)據(jù)。返回值為sw

};

這樣，我們就可以方便地使用PC/SC接口了。

 

 

6. 向智能卡發(fā)送指令

函數(shù)ScardTransmit()向智能卡發(fā)送指令，并接受返回的數(shù)據(jù)。

函數(shù)原型：LONG SCardTransmit(SCARDHANDLE hCard, LPCSCARD_I0_REQUEST pioSendPci, LPCBYTE pbSendBuffer, DWORD cbSendLength, LPSCARD_IO_REQUEST pioRecvPci, LPBYTE pbRecvBuffer, LPDWORD pcbRecvLength);

各個參數(shù)的含義：

（1）hCard：輸入類型；與智能卡連接的句柄。

（2）pioSendPci：輸入類型；指令的協(xié)議頭結(jié)構(gòu)的指針，由SCARD_IO_REQUEST結(jié)構(gòu)定義。后面是使用的協(xié)議的協(xié)議控制信息。一般使用系統(tǒng)定義的結(jié)構(gòu)，SCARD_PCI_T0（T=0協(xié)議）、 SCARD_PCI_T1（T=1協(xié)議）、SCARD_PCI_RAW（原始協(xié)議）。

（3）pbSendBuffer：輸入類型；要發(fā)送到智能卡的數(shù)據(jù)的指針。

（4）cbSendLength：輸入類型；pbSendBuffer的字節(jié)數(shù)目。

（5）pioRecvPci：輸入輸出類型；指令協(xié)議頭結(jié)構(gòu)的指針，后面是使用的協(xié)議的協(xié)議控制信息，如果不返回協(xié)議控制信息，可以為NULL。

（6）pbRecvBuffer：輸入輸出類型；從智能卡返回的數(shù)據(jù)的指針。

（7）pcbRecvLength：輸入輸出類型；pbRecvBuffer的大小和實際大小。

 

對于T=0協(xié)議，收發(fā)緩沖的用法如下：

（a）向智能卡發(fā)送數(shù)據(jù)：要向智能卡發(fā)送n>0字節(jié)數(shù)據(jù)時，pbSendBuffer 前4字節(jié)分別為T=0的CLA、INS、P1、P2，第5字節(jié)是n，隨后是n字節(jié)的數(shù)據(jù)；cbSendLength值為n+5（4字節(jié)頭+1字節(jié)Lc+n字節(jié)數(shù)據(jù)）。PbRecvBuffer將接收SW1、SW2狀態(tài)碼；pcbRecvLength值在調(diào)用時至少為2，返回后為2。

BYTE recvBuffer[260];

int sendSize, recvSize;

BTYE sw1, sw2;

BYTE    select_mf[]={0xC0, 0xA4, 0x00, 0x00, 0x02, 0x3F, 0x00};

sendSize=7;

recvSize=sizeof(recvBuffer);

lReturn = SCardTransmit(hCardHandle[0], SCARD_PCI_T0, select_mf, sendSize,

NULL, recvBuffer, &recvSize);

if ( lReturn != SCARD_S_SUCCESS )

{

printf("Failed SCardTransmit\n");

exit(1);

}

//返回的數(shù)據(jù)，recvSize=2

sw1=recvBuffer[recvSize-2];

sw2=recvBuffer[recvSize-1];

 

（b）從智能卡接收數(shù)據(jù)：為從智能卡接收n>0字節(jié)數(shù)據(jù)，pbSendBuffer 前4字節(jié)分別為T=0的CLA、INS、P1、P2，第5字節(jié)是n（即Le），如果從智能卡接收256字節(jié)，則第5字節(jié)為0；cbSendLength值為5（4字節(jié)頭+1字節(jié)Le）。PbRecvBuffer將接收智能卡返回的n字節(jié)，隨后是SW1、SW2狀態(tài)碼；pcbRecvLength的值在調(diào)用時至少為 n+2，返回后為n+2。

BYTE     get_challenge[]={0x00, 0x84, 0x00, 0x00, 0x08};

sendSize=5;

recvSize=sizeof(recvBuffer);

lReturn = SCardTransmit(hCardHandle[0], SCARD_PCI_T0, get_challenge,

sendSize, NULL, recvBuffer, &recvSize);

if ( lReturn != SCARD_S_SUCCESS )

{

printf("Failed SCardTransmit\n");

exit(1);

}

//返回的數(shù)據(jù), recvSize=10

sw1=recvBuffer[recvSize-2];

sw2=recvBuffer[recvSize-1];

//data=recvBuffer[0]----recvBuffer[7]

 

（c）向智能卡發(fā)送沒有數(shù)據(jù)交換的命令：應(yīng)用程序既不向智能卡發(fā)送數(shù)據(jù)，也不從智能卡接收數(shù)據(jù)，pbSendBuffer 前4字節(jié)分別為T=0的CLA、INS、P1、P2，不發(fā)送P3；cbSendLength 值必須為4。PbRecvBuffer從智能卡接收SW1、SW2狀態(tài)碼；pcbRecvLength值在調(diào)用時至少為2，返回后為2。

 

BYTE    set_flag[]={0x80, 0xFE, 0x00, 0x00};

sendSize=4;

recvSize=sizeof(recvBuffer);

lReturn = SCardTransmit(hCardHandle[0], SCARD_PCI_T0, set_flag, sendSize,

NULL, recvBuffer, &recvSize);

if ( lReturn != SCARD_S_SUCCESS )

{

printf("Failed SCardTransmit\n");

exit(1);

}

//返回的數(shù)據(jù)，recvSize=2

sw1=recvBuffer[recvSize-2];

sw2=recvBuffer[recvSize-1];

 

（d）向智能卡發(fā)送具有雙向數(shù)據(jù)交換的命令：T=0協(xié)議中，應(yīng)用程序不能同時向智能卡發(fā)送數(shù)據(jù)，并從智能卡接收數(shù)據(jù)，即發(fā)送到智能卡的指令中，不能同時有Lc和Le。這只能分兩步實現(xiàn)：向智能卡發(fā)送數(shù)據(jù)，接收智能卡返回的狀態(tài)碼，其中，SW2是智能卡將要返回的數(shù)據(jù)字節(jié)數(shù)目；從智能卡接收數(shù)據(jù)（指令為0x00、0xC0、0x00、0x00、Le）。

BYTE get_response={0x00, 0xc0, 0x00, 0x00, 0x00};

BYTE    internal_auth[]={0x00, 0x88, 0x00, 0x00, 0x08, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08};

sendSize=13;

recvSize=sizeof(recvBuffer);

lReturn = SCardTransmit(hCardHandle[0], SCARD_PCI_T0, internal_auth,

sendSize, NULL, recvBuffer, &recvSize);

if ( lReturn != SCARD_S_SUCCESS )

{

printf("Failed SCardTransmit\n");

exit(1);

}

//返回的數(shù)據(jù)，recvSize=2

sw1=recvBuffer[recvSize-2];

sw2=recvBuffer[recvSize-1];

if ( sw1!=0x61 )

{

printf("Failed Command\n");

exit(1);

}

get_response[4]=sw2;

sendSize=5;

recvSize=sizeof(recvBuffer);

lReturn = SCardTransmit(hCardHandle[0], SCARD_PCI_T0, get_response,

sendSize, NULL, recvBuffer, &recvSize);

if ( lReturn != SCARD_S_SUCCESS )

{

printf("Failed SCardTransmit\n");

exit(1);

}

//返回的數(shù)據(jù)，recvSize=10

sw1=recvBuffer[recvSize-2];

sw2=recvBuffer[recvSize-1];

//data=recvBuffer[0]----recvBuffer[7]