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

From SoftMC-Wiki
Jump to: navigation, search
(softMC Configurator - Setup)
(Added to Category:Robot Models)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
This example project 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"
+
 
|'''Overview'''
+
{| 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
+
The example uses the following system:
* 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]]
 
  
 +
*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:
  
The motor parameters are calculated according to the manufacture specifications in the Excel file.  
+
[[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 =
 +
 
 
Use the sofMC Configurator to open the example '''mcfg''' (cartXYZ.mdfg) file.
 
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|3-Axis Group Setup in EtherCAT Network]]. <br>
+
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.  
 
 
<!--<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.</strike> -->
 
This example generates a circular movement using an MC-Basic program, from the ControlStudio terminal.</strike> -->
  
 
= ControlStudio - Program Execution =
 
= ControlStudio - Program Execution =
 +
 
Use ControlStudio to open the example '''.apj''' (cartXYZ.apj) file.
 
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:  
+
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'>
+
&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 47: 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 contains data for setting up your robot.<br> Note which data you need to import from your system.
+
! Description
|align="center" |'''−'''
+
! Upload to Controller
 
|-
 
|-
|CONFIG.PRG
+
| Properties table
|MC-Basic program that defines the basic data required for ControlStudio and sofMC Configurator operation.
+
| 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
|Executes a 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
|Executes startPRG.PRG program and HOMING.PRG program.
+
| Executes a homing procedure for each axis.
|align="center" |'''+'''
+
| align="center" | '''+'''
 
|-
 
|-
|CIRCLE.PRG
+
| AUTOEXEC.PRG
|MC-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 CHANGES</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 - used 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 - used 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