EasyNav
輕量的 ROS 2 導航系統,以單一行程、單一參數檔執行
授權條款
- core, official plugins, NavMap and the Nav2 bridge: Apache 2.0
- stack repositories (gridmap, octomap, pointcloud, costmap, simple): GPL 3.0
- easynav_lidarslam_ros2: BSD 2-Clause
EasyNavigation 組織內的授權各不相同。核心(EasyNavigation)、官方外掛(easynav_plugins)、NavMap 與 Nav2 橋接層採用 Apache-2.0。獨立的堆疊儲存庫 easynav_gridmap_stack、easynav_octomap_stack、easynav_pointcloud_stack、easynav_costmap_stack 與 easynav_simple_stack 採用 GPL-3.0;easynav_lidarslam_ros2 採用 BSD-2-Clause;少數儲存庫沒有授權檔案。查核日期:2026-10-23。
概述
EasyNav(EasyNavigation)是 Universidad Rey Juan Carlos 智慧機器人實驗室推出的 ROS 2 開源導航系統;其專案負責人 Francisco Martín Rico 也主導 PlanSys2。它的工作與 Nav2 相同,帶領輪式機器人從目前位置前往目標並避開障礙物,但架構不同:整個系統以單一程式 system_main 執行,由一個參數檔設定,而每個部分(地圖表示、定位器、規劃器、控制器與復原)都是在該檔案中選用的外掛。它不受限於 2D 代價地圖:現有的堆疊支援 2D 代價地圖、NavMap 三角化 3D 曲面、Bonxai 機率體素地圖、高程網格地圖與純點雲。核心與官方外掛採用 Apache-2.0 授權,並以 Debian 套件形式發布於 Humble、Jazzy、Kilted 與 Lyrical,附有現成的 Gazebo 模擬可供試用。原始碼在 GitHub 上,文件涵蓋安裝、操作指南,以及將機器人從 Nav2 移轉過來的指南。
EasyNav 在單一行程中執行。一個 ROS 2 生命週期節點 SystemNode 負責組合其餘部分:一個感測器節點,收集點雲與雷射掃描、影像、IMU、GNSS、里程計與 3D 偵測結果;一個保存環境模型的地圖管理器;一個定位器;一個規劃器;一個控制器;以及一個恢復節點。系統節點內的 GoalManager 負責接收並追蹤目標。這裡沒有行為樹:巡邏等任務邏輯放在你自己的節點中,由它透過用戶端送出目標。每個元件都在即時週期中以自己的頻率執行,而控制器是速度指令的唯一來源,在每個週期中於控制器的輸出與恢復系統的輸出之間做出選擇。
EasyNav 的功能由其參數檔中指名、以 pluginlib 載入的外掛決定。官方外掛集放在 easynav_plugins 儲存庫中,涵蓋:
- 地圖管理器: Costmap2D、NavMap 3D 曲面、Bonxai 體素地圖、可編輯的導航路線、Octomap,以及一個供學習用的簡單二值地圖。 - 定位器: 在代價地圖上的 AMCL、用於全域定位與綁架問題的多假設 AMCL、對照 3D 體素地圖的 AMCL,以及融合 GPS、里程計與 IMU 的 UKF。 - 規劃器: 在代價地圖、NavMap 網格或簡單地圖上的 A*。 - 控制器: Regulated Pure Pursuit(移植自 Nav2,並可選用動態視窗擴充)、MPPI、模型預測控制、SeReST、VFF 反應式控制器,以及一個簡單的 PID 跟隨器。 - 恢復: 一個診斷式恢復系統,可在執行中停止或驅動機器人、暫停或中止任務,或變更參數。
每個元件也都有一個空的替代外掛,因此不需要地圖或定位器的應用(例如跟隨人員,或 GPS 航點行駛)只要把它省略即可。
PlayGrounds 是完整的 Gazebo Harmonic 模擬,附有現成的配置,適用於室內的 Kobuki、戶外的 Summit XL、TIAGo 以及一個全向底盤。從 Nav2 遷移的方式有文件說明:相同的 URDF、TF 座標框架、感測器主題與地圖檔案(來自 map_server 或 SLAM Toolbox)都可以沿用,而 easynav_nav2_bridge 套件提供 Nav2 的 NavigateToPose action,讓既有的 Nav2 用戶端(包括 RViz 的目標按鈕)能繼續運作。一份安全指南說明如何讓 EasyNav 作為機器人中非安全相關的部分,與經過認證的安全通道並行運作。
為何重要
Nav2 是讓 ROS 2 機器人導航的預設方式,而且非常出色,但它由許多伺服器組成、以行為樹協調,並圍繞 2D 成本地圖打造。EasyNav 由一個活躍的大學實驗室提供了不同的取捨:單一行程、單一檔案設定,感測到動作之間的延遲低,而且地圖表示不只限於平坦地面,還包括適用戶外與多樓層地形的 3D 網格、體素地圖與高程地圖。由於它沿用 Nav2 的慣例,並透過橋接層支援 Nav2 的目標 action,團隊可以在已經執行 Nav2 的機器人上試用它,而不必重建其他任何部分。
解決的問題
要讓輪式機器人在 ROS 2 中導航,通常得設定一整套各自獨立的伺服器、生命週期管理器與行為樹,而且即使地形不平坦,也只能使用 2D 成本地圖。EasyNav 把導航打包成一個可設定的行程,其地圖表示、定位器、規劃器與控制器都是可替換的外掛,因此同一套系統既能讓吸塵器大小的室內機器人在成本地圖上行駛,也能讓戶外機器人在 3D 表面地圖上行駛。
重點
- 以單一程式 system_main 執行、由一個參數檔設定的 ROS 2 導航系統
- 地圖表示、定位器、規劃器、控制器與恢復全都是外掛,應用不需要的部分可用空的佔位外掛代替
- 提供 2D 成本地圖、NavMap 3D 三角化表面、Bonxai 體素地圖、高程網格地圖與點雲的堆疊
- 控制器包括 Regulated Pure Pursuit、MPPI 與 MPC;定位器包括多假設 AMCL 與 GPS/IMU 融合
- 以 Debian 套件形式為 Humble、Jazzy、Kilted 與 Lyrical 發布;Gazebo PlayGrounds 涵蓋 Kobuki、Summit XL、TIAGo 與一個全向底盤
- 沿用 Nav2 的地圖與座標框架,並以橋接層提供 Nav2 的 NavigateToPose action,讓 Nav2 用戶端繼續運作
適用對象
- 打造輪式機器人、覺得 Nav2 設定繁重或需要非 2D 地圖的 ROS 2 開發者
- 擁有戶外或不平坦地形機器人、需要 3D 表面、體素或高程地圖的團隊
- 想以外掛形式換上自己的定位器、規劃器或控制器的研究人員
- 從簡易堆疊與 PlayGrounds 入門、學習機器人導航的學生
限制
- 仍在 1.0 之前(0.5.x),且文件追蹤的是 rolling 分支,可能描述尚未發布的功能
- 沒有行為樹:任務邏輯必須寫成一個送出目標的獨立節點
- 社群規模與外掛數量都不及 Nav2;獨立的 gridmap、octomap 與 pointcloud 堆疊儲存庫採用 GPL-3.0,而不是 Apache-2.0
- Humble 上只支援核心;外掛與 PlayGrounds 以 Jazzy 及之後的版本為目標,Rolling 目前還沒有 Debian 套件
- 不是經認證的安全元件:保護停止與緊急停止必須來自獨立的安全通道