Difference between revisions of "Define the zero position offsets"

From Wiki
m (changed link)
 
(61 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
The robolink arms provide reference switches which allow a precise and reproducible referencing. The reference switches are inductive switches with metal pins as set points (motor encoder version) or hall sensors with magnets as set points (AE version).
+
Requirements: CPRog V902-10-032 or higher. See [[Software Updates]]. TinyCtrl V980-04-039. See [[TinyCtrl Downloads]].
−
The sensor positions are not the robots zero positions. Each joint module stores an offset value that defines the difference between the reference position and the zero position in encoder tics.  
 
  
−
When the combination of robot and control have been provided by CPR then these offsets are already defined in the modules. They are also written on the quality assurance sheet. If robot and control are not provided in combination the following steps should be performed.
 
−
This page shows how to find the offsets for your robot and how to set the into the joints modules.
 
  
 +
The robolink arms provide reference switches which allow a precise and reproducible referencing. The reference switches are inductive switches reacting to metal pins as set points (motor encoder version) or hall-effect sensors reacting to magnets as set points (AE version).
 +
 +
The positions of the sensors at the joints of the robot are not the [[#Move the robot into zero position|zero positions of the joints]]. Each joint module stores an offset value that defines the difference between the reference position and the zero position. The offset values are the number of encoder pulses between these two positions.
  
 +
<span style="color:#008000"> When the combination of robot and control electronics have been provided by CPR, then these offsets are already defined in the modules. They are also written down on the quality assurance sheet. </span>
  
−
----
+
<span style="color:#800000"> If robot and control have been supplied separately, we wouldn't have been able to do this calibration for you. Therefore the following steps should be performed.</span>
  
−
'''1. Set the offsets to zero'''
 
  
−
To find the correct offsets the current offset need to be removed.
+
This page shows how to find the offsets for your robot and how to set the into the joints modules.
  
−
* The offsets and further parameter are defined in the file c:\CPRog\Data\Robots\igus_5DOF_BV\igus_5DOF_BV_AmpParameter.dat with the last directory and the file name according to your robot type. Open this file. The entries are in the lines "Joint0" to "Joint4" in Tag "Offset".
+
=Backup the Current Firmware Parameter=
−
* Set all offsets to "0.0" and save the file. !!! Attention: Please use only "." (dot) as separator, not "," !!!
+
[[File:CPRogAmpConfig.JPG|400px|thumb|Backup Amp Configuration menu entry in CPRog]]
−
* Start CPRog and connect with the robot controller. The green LEDs on the robot controller should be blinking now.
 
−
* Open the CPRog menu on the circle in the upper left corner and press the button "Configuration / Load Amp Config"
 
−
* Confirm the upcoming warning, choose the .dat file you just changed and press "OK"
 
−
* Now the parameter with the zero offsets are uploaded to the modules. You can see the green LED of each module blinking for a second, then the next.
 
  
 +
To find the correct offsets, we need to know the current values:
 +
* Download your current firmware parameter from the electronic modules:
 +
# Start CPRog and "Connect" with the robot control electronics. Most of the [[media:DIN-Rail-Module-LEDs.png|green LEDs]] of the robot control electronics should be blinking now.
 +
# Open the CPRog menu on the circle in the upper left corner and press the menu item "Configuration --> Amp Config --> Backup current Config"
 +
# Now CPRog loads the current parameter set from the modules and stores them in <code>c:\CPRog\Data\Backup\AmpParamBackup_yourdateandtime.dat</code>
 +
# Make a copy of this file so that you are able to restore the old data
  
−
----
+
<br clear=all>
  
−
'''2. Reference the robot'''
+
=Reference the robot=
  
 
Perform a referencing of the robot arm. Follow the instructions on page [[Referencing robolink]].
 
Perform a referencing of the robot arm. Follow the instructions on page [[Referencing robolink]].
  
 +
=Move the robot into zero position=
  
−
 
+
[[File:Robolink_5SV_ZeroPosition.PNG|400px|thumb|Zero position of the robolink 5DOF SV robot]]
−
----
 
−
 
 
−
'''3. Move the robot into zero position'''
 
  
 
Now we jog the robot arm into the zero position to find the offsets between reference position and zero position.
 
Now we jog the robot arm into the zero position to find the offsets between reference position and zero position.
  
 
* Start CPRog and connect / reset / enable the robot arm
 
* Start CPRog and connect / reset / enable the robot arm
−
* Jog the robot into a zero position as shown in the picture above. Joint 1 points into +X direction, joint 2 points upwards, joints 3 and 4 point forward into +X direction again.  
+
* Jog the robot into the zero position as shown in the picture on the right. Joint 1 points into +X direction, joint 2 points upwards, joints 3 and 4 point forward into +X direction.  
−
* At first move with e.g. 30% override. Then do the fine tuning with e.g. 5% override. Use a spirit level to find the precise angle.
+
* At first move with e.g. 30% [[override]]. Then do the fine tuning with e.g. 5% [[override]]. Use a spirit level or a laser tool to make sure you are in the zero position.
−
* The fifth axis should be set according to the connected gripper. Or, when no gripper is connected, mark the zero position and set to this.
+
** Note: the joint '''holes''' define the zero position, not the sheet metal surfaces!
 +
* The fifth axis should be set according to the connected gripper. If no gripper is connected, mark the zero position and set to this.
 
* Press the "Reset" button in CPRog to load the current hardware position.
 
* Press the "Reset" button in CPRog to load the current hardware position.
  
 +
<br clear=all>
  
−
----
+
=Calculate the offsets=
−
 
 
−
'''4. Calculating the offsets'''
 
  
 
Now we can see the offset in degree in the CPRog user interface. But we need to calculate the offset in encoder tics.
 
Now we can see the offset in degree in the CPRog user interface. But we need to calculate the offset in encoder tics.
  
−
* Open the Microsoft Excel file c:\CPRog\Data\Robots\igus_5DOF_BV\FindingTheOffset_5DOF-BV.xlsx (adapt according to your robot type)
+
* Open the Microsoft Excel file [https://www.cpr-robots.com/download/CPRog/FindingTheOffset_robolink.xlsx FindingTheOffset_robolink.xlsx]
−
* Check if the entries regarding the gear ratios are correct. You can find the gear ratios in the igus documentation.
+
** also found in c:\CPRog\Data\Robots\FindingTheOffset.xlsx  
−
* Copy the current joint values from the CPRog user interface to the table, column "Joint values at zero"
+
** Last file version: Dec. 06th, 2019
−
* In the next column the new offsets are calculated.
+
* In the file choose the right [[Configuration_Files_Overview#Which_files_do_I_need_for_my_robot_.28example.29.3F|robot type]]
 +
* Follow the instructions in the sheet
 +
* Attention: The offset values written in the AmpParameter file are numbers (no decimal . or ,)
  
 +
=Uploading the offsets to the modules=
  
−
----
+
Now we set the new offsets in the .dat file that we backuped before and upload them to the modules.
  
−
'''5. Uploading the offsets to the modules'''
+
* Open the .dat file from above and set the "Offset" values as calculated in the table. Use only numbers! (no decimal values, no "," or ".")
 +
* Save the .dat file and upload the parameter:
 +
# Open the CPRog menu on the circle in the upper left corner and press the menu item "Configuration --> Amp Config --> Set new Configuration"
 +
# Confirm the upcoming warning, choose the updated .dat file you just changed and press "OK"
 +
# Now the parameter with the new offsets are uploaded to the modules. You can see the green LED of each module blinking for a second, then the next.
  
−
Now we set the new offsets in the .dat file and upload them to the modules.
+
=Final Test=
  
−
* Open the .dat file from above and set the "Offset" values as calculated in the table. Do not use "," but only "." as seperators!
+
The new offsets should be verified:
−
* Save the .dat file and upload the parameter as in section 1.
 
  
−
 
+
* Switch off the robot control electronics and CPRog
−
 
+
* Wait at least 5 seconds to start the control electronics and CPRog again
−
----
 
−
 
 
−
'''6. Final Test'''
 
−
 
 
−
The new offsets should be tested if the are correct.
 
−
 
 
−
* Switch off the robot control and CPRog
 
−
* After min. 5 seconds start the control and CPRog again
 
 
* Connect / Reset / Enable the robot
 
* Connect / Reset / Enable the robot
 
* Reference the robot
 
* Reference the robot
 
* Jog the robot so that all joint values are zero. The real robot should be in the zero position now.
 
* Jog the robot so that all joint values are zero. The real robot should be in the zero position now.
  
 +
=Documentation=
 +
* Please write down the offsets or store the .dat file in a folder different then the CPRog program directory. When you update CPRog you custom .dat file might be overwritten. So it is necessary to store your custom file in a different location.
  
−
----
 
  
−
'''7. Documentation'''
+
For questions or comments please get [[Support Routes|into contact with us]]
−
* Please write down the offsets or store the .dat file in a folder different then the CPRog program directory. When you update CPRog you custom .dat file might be overwritten. So it is necessary to store your custom file in a different location.
+
[[Category:CPRog]]
  
  
−
For questions or comments please get in contact with us: info(at)cpr-robots.com
+
[[Category:CPRog v980-10-XXX]]

Latest revision as of 10:03, 16 August 2023

Requirements: CPRog V902-10-032 or higher. See Software Updates. TinyCtrl V980-04-039. See TinyCtrl Downloads.


The robolink arms provide reference switches which allow a precise and reproducible referencing. The reference switches are inductive switches reacting to metal pins as set points (motor encoder version) or hall-effect sensors reacting to magnets as set points (AE version).

The positions of the sensors at the joints of the robot are not the zero positions of the joints. Each joint module stores an offset value that defines the difference between the reference position and the zero position. The offset values are the number of encoder pulses between these two positions.

When the combination of robot and control electronics have been provided by CPR, then these offsets are already defined in the modules. They are also written down on the quality assurance sheet.

If robot and control have been supplied separately, we wouldn't have been able to do this calibration for you. Therefore the following steps should be performed.


This page shows how to find the offsets for your robot and how to set the into the joints modules.

Backup the Current Firmware Parameter

Backup Amp Configuration menu entry in CPRog

To find the correct offsets, we need to know the current values:

  • Download your current firmware parameter from the electronic modules:
  1. Start CPRog and "Connect" with the robot control electronics. Most of the green LEDs of the robot control electronics should be blinking now.
  2. Open the CPRog menu on the circle in the upper left corner and press the menu item "Configuration --> Amp Config --> Backup current Config"
  3. Now CPRog loads the current parameter set from the modules and stores them in c:\CPRog\Data\Backup\AmpParamBackup_yourdateandtime.dat
  4. Make a copy of this file so that you are able to restore the old data


Reference the robot

Perform a referencing of the robot arm. Follow the instructions on page Referencing robolink.

Move the robot into zero position

Zero position of the robolink 5DOF SV robot

Now we jog the robot arm into the zero position to find the offsets between reference position and zero position.

  • Start CPRog and connect / reset / enable the robot arm
  • Jog the robot into the zero position as shown in the picture on the right. Joint 1 points into +X direction, joint 2 points upwards, joints 3 and 4 point forward into +X direction.
  • At first move with e.g. 30% override. Then do the fine tuning with e.g. 5% override. Use a spirit level or a laser tool to make sure you are in the zero position.
    • Note: the joint holes define the zero position, not the sheet metal surfaces!
  • The fifth axis should be set according to the connected gripper. If no gripper is connected, mark the zero position and set to this.
  • Press the "Reset" button in CPRog to load the current hardware position.


Calculate the offsets

Now we can see the offset in degree in the CPRog user interface. But we need to calculate the offset in encoder tics.

  • Open the Microsoft Excel file FindingTheOffset_robolink.xlsx
    • also found in c:\CPRog\Data\Robots\FindingTheOffset.xlsx
    • Last file version: Dec. 06th, 2019
  • In the file choose the right robot type
  • Follow the instructions in the sheet
  • Attention: The offset values written in the AmpParameter file are numbers (no decimal . or ,)

Uploading the offsets to the modules

Now we set the new offsets in the .dat file that we backuped before and upload them to the modules.

  • Open the .dat file from above and set the "Offset" values as calculated in the table. Use only numbers! (no decimal values, no "," or ".")
  • Save the .dat file and upload the parameter:
  1. Open the CPRog menu on the circle in the upper left corner and press the menu item "Configuration --> Amp Config --> Set new Configuration"
  2. Confirm the upcoming warning, choose the updated .dat file you just changed and press "OK"
  3. Now the parameter with the new offsets are uploaded to the modules. You can see the green LED of each module blinking for a second, then the next.

Final Test

The new offsets should be verified:

  • Switch off the robot control electronics and CPRog
  • Wait at least 5 seconds to start the control electronics and CPRog again
  • Connect / Reset / Enable the robot
  • Reference the robot
  • Jog the robot so that all joint values are zero. The real robot should be in the zero position now.

Documentation

  • Please write down the offsets or store the .dat file in a folder different then the CPRog program directory. When you update CPRog you custom .dat file might be overwritten. So it is necessary to store your custom file in a different location.


For questions or comments please get into contact with us

Retrieved from "http://wiki.cpr-robots.com/index.php?title=Define_the_zero_position_offsets&oldid=3383"