增加外国人通用二次开发包接口说明

IDR-200U-IDR-器联机型身通用二次开发包接IDR-200U-IDR-器联机型身通用二次开发包接V4.0.1.10CPU卡发送超58字节数据问题，需IDR-200U-1V4.0.1.5增加对护照读卡器的支持V4.0.1.2增加Routon_RepeatRead函数，可控制是否连续读身份证-1V4.0.1.0增加M1-S70卡支V4.0.0.7读身份证V4.0.1.0增加M1-S70卡支V4.0.0.7读身份证信息前的容错处理V3.5.1.8解决照片解码相关的一个可能问题HIDIDR-200U Routon_CPUCard_PowerOFFRouton_CPUCard_Active-2目目 .-3目目 .-3概 .-6--4.Sdtapi.ll接口函数说 .-7端口函数- .-7--4.2.读二代证相关函 .-94.3. .-9-------------4.3.8.PSAM卡下 .-254.3.9.dc_init...................................................................................-254.3.10.dc_exit................................................................................-254.3.11.dc_request...........................................................................-264.3.12.dc_anticoll..........................................................................-264.3.13.dc_select.............................................................................-264.3.14.dc_authentication_passaddr...............................................-274.3.15.dc_read...............................................................................-27-34.3.16. .-274.3.17.dc_halt................................................................................-284.3.18.4.3.16. .-274.3.17.dc_halt................................................................................-284.3.18.dc_BeepLED......................................................................-284.3.19.Routon_CPUCard_PowerOFF...........................................-284.3.20.Routon_CPUCard_Active..................................................-294.3.21.Routon_CPUCard_ATS.....................................................-294.3.22.Routon_CPUCard_PPS......................................................-294.3.23.Routon_APDU...................................................................-294.3.24.Routon_ShutDownAntenna..............................................-304.3.25.Routon_Mute(boolisMute)................................................-304.3.26.Routon_RepeatRead(boolisRepeat)..................................-314.3.27.Routon_IsSaveWlt(boolisWlt)..........................................-314.3.28.ReadBaseInfosFPPhoto(char*Name,char*Gender,char*Folk,char*BirthDay,char*Code,char*Address,char*Agency,char*ExpireStart,char*ExpireEnd,char*directory,unsignedchar*pucFPMsg,unsignedint*puiFPMsgLen).....................................-32-4.3.29.Routon_DecideIDCardType()............................................-33Routon_ReadForeignBaseInfos(char*enName,char*Gender,char*Code,char*Nation,char*cnName,char*BirthDay,char*ExpireStart,char*ExpireEnd)........................................................-33Routon_ReadForeignBaseInfosPhoto(char*enName,*Gender,char*Code,char*Nation,char*cnName,char*BirthDay,char*ExpireStart,char*ExpireEnd,char*directory)....................-34-*Gender,char*Code,char*Nation,char*CnName,char**Agency,char*CardType,char .-364.3.33.Routon_ReadAllForeignBaseInfosPhoto(char*EnName,*Gender,char*Code,char*Nation,char*CnName,char**Agency,char*CardType,char*FutureItem,char.-374.3.34.FindAllUSB(int*SCount,int .-404.3.35.SelectUSB（intindex）....................................................-414.3.36.CloseSDTandHIDComm（intindex）..............................-414.3.37.InitSDTandHIDComm(intindex).......................................-414.3.38.Routon_ReadAllTypeCardInfos(intport,char*pMsg,*PhotoPath)....................................................................................-425.接口使用流程及示例43-448 .-43TypeA卡示例(IDR-200U)...........................................................-44--CPUIDR-200U)46- .-49-51.概（API1.概（API、、注意：完全兼容原2.0版本开发接口，支持USB-HID和串口的IDR-200U1、如果使用原开发包采用动态调用dll方式，只替换原dll即2、如果使用原开发包采用的静态调用方式，则变代码的情况下，对原程序重新编译链接2.Windows98、Windows2000Pro、Windows2000Server、WindowsXP。LargerLargerUSB口（视用户需求而定-6接口文件VisualC++C++Builder接口文件VisualC++C++Builder4.Sdtapi.ll接口函数说4.1.端口函4.1.1.端口初始原型：intInitCommintUSB数：iPort：设置串口、USB（公安部标准驱动、USB-HID（驱动、USB-CCID接口-71–161：4.1.2.端口关闭原说型：int参4.1.3.关闭天线型：intRouton_ShutDownAntenna4.1.2.端口关闭原说型：int参4.1.3.关闭天线型：intRouton_ShutDownAntenna明：本函数用于关闭天线场强。使用前必须端口初始化原说参-8值10值1值14.1.4.获取当前接入的HID接口IDR-200U数型：intGetHIDCount原说4.1.4.获取当前接入的HID接口IDR-200U数型：intGetHIDCount原说参4.1.5.设定当前操作的HID接口IDR-原说型：boolHIDSelectint参(2)来指定准备操作的IDR-200U设备4.2.二代证相关函4.2.1.卡认证接 型：intAuthenticate说-9值值值4.2.2.读卡信息原说型：intReadBaseMsg(unsignedchar*pMsg,int*字符串。图象信息被解码后存为文件photo.bmp（在当前工作目录下。 数[out]无符号字符指针，指4.2.2.读卡信息原说型：intReadBaseMsg(unsignedchar*pMsg,int*字符串。图象信息被解码后存为文件photo.bmp（在当前工作目录下。 数[out]无符号字符指针，指向读到的文本信息。需要在调用（NULL-10值10项长度（字节说399910原型2：intReadBaseMsgPhoto(unsignedchar*pMsg,int*len,char说photo.bm（ 数[out]无符号字符指针，指向读原型2：intReadBaseMsgPhoto(unsignedchar*pMsg,int*len,char说photo.bm（ 数[out]无符号字符指针，指向读到的文本信息。需要在调用（NULLdirectory[in],表示照片存储路径，路径最后有无“\”均（NULLReadBaseMsg原3：intReadBaseInfos(char*Name,char*Gender,char*char*BirthDay,char*Code,char*Address,char*Agency,char*ExpireStart，char*ExpireEnd)说-11值104项长度（字节说3999 数 [out]字符型指针，指向姓名信息。需要在调用时分配内存，字节数不小31。 [out]字符型指针，指 数 [out]字符型指针，指向姓名信息。需要在调用时分配内存，字节数不小31。 [out]字符型指针，指向民族信息。需要在调用时分配内存BirthDay[out]存，字节数不小9，前四位为出生年，第5位到第6位是出生月，后两位是[out]字符型指针，指向身份证号码信息。需要在调用时分Address[out]字符型指针，指向地址信息。需要在调用时分配内存，字节数不小71。[out]字符型指针，指向有效期起始日期信息。需要在[out]字符型指针，指向有效期截至日期信息。需要在 型4：intReadBaseInfosPhoto(char*Name,char*Gender,charFolk,char*BirthDay,char*Code,char*Address,char*Agency,char*ExpireStart，char*ExpireEnd,char*directory)说文字信息以字符串格式输出。图象信息被解码后存为照片photo.bmpphoto.jpgcard.jpg（在directory指定目录下参-12值10缺少dewlt.dll、[out]字符型指针，指向姓名信息。需要在调用时分配内存 [out]字符型指针，指向姓名信息。需要在调用时分配内存 [out]字符型指针，指向民族信息。需要在调用时分配内存BirthDay[out]字符型指针，指向出生日期信息。需要在调用时分配内存，字节数不小9，前四位为出生年，第5位到第6位是出生月，后两位出生日，格式为：CCYYMMDD[out]字符型指针，指向身份证号码信息。需要在调用时分Address[out]字符型指针，指向地址信息。需要在调用时分配内存，字节数不小71。[out]字符型指针，指向有效期起始日期信息。需要在[out]字符型指针，指向有效期截至日期信息。需要在（NULLReadBaseInfos5：intReadBaseMsgW(unsignedchar*pMsg,int*原说参-13值104缺少dewlt.dll、[out]无符号字符指针，指向读到的文本信息。需要在调用[out]6int原*说[out]无符号字符指针，指向读到的文本信息。需要在调用[out]6int原*说解码后存为文件photo.bmp（在directory指定目录下。 数[out]无符号字符指针，指向读到的文本信息。需要在调用-14项长度（字节说24值10项长度（字节说24[out]（NULLReadBaseMsgW4.2.3.读追加地 型1：intReadNewAppMsg(unsignedchar*pMsg,int*num说[out]（NULLReadBaseMsgW4.2.3.读追加地 型1：intReadNewAppMsg(unsignedchar*pMsg,int*num说 [out]无符号字符指针，指向读到的追加地址信息。需要在调用时分配内存，字节数不小于284。字段意义及偏移值如下所示：-15项长度（字节说值104原2：intReadNewAppInfos(unsignedchar*addr1,unsignedchar*addr2,unsignedchar*addr3,unsignedchar*addr4,int*num)；参原2：intReadNewAppInfos(unsignedchar*addr1,unsignedchar*addr2,unsignedchar*addr3,unsignedchar*addr4,int*num)；参原说3：intReadNewAppMsgW(unsignedchar*pMsg,int*numUCS-2进行存储 数[out]无符号字符指针，指向读到的追加地址信息。需要在-16项长度（字节说值10值104.2.4.读卡体管型：intReadIINSNDN(char*pMsg原4.2.4.读卡体管型：intReadIINSNDN(char*pMsg原:针对ERP编码为1IDA14016(即PCB型号B1342-3)1IDA14018(即PCB型号B1342-3)的串口组件设备，请使用原型2接口来读原型2: Routon_ReadIINSNDN(char*pMsg说参-17值10值10值10 原型 GetSAMIDToStr(char*pcSAMID明：本函数用于读取验证安全控制模 原型 GetSAMIDToStr(char*pcSAMID明：本函数用于读取验证安全控制模块（SAM_V）的序列36判断原型 CardOn(参-18值10值10读取包错误(base64串口设备-5,-6,-判断型 注读指纹及卡信息接型：intReadBaseFPMsgunsignedchar*pMsg,int*len原char判断型 注读指纹及卡信息接型：intReadBaseFPMsgunsignedchar*pMsg,int*len原char*pucFPMsg,unsigned 说参数：[out]无符号字符指针，指向读到的文本信息。需要在调用-19项长度（字节说39值1（NULL[out]无符号字符指针，指向读到的指纹信息。需要在（NULL[out]无符号字符指针，指向读到的指纹信息。需要在[out]4.3.Type卡相关函注意：串口型iDR200IDR-200U支持TypeA卡IDR-200URouton开头的相关函数。串口iDR200使用dc_开头的相关函数4.3.1.IC参-20值1M1-S502CPU3M1-S70值10994.3.2.IC卡序列号高级原说型：intRouton_IC_HL_ReadCardSN(char*参4.3.2.IC卡序列号高级原说型：intRouton_IC_HL_ReadCardSN(char*参SN[out]4.3.3.IC卡区块高级原intRouton_IC_HL_ReadCard(intSID,intunsignedchar*data)；说参SID为扇区号，0-15之间（M1S50卡BID为块号，0-3KeyType为密钥类型，两种：0x60keyA，0x61keyB小于16。-21值104MifareUltraLight04.3.4.IC卡区块高级原4.3.4.IC卡区块高级原intRouton_IC_HL_WriteCard(intSID,intunsignedchar*data)；说前需要先找卡Routon_IC_FindCard()参SID为扇区号，0-15之间（M1S50卡BID为块号，0-3KeyType为密钥类型，两种：0x60keyA，0x61keyB-22值10值104.3.5.控制蜂鸣器和指示 型intHID_BeepLED(boolBeepON,boolLEDON,unsignedintduration)； 明：本函数用于控制IDR-200UUSB-HID设备的LED指示灯和参4.3.5.控制蜂鸣器和指示 型intHID_BeepLED(boolBeepON,boolLEDON,unsignedintduration)； 明：本函数用于控制IDR-200UUSB-HID设备的LED指示灯和参原intRouton_BeepLED(boolBeepON,boolLEDON,unsignedint说参4.3.6.PSAMATR原intPSAM_ReadATR(unsignedcharCardIndex,unsignedSpeedIndex,unsignedcharTypeIndex,unsigned 说-23值10值10 0x01为卡座10x02为卡座4.3.7.PSAM卡发送数原intPSAM_SendCMD(unsignedchar 0x01为卡座10x02为卡座4.3.7.PSAM卡发送数原intPSAM_SendCMD(unsignedcharCardIndex,unsignedcharLen,unsignedcharCardIndex：0x01为卡座10x02为卡座*_Data:PSAM卡返回数据缓存说参-24值0值04.3.8.PSAM卡下原 4.3.8.PSAM卡下原 CardIndex：0x01为卡座10x02为卡座4.3.9.注意iDR200可使用本接口，IDR200U使用InitComm()参型：intdc_init(intport,long注意：仅串口型iDR200可使用本IDR-200U使用CloseComm()关闭端口型：intdc_exit(int参-25值04.3.11.原intdc_request(inticdev,unsignedchar4.3.11.原intdc_request(inticdev,unsignedchar_Mode,unsigned 参_Mode：寻卡模式。0Standard1All4.3.12.原intdc_anticoll(inticdev,unsignedchar_Bcnt,unsigned4.3.13.原型：intdc_select(inticdev,unsignedlong_Snr,unsignedchar-264.3.14.原型：intdc_authentication_passaddr(int4.3.14.原型：intdc_authentication_passaddr(inticdevunsignedcharunsignedcharAddr,unsignedchar说参_Mode：密码验证模式。0x60keyA，0x61keyB。4.3.15.型：dc_read(inticdev,unsignedchar_Adr,unsignedchar原4.3.16.型：dc_write(inticdev,unsignedchar_Adr,unsignedchar（1～63）,M1S0（1255参-274.3.17.型：dc_halt(inticdev);原4.3.17.型：dc_halt(inticdev);原4.3.18.原4.3.19.原明：CPU卡下电。-284.3.20.明：CPU卡激活。参4.3.21. 4.3.20.明：CPU卡激活。参4.3.21. unsignedint*ATSLen);说参明：CPURATSATS数据ATS数4.3.22.原PPS0PPS14.3.23.型：Routon_APDU(char*apdu,unsignedchar*data,int*明：向CPU卡发送APDU，并获取返回数据原说-29参4.3.24.Routon_Routon_ShutDownAntenna无原参4.3.24.Routon_Routon_ShutDownAntenna无原4.3.25.Routon_Mute(boolRouton_Mute(bool true为关闭，false参-30值01值01251字节原Routon_RepeatRead(bool true为可重复读，false4.3.27.Routon_IsSaveWlt(boolRouton_IsSaveWlt(bool原Routon_RepeatRead(bool true为可重复读，false4.3.27.Routon_IsSaveWlt(boolRouton_IsSaveWlt(bool原说 -31值01值01值014.3.28.Gender, Folk,char*BirthDay,char*char*Address,char*Agency,char*4.3.28.Gender, Folk,char*BirthDay,char*char*Address,char*Agency,char*char*ExpireEnd,char*directory,unsignedchar说 [out]字符型指针，指向姓名信息。需要在调用时分配内存 [out]字符型指针，指向民族信息。需要在调用时分配内存BirthDay[out]存，字节数不小9，前四位为出生年，第5位到第6位是出生月，后两[out]字符型指针，指向身份证号码信息。需要在调用时分Address[out]字符型指针，指向地址信息。需要在调用时分配内存，字节数不小71。[out]字符型指针，指向有效期起始日期信息。需要在[out]字符型指针，指向有效期截至日期信息。需要在（NULL同ReadBaseInfos-32puiFPMsgLen[out]4.3.29.说4.3.30.puiFPMsgLen[out]4.3.29.说4.3.30. char*Gender,char*Code,char*Nation,*ExpireStart,char*废弃，请使用接口说-33值值104缺少dewlt.dll、参enNameout]字符型指针，指向英文姓名信息。需要在调用时分配内存，字节数不小121。 分配内存，字节数不小3。[out]字符参enNameout]字符型指针，指向英文姓名信息。需要在调用时分配内存，字节数不小121。 分配内存，字节数不小3。[out]字符型指针，指向身份证号码信息。需要在调用时分[out]字符型指针，指向国籍信息。需要在调用时分配cnNameout]字符型指针，指向中文姓名信息。需要在调用时分配内存，字节数不小31。BirthDayout]字符型指针，指向出生日期信息。需要在调用时分配内位是出生日，格式为：CCYYMMDD[out]字符型指针，指向有效期起始日期信息。需要在[out]字符型指针，指向有效期截至日期信息。需要在4.3.31.(char*enName,char*Gender,char*Code,*Nation,char*cnName,char*BirthDay,charExpireStart,char*ExpireEnd,char*废弃，请使用接口说-34值01参enNameout]字符型指针，指向英文姓名信息。需要在调用时分配内存，字节数不小121。 分配内存，字节数不小3。参enNameout]字符型指针，指向英文姓名信息。需要在调用时分配内存，字节数不小121。 分配内存，字节数不小3。[out]字符型指针，指向身份证号码信息。需要在调用时分[out]字符型指针，指向国籍信息。需要在调用时分配cnNameout]字符型指针，指向中文姓名信息。需要在调用时分配内存，字节数不小31。BirthDayout]字符型指针，指向出生日期信息。需要在调用时分配内位是出生日，格式为：CCYYMMDD[out]字符型指针，指向有效期起始日期信息。需要在[out]字符型指针，指向有效期截至日期信息。需要在（NULL-35值014.3.32.(char*EnName,char*Gender,char*Code,*Nation,char*CnName,4.3.32.(char*EnName,char*Gender,char*Code,*Nation,char*CnName,char*BirthDay,charExpireStart,char*CardVertion,char*Agency,char*CardType,说参EnNameout]字符型指针，指向英文姓名信息。需要在调用时分配内存，字节数不小121。 [out]字符型指针，指向身份证号码信息。需要在调用时分[out]字符型指针，指向国籍信息。需要在调用时分配CnName[out]字符型指针，指向中文姓名信息。需要在调用时分配内存，字节数不小31。BirthDay[out]字符型指针，指向出生日期信息。需要在调用时分配内存，字节数不小9，前四位为出生年，第5位到第6位是出生月，后两ExpireStart[out]字符型指针，指向有效期起始日期信息。需要在调用时分配内存，字节数不小9,格式为：CCYYMMDD。CardVertionout]字符型指针，指向证件版本号信息。需要在调用时分配内存，字节数不小于5。]-36CardType[out]字符型指针，指向证件类型标识。需要在调用时分配内存，字节数不小于2。外国人永久居留证的标识为大写字母“ICardType[out]字符型指针，指向证件类型标识。需要在调用时分配内存，字节数不小于2。外国人永久居留证的标识为大写字母“I4.3.33.(char*EnName,char*Gender,char*Code,*Nation,char*CnName,char*BirthDay,charExpireStart,char*CardVertion,char*Agency,char*CardType,*FutureItem,char说参EnNameout]字符型指针，指向英文姓名信息。需要在调用时分配内存，字节数不小121。 分配内存，字节数不小3。[out]字符型指针，指向身份证号码信息。需要在调用时分[out]字符型指针，指向国籍信息。需要在调用时分配CnNameout]-37值01BirthDay[out]字符型指针，指向出生日期信息。需要在调用时分配内存，字节BirthDay[out]字符型指针，指向出生日期信息。需要在调用时分配内存，字节数不小9，前四位为出生年，第5位到第6位是出生月，后两ExpireStart[out]字符型指针，指向有效期起始日期信息。需要在调用时分配内存，字节数不小9,格式为：CCYYMMDD。CardVertionout]字符型指针，指向证件版本号信息。需要在调用时分配内存，字节数不小于5。Agencyout]字符型指针，指向当次申请受理机关代码信息。需要在调用时分配内存，字节数不小于9。CardType[out]字符型指针，指向证件类型标识。需要在调用时分配内存，字节数不小于2。外国人永久居留证的标识为大写字母“I己数不小于7。目前存放了三个空格符。Directoryin]字符指针,表示照片存储路径，路径最后有无“\”均可；（“”，效果同Routon_ReadForeignBaseInfos-38值014.3.34.Routon_ReadAllGATBaseInfos(char*Name,*Gender,char*FutureItem1,charchar4.3.34.Routon_ReadAllGATBaseInfos(char*Name,*Gender,char*FutureItem1,charchar*Address,char*Code,charcharExpireStart,char*ExpireEnd,char**SignCnt,char*FutureItem2,charchar说 数[out]字符型指针，指向姓名信息。需要在调用时分配内存Gender[out]字符型指针，指向性别信息（男或者女。需要在调用时分配内存，字节数不小3。要在调用时分配内存，字节数不小5。BirthDay[out]字符型指针，指向出生日期信息。需要在调用时分配内存，字节数不小9，前四位为出生年，第5位到第6位是出生月，后两Address[out][out]字符型指针，指向身份证号码信息。需要在调用时 [out]字符型指针，指向签发机关信息。需要在调用时分配内存，字节数不小于31。ExpireStartout]字符型指针，指向有效期起始日期信息。需要在调用时分配内存，字节数不小9,格式为：CCYYMMDD。-39 [out]字符型指针，指向签发次数。需要在调用时分配内存，字节数不小于5。 需要在调用时分配内存，字节数不小7。CardType[out]字符型指针，指向证件类型标识。需要在调用时分配内存，字节数不小于2 [out]字符型指针，指向签发次数。需要在调用时分配内存，字节数不小于5。 需要在调用时分配内存，字节数不小7。CardType[out]字符型指针，指向证件类型标识。需要在调用时分配内存，字节数不小于2。外国人永久居留证的标识为大写字母“J。 [out]字符型指针指向港澳台居住证第三块预留区信息。4.3.35.FindAllUSB(intint说明：本函数用于“部标”设备和HID设备同时连接PC时，获取当前PC连接的读卡设备的情况，能够识别是否有“部标”设备，有几台HID设备。备参注：仅针对USB接口的“部标”设备和HIDSCount[out]整型指针，指向当前PC连接“部标”设备数量。需要在调用时分配内存，字节数为1。SCount[0]0表示无“部标”设备，1表示HCount[out]整型指针，指向当前PCHID设备数量。需要在调用时分配内存，字节数为1。HCount[0]值为0表示无HID设备，1表示有一台HID设备，2表示有两台HID设备。-40值1值014.3.36.SelectUSB（int 4.3.36.SelectUSB（int 先先FindAllUSB()函数寻找USB接口设备。参indexHID设备。0代表“部标”设备，1HID1，2代表HID24.3.37.CloseSDTandHIDComm（int说备参indexHID设备。0代表“部标”设备，1HID1，2代表HID24.3.38.InitSDTandHIDComm(int 明：寻找当前PC连接的USB接口设备，根据用户选择的“部标”HID备注：仅针对USB接口的“部标”设备和HID设备。该接口包含-41值10值10FindAllUSB()和SelectUSB()参数indexHID设备。0代表“部标”设备，1HID1，2代表HID24.3.39.pMsg,charFindAllUSB()和SelectUSB()参数indexHID设备。0代表“部标”设备，1HID1，2代表HID24.3.39.pMsg,char数整数，表示设备的端口号或者串口pMsg[out]字符型指针，指向卡片的基本信息，在调用时分配内存，内存不小于265字节。Photopath[in]字符指针,表示头像照片存储路径，路径最后有无“\”均可；若不指定头像相片路径PhotoPath，则传入NULL或者“”，照片存在当前程序目录中；若指定头像照片路径PhotoPath,则传入不包含文件录，如“d:\\temp注：卡基本信息返回值pMsg备身份姓名|性别|民族|出生年月日|住址|公民身份号码|签发机关|有效-42返回含1卡片类型身份2卡片类型外国人居留--端口打开-卡认证失-读卡失-头像照片生成失值10限起始日期|有效期限起始日期|有效期限结束日期|有效期外国证:英文姓名|中文姓名|性别|国籍或地区代号|出生年月日|永久居住5.InitComm二代证示示intmain(){intintif(ret){if(ret){charret=ReadBaseMsg(Msg,0);if(ret>0){}intnum;ret=ReadNewAppMsg(Msg1,&num);if(ret>0){-43}}}ret=return}}}}ret=return}示#includeint{intret;if(ret){charif(Routon_IC_HL_ReadCardSN(csn))//读A卡卡{}{MessageBox(NULL,"Routon_IC_HL_ReadCa