DONSEE東信智能 - 身份證社保卡讀卡智能終端應(yīng)用服務(wù)商

DONSEE系列多功能讀寫(xiě)器Android API接口規(guī)范V1.0.44

DonseeDevice.aar

廣東東信智能科技有限公司

www.www.yjcsbsb.cn

2023.09.18

DONSEE系列多功能讀寫(xiě)器1

Android API接口規(guī)范V1.0.441

DonseeDevice.aar1

1、智能讀寫(xiě)器(SDK)簡(jiǎn)介5

2、函數(shù)說(shuō)明5

2.1通用函數(shù)5

2.1.1 Donsee_Open打開(kāi)設(shè)備5

2.1.2 Donsee_Close關(guān)閉設(shè)備6

2.1.3 Donsee_Beep蜂鳴器函數(shù)6

2.1.4 Donsee_Version讀取設(shè)備版本6

2.1.5 Donsee_SwitchRF設(shè)備天線開(kāi)關(guān)6

2.2身份證7

2.2.1 Donsee_ReadIDCard讀取身份證信息7

2.2.2 Donsee_ReadSAMID 讀取模塊SAM碼8

2.2.3 Donsee_ReadIDCardUid 讀取身份證UID8

2.3社保卡8

2.3.1 Donsee_ReadSSCard讀取社保卡信息8

2.4非接觸類卡片前置函數(shù)9

2.4.1 Donsee_ICRequest請(qǐng)求卡片9

2.4.2 Donsee_ICAnticoll防碰撞9

2.4.3 Donsee_ICSelect選擇卡片10

2.5 TypeA、TypeB卡10

2.5.1 Donsee_SetTypeA設(shè)置為T(mén)ypeA10

2.5.2 Donsee_SetTypeB設(shè)置為T(mén)ypeB10

2.5.3 Donsee_PowerOnTypeA TypeA卡上電復(fù)位10

2.5.4 Donsee_PowerOnTypeB TypeB卡上電復(fù)位11

2.5.5 Donsee_APDU執(zhí)行APDU命令11

2.6 M1卡11

2.6.1 Donsee_M1VerifyPass M1卡認(rèn)證秘鑰11

2.6.2 Donsee_M1VerifyPassHEX M1卡認(rèn)證秘鑰12

2.6.3 Donsee_M1Read M1卡讀卡12

2.6.4 Donsee_M1Write M1卡寫(xiě)卡12

2.6.5 Donsee_M1Initval M1卡初始化13

2.6.6 Donsee_M1Increment M1卡增值13

2.6.7 Donsee_M1Decrement M1卡減值13

2.6.8 Donsee_M1Readval M1卡讀值13

2.6.9 Donsee_M1LoadKey M1卡裝載密鑰14

2.6.10 Donsee_ReadICUid讀取M1和CPU卡的Uid卡號(hào)14

2.7接觸CPU卡14

2.7.1 Donsee_PowerOn CPU卡上電復(fù)位14

2.7.2 Donsee_ColdPowerOn 冷復(fù)位15

2.7.3 Donsee_HotPowerOn 熱復(fù)位15

2.7.4 Donsee_PowerOn_APDU CPU卡執(zhí)行APDU命令15

2.7.5 Donsee_PowerOn_LongAPDU CPU卡執(zhí)行APDU命令16

2.7.6 Donsee_PowerOff下電16

2.7.7 Donsee_GetStatus獲取卡座狀態(tài)17

2.8 15693卡17

2.8.1 Donsee_15693_Find 15693尋卡17

2.8.2 Donsee_15693_Info 15693獲取卡片詳細(xì)信息17

2.8.3 Donsee_15693_Read 15693讀卡18

2.8.4 Donsee_15693_Write 15693寫(xiě)卡18

2.8.5 Donsee_15693_WriteAFI 15693寫(xiě)AFI18

2.8.6 Donsee_15693_LockAFI 15693鎖AFI19

2.8.7 Donsee_15693_WriteDSFID 15693寫(xiě)DSFID19

2.8.8 Donsee_15693_LockDSFID 15693鎖DSFID19

2.8.9 Donsee_15693_LockDataBlock用于鎖定塊內(nèi)容19

2.9 SLE4442卡20

2.9.1 Donsee_4442_PowerOn 4442卡上電20

2.9.2 Donsee_4442_PowerOff 4442卡下電20

2.9.3 Donsee_4442_Read 4442卡讀數(shù)據(jù)20

2.9.4 Donsee_4442_Write 4442卡寫(xiě)數(shù)據(jù)21

2.9.5 Donsee_4442_Verify 4442卡認(rèn)證密鑰21

2.9.6 Donsee_4442_Change 4442卡修改密鑰21

2.9.7 Donsee_4442_ReadProtect 4442卡讀保護(hù)數(shù)據(jù)21

2.9.8 Donsee_4442_WriteProtect 4442卡寫(xiě)保護(hù)數(shù)據(jù)22

2.9.9 Donsee_4442_ReadCount 4442卡密鑰剩余認(rèn)證次數(shù)22

2.10磁條卡23

2.10.1 Donsee_ReadMagCard磁條卡讀卡23

2.11北京通23

2.11.1 Donsee_ReadBJTIDCard讀取北京通信息23

2.11.2 Donsee_ReadBJTIDCard_Photo讀取北京通照片24

2.12加密機(jī)24

2.12.1 Donsee_iReadCardBas讀基本信息24

2.12.2 Donsee_iReadCardBas_HSM_Step1加密機(jī)步驟124

2.12.3 Donsee_iReadCardBas_HSM_Step2加密機(jī)步驟225

2.13 4428卡25

2.13.1 Donsee_4428_PowerOn 4428卡上電25

2.13.2 Donsee_4428_PowerOff 4428卡下電26

2.13.3 Donsee_4428_Read 4428卡讀數(shù)據(jù)26

2.13.4 Donsee_4428_Write 4428卡寫(xiě)數(shù)據(jù)26

2.13.5 Donsee_4428_Verify 4428卡認(rèn)證密鑰27

2.13.6 Donsee_4428_Change 4428卡修改密鑰27

2.13.7 Donsee_4428_ReadCount 4428卡密鑰剩余認(rèn)證次數(shù)27

2.14輔助類函數(shù)27

2.14.1 Donsee_HexToStr 16進(jìn)制數(shù)組轉(zhuǎn)字符串27

2.14.2 Donsee_StrToHex 字符串轉(zhuǎn)16進(jìn)制數(shù)組28

3、狀態(tài)碼28

4、卡片調(diào)用順序30

4.1 TypeA卡30

