RFID讀寫器web插件開發指南(HF和UHF)

支持IC卡讀卡器在web中應用，兼容IE,Chrome,Firefox,Safari,Opera等瀏覽器

目錄
簡介
支持的瀏覽器和版本
WEB開發指南
類YOWORFIDReader的屬性
類YOWORFIDReader的回調函數：onResult
類YOWORFIDReader的方法之高頻IC卡(含M1卡)部分(支持讀卡器YW-605HA,YW-607,YW-627)
類YOWORFIDReader的方法之NFC卡(含NTAG卡)部分(支持讀卡器YW-607,YW-627)
類YOWORFIDReader的方法之高頻15693卡部分(支持讀卡器YW-607,YW-627)
類YOWORFIDReader的方法之超高頻IC卡（UHF）部分(支持讀卡器YW-602)
類YOWORFIDReader的方法之NFC NDEF部分(支持讀卡器YW-607,YW-627)
類YOWORFIDReader的方法之CPU卡EY5K01卡部分(支持讀卡器YW-607,YW-627)
類YOWORFIDReader的方法之YW-627液晶顯示部分(支持讀卡器YW-627)

為了在BS結構下使用RFID讀寫器和IC卡讀卡器，友我科技提供了基于ocx技術的安裝包，使大家可以在web頁面調用和使用IC卡讀卡器，但是ocx的局限就是只能在IE瀏覽器中使用。 為了突破這種局限，友我科技又發布了RFID讀寫器Web插件，他不僅支持IE瀏覽器，也支持Firefox，Chrome，Safari，Opera等等主流的瀏覽器，讓軟件工程師的作品無需再注明只支持IE，極大的提高用戶體驗。 友我科技RFID讀寫器Web插件是為RFID讀寫器和IC卡讀卡器為在BS結構下，更方便更容易更穩定的嵌入到各種主流的瀏覽器中提供的的數據流服務。 RFID讀寫器Web插件采用js腳本，無需ocx控件嵌入，通過異步回調的方式，就可以在web端實現IC卡的讀寫。
目前,RFID讀寫器Web插件插件支持高頻IC卡,例如M1系列卡片。也支持超高頻RFID卡，如6C，G2卡

WEBWeb插件插件支持Windows下 IE，Chrome，Firefox，Safari，Opera以及以這些為內核的瀏覽器,在客戶端會自動安裝云服web插件.支持的IC卡讀寫器型號列表如下:

友我科技rfid讀寫器Web插件的優勢：
1、該系統在單機，局域網，互聯網都可以使用，只要客戶端安裝Web插件程序就行。
2、客戶端同時支持net frame3.5和net frame4.0及以上。
3、客戶端兼容IE，Chrome，Firefox，Safari，Opeara及其相關內核的瀏覽器。
4、與網頁編程語言無關，不管是asp,php,jsp,aspx,html,都支持。
5、客戶端采用事件驅動（回調函數），無需占用界面線程的時間。
6、客戶端支持多種IC卡讀卡器，可以根需求據功能自由選擇。
7、單獨支持64位和128位的DES加解密服務。
8、支持64位或者128位的DES加解密讀寫數據塊，流程更少，效率更高，數據更安全。 （僅YW-607讀寫器以上支持）
9、支持高頻和超高頻的IC卡讀卡器有相對應的卡片。

各瀏覽器支持的版本如下：
google Chrome V4.0及以上
Firefox V4.0及以上
IE V10.0及以上
Opera V10.0及以上
Safari V5.0及以上

下載RFID讀寫器Web插件開發版，當前版本V2.2.0.0，有提示安裝界面，有進入開發指南

下載RFID讀寫器Web插件終端版，當前版本V2.2.0.0，有安裝界面，無開發內容

RFID讀寫器Web插件支持的RFID讀寫器有YW-605HA，YW-607，YW-602系列等

基于RFID讀寫器Web插件的web開發指南                                           Web開發應用實例

首先包含js文件

<script language="javascript" src="http://127.0.0.1:8008/YOWOCloudRFIDReader.js"></script>

在自己的文件中引用類：YOWORFIDReader， 如下代碼創建一個讀卡器的object。

try
{
var rfidreader=YOWORFIDReader.createNew();
}
catch(e)
{
alert("創建友我科技RFIDWeb插件連接失敗，請先下載安裝！");
top.location = "http://www.skimani.com/CloudReader/YOWORFIDReaderCloudForWeb.exe";
}
if(!rfidreader.TryConnect())
{
alert("瀏覽器不支持，請更換瀏覽器后重試！");
}

然后就可以使用。

類YOWORFIDReader的屬性：

類YOWORFIDReader的回調函數：onResult

可以做如下調用：

rfidreader.onResult(function(resultdata)
{
}

參數resultdata是一個結構，結構類型如下：

FunctionID：數字，執行的函數編號,
Result：數字，函數執行后的返回值,小于0位失敗，大于0為成功。
UID：數字，執行函數前，自定義的序號,
ReaderID：數字，讀卡器的ID,
CardNo：字符串，所操作的卡的卡號，16進制正常順序,
strData：字符串，執行函數根據函數參數返回的數據,
ValData：數字，執行函數根據函數參數返回數字結果。

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

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

RequestTypeACardNo(FormatID, OrderID)

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

回調函數返回結果：

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

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

RequestChinaIDCardNo()

參數：無

回調函數返回結果：

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

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

Request15693CardUID()

回調函數返回結果：

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

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

M1ReadBlock(blockIndex， FormatID)

如果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

如果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)

如果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)

如果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)

參數：blockIndex，塊號，絕對地址，從0開始

value：要初始化的值

回調函數返回結果：

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

1.9、M1卡獲取錢包余額

M1GetValue(blockIndex)

參數：blockIndex，塊號，絕對地址，從0開始

回調函數返回結果：

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

1.10、M1卡錢包充值

M1IncreaseValue(blockIndex,value)

參數：blockIndex，塊號，絕對地址，從0開始

value：要充值的值

回調函數返回結果：

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

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

M1DecreaseValue(blockIndex,value)

參數：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()

參數：無

回調函數返回結果：

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

1.16、CPU卡執行COS

CPUCOS(COSHexString)

參數：COSHexString：要執行的COS指令，16進制字符串。

回調函數返回結果：

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

1.17、執行DES或者3DES加解密算法

Des(DesData, DesDataForamt)

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

回調函數返回結果：

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

1.18、下載密鑰到讀卡器中

DownKey(KeyIndex,KeyString)

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

回調函數返回結果：

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