Difference between revisions of "Bin Picking Tutorial: Setting up Photoneo Bin Picking Studio with SIASUN robots"
Line 5: | Line 5: | ||
The SIASUN Bin Picking Interface was developed using the following system version: '''UI: 2.1.10, Robot: 1.1.8''' | The SIASUN Bin Picking Interface was developed using the following system version: '''UI: 2.1.10, Robot: 1.1.8''' | ||
− | ''' | + | '''This interface may not be compatible with other system versions!''' You can find more information about your system version in the '''About''' Tab: |
Line 19: | Line 19: | ||
== 2. SIASUN Controller Setup == | == 2. SIASUN Controller Setup == | ||
− | The following tutorial gives a step by step guide of how to configure your SIASUN | + | The following tutorial gives a step by step guide of how to configure your SIASUN Robot Controller, install all necessary files and amend the robotic program to get the Locator up and running. |
=== 2.1 Network Configuration === | === 2.1 Network Configuration === | ||
Line 25: | Line 25: | ||
The Locator SIASUN Module utilizes TCP/IP communication for transferring data between the SIASUN Robot Controller and the Vision Controller. | The Locator SIASUN Module utilizes TCP/IP communication for transferring data between the SIASUN Robot Controller and the Vision Controller. | ||
− | As the first step in | + | As the first step in the configuration process, ensure that the IP address of the SIASUN Controller meets your network configuration requirements. |
Browse to '''Setting''' -> '''IP Address''': | Browse to '''Setting''' -> '''IP Address''': | ||
Line 45: | Line 45: | ||
− | The new network configuration will be applied immediately | + | The new network configuration will be applied immediately and the Robot Controller does not need to be rebooted. |
== 3. Photoneo SIASUN Module Setup == | == 3. Photoneo SIASUN Module Setup == | ||
Line 51: | Line 51: | ||
The first step in the installation of Photoneo SIASUN Module is to '''copy the Robot Program from the Photoneo SIASUN Module Archive to the Robot Controller'''. | The first step in the installation of Photoneo SIASUN Module is to '''copy the Robot Program from the Photoneo SIASUN Module Archive to the Robot Controller'''. | ||
− | The Photoneo SIASUN Module is implemented in | + | The Photoneo SIASUN Module is implemented in the following file: |
* - ''Photoneo_SIASUN_Module_1_3.spf''' | * - ''Photoneo_SIASUN_Module_1_3.spf''' | ||
− | Plug USB into Robot Controller, select '''Program''' Tab and | + | Plug the USB into the Robot Controller, select the '''Program''' Tab and click the '''Import''' button at the bottom of the screen. |
Select the ''"Photoneo_SIASUN_Module_1_3.spf"'' file from the USB Disk and confirm by clicking '''Import''': | Select the ''"Photoneo_SIASUN_Module_1_3.spf"'' file from the USB Disk and confirm by clicking '''Import''': | ||
Line 63: | Line 63: | ||
− | If import has | + | If the import has been completed successfully, a popup should appear on the screen. Confirm by clicking '''Yes''': |
Line 69: | Line 69: | ||
− | + | The first step of the program configuration is to set a '''Home''' position - the first MoveJ command. | |
− | + | Set the Home Pose is out of the scanning volume to ensure that robot arm doesn't cast a shadow on the scene. | |
Line 77: | Line 77: | ||
− | Set IP Address of Bin Picking Studio Robot Interface to the '''vision_controller_ip''' variable. | + | Set the IP Address of the Bin Picking Studio Robot Interface to the '''vision_controller_ip''' variable. |
− | By default, '''bin_picking_port = 2002'''. | + | By default, '''bin_picking_port = 2002'''. This configuration should not be changed unless approved by Photoneo Support! |
Line 85: | Line 85: | ||
− | + | The next step of the process is to assign, Start and End pose joint values to the Array variables. | |
− | '''Start position''' should be above the center of the bin | + | '''Start position''' should be located approximately 30-40 cm above the center of the bin. Jog the robot to this position and set the values in the '''start_joint''' array according to the current joint values. |
− | '''End position''' can be the same as start pose or it can be shifted towards placing zone. It should also be | + | '''End position''' can be the same as the start pose or it can be shifted towards the placing zone. It should also be positioned approximately 30-40cm above the bin. Jog the robot to this position and set the values in '''end_joint''' array according to the current joint values. |
Line 95: | Line 95: | ||
− | Scroll down to the Motion Execution part of the program. As shown in the figure below, the bin picking trajectory consists of 5 motion segments | + | Scroll down to the Motion Execution part of the program. As is shown in the figure below, the bin picking trajectory consists of 5 motion segments |
* - '''movej Start''' | * - '''movej Start''' | ||
Line 107: | Line 107: | ||
* - '''movel End''' | * - '''movel End''' | ||
− | In the current implementation, all gripper commands MUST be hard-coded directly into the robot program - notice, for example, '''io_out(1,1)''' command after grasp pose is reached. | + | In the current implementation, all gripper commands MUST be hard-coded directly into the robot program - notice, for example, '''io_out(1,1)''' command after the grasp pose is reached. |
− | ''' | + | '''Do not configure any alternative gripper actions or additional path stages in Bin Picking Studio !!! The only permitted sequence of operations is [TRAJ, TRAJ, TRAJ, TRAJ, INFO, INFO, INFO] !!!''' |
Amend the speed and acceleration settings according to the application requirements. | Amend the speed and acceleration settings according to the application requirements. | ||
Line 117: | Line 117: | ||
− | Reteach placing poses and configure speed and acceleration settings according to the application requirements. | + | Reteach the placing poses and configure the speed and acceleration settings according to the application requirements. |
Line 125: | Line 125: | ||
== 4. SPF File == | == 4. SPF File == | ||
− | The following section provides the source code of ''Photoneo_Siasun_Module_1_3.spf'' - the basic template which demonstrates how the user's application and Photoneo Bin Picking API can be integrated together. | + | The following section provides the source code of ''Photoneo_Siasun_Module_1_3.spf'' - the basic template which demonstrates how the user's application and the Photoneo Bin Picking API can be integrated together. |
Line 132: | Line 132: | ||
== 5. Runtime == | == 5. Runtime == | ||
− | + | Ensure that your solution is running on the Deployment page of Bin Picking Studio and that the Bin Picking Status is in the '''Waiting for a connection''' state as is shown in the figure below: | |
Line 138: | Line 138: | ||
− | + | Select '''AUTO''' or '''MANUAL''' mode and adopt the speed override if required. | |
Select the ''Photoneo_Siasun_Module.spf'' from the Program List: | Select the ''Photoneo_Siasun_Module.spf'' from the Program List: | ||
Line 152: | Line 152: | ||
− | Hold '''Press to Move''' button to | + | Hold the '''Press to Move''' button to move the robot to the Home Position: |
Line 158: | Line 158: | ||
− | You should also notice that Bin Picking Status has changed to | + | You should also notice that the Bin Picking Status has changed to Connected. This means that the Bin Picking Studio has established a successful connection to the Robot Controller: |
Line 164: | Line 164: | ||
− | The robot should now start sending requests to the Bin Picking Studio and execute bin picking movements. | + | The robot should now start sending requests to the Bin Picking Studio and will execute bin picking movements. |
− | '''NOTE: Ensure that you are ready to halt motion execution immediately in | + | '''NOTE: Ensure that you are ready to halt motion execution immediately in any issue arise. It is strongly recommended to reduce the speed to 10% of maximum or less during initial bin picking tests.''' |
Latest revision as of 07:30, 7 February 2019
NOTE: Users are strongly recommended to read the general introduction to robot interfaces prior to installing specific robot modules.
Contents
1. Prerequisities
The SIASUN Bin Picking Interface was developed using the following system version: UI: 2.1.10, Robot: 1.1.8
This interface may not be compatible with other system versions! You can find more information about your system version in the About Tab:
If your pendant is still in Chinese, select the Settings tab and switch the language to English at the bottom of the page:
2. SIASUN Controller Setup
The following tutorial gives a step by step guide of how to configure your SIASUN Robot Controller, install all necessary files and amend the robotic program to get the Locator up and running.
2.1 Network Configuration
The Locator SIASUN Module utilizes TCP/IP communication for transferring data between the SIASUN Robot Controller and the Vision Controller.
As the first step in the configuration process, ensure that the IP address of the SIASUN Controller meets your network configuration requirements.
Browse to Setting -> IP Address:
Select the Static option and configure the network settings of the Robot Controller:
Confirm the new network configuration by clicking the YES button:
The new network configuration will be applied immediately and the Robot Controller does not need to be rebooted.
3. Photoneo SIASUN Module Setup
The first step in the installation of Photoneo SIASUN Module is to copy the Robot Program from the Photoneo SIASUN Module Archive to the Robot Controller.
The Photoneo SIASUN Module is implemented in the following file:
- - Photoneo_SIASUN_Module_1_3.spf'
Plug the USB into the Robot Controller, select the Program Tab and click the Import button at the bottom of the screen.
Select the "Photoneo_SIASUN_Module_1_3.spf" file from the USB Disk and confirm by clicking Import:
If the import has been completed successfully, a popup should appear on the screen. Confirm by clicking Yes:
The first step of the program configuration is to set a Home position - the first MoveJ command.
Set the Home Pose is out of the scanning volume to ensure that robot arm doesn't cast a shadow on the scene.
Set the IP Address of the Bin Picking Studio Robot Interface to the vision_controller_ip variable.
By default, bin_picking_port = 2002. This configuration should not be changed unless approved by Photoneo Support!
The next step of the process is to assign, Start and End pose joint values to the Array variables.
Start position should be located approximately 30-40 cm above the center of the bin. Jog the robot to this position and set the values in the start_joint array according to the current joint values.
End position can be the same as the start pose or it can be shifted towards the placing zone. It should also be positioned approximately 30-40cm above the bin. Jog the robot to this position and set the values in end_joint array according to the current joint values.
Scroll down to the Motion Execution part of the program. As is shown in the figure below, the bin picking trajectory consists of 5 motion segments
- - movej Start
- - movel Approach
- - movel Grasp
- - movel Deapproach
- - movel End
In the current implementation, all gripper commands MUST be hard-coded directly into the robot program - notice, for example, io_out(1,1) command after the grasp pose is reached.
Do not configure any alternative gripper actions or additional path stages in Bin Picking Studio !!! The only permitted sequence of operations is [TRAJ, TRAJ, TRAJ, TRAJ, INFO, INFO, INFO] !!!
Amend the speed and acceleration settings according to the application requirements.
Reteach the placing poses and configure the speed and acceleration settings according to the application requirements.
4. SPF File
The following section provides the source code of Photoneo_Siasun_Module_1_3.spf - the basic template which demonstrates how the user's application and the Photoneo Bin Picking API can be integrated together.
5. Runtime
Ensure that your solution is running on the Deployment page of Bin Picking Studio and that the Bin Picking Status is in the Waiting for a connection state as is shown in the figure below:
Select AUTO or MANUAL mode and adopt the speed override if required.
Select the Photoneo_Siasun_Module.spf from the Program List:
Click Start to launch the robot program:
Hold the Press to Move button to move the robot to the Home Position:
You should also notice that the Bin Picking Status has changed to Connected. This means that the Bin Picking Studio has established a successful connection to the Robot Controller:
The robot should now start sending requests to the Bin Picking Studio and will execute bin picking movements.
NOTE: Ensure that you are ready to halt motion execution immediately in any issue arise. It is strongly recommended to reduce the speed to 10% of maximum or less during initial bin picking tests.