ros2 高级组件其四之 webots

1 前言和资料2 正文2.1 webots 引入和学习资料2.2 webots 安装以及样例测试2.3 自编写 webots_demo 3 总结

1 前言和资料

当前，在机器人仿真领域，有两大产品比较突出，一是来自 ros 社区的 gazebo，二是从商业转向开源的 webots。通常情况下，ros 的学习者都会深入研究 gazebo，比如本人之前的 ROS高效进阶系列。但由于 webots 转向开源，加上 ros 的支持，影响力越来越大，ros2 humble 官方 Tutorials 也正式引入了 webots 的内容。

本文先介绍 webots 以及学习资料，然后安装并测试 webots，最后基于 ros2 humble 官方 Tutorials 中 webots 的内容，利用 webots 实现一个差速轮式机器人的运动仿真。

本文参考资料如下：

（1）Simulation-Webots

（2）其他资料见文章内容

2 正文

2.1 webots 引入和学习资料

（1）webots 引入：webots 是来自瑞士的 Cyberbotics 公司（Cyberbotics 官网）推出的机器人仿真软件，旨在降低机器人技术开发的门槛，并加速从理论到实践的转化过程。该平台用户群体非常广泛，涵盖了教育、科研和工业界。2018年以前，webots 是一款商业软件，2018年12月以后，Webots作为开放源码软件在Apache 2.0许可下发布（webots github）。

（2）gazebo 和 webots 的比较：这里我推荐两篇博客，大家大致了解下他们的异同即可。本文不建议读者在这里花费太多时间，适当了解后，尽快学习才是王道！

第一，ROS仿真平台总结

第二，到底该用哪款神器来仿真我的机器人？

（3）webots 和 ros：webots 本身是一款独立的仿真软件，跟 ros 没有关系。后来，ros1 有了 webots_ros 软件包，ros2 有了 webots_ros2 软件包，从而打通了 ros 与 webots 之间的接口，使得两者之间可以顺利通信。本文我们将使用 webots_ros2 ：webots_ros2 github

（4）webots 学习资料：这些资料都在 Cyberbotics 官网，有时会打不开，请多试几次。或者用翻墙梯子，体验会好很多。

第一，webots 入门手册 ，尤其是里面的 webots tutorials ，

补充：另外推荐 webots 中文系列教学博客，可供读者参考。

第二，webots 参考手册

第三，webots 自动驾驶仿真

（5）webots 学习路线：把上面的webots 学习资料按顺序学完，并动手实践。

2.2 webots 安装以及样例测试

（1）webots 安装：由于 webots 是从商业转向的开源，因此安装非常简单，如下。本系列 ros2 文章的基础环境是 Ubuntu22.04 + ros2 humble，安装的 webots 版本是 webotsR2023b。

cd ~# 先安装 webots_ros2sudo apt-get install ros-humble-webots-ros2# 启动机器臂样例，程序会自动查找 webots ，如果没有找到，则会询问你是否自动安装，如果yes，则默认安装在: ~/.ros/webotsR2023b/webotsros2 launch webots_ros2_universal_robot multirobot_launch.py# 设置 WEBOTS_HOME，方便查找安装位置export WEBOTS_HOME=/home/ycao/.ros/webotsR2023b/webots

（2）在 webots_ros2 中，利用 webots 实现了多种机器人仿真，包括 TurtleBot3 ，Tesla Model3，详细内容见：webots_ros2 Examples

测试 TurtleBot3 :

# 启动 TurtleBot3 仿真环境ros2 launch webots_ros2_turtlebot robot_launch.py# 再开一个窗口，控制 TurtleBot3 在仿真屋子里活动ros2 run teleop_twist_keyboard teleop_twist_keyboard

测试 Tesla Model3（怎么让车动起来，我没有详细研究，图也就不放了）：

ros2 launch webots_ros2_tesla robot_launch.py

2.3 自编写 webots_demo

（1）创建 webots_demo 软件包以及相关文件

cd ~/colcon_ws/srcros2 pkg create --build-type ament_python --license Apache-2.0 webots_demo --dependencies rclpy geometry_msgs webots_ros2_drivercd webots_demo mkdir launch worldstouch launch/mbot_launch.pytouch resource/mbot.urdftouch webots_demo/mbot_driver.py webots_demo/obstacle_avoider.py

（2）在 worlds 目录中添加 my_world.wbt，这个文件是 webots 的建模文件，里面包含虚拟仿真环境和一个差速轮式机器人。本文暂时不深究 webots 建模的细节，读者可以参考 webots tutorials 。

（3）编写 mbot_driver.py：这是差速轮式机器人车轮电机控制程序，内部有注释帮助理解