4.2 TypeB卡30

4.3 M1卡30

4.4 4442卡30

4.5 接觸CPU卡30

1、智能讀寫(xiě)器(SDK)簡(jiǎn)介

本文檔描述了廣東東信智能科技有限公司DONSEE系列讀寫(xiě)器SDK的函數(shù)定義、調(diào)用方法、參數(shù)以及返回值說(shuō)明，供開(kāi)發(fā)人員進(jìn)行二次開(kāi)發(fā)時(shí)使用。

SDK會(huì)自動(dòng)檢查是否擁有USB設(shè)備權(quán)限，如沒(méi)有權(quán)限，會(huì)自動(dòng)進(jìn)行申請(qǐng)，如果您的安卓設(shè)備是定制設(shè)備，遇到找不到設(shè)備時(shí)，請(qǐng)?jiān)儐?wèn)設(shè)備定制方是否開(kāi)放了USB接口的系統(tǒng)層權(quán)限。

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

2.1通用函數(shù)

2.1.1 Donsee_Open打開(kāi)設(shè)備

定義：打開(kāi)設(shè)備端口

原型:

long Donsee_Open(String dev_Name)

參數(shù)：

dev_Name[in]windows：USB設(shè)備傳入”USB”；串口設(shè)備傳入”COM1” “COM2”等

Android：USB設(shè)備傳入”USB”；”/dev/ttyS0”,” /dev /ttyUSB0”,” /dev/ ttySAC0”等

返回值：

0：打開(kāi)設(shè)備成功；

非0：打開(kāi)設(shè)備失敗，參考狀態(tài)碼

2.1.2 Donsee_Close關(guān)閉設(shè)備

定義：關(guān)閉設(shè)備端口

原型:

long Donsee_Close()

參數(shù)：無(wú)

返回值：

0：關(guān)閉設(shè)備成功；

非0：關(guān)閉設(shè)備失敗，參考狀態(tài)碼

2.1.3 Donsee_Beep蜂鳴器函數(shù)

定義：調(diào)用設(shè)備蜂鳴器

原型:

long Donsee_Beep()

參數(shù)：無(wú)

返回值：

0：調(diào)用蜂鳴器成功；

非0：調(diào)用蜂鳴器失敗，參考狀態(tài)碼

2.1.4 Donsee_Version讀取設(shè)備版本

定義：讀取設(shè)備版本號(hào)

原型:

long Donsee_Version (byte[] chVersion)

參數(shù)：

chVersion[out]設(shè)備版本號(hào)

返回值：

>0：獲取設(shè)備版本成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：獲取設(shè)備版本失敗，參考狀態(tài)碼

2.1.5 Donsee_SwitchRF設(shè)備天線開(kāi)關(guān)

定義：設(shè)備天線開(kāi)關(guān)

原型:

long Donsee_SwitchRF (int nType)

參數(shù)：

nType1，打開(kāi)設(shè)備天線；0，關(guān)閉設(shè)備天線

返回值：

0：天線開(kāi)關(guān)操作成功；

非0：天線開(kāi)關(guān)操作失敗，參考狀態(tài)碼

2.2身份證

class IDCardInfo {

    public String name;/*中文姓名*/

    public String enFullName; /*英文姓名*/

    public String sex;/*性別*/

    public String nation;/*民族*/

    public String address; /*地址*/

    public String birthDate;/*出生日期（YYYYMMDD）*/

    public String issueDate; /*發(fā)證日期（YYYYMMDD）*/

    public String expireDate;/*有效日期（YYYYMMDD）*/

    public String idNO;  /*證件號(hào)碼*/

    public String organs;  /*發(fā)證機(jī)關(guān)(或外國(guó)人永久居住正-當(dāng)次申請(qǐng)受理機(jī)關(guān))*/

    public String nationality;    /*國(guó)籍*/

    public byte[] photo ;      /*讀取二代證電子信息時(shí)保存照片數(shù)據(jù)信息*/

    public String other;

    public String passNu;/*通行證號(hào)*/

    public String signCount; /*簽發(fā)數(shù)次*/

    public String certVersion;  /*證件版本*/

public String certType;  /*卡片類型,”0”大陸身份證” ”,I”外國(guó)人，”J”港澳臺(tái)，”Y”新版外國(guó)人*/

    public String reserveName;/*英文姓名備用*/

    public String previousVersionNO;/*既往版本永居證號(hào)碼*/

    public byte[] figData = new byte[1024] ;/*指紋信息*/

} 

2.2.1 Donsee_ReadIDCard讀取身份證信息

定義：讀取身份證信息

原型：long Donsee_ReadIDCard (int nType, IDCardInfo idCardInfo);

參數(shù)：

nType [in]:設(shè)置身份證讀卡類型：0，文本信息；1，文本+照片；2，文本+照片+指紋idCardInfo [out];獲取的身份證信息

返回值：

0：讀取身份證信息成功；

非0：讀取身份證信息失敗，參考狀態(tài)碼

2.2.2 Donsee_ReadSAMID 讀取模塊SAM碼

定義：讀取身份證模塊SAM碼

原型：long Donsee_ReadSAMID (byte[] chSAM);

參數(shù)：

chSAM [out] 身份證模塊SAM碼

返回值：

0：讀取身份證模塊SAM碼成功；

非0：讀取身份證模塊SAM碼失敗，參考狀態(tài)碼

2.2.3 Donsee_ReadIDCardUid 讀取身份證UID

定義：讀取身份證UID

原型：long Donsee_ReadIDCardUid(byte[] chUID);

參數(shù)：

chUID [out] 身份證UID碼

返回值：

0：讀取身份證UID成功；

非0：讀取身份證UID失敗，參考狀態(tài)碼

2.3社保卡

public class SciCardInfo {

public String name; /*姓名*/

public String address; /*地址*/  //帶地址的請(qǐng)調(diào)用Donsee_ReadSSCardWithAddress

    public String sex; /*性別*/

    public String idNO; /*社會(huì)保障號(hào)碼(身份證號(hào))*/

    public String birthDate; /*出生日期（YYYYMMDD）*/

    public String cardNO; /*卡號(hào)*/

    public String issueDate; /*發(fā)證日期（YYYYMMDD）*/

    public String expireDate; /*有效日期（YYYYMMDD）*/

    public String fullVersion; /*社保卡版本*/

    public String nation; /*民族*/

