IC卡讀卡器web插件開發(fā)指南-通用IC卡

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

1.1、尋TypeA卡的卡號(hào)，包含M1卡

RequestTypeACardNo(FormatID, OrderID)

參考web例程:自動(dòng)讀取卡號(hào)(回調(diào))    自動(dòng)讀取卡號(hào)(異步await/async)

參數(shù)：FormatID，返回的卡號(hào)格式，0：16進(jìn)制(8HEX)，1：10進(jìn)制(10DEC).
OrderID, 卡號(hào)的現(xiàn)實(shí)順序，0：正常順序，1：倒序

回調(diào)函數(shù)返回結(jié)果：

FunctionID=0，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：字符串，執(zhí)行函數(shù)根據(jù)函數(shù)參數(shù)給定的格式的卡號(hào),

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

1.2、尋二代證的卡號(hào)，不是證件號(hào)碼 (YW-607)

RequestChinaIDCardNo()

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

參數(shù)：無

回調(diào)函數(shù)返回結(jié)果：

FunctionID=3，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：所操作的卡的卡號(hào)，16進(jìn)制正常順序,

 

1.3、尋15693卡的卡號(hào)(YW-607)

Request15693CardUID()

參考web例程:15693卡自動(dòng)讀取卡號(hào)(YW-607)    15693卡自動(dòng)讀取卡號(hào)(異步await/async)

參數(shù)：無

回調(diào)函數(shù)返回結(jié)果：

FunctionID=2，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：所操作的卡的卡號(hào)，16進(jìn)制正常順序,

1.4、M1卡讀塊，支持將讀取的數(shù)據(jù)進(jìn)行DES或者3DES加或者解密后送回

M1ReadBlock(blockIndex， FormatID)

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

如果DesDir=0則直接讀塊，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時(shí)指定DES的密鑰，則將數(shù)據(jù)加解密后返回
參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

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

回調(diào)函數(shù)返回結(jié)果：

FunctionID=5，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：根據(jù)參數(shù)返回的塊數(shù)據(jù),

 

1.5、M1卡寫塊，支持DES或者3DES加密后寫塊

M1WriteBlock(blockindex,blockdata,FormatID

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

如果DesDir=0則直接將數(shù)據(jù)寫塊，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時(shí)指定DES的密鑰，則將數(shù)據(jù)加解密后寫塊
參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

blockdata：要寫入的字符串，由于M1卡的每塊為16字節(jié)，故blockdata最終轉(zhuǎn)換的16進(jìn)制不夠16字節(jié)長(zhǎng)度，后面將補(bǔ)0x00，如果超過16字節(jié)，將去掉多余的字節(jié)。

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

回調(diào)函數(shù)返回結(jié)果：

FunctionID=6，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：實(shí)際寫入的數(shù)據(jù)的16進(jìn)制字符串,

1.6、M1卡讀扇區(qū)，支持將讀取的數(shù)據(jù)進(jìn)行DES或者3DES加或者解密后送回

M1ReadSector(sectorindex， FormatID)

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

如果DesDir=0則直接讀扇區(qū)，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時(shí)指定DES的密鑰，則將數(shù)據(jù)加解密后返回
參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

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

回調(diào)函數(shù)返回結(jié)果：

FunctionID=7，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：根據(jù)參數(shù)返回的扇區(qū)數(shù)據(jù),

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

M1WriteSector(blockindex,blockdata,FormatID)

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

如果DesDir=0則直接將數(shù)據(jù)寫扇區(qū)，如果DesDir=1(YW-607)或者DesDir=2(YW-607)，同時(shí)指定DES的密鑰，則將數(shù)據(jù)加解密后寫扇區(qū)
參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

blockdata：要寫入的字符串，由于M1卡的扇區(qū)有4塊和16塊，可用字節(jié)為48字節(jié)和240字節(jié)

故blockdata最終轉(zhuǎn)換的16進(jìn)制不夠字節(jié)長(zhǎng)度，后面將補(bǔ)0x00，如果超過字節(jié)長(zhǎng)度，將去掉多余的字節(jié)。

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

回調(diào)函數(shù)返回結(jié)果：

FunctionID=8，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：實(shí)際寫入的數(shù)據(jù)的16進(jìn)制字符串,

1.8、M1卡初始化錢包

M1IntialValue(blockIndex,value)

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

參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

value：要初始化的值

回調(diào)函數(shù)返回結(jié)果：

FunctionID=9，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：要初始化的值,
ValData：初始化后的余額,

1.9、M1卡獲取錢包余額

M1GetValue(blockIndex)

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

參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

回調(diào)函數(shù)返回結(jié)果：

FunctionID=10，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：錢包余額,
ValData：錢包余額,

 

1.10、M1卡錢包充值

M1IncreaseValue(blockIndex,value)

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

參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

value：要充值的值

回調(diào)函數(shù)返回結(jié)果：

FunctionID=11，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：要充值的值,
ValData：充值后的錢包余額,

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

M1DecreaseValue(blockIndex,value)

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

參數(shù)：blockIndex，塊號(hào)，絕對(duì)地址，從0開始

value：要減值的值

回調(diào)函數(shù)返回結(jié)果：

FunctionID=12，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：要減值的值,
ValData：減值后的錢包余額,

 

1.12、蜂鳴器鳴叫

Beep(TimeOn,TimeOff,Times)

參數(shù)：TimeOn，鳴叫的時(shí)間(*100ms)

TimeOff,：不鳴叫的時(shí)間(*100ms)

Times,：循環(huán)的次數(shù)

注：蜂鳴器函數(shù)在類屬性中可以配置每次執(zhí)行后的動(dòng)作，一般不需要單獨(dú)調(diào)用。

回調(diào)函數(shù)返回結(jié)果：

FunctionID=13，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),

