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

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

1.1、尋TypeA卡的卡號，包含M1卡

RequestTypeACardNo(FormatID, OrderID)

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

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

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

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

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

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

RequestChinaIDCardNo()

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

參數(shù)：無

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

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

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

Request15693CardUID()

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

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

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

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

M1ReadBlock(blockIndex， FormatID)

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

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

FormatID，格式，0：16進制字符串返回，1：普通字符串返回。

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

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

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

M1WriteBlock(blockindex,blockdata,FormatID

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

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

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

FormatID，格式，0：16進制字符串返回，1：普通字符串返回。

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

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

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

M1ReadSector(sectorindex， FormatID)

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

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

FormatID，格式，0：16進制字符串返回，1：普通字符串返回。

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

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

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

M1WriteSector(blockindex,blockdata,FormatID)

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

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

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

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

FormatID，格式，0：16進制字符串返回，1：普通字符串返回。

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

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

1.8、M1卡初始化錢包

M1IntialValue(blockIndex,value)

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

參數(shù)：blockIndex，塊號，絕對地址，從0開始

value：要初始化的值

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

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

1.9、M1卡獲取錢包余額

M1GetValue(blockIndex)

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

參數(shù)：blockIndex，塊號，絕對地址，從0開始

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

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

1.10、M1卡錢包充值

M1IncreaseValue(blockIndex,value)

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

參數(shù)：blockIndex，塊號，絕對地址，從0開始

value：要充值的值

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

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

1.11、M1卡錢包消費，即減值

M1DecreaseValue(blockIndex,value)

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

參數(shù)：blockIndex，塊號，絕對地址，從0開始

value：要減值的值

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

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

1.12、蜂鳴器鳴叫

Beep(TimeOn,TimeOff,Times)

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

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

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

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

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

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

1.13、獲取Web插件的版本

Ver()

參數(shù)：無

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

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

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

1.14、斷開Web插件連接

Disconnect()

參數(shù)：無

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

1.15、CPU卡復位

ACPUReset()

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

參數(shù)：無

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

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

1.16、CPU卡執(zhí)行COS

CPUCOS(COSHexString)

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

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

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

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

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

Des(DesData, DesDataForamt)

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

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

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

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

1.18、下載密鑰到讀卡器中

DownKey(KeyIndex,KeyString)

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

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

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

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

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

CardUIDFormat(hexuid, format,order);

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

hexduid：卡號的16進制字符串
format：需要轉(zhuǎn)換的格式.
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為倒序。

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

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

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