明創(chuàng)IDR-100U多功能身份證閱讀器Windows/Android/Linux開發(fā)包下載

以下開發(fā)包支持明創(chuàng)IDR-100U HID整機、IDR-M10、IDR-M20、IDR-M30等多功能免驅系列身份證閱讀器、社保卡讀卡器整機和模組等產(chǎn)品，供開發(fā)人員適用。

Windows平臺開發(fā)包，包括BS，C/S，支持USB和串口：

點擊這里下載↓

Android平臺開發(fā)包，包括USB和串口：

點擊這里下載↓

Linux平臺開發(fā)包，包括USB和串口：

點擊這里下載↓

串口協(xié)議，支持單片機PLC等開發(fā)：

點擊這里下載↓

本文檔描述了明創(chuàng)多功能身份證閱讀器SDK的函數(shù)定義、調用方法、參數(shù)以及返回值說明，供開發(fā)人員進行二次開發(fā)時使用。EU開頭的是接觸卡，PEU開頭的是非接卡。

三、函數(shù)說明

3.1、設備類

3.1.1、連接讀卡器

函數(shù)原型：long WINAPI EU_Reader_Open(char* dev_Name);

參數(shù)：[IN] dev_Name：固定值 “USB1”.

返回值：連接成功時返回句柄值(大于0)，該值需保存作為其他函數(shù)的入?yún)ⅰ?/span>

3.1.2、斷開連接

函數(shù)原型：long WINAPI EU_Reader_Close(long ReaderHandle);

參數(shù)：ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

返回值：無

3.1.3、蜂鳴器

函數(shù)原型：long WINAPI EU_PosBeep(long ReaderHandle, unsigned char time);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

Time：[IN] 蜂鳴時間，0~10

返回值：成功返回0。

3.1.4天線開關

long WINAPI PEU_Reader_RFControl(long ReaderHandle,short type);

//type=0 關閉天線 type=1 打開天線

3.2、接觸類

3.2.1、CPU卡&社保卡

3.2.1.1、CPU卡上電復位

函數(shù)原型：

long WINAPI EU_Reader_pre_PowerOn(long ReaderHandle,unsigned char EU_Slot_No,unsigned char* Response);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

EU_Slot_No：[IN]卡座號(如下)

0x01:大卡座

0x11~0x14：SAM1~SAM4卡座

Response：[OUT]上電返回的ATR

返回值：成功返回ATR的長度,<= 0表示失敗。

3.2.1.2、CPU卡執(zhí)行APDU命令

函數(shù)原型：long WINAPI EU_Reader_Application(long ReaderHandle,unsigned char EU_Slot_No, long Lenth_of_Command_APDU,unsigned char* Command_APDU, unsigned char* Response_APDU);

參數(shù)：

ReaderHandle：       [IN] EU_Reader_Open函數(shù)的返回值

EU_Slot_No：            [IN]卡座號，同上電復位

Lenth_of_Command_APDU： [IN]APDU命令長度

Command_APDU：          [IN]APDU命令

Response_APDU：         [OUT]響應數(shù)據(jù)

返回值：

    成功返回響應數(shù)據(jù)的長度，<= 0表示失敗

讀社保卡

函數(shù)原型：long WINAPI PEU_Reader_SICARD(long ReaderHandle, char* SBKH, char *XM, char *XB, char *MZ, char *CSRQ, char *SHBZHM, char *FKRQ, char *KYXQ,char* ErrMsg);

參數(shù)：

ReaderHandle：[IN] Open函數(shù)的返回值

SBKH：  [OUT]社保卡卡號

XM：    [OUT]姓名

XB：    [OUT]性別

MZ：    [OUT]民族

CSRQ：  [OUT]出生日期

SHBZHM：    [OUT]身份證號

FKRQ：  [OUT]發(fā)卡日期

FKRQ：  [OUT]卡有效期

ErrMsg：[OUT]錯誤信息

返回值：成功返回0

3.3、非接類

3.3.1、非接卡前置步驟（必須）

3.3.1.1、設置為TypeA/B

函數(shù)原型：     long WINAPI PEU_Reader_SetTypeA(long ReaderHandle);

long WINAPI PEU_Reader_SetTypeB(long ReaderHandle);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

返回值：成功返回0

3.3.1.2、請求卡片

函數(shù)原型：long WINAPI PEU_Reader_Request(long ReaderHandle);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

返回值：成功返回0

3.3.1.3、防碰撞

函數(shù)原型：long WINAPI PEU_Reader_anticoll(long ReaderHandle,unsigned char *uid);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Uid：[OUT] 卡片物理卡號，4字節(jié)

返回值：成功返回0

3.3.1.4、選擇卡片

函數(shù)原型：long WINAPI PEU_Reader_Select(long ReaderHandle,unsigned char cardtype);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

Cardtype：[IN]0x41表示TypeA/M1，0x42表示TypeB

