Creating a service server in ROS - Why You Should Know This

The Big Idea

Discover how a simple service server can make your robot smart and responsive without headaches!

The Scenario

Imagine you have a robot that needs to answer questions like "What is your battery level?" or "Can you move to this position?" by manually checking and replying every time someone asks.

The Problem

Manually handling each request means writing lots of repeated code to listen, check, and respond. It's easy to miss requests or send wrong answers, making the robot unreliable and slow.

The Solution

Creating a service server in ROS lets your robot automatically listen for requests and reply correctly using a simple, organized setup. This makes communication clear and dependable.

Before vs After

✗ Before

while True:
  if request_received():
    check_request()
    send_response()

✓ After

def handle_request(req):
  return response
service = rospy.Service('service_name', ServiceType, handle_request)
rospy.spin()

What It Enables

It enables your robot to respond instantly and correctly to many different requests without messy code or confusion.

Real Life Example

A delivery robot uses a service server to confirm if it can pick up a package when asked, ensuring smooth coordination with the control center.

Key Takeaways

Manual request handling is slow and error-prone.

Service servers automate request-response communication.

This leads to reliable and clean robot interactions.

Practice

1. What is the main role of a service server in ROS?

easy

A. To publish messages continuously

B. To wait for requests and send back replies

C. To subscribe to topics and process data

D. To log information to the console

Solution

1. Step 1: Understand the service server role

   A service server in ROS waits for incoming requests from clients and sends back replies after processing.

2. Step 2: Differentiate from other ROS nodes

   Unlike publishers or subscribers, a service server handles request-response communication, not continuous data streams.

3. Final Answer:

   To wait for requests and send back replies -> Option B

4. Quick Check:

   Service server = request and reply [OK]

Hint: Service servers handle requests and replies, not continuous data [OK]

Common Mistakes:

• Confusing service servers with publishers
• Thinking service servers subscribe to topics
• Assuming service servers only log data

2. Which of the following is the correct way to create a service server in ROS using rospy?

easy

A. server = rospy.Client('service_name', ServiceType, handler_function)

B. server = rospy.Publisher('service_name', ServiceType, handler_function)

C. server = rospy.Subscriber('service_name', ServiceType, handler_function)

D. server = rospy.Service('service_name', ServiceType, handler_function)

Solution

1. Step 1: Identify the correct rospy function

   The function to create a service server is rospy.Service, which takes the service name, service type, and handler function.

2. Step 2: Exclude other ROS communication methods

   Publisher and Subscriber are for topics, Client is not a rospy function for servers.

3. Final Answer:

   server = rospy.Service('service_name', ServiceType, handler_function) -> Option D

4. Quick Check:

   Service server creation = rospy.Service [OK]

Hint: Use rospy.Service to create service servers, not Publisher or Subscriber [OK]

Common Mistakes:

• Using rospy.Publisher instead of rospy.Service
• Confusing service server with subscriber
• Trying to use a non-existent rospy.Client

3. Given the following ROS service server code snippet, what will be the output when a client sends a request with data=5?

import rospy
from beginner_tutorials.srv import AddTwoInts, AddTwoIntsResponse

def handle_add_two_ints(req):
    return AddTwoIntsResponse(req.a + req.b)

rospy.init_node('add_two_ints_server')
service = rospy.Service('add_two_ints', AddTwoInts, handle_add_two_ints)
rospy.spin()

medium

A. The server returns the sum of req.a and req.b

B. The server returns the product of req.a and req.b

C. The server returns the difference of req.a and req.b

D. The server returns an error because of missing return statement

Solution

1. Step 1: Analyze the handler function

   The function handle_add_two_ints returns the sum of req.a and req.b wrapped in AddTwoIntsResponse.

2. Step 2: Understand the server behavior on request

   When a client sends a request with data=5 (assuming req.a=5 and req.b is provided), the server replies with their sum.

3. Final Answer:

   The server returns the sum of req.a and req.b -> Option A

4. Quick Check:

   Handler returns sum = The server returns the sum of req.a and req.b [OK]

Hint: Handler returns sum of inputs; check return statement carefully [OK]

Common Mistakes:

• Assuming multiplication instead of addition
• Forgetting to return a response object
• Confusing request fields names

4. Identify the error in this ROS service server code snippet:

import rospy
from beginner_tutorials.srv import AddTwoInts, AddTwoIntsResponse

def handle_add(req):
    sum = req.a + req.b

rospy.init_node('add_two_ints_server')
service = rospy.Service('add_two_ints', AddTwoInts, handle_add)
rospy.spin()

medium

A. The handler function does not return a response object

B. The service name is invalid

C. The node is not initialized

D. The service type is incorrect

Solution

1. Step 1: Check the handler function

   The handler function calculates sum but does not return AddTwoIntsResponse, which is required.

2. Step 2: Verify other parts of the code

   The service name, node initialization, and service type are correct and valid.

3. Final Answer:

   The handler function does not return a response object -> Option A

4. Quick Check:

   Handler must return response [OK]

Hint: Always return a response object from the handler function [OK]

Common Mistakes:

• Forgetting to return AddTwoIntsResponse
• Misnaming the handler function
• Not calling rospy.init_node

5. You want to create a ROS service server that returns the maximum of two integers sent by the client. Which handler function correctly implements this behavior?

hard

A. def handle_max(req):
return MaxIntsResponse(max(req.a, req.b))

B. def handle_max(req):
return MaxIntsResponse(req.a + req.b)

C. def handle_max(req):
if req.a > req.b:
return MaxIntsResponse(req.a)
else:
return MaxIntsResponse(req.b)

D. def handle_max(req):
return MaxIntsResponse(min(req.a, req.b))

Solution

1. Step 1: Understand the requirement

   The server must return the maximum of two integers sent by the client.

2. Step 2: Evaluate each handler function

   def handle_max(req): return MaxIntsResponse(max(req.a, req.b)) uses max() but assumes MaxIntsResponse accepts a single argument correctly; def handle_max(req): if req.a > req.b: return MaxIntsResponse(req.a) else: return MaxIntsResponse(req.b) explicitly returns the max value using if-else and returns response properly; def handle_max(req): return MaxIntsResponse(req.a + req.b) returns sum, which is incorrect; def handle_max(req): return MaxIntsResponse(min(req.a, req.b)) returns minimum, which is wrong.

3. Final Answer:

   def handle_max(req): if req.a > req.b: return MaxIntsResponse(req.a) else: return MaxIntsResponse(req.b) -> Option C

4. Quick Check:

   Correct max logic with proper return = def handle_max(req): if req.a > req.b: return MaxIntsResponse(req.a) else: return MaxIntsResponse(req.b) [OK]

Hint: Use if-else to return max value wrapped in response [OK]

Common Mistakes:

• Returning sum instead of max
• Returning min instead of max
• Incorrectly using max() without proper response