====================================================================================================
== ご紹介 (TDS) ====================================================================================

■ Please refer to ReadmeE.txt if you want to refer to the contents of this file in English.


■ "Trust Design Simple SECS Communication Library" パッケージのご紹介

  ・ SECS プロトコルによる通信を行うためのライブラリ等で構成するパッケージです。
  ・ SECS-1（RS232C接続）、HSMS-SS、HSMS-GS（TCP/IP接続）に対応します。
  ・ 任意の SECS-2 メッセージの構築、解析を行うことができます。
  ・ 動作可能プラットフォームは Windows系ＯＳ（WinsockV2）、Linux (CentOS、Fedora、Ubuntu、Vine、
     Debian、OpenSUSE、Redhat 等)、FreeBSD、MacOS X、Solaris 11(x86)、HP-UX 11 等です。
  ・ ライブラリは、C、C++、C#、VB、Java からの Call が可能です。
  ・ ライブラリは DLL、共用ライブラリで提供されますので、Ruby、Python、PHP 等からの使用も可能です。

  ・ Java 用の TDS には２種類があり、Java 機能のみを使用したものの場合 Intel プロセッサを利用した
     Windows、Linux 等の PC だけでなく、異なるプロセッサ、ＯＳであっても Java 実行環境が動作する
     環境であれば、TDS 機能の実行を行える可能性があります。
     この場合の AP の開発は、Java によるだけでなく、Java 開発環境がサポートする JNI (Java Native
     Interface) を利用して、C、C++ による開発も可能になります。

  ・ ホスト側、装置側（パッシブ側、アクティブ側）の両方をサポートします。
  ・ SML 形式でのメッセージ定義ファイルを使用した SECS-2 メッセージ構築、解析が可能です。
     また、同ファイルを使用した受信メッセージに対する自動応答機能を持ちます。
     もちろん、メッセージ定義ファイルを使用しなくても、SECS-2 メッセージを構築、解析が可能です。
  ・ メッセージ定義では、別途ファイルに格納した項目データを指定可能です。
     また、可変長項目の指定が可能です。

  ・ メッセージ定義を使用した送信メッセージの構築、受信メッセージの解析においても、複数レベル、
     複数個数の不定個数リストを定義することが可能です。アプリケーションにより実行時にリスト個数を
     確定させ、そのリスト内の各項目値を設定することが可能です。不定個数リストを含むメッセージ受信
     時には受信により確定したリスト個数でメッセージを展開し、項目値を参照することが可能です。

  ・ １つのアプリケーションが、最大 64 の相手と通信することが可能です。
  ・ SML 形式に対応した通信ログ出力、ユーザが指定可能なログ出力機能を持ちます。
  ・ 通信ログを、ユーザ関数で受け取り処理することも、ユーザが別途動作させるＡＰで TCP/IP 通信に
     より受け取り処理することも可能です。これにより、SECS 通信状態をリアルタイムで遠隔監視すること
     ができます。

  ・ 以下の SEMI 規格に準拠しています。
    ・ E4    : SECS-I ..... メッセージトランスファ (RS232C 接続)
    ・ E5    : SECS-II .... SECS メッセージ内容
    ・ E37   : HSMS ....... 高速 SECS メッセージサービス (HSMS) 汎用サービス (TCP/IP 接続)
    ・ E37.1 : HSMS-SS .... 高速 SECS メッセージサービス シングルセッションモード (HSMS-SS)
    ・ E37.2 : HSMS-GS .... 高速 SECS メッセージサービス ジェネラルセッション (HSMS-GS)
  ・ SEMI 標準にて定義された"E5-0600"準拠メッセージ定義がサンプルとして付属します。
  ・ 詳細は、製品に同梱のドキュメント（TDS.pdf）をご参照ください。

  ・ PeerGroup 社 SDR、及び Yokogawa 社 YSD の API と互換性のある C、C++ における SdrXxxxx() 関数
     等の I/F 互換ライブラリを、おまけのライブラリとして提供可能です。
     SDR 互換 API ライブラリ、YSD 互換 API ライブラリに関しては、弊社（info@trust-design.co.jp）
     までお問い合わせください。

  ・ 本パッケージ (TDS) を構成するソース・コードへのアクセス権の販売（ソース・コードの開示）も行っ
     ております。詳しくは、弊社 (info@trust-design.co.jp) までお問い合わせください。

  ・ SECS-1 及び HSMS-SS、HSMS-GS による通信処理（ホスト側、装置側）をシミュレートする検査アプリ
     ケーションとして、（簡易版）SECS/HSMS シミュレータ（Trust Design Simple SECS/HSMS Simulator 
     (Simplified Version))（使用ライセンス無料）を公開しております。詳しくは、弊社ホーム・ページを
     ご覧ください。

  ・ SECS-1 と HSMS-SS、HSMS-GS 相互の通信プロトコルを変換するアプリケーションとして、SECS/HSMS
     プロトコル変換プログラム（Trust Design Simple SECS/HSMS Protocol Converter）（使用ライセンス
     無料）を公開しております。詳しくは、弊社ホーム・ページをご覧ください。

  ・ PLC にて制御する装置を、SECS 通信 I/F で上位システムに接続するためのアプリケーションとして、
     SECS/PLC 通信接続プログラム（Trust Design Simple SECS/PLC Communication Connection）（使用ライ
     センス無料）を公開しております。このプログラムを使用すると、本ライブラリ等を使用した SECS 接続
     を行うコードを記述することなく Windows アプリケーションを作成することができます。詳しくは、弊
     社ホーム・ページをご覧ください。 

  ・ SECS(HSMS) による通信のモニターには、弊社 ネットワーク通信モニター（Trust Design Simple 
     Network Communication Monitor）（使用ライセンス無料）をご利用いただけます。詳しくは、弊社ホー
     ム・ページをご覧ください。

  ・ RS232C Serial Port を使用した SECS-1 通信を含めた通信のモニターには、弊社 シリアル通信モニター
    （Trust Design Simple Serial Port Communication Monitor）（使用ライセンス無料）をご利用いただけ
     ます。詳しくは、弊社ホーム・ページをご覧ください。



