KUKA installation and setup

The setup of Pickit with a KUKA robot consists of 4 steps:

Check controller and software compatibility

Pickit is compatible with controllers of version KR-C4 and the software module KUKA Connect KRC for socket communication is required. The product number for this module is 91B300-020 version 2.0.14 or later.

Tip

This module can only be purchased through Pickit. Please contact your account manager or sales@pickit3d.com for more information. Generation of temporary license keys by KUKA is possible for validating an application before the actual purchase of a Pickit system.

The module consists of: a set of files that you should copy to a NTFS formatted USB drive, and a 16-digit license key with the format xxxx-xxxx-xxxx-xxxx that depends on the robot’s serial number.

Verify if already installed

To verify whether the KUKA Connect KRC module is already installed on the KR-C4 controller, go to the Main Menu, then Help > Info. In the Info screen select the Options tab. The Main Menu is reachable by clicking on the round robot icon:

../../../../_images/kuka-main-menu.png

If an entry named Connect is listed, then the module is installed and you can skip the next subsection. If the entry is not listed, as in the image below (right), follow the remaining steps of this section to install the KUKA Connect KRC module.

../../../../_images/kuka-step-1.png

Module installation

Download the Pickit KUKA files here.

Plug in the USB drive containing the KUKA Connect KRC module files in the external USB port of the KR-C4 controller cabinet.

../../../../_images/kuka-step-2.png

A user with expert privileges is required to install the module. To enable expert mode, go to Main Menu, then Configuration > User group and select the Expert group.

../../../../_images/kuka-step-3.png

To install the module, go to Main Menu, then Start-up > Additional software. On the Additional software click the New software button at the bottom left.

../../../../_images/kuka-step-4.png

You should see a list of available modules pending for installation, including an entry named Connect. Toggle the checkbox next to the Connect module and click install. Confirm the installation on the pop-up dialog.

../../../../_images/kuka-step-5.png

After preparing the installation, a pop-up dialog will request a controller restart to complete the installation. Dismiss the pop-up by clicking OK and click the Restart button. You can also remove the USB drive from the KR-C4 controller cabinet at this point.

../../../../_images/kuka-step-6.png

After restarting, you should see a notification at the top of the screen indicating that the Connect module has an invalid license key.

../../../../_images/kuka-step-7.png

To activate the license, go to Main Menu, then Configuration > Connect settings. In the Connect settings screen click the License button.

../../../../_images/kuka-step-8.png

Enter the 16 digit license key associated to the robot’s serial number including dashes and click Activate.

../../../../_images/kuka-step-9.png

For the license key activation to take effect, another controller restart is required. To do so, go to Main Menu, then Shutdown. In the Shutdown screen click the Reboot control PC button and confirm.

../../../../_images/kuka-step-10.png

SPS file settings

After installing the KUKA Connect KRC module, it is necessary to add one command to the SPS file, which executes in the background of all robot programs. You need to be in expert mode to perform this operation.

To open the SPS file from the navigator, browse to R1 > System, select the sps file and click Open, as shown in the figure below, left.

Once the file is open, move the cursor to the USER PLC line and click on Open/close fold, and add a line calling the pickitsps() function, as shown in the figure below, right. Finally, close the file to save and exit (orange close icon at left panel).

../../../../_images/kuka-close-icon.png

The pickitsps() function allows Pickit to have access to the robot flange pose, as opposed to the pose of the currently active tool.

../../../../_images/kuka-step-11.png

KUKA KRC settings

Now that the KUKA Connect KRC module is installed, we need to configure it to communicate correctly with the Pickit system. To do this, go to Main Menu, then Configuration > Connect settings. In the Connect settings screen select the Pickit settings tab and inspect/modify the configuration, as follows, and as shown in the figure below (right):

../../../../_images/kuka-step-12.png

  • Check correctness the robot IP address. This is a read-only value shown for sanity-checking the robot configuration. If you wish to change the robot IP address, please refer to the KUKA KR-C4 user manual.

  • Disable the local UDP port.

  • Disable the local TCP port.

  • Activate ‘Show dialogs to autocomplete filter’.

  • Activate ‘Enable Pickit client connection’.

  • Specify the Pickit server IP address.

Attention

When communicating with KUKA robots, the Pickit server IP address cannot belong to the following IP ranges:

  • 169.254.0.0 to 169.254.255.255

  • 192.168.0.0 to 192.168.0.255

  • 172.16.0.0 to 172.16.255.255

  • 172.17.0.0 to 172.17.255.255

The default Pickit server IP is 169.254.5.180, which belongs to the first range, so it must be modified.

Click on the Save button to store the settings.

Setting up the network connection

The Pickit processor and the robot controller connect via Ethernet. An Ethernet cable should be connected to the KLI port of the KR-C4 controller (also referred to as X66), and to the Pickit processor as described here.

The location of the KR-C4 controller Ethernet port may vary depending on the controller model. The images below show example locations: Cabinet door (left), built-in switch (right).

../../../../_images/kuka-step-13.png

Loading the program files

The Kuka Connect typically does not contain the latest Pickit integration files. Therefore, you should overwrite the existing Pickit-Kuka integration files with the latest ones.

First, download the latest Pickit-Kuka integration files here. Then uplaod them to your controller and overwrite the existing ones. You will need to stop the SPS to be able to overwrite some of the files.

There are two sets of files installed in the robot controller that relate to Pickit communication:

  • Pickit application files. These are example programs that illustrate how to perform typical Pickit operations, like robot-camera calibration or object detection for pick and place. These are located in R1 > Program > Pickit.

  • Pickit interface files. These are internal files that expose the high-level functions used by the application files, and manage low-level communication with the Pickit system. These files are not meant for editing and are located in R1 > TP > Connect > Pickit.

The Pickit application files can be loaded and executed as any other KUKA.KRL program. Please refer to the KUKA KR-C4 user manual for further details.

Starting and verifying the communication

On the robot side, go to Main Menu, then Configuration > Connect settings. In the Connect settings screen, data being exchanged between the robot and Pickit is displayed in the text boxes labeled PC -> Robot and Robot -> PC. You should see data and timestamps being updated multiple times per second. When moving the robot, you should see the robot pose sent to Pickit changing too.

../../../../_images/kuka-step-14.png

On the Pickit web interface, you should see the robot connection symbol in the top bar. When moving the robot, you should see the robot flange frame moving in the 3D view.

Tip

If you don’t see the robot pose being updated when moving the robot, you probably did not set the sps right as indicated above.

Details on testing this connection on the Pickit side can be found on: Testing the Robot to Pickit connection.