[ROS]创建srv和msg

本贴最后更新于 2772 天前,其中的信息可能已经水流花落

前言:本教程介绍了如何创建和构建 msg 和 srv 文件,并介绍了 rosmsg,rossrv 和 roscp 命令行工具。

####1.Introduction to msg and srv
msg:msg 文件是简单的文本文件,它描述了 ROS 消息的属性。这些文件被用来生成消息在不同语言下的源码。

srv:srv 文件描述了服务。它由 2 部分组成:请求和响应。

msg 文件保存在包的 msg 字典中。srv 文件保存在 srv 字典中。

msg 文件是简单的文本文件,它的每一行包含一个属性类型和属性名字。下面是属性的类型:

int8, int16, int32, int64 (plus uint*)
float32, float64
string
time, duration
other msg files
variable-length array[] and fixed-length array[C]

ROS 中有一种特殊的类型:Header。Header 包含一个邮戳和 ROS 中普遍使用的坐标帧信息。你将频繁的看到 msg 文件的第一行是 Header header。
这里给出一个使用 msg 的例子,它用到了 Header,string,两个其他的 msg:

  Header header
  string child_frame_id
  geometry_msgs/PoseWithCovariance pose
  geometry_msgs/TwistWithCovariance twist

srv 和 msg 很类似,区别在于他们包含的两部分:请求和响应。两个部分之间通过单独的‘---’一行区分。这里给出一个 srv 的例子:

int64 A
int64 B
---
int64 Sum

上面的例子中 A 和 B 是请求,Sum 是响应。

####2.Using msg
#####2.1Creating a msg

让我们在之前创建的包中定义一个新的 msg。

$ cd ~/catkin_ws/src/beginner_tutorials
$ mkdir msg
$ echo "int64 num" > msg/Num.msg

示例中的.msg 文件只包含了一行。当然也可以通过一行添加一个复杂的元素来创建更复杂的文件,就像下面的那样:

string first_name
string last_name
uint8 age
uint32 score

接下来,我们需要确定这个 msg 文件要转换为那种源码,是 C++,Python,还是别的什么语言:
打开 package.xml 文件,确保下面的几行是在文件中,并且取消注释:

  <build_depend>message_generation</build_depend>
  <run_depend>message_generation</run_depend>
  <run_depend>message_runtime</run_depend>

文件中注明在构建的时候,需要"message_generation",运行的时候需要"message_runtime".
打开 CMakeList.txt 文件,在文件中添加 message_generation 依赖到已有的 find_package 标签中。你可以简单的添加 message_generation 到 COMPONENTS 列表中,添加之后为:

# Do not just add this to your CMakeLists.txt, modify the existing text to add message_generation before the closing parenthesis
find_package(catkin REQUIRED COMPONENTS
   roscpp
   rospy
   std_msgs
   message_generation
)

你可能已经注意到很多时候就算你不调用 find_package 添加所有依赖,你的工程也可以构建成功。这是因为 catkin 联合了你的所有工程到一个工程里面,所以如果之前的工程里面调用了 find_package,之后的工程也使用同样的配置。但是忘记调用 find_package 在单独的构建工程的时候非常容易失败。

同样的也需要确定导出运行时依赖的消息。

catkin_package(
  ...
  CATKIN_DEPENDS message_runtime ...
  ...)

找到下面部分的代码:

# add_message_files(
#   FILES
#   Message1.msg
#   Message2.msg
# )

通过删除#符号取消注释,然后替换 Message×.msg 文件为你的.msg 文件,完成之后看起来像:

add_message_files(
  FILES
  Num.msg
)

通过手动的添加.msg 文件,我们可以确定 CMake 知道在你添加了其他的.msg 文件之后需要重新配置工程。
现在我们需要确定 generate_messages()方法被调用了。

对于 ROS Hydro 及其之后的版本, 取消注释下面的几行:

# generate_messages(
#   DEPENDENCIES
#   std_msgs
# )

修改之后为:

generate_messages(
  DEPENDENCIES
  std_msgs
)

在更早的版本,只需要取消注释下面这一行:

generate_messages()

现在我们已经准备好了根据 msg 的定义生成源文件.如果你想立马开始做,忽略接下来的部分,直接跳到 Common step for msg and srv。

####3.Using rosmsg
这就是创建一个 msg 所有需要做的。让我们来确保这个 msg 对于 ROS 是可见的,使用 rosmsg show 即可。
用法:

