[ROS]创建srv和msg

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

前言:本教程介绍了如何创建和构建 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 子命令.


                
  • ROS
    23 引用 • 2 关注

相关帖子

欢迎来到这里!

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

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

推荐标签 标签

  • Quicker

    Quicker 您的指尖工具箱!操作更少,收获更多!

    32 引用 • 130 回帖 • 2 关注
  • BND

    BND(Baidu Netdisk Downloader)是一款图形界面的百度网盘不限速下载器,支持 Windows、Linux 和 Mac,详细介绍请看这里

    107 引用 • 1281 回帖 • 27 关注
  • AngularJS

    AngularJS 诞生于 2009 年,由 Misko Hevery 等人创建,后为 Google 所收购。是一款优秀的前端 JS 框架,已经被用于 Google 的多款产品当中。AngularJS 有着诸多特性,最为核心的是:MVC、模块化、自动化双向数据绑定、语义化标签、依赖注入等。2.0 版本后已经改名为 Angular。

    12 引用 • 50 回帖 • 474 关注
  • QQ

    1999 年 2 月腾讯正式推出“腾讯 QQ”,在线用户由 1999 年的 2 人(马化腾和张志东)到现在已经发展到上亿用户了,在线人数超过一亿,是目前使用最广泛的聊天软件之一。

    45 引用 • 557 回帖 • 67 关注
  • Pipe

    Pipe 是一款小而美的开源博客平台。Pipe 有着非常活跃的社区,可将文章作为帖子推送到社区,来自社区的回帖将作为博客评论进行联动(具体细节请浏览 B3log 构思 - 分布式社区网络)。

    这是一种全新的网络社区体验,让热爱记录和分享的你不再感到孤单!

    132 引用 • 1114 回帖 • 124 关注
  • 锤子科技

    锤子科技(Smartisan)成立于 2012 年 5 月,是一家制造移动互联网终端设备的公司,公司的使命是用完美主义的工匠精神,打造用户体验一流的数码消费类产品(智能手机为主),改善人们的生活质量。

    4 引用 • 31 回帖 • 4 关注
  • 国际化

    i18n(其来源是英文单词 internationalization 的首末字符 i 和 n,18 为中间的字符数)是“国际化”的简称。对程序来说,国际化是指在不修改代码的情况下,能根据不同语言及地区显示相应的界面。

    8 引用 • 26 回帖
  • Eclipse

    Eclipse 是一个开放源代码的、基于 Java 的可扩展开发平台。就其本身而言,它只是一个框架和一组服务,用于通过插件组件构建开发环境。

    75 引用 • 258 回帖 • 617 关注
  • Logseq

    Logseq 是一个隐私优先、开源的知识库工具。

    Logseq is a joyful, open-source outliner that works on top of local plain-text Markdown and Org-mode files. Use it to write, organize and share your thoughts, keep your to-do list, and build your own digital garden.

    6 引用 • 63 回帖
  • OpenStack

    OpenStack 是一个云操作系统,通过数据中心可控制大型的计算、存储、网络等资源池。所有的管理通过前端界面管理员就可以完成,同样也可以通过 Web 接口让最终用户部署资源。

    10 引用 • 4 关注
  • 大数据

    大数据(big data)是指无法在一定时间范围内用常规软件工具进行捕捉、管理和处理的数据集合,是需要新处理模式才能具有更强的决策力、洞察发现力和流程优化能力的海量、高增长率和多样化的信息资产。

    93 引用 • 113 回帖
  • Chrome

    Chrome 又称 Google 浏览器,是一个由谷歌公司开发的网页浏览器。该浏览器是基于其他开源软件所编写,包括 WebKit,目标是提升稳定性、速度和安全性,并创造出简单且有效率的使用者界面。

    62 引用 • 289 回帖 • 1 关注
  • 星云链

    星云链是一个开源公链,业内简单的将其称为区块链上的谷歌。其实它不仅仅是区块链搜索引擎,一个公链的所有功能,它基本都有,比如你可以用它来开发部署你的去中心化的 APP,你可以在上面编写智能合约,发送交易等等。3 分钟快速接入星云链 (NAS) 测试网

    3 引用 • 16 回帖
  • 前端

    前端技术一般分为前端设计和前端开发,前端设计可以理解为网站的视觉设计,前端开发则是网站的前台代码实现,包括 HTML、CSS 以及 JavaScript 等。

    247 引用 • 1348 回帖
  • 小薇

    小薇是一个用 Java 写的 QQ 聊天机器人 Web 服务,可以用于社群互动。

    由于 Smart QQ 从 2019 年 1 月 1 日起停止服务,所以该项目也已经停止维护了!

    34 引用 • 467 回帖 • 742 关注
  • Kotlin

    Kotlin 是一种在 Java 虚拟机上运行的静态类型编程语言,由 JetBrains 设计开发并开源。Kotlin 可以编译成 Java 字节码,也可以编译成 JavaScript,方便在没有 JVM 的设备上运行。在 Google I/O 2017 中,Google 宣布 Kotlin 成为 Android 官方开发语言。

    19 引用 • 33 回帖 • 63 关注
  • SEO

    发布对别人有帮助的原创内容是最好的 SEO 方式。

    35 引用 • 200 回帖 • 22 关注
  • 服务器

    服务器,也称伺服器,是提供计算服务的设备。由于服务器需要响应服务请求,并进行处理,因此一般来说服务器应具备承担服务并且保障服务的能力。

    125 引用 • 588 回帖
  • abitmean

    有点意思就行了

    29 关注
  • VirtualBox

    VirtualBox 是一款开源虚拟机软件,最早由德国 Innotek 公司开发,由 Sun Microsystems 公司出品的软件,使用 Qt 编写,在 Sun 被 Oracle 收购后正式更名成 Oracle VM VirtualBox。

    10 引用 • 2 回帖 • 6 关注
  • RabbitMQ

    RabbitMQ 是一个开源的 AMQP 实现,服务器端用 Erlang 语言编写,支持多种语言客户端,如:Python、Ruby、.NET、Java、C、PHP、ActionScript 等。用于在分布式系统中存储转发消息,在易用性、扩展性、高可用性等方面表现不俗。

    49 引用 • 60 回帖 • 362 关注
  • CloudFoundry

    Cloud Foundry 是 VMware 推出的业界第一个开源 PaaS 云平台,它支持多种框架、语言、运行时环境、云平台及应用服务,使开发人员能够在几秒钟内进行应用程序的部署和扩展,无需担心任何基础架构的问题。

    5 引用 • 18 回帖 • 167 关注
  • 支付宝

    支付宝是全球领先的独立第三方支付平台,致力于为广大用户提供安全快速的电子支付/网上支付/安全支付/手机支付体验,及转账收款/水电煤缴费/信用卡还款/AA 收款等生活服务应用。

    29 引用 • 347 回帖
  • etcd

    etcd 是一个分布式、高可用的 key-value 数据存储,专门用于在分布式系统中保存关键数据。

    5 引用 • 26 回帖 • 528 关注
  • flomo

    flomo 是新一代 「卡片笔记」 ,专注在碎片化时代,促进你的记录,帮你积累更多知识资产。

    5 引用 • 107 回帖
  • C

    C 语言是一门通用计算机编程语言,应用广泛。C 语言的设计目标是提供一种能以简易的方式编译、处理低级存储器、产生少量的机器码以及不需要任何运行环境支持便能运行的编程语言。

    85 引用 • 165 回帖 • 1 关注
  • Openfire

    Openfire 是开源的、基于可拓展通讯和表示协议 (XMPP)、采用 Java 编程语言开发的实时协作服务器。Openfire 的效率很高,单台服务器可支持上万并发用户。

    6 引用 • 7 回帖 • 94 关注