机器人 / 系统课时

使用 CLI 调用已有服务

使用 CLI 调用已有服务

在还没编写 Python 客户端时,可以先用 ROS 2 命令行验证现有服务能否被发现、请求字段是否匹配,以及服务端究竟返回了什么。这里使用 Ubuntu 24.04、ROS 2 Jazzy 的 turtlesim /spawn 服务,完成一次可观察、可重复的调用。

学习目标

  • 使用 ros2 service list 和 ros2 service type 确认服务名与类型。
  • 读取服务接口定义,按 YAML 格式准备请求参数。
  • 调用服务,并通过响应字段和仿真窗口共同验证结果。

启动一个已有服务端

准备已安装 ROS 2 Jazzy 和 turtlesim 的 Ubuntu 24.04 图形桌面环境。在终端 A 执行:

bash
source /opt/ros/jazzy/setup.bash
ros2 run turtlesim turtlesim_node

预期结果:弹出 turtlesim 窗口,默认有一只 turtle1;终端 A 保持运行,充当服务端。若提示找不到 turtlesim 包,应安装 ros-jazzy-turtlesim 后重试。以下命令均在另一个终端 B 中执行,不要关闭终端 A。

找到服务名并确认类型

终端 B 也必须先加载 Jazzy 环境,再列出当前通信域中发现的服务:

bash
source /opt/ros/jazzy/setup.bash
ros2 service list

预期输出(节选,实际还包含参数服务等):

text
/clear
/kill
/reset
/spawn

/spawn 是服务名,不是消息类型。通过它查询接口类型:

bash
ros2 service type /spawn

预期输出:

text
turtlesim/srv/Spawn

还可以用 ros2 service list -t 一次查看服务名及其类型;其中 /spawn [turtlesim/srv/Spawn] 应当对应起来。调用时服务名和类型都要填写,不能把话题消息类型或其他服务类型填进来。

确定请求和响应字段

在发送请求前,先检查服务接口:

bash
ros2 interface show turtlesim/srv/Spawn

预期输出(省略字段注释):

text
float32 x
float32 y
float32 theta
string name
---
string name

分隔线以上是请求字段:x、y 指定海龟在仿真世界中的坐标,theta 是弧度制朝向;请求中的 name 为字符串,传空字符串会由服务端分配名称。分隔线以下是响应字段 name,代表实际创建的海龟名称。不能因为请求和响应都存在 name 就把二者理解成同一方向的数据。

发送请求并核对结果

保持服务端运行,在终端 B 输入:

bash
ros2 service call /spawn turtlesim/srv/Spawn "{x: 2.0, y: 2.0, theta: 0.2, name: ''}"

预期输出(全新启动、尚未生成第二只海龟时):

text
requester: making request: turtlesim.srv.Spawn_Request(x=2.0, y=2.0, theta=0.2, name='')

response:
turtlesim.srv.Spawn_Response(name='turtle2')

CLI 的第三个参数采用 YAML 映射格式,外层双引号交给 Shell,name: '' 表示空字符串。先检查是否出现 response:,再检查返回的 name 非空;同时看仿真窗口是否在 (2.0, 2.0) 附近新增了一只海龟。重复调用时自动分配的名称可能变为 turtle3 等,应以当次响应为准,而不是固定断言 turtle2。

遇到异常时按顺序定位

如果 ros2 service list 中没有 /spawn,先检查终端 A 是否仍在运行、两边是否加载相同 ROS 2 发行版,以及 ROS_DOMAIN_ID 是否一致(两边都未设置也可以)。同一主机的正常实验中,不需要先编写客户端代码才能发现服务。

如果调用一直显示 waiting for service to become available...,表示尚未找到匹配的服务端,可按 Ctrl+C 结束等待并检查服务名。若提示请求解析失败,应回到 ros2 interface show 核对 x、y、theta 的数字类型以及 name 的引号;若类型不符,则重查 ros2 service type /spawn。不要把“命令已发送”当作执行成功:至少需要核对响应内容,对于这种有可见副作用的服务,还应观察新海龟是否真的出现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 CLI 调用已有服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通