EST-100/EST-100GS/EST-J13X系列Android開發包（含身份證、社?？?、CPU、M1、磁條卡、銀行卡等卡）
廣東東信智能科技有限公司DONSEE EST-100系列Android開發包（含身份證、社?？?、CPU、M1、磁條卡、銀行卡等卡），支持EST-100、EST-100G、EST-J13X、EST-100GS等機型，僅供開發人員和測試人員使用，包括armeabi/armeabi-v7a/armeabi-v8a/x86/x64等安卓處理器使用。
開發包分為Android Studio編譯和Eclipse兩種編譯環境，請根據實際需要選擇對應的版本下載。
Android平臺開發包下載地址：
DONSEE系列多功能讀寫器
API接口規范V1.5
廣東東信智能科技有限公司
www.eastcoms.com
2022.07.18
1、東信智能讀寫器(SDK)簡介5
2、函數說明5
2.1通用函數5
2.1.1 Donsee_Open打開設備5
2.1.2 Donsee_Close關閉設備5
2.1.3 Donsee_Beep蜂鳴器函數5
2.1.4 Donsee_Version讀取設備版本6
2.1.5 Donsee_WRSN 讀寫序列號(SN)6
2.1.6 Donsee_SwitchRF設備天線開關6
2.2身份證7
2.2.1 Donsee_ReadIDCard讀取身份證信息7
2.2.2 Donsee_ReadSAMID 讀取模塊SAM碼7
2.2.3 Donsee_ReadIDCardUid 讀取身份證UID8
2.3社?？?span style="white-space:pre">8
2.3.1 Donsee_ReadSSCard讀取社?？ㄐ畔?span style="white-space:pre">8
2.3.2 Donsee_ReadSSCard_NoPsam 無PSAM卡讀取社?？ㄐ畔?span style="white-space:pre">9
2.4非接觸類卡片前置函數9
2.4.1 Donsee_ICRequest請求卡片9
2.4.2 Donsee_ICAnticoll防碰撞10
2.4.3 Donsee_ICSelect選擇卡片10
2.5 TypeA、TypeB卡10
2.5.1 Donsee_SetTypeA設置為TypeA10
2.5.2 Donsee_SetTypeB設置為TypeB10
2.5.3 Donsee_PowerOnTypeA TypeA卡上電復位11
2.5.4 Donsee_PowerOnTypeB TypeB卡上電復位11
2.5.5 Donsee_APDU執行APDU命令11
2.6 M1卡12
2.6.1 Donsee_M1VerifyPass M1卡認證秘鑰12
2.6.2 Donsee_M1VerifyPassHEX M1卡認證秘鑰12
2.6.3 Donsee_M1Read M1卡讀卡12
2.6.4 Donsee_M1Write M1卡寫卡13
2.6.5 Donsee_M1Initval M1卡初始化13
2.6.6 Donsee_M1Increment M1卡增值13
2.6.7 Donsee_M1Decrement M1卡減值14
2.6.8 Donsee_M1Readval M1卡讀值14
2.6.9 Donsee_M1LoadKey M1卡裝載密鑰14
2.6.10 Donsee_ReadICUid讀取M1和CPU卡的Uid卡號15
2.7接觸CPU卡15
2.7.1 Donsee_PowerOn CPU卡上電復位15
2.7.2 Donsee_ColdPowerOn 冷復位15
2.7.3 Donsee_HotPowerOn 熱復位16
2.7.4 Donsee_PowerOn_APDU CPU卡執行APDU命令16
2.7.5 Donsee_PowerOn_LongAPDU CPU卡執行APDU命令17
2.7.6 Donsee_PowerOff下電17
2.7.7 Donsee_GetStatus獲取卡座狀態17
2.8 15693卡18
2.8.1 Donsee_15693_Find 15693尋卡18
2.8.2 Donsee_15693_Info 15693獲取卡片詳細信息18
2.8.3 Donsee_15693_Read 15693讀卡18
2.8.4 Donsee_15693_Write 15693寫卡19
2.8.5 Donsee_15693_WriteAFI 15693寫AFI19
2.8.6 Donsee_15693_LockAFI 15693鎖AFI19
2.8.7 Donsee_15693_WriteDSFID 15693寫DSFID19
2.8.8 Donsee_15693_LockDSFID 15693鎖DSFID20
2.8.9 Donsee_15693_LockDataBlock用于鎖定塊內容20
2.9 SLE4442卡20
2.9.1 Donsee_4442_PowerOn 4442卡上電20
2.9.2 Donsee_4442_PowerOff 4442卡下電21
2.9.3 Donsee_4442_Read 4442卡讀數據21
2.9.4 Donsee_4442_Write 4442卡寫數據21
2.9.5 Donsee_4442_Verify 4442卡認證密鑰22
2.9.6 Donsee_4442_Change 4442卡修改密鑰22
2.9.7 Donsee_4442_ReadProtect 4442卡讀保護數據22
2.9.8 Donsee_4442_WriteProtect 4442卡寫保護數據22
2.9.9 Donsee_4442_ReadCount 4442卡密鑰剩余認證次數23
2.10磁條卡23
2.10.1 Donsee_ReadMagCard磁條卡讀卡23
2.10.2 Donsee_ReadMagType設置輸出模式24
2.11北京通24
2.11.1 Donsee_ReadBJTIDCard讀取北京通信息24
2.11.2 Donsee_ReadBJTIDCard_Photo讀取北京通照片25
2.12輔助類函數25
2.12.1 Donsee_HexToStr 16進制數組轉字符串25
2.12.2 Donsee_StrToHex 字符串轉16進制數組25
3、狀態碼26
4、卡片調用順序27
4.1 TypeA卡27
4.2 TypeB卡27
4.3 M1卡28
4.4 4442卡28
4.5 接觸CPU卡28
1、智能讀寫器(SDK)簡介
本文檔描述了廣東東信智能科技有限公司DONSEE系列讀寫器SDK的函數定義、調用方法、參數以及返回值說明，供開發人員進行二次開發時使用。
2、函數說明
2.1通用函數
2.1.1 Donsee_Open打開設備
定義：打開設備端口
原型:
int Donsee_Open(String dev_Name)
參數：
dev_Name[in]windows：USB設備傳入”USB”；串口設備傳入”COM1” “COM2”等
返回值：
0：打開設備成功；
非0：打開設備失敗，參考狀態碼
2.1.2 Donsee_Close關閉設備
定義：關閉設備端口
原型:
int Donsee_Close()
參數：無
返回值：
0：關閉設備成功；
非0：關閉設備失敗，參考狀態碼
2.1.3 Donsee_Beep蜂鳴器函數
定義：調用設備蜂鳴器
原型:
int Donsee_Beep()
參數：無
返回值：
0：調用蜂鳴器成功；
非0：調用蜂鳴器失敗，參考狀態碼
2.1.4 Donsee_Version讀取設備版本
定義：讀取設備版本號
原型:
int Donsee_Version (byte[] chVersion)
參數：
chVersion[out]設備版本號
返回值：
>0：獲取設備版本成功并作為有效數據長度；
<=0：獲取設備版本失敗，參考狀態碼
2.1.5 Donsee_SwitchRF設備天線開關
定義：設備天線開關
原型:
int Donsee_SwitchRF (int nType)
參數：
nType0，打開設備天線；1，關閉設備天線
返回值：
0：天線開關操作成功；
非0：天線開關操作失敗，參考狀態碼
2.2身份證
public class IDINFO extends Structure{
public byte[] name = new byte[40]; /*中文姓名*/
public byte[] ENfullname = new byte[40]; /*英文姓名*/
public byte[] sex = new byte[10]; /*性別*/
public byte[] people = new byte[20]; /*民族*/
public byte[] address = new byte[200]; /*地址*/
public byte[] birthday = new byte[50]; /*出生日期（YYYYMMDD）*/
public byte[] signdate = new byte[50]; /*發證日期（YYYYMMDD）*/
public byte[] validterm = new byte[50]; /*有效日期（YYYYMMDD）*/
public byte[] number = new byte[40]; /*證件號碼*/
public byte[] organs = new byte[50];/*發證機關(或外國人永久居住正-當次申請受理機關)*/
public byte[] Nationality = new byte[200]; /*國籍*/
public byte[] Photo = new byte[1024]; /*讀取二代證電子信息時保存照片數據信息*/
public byte[] Other = new byte[200]; /*其他*/
public byte[] passNu = new byte[24]; /*通行證號*/
public byte[] signCount = new byte[8]; /*簽發數次*/
public byte[] certVersion = new byte[8]; /*證件版本*/
public byte certType;/*卡片類型,”0”大陸身份證” ”,I”外國人，”J”港澳臺*/
public byte[] figData = new byte[1024];/*指紋信息*/
}
2.2.1 Donsee_ReadIDCard讀取身份證信息
定義：讀取身份證信息
原型： int Donsee_ReadIDCard (int nType, String szPath,IDINFO idInfo,byte[] pszMsg);
參數：
nType [in]:設置身份證讀卡類型：0，文本信息；1，文本+照片；2，文本+照片+指紋
szPath[in]:獲取二代證頭像路徑
idinfo [out];獲取的身份證信息
pszMsg [out];錯誤信息
返回值：
0：讀取身份證信息成功；
非0：讀取身份證信息失敗，參考狀態碼
2.2.2 Donsee_ReadSAMID 讀取模塊SAM碼
定義：讀取身份證模塊SAM碼
原型：int Donsee_ReadSAMID (byte[] chSAM);
參數：
chSAM [out] 身份證模塊SAM碼
返回值：
0：讀取身份證模塊SAM碼成功；
非0：讀取身份證模塊SAM碼失敗，參考狀態碼
2.2.3 Donsee_ReadIDCardUid 讀取身份證UID
定義：讀取身份證UID
原型：int Donsee_ReadIDCardUid(byte[] chUID);
參數：
chUID [out] 身份證UID碼
返回值：
0：讀取身份證UID成功；
非0：讀取身份證UID失敗，參考狀態碼
2.3社?？?/p>
class SSCardIDINFO extends Structure {
public byte[] name = new byte[40]; /*姓名*/
public byte[] sex = new byte[10];/*性別*/
public byte[] nation = new byte[20];/*民族*/
public byte[] birthday = new byte[50];/*出生日期（YYYYMMDD）*/
public byte[] signdate = new byte[50];/*發證日期（YYYYMMDD）*/
public byte[] validterm = new byte[50];/*有效日期（YYYYMMDD）*/
public byte[] cardnumber = new byte[40];/*卡號*/
public byte[] idnumber = new byte[40];/*社會保障號碼(身份證號)*/
public byte[] city = new byte[64] ;/*城市代碼*/
public byte[] cardveVrsion = new byte[8] ;/*社?？ò姹?/
public byte[] Other = new byte[200];/*其他*/
}
2.3.1 Donsee_ReadSSCard讀取社?？ㄐ畔?/p>
定義：讀取二代、三代社?？?/p>
原型：int Donsee_ReadSSCard (int nSlotPsam,SSCardIDINFO sciCardInfo,byte[] errInfor);
參數：
nSlotPsam [int] PSAM存放卡座，0x11 SAM1, 0x12 SAM2, 0x13 SAM3, 0x14 SAM4
cardInfo [out] 社?？ㄐ畔?/p>
arrChMsg [out] 錯誤信息
返回值：
0：讀取社?？ǔ晒?；
非0：讀取社?？ㄊ?，參考狀態碼
備注：二代社?？o需PSAM卡，只支持接觸式讀取。三代社?？ū仨毰鋫銹SAM卡，支持接觸、非接兩種方式讀取。
2.4非接觸類卡片前置函數
2.4.1 Donsee_ICRequest請求卡片
定義：請求卡片
原型:
int Donsee_ICRequest ()
參數：
返回值：
0：請求卡片成功；
非0：請求卡片失敗，參考狀態碼
2.4.2 Donsee_ICAnticoll防碰撞
定義：卡片防碰撞
原型:
int Donsee_ICAnticoll (byte[] chUID)
參數：
chUID[out]卡片序列號Uid
返回值：
>0：卡片防碰撞成功；
<=0：卡片防碰撞失敗，參考狀態碼
2.4.3 Donsee_ICSelect選擇卡片
定義：選擇卡片
原型:
int Donsee_ICSelect (byte nCardType)
參數：
nCardType [in]0x41 表示 typeA 及M1 卡，0x42 表示 typeB卡
返回值：
0：選擇卡片成功；
非0：選擇卡片失敗，參考狀態碼
2.5 TypeA、TypeB卡
2.5.1 Donsee_SetTypeA設置為TypeA
定義：設置為TypeA卡
原型:
int Donsee_SetTypeA ()
參數：
返回值：
0：設置為TypeA卡成功；
非0：設置為TypeA卡失敗，參考狀態碼
2.5.2 Donsee_SetTypeB設置為TypeB
定義：設置為TypeB卡
原型:
int Donsee_SetTypeB ()
參數：
返回值：
0：設置為TypeB卡成功；
非0：設置為TypeB卡失敗，參考狀態碼
2.5.3 Donsee_PowerOnTypeA TypeA卡上電復位
定義：TypeA上電
原型:
int Donsee_ PowerOnTypeA (byte[] Response)
參數：
Response [out]卡片復位信息(ATR)
返回值：
>0：TypeA上電成功并作為有效數據長度；
<=0：TypeA上電失敗，參考狀態碼
2.5.4 Donsee_PowerOnTypeB TypeB卡上電復位
定義：TypeB上電
原型:
int Donsee_PowerOnTypeB(byte[] Response)
參數：
Response [out]卡片復位信息(ATR)
返回值：
>0：TypeB上電成功并作為有效數據長度；
<=0：TypeB上電失敗，參考狀態碼
2.5.5 Donsee_APDU執行APDU命令
定義：TypeA|TypeB執行APDU命令
原型:
int Donsee_APDU (byte[] Command_APDU, byte[] Response_APDU);
參數：
Command_APDU [in]下發APDU命令(字符串”0084000008”)
Response_APDU[out]執行APDU相應數據(字符串如”9000”)
返回值：
>0：執行APDU命令成功并作為有效數據長度；
<=0：執行APDU命令失敗，參考狀態碼
2.6 M1卡
2.6.1 Donsee_M1VerifyPass M1卡認證秘鑰
定義：M1卡認證秘鑰
原型:
int Donsee_M1VerifyPass (byte nMode, byte nSecNr,byte[] PassWord);
參數：
nMode [in]認證模式, 0x00 認證KeyA|0x04 認證KeyB
nSecNr [in]扇區號 (0~15)
PassWord [in]密鑰(如:”FFFFFFFFFFFF”)
返回值：
0：M1卡認證秘鑰成功；
非0：M1卡認證秘鑰失敗，參考狀態碼
2.6.2 Donsee_M1VerifyPassHEX M1卡認證秘鑰
定義：M1卡認證秘鑰
原型:
int Donsee_M1VerifyPassHex (byte nMode, byte nSecNr,byte[] PassWord);
參數：
nMode [in]認證模式, 0x00 認證KeyA|0x04 認證KeyB
nSecNr [in]扇區號 (0~15)
PassWord [in]密鑰(如:{0xff,0xff,0xff ,0xff ,0xff ,0xff })
返回值：
0：M1卡認證秘鑰成功；
非0：M1卡認證秘鑰失敗，參考狀態碼
2.6.3 Donsee_M1Read M1卡讀卡
定義：M1卡讀卡
原型:
int Donsee_M1Read(byte Addr, byte[]chData)
參數：
Addr [in]塊號(S50該值范圍0~63| S70該值范圍0~255)
chData [out]讀取數據
返回值：
>0：M1卡讀卡成功并作為有效數據長度；
<=0：M1卡讀卡失敗，參考狀態碼
2.6.4 Donsee_M1Write M1卡寫卡
定義：M1卡寫卡
原型:
int Donsee_M1Write(byte Addr,byte[]chData)
參數：
Addr [in]塊號(S50該值范圍0~63| S70該值范圍0~255)
chData [in]讀取數據
塊地址計算公式：塊地址=扇區號*4+當前塊號
返回值：
0：M1卡寫卡成功；
非0：M1卡寫卡失敗，參考狀態碼
2.6.5 Donsee_M1Initval M1卡初始化
定義：M1卡初始化
原型:
int Donsee_M1Initval (byte nAddr, long nValue)
參數：
nAddr[in]塊號(S50該值范圍0~63| S70該值范圍0~255)
nValue [int]數值
返回值：
0：M1卡初始化成功；
非0：M1卡初始化失敗，參考狀態碼
2.6.6 Donsee_M1Increment M1卡增值
定義：M1卡增值
原型:
int Donsee_M1Increment (byte nAddr, long nValue)
參數：
nAddr[in]塊號(S50該值范圍0~63| S70該值范圍0~255)
nValue [int]數值
返回值：
0：M1卡增值成功；
非0：M1卡增值失敗，參考狀態碼
2.6.7 Donsee_M1Decrement M1卡減值
定義：M1卡減值
原型:
int Donsee_M1Decrement (byte nAddr, long nValue)
參數：
nAddr[in]塊號(S50該值范圍0~63| S70該值范圍0~255)
nValue [int]數值
返回值：
0：M1卡減值成功；
非0：M1卡減值失敗，參考狀態碼
2.6.8 Donsee_M1Readval M1卡讀值
定義：M1卡讀值
原型:
int Donsee_M1Readval (byte nAddr, long[] nValue)
參數：
nAddr[in]塊號(S50該值范圍0~63| S70該值范圍0~255)
nValue [out]數值
返回值：
0：M1卡讀值成功；
非0：M1卡讀值失敗，參考狀態碼
2.6.9 Donsee_M1LoadKey M1卡裝載密鑰
定義：裝載M1卡密鑰到設備
原型:
int Donsee_M1LoadKey (byte nMode, byte nSecNr, byte[]PassWord);
參數：
nMode [in]認證模式, 0x00 認證KeyA|0x04 認證KeyB
nSecNr [in]扇區號 (0~15)
PassWord [int]待下載到設備的密鑰
例子：
byte key[10]={0xff,0xff,0xff,0xff,0xff,0xff};
int nRe = Donsee_M1LoadKey (0,0,key);//下載扇區0的KeyA密鑰至設備里
返回值：
0：M1卡裝載密鑰成功；
非0：M1卡裝載密鑰失敗，參考狀態碼
2.6.10 Donsee_ReadICUid讀取M1和CPU卡的Uid卡號
定義：讀取M1和CPU卡UID
原型:
int Donsee_ReadICUid (byte[] chUID)
參數：
chUID[out]卡片序列號
返回值：
0：讀取M1和CPU卡的Uid卡號成功；
非0：讀取M1和CPU卡的Uid卡號失敗，參考狀態碼
2.7接觸CPU卡
2.7.1 Donsee_PowerOn CPU卡上電復位
定義：CPU卡上電復位
原型:
int Donsee_PowerOn (byte nSlotNo, byte[] chResponse)
參數：
nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；
0x11：SAM1卡座；0x12：SAM2卡座；
0x13：SAM3卡座；0x14：SAM4卡座
chResponse [out]卡片返回復位信息數據
返回值：
>0：卡片復位成功并作為有效數據長度；
<=0：卡片復位失敗，參考狀態碼
2.7.2 Donsee_ColdPowerOn 冷復位
定義：接觸CPU卡冷復位
原型:
int Donsee_ColdPowerOn (byte nSlotNo, byte[] chResponse)
參數：
nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；
0x11：SAM1卡座；0x12：SAM2卡座；
0x13：SAM3卡座；0x14：SAM4卡座
chResponse [out]卡片返回復位信息數據
返回值：
>0：卡片復位成功并作為有效數據長度；
<=0：卡片復位失敗，參考狀態碼
2.7.3 Donsee_HotPowerOn 熱復位
定義：接觸CPU卡熱復位
原型:
int Donsee_HotPowerOn (byte nSlotNo, byte[] chResponse)
參數：
nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；
0x11：SAM1卡座；0x12：SAM2卡座；
0x13：SAM3卡座；0x14：SAM4卡座
chResponse [out]卡片返回復位信息數據
返回值：
>0：卡片復位成功并作為有效數據長度；
<=0：卡片復位失敗，參考狀態碼
2.7.4 Donsee_PowerOn_APDU CPU卡執行APDU命令
定義：執行APDU命令
原型:
int Donsee_PowerOn_APDU(byte nSlotNo,
byte[] Command_APDU,
byte[] Response_APDU);
)
參數：
nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；
0x11：SAM1卡座；0x12：SAM2卡座；
0x13：SAM3卡座；0x14：SAM4卡座
Command_APDU [in]下發APDU命令(字符串”0084000008”)
Response_APDU[out]執行APDU相應數據(字符串如”9000”)
返回值：
>0：執行APDU命令成功并作為有效數據長度；
<=0：執行APDU命令失敗，參考狀態碼
2.7.5 Donsee_PowerOn_LongAPDU CPU卡執行APDU命令
定義：執行APDU命令
原型:
int Donsee_PowerOn_LongAPDU (byte nSlotNo,
byte[] Command_APDU,
byte[] Response_APDU);
)
參數：
nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；
0x11：SAM1卡座；0x12：SAM2卡座；
0x13：SAM3卡座；0x14：SAM4卡座
Command_APDU [in]下發APDU命令(字符串”0084000008”)
Response_APDU[out]執行APDU相應數據(字符串如”9000”)
返回值：
>0：執行APDU命令成功并作為有效數據長度；
<=0：執行APDU命令失敗，參考狀態碼
2.7.6 Donsee_PowerOff下電
定義：CPU卡下電
原型:
int Donsee_PowerOff (byte nSlotNo)
參數：
nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；
0x11：SAM1卡座；0x12：SAM2卡座；
0x13：SAM3卡座；0x14：SAM4卡座
返回值：
0：CPU卡下電成功；
非0：CPU卡下電失敗，參考狀態碼
2.7.7 Donsee_GetStatus獲取卡座狀態
定義：獲取卡座狀態
原型:
int Donsee_GetStatus(byte nSlotNo,int* nStatus)
參數：
nSlotNo[in]卡座選擇：0x01 大卡座, 0x02：副卡座 ；
0x11：SAM1卡座；0x12：SAM2卡座；
0x13：SAM3卡座；0x14：SAM4卡座
nStatus[out]卡座狀態：為 0 表示有卡上電，1表示有卡未上，2表示無卡
返回值：
0：獲取卡座狀態成功；
非0：獲取卡座狀態失敗，參考狀態碼
2.8 15693卡
2.8.1 Donsee_15693_Find 15693尋卡
定義：15693尋卡
原型:
int Donsee_15693_Find (byte[] chUID)
參數：
chUID [out]尋卡得到8字節卡片數據；
返回值：
0：15693尋卡成功；
非0：15693尋卡失敗，參考狀態碼
2.8.2 Donsee_15693_Info 15693獲取卡片詳細信息
定義：獲取15693卡詳細信息
原型:
int Donsee_15693_Info (byte[] chCardInfo)
參數：
chCardInfo [out]14字節卡片數據；
返回值：
0：獲取15693卡詳細信息成功；
非0：獲取15693卡詳細信息失敗，參考狀態碼
2.8.3 Donsee_15693_Read 15693讀卡
定義：15693讀卡
原型:
int Donsee_15693_Read (byte nBlkAdd, byte[] chResult)
參數：
nBlkAdd[in]塊地址
chResult [out]14字節卡片數據；
返回值：
>0：15693讀卡成功并作為有效數據長度；
<=0：15693讀卡失敗，參考狀態碼
2.8.4 Donsee_15693_Write 15693寫卡
定義：15693寫卡
原型:
int Donsee_15693_Write (byte nBlkAdd, byte[] chData)
參數：
nBlkAdd[in]塊地址
chData [in]要寫入的4字節卡片數據；
返回值：
0：15693寫卡成功；
非0：15693寫卡失敗，參考狀態碼
2.8.5 Donsee_15693_WriteAFI 15693寫AFI
定義：15693寫AFI
原型:
int Donsee_15693_WriteAFI (byte[] data, byte[] Response)
參數：
data [in]data[0] 為0表示寫AFI,為1則表示鎖AFI
Response [in]null
返回值：
0：15693寫AFI成功；
非0：15693寫AFI失敗，參考狀態碼
2.8.6 Donsee_15693_LockAFI 15693鎖AFI
定義：15693寫AFI
原型:
int Donsee_15693_LookAFI (byte[] data, byte[] Response)
參數：
data [in]data[0] 為0表示寫AFI,為1則表示鎖AFI
Response [in]null
返回值：
0：15693鎖AFI成功；
非0：15693鎖AFI失敗，參考狀態碼
2.8.7 Donsee_15693_WriteDSFID 15693寫DSFID
定義：15693寫DSFID
原型:
int Donsee_15693_WriteDSFID (byte[] data, byte[] Response)
參數：
data [in]data[0] 為0表示寫DSFID,為1則表示鎖DSFID
Response [in]null
返回值：
0：15693寫DSFID成功；
非0：15693寫DSFID 失敗，參考狀態碼
2.8.8 Donsee_15693_LockDSFID 15693鎖DSFID
定義：15693鎖DSFID
原型:
int Donsee_15693_LockDSFID (byte[] data, byte[] Response a)
參數：
data [in]data[0] 為0表示寫AFI,為1則表示鎖AFI
Response [out]null；
返回值：
0：15693鎖DSFID成功；
非0：15693鎖DSFID失敗，參考狀態碼
2.8.9 Donsee_15693_LockDataBlock用于鎖定塊內容
定義：用于鎖定塊內容。注意：此過程不可逆（不能解鎖）塊鎖定后內容不能在修改。
原型:
int Donsee_15693_LockDataBlock(byte blk_add, byte[] chResult)
參數：
blk_add [in]塊地址
chResult [out]返回數據
返回值：
0：15693鎖塊內容成功；
非0：15693鎖塊內容失敗，參考狀態碼
2.9 SLE4442卡
2.9.1 Donsee_4442_PowerOn 4442卡上電
定義：4442卡上電
原型:
int Donsee_4442_PowerOn (byte[] chUID)
參數：
chUID [out]上電返回數據，4字節廠商代碼
返回值：
>0：4442卡上電成功并作為有效數據長度；
<=0：4442卡上電失敗，參考狀態碼
2.9.2 Donsee_4442_PowerOff 4442卡下電
定義：4442卡下電
原型:
int Donsee_4442_PowerOff ()
參數：
返回值：
0：4442卡下電成功；
非0：4442卡下電失敗，參考狀態碼
2.9.3 Donsee_4442_Read 4442卡讀數據
定義：4442卡讀取數據
原型:
int Donsee_4442_Read (int nOffset, int nLen, byte[]chData)
參數：
nOffset[in]起始地址
nLen[in]讀取數據長度
chData [iout]讀取的數據內容
返回值：
>0：4442卡讀取數據成功并作為有效數據長度；
<=0：4442卡讀取數據失敗，參考狀態碼
2.9.4 Donsee_4442_Write 4442卡寫數據
定義：4442卡寫入數據
原型:
int Donsee_4442_Read (int nOffset, int nLen, byte[]chData)
參數：
nOffset[in]起始地址
nLen[in]寫入數據長度
chData [in]寫入的數據內容
返回值：
0：4442卡寫入數據成功；
非0：4442卡寫入數據失敗，參考狀態碼
2.9.5 Donsee_4442_Verify 4442卡認證密鑰
定義：4442卡認證秘鑰
原型:
int Donsee_4442_Verify(byte[]chKey)
參數：
chKey [in]秘鑰數據，如unsigned byte[] chKey={0xff,0xff,0xff};
返回值：
0：4442卡認證秘鑰成功；
非0：4442卡認證秘鑰失敗，參考狀態碼
2.9.6 Donsee_4442_Change 4442卡修改密鑰
定義：4442卡修改秘鑰
原型:
int Donsee_4442_Change (byte[]chNewKey)
參數：
chNewKey [in]秘鑰數據，如unsigned byte[] chNewKey ={0xff,0xff,0xff};
返回值：
0：4442卡修改密鑰成功；
非0：4442卡修改密鑰失敗，參考狀態碼
2.9.7 Donsee_4442_ReadProtect 4442卡讀保護數據
定義：4442卡讀取保護數據
原型:
int Donsee_4442_ReadProtect (int nOffset, int nLen, byte[]chData)
參數：
nOffset[in]起始地址，起始地址 需小于32
nLen[in]讀取數據長度，數據長度 需小于32
chData [iout]讀取的數據內容，返回值為一串00或01的數據串，如果為00代表已寫保護，如果為01代表未寫保護
返回值：
>0：4442卡讀保護數據成功并作為有效數據長度；
<=0：4442卡讀保護數據失敗，參考狀態碼
2.9.8 Donsee_4442_WriteProtect 4442卡寫保護數據
定義：4442卡寫入保護數據，即固化數據，一旦寫保護，數據將不能再修改
原型:
int Donsee_4442_WriteProtect (int nOffset, int nLen, byte[]chData)
參數：
nOffset[in]起始地址，起始地址 需小于32
nLen[in]讀取數據長度，數據長度 需小于32
chData [in]讀取的數據內容，返回值為一串00或01的數據串，如果為00代表已寫保護，如果為01代表未寫保護
返回值：
0：4442卡寫保護數據成功；
非0：4442卡寫保護數據失敗，參考狀態碼
2.9.9 Donsee_4442_ReadCount 4442卡密鑰剩余認證次數
定義：4442卡密鑰剩余認證次數
原型:
int Donsee_4442_ReadCount (int[] nCount)
參數：
nCount [0]4442卡密鑰剩余認次數
返回值：
0：獲取4442卡密鑰剩余認證次數成功；
非0：獲取4442卡密鑰剩余認證次數失敗，參考狀態碼
2.10磁條卡
2.10.1 Donsee_ReadMagCard磁條卡讀卡
定義：磁條卡讀卡
原型:
int Donsee_ReadMagCard (byte ctime,int track, byte[]rlen, byte[]getdata)
參數：
ctime[in]超時時間，單位：秒
track [in]磁道（1~3）磁道1~~磁道3，track=4時表示全軌一次性刷出
為TLV格式，例如：010101020201020303010203
rlen [in]返回數據的長度
getdata [out]返回的數據
返回值：
0：磁條卡讀卡成功；
非0：磁條卡讀卡失敗，參考狀態碼
2.11北京通
class BJTCardInfo {
public byte[] name= new byte[40]; /*姓名*/
public byte[] sex= new byte[10];/*性別*/
public byte[] cardnumber= new byte[40];/*北京通號*/
public byte[] nType= new byte[32] ;/*卡片類型*/
public byte[] cardName= new byte[40];/*證件名稱*/
public byte[] organs= new byte[50];/*發卡機構*/
}
2.11.1 Donsee_ReadBJTIDCard讀取北京通信息
定義：讀取北京通信息
原型：
int Donsee_ReadBJTIDCard(BJTCardInfo bjtCardInfo,byte[] arrChMsg);
參數：
cardInfo [out] 北京通信息
arrChMsg [out] 錯誤信息
返回值：
0：讀取北京通信息成功；
非0：讀取北京通信息失敗，參考狀態碼
2.11.2 Donsee_ReadBJTIDCard_Photo讀取北京通照片
定義：讀取北京通信息
原型：
int Donsee_ReadBJTIDCard_Photo (byte[] cardInfoPhoto);
參數：
cardInfoPhoto[out] 北京通照片信息
返回值：
>0：讀取北京通照片信息成功并作為有效數據長度；
<=0：讀取北京通照片信息失敗，參考狀態碼
2.12輔助類函數
2.12.1 Donsee_HexToStr 16進制數組轉字符串
定義：16進制數組轉字符串
原型：
StringbytesToHex (byte[]Src,int len);
參數：
Src[in]:十六進制數組
Len[in]:數據長度
返回值：
!null：16進制數組轉字符串成功；
null：16進制數組轉字符串失敗，參考狀態碼
2.12.2 Donsee_StrToHex 字符串轉16進制數組
定義：字符串轉16進制數組
原型：byte[] hexToBytes (String Src);
參數：
Src[in]:hexstr格式字符串
返回值：
!null：字符串轉16進制數組成功；
null：字符串轉16進制數組失敗，參考狀態碼
3、狀態碼
IFD_OK0執行成功
IFD_ICC_TypeError-1卡片類型不對
IFD_ICC_NoExist-2無卡
IFD_ICC_NoPower-3有卡未上電
IFD_ICC_NoResponse-4卡片無應答
IFD_ConnectError-11讀卡器連接錯
IFD_UnConnected-12未建立連接(沒有執行打開設備函數)
IFD_BadCommand-13(動態庫)不支持該命令
IFD_ParameterError-14(發給動態庫的)命令參數錯
IFD_CheckSumError-15信息校驗和出錯
社?？顟B碼
返回值錯誤信息描述
-1卡類型不對
-2無卡
-3有卡未上電
-4卡無應答
-5加載動態庫錯
-11讀卡器連接錯
-12未建立連接
-13（動態庫）不支持該命令
-14（發給動態庫的）命令參數錯
-15信息校驗和出錯
-18操作超時
-19發送數據失敗
-20卡識別碼格式錯
-21內部認證失?。ㄓ脩艨ú缓戏ǎ?/p>
-22傳入數據與卡內不符
-23傳入數據不合法
-24PSAM卡密鑰級別不夠
-25接收數據失敗
-31用戶取消密碼輸入
-32密碼輸入操作超時
-33輸入密碼長度錯
-34兩次輸入密碼不一致
-35（預留）初始密碼不能交易
-36（預留）不能改為初始密碼
-41運算數據含非法字符
-42運算數據長度錯
-51PIN校驗失敗，剩余次數N次（根據卡返回信息）
-52PIN鎖定
-2201無PSAM卡
-2202PSAM卡算法不支持（即PSAM卡內沒有SSF33算法或SM4算法）
-2203PSAM卡內沒有RKSSSE密鑰（3.0卡讀個人基本信息需要RKSSSE密鑰外部認證）
-2204不需要加密機認證
-25536、-25537、-25538外部認證失敗，剩余可嘗試次數2、1、0次
-26368Lc/Le不正確
-26881命令不接受（無效狀態）
-27009命令與文件結構不相符、當前文件非所需文件
-27010不滿足安全條件
-27011密鑰鎖定（算法鎖定）鑒別方法鎖定
-27012引用數據無效、隨機數無效
-27013不滿足使用條件、應用被鎖定、應用未選擇、余額上溢
-27016安全報文數據項不正確、MAC不正確
-27264數據域參數不正確
-27265不支持該功能、卡中無MF、卡被鎖定、應用鎖定
-27266未找到文件、文件標識相重、SFI不正確
-27267未找到記錄
-27272未找到引用數據、未找到密鑰
-37634MAC無效
-37635應用已被永久鎖定、卡片鎖定
-37891PSAM卡不支持消費交易
-37894所需MAC（或/和TAC）不可用
其他未知錯誤
4、卡片調用順序
4.1 TypeA卡
1 設置為TypeA卡片
2 請求卡片
3 防碰撞
4 選擇卡片
5 上電
6 APDU 命令
4.2 TypeB卡
1 設置為TypeB卡片
2 上電
3 選卡
4 APDU 命令
4.3 M1卡
1 請求卡片
2 防碰撞
3 選擇卡片
4 認證密鑰
5 讀或寫
4.4 4442卡
1 上電復位
2 認證
3 讀或寫
4.5 接觸CPU卡
1 上電
2 APDU 命令
以下之所以沒有刪除，是留備用，請下載上面最新的。
USB接口最新版本（AS版本20211229-20230704New）↓
USB接口最新版本（AS版本20211229-20230713New）↓
