Ana içeriğe atla
Bu kılavuz, Deneyap Kart IDE ile ilk projenizi oluşturup karta yüklemeniz için gereken temel işlemleri sırasıyla anlatır. Ekran görüntüleri v2.2.5 sürümünden alınmıştır. Arayüzün her bölümünün ayrıntılı açıklaması için Deneyap Kart IDE Tanıtımı sayfasına bakabilirsiniz.
IDE’yi henüz kurmadıysanız önce Deneyap Kart IDE Kurulumu sayfasındaki adımları uygulayınız. Görsellerdeki turuncu numaralar, metindeki adım numaralarıyla eşleşir.

Video: İlk Projeni Oluştur ve Kartına Yükle

Aşağıdaki kısa video, bu sayfada anlatılan temel adımları (yeni kod sayfası, kaydetme, kart ve port seçimi, yükleme, Seri Monitör ve kütüphane kurma) baştan sona gösterir.

Arduino IDE’yi Bilenler İçin: Nerede Ne Var?

1. Yeni Proje Oluşturma

IDE açıldığında karşınıza Adsız.cpp adlı boş bir kod sayfası gelir; kodunuzu doğrudan buraya yazabilirsiniz. Yeni bir kod sayfası açmak için şu yollardan birini kullanınız:

Yeni kod sayfası: Projeler panelindeki + düğmesi (1) veya sekme çubuğundaki + düğmesi (2)

  • Projeler panelinin başlığındaki + düğmesi (1),
  • Sekme çubuğundaki + düğmesi (2),
  • Ayarlar → Yeni Dosya ya da klavyeden Ctrl+N.

Ayarlar menüsü: Yeni Dosya (1), Dosya Aç (2) ve Kaydet (3)

Kodunuzu editöre yazınız. Bu kılavuzda, karta her saniye bir mesaj gönderen aşağıdaki kodu kullanacağız:

Kod editöre yazıldı

2. Projeyi Kaydetme ve Yeniden Açma

1

Kaydedin

Ctrl+S tuşlarına basınız (ya da Ayarlar → Kaydet). İlk kayıtta dosyanın adı ve konumu sorulur. Dosya türü olarak Arduino Dosyası “.ino” seçmenizi öneririz; projeniz Arduino IDE’de de açılabilir.
Her proje için ayrı bir klasör oluşturup dosyayı klasörle aynı adla kaydetmek (ör. Merhaba/Merhaba.ino) projelerinizi düzenli tutar.
2

Kaydedildiğini kontrol edin

Sekmenin adı yeni dosya adıyla değişir (1), Projeler panelinde Son Dosyalar listesine eklenir (2) ve Derleme Çıktısı’nda Dosya kaydedildi satırı görünür (3).

Kaydedilen dosya

3

Daha sonra yeniden açın

  • Projeler panelindeki Son Dosyalar listesinden dosyaya tıklayınız,
  • ya da Ayarlar → Dosya Aç (Ctrl+O) ile dosyayı seçiniz,
  • ya da dosyayı sürükleyip IDE penceresinin üzerine bırakınız.
Açtığınız dosyayla aynı klasördeki diğer kod dosyaları (.h, .cpp) da projeye birlikte eklenir.
Kaydedilmemiş değişiklikleri olan bir dosyayı kapatmak istediğinizde IDE sizi uyarır. Projeyi başka bir adla saklamak için menü çubuğundaki Dosya → Farklı Kaydet (Ctrl+Shift+S) komutunu kullanabilirsiniz.

3. Kartı Bağlama, Kart ve Port Seçimi

1

Kartı bilgisayara bağlayın

Kartınızı veri aktarımı destekleyen bir USB kablosuyla bilgisayarınıza takınız. Yalnızca şarj için üretilmiş kablolarda port görünmez.
2

Kart türünü seçin

Üst araç çubuğundaki kart listesinden (1) elinizdeki kartı seçiniz: Deneyap Kart, Deneyap Kart v2, Deneyap Kart 1A, Deneyap Kart 1A v2, Deneyap Mini, Deneyap Mini v2 veya Deneyap Kart G.
3

Portu seçin

