Joystick control with joy package in ROS - Mini Project: Build & Apply

Joystick Control with joy Package in ROS

📖 Scenario: You want to control a robot using a joystick. ROS provides a joy package that reads joystick inputs and publishes them as messages. You will create a simple ROS node that subscribes to joystick messages and processes button presses and axis movements.

🎯 Goal: Build a ROS node that subscribes to the /joy topic, reads joystick button and axis data, and prints simple messages when specific buttons are pressed or axes moved.

📋 What You'll Learn

Create a ROS subscriber node in Python named joy_listener.

Subscribe to the /joy topic with message type sensor_msgs.msg.Joy.

Define a callback function named joy_callback that processes joystick data.

Print a message when button 0 is pressed and when axis 1 moves above 0.5.

💡 Why This Matters

🌍 Real World

Joystick control is common in robotics to manually drive or control robots in real time.

💼 Career

Understanding ROS joystick integration is useful for robotics engineers working on teleoperation and human-robot interaction.

1

DATA SETUP: Import ROS and create the node

Import rclpy and sensor_msgs.msg.Joy. Initialize a ROS node called joy_listener.

ROS

# Import rclpy and Joy message
# Initialize ROS node named 'joy_listener'
# Your code here

Hint

Use rclpy.init() to start ROS and Node('joy_listener') to create the node.

2

CONFIGURATION: Create the subscriber to /joy topic

Create a subscriber on the /joy topic using node.create_subscription. Use Joy as the message type and joy_callback as the callback function.

ROS

import rclpy
from rclpy.node import Node
from sensor_msgs.msg import Joy

rclpy.init()
node = Node('joy_listener')

# Create subscriber to '/joy' topic with Joy message and joy_callback
# Your code here

Hint

Use node.create_subscription with the topic '/joy', message type Joy, and callback joy_callback.

3

CORE LOGIC: Define the joy_callback function

Define a function named joy_callback that takes a msg parameter. Inside, check if msg.buttons[0] is pressed (value 1) and if msg.axes[1] is greater than 0.5. Print "Button 0 pressed" and "Axis 1 moved up" accordingly.

ROS

import rclpy
from rclpy.node import Node
from sensor_msgs.msg import Joy

rclpy.init()
node = Node('joy_listener')

subscription = node.create_subscription(Joy, '/joy', joy_callback, 10)

# Define joy_callback function to check button 0 and axis 1
# Your code here

Hint

Use msg.buttons[0] and msg.axes[1] to check joystick inputs inside the callback.

4

COMPLETION: Spin the node to process callbacks

Add rclpy.spin(node) to keep the node running and processing joystick messages.

ROS

import rclpy
from rclpy.node import Node
from sensor_msgs.msg import Joy

rclpy.init()
node = Node('joy_listener')

def joy_callback(msg):
    if msg.buttons[0] == 1:
        print("Button 0 pressed")
    if msg.axes[1] > 0.5:
        print("Axis 1 moved up")

subscription = node.create_subscription(Joy, '/joy', joy_callback, 10)

# Keep the node running to listen for joystick messages
# Your code here

Hint

Use rclpy.spin(node) to keep your node alive and processing messages.

Practice

1. What is the main purpose of the joy package in ROS?

easy

A. To read joystick inputs and publish them as ROS messages

B. To control robot motors directly

C. To visualize sensor data in RViz

D. To simulate robot movements in Gazebo

Solution

1. Step 1: Understand the role of the joy package

   The joy package reads input from a joystick device and converts it into ROS messages.

2. Step 2: Identify what the package publishes

   It publishes joystick data on the /joy topic for other nodes to use.

3. Final Answer:

   To read joystick inputs and publish them as ROS messages -> Option A

4. Quick Check:

   joy package = joystick input publisher [OK]

Hint: Remember joy package publishes joystick data on /joy topic [OK]

Common Mistakes:

• Confusing joy package with motor control packages
• Thinking joy package visualizes data
• Assuming joy package simulates robots

2. Which ROS topic should you subscribe to in order to receive joystick data from the joy package?

