Tool Configuration

Robot tools, like grippers, are defined in separate configuration files that can be easily swapped or shared between different projects. This article explains how to configure a robot to use a tool and how to configure an existing tool or create a new one.

See also category Tool.

Changing Tools

Tool configuration in CPRog

To change the tool in CPRog or iRC open the project configuration area and the Tool section. Select the tool next to "Tool type", then click "Apply" to apply the changes without saving or "Save project" to save the change to the current project.

To change the tool configuration of an embedded control (TinyCtrl) connect CPRog or iRC to the robot via Ethernet, then open the configuration area and click "Apply" or "Save project".

Troubleshooting

If the tool can not be applied to the embedded control the tool configuration file most likely is unavailable. In order to fix this find the configuration file in the data directory of CPRog/iRC, e.g.:

C:\CPRog\Data\Tools\<ToolName>.xml

Copy this file to the embedded control using a SFTP client:

/home/root/TinyCtrl/Data/Tools/<ToolName>.xml

Configuring a Tool

Tools are configured in XML files (find the paths as described in the previous section). Optionally 3d graphics files may be used to visualize the tool in CPRog/iRC.

Basic configuration

The structure of the tool configuration looks like this:

<?xml version="1.0" encoding="utf-8"?>
<Tool>
  <INFO NAME="ParallelGripper" AUTHOR="Christian Meyer" />
  <OFFSET OffsetX="0" OffsetY="0" OffsetZ="105" OffsetA="0.0" OffsetB="0" OffsetC="0.0" />
  <CAD FileStandard="FestoPG_open.obj" FileActive="FestoPG_closed.obj" FlipMesh="True" />
  <KINEMATIC Motion="Digital" MotionVel="10" />
  <INTERFACE Protocol="digital" ChannelOpenClose="11" ChannelEnable="12" />
</Tool>

• INFO defines information that don't affect functionality
• OFFSET defines the offset (position and rotation) of the tool center point, relative to the tool base
• CAD defines optional 3D mesh files for visualization
• KINEMATIC defines how the tool motion is calculated
• INTERFACE specifies how the tool is controlled

Kinematic

If Motion is set to Digital the visualization only shows if the tool is open or closed (or active/inactive).

If you need more control over the motion you can use the linear kinematic. This allows to specify how the gripper claw moves.

<KINEMATIC Motion="Linear" MotionMin="10" MotionMax="100.0" MotionVel="15.0" MotionOffsetX="0.0" MotionOffsetY="0.0" MotionOffsetZ="0.0"/>

Interface

Choose Protocol="digital" if your tool is controlled by digital outputs. Enter the DOut channel numbers at ChannelOpenClose and ChannelEnable.

Alternatively you can use Protocol="bus", if the tool is controlled like a joint, e.g. if it is connected to a motor module. You can configure the following parameters:

• BusID: CAN bus ID
• GearScale: Gear ratio
• GearZero: Zero position offset
• MaxCurrent, CurrentScale, CurrentZero: Current settings
• Bus: Bus type (currently not relevant for CAN-based connections)
• Torque: Currently not relevant for CAN-based connections
• ComplianceSlope: Currently not relevant for CAN-based connections

Visualization

You may specify two 3D mesh files for visualization in the CAD-tag, FileStandard and FileActive.

If Kinematic is set to digital FileStandard is used for the open state and FileActive for the closed state. If Kinematic is set to linear FileActive will be animated as specified in Kinematic.