スマホでDESFireカードにNDEFレコードが表示されない理由
DESFireカードは、最初からNDEFタグとして使える状態のものではなく、いわば道具箱です。スマホが期待するレイアウト、読み取り結果が空になる理由、ご自身のカードでの直し方を解説します。
結論
スマホにNDEFレコードが表示されないのは、スマホが探すレイアウトでカードにNDEFデータが入っていないためです。MIFARE DESFireカードは、アプリケーションとファイルを収めた道具箱のようなものです。誰かがNDEFタグとして設定して、はじめてNDEFタグのように見えます。このガイドは、プロジェクト用に購入した未使用のDESFireなど、ご自身が所有するカードを対象としています。
スマホに何も表示されない理由
DESFire EV1はNFC Forum Type 4フォーマットと互換性がありますが、設定を済ませるまではNDEFアプリケーションを持っていません。WakDevのDESFire EV1に関するメモによると、NFC ToolsでNDEFを読み書きするには、まずカードをType 4としてフォーマットする必要があります。
入退室管理や交通機関など別の用途のために作られたカードは、独自のアプリケーションを持ち、NDEFアプリケーションは持っていません。スマホはカードを検出しますが、メッセージとして解析できるものが見つかりません。各プラットフォームでこれらのカードに何ができて何ができないかは、iPhoneとAndroidでDESFireカードから読み取れる内容をご覧ください。
スマホで読めるレイアウトとは
Dangerous Thingsフォーラムのスレッドにあるコミュニティの一例から、構成要素を見てみましょう。
- AIDが
000001、DF名がD2760000850101(標準のNDEFアプリケーション名)のアプリケーション。 - ISO IDが
E103で15バイトのファイル01:capability container(CC)。 - ISO IDが
E104で2000バイトのファイル02:NDEFファイル本体。 - 読み取りにキーが不要な、フリーアクセス権限。
スマホはNDEFアプリケーションを選択し、CCを読み、どのファイルにメッセージがあるかを把握してから、そのファイルを読みます。どこかの手順が欠けると、読み取り結果は空になります。
よくある原因
capability containerがない
libfreefareのリファレンス用リーダーコードは、CCの中からNDEF File Control TLV(タグ04)を解析して、NDEFファイルとその最大サイズを調べます。前述のフォーラムのスレッドでは、NDEFレコードが機能するようになる前に、CCファイルを書き込む必要がありました。
長さが間違っている、またはゼロ
NDEFファイルの先頭2バイトはメッセージの長さで、NLENと呼ばれます。libfreefareのリーダーは、まずこの2バイトを読み、長さに2を足した値が最大サイズを超えていれば処理を止め、そうでなければその長さ分のバイトを読みます。長さがゼロなら空のメッセージとなり、長さが誤っていれば読み取りは失敗します。
メッセージの形式が不正
同じスレッドでは、短いテスト用ペイロードはNFC Toolsで問題なく読めたのに、長いペイロードは読めなかったという報告がありました。これはカードの設定ではなく、メッセージのバイト列に原因があることを示しています。レコードヘッダー、ペイロード長、NLENの値が互いに整合しているか確認してください。
古いカードでは識別子が異なる
Version 0のDESFireタグは、EV1以降とは異なる識別子を使います。libfreefareのリーダーは、version 0ではAID 0xEEEE10とCCファイル0x03を、それ以外ではAID 0x000001とCCファイル0x01を使います。一方のレイアウト向けに作られたツールは、もう一方を見落とすことがあります。
バージョンとiPhoneの癖
iPhoneでは、アプリのInfo.plistにCore NFC用のアプリケーションIDを記載できます。Appleのエンジニアは開発者フォーラムの回答で、D2760000850101を記載するとシステムがそのタグをISO 7816として扱うと説明しています。記載しない場合はNFCMiFareTagとして扱われ、ネイティブコマンドはsendMiFareCommandを通して送ります。アプリを開発する場合は、カードとのやり取りの方法に合ったモードを選んでください。カードの世代を選ぶ際は、DESFire EV2とEV3の違いも参考になります。
直し方
- カードの中身を確認します。NFCoreのような生のタグデータを表示するリーダーアプリを使うと、スマホがNDEFを認識しているかどうかがわかります。
- DESFire対応のツールでカードをType 4としてフォーマットします。通常、カードのキーが必要です。出荷時の未使用カードであれば、たいていデフォルトキーが使われています。他人のシステム用にキーが設定されたカードは、ご自身で再フォーマットしてよいものではありません。
- まず数文字のテキストなど、短いテストメッセージを書き込みます。それが読めたら、より長いペイロードに進みます。
- 長いメッセージで失敗する場合は、NLEN、レコードヘッダー、CCが互いに整合しているか確認します。
この作業はご自身が所有するカードにのみ行ってください。交通機関、勤務先、ビルなどのカードを再フォーマットしても機能せず、試すべきことでもありません。
まとめ
DESFireカードでNDEFの読み取り結果が空になるのは、ほとんどの場合、NDEFレイアウトがないか不完全なためで、カードが壊れているわけではありません。NDEFアプリケーション、CCファイル、NDEFファイル、正しい長さの順に確認し、短いメッセージでテストしてください。
よくある質問
スマホにNDEFレコードが表示されないのは、DESFireカードが壊れているからですか?
たいていは違います。多くのDESFireカードは入退室管理や交通機関向けに出荷され、独自のアプリケーションを持ち、NDEFアプリケーションは持っていません。スマホが失敗しているのではなく、スマホが探すレイアウトにNDEFデータがないだけです。
NTAGのシールのように、DESFireカードにURLをそのまま書き込めますか?
そのままではできません。NTAGはメモリマップが固定されていますが、DESFireは先にアプリケーションとファイルを作成する必要があります。カードをType 4としてフォーマットするツールがその手順を行ってくれますが、カードのキーが必要です。
短いテストメッセージは読めるのに、長いメッセージは読めないのはなぜですか?
カードの設定ではなく、メッセージのバイト列に原因があると考えられます。あるコミュニティの事例では、短いテスト用ペイロードは問題なく読めたのに長いものは読めませんでした。これは、長さの誤りかメッセージの形式不正に当てはまります。