EasyNav
Sistema di navigazione ROS 2 leggero che gira come un unico processo da un unico file di parametri
Licenza
- 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
Licenze miste nell'organizzazione EasyNavigation. Il nucleo (EasyNavigation), i plugin ufficiali (easynav_plugins), NavMap e il bridge Nav2 sono Apache-2.0. I repository separati degli stack easynav_gridmap_stack, easynav_octomap_stack, easynav_pointcloud_stack, easynav_costmap_stack ed easynav_simple_stack sono GPL-3.0; easynav_lidarslam_ros2 è BSD-2-Clause; alcuni repository non hanno un file di licenza. Verificato il 2026-10-23.
Panoramica
EasyNav (EasyNavigation) è un sistema di navigazione open source per ROS 2 dell'Intelligent Robotics Lab della Universidad Rey Juan Carlos; il responsabile del progetto, Francisco Martín Rico, guida anche PlanSys2. Svolge lo stesso compito di Nav2, portare un robot su ruote dalla sua posizione a un obiettivo evitando gli ostacoli, ma è costruito in modo diverso: l'intero sistema gira come un unico programma, system_main, configurato da un unico file di parametri, e ogni parte (rappresentazione della mappa, localizzatore, pianificatore, controllore e recupero) è un plugin scelto in quel file. Non è legato a una costmap 2D: esistono stack per costmap 2D, superfici 3D triangolate NavMap, mappe voxel probabilistiche Bonxai, mappe di elevazione a griglia e semplici nuvole di punti. Il nucleo e i plugin ufficiali sono Apache-2.0 e sono rilasciati come pacchetti Debian per Humble, Jazzy, Kilted e Lyrical, con simulazioni Gazebo pronte per provarlo. Il codice sorgente è su GitHub e la documentazione copre l'installazione, guide pratiche e una guida per migrare un robot da Nav2.
EasyNav gira all'interno di un unico processo. Un nodo lifecycle di ROS 2, SystemNode, compone il resto: un nodo dei sensori che raccoglie nuvole di punti e scansioni laser, immagini, IMU, GNSS, odometria e rilevamenti 3D; un gestore delle mappe che contiene il modello dell'ambiente; un localizzatore; un pianificatore; un controller; e un nodo di recupero. Un GoalManager all'interno del nodo di sistema accetta e traccia gli obiettivi. Non c'è un behavior tree: la logica di missione, come i pattugliamenti, va nel proprio nodo, che invia gli obiettivi tramite un client. Ogni componente gira alla propria frequenza in un ciclo in tempo reale, e il controller è l'unica fonte dei comandi di velocità, scegliendo a ogni ciclo tra l'output del controller e quello del sistema di recupero.
Ciò che EasyNav fa è deciso dai plugin indicati nel suo file di parametri, caricati con pluginlib. Il set ufficiale, nel repository easynav_plugins, comprende:
- Gestori delle mappe: Costmap2D, superfici 3D NavMap, mappe a voxel Bonxai, percorsi di navigazione modificabili, Octomap e una semplice mappa binaria per imparare. - Localizzatori: AMCL su una costmap, AMCL a ipotesi multiple per la localizzazione globale e il problema del rapimento, AMCL su una mappa a voxel 3D e un UKF che fonde GPS, odometria e IMU. - Pianificatori: A* su una costmap, una mesh NavMap o una mappa semplice. - Controller: Regulated Pure Pursuit (un port di quello di Nav2, con un'estensione dynamic-window opzionale), MPPI, controllo predittivo basato su modello (MPC), SeReST, un controller reattivo VFF e un semplice inseguitore PID. - Recupero: un sistema di recupero diagnostico che può fermare o guidare il robot, sospendere o interrompere una missione, o modificare parametri durante l'esecuzione.
Ogni componente ha anche un plugin fittizio, così un'applicazione che non ha bisogno di una mappa o di un localizzatore (un inseguitore di persone, o la guida per waypoint GPS) semplicemente lo omette.
I PlayGrounds sono simulazioni complete in Gazebo Harmonic con configurazioni pronte per un Kobuki al chiuso, un Summit XL all'aperto, un TIAGo e una base omnidirezionale. Il passaggio da Nav2 è documentato: si riutilizzano gli stessi URDF, sistemi di coordinate TF, topic dei sensori e file delle mappe (da map_server o SLAM Toolbox), e un pacchetto easynav_nav2_bridge espone l'azione NavigateToPose di Nav2, così i client Nav2 esistenti, compreso il pulsante dell'obiettivo di RViz, continuano a funzionare. Una guida alla sicurezza spiega come far funzionare EasyNav come parte non di sicurezza di un robot, accanto a un canale di sicurezza certificato.
Perché è importante
Nav2 è il modo predefinito per far navigare un robot ROS 2, ed è eccellente, ma è composto da molti server coordinati da behavior tree e costruito attorno alle costmap 2D. EasyNav offre un compromesso diverso, da un laboratorio universitario attivo: un processo e un file da configurare, bassa latenza tra percezione e azione, e rappresentazioni della mappa che vanno oltre i pavimenti piatti, tra cui mesh 3D, mappe voxel e mappe di elevazione per terreni all'aperto e su più livelli. Poiché riutilizza le convenzioni di Nav2 e parla l'azione degli obiettivi di Nav2 tramite un bridge, un team può provarlo su un robot che già usa Nav2 senza ricostruire nient'altro.
Il problema che risolve
Far navigare un robot su ruote in ROS 2 di solito significa configurare uno stack di server separati, un lifecycle manager e behavior tree, e lavorare con una costmap 2D anche quando il terreno non è piatto. EasyNav racchiude la navigazione in un unico processo configurabile, in cui rappresentazione della mappa, localizzatore, pianificatore e controller sono plugin intercambiabili, così lo stesso sistema può guidare un robot da interni delle dimensioni di un aspirapolvere su una costmap o un robot da esterni su una mappa di superficie 3D.
Punti chiave
- Un sistema di navigazione ROS 2 che gira come un unico programma, system_main, configurato da un unico file di parametri
- Rappresentazione della mappa, localizzatore, pianificatore, controller e recovery sono tutti plugin, con plugin fittizi per le parti di cui un'applicazione non ha bisogno
- Stack per costmap 2D, superfici 3D triangolate NavMap, mappe voxel Bonxai, mappe di elevazione a griglia e nuvole di punti
- I controller includono Regulated Pure Pursuit, MPPI e MPC; i localizzatori includono AMCL multi-ipotesi e la fusione GPS/IMU
- Rilasciato come pacchetti Debian per Humble, Jazzy, Kilted e Lyrical; PlayGround Gazebo per Kobuki, Summit XL, TIAGo e una base omnidirezionale
- Riutilizza le mappe e i frame di Nav2, e un bridge serve l'azione NavigateToPose di Nav2, così i client Nav2 continuano a funzionare
A chi si rivolge
- Sviluppatori ROS 2 che costruiscono robot su ruote e trovano Nav2 pesante da configurare o hanno bisogno di una mappa non 2D
- Team con robot da esterni o per terreni irregolari che necessitano di mappe di superficie 3D, voxel o di elevazione
- Ricercatori che vogliono inserire come plugin il proprio localizzatore, pianificatore o controller
- Studenti che imparano la navigazione robotica, partendo dallo stack semplice e dai PlayGround
Limiti
- Ancora prima della 1.0 (0.5.x), e la documentazione segue il branch rolling, che può descrivere funzionalità non ancora rilasciate
- Niente behavior tree: la logica di missione va scritta come nodo separato che invia gli obiettivi
- Comunità più piccola e meno plugin rispetto a Nav2; i repository separati degli stack gridmap, octomap e pointcloud sono GPL-3.0, non Apache-2.0
- Su Humble è supportato solo il nucleo; i plugin e i PlayGround puntano a Jazzy e versioni successive, e Rolling non ha ancora pacchetti Debian
- Non è un componente di sicurezza certificato: gli arresti di protezione e gli arresti di emergenza devono provenire da un canale di sicurezza indipendente