Port listesinden (2) kartın bağlı olduğu portu seçiniz (Windows’ta COM3, macOS/Linux’ta /dev/ttyUSB0 gibi). Port görünmüyorsa Portları Yenile (3) düğmesine basınız.

Kart listesi (1), port listesi (2) ve Portları Yenile (3)

Hangi portun kartınıza ait olduğundan emin değilseniz kartı çıkarıp yeniden takınız; listeden kaybolup geri gelen port kartınızındır.
4

Durum çubuğundan kontrol edin

Ekranın en altındaki durum çubuğu seçtiğiniz Kart (1) ve Port (2) bilgisini gösterir.

Durum çubuğu

4. Derleme ve Karta Yükleme

Derle (1) ve Derle ve Yükle (2) düğmeleri

  • Derle (1): Kodunuzda hata olup olmadığını kontrol eder, karta bir şey yüklemez.
  • Derle ve Yükle (2): Kodu derler ve seçili porttaki karta yükler.
İşlem sırasında derleyicinin çıktısı alt paneldeki Derleme Çıktısı sekmesine akar. Yükleme başarıyla bittiğinde son satırda “[Başarılı] Karta yükleme işlemi tamamlandı.” yazar ve kart yeni kodu çalıştırmaya başlar.

Başarılı bir yüklemenin çıktısı

İlk derleme birkaç dakika sürebilir; sonraki derlemeler çok daha hızlıdır. İşlem sürerken araç çubuğunda beliren Durdur düğmesiyle işlemi iptal edebilirsiniz.
Çıktıda kırmızı [Hata] satırları görürseniz hata mesajının tamamını okuyunuz: kod hatalarında hatanın bulunduğu dosya ve satır numarası yazar. Kart veya portla ilgili sorunlar için sayfanın sonundaki Sık Karşılaşılan Durumlar bölümüne bakınız.

5. Seri Monitör ile Karttan Veri Okuma

Kartınızın Serial.print ile gönderdiği mesajları görmek için alt paneldeki Seri Monitör sekmesini açınız.
1

Portu seçin

Seri Monitör’ün kendi port listesinden (1) kartınızın portunu seçiniz.
2

Baud hızını ayarlayın

Baud hızını (2), kodunuzdaki Serial.begin(...) değeriyle aynı yapınız. Örnek kodumuzda bu değer 115200’dür.
3

Bağlanın

Bağlan (3) düğmesine basınız. Bağlantı kurulunca aynı düğme Bağlantıyı Kes olur. Karttan gelen mesajlar çıktı alanında (4) satır satır görünür.

Seri Monitör: port (1), baud hızı (2), Bağlan / Bağlantıyı Kes (3) ve çıktı alanı (4)

  • Kartı Resetle (1): Kartı yeniden başlatır; programınız baştan çalışır. setup() içinde yazdırdığınız mesajları görmek için kullanışlıdır.
  • Bağlantıyı Kes (2): Seri bağlantıyı kapatır. Bağlı değilken aynı düğme Bağlan olarak görünür.

Kartı Resetle (1) ve Bağlantıyı Kes (2)

Seri Monitör açıkken Derle ve Yükle’ye basabilirsiniz: IDE yükleme öncesinde bağlantıyı kendisi kapatır, yükleme bitince aynı porta yeniden bağlanır.

6. Hazır Örnekleri Açmak

1

Örnekler panelini açın

Sol kenardaki Örnekler (1) simgesine tıklayınız. Arama kutusuna (2) örneğin adını yazarak filtreleyebilirsiniz.
2

Bir örnek seçin

Kütüphane klasörünü açıp örneğe (3) tıklayınız. Klasörün yanındaki Çekirdek etiketi Deneyap çekirdeğiyle gelen örnekleri, Kullanıcı etiketi sizin kurduğunuz kütüphanelerin örneklerini gösterir.

Örnekler paneli: Deneyap → RgbYakSondur

3

Örneği yükleyin

Örnek yeni bir sekmede açılır (1). Kart ve port seçiliyse Derle ve Yükle ile doğrudan karta yükleyebilirsiniz.

Açılan örnek

Örnek üzerinde değişiklik yapıp kaydettiğinizde IDE yeni bir konum sorar; orijinal örnek dosyası değişmez.

