Arduino exit status 1 Hatası: Derleme Hataları ve Çözümleri

Arduino exit status 1 hatası, kodunun derlenemediğini, yani derleyicinin yazdığın programı işlemcinin anlayacağı makine koduna çeviremediğini söyleyen genel bir mesajdır; asıl sebep hiçbir zaman bu satırda yazmaz. Sebep, çıktı panelinde onun birkaç satır yukarısında duran ve error: kelimesini içeren ilk satırdadır: bir ismi yanlış yazmışsındır, bir noktalı virgülü unutmuşsundur, bir kütüphane kurulu değildir ya da kod başka bir kart için yazılmıştır. Arduino IDE 2'de sağ altta beliren Compilation error: exit status 1 (Türkçe arayüzde Derleme hatası: exit status 1) bildirimi de, eski 1.8 sürümündeki Arduino Uno kartı için derleme hatası satırı da aynı anlama gelir.

Bu rehberde önce derlemenin arka planda nasıl çalıştığını ve bir hata mesajını dosya, satır ve sütun bilgisine ayırarak okumayı göreceksin. Ardından en sık karşılaşılan derleme hatalarını tek tek ele alacağız: was not declared in this scope, expected ';' before, No such file or directory, does not name a type, redefinition of ve Sketch too big. Her biri için hatayı doğuran durumu, derleyicinin verdiği gerçek mesajı ve düzeltilmiş, hatasız derlenen bir örnek kodu bulacaksın. Yanlış kart seçiminden doğan hataları, ESP32 ve Raspberry Pi Pico'ya özgü durumları ve yazının sonunda hepsini bir arada gösteren bir hata-çözüm tablosunu da ekledik. Kodun hatasız derleniyor ama karta yüklenmiyorsa sorun başka bir aşamadadır; o durum için Arduino Kod Yüklenmiyor rehberine bak.

Arduino exit status 1 nedir? Derleme ile yükleme arasındaki fark

Doğrula (onay işareti) ya da Yükle düğmesine bastığında Arduino IDE arka planda birkaç program çalıştırır. Önce taslak klasöründeki .ino dosyalarını birleştirir, başına Arduino.h başlık dosyasını ve fonksiyonların prototiplerini ekleyerek onu sıradan bir C++ dosyasına çevirir. Sonra Uno için avr-g++, ESP32 için xtensa-esp32-elf-g++ gibi bir derleyici bu dosyayı ve kullandığın kütüphaneleri derler, bağlayıcı (linker) bütün parçaları tek bir programda birleştirir ve en son programın karta sığıp sığmadığı kontrol edilir. Her program işini bitirince bir çıkış kodu döndürür: 0 başarı, 1 ise hata demektir. "exit status 1" tam olarak bunu söyler: zincirdeki programlardan biri başarısız oldu. Bu yüzden aynı ifade, yükleme sırasında avrdude başarısız olduğunda da görünür; hangisi olduğunu önündeki mesajdan anlarsın.

Arduino hata mesajı nasıl okunur?

Derleyicinin her hata satırı aynı kalıbı izler: önce dosyanın adı, sonra iki nokta üst üsteyle ayrılmış satır ve sütun numarası, ardından hatanın türü ve açıklaması gelir. Hemen üstünde çoğu zaman In function 'void loop()': gibi bir satır, hatanın hangi fonksiyonun içinde olduğunu söyler; altında ise hatalı satırın bir kopyası ve sorunlu yeri gösteren küçük bir ^ işareti bulunur. error derlemeyi durduran gerçek bir hatadır, warning yalnızca uyarıdır ve kod yine de derlenir, note ise bir önceki mesaja ek bilgi verir. Derleyici çoğu zaman bir de öneri ekler: aşağıdaki örnekte suggested alternative: 'digitalWrite' diyerek doğru yazımı kendisi gösterir.

