No version for distro galactic. Known supported distros are highlighted in the buttons above.
No version for distro foxy. Known supported distros are highlighted in the buttons above.
No version for distro rolling. Known supported distros are highlighted in the buttons above.

dynamixel_interface package from dynamixel_interface repo

dynamixel_interface

Package Summary

Tags No category tags.
Version 1.0.0
License CSIRO Open Source Software License Agreement (variation of the BSD / MIT License)
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/csiro-robotics/dynamixel_interface.git
VCS Type git
VCS Version noetic-devel
Last Updated 2021-09-22
Dev Status MAINTAINED
CI status No Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

dynamixel_interface aims to provide a fast, scalable and easily configurable interface for controlling the Robotis 'Dynamixel' brand of servo motors. It is implemented in c++ and is based on the official robotis dynamixel_sdk. The controller is designed to handle many dynamixels at once and can synchronously communicate with dynamixels spread across multiple serial ports. The controller can run in either position, velocity or torque control modes and is easily configured with an external yaml file.

Additional Links

No additional links.

Maintainers

  • Tom Molnar

Authors

  • Tom Molnar

Dynamixel Interface: A Fast, Scalable Dynamixel Driver

Version License

Gizmo Wizmo Zero

This package aims to provide a scalable and easily configurable interface for controlling many dynamixel's across multiple serial devices.

Features:

  • Fast C++ implementation capable of controlling 10's of dynamixels at very high (>100Hz) rates.
  • Easily configure all dynamixels in a single yaml file
  • Synchronous across multiple serial ports (using threaded IO)
  • All dynamixel states/commands are exchanged via a single sensor_msgs/JointState message
  • Supports position, velocity and current* control modes.
    • In position control mode, can supply profile velocities as well

*current control not available on all models.

Currently the following series of motors are supported:

  • AX
  • RX
  • DX
  • EX
  • MX
  • XM
  • PRO
  • PRO+
  • P

INSTALLATION

Requirements

  • Ubuntu 18.04 LTS and ROS Melodic; or
  • Ubuntu 20.04 LTS and ROS Noetic

Dependencies

Building from source

mkdir -p catkin_ws/src
cd catkin_ws/src
git clone https://github.com/csiro-robotics/dynamixel_interface.git
cd ..
rosdep install --from-paths src --ignore-src -r -y
catkin build

USAGE NOTES

For detailed instructions, consult the tutorials in the subdirectory of this package:

Serial Access

For serial communications, give the user access to the dialout group


sudo usermod -a -G dialout $USER


Operation

To use the dynamixel_interface_controller to operate servos:

  • Create a controller_config.yaml with the necessary parameters for each servo (see the tutorials as well as the example in the config/ folder for an example and explanation of the various configuration options)
  • Launch the dynamixel_interface_controller_node, loading in the custom config file (see the example in the launch/ folder)

During operation:

  • The controller communicates using the sensor_msgs::JointState message.
  • Current joint states are published to /joint_states
  • Commands should be sent to /desired_joint_states
  • For each control mode

    • Position Control: only position and velocity are considered in the command message, velocity controls the moving speed to the goal position of the dynamixel. If no velocity is specified the default is used
    • Velocity Control: only the velocity value is considered
    • Torque Control: only the effort value is considered
    • Note that all non-empty arrays must have the same length as the array of joint_names, otherwise the command is invalid

A note on units:

  • Positions are in radians
  • Velocities are in radians/second
  • Effort is in mA of current

IMPROVING DRIVER PERFORMANCE

This driver is designed with goal of achieveing the maximum possible loop rate for a given configuration of dynamixels. To that end, there are three key optimisations that we recommend :

Baud rate

The baud rate used to communicate on the bus directly affects the maximum achieveable loop rate on the bus. A higher loop rate will result in faster update rates but can reduce the noise the bus can tolerate, for most applications the recommended baud rate is the maximum of 3Mbps.