7. Kütüphane Kurmak

Sık kullanılan bazı kütüphaneler IDE’nin ilk açılışında kendiliğinden kurulur; bunları ayrıca kurmanız gerekmez. Örneğin Deneyap Servo (#include <Deneyap_Servo.h>) ve I2C LCD ekran için LiquidCrystal_I2C (#include <LiquidCrystal_I2C.h>) hazır gelir. Aradığınızda Kurulu etiketiyle görünürler.
1

Kütüphane panelini açın

Sol kenardaki Kütüphane (1) simgesine tıklayınız.
2

Kütüphaneyi arayın

Arama kutusuna (2) kütüphanenin adını yazıp Enter’a basınız.
3

Kurun

İstediğiniz sürümü seçip Kur (3) düğmesine basınız. Kurulu kütüphanelerinizi Kurulu Olanlar (4) sekmesinde görebilir, güncelleyebilir veya kaldırabilirsiniz.

Kütüphane Yöneticisi

Arduino ekosisteminde bulunmayan bir kütüphaneyi .zip dosyasından kurmak için .zip Dosyasından Kütüphane Kur (5) düğmesini kullanınız.
Deneyap modüllerinin kütüphanelerini bulmak için arama kutusuna Deneyap yazmanız yeterlidir; sonuçlarda geliştiricisi Turkish Technology Team Foundation (T3) olan kütüphaneler listelenir.

Sık Karşılaşılan Durumlar

  • Kablonun veri aktarımını desteklediğinden emin olunuz; başka bir kabloyla deneyiniz.
  • Kartı başka bir USB girişine takıp Portları Yenile’ye basınız.
  • Kartınız USB sürücüsü gerektiriyorsa USB Sürücünün Yüklenmesi sayfasındaki adımları uygulayınız.
  • Linux’ta port görünüyor ama açılmıyorsa Hatalar ve Çözümleri sayfasına bakınız.
Port başka bir program tarafından kullanılıyor olabilir. Kartı dinleyen diğer programları (başka bir IDE penceresi, Arduino IDE, Deneyap Kart Blok vb.) kapatıp yeniden deneyiniz.
  • Kart listesinde doğru kart türünün seçili olduğunu kontrol ediniz.
  • Kartı çıkarıp yeniden takarak tekrar deneyiniz.
  • Sorun devam ederse kartı elle yükleme moduna alınız: kart üzerindeki BOOT tuşunu basılı tutarken RESET tuşuna basıp bırakınız, ardından BOOT tuşunu bırakınız. Sonra Derle ve Yükle’ye basınız. Deneyap Mini ve Mini v2’de bu işlemden sonra port numarası değişebilir; port listesinden yeni portu seçiniz. Yükleme bitince kartın RESET tuşuna basarak programı başlatınız.
Seri Monitör’deki baud hızı, kodunuzdaki Serial.begin(...) değeriyle aynı değildir. İkisini aynı değere getiriniz.
  • Kodunuzun Serial.begin(...) ile başladığından ve Serial.print ile mesaj gönderdiğinden emin olunuz.
  • setup() içindeki mesajlar bağlanmadan önce gönderilmiş olabilir; Kartı Resetle düğmesiyle programı baştan başlatınız.
IDE, kartları derlemek için kullandığı Deneyap çekirdeğinin daha yeni bir sürümünün hazır olduğunu bildiriyor. Çekirdeği Güncelle düğmesine basınız; ilerleme ekranın üstünde gösterilir. Güncelleme büyük bir indirme (1–2 GB) gerektirdiğinden hızlı bir internet bağlantısında başlatınız. Daha sonra yapmak isterseniz bildirimi kapatabilir, güncellemeyi Ayarlar menüsünden de yapabilirsiniz.
Diğer hata ve çözümler için Hatalar ve Çözümleri ve Sıkça Sorulan Sorular sayfalarına bakabilirsiniz.

Sırada Ne Var?

Başlangıç Seviyesi Projeler

Kartınızla yapabileceğiniz ilk projeler.

Deneyap Kart IDE Tanıtımı

Arayüzün tüm bölümlerinin ayrıntılı açıklaması.