[Documentation] [TitleIndex] [WordIndex

Only released in EOL distros:  

Overview

Package contains node for teleoperating Care-O-Bot or any other holonomic robot by Space Navigator 3D mouse.

Control input from SN is recomputed to make robot teleoperation in user perspective. This helps to lower mental load of an operator and leads to very intuitive way of interaction. To enable this functionality position of RVIZ camera must be published as TF transformation for instance, by plugin from srs_env_model_ui.

Node can publish to two Twist topics. Normally it publish to first one (safe topic in case of Care-O-Bot) and when the left button is pressed on SN, it publishes to second topic (unsafe in case of Care-O-Bot). When right button is pressed once, robot control is switched to the robot perspective. Next press will switch control back to default mode.

Teleop node also offers axis preference which can be useful for some robot bases. This means if user tries to command robot to move in x axis direction for instance, then in some cases (depending on the parameters) small movements in other axes can be ignored.

ROS API

Subscribed Topics

/spacenav/offset (geometry_msgs/Vector3) /spacenav/rot_offset (geometry_msgs/Vector3) /spacenav/joy (sensor_msgs/Joy)

Published Topics

/cmd_vel_safe (geometry_msgs/Twist) /cmd_vel_unsafe (geometry_msgs/Twist)

Services

~disable (std_srvs/Empty) ~enable (std_srvs/Empty)

Parameters

~max_vel_x (double, default: "0.3") ~max_vel_y (double, default: "0.2") ~max_vel_th (double, default: "0.3") ~spacenav/max_val (double, default: "350.0") ~spacenav/min_val_th (double, default: "0.05") ~spacenav/ignore_th_high (double, default: "0.9") ~spacenav/ignore_th_low (double, default: "0.1")
  • Lower threshold for axis preference.
~spacenav/instant_stop_enabled (bool, default: "false")
  • When enabled, robot can be stopped by pressing SN. Teleop will then publish zero velocities for few seconds.
~use_rviz_cam (bool, default: "false")
  • Enables/disables usage of RVIZ camera position to transform control commands according to it.
~rviz_cam_link (string, default: "/rviz_cam")
  • RVIZ camera TF frame.

Usage example

To test with simulated Care-O-Bot run following command:

roslaunch cob_spacenav_teleop spacenav_teleop_test_sim.launch

To test with a real robot, connect SN and launch its driver:

rosrun spacenav_node spacenav_node

Launch teleop:

roslaunch cob_spacenav_teleop spacenav_teleop.launch


2019-11-09 12:35