Project

General

Profile

Statistics
| Branch: | Revision:

root / joy / mainpage.dox @ master

History | View | Annotate | Download (2.25 KB)

1
/**
2

    
3
\mainpage
4
\htmlinclude manifest.html
5

    
6
\b joy ROS joystick drivers for Linux. This package works with Logitech joysticks and PS3 SIXAXIS/DUALSHOCK devices. This package will only build is linux/joystick.h
7

    
8
\section rosapi ROS API
9

    
10
This package contains the message "Joy", which carries data from the joystick's axes and buttons. It also has the joy_node, which reads from a given joystick port and publishes "Joy" messages.
11

    
12
List of nodes:
13
- \b joy_node
14

    
15
Deprecated nodes:
16
- \b txjoy 
17
- \b joy 
18
The deprecated nodes are the same as the joy_node, but they will warn users when used. They are actually just bash scripts that call "joy_node" and print a warning. 
19

    
20
<hr>
21

    
22
\subsection joy joy
23

    
24
\b joy ROS joystick driver for all linux joysticks. The driver will poll a given port until it can read from it, the publish Joy messages of the joystick state. If the port closes, or it reads an error, it will reopen the port. All axes are in the range [-1, 1], and all buttons are 0 (off) or 1 (on). 
25

    
26
Since the driver will poll for the joystick port, and automatically reopen the port if it's closed, the joy_node should be "on" whenever possible. It is typically part of the robot's launch file.
27

    
28
\subsubsection autorepeat Auto-Repeat/Signal Loss
29

    
30
The joy_node takes an "~autorepeat_rate" parameter. If the linux kernal receives no events during the autorepeat interval, it will automatically repeat the last value of the joystick. This is an important safety feature, and allows users to recover from a joystick that has timed out.
31

    
32
\subsubsection usage Usage
33
\verbatim
34
$ joy [standard ROS args]
35
\endverbatim
36

    
37
\subsubsection topic ROS topics
38

    
39
Subscribes to (name / type):
40
- None
41

    
42
Publishes to (name / type):
43
- \b "joy/Joy" : Joystick output. Axes are [-1, 1], buttons are 0 or 1 (depressed).
44

    
45
\subsubsection parameters ROS parameters
46
- \b "~dev" : Input device for joystick. Default: /dev/input/js0
47
- \b "~deadzone" : Output is zero for axis in deadzone. Range: [-0.9, 0.9]. Default 0.05
48
- \b "~autorepeat_rate" : If no events, repeats last known state at this rate. Defualt: 0 (disabled)
49
- \b "~coalesce_interval" : Waits for this interval (seconds) after receiving an event. If multiple events happen in this interval, only one message will be sent. Reduces number of messages. Default: 0.001.
50

    
51

    
52
<hr>
53

    
54

    
55

    
56
*/