====================================================================================================
== ソース・コード・ファイル ========================================================================

■ SimpleIo.c

  ・ SECS メッセージをＡＰ内で構築し、単純に S1F1、S1F2 の送受信を繰り返す、最も単純な使用例。



■ BasicIo.c

  ・ SECS メッセージの HSMS による Send/Receive 処理を逐次行う、基本的な処理例。

  ・ 内部に定義したマクロ定数の値を変更することにより、以下の項目に関して処理方法を変更できる。
    ・ メッセージ定義ファイル使用の有無
    ・ メッセージのリスト表現形式
    ・ メッセージ内各データ項目の取得方法



■ CallbackIo.c

  ・ SECS メッセージの Receive 処理を Callback 関数内で行い、１次メッセージの受信時は、対応する２次
     メッセージの送出もその時点で行う通常の処理に近い処理例。

  ・ 内部に定義したマクロ定数の値を変更することにより、以下の項目に関して処理方法を変更できる。
    ・ SECS-1 or HSMS
    ・ メッセージ定義ファイル使用、及び２次メッセージ自動応答の有無
    ・ メッセージのリスト表現形式
    ・ メッセージ内各データ項目の取得方法
    ・ ユーザ関数による通信トレース出力の有無

  ・ 通信トレースをユーザ関数内で行う例示もする。
     指定により、メッセージ定義ファイルを使用し、定義ファイルを利用した自動応答機能を使用する。

  ・ トレース・メッセージ内に定義ファイルにて規定する項目名等の情報を出力する。

  ・ 要求コードにより、一定間隔（100ms）での連続送信（受信）処理を CNTL-C 入力まで継続実行する。



■ SubFunctions.h

  ・ BasicIo.c、CallbackIo.c から Call される関数の実体を格納したソース・コード・ファイル。
     各ソース・コード・ファイルでは、#include することにより、自分の中に取り込む。



■ CSIo.cs

  ・ BaseicIo.c の C# 版。内部に定義した変数を変更することにより、Callback 処理も可能。

  ・ 本サンプルの起動には、.Net Framework 2.0 が必要。
  ・ 本サンプルは、Windows 版のみ使用可能



■ VBIo.vb

  ・ BaseicIo.c の Visual Basic 版。内部に定義した変数を変更することにより、Callback 処理も可能。

  ・ 本サンプルの起動には、.Net Framework 2.0 が必要。
  ・ 本サンプルは、Windows 版のみ使用可能



■ Makefile

  ・ 上記５つのプログラム（SimpleIo、BasicIo、CallbackIo、CSIo、VBIo）を作成する Makefile
    （注) CSIo、VBIo は Windows 版のみ Make 対象となる。



■ Sample.ini

  ・ 本ライブラリの設定ファイルの例であり、本サンプル・プログラムが使用する。
  ・ [DEFAULT] セクションに、ホスト側、設備側共通の項目を設定した上で、[HOST] セクションにホスト側
     固有の設定を行い、[EQUIP] セクションに設備側固有の設定を行う。
  ・ HSMS 接続により、デバイスＩＤ = 0x20 の設備とホストが、１つのＰＣ内で折り返し試験を行う場合を
     想定した設定。
  ・ SECS メッセージの最大長は 4096Bytes としており、もっと大きなメッセージを使用する場合は、本設定
     ファイルの先頭に記述したコメントを参考として、パラメータ値を変更する必要がある。
  ・ 本ライブラリが行うログ出力に関しては以下の設定となっている。
    ・ 通信トレースを本ライブラリの書式のリスト形式で出力する。１６進数表示は行わない。
    ・ 処理トレース、ユーザＩ／Ｆ関数トレースは行わない。通信トレースは、ファイルにのみ出力。
    ・ トレース・ファイルは 5MB を超えると切り替える。
  ・ 設定値の詳細は、プログラマーズ・マニュアル（TDS.pdf）を参照すること。



■ Sample.sml

  ・ 本サンプル・コードが使用する SECS メッセージを SML 形式で定義したファイル。
  ・ メッセージ定義ファイルは、必ずしも必要な訳ではない。
  ・ 本ライブラリでは、メッセージ定義を行わなくても SECS メッセージを構築する事が可能。
  ・ メッセージ定義を使用する場合は、項目名を使用してメッセージを構成する各項目値の参照、設定を行う
     事ができる。また、２次メッセージの自動応答（自動メッセージ選択）を行うことができる。
  ・ 本サンプルでは、本メッセージ定義ファイルを使用して SECS メッセージを構築する場合、使用せずに
     構築する場合の両方を例示する。
  ・ メッセージ定義ファイルの構成に関する詳細は、プログラマーズ・マニュアル（TDS.pdf）を参照する事。



■ SemiStandard.sml

  ・ SEMI 標準にて定義された "E5-0600" に準拠したメッセージを SML 形式で定義したファイル。
  ・ このままの形態でも使用可能ではあるが、多分適用するシステムに合わせて、各メッセージの構造を
     変更する必要があると思う。



(注) 各サンプル・プログラム 及び Makefile の行末は、"LF" コードのみ。従って、Windows の Notepad で
    は、正しく参照することができない。改行コードが "LF" のみであるファイルに対応したテキスト・エ
    ディタを使用して、参照すること。
    設定ファイル等は、Notepad でも参照可能。



====================================================================================================
== サンプル・プログラムの作成方法 ==================================================================

■ Windows における Makefile を使用したプログラムの Build

  ・ cmd.exe を起動し、その中で作業を行う。

  ・ Microsoft Visual Studio のコンパイラ等の開発環境が使用できるようにするため、Visual Studio が
     用意する以下のバッチ・ファイルを起動し、開発環境を整える。
    ・ [Visual Studio をインストールしたディレクトリ]\VC\bin\vcvars32.bat

  ・ 以下のコマンドで Build を行う。
    ・ nmake

  (注) 本ライブラリ・パッケージは以下の開発環境に対応する。
    ・ Microsoft .. Visual Studio 2005      (c:\Program Files\Microsoft Visual Studio 8)
    ・ Microsoft .. Visual Studio 2008      (c:\Program Files\Microsoft Visual Studio 9.0)
    ・ Microsoft .. Visual Studio 2010      (c:\Program Files\Microsoft Visual Studio 10.0)



■ UNIX 系ＯＳにおけるプログラムの Build

  ・ 以下のコマンドを実行する。
    ・ make

  (注) make に失敗する場合、Makefile を適宜修正すること。



====================================================================================================
== サンプル・プログラムの起動方法、操作方法 ========================================================


■ 各サンプル・プログラムの起動方法、操作方法等は、各ソース・コードのヘッダ部を参照すること。


