Arduino Kod Yüklenmiyor: avrdude, Port ve Sürücü Hatası Çözümü

Arduino'ya kod yüklenmiyor ve çıktı penceresinde kırmızı bir avrdude hatası mı görüyorsun? Endişelenme: bu sorunların neredeyse tamamı kartın bozuk olmasından değil; yalnızca şarj eden bir USB kablosundan, eksik CH340 sürücüsünden, yanlış seçilmiş kart ya da porttan, pin 0 ve 1'e bağlı bir modülden veya portu meşgul eden başka bir programdan kaynaklanır. Doğru sırayla kontrol edersen çoğu durumda birkaç dakikada çözersin; kart gerçekten arızalıysa bile bunu kesin olarak anlamanın basit bir yolu vardır.

Bu rehberde önce yükleme sırasında arka planda neler olduğunu ve hata mesajının nasıl okunacağını göreceksin. Ardından belirti, sebep ve çözüm sütunlarından oluşan bir teşhis tablosuyla sorunu adım adım daraltacağız. Arduino Nano'daki ATmega328P (Old Bootloader) ayarını, Seri Monitör ve başka programların portu kilitlemesini, ESP32'deki Failed to connect hatasını ve BOOT tuşunu, Raspberry Pi Pico'daki BOOTSEL ve UF2 yöntemini de ayrı başlıklarda ele alıyoruz. Her bölümde, sorunu çözdükten sonra kartını denemen için kısa test kodları var.

Kod yükleme nasıl çalışır: derleme hatası mı, yükleme hatası mı?

Yükle düğmesine bastığında iki ayrı iş olur. Önce IDE kodunu derler; bu aşama başarılı olursa çıktı penceresinde taslağın kaç bayt yer kapladığını söyleyen bir satır görürsün (İngilizce arayüzde Sketch uses 924 bytes). Ardından avrdude adlı program seçtiğin portu açar, kartı DTR sinyaliyle yeniden başlatır ve kartın içindeki küçük yükleyici programla, yani bootloader ile el sıkışır. Bootloader resetten sonra yalnızca yaklaşık bir saniye dinler; bu sürede veri gelmezse kartta duran eski program çalışmaya devam eder. Zincirin hangi halkasının koptuğu hata mesajından anlaşılır. Kırmızı yazı derleme sırasında çıkıyorsa sorun kodundadır, kartla ya da kabloyla ilgisi yoktur.

En sık görülen avrdude hataları ve anlamları

Adım adım teşhis tablosu: belirti, sebep, çözüm

Tabloyu yukarıdan aşağıya doğru oku; ilk satırlar en sık görülen ve en kolay çözülen sorunlardır. Her değişiklikten sonra yüklemeyi yeniden dene. Birden fazla şeyi aynı anda değiştirirsen sorunu hangisinin çözdüğünü öğrenemezsin ve aynı hata bir dahaki sefere yine seni şaşırtır.

Hızlı kontrol listesi ve yükleme test kodu

1. Kartın üzerindeki her şeyi sök: shield, modüller ve pin 0 ile 1'deki kablolar. Yalnızca USB kablosu takılı kalsın.
2. Kartı doğrudan bilgisayarın arkasındaki bir USB portuna tak; hub, uzatma kablosu ve kasanın ön panelindeki girişlerden kaçın.
3. Araçlar > Port menüsünü aç ve listeye bak. Kartı çıkarıp yeniden tak, hangi portun kaybolup geri geldiğini not et. Liste hiç değişmiyorsa sorun kablo ya da sürücüdedir.
4. Araçlar > Kart menüsünden kartının tam modelini seç; Nano kullanıyorsan Araçlar > Processor altından doğru bootloader'ı da seç.
5. Portu başka bir programın ya da ikinci bir IDE penceresinin kullanmadığından emin ol; şüphe varsa hepsini kapat.
6. Ayrıntılı yükleme çıktısını aç ve aşağıdaki küçük test kodunu yükle. Hatasız olduğunu bildiğin bir kodla denemek, derleme sorunlarını hesaptan çıkarır.
7. Yine olmuyorsa reset tuşuna bas: L LED'i bir ya da birkaç kez hızlıca yanıp sönüyorsa bootloader çalışıyordur. Ardından aşağıdaki loopback testine geç.
8. Başka bir bilgisayarda ya da başka bir kartla dene. Sorun kartla birlikte taşınıyorsa karttadır; bilgisayarda kalıyorsa sürücüde ya da işletim sistemi ayarlarındadır.

