Ana içeriğe atla
Bu bölümde ROS 2 Jazzy doğrudan T3 Gemstone O1’e kurulur ve UGV çalışma alanı kart üzerinde derlenir. Ardından çizgi sensörünü okuyan Deneyap Mini v2 programlanır ve motor PWM hatları için gerekli overlay’ler etkinleştirilir. Kurulum için gerekenler:
  • En az 32 GB kapasiteli microSD kart veya kartın dahili eMMC belleği
  • İnternet bağlantısı (Ethernet veya Wi-Fi)
  • sudo yetkili bir kullanıcı
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. İşletim Sistemi Kurulumu

1

İmajı yazın

Bilgisayarınıza Gem Imager’ı kurun ve microSD kartı okuyucuyla bilgisayara takın. Gem Imager’da T3-GEM-O1 modelini, Ubuntu 24.04 (Noble) Minimal imajını ve hedef olarak microSD kartı seçin. Özelleştirme ekranında kullanıcı parolasını belirleyin, uzaktan bağlanacaksanız SSH’ı etkinleştirin ve isterseniz Wi-Fi bilgilerini girin. Ardından imajı yazın.Ayrıntılı anlatım için Hızlı Başlangıç ve İmaj Yazma Uygulaması sayfalarına bakınız.
2

Kartı başlatın

T3 Gemstone O1 kapalıyken microSD kartı takın ve açılış anahtarlarını SD card konumuna getirin. Ardından kartı çalıştırın. Dahili eMMC kullanacaksanız eMMC’ye imaj yazma adımlarını izleyin.
3

Karta bağlanın

T3 Gemstone O1’i Ethernet veya Wi-Fi üzerinden internete bağlayın. Aynı ağdaki bilgisayardan SSH ile ya da T3 Gemstone O1’e bağlı ekran ve klavyeyle oturum açın. Kartı USB Type-C ile bilgisayara bağladıysanız aşağıdaki komutu kullanabilirsiniz.
Wi-Fi ağı tanıtma ve robotun IP adresini bulma adımları için Ağ Bağlantısı sayfasına bakınız.

2. UGV Yazılımının Kurulumu

Aşağıdaki komutları T3 Gemstone O1’de, sudo yetkili normal kullanıcınızla (root olmadan) sırasıyla çalıştırın. sudo gerektiren komutlar parolanızı soracaktır.

2.1. Depoyu indirin

Depodaki scripts/install-native.sh betiği 2.2–2.6 adımlarını tek seferde uygular. Kullanmak için depoyu indirdikten sonra cd ~/ugv-ros && bash scripts/install-native.sh komutunu çalıştırın ve Deneyap Mini v2 Yazılımının Yüklenmesi adımıyla devam edin.

2.2. ROS 2 apt kaynağını ekleyin

ROS 2 paketleri, ROS’un kendi apt deposundan kurulur. Depoyu tanıtan ros2-apt-source paketinin son sürümünü indirip kurun.

2.3. ROS 2 Jazzy ve geliştirme araçlarını kurun

2.4. USB lidar sürücüsünü (CP210x) kurun

Lidarın USB adaptörü CP210x USB-seri sürücüsünü kullanır. Minimal imajda bu modül bulunmayabilir; bu durumda adaptör lsusb çıktısında görünür ancak /dev/ttyUSB0 oluşmaz. Önce modülün yüklü olup olmadığını kontrol edin.
Komut modül bilgilerini yazdırıyorsa sonraki adıma geçebilirsiniz. Module cp210x not found hatası alırsanız sürücüyü T3 apt deposundan kurun. Bu paket yalnızca sürücü modülünü ekler, çekirdeği değiştirmez.
Son olarak modülü yükleyin.
Çalışan çekirdek sürümüne uygun kernel-module-cp210x paketi bulunamazsa USB lidar bağlantısı çalışmaz. Lidarı doğrudan T3 Gemstone O1’in GPIO pinlerine bağlayarak kullanmaya devam edebilirsiniz. Lidar bağlantısı

2.5. libgpiod v2 Python ortamını oluşturun

Enkoderlerin yüksek devirde sayım kaçırmadan okunabilmesi için libgpiod v2 Python bağlaması gerekir. Ubuntu 24.04 apt deposunda yalnızca v1.6 sürümü bulunduğundan v2, sistem Python’una dokunmadan ayrı bir sanal ortama kurulur.

2.6. Bağımlılıkları kurun ve çalışma alanını derleyin

Kaynaktan derlenen lidar sürücüsünü (sllidar_ros2) indirin.
rosdep aracını başlatın ve paket listesini güncelleyin. rosdep init yalnızca ilk kurulumda gereklidir; default sources list file already exists hatası alırsanız bu komutu atlayabilirsiniz.
Tüm ROS bağımlılıklarını (slam_toolbox, Nav2, robot_localization, rosbridge vb.) kurun.
Çalışma alanını derleyin. Kartın belleğini aşmamak için paketlerin sırayla ve en fazla iki iş parçacığıyla derlenmesi önerilir.
Bağımlılıkların kurulumu ve derleme, internet hızına bağlı olarak 20–40 dakika sürebilir.

3. Deneyap Mini v2 Yazılımının Yüklenmesi

