abc SAM ライブラリマニュアル このマニュアルは、SAM ライブラリの 仕様について記載します。 Ver. 1.
ご注意 ● このソフトウェアおよびマニュアルの、一部または全部を無断で使用、複製することはできません。 ● このソフトウェアおよびマニュアルは、本製品の使用許諾契約書のもとでのみ使用することができます。 ● このソフトウェアおよびマニュアルを運用した結果の影響については、一切の責任を負いかねますのでご了 承ください。 ● このソフトウェアの仕様、およびマニュアルに記載されている事柄は、将来予告なしに変更することがありま す。 ● このマニュアルの著作権はカシオ計算機株式会社に帰属します。 ● 本書中に含まれている画面表示は、実際の画面とは若干異なる場合があります。予めご了承ください。 © 2014 カシオ計算機株式会社
目次 1. 概要 ··················································································································································································· 1 1.1 概要 ··········································································································································································· 1 1.
1. 概要 1.1 概要 SAM（Secure Application Module）ライブラリは、SAM スロットに挿入した SAM カードとの通信を行う関数 を提供します。 1.2 動作環境 1.2.1 対象機種 V-T500/V-N500 1.2.2 対象OS Android 4.0 (API level 15) 1.2.3 プログラミング言語 Java (JDK コンパイラー準拠レベル 16) 1.2.
1.2.5 必要なソフトウェア 以下のソフトウェアが必須となります。 • Java SE Development Kit 6u31 • Eclipse 3.7 (Indigo) • Android SDK r18 • ADT Plugin for Eclipse 15.0.
2. ライブラリ 2.1 Package名称 jp.casio.vx.faramework.sam 2.
2.2.
2.2.
2.2.
2.2.
2.2.5 powerUpCard 本関数は、カードスロット内の SAM カードの電源を ON にし、SAM カードを通信可能状態にします。 boolean powerUpCard( int slotnumber, int voltage ) 解説 カードスロット内の SAM カードの電源を ON にし、SAM カードを通信可能状態にします。 パラメータ slotnumber SAM カードスロットの番号を指定します。1 を指定してください。 voltage 挿入した SAM カードに入れる電源の電圧を指定します。 SAM_POWER_ISO : 1.8V、3V、5V の順で電源 ON にし、最初に応答のあった電圧で電 源 ON SAM_POWER_18V : 1.
2.2.
2.2.
SAM_NOT_DEVICE SAM_POF SAM_PRM SAM_ERROR_NOCARD SAM_ERROR_TIMEOUT SAM_ERROR_SUSPEND SAM_NOT_ACTIVATION SAM_ERROR_RESPONSE FUNCTION_UNSUPPORT : SAM ドライバエラー DeviceEmulator では発生しません : 未オープンエラー : パラメータエラー : SAM カード未挿入エラー DeviceEmulator では発生しません : タイムアウトエラー DeviceEmulator では発生しません : 本体 OFF 発生エラー DeviceEmulator では発生しません : カード未起動エラー : SAM カード異常応答発生エラー DeviceEmulator では発生しません : 関数未サポート 補足 戻り値の SAM_OK は、SAM カードとの通信の正常終了を表すものであり、指定したコマンド自身の正 常終了を表すものではありません。コマンド自身の結果については、応答情報に格納しているコマンド の実行結果を確認してください。 補足 エミュレーター上
2.2.
[TS] 開始キャラクタ（必須） [T0] 構成表示キャラクタ（必須） 上位 4bit :TD(1)～TA(1)の有無を符号化 下位 4bit :管理情報バイトの個数（0～15） 接続情報キャラクタ（任意） 共通、Fi / Di を符号化 ああ [TA(1)] ああ [TB(1)] ああ [TC(1)] ああ [TD(1)] ああ [TA(2)] ああ [TB(2)] ああ [TC(2)] ああ [TD(2)] ああ [TA(3)] （省略） [T1] （省略） [TK] 共通、Ii / Pi を符号化 共通、N を符号化 TD(2)～TA(2)の有無と T を符号化 共通、Fi / Di を符号化 共通、Pi2 を符号化 固有 TD(2)～TA(2)の有無と T を符号化 T≠15 のとき伝送プロトコルパラメータ、T=15 のとき IC パラメータ 管理情報キャラクタ（任意） （最大 15 キャラクタ） [TCK] 検査キャラクタ TD(1)が存在しないとき TCK は存在してはならない ※ ATR 応答情報の詳細については ISO7816 の規格書を参照してください size SAM カ
SAM_PRM SAM_ERROR_NOCARD SAM_NOT_ACTIVATION FUNCTION_UNSUPPORT : パラメータエラー : SAM カード未挿入エラー DeviceEmulator では発生しません : SAM カード未起動エラー : 関数未サポート 補足 エミュレーター上では、本関数は open 済、かつ電源 ON のチェックのみを行います。open が呼び出 されていない状態で本関数を呼び出す、もしくは SAM カードの電源が ON になっていない状態で呼 び出されると、false を返します。それ以外は true となります。 14
2.2.
SAM_ERROR_TIMEOUT SAM_ERROR_SUSPEND SAM_ERROR_RESPONSE FUNCTION_UNSUPPORT : タイムアウトエラー DeviceEmulator では発生しません : 本体 OFF 発生エラー DeviceEmulator では発生しません : SAM カード異常応答発生エラー DeviceEmulator では発生しません : 関数未サポート 補足 エミュレーター上では、本関数は open 済、かつ電源 ON のチェックのみを行います。open が呼び出 されていない状態で本関数を呼び出す、もしくは SAM カードの電源が ON になっていない状態で呼 び出されると、false を返します。それ以外は true となります。 16
カシオ計算機お問い合わせ窓口 製品に関する最新情報 ●製品サポートサイト（カシオペア・ハンディターミナル） http://casio.
