此SDK為廣東東信智能科技有限公司Linux串口系列身份證閱讀器，支持Linux相片解碼以及獲取身份證文字信息，另外還包括了非接IC卡、M1卡、CPU等卡的讀取指令，含Linux系統libwlt2bmp.so相片解碼庫。

版本：V2018.11.07

相片解碼說明：

#ifndef _dev_serial_H

#define _dev_serial_H

#define IC_UnConnect -1001 /*設備通訊超時*/

#define NoOpenCom        -120   /* 串口沒打開*/

#define SendDataError    -121   /* 發送數據失敗*/

#define TermParaError    -122/* 終端參數錯*/

#define TermTypeError    -123   /* 終端類型錯誤*/

#define RevTimeOut       -101/* 接收數據超時*/

#define IFD_SendAgain -40           /*如果返回此錯誤，需重發數據*/

#define IFD_TypeA_Find_Error -28/*TYPE A尋卡錯誤*/

#define IFD_TypeA_MoreCard_Error -27/*TYPE A檢測到多張卡片*/

#define IFD_TypeA_Anticoll_Error -26/*TYPE A防碰撞錯誤*/

#define IFD_TypeA_Select_Error -25/*TYPE A選卡錯誤*/

#define IFD_TypeA_RATS_Error -24/*TYPE A RATS錯誤*/

#define IFD_M1_Auth_Error -23/*Mifare one Auth錯誤*/

#define IFD_TypeB_Find_Error -22/*TYPE B尋卡錯誤*/

#define IFD_TypeB_attrib_Error -21/*TYPE B attrib錯誤*/

/*狀態碼*/

#define IFD_OK0 /*執行成功*/

#define IFD_ICC_TypeError-1 /*卡片類型不對*/

#define IFD_ICC_NoExist-2 /*無卡*/

#define IFD_ICC_NoPower-3 /*有卡未上電*/

#define IFD_ICC_NoResponse-4     /*卡片無應答*/

#define IFD_ConnectError-11     /*讀卡器連接錯*/

#define IFD_UnConnected-12         /*未建立連接(沒有執行打開設備函數)*/

#define IFD_BadCommand-13         /*(動態庫)不支持該命令*/

#define IFD_ParameterError-14     /*(發給動態庫的)命令參數錯*/

#define IFD_CheckSumError-15     /*信息校驗和出錯*/

#ifdef __cplusplus