deneyap_line.ino yazılımı çizgi sensörünün sekiz analog çıkışını A0–A7 üzerinden okur ve milivolt değerlerini saniyede yaklaşık 50 kez UART üzerinden T3 Gemstone O1’e gönderir. Aynı JSON satırları USB seri monitörde de görülür. Motor kontrolü yapmaz; siyah/beyaz kalibrasyonu T3 Gemstone O1’de saklanır.
Mini v2’nin 5V pini USB besleme hattına bağlıdır. Mini v2’yi bilgisayara USB ile bağlamadan önce T3 Gemstone O1’den gelen 5 V, TX ve RX kablolarını mutlaka ayırın.
1

Deneyap Kart IDE'yi kurun

Bilgisayarınıza Deneyap Kart IDE’yi kurun. İlk açılışta Geliştirme Ortamı Hazırlanıyor ekranındaki indirmelerin tamamlanmasını bekleyin. Deneyap Kart IDE kurulum kılavuzu
2

Kartı bilgisayara bağlayın

Gücü kapatıp T3 Gemstone O1’den gelen 5 V, TX ve RX kablolarını ayırın. Mini v2’yi veri aktarabilen bir USB kabloyla bilgisayara bağlayın.
3

Yazılımı açın ve kartı seçin

Depodaki firmware/deneyap_line/deneyap_line.ino dosyasını Ayarlar → Dosya Aç ile açın. Üst araç çubuğunda Deneyap Mini v2 kartını seçin.
4

Derleyin ve yükleyin

Araçlar menüsünde Upload Mode ayarını Internal USB, USB CDC On Boot ayarını Enabled yapın. Mini v2’nin portunu seçin ve Derle ve Yükle’ye tıklayın. Deneyap Kart IDE arayüz kılavuzuPort görünmüyorsa BUT tuşunu basılı tutarken RES tuşuna basıp bırakın, ardından BUT tuşunu bırakın. Portları Yenile düğmesine tıklayın, yükleme modunda görünen portu seçip yeniden deneyin. Deneyap Mini v2 sorun giderme kılavuzu
5

Çıktıyı kontrol edin

Yükleme tamamlanınca Seri Monitör sekmesinde kartın portunu ve 115200 baud hızını seçip Bağlan’a tıklayın. Aşağıdakine benzer JSON satırları görmelisiniz. Yükleme sonrası yazılım başlamazsa RES tuşuna bir kez basın.
Örnekteki değerler temsilidir; sensör siyah ve beyaz yüzeyler üzerinde gezdirildiğinde değerler değişmelidir.
Mini v2 için doğrulanmış derleme hedefi aşağıdaki gibidir. Komutu depo dizininde çalıştırın.
Aynı kaynak kod Deneyap Kart 1A v2 için de kullanılabilir. Bu durumda Deneyap Kart 1A v2 seçilerek yeniden derlenmeli ve o kartın A0–A7/TX/RX etiketlerine göre bağlanmalıdır. Pin tanımları kart paketinden gelir; GPIO numaralarını kaynak kodda elle değiştirmeyin.

4. PWM ve UART Ayarları (Overlay)

Motor sürücüsünün ENA/ENB hatları için kullanılan PWM kanalları, /boot/uEnv.txt dosyasındaki overlays= satırına eklenen overlay’lerle etkinleştirilir. Overlay’ler hakkında ayrıntılı bilgi için PWM ve Device Tree sayfalarına bakınız. Lidarın bağlantı şekline göre ilgili sekmedeki adımları izleyin. Bağlantı seçenekleri Lidar bağlantısı bölümünde açıklanmıştır.
/boot/uEnv.txt dosyasını açın.
overlays= satırında spidev0-2cs yerine spidev0-1cs yazın ve diğer overlay’leri silmeden satırın sonuna boşluk bırakarak ENA ve ENB için PWM overlay’lerini ekleyin. Satır aşağıdakine benzer görünmelidir.
Dosyayı kaydedip kartı yeniden başlatın.
Kart açıldıktan sonra PWM çiplerinin ve UART aygıtlarının oluştuğunu kontrol edin.
/dev/ttyS3 Deneyap Mini v2’nin, /dev/ttyS0 ise GPIO lidarın UART’ıdır. USB lidar kullanıyorsanız /dev/ttyS0 bulunmaması normaldir. GPIO lidar kullanıyorsanız dmesg | grep ttyS0 çıktısında 2b300000.serial: ttyS0 satırı görünmelidir.
pwmchipN numaraları yüklü overlay sayısına göre değişir. Bu nedenle UGV yapılandırmasında PWM kanalları numara ile değil modül adı ile (ecap0, epwm1:1) belirtilir. Hangi çipin hangi modüle karşılık geldiği Saha Testi sırasında hw_check pins komutuyla listelenir.

Etkinleştirilmemesi gereken overlay’ler

Aşağıdaki overlay’ler UGV’nın kullandığı GPIO pinlerini başka işlevlere atadığı için etkinleştirilmemelidir.
Aynı epwm modülünün iki kanalı (GPIO6 ve GPIO13) aynı periyodu paylaşmak zorundadır. GPIO6 PWM olarak açılmadığından ENB istediği periyodu alabilir. Çakışma olursa sürücü kardeş kanalın periyoduna uyar ve günlüğe uyarı yazar.
Kurulum tamamlandıktan sonra Donanım ve Kablolama sayfasındaki bağlantıları yapın.