Repository navigation
feat(chap1): 新增小海龟键盘遥控与 ROS 基础实验模块 - #1080
Merged
Merged
Conversation
Contributor
|
第一章现有实验集中在自动绘图,缺少与课堂作业对应的键盘遥控、常用命令
练习和桥接源码阅读环节,学生只能直接调用官方 turtle_teleop_key,无法
练习自己编写话题发布节点。
- 新增 src/chap1/turtlesim_teleop:main.py 读取方向键 / WASD 并发布
geometry_msgs/Twist 到 /turtle1/cmd_vel,支持空格停车、+/- 调速,
退出时发布零速度;提供 main.launch 一键启动和 rosrun 两种运行方式。
- 新增 docs/chapter/chap1/turtlesim_teleop.md:环境验证、控制原理、运行
步骤、常用 ROS 命令速查、CARLA-ROS 桥接源码结构阅读笔记和运行截图。
- 在首页、mkdocs 导航和第一章页面加入口,方便检索。
- 新增 tests/test_turtlesim_teleop_local.py(25 项桩测试),不依赖 ROS。
验证:mkdocs build 通过;mkdocs serve --livereload 下页面、导航和截图
链接均返回 200。本机为 Windows 且未安装 ROS,ROS 端实际运行未验证,
仅验证了按键映射、消息字段和工程文件。
评审修复:
- main.launch 移到 launch/main.launch,与同级 chap1 包的目录约定一致;
- CMakeLists.txt 补 install(DIRECTORY launch DESTINATION
${CATKIN_PACKAGE_SHARE_DESTINATION}),catkin_make install 后
roslaunch turtlesim_teleop main.launch 能找到 launch 文件;
- 文档目录树、CMakeLists 职责说明同步更新;
- 替换文档中误粘贴的 CARLA 桥接小节,改为 turtlesim 遥控的实际
数据流与安装说明;
- 测试改用 launch/main.launch,并新增 launch 安装规则检查;本地
26 项测试通过。
xinyangtang91
force-pushed
the
feat/turtlesim_teleop
branch
from
November 13, 2026 12:04
b08101d to
452d7f9
Compare
Contributor
Author
|
已按评审意见修改并重新推送:
|
tianyutu981
approved these changes
Nov 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
修改目的与内容
第一章现有实验集中在“小海龟自动绘图”,缺少与本次 ROS 基础作业对应的“键盘遥控 + 常用命令 + 桥接源码阅读”环节。学生目前只能直接调用官方
turtle_teleop_key,没有自己编写话题发布节点的练习,也不方便在文档里串起环境验证、调试命令和桥接原理。本 PR 新增第一章第 10 个实验模块
turtlesim_teleop:src/chap1/turtlesim_teleop/:入口main.py读取方向键 / WASD,把按键映射为线速度、角速度后发布到/turtle1/cmd_vel;支持空格停车、+/-调速、q/Ctrl+C退出并在退出前发布零速度。main.launch一键启动 turtlesim + 遥控节点(用 xterm 承载键盘输入),也可rosrun前台运行;另含package.xml、CMakeLists.txt(安装main.py)和 README。docs/chapter/chap1/turtlesim_teleop.md:环境验证、控制原理、运行步骤、常用 ROS 命令速查、CARLA-ROS 桥接源码结构阅读笔记、运行截图。docs/index.md、mkdocs.yml导航、docs/chapter/chap1/chap1.md均加入口。tests/test_turtlesim_teleop_local.py:不依赖 ROS 的桩测试,覆盖按键映射、Twist字段和工程文件。已知限制:作者本机为 Windows,未安装 ROS,
main.py的 ROS 端实际运行尚未验证;文中截图来自 ROS Noetic 虚拟机中官方turtle_teleop_key的运行结果,用于说明实验环境和键盘遥控效果,不是本模块main.py的运行截图。合并前需要一名有 ROS Noetic 环境的同学按 README 实际跑一遍。测试环境与结果
pypandoc-binary),pymdown-extensions 13.0rosversion输出 1.16.0),turtlesimpython -m mkdocs buildpython -m mkdocs serve --dev-addr 127.0.0.1:8000 --livereloadpython tests/test_turtlesim_teleop_local.pycp -r src/chap1/turtlesim_teleop ~/catkin_ws/src/ && cd ~/catkin_ws && catkin_make && source devel/setup.bash && roslaunch turtlesim_teleop main.launchmkdocs build通过(28.47 秒),新增页面无构建报错;mkdocs serve --livereload下新页面、导航入口和turtle_teleop.png均返回 HTTP 200;main.py在 ROS 中的键盘输入与话题发布、main.launch启动、turtlesim 实际运动、catkin_make编译。运行效果
截图为 ROS Noetic 虚拟机中同时运行
roscore、turtlesim_node和turtle_teleop_key的效果:左侧终端显示Reading from keyboard和方向键提示,右侧小海龟在按键控制下留下三角形轨迹,roscore参数显示/rosdistro: noetic、/rosversion: 1.16.0。本模块main.py的同类效果待在 ROS 环境复现后补充。提交前检查
git diff一致;mergeable为 true,无冲突;分支已 rebase 到最新 masterac75bdb。)main.py、main.launch、package.xml、CMakeLists.txt已提供,依赖与安装路径已检查;但 README 的 ROS 运行步骤未在本机执行,因为本机没有 ROS,待另一台机器验证。)turtle_teleop_key的运行效果。)大模型使用声明