    public String cityCode; /*城市代碼*/

2.3.1 Donsee_ReadSSCard讀取社保卡信息

定義：讀取二代、三代社保卡

原型：

long Donsee_ReadSSCard (int nSlotPsam,

int nType ;

SciCardInfo cardInfo,

byte[] arrChMsg);

參數(shù)：

nSlotPsam [int] PSAM存放卡座，0x11 SAM1, 0x12 SAM2, 0x13 SAM3, 0x14 SAM4

nType[in]有無(wú)SAM卡(針對(duì)三代社保卡)

1，有SAM卡返回全部信息

2，無(wú)SAM卡返回卡號(hào)

cardInfo [out] 社保卡信息

arrChMsg [out] 錯(cuò)誤信息

返回值：

0：讀取社保卡成功；

非0：讀取社保卡失敗，參考狀態(tài)碼

備注：二代社保卡無(wú)需PSAM卡，只支持接觸式讀取。三代社保卡必須配備PSAM卡，支持接觸、非接兩種方式讀取。三代社保卡無(wú)PSAM卡只返回卡號(hào)。

2.4非接觸類卡片前置函數(shù)

2.4.1 Donsee_ICRequest請(qǐng)求卡片

定義：請(qǐng)求卡片

原型:

long Donsee_ICRequest ()

參數(shù)：

返回值：

0：請(qǐng)求卡片成功；

非0：請(qǐng)求卡片失敗，參考狀態(tài)碼

2.4.2 Donsee_ICAnticoll防碰撞

定義：卡片防碰撞

原型:

long Donsee_ICAnticoll (byte[] chUID)

參數(shù)：

chUID[out]卡片序列號(hào)Uid

返回值：

>0：卡片防碰撞成功；

<=0：卡片防碰撞失敗，參考狀態(tài)碼

2.4.3 Donsee_ICSelect選擇卡片

定義：選擇卡片

原型:

long Donsee_ICSelect (byte nCardType)

參數(shù)：

nCardType [in]0x41 表示 typeA 及M1 卡，0x43 表示 typeB卡

返回值：

0：選擇卡片成功；

非0：選擇卡片失敗，參考狀態(tài)碼

2.5 TypeA、TypeB卡

2.5.1 Donsee_SetTypeA設(shè)置為T(mén)ypeA

定義：設(shè)置為T(mén)ypeA卡

原型:

long Donsee_SetTypeA ()

參數(shù)：

返回值：

0：設(shè)置為T(mén)ypeA卡成功；

非0：設(shè)置為T(mén)ypeA卡失敗，參考狀態(tài)碼

2.5.2 Donsee_SetTypeB設(shè)置為T(mén)ypeB

定義：設(shè)置為T(mén)ypeB卡

原型:

long Donsee_SetTypeB ()

參數(shù)：

返回值：

0：設(shè)置為T(mén)ypeB卡成功；

非0：設(shè)置為T(mén)ypeB卡失敗，參考狀態(tài)碼

2.5.3 Donsee_PowerOnTypeA TypeA卡上電復(fù)位

定義：TypeA上電

原型:

long Donsee_ PowerOnTypeA (byte[] Response)

參數(shù)：

Response [out]卡片復(fù)位信息(ATR)

返回值：

>0：TypeA上電成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：TypeA上電失敗，參考狀態(tài)碼

2.5.4 Donsee_PowerOnTypeB TypeB卡上電復(fù)位

定義：TypeB上電

原型:

long Donsee_PowerOnTypeB(byte[] Response)

參數(shù)：

Response [out]卡片復(fù)位信息(ATR)

返回值：

>0：TypeB上電成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：TypeB上電失敗，參考狀態(tài)碼

2.5.5 Donsee_APDU執(zhí)行APDU命令

定義：TypeA|TypeB執(zhí)行APDU命令

原型:

long Donsee_APDU (byte[] Command_APDU, byte[] Response_APDU);

參數(shù)：

Command_APDU [in]下發(fā)APDU命令(字符串”0084000008”)

Response_APDU[out]執(zhí)行APDU相應(yīng)數(shù)據(jù)(字符串如”9000”)

返回值：

>0：執(zhí)行APDU命令成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：執(zhí)行APDU命令失敗，參考狀態(tài)碼

2.6 M1卡

2.6.1 Donsee_M1VerifyPass M1卡認(rèn)證秘鑰

定義：M1卡認(rèn)證秘鑰

原型:

long Donsee_M1VerifyPass (byte nMode, byte nSecNr,byte[] PassWord);

參數(shù)：

nMode [in]認(rèn)證模式, 0x60 認(rèn)證KeyA|0x61  認(rèn)證KeyB

nSecNr [in]扇區(qū)號(hào) (0~15)

PassWord [in]密鑰(如:”FFFFFFFFFFFF”)

返回值：

0：M1卡認(rèn)證秘鑰成功；

非0：M1卡認(rèn)證秘鑰失敗，參考狀態(tài)碼

2.6.2 Donsee_M1VerifyPassHEX M1卡認(rèn)證秘鑰

定義：M1卡認(rèn)證秘鑰

原型:

long Donsee_M1VerifyPassHex (byte nMode, byte nSecNr,byte[] PassWord);

參數(shù)：

nMode [in]認(rèn)證模式, 0x60 認(rèn)證KeyA|0x61  認(rèn)證KeyB

nSecNr [in]扇區(qū)號(hào) (0~15)

PassWord [in]密鑰(如:{0xff,0xff,0xff ,0xff ,0xff ,0xff })

返回值：

0：M1卡認(rèn)證秘鑰成功；

非0：M1卡認(rèn)證秘鑰失敗，參考狀態(tài)碼

2.6.3 Donsee_M1Read M1卡讀卡

定義：M1卡讀卡

原型:

long Donsee_M1Read(byte Addr, byte[]chData)

參數(shù)：

Addr [in]塊號(hào)(S50該值范圍0~63| S70該值范圍0~255)

chData [out]讀取數(shù)據(jù)

返回值：

>0：M1卡讀卡成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：M1卡讀卡失敗，參考狀態(tài)碼

2.6.4 Donsee_M1Write M1卡寫(xiě)卡

定義：M1卡寫(xiě)卡

原型:

long Donsee_M1Write(byte Addr,byte[]chData)

參數(shù)：

Addr [in]塊號(hào)(S50該值范圍0~63| S70該值范圍0~255)

chData [in]讀取數(shù)據(jù)

塊地址計(jì)算公式：塊地址=扇區(qū)號(hào)*4+當(dāng)前塊號(hào)

返回值：

0：M1卡寫(xiě)卡成功；

非0：M1卡寫(xiě)卡失敗，參考狀態(tài)碼

2.6.5 Donsee_M1Initval M1卡初始化

定義：M1卡初始化

原型:

long Donsee_M1Initval (byte nAddr, long nValue)

參數(shù)：

nAddr[in]塊號(hào)(S50該值范圍0~63| S70該值范圍0~255)

nValue [int]數(shù)值

返回值：

0：M1卡初始化成功；

非0：M1卡初始化失敗，參考狀態(tài)碼

2.6.6 Donsee_M1Increment M1卡增值

定義：M1卡增值

原型:

long Donsee_M1Increment (byte nAddr, long nValue)

參數(shù)：

nAddr[in]塊號(hào)(S50該值范圍0~63| S70該值范圍0~255)

nValue [int]數(shù)值

返回值：

0：M1卡增值成功；

非0：M1卡增值失敗，參考狀態(tài)碼

2.6.7 Donsee_M1Decrement M1卡減值

定義：M1卡減值

原型:

long Donsee_M1Decrement (byte nAddr, long nValue)

參數(shù)：

nAddr[in]塊號(hào)(S50該值范圍0~63| S70該值范圍0~255)

nValue [int]數(shù)值

返回值：

0：M1卡減值成功；

非0：M1卡減值失敗，參考狀態(tài)碼

2.6.8 Donsee_M1Readval M1卡讀值

定義：M1卡讀值

原型:

long Donsee_M1Readval (byte nAddr, long[] nValue)

參數(shù)：

nAddr[in]塊號(hào)(S50該值范圍0~63| S70該值范圍0~255)

nValue [out]數(shù)值

返回值：

0：M1卡讀值成功；

非0：M1卡讀值失敗，參考狀態(tài)碼

2.6.9 Donsee_M1LoadKey M1卡裝載密鑰

定義：裝載M1卡密鑰到設(shè)備

原型:

long Donsee_M1LoadKey (byte nMode, byte nSecNr, byte[]PassWord);

參數(shù)：

nMode [in]認(rèn)證模式, 0x00 認(rèn)證KeyA|0x04  認(rèn)證KeyB

nSecNr [in]扇區(qū)號(hào) (0~15)

PassWord [int]待下載到設(shè)備的密鑰

例子：

byte key[10]={0xff,0xff,0xff,0xff,0xff,0xff};

int nRe = Donsee_M1LoadKey (0,0,key);//下載扇區(qū)0的KeyA密鑰至設(shè)備里

返回值：

0：M1卡裝載密鑰成功；

非0：M1卡裝載密鑰失敗，參考狀態(tài)碼

2.6.10 Donsee_ReadICUid讀取M1和CPU卡的Uid卡號(hào)

定義：讀取M1和CPU卡UID

原型:

long Donsee_ReadICUid (byte[] chUID)

參數(shù)：

chUID[out]卡片序列號(hào)

返回值：

0：讀取M1和CPU卡的Uid卡號(hào)成功；

非0：讀取M1和CPU卡的Uid卡號(hào)失敗，參考狀態(tài)碼

2.7接觸CPU卡

2.7.1 Donsee_PowerOn CPU卡上電復(fù)位

定義：CPU卡上電復(fù)位

原型:

long Donsee_PowerOn (byte nSlotNo, byte[] chResponse)

參數(shù)：

nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；

0x11：SAM1卡座；0x12：SAM2卡座；

0x13：SAM3卡座；0x14：SAM4卡座

chResponse [out]卡片返回復(fù)位信息數(shù)據(jù)

返回值：

>0：卡片復(fù)位成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：卡片復(fù)位失敗，參考狀態(tài)碼

2.7.2 Donsee_ColdPowerOn 冷復(fù)位

定義：接觸CPU卡冷復(fù)位

原型:

long Donsee_ColdPowerOn (byte nSlotNo, byte[] chResponse)

參數(shù)：

nSlotNo[in]卡座選擇：0x01 大卡座； 0x02：副卡座 ；

0x11：SAM1卡座；0x12：SAM2卡座；

0x13：SAM3卡座；0x14：SAM4卡座

chResponse [out]卡片返回復(fù)位信息數(shù)據(jù)

返回值：

>0：卡片復(fù)位成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：卡片復(fù)位失敗，參考狀態(tài)碼

2.7.3 Donsee_HotPowerOn 熱復(fù)位

定義：接觸CPU卡熱復(fù)位

原型:

long Donsee_HotPowerOn (byte nSlotNo, byte[] chResponse)

參數(shù)：

nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；

0x11：SAM1卡座；0x12：SAM2卡座；

0x13：SAM3卡座；0x14：SAM4卡座

chResponse [out]卡片返回復(fù)位信息數(shù)據(jù)

返回值：

>0：卡片復(fù)位成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：卡片復(fù)位失敗，參考狀態(tài)碼

2.7.4 Donsee_PowerOn_APDU CPU卡執(zhí)行APDU命令

定義：執(zhí)行APDU命令

原型:

long Donsee_PowerOn_APDU(byte nSlotNo,

byte[] Command_APDU,

byte[] Response_APDU);

)

