Ana içeriğe atla
Bu sayfadaki komutlar, Gem Imager’da kullanıcı adı olarak gemstone seçildiği varsayılarak yazılmıştır. Farklı bir kullanıcı adı seçtiyseniz /home/gemstone ifadelerini kendi kullanıcı dizininizle değiştirin.

1. Robotu Başlatma

Robot yazılımı GPIO ve PWM erişimi için root yetkisiyle çalıştırılır. T3 Gemstone O1’de root kabuğuna geçin.
ROS ortamını ve libgpiod v2 Python yolunu yükleyin.
Robotun ROS_DOMAIN_ID değerini belirleyin. Aynı ağdaki her robota farklı bir değer verin.
Robotu başlatın. Robotu durdurmak için Ctrl+C tuşlarını kullanın.
Otomatik başlatma servisi kuruluysa robotu elle başlatmadan önce sudo systemctl stop ugv komutuyla servisi durdurun. Servis çalışırken ikinci bir ros2 launch başlatmayın.

1.1. Başlatma argümanları

Varsayılan başlatma tam robotu haritalama modunda çalıştırır. Bileşenleri açıp kapatmak için komutun sonuna argüman:=değer biçiminde argümanlar eklenebilir. Örneğin çizgi sensörü olmadan başlatmak için:

2. Web Arayüzüne Bağlanma

1

Robotun IP adresini öğrenin

T3 Gemstone O1 terminalinde robotun yerel ağdaki IP adresini öğrenin.
2

Arayüzü açın

Aynı ağa bağlı bilgisayarda tarayıcıyı açın ve http://<robot-ip>:8000 adresine gidin. Örneğin robotun IP adresi 192.168.1.42 ise adres http://192.168.1.42:8000 olur.
3

Bağlantıyı kontrol edin

Sağ üstteki bağlantı göstergesi yeşile döndüğünde arayüz hazırdır. Gösterge kırmızı kalırsa robot address alanına T3 Gemstone O1’in IP adresini yazıp Connect düğmesine tıklayın. Sayfa 8000, ROS bağlantısı ise 9090 portunu kullanır.
Bağlantı sorunu sürerse Ağ Bağlantısı sayfasındaki kontrolleri uygulayın. Arayüzdeki panellerin açıklamaları için Genel Bakış sayfasına bakınız.
Sürüşü durdurmak için EMERGENCY STOP düğmesini veya Boşluk tuşunu kullanın.

3. Çizgi Sensörü Kalibrasyonu

Çizgi izleme için her kanalın eşiği, beyaz ve siyah ölçümlerin ortası olarak belirlenir. Kalibrasyon yapılmadan hiçbir kanal çizgiyi algılamaz. Kalibrasyon robot çalışırken ve robot Idle modundayken yapılır.
1

Kalibrasyonu başlatın

Line sensor calibration panelinde Start calibration seçeneğine tıklayın. Robot Idle moduna alınır; klavye, gamepad, ekran sürüşü ve harita hedefi işlem tamamlanana kadar bu sekmede engellenir.
2

Beyaz yüzeyi ölçün

Sensörü çalışma yüksekliğinde sabit tutup sekiz gözün tamamının altına beyaz yüzey yerleştirin ve White ready — measure seçeneğine tıklayın. Tıklamadan sonra yaklaşık 1,2 saniye sabit tutun.
3

Siyah yüzeyi ölçün ve kaydedin

Yüksekliği değiştirmeden mat siyah bir yüzey yerleştirin ve Black ready — measure and save seçeneğine tıklayın. Tıklamadan sonra yaklaşık 1,2 saniye sabit tutun.
Panel son kayıtlı beyaz/siyah değerleri, eşikleri ve kanal başına ayrım payını mV olarak gösterir; 200 mV’un altındaki dar paylar vurgulanır. Yeni ölçüm başarısız olursa veya işlem kapatılırsa önceki kayıt korunur. Kayıtlı ayarlar her açılışta otomatik yüklenir; sensör yüksekliği, zemin veya ışık değiştiğinde kalibrasyonu tekrarlayın.
Bu panel yalnızca Deneyap Mini v2 bağlantısında (type: serial) kullanılabilir. qtr_rc veya digital tiplerinde ya da sensör kapalıyken panel pasiftir.
Kalibrasyon sonucu robotta ~/.ugv/line_calibration.json dosyasına yazılır. Robot root olarak çalıştığı için dosya /root/.ugv/ dizinindedir. Dosya yalnızca başarılı siyah ölçümünden sonra atomik olarak değiştirilir. Kalibrasyon tamamlandıktan sonra arayüzden Line follow modunu deneyin.

