NFC Reader Extension for Win32

NFC Reader Extension for Win32插件简介

NFC Reader Extension for Win32插件描述

This extension sends Felica  Mifare card IDs to web pages from PC/SC featured card reader.
(To read cards, the win32 application distributed in the GitHub is needed.)
Now it only reads ID, I will add functions such as read/write nonencryption areas in the future.

GitHub URL: https://github.com/yosuke1984chrome/chrome_nfcbridge_win32

PC/SC対応のICリーダ/ライタから読み出したFelica・Mifareカードの情報をWebページへ連携する拡張機能です。
(カードの読み出しには上記のGitHubページにて配布する、Win32アプリケーション別途必要です)
現時点ではIDの読み取りのみですが、非暗号領域の読み出し・書き込み機能等も追加予定です。
日本語の詳細説明は後段に記載しています。


Environments

1.OS : Windows 32bit only
2.IC cards : Mifare Classic, Mifare Ultralight, Felica, Felica LiteS
3.Devices :PC/SC featured IC card readers( drivers f each devices needed)


How to install

1. Add this extension to your Chrome browser.
2. Download chrome.nfcbridge.win32 with ZIP file fm the GitHub page.(You can download ZIP file by clicking download ZIP button)
3. Unzip the zip file  install the Win32 application as written in InstallGuide_en.txt.
4. Also you can update the Win32 application by downloading the latest version from the GitHub page  install.


Use in popup page

By clicking the button in the popup page, this starts getting card ID.

1. Click the icon of this extension,  show the popup page.
2. Click get ID button  hold the card, then check the card ID.(7bytes UID f Mifare cards  8byte IDm f Felica cards) 
3. If threre is an html element with cardId id in the current web page, this sets the value of element to card ID.


Use in web pages

You can also embed the get ID button in your own web page.
Please see sample html included in the zip file,  option page of this extension.

1. Embed element with startPolling id  element with cardId id in your web page.
2. By clicking startPolling element , this starts to read the IC card.
3. ID of the card is added to the cardId element when reading ID.
4. The extension stops when the web page is moved  removed,  Win32 application also stops.
(As the custom event getId is fired when the card ID sent, so you can associate your script with getId event in reading cards.)

Any comments would be appreciable.  

Cautions:
 1.I wont take any responsibilities f damages about installing  using this extension  application.
 2.The copyright of this extension belongs to me, but you can see inside of this application from back ground pages.



■動作環境：
1.OS：Windows 32bit(その他のＯＳでは動作しません)
2.ICカード：Felica、Felica LiteS、Mifare Classic、Mifare Ultralight
3.デバイス：PC/SC対応のICリーダ/ライタ(各ICリーダ/ライタのドライバも必要です)

■インストール方法：
1. この拡張機能をChromeに追加して下さい。
2. GitHubページからchrome.nfcbridge.win32をZIPファイルでダウンロードして下さい。(ページ右側のdownload ZIPボタンからZIPファイルがダウンロードできます)
3. ZIPファイルを解凍してInstallGuideの記載内容に従ってアプリケーションをインストールして下さい。
4. win32アプリケーションのアップデート時も同様にGitHubページから最新版をダウンロードし、インストールして下さい。

■ポップアップでの使い方：
1. ブラウザ右上の本拡張機能のアイコンをクリックし、ポップアップを開く。
2. ポップアップの「get IDm」ボタンを押してカードをかざし、カードIDが表示されることを確認する。
   (Felicaカードでは8バイトのIDm、Mifareカードでは7バイトのUIDが表示されます)
3. 表示中のWebページ内にIDが「cardId」のHTML要素があれば、その要素のvalue値をカードIDに変更します。

■Webページ上での使い方
（GitHubページにてアプリケーションに同梱のサンプルHTMLファイルおよび、本拡張機能のオプションページをご参考下さい）

1. IDを連携したいWebページにIDがstartPollingの要素とIDがcardIdの要素を埋め込んでください。
2. startPolling要素をクリックするとカードIDの読み取りを開始します。
3. IDの読み取りが完了したらIDがcardId要素のvalue値に書き込まれます。
4. ページを移動したり閉じたりすると読み取りを中止し、Win32アプリケーションも終了します。
(IDの連携時にcardId要素にgetIdというカスタムイベントが発生するので、読み取り時に実行したい動作はgetIdイベントに連動させてください)

※留意事項および免責事項※
1.この拡張機能およびアプリケーションのインストールや利用により発生するいかなる事故・損害について当方は一切責任を負いません。
2.このアプリの著作権は当方に帰属いたしますが、中身はバックグラウンドページやGitHubからご自由にご覧下さい。
　　
改善点や不具合、その他ご意見あればご一報下さい。可能な限り対応します。
動作確認をして頂ける方がいらっしゃれば有難いです。
                                

NFC Reader Extension for Win32插件离线安装方法

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

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

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

4.下载 NFC Reader Extension for Win32Chrome插件v1.1.0版本到本地。

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

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