Changing Robot Parameters

From Wiki
Revision as of 13:02, 10 November 2020 by Mab (talk | contribs) (Added section for TinyCtrl, added joint accelerations)

CPRog/iRC and TinyCtrl use several robot specific parameters, e.g. maximum allowable joint velocities or the minimum and maximum allowable joint motion. These parameters are defined in XML files and can be adapted to the specific needs.

Caution.png !!! Please be aware that changing these parameters might lead to collisions and other problems! Change the parameters with care and in small increments. Perform tests after the changes !!!


Location of the parameter file

CPRog/iRC and the embedded control (TinyCtrl) both use their own set of configuration files. If you are using a robot with embedded control you will need to change the parameters there as well.

CPRog and iRC

The files containing the robot parameters are located in the robot directory in C:\CPRog\Data\Robots, e.g.:

C:\CPRog\Data\Robots\igus_5DOF_BV\igus_5DOF_BV.xml

To find out, which file you are using you can have a look at which file is referenced in your project file (see Which project configuration file am I currently using?). To find out, which robot file you should be using based on your robot, have a look at Robot Files and Project Files.

The robot file is written in XML format and can be opened with any text editor, such as Notepad++. Changes take effect after changing the file and restarting CPRog.

Attention: Use a dot "." as decimal separator, not a comma ","

Embedded control (TinyCtrl)

If you are using an embedded robot control you will need to change the robot configuration there as well. The article [FTP and putty Access] explains how to access the file using a SFTP client program. You can find the robot configuration similarly to CPRog in /home/root/TinyCtrl/Data/Robots, e.g.:

/home/root/TinyCtrl/Data/Robots/igus_5DOF_BV/igus_5DOF_BV.xml

Joint velocity

Example robot-parameters-file

The tag "JointVelocities" defines the maximum rotational velocitiy of each joint in °/s and optionally the maximum cartesian motion in mm/s.

<JointVelocities A1="500" A2="500" A3="300" A4="120" cart="500" />
  • During manual jogging only 50% of this velocity is allowed. The full velocity is reached during robot program replay with override at 100% and motion command velocity at 100%.
  • When increasing the velocity, problems may occur:
    • Overcurrent Error when the current consumption is too high.
    • Position Lag Error when the joints PID controller cannot reach the set point commands fast enough

Using the Config Software ModuleCtrl, it is possible to change the joint module parameters, such as motor current.

Joint acceleration

Similarly to the velocity limits the joint accelerations can be changed by setting the following parameters:

<JointAccelerations A1="3000" A2="3000" A3="3000" A4="400.0" A5="100.0" A6="100.0" />
<JointAccelerationIncs A1="9000" A2="9000" A3="9000" A4="1200.0" A5="100.0" A6="100.0" />
<CartAccelerations AccLin="3000" AccLinInc="9000" />

Joint min/max travel limits

The tag "SoftwareMinMax" defines the allowed motion ranges for the joints. It is not possible to move the joint out of these (virtual) boundaries.

<SoftwareMinMax A1Min="0" A1Max="500" A2Min="0" A2Max="500" A3Min="0" A3Max="100.0" A4Min="-179.0" A4Max="179.0" />

Note: When increasing these limits, collisions might occur that would have been prevented otherwise!


For questions or comments please get in contact with us.