參數(shù)：

nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；

0x11：SAM1卡座；0x12：SAM2卡座；

0x13：SAM3卡座；0x14：SAM4卡座

Command_APDU [in]下發(fā)APDU命令(字符串”0084000008”)

Response_APDU[out]執(zhí)行APDU相應(yīng)數(shù)據(jù)(字符串如”9000”)

返回值：

>0：執(zhí)行APDU命令成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：執(zhí)行APDU命令失敗，參考狀態(tài)碼

2.7.5 Donsee_PowerOn_LongAPDU CPU卡執(zhí)行APDU命令

定義：執(zhí)行APDU命令

原型:

long Donsee_PowerOn_LongAPDU (byte nSlotNo,

byte[] Command_APDU,

byte[] Response_APDU);

)

參數(shù)：

nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；

0x11：SAM1卡座；0x12：SAM2卡座；

0x13：SAM3卡座；0x14：SAM4卡座

Command_APDU [in]下發(fā)APDU命令(字符串”0084000008”)

Response_APDU[out]執(zhí)行APDU相應(yīng)數(shù)據(jù)(字符串如”9000”)

返回值：

>0：執(zhí)行APDU命令成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：執(zhí)行APDU命令失敗，參考狀態(tài)碼

2.7.6 Donsee_PowerOff下電

定義：CPU卡下電

原型:

long Donsee_PowerOff (byte nSlotNo)

參數(shù)：

nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；

0x11：SAM1卡座；0x12：SAM2卡座；

0x13：SAM3卡座；0x14：SAM4卡座

返回值：

0：CPU卡下電成功；

非0：CPU卡下電失敗，參考狀態(tài)碼