extern "C" {

#endif

/******************************************************************************************************************************************\

\   /

/身份證   \

\   /

\******************************************************************************************************************************************/

/*****************************************

* 功能： 讀取證件(居民身份證 + 外國人永久居留證 + 港澳臺居民居住證)

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

* 返回值： 

*成功返回0，執行成功后可調用下列get函數獲取相應的信息

***********************************************************************/

long PICC_ReadIDCard(long ReaderHandle);

/*****************************************

* 功能： 讀取證件,包含指紋(居民身份證 + 外國人永久居留證 + 港澳臺居民居住證)

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

* 返回值： 

*成功返回0，執行成功后可調用下列get函數獲取相應的信息

***********************************************************************/

long PICC_ReadIDCardFP(long ReaderHandle);

/*****************************************

* 功能： 獲取證件類型

* 參數： 

*無

* 返回值： 

*0：表示居民身份證

*1：表示外國人永久居留證

*2：表示港澳臺居民居住證

*****************************************/

int GetCardType();

/*****************************************

* 功能： 獲取姓名

* 參數： 

*pName： [OUT] 姓名

* 返回值： 

*成功返回0

* 包含證件類型：0、1、2

*****************************************/

int GetName(char* pName);

/*****************************************

* 功能： 獲取性別

* 參數： 

*pSex： [OUT] 性別

* 返回值： 

*成功返回0

* 包含證件類型：0、1、2

*****************************************/

int GetSex(char* pSex);

/*****************************************

* 功能： 獲取民族

* 參數： 

*pNation： [OUT] 民族

* 返回值： 

*成功返回0

* 包含證件類型：0

*****************************************/

int GetNation(char* pNation);

/*****************************************

* 功能： 獲取出生日期

* 參數： 

*pBirth： [OUT] 出生日期

* 返回值： 

*成功返回0

* 包含證件類型：0、1、2

*****************************************/

int GetBirth(char* pBirth);

/*****************************************

* 功能： 獲取住址

* 參數： 

*pAddress： [OUT] 住址

* 返回值： 

*成功返回0

* 包含證件類型：0、2

*****************************************/

int GetAddress(char* pAddress);

/*****************************************

* 功能： 獲取證件號碼

* 參數： 

*pCertNo： [OUT] 證件號碼

* 返回值： 

*成功返回0

* 包含證件類型：0、1、2

*****************************************/

int GetCertNo(char* pCertNo);

/*****************************************

* 功能： 獲取簽發機關

* 參數： 

*pDepartemt： [OUT] 簽發機關

* 返回值： 

*成功返回0

* 包含證件類型：0、2

*****************************************/

int GetDepartemt(char* pDepartemt);

/*****************************************

* 功能： 獲取有效起始日期

* 參數： 

*pEffectDate： [OUT] 有效起始日期

* 返回值： 

*成功返回0

* 包含證件類型：0、1、2

*****************************************/

int GetEffectDate(char* pEffectDate);

/*****************************************

* 功能： 獲取有效截止日期

* 參數： 

*pExpireDate： [OUT] 有效截止日期

* 返回值： 

*成功返回0

* 包含證件類型：0、1、2

*****************************************/

int GetExpireDate(char* pExpireDate);

/*****************************************

* 功能： 獲取通行證號碼

* 參數： 

*pTXZHM： [OUT] 通行證號碼

* 返回值： 

*成功返回0

* 包含證件類型：2

*****************************************/

int GetTXZHM(char* pTXZHM);

/*****************************************

* 功能： 獲取通行證簽發次數

* 參數： 

*pTXZQFCS： [OUT] 通行證簽發次數

* 返回值： 

*成功返回0

* 包含證件類型：2

*****************************************/

int GetTXZQFCS(char* pTXZQFCS);

/*****************************************

* 功能： 獲取英文名

* 參數： 

*pEnName： [OUT] 外國人英文名

* 返回值： 

*成功返回0

* 包含證件類型：1

*****************************************/

int GetEnName(char* pEnName);

/*****************************************

* 功能： 獲取國籍代碼

* 參數： 

*pNationalityCode： [OUT] 外國人國籍代碼

* 返回值： 

*成功返回0

* 包含證件類型：1

*****************************************/

int GetNationalityCode(char* pNationalityCode);

/*****************************************

* 功能： 獲取證件版本

* 參數： 

*pCardVersion： [OUT] 外國人居留證證件版本

* 返回值： 

*成功返回0

* 包含證件類型：1

*****************************************/

int GetCardVersion(char* pCardVersion);

/*****************************************

* 功能： 獲取照片

* 參數： 

*dlpath： [IN] so路徑, 例如："../lib/libwltdecode.so"

*pBmpfilepath： [IN] 照片路徑, 例如："../list/zp.bmp"

* 返回值： 

*成功返回0

* 包含證件類型：0、1、2

*****************************************/

int GetBmpFile(const char* dlpath, char* pBmpfilepath);

/*****************************************

* 功能： 是否含指紋信息

* 參數： 

*無

* 返回值： 

*成功返回指紋數據長度，0表示沒有

* 包含證件類型：0、1、2

*****************************************/

int IsFingerExist();

/*****************************************

* 功能： 獲取指紋信息

* 參數： 

*fpInfo： [OUT] 指紋數據

* 返回值： 

*成功返回獲取到的指紋數據長度，0表示沒有

* 包含證件類型：0、1、2

*****************************************/

int GetFingerprint(unsigned char* fpInfo);

/******************************************************************************************************************************************\

\   /

/設備類   \

\   /

\******************************************************************************************************************************************/

/*****************************************

* 功能：連接讀卡器 

* 參數： 

*comm：[IN] 串口號，例如"/dev/ttyS3"  

* 返回值： 

*返回大于0的設備句柄 

******************************************/

long ICC_Reader_Open(char * comm);

/*****************************************

* 功能：斷開讀卡器連接

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

* 返回值： 

*成功返回0

***************************************************************/

long ICC_Reader_Close(long ReaderHandle);

/*****************************************

* 功能： 蜂鳴 

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*timeout： [IN] 超時時間，固定為5

* 返回值： 

*成功返回0 

******************************************/

long ICC_PosBeep(long ReaderHandle, unsigned char timeout);

/******************************************************************************************************************************************\

\   /

/接CPU   \

\   /

\******************************************************************************************************************************************/

/*****************************************

* 功能： 接觸CPU卡上電(冷復位)

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*ICC_Slot_No：[IN] 卡座號 0x01(大卡座)，0x11~0x14(SAM1~SAM4)

*Response：[OUT] ATR

* 返回值： 

*成功返回數據長度

***************************************************************/

long ICC_Reader_pre_PowerOn(long ReaderHandle, unsigned char ICC_Slot_No, unsigned char* Response);

/*****************************************

* 功能： 接觸CPU卡下電

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*ICC_Slot_No：[IN] 卡座號 0x01(大卡座)，0x11~0x14(SAM1~SAM4)

* 返回值： 

*成功返回0

***************************************************************/

long ICC_Reader_PowerOff(long ReaderHandle,unsigned char ICC_Slot_No);

/*****************************************

* 功能： 接觸CPU卡執行APDU命令

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*ICC_Slot_No：[IN] 卡座號 0x01(大卡座)，0x11~0x14(SAM1~SAM4)

*Lenth_of_Command_APDU： [IN] APDU命令的長度

*Command_APDU：[IN] APDU命令

*Response_APDU： [OUT] 響應信息

* 返回值： 

*成功返回響應信息數據的長度

***************************************************************/

long ICC_Reader_Application(long ReaderHandle,unsigned char ICC_Slot_No, long Lenth_of_Command_APDU,unsigned char* Command_APDU,unsigned char* Response_APDU);  

/******************************************************************************************************************************************\

\   /

/非接類   \

\   /

\******************************************************************************************************************************************/

/*****************************************

* 功能： 獲取卡片UID(M1 & TypeA)

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*UID： [OUT] 4字節UID

* 返回值： 

*成功返回0

***************************************************************/

long PICC_Reader_GetUID(long fd,unsigned char* UID);

/*****************************************

* 功能： M1卡認證秘鑰

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*Mode： [IN] 0x60 表示認證KeyA, 0x61表示認證KeyB

*SecNr：[IN] 扇區號 S50系列卡 0~15， S70系列卡 0~63

*Key： [IN] 6字節秘鑰

* 返回值： 

*成功返回0

***************************************************************/

long PICC_Reader_Authentication_Pass(long ReaderHandle,unsigned char Mode, unsigned char SecNr,unsigned char *Key);

/*****************************************

* 功能： M1讀卡

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*Addr：[IN] 塊地址 S50系列卡 0~63， S70系列卡 0~255， 例如：1扇區1塊，這里Addr=5=1*4 + 1(扇區號*4 + 塊號)

*Data：[OUT] 16字節塊數據

* 返回值： 

*成功返回0

*****************************************************************************************************************/

long PICC_Reader_Read(long ReaderHandle,unsigned char Addr,unsigned char *Data);

/*****************************************

* 功能： M1寫卡

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*Addr：[IN] 塊地址 S50系列卡 0~63， S70系列卡 0~255， 例如：1扇區1塊，這里Addr=5=1*4 + 1(扇區號*4 + 塊號)

*Data： [IN] 16字節待寫入數據

* 返回值： 

*成功返回0

***************************************************************************************************************/

long PICC_Reader_Write(long ReaderHandle,unsigned char Addr,unsigned char *Data);

/*****************************************

* 功能： TypeA卡上電

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*Response： [OUT] 上電返回數據

* 返回值： 

*成功返回數據長度

***************************************************************/

long PICC_Reader_PowerOnTypeA(long ReaderHandle,unsigned char* Response);

/*****************************************

* 功能： TypeB卡上電

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*Response： [OUT] 上電返回數據

* 返回值： 

*成功返回數據長度

***************************************************************/

long PICC_Reader_PowerOnTypeB(long ReaderHandle,unsigned char* Response);

/*****************************************

* 功能： TypeA & B 卡執行APDU命令

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*Lenth_of_Command_APDU： [IN] APDU命令的長度

*Command_APDU：[IN] APDU命令

*Response_APDU： [OUT] 響應信息

* 返回值： 

*成功返回響應信息數據的長度

***************************************************************/

long PICC_Reader_Application(long ReaderHandle,long Lenth_of_Command_APDU,unsigned char* Command_APDU,unsigned char* Response_APDU);

/******************************************************************************************************************************************\

\   /

/磁條卡   \

\   /

\******************************************************************************************************************************************/

/*****************************************

* 功能： 讀磁條卡

* 參數： 

*ReaderHandle：[IN] 執行ICC_Reader_Open 函數成功時的返回值

*ctime：[IN] 等待刷卡的超時時間，單位：秒

*track：[IN] 磁道 1~3

*rlen： [OUT] 返回的磁道數據長度

*Data： [OUT] 返回的磁道數據

* 返回值： 

*成功返回0

****************************************************************/

long Rcard(long ReaderHandle,unsigned char ctime,int track,unsigned char *rlen,char *Data);

#ifdef __cplusplus

}

