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

From SoftMC-Wiki
Jump to: navigation, search
m
(Added to Category:Robot Models)
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
The following example shows how to define Cartesian robot properties using [[softMC Configurator]] and how to make a circular movement with the robot. <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 project file, extract all the files, and then use ControlStudio to open and run the example project.<br/>
+
| '''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.
 
Refer to the file descriptions and instructions below.
−
|[[image:Download.png|90px|link=http://softmc.servotronix.com/img_auth.php/d/d1/cartXYZ.zip]]  
+
 
 +
| [[File:Download.png|90px|Download.png|link=http://softmc.servotronix.com/img_auth.php/d/d1/cartXYZ.zip]]
 
|}
 
|}
  
−
=System Setup=
+
= System Setup =
−
The example uses the following system: <br>
 
−
* softMC 7
 
−
* Three CDHD drives connected to three linear motors
 
−
* Cartesian robot (XYZ)
 
−
* Computer with [[Control Studio|ControlStudio]] and [[softMC Configurator]].
 
−
* Example files - Programs, setups, properties and more (See below for descriptions)
 
−
* Wiring as shown in the image below: <br/>
 
−
[[image: cart_1.png| 300px]]
 
  
 +
The example uses the following system:
  
−
The motor parameters are calculated according to the manufacture specifications in the Excel file.  
+
*softMC 7
 +
*Three CDHD drives connected to three linear motors
 +
*Cartesian robot (XYZ)
 +
*Computer with [[Control_Studio|ControlStudio]] and [[softMC_Configurator|softMC Configurator]].
 +
*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 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 - Setup =
+
= softMC Configurator - Setup =
−
Upload the example setups. Use the sofMC Configurator to open the example '''.mcfg''' file.
 
−
''insert brief explanation about mcfg file – what it is, what it does, what it contains.''
 
  
−
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>
+
Use the sofMC Configurator to open the example '''mcfg''' (cartXYZ.mdfg) file.
  
−
<font color = red> <strikethrough> After creating all project files with softMC Configurator or uploading an existing project, you can run the robot from ControlStudio or from softMC Configurator. </strikethrough>
+
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.</font color>  
+
This example generates a circular movement using an MC-Basic program, from the ControlStudio terminal.</strike> -->
  
 
= ControlStudio - Program Execution =
 
= ControlStudio - Program Execution =
−
Upload the example setups. Use ControlStudio to open the example '''.apj''' file.<br/>
 
−
''insert brief explanation about apj file – what it is, what it does, what it contains.''
 
  
−
Once all required files are uploaded to your controller, use the ControlStudio terminal to enter the following instructions and run the example:
+
Use ControlStudio to open the example '''.apj''' (cartXYZ.apj) file.
  
−
<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 49: Line 54:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
==File Descriptions ==
+
= File Descriptions =
  
−
{|class="wikitable"
+
{| class="wikitable"
−
!colspan = "3"|'''<big>User Files</big>'''
+
|-
 +
! colspan="3" | '''<big>User Files</big>'''
 
|-
 
|-
−
!File Name
+
! File Name
−
!Description
+
! Description
−
!Upload to Controller  
+
! Upload to Controller
 
|-
 
|-
−
|Properties table
+
| Properties table
−
|Excel matrix that contains data for setting up your robot.<br> Note which data you need to import from your system.
+
| 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" | '''−'''
 
|-
 
|-
−
|CONFIG.PRG
+
| CONFIG.PRG
−
|MC-Basic program that defines the basic data required for ControlStudio and sofMC Configurator operation.
+
| MC-Basic program that defines the basic data required for ControlStudio and sofMC Configurator operation.
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|HOMING.PRG
+
| HOMING.PRG
−
|Executes a homing procedure for each axis.
+
| Executes a homing procedure for each axis.
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|AUTOEXEC.PRG
+
| AUTOEXEC.PRG
−
|Executes startPRG.PRG program and HOMING.PRG program.
+
| Executes startPRG.PRG program and HOMING.PRG program.
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|CIRCLE.PRG
+
| CIRCLE.PRG
−
|MC-Basic circular movement program.
+
| MC-Basic circular movement program.
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|}
 
|}
  
 +
&nbsp;
  
−
{|class = "wikitable"
+
{| class="wikitable"
−
!colspan = "3"| '''<big>softMC Configurator Files - DO NOT MAKE ANY CHANGES</big>'''
+
|-
 +
! colspan="3" | '''<big>softMC Configurator Files - DO NOT MAKE ANY CHANGES</big>'''
 
|-
 
|-
−
!File Name
+
! File Name
−
!Description
+
! Description
−
!Upload to Controller
+
! Upload to Controller
 
|-
 
|-
−
|AX_SETUP.PRG
+
| AX_SETUP.PRG
−
|Axes parameters setup program
+
| Axes parameters setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|CANSETUP.PRG
+
| CANSETUP.PRG
−
|CANopen communication parameter setup program
+
| CANopen communication parameter setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|EC_CDHD.LIB
+
| EC_CDHD.LIB
−
|EtherCat communication function and subroutine with CDHD library file
+
| EtherCat communication function and subroutine with CDHD library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|EC_USER.LIB
+
| EC_USER.LIB
−
|EtherCat communication function and subroutine library file
+
| EtherCat communication function and subroutine library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|ETHERCAT.LIB
+
| ETHERCAT.LIB
−
|EtherCat communication function and subroutine library file
+
| EtherCat communication function and subroutine library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|ECCONFIG.PRG
+
| ECCONFIG.PRG
−
|EtherCat configuration program
+
| EtherCat configuration program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|EC_SETUP.PRG
+
| EC_SETUP.PRG
−
|EtherCat communication setup program
+
| EtherCat communication setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|RobLib.LIB
+
| RobLib.LIB
−
|Robot function and subroutine library file  
+
| Robot function and subroutine library file
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|ROBOT.PRG
+
| ROBOT.PRG
−
|Robot parameter setup program  
+
| Robot parameter setup program
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|STARTPRG.PRG
+
| STARTPRG.PRG
−
|Program that runs all other softMC Configurator programs
+
| Program that runs all other softMC Configurator programs
−
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
−
|cartXYZ.apj
+
| cartXYZ.apj
−
|Project file - used to load an existing project from ControStudio  
+
| Project file - used to load an existing project from ControStudio
−
|align="center" |'''−'''
+
| align="center" | '''−'''
 
|-
 
|-
−
|cartXYZ.mcfg
+
| cartXYZ.mcfg
−
|Project file - used to load an existing project from softMC Configurator
+
| Project file - used to load an existing project from softMC Configurator
−
|align="center" |'''−'''
+
| align="center" | '''−'''
 
|-
 
|-
−
|cartXYZ.dat
+
| cartXYZ.dat
−
|rowspan="3" align="center"|General project files
+
| align="center" rowspan="3" | General project files
−
|align="center" |'''−'''
+
| align="center" | '''−'''
 
|-
 
|-
−
|cartXYZ.asn
+
| cartXYZ.asn
−
|align="center" |'''−'''
+
| align="center" | '''−'''
 
|-
 
|-
−
|cartXYZ.pse
+
| cartXYZ.pse
−
|align="center" |'''−'''
+
| 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"