> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deneyapkart.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Adım Adım Kullanım Kılavuzu
> Yeni proje oluşturma, kaydetme, karta kod yükleme, Seri Monitör, örnekler ve kütüphaneler
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ı](/tr/IDE/Deneyap-Kart-IDE-Introduction) sayfasına bakabilirsiniz.
> [!TIP]
>
> IDE'yi henüz kurmadıysanız önce [Deneyap Kart IDE Kurulumu](/tr/IDE/Deneyap-Kart-IDE-Setup)
> 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?
| Arduino IDE | Deneyap Kart IDE |
| - | - |
| **Doğrula** (✓) | Üst araç çubuğunda **Derle** |
| **Yükle** (→) | Üst araç çubuğunda **Derle ve Yükle** |
| Araçlar → Kart | Üst araç çubuğundaki **kart listesi** |
| Araçlar → Port | Üst araç çubuğundaki **port listesi** |
| Araçlar → (kart ayarları) | Üst araç çubuğunda **Araçlar** |
| Dosya → Yeni / Aç / Kaydet | **Ayarlar** menüsü veya `Ctrl+N` / `Ctrl+O` / `Ctrl+S` |
| Dosya → Örnekler | Sol kenardaki **Örnekler** paneli |
| Kütüphaneleri Yönet | Sol kenardaki **Kütüphane** paneli |
| Seri Port Ekranı | Alt paneldeki **Seri Monitör** sekmesi |
## 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:
* **Projeler** panelinin başlığındaki **+** düğmesi (1),
* Sekme çubuğundaki **+** düğmesi (2),
* **Ayarlar → Yeni Dosya** ya da klavyeden `Ctrl+N`.
Kodunuzu editöre yazınız. Bu kılavuzda, karta her saniye bir mesaj gönderen aşağıdaki
kodu kullanacağız:
```cpp theme={null}
int sayac = 0;
void setup() {
Serial.begin(115200);
}
void loop() {
Serial.print("Merhaba Deneyap! ");
Serial.println(sayac);
sayac++;
delay(1000);
}
```
## 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.
> [!TIP]
>
> 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).
**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.
> [!TIP]
>
> 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.
> [!TIP]
>
> 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.
## 4. Derleme ve Karta Yükleme
* **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.
> [!TIP]
>
> İ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.
> [!WARNING]
>
> Çı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.
* **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.
> [!TIP]
>
> 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.
**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.
> [!TIP]
>
> Ö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
> [!NOTE]
>
> 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 `) ve
> I2C LCD ekran için **LiquidCrystal\_I2C** (`#include `) 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.
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.
> [!TIP]
>
> 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
> **Port listesi boş, kartım görünmüyor**
>
> * 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](/tr/Cards/USB-Driver-Setup)
> sayfasındaki adımları uygulayınız.
> * Linux'ta port görünüyor ama açılmıyorsa
> [Hatalar ve Çözümleri](/tr/IDE/Deneyap-Kart-IDE-Errors-and-Solutions) sayfasına bakınız.
> **Yükleme portun meşgul olduğunu söylüyor**
>
> 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.
> **Yükleme karta bağlanamıyor**
>
> * 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'de anlamsız karakterler görünüyor**
>
> Seri Monitör'deki baud hızı, kodunuzdaki `Serial.begin(...)` değeriyle aynı değildir.
> İkisini aynı değere getiriniz.
> **Seri Monitör'de hiçbir şey görünmüyor**
>
> * 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.
> **Üstte "Deneyap çekirdeğinin yeni sürümü hazır" yazıyor**
>
> 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](/tr/IDE/Deneyap-Kart-IDE-Errors-and-Solutions)
ve [Sıkça Sorulan Sorular](/tr/FAQ) sayfalarına bakabilirsiniz.
## Sırada Ne Var?
> **[Başlangıç Seviyesi Projeler](/tr/projects/Beginner)**
>
> Kartınızla yapabileceğiniz ilk projeler.
> **[Deneyap Kart IDE Tanıtımı](/tr/IDE/Deneyap-Kart-IDE-Introduction)**
>
> Arayüzün tüm bölümlerinin ayrıntılı açıklaması.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.