Difference between revisions of "Motion Project Example: Cartesian Robot"

From SoftMC-Wiki
Jump to: navigation, search
m (→‎Running The Program)
(Added to Category:Robot Models)
 
(25 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
The following example show how to set a cartesian robot properties using [[softMC Configurator]] and how to make circular movement using it. <br>
+
{{Languages|Motion_Project_Example:_Cartesian_Robot}}
 +
This example project shows how to define Cartesian robot properties using [[softMC_Configurator|softMC Configurator]] and how to make a circular movement with the robot.
  
−
=Download Example Files=
+
= Download Example Files =
−
{|class="wikitable" style="text-align: left"
+
 
−
|'''Description'''
+
{| class="wikitable" style="text-align: left"
−
|'''Download'''
 
 
|-
 
|-
−
|Download the '''ZIP''' example file, extract all the project files, open the project with ControlStudio, and run the example.<br/>
+
| '''Overview'''
−
Refer to the file descriptions and instructions in the following sections.
+
| '''Download'''
−
|[[image:Download.png|90px|link=http://softmc.servotronix.com/img_auth.php/d/d1/cartXYZ.zip]]  
+
|-
 +
| Download the '''ZIP''' example project file, extract all the files, and then use ControlStudio to open and run the example project.  
 +
Refer to the file descriptions and instructions below.
 +
 
 +
| [[File:Download.png|90px|Download.png|link=http://softmc.servotronix.com/img_auth.php/d/d1/cartXYZ.zip]]
 
|}
 
|}
  
−
=System Setup=
+
= System Setup =
−
This example uses the following system: <br>
+
 
−
* softMC 7
+
The example uses the following system:
−
* Three CDHD drives connected to three linear motors
+
 
−
* Cartesian robot (XYZ)  
+
*softMC 7  
−
* Computer with [[Control Studio|ControlStudio]] and [[softMC Configurator]].
+
*Three CDHD drives connected to three linear motors  
−
* Example files - Programs, setups, properties and more (See below for descriptions)
+
*Cartesian robot (XYZ)  
−
* Wiring as shown in image below: <br/>
+
*Computer with [[Control_Studio|ControlStudio]] and [[softMC_Configurator|softMC Configurator]].  
−
[[image: cart_1.png| 300px]]
+
*Example files - Programs, setups, properties and more (See below for descriptions)  
 +
*Wiring as shown in the image below:  
  
 +
[[File:cart 1.png|300px|cart 1.png]]
  
−
The motor parameters are calculated according to the manufacture formulas as appear in the Excel file.  
+
The motor parameters are calculated according to the manufacture specifications in the Excel file.
  
 
{{Note|When using drives other than CDHD, you must insert the motor '''pitch''' value, provided by the motor manufacture, to the softMC Configurator, to obtain a suitable [[MC-Basic:axis.POSITIONFACTOR|Position Factor]].}}
 
{{Note|When using drives other than CDHD, you must insert the motor '''pitch''' value, provided by the motor manufacture, to the softMC Configurator, to obtain a suitable [[MC-Basic:axis.POSITIONFACTOR|Position Factor]].}}
  
−
=softMC Configurator=
+
= softMC Configurator - Setup =
−
To upload the example setups to sofMC Configurator, open the example '''.mcfg''' file from the softMC Configurator.
+
 
 +
Use the sofMC Configurator to open the example '''mcfg''' (cartXYZ.mdfg) file.
  
−
After creating all project files with softMC Configurator or uploading an existing project, you can run your robot from ControlStudio or from softMC Configurator.  
+
For more information on how to set up Cartesian robot parameters using softMC Configurator, refer to [[3-Axis_Group_Setup_in_EtherCAT_Network|3-Axis Group Setup in EtherCAT Network]].<br/> <!--<strike> After creating all project files with softMC Configurator or uploading an existing project, you can run the robot from ControlStudio or from softMC Configurator.  
  
−
This example generates a circular movement using an MC-Basic program, from the ControlStudio terminal.
+
This example generates a circular movement using an MC-Basic program, from the ControlStudio terminal.</strike> -->
  
−
For more information on how to set up Cartesian robot parameters using softMC Configurator, [[3-Axis Group Setup in EtherCAT Network|look here]] <br>
+
= ControlStudio - Program Execution =
  
−
=Running The Program=
+
Use ControlStudio to open the example '''.apj''' (cartXYZ.apj) file.
−
To upload the example setups to ControlStudio, open the example '''.apj''' file from the ControlStudio.<br/>
 
−
Once all required files are uploaded to your controller, use the ControlStudio terminal to enter the following instructions and run the example:
 
  
−
<syntaxhighlight lang='VB'>
+
Once all required files are uploaded to your controller, use the ControlStudio terminal to enter the following instructions and run the example:
 +
 
 +
&nbsp;
 +
<syntaxhighlight lang="VB">
 
-->reset all
 
-->reset all
 
-->load AUTOEXEC.PRG  'wait until the program terminates
 
-->load AUTOEXEC.PRG  'wait until the program terminates
Line 46: Line 54:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
==File Descriptions ==
+
= File Descriptions =
  
−
{|class="wikitable"
+
{| class="wikitable"
−
!colspan = "3"|'''<big>User Files</big>'''
 
 
|-
 
|-
−
!File Name
+
! colspan="3" | '''<big>User Files</big>'''
−
!Description
 
−
!Upload to Controller
 
 
|-
 
|-
−
|Properties table
+
! File Name
−
|Excel matrix that contain the information that you need to setup your robot.<br> Notice which information you need to import from your system.
+
! Description
−
|align="center" |'''−'''
+
! Upload to Controller
 
|-
 
|-
−
|CONFIG.PRG
+
| Properties table
−
|MC-Basic program that define the basic data so that ControlStudio and sofMC Configurator will work.
+
| Excel matrix that contains data for setting up your robot.<br/> Note which data you need to import from your system.
−
|align="center" |'''+'''
+
| align="center" | '''−'''
 
|-
 
|-
−
|HOMING.PRG
+
| CONFIG.PRG
−
|Execute homing procedure for each axis.
+
| MC-Basic program that defines the basic data required for ControlStudio and sofMC Configurator operation.
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|AUTOEXEC.PRG
+
| HOMING.PRG
−
|Execute startPRG.PRG program and HOMING.PRG program.
+
| Executes a homing procedure for each axis.
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|CIRCLE.PRG
+
| AUTOEXEC.PRG
−
|Basic circular movement program
+
| Executes startPRG.PRG program and HOMING.PRG program.
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 +
|-
 +
| CIRCLE.PRG
 +
| MC-Basic circular movement program.
 +
| align="center" | '''+'''
 
|}
 
|}
  
 +
&nbsp;
  
−
{|class = "wikitable"
+
{| class="wikitable"
−
!colspan = "3"| '''<big>softMC Configurator files - DO NOT MAKE ANY CHANGE</big>'''
 
 
|-
 
|-
−
!File Name
+
! colspan="3" | '''<big>softMC Configurator Files - DO NOT MAKE ANY CHANGES</big>'''
−
!Description
 
−
!Upload to Controller
 
 
|-
 
|-
−
|AX_SETUP.PRG
+
! File Name
−
|Axes parameters setup program
+
! Description
−
|align="center" |'''+'''
+
! Upload to Controller
 
|-
 
|-
−
|CANSETUP.PRG
+
| AX_SETUP.PRG
−
|CANopen communication parameter setup program
+
| Axes parameters setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|EC_CDHD.LIB
+
| CANSETUP.PRG
−
|EtherCat communication function and subroutine with CDHD library file
+
| CANopen communication parameter setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|EC_USER.LIB
+
| EC_CDHD.LIB
−
|EtherCat communication function and subroutine library file
+
| EtherCat communication function and subroutine with CDHD library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|ETHERCAT.LIB
+
| EC_USER.LIB
−
|EtherCat communication function and subroutine library file
+
| EtherCat communication function and subroutine library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|ECCONFIG.PRG
+
| ETHERCAT.LIB
−
|EtherCat configuration program
+
| EtherCat communication function and subroutine library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|EC_SETUP.PRG
+
| ECCONFIG.PRG
−
|EtherCat communication setup program
+
| EtherCat configuration program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|RobLib.LIB
+
| EC_SETUP.PRG
−
|Robot function and subroutine library file
+
| EtherCat communication setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|ROBOT.PRG
+
| RobLib.LIB
−
|Robot parameter setup program
+
| Robot function and subroutine library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|STARTPRG.PRG
+
| ROBOT.PRG
−
|Program that runs all other softMC Configurator programs
+
| Robot parameter setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|cartXYZ.apj
+
| STARTPRG.PRG
−
|Project file - allowed to load an existing project from ControStudio.
+
| Program that runs all other softMC Configurator programs
−
|align="center" |'''−'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|cartXYZ.mcfg
+
| cartXYZ.apj
−
|Project file - allowed to load an existing project from softMC Configurator.
+
| Project file - used to load an existing project from ControStudio
−
|align="center" |'''−'''
+
| align="center" | '''−'''
 
|-
 
|-
−
|cartXYZ.dat
+
| cartXYZ.mcfg
−
|rowspan="3" align="center"|General project files
+
| Project file - used to load an existing project from softMC Configurator
−
|align="center" |'''−'''
+
| align="center" | '''−'''
 
|-
 
|-
−
|cartXYZ.asn
+
| cartXYZ.dat
−
|align="center" |'''−'''
+
| align="center" rowspan="3" | General project files
 +
| align="center" | '''−'''
 
|-
 
|-
−
|cartXYZ.pse
+
| cartXYZ.asn
−
|align="center" |'''−'''
+
| align="center" | '''−'''
 +
|-
 +
| cartXYZ.pse
 +
| align="center" | '''−'''
 
|}
 
|}
 +
 +
[[Category:Robot Models]]

Latest revision as of 01:09, 11 April 2022

Language: English  • 中文（简体）‎

This example project shows how to define Cartesian robot properties using softMC Configurator and how to make a circular movement with the robot.

Download Example Files

Overview Download
Download the ZIP example project file, extract all the files, and then use ControlStudio to open and run the example project.

Refer to the file descriptions and instructions below.

Download.png

System Setup

The example uses the following system:

  • softMC 7
  • Three CDHD drives connected to three linear motors
  • Cartesian robot (XYZ)
  • Computer with ControlStudio and softMC Configurator.
  • Example files - Programs, setups, properties and more (See below for descriptions)
  • Wiring as shown in the image below:

cart 1.png

The motor parameters are calculated according to the manufacture specifications in the Excel file.

NOTE-Info.svgNOTE
When using drives other than CDHD, you must insert the motor pitch value, provided by the motor manufacture, to the softMC Configurator, to obtain a suitable Position Factor.

softMC Configurator - Setup

Use the sofMC Configurator to open the example mcfg (cartXYZ.mdfg) file.

For more information on how to set up Cartesian robot parameters using softMC Configurator, refer to 3-Axis Group Setup in EtherCAT Network.

ControlStudio - Program Execution

Use ControlStudio to open the example .apj (cartXYZ.apj) file.

Once all required files are uploaded to your controller, use the ControlStudio terminal to enter the following instructions and run the example:

  

-->reset all
-->load AUTOEXEC.PRG   'wait until the program terminates
-->load CIRCLE.PRG
-->Stas CIRCLE.PRG     'when the program ends, you can find motion record file (CIRCLE.REC) in the controller

File Descriptions

User Files
File Name Description Upload to Controller
Properties table Excel matrix that contains data for setting up your robot.
Note which data you need to import from your system. 		−
CONFIG.PRG MC-Basic program that defines the basic data required for ControlStudio and sofMC Configurator operation. +
HOMING.PRG Executes a homing procedure for each axis. +
AUTOEXEC.PRG Executes startPRG.PRG program and HOMING.PRG program. +
CIRCLE.PRG MC-Basic circular movement program. +

 

softMC Configurator Files - DO NOT MAKE ANY CHANGES
File Name Description Upload to Controller
AX_SETUP.PRG Axes parameters setup program +
CANSETUP.PRG CANopen communication parameter setup program +
EC_CDHD.LIB EtherCat communication function and subroutine with CDHD library file +
EC_USER.LIB EtherCat communication function and subroutine library file +
ETHERCAT.LIB EtherCat communication function and subroutine library file +
ECCONFIG.PRG EtherCat configuration program +
EC_SETUP.PRG EtherCat communication setup program +
RobLib.LIB Robot function and subroutine library file +
ROBOT.PRG Robot parameter setup program +
STARTPRG.PRG Program that runs all other softMC Configurator programs +
cartXYZ.apj Project file - used to load an existing project from ControStudio −
cartXYZ.mcfg Project file - used to load an existing project from softMC Configurator −
cartXYZ.dat General project files −
cartXYZ.asn −
cartXYZ.pse −
Retrieved from "http://softmc.servotronix.com/index.php?title=Motion_Project_Example:_Cartesian_Robot&oldid=133856"