ホーム>プログラミング関連>C# ソースコード
ダウンロード 
 *-
* Free/Libre Near Field Communication (NFC) library
*
* Libnfc historical contributors:
* Copyright (C) 2009      Roel Verdult
* Copyright (C) 2009-2015 Romuald Conty
* Copyright (C) 2010-2012 Romain Tartière
* Copyright (C) 2010-2013 Philippe Teuwen
* Copyright (C) 2012-2013 Ludovic Rousseau
* Additional contributors:
* See AUTHORS file
-*

一般情報

libnfc は、ユーザー空間アプリケーションが NFC デバイスにアクセスできるようにするライブラリです。

公式 Web サイトは次のとおりです: http://www.nfc-tools.org/

公式フォーラム サイトは次のとおりです: http://www.libnfc.org/community/

公式開発サイトは次のとおりです: https://github.com/nfc-tools/libnfc

重要な注意事項: このファイルは POSIX システムを対象としています。Windows の場合は、README-Windows.md をお読みください。

要件

一部の NFC ドライバーはサードパーティ ソフトウェアに依存します。

  • pn53x_usb および acr122_usb:

    • libusb-0.1 http://libusb.sf.net

  • acr122_pcsc:

    • pcsc-lite https://pcsclite.apdu.fr/

  • 個数:

    • PCSC ドライバーを使用したビルドをサポートします。互換性のあるすべてのリーダーを使用できます。Feitian R502 および bR500 はすでにテストに合格しています。

回帰テスト スイートはカッター フレームワークに依存します: http://cutter.sf.net

建物

注: リポジトリの git clone から直接作業する場合、一部のファイルを最初に生成する必要があります。これを行うには、 autoreconf -vis実行します。

あるいは、パッケージ化されたリリースの .tar.bz2 バージョン (./configure がすでに含まれています) を使用します: https://github.com/nfc-tools/libnfc/releases/

ビルドは次のコマンドを実行するだけで簡単になります。 

 ./configure
make

特定のドライバーを使用してビルドするには、 ./configure --helpで詳しく説明されているオプション--with-drivers=...を参照してください。

インストール

 make install

デバイスを運転するためのアクセス許可をユーザーに付与する必要がある場合があります。 GNU/Linux システムでは、udev を使用する場合、提供されている udev ルールを使用できます。例: Debian、Ubuntu など。 

 sudo cp contrib/udev/93-pn53x.rules /lib/udev/rules.d/

FreeBSD では、devd を使用する場合、ルール ファイル contrib/devd/pn53x.conf もあります。

構成

ライブラリのデフォルトの動作を変更するために、libnfc は sysconfdir にある設定ファイル (./configure に提供されるもの) を使用します。

コメント付きファイルのサンプルはソースにあります: libnfc.conf.sample

以下を使用してコンパイルした場合: 

 ./configure --prefix=/usr --sysconfdir=/etc

構成ディレクトリを作成し、サンプル ファイルをコピーできます。 

 sudo mkdir /etc/nfc
sudo cp libnfc.conf.sample /etc/nfc/libnfc.conf

複数のデバイスを構成するには、libnfc.conf を変更するか、nfc/devices.d ディレクトリにデバイスごとにファイルを作成します。 

 sudo mkdir -p /etc/nfc/devices.d
printf 'name = "My first device"nconnstring = "pn532_uart:/dev/ttyACM0"n' | sudo tee /etc/nfc/devices.d/first.conf
printf 'name = "My second device"nconnstring = "pn532_uart:/dev/ttyACM1"n' | sudo tee /etc/nfc/devices.d/second.conf

環境変数

次の環境変数を使用して、実行時に特定の構成オプションをオーバーライドできます。

  • LIBNFC_DEFAULT_DEVICE= : LIBNFC_DEFAULT_DEVICE=pn532_uart:/dev/ttyACM0は、/dev/ttyACM0 上の pn532 をデフォルトのデバイスとして使用します
  • LIBNFC_DEVICE=構成ファイル内のすべてのデバイスを無視し、変数で定義されたデバイスのみを使用します。
  • LIBNFC_AUTO_SCAN=構成ファイルのallow_autoscanオプションをオーバーライドします。
  • LIBNFC_INTRUSIVE_SCAN=構成ファイルのallow_intrusive_scanオプションをオーバーライドします。
  • LIBNFC_LOG_LEVEL=<0|1|2|3>構成ファイルのlog_levelオプションをオーバーライドします。

認識されたデバイスの connstring を取得するには、 nfc-scan-device使用できます。 LIBNFC_AUTO_SCAN=true nfc-scan-device見つかったすべてのデバイスの名前と connstring を表示します。

バグを報告する方法

バグを報告するには、https://github.com/nfc-tools/libnfc/issues にアクセスし、バグ報告フォームに記入してください。

質問や意見がある場合は、開発者コミュニティに投稿することをお勧めします: http://www.libnfc.org/community

