IC卡讀卡器web插件開發指南-通用IC卡

IC卡讀卡器web插件的方法之高頻IC卡部分：(支持讀卡器YW-605HA,YW-607,YW-627)

1.1、尋(xún)TypeA卡的卡号，包含M1卡

RequestTypeACardNo(FormatID, OrderID)

參考web例程:自動讀取卡号(回調)    自動讀取卡号(異步await/async)

參數
：FormatID，返回的卡号格式，0：16進制(8HEX)，1：10進制(10DEC).
OrderID, 卡号的現實順序，0：正常順序，1：倒序

回調函數返回結果：

FunctionID=0，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：字符串，執行函數根據函數參數給定的格式的卡号,

異步調(diào)用返回與回調(diào)結構(gòu)體一緻, 如let result = await rfidreader.RequestTypeACardNo(0,0);

1.2、尋(xún)二代證的卡号，不是證件号碼(mǎ) (YW-607)

RequestChinaIDCardNo()

參考web例程:讀取身份證卡卡号(回調僅YW-607支持)    讀取身份證卡卡号(異步await/async)

參數：無

回調函數返回結果：

FunctionID=3，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：所操作的卡的卡号，16進制正常順序,

 

1.3、尋(xún)15693卡的卡号(YW-607)

Request15693CardUID()

參考web例程:15693卡自動讀取卡号(YW-607)    15693卡自動讀取卡号(異步await/async)

參數：無

回調函數返回結果：

FunctionID=2，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：所操作的卡的卡号，16進制正常順序,

1.4、M1卡讀(dú)塊，支持将讀(dú)取的數據進行DES或者3DES加或者解密後(hòu)送回

M1ReadBlock(blockIndex， FormatID)

參考web例程:16進制讀寫塊數據    16進制讀寫塊數據(異步await/async)
參考web例程:字符串讀寫塊數據    字符串讀寫塊數據(異步await/async)
參考web例程:對16進制進行DES或者3DES加解密後讀寫塊數據(僅YW-607支持)    (異步await/async)
參考web例程:對字符串行DES或者3DES加解密後讀寫塊數據(僅YW-607支持)    (異步await/async)

如果DesDir=0則直接讀塊，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時指定DES的密鑰，則将數據加解密後返回
參數：blockIndex，塊号，絕對地址，從0開始

FormatID，格式，0：16進(jìn)制字符串返回，1：普通字符串返回。

回調函數返回結果
：

FunctionID=5，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：根據參數返回的塊數據,

 

1.5、M1卡寫塊(kuài)，支持DES或者3DES加密後(hòu)寫塊(kuài)

