# EarthRover Mini Plus

<img
  src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/lerobot/Earth_Rover_Mini_5_240c9adc-4f9e-44b7-982f-5d1dc24af1d8.png.webp"
  alt="EarthRover Mini Plus"
  width="70%"
/>

EarthRover Mini Plus, Frodobots SDK aracılığıyla bulut üzerinden bağlantı kuran, tamamen açık kaynaklı bir mobil robottur. Bu sayede robotu kontrol edebilir ve yapay zeka modellerini eğitmek için veri setleri kaydedebilirsiniz.

## Gereksinimler

### Donanım

- EarthRover Mini robot
- Python 3.12 veya daha yeni bir sürümle çalışan bilgisayar
- İnternet bağlantısı

### Frodobots SDK'nın Kurulumu

Robotun çalışması için bilgisayarınızda [Frodobots SDK](https://github.com/frodobots-org/earth-rovers-sdk) kurulu olmalıdır. İşte adımlar:

1. SDK'yi indirin ve yükleyin:

```bash
git clone https://github.com/frodobots-org/earth-rovers-sdk.git
cd earth-rovers-sdk
pip install -r requirements.txt
```

2. Kimlik Bilgilerini Kaydet:

Frodobots ekibinin sağladığı SDK API anahtarı ve bot adıyla .env değişkenlerinizi yazın.

```bash
SDK_API_TOKEN=your_sdk_api_token_here
BOT_SLUG=your_bot_slug_here
CHROME_EXECUTABLE_PATH=/path/to/chrome_or_chromium
# Default value is MAP_ZOOM_LEVEL=18 https://wiki.openstreetmap.org/wiki/Zoom_levels
MAP_ZOOM_LEVEL=18
MISSION_SLUG=your_mission_slug_here
# Image quality between 0.1 and 1.0 (default: 0.8)
# Recommended: 0.8 for better performance
IMAGE_QUALITY=0.8
# Image format: jpeg, png or webp (default: png)
# Recommended: jpeg for better performance and lower bandwidth usage
IMAGE_FORMAT=jpeg
```

3. SDK'yi başlatın:

```bash
hypercorn main:app --reload
```

4. Web tarayıcınızı açın ve `http://localhost:8000` adresine gidin, ardından "Join" düğmesine tıklayın

SDK size şunları sunar:

- Ön ve arka kameralardan canlı video

> [!IMPORTANT]
> Robotu kullanabilmeniz için SDK'nın çalışıyor olması gerekir.

## LeRobot'u Yükle

LeRobot'u yüklemek için [Yükleme Kılavuzumuza](./installation) göz atın.

Temel kurulumun yanı sıra, EarthRover Mini'yi donanım bağımlılıklarıyla birlikte kurun:

```bash
pip install -e ".[hardware]"
```

## Nasıl Çalışır

Robot, iletişim için interneti kullanır:

- **Hareket komutları**: SDK üzerinden gönderilir
- **Kamera videosu**: SDK'dan alındı
- **Robot bilgisi**: SDK'dan pil, konum, hız

Hiçbir şeyi takmanıza gerek yok - her şey SDK üzerinden çalışır.

## Kalibrasyon

Kalibrasyona gerek yok! SDK çalışmaya başladığı anda robot kullanıma hazırdır.

## Robotu Kontrol Etme

Robotu klavyenizle kontrol edersiniz - tıpkı bir video oyununda WASD tuşlarını kullanmak gibi.

### Klavye Kontrolleri

| Anahtar | Eylem                           |
| --- | -------------------------------- |
| W   | İleri git                     |
| S   | Geriye git                    |
| A   | Sola dön (ileri hareketle)  |
| D   | Sağa dön (ileri hareketle) |
| Q   | Yerinde sola döndür             |
| E   | Sağa yerinde döndür            |
| X   | Tüm hareketleri durdur                |
| +/= | Hız artışı                   |
| -   | Hızı azalt                   |
| ESC | Bağlantıyı Kes                       |

### Hız Ayarları

Robotun ne kadar hızlı hareket ettiğini ayarlayabilirsiniz:

- **İleri/geri hız**: Varsayılan tam hız (1.0)
- **Dönme hızı**: Varsayılan tam hız (1.0)
- **Hız değişiklikleri**: Her seferinde 0,1'lik ayarlamalar yapmak için +/- tuşlarını kullanın

### Deneyin

Veri kaydetmeden önce robotu deneme sürüşüne çıkarma:

```python
from lerobot.robots.earthrover_mini_plus import EarthRoverMiniPlus, EarthRoverMiniPlusConfig
from lerobot.teleoperators.keyboard import KeyboardRoverTeleop, KeyboardRoverTeleopConfig

# Initialize robot
robot_config = EarthRoverMiniPlusConfig()
robot = EarthRoverMiniPlus(robot_config)

# Initialize teleoperator
teleop_config = KeyboardRoverTeleopConfig(
    linear_speed=1.0,
    angular_speed=1.0,
    speed_increment=0.1
)
teleop = KeyboardRoverTeleop(teleop_config)

# Connect
robot.connect()
teleop.connect()

# Teleoperate (use keyboard controls)
try:
    while True:
        action = teleop.get_action()
        robot.send_action(action)
except KeyboardInterrupt:
    pass
finally:
    robot.disconnect()
    teleop.disconnect()
```

> [!TIP]
> Mac kullanıyorsanız, teleoperation için Terminal'in klavyenize erişmesine izin vermeniz gerekebilir. Sistem Tercihleri > Güvenlik ve Gizlilik > Girdi İzleme bölümüne gidin ve Terminal için kutuyu işaretleyin.

## Veri Kaydı

Robotu iyi bir şekilde sürdürebildiğinizde, yapay zeka modellerini eğitmek için veri kaydetmeye başlayabilirsiniz. Sistem şunları kaydeder:

- **Ne yaptığınız**: Robotu nasıl hareket ettirdiğiniz (ileri, geri, dönme)
- **Robotun gördüğü**:
  - Her iki kameradan gelen videolar
  - Robot hızı ve yönü
  - Pil seviyesi ve konum
  - GPS konumu ve sinyali
  - Diğer sensör verileri
- **Ne zaman olduğu**: Her şey için zaman damgaları

### Hugging Face Kurulumu

Verilerinizi çevrimiçi olarak saklamak için Hugging Face kullanıyoruz. Öncelikle [Hugging Face ayarları](https://huggingface.co/settings/tokens)ndan aldığınız token ile oturum açın:

```bash
hf auth login --token ${HUGGINGFACE_TOKEN} --add-to-git-credential
```

Hugging Face kullanıcı adınızı saklayın:

```bash
HF_USER=$(hf auth whoami | awk -F': *' 'NR==1 {print $2}')
echo $HF_USER
```

### Kaydı Başlat

Standart kayıt komutunu kullanın:

```bash
lerobot-record \
    --robot.type=earthrover_mini_plus \
    --teleop.type=keyboard_rover \
    --dataset.repo_id=your_username/dataset_name \
    --dataset.num_episodes=2 \
    --dataset.fps=10 \
    --dataset.single_task="Navigate around obstacles" \
    --dataset.streaming_encoding=true \
    --dataset.encoder_threads=2 \
    --display_data=true
# Optional: --dataset.rgb_encoder.vcodec=auto
```

`your_username/dataset_name` ifadesini Hugging Face kullanıcı adınız ve veri setiniz için seçtiğiniz adla değiştirin.

### Ne Kaydedilir

Veri setiniz şunları içerir:

**Eylemleriniz (2 özellik)**:

- `linear_velocity`: İleri/geri ne kadar hareket ettiniz
- `angular_velocity`: Ne kadar sola/sağa döndüğünüz

**Robot Gözlemleri (24 özellik)**:

- Ön kamera videosu
- Arka kamera videosu
- Mevcut hız
- Pil seviyesi
- Yönlendirme
- GPS (enlem, boylam, sinyal gücü)
- Ağ sinyal gücü
- Titreşim seviyesi
- Lamba durumu (açık/kapalı)
- Accelerometer (x, y, z)
- Gyroscope (x, y, z)
- Magnetometer (x, y, z)
- Tekerlek Devirleri (4 tekerlek)

### Verilerinizin Nereye Gittiği

Bilgisayarınızda: `~/.cache/huggingface/lerobot/{repo-id}`

Kayıt yapıldıktan sonra verileriniz otomatik olarak Hugging Face sayfanıza yüklenir:

```bash
echo https://huggingface.co/datasets/${HF_USER}/earthrover-navigation
```

Veri setiniz, topluluk keşfi için `LeRobot` etiketiyle işaretlenecektir.