必ず次の内容を含めてください。

  • libnfcのバージョン

  • システムに関する情報。例えば：

    • オペレーティング システムとバージョン
    • Linux の場合、C ライブラリのバージョン

    その他、関連すると思われるものは何でも。

  • デバッグがアクティブ化されたトレース。

    デバッグでバグを再現します。たとえば、次のような場合です。 

      $ nfc-list -v

    次のように実行します。 

      $ LIBNFC_LOG_LEVEL=3 nfc-list -v

  • バグを再現する方法。

    動作を示す短いテスト プログラムを含めてください。

    最後の手段として、より大きな部分へのポインタを提供することもできます。

    ダウンロードできるソフトウェアのこと。

  • バグがクラッシュだった場合、出力された正確なテキスト

    クラッシュが発生したとき。

  • スタック トレースなどの詳細情報も役立つ場合がありますが、

    必要ありません。

パッチ

パッチは https://github.com/nfc-tools/libnfc/issues に投稿できます。

パッチでバグが修正される場合は、通常、「バグを報告する方法」に記載されているすべての情報を含めることをお勧めします。

トラブルシューティング

タッチタグ/ACR122:

Touchatag または ACR122 デバイスが libnfc によって検出されない場合は、PCSC-lite デーモン ( pcscd ) がインストールされ、実行されていることを確認してください。

Touchatag または ACR122 デバイスが PCSC-lite デーモンによって検出されない場合 ( pcsc_scan何も表示しない)、libccid の偽のファームウェア検出を削除してみてください。 libccid_Info.plist 構成ファイル (通常は/etc/libccid_Info.plist ) を編集し、 ifdDriverOptions 、 0x0000の値を0x0004偽のデバイスを許可し、pcscd デーモンを再起動します。

ACR122:

libnfc を備え、タグなしで ACR122 デバイスを使用する場合 (NFCIP モードまたはカード エミュレーションを使用する場合など)、さらに別の PCSC-lite 調整が必要です。CCID Exchange コマンドの使用を許可する必要があります。これを行うには、 libccid_Info.plist構成ファイル (通常は/etc/libccid_Info.plist ) を編集してifdDriverOptionsを見つけ、 0x0000値を0x0001に変更して CCID 交換を許可するか、 0x0005に変更して許可します。 CCID と偽のデバイスを交換し (前のコメントを参照)、pcscd デーモンを再起動します。

警告: ACS CCID ドライバー (acsccid) を使用する場合、構成ファイルは/usr/lib/pcsc/drivers/ifd-acsccid.bundle/Contents/Info.plistのような場所にあります。

SCL3711:

Libnfc は、SCL3711 の PCSC 独自ドライバーと同時に使用することはできません。考えられる解決策は 2 つあります。

  • SCL3711ドライバーをまったくインストールしていないかのどちらかです
  • または、libnfc ベースのツールを使用する場合は、PCSC デーモンを停止します。

Linux 3.1 以上の PN533 USB デバイス:

Linux カーネル バージョン 3.1 以降、libnfc を使用するには、いくつかのカーネル モジュール (「nfc」、「pn533」、および「pn533_usb」) をロードする必要があります。カーネルがこれらのモジュールを自動的にロードしないようにするには、modprobe conf ファイルでそれらのモジュールをブラックリストに登録します。このファイルは libnfc アーカイブ内で提供されます。 

 sudo cp contrib/linux/blacklist-libnfc.conf /etc/modprobe.d/blacklist-libnfc.conf

フェイティアン bR500 および R502:

Libnfc は、ほとんどの Linux セットアップですでに利用可能な bR500 および R502 の PCSC 独自ドライバーで動作します。 PCSC サポートを有効にするには: ./configure --with-drivers=pcsc 。機能することが知られているリーダー:

  • フェイティアン bR500
  • Feitian R502 デュアル インターフェイス リーダー
  • Feitian R502 CL(非接触) リーダー

これらのリーダーは v1.4.25 以降 CCID によってサポートされています。CCID ドライバーのバージョンが 1.4.25 以上であることを確認してください。

MacOS では、次のコマンドを使用して CCID バージョンを確認でき、必要に応じて https://github.com/martinpaljak/osx-ccid-installer/releases から最新の CCID ドライバーをインストールできます。 

 grep -A 1 CFBundleShortVersionString /usr/local/libexec/SmartCardServices/drivers/ifd-ccid.bundle/Contents/Info.plist

Linux では、次のコマンドを使用して CCID バージョンを確認でき、必要に応じて https://ccid.apdu.fr/ から最新の CCID ドライバーをインストールできます。 

 grep -A 1 CFBundleShortVersionString /usr/lib/pcsc/drivers/ifd-ccid.bundle/Contents/Info.plist

独自のメモ

FeliCaはソニー株式会社の登録商標です。 MIFARE は NXP Semiconductors の商標です。 Jewel Topaz は Innovision Research & Technology の商標です。その他すべての商標は、それぞれの所有者の財産です。

拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて