diff --git a/README.md b/README.md index d6dee186694c3cdf0f14dccf9f90a0938840cacd..f78b28051bb23425059e4a624fb7e8dc65c2fa9f 100644 --- a/README.md +++ b/README.md @@ -1,40 +1,41 @@ -# ros +# openEuler ROS SIG -#### 介绍 -It provides ROS source for openEuler +openEuler ROS SIG成立于2020年6月,致力于在openEuler系统上提供对ROS1/ROS2通用软件包的支持、更新和维护。 -#### 软件架构 -软件架构说明 +本仓库是 openEuler ROS SIG 的门户仓, 托管了openEuler ROS SIG的项目文档、工程配置以及脚本工具等。 +项目有关的任务、需求、bug、讨论和交流都可通过issue的形式进行:[ROS SIG issue列表地址](https://gitee.com/openeuler/ros/issues) -#### 安装教程 +## 使用说明 -1. TODO +目前已在openEuler 22.03 系统上发布ROS2 Humble 860+软件包,在openEuler 24.03上发布ROS1 Noetic和ROS2 Humble 1000+软件包。支持`yum install`一键安装,即装即用。 -#### 使用说明 +使用测试文档可参考[使用文档](/user_doc) -1. TODO +- [openEuler22.03安装测试ROS2 Humble](/user_doc/openEuler22.03安装测试ROS2-Humble.md) +- TODO -#### 参与贡献 +## 参与贡献 -1. Fork 本仓库 -2. 新建 Feat_xxx 分支 -3. 提交代码 -4. 新建 Pull Request +欢迎对ROS项目感兴趣的成员加入ROS SIG。 -#### 已完成移植package +关于如何在openEuler开源社区开始贡献的指导文档请参考: [openEuler 贡献者指南](https://gitee.com/openeuler/community/blob/master/zh/contributors/README.md ) 以及[贡献攻略](https://www.openeuler.org/zh/community/contribution/) -- https://gitee.com/src-openeuler/catkin -- https://gitee.com/src-openeuler/class_loader -- https://gitee.com/src-openeuler/cmake_modules -- https://gitee.com/src-openeuler/cpp_common -- https://gitee.com/src-openeuler/gencpp +ROS SIG 相关文档可参考[项目文档](/document) -#### 码云特技 +- 贡献项目文档和使用文档:TODO -1. 使用 Readme\_XXX.md 来支持不同的语言,例如 Readme\_en.md, Readme\_zh.md -2. 码云官方博客 [blog.gitee.com](https://blog.gitee.com) -3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解码云上的优秀开源项目 -4. [GVP](https://gitee.com/gvp) 全称是码云最有价值开源项目,是码云综合评定出的优秀开源项目 -5. 码云官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) -6. 码云封面人物是一档用来展示码云会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) +- 解决已有功能包Bug:TODO +- 贡献新的功能包:TODO +- …… + +## 已完成移植的功能包列表 + +TODO + + + +## 相关文档和仓库 + +- [openEuler RISC-V](https://gitee.com/openeuler/RISC-V) +- diff --git a/user_doc/img/11.png b/user_doc/img/11.png new file mode 100644 index 0000000000000000000000000000000000000000..ad958287f97511f0e069364985bcbcd56457fc94 Binary files /dev/null and b/user_doc/img/11.png differ diff --git "a/user_doc/img/\344\271\214\351\276\237\346\265\213\350\257\2251.png" "b/user_doc/img/\344\271\214\351\276\237\346\265\213\350\257\2251.png" new file mode 100644 index 0000000000000000000000000000000000000000..a0e0521a17883a789197c045c3b041d53d3e7c08 Binary files /dev/null and "b/user_doc/img/\344\271\214\351\276\237\346\265\213\350\257\2251.png" differ diff --git "a/user_doc/img/\346\226\207\344\273\266\345\205\261\344\272\253.png" "b/user_doc/img/\346\226\207\344\273\266\345\205\261\344\272\253.png" new file mode 100644 index 0000000000000000000000000000000000000000..f752bc3950cf21cfd095f66ebd58853ce850b65a Binary files /dev/null and "b/user_doc/img/\346\226\207\344\273\266\345\205\261\344\272\253.png" differ diff --git "a/user_doc/openEuler22.03\345\256\211\350\243\205\346\265\213\350\257\225ROS2-Humble.md" "b/user_doc/openEuler22.03\345\256\211\350\243\205\346\265\213\350\257\225ROS2-Humble.md" new file mode 100644 index 0000000000000000000000000000000000000000..08c69277ffe0e0ce347797232ac2c25278be51dd --- /dev/null +++ "b/user_doc/openEuler22.03\345\256\211\350\243\205\346\265\213\350\257\225ROS2-Humble.md" @@ -0,0 +1,83 @@ +## openEuler22.03 安装测试ROS2 Humble + +### 1.安装系统 + +#### 1.1安装系统 + +参考openEuler官方教程物理机安装openEuler系统或虚拟机安装系统 + +#### 1.2安装桌面环境 + +``` +yum install ukui +systemctl set-default graphical.target +``` + +### 2.安装ROS2 humble + +安装: + +``` +yum install openeuler-ros +yum install ros-humble-ros-base ros-humble-turtlesim +``` + +安装一些常用包: + +``` +yum install ros-humble-rviz* +yum install ros-humble-tf* +yum install ros-humble-control* +``` + +ROS SIG已经打包发版的功能包均可通过`yum install ros-humble-功能包名`的形式安装,其他尚未移植的功能包需要自行源码编译安装 + +设置环境变量: + +``` +echo " source /opt/ros/humble/setup.bash" >> ~/.bashrc +``` + +### 3. 测试小乌龟程序 + +``` +ros2 run turtlesim turtlesim_node +ros2 run turtlesim turtle_teleop_key +``` + +![](img/乌龟测试1.png) + +### 4.安装编译器colcon + +``` +dnf install -y python3-pip +pip3 install -U colcon-common-extensions +yum -y install gcc automake autoconf libtool make +``` + +### 5.测试自己的代码 + +新建工作空间、编译、运行其他功能包的流程与ROS官方教程基本一致:https://docs.ros.org/en/humble/Tutorials.html + +### 6.其他配置 + +#### 6.1 VM虚拟机设置文件共享(可选) + +openEuler系统提供了VMtools工具的安装: + +``` +yum -y install open-vm-tools +``` + +编译安装完成后,关闭虚拟机,设置宿主机的共享目录: + +![](img/11.png) + + + +开启虚拟机命令行输入`vmhgfs-fuse .host:/share ~/code`将主机目录挂到~/code下 + +出现下图最后一行说明文件共享成功: + +![](img/文件共享.png) +