M1WriteBlock(blockindex,blockdata,FormatID

參考web例程:16進制讀寫塊數據    16進制讀寫塊數據(異步await/async)
參考web例程:字符串讀寫塊數據    字符串讀寫塊數據(異步await/async)
參考web例程:對16進制進行DES或者3DES加解密後讀寫塊數據(僅YW-607支持)    (異步await/async)
參考web例程:對字符串行DES或者3DES加解密後讀寫塊數據(僅YW-607支持)    (異步await/async)

如果DesDir=0則直接将數據寫塊，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時指定DES的密鑰，則将數據加解密後寫塊
參數：blockIndex，塊号，絕對地址，從0開始

blockdata：要寫入的字符串，由於(yú)M1卡的每塊爲16字節，故blockdata最終轉換的16進制不夠16字節長度，後面将補(bǔ)0x00，如果超過16字節，将去掉多餘的字節。

FormatID，格式，0：16進(jìn)制字符串返回，1：普通字符串返回。

回調函數返回結果：

FunctionID=6，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：實際寫入的數據的16進制字符串,

1.6、M1卡讀(dú)扇區，支持将讀(dú)取的數據進行DES或者3DES加或者解密後(hòu)送回

M1ReadSector(sectorindex， FormatID)

參考web例程:16進制讀寫扇區數據    16進制讀寫扇區數據(異步await/async)
參考web例程:字符串讀寫扇區數據    字符串讀寫扇區數據(異步await/async)
參考web例程:對16進制進行DES或者3DES加解密後讀寫扇區數據(僅YW-607支持)    (異步await/async)
參考web例程:對字符串進行DES或者3DES加解密後讀寫扇區數據(僅YW-607支持)    (異步await/async)

如果DesDir=0則直接讀扇區，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時指定DES的密鑰，則将數據加解密後返回
參數：blockIndex，塊号，絕對地址，從0開始

FormatID，格式，0：16進(jìn)制字符串返回，1：普通字符串返回
。

回調函數返回結果：

FunctionID=7，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：根據參數返回的扇區數據,

1.7、M1卡寫扇區(qū)，支持DES或者3DES加密後(hòu)寫扇區(qū)

M1WriteSector(blockindex,blockdata,FormatID)

參考web例程:16進制讀寫扇區數據    16進制讀寫扇區數據(異步await/async)
參考web例程:字符串讀寫扇區數據    字符串讀寫扇區數據(異步await/async)
參考web例程:對16進制進行DES或者3DES加解密後讀寫扇區數據(僅YW-607支持)    (異步await/async)
參考web例程:對字符串進行DES或者3DES加解密後讀寫扇區數據(僅YW-607支持)    (異步await/async)

如果DesDir=0則直接将數據寫扇區，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時指定DES的密鑰，則将數據加解密後寫扇區
參數：blockIndex，塊号，絕對地址，從0開始

blockdata：要寫入的字符串，由於(yú)M1卡的扇區有4塊和16塊，可用字節(jié)爲48字節(jié)和240字節(jié)

故blockdata最終轉換的16進制不夠字節長(zhǎng)度，後面将補(bǔ)0x00，如果超過字節長(zhǎng)度，将去掉多餘的字節
。

FormatID，格式
，0：16進(jìn)制字符串返回，1：普通字符串返回。

回調函數返回結果：

FunctionID=8，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：實際寫入的數據的16進制字符串,

1.8、M1卡初始化錢包

M1IntialValue(blockIndex,value)

參考web例程:錢包操作    錢包操作(異步await/async)

參(cān)數：blockIndex，塊号，絕對地址，從(cóng)0開始

value：要初始化的值

回調函數返回結果：

FunctionID=9，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：要初始化的值,
ValData：初始化後的餘額,

1.9、M1卡獲(huò)取錢包餘額(é)

M1GetValue(blockIndex)

參考web例程:錢包操作    錢包操作(異步await/async)

參(cān)數：blockIndex，塊号，絕對地址，從(cóng)0開始

回調函數返回結果：

FunctionID=10，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：錢包餘額,
ValData：錢包餘額,

 

1.10、M1卡錢包充值

M1IncreaseValue(blockIndex,value)

參考web例程:錢包操作    錢包操作(異步await/async)

參(cān)數：blockIndex，塊号，絕對地址，從(cóng)0開始

value：要充值的值

回調函數返回結果：

FunctionID=11，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：要充值的值,
ValData：充值後的錢包餘額,

1.11、M1卡錢包消費(fèi)，即減(jiǎn)值

M1DecreaseValue(blockIndex,value)

參考web例程:錢包操作    錢包操作(異步await/async)

參(cān)數：blockIndex，塊号，絕對地址，從(cóng)0開始

value：要減值的值

回調函數返回結果：

FunctionID=12，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号，16進制正常順序,
strData：要減值的值,
ValData：減值後的錢包餘額,

 

1.12、蜂鳴器鳴叫

Beep(TimeOn,TimeOff,Times)

參(cān)數：TimeOn，鳴叫的時間(jiān)(*100ms)

TimeOff,：不鳴(míng)叫的時間(jiān)(*100ms)

Times,：循環的次數

注：蜂鳴器函數在類屬性中可以配置每次執行後的動作
，一般不需要單(dān)獨調(diào)用。

回調函數返回結果：

FunctionID=13，
Result：數字，函數執行後的返回值,
UID：自定義的序号,

1.13、獲(huò)取Web插件的版本

Ver()

參數：無

注：在連接Web插件時，自動調(diào)用瞭(le)Ver()函數，中途可以通過Version屬性獲取或者在回調(diào)函數中讀取。

回調函數返回結果：

FunctionID=14，
Result：數字
，函數執行後的返回值,
UID：自定義的序号,
strData：版本号,

 

1.14、斷(duàn)開(kāi)Web插件連接

Disconnect()

參數：無

注：斷(duàn)開Web插件連接，一般在頁面的unload中調(diào)用。

1.15、CPU卡複位

ACPUReset()

參考web例程:CPU卡操作(FM1208)    CPU卡操作(異步await/async)

參數：無

回調函數返回結果：

FunctionID=17，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：所操作的卡的卡号
，16進制正常順序,
strData：複位後的返回的16進制字符串
ValData：無

1.16、CPU卡執(zhí)行COS

CPUCOS(COSHexString)

參考web例程:CPU卡操作(FM1208)    CPU卡操作(異步await/async)

參(cān)數：COSHexString：要執行的COS指令，16進(jìn)制字符串。

回調函數返回結果：

FunctionID=19，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：無
strData：執行COS後的返回的16進制字符串
ValData：執行COS指令返回的狀态，10進制顯示，如：9000顯示爲36864

 

1.17、執(zhí)行DES或者3DES加解密算法

Des(DesData, DesDataForamt)

參考web例程:對數據進行DES或者3DES加解密    對數據進行DES或者3DES加解密(異步await/async)

DES加解密函數要配合屬性DesDir，DesMode，DesKey，DesKeyMode等使用
參數
：DesDatag：要加解密的數據。DesDataForamt:數據的格式，0十六進制字符串，1位普通字符串

回調函數返回結果：

FunctionID=22，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：無
strData：執行加解密後的16進制字符串
ValData：無

 

1.18、下載密鑰(yào)到讀(dú)卡器中

DownKey(KeyIndex,KeyString)

參考web例程:下載密鑰到讀卡器    下載密鑰到讀卡器(異步await/async)
參考web例程:使用下載的密鑰認證讀寫數據    使用下載的密鑰認證讀寫數據(異步await/async)

DownKey可以将密鑰下載到讀卡器中
KeyIndex：密鑰序号，範圍0到31。
KeyString:16進制字符串，6字節。

回調函數返回結果：

FunctionID=45，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：無
strData：無
ValData：無

 

1.19、卡号格式轉換

CardUIDFormat(hexuid, format,order);

參考web例程:卡号格式轉換    卡号格式轉換(異步await/async)

hexduid：卡号的16進制字符串
format：需要轉換的格式.
0: 16進制(HEX)
1: 10進制(8H-10D)
2: 10進制(6H-8D)
3: 10進制(4H-5D)
4: 8Hex(8H)
5: 6Hex(6H)
6: 4Hex(4H)
7: WG26(2H+4H)
8: WG34(4H+4H)
order：順序，0爲正須，1爲倒序。

回調函數返回結果：

FunctionID=76，
Result：數字，函數執行後的返回值,
UID：自定義的序号,
CardNo：輸入的卡号
strData：轉換後的卡号
ValData：無

 

IC卡web插件API函數(shù)接口按照使用的IC卡參(cān)考如下：