1. Dosya > Tercihler penceresinde Ayrıntılı çıktıyı görüntüle satırındaki derle kutusunu işaretle. Böylece derleyicinin hangi dosyaları ve hangi kütüphane klasörlerini kullandığını da görürsün.
2. Kartın takılı olmasına gerek yok: Doğrula (onay işareti) düğmesine bas. Doğrula yalnızca derler; hata derleme aşamasındaysa Yükle'ye basmak sadece zaman kaybettirir.
3. Çıktı panelini en üste kaydır ve error: geçen ilk satırı bul. Ondan sonraki hataların çoğu bu ilk hatanın zincirleme sonucudur.
4. Mesajdaki satır numarasına git. IDE 2 hatanın olduğu karakterin altını kırmızıyla çizer, 1.8 sürümü bütün satırı kırmızıya boyar. O satırda bir sorun göremiyorsan bir üst satıra bak.
5. Yalnızca o ilk hatayı düzelt ve yeniden Doğrula'ya bas. Hata sayısı bir anda azalıyorsa doğru yoldasın.
6. İnternette arayacaksan mesajı kendi değişken adlarından ve dosya yollarından arındır: 'sayac' was not declared in this scope yerine was not declared in this scope aratmak çok daha fazla sonuç getirir. Bir forumda yardım isterken ise çıktının tamamını kopyala.

'was not declared in this scope' hatası ve çözümü

