ROS Driver for Generic Linux Joysticks

The joy package contains joy_node, a node that interfaces a generic Linux joystick to ROS. This node publishes a “Joy” message, which contains the current state of each one of the joystick’s buttons and axes.

Supported Hardware

This node should work with any joystick that is supported by Linux.

Published Topics

• joy (sensor_msgs/Joy): outputs the joystick state.

Device Selection

There are two parameters controlling which device should be used:

• ~dev (string, default: “/dev/input/js0”)
• ~dev_name (string, default: “” (empty = disabled))

If ~dev_name is empty, ~dev defines the Linux joystick device from which to read joystick events.

If ~dev_name is defined, the node enumerates all available joysticks, i.e. /dev/input/js*. The first joystick matching ~dev_name is opened. If no joystick matches the desired device name, the device specified by ~dev is used as a fallback.

To get a list of the names of all connected joysticks, an invalid ~dev_name can be specified. For example:

rosrun joy joy_node _dev_name:="*"

The output might look like this:

[ INFO]: Found joystick: ST LIS3LV02DL Accelerometer (/dev/input/js1).
[ INFO]: Found joystick: Microsoft X-Box 360 pad (/dev/input/js0).
[ERROR]: Couldn't find a joystick with name *. Falling back to default device.

Then the node can be started with the device name given in the list. For example:

rosrun joy joy_node _dev_name:="Microsoft X-Box 360 pad"

Advanced Parameters

• ~deadzone (double, default: 0.05)
  • Amount by which the joystick has to move before it is considered to be off-center. This parameter is specified relative to an axis normalized between -1 and 1. Thus, 0.1 means that the joystick has to move 10% of the way to the edge of an axis’s range before that axis will output a non-zero value. Linux does its own deadzone processing, so in many cases this value can be set to zero.
• ~autorepeat_rate (double, default: 0.0 (disabled))
  • Rate in Hz at which a joystick that has a non-changing state will resend the previously sent message.
• ~coalesce_interval (double, default: 0.001)
  • Axis events that are received within coalesce_interval (seconds) of each other are sent out in a single ROS message. Since the kernel sends each axis motion as a separate event, coalescing greatly reduces the rate at which messages are sent. This option can also be used to limit the rate of outgoing messages. Button events are always sent out immediately to avoid missing button presses.

Further Information

For further information have a look at the Wiki page.

Changelog for package joy

2.1.0 (2018-06-26)

• fixups after rebase
• 2.0.0

• Fix joystick driver to work with recent changes to rclcpp::Time. (#4) * Fix joystick driver to work with recent changes to rclcpp::Time. Signed-off-by: Chris Lalancette <<clalancette@osrfoundation.org>> * Move creation of time source outside of loop. Signed-off-by: Chris Lalancette <<clalancette@osrfoundation.org>>

• Switch to using the RCUTILS_* macros. (#3) Signed-off-by: Chris Lalancette <<clalancette@openrobotics.org>>
• Move from bin to lib. (#2) Signed-off-by: Chris Lalancette <<clalancette@openrobotics.org>>
• set autorepeat_rate to 20
• remove ROS1 specific files convert package.xml and cmakelists to ROS2 update licence don't lint ported code (and dont make it comply with pedantic) comment out diagnostic code and replace ROS1 calls with ROS2 calls use a rclcpp wall timer rather than a sleep fail if joystick.h not found
• rename joy_node to joy_node_linux
• Merge pull request #108 from hdino/indigo-devel Added dev_name parameter to select joystick by name
• Changed layout of README.md
• Added Readme for joy package with description of new device name parameter
• Added dev_name parameter to select joystick by name
• Merge pull request #107 from honeybee-robotics-forks/indigo-devel Numerous outstanding PRs.
• Added sticky buttons Fixed indentation Added CI config Added sticky buttons Changed messaging to better reflect what the script is doing Added wiimote testing script Changed package xml to format 2 Fixed Indentation Fixed indentation Cleaned up code block Editted argc check block Removed unnesesary comment Formatted conditional block Fixed small errors Added comments decribing variables Removed blank line Fixed formatting issues Add CI config. Add CI config.
• Fixed issue when the joystick data did not got send until changed. Made the fix to error 91 an optional behavior
• Changed package xml to format 2
• Changed messaging to better reflect what the script is doing Fixed minor string error Changed tabs to spaces
• Contributors: Chris Lalancette, Dino Hüllmann, Jonathan Bohren, Mikael Arguedas, Miklos Marton, jprod123, psimona

1.11.0 (2017-02-10)

• fixed joy/Cmakelists for osx
• Update dependencies to remove warnings
• Contributors: Marynel Vazquez, Mark D Horn

1.10.1 (2015-05-24)

• Remove stray architechture_independent flags
• Contributors: Jonathan Bohren, Scott K Logan

1.10.0 (2014-06-26)

• First indigo release