FB_EntitiesHandler - General Information

Overview

Type:

Function block

Available as of:

V1.4.1.0

Inherits from:

-

Implements:

-

This chapter provides information on:

Task

Store and retrieve a global description of a robotic system.

Description

The function block FB_EntitiesHandler is used to store and retrieve a global description of a robotic system (for example a robotic cell). Such description includes robots, conveyor belts, tracking systems and types of target.

The function block contains a set of methods used to store information on the entities of the system. On request, it is possible to retrieve such data or to evaluate additional information linked to the relations between such entities.

The Cartesian pose describing position and orientation of each object is referred to a global coordinate system. You can evaluate the relative Cartesian pose between two configured entities by calling specific methods.

For example, such local transformation could be required during the configuration of a single robot within the system (either as ROB.FB_Robot or RM.FB_RobotModule).

Methods

Name

Description

AddConveyor

Store a new conveyor entity inside the function block.

AddLinearTrackingSystem

Describe a pairing between a conveyor previously added to the function block (using AddConveyor) and a sensor. The result of such pairing is a new tracking system.

AddRobot

Add a new robot entity to the function block.

AddTargetType

Add a new target type to the function block

AddTrackingSystem

Define the parameter that can be used to add a tracking system.

AddTargetGenerator

Add a new target generator entity to the function block.

AddRotativeConveyor

Add a new rotative conveyor entity to the function block.

CalcEntityPoseInEntitySystem

Calculate a cartesian pose in the base frame of a source entity.

CalcEntitiesRelativePose

Calculate the relative Cartesian pose between the base frame of a source entity and the base frame of a target entity.

CalcRobotPoseInTrackingSystem

Transform a Cartesian pose referred to a robot coordinate system to a Cartesian pose referred to a tracking coordinate system.

CalcSensorPoseInTrackingSystem

Transform a Cartesian pose referred to a sensor system to a Cartesian pose referred to the coordinate system of the conveyor to which the sensor has been paired.

CalcTargetGeneratorPoseInTrackingSystem

Transform a Cartesian pose referred to a target generator coordinate system.

CalcTrackingPoseInRobotSystem

Transform a Cartesian pose referred to a tracking coordinate system to a Cartesian pose referred to the coordinate system of a robot.

GetConveyor

Retrieve the information on a conveyor entity previously stored inside the internal list of the function block.

GetLinearTrackingSystem

Retrieve the information on a linear tracking system previously stored inside the internal list of the function block.

GetRobot

Retrieve the information on a robot entity previously stored inside the internal list of the function block.

GetTargetType

Retrieve the information on a target type previously stored inside the internal list of the function block.

GetTrackingSystem

Retrieve the information on a tracking system.

GetTargetGenerator

Retrieve the information on a target generator.

GetRotativeConveyor

Retrieve the information on a rotative conveyor.

Reset

Reset the configuration of the function block.

Properties

Name

Data type

Accessing

Description

raetConveyorList

REFERENCE TO ARRAY [1...Gc_udiMaxNumberOfConveyors] OF ET_SystemEntity

Get

This property contains the list of system IDs of type ET_SystemEntity for the configured conveyors. It is possible to cycle the list from 1 to FB_EntitiesHandler.udiNumberOfConveyors.

raetRobotList

REFERENCE TO ARRAY [1...Gc_udiMaxNumberOfRobots] OF ET_SystemEntity

Get

This property contains the list of system IDs of type ET_SystemEntity for the configured robots. It is possible to cycle the list from 1 to FB_EntitiesHandler.udiNumberOfRobots.

raetTargetGeneratorList

REFERENCE TO ARRAY [1...Gc_udiMaxNumberOfTargetGenerators] OF ET_SystemEntity

Get

This property contains the list of system IDs of type ET_SystemEntity for the configured target generators. It is possible to cycle the list from 1 to FB_EntitiesHandler.udiNumberOfTargetGenerators.

raetTargetTypeList

REFERENCE TO ARRAY [1...Gc_udiMaxNumberOfTargetTypes] OF ET_TargetType

Get

This property contains the list of IDs of type ET_TargetType for the configured target types. It is possible to cycle the list from 1 to FB_EntitiesHandler.udiNumberOfTargetTypes.

raetTrackingSystemList

REFERENCE TO ARRAY [1...ROB.Gc_udiMaxNumberOfTrackingSystemsIds] OF ROB.ET_CoordinateSystem

Get

This property contains the list of IDs of type ROB.ET_CoordinateSystem for the configured tracking systems. It is possible to cycle the list from 1 to FB_EntitiesHandler.udiNumberOfTrackingSystems.

For further information, refer to ROB.ET_CoordinateSystem

udiNumberOfRobots

UDINT

Read

Number of configured robots

udiNumberOfTrackingSystems

UDINT

Read

Number of configured tracking systems

udiNumberOfConveyors

UDINT

Read

Number of configured conveyors

udiNumberOfTargetTypes

UDINT

Read

Number of configured target types

udiNumberOfTargetGenerators

UDINT

Read

Number of configured target generators