• 廣東明創(chuàng)智慧科技有限公司是中國(guó)專(zhuān)業(yè)的身份證閱讀器供應(yīng)商,
  • 專(zhuān)注身份證閱讀器、指紋采集儀、社??ㄗx卡器、IC卡讀寫(xiě)器的一家身份證應(yīng)用服務(wù)平臺(tái)

明創(chuàng)智慧

當(dāng)前位置: 首頁(yè) > 服務(wù)支持專(zhuān)區(qū) > SDK開(kāi)發(fā)包 > 正文

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

來(lái)源:www.mingcreate.cn   標(biāo)簽:IDR-100U HID 多功能 開(kāi)發(fā)包 Windows Android Linux   最近更新:2022-2-19

3333.jpg

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


Windows平臺(tái)開(kāi)發(fā)包,包括BS,C/S,支持USB和串口:

點(diǎn)擊這里下載↓



Android平臺(tái)開(kāi)發(fā)包,包括USB和串口:

點(diǎn)擊這里下載↓



Linux平臺(tái)開(kāi)發(fā)包,包括USB和串口:

點(diǎn)擊這里下載↓



串口協(xié)議,支持單片機(jī)PLC等開(kāi)發(fā):

點(diǎn)擊這里下載↓





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

三、函數(shù)說(shuō)明

3.1、設(shè)備類(lèi)

3.1.1、連接讀卡器

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

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

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

3.1.2、斷開(kāi)連接

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

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

返回值:無(wú)

3.1.3、蜂鳴器

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

參數(shù):

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

Time:[IN] 蜂鳴時(shí)間,0~10

返回值:成功返回0。

 

 

3.1.4天線(xiàn)開(kāi)關(guān)

long WINAPI PEU_Reader_RFControl(long ReaderHandle,short type);

//type=0 關(guān)閉天線(xiàn) type=1 打開(kāi)天線(xiàn)

 

3.2、接觸類(lèi)

3.2.1、CPU卡&社保卡

3.2.1.1、CPU卡上電復(fù)位

函數(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]卡座號(hào)(如下)

0x01:大卡座

0x11~0x14:SAM1~SAM4卡座

Response[OUT]上電返回的ATR

 

返回值:成功返回ATR的長(zhǎng)度,<= 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]卡座號(hào),同上電復(fù)位

Lenth_of_Command_APDU: [IN]APDU命令長(zhǎng)度

Command_APDU:          [IN]APDU命令

Response_APDU:         [OUT]響應(yīng)數(shù)據(jù)

返回值:

    成功返回響應(yīng)數(shù)據(jù)的長(zhǎng)度,<= 0表示失敗

 

 

讀社???/span>

函數(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]社??ㄌ?hào)

XM:    [OUT]姓名

XB:    [OUT]性別

MZ:    [OUT]民族

CSRQ:  [OUT]出生日期

SHBZHM:    [OUT]身份證號(hào)

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

FKRQ:  [OUT]卡有效期

ErrMsg:[OUT]錯(cuò)誤信息

 

返回值:成功返回0

 

3.3、非接類(lèi)

3.3.1、非接卡前置步驟(必須)

3.3.1.1、設(shè)置為T(mén)ypeA/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、請(qǐng)求卡片

函數(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] 卡片物理卡號(hào),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卡上電復(fù)位

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

參數(shù):

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

    Response:[OUT]上電返回?cái)?shù)據(jù)(ATS)

返回值:成功返回ATS長(zhǎng)度,<= 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命令長(zhǎng)度

Command_APDU:          [IN]APDU命令

Response_APDU:         [OUT]響應(yīng)數(shù)據(jù)

返回值:

    成功返回響應(yīng)數(shù)據(jù)的長(zhǎng)度,<= 0表示失敗

 

3.3.3、Mifare One(M1卡) 系列

3.3.3.1、認(rèn)證秘鑰

函數(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]要認(rèn)證的Key類(lèi)型,0x60表示KeyA,0x61表示KeyB。

Secnr: [IN]扇區(qū)號(hào),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);//認(rèn)證密鑰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、寫(xiě)卡

函數(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]待寫(xiě)入的卡數(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]身份號(hào),50字節(jié)

    pDepartment:   [OUT]簽發(fā)機(jī)關(guān),50

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

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

pErrMsg:       [OUT]錯(cuò)誤提示,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]錯(cuò)誤提示,50字節(jié)

 

返回值:讀卡成功返回0,讀卡成功后可調(diào)用下文get函數(shù)獲取信息

 

PEU_Reader_ReadIDCardFp(文字+照片+指紋)

函數(shù)原型:

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

參數(shù):

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

pErrMsg:       [OUT]錯(cuò)誤提示,50字節(jié)

 

返回值:讀卡成功返回0,讀卡成功后可調(diào)用下文get函數(shù)獲取信息

 

3.4.3、讀身份證物理ID號(hào)

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

參數(shù):

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

    Response:[OUT]身份物理ID號(hào),16字節(jié)字符串

返回值:成功返回0,其它值失敗。

 

3.4.4、查詢(xún)天線(xiàn)區(qū)域有無(wú)身份證

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

 

