# origincar_ws **Repository Path**: Ly0330/origincar_ws ## Basic Information - **Project Name**: origincar_ws - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-03 - **Last Updated**: 2026-11-03 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # OriginCar X3 本分支保存 **OriginCar X3 版本**的 ROS 2 程序及模型配置,`master` 为仓库默认分支。 ## 分支与版本 | 分支 | 对应版本 | | --- | --- | | [`master`](https://gitee.com/Ly0330/origincar_ws/tree/master)(当前分支、默认分支) | X3 | | [`X5`](https://gitee.com/Ly0330/origincar_ws/tree/X5) | X5 | 使用 X3 小车时,请下载或克隆 `master` 分支。 ## 目录说明 本分支保留 X3 原始文件夹的目录结构: ```text . ├── config/ # 算法配置、模型和类别列表 │ ├── archer.bin │ ├── origincar_config.json │ ├── origincar.list │ └── qrcode/ └── origincar/ # ROS 2 功能包 ├── 3rdparty/ # Ackermann 消息、串口库和 tf2_tools ├── origincar_base/ # 底盘驱动、里程计、IMU 和定位配置 ├── origincar_bringup/ # USB 相机及 Web 展示启动文件 ├── origincar_description/ # 机器人模型、URDF/Xacro 和 RViz 配置 └── origincar_msg/ # 自定义消息 ``` ## 获取与编译 以下命令在已配置好 ROS 2、colcon 及小车运行依赖的 Linux 环境中执行。先加载系统的 ROS 2 环境,再编译工作空间。 ```bash mkdir -p ~/dev_ws/src git clone --branch master --single-branch https://gitee.com/Ly0330/origincar_ws.git ~/dev_ws/src/origincar cd ~/dev_ws colcon build --symlink-install source install/setup.bash ``` 若代码已经放入工作空间,直接在工作空间根目录执行编译命令即可。每个新终端在启动节点前,都需要加载系统的 ROS 2 环境及工作空间的 `install/setup.bash`。 ## 底盘与键盘控制 启动底盘: ```bash ros2 launch origincar_base origincar_bringup.launch.py ``` 另开终端,加载环境后启动键盘控制(需已安装 `teleop_twist_keyboard`): ```bash ros2 run teleop_twist_keyboard teleop_twist_keyboard ``` 键盘节点向 `/cmd_vel` 发布速度消息,底盘节点订阅该话题进行控制。 ## USB 相机与算法展示 此功能依赖车载环境中的 `hobot_usb_cam`、`hobot_codec`、`dnn_node_example` 和 `websocket` 等功能包。 启动文件中的 `dnn_example_config_file` 默认值是占位文字,运行时需要显式指定配置文件: ```bash ros2 launch origincar_bringup usb_websocket_display.launch.py \ dnn_example_config_file:="$HOME/dev_ws/src/origincar/config/origincar_config.json" \ device:=/dev/video8 ``` `device` 应按小车实际的相机设备调整,当前启动文件默认使用 `/dev/video8`。 `config/origincar_config.json` 中的 `model_file` 和 `cls_names_list` 当前使用 `/root/dev_ws/src/origincar/config/` 下的绝对路径。若工作空间位于其他目录,请在运行前将这两个字段调整为实际的 `archer.bin` 和 `origincar.list` 路径。