$ rosmsg show [message type]

例如:

$ rosmsg show beginner_tutorials/Num

将看到:

int64 num

在之前的例子中,消息的类型由 2 部分组成:

beginner_tutorials -- 消息定义在哪个包
Num -- Num 是消息的名称.

如果你不记得是 msg 是在具体哪个包里面,你可以不指定包名。尝试:

$ rosmsg show Num

可以看到:

[beginner_tutorials/Num]:
int64 num

####4.Using srv
#####4.1Creating a srv

首先进入我们之前创建的包去创建一个 srv:

$ roscd beginner_tutorials
$ mkdir srv

这次我们不手动的创建一个新的 srv 定义,而是从别的包中拷贝一个现有的。

为了达成我们的目的,roscp 是一个非常有用的命令行工具,它可以用来从一个包中拷贝文件到另一个包。
方法:

$ roscp [package_name] [file_to_copy_path] [copy_path]

现在我们从 rospy_tutorials 包中拷贝一个服务:
Now we can copy a service from the rospy_tutorials package:

$ roscp rospy_tutorials AddTwoInts.srv srv/AddTwoInts.srv

接下来,我们需要确定这个 srv 文件要转换为那种源码,是 C++,Python,还是别的什么语言:
除非你已经做好了,不然打开 package.xml 文件,然后确保下面两行没有被注释掉:

  <build_depend>message_generation</build_depend>
  <run_depend>message_runtime</run_depend>

像之前那样,在构建的时候需要 message_generation,而在运行的时候,需要 message_runtime。

除非在之前已经在创建新的 msg 的时候做好了,不然接下来需要在 CMakeList.txt 文件中添加 message_generation 依赖:

# Do not just add this line to your CMakeLists.txt, modify the existing line
find_package(catkin REQUIRED COMPONENTS
  roscpp
  rospy
  std_msgs
 message_generation
)

(message_generation 对 msg 和 srv 都生效,所以这里可以不用管名字重复的问题)

同样的你需要对 package.xml 做之前在创建 msg 的时候同样的事情,所以我们向上看看额外需要的依赖:

删除#取消对下面几行的注释:

# add_service_files(
#   FILES
#   Service1.srv
#   Service2.srv
# )

然后把 Service*.srv 这几个文件改成你的文件:

add_service_files(
  FILES
  AddTwoInts.srv
)

现在我们已经准备好了根据服务的定义生成源码了。如果你想立马做的话,跳到 Common step for msg and srv。

#####4.2.Using rossrv

这就是创建一个 srv 需要做的全部事情。让我们通过 rossrv 来确定 ROS 可见我们刚才创建的 srv。
用法:

$ rossrv show <service type>

例如:

$ rossrv show beginner_tutorials/AddTwoInts

你将看到:

int64 a
int64 b
---
int64 sum

跟 rosmsg 类似, 可以找到需要的 srv 文件,而不需要指定包名:

$ rossrv show AddTwoInts
[beginner_tutorials/AddTwoInts]:
int64 a
int64 b
---
int64 sum

[rospy_tutorials/AddTwoInts]:
int64 a
int64 b
---
int64 sum

####5.Common step for msg and srv

确定 CMakeLists.txt 文件中下面的几行没有被注释 :

# generate_messages(
#   DEPENDENCIES
# #  std_msgs  # Or other packages containing msgs
# )

取消注释,然后添加使用 msg 需要依赖的任何.msg 文件,完成之后看起来像下面的样子:

generate_messages(
  DEPENDENCIES
  std_msgs
)

现在已经在包中添加了一些新的 msg,重新 make 包:

# In your catkin workspace
$ cd ../..
$ catkin_make install
$ cd -

任何在 msg 文件夹中的.msg 文件将生成所有能被支持的语言的源码。C++ 消息头文件生成在 ~/catkin_ws/devel/include/beginner_tutorials。Python 脚本创建在 ~/catkin_ws/devel/lib/python2.7/dist-packages/beginner_tutorials/msg。lisp 文件生成在~/catkin_ws/devel/share/common-lisp/ros/beginner_tutorials/msg/。

类似的,任何 srv 目录中的.srv 文件也能生成被支持的语言的源码。对于 C++,生成在 msg 的头文件相同的目录中。对于 Python 和 Lisp,生成在 msg 目录里的 srv 目录。

