リファレンスマニュアル

NFC モジュール DLL

目次

第１章 関数一覧

第２章 関数仕様
２－１ NFCモジュールDLL関数 ····················································· ２－１i

NFC モジュール DLL リファレンスマニュアル

第１章

第１章関数一覧

関数一覧

関 数
ALNFC_Open( )機NFC モジュールをオープンします。

ALNFC_OpenEx( )ALNFC_Close( )NFC モジュールをオープンします。
（RF モード指定）
NFC モジュールをクローズします。

ALNFC_GetCard( )ALNFC_SendCommand( )検出中のカードの情報を取得します。
検出中のカードにコマンド送信します。

ALNFC_GetFirmVersion( )ALNFC_SaveBaudrate( )NFC モジュールのファームウェアバージョンを取得します。
NFC モジュールとの通信ボーレートを検出し、結果を INI ファイルに記録します。

１－１

能NFC モジュール DLL リファレンスマニュアル

第２章

第１章

関数一覧

関数仕様

２－１ NFC モジュール DLL 関数
ALNFC_Open 関数
機能

NFC モジュールをオープンします。

書式

int ALNFC_Open(int ComPort)

引数ComPort

戻り値

ALNFC_ER_OK
ALNFC_ER_OPENDEVICEALNFC_ER_ALREADYOPEN
ALNFC_ER_ER_NFCMODULE
ALNFC_ER_CREATEOBJECT
ALNFC_ER_SAVEBAUDRATE

説明

NFC モジュールをオープンし、NFC 無線通信を開始します。

：COM ポート番号：正常：COM ポートが使用できない状態にあります：すでにオープンしています：NFC モジュールが応答しません：ソフトウェアオブジェクトの生成に失敗しました：ボーレートの保存に失敗しました

COM ポート番号で指定した COM ポートを使用します。
DLL と同一フォルダにある「ALNFC.ini」を読込み、「ALNFC.ini」に記述されたボーレートでNFC モジュールと通信を開始します。
「ALNFC.ini」がない場合は、ボーレート検出処理を行い、「ALNFC.ini」ファイルに結果を保存したのち、NFC モジュールと通信を開始します。
NFC モジュールとの通信が開始されると、NFC モジュールは無線通信を開始します。
無線通信は NFC-A、NFC-B、NFC-F、ISO15693 に対応します。
この関数が正常終了すると、NFC モジュール DLL の他の関数を使用することができるようになります。
（ALNFC_SaveBaudrate 関数は除きます。
）

２－１

NFC モジュール DLL リファレンスマニュアル

第１章

関数一覧

ALNFC_OpenEx 関数
機能

NFC モジュールをオープンします。（RF モード指定）

書式

int ALNFC_OpenEx(int ComPort, UCHAR RfMode)引数

ComPort
RfMode：COM ポート番号：RF モード指定
ビット
RF モード
D0
D1

NFC-A
NFC-B

D2
D3

NFC-F
ISO15693

戻り値ALNFC_ER_OK
ALNFC_ER_OPENDEVICEALNFC_ER_ALREADYOPEN
ALNFC_ER_ER_NFCMODULE
ALNFC_ER_CREATEOBJECT
ALNFC_ER_SAVEBAUDRATE：正常：COM ポートが使用できない状態にあります：すでにオープンしています：NFC モジュールが応答しません：ソフトウェアオブジェクトの生成に失敗しました：ボーレートの保存に失敗しました

説明

NFC モジュールをオープンし、RF モードで指定した無線通信のみで NFC 無線通信を開始します。
COM ポート番号で指定した COM ポートを使用します。
DLL と同一フォルダにある「ALNFC.ini」を読込み、「ALNFC.ini」に記述されたボーレートでNFC モジュールと通信を開始します。
「ALNFC.ini」がない場合は、ボーレート検出処理を行い、「ALNFC.ini」ファイルに結果を保存したのち、NFC モジュールと通信を開始します。
NFC モジュールとの通信が開始されると、NFC モジュールは無線通信を開始します。
無線通信は RF モードで指定した無線通信のみに対応します。
この関数が正常終了すると、NFC モジュール DLL の他の関数を使用することができるようになります。

２－２

NFC モジュール DLL リファレンスマニュアル

第１章

関数一覧

ALNFC _Close 関数
機能

NFC モジュールをクローズします。

書式

int ALNFC_Close(void)

引数なし

戻り値

ALNFC_ER_OK
ALNFC_ER_NOTOPEN

説明

NFC モジュールをクローズし、NFC 無線通信を停止します。
NFC モジュールは NFC 無線通信を停止します。NFC モジュールとの通信を終了し、COM ポートをクローズします。

：正常：オープンされていません

２－３

NFC モジュール DLL リファレンスマニュアル

第１章

ALNFC_GetCard 関数
機能

検出中カードの情報を取得します。

書式

