標準インターフェースコマンド
FANUCで標準インターフェースを用いてロボットプログラミングを行う際は、以下の点にご注意ください。
-
複数のパラメータはコンマで区切る必要があります。
-
すべてのパラメータはプログラムファイル内でローカル変数として定義する必要があります。
-
パラメータは入力パラメータと出力パラメータと定義します。
この標準インターフェースはTCP/IPプロトコルを介して通信を行います。
通信の初期化
Mech-Visionプロジェクトの実行
このコマンドを実行すると、Mech-Visionプロジェクトが実行され、カメラ撮影とビジョン処理による認識が行われます。Mech-Vizを使用せずMech-Visionを使用する場合に使用します。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Job |
Mech-Visionのプロジェクト番号は、Mech-Visionのプロジェクトリストで確認できます。プロジェクト名の前の数字は、プロジェクト番号を表します。 |
Pos_Num_Need |
ビジョンポイントの期待数で、Mech-Visionから取得したいビジョンポイントの数です。設定可能な範囲は0~20で、0に設定するとすべてのビジョンポイントが取得されます。 |
SendPos_Type |
ロボット位置姿勢のタイプで、ロボット実機の位置姿勢がMech-Visionに送信される形式を指定します。パラメータ範囲は0~3です。
|
Pr_Num |
PRレジスタ番号で、事前定義されたロボットの関節角度を保存するために使用されます(PRレジスタのデータ形式を関節角度に変更)。このレジスタの関節角度データは、SendPos_Type=3の場合のみ使用されます。 |
ビジョン目標点の取得
Mech-Visionプロジェクト起動後、ビジョン処理による認識結果を取得するために、このコマンドが使われています。Mech-Vizを使用せずMech-Visionを使用する場合に使用します。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Job |
Mech-Visionのプロジェクト番号は、Mech-Visionのプロジェクトリストで確認できます。プロジェクト名の前の数字は、プロジェクト番号を表します。 |
出力パラメータ |
|
Reg_Pos_Num |
返された位置姿勢の数を保存するためのレジスタです。範囲は1~20です。 |
Reg_Status |
ステータスコードを記録するためのレジスタです。詳細については、 標準インターフェースのステータスコード一覧とトラブルシューティング をご参照ください。 |
Mech-Vizプロジェクトの実行
このコマンドを実行すると、Mech-Vizプロジェクトが実行され、対応するMech-Visionを呼び出してロボットの動作経路を計画します。Mech-VisionとMech-Vizの両方を使用する場合に使用します。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
SendPos_Type |
ロボット位置姿勢のタイプです。パラメータ範囲は0~2です。
|
Pr_Num |
PRレジスタ番号で、事前定義されたロボットの関節角度を保存するために使用されます(PRレジスタのデータ形式を関節角度に変更)。このレジスタの関節角度データは、SendPos_Type=2の場合のみ使用されます。 |
Mech-Vizによって計画された動作経路を取得
このコマンドは、Mech-Vizプロジェクトから計画された動作経路を取得するために使用されます。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Jps_Pos |
取得する経路におけるポイントのタイプを設定します。
|
出力パラメータ |
|
Reg_Pos_Num |
取得したビジョンポイントの数を記録するためのレジスタです。範囲は1~20です。 |
Reg_VPos_Num |
最初の「ビジョン処理による移動」が経路全体における位置番号を記録するためのレジスタです。
|
Reg_Status |
ステータスコードを記録するためのレジスタです。詳細については、 標準インターフェースのステータスコード一覧とトラブルシューティング をご参照ください。 |
ビジョンポイント座標の取得
関節角度を取得(Mech-Vizを使用する場合にのみ有効)
Mech-Visionのパラメータレシピの切替
Mech-Visionのレシピ機能は異なるワークの認識に使用される場合、画像マッチングテンプレート、ROI、信頼性のしきい値など、Mech-Visionプロジェクトの各ステップのパラメータを変更することができます。このコマンドは、 MM_START_VIS の前に実行する必要があります。
Mech-Viz分岐を選択
Mech-Vizプロジェクトに「メッセージによって異なる分岐を実行」ステップがある場合、このコマンドはMech-Vizにある「メッセージによって異なる分岐を実行」ステップを指定された出口に沿って実行し続けることを制御します。このコマンドを呼び出す前に、 MM_START_VIZ を呼び出す必要があります。Mech-Vizは「メッセージによって異なる分岐を実行」ステップに実行すると、 MM_SET_BCH が出口を送信するのを待ちます。
移動インデックスを設定
このコマンドはMech-Vizステップの 現在のインデックス パラメータを設定する場合に使われます。このパラメータが設定可能なステップは「リストによる移動」、「グリッドによる移動」、「カスタマイズのパレットパターン」、「事前計画パレットパターン」などです。このコマンドを呼び出す前に、 MM_START_VIZ を実行する必要があります。
ソフトウェアのステータスを取得
Mech-Vision、Mech-Viz、Mech-Centerの実行ステータスを取得するために使用されます。現在、Mech-Visionのプロジェクトステータスを確認できます。
パラメータ
パラメータ | 説明 |
---|---|
出力パラメータ |
|
MM_Status |
ステータスコードを記録するためのレジスタです。詳細については、 標準インターフェースのステータスコード一覧とトラブルシューティング をご参照ください。 |
Mech-Visionプロジェクトへ対象物の寸法を送信
吸盤のDO信号を取得
このコマンドは、Mech-VisionまたはMech-Vizによって計画された吸盤のDO信号を取得するために使用されます。ロボットは MM_SET_DL により、取得されたDO信号をロボットハンドに適用します。
吸盤のDO信号を設定
このコマンドは、Mech-VisionまたはMech-Vizソフトウェアが返すDOリストを汎用出力信号に設定するために使用されます。
このコマンドは、 MM_GET_DL の後に呼び出す必要があります。 |
キャリブレーション
カメラの外部パラメータをキャリブレーションするときに使用します。Mech-Visionのカメラキャリブレーション機能と連動してキャリブレーションを自動的に行います。詳細については、『キャリブレーションの操作手順』をご参照ください。
Mech-Visionから通知メッセージを取得
このコマンドは、Mech-Visionの「通知」ステップからのメッセージを取得するために使用されます。有効するには、 Mech-Visionプロジェクトの実行 または Mech-Vizプロジェクトの実行 と一緒に使用する必要があります。
Mech-Visionプロジェクトで「通知」ステップのパラメータ設定は以下の要件があります。
-
「サービス名」パラメータをStandard Interface Notifyに設定する必要があります。
-
「メッセージ」は、ロボット側が必要なデータを示し、正の整数である必要があります。
Mech-Visionのカスタマイズされたデータを取得
このコマンドは、Mech-Visionの「出力」ステップからカスタマイズされたデータを受け取るために使用されます。posesとlabels以外のポートのデータを受け取ります(ステップパラメータ「ポートタイプ」を「カスタム」に設定する場合)。
Mech-Visionから取得したカスタマイズされたデータをレジスタ変数に保存
このコマンドは、Mech-Visionから取得したカスタマイズされたデータを指定したロボットのレジスタ変数に保存するために使用されます。 Mech-Visionのカスタマイズされたデータを取得 を実行した後に使用します。
「ビジョン処理による移動」の計画データまたはカスタマイズされたデータを取得
このコマンドは、Mech-Visionプロジェクトの「ビジョン処理による移動」の計画結果、またはMech-Vizプロジェクトの「ビジョン処理による移動」の計画結果またはカスタマイズされたデータを取得するために使用されます。MM_GET_PLJOP により、取得したデータを各変数に割り当てることができます。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Resource |
「ビジョン処理による移動」の計画結果のソースを指定します。
|
Jps_Pos |
返されたデータの予期形式で、範囲は1~4です。 |
出力パラメータ |
|
Reg_Pos_Num |
Rレジスタ番号で、取得した経路点の数を保存するために使用されます。範囲は1~50です。 |
Reg_VPos_Num |
Rレジスタ番号で、最初のビジョン処理による移動が経路計画における位置番号を保存するために使用されます。 |
Reg_Status |
Rレジスタ番号で、返されたステータスコードを保存するために使用されます。 |
-
Resourceが0の場合、Jps_Pos パラメータの値の範囲は1~4です。
Jps_Pos パラメータ値 返されたデータの予期形式 説明 1
位置姿勢(JPs形式),移動方式,ツール番号,速度,カスタマイズされたデータ1,...,カスタマイズされたデータN
2
位置姿勢(TCP形式),移動方式,ツール番号,速度カスタマイズされたデータ1,...,カスタマイズされたデータN
3
位置姿勢(JPs形式),移動方式,ツール番号,速度,Mech-Vizの「ビジョン処理による移動」の計画結果,カスタマイズされたデータ1,...,カスタマイズされたデータN
4
位置姿勢(TCP形式),移動方式,ツール番号,速度,Mech-Vizの「ビジョン処理による移動」の計画結果,カスタマイズされたデータ1,...,カスタマイズされたデータN
-
Resourceが正整数の場合、Jps_Pos パラメータの値の範囲は1~2です。
Jps_Pos パラメータ値 返されたデータの予期形式 説明 1
位置姿勢(JPs形式)、移動方式、ツール番号、速度、Mech-Visionの「ビジョン処理による移動」の計画結果
2
位置姿勢(TCP形式)、移動方式、ツール番号、速度、Mech-Visionの「ビジョン処理による移動」の計画結果
位置姿勢
経路点の位置姿勢は、ロボット関節角度(JPs、単位は度)、ツール位置姿勢(TCP、3次元座標はミリメートル、オイラー角は度)のいずれかであり、その形式は送信するコマンドパラメータに依存します。
移動方式
-
1:関節運動。
-
2:直線運動。
ツール番号
ロボットがその経路点に移動するときに使用するロボットハンドの番号です。-1である場合、ロボットハンドが使用されないことを示します。
速度
経路点の速度値です。
「ビジョン処理による移動」の計画結果
Mech-VisionまたはMech-Vizの「ビジョン処理による移動」ステップが計画されたデータのことで、把持するワークのラベル、把持されたワークの合計数、今回把持されたワークの数、吸盤のエッジコーナー番号、TCPオフセット、ワーク群の向き、単体ワークの向き、ワーク群の寸法が含まれます。
カスタイズされたデータ
Mech-Visionプロジェクトの「出力」ステップでポートタイプが「カスタム」に設定された場合に出力されたposesとlabelsポート以外のカスタマイズされたポートのデータです。 カスタマイズされたデータは、ポート名のA–Zの順に並べられています。
MM_GET_PLNDTから取得したデータを変数に保存
このコマンドは 「ビジョン処理による移動」の計画データまたはカスタマイズされたデータを取得 の後に使用され、取得したデータを異なる変数に格納するために使用されます。
プログラム
MM_GET_PLJOP(Serial,Jps_Pos,Pr_Num,Reg_MoveType,Reg_ToolNum,Reg_Speed,Reg_UserData,Reg_PlanRes)
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Serial |
保存する経路点を指定します。 |
Jps_Pos |
「ビジョン処理による移動」の計画データまたはカスタマイズされたデータを取得 コマンドのJps_Posの設定値と同じです。 |
出力パラメータ |
|
Pr_Num |
指定した経路点が対応する位置姿勢を保存するためのPR レジスタ番号です。 |
Reg_MoveType |
指定した経路点が対応する移動方式を保存するためのRレジスタ番号です。1は関節運動、2は直線運動を示します。 |
Reg_ToolNum |
指定した経路点が対応するツール番号を保存するためのRレジスタ番号です。-1である場合、ロボットハンドが使用されないことを示します。 |
Reg_Speed |
Rレジスタ番号で、指定した経路点が対応する移動速度を保存するために使用されます。 |
Reg_UserData |
PR レジスタ番号で、指定した経路点が対応するカスタマイズされたデータを保存するために使用されます。これは開始番号で、カスタマイズされたデータの数に応じて順番に保存します。現在対応している最大数は50となります。 |
Reg_PlanRes |
指定した経路点が対応する「ビジョン処理による移動」の計画結果を保存するためのRレジスタ番号です。これは開始番号となり、「ビジョン処理による移動」の計画結果の数に応じて順番に保存します。現在の数は21となります。 |
「ビジョン処理による移動」の計画結果の詳細を下表に示します。
データ | 説明 | 対応するRレジスタ番号 |
---|---|---|
把持するワークのラベル |
10個の整数で構成され、デフォルトは10個のゼロです。 |
Reg_PlanRes~Reg_PlanRes+9 |
把持されたワークの合計数 |
累計で把持されたワークの数です。 |
Reg_PlanRes+10 |
今回把持されたワークの数となります。 |
今回把持されたワークの数となります。 |
Reg_PlanRes+11 |
吸盤のエッジコーナー番号 |
この吸盤に使用されているエッジコーナー番号です。 |
Reg_PlanRes+12 |
TCPオフセット |
ロボットハンド中心からのワーク群の中心のXYZオフセットです。 |
Reg_PlanRes+13~Reg_PlanRes+15 |
ワーク群の向き |
吸盤の長辺に対するワーク群の向きです。0は平行、1は垂直を意味します。 |
Reg_PlanRes+16 |
単体ワークの向き |
吸盤の長辺に対する単体ワークの向きです。0は平行、1は垂直を意味します。 |
Reg_PlanRes+17 |
ワーク群の寸法 |
今回把持されたワーク群の長さ、幅、高さです。 |
Reg_PlanRes+18~Reg_PlanRes+20 |
Mech-Visionの「経路計画」ステップの結果を取得
Mech-Visionプロジェクトを実行した後、このコマンドはMech-Visionプロジェクトの「経路計画」ステップから出力された衝突のない把持経路を取得するために使用されます。
このコマンドを使用する時、Mech-Visionの「出力」ステップの ポートタイプ を「事前定義済み(ロボット経路)」に設定する必要があります。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Job |
Mech-Visionのプロジェクト番号は、Mech-Visionのプロジェクトリストで確認できます。プロジェクト名の前の数字は、プロジェクト番号を表します。 |
Jps_Pos |
このパラメータは、「経路計画」ステップから返された経路点の位置姿勢タイプを指定するために使用されます。
|
出力パラメータ |
|
Reg_Pos_Num |
Rレジスタ番号で、返された経路点の数を保存するために使用されます。範囲は1~20です。 |
Reg_VPos_Num |
経路計画設定ツールで設定された「ビジョン処理による移動」が経路全体における位置を保存するために使用されます。
|
Reg_Status |
Rレジスタ番号で、返されたステータスコードを保存するために使用されます。 |
Mech-Vizのステップパラメータを読み取る
このコマンドは、Mech-Vizプロジェクトで指定されたステップパラメータの値を読み取るために使用されます。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Read_id |
このパラメータは、property_configファイルで指定された 構成ID フィールドとなります。 |
出力パラメータ |
|
Reg_Status |
ステータスコードを記録するためのレジスタです。詳細については、 標準インターフェースのステータスコード一覧とトラブルシューティング をご参照ください。 |
Reg_Viz_Prop |
指定されたステップの返されるパラメータ値を保存するためのRレジスタ番号で、現在INT整数値のみを返すことをサポートしています。 |
Mech-Visionでは、ツールバーの をクリックし、 プロパティ設定 をクリックしてproperty_configファイルを開きます。 |
このコマンドを使用する前に、あらかじめproperty_configファイルに、ステップ番号と、パラメータ名に対応するキー名を、以下の形式で指定しておく必要があります。
read,構成ID,ステップ番号,パラメータ名に対応するキー名
read |
ステップパラメータ値の読取りに使用する行を指定します。 |
構成ID |
唯一の番号を正の整数で指定します。1つの構成IDは、1つのステップパラメータ値を読み取るためにのみ使用できます。複数のステップパラメータ値を読み取る場合は、異なる構成IDを使用してください。 |
ステップ番号 |
読み取るパラメータが属するステップの番号を指定します。 |
キー名 |
読み込むパラメータに対応するキー名を指定します。 |
|
property_configファイルには複数のreadコマンドを設定することができますが、各readコマンドの構成IDは一意である必要があります。 |
Mech-Vizのステップパラメータを設定
このコマンドは、Mech-Vizプロジェクトで指定されたステップパラメータの値を設定するために使用されます。
パラメータ
パラメータ | 説明 |
---|---|
入力パラメータ |
|
Write_id |
このパラメータは、property_configファイルで指定された 構成ID フィールドとなります。 |
出力パラメータ |
|
Reg_Status |
ステータスコードを記録するためのレジスタです。詳細については、 標準インターフェースのステータスコード一覧とトラブルシューティング をご参照ください。 |
Mech-Visionでは、ツールバーの をクリックし、 プロパティ設定 をクリックしてproperty_configファイルを開きます。 |
このコマンドを使用する前に、あらかじめproperty_configファイルに、ステップ番号、パラメータ名に対応するキー名とパラメータ値を、以下の形式で指定しておく必要があります。
write,構成ID,ステップ番号,パラメータ名に対応するキー名,パラメータ値
write |
ステップパラメータ値の設定に使用する行を指定します。 |
構成ID |
番号(一意でない)を正の整数で指定します。 |
ステップ番号 |
設定するパラメータが属するステップの番号を指定します。 |
キー名 |
設定するパラメータに対応するキー名を指定します。 |
パラメータ値 |
設定するパラメータ値を指定します。 |
|
サンプル
例えば、property_configファイルの内容は、1が構成ID、3がステップ番号、xOffset、yOffset、zOffsetがキー名、10がxOffsetに対応するパラメータ値、20がyOffsetに対応するパラメータ値、30がzOffsetに対応するパラメータ値を示します。
write, 1, 3, xOffset, 10
write, 1, 3, yOffset, 20
write, 1, 3, zOffset, 30
ロボットが以下のコマンドを送信した後、Mech-VizはxOffset、yOffsetとzOffsのパラメータ値をそれぞれ10、20と30に設定します。
MM_SET_PROP(1,10)
このサンプルを実行すると、xOffset、yOffsetとzOffsに対応するパラメータ値がそれぞれ10、20と30に設定され、返されたステータスコードがR[10]レジスタに保存されます。