Felica IDm Receiver Extension for RC-S380

Felica IDm Receiver Extension for RC-S380插件简介

Felica IDm Receiver Extension for RC-S380插件描述

To exchange data with felica cards, you need Felica IDm Reader App f RCS380.
This extension helps you to sending  recieving data  web pages  reader app.

Features:
* Sending felica card IDm, rom chalenge response to web pages from reader app.
* Writing felica card user ID  Key with reader app.
* The custom event getId is fired when the data recieved, so you can run your own script when recieved data.
* Veryfing rom challenge response from the card.(Only f testing)


How to use
	
Please embed html elemnents with following id in your web pages.
The option page  script of this extension is an example of usage, so please check it.
"extension" means "Felica IDm Receiver Extension f RCS380",
"app" means "Felica IDm Reader App f RCS380".
Basically, extension sends requests to app,  recieves the result.


*** Reading IDm ***
(Both felica  felica lites available)
input:
 startPolling : When its clicked,  extension makes app to start reading IDm.
output:
 felicaIDm : IDm is inserted to the value of this element by extension. This extension fires getID event in this element.


*** Reading user ID ***
(Only felica lites available)
input:
 getCardId : When its clicked, extension makes app to start reading IDm  user ID.
output:
 felicaIDm : IDm  user ID are inserted together to the value of this element by extension. 


*** Writing user ID  Key ***
(Only felica lites available)
If you dont enter master key  car key version, only user ID will be written.
You cant read card key written in the card directly.

input:
 felicaUserId : 0  281474976710655 integral number
 felicaCKVInput : 0  65535 integral number
 felicaMasterKey : 24bytes hex number string
 writeCardId :  When its clicked, extension makes app to start writing user ID, card key version,  card key.

output:
 felicaIDm : IDm  user ID are inserted together to the value of this element by extension. 


*** Writing Rom Challenge ***
(Only felica lites available) 

input:
 authCard : When its clicked, extension sends 16bytes rom numbers  makes app to start writing rom challenges.

output:
 felicaIDm : IDm is inserted to the value of this element by extension. 
 felicaCKV : 16bytes hex numbers string including the card key version is inserted to the value of this element.
 felicaRomNum : Rom 16bytes hex numbers used in rom challenge is inserted to the value of this element.
 felicaRomRes : 16bytes hex numbers rom challenge response is inserted to the value of this element.

*** Veryfing Rom Challenge Response ***
(Only felica lites available)
Entering keys in web pages is NOT SAFE, so please use this feature only f testing!
After sending rom challenge, enter master key  click verify button,
extension calculates MAC_A value  compares it to response of thet card.

#####################
Cautions:
#####################
1.I wont take any responsibilities about installing  using this application, including changing drivers in your PCs.

2.The copyright of this application belongs to me, but you can check inside of this application from background pages.

3.The authentication functions are designed based on SONYs document(you can find on the web), but there is no guarantee about security.

This app is using CryptoJS, useful javascript encryption library, to write card key.
(https://code.google.com/p/cryptojs/)
Any comments would be appreciable.  

FelicaカードのIDmをWebページを連携するための拡張機能です。
またFelicaLiteSカードへのユーザ独自IDの書き込み・読み出しを行います。
(IDmの読み取りにはFelica IDm Reader App f RCS380が必要です)

使い方：
1. IDmを連携したいWebページにIDがstartPollingのbutton要素とIDがfelicaIDmのinput要素を埋め込んでください。
   (IDmとユーザ独自IDを取得する場合はIDがgetUserIdのbutton要素を埋めこんでください)
2. ボタンをクリックするとAppが読み取りを開始し、IDの読み取りが完了したらinput要素にIDが連携されます。
3. ページを移動したり閉じたりするとAppの動作を停止します。
4. ページ読み取り時に自動実行する場合はページ読み込み時にボタンを押すスクリプトを追加して下さい。

動作確認：
[IDmの読み出し]
1．WinUSBをインストールし、PCにRCS380を接続する
2. 拡張機能の管理画面をChromeのメニューの「その他のツール」⇒「拡張機能」から開く
3. 「Felica IDm Reciever Extension f RCS380」のオプション画面を開く
4. オプション画面で「get IDm」ボタンを押してカードをかざす
5. 読み出しが完了するとオプション画面にIDmが表示される

[FelicaLiteSでのユーザ独自IDの書き込み・読み出し]
1. オプション画面でuserIDの入力フォームにIDを入力
2. カードをかざした状態で、「regist userID」ボタンを押す
3. IDm表示画面に表示されるIDmと入力したIDを確認する
4. IDの取得のみ行う場合は「get userID」ボタンを押してIDmとIDを取得する
※ユーザ独自IDは0～281474976710655の整数値以外は登録できません。またカード内では16進表記で登録されます。

デフォルトで「Felica IDm Reader App f RCS380」と連携する設定ですが、オプション画面でAppのIDを変更できます。

動作環境：
　1.対応OS：Windows7およびXPのChromeブラウザで動作を確認しています。
	　(その他のＯＳでは動作未確認です。モバイルアプリ版のChromeでは現時点で動作不可です。)

　2.対応ICカード：Felica、Felica LiteSカードで動作を確認しました。
　　　　　　　　(Mifareカードでは動作未確認です)

　3.ドライバ：WinUSBをインストールして下さい。
　　　　　　　(ソニー社のNFCポートソフトウェアでは動作しません。zadig等のツールで上書きしてインストールしてください)

時々動かなくなることがあるかもしれませんが、ブラウザごと再起動して頂くと一番手っ取り早いと思います…。
なお現時点では未公開ですが、Felica LiteSカードに対応した非暗号化書き込み・読み出しおよびカードの認証(内部認証)の機能も作成しています。
ご要望があれば公開していきたいと思っています。

留意事項および免責事項：
　1.この拡張機能のインストールや利用およびドライバの変更により発生するいかなる事故・損害について当方は一切責任を負いませんので、
　　ドライバの変更およびアプリのインストール・ご利用は自己責任で実施願います。

　2.このアプリの著作権は当方に帰属いたしますが、中身はバックグラウンドページ等からご自由に閲覧して下さい。
　　
改善点や不具合、その他ご意見あればご一報下さい。可能な限り対応します。
動作確認をして頂ける方がいらっしゃれば有難いです。
                                

Felica IDm Receiver Extension for RC-S380插件离线安装方法

1.首先用户点击谷歌浏览器右上角的自定义及控制按钮，在下拉框中选择设置。

2.在打开的谷歌浏览器的扩展管理器最左侧选择扩展程序或直接输入：chrome://extensions/

3.找到自己已经下载好的Chrome离线安装文件xxx.crx，然后将其从资源管理器中拖动到Chrome的扩展管理界面中，这时候用户会发现在扩展管理器的中央部分中会多出一个”拖动以安装“的插件按钮。

4.下载 Felica IDm Receiver Extension for RC-S380Chrome插件v3.0.1版本到本地。

5.勾选开发者模式，点击加载已解压的扩展程序，将文件夹选择即可安装插件。

注意：最新版本的chrome浏览器直接拖放安装时会出现“程序包无效CRX-HEADER-INVALID”的报错信息，参照这篇文章即可解决