#include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
      kcxinit( argc, argv );
  }

 《解説》
  (1) karacrix.h は、どこにあるのでしょうか？
      karacrix.h は、プログラムをコンパイルする毎に一時的に自動生成されてそれを使います。 
      自動生成すると言っても元ファイルがあります。それは、
      karacrixXXX(KaracrixBuilderのディレクトリ)/sys/sinc/kcxux_program.h です。
      これがプログラム毎に編集(制御か印刷用かで少々情報追加)されて、karacrixXXX/sys/stmp/karacrix.h に置かれます。
      なお、karacrixXXX/sys/stmp/karacrix.h は KaracrixBuilder が起動する度に初期削除されます。
  (2) argc,argv は、必要なのでしょうか？
      argc,argv は、KaracrixBuilder がプログラムの起動に必要なデータを与えるものです。
      kcxinit(argc,argv); に渡します。
  (3) kcxinit(argc,argv); は、必要なのでしょうか？
      kcxinit() は、KaracrixBuilder側とプログラムの結合に必要不可欠なものです。
      オブジェクト等のアドレス含め多くの情報をプログラムのライブラリに初期値として渡しています。
  (4) kcxinit(argc,argv); を記述する場所はどこでしょうか？
      main() 関数の最先頭位置になければなりません。

  #include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
    int    objid,status;
    int    idata;   
    double fdata;   
      kcxinit( argc, argv );
      objid  = kcxobj_open( "di001" );
      status = kcxobj_stat_ird( objid, &idata );
  }

 《解説》
  (1) 作業メモリの宣言
      オブジェクトIDと関数の戻り値を保存する整数 objid と status を宣言
      整数ポイント状態値を保存する整数 idata を宣言
      実数ポイント状態値を保存する実数 fdata を宣言
  (2) オブジェクトIDの取得
      objid = kcxobj_open( "di001" );
      で行っています。
      kcxobj_open() に与える引数は、オブジェクトID名という文字列です。
      成功すると関数の返り値として正の整数値が戻って来ます。
      この返り値は ID と呼んでいますが、上記解説オブジェクトメモリのアドレスみたいなものでシステム内部配列値を示しています。

  #include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
    int    objid,status;
    int    idata;   
    double fdata;   
      kcxinit( argc, argv );
      objid  = kcxobj_open( "di001" );
      status = kcxobj_stat_ird( objid, &idata );
      objid  = kcxobj_open( "di001" );
      status = kcxobj_stat_iwt( objid, 0      );
      objid  = kcxobj_open( "do001" );
      status = kcxobj_stat_ird( objid, &idata );
      status = kcxobj_stat_iwt( objid, 1      );
      objid  = kcxobj_open( "pi001" );
      status = kcxobj_stat_ird( objid, &idata );
      status = kcxobj_stat_iwt( objid, 9999   );
      objid  = kcxobj_open( "ai001" );
      status = kcxobj_stat_frd( objid, &fdata );
      status = kcxobj_stat_fwt( objid, 3.14   );
      objid  = kcxobj_open( "ao001" );
      status = kcxobj_stat_frd( objid, &fdata );
      status = kcxobj_stat_fwt( objid, 31.4   );
  }

 《解説》
  (1) objid = kcxobj_open() を何回も繰り返してよいのでしょうか？
      kcxobj_open() はリソースを溜め込むものではありません。
      アドレス(配列値)みたいなもので ID を返しているだけです。
      ですので例えば同じオブジェクトID名を何回オープン(kcxobj_open)しても構いません。
      但し、kcxobj_open() は、オブジェクトID名をメモリの上から文字検索するので軽負荷ではありません。
      この場合、保存した ID を再使用するようなプログラムにした方が良いと思います。 
  (2) kcxobj_stat_ird( objid, &idata ) のデータ引数
      整数型変数のアドレスを指定します。idata には、ポイントの状態値が入ります。 
  (3) kcxobj_stat_iwt( objid, 1 ) のデータ引数
      整数値あるいは整数型変数を指定します。ポイントの状態値として設定されます。 
  (4) kcxobj_stat_frd( objid, &fdata ) のデータ引数
      実数型変数のアドレスを指定します。fdata には、ポイントの状態値が入ります。 
  (5) kcxobj_stat_fwt( objid, 3.14 ) のデータ引数
      実数値あるいは実数型変数を指定します。ポイントの状態値として設定されます。 
  (6) status = kcxobj_stat_xxx( ... ) 関数の返り値について
      引数を正しく使用している限りエラーは返りません。CPU 環境の影響を受けるものではありません。

  #include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
    int    objid,status;
    int    idata;   
    double fdata;
    char   cdata[64];
      kcxinit( argc, argv );
      objid  = kcxobj_open( "di001" );
      status = kcxobj_atbut_ird( objid, 1, &idata ); /*汎用整数属性1取得*/
      status = kcxobj_atbut_frd( objid, 2, &fdata ); /*汎用実数属性2取得*/
      status = kcxobj_atbut_crd( objid, 4, cdata  ); /*汎用文字属性4取得*/
      status = kcxobj_atbut_iwt( objid, 5, 2000   ); /*汎用整数属性5に2000書込例*/
      status = kcxobj_atbut_fwt( objid, 6, 1.23   ); /*汎用実数属性6に1.23書込例*/
      status = kcxobj_atbut_cwt( objid, 1, "日本" ); /*汎用文字用属性1に「日本」書込例*/
      idata = 1234
      fdata = 3.14;
      status = kcxobj_atbut_iwt( objid, 7, idata );  /*汎用整数属性7に1234書込例*/
      status = kcxobj_atbut_fwt( objid, 8, fdata );  /*汎用実数属性8に3.14書込例*/
      status = kcxobj_alm_stat_ird( objid, &idata ); /*警報状態値(整数)の読込*/
      status = kcxobj_alm_stat_iwt( objid, 1 );      /*警報状態値(整数)に1(ON)書込例*/
      idata = 0;
      status = kcxobj_alm_stat_iwt( objid, idata );  /*警報状態値(整数)に0(OFF)書込例*/
      status = kcxobj_lock_wrt( objid, 1 );          /*ロック状態値(整数)の1(ON)書込*/
      status = kcxobj_lock_ird( objid, &idata );     /*ロック状態値(整数)の読込*/
      status = kcxobj_online_ird( objid, &idata );   /*通信状態値(整数)の読込*/
  }

 《解説》
  (1) 汎用文字属性の文字長について
      読み書き出来る文字長は半角63文字迄です。全角で31文字迄となります。
      文字変数を宣言する場合の長さは、63+終端(0:NULL)で、64文字分必要になります。

  #include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
    int         objid;
    KcxIntFlt_t udata;
      kcxinit( argc, argv );
      for(;;){
        switch( kcxobj_sndstat_fromkcx( &objid, &udata ) ){
        case KcxINTEGER: /*整数型ポイント*/
             /* ------------------------------------------------------------*/
             /* 通常ここにリモートI/O装置へのコマンド送信プログラム書きます */
             /* ------------------------------------------------------------*/
             kcxobj_stat_iwt( objid, udata.i );  /* ← ポイント状態確定設定例 */
             break;
        case KcxFLOAT:   /*実数型ポイント*/
             /* ------------------------------------------------------------*/
             /* 通常ここにリモートI/O装置へのコマンド送信プログラム書きます */
             /* ------------------------------------------------------------*/
             kcxobj_stat_fwt( objid, udata.f );  /* ← ポイント状態確定設定例 */
             break;
        case KcxNULL:    /*データ無し*/
        default:
             break;
        }
        sleep( 1 );
      } 
  }

 《解説》
  (1) 作業メモリの宣言
      ポイントの操作値を取得する為の共用体名 KcxIntFlt_t 型の udata を宣言
      KcxIntFlt_t は、整数と実数両方が扱える共用体で、karacrix.h の中に定義されています。
  (2) kcxobj_sndstat_fromkcx() 関数の返り値
      FIFOスタックメモリ内にポイント操作データが存在しない場合、KcxNULL が返ります。
      データが存在する場合、ポイントのデータ型別に返り値が異ります。
      整数型ポイントの場合 KcxINTEGER が、実数型の場合 KcxFLOAT が返ります。
      KcxINTEGER KcxFLOAT KcxNULL は、karacrix.h の中に定義されています。
  (3) 取得した objid と udata パラメータ
      objid には、操作ポイントのオブジェクトIDが入っています。
      udata には、操作ポイントのデータが入っています。
      udata だけでは、整数か実数かどちらのデータかは見分けが付けません。
      ポイントのデータ型別に、 udata.i で整数が、udata.f で実数を取り出せます。 
  (4) sleep( 1 ) の意味
      1 秒間プログラムに待ちを入れると言う意味です。
      もしこのsleep()文を使用せずプログラムにウエイトを入れなかった場合で、
      FIFOスタックメモリにデータが無いとfor()文がものすごい早さで空回りします。
      ただこの空回り、CPUに対して負荷が軽いのではなく大変重いものになります。
      アプリケーションとしては仕事はしていませんが、
      for()文とswitch()文の単純判断だけの処理を忠実に膨大に行うからです。 
      アプリケーションに必要な時間だけを与え、後はウエイトさせる様にする方が良いでしょう。

  #include <karacrix.h>
  main( argc, argv )
  int   argc;
  char *argv[];
  {
    int objid;
      kcxinit( argc, argv );
      objid = kcxobj_open  ( "do001"     );
      kcxobj_sndistat_tokcx( objid, 1    );
      objid = kcxobj_open  ( "ao001"     );
      kcxobj_sndfstat_tokcx( objid, 3.14 );
  }

 《解説》
  (1) do001 の操作
      ポイント操作のデータ 1 をFIFOスタックメモリに書き込みました。
      デジタル型のポイントの場合、1 が ON で 0 が OFF という決まりに統一しています。
  (2) ao001 の操作
      ポイント操作のデータ 3.14 をFIFOスタックメモリに書き込みました。
  (3) kcxobj_sndistat_tokcx() 関数の返り値について 
      ここでは、関数実行の成功失敗の返り値は見ていません。 成功したとしても、
      そのデータが回り回ってリモートI/O装置の出力を操作した結果で無いためです。

HOME　戻る