1// Yükleme testi: LED yanıp söner, sayaç yazılır / Upload test: blinks the LED, prints a counter
2unsigned long sayac = 0;   // çalışma sayacı / run counter
3
4void setup() {
5  pinMode(LED_BUILTIN, OUTPUT);   // Uno ve Nano'da pin 13 / pin 13 on Uno and Nano
6  Serial.begin(9600);
7  Serial.println("Yukleme basarili / Upload OK");
8}
9
10void loop() {
11  digitalWrite(LED_BUILTIN, HIGH);
12  delay(200);                     // yanma süresi: değiştirip tekrar yükle / on time: change it and re-upload
13  digitalWrite(LED_BUILTIN, LOW);
14  delay(800);
15  Serial.println(sayac++);        // Seri Monitör 9600 baud / Serial Monitor at 9600 baud
16}

Kod yüklendiyse L LED'i kısa yanıp uzun söner ve Seri Monitör'ü (Türkçe arayüzde Araçlar > Seri Port Ekranı) 9600 baud hızında açtığında sayaç artar. Yüklemenin gerçekten yeni kodu karta yazdığından emin olmak istersen delay(200) değerini delay(50) yapıp yeniden yükle: yanıp sönme ritmi değişmiyorsa kartta hâlâ eski program çalışıyordur. Seri Monitör'de anlamsız karakterler görürsen Seri Monitör'deki baud hızı ayarı koddaki değerle aynı değildir; bu bir yükleme hatası sayılmaz.

COM port görünmüyor: USB kablosu ve CH340, CP2102 sürücüsü

Port menüsü gri ya da boşsa ilk şüpheli kablodur. Telefon şarj aletlerinden çıkan birçok ince kabloda yalnızca iki güç teli bulunur; D+ ve D- veri telleri hiç yoktur. Bu kabloyla kartın güç LED'i yandığı için insan kandırılır, ama bilgisayar karşısında hiçbir cihaz görmez ve takma sesi bile çıkmaz. Kablonu bir telefonla dosya aktarmayı deneyerek ya da çalıştığını bildiğin başka bir kartla test edebilirsin. Uno'nun kalın B tipi kablosunda bu sorun daha nadirdir; Nano'nun mini USB'sinde, ESP32 ve Pico'nun mikro USB ya da USB-C kablolarında çok sık görülür.

Kablo sağlamsa ikinci şüpheli sürücüdür. USB soketinin yanındaki yonganın üzerindeki yazıyı oku: orijinal Arduino Uno ve Mega'da ATmega16U2, klon Uno ve Nano'larda çoğunlukla CH340G ya da CH340C, ESP32 geliştirme kartlarında genellikle CP2102 veya CH340 bulunur. Windows'ta Aygıt Yöneticisi'ni aç: kart doğru tanındıysa Bağlantı noktaları (COM ve LPT) başlığı altında görünür. Diğer aygıtlar altında sarı ünlemli bir USB2.0-Serial görüyorsan CH340 sürücüsü eksiktir.

Windows 10 ve 11, CH340 ile CP2102 sürücülerini çoğu zaman Windows Update üzerinden kendisi kurar. Kurmazsa yonga üreticisinin sitesinden CH340 için CH341SER, CP2102 için CP210x VCP sürücüsünü indirip kur, ardından kartı çıkarıp yeniden tak. macOS'un güncel sürümlerinde bu iki yonganın sürücüsü yerleşiktir; farklı kaynaklardan eski sürücüleri üst üste kurmak çoğu zaman sorunu büyütür. Linux'ta sürücüler çekirdekte hazırdır, ancak portu kullanabilmek için kullanıcını dialout grubuna eklemen (sudo usermod -a -G dialout $USER) ve oturumu kapatıp açman gerekir; yoksa Permission denied hatası alırsın. Ubuntu 22.04 ve sonrasında CH340'lı kart takılır takılmaz port kayboluyorsa suçlu genellikle ekran okuyucu paketi brltty'dir; kullanmıyorsan sudo apt remove brltty ile kaldır.

