Type: |
Function block |
Available as of: |
V1.4.1.0 |
Inherits from: |
- |
Implements: |
- |
This chapter provides information on:
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
).
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. |
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 |