1. はじめに本書は弊社 UHF 920MHz 帯リーダライタ ( 以下リーダライタとします ) を使用しソフトウエア開発を行なうための開発情報について説明するものです Windows Microsoft Visual Studio Microsoft Visual C++.NET M

Size: px

Start display at page:

Download "1. はじめに本書は弊社 UHF 920MHz 帯リーダライタ ( 以下リーダライタとします ) を使用しソフトウエア開発を行なうための開発情報について説明するものです Windows Microsoft Visual Studio Microsoft Visual C++.NET M"

せいごろうのえ
5 years ago
Views:

1 2018 年 4 月 11 日第版株式会社アートファイネックス

2 1. はじめに本書は弊社 UHF 920MHz 帯リーダライタ ( 以下リーダライタとします ) を使用しソフトウエア開発を行なうための開発情報について説明するものです Windows Microsoft Visual Studio Microsoft Visual C++.NET Microsoft Visual Basic.NET Microsoft Visual Basic 6.0 Microsoft Visual C#.NET は米国 Microsoft Corp. の登録商標ですその他商品名及び製品名などは一般に各社の商標または登録商標です 2. リーダライタ種別リーダライタは以下の 2 種を用意しております表 2-1 名称使用プロトコル対象機種 ART Finex UHF リーダライタ CB ファミリ ART Finex リーダライタプロトコル UHF 版 [CB ファミリ SP モデル ] UPS-32-J2 UP-100-J2 UP4-100-J2 UP8-100-J2 UP-200-J2 UP4-200-J2 UP8-200-J2 他 [CB ファミリ SU モデル ] UP-1000-J2 UP UP J2 UP J2 UP-250-J2 UP2-250 UP4-250-J2 UP8-250-J2 他 ART Finex UHF リーダライタ f ファミリ URW-SP プロトコル [f ファミリ SP モデル ] URW-SP3 URW-SP4 UP-100f-J2 UC-100f-J2 PRM92J30CE-S UP-200f-J2 他 [f ファミリ SensorTag モデル ] PRM92J30CE-S(2) UCS-200f-J2 UC-200f-J2 1

3 開発情報はインターフェース拡張オプションの有無によって区別できます [CB ファミリ ] : インターフェース拡張オプションが付属されている製品群 [f ファミリ ] : インターフェース拡張オプションがない製品群同一システムで様々なインターフェースをご利用になる場合や将来的なインターフェース拡張を予定している場合には [CB ファミリ ] をお勧め致します組み込み利用など特定のインターフェースでご利用になる場合には [f ファミリ ] をご利用くださいまたインターフェース拡張オプション [CB ファミリ ] をご利用になることにより以下の機能が拡張されます 5 つのインターフェース (RS232C USB LAN 無線 LAN Bluetooth) 製品により標準搭載インターフェースは異なりますリーダライタが自律的に RFID タグ認識変化状態を検知し上位へ通知するタグ移動時通知機能拡張基板の汎用 IO ポート (12 本 ) 製品により利用可能なポート数は異なります UHF 帯アンテナ切替器拡張基板の汎用 IO ポートを利用します LCD 付テンキー機器 ( オプション ) RS-232C ポートに LCD 付テンキー機器を接続可能です 2

4 3. 開発手法開発情報 CD-ROM には以下のものが同梱されていますプロトコル仕様書 Windows 向け開発用ライブラリ (API) 及び仕様書サンプルソース Windows 用サンプルアプリケーションリーダライタを使用したソフトウエア開発の手法としてリーダライタプロトコルを使用した開発手法と Windows 向け開発用ライブラリ (API) を使用した開発手法の二つがあります以下にそれぞれの場合において必要なドキュメント及びツールの説明を記述します 3.1. リーダライタプロトコルを使用した開発手法使用するドキュメント及びツールプロトコル仕様書サンプルアプリケーション (IC タグライタ ) プロトコル仕様書はご利用になるリーダライタによって異なる種類 (URW-SP プロトコル ART Finex リーダライタプロトコル UHF 版 ) の仕様書がございます仕様書にはリーダライタを制御するためのコマンド定義が記載されています URW-SP プロトコル ART Finex リーダライタプロトコル UHF 版には互換性がございませんリーダライタに対応するプロトコルは表 1-1にてご確認くださいそれぞれのコマンドはサンプルアプリケーション (IC タグライタ ) にて確認することができますメイン画面のメニュー [Help]-[Cmd Test] から定義されたコマンドをリーダライタに送信し受信したコマンドが確認できますサンプルアプリケーションは Windows 7 Windows 8/8.1 Windows 10 に対応していますそれ以外の環境で開発される場合はターミナルソフト等を使用してコマンドの確認を行なってください 3

