ABB標準インターフェースコマンド

現在ご覧いただいているのは最新版の内容です（V1.3.0）。異なるバージョンを参照する場合は、画面右上のボタンから切り替えが可能です。

■ ご利用中のバージョンが分からない場合や、サポートが必要な場合はお気軽にサポート窓口までご連絡ください。

本節では、ABBロボットとMech-Mindインライン測定システム間でTCPプロトコル通信を行うための標準インターフェースコマンドについて説明します。そのうち、ロボット（クライアント側）はMech-Mindインライン測定システム（サーバー）にコマンドを送信し、Mech-Mindインライン測定システムは処理後のデータをロボットに返します。

コマンド一覧

コマンド 呼び出し必須か 説明

通信初期化

必須

ロボットと通信するIPCのIPアドレス、ポート番号、および通信タイムアウトの待ち時間を設定する

TCPプロトコル通信接続の確立

必須

ロボットとインライン測定システム間のTCPプロトコルによる通信接続を確立する

TCPプロトコル通信接続の切断

必須

ロボットとインライン測定システム間のTCPプロトコルによる通信接続を切断する

プロジェクトの切り替え

任意

ロボットがMech-Metricsにプロジェクトの切り替え開始を通知する

測定タスクの開始

必須

ロボットが Mech-Metrics に新しいワークの測定開始を通知し、ワーク名、ワークSN、およびその他のワーク情報を Mech-Metrics に送信する

特徴測定の実行

必須

対応する測定特徴の Mech-MSR プロジェクトの実行をトリガーする。複数回の測定を行う必要がある場合は、このコマンドを複数回呼び出す可能

測定タスクの終了

必須

ロボットが Mech-Metrics に測定終了を通知し、ワークの測定結果を問い合わせる

測定中のワークSN入力

任意

一部のユースケースでは、測定開始時にワークSNを取得できない。例えば、測定中にバーコードやQRコードをスキャンして取得しなければならない。このコマンドは、ワーク測定中にワークSNを入力するために使用する

ワーク履歴データの照会

任意

ワークSNを入力することで、Mech-Metrics ソフトウェアのメイン画面を対応するワークのデータビューに切り替える

キャリブレーション

必須（自動キャリブレーションプログラムの場合）

ロボットのハンドアイキャリブレーション（外部パラメータキャリブレーション）に使用する

注意事項

これらのコマンドを使用する前に、以下の事項に注意してください。

  • ABBロボットコマンドの呼び出しに関する説明：

    • コマンドの仮引数リスト内の各パラメータは半角カンマで区切ります。

    • 各仮引数変数はローカル変数として定義され、該当するコマンド内でのみ有効です。

    • コマンドの仮引数リストは、入力パラメータおよび出力パラメータの定義に対応しています。

    • 通信接続と通信切断のステートメントは2つの独立したコマンド（TCPプロトコル通信接続の確立およびTCPプロトコル通信接続の切断）であり、これによりロボットとビジョンシステム間の頻繁な接続・切断を回避します。

  • コマンドのデータ単位：

    • 関節角度の単位は度（°）です。

    • ロボットのフランジ位置姿勢またはロボットのツール位置姿勢は位置と姿勢で構成されています。位置（XYZ座標値）の単位はミリメートル（mm）、姿勢はオイラー角で表され、単位は度（°）です。

通信初期化

このコマンドは、ロボットと通信するIPCのIPアドレス、ポート番号、および通信のタイムアウト待ち時間を設定するために使用されます。

呼び出しのタイミング

このコマンドを使用した後、ユーザーはロボットとインライン測定システム間のTCPプロトコル通信接続を確立するには、TCPプロトコル通信接続の確立を呼び出す必要があります。初期化は一度だけ実行すればよいです。

コマンド形式

MSR_Init_Socket(string IP_Address,num Server_Port,num Time_Out)

入力パラメータ

IP_Address

このパラメータはIPCのIPアドレスを示します。データ型はstringです。

Server_Port

このパラメータは、IPCがロボットと通信を確立するために使用するポート番号を示します。このパラメータ値は、Mech-MSR ソフトウェアのTCP・ASCII通信設定（標準通信方式）で設定されたホストポート番号と一致している必要があります。データ型はnumです。

Time_Out

このパラメータは通信タイムアウトの待ち時間を示し、単位は秒です。データ型はnumです。

サンプル

MSR_Init_Socket "192.168.1.20", 50000, 300;

上記のサンプルは、ロボットが接続するIPCのIPアドレスが192.168.1.20、ポート番号が50000、タイムアウト待ち時間が300秒であることを示しています。

TCPプロトコル通信接続の確立

このコマンドは、ロボットとオンライン測定システム間のTCPプロトコルによる通信接続を確立するために使用します。