所有消息格式的描述参考:http://wiki.ros.org/ROS/Message_Description_Language.

如果你使用新的 msg 构建 c++ 节点,你需要在 node 和 message 之间声明依赖,参考:http://docs.ros.org/hydro/api/catkin/html/howto/format2/building_msgs.html
####6.Getting Help

如今已经有了很多的新 ROS 工具。很难去记得每一个命令需要什么参数,幸运的是,大多数的 ROS 工具提供了他们自己的帮助。
运行:

$ rosmsg -h

你可以看到不同的 rosmsg 子命令.

Commands:
  rosmsg show Show message description
  rosmsg users  Find files that use message
  rosmsg md5  Display message md5sum
  rosmsg package  List messages in a package
  rosmsg packages List packages that contain messages

也可以查看子命令的帮助:

$ rosmsg show -h

这个命令显示 rosmsg show 需要那种参数:

Usage: rosmsg show [options] <message type>

Options:
  -h, --help  show this help message and exit
  -r, --raw   show raw message text, including comment

####7.Review
让我们列出一下我们目前位置使用到的命令:

rospack = ros+pack(age) : 提供包的信息
roscd = ros+cd : 进入目标包的目录
rosls = ros+ls : 列出包的文件
roscp = ros+cp : 从一个包拷贝文件到另外一个包
rosmsg = ros+msg : message的定义信息
rossrv = ros+srv : service的定义信息
catkin_make : 编译一个包
rosmake = ros+make : 编译一个包(不在catkin工作目录的时候)

####8.Next Tutorial
接下来我们将学习编写一个简单的发布器和订阅器。

  • ROS
    23 引用 • 2 关注

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...