4. Haritalama ve Navigasyon

4.1. Harita çıkarma

Haritalama varsayılan olarak açıktır. Robotu varsayılan argümanlarla başlatın, arayüzden Manual modda yavaşça gezdirin ve harita tamamlandığında Save map panelinden bir isim vererek kaydedin. Harita ~/ugv_maps/<isim>.{pgm,yaml,posegraph,data} dosyalarına yazılır; robot root olarak çalıştığı için dizin /root/ugv_maps olur.

4.2. Kayıtlı haritada hedefe gitme

Robotu haritalamaya başladığınız noktaya ve aynı yöne bakacak şekilde yerleştirin. Ardından robotu konumlandırma modunda, uzantısız harita yolu ve Nav2 etkin olarak başlatın.
Arayüzde Click → goal seçeneğini açıp haritaya tıklayın; robot NAV moduna geçerek hedefe gider. Yol sırasında herhangi bir sürüş tuşuna basıldığında robot manuel moda geçer ve durur.

5. Açılışta Otomatik Başlatma

Robotun her açılışta kendiliğinden başlaması için bir systemd servisi tanımlanır. Elle başlattığınız oturum açıksa önce Ctrl+C ile durdurun ve root kabuğundan exit ile çıkın.
sudo bash ~/ugv-ros/scripts/install-service.sh 1 komutu aşağıdaki üç adımı tek seferde uygular; argüman robotun ROS_DOMAIN_ID değeridir. Betiğin kurduğu servis robotu scripts/start-native.sh üzerinden başlatır ve aynı /etc/default/ugv dosyasını okur.
1

Robot ayar dosyasını oluşturun

Robot ayarları /etc/default/ugv dosyasında tutulur. ROS_DOMAIN_ID değerini robotun numarasına göre ayarlayın.
2

Servis dosyasını oluşturun

$$UGV_ARGS ifadesi systemd tarafından $UGV_ARGS olarak bash’e aktarılır; böylece /etc/default/ugv dosyasındaki argümanlar başlatma komutuna eklenir.
3

Servisi etkinleştirin

Aynı ağdaki her robota farklı bir ROS_DOMAIN_ID verin. Aynı numaraya sahip iki robotun ROS düğümleri birbirini görür ve bir robotun arayüzünden verilen sürüş komutu diğer robotu da sürer. Arayüz her robotun kendi IP adresinden açıldığı için bu numara arayüzü etkilemez.
/etc/default/ugv dosyasını değiştirdikten sonra servisi yeniden başlatın. Servisi yönetmek için kullanılan komutlar şunlardır:
Servis root olarak çalıştığı için kaydedilen haritalar /root/ugv_maps, lidar seçimi /root/.ugv/lidar_source, ROS günlükleri ise /var/log/ugv altındadır.

6. Güncelleme

Depodaki son değişiklikleri alıp çalışma alanını yeniden derleyin.
Güncellemeyle yeni bir bağımlılık eklendiyse derlemeden önce bağımlılıkları kurun.

7. Birden Fazla Robot

Her kartta aynı kurulum adımlarını uygulayın; yalnızca /etc/default/ugv dosyasındaki ROS_DOMAIN_ID değeri farklı olmalıdır (ör. 1 ve 2). Kartları ağda ayırt edebilmek için hostname’lerini de değiştirin.

8. Docker ile Çalıştırma

Docker ve Docker Compose kurulu bir Linux sisteminde robot konteyner içinde de çalıştırılabilir. Depo dizininde aşağıdaki komutlarla imajı oluşturup robotu başlatın ve günlükleri izleyin.
Konteyner GPIO, SPI, PWM ve seri portlara erişebilmek için privileged modda ve host ağında çalışır. Kaydedilen haritalar ~/ugv_maps, arayüzde seçilen ayarlar ise ~/.ugv dizininde saklanır.
Arayüzü robot donanımı olmadan denemek için imajı oluşturup aşağıdaki komutu çalıştırın. backend:=mock motor ve enkoderleri benzetir. Ardından tarayıcıda http://localhost:8000 adresini açın.