Yanlış kart, işlemci ya da port seçimi

Arduino IDE 2'de kart ve port, üst çubuktaki açılır listeden ya da Araçlar > Kart ve Araçlar > Port menülerinden seçilir. Windows'ta listede COM1 ya da Bluetooth'a ait birkaç sanal port görebilirsin; doğru olanı bulmanın en kolay yolu kartı çıkarıp hangi portun kaybolduğuna bakmaktır. Kart menüsünde Uno yerine Mega ya da Nano yerine Leonardo gibi yanlış bir model seçilirse avrdude ya hiç cevap alamaz ya da Device signature satırında beklemediği bir yonga kimliği görür. Bir de şuna dikkat et: normal yükleme için Ctrl+U kısayolunu kullan. Eskiz > Programlayıcı Kullanarak Yükle komutu harici bir ISP programlayıcı bekler ve başarılı olursa karttaki bootloader'ı siler; bundan sonra kart USB'den yükleme kabul etmez.

Arduino Nano kod yüklenmiyor: ATmega328P (Old Bootloader)

Piyasadaki uygun fiyatlı Nano kartların çoğu CH340 yongalı klonlardır ve bunların büyük kısmında eski bootloader yüklüdür. Arduino, 2018 başında Nano'nun bootloader'ını Uno'daki daha küçük ve hızlı Optiboot ile değiştirdi; IDE'deki varsayılan ATmega328P seçeneği o günden beri 115200 baud ile konuşur. Eski bootloader ise 57600 baud bekler. Hızlar uyuşmayınca kart hiç cevap vermiyormuş gibi görünür ve not in sync: resp=0x00 hatası on deneme boyunca tekrarlanır. Çözüm tek bir menü ayarıdır: Araçlar > Processor > ATmega328P (Old Bootloader). Bu seçenekler kartın paketinden geldiği için Arduino IDE 2'de menünün adı Türkçe arayüzde de Processor olarak görünür (eski IDE 1.8'de İşlemci). Hangisinin doğru olduğunu bilmiyorsan seçenekleri sırayla dene; yanlış seçim karta hiçbir zarar vermez.

Pin 0 ve 1'e bağlı modüller yüklemeyi engeller

Uno ve Nano'da USB-seri yonga, ATmega328P'ye D0 (RX) ve D1 (TX) pinleri üzerinden 1 kΩ'luk dirençlerle bağlıdır. Kod yüklenirken bu hat bilgisayara ayrılmıştır. HC-05 Bluetooth modülü, GPS, ESP-01 ya da parmak izi sensörü gibi seri haberleşen bir modül bu pinlere bağlıysa kendi verisini de hatta basar ya da hattı sabit bir seviyede tutar ve bootloader'ın el sıkışmasını bozar. Sonuç yine programmer is not responding ya da not in sync hatasıdır. En hızlı çözüm yükleme sırasında D0 ve D1'deki kabloları çıkarmaktır; kalıcı çözüm ise modülü SoftwareSerial ile başka pinlere taşımaktır:

1#include <SoftwareSerial.h>
2
3// HC-05 TX -> D10, HC-05 RX <- D11 (gerilim bölücüyle / through a voltage divider)
4SoftwareSerial bt(10, 11);   // RX, TX pinleri / RX, TX pins
5
6void setup() {
7  Serial.begin(9600);        // USB: Seri Monitör / USB: Serial Monitor
8  bt.begin(9600);            // HC-05 veri modu hızı / HC-05 data mode baud rate
9  Serial.println("Hazir / Ready");
10}
11
12void loop() {
13  if (bt.available()) Serial.write(bt.read());      // telefondan bilgisayara / phone to PC
14  if (Serial.available()) bt.write(Serial.read());  // bilgisayardan telefona / PC to phone
15}

Bu kodda HC-05'in TX ucu D10'a, RX ucu D11'e bağlanır. HC-05'in RX girişi 3,3 V seviyesinde çalıştığı için D11 ile arasına 1 kΩ ve 2 kΩ'luk dirençlerle bir gerilim bölücü koy. Artık modül takılıyken de kod yükleyebilir, Seri Monitör'e yazdıklarını telefona gönderebilirsin. Bağlantının tamamı ve AT komut modu için HC-05 Bluetooth Modülü yazısına bak. Mega kullanıyorsan SoftwareSerial'e gerek yok; kartta Serial1 (TX1 = D18, RX1 = D19) gibi donanımsal ek seri portlar vardır.

