> ## Documentation Index
> Fetch the complete documentation index at: https://docs.t3gemstone.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Genel Bakış

> T3 Gemstone O1 tabanlı, ROS 2 Jazzy ile çalışan diferansiyel sürüşlü kara robotu

![UGV robotunun pili ve kabloları](https://mintcdn.com/t3gemstone-754bcb96/ob7PTI-_45ZCj-OZ/images/ugv-ros/ugv-rear.png?fit=max\&auto=format\&n=ob7PTI-_45ZCj-OZ\&q=85\&s=ea47231da8a4971d495cdbc6388e186a)

Pil ve kablo yerleşimi

![UGV robotunun çizgi sensörü ve motor sürücüsü](https://mintcdn.com/t3gemstone-754bcb96/ob7PTI-_45ZCj-OZ/images/ugv-ros/ugv-front.png?fit=max\&auto=format\&n=ob7PTI-_45ZCj-OZ\&q=85\&s=f3d981c06056ce94b91f1b35cd5d8e3a)

Çizgi sensörü ve motor sürücüsü

> [!TIP]
>
> Bölüm bitiminde aşağıdaki konularda bilgi sahibi olacaksınız.
>
> * T3 Gemstone O1 üzerinde **Ubuntu 24.04** ve **ROS 2 Jazzy** ile bir kara robotunun kurulması
> * Motor, enkoder, IMU, çizgi sensörü ve lidar bağlantılarının yapılması
> * Robotun web arayüzünden sürülmesi, çizgi izlemesi ve lidar ile harita çıkarması
> * Kayıtlı harita üzerinde Nav2 ile hedefe otonom gidilmesi

## 1. Giriş

UGV ROS, T3 Gemstone O1 tabanlı, diferansiyel sürüşlü bir kara robotudur. Robot üzerinde **Ubuntu 24.04 ve ROS 2 Jazzy**
çalışır. Robot çizgi izleyebilir, lidar ile çevresinin haritasını çıkarabilir ve Nav2 etkinleştirildiğinde kayıtlı harita
üzerinde belirlenen bir hedefe gidebilir.

* **Manuel sürüş** için klavye, ekrandaki yön tuşları veya gamepad kullanılır. Tekerlek hızı enkoderlerle ölçülür,
  odometri kart üzerindeki IMU ile birleştirilir.
* **Çizgi izleme** için sekiz kanallı analog sensör Deneyap Mini v2 üzerinden okunur. Beyaz ve siyah zemin ölçümleri web
  arayüzünden kaydedilir.
* **Haritalama ve navigasyon** için RPLIDAR A1 kullanılır. Harita kaydedilebilir ve Nav2 etkinleştirildiğinde harita
  üzerinden hedef verilebilir.

Projenin kaynak kodlarına [t3gemstone/ugv-ros](https://github.com/t3gemstone/ugv-ros) deposundan erişebilirsiniz.

## 2. Bileşenler

| Bileşen | Görev |
| - | - |
| **T3 Gemstone O1** | Ana bilgisayar. ROS 2 düğümleri, web arayüzü, kart üzerindeki ICM-20948 IMU |
| **L298N** motor sürücüsü | İki motorun yönünü ve hızını (PWM) sürer |
| 2 × **Waveshare DCGM-3865** | 12 V, 1:42 redüktörlü, 240 rpm, hall enkoderli DC motorlar |
| **Deneyap Mini v2** | Çizgi sensörünün sekiz analog kanalını okuyup UART ile T3 Gemstone O1'e gönderir |
| Pololu QTR-8A çizgi sensörü | 8 kanallı analog, siyah/beyaz zemin algılama |
| **RPLIDAR A1** | 360° lidar; haritalama, konumlandırma ve engel algılama |
| 3S Li-Po (11,1 V, 4200 mAh) | Motor ve kart beslemesi |

Pin bağlantılarının tamamı [Donanım ve Kablolama](https://docs.t3gemstone.org/tr/projects/ugv-ros/hardware.md) sayfasında yer almaktadır.

## 3. Web Arayüzü

Robot üzerinde çalışan **UGV Control** arayüzüne aynı ağa bağlı bir bilgisayarın tarayıcısından erişilir. Bilgisayarda
ROS kurulu olması gerekmez.

![UGV Control ekranında harita, robot konumu, sürüş, sensör kalibrasyonu ve lidar panelleri](https://mintcdn.com/t3gemstone-754bcb96/ob7PTI-_45ZCj-OZ/images/ugv-ros/ugv-web-ui.png?fit=max\&auto=format\&n=ob7PTI-_45ZCj-OZ\&q=85\&s=0bbba1ceaa90d073b9a7ac762edcab9d)

UGV Control ekranı, kayıtlı bir lidar taramasından aktarılan harita ve örnek sensör değerleriyle.

| Panel | İşlev |
| - | - |
| **Mode** ve **Drive** | **Idle**, **Manual** veya **Line follow** modunu seçin. Manuel sürüşte ekran tuşlarını, WASD veya ok tuşlarını ya da gamepad'i kullanın. Hızı ve dönüş hızını ayarlayın. |
| **Map** | SLAM ile oluşan haritayı ve robotun konumunu izleyin. **Save map** paneliyle haritayı kaydedin. Nav2 açıkken **Click → goal** seçeneğiyle harita üzerinden hedef verin. |
| **Status** ve **Line sensor calibration** | Hızı, engel mesafesini ve çizgi sensörü ölçümlerini izleyin. Deneyap seri sensörünü beyaz ve siyah yüzeylerle kalibre edin. |
| **Lidar** | Kablolamaya göre **USB** veya **GPIO (UART)** seçin ve tarama hızını kontrol edin. |

Sürüşü durdurmak için **EMERGENCY STOP** düğmesini veya **Boşluk** tuşunu kullanın.

## 4. İlk Kullanım Adımları

**1. İşletim sistemini ve UGV yazılımını kurun**

T3 Gemstone O1'e Ubuntu 24.04 imajını yazın, ROS 2 Jazzy'yi ve bağımlılıkları kurup çalışma alanını derleyin.
Ardından Deneyap Mini v2'ye çizgi sensörü yazılımını yükleyin ve PWM/UART overlay'lerini etkinleştirin.
[Kurulum](https://docs.t3gemstone.org/tr/projects/ugv-ros/installation.md)

**2. Donanımı bağlayın**

Güç kapalıyken motor, enkoder, çizgi sensörü ve lidar bağlantılarını tamamlayın.
[Donanım ve Kablolama](https://docs.t3gemstone.org/tr/projects/ugv-ros/hardware.md)

**3. Güvenlik kurallarını okuyun**

İlk sürüşten önce pil ve kullanım güvenliği kurallarını okuyun.
[Pil ve Kullanım Güvenliği](https://docs.t3gemstone.org/tr/projects/ugv-ros/safety.md)

**4. Saha testini yapın**

Tekerlekleri yerden kaldırarak motor yönlerini, enkoderleri, IMU'yu ve lidarı adım adım doğrulayın.
[Saha Testi](https://docs.t3gemstone.org/tr/projects/ugv-ros/field-test.md)

**5. Robotu başlatın ve kullanın**

Robotu başlatın, web arayüzünü açın, çizgi sensörünü kalibre edin ve harita çıkarın.
[Kullanım](https://docs.t3gemstone.org/tr/projects/ugv-ros/usage.md)

## 5. Teknik Referanslar

> [card] [Mimari](https://docs.t3gemstone.org/tr/projects/ugv-ros/architecture.md)
>
> ROS 2 paketleri, konular, servisler ve sürüş modları

> [card] [Simülasyon](https://docs.t3gemstone.org/tr/projects/ugv-ros/simulation.md)
>
> Robot olmadan Gazebo'da haritalama, navigasyon ve çizgi izleme

> [card] [Ağ Bağlantısı](https://docs.t3gemstone.org/tr/projects/ugv-ros/network.md)
>
> Robotu yeni bir Wi-Fi ağına bağlama ve IP adresini bulma

> [card] [PWM](https://docs.t3gemstone.org/tr/boards/o1/peripherals/pwm.md)
>
> T3 Gemstone O1 PWM kanalları ve overlay yapılandırması

> [card] [IMU](https://docs.t3gemstone.org/tr/boards/o1/peripherals/imu.md)
>
> Kart üzerindeki ICM-20948 sensörü


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.