Windows x64 には、felicalib ver 0.4 から対応しています。
なお、ver 0.4.3 からは x64ネイティブアプリからも利用できるようになる予定です。
felicalib は Windows x64 環境で動作しますが、x86(32bit)アプリケーションのみに対応し、 x64 アプリケーションには対応しません。
このため、felicalib を使用するアプリケーションは必ず x86 を指定してビルドしてください。 x64 環境では、アプリケーションは WOW64 上で動作することになります。
この理由は、FeliCaポートソフトウェア自体が提供する felica.dll が x86 版しかないからです。
C# など、.NET アプリケーションをビルドするときは、ターゲットプラットフォームを "Any CPU" ではなく x86 限定にしておかなければなりません。Any CPU でビルドした アプリケーションを x64 環境で実行しても、felicalib.dll をロードできません。
]]>IO-DATA の USB2-NFCには、現行の felicalib は対応していません。 USB2-NFC にアクセスするための方法は PaSoRi とは違うようです。
ですが、USB2-NFC には、felicatonfc.dll という API ラッパ DLL があります(USB2-NFC版EdyViewer に付属)。 これを使えば、felicalib から USB2-NFC にアクセスできるようになるはずです。
このため、以下の API を追加予定です (Subversion にはコミット済み)
pasori * pasori2_open(TCHAR *dllpath) pasori をオープンする。dllpath には、デバイスにアクセスするための DLL のpathを指定する。 ここに felicatonfc.dll のパスを指定すれば、USB2-NFC にアクセスできる。
注意点: felicatonfd.dll には、polling_and_request_system_code など一部 API が欠けています。 このため、FelicaDump は動作しません。ID 読み取りとか、普通のブロックリードなどは動作するはずです。
]]>felicalib の Wiki です。
felicalib 0.2 を公開しました(2007/11/10)
あと、Edy とか Suica とか nanaco の読み込み用の API もあると便利？
以下の情報は、でんのすけさんにいただいた情報、および guisaの実装(page3.nifty.com/slokar/pasori/gsuica)をベースにしています。
Suica/ICOCA/PiTaPa/PASMO/TOICA は基本的に同じフォーマットです。 Suica には入出場記録と履歴の２つのサービスコードがある。以下の説明は履歴のほうのみ。サービスコードは 0x090f。 (なお、IruCa はシステムコードが 0xde80 に変わるが、フォーマットは基本的に Suica 系と同じ)
各エントリは１６バイト。フォーマットは以下の通り。
残高だけ little endian なので注意。
なお、物販とバスの場合、以下のようにフォーマットが変わる。
端末種の値は以下の通り
処理の値は以下の通り
http://www.denno.net/SFCardFan/ にあるサイバネ駅コードデータベースで調べられる。
端末種が 0xc7, 0xc8, 0x05 以外の場合。
駅名については地区コード(AreaCode)、線区コード(LineCode)、駅順コード(StationCode)から調べる。 ここで、地区コードは以下のように求める。
端末種が 0xc7, 0xc8 の場合。
店舗については、エリア(AreaCode)、端末(TerminalCode)、線区(LineCode)、駅順(StationCode)の４バイトで検索する。 エリアコードは 1:Suica/PASMO, 2:ICOCA, 4:IruCa となっている。しかし、履歴にはエリアコードは記録されておらず、 さらに Suica/PASMO 間でコード重複があるので、100% 確実に店舗名を知ることは不可能。
端末種が 0x05 の場合。
このときは、線区/駅順をキーに IruCa停留所コードテーブルを見れば良い。
]]>QUICPay ID は、SystemCode 04C1, ServiceCode 100B に書かれている。 10バイト、HEX。
履歴が入っているかどうかは不明。
]]>システムコード 0x00fe, サービスコード 0x680b に履歴情報がある。 履歴は３件。ややこしいことに、履歴１つに対して２ブロック(32バイト)となっている。
カード番号はサービスコード 0x67cf、ブロック番号0より、13バイト目から８バイトに渡り入っている。
履歴情報(32バイト)の構成は以下の通り(数値はオフセット)
データが思いっきり詰め込まれてるので読みにくい。。。 下のビット割り当てを参照のこと。
7 6 5 4 3 2 1 0
+-+-+-+-+-+-+-+-+
18 | year? |month|
+-+-+-+-+-+-+-+-+
19 | | day | ho|
+-+-+-+-+-+-+-+-+
20 |ur | minutes |
+-+-+-+-+-+-+-+-+
21 | | value |
+-+-+-+-+-+-+-+-+
22 | value |
+-+-+-+-+-+-+-+-+
23 |value| outgo |
+-+-+-+-+-+-+-+-+
24 | outgo |
+-+-+-+-+-+-+-+-+
25 | outgo |incom|
+-+-+-+-+-+-+-+-+
26 | income |
+-+-+-+-+-+-+-+-+
27 | income | |?|
+-+-+-+-+-+-+-+-+
28 |???| |
+-+-+-+-+-+-+-+-+
]]>
システムコード FE00。
nanaco ID はサービスコード 0x558b に入っている。 先頭８バイトに ID が BCD エンコードでそのまま入っている。
履歴は、サービスコード 564F に入っている。１ブロック=１履歴。 各ブロックの内容は以下の通り。
値は全て Big Endian で格納されている。
日付と時刻は4バイトあり、MSB 側からビットが切られている。
例えば、00F5F49B の場合、7年 10月 31日 18時 27分となる。 (年が本当に 11bit もあるのかは不明)
]]>サービスコードは 0x1317。
各ブロック(16バイト) のフォーマットは以下のとおり。
エンディアンはすべてビッグエンディアン。金額の値は常に正。
日付のフォーマットはちょっと面倒。まず上位15bitに日付が入る。これは 2000/1/1からの経過日数。(なので、2089年くらいまでしか表現できない)
時刻は下17bit に入っている。これは0時0分からの経過秒数となっている。
]]>C/C++ から felicalib を利用するには以下のようにします。 どちらでもお好きな方法で。
API については、http://felicalib.tmurakam.org/refdoc/ を見てください。
まず、felialib.h を #include してください。 そして felicalib.lib (インポートライブラリ) を一緒にリンクします。
実行プログラムを同じディレクトリに felicalib.dll を置いて実行してください。
felicalib.h, felicaint.h, felicalib.c をあなたのプログラムと一緒に コンパイル、リンクしてください。この場合、felicalib.dll は必要ありません。
]]>PInvoke 経由で felicalib.dll を使用するライブラリを添付してあります。
src/CSharp ディレクトリにあるFelicaLib.cs ファイルをプロジェクトに追加して利用してください。 felicalib.dll を実行プログラムを同じディレクトリにおいて実行してください。
以下にサンプルを示します。これは nanaco の履歴をダンプするもの。
using System;
using System.Collections.Generic;
using System.Text;
using FelicaLib;
namespace FelicaLib
{
public class Nanaco
{
public static void Main()
{
try
{
using (Felica f = new Felica())
{
readNanaco(f);
}
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
}
private static void readNanaco(Felica f)
{
f.Polling((int)SystemCode.Common);
byte[] data = f.ReadWithoutEncryption(0x558b, 0);
if (data == null)
{
throw new Exception("nanaco ID が読み取れません");
}
Console.Write("Nanaco ID = ");
for (int i = 0; i < 8; i++) {
Console.Write(data[i].ToString("X2"));
}
Console.Write("\n");
for (int i = 0; ; i++)
{
data = f.ReadWithoutEncryption(0x564f, i);
if (data == null) break;
switch (data[0])
{
case 0x47:
default:
Console.Write("支払 ");
break;
case 0x6f:
Console.Write("チャージ ");
break;
}
int value = (data[9] << 24) + (data[10] << 16) + (data[11] << 8) + data[12];
int year = (value >> 21) + 2000;
int month = (value >> 17) & 0xf;
int date = (value >> 12) & 0x1f;
int hour = (value >> 6) & 0x3f;
int min = value & 0x3f;
Console.Write("{0}/{1:D2}/{2:D2} {3:D2}:{4:D2}", year, month, date, hour, min);
value = (data[1] << 24) + (data[2] << 16) + (data[3] << 8) + data[4];
Console.Write(" 金額 {0,6}円", value);
value = (data[5] << 24) + (data[6] << 16) + (data[7] << 8) + data[8];
Console.Write(" 残高 {0,6}円", value);
value = (data[13] << 8) + data[14];
Console.WriteLine(" 連番 {0}", value);
}
}
}
}
]]>