Seri Monitör ve portu meşgul eden programlar

Bir seri port aynı anda yalnızca tek bir program tarafından açılabilir. Windows'ta Access is denied (Türkçe sistemde Erişim engellendi), macOS ve Linux'ta Resource busy mesajı bu yüzden çıkar. Arduino IDE kendi Seri Monitör'ünü yükleme sırasında genellikle otomatik olarak duraklatır, ama bu her sürümde ve her kartta, özellikle ESP32'de, kusursuz çalışmaz; hata alıyorsan önce Seri Monitör sekmesini kapat. Sorun çoğunlukla portu başka bir yerin tutmasından çıkar: ikinci bir IDE penceresi, açık kalan Seri Çizici, PuTTY, Cura gibi 3D yazıcı programları, VS Code'daki PlatformIO monitörü ya da arka planda çalışan bir Python betiği. Bunları kapat, kartı çıkarıp tak ve yeniden dene. Linux'ta portu hangi programın tuttuğunu sudo lsof /dev/ttyUSB0 komutuyla görebilirsin.

Kart bozuk mu? Loopback testi ve bootloader yazma

Yukarıdakilerin hepsini denedin ve hâlâ yüklenmiyorsa sorunun USB tarafında mı yoksa ana işlemcide mi olduğunu ayırman gerekir. Uno ve Nano için klasik yöntem loopback (geri döngü) testidir: ana işlemciyi resette tutar, USB-seri yongayı kendi kendisiyle konuşturursun. Bu test için hiçbir kod yüklemen gerekmez.

1. Karttaki bütün kabloları sök, yalnızca USB kablosu takılı kalsın.
2. Bir jumper kabloyla RESET pinini GND'ye bağla; ATmega328P böylece resette kalır ve hatta karışmaz.
3. İkinci bir kabloyla D0 ve D1 pinlerini birbirine bağla.
4. IDE'de kartın portunu seç ve Seri Monitör'ü aç; hız ayarı bu test için önemli değildir.
5. Kutucuğa birkaç harf yazıp gönder. Yazdığın metin aynen geri geliyorsa kablo, sürücü ve USB-seri yonga sağlamdır; sorun ana işlemcide ya da bootloader'dadır. Hiçbir şey dönmüyorsa sorun USB tarafındadır.
6. Test bitince iki kabloyu da çıkarmayı unutma.

Loopback testi geçtiği hâlde yükleme olmuyorsa ve reset tuşuna bastığında L LED'i hiç hızlıca yanıp sönmüyorsa bootloader silinmiş ya da yonga değiştirilmiş olabilir. İkinci bir Uno ile bootloader'ı yeniden yazabilirsin. Programlayıcı olacak Uno'ya Dosya > Örnekler > 11.ArduinoISP > ArduinoISP kodunu yükle. Sonra programlayıcının D10 pinini hedef kartın RESET pinine, D11, D12 ve D13'ü hedefin aynı numaralı pinlerine, 5V ve GND'yi de birbirine bağla. Programlayıcı Uno'nun RESET ile GND pini arasına 10 µF'lık bir kondansatör tak; bu, onun kendi kendini resetlemesini engeller. Son olarak Araçlar > Programlayıcı > Arduino as ISP seç, Kart menüsünde hedef kartı seç ve Araçlar > Bootloader'ı Yükle komutunu çalıştır. Bu yolla klon bir Nano'ya yeni Optiboot'u da yazabilirsin.

ESP32 kod yüklenmiyor: Failed to connect ve BOOT tuşu

ESP32'de yüklemeyi avrdude değil esptool yapar. Çıktıda önce Connecting........_____..... satırı belirir; esptool bu sırada kartı indirme (download) moduna sokmaya çalışır. Başaramazsa A fatal error occurred: Failed to connect to ESP32 ile başlayan bir hata görürsün. Güncel esptool sürümlerinde kart normal modda açıldıysa mesajın devamı Wrong boot mode detected (0x13)! The chip needs to be in download mode. olur; 0x13 kartın indirme modu yerine normal açılış moduna geçtiğini gösterir. Karttan hiç cevap gelmiyorsa mesaj No serial data received ile biter; eski sürümler bu durumu Timed out waiting for packet header diye yazar. Kart kendiliğinden indirme moduna giremiyorsa bunu elle yaparsın.

