- En az 32 GB kapasiteli microSD kart veya kartın dahili eMMC belleği
- İnternet bağlantısı (Ethernet veya Wi-Fi)
sudoyetkili 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
2.2. ROS 2 apt kaynağını ekleyin
ROS 2 paketleri, ROS’un kendi apt deposundan kurulur. Depoyu tanıtanros2-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örlsusb çıktısında görünür ancak /dev/ttyUSB0 oluşmaz. Önce modülün yüklü olup olmadığını kontrol edin.
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.
Ç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.
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.
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.
Arduino CLI ile derleme
Arduino CLI ile derleme
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.
- USB lidar (varsayılan)
- GPIO lidar
/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./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.
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.