返回值：成功返回0

3.3.2、非接CPU卡（TypeA）

3.3.2.1、TypeA卡上電復位

函數(shù)原型：long WINAPI PEU_Reader_PowerOnTypeA(long ReaderHandle,unsigned char* Response);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Response：[OUT]上電返回數(shù)據(jù)（ATS）

返回值：成功返回ATS長度，<= 0表示失敗。

3.3.2.2、TypeA卡執(zhí)行APDU命令

函數(shù)原型：long WINAPI PEU_Reader_Application(long ReaderHandle, long Lenth_of_Command_APDU,unsigned char* Command_APDU, unsigned char* Response_APDU);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

Lenth_of_Command_APDU： [IN]APDU命令長度

Command_APDU：          [IN]APDU命令

Response_APDU：         [OUT]響應數(shù)據(jù)

返回值：

    成功返回響應數(shù)據(jù)的長度，<= 0表示失敗

3.3.3、Mifare One(M1卡) 系列

3.3.3.1、認證秘鑰

函數(shù)原型：long WINAPI PEU_Reader_Authentication_Pass(long ReaderHandle,unsigned char Mode, unsigned char SecNr,unsigned char *PassWord);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Mode：  [IN]要認證的Key類型，0x60表示KeyA，0x61表示KeyB。

Secnr： [IN]扇區(qū)號，S50卡范圍：0~15、S70卡范圍0~63

Key：   [IN]秘鑰，6字節(jié)

返回值：返回0表示成功，其他值失敗。

//備用函數(shù)

long WINAPI PEU_Reader_Authentication_PassHEX(long ReaderHandle,unsigned char Mode, unsigned char SecNr,char *PassWord);//認證密鑰M1 帶密鑰參數(shù)

3.3.3.2、讀卡

函數(shù)原型：long WINAPI PEU_Reader_Read(long ReaderHandle,unsigned char Addr,unsigned char *Data);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Addr：      [IN]塊地址S50卡：0~63、S70卡：0~255

    Response：  [OUT]讀出的卡數(shù)據(jù)，16字節(jié)

返回值：成功返回0，其它值失敗。

3.3.3.3、寫卡

函數(shù)原型：long WINAPI PEU_Reader_Write(long ReaderHandle,unsigned char Addr,unsigned char *Data);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Addr：  [IN]塊地址S50卡：0~63、S70卡：0~255

    Data：  [IN]待寫入的卡數(shù)據(jù)，16字節(jié)

返回值：成功返回0，其它值失敗。

3.4、身份證

3.4.1、讀身份證信息（文字+照片）

函數(shù)原型：

long WINAPI PEU_Reader_ReadIDMsg(long ReaderHandle,

const char* pBmpFile,

char *pName,

char *pSex,

char *pNation,

char *pBirth,

char *pAddress,

char *pCertNo,

char *pDepartment ,

char *pEffectData,

char *pExpire,

char * pErrMsg);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    pBmpFile：  [IN]要生成照片的路徑,例：”D:\\zp.bmp”

    pName：     [OUT]姓名，50字節(jié)

    pSex：      [OUT]性別，10字節(jié)

    pNation：   [OU]民族，10字節(jié)

    pBirth：    [OUT]出生日期，30字節(jié)

    pAddress：  [OUT]家庭住址，100字節(jié)

    pIDNo：     [OUT]身份號，50字節(jié)

    pDepartment：   [OUT]簽發(fā)機關，50

pEffectDate：   [OUT]有效起始日期，30字節(jié)

pExpireDate：   [OUT]有效截止日期，30字節(jié)

pErrMsg：       [OUT]錯誤提示，50字節(jié)

返回值：讀卡成功返回0

3.4.2、讀身份證信息（文字+照片）

函數(shù)原型：

long WINAPI PEU_Reader_ReadIDCard(long ReaderHandle, char * pErrMsg);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

pErrMsg：       [OUT]錯誤提示，50字節(jié)

返回值：讀卡成功返回0，讀卡成功后可調用下文get函數(shù)獲取信息

PEU_Reader_ReadIDCardFp（文字+照片+指紋）

函數(shù)原型：

long WINAPI PEU_Reader_ReadIDCardFp(long ReaderHandle, char * pErrMsg);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

pErrMsg：       [OUT]錯誤提示，50字節(jié)

返回值：讀卡成功返回0，讀卡成功后可調用下文get函數(shù)獲取信息

3.4.3、讀身份證物理ID號

函數(shù)原型：long WINAPI PEU_Reader_ID_ReadUID(long ReaderHandle,unsigned char* UID);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Response：[OUT]身份物理ID號，16字節(jié)字符串

返回值：成功返回0，其它值失敗。

3.4.4、查詢天線區(qū)域有無身份證

函數(shù)原型：long WINAPI PEU_Reader_ID_Request(long ReaderHandle);

參數(shù)：

ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

