机器人 / 系统课时
使用 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 执行:
source /opt/ros/jazzy/setup.bash
ros2 run turtlesim turtlesim_node预期结果:弹出 turtlesim 窗口,默认有一只 turtle1;终端 A 保持运行,充当服务端。若提示找不到 turtlesim 包,应安装 ros-jazzy-turtlesim 后重试。以下命令均在另一个终端 B 中执行,不要关闭终端 A。
找到服务名并确认类型
终端 B 也必须先加载 Jazzy 环境,再列出当前通信域中发现的服务:
source /opt/ros/jazzy/setup.bash
ros2 service list预期输出(节选,实际还包含参数服务等):
/clear
/kill
/reset
/spawn/spawn 是服务名,不是消息类型。通过它查询接口类型:
ros2 service type /spawn预期输出:
turtlesim/srv/Spawn还可以用 ros2 service list -t 一次查看服务名及其类型;其中 /spawn [turtlesim/srv/Spawn] 应当对应起来。调用时服务名和类型都要填写,不能把话题消息类型或其他服务类型填进来。
确定请求和响应字段
在发送请求前,先检查服务接口:
ros2 interface show turtlesim/srv/Spawn预期输出(省略字段注释):
float32 x
float32 y
float32 theta
string name
---
string name分隔线以上是请求字段:x、y 指定海龟在仿真世界中的坐标,theta 是弧度制朝向;请求中的 name 为字符串,传空字符串会由服务端分配名称。分隔线以下是响应字段 name,代表实际创建的海龟名称。不能因为请求和响应都存在 name 就把二者理解成同一方向的数据。
发送请求并核对结果
保持服务端运行,在终端 B 输入:
ros2 service call /spawn turtlesim/srv/Spawn "{x: 2.0, y: 2.0, theta: 0.2, name: ''}"预期输出(全新启动、尚未生成第二只海龟时):
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。不要把“命令已发送”当作执行成功:至少需要核对响应内容,对于这种有可见副作用的服务,还应观察新海龟是否真的出现。