プラグインの構成
MERLIC RTE Setup で構成を有効にする
MERLIC RTE Setup の「通信」タブでプラグインの構成を有効にするには、まず MERLIC RTE を起動し、次の手順を実行する必要があります。
- MERLIC RTE Setup を開き、「通信」タブに移動します。MERLIC RTE が起動していない場合は、「通信」タブから直接起動できます。
-
- プラグインが現在は実行されていないことを確認してください。そうでない場合、パラメーターを構成することはできません。プラグインの現在の状態は、プラグインインスタンスのリストに示されるステータスアイコンで確認できます。ステータスにアイコン
が表示される場合、プラグインが実行中です。この場合は、MERLIC RTE Setup の下側にある「
プラグインの停止」ボタンをクリックして停止する必要があります。代わりにステータスにアイコン 
が表示される場合、プラグインは実行されていません。
-
「通信」タブの右側には、選択した MELSEC Communication プラグインのパラメーターが表示されます。
Plug-in Parameters
このタイプのパラメーターは、通信プラグインの一般的なパラメーターを表しますが、「通信」タブの構成エリアでは調整することはできません。これらのパラメーターは、プラグインのバージョン番号、ログレベルの現在のパラメーター値、プラグインのアクセスレベルを表すこともあります。これらの値は、それぞれ異なる場所または異なる方法で設定する必要があります。
Version
このパラメーターでは、プラグインの実装時に定義されたバージョン番号が表示されます。これには、メジャー、マイナー、メンテナンスバージョンがあります。新しいプラグインインスタンスを追加したときにも表示されます。バージョンは任意です。したがって、実装時にバージョン番号の定義を省略することもできます。
Log level
このパラメーターは、プラグインインスタンスのログレベルを示します。デフォルトのログレベルは、MERLIC RTE Setup でプラグインインスタンスを追加するときのそれぞれの MERLIC RTE プロセスのログレベルに設定されています。
Access level
このパラメーターはプラグインに設定されているアクセスレベルを示します。MELSEC Communication プラグインの場合、アクセスレベルはデフォルトで「monitor and control」に設定されています。つまり、プラグインは「イベント」を受信して「アクション」を送信することができます。アクセスレベルは、プラグインの実装で定義されている機能と相関関係があります。アクセスレベルは MERLIC RTE Setup では調整できません。
Supports rapid validation
このパラメーターは、プラグインが現在のプラグイン構成の即時検証をサポートしているかどうかを示します。このプラグインでは、チェックボックスにチェックが入っていることで「高速検証」がサポートされていることが示されています。これは、MERLIC RTE Setup の「通信」タブで編集可能なパラメーターを変更するたびにプラグインの構成が検証されることを意味します。プラグインが高速検証をサポートしていない場合、プラグインの構成は構成を保存するときにのみ検証されます。
User Parameters
「User parameters」は、プラグインに構成可能なパラメーターを示します。パラメーターはカテゴリごとに表示され、展開したり閉じたりすることができます。
以下の項では、カテゴリごとのパラメーターについて説明します。
- Ethernet Connection Details
- System Operation
- Result Handling Behavior
- Writing Data to PLC Memory
- Reading Data from PLC Memory
- Global Label CSV Export
Ethernet Connection Details
このカテゴリのパラメーターは、PLC への接続設定を定義します。PLC への接続のセットアップ方法の詳細については、「PLC との接続のセットアップ」を参照してください。
以下の図では、パラメーターの概要と、それぞれのデフォルト設定を示しています。パラメーターについては、図の後に詳細な説明があります。
IP address
このパラメーターでは、接続する MELSEC Communication PLC のインターネットプロトコルアドレス (IP アドレス) を定義します。デフォルト設定値は「127.0.0.1」です。このパラメーターは、インターネットプロトコルバージョン 4 (IPv4) アドレスのみをサポートします。したがって、ホスト名の使用はサポートされません。
Port
このパラメーターは、接続に使用されるポートを定義します。
System Operation
このカテゴリのパラメーターは、MVTec の PLC プロトコルのバージョンとハートビートモードに関する設定を定義します。
以下の図では、パラメーターの概要と、それぞれのデフォルト設定を示しています。パラメーターについては、図の後に詳細な説明があります。
Protocol version
このパラメーターは、使用される MVTec の PLC プロトコルのバージョンを定義します。デフォルト設定値は、最新バージョンの 1.1 です。プロトコルのバージョンを、以前の MERLIC バージョンで使用されていたプロトコルのバージョンに対応する「1.0」に設定できます。
プロトコルのバージョン「1.0」とは異なり、新しいバージョンには、MERLIC への接続が引き続き有効であることを常に通知するハートビートモードが備えられています。プロトコルのバージョン「1.1」を使用すると、ラベルが「gMV_Heartbeat」である追加フィールドが、エクスポートされたラベルファイルで利用可能になり、PLC によって予約されます。このフィールドには、プラグインの実行中にプラグインによって常に更新される 16 ビットカウンタが含まれます。これにより、MERLIC と PLC 間の接続を監視し、それに応じて PLC プログラムを構成することで、予期しないエラーで接続が失われても対処できるようになります。PLC プロトコルで使用されるフィールドの詳細については、「PLC との通信のためのフィールド」を参照してください。
5.6.0 より前のバージョンの MERLIC で構成された MELSEC Communication プラグインが使用されている既存の GX Works2 または GX Works3 プロジェクトを、この MERLIC バージョンの MERLIC RTE で使用したい場合は、プロトコルのバージョン「1.0」を使用するか、新しい PLC プロトコルに応じてプラグインとプロジェクトの構成を調整する必要があります。
Heartbeat interval
このパラメーターは、ハートビートの間隔をミリ秒単位で定義します。デフォルト設定値は 1000 ms です。これは、ハートビートカウンタのフィールド「gMV_Heartbeat」が 1000 ms ごとに更新されることを意味します。ハートビートモードの詳細については、エラー処理のセクション「gMV_Heartbeat」を参照してください。
このパラメーターは、ハートビートモードをサポートするプロトコルのバージョンが使用されている場合、つまり「Protocol version」が「1.1」に設定されている場合にのみ使用できます。したがって、パラメーター「Protocol version」が「1.0」に設定されている場合、構成でこのパラメーターは無効になります。
Result Handling Behavior
このカテゴリのパラメーターは、結果の検索に関する設定を定義します。さまざまなモードの結果処理の詳細については、結果モードを参照してください。
以下の図では、パラメーターの概要と、それぞれのデフォルト設定を示しています。パラメーターについては、図の後に詳細な説明があります。
Result mode
このパラメーターを使用すると、結果を照会するモードを選択できます。「Free-running」と「Dequeue from buffer」から選択できます。パラメーターの設定値はデフォルトで「Dequeue from buffer」です。以下の表では、各モードを簡単に説明しています。
|
モード |
説明 |
|---|---|
|
Free-running |
このモードでは、単一実行または連続実行の結果は、ハンドシェイクメカニズムなしで PLC のそれぞれのメモリアドレスに即座に書き込まれます。このモードは最も高速ですが、最もエラーが発生しやすいモードでもあります。MERLIC および PLC のタイミングによっては、PLC が結果を収集する前に、結果の一部が失われたり上書きされたりする可能性があります。 |
|
Dequeue from buffer |
このモードでは、内部 FIFO キューを使用して、単一実行または連続実行の開始後に受信する結果を保存します。PLC が「gMV_ReqCommandCode」を 10 に設定して結果をリクエストした場合、バッファの最初の結果が PLC の各メモリアドレスに書き込まれます。リクエストされた結果は、すぐにキューから除去されます。 |
Result buffer capacity
このパラメーターは、結果モードとして「Dequeue from buffer」を使用する場合に、結果を一時的に保存するために使用するバッファのサイズを定義します。これはバッファに保存できる結果の数を表します。デフォルト設定値は 10 です。
このパラメーターは、「Dequeue from buffer」が結果モードに設定されている場合にのみ使用されます。「Result mode」が「Free-running」に設定されている場合は無効です。したがって、「Free-running」モードが選択されている場合は、構成のために無効にされます。
DequeueResult command timeout
このパラメーターは、新しい結果を待機するときの「Dequeue from buffer」モードのタイムアウトを定義します。PLC が結果をリクエストし、それぞれの結果がまだ利用できない場合、他のすべての要求は、結果が利用可能になるまで、または指定されたタイムアウトが期限切れになるまでブロックされます。デフォルトでは、タイムアウトは 1000 ms に設定されます。
このパラメーターは、「Dequeue from buffer」が結果モードに設定されている場合にのみ使用されます。「Result mode」が「Free-running」に設定されている場合は無効です。したがって、「Free-running」モードが選択されている場合は、構成のために無効にされます。
Writing Data to PLC Memory
このカテゴリのパラメーターは、PLC に転送できる結果の数を定義します。データタイプごとに目的の数を個別に設定する必要があります。使用するすべての MERLIC レシピ、つまり、 レシピで参照されているすべての MERLIC Vision Apps に関して、構成が適合していることを確認します。
デフォルトでは、結果は PLC に転送されません。したがって、まずはこのカテゴリのパラメーターを適切に調整し、データタイプごとに目的の結果の数を設定する必要があります。
結果を転送可能にする方法
- 必要な結果の数やそのデータタイプがわからない場合は、次のように確認できます。
- MERLIC Creator を開き、MERLIC レシピで参照されている MERLIC Vision App を読み込みます。
- 「MVApp パラメーターおよび結果」パネルに移動し、転送する各 MVApp 結果 のデータタイプを見つけます。各データタイプの目的の結果の合計数を確認します。目的の結果をすべて転送できるようにするためには、プラグイン構成の中で、対応するパラメーターを最低でもこの値に設定する必要があります。
- 使用するすべての MVApps、つまり、アプリケーションで使用する MERLIC レシピで参照されている MVApps に関して、MVApp 結果 を確認します。
- MERLIC RTE Setup の「通信」タブで、MELSEC Communication プラグインの目的のインスタンスを選択し、カテゴリ「Writing Data to PLC Memory」のパラメーターに移動します。
- このカテゴリのそれぞれのプラグインパラメーターで、各データタイプで転送可能にする結果の数を設定します。使用するすべての MVApps に適合する値であることを確認します。
たとえば、MVApps にデータタイプ INT の MVApp 結果 が最大 5 つまで含まれている場合、すべての INT 結果の値を PLC に利用できるように、パラメーター「INT (signed 16-bit integer) result allocation」を 5 以上に設定する必要があります。
特定のデータタイプの結果がプラグイン構成で指定されたより多く送信される場合は、すべてのパラメーターを使用できるわけではありません。PLC で十分な メモリアドレス が予約されてはいないからです。一方、それぞれのデータタイプに指定された数よりも少ない結果が転送される場合、PLC で予約されているすべての devices が使用されるわけではありません。
フィールドと割り当てメモリ
このカテゴリのユーザーパラメーターを設定することで、データタイプごとに PLC が転送できる結果の数を定義します。転送可能なそれぞれの結果に対し、いわゆるフィールドが予約されています。フィールドは、それぞれの結果値に使用される PLC 上の特定のメモリブロックを表します。ただし、それ以外のコンテンツやコマンドのためのフィールド、たとえば現在の状態やコマンドをリクエストするためのフィールドもあります。各フィールドには定義済みの名前があります (たとえば 「gMV_CurrentState」)。
各データタイプに必要なメモリ
次の表は、各データタイプで必要なメモリ、つまり、それぞれのデータタイプの 1 つの値に必要なメモリアドレスの数を示しています。
|
結果のデータタイプ |
必要なメモリアドレス (= 2 バイト) |
|---|---|
|
BOOL |
1 ビットのメモリアドレス |
|
INT |
1 |
|
DINT |
2 |
|
REAL |
2 |
|
LREAL |
4 |
|
STRING[32] |
16 |
|
WORD |
1 |
|
DWORD |
2 |
例
このセクションでは、2 つの結果を PLC に転送できるようにプラグインを構成する方法の例について説明し、PLC で割り当てられるフィールドを示します。
MVApp にデータタイプ INT の MVApp 結果 がちょうど 2 つ含まれていて、両方の結果を転送できるようにするには、プラグイン構成でそれぞれのユーザーパラメーターを設定する必要があります。結果のデータタイプは INT であることから、パラメーター「INT (signed 16-bit integer) result allocation」を設定する必要があります。この例では、PLC がデータタイプ INT の結果を 2 つまで照会できるよう、パラメーターを 2 以上に設定する必要があります。
プラグインの構成を保存した後で、パラメーターカテゴリ「Export Symbols」で定められているように、対応するフィールドのセットをエクスポートできます。PLC 用プログラムを実装する場合、エクスポートしたファイルは通信に必要なフィールドとメモリブロックの入力として機能します。この例の構成では、プラグインは以下の 3 つのフィールドを割り当てます。
|
フィールド |
説明 |
|---|---|
|
gMV_ResultUseArray_INT |
このフィールドは、INT の結果が照会可能かどうかを示します。結果が利用可能かどうかを示すフィールドは、常に結果値のフィールドより前に表示されます。 |
|
gMV_Result_INT_0 |
このフィールドは、INT のインデックス 0 の結果の値に使用されます。追加される数字は、MERLIC Creator 内の MVApp 結果 の概要における結果のインデックスに相当します。したがって、INT のインデックス 0 の結果は、MVApp 結果 の概要における最初の INT の結果を表します。 |
|
gMV_Result_INT_1 |
このフィールドは、INT のインデックス 1 の結果の値に使用されます。追加される数字は、MERLIC Creator 内の MVApp 結果 の概要における結果のインデックスに相当します。したがって、INT のインデックス 1 の結果は、MVApp 結果 の概要における 2 番目の INT の結果を表します。 |
INT 結果が 1 つしか転送されない場合、PLC で予約されているすべてのレジスタが使用されるわけではありません。しかし、データタイプ INT の結果が 2 つを超えて送信される場合、たとえば、準備されたレシピの MVApp に INT 結果が 3 つ以上含まれている場合でも、PLC によって照会されるのは最初の 2 つの結果だけです。プラグインは 2 つの INT 結果用のレジスタアドレスしか予約しないからです。
以下の図は、パラメーターの概要を示しています。パラメーターについては、図の後に詳細な説明があります。
Head device number
このパラメーターは、プラグインによってプロトコルに書き込まれ、PLC によって読み取られるすべての値 (たとえば、現在の状態や結果値など) のために PLC で予約されるブロックの最初のメモリアドレスを定義します。
デフォルトでは 0 に設定されており、D0 に対応します。
BOOL (Bit) result allocation
このパラメーターは、PLC に転送できる Boolean 結果の数を定義します。たとえば、最大 5 つの Boolean を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり Boolean の結果は転送されません。
このデータタイプのパラメーターは、きっかり 1 ビットを必要とします。したがって、最大 16 の結果が選択されていれば、メモリアドレスのきっかり 1 ビットが Boolean 結果のフィールドにマッピングされます。指定された device の中の個々の結果は、たとえば、D30.0、D30.1、...、D30.f のように、16 進数でアドレス指定されます。16 以上の Boolean の結果が返された場合、各結果にフィールドを提供するために、さらにメモリアドレスがマッピングされます。
WORD (unsigned 16-bit integer) result allocation
このパラメーターは、PLC に転送できる WORD 結果の数を定義します。たとえば、最大 5 つの WORD を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり WORD の結果は転送されません。
このデータタイプのパラメーターは、きっかり 1 つの device に対応する、きっかり 16 ビットを必要とします。そのため、たとえば D31 のように、device 全体のアドレスがマッピングされることになります。
DWORD (unsigned 32-bit integer) result allocation
このパラメーターは、PLC に転送できる DWORD 結果の数を定義します。たとえば、最大 5 つの DWORD を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり DWORD の結果は転送されません。
このデータタイプのパラメーターは、きっかり 2 つの devices に対応する、きっかり 32 ビットを必要とします。そのため、2 つの devices が予約されていますが、たとえば、アドレス D32 と D33 を使用する場合は D32 というように、最初のアドレスのみがマッピングされます。
INT (signed 16-bit integer) result allocation
このパラメーターは、PLC に転送できる INT 結果の数を定義します。たとえば、最大 5 つの INT を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり INT の結果は転送されません。
このデータタイプのパラメーターは、きっかり 1 つの device に対応する、きっかり 16 ビットを必要とします。そのため、たとえば D34 のように、device 全体のアドレスがマッピングされることになります。
DINT (signed 32-bit integer) result allocation
このパラメーターは、PLC に転送できる DINT 結果の数を定義します。たとえば、最大 5 つの DINT を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり DINT の結果は転送されません。
このデータタイプのパラメーターは、きっかり 2 つの devices に対応する、きっかり 32 ビットを必要とします。そのため、2 つの devices が予約されていますが、たとえば、アドレス D35 と D36 を使用する場合は D35 というように、最初のアドレスのみがマッピングされます。
REAL (single-precision floating-point) result allocation
このパラメーターは、PLC に転送できる REAL 結果の数を定義します。たとえば、最大 5 つの REAL を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり REAL の結果は転送されません。
このデータタイプのパラメーターは、きっかり 2 つの devices に対応する、きっかり 32 ビットを必要とします。そのため、2 つの devices が予約されていますが、たとえば、アドレス D37 と D38 を使用する場合は D37 というように、最初のアドレスのみがマッピングされます。
LREAL (double-precision floating-point) result allocation
このパラメーターは、PLC に転送できる LREAL 結果の数を定義します。たとえば、最大 5 つの LREAL を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり LREAL の結果は転送されません。
このデータタイプのパラメーターは、きっかり 4 つの devices に対応する、きっかり 64 ビットを必要とします。そのため、4 つの devices が予約されていますが、たとえば、アドレス D39 ～ D42 を使用する場合は D39 というように、最初のアドレスのみがマッピングされます。
STRING[32] result allocation
このパラメーターは、PLC に転送できる STRING[32] 結果の数を定義します。たとえば、最大 5 つの STRING[32] を転送する場合は、このパラメーターを 5 以上に設定します。
デフォルトでは、パラメーターの設定値は 0 です。つまり STRING[32] の結果は転送されません。
このデータタイプのパラメーターは、きっかり 16 の devices に対応する、きっかり 32 バイト (256 ビット) を必要とします。そのため、16 の devices が予約されていますが、たとえば、アドレス D43 ～ D58 を使用する場合は D43 というように、最初のアドレスのみがマッピングされます。
Reading Data from PLC Memory
このカテゴリのパラメーターは、データタイプごとに PLC に提供できる反復パラメーターの数を定義します。反復パラメーターは、MVApp の実行の引数となるパラメーターを表し、準備中のレシピで指定されている対応する MVApp パラメーター の値を上書きします。これにより、レシピを変更する必要なく、他の入力値で MVApp を実行できます。つまり、このカテゴリのパラメーターは、データタイプごとにいくつのパラメーター値を実行時に PLC によって上書きできるかを定義します。
デフォルトでは、PLC による構成に利用できる反復パラメーターはありません。したがって、まずはこのカテゴリのパラメーターを適切に調整し、データタイプごとに目的の反復パラメーターの数を設定する必要があります。
反復パラメーターを使用可能にする方法
特定の MVApp パラメーター の値を PLC が上書きして実行できるようにしたい場合は、それぞれのデータタイプのパラメーターを間違いなく適切に設定する必要があります。
- 必要な反復パラメーターの数やそのデータタイプがわからない場合は、次のように確認できます。
- MERLIC Creator を開き、MERLIC レシピで参照されている MERLIC Vision App を読み込みます。
- 「MVApp パラメーターおよび結果」パネルに移動し、PLC を通じて設定する各 MVApp パラメーター のデータタイプを見つけます。各データタイプの目的の反復パラメーターの合計数を確認します。PLC を通じて目的の反復パラメーターをすべて設定できるようにするためには、プラグイン構成の中で、対応するパラメーターを最低でもこの値に設定する必要があります。
- 使用するすべての MVApps、つまり、アプリケーションで使用する MERLIC レシピで参照されている MVApps に関して、MVApp パラメーター を確認します。
- MERLIC RTE Setup の「通信」タブで、MELSEC Communication プラグインの目的のインスタンスを選択し、カテゴリ「Reading Data from PLC Memory」のパラメーターに移動します。
- このカテゴリのそれぞれのプラグインパラメーターで、上書きを可能にする反復パラメーターの数を設定します。使用するすべての MVApps に適合する値であることを確認します。
たとえば、MVApps にデータタイプ INT の MVApp パラメーター が最大 3 つまで含まれている場合、このデータタイプの MVApp パラメーター をすべて PLC 経由で調整できるように、パラメーター「INT (signed 16-bit integer) iteration parameter allocation」を 3 以上に設定する必要があります。
プラグイン構成は、PLC が実行時にそれぞれの MVApp パラメーター を上書きするために利用できる反復パラメーターがいくつであるかだけを定義します。ただし、指定された反復パラメーターを使用する必要はありません。また、PLC は、反復パラメーターを使用せずに、単一実行または連続実行をリクエストすることもできます。この場合、MVApp はそれぞれのレシピに定義された値で実行されます。
レシピのパラメーター値を上書きする反復パラメーターを指定する場合、PLC はいくつかの要件を考慮する必要があります。指定するパラメーター値の数は、レシピファイルに定義されている値の数に対応する必要があります。しかも、そのデータタイプはレシピの各パラメーター値のデータタイプにロスレスで変換できるものでなければなりません。これらの条件が満たされない場合、反復パラメーターのセット全体が破棄され、代わりにデフォルト値でレシピが実行されます。この場合、「gMV_ErrorCode」および「gMV_ErrorCause」フィールドでも警告が出されます。詳細については、通信プラグイン開発マニュアルのAvailable Actionsのパラメーター「MV_PARAM_START_PARAMS」にある対応ルールの説明を参照してください。
フィールドと割り当てメモリ
このカテゴリのユーザーパラメーターを設定することで、データタイプごとに PLC が設定できる反復パラメーターの数を定義します。PLC が構成に利用できるそれぞれの反復パラメーターに対し、いわゆるフィールドが予約されています。つまり、反復パラメーターに必要なメモリを割り当てる必要があるということです。そのように割り当てるには、このカテゴリの各ユーザーパラメーターの値を、それぞれのデータタイプで PLC に使用できるようにする反復パラメーターの数に設定します。使用可能なフィールドの詳細については、PLC との通信のためのフィールドを参照してください。
各データタイプに必要なメモリの詳細については、カテゴリ「Writing Data to PLC Memory」の説明の中のセクションフィールドと割り当てメモリを参照してください。
例
このセクションでは、PLC が反復パラメーターを上書きできるようにプラグインを構成する方法の例について説明し、PLC で割り当てられるフィールドを示します。
レシピに、データタイプ INT の 2 つの MVApp パラメーター と、データタイプ STRING_80 の 1 つの MVApp パラメーター パラメーターが含まれていて、PLC によりこれらのパラメーターの値を単一実行または連続実行で上書きできるようにしたい場合、次のようにパラメーターを設定する必要があります。
|
ユーザーパラメーター |
値 |
|---|---|
|
INT (signed 16-bit integer) iteration parameter allocation |
2 |
|
STRING[32] iteration parameter allocation |
1 |
現在のレシピに 2 つの INT パラメーターと 1 つの STRING_80 パラメーターしかない場合に、それより大きな値を設定することも可能です。しかし、この例では、プラグイン構成の値が上の表のとおりに設定されていると仮定します。
プラグインの構成を保存した後で、パラメーターカテゴリ「Export Symbols」で定められているように、対応するフィールドのセットをエクスポートできます。PLC 用プログラムを実装する場合、エクスポートしたファイルは通信に必要なフィールドとメモリブロックの入力として機能します。この例の構成では、プラグインは以下のフィールドを割り当てます。
|
割り当てられるフィールド |
説明 |
|---|---|
|
gMV_ItParamUseArray_INT |
このフィールドは、データタイプ INT のレシピパラメーターが、次回の単一実行または連続実行のために、「gMV_ItParam_INT_0」と「gMV_ItParam_INT_1」で定義された値で上書きされるかどうかを示す指標として機能します。 |
|
gMV_ItParamUseArray_STRING32 |
このフィールドは、データタイプ STRING_80 のレシピパラメーターが、次回の単一実行または連続実行のために、「gMV_ItParam_STRING32_0」で定義された値で上書きされるかどうかを示す指標として機能します。 |
|
gMV_ItParam_INT_0 |
このフィールドは、データタイプ MVApp パラメーター の INT とインデックス 0、つまりレシピの最初の INT パラメーターの新しい値を定義するために備えられています。 接尾辞として追加される数字は、レシピパラメーターのインデックスを示します。この例では、データタイプ INT の最初のレシピパラメーターを指します。レシピパラメーターのリストとそれぞれのインデックス番号は、MERLIC Creator 内の MVApp パラメーター の概要にも表示されます。 |
|
gMV_ItParam_INT_1 |
このフィールドは、データタイプ MVApp パラメーター の INT とインデックス 1、つまりレシピの 2 番目の INT パラメーターの新しい値を定義するために備えられています。 接尾辞 1 で示されるように、このフィールドはデータタイプ INT の 2 番目のレシピパラメーターを参照します。 |
|
gMV_ItParam_STRING32_0 |
このフィールドは、データタイプ MVApp パラメーター の STRING_80 とインデックス 0、つまりレシピの STRING_80 パラメーターの新しい値を定義するために備えられています。 接尾辞 0 で示されるように、このフィールドはデータタイプ STRING_80 の最初のレシピパラメーターを指します。 |
新しいフィールドは、準備中のレシピで参照されている MVApp を実行するためのパラメーター値を指定するために使用できます。
この例では、2 つの INT パラメーターと 1 つの STRING_80 パラメーターを持つレシピが用意されていると想定します。次の実行でパラメーターを上書きするには、PLC はパラメーターの希望値をそれぞれのフィールドに設定し、3 つのパラメーター値すべてを次の「StartSingleJob」または「StartContinuous」コマンドで使用するように指定する必要があります。つまり、PLC は以下のフィールドに値を設定する必要があります。
|
フィールド |
説明 |
|---|---|
|
gMV_ItParamUseArray_INT |
この配列の最初の 2 つのビットを 1 に |
|
gMV_ItParamUseArray_STRING32 |
このフィールドの値は 1 に (または TRUE に) 設定する必要があります。これは、「gMV_ItParam_STRING32_0」の値を次の実行に使用することを示します。 |
|
gMV_ItParam_INT_0 |
このフィールドは、レシピで定義された値の代わりに、最初の INT パラメーターに使用される整数値を含みます。 |
|
gMV_ItParam_INT_1 |
レシピで定義された値の代わりに、2 番目の INT パラメーターに使用される整数値に設定する必要があります。 |
|
gMV_ItParam_STRING32_0 |
これらのフィールドにおける WORDS の順序は、レシピで定義された値の代わりに、STRING_80 パラメーターに使用される値に設定する必要があります。 |
PLC により新しい「StartSingleJob」または「StartContinuous」コマンドがリクエストされると、プラグインは次の実行に反復パラメーターの指定値を使用します。レシピの値は、フィールド「gMV_ItParamUseArray_INT」および「gMV_ItParamUseArray_STRING32」が上記のように設定されている限り、つまり値が 0 にリセットされるまで、それぞれの「StartSingleJob」および「StartContinuous」コマンドで上書きされます。反復パラメーターが「使用中」に設定されていない場合、レシピで定義されたデフォルト値が再度使用されます。
以下の図は、パラメーターの概要を示しています。パラメーターについては、図の後に詳細な説明があります。
Head device number
このパラメーターは、PLC で予約されているブロックの最初の メモリアドレス を定義します。このブロックには、PLC によってプロトコルに書き込まれ、プラグインによって読み取られるすべての値、たとえばリクエストされたコマンドや反復パラメーターの値などが含まれます。デフォルトでは 100 に設定されており、D100 に対応します。
あるいは、パラメーターを大きな数値に設定して、メモリが重複する可能性を最小に抑えることもできます。
Polling cycle time for ReqCommandCode
このパラメーターは、「gMV_ReqCommandCode」フィールドの値を読み取るサイクルを定義します。
デフォルトではこれは
BOOL (Bit) iteration parameter allocation
このパラメーターは、PLC から Boolean に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の Boolean 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 1 ビットを必要とします。したがって、メモリアドレスのきっかり 1 ビットが Boolean 反復パラメーターのフィールドにマッピングされます。指定された device の中の個々の反復パラメーターは、たとえば、D112.0、D112.1、...、D112.f のように、16 進数でアドレス指定されます。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_BOOL」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の Boolean パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_BOOL」フィールドの値を
WORD (unsigned 16-bit integer) iteration parameter allocation
このパラメーターは、PLC から WORD に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の WORD 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 1 つの device に対応する、きっかり 16 ビットを必要とします。そのため、たとえば D113 のように、device 全体のアドレスがマッピングされることになります。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_WORD」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の WORD パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_WORD」フィールドの値を
DWORD (unsigned 32-bit integer) iteration parameter allocation
このパラメーターは、PLC から DWORD に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の DWORD 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 2 つの devices に対応する、きっかり 32 ビットを必要とします。そのため、2 つの devices が予約されていますが、たとえば、アドレス D114 と D115 を使用する場合は D114 というように、最初のアドレスのみがマッピングされます。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_DWORD」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の DWORD パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_DWORD」フィールドの値を
INT (signed 16-bit integer) iteration parameter allocation
このパラメーターは、PLC から INT に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の INT 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 1 つの device に対応する、きっかり 16 ビットを必要とします。そのため、たとえば D116 のように、device 全体のアドレスがマッピングされることになります。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_INT」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の INT パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_INT」フィールドの値を
DINT (signed 32-bit integer) iteration parameter allocation
このパラメーターは、PLC から DINT に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の DINT 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 2 つの devices に対応する、きっかり 32 ビットを必要とします。そのため、2 つの devices が予約されていますが、たとえば、アドレス D117 と D118 を使用する場合は D117 というように、最初のアドレスのみがマッピングされます。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_DINT」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の DINT パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_DINT」フィールドの値を
REAL (single-precision floating-point) iteration parameter allocation
このパラメーターは、PLC から REAL に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の REAL 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 2 つの devices に対応する、きっかり 32 ビットを必要とします。そのため、2 つの devices が予約されていますが、たとえば、アドレス D119 と D120 を使用する場合は D119 というように、最初のアドレスのみがマッピングされます。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_REAL」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の REAL パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_REAL」フィールドの値を
LREAL (double-precision floating-point) iteration parameter allocation
このパラメーターは、PLC から LREAL に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の LREAL 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 4 つの devices に対応する、きっかり 64 ビットを必要とします。そのため、4 つの devices が予約されていますが、たとえば、アドレス D121 ～ D124 を使用する場合は D121 というように、最初のアドレスのみがマッピングされます。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_LREAL」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の LREAL パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_LREAL」フィールドの値を
STRING[32] iteration parameter allocation
このパラメーターは、PLC から STRING[32] に転送できるデータタイプ MERLIC の反復パラメーター数を定義します。たとえば、PLC がレシピで定義された最大 5 つの MVApp パラメーター の STRING[32] 値を上書きできるようにするには、パラメーターを 5 に設定します。
パラメーターの設定値はデフォルトで「0」です。つまり、このデータタイプのパラメーターについては、プロトコルにフィールドが追加されません。
このデータタイプのパラメーターは、きっかり 16 の devices に対応する、きっかり 32 バイト (256 ビット) を必要とします。そのため、16 の devices が予約されていますが、たとえば、アドレス D125 ～ D140 を使用する場合は D125 というように、最初のアドレスのみがマッピングされます。
さらに、別のフィールドが追加されます。「gMV_ItParamUseArray_STRING32」です。このフィールドは PLC によって使用され、レシピで提供されたパラメーター値を、次の実行のために、それぞれの反復パラメーターのフィールドで定義された値で上書きするかどうかを示します。
このデータタイプで利用可能な各反復パラメーターについて、PLC はそれを実行に使用するかどうかをビット単位で定義する必要があります。たとえば、このパラメーターを 2 に設定し、次の実行で両方の STRING[32] パラメーターを使用したい場合、PLC は「gMV_ItParamUseArray_STRING32」フィールドの値を
Global Label CSV Export
このカテゴリのパラメーターは、プラグインの起動時にプラグインの構成に基づいてエクスポートされるファイルの場所と名前を定義します。このファイルはプラグインの構成に基づいており、PLC によって予約されるすべてのフィールドの
ファイルは .csv ファイル (カンマ区切り値ファイル) としてフォーマットされ、PLC プログラムのプロジェクトにインポートできます。
以下の図では、パラメーターの概要と、それぞれのデフォルト設定を示しています。パラメーターについては、図の後に詳細な説明があります。
Environment
このパラメーターは、ラベルのエクスポート先になるアプリケーションを定義します。次の表に載っている GX Works バージョンから選択できます。エクスポートされた「Global Label」ファイルは、選択されたアプリケーションの要件に従ってフォーマットされます。デフォルト設定値は「GX Works2」です。正しいアプリケーションを選択してください。そうしないと、GX Works バージョンのプロジェクトに .csv ファイルをインポートする際にエラーが発生する可能性があります。
|
値 |
説明 |
|---|---|
|
GX Works2 |
エクスポートされた「Global Label」ファイルは、GX Works2 の要件に従ってフォーマットされます。 |
|
GX Works3 |
エクスポートされた「Global Label」ファイルは、GX Works3 の要件に従ってフォーマットされます。 |
Locale
このパラメーターは、「Global Label」ファイルのエクスポートで使用する言語を定義します。正確に言うと、エクスポートされるファイルの見出しに使う言語を決定します。現在は、次の表に示す設定から選択できます。デフォルト設定値は「en-US」です。
|
値 |
説明 |
|---|---|
|
en-US |
英語 (米国) |
|
ja-JP |
日本語 (日本) |
GX Works で .csv ファイルをインポートする際にエラーにならないように、間違いなく正しい言語を選択してください。GX Works を英語版で使用する場合は「en-US」を、日本語版で使用する場合は「ja-JP」を選択する必要があります。
Output directory
このパラメーターは、ファイルが保存されるディレクトリを定義します。
ボタンを介してファイルシステムからディレクトリを選択することも (ローカルシステムの場合)、テキストフィールドに直接パスを入力することもできます。デフォルトでは、Windows システムでは「%LOCALAPPDATA%/Temp」に、Linux システムでは「/tmp」に設定されています。
Output file name
このパラメーターで、エクスポートファイルの名前を定義します。テキストフィールドで直接名前を変更することができます。デフォルト設定値は「gMV_GlobalLabels.csv」です。