返回值：成功返回0，其它值失敗。

3.4.5 get函數(shù)

3.4.6 獲取SAMID

函數(shù)原型：long WINAPI EU_Reader_GetSAMID(long ReaderHandle,char *SAMID);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    SAMID： [OUT]返回的數(shù)據(jù)

返回值：0表示成功，其它表示失敗。

3.5、磁條

函數(shù)原型：long WINAPI Rcard(long ReaderHandle,unsigned char ctime,int track,unsigned char *rlen,unsigned char *getdata);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    ctime： [IN]超時時間，單位：秒

    track： [IN]磁道（1~3）磁道1~~磁道3，track=4時表示全軌一次性刷出，返回數(shù)據(jù)為TLV格式，例如：010101020201020303010203

    rlen：  [OUT]返回數(shù)據(jù)的長度

    data：  [OUT]返回的數(shù)據(jù)

返回值：0表示成功，其它表示失敗。

3.6、輔助函數(shù)

3.6.1、十六進制數(shù)組轉hexstr字符串，例如：0x11,0x22 à“1122”

函數(shù)原型：long WINAPI HexToStr(unsigned char *Src,int len,unsigned char *Des );

參數(shù)：

    Src：   [IN]十六進制數(shù)組

    Len：   [IN]數(shù)據(jù)長度

    Des：   [OUT]轉換好的hexstr格式字符串。

返回值：返回0

3.6.1、hexstr字符串轉十六進制數(shù)組，例如：“1122”à  0x11,0x22

函數(shù)原型：long WINAPI StrToHex(unsigned char *Src, int len,unsigned char *Des);

參數(shù)：

    Src：   [IN]hexstr格式字符串

    Len：   [IN]字節(jié)長度

    Des：   [OUT]轉換好的數(shù)據(jù)

返回值：返回轉換好的十六進制數(shù)據(jù)。

3.7、卡片操作要點

3.7.1    typeACPU 卡操作順序

1 設置為TypeA卡片

2 請求卡片

3 防碰撞

4 選擇卡片

5 上電

6  APDU 命令

3.7.2    typeB 卡操作順序

1 設置為TypeB卡片

2 上電

3 選卡

4  APDU 命令

3.7.3    M1卡操作順序

1 請求卡片

2 防碰撞

3 選擇卡片

4 認證密鑰

5  讀或寫

3.7.4    接觸CPU卡操作順序

1  上電復位

2  APDU 命令

3.8、 15693卡

3.8.1、15693尋卡

函數(shù)原型：long WINAPI PEU_Reader_Inventory (long ReaderHandle,unsigned char* Response);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Response： [OUT] 尋卡得到8字節(jié)卡片數(shù)據(jù)

返回值：成功返回0。

3.8.2、15693獲取卡片詳細信息

函數(shù)原型：long WINAPI PEU_Reader_SystemInfor(long ReaderHandle,unsigned char* Response);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

    Response： [OUT] 得到14字節(jié)卡片數(shù)據(jù)

返回值：成功返回0。

3.8.3、15693讀卡

函數(shù)原型：long WINAPI PEU_Reader_15693_Read (long ReaderHandle, unsigned char blk_add, unsigned char* Response);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

blk_add：[IN] 塊地址

    Response： [OUT] 得到4字節(jié)卡片數(shù)據(jù)

返回值：成功返回0。

3.8.4、15693寫卡

函數(shù)原型：long WINAPI PEU_Reader_15693_Write(long ReaderHandle, unsigned char blk_add, unsigned char* Response);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

blk_add：[IN] 塊地址

    Response： [IN] 要寫入的4字節(jié)卡片數(shù)據(jù)

返回值：成功返回0。

3.8.5、15693_AFI操作

函數(shù)原型：long WINAPI PEU_Reader_AFI(long ReaderHandle, unsigned char* data, unsigned char* Response);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

data：[IN] data[0] 為0表示寫AFI,為1則表示鎖AFI，

            data[0]為0時 data[1]為有效AFI值。

    Response： [OUT] NULL.

返回值：成功返回0。

3.8.6、15693_DSFID操作

函數(shù)原型：long WINAPI PEU_Reader_DSFID(long ReaderHandle, unsigned char* data, unsigned char* Response);

參數(shù)：

    ReaderHandle：[IN] EU_Reader_Open函數(shù)的返回值

data：[IN] data[0] 為0表示寫DSFID,為1則表示鎖AFI，

            data[0]為0時 data[1]為有效DSFID值。

    Response： [OUT] NULL.

返回值：成功返回0。

（*由于產(chǎn)品升級或其他原因，明創(chuàng)IDR-100U多功能身份證閱讀器Windows/Android/Linux開發(fā)包下載產(chǎn)品實際參數(shù)有可能變更，以實際產(chǎn)品為準。本文中的所有陳述、信息和建議也不構成任何明示或暗示的擔保）