2.7.7 Donsee_GetStatus獲取卡座狀態(tài)

定義：獲取卡座狀態(tài)

原型:

long Donsee_GetStatus(byte nSlotNo,int* nStatus)

參數(shù)：

nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；

0x11：SAM1卡座；0x12：SAM2卡座；

0x13：SAM3卡座；0x14：SAM4卡座

nStatus[out]卡座狀態(tài)：為 0 表示有卡上電，1表示有卡未上，2表示無(wú)卡

返回值：

0：獲取卡座狀態(tài)成功；

非0：獲取卡座狀態(tài)失敗，參考狀態(tài)碼

2.8 15693卡

2.8.1 Donsee_15693_Find 15693尋卡

定義：15693尋卡

原型:

long Donsee_15693_Find (byte[] chUID)

參數(shù)：

chUID [out]尋卡得到8字節(jié)卡片數(shù)據(jù)；

返回值：

0：15693尋卡成功；

非0：15693尋卡失敗，參考狀態(tài)碼

2.8.2 Donsee_15693_Info 15693獲取卡片詳細(xì)信息

定義：獲取15693卡詳細(xì)信息

原型:

long Donsee_15693_Info (byte[] chCardInfo)

參數(shù)：

chCardInfo [out]14字節(jié)卡片數(shù)據(jù)；

返回值：

0：獲取15693卡詳細(xì)信息成功；

非0：獲取15693卡詳細(xì)信息失敗，參考狀態(tài)碼

2.8.3 Donsee_15693_Read 15693讀卡

定義：15693讀卡

原型:

long Donsee_15693_Read (byte nBlkAdd, byte[] chResult)

參數(shù)：

nBlkAdd[in]塊地址

chResult [out]14字節(jié)卡片數(shù)據(jù)；

返回值：

>0：15693讀卡成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：15693讀卡失敗，參考狀態(tài)碼

2.8.4 Donsee_15693_Write 15693寫(xiě)卡

定義：15693寫(xiě)卡

原型:

long Donsee_15693_Write (byte nBlkAdd, byte[] chData)

參數(shù)：

nBlkAdd[in]塊地址

chData [in]要寫(xiě)入的4字節(jié)卡片數(shù)據(jù)；

返回值：

0：15693寫(xiě)卡成功；

非0：15693寫(xiě)卡失敗，參考狀態(tài)碼

2.8.5 Donsee_15693_WriteAFI 15693寫(xiě)AFI

定義：15693寫(xiě)AFI

原型:

long Donsee_15693_WriteAFI (byte[] data, byte[] Response)

參數(shù)：

data [in]data[0] 為0表示寫(xiě)AFI,為1則表示鎖AFI

Response [in]null

返回值：

0：15693寫(xiě)AFI成功；

非0：15693寫(xiě)AFI失敗，參考狀態(tài)碼

2.8.6 Donsee_15693_LockAFI 15693鎖AFI

定義：15693寫(xiě)AFI

原型:

long Donsee_15693_LookAFI (byte[] data, byte[] Response)

參數(shù)：

data [in]data[0] 為0表示寫(xiě)AFI,為1則表示鎖AFI

Response [in]null

返回值：

0：15693鎖AFI成功；

非0：15693鎖AFI失敗，參考狀態(tài)碼

2.8.7 Donsee_15693_WriteDSFID 15693寫(xiě)DSFID

定義：15693寫(xiě)DSFID

原型:

long Donsee_15693_WriteDSFID (byte[] data, byte[] Response)

參數(shù)：

data [in]data[0] 為0表示寫(xiě)DSFID,為1則表示鎖DSFID

Response [in]null

返回值：

0：15693寫(xiě)DSFID成功；

非0：15693寫(xiě)DSFID 失敗，參考狀態(tài)碼

2.8.8 Donsee_15693_LockDSFID 15693鎖DSFID

定義：15693鎖DSFID

原型:

long Donsee_15693_LockDSFID (byte[] data, byte[] Response a)

參數(shù)：

data [in]data[0] 為0表示寫(xiě)AFI,為1則表示鎖AFI

Response [out]null；

返回值：

0：15693鎖DSFID成功；

非0：15693鎖DSFID失敗，參考狀態(tài)碼

2.8.9 Donsee_15693_LockDataBlock用于鎖定塊內(nèi)容

定義：用于鎖定塊內(nèi)容。注意：此過(guò)程不可逆（不能解鎖）塊鎖定后內(nèi)容不能在修改。

原型:

long Donsee_15693_LockDataBlock(byte blk_add, byte[] chResult)

參數(shù)：

blk_add [in]塊地址

chResult [out]返回?cái)?shù)據(jù)

返回值：

0：15693鎖塊內(nèi)容成功；

非0：15693鎖塊內(nèi)容失敗，參考狀態(tài)碼

2.9 SLE4442卡

2.9.1 Donsee_4442_PowerOn 4442卡上電

定義：4442卡上電

原型:

long Donsee_4442_PowerOn (byte[] chUID)

參數(shù)：

chUID [out]上電返回?cái)?shù)據(jù)，4字節(jié)廠商代碼

返回值：

>0：4442卡上電成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：4442卡上電失敗，參考狀態(tài)碼

2.9.2 Donsee_4442_PowerOff 4442卡下電

定義：4442卡下電

原型:

long Donsee_4442_PowerOff ()

參數(shù)：

返回值：

0：4442卡下電成功；

非0：4442卡下電失敗，參考狀態(tài)碼

2.9.3 Donsee_4442_Read 4442卡讀數(shù)據(jù)

定義：4442卡讀取數(shù)據(jù)

原型:

long Donsee_4442_Read (int nOffset, int nLen, byte[]chData)

參數(shù)：

nOffset[in]起始地址

nLen[in]讀取數(shù)據(jù)長(zhǎng)度

chData [iout]讀取的數(shù)據(jù)內(nèi)容

返回值：

>0：4442卡讀取數(shù)據(jù)成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：4442卡讀取數(shù)據(jù)失敗，參考狀態(tài)碼

2.9.4 Donsee_4442_Write 4442卡寫(xiě)數(shù)據(jù)

定義：4442卡寫(xiě)入數(shù)據(jù)

原型:

long Donsee_4442_Read (int nOffset, int nLen, byte[]chData)

參數(shù)：

nOffset[in]起始地址

nLen[in]寫(xiě)入數(shù)據(jù)長(zhǎng)度

chData [in]寫(xiě)入的數(shù)據(jù)內(nèi)容

返回值：

0：4442卡寫(xiě)入數(shù)據(jù)成功；