1. IDE'de Yükle'ye tıkla ve çıktı penceresini izle.
2. Connecting... yazısı belirdiği anda kartın üzerindeki BOOT düğmesine basılı tut.
3. Hâlâ bağlanmazsa BOOT basılıyken EN düğmesine bir kez kısa bas ve bırak.
4. Çıktıda Writing at ile başlayan satırlar ve yükleme yüzdesi akmaya başlayınca BOOT düğmesini bırak.
5. Yükleme Hard resetting via RTS pin... satırıyla biter. Program başlamazsa EN düğmesine bir kez bas.

Peki bu neden olur? ESP32'nin indirme moduna girmesi için açılış anında GPIO0 pininin LOW olması gerekir. Geliştirme kartlarındaki iki transistörlük otomatik reset devresi bunu USB yongasının DTR ve RTS sinyalleriyle kendiliğinden yapar; ucuz kartlarda bu devre zamanlamayı kaçırabilir. Her seferinde BOOT'a basmaktan sıkıldıysan kalıcı bir çözüm var: kartın EN pini ile GND arasına 10 µF'lık bir elektrolitik kondansatör bağla (eksi bacağı GND'ye). Kondansatör EN hattının yükselmesini geciktirir ve otomatik reset devresine GPIO0'ı LOW tutması için zaman kazandırır.

1// ESP32 yükleme testi / ESP32 upload test
2const int LED_PIN = 2;   // birçok DevKit kartında dahili LED / onboard LED on many DevKit boards
3
4void setup() {
5  pinMode(LED_PIN, OUTPUT);
6  Serial.begin(115200);   // Seri Monitör 115200 baud / Serial Monitor at 115200 baud
7  delay(500);
8  Serial.print("Model: ");
9  Serial.println(ESP.getChipModel());                 // ör. ESP32-D0WD-V3 / e.g. ESP32-D0WD-V3
10  Serial.print("Flash (MB): ");
11  Serial.println(ESP.getFlashChipSize() / (1024 * 1024));
12  Serial.print("CPU (MHz): ");
13  Serial.println(getCpuFrequencyMhz());
14}
15
16void loop() {
17  digitalWrite(LED_PIN, !digitalRead(LED_PIN));   // LED'i tersle / toggle the LED
18  delay(500);
19}

Raspberry Pi Pico: BOOTSEL ve UF2 ile yükleme

Pico'da ayrı bir USB-seri yonga yoktur; RP2040'ın kendi USB birimi vardır ve önyükleyici, yonganın silinemeyen ROM belleğinde durur. Bu yüzden Pico'yu yazılımla bozmak neredeyse imkânsızdır. BOOTSEL düğmesine basılı tutarak USB kablosunu takarsan Pico bilgisayara RPI-RP2 adlı bir flaş bellek gibi görünür (Pico 2'de sürücünün adı RP2350'dir). Bu sürücüye sürükleyip bıraktığın .uf2 uzantılı dosya karta yazılır ve kart kendiliğinden yeniden başlar; MicroPython'u da bu yolla kurarsın.

Arduino IDE ile Pico programlıyorsan ilk yüklemede henüz bir COM port yoktur; kartı BOOTSEL basılı olarak tak ve Yükle'ye tıkla. İlk koddan sonra kart bir seri port açar ve sonraki yüklemelerde BOOTSEL gerekmez. Kodun çökerse ya da USB'yi kapatırsa port yine kaybolur ve No drive to deploy hatası alırsın; o zaman BOOTSEL yöntemine geri dön. MicroPython kullanıyorsan Thonny'nin sağ alt köşesinden yorumlayıcı olarak MicroPython (Raspberry Pi Pico) seçili olmalıdır. Pico'nun pinleri ve kurulumu için Raspberry Pi Pico Nedir? yazısına bakabilirsin.