Return delay time

The return delay time is a parameter on the dynamixels that sets the amount of delay in microseconds before they respond to a packet, by default this value is quite large (250, which equates to 500 microseconds). Lowering this value will reduce the total round-trip time for any comms on the bus. It is recommended to set this value very low (tested at 5, or 10 microseconds).

Both the above values will need to be configured PRIOR TO OPERATION using the dynamixel wizard available from robotis.

FTDI DRIVER LATENCY FOR SERIAL COMMUINICATIONS

Since 16.04, the default latency_timer value for the ftdi usb driver was changed from 1ms to 16ms. This value represents how long the kernel driver waits before passing data up to the user application. It significantly affects the speed the driver will be able to communicate with the dynamixels, resulting in very low achievable loop rates. To correct this, a script is included that can change a serial port into 'low latency' mode (a latency_timer value of 1), which requires the installation of the setserial command:


sudo apt install setserial


then, run the script (no roscore required) with:


rosrun dynamixel_interface set_lowlatency_mode.sh <port>


If setserial is not available as a command on your system, the value for the device can be set directly in the kernel:


echo "1" | sudo tee /sys/bus/usb-serial/devices/<device>/latency_timer


Authors

  • Thomas Molnar
  • Ryan Steindl
  • Marisa Bucolo
  • Benjamin Tam
  • Jacob Oestreich

License

This project is licensed under the CSIRO Open Source Software Licence Agreement (variation of the BSD / MIT License) - see the LICENSE file for details.

Contributing

Thank you for being interested in contributing. We encourage the community to create new features and to fix bugs. If it is a new feature, please create a new issue via the Issue Tracker and describe the intended feature so that we can discuss the implementation. Else, search for the existing issue and comment on your proposed work. Please fork the repo, work on your changes and then send a pull request.

Issues

Please report bugs using Issue Tracker or contact us via email shc-support@csiro.au.

CHANGELOG

Changelog for package dynamixel_interface

1.0.0 (2021-09-06) -----------* Initial Release

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged dynamixel_interface at answers.ros.org

dynamixel_interface package from dynamixel_interface repo

dynamixel_interface

Package Summary

Tags No category tags.
Version 1.0.0
License CSIRO Open Source Software License Agreement (variation of the BSD / MIT License)
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/csiro-robotics/dynamixel_interface.git
VCS Type git
VCS Version noetic-devel
Last Updated 2021-09-22
Dev Status MAINTAINED
CI status No Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

dynamixel_interface aims to provide a fast, scalable and easily configurable interface for controlling the Robotis 'Dynamixel' brand of servo motors. It is implemented in c++ and is based on the official robotis dynamixel_sdk. The controller is designed to handle many dynamixels at once and can synchronously communicate with dynamixels spread across multiple serial ports. The controller can run in either position, velocity or torque control modes and is easily configured with an external yaml file.

Additional Links

No additional links.

Maintainers

  • Tom Molnar

Authors

  • Tom Molnar

Dynamixel Interface: A Fast, Scalable Dynamixel Driver

Version License

Gizmo Wizmo Zero

This package aims to provide a scalable and easily configurable interface for controlling many dynamixel's across multiple serial devices.

Features:

  • Fast C++ implementation capable of controlling 10's of dynamixels at very high (>100Hz) rates.
  • Easily configure all dynamixels in a single yaml file
  • Synchronous across multiple serial ports (using threaded IO)
  • All dynamixel states/commands are exchanged via a single sensor_msgs/JointState message
  • Supports position, velocity and current* control modes.
    • In position control mode, can supply profile velocities as well

*current control not available on all models.

Currently the following series of motors are supported:

  • AX
  • RX
  • DX
  • EX
  • MX
  • XM
  • PRO
  • PRO+
  • P

INSTALLATION

Requirements

  • Ubuntu 18.04 LTS and ROS Melodic; or
  • Ubuntu 20.04 LTS and ROS Noetic