1.13、獲取Web插件的版本

Ver()

參數(shù)：無

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

回調(diào)函數(shù)返回結(jié)果：

FunctionID=14，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
strData：版本號(hào),

 

1.14、斷開Web插件連接

Disconnect()

參數(shù)：無

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

1.15、CPU卡復(fù)位

ACPUReset()

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

參數(shù)：無

回調(diào)函數(shù)返回結(jié)果：

FunctionID=17，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：所操作的卡的卡號(hào)，16進(jìn)制正常順序,
strData：復(fù)位后的返回的16進(jìn)制字符串
ValData：無

1.16、CPU卡執(zhí)行COS

CPUCOS(COSHexString)

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

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

回調(diào)函數(shù)返回結(jié)果：

FunctionID=19，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：無
strData：執(zhí)行COS后的返回的16進(jìn)制字符串
ValData：執(zhí)行COS指令返回的狀態(tài)，10進(jìn)制顯示，如：9000顯示為36864

 

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

Des(DesData, DesDataForamt)

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

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

回調(diào)函數(shù)返回結(jié)果：

FunctionID=22，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：無
strData：執(zhí)行加解密后的16進(jìn)制字符串
ValData：無

 

1.18、下載密鑰到讀卡器中

DownKey(KeyIndex,KeyString)

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

DownKey可以將密鑰下載到讀卡器中
KeyIndex：密鑰序號(hào)，范圍0到31。
KeyString:16進(jìn)制字符串，6字節(jié)。

回調(diào)函數(shù)返回結(jié)果：

FunctionID=45，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：無
strData：無
ValData：無

 

1.19、卡號(hào)格式轉(zhuǎn)換

CardUIDFormat(hexuid, format,order);

參考web例程:卡號(hào)格式轉(zhuǎn)換    卡號(hào)格式轉(zhuǎn)換(異步await/async)

hexduid：卡號(hào)的16進(jìn)制字符串
format：需要轉(zhuǎn)換的格式.
0: 16進(jìn)制(HEX)
1: 10進(jìn)制(8H-10D)
2: 10進(jìn)制(6H-8D)
3: 10進(jìn)制(4H-5D)
4: 8Hex(8H)
5: 6Hex(6H)
6: 4Hex(4H)
7: WG26(2H+4H)
8: WG34(4H+4H)
order：順序，0為正須，1為倒序。

回調(diào)函數(shù)返回結(jié)果：

FunctionID=76，
Result：數(shù)字，函數(shù)執(zhí)行后的返回值,
UID：自定義的序號(hào),
CardNo：輸入的卡號(hào)
strData：轉(zhuǎn)換后的卡號(hào)
ValData：無

 

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

<b id="n3ws3"><menuitem id="n3ws3"></menuitem></b>

<b id="n3ws3"><menuitem id="n3ws3"></menuitem></b>