Skip to content

Commit 99bb985

Browse files
authored
Create README.md
1 parent 35f1b7e commit 99bb985

File tree

1 file changed

+80
-0
lines changed

1 file changed

+80
-0
lines changed

README.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
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

Comments
 (0)