推荐标签 标签

  • SOHO

    为成为自由职业者在家办公而努力吧!

    7 引用 • 55 回帖 • 99 关注
  • 单点登录

    单点登录(Single Sign On)是目前比较流行的企业业务整合的解决方案之一。SSO 的定义是在多个应用系统中,用户只需要登录一次就可以访问所有相互信任的应用系统。

    9 引用 • 25 回帖 • 9 关注
  • Sillot

    Sillot (汐洛)孵化自思源笔记,致力于服务智慧新彖乄,具有彖乄驱动、极致优雅、开发者友好的特点
    Github 地址:https://github.com/Hi-Windom/Sillot

    12 引用 • 26 关注
  • 微信

    腾讯公司 2011 年 1 月 21 日推出的一款手机通讯软件。用户可以通过摇一摇、搜索号码、扫描二维码等添加好友和关注公众平台,同时可以将自己看到的精彩内容分享到微信朋友圈。

    129 引用 • 791 回帖 • 1 关注
  • 面试

    面试造航母,上班拧螺丝。多面试,少加班。

    324 引用 • 1395 回帖
  • Rust

    Rust 是一门赋予每个人构建可靠且高效软件能力的语言。Rust 由 Mozilla 开发,最早发布于 2014 年 9 月。

    57 引用 • 22 回帖
  • B3log

    B3log 是一个开源组织,名字来源于“Bulletin Board Blog”缩写,目标是将独立博客与论坛结合,形成一种新的网络社区体验,详细请看 B3log 构思。目前 B3log 已经开源了多款产品:SymSoloVditor思源笔记

    1090 引用 • 3467 回帖 • 297 关注
  • NetBeans

    NetBeans 是一个始于 1997 年的 Xelfi 计划,本身是捷克布拉格查理大学的数学及物理学院的学生计划。此计划延伸而成立了一家公司进而发展这个商用版本的 NetBeans IDE,直到 1999 年 Sun 买下此公司。Sun 于次年(2000 年)六月将 NetBeans IDE 开源,直到现在 NetBeans 的社群依然持续增长。

    78 引用 • 102 回帖 • 636 关注
  • 周末

    星期六到星期天晚,实行五天工作制后,指每周的最后两天。再过几年可能就是三天了。

    14 引用 • 297 回帖
  • NGINX

    NGINX 是一个高性能的 HTTP 和反向代理服务器,也是一个 IMAP/POP3/SMTP 代理服务器。 NGINX 是由 Igor Sysoev 为俄罗斯访问量第二的 Rambler.ru 站点开发的,第一个公开版本 0.1.0 发布于 2004 年 10 月 4 日。

    311 引用 • 546 回帖 • 57 关注
  • Kafka

    Kafka 是一种高吞吐量的分布式发布订阅消息系统,它可以处理消费者规模的网站中的所有动作流数据。 这种动作(网页浏览,搜索和其他用户的行动)是现代系统中许多功能的基础。 这些数据通常是由于吞吐量的要求而通过处理日志和日志聚合来解决。

    35 引用 • 35 回帖
  • 黑曜石

    黑曜石是一款强大的知识库工具,支持本地 Markdown 文件编辑,支持双向链接和关系图。

    A second brain, for you, forever.

    9 引用 • 83 回帖
  • 倾城之链
    23 引用 • 66 回帖 • 93 关注
  • 反馈

    Communication channel for makers and users.

    123 引用 • 906 回帖 • 177 关注
  • Webswing

    Webswing 是一个能将任何 Swing 应用通过纯 HTML5 运行在浏览器中的 Web 服务器,详细介绍请看 将 Java Swing 应用变成 Web 应用

    1 引用 • 15 回帖 • 633 关注
  • SMTP

    SMTP(Simple Mail Transfer Protocol)即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。SMTP 协议属于 TCP/IP 协议簇,它帮助每台计算机在发送或中转信件时找到下一个目的地。

    4 引用 • 18 回帖 • 581 关注
  • MongoDB

    MongoDB(来自于英文单词“Humongous”,中文含义为“庞大”)是一个基于分布式文件存储的数据库,由 C++ 语言编写。旨在为应用提供可扩展的高性能数据存储解决方案。MongoDB 是一个介于关系数据库和非关系数据库之间的产品,是非关系数据库当中功能最丰富,最像关系数据库的。它支持的数据结构非常松散,是类似 JSON 的 BSON 格式,因此可以存储比较复杂的数据类型。

    90 引用 • 59 回帖 • 4 关注
  • OpenShift

    红帽提供的 PaaS 云,支持多种编程语言,为开发人员提供了更为灵活的框架、存储选择。

    14 引用 • 20 回帖 • 596 关注
  • Electron

    Electron 基于 Chromium 和 Node.js,让你可以使用 HTML、CSS 和 JavaScript 构建应用。它是一个由 GitHub 及众多贡献者组成的活跃社区共同维护的开源项目,兼容 Mac、Windows 和 Linux,它构建的应用可在这三个操作系统上面运行。

    15 引用 • 136 回帖 • 1 关注
  • LaTeX

    LaTeX(音译“拉泰赫”)是一种基于 ΤΕΧ 的排版系统,由美国计算机学家莱斯利·兰伯特(Leslie Lamport)在 20 世纪 80 年代初期开发,利用这种格式,即使使用者没有排版和程序设计的知识也可以充分发挥由 TeX 所提供的强大功能,能在几天,甚至几小时内生成很多具有书籍质量的印刷品。对于生成复杂表格和数学公式,这一点表现得尤为突出。因此它非常适用于生成高印刷质量的科技和数学类文档。

    9 引用 • 32 回帖 • 179 关注
  • 旅游

    希望你我能在旅途中找到人生的下一站。

    83 引用 • 894 回帖
  • TGIF

    Thank God It's Friday! 感谢老天,总算到星期五啦!

    284 引用 • 4481 回帖 • 652 关注
  • 机器学习

    机器学习(Machine Learning)是一门多领域交叉学科,涉及概率论、统计学、逼近论、凸分析、算法复杂度理论等多门学科。专门研究计算机怎样模拟或实现人类的学习行为,以获取新的知识或技能,重新组织已有的知识结构使之不断改善自身的性能。

    76 引用 • 37 回帖
  • OnlyOffice
    4 引用 • 19 关注
  • Hibernate

    Hibernate 是一个开放源代码的对象关系映射框架,它对 JDBC 进行了非常轻量级的对象封装,使得 Java 程序员可以随心所欲的使用对象编程思维来操纵数据库。

    39 引用 • 103 回帖 • 676 关注
  • SendCloud

    SendCloud 由搜狐武汉研发中心孵化的项目,是致力于为开发者提供高质量的触发邮件服务的云端邮件发送平台,为开发者提供便利的 API 接口来调用服务,让邮件准确迅速到达用户收件箱并获得强大的追踪数据。

    2 引用 • 8 回帖 • 429 关注
  • 安装

    你若安好,便是晴天。

    128 引用 • 1183 回帖