int ALNFC_GetCard(ALNFC_CARDINFO* pCardInfo)

引数pCardInfo：カード情報を格納するポインタ

ALNFC_CARDINFO
typedef struct {UCHAR
CardType;
UCHAR
TagType;
UCHAR
IdSize;Char
Id[256];} FPGATIMER_CONFIG, *PFPGATIMER_CONFIG;
CardType

TagType

IdSizeId：カードタイプ
値0

カードタイプ
NFC-A

12

NFC-B
NFC-F

3ISO15693：タグタイプ
値0タグタイプ
TYPE1 TAG

12

TYPE2 TAG
TYPE3 TAG

34TYPE4 TAG
TYPE5 TAG

：ID サイズ：ID

戻り値

ALNFC_ER_OK
ALNFC_ER_NOTOPEN
ALNFC_ER_ER_NFCMODULE
ALNFC_ER_NOCARD：正常：オープンされていません：NFC モジュールが応答しない：カードが存在しない

説明

検出中のカードの情報を取得します。
検出中のカードが存在しない場合は、[ALNFC_ER_NOCARD]を返します。

２－４関数一覧

NFC モジュール DLL リファレンスマニュアル

第１章

ALNFC_SendCommand 関数
機能検出中のカードにコマンド送信します。

書式

int ALNFC_SendCommand(
UCHAR* pCmdData,
int
CmdDataLen,
UCHAR* pResData,
int
ResDataLen,
int*pResRetLen)

引数

pCmdData
CmdDataLen
pResDataLen
ResDataLen
ResRetLen

戻り値

AL_ER_OK
AL_ER_NOTOPEN
ALNFC_ER_ER_NFCMODULE
ALNFC_ER_NOCARD

説明

検出中のカードにコマンド送信します。
検出中のカードにコマンドを送信し、受信したレスポンスデータを取得します。
検出中のカードが存在しない場合は、[ALNFC_ER_NOCARD]を返します。

：コマンドデータを格納するポインタ：コマンドデータバッファサイズ：レスポンスデータを格納するポインタ：レスポンスデータバッファサイズ：実際に取得したレスポンスデータのサイズ：正常：オープンされていません：NFC モジュールが応答しない：カードが存在しない

２－５

関数一覧

NFC モジュール DLL リファレンスマニュアル

第１章

ALNFC_GetFirmVersion 関数
機能

ファームウェアバージョンを取得します。

書式

int ALNFC_GetFirmVersion(USHORT* pFirmVersion)

引数

pFirmVersion

戻り値

AL_ER_OK
AL_ER_NOTOPEN

説明

オープンに成功した NFC モジュールのバージョンを取得します。

：ファームウェアバージョンを格納するポインタ：正常：オープンされていません

２－６

関数一覧

NFC モジュール DLL リファレンスマニュアル

第１章

関数一覧

ALNFC_SaveBaudrate 関数
機能

NFC モジュールとの通信ボーレートを検出し、INI ファイルに保存します。

書式

int ALNFC_SaveBaudrate (int ComPort)引数

ComPort

戻り値

AL_ER_OK
ALNFC_ER_OPENDEVICEALNFC_ER_ALREADYOPEN
ALNFC_ER_ER_NFCMODULE
ALNFC_ER_CREATEOBJECT
ALNFC_ER_SAVEBAUDRATE

説明

NFC モジュールとの通信ボーレートを検出し、INI ファイルに保存します。
NFC モジュールをオープン中は使用できません。

：COM ポート番号：正常：COM ポートが使用できない状態にあります：すでにオープンしています：NFC モジュールが応答しません：ソフトウェアオブジェクトの生成に失敗しました：ボーレートの保存に失敗しました

COM ポート番号で指定した COM ポートを使用します。
D ボーレート検出処理を行い、DLL と同一フォルダにある「ALNFC.ini」ファイルに結果を保存します。既に「ALNFC.ini」が存在する場合は、検出結果で上書きします。

２－７

このリファレンスマニュアルについて(１)本書の内容の一部または全部を当社からの事前の承諾を得ることなく、無断で複写、複製、掲載することは固くお断りします。
(２)本書の内容に関しては、製品改良のためお断りなく、仕様などを変更することがありますのでご了承下
さい。
(３)本書の内容に関しては万全を期しておりますが、万一ご不審な点や誤りなどお気付きのことがございま
したらお手数ですが巻末記載の弊社もしくは、営業所までご連絡下さい。その際、巻末記載の書籍番号も併せてお知らせ下さい。

７７ＣＭ３００１０Ａ

２０１８年

５月

初版

株式会社アルゴシステム
本社〒５８７－００２１ 大阪府堺市美原区小平尾６５６番地

ホームページＴＥＬ（０７２）３６２－５０６７
ＦＡＸ（０７２）３６２－４８５６

http://www.algosystem.co.jp/