|
| 1 | +# Eurobot-2025-Navigation2 |
| 2 | + |
| 3 | +## Overview |
| 4 | +Eurobot-2025-Navigation2 provides essential navigation capabilities for the DIT Robotics Eurobot 2025 robot. It includes core navigation functions, docking process integration, and various optimizations to enhance autonomous movement and docking performance. |
| 5 | + |
| 6 | +## Features |
| 7 | + |
| 8 | +- **Basic Navigation Functions** – Enables smooth and efficient robot movement using ROS 2 Navigation Stack (Nav2). |
| 9 | +- **Docking Process Integration** – Seamlessly integrates the robot's docking and movement workflows. |
| 10 | +- **Optimized Navigation Parameters** – Fine-tuned parameters for improved localization, path planning, and obstacle avoidance. |
| 11 | +- **Navigation Termination** – Implements the `stopRobot` feature to lock the navigation system when needed. |
| 12 | + |
| 13 | +## Installation |
| 14 | + |
| 15 | +1. Clone this repository: |
| 16 | + ```sh |
| 17 | + git clone https://github.com/DIT-ROBOTICS/Eurobot-2025-Navigation2.git |
| 18 | + ``` |
| 19 | +2. Navigate to the workspace: |
| 20 | + ```sh |
| 21 | + cd Eurobot-2025-Navigation2 |
| 22 | + ``` |
| 23 | +3. Install dependencies: |
| 24 | + ```sh |
| 25 | + rosdep install --from-paths src --ignore-src -r -y |
| 26 | + ``` |
| 27 | +4. Build the workspace: |
| 28 | + ```sh |
| 29 | + colcon build --symlink-install |
| 30 | + ``` |
| 31 | +5. Source the workspace: |
| 32 | + ```sh |
| 33 | + source install/setup.bash |
| 34 | + ``` |
| 35 | + |
| 36 | +## How to Use |
| 37 | + |
| 38 | +1. Start the ROS 2 environment: |
| 39 | + ```sh |
| 40 | + source install/setup.bash |
| 41 | + ``` |
| 42 | +2. Launch the navigation system: |
| 43 | + ```sh |
| 44 | + ros2 launch eurobot_navigation2 bringup.launch.py |
| 45 | + ``` |
| 46 | +3. To send a goal, use: |
| 47 | + ```sh |
| 48 | + ros2 action send_goal /navigate_to_pose nav2_msgs/action/NavigateToPose "{pose: {position: {x: 1.0, y: 2.0, z: 0.0}, orientation: {w: 1.0}}}" |
| 49 | + ``` |
| 50 | + |
| 51 | +## Version Updates |
| 52 | + |
| 53 | +- **Installation Adjustments** – Replaced symbolic links with copied files in the install folder. |
| 54 | +- **Parameter Optimization** – Enhanced configurations for improved navigation and docking. |
| 55 | +- **Bug Fixes** – Resolved multiple known issues. |
| 56 | +- **Navigation Termination** – Added the `stopRobot` feature to lock the navigation system. |
| 57 | + |
| 58 | +## Repository Structure |
| 59 | +``` |
| 60 | +Eurobot-2025-Navigation2/ |
| 61 | +├── src/ # Source code for navigation |
| 62 | +├── launch/ # Launch files for starting navigation |
| 63 | +├── config/ # Configuration files for navigation parameters |
| 64 | +├── maps/ # Predefined maps for localization |
| 65 | +├── scripts/ # Utility scripts |
| 66 | +└── README.md # Project documentation |
| 67 | +``` |
| 68 | + |
| 69 | +## Contribution |
| 70 | +Contributions are welcome! Please follow these steps: |
| 71 | +1. Fork the repository. |
| 72 | +2. Create a feature branch. |
| 73 | +3. Commit your changes. |
| 74 | +4. Submit a pull request. |
| 75 | + |
| 76 | +## License |
| 77 | +This project is licensed under the MIT License. See the `LICENSE` file for details. |
| 78 | + |
| 79 | +## Contact |
| 80 | +For any issues or inquiries, please open an issue on GitHub or contact the DIT Robotics team. |
0 commit comments