mab方式MORE連携ユーティリティライブラリ

◆mab方式MORE連携ユーティリティライブラリについて
　・mabさん考案のファイル名呼出しによるMORE連携方式を
　　サポートするための関数をまとめたライブラリです。
　・MORE連携方式については，下記を参照ください。

◆動作環境
　・シャープザウルスシリーズ
　・動作確認機種：MI-310

◆更新履歴
　2000/10/06　Ver1.00
　　　　　　　・公開開始。
　2001/01/30　Ver2.00
　　　　　　　・MI-E1のCF/SDカードのファイル連携に対応。

◆ダウンロード
　ライブラリ＋ヘッダファイル＋説明書
　　KickUtil-200.lzh
　ソースファイル＋ヘッダファイル＋説明書
　　KickUtil-200s.lzh

◆仕様
　０．KICKファイル
　１．MORE連携呼出し元関係
　２．MORE連携呼出し先関係


　０．KICKファイル
　　　ファイル名：F0:WYR_KICK.INI
　　　形式：バイナリ形式
　　　　　　typedef struct {
　　　　　　    UCHAR dstAplName[5]; /* 呼出し先アプリ識別名４文字＋'\0' */
　　　　　　    UCHAR srcAplName[5]; /* 呼出し元アプリ識別名４文字＋'\0' */
　　　　　　    TIME  setTime;       /* 連携ファイル作成時刻 */
　　　　　　    UCHAR fileName[LONG_DFNAME_LEN+20]; /* 引数ファイル名（絶対パス） */
　　　　　　    UCHAR dirName[LONG_DFNAME_LEN];     /* 引数ファイル名のディレクトリ */
　　　　　　                                        /* F0:, F1:, F1:\DIR\,
　　　　　　                                           C1;, C1:\, C2:, C2:\SRC など */
　　　　　　    int   readOnlyMode;  /* 0: Read/Write, 1: ReadOnly */
　　　　　　    UCHAR work[100];     /* 各MORE独自パラメータ用 */
　　　　　　} KICK_F;

　１．MORE連携呼出し元関係
　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：APLID KICK_AplNameToAplID(UCHAR *aplName)
　　　引　数：aplName　アプリ識別文字列
　　　戻り値：アプリ識別値

　　　概　要：引数aplNameのアプリ識別文字列をアプリ識別値に変換する。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：void KICK_AplIDToAplName(UCHAR *aplName, APLID aplID)
　　　引　数：aplName　アプリ識別文字列
　　　　　　　aplID  　アプリ識別値
　　　戻り値：なし

　　　概　要：引数aplIDのアプリ識別値をアプリ識別文字列に変換して，引数aplName
　　　　　　　に格納する。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：BOOLEAN KICK_IsExistMORE(UCHAR *dstAplName)
　　　引　数：dstAplName　呼出し先MOREアプリ識別文字列
　　　戻り値：存在する　　=TRUE
　　　　　　　存在しない　=FALSE

　　　概　要：引数dstAplNameで示されるMOREソフトが，ザウルス上（本体，カード）
　　　　　　　に存在するかどうかを調べる。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：BOOLEAN KICK_CreateKickFile(KICK_F *pKickFile)
　　　引　数：pKickFile　KICKファイル構造体
　　　戻り値：KICKファイルの作成成功　=TRUE
　　　　　　　KICKファイルの作成失敗　=FALSE

　　　概　要：引数pKickFileの内容を持つKICKファイルを作成する。
　　　　　　　KICKファイルが存在する場合には，上書きする。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：BOOLEAN KICK_MakeKickFile(UCHAR *dstAplName, UCHAR *fileName,
　　　　　　　                          int readOnlyMode, UCHAR *work)
　　　引　数：dstAplName  　呼出し先MOREのアプリ識別文字列
　　　　　　　fileName    　呼出し先MOREで使用するファイル名（絶対パス）
　　　　　　　readOnlyMode　ReadOnlyフラグ
　　　　　　　work        　その他の各MORE独自パラメータ用（100バイトまで）
　　　戻り値：KICKファイルの作成成功　=TRUE
　　　　　　　KICKファイルの作成失敗　=FALSE