非0：4442卡寫(xiě)入數(shù)據(jù)失敗，參考狀態(tài)碼

2.9.5 Donsee_4442_Verify 4442卡認(rèn)證密鑰

定義：4442卡認(rèn)證秘鑰

原型:

long Donsee_4442_Verify(byte[]chKey)

參數(shù)：

chKey [in]秘鑰數(shù)據(jù)，如unsigned  byte[] chKey={0xff,0xff,0xff};

返回值：

0：4442卡認(rèn)證秘鑰成功；

非0：4442卡認(rèn)證秘鑰失敗，參考狀態(tài)碼

2.9.6 Donsee_4442_Change 4442卡修改密鑰

定義：4442卡修改秘鑰

原型:

long Donsee_4442_Change (byte[]chNewKey)

參數(shù)：

chNewKey [in]秘鑰數(shù)據(jù)，如unsigned  byte[] chNewKey ={0xff,0xff,0xff};

返回值：

0：4442卡修改密鑰成功；

非0：4442卡修改密鑰失敗，參考狀態(tài)碼

2.9.7 Donsee_4442_ReadProtect 4442卡讀保護(hù)數(shù)據(jù)

定義：4442卡讀取保護(hù)數(shù)據(jù)

原型:

long Donsee_4442_ReadProtect (int nOffset, int nLen, byte[]chData)

參數(shù)：

nOffset[in]起始地址，起始地址 需小于32

nLen[in]讀取數(shù)據(jù)長(zhǎng)度，數(shù)據(jù)長(zhǎng)度 需小于32

chData [iout]讀取的數(shù)據(jù)內(nèi)容，返回值為一串00或01的數(shù)據(jù)串，如果為00代表已寫(xiě)保護(hù)，如果為01代表未寫(xiě)保護(hù)

返回值：

>0：4442卡讀保護(hù)數(shù)據(jù)成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：4442卡讀保護(hù)數(shù)據(jù)失敗，參考狀態(tài)碼

2.9.8 Donsee_4442_WriteProtect 4442卡寫(xiě)保護(hù)數(shù)據(jù)

定義：4442卡寫(xiě)入保護(hù)數(shù)據(jù)，即固化數(shù)據(jù)，一旦寫(xiě)保護(hù)，數(shù)據(jù)將不能再修改

原型:

long Donsee_4442_WriteProtect (int nOffset, int nLen, byte[]chData)

參數(shù)：

nOffset[in]起始地址，起始地址 需小于32

nLen[in]讀取數(shù)據(jù)長(zhǎng)度，數(shù)據(jù)長(zhǎng)度 需小于32

chData [in]讀取的數(shù)據(jù)內(nèi)容，返回值為一串00或01的數(shù)據(jù)串，如果為00代表已寫(xiě)保護(hù)，如果為01代表未寫(xiě)保護(hù)

返回值：

0：4442卡寫(xiě)保護(hù)數(shù)據(jù)成功；

非0：4442卡寫(xiě)保護(hù)數(shù)據(jù)失敗，參考狀態(tài)碼

2.9.9 Donsee_4442_ReadCount 4442卡密鑰剩余認(rèn)證次數(shù)

定義：4442卡密鑰剩余認(rèn)證次數(shù)

原型:

long Donsee_4442_ReadCount (int[] nCount)

參數(shù)：

nCount [0]4442卡密鑰剩余認(rèn)次數(shù)

返回值：

0：獲取4442卡密鑰剩余認(rèn)證次數(shù)成功；

非0：獲取4442卡密鑰剩余認(rèn)證次數(shù)失敗，參考狀態(tài)碼

2.10磁條卡

2.10.1 Donsee_ReadMagCard磁條卡讀卡

定義：磁條卡讀卡

原型:

long Donsee_ReadMagCard (byte ctime,int track, byte[]rlen, byte[]getdata)

參數(shù)：

ctime[in]超時(shí)時(shí)間，單位：秒

track [in]磁道（1~3）磁道1~~磁道3，track=4時(shí)表示全軌一次性刷出

為T(mén)LV格式，例如：010101020201020303010203

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

getdata [out]返回的數(shù)據(jù)

返回值：

0：磁條卡讀卡成功；

非0：磁條卡讀卡失敗，參考狀態(tài)碼

2.11北京通

class BJTCardInfo {

public String name; /*姓名*/

    public String sex; /*性別*/

    public String cardNO; /*北京通號(hào)*/

    public String cardType; /*卡片類型*/

    public String cardName; /*證件名稱*/

    public String cardIssuer; /*發(fā)卡機(jī)構(gòu)*/

}

2.11.1 Donsee_ReadBJTIDCard讀取北京通信息

定義：讀取北京通信息

原型：

long Donsee_ReadBJTIDCard (BJTCardInfo cardInfo);

參數(shù)：

cardInfo [out] 北京通信息

返回值：

0：讀取北京通信息成功；

非0：讀取北京通信息失敗，參考狀態(tài)碼

2.11.2 Donsee_ReadBJTIDCard_Photo讀取北京通照片

定義：讀取北京通信息

原型：

long Donsee_ReadBJTIDCard_Photo (byte[] cardInfoPhoto);

參數(shù)：

cardInfoPhoto[out] 北京通照片信息

返回值：

>0：讀取北京通照片信息成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：讀取北京通照片信息失敗，參考狀態(tài)碼

2.12加密機(jī)

2.12.1 Donsee_iReadCardBas讀基本信息

定義：讀基本信息

原型:

long Donsee_iReadCardBas (int nType, byte[] info)

參數(shù)：

nType [in]卡片類型 1接觸、2非接、3接觸+非接，非接優(yōu)先

info [out]返回的數(shù)據(jù)

返回值：

0：讀卡成功；

非0：讀卡失敗，參考狀態(tài)碼

//返回格式：發(fā)卡地區(qū)行政區(qū)劃代碼（卡識(shí)別碼前6位）|社會(huì)保障號(hào)碼|卡號(hào)|卡識(shí)別碼|姓名|卡復(fù)位信息（僅取歷史字節(jié)）|規(guī)范版本|發(fā)卡日期|卡有效期|終端機(jī)編號(hào)|終端設(shè)備號(hào)|

//返回舉例：

360700|360700199907151372|890642628|360700D156003335690999604657ED2D|張無(wú)忌|0081544B44869B160818107861|2.00|20180701|20280701|310000309109|65884835323437175132|

說(shuō)明：此函數(shù)讀三代社保卡需要psam卡，否則返回-2201，二代社保卡可以直接讀取

2.12.2 Donsee_iReadCardBas_HSM_Step1加密機(jī)步驟1

