dev #31

Merged
Atharv merged 136 commits from dev into ayaan_dev 2025-10-31 11:56:16 +00:00
Showing only changes of commit 489add5722 - Show all commits

View File

@@ -1,4 +1,4 @@
# 🤖 65266 Lego Dynamics - UNEARTHED Season
# 65266 Lego Dynamics - UNEARTHED Season
<div align="center">
@@ -12,26 +12,26 @@
---
## 📋 Project Overview
## Project Overview
Welcome to the official code repository for **Team 65266 Lego Dynamics**! This repository contains all the Pybricks code powering our robot through the UNEARTHED season missions. Our modular approach allows for flexible mission execution and quick color-sensor-based run selection.
---
## 🦾 Robot Hardware
## Robot Hardware
### 🎯 Meet Optimus Prime III
### Meet Optimus Prime III
| Component | Specification |
|-----------|--------------|
| 🤖 **Robot Name** | Optimus Prime III |
| 💾 **Firmware** | Pybricks |
| 🔧 **Attachment Motors** | 2× Large Motors (Ports C & D) |
| 🚗 **Drive Motors** | 2× Small Motors (Ports A & B) |
| 👁️ **Sensors** | Up-facing Color Sensor (Quick Start) |
| 🛠️ **Attachments** | Multiple mission-specific tools |
| **Robot Name** | Optimus Prime III |
| **Firmware** | Pybricks |
| **Attachment Motors** | 2× Large Motors (Ports C & D) |
| **Drive Motors** | 2× Small Motors (Ports A & B) |
| **Sensors** | Up-facing Color Sensor (Quick Start) |
| **Attachments** | Multiple mission-specific tools |
### ⚙️ Motor Configuration
### Motor Configuration
- **Port A**: Left Drive Motor (Small)
- **Port B**: Right Drive Motor (Small)
- **Port C**: Left Attachment Motor (Large)
@@ -39,56 +39,56 @@ Welcome to the official code repository for **Team 65266 Lego Dynamics**! This r
---
## 📂 Code Structure
## Code Structure
Our codebase is organized for maximum efficiency and modularity:
```
📦 Repository
📜 run_1.py # Individual mission runs
📜 run_2.py # Each file = 1+ mission completions
📜 run_3.py
📜 ...
📜 master.py # 🎯 Combined master file with color-start logic
Repository
┣ run_1.py # Individual mission runs
┣ run_2.py # Each file = 1+ mission completions
┣ run_3.py
┣ ...
┗ master.py # 🎯 Combined master file with color-start logic
```
### 🔄 Workflow
### Workflow
1. **Individual Run Files** → Contain specific mission sequences
2. **Script Combination** → Merges runs into master file
3. **Color Sensor Logic** → Adds intelligent run selection based on color detection
---
## 🚀 How to Use
## How to Use
### 📥 Installation & Deployment
### Installation & Deployment
1. **Load the Code**
```bash
# Open the master.py file in Pybricks IDE
```
2. **🔌 Connect to Robot**
2. **Connect to Robot**
- Pair your robot via Bluetooth in Pybricks
3. **📤 Upload to Robot**
3. **Upload to Robot**
- Click "Download and Run" or send the program to the robot
4. **🎨 Start Your Run**
4. **Start Your Run**
- Hold a colored LEGO brick up to the color sensor
- Different colors trigger different mission runs!
### 🎮 Color Start System
### Color Start System
| 🟥 Red | 🟦 Blue | 🟩 Green | 🟨 Yellow |
|--------|---------|----------|-----------|
| Run 1 | Run 2 | Run 3 | Run 4 |
> **💡 Pro Tip**: Organize your colored bricks before the match for quick run selection!
> **Tip**: Organize your colored bricks before the match for quick run selection!
---
## 🏆 Competition Notes
## Competition Notes
- ⏱️ **Quick Start**: Color sensor enables rapid run switching without reprogramming
- 🎯 **Modular Design**: Easy to test and modify individual missions
@@ -96,7 +96,7 @@ Our codebase is organized for maximum efficiency and modularity:
---
## 🤝 Contributing
## Contributing
Team members can contribute by:
- 🐛 Reporting bugs via Issues
@@ -106,25 +106,25 @@ Team members can contribute by:
---
## 📄 License
## License
**GNU General Public License v3.0**
```
🔒 You can take inspiration from our code, but you can't take our exact code.
You can take inspiration from our code, but you can't take our exact code.
```
This project is licensed under GPL-3.0 - see the [LICENSE](LICENSE) file for complete details.
### 📖 What This Means:
- Learn from our approaches and strategies
- Understand our logic and algorithms
- Don't copy-paste our exact code
- Create your own unique implementations
### What This Means:
- Learn from our approaches and strategies
- Understand our logic and algorithms
- Don't copy-paste our exact code
- Create your own unique implementations
---
## 📞 Contact & Support
## Contact & Support
**Team 65266 Lego Dynamics**
@@ -134,8 +134,6 @@ Questions about our approach? Interested in collaboration? Reach out!
<div align="center">
**🔧 Built with Passion | 🤖 Powered by Pybricks | 🏆 Competing for Excellence**
⭐ Star this repo if you found it helpful! ⭐
Star this repo if you found it helpful!
</div>