Documentation Status

shadow_robot: sr_description | sr_example | sr_gazebo_plugins | sr_hand | sr_hardware_interface | sr_kinematics | sr_mechanism_controllers | sr_mechanism_model | sr_move_arm | sr_movements | sr_robot_msgs | sr_tactile_sensors | sr_utilities

Package Summary

Documented

This is a ROS interface to the Shadow Robot's robotic hand. It contains both an interface to the real hand (communicating via a CAN interface) and a simulated version of the hand. It also contains an interface to Shadow Robot's muscle arm.

shadow_robot: sr_description | sr_example | sr_gazebo_plugins | sr_hand | sr_hardware_interface | sr_kinematics | sr_mechanism_controllers | sr_mechanism_model | sr_move_arm | sr_movements | sr_robot_msgs | sr_tactile_sensors | sr_utilities

Package Summary

Documented

This is a ROS interface to the Shadow Robot's robotic hand. It contains both an interface to the real hand (communicating via a CAN interface) and a simulated version of the hand. It also contains an interface to Shadow Robot's muscle arm.

shadow_robot: sr_description | sr_example | sr_gazebo_plugins | sr_hand | sr_hardware_interface | sr_mechanism_controllers | sr_mechanism_model | sr_move_arm | sr_movements | sr_robot_msgs | sr_self_test | sr_tactile_sensors | sr_utilities

Package Summary

Documented

This is a ROS interface to the Shadow Robot's robotic hand. It contains both an interface to the real hand (communicating via a CAN interface) and a simulated version of the hand. It also contains an interface to Shadow Robot's muscle arm.

shadow_robot: sr_description | sr_example | sr_gazebo_plugins | sr_hand | sr_hardware_interface | sr_mechanism_controllers | sr_mechanism_model | sr_moveit_config | sr_movements | sr_robot_msgs | sr_self_test | sr_tactile_sensors | sr_utilities

Package Summary

Released Continuous integration Documented

This is a ROS interface to the Shadow Robot's robotic hand. It contains both an interface to the real hand (communicating via a CAN interface) and a simulated version of the hand. It also contains an interface to Shadow Robot's muscle arm.

shadow_robot: sr_description | sr_example | sr_hand | sr_hardware_interface | sr_mechanism_controllers | sr_mechanism_model | sr_movements | sr_robot_msgs | sr_self_test | sr_tactile_sensors | sr_utilities

Package Summary

Released Continuous integration Documented

This is a ROS interface to the Shadow Robot's robotic hand. It contains both an interface to the real hand (communicating via a CAN interface) and a simulated version of the hand. It also contains an interface to Shadow Robot's muscle arm.

Cannot load information on name: sr_hand, distro: jade, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
Cannot load information on name: sr_hand, distro: kinetic, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
Cannot load information on name: sr_hand, distro: lunar, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
Cannot load information on name: sr_hand, distro: melodic, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.

Overview

This package provides a ROS interface to the Shadow Robot Dextrous Hand and Arm. Its aim is not only to provide a complete ROS integration to our hardware, but also to provide the user with a simulated and a dummy interface (the dummy interface is a really simple simulated interface, without any physics computation). Changing between those 3 interfaces is transparent for the end user, thus allowing you to test your algorithm in simulation, and then run them on the real hardware without changing any code.

This package also provides a (deprecated) compatibility interface for the EtherCAT Hand. For more information, you can have a look at this Tutorial.

ROS API

Here is an overview of the ROS system:

Overview of the System

As you can see, the topics are similar on the arm and hand.

Subscribed Topics

  • sendupdate: The sendupdate message is defined in sr_robot_msgs. It is used to send one or a vector of new targets to the robot. For an example on how to publish on this topic, please refer to the Moving the Robot tutorial.

  • contrlr: The contrlr message is defined in sr_robot_msgs. This topic is used to set new controller parameters when you use our real hardware. To see how to publish on this topic, go to the Setting new Controller Parameters tutorial.

  • config: This functionality is not yet implemented.

Published Topics

  • position/joint_states: Publish a sensor_msgs/joint_states message containing the current positions of the robot. A robot_state_publisher subscribes to this topic, in order to publish to the tf topic, with a /srh/position prefix.

  • target/joint_states: Publish a sensor_msgs/joint_states message containing the current targets for the robot. This is not so important, but it can be used to display the targets in rviz. A robot_state_publisher subscribes to this topic, in order to publish to the tf topic, with a /srh/target prefix.

  • shadowhand_data: This topic publishes more information than the joint_states topics. It's based on the sr_robot_msgs/joints_data. There is a duplication of the information sent on those topics, but we can't really get rid of any of them as they may be needed in different situations.

  • diagnostics: Diagnostics data (motor status, etc...) are published on this topic, and then aggregated by a diagnostic_aggregator. You can look at the diagnostics using the robot_monitor.