定義：加密機(jī)步驟1

原型:

long Donsee_iReadCardBas_HSM_Step1(int nType, byte[] info)

參數(shù)：

nType [in]卡片類型 1接觸、2非接、3接觸+非接，非接優(yōu)先

info [out]返回的數(shù)據(jù)

返回值：

0：讀卡成功；

非0：讀卡失敗，參考狀態(tài)碼

//返回格式：發(fā)卡地行政區(qū)劃代碼|卡復(fù)位信息|算法標(biāo)識(shí)|卡識(shí)別碼|內(nèi)部認(rèn)證過(guò)程因子|內(nèi)部認(rèn)證鑒別所需的原始信息|外部認(rèn)證過(guò)程因子|外部認(rèn)證鑒別所需的原始信息|

//返回舉例：

440100|00814A66678660440100AC8FE3|03|440100D15600880600AC8FE3257118AC|7EFCD0C331DA50AC|0102030405060708|DB25A7E8ABD59B1B|0102030405060708|

2.12.3 Donsee_iReadCardBas_HSM_Step2加密機(jī)步驟2

定義：加密機(jī)步驟2

原型:

long Donsee_iReadCardBas_HSM_Step2 (String key, byte[] info)

參數(shù)：

key [in]    密鑰，即加密機(jī)返回的信息

info [out]返回的數(shù)據(jù)

返回值：

0：讀卡成功；

非0：讀卡失敗，參考狀態(tài)碼

key為加密機(jī)返回的內(nèi)部認(rèn)證和外部認(rèn)證結(jié)果數(shù)據(jù)，依次為：內(nèi)部認(rèn)證結(jié)果數(shù)據(jù)（即內(nèi)部認(rèn)證鑒別數(shù)據(jù)（16 位）和內(nèi)部認(rèn)證鑒別所需的原始信息（16 位）拼接組成）、外部認(rèn)證結(jié)果數(shù)據(jù)（即外部認(rèn)證鑒別數(shù)據(jù)（16 位）和外部認(rèn)證鑒別所需的原始信息（16 位）拼接組成）。各數(shù)據(jù)項(xiàng)之間以“|”分割，且最后一個(gè)數(shù)據(jù)項(xiàng)以“|”結(jié)尾。

例如：96BBD0687A1667AD0102030405060708|A52BFF7396EEE45F0102030405060708|

//返回格式（和Donsee_iReadCardBas一樣）：發(fā)卡地區(qū)行政區(qū)劃代碼（卡識(shí)別碼前6位）|社會(huì)保障號(hào)碼|卡號(hào)|卡識(shí)別碼|姓名|卡復(fù)位信息（僅取歷史字節(jié)）|規(guī)范版本|發(fā)卡日期|卡有效期|終端機(jī)編號(hào)|終端設(shè)備號(hào)|

//返回舉例：

360700|360700199907151372|890642628|360700D156003335690999604657ED2D|張無(wú)忌|0081544B44869B160818107861|2.00|20180701|20280701|310000309109|65884835323437175132|

2.13 4428卡

2.13.1 Donsee_4428_PowerOn 4428卡上電

定義：4428卡上電

原型:

long Donsee_4428_PowerOn (byte[] chUID)

參數(shù)：

chUID [out]上電返回?cái)?shù)據(jù)，4字節(jié)廠商代碼

返回值：

>0：4428卡上電成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：4428卡上電失敗，參考狀態(tài)碼

2.13.2 Donsee_4428_PowerOff 4428卡下電

定義：4428卡下電

原型:

long Donsee_4428_PowerOff ()

參數(shù)：

返回值：

0：4428卡下電成功；

非0：4428卡下電失敗，參考狀態(tài)碼

2.13.3 Donsee_4428_Read 4428卡讀數(shù)據(jù)

定義：4428卡讀取數(shù)據(jù)

原型:

long Donsee_4428_Read (int nOffset, int nLen, byte[]chData)

參數(shù)：

nOffset[in]起始地址

nLen[in]讀取數(shù)據(jù)長(zhǎng)度

chData [iout]讀取的數(shù)據(jù)內(nèi)容

返回值：

>0：4428卡讀取數(shù)據(jù)成功并作為有效數(shù)據(jù)長(zhǎng)度；

<=0：4428卡讀取數(shù)據(jù)失敗，參考狀態(tài)碼

2.13.4 Donsee_4428_Write 4428卡寫(xiě)數(shù)據(jù)

定義：4428卡寫(xiě)入數(shù)據(jù)

原型:

long Donsee_4428_Read (int nOffset, int nLen, byte[]chData)

參數(shù)：

nOffset[in]起始地址

nLen[in]寫(xiě)入數(shù)據(jù)長(zhǎng)度

chData [in]寫(xiě)入的數(shù)據(jù)內(nèi)容

返回值：

0：4428卡寫(xiě)入數(shù)據(jù)成功；

非0：4428卡寫(xiě)入數(shù)據(jù)失敗，參考狀態(tài)碼

2.13.5 Donsee_4428_Verify 4428卡認(rèn)證密鑰

定義：4428卡認(rèn)證秘鑰

原型:

long Donsee_4428_Verify(byte[]chKey)

參數(shù)：

chKey [in]秘鑰數(shù)據(jù)，如unsigned  byte[] chKey={0xff,0xff,0xff};

返回值：

0：4428卡認(rèn)證秘鑰成功；

非0：4428卡認(rèn)證秘鑰失敗，參考狀態(tài)碼

2.13.6 Donsee_4428_Change 4428卡修改密鑰

定義：4428卡修改秘鑰

原型:

long Donsee_4428_Change (byte[]chNewKey)

參數(shù)：

chNewKey [in]秘鑰數(shù)據(jù)，如unsigned  byte[] chNewKey ={0xff,0xff,0xff};

返回值：

0：4428卡修改密鑰成功；

非0：4428卡修改密鑰失敗，參考狀態(tài)碼

2.13.7 Donsee_4428_ReadCount 4428卡密鑰剩余認(rèn)證次數(shù)

定義：4428卡密鑰剩余認(rèn)證次數(shù)

原型:

long Donsee_4428_ReadCount (int[] nCount)

參數(shù)：

nCount [0]4428卡密鑰剩余認(rèn)次數(shù)

返回值：

0：獲取4428卡密鑰剩余認(rèn)證次數(shù)成功；

非0：獲取4428卡密鑰剩余認(rèn)證次數(shù)失敗，參考狀態(tài)碼

2.14輔助類函數(shù)

2.14.1 Donsee_HexToStr 16進(jìn)制數(shù)組轉(zhuǎn)字符串