import rclpyfrom geometry_msgs.msg import TwistHALF_DISTANCE_BETWEEN_WHEELS = 0.045WHEEL_RADIUS = 0.025# MbotDriver 是机器人的控制器程序，他创建了一个 ros2 节点 mbot_driver，# 订阅 cmd_vel 话题，接收 Twist 消息，然后根据 Twist 消息的线速度和角速度控制机器人的左右轮速度，从而实现机器人的运动控制。class MbotDriver: def init(self, webots_node, properties): # 获取 webots 里的 robot 对象，在本样例就是 my_world.wbt 中的 mbot_car self._robot = webots_node.robot # 获取左右轮的电机对象，并设置电机的目标位置为极大（一直旋转）和速度为 0 self._left_motor = self._robot.getDevice('left wheel motor') self._right_motor = self._robot.getDevice('right wheel motor') self._left_motor.setPosition(float('inf')) self._left_motor.setVelocity(0) self._right_motor.setPosition(float('inf')) self._right_motor.setVelocity(0) self._target_twist = Twist() # 创建一个 ros2 节点 mbot_driver，订阅 cmd_vel 话题，用来驱动 mbot_car # 接收到的 Twist 消息存入 self._target_twist 中，等待 step 函数处理 rclpy.init(args=None) self._node = rclpy.create_node('mbot_driver') self._node.create_subscription(Twist, 'cmd_vel', self._cmd_vel_callback, 1) def _cmd_vel_callback(self, twist): self._target_twist = twist # step 由 webots_ros2_driver.webots_controller.WebotsController 调用，称之为 simulation step # 这里可以理解为是机器人控制器的主循环函数，周期调用 def step(self): # 使用 spin_once 来处理 mbot_driver 的一次事件，这里是一次 cmd_vel 订阅 # 如果没有这个函数，_cmd_vel_callback 是不会被执行的 # 如果事件没来，会立即返回，不会阻塞，确保实时性 rclpy.spin_once(self._node, timeout_sec=0) # 这里讲解了 Twist 理解 和 右手定则：https://blog.csdn.net/cy1641395022/article/details/131236155 # 获取机器人的前进速度和旋转速度，根据右手定则： # 如果机器人向左转（顺时针），angular_speed为负； # 如果机器人向右转（逆时针），angular_speed为正； forward_speed = self._target_twist.linear.x angular_speed = self._target_twist.angular.z # 机器人的前进和旋转速度需要转换为左右轮转速，由于机器人是差速驱动，所以需要根据机器人的轮距和轮径来计算左右轮转速 # HALF_DISTANCE_BETWEEN_WHEELS 是机器人的轮距的一半，乘以 angular_speed 就是机器人内外轮线速度的补偿值 # 得到内外轮线速度后，再除以 WHEEL_RADIUS 就是内外轮的转速（角速度乘以旋转半径为线速度） # 简单的三个场景，可以帮助理解这个公式： # 第一，控制机器人直线前进（forward_speed 为正，angular_speed 为0），左右轮转速必须相同，且转向相同 # 第二，控制机器人原地顺时针旋转（forward_speed 为0，angular_speed 为负），左右轮转速必须相同，且转向相反 # 第三，控制机器人原地逆时针旋转（forward_speed 为0，angular_speed 为正），左右轮转速必须相同，且转向相反 command_motor_left = (forward_speed - angular_speed * HALF_DISTANCE_BETWEEN_WHEELS) / WHEEL_RADIUS command_motor_right = (forward_speed + angular_speed * HALF_DISTANCE_BETWEEN_WHEELS) / WHEEL_RADIUS # 设置左右轮的目标转速 self._left_motor.setVelocity(command_motor_left) self._right_motor.setVelocity(command_motor_right)

（4）编写 mbot.urdf：这是差速轮式机器人的 URDF 描述文件（Unified Robot Description Format，统一的机器人描述文件格式，使用 xml 格式），为机器人添加了左右距离传感器，并指定了车轮电机控制器。

<?xml version="1.0" ?><robot name="My robot"> <webots> <device reference="ds0" type="DistanceSensor"> <ros> <topicName>/left_sensor</topicName> <alwaysOn>true</alwaysOn> </ros> </device> <device reference="ds1" type="DistanceSensor"> <ros> <topicName>/right_sensor</topicName> <alwaysOn>true</alwaysOn> </ros> </device> <plugin type="webots_demo.mbot_driver.MbotDriver" /> </webots></robot>

（4）编写 obstacle_avoider.py：这个程序基于左右距离传感器的数据，通过 cmd_vel topic 控制机器人避障。