Parameters

You can specify the following parameters for the Hand or for the Arm:

  • publish_frequency: You can change the publishing frequency of the main robot data (shadowhand_data and joint_states). Default is 20Hz.

  • publish_frequency_diagnostics: You can change the rate at which diagnostics are being published for the robot. Default is 1Hz.

  • gazebo_joint_states_prefix: If using gazebo, what's the prefix of the joint_states published by gazebo.

Installation instructions

Please refer to the Installation Instructions page.

Contributing

We always welcome contributions. If you want to contribute, please refer to the shadow_robot stack.

Overview

This package provides a ROS interface to the Shadow Robot Dextrous Hand and Arm. Its aim is not only to provide a complete ROS integration to our hardware, but also to provide the user with a simulated and a dummy interface (the dummy interface is a really simple simulated interface, without any physics computation). Changing between those 3 interfaces is transparent for the end user, thus allowing you to test your algorithm in simulation, and then run them on the real hardware without changing any code.

This package also provides a (deprecated) compatibility interface for the EtherCAT Hand. For more information, you can have a look at this Tutorial.

ROS API

Here is an overview of the ROS system:

Overview of the System

As you can see, the topics are similar on the arm and hand.

Subscribed Topics

  • sendupdate: The sendupdate message is defined in sr_robot_msgs. It is used to send one or a vector of new targets to the robot. For an example on how to publish on this topic, please refer to the Moving the Robot tutorial.

  • contrlr: The contrlr message is defined in sr_robot_msgs. This topic is used to set new controller parameters when you use our real hardware. To see how to publish on this topic, go to the Setting new Controller Parameters tutorial.

  • config: This functionality is not yet implemented.

Published Topics

  • position/joint_states: Publish a sensor_msgs/joint_states message containing the current positions of the robot. A robot_state_publisher subscribes to this topic, in order to publish to the tf topic, with a /srh/position prefix.

  • target/joint_states: Publish a sensor_msgs/joint_states message containing the current targets for the robot. This is not so important, but it can be used to display the targets in rviz. A robot_state_publisher subscribes to this topic, in order to publish to the tf topic, with a /srh/target prefix.

  • shadowhand_data: This topic publishes more information than the joint_states topics. It's based on the sr_robot_msgs/joints_data. There is a duplication of the information sent on those topics, but we can't really get rid of any of them as they may be needed in different situations.

  • diagnostics: Diagnostics data (motor status, etc...) are published on this topic, and then aggregated by a diagnostic_aggregator. You can look at the diagnostics using the robot_monitor.

Parameters

You can specify the following parameters for the Hand or for the Arm:

  • publish_frequency: You can change the publishing frequency of the main robot data (shadowhand_data and joint_states). Default is 20Hz.

  • publish_frequency_diagnostics: You can change the rate at which diagnostics are being published for the robot. Default is 1Hz.

  • gazebo_joint_states_prefix: If using gazebo, what's the prefix of the joint_states published by gazebo.

Installation instructions

Please refer to the Installation Instructions page.

Contributing

We always welcome contributions. If you want to contribute, please refer to the shadow_robot stack.

Overview

This package contains mainly launch files for the simulated version of the Shadow Robot Dexterous Hand and Arm.

It also contains a (deprecated) compatibility interface for the EtherCAT Hand. For more information you can take a look at this Tutorial.

Getting Started

See this page to get started with the simulated hand and arm.

ROS API

This interface uses some controllers based on the standard pr2 controllers.

Each controller has its own subscriber to a command topic on sh_ffj3_position_controller/command (replace ffj3 by any other joint name - see here for a diagram containing the joint names).

The controllers are publishing their state on sh_ffj3_position_controller/state (replace ffj3 by any other joint name).

Overview

This package contains mainly launch files for the simulated version of the Shadow Robot Dexterous Hand and Arm.

It also contains a (deprecated) compatibility interface for the EtherCAT Hand. For more information you can take a look at this Tutorial.

Getting Started

See this page to get started with the simulated hand and arm.

ROS API

This interface uses some controllers based on the standard pr2 controllers.

Each controller has its own subscriber to a command topic on sh_ffj3_position_controller/command (replace ffj3 by any other joint name - see here for a diagram containing the joint names).

The controllers are publishing their state on sh_ffj3_position_controller/state (replace ffj3 by any other joint name).

Wiki: sr_hand (last edited 2014-02-24 08:38:59 by UgoCupcic)