■ インストール方法

  ・ 本パッケージの書庫ファイル（TDS.zip あるいは TDS.YY.MMN.zip (YY.MMN はバージョン番号）等）を、
     任意のフォルダに展開してください。

  ・ 本パッケージは、レジストリを使用しません。

  ・ 適用するアプリケーションの種別（32bit/64bit）により、適宜 Win32、Win64 等のフォルダに存在する
     .dll、.lib 等をご使用ください。



■ アンインストール方法

  ・ 本パッケージをインストールしたフォルダを削除してください。



■ Windows 版 (32bit アプリケーション対応) における必要な開発環境

  ・ Microsoft Visual Studio 2005 ... 2019年末でサポート終了しました
  ・ Microsoft Visual Studio 2008 ... 2019年末でサポート終了しました
  ・ Microsoft Visual Studio 2010
  ・ Microsoft Visual Studio 2012
  ・ Microsoft Visual Studio 2013
  ・ Microsoft Visual Studio 2015
  ・ Microsoft Visual Studio 2017
  ・ Microsoft Visual Studio 2019
  ・ Microsoft Visual Studio 2022

  Windows 系ＯＳ (32bit、64bit) 上での 32bit アプリケーションでは、Win32 ディレクトリ下に存在する
  .lib、.dll を使用してください。

  コマンド・プロンプト上での開発の場合は、Visual Studio をインストールしたディレクトリの
  "VC/vcvarsall.bat x86"、もしくは "VC/bin/vcvars32.bat" を使用して、32bit 開発環境のセットアップ
  を行ってください。

  C#、VB により開発したコードを実行する場合、".Net Framework 2.0" 以降が必要です。
  C#、VB による開発時には、build 時に "platform=x86" オプションを指定してください。



■ Windows 版 (64bit アプリケーション対応) における必要な開発環境

  ・ Microsoft Visual Studio 2010
  ・ Microsoft Visual Studio 2012
  ・ Microsoft Visual Studio 2013
  ・ Microsoft Visual Studio 2015
  ・ Microsoft Visual Studio 2017
  ・ Microsoft Visual Studio 2019
  ・ Microsoft Visual Studio 2022

  Windows 系ＯＳ (64bit) 上での 64bit アプリケーションでは、Win64 ディレクトリ下に存在する .lib、
  .dll を使用してください。

  コマンド・プロンプト上での開発の場合は、Visual Studio をインストールしたディレクトリの
  "VC/vcvarsall.bat x64"、もしくは "VC/bin/amd64/vcvars64.bat" を使用して、64bit 開発環境のセット
  アップを行ってください。

  C#、VB により開発したコードを実行する場合、".Net Framework 2.0" 以降が必要です。
  C#、VB による開発時には、build 時に "platform=x64" オプションを指定してください。



■ Linux 版における必要な開発環境

  ・ gmake、gcc 開発環境

  32bit アプリケーションでは、ディレクトリ Linux32 下のライブラリを使用し、コンパイル時に -m32
  オプションを指定してください。

  64bit アプリケーションでは、ディレクトリ Linux64 下のライブラリを使用し、コンパイル時に -m64
  オプションを指定してください。



■ FreeBSD 版における必要な開発環境

  ・ gmake、clang 開発環境

  32bit アプリケーションでは、ディレクトリ FreeBSD32 下のライブラリを使用し、コンパイル時に -m32
  オプションを指定してください。

  64bit アプリケーションでは、ディレクトリ FreeBSD64 下のライブラリを使用し、コンパイル時に -m64
  オプションを指定してください。



■ MacOS X 版における必要な開発環境

  ・ gmake、clang 開発環境

  32bit アプリケーションでは、ディレクトリ MacOS32 下のライブラリを使用し、コンパイル時に -m32
  オプションを指定してください。

  64bit アプリケーションでは、ディレクトリ MacOS64 下のライブラリを使用し、コンパイル時に -m64
  オプションを指定してください。



■ Solaris 11 (x86) 版における必要な開発環境

  ・ gmake、gcc 開発環境

  32bit アプリケーションでは、ディレクトリ SunOS32 下のライブラリを使用し、コンパイル時に -m32
  オプションを指定してください。

  64bit アプリケーションでは、ディレクトリ SunOS64 下のライブラリを使用し、コンパイル時に -m64
  オプションを指定してください。



■ HP-UX 版における必要な開発環境

  ・ HP-C/ANSI-C 開発環境

  32bit アプリケーションでは、ディレクトリ HP-UX32 下のライブラリを使用し、コンパイル時に +DD32
  オプションを指定してください。

  64bit アプリケーションでは、ディレクトリ HP-UX64 下のライブラリを使用し、コンパイル時に +DD64
  オプションを指定してください。



■ Java 版における必要な開発環境 及び 実行環境

  ・ Java 版は２種類あります。
    1. JNA を使用して TDS.dll の全機能を使用するもの ............ TDJVS.jar
    2. JNA を使用せず、Java 実行環境のみでの実行が可能なもの .... TDSJava.jar

  ・ 上記 1. に関する開発、実行環境 
    ・ JavaVM 8   以降
    ・ JDK    8   以降
    ・ JNA    4.1 以降

    (注1) JNA の対応アーキテクチャ (32bit or 64bit) に注意し、使用する共有ライブラリ (TDS.dll、
        libTDS.so、libTDS.dylib、libTDS.sl) のアーキテクチャ (32bit or 64bit) を対応するものと
        する必要があります。

  ・ 上記 2. に関する開発、実行環境 
    ・ JavaVM 8   以降
    ・ JDK    8   以降

    (注2) TDSJava.jar は TDJVS.jar (TDS.dll) と比して、一部機能が制限されます。詳細は TDS.pdf
        付Ｅをご参照ください。
        なお、TDSJava.jar は、弊社ＨＰ 及び ベクター様からのダウンロード可能な製品ファイルには
        含まれておりません。
        TDSJava.jar のご使用をご検討される場合は、弊社 (info@trust-design.co.jp) まで、お問い
        合わせください。

    (注3) TDSJava.jar は TDS 機能の実行を JNA を使用して TDS.dll、libTDS.so 等を利用して行うので
        はなく、TDSJava.jar が Native な Java Call により TDS 機能を実行するので、Intel プロセッ
        サを利用した Windows、Linux 等の PC だけでなく、異なるプロセッサ、ＯＳであっても Java
        実行環境が動作する環境であれば、TDS 機能の実行を行える可能性があります。
        その場合の AP の開発は、Java によるだけでなく、Java 開発環境がサポートする JNI (Java
        Native Interface) を利用して、C、C++ による開発も可能になります。
        TDSJava.jar を構成するソース・コードへのアクセス権の販売（ソース・コードの開示）も行って
        おります。詳しくは、弊社 (info@trust-design.co.jp) までお問い合わせください。



■ 連絡先

   名称    : 合同会社 トラストデザイン
   e-Mail  : info@trust-design.co.jp
   URL     : http://www.trust-design.co.jp/



====================================================================================================
== 留意事項 ========================================================================================

■ 本ライブラリ・パッケージのご使用にあたっての留意事項

  ・ 弊社ＨＰよりダウンロード可能な本パッケージは Windows系ＯＳ (32/64bit) 用 及び Linux (32/64bit)
     です。その他の UNIX系ＯＳ (FreeBSD、MacOS X、Solaris 11、HP-UX) 用に関しては、弊社
     "info@trust-design.co.jp" まで e-Mail にて、お問い合わせください。

  ・ 本パッケージの使用にあたり、本書下部にある「使用許諾条件等」をお読みいただき、ご同意ください。

  ・ 本パッケージの使用ライセンス・キー・コードを取得する場合は、以下の内容を明記の上、e-Mail にて、
     弊社 "info@trust-design.co.jp" までご連絡ください。
     ライセンス・キー・コードの発行は無料です。

    ・ 題名を「SECS/HSMS 通信パッケージ ライセンス希望」としてください。
    ・ 本文に以下の内容を記述してください。
      ・ 団体名称（企業名 及び 所属部署名）
      ・ 団体名称（企業名 及び 所属部署名）の英文表記
      ・ ご担当者様氏名
      ・ ご連絡先（住所、電話番号、e-Mailアドレス）
      ・ 動作プラットフォーム（Windows/Linux/FreeBSD/MacOS X/Solaris 11/HP-UX）
      ・ 必要とするライセンス個数
         １回のご依頼にて発行するライセンス個数は最大１０個までとさせていただきます。
         より多くのライセンスを必要とする場合は、別途弊社までその旨ご連絡下さい。
         なお、お使いのＰＣ１台毎に異なるライセンスが必要です。
    ・ 可能であれば、ご参考までに以下の内容もご記述いただければ幸いです。
      ・ 使用目的（工場ライン/設備試験/研究開発/その他）
      ・ 通信形態（SECS-1/HSMS-SS/HSMS-GS)
      ・ 対象設備種別等

  ・ 本パッケージを試験的に使用する場合、設定ファイル（.ini）に、弊社ＨＰに掲載の以下のライセンス・
     キーに関する記述を追加してください。

    LICENSENAME = "Default Co.,Ltd."
    LICENSECODE = "Default"
    LICENSESER  = "1"
    LICENSEDATE = "20111001"
    LICENSEKEY  = "FVZM3-T72IB-76OWG-P7KWM-TMBF2-4ZXBW"

   (注1) 試験使用用ライセンス・キーの LICENSEDATE、LICENSEKEY の値は、定期的に変更されます。最新の
        試験使用用ライセンス・キーは、弊社ＨＰ "http://www.trust-design.co.jp" にてご確認ください。

   (注2) Version 12.120 以前のバージョンの TDS 用に発行された LICENSEKEY は、Version 12.120 以降
        のバージョンでは使用できません。
        Version 12.120 以前のバージョンのライセンス・キーを所持される方で、本バージョンでの正規ラ
        イセンスを必要とされる場合は、お手数をお掛けして申し訳ありませんが、再度ライセンス・キー・
        コード発行のご依頼をお願い致します。（もちろん無料です。）

   (注3) ------------------------------------------------------------------------------------------+
    |  本パッケージは、ライセンス管理用として、UDP/IPの以下のポートを使用します。                  |
    | また、UDP/Multicast アドレスとして、以下のクラスＤアドレスを使用します。ご使用になるコン     |
    | ピュータのファイアウォール等により、これらをブロックしないよう設定してください。             |
    | ・ 36274/udp                                                                                 |
    | ・ 239.254.200.74                                                                            |
    |なお、インターネット接続環境を含め、ネットワーク接続ができない状態、NIC が存在しない状態でも、|
    |ご使用は可能であり、使用に関する機能上の制限等は、同環境がある場合に比して、一切ありません。  |
    +----------------------------------------------------------------------------------------------+


  ・ 本パッケージの使用方法の詳細は "TDS.pdf" をご参照ください。

  ・ 本ライブラリを使用したアプリケーションのコード記述に関しては、まず FirstSample0 に格納した C
     言語によるサンプル・コードをご参照ください。特定のオプションにおける簡単なコードとなっています。
     様々なオプションを使用したコード記述、C、C++ 以外の言語でのコード記述に関しては、Sample0 に格
     納したサンプル・コードをご参照ください。

  ・ Sample0、Sample1、Sample2 フォルダに、使用例を格納しています。各サンプルの内容、詳細は、
     Sample0、Sample1、Sample2 フォルダ内の Readme.txt 及び、各ソース・コード・ファイル先頭のコメ
     ントをご参照ください。
     Sample0、Sample1 は VS2010/32bit での Build サンプル、Sample2 は VS2010/64bit での Build
     サンプルです。もちろん、それぞれ、Makefile、プロジェクト設定を変更することにより、他のバー
     ジョンの Visual Studio、また 32bit/64bit いずれの Build も可能です。

  ・ Sample0 は、Makefile を使用した nmake による AP の Build 方法を示します。
  ・ Sample1、Sample2 は、それぞれ VS2010 の IDE を使用した AP の Build 方法を示します。
  ・ SampleX は、Sample0 において Makefile を使用した nmake による AP の Build の代わりに VS2017
     の IDE を使用した Build 方法のサンプルを示します。


  ・【 重要１ 】
     本パッケージでは、設定ファイル（.ini ファイル）を使用します。
     Sample0 フォルダの "Sample.ini" をコピーして使用していただけますが、ご自身の使用条件に応じて
     特に、以下のパラメータにご留意ください。詳細はプログラマーズ・マニュアル（TDS.pdf）をご参照く
     ださい。

     SECSMODE           // SECS 通信パラメータ
     DEVMODE            // デバイス制御モード
     DEVID              // 接続デバイスID
     XMSGSIZE           // 最大 SECS メッセージ・バイト長
     INTER0             // 通信制御部処理インターバル
     INTER2             // シリアル通信受信インターバル
     SDEVICE            // シリアル接続 デバイス名称
     HOST               // HSMS TCP/IP 接続先ホスト名称 もしくは IP アドレス
     PORT               // HSMS TCP/IP 接続ポート番号
     TRCTTYPE           // 通信トレースへの通信メッセージ出力形式
     LINKINT            // Link Test インターバル
     MDMSSG             // SML 形式、もしくは NSG/TS300 形式のメッセージ定義ファイル・パス
     MDMXITEM           // 各メッセージで使用するデータ・アイテム総数の最大個数
     MDMXMSSG           // 定義するメッセージの最大個数
     MDMXMITEM          // 各メッセージ内で使用するアイテムの総計の最大個数
     MDMXPOOL           // メッセージ定義 設定データ格納領域サイズ


  ・【 重要２ 】
     本パッケージは、ライセンス管理用として、UDP/IPの以下のポートを使用します。
     また、UDP//Multicast アドレスとして、以下のクラスＤアドレスを使用します。ご使用になるコン
     ピュータのファイアウォール等により、これらをブロックしないよう設定してください。
     ・ 36274/udp
     ・ 239.254.200.74
     なお、インターネット接続環境を含め、ネットワーク接続ができない状態、NIC が存在しない状態でも、
     ご使用は可能であり、使用に関する機能上の制限等は、同環境がある場合に比して、一切ありません。


  ・ 本プログラム最新版のリリースは、弊社ＨＰにて行っております。
     逐次、弊社ＨＰ "http://www.trust-design.co.jp/" をご確認ください。