1import time
2from machine import Pin
3
4time.sleep(3)   # açılışta 3 sn bekle, Thonny durdurabilsin / wait 3 s so Thonny can stop the script
5
6led = Pin("LED", Pin.OUT)   # Pico ve Pico W dahili LED / onboard LED on Pico and Pico W
7sayac = 0
8while True:
9    led.toggle()
10    print("Calisiyor / running", sayac)
11    sayac += 1
12    time.sleep(0.5)

Gözden kaçan küçük ama sinsi sebepler

• Leonardo, Micro ve Uno R4: Yerleşik USB'li bu kartlarda yükleme sırasında port kısa süreliğine değişebilir. Yükleme takılırsa Yükle'ye tıkla ve derleme bitip yükleme aşaması başladığı anda reset tuşuna bir kez bas (Uno R4'te hızlıca iki kez); kart bir süre bootloader'da bekler ve kod bu sırada yüklenir.
• Bozuk otomatik reset: Uno ya da Nano'da otomatik reset çalışmıyorsa reset tuşuna basılı tut, Yükle'ye tıkla ve çıktıda taslağın boyutunu gösteren satır belirdiği anda tuşu bırak.
• Shield ve harici devreler: Motor sürücü shield'i ya da 5V hattını zorlayan bir devre, yükleme anında besleme gerilimini düşürüp yazmayı yarıda kesebilir.
• macOS'ta yanlış port: Port listesindeki /dev/cu.Bluetooth-Incoming-Port ve /dev/cu.debug-console kart değil, sistemin kendi portlarıdır. Kartın portunun adında usbmodem, usbserial ya da wchusbserial geçer; emin değilsen kartı çıkarıp takarak hangisinin kaybolduğuna bak.
• Kullanıcı adında Türkçe karakter: Windows kullanıcı klasörünün adında ş, ğ, ı gibi harfler varsa bazı kart paketlerinde, özellikle ESP32'de, derleme ve yükleme araçları dosya bulamayabilir. Taslak klasörünü Tercihler'den Türkçe karakter içermeyen bir yola taşı; sorun sürerse yeni bir Windows kullanıcısı aç.
• Taslak çok büyük: Sketch too big uyarısı bir yükleme hatası değildir; kodun Uno'nun bootloader'dan arta kalan yaklaşık 31,5 KB'lık flaşına sığmadığını söyler. Kütüphaneleri ve uzun metinleri azalt ya da daha büyük bir karta geç.
• Uykudan sonra kilitlenen port: Bilgisayar uykudan uyandıktan sonra port takılı kalabilir; IDE'yi kapatıp açmak ya da kartı başka bir USB portuna takmak çoğu zaman yeter.

Yükleme çalıştı: şimdi ne yapabilirsin?

• İlk devre: LED ve dirençle kendi Blink devreni kur, ardından bir buton ekleyerek ilk etkileşimli projeni yap.
• Seri haberleşme: Pin 0 ve 1'in yüklemeyle ilişkisini öğrendiğine göre HC-05 Bluetooth modülü ile telefondan LED yakmayı dene.
• Sensör okumak: Arduino Sensörleri Rehberi ile sıcaklık, mesafe ve ışık ölçen ilk projelerini seç.
• Kablosuza geçmek: ESP32 ile Wi-Fi'ye bağlanan ve telefondan kontrol edilen bir proje yap; OTA özelliği sayesinde bir süre sonra kodu kablosuz olarak da yükleyebilirsin.
• Doğru kartı seçmek: Uno, Nano ve Mega arasında kararsızsan Hangi Arduino'yu Almalıyım? yazısına göz at.

Kod yükleme hataları ilk karşılaştığında can sıkıcıdır, ama her birinin mantıklı bir sebebi vardır ve hemen hepsi aynı sırayla bulunur: kablo, sürücü, port, kart ayarı, seri hat ve en son bootloader. Bu sırayı aklında tutarsan bir sonraki hatayı dakikalar içinde çözersin. Kartın kod almaya başladığında BlueGrays uygulamasında Arduino, ESP32 ve Raspberry Pi Pico için LED yakmaktan Wi-Fi ve kablosuz OTA güncellemeye kadar pek çok projeyi adım adım devre şeması ve hazır koduyla bulabilir, kartını hemen işe koşabilirsin.