gripper
[Interface specifications]
Collaboration diagram for gripper:
|
Detailed Description
Gripper interface.
The gripper interface provides access to a robotic gripper. A gripper is a device capable of closing around and carrying an object of suitable size and shape. On a mobile robot, a gripper is typically mounted near the floor on the front, or on the end of a robotic limb. Grippers typically have two "fingers" that close around an object. Some grippers can detect whether an objcet is within the gripper (using, for example, light beams). Some grippers also have the ability to move the a carried object into a storage system, freeing the gripper to pick up a new object, and move objects from the storage system back into the gripper.
| #define | PLAYER_GRIPPER_DATA_STATE 1 |
| Data subtype: state. | |
| #define | PLAYER_GRIPPER_REQ_GET_GEOM 1 |
| Request subtype: get geometry. | |
| #define | PLAYER_GRIPPER_CMD_OPEN 1 |
| Command: Open (PLAYER_GRIPPER_CMD_OPEN). | |
| #define | PLAYER_GRIPPER_CMD_CLOSE 2 |
| Command: Close (PLAYER_GRIPPER_CMD_CLOSE). | |
| #define | PLAYER_GRIPPER_CMD_STOP 3 |
| Command: Stop (PLAYER_GRIPPER_CMD_STOP). | |
| #define | PLAYER_GRIPPER_CMD_STORE 4 |
| Command: Store (PLAYER_GRIPPER_CMD_STORE). | |
| #define | PLAYER_GRIPPER_CMD_RETRIEVE 5 |
| Command: Retrieve (PLAYER_GRIPPER_CMD_RETRIEVE). | |
| #define | PLAYER_GRIPPER_STATE_OPEN 1 |
| Gripper state: open. | |
| #define | PLAYER_GRIPPER_STATE_CLOSED 2 |
| Gripper state: closed. | |
| #define | PLAYER_GRIPPER_STATE_MOVING 3 |
| Gripper state: moving. | |
| #define | PLAYER_GRIPPER_STATE_ERROR 4 |
| Gripper state: error. | |
| typedef player_gripper_data | player_gripper_data_t |
| Data: state (PLAYER_GRIPPER_DATA_STATE). | |
| typedef player_gripper_geom | player_gripper_geom_t |
| Request/reply: get geometry. |
Define Documentation
| #define PLAYER_GRIPPER_CMD_CLOSE 2 |
Command: Close (PLAYER_GRIPPER_CMD_CLOSE).
Tells the gripper to close.
Definition at line 2334 of file player_interfaces.h.
Referenced by P2OS::CloseArmGripper(), P2OS::CloseGripper(), P2OS::HandleArmGripperCommand(), P2OS::HandleGripperCommand(), and P2OS::ProcessMessage().
| #define PLAYER_GRIPPER_CMD_OPEN 1 |
Command: Open (PLAYER_GRIPPER_CMD_OPEN).
Tells the gripper to open.
Definition at line 2329 of file player_interfaces.h.
Referenced by P2OS::HandleArmGripperCommand(), P2OS::HandleGripperCommand(), P2OS::OpenArmGripper(), P2OS::OpenGripper(), and P2OS::ProcessMessage().
| #define PLAYER_GRIPPER_CMD_RETRIEVE 5 |
Command: Retrieve (PLAYER_GRIPPER_CMD_RETRIEVE).
Tells the gripper to retrieve a stored object (so that it can be put back into the world). The opposite of store.
Definition at line 2350 of file player_interfaces.h.
| #define PLAYER_GRIPPER_CMD_STOP 3 |
Command: Stop (PLAYER_GRIPPER_CMD_STOP).
Tells the gripper to stop.
Definition at line 2339 of file player_interfaces.h.
Referenced by P2OS::HandleArmGripperCommand(), P2OS::HandleGripperCommand(), P2OS::ProcessMessage(), P2OS::StopArmGripper(), and P2OS::StopGripper().
| #define PLAYER_GRIPPER_CMD_STORE 4 |
Command: Store (PLAYER_GRIPPER_CMD_STORE).
Tells the gripper to store whatever it is holding.
Definition at line 2344 of file player_interfaces.h.
Typedef Documentation
| typedef struct player_gripper_data player_gripper_data_t |
Data: state (PLAYER_GRIPPER_DATA_STATE).
The gripper interface returns the current state of the gripper and information on a potential object in the gripper. state may be PLAYER_GRIPPER_STATE_OPEN, PLAYER_GRIPPER_STATE_CLOSED, PLAYER_GRIPPER_STAGE_MOVING or PLAYER_GRIPPER_STATE_ERROR. beams provides information on how far into the gripper an object is. For most grippers, this will be a bit mask, with each bit representing whether a beam has been interrupted or not.
| typedef struct player_gripper_geom player_gripper_geom_t |
Request/reply: get geometry.
The geometry (pose, outer size and inner size) of the gripper device can be queried by sending a null PLAYER_GRIPPER_REQ_GET_GEOM request.