5 3.2. 開発用ライブラリ (API) を使用した開発手法使用するドキュメント及びツール開発用ライブラリ (API) 及び仕様書サンプルソース開発用ライブラリ (API) は定義されている各関数をプログラム内で呼び出すことによりプロトコル仕様書に記載されているコマンド定義を意識することなくリーダライタを制御し RFID タグへのアクセスリーダライタパラメータの設定取得等を行うことができます開発用ライブラリ (API) を使用することでこれらの機能を実装したアプリケーションを容易に開発することができます開発用ライブラリ (API) の関数及びファミリモデル毎の対応非対応につきましては別紙 : 開発用ライブラリ (API) 関数一覧をご参照ください開発用ライブラリ (API) は Visual Studio.NET 2003(Visual C++ Visual C# Visual Basic.NET) 以降 Visual Basic 6.0 で使用することができ Windows 7(32bit/64bit) Windows 8/8.1(32bit/64bit) Windows 10(32bit/64bit) に対応しています 4

6 以下に開発用ライブラリ (API) を使って RFID タグの EPC を取得し表示する簡単な例を示します (C++) TypeCTagID_T tagid[5]; unsigned char Count = 5; int icommno = so_commsetup(255, 1, 19200); if(icommno > 0){ int iresult = su_readtagid_single(icommno, tagid, &Count, 0); if(iresult == OK){ for(int i = 0; i < Count; i++){ for(int j = 0; j < tagid[i].epc_length; j++){ printf("%02x", tagid[i].epc[j]); } printf("\n"); } } so_commdelete(icommno); } また同梱されているサンプルソースは開発用ライブラリ (API) を使った RFID タグの EPC の取得 RFID タグのメモリの読み取り書き込みを行うアプリケーションのソースコード群ですこれらのソースコード群を参照することで実装方法を確認することができますサンプルソースは Visual Studio 2005(Visual C++ Visual C# Visual Basic.NET) Visual Basic 6.0 で作成されたものをそれぞれ同梱しています 4. USB ドライバ USB ドライバは FTDI 社の HP から最新のものをダウンロードしてご利用いただけます Windows 7(32bit/64bit) Windows 8 /8.1(32bit/64bit) Windows 10(32bit/64bit) に対応しておりますまた Linux Mac OS 用の USB ドライバもございます 5

7 5. 開発情報 CD-ROM 同梱アプリケーション開発情報 CD-ROM には以下の Windows 用アプリケーションが同梱されております IC タグライタ RFID2KBD 5.1. IC タグライタ IC タグライタは RFID タグのエンコードリーダライタ設定タグとの通信確認メモリアクセス等リーダライタのほぼ全ての機能が確認できるアプリケーションですまたタグ情報をシステムなどへ取りこむ方法として指定時間間隔でタグの認識状況の変化情報を記載したLOGファイルを生成する機能やタグの認識状況の変化時にファイルを生成する機能などがあります RFID タグのエンコード方法については UHF 帯タグエンコードガイドをご参照ください 5.2. RFID2KBD RFID2KBD は取得した RFID タグの ID をキーボードエミュレートによりテキストエリア等に自動入力するアプリケーションです EXCEL やユーザー様アプリケーションへタグ ID を入力する場合などにご利用いただけます RFID タグの情報がバーコードの標準エンコードデータの場合はデコードした内容をアプリケーションへ渡す事も可能ですキーボードインターフェースバーコードリーダからの置き換えにも利用できます 6

8 6. Android 向け開発情報 USB ホスト機能を有する Android 端末にて USB インターフェースを持つリーダライタを制御することができます Android 向けの場合 FTDI 社の JAVA D2XX for Android API を使用しリーダライタプロトコルを送信関数に渡すことでリーダライタにコマンドを送ることができます Android 向けの開発情報の詳細につきましては Android 搭載ホスト向け開発情報についてをご参照ください以上 7

9 別紙 : 開発用ライブラリ (API) 関数一覧 2018/4/11 開発環境対応 OS 関数一覧 Microsoft Visual Studio.NET 2003 以降 (Visual C++ Visual Basic.NET Visual C#.NET) Microsoft Visual Basic 6.0 Microsoft Windows 7 (32bit/64bit) Microsoft Windows 8/8.1 (32bit/64bit) Microsoft Windows 10 (32bit/64bit) 対応 fファミリ fファミリ CBファミリ CBファミリ No. 関数名説明 SPモデル SensorTag SPモデル SUモデルモデル 1 so_commsetup リーダ接続 2 so_commsetupip リーダ接続 (IP) 3 so_commdelete リーダ切断 4 so_getreaderinformation リーダ情報取得 5 so_getspversion リーダバージョン取得 6 so_getcurrentregion リージョン取得 7 so_setregion リージョン設定 8 so_gettypeselectparameters Selectパラメータ取得 9 so_settypeselectparameters Selectパラメータ設定 10 so_gettypequeryparameters Queryパラメータ取得 11 so_settypequeryparameters Queryパラメータ設定 12 so_readtagid_single タグID 取得 13 su_readtagid_single タグID 取得 14 so_readtagid_multiple 連続タグID 取得 15 su_readtagid_multiple 連続タグID 取得 16 so_stopreadtagid_multiple 連続タグID 取得停止 17 so_readtagmemory タグメモリ読み取り 18 so_writetagdata タグメモリ書き込み 19 su_writetagdata タグメモリ書き込み 20 so_blockwritetagdata タグメモリ書き込み (BlockWriteコマンド) 21 so_killtag タグ使用不可 22 so_locktag タグロック 23 so_blockpermalock タグ恒久ロック (BlockPermaLockコマンド) 24 so_changeeas EAS 有無設定 25 so_easalarm EASアラーム 26 so_getcurrentrfchannel RFチャネル取得 27 so_setcurrentrfchannel RFチャネル設定 28 so_gettxpower 出力取得 29 so_settxpapower 出力設定 30 so_getrssi RSSI 取得 31 so_scanrssi RSSIスキャン 32 so_seteeprom EEPROM 状態変更 33 so_sethoppingsequence 周波数ホッピングの設定 7 34 so_gethoppingsequence 周波数ホッピングの取得 7 35 so_setfrequencyhopping 周波数ホッピング有無設定 36 so_getfrequencyhopping 周波数ホッピング有無取得 37 so_spsetioportstate モジュールIOポート状態設定 38 so_spgetioportstate モジュールIOポート状態取得 39 so_spsetioportvalue モジュールIOポート設定 40 so_spgetioportvalue モジュールIOポート取得 41 so_setcommandretry コマンドリトライの設定 42 so_getcommandretry コマンドリトライの取得 43 so_setselectbanksetting タグ特定メモリバンク (EPC or TID) 設定 44 so_getselectbanksetting タグ特定メモリバンク (EPC or TID) 取得 45 so_setreaderid リーダID 設定 46 so_getreaderid リーダID 取得 47 so_gettagrssi タグRSSI 取得 48 so_resetreader リセット 49 so_resetreaderanytime 強制リセット 50 so_spsetlinespeed モジュール回線速度設定 51 so_spgetlinespeed モジュール回線速度取得 52 so_writetagdata_customverify タグメモリ書き込み ( ベリファイ動作変更 ) 53 so_sptransmit 任意コマンド 54 so_setprotocol プロトコル設定 55 so_getprotocol プロトコル取得 56 so_sosetlinespeed 回線速度設定 57 so_sogetlinespeed 回線速度取得 58 so_getreadertype 機器種別取得 59 so_readeeprom EEPROM 読み取り 60 so_writeeeprom EEPROM 書き込み 61 so_releasepairing ペアリング解除 1 62 so_socontrolioport ワンショットIOポート制御 1/2

10 別紙 : 開発用ライブラリ (API) 関数一覧 2018/4/11 対応 fファミリ fファミリ CBファミリ CBファミリ No. 関数名説明 SPモデル SensorTag SPモデル SUモデルモデル 63 so_sosetioportdirection IOポート入出力設定 64 so_sogetioportdirection IOポート入出力取得 65 so_sooutputioport IOポート出力 66 so_soinputioport IOポート入力 67 so_setdefaultoutputioportvalue IOポート出力切替値設定 68 so_getdefaultoutputioportvalue IOポート出力切替値取得 69 so_setstoragelocation コマンドパラメータ制御設定 70 so_getstoragelocation コマンドパラメータ制御取得 71 so_setpoweronparameter PowerOnパラメータ設定 72 so_getpoweronparameter PowerOnパラメータ取得 73 so_readtagid_multiple_stock 連続タグID 取得 ( 溜めこみ ) 74 su_readtagid_multiple_stock 連続タグID 取得 ( 溜めこみ ) 75 so_startoperatingmode 動作モード ( タグ移動時通知 ) 開始 76 so_sendoperatingmode 動作モード ( タグ移動時通知 ) 開始 (VB6 用 ) 77 so_recvoperatingmode 動作モード ( タグ移動時通知 ) データ取得 (VB6 用 ) 78 so_stopoperatingmode 動作モード ( タグ移動時通知 ) 停止 79 so_getoperatingmodestate 動作モード ( タグ移動時通知 ) 状態取得 80 so_setoperatingparameter 動作モード ( タグ移動時通知 ) パラメータ設定 81 so_getoperatingparameter 動作モード ( タグ移動時通知 ) パラメータ取得 82 so_setreadername リーダ名設定 83 so_getreadername リーダ名取得 84 so_sotransmit 任意コマンド 85 so_startkeypadmode テンキー動作モード開始 2 86 so_sendkeypadmode テンキー動作モード開始 (VB6 用 ) 2 87 so_recvkeypad テンキーデータ取得 (VB6 用 ) 2 88 so_recvfunctionkey ファンクションキーデータ取得 (VB6 用 ) 2 89 so_stopkeypadmode テンキー動作モード停止 2 90 so_getkeypadmodestate テンキー動作モード状態取得 2 91 so_getkeypaddata テンキーデータ取得 2 92 so_outputlcd LCD 出力 2 93 so_setantennaswitchnum アンテナ切替 so_ SetAntennaPort アンテナ切替 (UP2 用 ) 6 95 so_getantennaswitchnum アンテナ切替値取得 so_setantennaswitchstate アンテナ切替器使用有無設定 so_getantennaswitchstate アンテナ切替器使用有無取得 so_setbtsettings Bluetooth 機器設定 1 99 so_getbtsettings Bluetooth 機器設定値取得 so_setdestinationaddress 宛先アドレス設定 so_getdestinationaddress 宛先アドレス取得 so_setsourceaddress 自局アドレス設定 so_getsourceaddress 自局アドレス取得 so_setselectsp DUALモデル選択設定 so_getselectsp DUALモデル選択取得 so_getcontrolmultiplesp DUALモデル複数台制御取得 so_setantennactrlmethod アンテナポート間制御設定 so_getantennactrlmethod アンテナポート間制御取得 so_setreceivetimeout 受信タイムアウト設定 110 so_setcommandmonitor コマンド表示 111 su_readtagid_single_formanytag タグID 取得 ( 多数タグ用 ) 112 so_gettagrssi_formanytag RSSI 取得 ( 多数タグ用 ) 113 su_readtagid_multiple_stock_formanyt 連続タグID 取得 ( 溜めこみ )( 多数タグ用 ) 114 so_setquery QueryパラメータのQ 値設定 115 so_getquery QueryパラメータのQ 値取得 116 so_setdwelltime 送信時間設定 117 so_getdwelltime 送信時間取得 118 so_setroundcount カウント数設定 119 so_getroundcount カウント数取得 120 so_readsensortag_single センサータグ情報取得 121 so_readtagid_multiple_nomerge タグID 取得 ( マージなし用 ) 122 so_settxpapowerant アンテナ毎の出力設定 123 so_gettxpowerant アンテナ毎の出力取得 124 so_setsessionant アンテナ毎のセッション設定 125 so_getsessionant アンテナ毎のセッション取得 126 so_setsessionstate セッション有効 / 無効設定 127 so_getsessionstate セッション有効 / 無効取得 128 so_setrssifilter RSSIフィルタ設定 129 so_getrssifilter RSSIフィルタ取得 : 利用可能 : 利用不可 1 Bluetoothオプション利用時のみ対応しています 2 テンキーオプション利用時のみ対応しています 3 DUALモデルのみ対応しています 4 アンテナ切替器利用時のみ対応しています 5 RS-485オプションで接続した際に使用します 6 UP2-250 UP 利用時のみ対応しています 7 UPx-250 利用時のみ対応しています 2/2

11 別紙 :UHF 制御プロトコル一覧 2018/4/11 制御プロトコル一覧対応 fファミリ fファミリ CBファミリ CBファミリ No. 機能 SensorTag SPモデル SPモデル SUモデルモデル 1 タグID 取得 2 連続タグID 取得 5 3 タグID 取得 ( 動作モード ) 4 連続タグID 取得停止 5 タグメモリ読み取り 6 タグメモリ書き込み 7 タグ使用不可 8 タグロック 9 タグ恒久ロック (BlockPermaLock) 10 EAS 有無設定 11 EASアラーム 12 リーダバージョン取得 13 リーダ情報取得 14 リージョン取得 15 リージョン設定 16 出力取得 17 出力設定 18 RFチャネル取得 19 RFチャネル設定 20 周波数ホッピング取得 / 設定 6 21 ホッピング有無取得 / 設定 22 コマンドリトライ取得 / 設定 23 Selectパラメータ取得 24 Selectパラメータ設定 25 Queryパラメータ取得 26 Queryパラメータ設定 27 EEPROM 状態変更 28 モジュール回線速度取得 / 設定 29 IOポート取得 / 設定 30 IOポート状態取得 / 設定 31 IOポート出力切替値取得 / 設定 32 RSSI 取得 33 RSSIスキャン 34 タグRSSI 取得 35 タグ特定メモリバンク (EPC or TID) 設定 36 タグ特定メモリバンク (EPC or TID) 取得 37 タグメモリ書き込み (BlockWriteコマンド) 38 リーダID 取得 39 リーダID 設定 40 省電力モード 41 リセット 42 強制リセット 43 プロトコル設定 44 プロトコル取得 45 回線速度設定 46 回線速度取得 47 機器種別取得 48 EEPROMデータ設定 49 EEPROMデータ取得 50 ワンショットIO 制御 51 動作モード設定 52 動作モード取得 53 動作パラメータ設定 54 動作パラメータ取得 55 コマンドパラメータ制御設定 56 コマンドパラメータ制御取得 57 PowerOnパラメータ設定 58 PowerOnパラメータ取得 1/2

12 別紙 :UHF 制御プロトコル一覧 2018/4/11 対応 fファミリ fファミリ CBファミリ CBファミリ No. 機能 SensorTag SPモデル SPモデル SUモデルモデル 59 リーダ名設定 60 リーダ名取得 61 テンキー動作設定 2 62 テンキー動作取得 2 63 テンキー通知 2 64 テンキー取得 2 65 LCD 出力 2 66 ファンクション通知 2 67 アンテナ切替アンテナ切替 (UP2 用 ) 4 69 アンテナ切替値取得アンテナ設定アンテナ取得ペアリング解除 1 73 Bluetooth 機器設定 1 74 Bluetooth 機器設定値取得 1 75 タグID 取得 ( 多数タグ用 ) 76 TagRSSI 取得 ( 多数タグ用 ) 77 Q 値設定 78 Q 値取得 79 送信時間設定 80 送信時間取得 81 カウント数設定 82 カウント数取得 83 Read Sensor Tag 84 タグID 取得 ( マージなし用 ) 85 セッション有効 / 無効設定 86 セッション有効 / 無効取得 87 RSSIフィルタリング条件設定 88 RSSIフィルタリング条件取得 89 RSSIフィルタリング範囲値設定 90 RSSIフィルタリング範囲値取得 91 アンテナごとの送信出力設定 92 アンテナごとの送信出力取得 93 アンテナごとのセッション設定 94 アンテナごとのセッション取得 95 ファームウェアタイプ設定 96 ファームウェアタイプ取得 1 Bluetoothオプション利用時のみ対応しています : 利用可能 : 利用不可 2 テンキーオプション利用時のみ対応しています 3 アンテナ切替器利用時のみ対応しています 4 UP2-250 UP 利用時のみ対応しています 5 取得回数の範囲は 1~100 通知モードは一括通知のみ対応しています 6 UPx-250 のみ対応しています 2/2

UHF 帯 RFID リーダライタ I/F プロトコルによる制御方法 2018 年 04 月 04 日第版株式会社アートファイネックス

UHF 帯 RFID リーダライタ I/F プロトコルによる制御方法 2018 年 04 月 04 日第版株式会社アートファイネックス UHF 帯 RFID リーダライタ I/F プロトコルによる制御方法 2018 年 04 月 04 日第 1.0.1 版株式会社アートファイネックス変更履歴日付版数変更内容 2018/02/28 1.0.0 初版発行 2018/04/04 1.0.1 CB ファミリ用のメッセージフォーマットを併記余分な説明を削除関連資料へのリンク貼り CB ファミリのコマンド一覧表を追加はじめに本書は

1. はじめに 本書は 弊社 UHF 920MHz 帯リーダ ライタ ( 以下 リーダ ライタとします ) を使用し ソフトウエア開発を行なうため の開発情報について説明するものです Windows Microsoft Visual Studio Microsoft Visual C++.NET M

1. はじめに本書は弊社 UHF 920MHz 帯リーダライタ ( 以下リーダライタとします ) を使用しソフトウエア開発を行なうための開発情報について説明するものです Windows Microsoft Visual Studio Microsoft Visual C++.NET M