呼び出しのタイミング

このコマンドは、通信初期化コマンドの直後に呼び出す必要があります。

コマンド形式

MSR_Open_Socket(num MSR_Status)

出力パラメータ

MSR_Status

このパラメータは、コマンドのステータスコードを保存するために使用します。

-99：ロボット通信異常。

TCPプロトコル通信接続の切断

このコマンドは、ロボットとオンライン測定システム間のTCPプロトコルによる通信接続を切断するために使用します。

呼び出し順序

Mech-MSR プロジェクトの結果を取得した後、ユーザーは直ちにこのコマンドを呼び出して通信接続を切断し、その後、取得した結果を指定の変数に保存することができます。通信接続が長時間切断されない場合、ロボットプログラムが異常切断エラーを引き起こす可能性があります。

コマンド形式

MSR_Close_Socket

プロジェクトの切り替え

ロボットが Mech-Metrics にプロジェクト切り替えの開始を通知します。

呼び出しのタイミング

プロジェクト切り替えを開始する前。

コマンド形式

MSR_SW_PROJ(num Robot_Id,num Job,INOUT num MSR_Status)

入力パラメータ

Robot_Id

このパラメータはワーク番号を示します。ワーク番号は1から99までの整数です。指定するワーク番号は、ワーク番号を設定画面で既に設定されている必要があります。データ型はnumです。

Job

このパラメータはプロジェクト番号を示します。指定するプロジェクト番号は、あらかじめプロジェクト切り替え管理で設定されている必要があります。データ型はnumです。

出力パラメータ

MSR_Status

このパラメータは、コマンドのステータスコードを保存するために使用します。

8105：コマンドの実行に成功しました。

-99：ロボット通信異常。

サンプル

MSR_SW_PROJ 1,1,MSR_Status;

上記のサンプルは、ワーク番号1、プロジェクト番号1のプロジェクトに切り替え、コマンドのステータスコードをMSR_Statusに保存することを示しています。

測定タスクの開始

ロボットが Mech-Metrics に新しいワークの測定開始を通知し、ワーク名、ワークSN、およびその他のワーク情報を Mech-Metrics に送信します。

呼び出しのタイミング

新しいワークの測定を開始する時点。

コマンド形式

MSR_Start_Measure(num RobotId,string PieceName,string PieceSn,num QcMode,num CustomValue1,num CustomValue2,num CustomValue3,num CustomValue4,num CustomValue5,num CustomValue6,num CustomValue7,num CustomValue8,INOUT num ContinuousMode,INOUT num MSR_Status)

入力パラメータ

RobotId

このパラメータはワーク番号を示します。ワーク番号は1から99までの整数です。指定するワーク番号は、ワーク番号を設定画面で既に設定されている必要があります。データ型はnumです。

PieceName

このパラメータは測定するワークの名称を示します。ワーク名には英数字を含めることができ、長さは20文字以内です。データ型はstringです。

PieceSn

このパラメータはワークSNを示します。ワークSNとは、ワークのシリアル番号のことであり、そのワークの一意の識別子（ID）です。ワークSNには英数字を含めることができ、長さは30文字以内です。データ型はstringです。

Qc_Mode

このパラメータはワークの品質検査モードを示します。データ型はnumです。各パラメータ値の意味は以下の通りです：

  • 1：全数検査

  • 2：抜取検査

  • その他：既存の設定を使用

CustomValue1-CustomValue8

このパラメータはオプションパラメータであり、ワークのカスタム情報を提供するために使用します。データ型はnumです。カスタムパラメータは、Mech-Metrics により多くのワーク情報を提供する必要がある場合にのみ使用されます。このコマンドでは、最大8つのカスタムパラメータを指定でき、各カスタムパラメータの値は1から8までの整数です。

カスタムパラメータを使用する場合：

  1. Mech-Metrics ソフトウェア設定画面の上部にある機能エリアで通信  通信コマンドを設定を選択し、指定のカスタムパラメータ（例：カスタムパラメータ1）に対してその数値（1〜8）の意味を設定します。

  2. このコマンドで指定のカスタムパラメータを設定します。

出力パラメータ

ContinuousMode

このパラメータは、今回の実行が連続実行か通常の実行かを示します。データ型はnumです。

0：実行

1：連続実行

実行が指定された場合、ロボット側は以下のコマンドを1回実行します：測定タスクの開始→特徴測定の実行→測定タスクの終了。複数の特徴を測定する場合は、特徴測定の実行コマンドを複数回実行してください。例えば、ユーザーが2つの特徴を測定したい場合、1回の実行において、ロボット側で以下のようにコマンドを実行する必要があります：プログラム開始→測定タスクの開始→特徴測定の実行→特徴測定の実行→測定タスクの終了→プログラム終了。