參數(shù):

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

 

返回值:成功返回0,其它值失敗。

3.4.5 get函數(shù)

函數(shù)

獲取信息功能

包含證件類(lèi)型

int     WINAPI GetCardType();

獲取證件類(lèi)型

0:居民身份證

1:外國(guó)人永久居留證

2:港澳臺(tái)居民居住證


int   WINAPI GetName(char* pName);

姓名(類(lèi)型為1時(shí)表示:外國(guó)人中文姓名)

0、1、2

int   WINAPI GetSex(char* pSex);

性別

0、1、2

int   WINAPI GetNation(char* pNation);

民族

0

int   WINAPI GetBirth(char* pBirth);

出生日期

0、1、2

int   WINAPI GetAddress(char* pAddress);

住址

0、2

int   WINAPI GetCertNo(char* pCertNo);

公民身份證號(hào)碼(類(lèi)型為1時(shí)表示:外國(guó)人居留證號(hào)碼)

0、1、2

int   WINAPI GetDepartemt(char* pDepartemt);

簽發(fā)機(jī)關(guān)

0、2

intWINAPI   GetEffectDate(char* pEffectDate);

有效起始日期

0、1、2

int   WINAPI GetExpireDate(char* pExpireDate);

有效截止日期

0、1、2

int   WINAPI GetBmpFileData(char* pBmpFileData);

bmp格式照片數(shù)據(jù)

0、1、2

int   WINAPIGetBmpFile(char* pBmpfilepath);

生成照片,入?yún)⒖嘉闹?.4.1

0、1、2

int     WINAPI IsFingerExist();

是否含存在指紋信息:

存在時(shí)返回512或者1024

不存在時(shí)返回0

0、2

int WINAPIGetFingerprint(unsigned char* fpInfo);

獲取指紋數(shù)據(jù):

成功時(shí)返回獲取到的字節(jié)長(zhǎng)度

0、2

int   WINAPI GetEnName(char* pEnName);

外國(guó)人英文姓名

1

int   WINAPI GetNationalityCode(char* pNationalityCode);

外國(guó)人國(guó)籍代碼,符合GB/T2659-2000規(guī)定

1

int   WINAPI GetTXZHM(char* pTXZHM);

港澳臺(tái)通行證號(hào)碼

2

int   WINAPI GetTXZQFCS(char* pTXZQFCS);

港澳臺(tái)通行證簽發(fā)次數(shù)

2

注:以上函數(shù)須在 “PEU_Reader_ReadIDCard” 函數(shù)執(zhí)行成功之后調(diào)用,否則獲取不到有效信息。

 

 

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]超時(shí)時(shí)間,單位:秒

    track: [IN]磁道(1~3)磁道1~~磁道3,track=4時(shí)表示全軌一次性刷出,返回?cái)?shù)據(jù)為T(mén)LV格式,例如:010101020201020303010203

    rlen:  [OUT]返回?cái)?shù)據(jù)的長(zhǎng)度

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

返回值:0表示成功,其它表示失敗。

 

3.6、輔助函數(shù)

3.6.1、十六進(jìn)制數(shù)組轉(zhuǎn)hexstr字符串,例如:0x11,0x22 à“1122”

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

參數(shù):

    Src:   [IN]十六進(jìn)制數(shù)組

    Len:   [IN]數(shù)據(jù)長(zhǎng)度

    Des:   [OUT]轉(zhuǎn)換好的hexstr格式字符串。

返回值:返回0

3.6.1、hexstr字符串轉(zhuǎn)十六進(jìn)制數(shù)組,例如:“1122”à  0x11,0x22

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

參數(shù):

    Src:   [IN]hexstr格式字符串

    Len:   [IN]字節(jié)長(zhǎng)度

    Des:   [OUT]轉(zhuǎn)換好的數(shù)據(jù)

 

返回值:返回轉(zhuǎn)換好的十六進(jìn)制數(shù)據(jù)。

 

3.7、卡片操作要點(diǎn)

3.7.1    typeACPU 卡操作順序

1 設(shè)置為TypeA卡片

2 請(qǐng)求卡片

3 防碰撞

4 選擇卡片

5 上電

6  APDU 命令

3.7.2    typeB 卡操作順序

1 設(shè)置為TypeB卡片

2 上電

3 選卡

4  APDU 命令

3.7.3    M1卡操作順序

1 請(qǐng)求卡片

2 防碰撞

3 選擇卡片

4 認(rèn)證密鑰

讀或?qū)?/span>

3.7.4    接觸CPU卡操作順序

上電復(fù)位

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獲取卡片詳細(xì)信息

函數(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寫(xiě)卡

函數(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] 要寫(xiě)入的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表示寫(xiě)AFI,為1則表示鎖AFI,

            data[0]為0時(shí) data[1]為有效AFI值。

    Response: [OUT] NULL.

返回值:成功返回0。

 

3.8.615693_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表示寫(xiě)DSFID,為1則表示鎖AFI,

            data[0]為0時(shí) data[1]為有效DSFID值。

    Response: [OUT] NULL.

返回值:成功返回0。










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