定義：16進(jìn)制數(shù)組轉(zhuǎn)字符串

原型：

StringbytesToHex (byte[]Src,int len);

參數(shù)：

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

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

返回值：

null：16進(jìn)制數(shù)組轉(zhuǎn)字符串成功；

null：16進(jìn)制數(shù)組轉(zhuǎn)字符串失敗，參考狀態(tài)碼

2.14.2 Donsee_StrToHex 字符串轉(zhuǎn)16進(jìn)制數(shù)組

定義：字符串轉(zhuǎn)16進(jìn)制數(shù)組

原型：byte[] hexToBytes (String Src);

參數(shù)：

Src[in]:hexstr格式字符串

返回值：

!null：字符串轉(zhuǎn)16進(jìn)制數(shù)組成功；

null：字符串轉(zhuǎn)16進(jìn)制數(shù)組失敗，參考狀態(tài)碼

3、狀態(tài)碼

IFD_OK0執(zhí)行成功

IFD_ICC_TypeError-1卡片類型不對(duì)

IFD_ICC_NoExist-2無(wú)卡

IFD_ICC_NoPower-3有卡未上電

IFD_ICC_NoResponse-4卡片無(wú)應(yīng)答

IFD_ConnectError-11讀卡器連接錯(cuò)

IFD_UnConnected-12未建立連接(沒(méi)有執(zhí)行打開(kāi)設(shè)備函數(shù))

IFD_BadCommand-13(動(dòng)態(tài)庫(kù))不支持該命令

IFD_ParameterError-14(發(fā)給動(dòng)態(tài)庫(kù)的)命令參數(shù)錯(cuò)

IFD_CheckSumError-15信息校驗(yàn)和出錯(cuò)

社保卡狀態(tài)碼

返回值錯(cuò)誤信息描述

-1卡類型不對(duì)

-2無(wú)卡

-3有卡未上電

-4卡無(wú)應(yīng)答

-5加載動(dòng)態(tài)庫(kù)錯(cuò)

-11讀卡器連接錯(cuò)

-12未建立連接

-13（動(dòng)態(tài)庫(kù)）不支持該命令

-14（發(fā)給動(dòng)態(tài)庫(kù)的）命令參數(shù)錯(cuò)

-15信息校驗(yàn)和出錯(cuò)

-18操作超時(shí)

-19發(fā)送數(shù)據(jù)失敗

-20卡識(shí)別碼格式錯(cuò)

-21內(nèi)部認(rèn)證失敗（用戶卡不合法）

-22傳入數(shù)據(jù)與卡內(nèi)不符

-23傳入數(shù)據(jù)不合法

-24PSAM卡密鑰級(jí)別不夠

-25接收數(shù)據(jù)失敗

-31用戶取消密碼輸入

-32密碼輸入操作超時(shí)

-33輸入密碼長(zhǎng)度錯(cuò)

-34兩次輸入密碼不一致

-35（預(yù)留）初始密碼不能交易

-36（預(yù)留）不能改為初始密碼

-41運(yùn)算數(shù)據(jù)含非法字符

-42運(yùn)算數(shù)據(jù)長(zhǎng)度錯(cuò)

-51PIN校驗(yàn)失敗，剩余次數(shù)N次（根據(jù)卡返回信息）

-52PIN鎖定

-2201無(wú)PSAM卡

-2202PSAM卡算法不支持（即PSAM卡內(nèi)沒(méi)有SSF33算法或SM4算法）

-2203PSAM卡內(nèi)沒(méi)有RKSSSE密鑰（3.0卡讀個(gè)人基本信息需要RKSSSE密鑰外部認(rèn)證）

-2204不需要加密機(jī)認(rèn)證

-25536、-25537、-25538、-25539、-25540、-25541外部認(rèn)證失敗，剩余可嘗試次數(shù)0~5次

（注意：這個(gè)返回值表示馬上要鎖卡了，請(qǐng)不要再嘗試）

-26368Lc/Le不正確

-26881命令不接受（無(wú)效狀態(tài)）

-27009命令與文件結(jié)構(gòu)不相符、當(dāng)前文件非所需文件

-27010不滿足安全條件

-27011密鑰鎖定（算法鎖定）鑒別方法鎖定

-27012引用數(shù)據(jù)無(wú)效、隨機(jī)數(shù)無(wú)效

-27013不滿足使用條件、應(yīng)用被鎖定、應(yīng)用未選擇、余額上溢

-27016安全報(bào)文數(shù)據(jù)項(xiàng)不正確、MAC不正確

-27264數(shù)據(jù)域參數(shù)不正確

-27265不支持該功能、卡中無(wú)MF、卡被鎖定、應(yīng)用鎖定

-27266未找到文件、文件標(biāo)識(shí)相重、SFI不正確

-27267未找到記錄

-27272未找到引用數(shù)據(jù)、未找到密鑰

-37634MAC無(wú)效

-37635應(yīng)用已被永久鎖定、卡片鎖定

-37891PSAM卡不支持消費(fèi)交易

-37894所需MAC（或/和TAC）不可用

其他未知錯(cuò)誤

4、卡片調(diào)用順序

4.1 TypeA卡

1、尋卡：Donsee_ICRequest

2、防碰撞：Donsee_ICAnticoll

3、選卡：Donsee_ICSelect

4、TypeA上電：Donsee_PowerOnTypeA

5、APDU命令：Donsee_APDU

4.2 TypeB卡

1、設(shè)置為T(mén)ypeB卡片：Donsee_SetTypeB

2、TypeB上電：Donsee_PowerOnTypeB

3、選卡：Donsee_ICSelect

4、APDU命令：Donsee_APDU

4.3 M1卡

USB接口方式：

1、尋卡：Donsee_ICRequest

2、防碰撞：Donsee_ICAnticoll

3、選卡：Donsee_ICSelect

4、認(rèn)證秘鑰：Donsee_M1VerifyPass //KeyA 0x60，KeyB 0x61

5、讀/寫(xiě)：Donsee_M1Read/Donsee_M1Write

串口方式：

1、尋卡：Donsee_ReadICUid

2、認(rèn)證秘鑰：Donsee_M1VerifyPass ////KeyA 0x60，KeyB 0x61

3、讀/寫(xiě)：Donsee_M1Read/Donsee_M1Write

4.4 4442卡

1 上電復(fù)位

2 認(rèn)證

3 讀或?qū)?/p>

4.5 接觸CPU卡

1、接觸冷復(fù)位：Donsee_ColdPowerOn

2、接觸APDU命令：Donsee_PowerOn_APDU