連続実行が指定された場合、ロボット側は1ラウンドのコマンドを実行した後、測定タスクの開始に戻って繰り返し実行します。あるラウンドにおいて測定タスクの開始が1回実行が返された場合、ロボットプログラムは現在のラウンドのコマンド実行完了後に停止します。

  • デフォルトでは、Mech-Metrics はロボットに0を返し、今回の実行が1回の実行であることをロボットに通知します。

  • 半動的繰り返し精度テストでは、Mech-Metrics はロボットに1を返し、今回の実行が連続運行であることをロボットに通知します。半動的繰り返し精度テストのプロセス中、ロボットを手動で移動させたり、ワークを手動でクランプしたりする必要がないため、ロボットは複数ラウンドのコマンドを連続実行できます。

 
MSR_Status

このパラメータは、コマンドのステータスコードを保存するために使用します。

8100：コマンドの実行に成功しました。

-99：ロボット通信異常。

サンプル

MSR_Start_Measure 1,"Piece01","ABC",2,1,2,3,4,5,6,7,8,outvalue,MSR_Status;

上記のサンプルは、番号1、名前「Piece01」、SN「ABC」のワークに対する測定開始を指定し、検査モードを抜取検査（2）に指定する。8つのカスタムパラメータ（1、2、3、4、5、6、7、8）を指定し、返された値の保存位置をoutvalueに指定すると同時に、コマンドのステータスコードをMSR_Statusに保存することを示しています。

特徴測定の実行

対応する特徴測定の Mech-MSR プロジェクト実行をトリガーします。

呼び出しのタイミング

ロボットが測定対象特徴の撮影位置に到達した時点。

コマンド形式

MSR_Measure_Feature(num RobotId,num Measure_Index,INOUT num MSR_Status)

入力パラメータ

RobotId

このパラメータはワーク番号を示します。ワーク番号は1から99までの整数です。指定するワーク番号は、ワーク番号を設定画面で既に設定されている必要があります。データ型はnumです。

Measure_Index

このパラメータは、測定対象となる特徴の測定番号を示します。データ型はnumです。測定番号はその特徴の一意の識別子（ID）です。測定特徴番号は1から999までの整数です。

出力パラメータ

MSR_Status

このパラメータは、コマンドのステータスコードを保存するために使用します。

8101：コマンドの実行に成功しました。

-99：ロボットの通信に異常が発生しました。

サンプル

MSR_Measure_Feature 1,1,MSR_Status;

上記のサンプルは、ロボット側からワーク番号1、測定対象特徴の測定番号1となる Mech-MSR プロジェクトの実行をトリガーし、ステータスコードをMSR_Statusに保存することを示しています。

測定タスクの終了

ロボットが Mech-Metrics に測定終了を通知し、ワークの測定結果を問い合わせます。

呼び出しのタイミング

最後の測定対象特徴の撮影が完了し、ワークの測定が完了した時点。

コマンド形式

MSR_End_Measure(num RobotId, INOUT num MeasureResult, INOUT num FailedCount{*},INOUT num MSR_Status)

入力パラメータ

RobotId

このパラメータはワーク番号を示します。ワーク番号は1から99までの整数です。指定するワーク番号は、ワーク番号を設定画面で既に設定されている必要があります。データ型はnumです。

出力パラメータ

MeasureResult

このパラメータはワークの判定結果を保存します。1はOK、0はNGを表します。データ型はnumです。

FailedCount{pass:[*]}

このパラメータはワークの測定項目数を保存します。データ型はnumです。詳細は以下の通りです：

  • FailedCount{1}ワークが公差1を超えた測定項目数を保存します。

  • FailedCount{2}ワークが公差2を超えた測定項目数を保存します。

  • FailedCount{3}ワークが公差2を超えた測定項目数を保存します。

MSR_Status

このパラメータは、コマンドのステータスコードを保存するために使用します。

8102：コマンドの実行に成功しました。

-99：ロボットの通信に異常が発生しました。

サンプル

MSR_End_Measure 1,measure_result,FailedCount;

上記のサンプルは、ロボットが Mech-Metrics に測定終了（ワーク番号1）を通知し、同時にワークの判定結果をmeasure_resultに、測定項目数をFailedCountに保存し、コマンドのステータスコードをMSR_Statusに保存することを示しています。

測定中のワークSN入力

一部のユースケースでは、測定開始時にワークSNを取得できない。例えば、測定中にバーコードやQRコードをスキャンして取得しなければなりません。このコマンドは、ワーク測定中にワークSNを入力するために使用する

呼び出しのタイミング

現在のワーク測定中の任意時点。

コマンド形式

