Binpicking Tutorial: Setting up Photoneo BP Studio with KUKA IIWA

From 3D scanning Knowledge base - Photoneo wiki
Revision as of 13:09, 12 February 2018 by Durovsky (talk | contribs)

Jump to: navigation, search

1. Prerequisities

No special prerequisities are known by the time of writing this tutorial.

2. KUKA Controller setup

This tutorial was written using Sunrise Workbench v.1.11, however it should be compatible with different version with minor changes.


KUKA IIWA Sunrise version.jpg


2.1 Create new sunrise project

Start by creating new Sunrise Project. Select New -> Sunrise Project


KUKA IIWA new project.png


Make sure that IP Address of KUKA Controller is configured properly:


KUKA IIWA set IP address.png


Select which version of manipulator you use, KUKA IIWA 7 R800 was used in this tutorial:


KUKA IIWA Select robot.png


Select flange type, Medien Flanch Touch Pneumatisch was use in this tutorial:


KUKA IIWA Select Gripper.png


Review Summary of Sunrise Project and click Finish Button.


KUKA IIWA Project summary.png


2.2 Project Configuration

Enter StationSetup.cat option in Project Overview

On Topology Tab add your version of KUKA IIWA to the robot to the Used Element under KUKA Sunrise Cabinet:


KUKA IIWA StationSetup.png


On the Software tab make sure that all important software components are included in installation, especially Robotics API:


KUKA IIWA StationSetup Software.png


On the Configuration Tab select flange type again:


KUKA IIWA StationSetup Configuration.png


Proceed to Installation Tab and Install the project to the controller, click Save and Apply:


KUKA IIWA StationSetup start installation.png


Project files should be copied to the robot controller now:


KUKA IIWA Installation progress.png


OPTIONAL: If you do not use safety PLC and need to disable safety features enter SafetyConfiguration.cat file and disable first three rows (Emergency Stop External, Operator protection and Protective Setup).

Safety Settings will be applied during project synchronization later.


KUKA IIWA Safety Config.png


2.3 Installation of Photoneo Module

Photoneo KUKA IIWA Module consists of two tasks - State Server and Client. First we configure Background task for State Server. Right Click on src -> New -> Background Task.


KUKA IIWA Background task.png


After adding Background Task to the project your current structure should look as shown in the figure below:


KUKA IIWA Project Structure With Backgroundtask.png


Synchronize project and restart controller if needed:


KUKA IIWA Restart Controller.png


Now copy files from Photoneo KUKA IIWA USB to your project to reach state as shown in the figure below:


KUKA IIWA Final Project Structure.png


In RobotApplication.java edit argument in waitForServer function to meet your Vision Controller network configuration:


KUKA IIWA IP EDIT.png


Synchronize project again:


KUKA IIWA Synchronize progress.png


3. Runtime

OPTIONAL: If you see these errors after reboot you need to activate safety functions first:


KUKA IIWA Pendant Safety.jpg


Select Safety->Activate


KUKA IIWA Pendant Safety Activation.jpg


Open Application select box and make sure that you see both PhotoneoStateServer and RobotApplication (Binpicking Client) available. PhotoneoStateServer should be running from boot:


KUKA IIWA Pendant Applications.png


Now you are about to run Client application. Start Vision Controller side first and decrease joint speed to 10% using Override option:


KUKA IIWA Pendant Override.png


Wait until BinPicking server starts on Vision Side and hit Play button on the pendant to connect robot application to Vision Controller. If everything is okay you should see similar output:


KUKA IIWA Pendant Runtime.png