#endif

#endif

#include "../inc/dev_serial.h"

#include <string.h>

#include <stdio.h>

static long handle;

static void printchar(char ch, int len)

{

while(len--)

{

printf("%c", ch);

}

printf("\n");

}

static void printchar_txt(char ch, char *pText)

{

printf("%c\t%s\n", ch, pText);

}

static void printByteArray(char *Tag, unsigned char *pSrc, int ilen)

{

inti = 0;

printf( "%s", Tag );

while( i<ilen )

{

printf( "%02X ", pSrc[i] );

i++;

}

printf( "\n" );

}

static void ShowToEdit(const char* tag, const char* msg)

{

printf( "%s\t%s\n", tag, msg );

}

static void CertCard_Test()

{

intnRt, i;

char pName[50]={0};

char pSex[10]={0};

char pNation[10]={0};

char pBirth[50]={0};

char pAddress[100]={0};

char pCertNo[50]={0};

char pDepartment[100]={0};

char pEffectData[50]={0};

char pExpire[20]={0};

char pErrMsg[50]={0};

char pEnName[150] = { 0 };

char pEnNation[50] = { 0 };

char pAuthorCode[150] = { 0 };

char pCardVersion[150] = { 0 };

char pTXZHM[50] = { 0 };

char pTXZQFCS[10] = { 0 };

nRt = PICC_ReadIDCard(handle);

if ( nRt != 0 )

{

printf( "ReadCertCard fail! nRet=%d\n", nRt );

return;

}

if(GetCardType() == 0)

{

GetName(pName);

GetSex(pSex);

GetNation(pNation);

GetBirth(pBirth);

GetAddress(pAddress);

GetCertNo(pCertNo);

GetDepartemt(pDepartment);

GetEffectDate(pEffectData);

GetExpireDate(pExpire);

ShowToEdit( "姓名：", (pName));

ShowToEdit( "性別：", (pSex));

ShowToEdit( "民族：", (pNation));

ShowToEdit( "出生日期：", (pBirth));

ShowToEdit( "地址：", (pAddress));

ShowToEdit( "身份證號：", (pCertNo));

ShowToEdit( "簽發機關：", (pDepartment));

ShowToEdit( "有效起始日期：", (pEffectData));

ShowToEdit( "有效截止日期：", (pExpire));

}

if(GetCardType() == 1)

{

GetName(pName);

GetEnName(pEnName);

GetSex(pSex);

GetNationalityCode(pEnNation);

GetBirth(pBirth);

GetCertNo(pCertNo);

GetEffectDate(pEffectData);

GetExpireDate(pExpire);

GetCardVersion(pCardVersion);

ShowToEdit( "中文姓名：", (pName));

ShowToEdit( "英文姓名：", (pEnName));

ShowToEdit( "性別：", (pSex));

ShowToEdit( "國籍代碼：", (pEnNation));

ShowToEdit( "永久居留證號碼：", (pCertNo));

ShowToEdit( "出生日期：", (pBirth));

ShowToEdit( "證件簽發日期：", (pEffectData));

ShowToEdit( "證件終止日期：", (pExpire));

ShowToEdit( "證件版本：", (pCardVersion));

}

if(GetCardType() == 2)

{

GetName(pName);

GetSex(pSex);

GetBirth(pBirth);

GetAddress(pAddress);

GetCertNo(pCertNo);

GetDepartemt(pDepartment);

GetEffectDate(pEffectData);

GetExpireDate(pExpire);

GetTXZHM(pTXZHM);

GetTXZQFCS(pTXZQFCS);

ShowToEdit( "姓名：", (pName));

ShowToEdit( "性別：", (pSex));

ShowToEdit( "出生日期：", (pBirth));

ShowToEdit( "地址：", (pAddress));

ShowToEdit( "身份證號：", (pCertNo));

ShowToEdit( "簽發機關：", (pDepartment));

ShowToEdit( "有效起始日期：", (pEffectData));

ShowToEdit( "有效截止日期：", (pExpire));

ShowToEdit( "通行證號碼：", (pTXZHM));

ShowToEdit( "通行證簽發次數：", (pTXZQFCS));

}

char szPhotoPath[255] = { 0 };

sprintf(szPhotoPath, "../list/%s.bmp", pCertNo);

GetBmpFile("../lib/libwltdecode.so", szPhotoPath);

}

