Locator Tutorial: Setting up Locator to work with SIASUN robots

From 3D scanning Knowledge base - Photoneo wiki
Revision as of 11:41, 27 November 2018 by Durovsky (talk | contribs)

Jump to: navigation, search

It is highly recommended that users read Locator Tutorial: Introduction prior to installation of specific robot interface

1. Prerequisities

Locator SIASUN Interface is compatible with following system version: UI: 2.0.5, Robot: 1.0.5 or higher.

Check your robot system version before proceeding further, on Main Menu Click About Tab:


SIASUN Locator Tutorial About.png


If your pendant is still in Chinese, select Settings tab and Switch language to English at the bottom of the page:


SIASUN Locator Tutorial Language.png


2. SIASUN Controller Setup

The following tutorial gives a step by step guide of how to configure your SIASUN robot controller, install all the necessary files and amend the robotic program to get the Locator up and running.

This tutorial was originally written using the latest collaborative SCR5 with system version UI: 2.0.5, Robot: 1.0.5

2.1 Network Configuration

The Locator SIASUN Module utilizes TCP/IP communication for transferring data between SIASUN Robot Controller and Vision Controller.

As a first step in commissioning, ensure that the IP address of the SIASUN controller meets your network configuration requirements

Browse to Settings -> IP Address:


SIASUN Locator Tutorial IP Config Step 0.png


Select Static option and configure network settings of robot controller:


SIASUN Locator Tutorial IP Config Step 1.png


Confirm new network configuration by clicking on YES button:


SIASUN Locator Tutorial IP Config Step 2.png


The new network configuration is applied immediately, reboot is not necessary.

3. Photoneo SIASUN Module Setup

Photoneo SIASUN Locator Module is available in two variants:

  • - Single Result Mode - only one localization result will be requested
  • - Multiple Result Mode - user decides how many localization results within allowed range <1-16> will be requested

It is recommended to import both .spf to the robot controller and use more appropriate version accordingly.

Insert USB Stick containing Locator files to slot directly on the robot controller.

Select Program Tab -> Import -> Single/Multiple_Result_Mode and confirm by clicking the Import Button:


SIASUN Locator Tutorial Import Step 1.png


Successful import is confirmed by pop-up window:


SIASUN Locator Tutorial Import Step 2.png


4. Calibration

Robot Camera Calibration is a crucial step in Locator configuration. Accurate calibration guarantees that the object positions will be calculated directly in Robot Base coordinates.

4.1 Robot - Camera Calibration

Mount the Scanner firmly, ensure that the scene is properly captured from the final position and start the Photoneo Robot Camera Calibrator:


KUKA SettingUp Guide Scanner Calibration 10.png


Ensure that ToolTCP Settings and User Coordinate are all set to zeros:


SIASUN Locator Tutorial TCP Zeros.png


SIASUN Locator Tutorial User Zeros.png


Connect to the Scanner, select XYZ_Extrinsic formalism (Standard for SIASUN robots), adjust the Sphere radius (20 mm in case of standard ping pong ball) and set the Min visible parameter to 40%:


SIASUN Locator Tutorial Calib Step 1.png


Attach a ping-pong ball to the gripper, and jog the robot to the first position (usually the nearest corner of the bin/ area of interest).

Press the Capture button on the first line of the list of points in order to capture the ball position.

On the SIASUN Pendant select Status -> Joints to obtain the current tool position:


SIASUN Locator Tutorial Status.png


Input the X,Y,Z and A,B,C values of the current position to the first line of the point list and repeat the same procedure for at least 5 more points.

Recommended procedure is to cover four corners of the scanning volume/bin + two positions in the center of the scanning volume.

Change the orientation of the tool in all axes to achieve a wider range of input values. Press the Compute button after adding the final point.


SIASUN Locator Tutorial Calib Step 2.png


For successful calibration the Final Error per point should not exceed 2-3 mm. (0.565mm in this example).


SIASUN Locator Tutorial Calib Step 3 1.png


If the Final Error value is too high, try adding more points or start the calibration from the beginning again.

Once you are satisfied with the results, press the Set Matrix to PhoXi button to store the results to the PhoXi Scanner.


SIASUN Locator Tutorial Calib Step 4.png


Do not forget to switch the Coordinate Space in PhoXi Control after calibration has been completed successfully:


KUKA SettingUp Guide Scanner Calibration 20.png