　　　概　要：各引数の内容を持つKICKファイルを作成する。
　　　　　　　KICKファイルが存在する場合には，上書きする。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：BOOLEAN KICK_ExecMORE(UCHAR *dstAplName)
　　　引　数：dstAplName  　呼出し先MOREのアプリ識別文字列
　　　戻り値：MORE呼出し成功　=TRUE
　　　　　　　MORE呼出し失敗　=FALSE

　　　概　要：引数dstAplNameで示されるMOREソフトを起動する。
　　　　　　　すでに呼出し先MOREソフトがOUT状態の場合には，呼出し先MOREソフト
　　　　　　　をEXEC状態に切り替える。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

　２．MORE連携呼出し先関係
　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：BOOLEAN KICK_ReadKickFile(KICK_F *pKickFile)
　　　引　数：pKickFile　KICKファイル構造体
　　　戻り値：KICKファイルの読み出し成功　=TRUE
　　　　　　　KICKファイルの読み出し失敗　=FALSE

　　　概　要：引数pKickFileで示されるKICKファイル構造体に，KICKファイルを読み
　　　　　　　出して設定する。
　　　　　　　KICKファイルが存在しない場合や，呼出し先アプリ識別名が自MOREソフ
　　　　　　　トのアプリ識別名と異なる場合には，FALSEを返す。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
　　　形　式：BOOLEAN KICK_DeleteKickFile()
　　　引　数：なし
　　　戻り値：KICKファイルの削除成功　=TRUE
　　　　　　　KICKファイルの削除失敗　=FALSE

　　　概　要：KICKファイルを削除する。
　　　　　　　KICKファイルが存在しない場合には，FALSEを返す。

　　　＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

◆呼出し元コーディング例
  UCHAR dst_id;      /* 呼出し先アプリ識別値 */
  UCHAR apl_name[5]; /* 呼出し先アプリ識別文字列 */
  UCHAR file_name[LONG_DFNAME_LEN]; /* ファイル名（絶対パス） */
  UCHAR work[100];   /* */

  /* アプリ識別値をアプリ識別文字列に変換 */
  KICK_AplIDToAplName(apl_name, dst_id);
  /* 呼出し先MOREソフトの存在確認 */
  if (KICK_IsExistMORE(apl_name) != FALSE) {
      /*
       * 呼出し先MOREに渡したいファイル名（絶対パス）とworkを設定
       */
      /* KICKファイルの作成 */
      if (KICK_MakeKickFile(apl_name, file_name, KICK_READWRITE, work) != FALSE) {
          /* 呼出し先MOREソフトの起動 */
          KICK_ExecMORE(apl_name);
      }
  }

◆呼出し先コーディング例
  PIMAplSetup関数などで

  KICK_F kick_file;  /* KICKファイル構造体 */

  if (KICK_ReadKickFile(&kick_file) != FALSE) {
      /*
       * kick_fileの内容に従い起動設定
       */
      KICK_DeleteKickFile();
  }

◆使用方法
　１．libKickUtil.aをSZABインストールディレクトリの下の lib ディレク
　　　トリにコピーする。
　２．KickUtil.hをSZABインストールディレクトリの libheader/c ディレ
　　　クトリにコピーする。
　　　あるいは，各プロジェクトのディレクトリの csrc ディレクトリの下
　　　にコピーする。
　３．SZAB統合開発環境のリンカオプション LKFLAGS2 に -lKickUtil を追
　　　加する。

◆対応MOREソフト一覧(2001/07/09現在)

◆制限事項
　・MI-E1において，MORE連携で起動できるMOREソフトは「カード」設定されているドライブ上のMOREソフトの
　　みである。

◆著作権・転載条件など
　・本ライブラリは，制限なしで使用可能です。自由に使用してください。
　　但し，本ライブラリを使用して生じるあらゆる障害に対して，一切責任
　　を負いません。

MOREソフト