# ranger_ros2

> 权威词条地址：https://robotics.hellobike.com/sdks/agilexrobotics-ranger-ros2
> 所属分类：sdks | 最近核验日期：2026-04-10 | 技术层级：L3, L5

## 核心摘要

agilexrobotics 在 GitHub 开源的框架，主要语言 C++。 ranger_ros2 package

## 结构化工程参数

| 参数项 | 数值 / 配置 |
| :--- | :--- |
| `layers` | ["L3", "L5"] |
| `links` | [{"title": "GitHub", "url": "https://github.com/agilexrobotics/ranger_ros2"}] |
| `updated` | 2026-04-10 |
| `vendor` | agilex |
| `repo` | https://github.com/agilexrobotics/ranger_ros2 |
| `language` | ["c++"] |
| `pinned_versions` | [{"version_or_sha": "humble 分支 / main（ROS 2 Humble 兼容）", "tested_env": "Ubuntu 22.04 LTS + ROS 2 Humble，colcon 构建，C++17", "notes": "克隆至 colcon 工作区 src，rosdep 安装依赖后 colcon build，配置 CAN/串口参数后通过 cmd_vel 与 odom 话题控制 Ranger Mini。"}] |
| `incompatible_envs` | ["不支持 ROS 1 Noetic 工作区，勿与 ranger_ros（ROS1）混编同一 overlay", "未适配 Windows/macOS，需原生 Linux 与 SocketCAN 或官方 USB-CAN 适配器"] |
| `robots` | ["agilex-ranger-mini"] |
| `repo_stats` | {"stars": 73, "forks": 51, "as_of": "2026-10-13"} |
| `tool_type` | framework |
| `source_kind` | vendor_org |
| `overview_sources` | ["https://github.com/agilexrobotics/ranger_ros2"] |

## 技术详解与生态说明

ranger_ros2是松灵机器人（AgileX Robotics）开源的ROS2适配框架，核心开发语言为C++，包含移动机器人底盘通信解析、状态上报、运动指令转换、参数配置等核心功能模块，为上层应用提供标准化的ROS2交互接口。

该框架适配AgileX Ranger Mini系列移动底盘，覆盖运动控制（L3）与上层应用集成（L5）技术层级，开发者可直接克隆仓库至ROS2工作区编译，通过配置串口或CAN总线参数完成底盘接入，即可基于标准ROS2话题实现底盘运动控制与状态读取，无需额外适配底层通信协议。

## 原始核验来源 (Sources)

- [GitHub agilexrobotics/ranger_ros2](https://github.com/agilexrobotics/ranger_ros2)