====================================================================================================
== 使用許諾条件等 ==================================================================================

■ 著作権等

  "Trust Design Simple SECS Communication Library" パッケージ（以下 本ソフトウエア）のオリジナル・
  コードに関する著作権は "合同会社 トラストデザイン"（以下、弊社）が保有します。

  ・ 本ソフトウエアの改変、改修、リバースエンジニアリングはご遠慮ください。
  ・ お客様は、有償、無償を問わず、弊社の同意なく、本ソフトウエアそのもの（本ソフトウエア自体の機能
     そのものを提供するパッケージ等）を第三者に配布することはできません。
  ・ お客様が作成した、本ソフトウエアを使用したアプリケーション等を配布する場合は、以下のソフトウエ
     アを使用している旨を明示してください。
    ・ 本ソフトウエアの名称     :  "Trust Design Simple SECS Communication Library"
    ・ 本ソフトウエアの著作権者 :  "合同会社 トラストデザイン"
                                   "Trust Design Limited Liability Company"



■ 使用制限

  本ソフトウエアは、どなたでも無償で使用することができます。

  一定時間以上連続して使用される場合は、所定の形式（上述）の e-Mail にて弊社までお問い合わせいただ
  き、ライセンス・キー・コードの発行を受けることが必要です。

  ・ ライセンス・キー・コードの発行は無料です。
  ・ ライセンス・キー・コードは、ご使用になるコンピュータ１台毎に必要となります。
  ・ お客様毎に発行された正規ライセンス・キー・コードを使用して TDS を実行する場合、実行時間に制限
     はありません。また、正規ライセンス・キー・コードに使用期間の制限はありません。

  なお、ライセンス・キー・コードの発行には、お客様情報のご登録が必要です。ライセンス・キー・コー
  ド発行に伴いご登録いただいたお客様情報は、当該ソフトウエアのインストール状況管理に使用させてい
  ただきます。



■ 免責事項

  本ソフトウエアの使用によって仮に何らかの障害、損害等が発生した場合、それが本ソフトウエアが内包
  する不具合に起因するものであっても、障害、損害の大小を問わず、弊社はいかなる責も負いません。
  弊社は、お客様が本ソフトウエアを使用する環境において、本ソフトウエアが常に正確に動作する事を保
  証するものではありません。



■ サポート

  本ソフトウエアに関するサポートは、e-Mail のみにて行います。
  e-Mail にてお問い合わせいただいた内容に対して、弊社は可能な範囲で応答、対処致しますが、返信の有
  無、応答までの時間（期間）を含め、いかなる保証も致しかねます。
  また、本ソフトウエアに関するサポートを、お客様と合意の上、有償で行わせていただく場合があります。
  本ソフトウエアに関する不具合が発見された場合、弊社は、その原因の解明、原因に対する対応、新バー
  ジョンのリリースを行う事がありますが、その時期、内容等は弊社が独自に決定し、お客様に何らお約束
  をすることはできません。

  本ソフトウエアは、その性能向上等を目的として、予告無く改訂、更新する場合があります。
  最新バージョンに関しては、弊社ＨＰ（http://www.trust-design.co.jp/）をご参照ください。


