[Documentation] [TitleIndex] [WordIndex

Only released in EOL distros:  

hrl_hardware_drivers: force_torque | hrl_hokuyo | hrl_segway_omni | hrl_tilting_hokuyo | pan_tilt_robotis | phantom_omni | robotis | zenither

Package Summary

This package is designed to operate, query, and control Robotis Dynamixel 'smart' Servos using a USB2Dynamixel adaptor. It has been tested on the RX-28 and RX-64 servo variants.

  • Author: Travis Deyle, Advait Jain, Marc Killpack, Advisor: Prof. Charlie Kemp, Lab: Healthcare Robotics Lab at Georgia Tech
  • License: New BSD
  • Source: git https://code.google.com/p/gt-ros-pkg.hrl/ (branch: master)


A more detailed coding tutorial, application overviews, and a servo disassembly can be found on Hizook.com. Robotis Dynamixel servos and USB2Dynamixel adaptors (used for communication with the servos) can be purchased online.

This package includes a stand-alone library (lib_robotis.py) for querying and controlling Robotis Dynamixel Servos. The code is written entirely in Python and is thread-safe, so that multiple servo objects can be controlled / queried "simultaneously" on the same USB2Dynamixel bus (within the same process). The library should function on Linux, Mac, and Windows (yay, python!), and the only dependency is pyserial for communications. The code has only been tested on the RX-28 and RX-64 variants. Sample usage is shown below; more comprehensive explanations can be found on Hizook.com.

from lib_robotis import *
dyn = USB2Dynamixel_Device('/dev/ttyUSB0')
p = Robotis_Servo( dyn, 11 )
t = Robotis_Servo( dyn, 12 )
t.move_angle( math.radians( 10 ), blocking = False )
p.move_angle( math.radians( 10 ), blocking = False )

ROS wrappers (messages and services) have also been implemented to query and control the servos remotely. Again, sample usage is shown below and more comprehensive explanations can be found on Hizook.com.

import roslib
import rospy
from robotis.ros_robotis import *

poller = ROS_Robotis_Poller( '/dev/ttyUSB0', [11,12], ['pan', 'tilt'] )

Essentially, the poller is implemented thusly:

import roslib
import rospy

import robotis.lib_robotis as rs
print 'Sample Server: '

# Important note: You cannot (!) use the same device in another
# process. The device is only "thread-safe" within the same process
# (i.e.  between servos (and callbacks) instantiated within that
# process)

dev_name = '/dev/ttyUSB0'
ids = [11, 12]
names = ['pan', 'tilt']

dyn = rs.USB2Dynamixel_Device( dev_name )

servos = [ rs.Robotis_Servo( dyn, i ) for i in ids ]
ros_servers = [ ROS_Robotis_Server( s, n ) for s,n in zip( servos, names ) ]

    while not rospy.is_shutdown():
        [ s.update_server() for s in ros_servers ]

Older libraries (robotis_servo.py) are also present, but are now deprecated.

./robotis_servo -h # this will print out the command line params that the code accepts.

./robotis_servo -d /dev/ttyUSB0 --ang=30 --id=1 # moves a servo with id 1 connected to ttyUSB0 to angle 30 degrees.

2024-05-18 13:07