MSR_Set_Piece_Info(num RobotId, string PieceSn,INOUT num MSR_Status)

入力パラメータ

RobotId

このパラメータはワーク番号を示します。ワーク番号は1から99までの整数です。指定するワーク番号は、ワーク番号を設定画面で既に設定されている必要があります。データ型はnumです。

PieceSn

このパラメータはワークSNを示します。ワークSNとは、ワークのシリアル番号のことであり、そのワークの一意の識別子（ID）です。ワークSNには英数字を含めることができ、長さは30文字以内です。データ型はstringです。

出力パラメータ

MSR_Status

このパラメータは、コマンドのステータスコードを保存するために使用します。

8103：コマンド実行成功。

-99：ロボット通信異常。

サンプル

MSR_Set_Piece_Info 1,"ABC",MSR_Status;

上記のサンプルでは、ロボットが Mech-Metrics にワークSN「ABC」のワークを入力し、コマンドのステータスコードを数値レジスタMSR_Statusに保存することを示しています。

ワーク履歴データの照会

外部からワークSNを入力することにより、Mech-Metrics ソフトウェアのメイン画面を入力された番号のワークに切り替えます。

呼び出しのタイミング

非測定中の任意時点。

コマンド形式

MSR_View_Piece_Data(num RobotId, string PieceSn,INOUT num MSR_Status)

入力パラメータ

RobotId

このパラメータはワーク番号を示します。ワーク番号は1から99までの整数です。データ型はnumです。

PieceSn

このパラメータはワークSNを示します。ワークSNとは、ワークのシリアル番号のことであり、そのワークの一意の識別子（ID）です。ワークSNには英数字を含めることができ、長さは30文字以内です。データ型はstringです。

出力パラメータ

MSR_Status

このパラメータは、コマンドのステータスコードを保存するために使用します。

8104：コマンドの実行に成功しました。

-99：ロボット通信異常。

サンプル

MSR_View_Piece_Data 1,"ABC",MSR_Status;

上記のサンプルは、ワークSN（ABC）を Mech-Metrics に入力し、Mech-Metrics ソフトウェアのメイン画面を該当ワークのデータビューに切り替え、コマンドのステータスコードをMSR_Statusに保存することを示しています。

キャリブレーション

このコマンドは、ロボットのハンドアイキャリブレーション（外部パラメータのキャリブレーション）に使用します。このコマンドは、Mech-MSRカメラメニューの3Dカメラキャリブレーションツールと組み合わせて使用する必要があります。

呼び出し順序

正式な測定を開始する前に、このコマンドを呼び出してロボットのハンドアイキャリブレーションを行う必要があります。

コマンド形式

MSR_Calib Move_Type,Pos_Jps,Wait_time\Ext;

入力パラメータ

{Move_Type}

このパラメータはロボットの移動タイプを示し、値の範囲が1または2です。

  • 1：直線運動

  • 2：関節運動

{Pos_Jps}

このパラメータは、キャリブレーションポイントの位置姿勢形式を指定するために使用し、値は1または2です。

  • 1：ツール位置姿勢

  • 2：関節角度

{Wait_time}

このパラメータは、ロボットがキャリブレーションポイントに移動した後の待ち時間（ロボットの振動・ブレを防止するため）を示します。単位は秒で、デフォルトは2秒です。データ型はnumです。

{Ext}

このパラメータは外部軸のデータを示し、単位はミリメートル（mm）です。現場に第7軸の走行レールがあり、かつロボットがそのレールの移動を制御する場合のみ、このパラメータに値を設定する必要があります。

出力パラメータ

TOP_Status

コマンドのステータスコードを保存するために使用します。

サンプル

  • サンプル 1：

    MSR_Calib 2,1,2;

    上記のサンプルは、キャリブレーションポイントの位置姿勢形式がツール位置姿勢であり、ロボットが関節角度形式でキャリブレーションポイントに移動した後の待ち時間が2秒であることを示しています。

  • サンプル 2：

    MSR_Calib 2,1,2\EXT:=Axis7;

    上記のサンプルは、キャリブレーションポイントの位置姿勢形式がツール位置姿勢であり、ロボットが関節角度形式でキャリブレーションポイントに移動した後の待ち時間が2秒、第7軸の値が Axis7 であることを示しています。

この情報は役に立ちましたか？

ご意見・ご要望がございましたら、以下よりお寄せください：

Mech-Mindは、お客様のプライバシーを重視しています

このサイトでは最高の体験を提供するために Cookie を使用しています。サイトの閲覧を続ける場合、Cookie の使用に同意したことになります。「拒否する」を選択すると、このサイトを訪れた際に追跡や記憶が行われないように単独の Cookie が使用されます。

  • Preference
  • 同意する
  • 拒否する