Bu mesaj, derleyicinin kullandığın bir ismi o noktada tanımadığını söyler; Türkçesiyle "bu kapsamda tanımlanmamış". En sık sebep yazım hatasıdır: Arduino büyük-küçük harfe duyarlıdır ve digitalwrite, Digitalwrite ve digitalWrite üç farklı isimdir. İkinci büyük sebep kapsamdır (scope): bir değişkeni setup() içinde tanımlarsan o değişken yalnızca setup() çalışırken yaşar ve loop() onu göremez. Bir değişkeni birden çok fonksiyonda kullanacaksan bütün fonksiyonların dışında, dosyanın en üstünde tanımla. Değişkeni kullandığın satırdan sonra tanımlamak da aynı hatayı verir, çünkü derleyici dosyayı yukarıdan aşağıya okur. Son olarak bu hata, kütüphanesini eklemediğin bir nesneyi (Wire, Servo) ya da seçili kartta bulunmayan bir özelliği (Uno'da Serial1) kullandığında da çıkar.

1// Kapsam (scope) örneği / Scope example
2const int LED_PIN = 13;   // global: her fonksiyon görür / global: every function can see it
3int yanmaSayisi = 0;      // setup() içine taşırsan loop() göremez / move it into setup() and loop() can't see it
4
5void setup() {
6  pinMode(LED_PIN, OUTPUT);
7  Serial.begin(9600);
8}
9
10void loop() {
11  int sure = 500;                // yerel: yalnız loop() içinde / local: only inside loop()
12  digitalWrite(LED_PIN, HIGH);   // digitalwrite yazarsan: was not declared / typing digitalwrite: was not declared
13  delay(sure);
14  digitalWrite(LED_PIN, LOW);
15  delay(sure);
16  yanmaSayisi++;
17  Serial.println(yanmaSayisi);   // kaç kez yandı / how many times it blinked
18}

'expected ';' before' ve diğer söz dizimi hataları

C++'ta her ifade noktalı virgülle biter. Bir satırın sonunda noktalı virgülü unuttuğunda derleyici bunu ancak bir sonraki kelimeyi okuduğunda fark eder. Bu yüzden Uno'nun derleyicisinde expected ';' before 'delay' mesajındaki satır numarası hatanın bir alt satırını gösterir: eksik noktalı virgül, delay'den önceki satırın sonundadır. ESP32 ve Pico paketlerindeki daha yeni derleyiciler ise doğrudan noktalı virgülün eksik olduğu satırın sonunu gösterir. Fonksiyonun son satırında unutursan mesaj expected ';' before '}' token olur. Parantez hataları da benzer davranır. Bir if bloğunun ya da fonksiyonun süslü parantezini kapatmayı unutursan derleyici kodu dosyanın sonuna kadar okur ve ancak orada expected '}' at end of input der. Kapanmamış parantez setup() içindeyse bir de a function-definition is not allowed here before '{' token mesajı gelir, çünkü derleyiciye göre loop() artık setup()'ın içinde tanımlanmaya çalışılan bir fonksiyondur. for döngüsünün parantezinde noktalı virgül yerine virgül kullanmak da bu ailenin klasik hatasıdır.

'No such file or directory': kütüphane bulunamadı

fatal error: DHT.h: No such file or directory ve hemen ardından gelen compilation terminated. satırları, kodundaki bir #include satırının istediği dosyanın bilgisayarda bulunamadığını söyler. "fatal" kelimesi derlemenin o noktada tamamen durduğunu anlatır; bu yüzden bu hatayı çözmeden kodun geri kalanındaki hataları göremezsin. Sebep neredeyse her zaman kütüphanenin kurulmamış olmasıdır. İnternetten aldığın bir projeyi açtığında kodun başındaki #include satırlarını tek tek oku ve her birinin kütüphanesini Araçlar > Kütüphaneleri Yönet ekranından kur. Bağımlılıkları soran pencerede Tümünü kur seçeneğini seçmezsen ana kütüphane kurulur ama onun ihtiyaç duyduğu ikinci kütüphane eksik kalır; bu durumda mesajdaki dosya adı senin yazdığın değil, kütüphanenin içinden çağrılan bir dosya olur (örneğin Adafruit_Sensor.h). Dosya adındaki büyük-küçük harfler de önemlidir: Linux'ta dht.h ile DHT.h farklı dosyalardır. Kütüphane kurmanın üç yolu ve ZIP sorunları için Arduino Kütüphane Ekleme rehberine bakabilirsin.

'does not name a type' hatası

does not name a type, derleyicinin bir satırın başında bir veri türü (int, float, Servo, LiquidCrystal_I2C gibi) beklediğini ama yazdığın kelimeyi tanıyamadığını söyler. Üç yaygın sebebi vardır. Birincisi, kütüphanenin #include satırını unutmaktır: Servo kapak; satırı Servo.h eklenmeden derlenirse 'Servo' does not name a type hatası çıkar. İkincisi, türün adını yanlış yazmaktır: string yerine String, Int yerine int doğrudur ve derleyici çoğu zaman did you mean 'String'? diye yardım eder. Üçüncüsü ve en şaşırtıcı olanı, fonksiyonların dışına bir komut yazmaktır. Fonksiyon dışında yalnızca tanım yapılabilir: int aci = 0; geçerlidir, ama sonraki bir satırda tek başına aci = 90; yazarsan derleyici aci kelimesini bir tür sanır ve 'aci' does not name a type der. Arduino'ya özgü bir tuzak daha var: IDE, fonksiyonlarının prototiplerini otomatik olarak ilk fonksiyonun hemen önüne ekler. Kendi tanımladığın bir struct türünü döndüren bir fonksiyon yazdıysan ve struct'ı setup()'ın altında tanımladıysan prototip struct'tan önce kalır ve aynı hata çıkar. Çözüm, struct tanımlarını dosyanın en üstüne, ilk fonksiyondan önceye taşımaktır.

1#include <Servo.h>   // bu satır yoksa: 'Servo' does not name a type / without it: 'Servo' does not name a type
2
3struct Olcum {       // struct'ı ilk fonksiyondan önce tanımla / define structs before the first function
4  int ham;
5  float volt;
6};
7
8Servo kapak;         // tür adı büyük harfle başlar / the type name starts with a capital letter
9int aci = 0;         // dışarıda tanım ve ilk değer serbest / declaring with a value outside is fine
10// aci = 90;         // dışarıda tek başına atama: 'aci' does not name a type / bare assignment outside: error
11
12Olcum potOku() {
13  Olcum o;
14  o.ham = analogRead(A0);           // potansiyometre A0'da / potentiometer on A0
15  o.volt = o.ham * 5.0 / 1023.0;    // 0-1023 değerini volta çevir / convert 0-1023 to volts
16  return o;
17}
18
19void setup() {
20  Serial.begin(9600);
21  kapak.attach(9);   // servo sinyali D9 / servo signal on D9
22}
23
24void loop() {
25  Olcum o = potOku();
26  aci = map(o.ham, 0, 1023, 0, 180);   // atama fonksiyonun içinde / assignment inside a function
27  kapak.write(aci);
28  Serial.println(o.volt);
29  delay(20);
30}

'redefinition of' hatası: aynı şeyi iki kez tanımlamak

redefinition of 'void setup()' hatası, aynı isimde iki tanım olduğunu söyler; hemen altındaki note: 'void setup()' previously defined here satırı da ilk tanımın yerini gösterir. Yeni başlayanlarda bunun en sık sebebi iki örnek kodu tek dosyaya art arda yapıştırmaktır: ortaya iki setup() ve iki loop() çıkar. İkinci sebep sekmelerdir. Arduino IDE, taslak klasöründeki bütün .ino dosyalarını derlemeden önce tek bir dosyada birleştirir. Klasöre kopyaladığın eski bir yedek (örneğin proje_eski.ino) ya da kendi setup() ve loop() fonksiyonlarını içeren ikinci bir sekme, sen o sekmeyi hiç açmasan bile bu hatayı verir; çözüm o dosyayı klasörden çıkarmaktır. Aynı değişkeni iki kez tanımlamak da benzer bir mesaj üretir: redefinition of 'int led'. Bu hatanın bağlayıcıdaki kardeşi multiple definition of mesajıdır; bir başlık (.h) dosyasında değer atanmış bir değişken iki ayrı .cpp dosyasına eklendiğinde çıkar. Tersi olan undefined reference to ise prototipini yazdığın ama gövdesini hiç yazmadığın ya da adını farklı yazdığın bir fonksiyonu işaret eder.

1// İki örneği birleştirmek: tek setup(), tek loop() / Merging two sketches: one setup(), one loop()
2const int LED_PIN = 13;          // 1. örnek: Blink / sketch 1: Blink
3const int POT_PIN = A0;          // 2. örnek: potansiyometre / sketch 2: potentiometer
4unsigned long oncekiZaman = 0;   // millis() zamanlayıcısı / millis() timer
5bool ledDurum = false;
6
7void setup() {
8  pinMode(LED_PIN, OUTPUT);      // 1. örneğin setup içeriği / setup body of sketch 1
9  Serial.begin(9600);            // 2. örneğin setup içeriği / setup body of sketch 2
10}
11
12void loop() {
13  // 1. örnek: delay yerine millis ile yanıp sönme / sketch 1: blink with millis instead of delay
14  if (millis() - oncekiZaman >= 500) {
15    oncekiZaman = millis();
16    ledDurum = !ledDurum;
17    digitalWrite(LED_PIN, ledDurum);
18  }
19  // 2. örnek: potansiyometreyi oku ve yaz / sketch 2: read and print the potentiometer
20  int deger = analogRead(POT_PIN);   // 0-1023 arası / between 0 and 1023
21  Serial.println(deger);
22  delay(50);
23}

Birleştirirken şu sırayı izle: önce iki koddaki #include satırlarını tekrarsız olarak en üste topla, sonra global değişkenleri ve sabitleri ekle; aynı isim iki kodda da varsa birini yeniden adlandır. Ardından iki setup() fonksiyonunun içini tek bir setup()'a, iki loop()'un içini de tek bir loop()'a yerleştir. Kodlardan biri uzun delay() kullanıyorsa diğerini bekletir; bunu delay() yerine millis() ile zamanlama yöntemiyle çözebilirsin. Son olarak iki kodun aynı pini kullanıp kullanmadığını kontrol et: derleyici bunu fark etmez ama devren beklediğin gibi çalışmaz.

'Sketch too big' ve bellek yetersiz hataları

Her başarılı derlemenin sonunda iki satır görürsün. Yukarıdaki kapsam örneğini Uno için derlediğinde Sketch uses 2212 bytes (6%) of program storage space. Maximum is 32256 bytes. satırı programın flaş bellekte ne kadar yer kapladığını, Global variables use 190 bytes (9%) of dynamic memory satırı da global değişkenlerin RAM'in ne kadarını kullandığını söyler. Program flaşa sığmazsa yüzde 100'ü geçer, ardından Sketch too big uyarısı ve text section exceeds available space in board hatası gelir. Global değişkenler RAM'e sığmazsa bu kez Not enough memory ve data section exceeds available space in board görürsün. RAM kullanımı yüzde 75'i geçtiğinde IDE Low memory available, stability problems may occur. uyarısını verebilir: kod derlenir ama çalışırken yerel değişkenlere yer kalmadığı için kart rastgele donabilir ya da kendi kendine yeniden başlayabilir. Uno'da 32 KB flaşın 0,5 KB'ını bootloader kullandığı için üst sınır 32256 bayttır.

1// RAM tasarrufu: F() ve PROGMEM / Saving RAM: F() and PROGMEM
2const char mesaj[] PROGMEM = "Bu uzun metin RAM yerine flasta durur";   // flaşta saklanır / stored in flash
3const byte notalar[] PROGMEM = {60, 62, 64, 65, 67, 69, 71, 72};      // byte: int'in yarısı / byte: half of an int
4
5void setup() {
6  Serial.begin(9600);
7  Serial.println(F("Merhaba! Bu metin de flastan okunur"));   // F(): RAM harcamaz / F(): uses no RAM
8  char tampon[48];                                            // geçici RAM tamponu / temporary RAM buffer
9  strcpy_P(tampon, mesaj);                                    // flaştan RAM'e kopyala / copy from flash to RAM
10  Serial.println(tampon);
11  for (byte i = 0; i < sizeof(notalar); i++) {
12    Serial.print(pgm_read_byte(&notalar[i]));                 // flaştan bir bayt oku / read one byte from flash
13    Serial.print(' ');
14  }
15  Serial.println();
16}
17
18void loop() {
19}

• Sabit metinleri F() içine al: Serial.println(F("Sistem hazir")); metni RAM'e kopyalamadan doğrudan flaştan okur. LCD ve OLED ekranlara yazdırılan sabit metinler için de aynısı geçerlidir.
• Büyük dizileri PROGMEM'e taşı: Nota tabloları, ekran bitmap'leri ve uzun metinler değişmiyorsa RAM'de durmalarına gerek yoktur. Ayrıntılı teknikler için Arduino bellek yetersiz yazısına bak.
• Doğru veri türünü seç: 0 ile 255 arasındaki bir değer için byte (1 bayt) yeterlidir; int Uno'da 2, long ve float 4 bayt yer kaplar.
• String sınıfını azalt: Sürekli birleştirilen String nesneleri RAM'i parçalar; sabit uzunlukta char dizileri daha öngörülebilirdir.
• Ekran kütüphanelerinin gizli ihtiyacını bil: Adafruit SSD1306, 128×64 OLED ekran için 1 KB'lık tamponu çalışma anında ayırır. Bu bellek derleme raporunda görünmez; rapor yüzde 70 dese bile ekran açılmayabilir.
• Daha büyük bir karta geç: Uno'ya sığdıramadığın bir proje Mega'da ya da ESP32'de rahatça çalışır. ESP32'de Araçlar > Partition Scheme menüsünden Huge APP (3MB No OTA/1MB SPIFFS) seçerek program alanını 1,25 MB'tan 3 MB'a çıkarabilirsin; bu seçenekte kablosuz güncelleme (OTA) kullanılamaz.

Yanlış kart seçimiyle gelen hatalar

Derleyici kodunu her zaman Araçlar > Kart menüsünde (IDE 2'de üstteki kart seçicide) seçili kartın işlemcisi için derler. Aynı kod Mega için hatasız derlenirken Uno seçiliyken hata verebilir, çünkü her kartın donanımı, pin adları ve kart paketiyle gelen kütüphaneleri farklıdır. İnternetten bulduğun bir projeyi açtığında önce hangi kart için yazıldığına bak: ESP32 için yazılmış bir kod Uno seçiliyken, Uno için yazılmış ve işlemcinin yazmaçlarına doğrudan erişen bir kod da ESP32 seçiliyken derlenmez. Kartını listede hiç göremiyorsan kart paketi kurulu değildir; ESP32 ve Raspberry Pi Pico paketlerini Kart Yöneticisi'nden kurman gerekir. Adımlar için Arduino IDE kurulumu rehberine bakabilirsin.

ESP32'de derleme hataları

ESP32 de Arduino diliyle programlanır, ama derleyicisi ve kart paketi farklı olduğu için Uno'da hatasız derlenen bir kod ESP32'de takılabilir. En sık karşılaşılan sebep paket sürümüdür: ESP32 Arduino paketinin 3.x sürümünde PWM fonksiyonları değişti; ledcSetup() ve ledcAttachPin() kaldırıldı, yerlerine kanal numarası yerine pin numarasıyla çalışan ledcAttach() ve ledcWrite() geldi. İnternetteki eski örnekler bu yüzden 'ledcSetup' was not declared in this scope hatası verir; ya kodu yeni fonksiyonlara çevirirsin ya da Kart Yöneticisi'nden 2.0.17 sürümünü kurarsın. İkinci fark derleyici ayarlarıdır. Uno'nun paketi kodu -fpermissive seçeneğiyle derler ve bazı hataları yalnızca uyarıya çevirir; ESP32'de bu seçenek yoktur. Örneğin switch içinde süslü parantez kullanmadan değişken tanımlamak Uno'da derlenirken ESP32'de jump to case label hatası verir. Güncel ESP32 paketleri ayrıca -Werror=return-type ile derler: değer döndürmesi gereken bir fonksiyonda return unutulursa, Derleyici uyarıları ayarı Hiçbiri dışında bir seviyedeyken no return statement in function returning non-void hatası alırsın. 2.x sürümünde ise Derleyici uyarıları Daha fazla ya da Tümü yapıldığında uyarıların çoğu hataya dönüşür. Kartın temel ayarları için ESP32 nedir yazısına göz atabilirsin.

1// ESP32 Arduino paketi 3.x / ESP32 Arduino core 3.x
2const int LED_PIN = 2;        // birçok DevKit kartında dahili LED / onboard LED on many DevKit boards
3const int FREKANS = 5000;     // PWM frekansı 5 kHz / PWM frequency 5 kHz
4const int COZUNURLUK = 8;     // 8 bit: 0-255 arası / 8 bits: range 0-255
5
6int parlaklik(int adim) {
7  return (adim % 32) * 8;     // return unutulursa 3.x'te derleme hatası olabilir / a missing return can fail to compile on 3.x
8}
9
10void setup() {
11  Serial.begin(115200);
12  // eski 2.x kodu / old 2.x code: ledcSetup(0, FREKANS, COZUNURLUK); ledcAttachPin(LED_PIN, 0);
13  ledcAttach(LED_PIN, FREKANS, COZUNURLUK);   // 3.x: kanal otomatik seçilir / channel is picked automatically
14}
15
16void loop() {
17  for (int adim = 0; adim < 32; adim++) {
18    ledcWrite(LED_PIN, parlaklik(adim));      // 3.x: pin numarasıyla yaz / write using the pin number
19    delay(30);
20  }
21  if (Serial.available()) {
22    switch (Serial.read()) {
23      case 'h': {                             // case içinde değişken varsa süslü parantez şart / braces needed if a case declares a variable
24        int deger = ledcRead(LED_PIN);
25        Serial.println(deger);
26        break;
27      }
28      default:
29        break;
30    }
31  }
32}

Raspberry Pi Pico: Arduino IDE ve MicroPython hataları

Pico'yu Arduino IDE ile, yani Earle Philhower'ın arduino-pico paketiyle programlıyorsan derleyici yine GCC'dir ve bu yazıdaki bütün mesajlar aynen geçerlidir. MicroPython'da ise durum farklıdır: kodun önceden bir derleme adımı yoktur; Pico dosyayı açılışta bayt koduna çevirir ve satır satır çalıştırır. Bu yüzden hatalar Thonny'nin alt kısmındaki Shell (Kabuk) penceresinde, Traceback (most recent call last): ile başlayan bir mesajla ortaya çıkar. Bu mesajı sondan başa doğru oku: en alttaki satır hatanın türünü ve açıklamasını, onun üstündeki line 7 gibi ifade de hatanın satırını söyler. Söz dizimi hataları (SyntaxError, IndentationError) program hiç başlamadan bildirilir; diğer hatalar ise program o satıra geldiği anda ortaya çıkar, yani kodun bir süre sorunsuz çalışıp sonra durması mümkündür. MicroPython kurulumu ve ilk adımlar için Raspberry Pi Pico nedir yazısına bakabilirsin.

1from machine import Pin
2import time
3
4led = Pin("LED", Pin.OUT)     # Pico ve Pico W dahili LED / onboard LED on Pico and Pico W
5sayac = 0
6
7while True:                   # iki nokta unutulursa SyntaxError / a missing colon gives SyntaxError
8    led.toggle()              # blok içinde 4 boşluk girinti / 4-space indent inside the block
9    sayac += 1
10    print("Sayac:", sayac)    # "Sayac: " + sayac yazmak TypeError verir / "Sayac: " + sayac raises TypeError
11    time.sleep(0.5)

Arduino derleme hataları ve çözümleri tablosu

Hatasız kod yazmak için sonraki adımlar

• Temelleri sağlamlaştır: Arduino programlama temelleri yazısı değişkenleri, kapsamı, fonksiyonları ve döngüleri anlatıyor; bu yazıdaki hataların çoğu bu konulardan doğar.
• Komutların doğru yazımını öğren: Arduino komutları listesi her komutun söz dizimini ve parametrelerini örneklerle gösteriyor.
• Kütüphaneleri doğru kur: Arduino kütüphane ekleme rehberi No such file or directory ve Multiple libraries were found mesajlarını ayrıntılı ele alıyor.
• Kodun çalışırken ne yaptığını gör: Derlenen ama beklediğin gibi çalışmayan kodlarda değişkenleri Seri Monitör ile ekrana yazdırmak en hızlı teşhis yoludur.
• Kartı bağlamadan dene: Wokwi ya da Tinkercad simülatörlerinde kodunu derleyip devreyle birlikte çalıştırabilirsin.
• Yapay zekâyla yazılan kodu kontrol et: Sohbet botlarının ürettiği kodlar sık sık eski kütüphane sürümlerine ya da başka bir karta göre yazılmış olur; yapay zekâ ile Arduino kodu yazısı bunları nasıl yakalayacağını anlatıyor.

Derleme hataları ilk bakışta korkutucu görünse de derleyici aslında sana sorunun yerini ve çoğu zaman çözümünü söyler: dosya, satır, sütun ve kısa bir açıklama. İlk hatayı oku, yalnızca onu düzelt, yeniden derle ve bu döngüyü tekrarla; birkaç projeden sonra hataları saniyeler içinde çözdüğünü göreceksin. Kodun derlenip karta yüklendiğinde BlueGrays uygulamasındaki LED, buton, sensör ve ekran projeleriyle devam edebilirsin: Arduino, ESP32 ve Raspberry Pi Pico için her projede devre şeması ve hatasız derlenen kod adım adım hazır.