static void ICC_CPUCard_Test()

{

intnRt, i;

unsigned char slot = 0x01;

unsigned char cmd[255] = { 0 };

unsigned charresp[255]= { 0 };

unsigned charATR[60] = { 0 };

intlenth_of_cmd;

// Get 8 byte Random

cmd[0] = 0x00;

cmd[1] = 0x84;

cmd[2] = 0x00;

cmd[3] = 0x00;

cmd[4] = 0x08;

lenth_of_cmd = 5;

//CPU Card PowerOn

nRt = ICC_Reader_pre_PowerOn( handle, slot, resp );

if( nRt < 0 )

{

printf( "CPU Card PowerOn fail! ret=%d\n", nRt );

return;

}

printByteArray( "ATR: ", resp, nRt );

printByteArray( "CMD: ", cmd, lenth_of_cmd );

//Send APDU CMD

memset( resp, 0, 250 );

nRt = ICC_Reader_Application( handle, slot, lenth_of_cmd, cmd, resp );

if( nRt < 0 )

{

printf( "send APDU CMD fail! ret=%d\n", nRt );

return;

}

printByteArray( "Resp: ", resp, nRt );

}

static void PICC_CPUCard_Test()

{

int             nRt, i;

unsigned char   uid[15]  = { 0 };

unsigned char   cmd[255] = { 0 };

unsigned char   resp[255]= { 0 };

unsigned char   ATR[60]  = { 0 };

int             lenth_of_cmd;

// Get 8 byte Random

cmd[0] = 0x00;

cmd[1] = 0x84;

cmd[2] = 0x00;

cmd[3] = 0x00;

cmd[4] = 0x08;

lenth_of_cmd = 5;

//CPU Card PowerOn

nRt = PICC_Reader_PowerOnTypeA( handle, resp );

if( nRt < 0 )

{

printf( "TypeA CPU Card PowerOn fail! ret=%d\n", nRt );

return;

}

printByteArray( "ATR: ", resp, nRt );

printByteArray( "CMD: ", cmd, lenth_of_cmd );

memset( resp, 0, 250 );

nRt = PICC_Reader_Application( handle, lenth_of_cmd, cmd, resp );

if( nRt < 0 )

{

printf( "send APDU CMD fail! ret=%d\n", nRt );

return;

}

printByteArray( "Resp: ", resp, nRt );

}