Dependencies

Building from source

mkdir -p catkin_ws/src
cd catkin_ws/src
git clone https://github.com/csiro-robotics/dynamixel_interface.git
cd ..
rosdep install --from-paths src --ignore-src -r -y
catkin build

USAGE NOTES

For detailed instructions, consult the tutorials in the subdirectory of this package:

Serial Access

For serial communications, give the user access to the dialout group


sudo usermod -a -G dialout $USER


Operation

To use the dynamixel_interface_controller to operate servos:

  • Create a controller_config.yaml with the necessary parameters for each servo (see the tutorials as well as the example in the config/ folder for an example and explanation of the various configuration options)
  • Launch the dynamixel_interface_controller_node, loading in the custom config file (see the example in the launch/ folder)

During operation:

  • The controller communicates using the sensor_msgs::JointState message.
  • Current joint states are published to /joint_states
  • Commands should be sent to /desired_joint_states
  • For each control mode

    • Position Control: only position and velocity are considered in the command message, velocity controls the moving speed to the goal position of the dynamixel. If no velocity is specified the default is used
    • Velocity Control: only the velocity value is considered
    • Torque Control: only the effort value is considered
    • Note that all non-empty arrays must have the same length as the array of joint_names, otherwise the command is invalid

A note on units:

  • Positions are in radians
  • Velocities are in radians/second
  • Effort is in mA of current

IMPROVING DRIVER PERFORMANCE

This driver is designed with goal of achieveing the maximum possible loop rate for a given configuration of dynamixels. To that end, there are three key optimisations that we recommend :

Baud rate

The baud rate used to communicate on the bus directly affects the maximum achieveable loop rate on the bus. A higher loop rate will result in faster update rates but can reduce the noise the bus can tolerate, for most applications the recommended baud rate is the maximum of 3Mbps.

Return delay time

The return delay time is a parameter on the dynamixels that sets the amount of delay in microseconds before they respond to a packet, by default this value is quite large (250, which equates to 500 microseconds). Lowering this value will reduce the total round-trip time for any comms on the bus. It is recommended to set this value very low (tested at 5, or 10 microseconds).

Both the above values will need to be configured PRIOR TO OPERATION using the dynamixel wizard available from robotis.

FTDI DRIVER LATENCY FOR SERIAL COMMUINICATIONS

Since 16.04, the default latency_timer value for the ftdi usb driver was changed from 1ms to 16ms. This value represents how long the kernel driver waits before passing data up to the user application. It significantly affects the speed the driver will be able to communicate with the dynamixels, resulting in very low achievable loop rates. To correct this, a script is included that can change a serial port into 'low latency' mode (a latency_timer value of 1), which requires the installation of the setserial command:


sudo apt install setserial


then, run the script (no roscore required) with:


rosrun dynamixel_interface set_lowlatency_mode.sh <port>


If setserial is not available as a command on your system, the value for the device can be set directly in the kernel:


echo "1" | sudo tee /sys/bus/usb-serial/devices/<device>/latency_timer


Authors

  • Thomas Molnar
  • Ryan Steindl
  • Marisa Bucolo
  • Benjamin Tam
  • Jacob Oestreich

License

This project is licensed under the CSIRO Open Source Software Licence Agreement (variation of the BSD / MIT License) - see the LICENSE file for details.

Contributing

Thank you for being interested in contributing. We encourage the community to create new features and to fix bugs. If it is a new feature, please create a new issue via the Issue Tracker and describe the intended feature so that we can discuss the implementation. Else, search for the existing issue and comment on your proposed work. Please fork the repo, work on your changes and then send a pull request.

Issues

Please report bugs using Issue Tracker or contact us via email shc-support@csiro.au.

CHANGELOG

Changelog for package dynamixel_interface

1.0.0 (2021-09-06) -----------* Initial Release

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged dynamixel_interface at answers.ros.org

No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.
No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.