Warning
You are reading the documentation for an older Pickit release (3.0). Documentation for the latest release (3.4) can be found here.
Hanwha Pickit interface
This article documents the interface of the Hanwha Pickit integration. For installation instructions, please refer to the Hanwha installation and setup article.
Pickit variables
The following variables need to be defined before you can use the Pickit functions. To do this go to Programming → Variables → Add. Once a variable is created, its name should be changed according to the table below.
Variable name |
Type |
Comment |
---|---|---|
piPose |
position |
Object pose expressed relatively to the robot base frame. |
piPrePose |
joint |
Joint pose relatively to the piPose, used to approach the piPose. |
piRefJoint |
joint |
Joint position used for robot joint configuration, typically defined in the middle of the picking area. |
piPickId |
number |
ID of the pick point that was selected for the given object. |
piRefId |
number |
ID of the selected pick point’s reference pick point. |
piType |
number |
ID type of the detected object. |
piDim1 |
number |
Length or diameter (mm). |
piDim2 |
number |
Width or diameter (mm). |
piDim3 |
number |
Height (mm). |
piAge |
number |
Amount of time that has passed between the capturing of the camera data and the moment the object information is sent to the robot. |
piRemain |
number |
Number of remaining objects that can be sent to the robot in the next messages. |
piStatus |
number |
Pickit status or a response to previously received robot commands. |
Define piRefJoint
To prevent strange movements of the robot, we need to define the robot joint configuration for picking. This is done by jogging the robot to the center of the picking area and manually set the joint position values of piRefJoint. This position will indicate the desired robot configuration, which will be used for all calculated pick poses.
Pickit functions
First, download the integration files here. Copy all the .script files to a USB drive and plug it in the teach pendant. To add a Pickit function in your robot program go to Commands → script. A new script node will be created. Press this node and edit → file → load. This allows you to select the .script function that you want to add.
All available functions are briefly explained below.
Defining the IP adress of Pickit
Before any of these functions can be used, please make sure to set the correct IP address of the Pickit system. This is done by pressing on the node and edit. Here you can set the IP address, which is set to 169.254.5.180 by default.
Detection functions
Function name |
Comment |
Input |
---|---|---|
Detection |
Trigger a Pickit object detection using the currently active setup and product Configuration. |
pickit_offset |
Next object |
Request the next detected object. |
pickit_offset |
Capture image |
Trigger Pickit to capture a camera image to be used by a following Process image function. If the camera moves during image capture, a warning will be shown in the web interface. |
/ |
Process image |
Trigger an object detection on the camera image that was previously captured via the Capture image function (or one of the Detection functions). |
pickit_offset |
Detection with retries |
Repeatedly trigger a Pickit object detection as long as nothing is found and the ROI is not empty, up to a number of attempts. |
retries, pickit_offset |
Configuration functions
Function name |
Comment |
Input |
---|---|---|
Configuration |
Load the specified setup and product Configuration. |
setup, product |
Build background |
Build the background cloud used in Advanced filters. |
/ |
Calibration functions
Function name |
Comment |
Input |
---|---|---|
Calibration |
Trigger a detection of the robot-camera calibration plate. |
/ |
Monitoring functions
Function name |
Comment |
Input |
---|---|---|
Save scene |
Save a Snapshots with the latest detection results. |
/ |
Hint
In some functions, input values have to be set manually. This is done by pressing on the node and edit. The mentioned input variables can be found under the header Input at the beginning of each function.