easy

A. /scan

B. /cmd_vel

C. /odom

D. /joy

Solution

1. Step 1: Identify the topic published by joy package

   The joy package publishes joystick messages on the /joy topic.

2. Step 2: Match the topic to subscription

   To get joystick data, subscribe to /joy, not other topics like /cmd_vel or /odom.

3. Final Answer:

   /joy -> Option D

4. Quick Check:

   Subscribe to /joy for joystick data [OK]

Hint: Joystick data is always on /joy topic [OK]

Common Mistakes:

• Subscribing to /cmd_vel instead of /joy
• Confusing sensor topics like /scan with joystick
• Using /odom which is for odometry

3. Given the following Python callback for joystick data, what will be printed if the joystick's first axis value is 0.5 and the first button is pressed (value 1)?

def joy_callback(data):
    print(f"Axis 0: {data.axes[0]}")
    print(f"Button 0: {data.buttons[0]}")

medium

A. Axis 0: 1
Button 0: 0.5

B. Axis 0: 0.5
Button 0: 1

C. Axis 0: 0
Button 0: 0

D. Axis 0: 1
Button 0: 1

Solution

1. Step 1: Understand data.axes and data.buttons arrays

   The axes array holds float values for joystick axes; buttons holds integers for button states.

2. Step 2: Match given values to print statements

   Given axis 0 is 0.5 and button 0 is pressed (1), the print outputs match exactly those values.

3. Final Answer:

   Axis 0: 0.5 Button 0: 1 -> Option B

4. Quick Check:

   axes[0]=0.5, buttons[0]=1 [OK]

Hint: Axes are floats, buttons are integers in joystick messages [OK]

Common Mistakes:

• Mixing axes and buttons values
• Assuming buttons are floats
• Confusing index positions

4. What is wrong with this ROS Python subscriber code for joystick data?

import rospy
from sensor_msgs.msg import Joy

def callback(data):
    print(data.axes[0])

rospy.init_node('joy_listener')
rospy.Subscriber('/joy', Joy, callback)
rospy.spin()

medium

A. The subscriber topic name should be '/joy_data' not '/joy'

B. The callback function is missing the 'self' parameter

C. The code is correct and will print the first axis value

D. The message type should be Twist, not Joy

Solution

1. Step 1: Check topic and message type correctness

   The joy package publishes on '/joy' topic with message type Joy, which matches the subscriber.

2. Step 2: Verify callback function signature and usage

   The callback takes one argument (data) and prints the first axis value correctly.

3. Final Answer:

   The code is correct and will print the first axis value -> Option C

4. Quick Check:

   Subscriber to /joy with Joy message and callback is correct [OK]

Hint: Callback for subscriber needs one argument, no self unless in class [OK]

Common Mistakes:

• Using wrong topic name
• Adding 'self' in non-class callback
• Using wrong message type

5. You want to control a robot's forward speed using the joystick's vertical axis (axis 1). Which of these code snippets correctly converts the joystick input to a velocity command published on /cmd_vel topic using the joy package data?

hard

A. velocity.linear.x = data.axes[1]; pub.publish(velocity)

B. velocity.linear.x = data.buttons[1]; pub.publish(velocity)

C. velocity.angular.z = data.axes[1]; pub.publish(velocity)

D. velocity.linear.y = data.axes[0]; pub.publish(velocity)

Solution

1. Step 1: Identify joystick axis for forward speed

   Vertical axis is usually axis 1, which controls forward/backward movement.

2. Step 2: Assign axis value to linear.x velocity

   Forward speed is controlled by linear.x in Twist messages, so assign data.axes[1] to velocity.linear.x.

3. Final Answer:

   velocity.linear.x = data.axes[1]; pub.publish(velocity) -> Option A

4. Quick Check:

   Forward speed = linear.x = axes[1] [OK]

Hint: Forward speed maps to linear.x and vertical joystick axis [OK]

Common Mistakes:

• Using buttons instead of axes for speed
• Assigning to angular.z instead of linear.x
• Using wrong axis index