import rclpyfrom rclpy.node import Nodefrom sensor_msgs.msg import Rangefrom geometry_msgs.msg import TwistMAX_RANGE = 0.15# ObstacleAvoider 是机器人行动的控制程序，主要是避障，防止机器人撞墙# 他创建了一个 ros2 节点 obstacle_avoider，订阅了两个传感器话题 left_sensor 和 right_sensor，# 接收 Range 消息，然后根据传感器的距离，通过 cmd_vel 发给 mbot_driver 控制机器人运动class ObstacleAvoider(Node): def __init__(self): super().__init__('obstacle_avoider') self._publisher = self.create_publisher(Twist, 'cmd_vel', 1) self.create_subscription(Range, 'left_sensor', self._left_sensor_callback, 1) self.create_subscription(Range, 'right_sensor', self._right_sensor_callback, 1) def _left_sensor_callback(self, message): self._left_sensor_value = message.range def _right_sensor_callback(self, message): self._right_sensor_value = message.range # 每次收到一个传感器的数据，就计算一次机器人的运动控制 command_message = Twist() command_message.linear.x = 0.1 # 如果左右传感器的距离有一个小于 0.9 * MAX_RANGE，就让机器人向顺时针向右转，否则默认为0，即直线行驶 if self._left_sensor_value < 0.9 * MAX_RANGE or self._right_sensor_value < 0.9 * MAX_RANGE: command_message.angular.z = -2.0 self._publisher.publish(command_message)def main(args=None): rclpy.init(args=args) avoider = ObstacleAvoider() rclpy.spin(avoider) avoider.destroy_node() rclpy.shutdown()if __name__ == '__main__': main()

（5）编写 mbot_launch.py ：

import osimport launchfrom launch_ros.actions import Nodefrom launch import LaunchDescriptionfrom ament_index_python.packages import get_package_share_directoryfrom webots_ros2_driver.webots_launcher import WebotsLauncherfrom webots_ros2_driver.webots_controller import WebotsControllerdef generate_launch_description(): package_dir = get_package_share_directory('webots_demo') mbot_description_path = os.path.join(package_dir, 'resource', 'mbot.urdf') # 使用 webots_ros2_driver.webots_launcher.WebotsLauncher 来启动 webots，加载 my_world.wbt # my_world.wbt 内有一个 mbot_car 机器人 # 补充：如何制作 my_world.wbt，可以参考： # https://cyberbotics.com/doc/guide/tutorials webots_world = WebotsLauncher( world=os.path.join(package_dir, 'worlds', 'my_world.wbt') ) # 使用 webots_ros2_driver.webots_controller.WebotsController 来启动 mbot_car 机器人的控制器 # 参数 robot_description 为 mbot.urdf，里面指定了 webots_demo.mbot_driver.MbotDriver 为机器人的控制器 mbot_controller = WebotsController( robot_name='mbot_car', parameters=[ { 'robot_description': mbot_description_path}, ], ) # 额外启动一个避障控制器，订阅 mbot_car 发来的左右距离传感器数据，通过 cmd_vel，控制 mbot_car 机器人的运动 obstacle_avoider = Node( package='webots_demo', executable='obstacle_avoider', ) return LaunchDescription([ webots_world, mbot_controller, obstacle_avoider, launch.actions.RegisterEventHandler( event_handler=launch.event_handlers.OnProcessExit( target_action=webots_world, on_exit=[launch.actions.EmitEvent(event=launch.events.Shutdown())], ) ) ])

（6）修改 setup.py

import osfrom glob import globfrom setuptools import find_packages, setuppackage_name = 'webots_demo'setup( name=package_name, version='0.0.0', packages=find_packages(exclude=['test']), data_files=[ ('share/ament_index/resource_index/packages', ['resource/' + package_name]), ('share/' + package_name, ['package.xml']), (os.path.join('share', package_name, 'launch'), glob(os.path.join('launch', '*_launch.py'))), (os.path.join('share', package_name, 'worlds'), glob(os.path.join('worlds', '*.wbt'))), (os.path.join('share', package_name, 'resource'), glob(os.path.join('resource', '*.urdf'))) ], install_requires=['setuptools'], zip_safe=True, maintainer='ycao', maintainer_email='1641395022@qq.com', description='TODO: Package description', license='Apache-2.0', tests_require=['pytest'], entry_points={ 'console_scripts': [ 'mbot_driver = webots_demo.mbot_driver:main', 'obstacle_avoider = webots_demo.obstacle_avoider:main' ], },)

（7）编译并运行

cd ~/colcon_ws/srccolcon build --packages-select webots_demosource install/local_setup.bashros2 launch webots_demo mbot_launch.py

3 总结

本文主要通过一个差速轮式机器人仿真样例，为大家引入 webots ，但没有深入探究 webots 的建模细节。尽快如此，读者可以在本文的基础上，利用文中提到的资料，对 webots 进行深入的学习和研究。

本文的代码托管在本人的 github 上：webots_demo