Skip to main content

FANUC Robot Interface

Purpose

This plugin collects bits, words, and robot status through FANUC Robot Interface. It can also write IO or poses after site safety has been confirmed. It is named FanucRobotInterfaceMaster in the device selector.

See Collection Configuration for common channel, device, and variable operations. This page covers only Robot Interface settings, addresses, methods, and debug tools.

Open the plugin

Open Development Configuration → Collection Configuration, create a TCP client channel, then create a device using FanucRobotInterfaceMaster. Robot Interface uses TCP port 60008 by default.

Supported scope

ItemDescription
ChannelTCP client. Enter the robot IP and Robot Interface port.
Data typesBoolean, Byte, common signed/unsigned integers, Float, and Double.

Plugin properties

SettingDefaultDescription
Client ID1024Client identifier used when the Robot Interface session is established.
Text encodingGB2312Decodes fixed-length text in the status snapshot.
Maximum word batch6130Maximum WORD count combined in one polling request.
Maximum bit batch8192Maximum bit count combined in one polling request.

Keep the batch limits at their defaults unless the controller requires lower values.

Address rules

AreaExamplesDescription
WORDD1, AI1, AQ1, GI1, GO1Addresses start at 1.
Register groupsR1 to R10, SR1 to SR6Use the controller mapping.
BitsI1, Q1, M1, SDO1, SDI1, RDI1, RDO1, UI1, UO1, SI1, SO1Addresses start at 1; bits are decoded from low to high.

A bit write replaces every bit in the padded byte. Bits omitted from that byte can be cleared, so submit the complete bit values that must be retained.

Special methods

Choose the method under the variable's Special Method field and enter the listed arguments in the variable address field.

Selector valuePurposeArguments
ReadWordsAsyncRead a raw word areaselector=8/10/12,address,length
WriteWordsAsyncWrite a raw word areaselector=8/10/12,address,value=even byte array
ReadBitsAsyncRead a raw bit areaselector=70/72/76,address,length
WriteBitsAsyncWrite a raw bit areaselector=70/72/76,address,value=Boolean array
ReadSdoAsync / WriteSdoAsyncRead/write SDORead: address,length; write: address,value
ReadSdiAsync / WriteSdiAsyncRead/write SDIRead: address,length; write: address,value
ReadRdiAsync / WriteRdiAsyncRead/write RDIRead: address,length; write: address,value
ReadRdoAsync / WriteRdoAsyncRead/write RDORead: address,length; write: address,value
ReadUiAsyncRead UIaddress,length
ReadUoAsync / WriteUoAsyncRead/write UORead: address,length; write: address,value
ReadSiAsyncRead SIaddress,length
ReadSoAsync / WriteSoAsyncRead/write SORead: address,length; write: address,value
ReadPmcr2Async / WritePmcr2AsyncRead/write PMCR2Read: address,length; write: address,value
ReadGiAsync / WriteGiAsyncRead/write GIRead: address,length; write: address,value=UInt16 array
ReadGoAsync / WriteGoAsyncRead/write GORead: address,length; write: address,value=UInt16 array
ReadSnapshotAsyncRead the status snapshotNo arguments
WriteCartesianPoseAsyncWrite a Cartesian poseaddress,xyzwpr=9 Floats,configuration=7 Int16s,userFrame,userTool
WriteJointPoseAsyncWrite a joint poseaddress,joint=9 Floats,userFrame,userTool

Functions

FunctionPurpose
Status snapshotUse Status snapshot to inspect mapped values, status, counters, recent messages, or the latest result.
Plugin operationUse the controls on this plugin page and review the returned result.
Control operationUse Control operation with an approved test point and confirm site safety before execution.

Device debug

Open Development Configuration → Collection Configuration, select this device, then open Debug → Protocol Debug · FanucRobotInterface.

FeaturePurpose
Status SnapshotReads the current robot status.
IOReads bit/word areas and performs approved writes.
Pose WriteWrites a Cartesian or joint pose.

Status snapshot

Refresh the robot status snapshot first. This is a read-only connection and status check.

FANUC Robot Interface status snapshot

IO

Select a bit or word area, enter the logical address and quantity, then read it. Writes change robot IO; UI and SI remain read-only in this panel.

FANUC Robot Interface IO debug

Pose write

Select Cartesian or Joint, then enter the address, pose array, user frame, and user tool.

FANUC Robot Interface pose write

Before writing IO or a pose, verify that the robot permits the operation, personnel are outside the hazardous area, and a stop measure is ready.

Verify the configuration

  1. Refresh Status Snapshot and compare it with the teach pendant.
  2. Read one known point under IO and verify its area, address, and result.
  3. Test a write only under approved site safety conditions, then immediately verify the robot state.

Troubleshooting

SymptomCheck
Cannot connectRobot IP, port 60008, network, firewall, and Robot Interface service.
Address read failsArea name, one-based logical address, quantity, and configured mapping.
Text is garbledText encoding and robot character set.
Adjacent bits changeSubmit the complete padded byte values that must be retained.