IC卡读卡器web插件开发指南-通用IC卡

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

1.1、寻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：字符串，执行函数根据函数参数给定的格式的卡号,

异步调用返回与回调结构体一致, 如let result = await rfidreader.RequestTypeACardNo(0,0);

1.2、寻二代证的卡号，不是证件号码 (YW-607)

RequestChinaIDCardNo()

参考web例程:读取身份证卡卡号(回调仅YW-607支持)    读取身份证卡卡号(异步await/async)

参数：无

回调函数返回结果：

FunctionID=3，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：所操作的卡的卡号，16进制正常顺序,

 

1.3、寻15693卡的卡号(YW-607)

Request15693CardUID()

参考web例程:15693卡自动读取卡号(YW-607)    15693卡自动读取卡号(异步await/async)

参数：无

回调函数返回结果：

FunctionID=2，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：所操作的卡的卡号，16进制正常顺序,

1.4、M1卡读块，支持将读取的数据进行DES或者3DES加或者解密后送回

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进制字符串返回，1：普通字符串返回。

回调函数返回结果：

FunctionID=5，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：根据参数返回的块数据,

 

1.5、M1卡写块，支持DES或者3DES加密后写块

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：要写入的字符串，由于M1卡的每块为16字节，故blockdata最终转换的16进制不够16字节长度，后面将补0x00，如果超过16字节，将去掉多余的字节。

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

回调函数返回结果：

FunctionID=6，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：实际写入的数据的16进制字符串,

1.6、M1卡读扇区，支持将读取的数据进行DES或者3DES加或者解密后送回

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进制字符串返回，1：普通字符串返回。

回调函数返回结果：

FunctionID=7，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：根据参数返回的扇区数据,

1.7、M1卡写扇区，支持DES或者3DES加密后写扇区

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：要写入的字符串，由于M1卡的扇区有4块和16块，可用字节为48字节和240字节

故blockdata最终转换的16进制不够字节长度，后面将补0x00，如果超过字节长度，将去掉多余的字节。

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

回调函数返回结果：

FunctionID=8，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：实际写入的数据的16进制字符串,

1.8、M1卡初始化钱包

M1IntialValue(blockIndex,value)

参考web例程:钱包操作    钱包操作(异步await/async)

参数：blockIndex，块号，绝对地址，从0开始

value：要初始化的值

回调函数返回结果：

FunctionID=9，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：要初始化的值,
ValData：初始化后的余额,

1.9、M1卡获取钱包余额

M1GetValue(blockIndex)

参考web例程:钱包操作    钱包操作(异步await/async)

参数：blockIndex，块号，绝对地址，从0开始

回调函数返回结果：

FunctionID=10，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：钱包余额,
ValData：钱包余额,

 

1.10、M1卡钱包充值

M1IncreaseValue(blockIndex,value)

参考web例程:钱包操作    钱包操作(异步await/async)

参数：blockIndex，块号，绝对地址，从0开始

value：要充值的值

回调函数返回结果：

FunctionID=11，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：要充值的值,
ValData：充值后的钱包余额,

1.11、M1卡钱包消费，即减值

M1DecreaseValue(blockIndex,value)

参考web例程:钱包操作    钱包操作(异步await/async)

参数：blockIndex，块号，绝对地址，从0开始

value：要减值的值

回调函数返回结果：

FunctionID=12，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：要减值的值,
ValData：减值后的钱包余额,

 

1.12、蜂鸣器鸣叫

Beep(TimeOn,TimeOff,Times)

参数：TimeOn，鸣叫的时间(*100ms)

TimeOff,：不鸣叫的时间(*100ms)

Times,：循环的次数

注：蜂鸣器函数在类属性中可以配置每次执行后的动作，一般不需要单独调用。

回调函数返回结果：

FunctionID=13，
Result：数字，函数执行后的返回值,
UID：自定义的序号,

1.13、获取Web插件的版本

Ver()

参数：无

注：在连接Web插件时，自动调用了Ver()函数，中途可以通过Version属性获取或者在回调函数中读取。

回调函数返回结果：

FunctionID=14，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
strData：版本号,

 

1.14、断开Web插件连接

Disconnect()

参数：无

注：断开Web插件连接，一般在页面的unload中调用。

1.15、CPU卡复位

ACPUReset()

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

参数：无

回调函数返回结果：

FunctionID=17，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：所操作的卡的卡号，16进制正常顺序,
strData：复位后的返回的16进制字符串
ValData：无

1.16、CPU卡执行COS

CPUCOS(COSHexString)

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

参数：COSHexString：要执行的COS指令，16进制字符串。

回调函数返回结果：

FunctionID=19，
Result：数字，函数执行后的返回值,
UID：自定义的序号,
CardNo：无
strData：执行COS后的返回的16进制字符串
ValData：执行COS指令返回的状态，10进制显示，如：9000显示为36864

 

1.17、执行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、下载密钥到读卡器中

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函数接口按照使用的IC卡参考如下：