static void M1Card_Test()

{

int             nRt, i;

unsigned char   uid[15]= { 0 };

unsigned char   password[7] = { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x00 };

unsigned char   resp[255]= { 0 };

unsigned charaddr= 0x04;

unsigned charsncr= 0x01;

unsigned charmode= 0x61;

if( PICC_Reader_GetUID( handle, uid ) <= 0 )

{

printf( "PICC_Reader_anticoll fail! ret=%d\n", nRt );

return;

}

printByteArray( "UID: ", uid, 4 );

nRt = PICC_Reader_Authentication_Pass( handle, mode, sncr, password );

if ( nRt != 0 )

{

printf( "PICC_Reader_Authentication_Pass fail! ret=%d\n", nRt );

return;

}

nRt = PICC_Reader_Read( handle, addr, resp );

if( nRt != 0 )

{

printf( "PICC_Reader_Read fail! ret=%d\n", nRt );

return;

}

printByteArray( "Data: ", resp, 16 );

}

int main(void)

{

long nRt;

intnval;

handle = ICC_Reader_Open( "/dev/ttyUSB0" );

if( handle <= 0 )

{

printf( "open fail! \n" );

return 0;

}

printchar( '#', 80 );

printchar_txt( '#', "please choose the action you want:" );

printchar_txt( '#', "1.opt ICC CPU Card." );

printchar_txt( '#', "2.opt PICC CPU(A) Card." );

printchar_txt( '#', "3.opt M1 Card." );

printchar_txt( '#', "4.opt CertCard." );

printchar( '#', 80 );

scanf( "%d", &nval );

//nRt = ICC_PosBeep( handle, 10 );

switch( nval )

{

case 1:

{

printf( "\tICC_CPU_CARD.\n" );

ICC_CPUCard_Test();

}

break;

case 2:

{

printf( "\tPICC_CPU(A)_CARD.\n" );

PICC_CPUCard_Test();

}

break;

case 3:

{

printf( "\tM1_CARD.\n" );

M1Card_Test();

}

break;

case 4:

{

printf( "\tCertCard.\n" );

CertCard_Test();

}

break;

default:

printf( "enter err!\n" );

break;

}

ICC_PosBeep(handle, 10);

ICC_Reader_Close(handle);

return 0;

}