AP 開発支援ライブラリ解説書 このマニュアルは、AP 開発支援ライブラリの 仕様について記載します。
ご注意 ● このソフトウェアおよびマニュアルの、一部または全部を無断で使用、複製することはできません。 ● このソフトウェアおよびマニュアルは、本製品の使用許諾契約書のもとでのみ使用することができます。 ● このソフトウェアおよびマニュアルを運用した結果の影響については、一切の責任を負いかねますのでご了 承ください。 ● このソフトウェアの仕様、およびマニュアルに記載されている事柄は、将来予告なしに変更することがありま す。 ● このマニュアルの著作権はカシオ計算機株式会社に帰属します。 ● 本書中に含まれている画面表示は、実際の画面とは若干異なる場合があります。予めご了承ください。 © 2006 カシオ計算機株式会社 Microsoft, MS, ActiveSync, Active Desktop, Outlook, Windows, Windows NT, および Windows ロゴは、米国 Microsoft Corporation の米国およびその他の国における登録商標または商標です。Microsoft 社の製品は、OEM 各社に、Microsoft Corporation の 100%出資子会
はじめに バーコードリーダ一体型ハンディターミナルＤＴ－９３０は、ＤＴ－９００の後継機として、非常に注目 されています。 当然の事ながら、ハードの普及に比例してアプリケーション開発の需要も増えるわけですが、 ・開発言語がＣという自由度の高い言語 ・マシン特有の操作を行うためのオリジナル関数 というポイントで問い合わせが多く発生しています。 こうした不明点やわかりづらさを解消し、より効率の良いプログラム開発が行えるよう作成されたの が、この「ＤＴ－９３０ アプリケーション開発支援ライブラリ」です。 このユーティリティは、 ・ＤＴ－９３０専用Ｃ関数の上位に位置する関数 ・開発の参考となるＣプログラムのソースリスト ・当ユーティリティの関数を用いたサンプルプログラム から構成されています。 2
目次 1． 概 要 -------------------------------------------------------------------- 1 2． 当 ラ イ ブ ラ リ の 位 置 づ け -------------------------------------------------- 3 3． 日 付 チ ェ ッ ク 関 数 群 ------------------------------------------------------ 4 3.1.1. ht_CheckDate ------------------------------------------------------------ 5 3.1.2. ht_CheckYear------------------------------------------------------------- 6 3.1.3.
7． フ ァ イ ル 制 御 関 数 群 ----------------------------------------------------- 66 7.1.1. ht_fileopen -------------------------------------------------------------- 68 7.1.2. ht_fileclose -------------------------------------------------------------- 69 7.1.3. ht_fileread -------------------------------------------------------------- 70 7.1.4. ht_filewrite -------------------------------------------------------------- 71 7.1.5.
1． 概要 ＤＴ－９３０のアプリケーションプログラム開発は、ＤＴ－９３０専用関数とＳＨＣ標準関数（一部使 用不可）を使って行います。 しかしながら、これらの各関数はデバイスの基本的な制御を司るもので、それをいろいろなパタ ーンで組み合わせることで開発における自由度が膨らみますが、逆に設計やプログラミングに費 やす時間が多くなってしまいます。 この煩雑さを解消するために、一つの関数で従来の数ステップ分の処理を賄える関数群をライ ブラリとして提供するのが「ＤＴ－９３０ アプリケーション支援ライブラリ」です。 このライブラリは、処理内容により、下記の様に分類されます。 （１）日付チェック （２）ブロックチェック （３）入力 （４）通信 （５）ファイル （６）サービス それぞれの機能は、下記の内容で提供しています。 機能名 処理内容 日付ﾁｪｯｸ 妥当性チェック 閏年 西暦／和暦返還 ライブラリファイルによる 提供 ○ ○ ○ ブロック チェック チェックサム計算 ＣＲＣ計算 ＬＲＣ計算 チェックディジット計算 ○ ○ ○ ○ 入力 制御キー入力 脱出条件（文字） 脱出条件（数値） 日付入力 時刻入
このライブラリは ・ライブラリファイル（ファイル名：DPLIB.LIB） ・インクルードファイル（ファイル名：DPLIB.
2． 当ライブラリの位置づけ 当ライブラリは、ＤＴ－９３０専用関数とＳＨＣ標準関数を用いて作成します。 しかしながら、当ライブラリがＤＴ－９３０のすべての制御を網羅しているわけではないので、必要 に応じて専用関数やＳＨＣ関数を使って下さい。（当然の事ながら、リンクする場合も当ライブラリ とＳＨＣのライブラリ、ＤＴ－９３０専用ライブラリ及びオブジェクトファイルをリンクして下さい） ソフトウェアの構造は、下記のようになっています。 アプリケーションプログラム ＡＰＬ支援ＬＩＢ ＳＨＣ ＬＩＢ DT-930専用ＬＩＢ DT-900専用ＬＩＢ ＤＴ－９３０ ＯＳ ＤＴ－９００ 3
3． 日付チェック関数群 棚卸や発注業務などで、日付を入力するケースはよくありますが、その際行わなければならない のが入力された日付の妥当性をチェックする処理です。 また、西暦を和暦に変換したり、その逆の処理を行うケースも多々あります。 このような、日付に関する処理を行うものが「日付チェック関数群」であり、これには下記の関数を 用意します。 日付妥当性チェック･･････引数で与えられた日付が妥当かどうかチェックする。 閏年もチェックする。 閏年チェック ･･････引数で与えられた年が、閏年かどうかを返す。 西暦／和暦変換 ･･････引数の指示に従い、西暦と和暦を変換して返す。 次ページ以降に関数仕様を示します。 4
3.1.1. ht_CheckDate 日付（西暦４桁月２桁日２桁）の妥当性をチェックします． 日付のチェック範囲は１８６６年１月１日から２０８８年１２月３１日の範囲とします。 ER ht_CheckDate( H year, H month, H day ); パラメータ year 年（西暦１８６８～２０８８） month 月（１～１２） day 日（１～３１） 戻り値 チェック結果 E_OK 正常（妥当な日付） E_NG 不正な日付 補足 注意）範囲外（１８６８年～２０８８年以外）か、或いは存在しない日付を指定すると、不正日付に なります。 【ＳＡＭＰＬＥ】 #include "dplib.
3.1.2. ht_CheckYear 入力年が閏年か否かを判定します。 年のチェック範囲は１８６８年から２０８８年の範囲とします。 ER ht_CheckYear( H year ); パラメータ year 年（西暦１８６８～２０８８） 戻り値 チェック結果 E_OK 閏年 E_NG 通常年 E_PRM 対象範囲外 補足 注意）範囲外（１８６８年～２０８８年以外）を指定すると、対象範囲外になります。 【ＳＡＭＰＬＥ】 #include "dplib.
3.1.3.
【ＳＡＭＰＬＥ】 #include "dplib.
4． ブロックチェック関数群 データ通信時に大概必要になるのが水平パリティのコードであり、一部のバーコードにおいては、 バーコードデータの最後にチェックディジットがつくケースがあります。 これらの値を算出するには、そのロジックをプログラムに反映すればいいのですが、まずはロジッ クを調べることから始まるため、新規に作る場合は少々面倒です。 そこでこの計算ロジックを関数にして提供するのが「ブロックチェック関数群」です。 チェックサム計算 ＣＲＣ計算 ＬＲＣ計算 ﾁｪｯｸﾃﾞｨｼﾞｯﾄ計算 指定データのチェックサムを計算し、値を返す。 指定データのＣＲＣ値を計算し、返す（ＡＮＳＩ、ＣＣＩＴＴ及びＸＭＯＤＥＭ） 指定データのＬＲＣ値を計算し、返す。 指定データに対し、指示された計算方式でﾁｪｯｸﾃﾞｨｼﾞｯﾄ を算出し、値を 返す。 次ページ以降に関数仕様を示します。 9
4.1.1. ht_Checksum check_data で指定したデータのチェックサム値を求めます。 UH ht_Checksum( unsigned char *check_data, H size ); パラメータ check_data 対象データ size データ長 戻り値 チェックサム値 補足 【ＳＡＭＰＬＥ】 #include "dplib.
4.1.2. ht_CalcCRC_ANSI check_data で指定したデータのＡＮＳＩ規格ＣＲＣ値を求めます。 UH ht_CalcCRC_ANSI( unsigned char *check_data, H size ); パラメータ check_data 対象データ size データ長 戻り値 ＡＮＳＩ規格ＣＲＣ値 補足 【ＳＡＭＰＬＥ】 #include "dplib.
4.1.3. ht_CalcCRC_CCITT check_data で指定したデータのＣＣＩＴＴ規格ＣＲＣ値を求めます。 UH ht_CalcCRC_CCITT( unsigned char *check_data, H size ); 【パラメータ】 check_data 対象データ size データ長 戻り値 ＣＣＩＴＴ規格ＣＲＣ値 補足 【ＳＡＭＰＬＥ】 #include "dplib.
4.1.4. ht_CalcCRC_X check_data で指定したデータのＸＭＯＤＥＭ用ＣＲＣ値を求めます。 UH ht_CalcCRC_X( unsigned char *check_data, H size ); パラメータ check_data 対象データ size データ長 戻り値 ＸＭＯＤＥＭ用ＣＲＣ値 補足 【ＳＡＭＰＬＥ】 #include "dplib.
4.1.5. ht_CalcLRC check_data で指定したデータに含まれるデータのＬＲＣ値を求めます。 UH ht_CalcLRC( unsigned char *check_data, H size ); パラメータ check_data 対象データ size データ長 戻り値 ＬＲＣ値 補足 【ＳＡＭＰＬＥ】 #include "dplib.
4.1.6.
補足 【ＳＡＭＰＬＥ】 #include "dplib.
5． 入力関数群 データの入力は、バーコード及びキー入力により行いますが、入力を抜ける条件として、通常の 入力以外の条件（ファンクションキー押下、後退キー押下等）を設定するのは若干面倒な処理が 入ります。 それらの設定を引数指定により実行できる関数が下記の入力関数です。 制御キー入力 テンキー、電源キー及びシフトキーを除いた制御キーのうち、脱出 するキーを引数により指定し、そのキーが押されたら終了する。 脱出条件設定付入力(文字) 引数として脱出条件を渡し、それに合致する条件が発生したら入 力処理を抜け、バーコード入力があったら、バーコードバッファか ら読み出し、文字列に代入する。 脱出した情報は戻り値及びグローバル変数にて知らせる。 ＊脱出条件：ファンクションキー入力、ＬＢ発生、及び key_string で 設定できる脱出条件 脱出条件設定付入力(数値) 引数として脱出条件を渡し、それに合致する条件が発生したら入 力処理を抜け、バーコード入力があったら、バーコードバッファか ら読み出し、文字列に代入する。 脱出した情報は戻り値及びグローバル変数にて知らせる。 ＊脱出条件：ファンクションキー入力、ＬＢ発生
5.1.1.
5.1.2.
戻り値 押されたキー情報（発生イベント） KY_F01 Ｆ１キー KY_F02 Ｆ２キー KY_F03 Ｆ３キー KY_F04 Ｆ４キー KY_F05 Ｆ５キー KY_F06 Ｆ６キー KY_F07 Ｆ７キー KY_F08 Ｆ８キー KY_ENT 実行キー KY_LB ＬＢ発生 KY_OBR バーコード読み込み E_NG 異常終了 補足 20
5.1.3.
戻り値 押されたキー情報（発生イベント） KY_F01 Ｆ１キー KY_F02 Ｆ２キー KY_F03 Ｆ３キー KY_F04 Ｆ４キー KY_F05 Ｆ５キー KY_F06 Ｆ６キー KY_F07 Ｆ７キー KY_F08 Ｆ８キー KY_ENT 実行キー KY_LB ＬＢ発生 KY_OBR バーコード読み込み E_NG 異常終了 補足 22
5.1.4.
string 入力文字列格納エリアポインタ （格納エリアは最大バイト数＋１の容量が必要） 戻り値 押されたキー情報（発生イベント） ※キーコードについては、ｈｔ＿ＦＣＷａｉｔを参照してください。 補足 24
/**********************************************************************/ /* < ﾌﾟﾛｸﾞﾗﾑ名 > */ /* 日付入力 */ /* < 機能概要 > */ /* 日付の入力を行います。 */ /* ･SEIREKI_8 が指定された場合、範囲は 1868 年 01 月 01 から */ /* /* /* /* /* /* 2088 年 12 月 31 日です。 */ ･SEIREKI_6 が指定された場合で、年が 80 年以上のときは、1900 年代 */ としてﾁｪｯｸします。80 年未満の場合は、2000 年代としてﾁｪｯｸします。*/ ･入力した日付が正しくない場合、当関数から Exit しません。 < 文法 > ER */ */ ht_DateInp( B mode , */ /* ER escape, */ /* H fsize , */ /* H type , */ /* UH clm , */ /* UH line , */ /*
/* KY_F02 : F2 ｷｰ */ /* KY_F03 : F3 ｷｰ */ /* KY_F04 : F4 ｷｰ */ /* KY_F05 : F5 ｷｰ */ /* KY_F06 : F6 ｷｰ */ /* KY_F07 : F7 ｷｰ */ /* KY_F08 : F8 ｷｰ */ /* KY_ENT : 実行ｷｰ */ /* KY_LB : LB 発生 */ /* KY_OBR : ﾊﾞｰｺｰﾄﾞ読込み */ /* E_NG : 異常終了 */ /* E_PRM : ﾊﾟﾗﾒｰﾀｴﾗｰ */ /**********************************************************************/ ER ht_DateInp(B mode, ER escape, H fsize, H type, UH clm, UH line, UB *string) { ER ret; UH len; H year,wyear,gengo; H month; H day; ER w
else{ if(strlen((const char *)string)==6){ year =(H)memto_l(string , 2); month=(H)memto_l(string+2, 2); day =(H)memto_l(string+4, 2); if(ht_ConvertYear(year, 4, &wyear, &gengo)==E_OK){ if(ht_CheckDate(wyear, month, day)==E_OK) break; } } } } else break; } return(ret); } 27
5.1.5.
補足 /**********************************************************************/ /* < ﾌﾟﾛｸﾞﾗﾑ名 > */ /* 時刻入力 */ /* < 機能概要 > */ /* 時刻の入力を行います。 */ /* ･時間は 24 時間制でﾁｪｯｸします。 */ ･入力した時刻が正しくない場合、当関数から Exit しません。 */ /* /* /* < 文法 > ER */ ht_TimeInp( ER escape, */ /* H fsize , */ /* H type , */ /* UH clm , */ /* UH line , */ /* UB *string /* /* ) */ < ﾊﾟﾗﾒｰﾀ > */ UH escape : 脱出条件(以下の条件を OR 論理で複数指定) */ /* KY_F01 : F1 ｷｰ */ /* KY_F02 : F2 ｷｰ */ /* KY_F03 : F3 ｷｰ */ /*
/* KY_ENT : 実行ｷｰ */ /* KY_LB : LB 発生 */ /* KY_OBR : ﾊﾞｰｺｰﾄﾞ読込み */ /* E_NG : 異常終了 */ /* E_PRM : ﾊﾟﾗﾒｰﾀｴﾗｰ */ /**********************************************************************/ ER ht_TimeInp( ER escape, H fsize, H type, UH clm, UH line, UB *string ) { ER ret; UH len; H hour; H min; H sec; ER wescape; ret=0L; len=6; wescape=(escape & KY_OBR_CANCEL); /* ﾊﾞｰｺｰﾄﾞを使用させないため for(;;){ ret=ht_NumInp(wescape, fsize, type, len, clm, line, string); if(ret==KY_ENT){ if(strlen((const char
W memto_l( void *buf , size_t len ) { UB wk[16]; memcpy( wk , buf , len ); wk[len] = 0x00; return( atol((char *) wk ) ); } 31
5.1.6.
6． 通信関数群 マルチドロップ、ＦＬＩＮＫプロトコルに対応したファイル転送を一括で行えるような関数を用意しま す。 ﾏﾙﾁﾄﾞﾛｯﾌﾟ送信 ﾏﾙﾁﾄﾞﾛｯﾌﾟ受信 ＦＬＩＮＫ送信 ＦＬＩＮＫ受信 Ｉｒ簡易制御関数群 通信条件及び送信ファイルテーブルをセットすることで、マルチドロッ ププロトコルの通信を行う。 通信条件をセットすることで、マルチドロッププロトコルによる受信処理 を行う。 通信条件、送信ファイル、送信先ディレクトリをセットすることで、ＦＩＬＮ Ｋプロトコルの通信を行う。 通信条件、受信ファイル、受信先ディレクトリをセットすることで、ＦＩＬＮ Ｋプロトコルによる受信処理を行う。 ＩｒＤＡ制御関数を、カシオＩｒ関数（ｃ＿ＸＸ）と同等に扱えるようにした 関数。 次ページ以降に関数仕様を示します。 また、カスタマイズに用いていただける様に各関数のソースリストを添付します。 ☆上記の関数群のうち マルチドロップ送信／受信は、ベーシックＩ／Ｏボックス ＦＬＩＮＫ送信／受信、Ｉｒ簡易制御関数群は、マスタ及びサテライトＩ／Ｏボックスに機能しま す。 33
6.1.1. ht_MLTsend マルチドロッププロトコルによる送信を行います。 ER ht_MLTsend( H com_no, UB connectMode, DAT_COM_STR *param B fnam_tbl[12][], H *s_file, H *phase ); パラメータ ※ｃｏｍ＿ｎｏ～＊ｐａｒａｍのパラメータはｃｕ＿ｏｐｅｎと全くおなじです。 Ｃライブラリ解説書の「８．通信ユーティリティ部関数」をご覧ください。 fnum_tbl[12][] 送信ファイル名テーブル（★最終は先頭が￥０） 例） fnum_tbl[12][]={ "SHOHIN□□MST", /* SHOHIN.MST */ "KOKYAKU□MST", /* KOKYAKU.MST */ "TORIHIKITRN", /* TORIHIKI.
6.1.2.
補足 /**********************************************************************/ /* < ﾌﾟﾛｸﾞﾗﾑ名 > */ /* ホスト送信 */ /* < 機能概要 > */ /* パソコンに対してＦＬＩＮＫプロトコル /* /* */ にてファイルを送信する。 */ < 文法 > /* */ ER ht_MLTsend(H com_no, H irSpeed, CU_RSPRM *param, */ /* B fnam_tbl[12][], B *dir, */ /* H *s_file, H *phase); */ /* < ﾊﾟﾗﾒｰﾀ > /* H */ com_no : ＣＯＭ番号 /* */ COM0,COM1 /* H /* irSpeed CU_RSPRM : *param : /* */ 赤外通信最大速度 通信パラメータデータのポインタ typedef struct { */ */ */ /* W speed; /* W
} if( fnam_tbl[fileCnt][0]==0x00){ break; } } if( fileCnt == 0){ return(E_PRM); } graphSet.graphMode = CU_GRAPH_ON_2; graphSet.graphPos = 0; graphSet.graphCol = 0; graphSet.graphName = CU_GRAPH_NM_FILE; graphSet.
/**********************************************************************/ /* < ﾌﾟﾛｸﾞﾗﾑ名 > */ /* ホスト受信 */ /* < 機能概要 > */ /* /* パソコンよりＦＬＩＮＫプロトコルにてファイルを受信する。 < 文法 > /* */ ER ht_MLTrecv(H com_no, H irSpeed, CU_RSPRM *param, B *dir, /* /* H *r_file, H *phase); < ﾊﾟﾗﾒｰﾀ > /* H com_no H /* */ */ */ : ＣＯＭ番号 /* /* */ irSpeed CU_RSPRM : *param : /* */ COM0,COM1 */ 赤外通信最大速度 */ 通信パラメータデータのポインタ typedef struct { */ */ /* W speed; /* W length; データ長 */ /* W parity; パリティビット *
if( fileCnt == 0){ return(E_PRM); } graphSet.graphMode = CU_GRAPH_ON_2; graphSet.graphPos = 0; graphSet.graphCol = 0; graphSet.graphName = CU_GRAPH_NM_FILE; graphSet.
6.1.3.
6.1.4.
6.1.5.
busy_ch ＸＯＦＦコード（受信不可時のコード） nonbusy_ch ＸＯＮコード（受信可能時のコード） buff 受信バッファアドレス buf_l 受信バッファレングス （０の時ＢＩＯＳ内部の１６バイトエリアを受信バッファとして使用します） tim_out typedef struct { H cs; ：ＣＳタイムアウト監視値(0～32767(×7.8ms)) H dr; ：ＤＲタイムアウト監視値(0～32767(×7.8ms)) H cd; ：ＣＤタイムアウト監視値(0～32767(×7.
6.1.6.
6.1.7.
ＣＯＭステータス 15 14 13 12 11 10 9 ０ ０ ０ 8 7 6 5 ０ ０ ０ 4 46 3 2 1 0 STS_RD 1:受信データあり 0:受信データなし CI信号 1:ＯＦＦ 0:ＯＮ CD信号 1:ＯＦＦ 0:ＯＮ CS信号 1:ＯＦＦ 0:ＯＮ DR信号 1:ＯＦＦ 0:ＯＮ STS_PRI 1:パリティエラー 0エラーなし STS_OVR 1:ｵｰﾊﾞｰﾗﾝｴﾗｰ 0:エラーなし STS_FRE 1:ﾌﾚﾐﾝｸﾞｴﾗｰ 0:エラーなし STS_FUL 1:ﾊﾞｯﾌｧﾌﾙｴﾗｰ 0:エラーなし STS_BRK 1:ブレーク検出 0:ブレーク未検出
6.1.8.
6.1.9.
6.1.10.
6.1.11.
6.1.12.
6.1.13.
6.1.14.
6.1.15.
6.1.16.
6.1.17.
6.1.18. Ir_c_timer ＣＳ、ＤＲ、ＣＤ信号のタイムアウト値を設定します。 ER Ir_c_timer( H com_no， H cs_time, H dr_time, H cd_time ); パラメータ com_no 通信ポート COM0 カシオ IR インタフェース cs_time ＣＳタイムアウト値（0～32767)×7.8ms dr_time ＣＳタイムアウト値（0～32767)×7.8ms cs_time ＣＳタイムアウト値（0～32767)×7.
6.1.19.
6.1.20.
6.1.21.
6.1.22.
6.1.23.
6.1.24.
6.1.25.
6.1.26.
7． ファイル制御関数群 ＤＴ－９３０では、ファイル制御はＣの標準関数（ｆｏｐｅｎやｏｐｅｎ等）にて行います。 このため、読み込み・書き込み時に特定のレコードにアクセスする場合は、自分でファイルポイン タを移動する必要があります。 こういった手間を省き、ＢＡＳＩＣライクなファイル制御を実現するのが「ファイル制御関数群」で す。 この関数群を使用する場合は、ファイル名とレコード長のテーブルを用意し、アクセスはユニーク なファイル番号で行います。 ファイルオープン ファイルクローズ ファイルリード ファイルライト ファイルサイズ取得 レコード数取得 ファイル（引数にてテーブルを渡し、指定）をオープンする。 ファイル（ファイル番号にて指定）をクローズする。 ファイル（ファイル番号にて指定）の指定レコード番号のデータ を読み込む。 ァイル（ファイル番号にて指定）の指定レコード番号にデータ を書き込む。 定ファイル（ファイル番号にて指定）のファイルサイズを返す。 ファイル（ファイル番号にて指定）のレコード数を返す。 ☆この関数群を使用する場合は、ＤＴ－９３０のファイルモードを必ず「ＤＴ７００モード」にして 下さい。
ファイル構造体配列テーブル 次ページ以降のファイル制御関数で使用するファイル管理テーブルの構造は以下の通りです。 ファイル管理テーブルの名称は、固定になっていますので、ファイル制御関数を使用する際は、 必ずこの名前にてテーブルをグローバル定義する様にしてください。 struct ht_filetbl { char fname[14]; /* ファイル名称 */ H rsize; /* １レコードのバイト値 */ FILE *fp; /* ストリーム保存（ファイル制御関数で使用） */ }; typedef struct ht_filetbl FILE_TBL; 例） FILE_TBL filetbl[]={ { "shohin.mst" , 120, (FILE*)0 }, { "kokyaku.mst" , 56, (FILE*)0 }, { "tana.
7.1.1.
7.1.2.
7.1.3.
7.1.4.
7.1.5.
7.1.6.
8． サービス関数群 プログラム開発に有用な関数群です。 ウェイト処理 デバッグ補助関数 音制御 ＸＹＭＯＤＥＭ ＩｒＤＡ用ＸＹＭＯＤＥＭ 渡された時間（単位：秒）だけウェイトします。 れた変数やメッセージを通信ポートへ出力する。 のエラー音を引数により分ける ＤＥＭ手順によるファイルの送受信を行う関数です。 ＤＡポートでＸＹＭＯＤＥＭを行う関数です。 次ページ以降に関数仕様を示します。 また、カスタマイズのためにウェイト関数、及び音制御についてはその関数のソースリストを添付 します。 ☆Ｉ／Ｏボックスを用いてＸＹＭＯＤＥＭ通信を行う場合、 「ＸＹＭＯＤＥＭ」なら、ベーシックＩ／Ｏボックス 「ＩｒＤＡ用ＸＹＭＯＤＥＭ」なら、マスタもしくはサテライトＩ／Ｏボックス をご使用下さい。 74
8.1.1.
8.1.2.
8.1.3.
8.1.4.
戻り値 xy_modem()の戻り値は終了情報を表します。 詳細は下記の通りです。 ０ 正常終了 １ 強制終了（ファンクションキー押下による中止） ２ パラメータエラー ６ 入力ファイルなし ７ 出力ファイル作成エラー ９ 通信エラー １１ 電圧低下による中止（ＬＢ通知を行った場合のみ） ３２ ２重オープン ３３ 応答なし ３４ 回線接続不可 ３５ 話し中 ３６ ホストからキャンセルされ ３７ 回線未オープン ３８ モデムエラー ５０ 内部エラー ５１ タイムアウト ５２ 外部機器エラー ☆上記戻り値の１（強制終了）は、アプリケーションでキー通知モードの設定（key_fnc_mode 関数にて設定）を行ったときのみ発生します。 発生時には、グローバル変数 xy_error に通知フラグをセットし、xy_modem() 内で通知 フラグを一度クリアします。 ☆上記戻り値の１１（電圧低下）は、アプリケーションでＬＢ通知モードの設定（pwr_inhabit 関数、にて設定）を行ったときのみ発生します。 発生時には、グローバル変数 xy_error に通知フラグをセットし、xy_modem() 内で通知 フラグを一度
・xy_modem の通信モードの詳細（ はデフォルト値） 機能 指定なし XY_SEND XY_RECEIVE ：送受信を行わない ：送信 ：受信 モデム操作 指定なし XY_MODEM ：モデム操作を行わない ：発（着）信を行う プロトコル XY_YMODEM XY_XMODEM ：ＹＭＯＤＥＭ ：ＸＭＯＤＥＭ エラー検出 XY_CRC XY_CHKSUM ：ＣＲＣ ：チェックサム パケット長 XY_LONG XY_SHORT ：ロング（１０２４バイト） ：ショート（１２８バイト） ポート XY_0 XY_1 ：赤外線インターフェース（COM0） ：シリアルインターフェース（COM1） ‘K’ 送信 XY_KOFF XY_KON ：'K' を送信しない ：‘K’ を送信する ボーレート XY_1200 XY_2400 XY_4800 XY_9600 XY_19200 XY_38400 XY_57600 XY_115200 ：１２００ｂｐｓ ：２４００ｂｐｓ ：４８００ｂｐｓ ：９６００ｂｐｓ ：１９２００ｂｐｓ ：３８４００ｂｐｓ ：５７６００ｂｐｓ ：１
☆通信モードにおける機能、モデム操作、ポート操作の指定における xy_modem()の処理内容 機能 指定なし XY_SEND モデム操作 指定なし ポート操作 XY_232ON XY_232OFF xy_modem() の処理内容 パラメータエラー パラメータエラー XY_MODEM XY_232ON XY_232OFF XY_232ON XY_232OFF XY_232ON XY_232OFF パラメータエラー 発（着）信 オープン→送信→クローズ 送信 オープン→発（着）信→送信→回線断→クローズ 発（着）信→送信→回線断 XY_232ON XY_232OFF XY_232ON XY_232OFF オープン→受信→クローズ 受信 オープン→発（着）信→受信→回線断→クローズ 発（着）信→受信→回線断 指定なし XY_MODEM XY_RECEIVE 指定なし XY_MODEM ☆モデム操作にて XY_MODEM を指定した場合、モデムに対しては、以下の設定を行います。 ダイヤルトーン検出・ビジートーン検出 *キャラクタエコーなし *リザルトコードを数字で返す 自動応答しない *
8.1.5.
9． サンプルプログラムについて 本ライブラリの関数を使用したサンプルプログラムを用意しました。 プログラムの内容は、それぞれ下記のようになっています。 ・SAMPLE1.SRC・・・入力処理サンプル ・SAMPLE2.SRC・・・日付・時刻入力関数サンプル ・SAMPLE3.SRC・・・ファイル制御関数サンプル ・SAMPLE4.SRC・・・日付チェック関数サンプル ・SAMPLE5.SRC・・・ビープ音、ウェイト関数サンプル ・SAMPXY.
ＤＴ－９３０ ＡＰ開発支援ライブラリ解説書 平成１８年２月 Rev1.
