Skip to Content
Arduino EğitimleriArduino IDE Kurulumu

Arduino IDE Kurulumu

Arduino IDE, kod yazdığınız, derlediğiniz ve karta yüklediğiniz programdır. Kurulumu basittir; asıl zaman kaybı genellikle port görünmemesi ve sürücü sorunlarında yaşanır. Bu yazı ikisini de kapsar.

İndirme ve Kurulum

Arduino IDE’yi resmi siteden (arduino.cc) indirin. İki sürüm bulunur:

  • IDE 2.x — güncel sürüm; otomatik tamamlama, hata ayıklayıcı ve daha iyi kütüphane yöneticisi içerir.
  • IDE 1.8.x — eski, hafif sürüm; düşük donanımlı bilgisayarlarda hâlâ tercih edilir.

Yeni başlıyorsanız 2.x sürümünü kurun.

Windows

Kurulum sihirbazını çalıştırın. Kurulum sırasında sürücü yükleme onayı çıkarsa kabul edin — bu, orijinal Arduino kartlarının USB sürücüsüdür.

macOS

İndirilen .dmg dosyasını açın ve Arduino IDE’yi Applications klasörüne sürükleyin. İlk açılışta güvenlik uyarısı çıkarsa Sistem Ayarları → Gizlilik ve Güvenlik bölümünden izin verin.

Linux

AppImage dosyasını indirip çalıştırılabilir yapın:

chmod +x arduino-ide_*.AppImage ./arduino-ide_*.AppImage

Linux’ta seri porta erişim için kullanıcınızı dialout grubuna eklemeniz gerekir:

sudo usermod -a -G dialout $USER

Ardından oturumu kapatıp açın.

Kartı Bağlama

Arduino’yu USB kablosuyla bilgisayara bağlayın. Kart üzerindeki güç LED’i (ON yazan yeşil LED) yanmalıdır.

Kullandığınız USB kablosunun veri aktarımını desteklediğinden emin olun. Bazı ucuz kablolar yalnızca şarj içindir; içlerinde veri hattı yoktur. Kart güç alır (LED yanar) ama bilgisayarda hiç görünmez. Port görünmüyorsa ilk deneyeceğiniz şey başka bir kablo olmalıdır.

Kart ve Port Seçimi

Kart seçimi

Araçlar → Kart → Arduino AVR Boards → Arduino Uno

Nano kullanıyorsanız Arduino Nano, Mega kullanıyorsanız Arduino Mega or Mega 2560 seçin.

Port seçimi

Araçlar → Port menüsünü açın.

İşletim sistemiPort görünümü
WindowsCOM3, COM4, COM5
macOS/dev/cu.usbserial-… veya /dev/cu.usbmodem…
Linux/dev/ttyUSB0 veya /dev/ttyACM0

Hangi port benim kartım? Kartı çıkarın, menüye bakın; takın, menüye tekrar bakın. Yeni beliren port sizinkidir.

CH340 Sürücü Sorunu

Port menüsü boşsa veya kart görünmüyorsa en olası neden budur.

Orijinal Arduino kartları USB dönüşümü için ATmega16u2 çipi kullanır ve işletim sistemi bunu otomatik tanır. Klon kartların çoğu ise CH340 (veya CH341) çipi kullanır ve bu çip için ayrı sürücü gerekebilir.

Nasıl anlarsınız? Kartın USB soketinin yanındaki küçük kare çipe bakın; üzerinde CH340G yazıyorsa bu sürücüye ihtiyacınız var.

Windows: Aygıt Yöneticisi’nde sarı ünlem işaretli USB-SERIAL CH340 görünür. WCH’nin resmi CH341SER sürücüsünü kurun ve kartı yeniden takın.

macOS: Yeni macOS sürümleri CH340’ı yerleşik olarak destekler. Görünmüyorsa CH34x sürücüsünü kurun ve gerekirse çekirdek uzantısına izin verin.

Linux: Sürücü çekirdekte yerleşiktir, ek kurulum gerekmez. dmesg | tail komutu kartın hangi porta bağlandığını gösterir.

Bazı kartlarda CP2102 çipi bulunur; onun için Silicon Labs sürücüsü gerekir.

Dosya → Örnekler → 01.Basics → Blink

void setup() { pinMode(LED_BUILTIN, OUTPUT); } void loop() { digitalWrite(LED_BUILTIN, HIGH); delay(1000); digitalWrite(LED_BUILTIN, LOW); delay(1000); }
  1. Sol üstteki ✓ (Doğrula) düğmesine basın. Kod derlenir; hata yoksa altta “Derleme tamamlandı” yazar.
  2. → (Yükle) düğmesine basın. Kart üzerindeki TX/RX LED’leri hızla yanıp söner.
  3. Yükleme bitince kart üzerindeki L LED’i saniyede bir yanıp sönmeye başlar.

Bu çalıştıysa kurulumunuz tamamdır.

Yükleme Hataları ve Çözümleri

avrdude: stk500_recv(): programmer is not responding

En sık görülen hatadır. Sırasıyla deneyin:

  1. Port doğru mu? Araçlar → Port menüsünden kontrol edin.
  2. Kart doğru mu? Nano seçiliyken Uno’ya yükleme yapılmaz.
  3. Nano ve bootloader: Eski Nano klonlarında Araçlar → İşlemci → ATmega328P (Old Bootloader) seçmek gerekir. Bu, Nano’da en sık karşılaşılan sorundur.
  4. Seri Monitör açık mı? Açık bir Seri Monitör portu meşgul edebilir; kapatıp deneyin.
  5. RX/TX pinlerinde bir şey bağlı mı? Pin 0 ve 1 seri haberleşme içindir. Buraya bağlı bir modül (Bluetooth, GPS) yüklemeyi engeller. Yükleme sırasında bu pinleri boşaltın.
  6. Başka program portu kullanıyor mu? Seri terminal, plotter programı vb. kapatın.
  7. Kabloyu ve USB portunu değiştirin.

Port not found / port menüsü boş

  • Veri destekli USB kablosu kullanın.
  • CH340 sürücüsünü kurun.
  • Kartın güç LED’i yanmıyorsa kart veya kablo arızalı olabilir.

Sketch too big

Kod, kartın flash belleğine sığmıyor. Kullanılmayan kütüphaneleri çıkarın veya daha büyük bellekli bir karta (Mega) geçin.

Low memory available, stability problems may occur

SRAM sınırına yaklaşıldığını gösteren bir uyarıdır. Sabit metinleri F() makrosuyla flash’ta tutun:

Serial.println(F("Bu metin SRAM tuketmiyor"));

Büyük dizileri PROGMEM ile flash belleğe taşıyın.

Permission denied: /dev/ttyUSB0 (Linux)

Kullanıcınızı dialout grubuna ekleyin ve oturumu yeniden başlatın.

Seri Monitör

Kod yüklendikten sonra kartla konuşmanın yolu Seri Monitör’dür. Sağ üstteki büyüteç simgesiyle veya Araçlar → Seri Monitör ile açılır.

Kritik ayar: Sağ alttaki baud hızı, kodunuzdaki Serial.begin() değeriyle aynı olmalıdır. Farklıysa ekranda anlamsız karakterler görürsünüz.

Serial.begin(9600); // Seri Monitor de 9600 baud olmali

Ayrıntılar için Seri Port Haberleşmesi yazısına bakın.

Kart Yöneticisi ile ESP Desteği Ekleme

ESP8266 veya ESP32 kullanacaksanız IDE’ye ek kart desteği tanıtmanız gerekir.

  1. Dosya → Tercihler menüsünü açın.
  2. Ek Kart Yöneticisi URL’leri alanına ilgili JSON adresini ekleyin:
    • ESP8266: https://arduino.esp8266.com/stable/package_esp8266com_index.json
    • ESP32: https://espressif.github.io/arduino-esp32/package_esp32_index.json
  3. Araçlar → Kart → Kart Yöneticisi’ni açın, esp8266 veya esp32 aratın ve kurun.
  4. Kurulum bittiğinde kart listesinde NodeMCU, Wemos D1 Mini, ESP32 Dev Module gibi seçenekler görünür.

Birden fazla URL eklemek isterseniz virgülle ayırın.

Özet

Arduino IDE’yi kurmak, kartı seçmek ve doğru portu bulmakla iş biter. En sık yaşanan sorun, klon kartlardaki CH340 çipi için sürücü eksikliğidir.

Bu derste şunları öğrendik:

  • IDE 2.x kurulumunu (Windows, macOS, Linux)
  • Kart ve port seçimini
  • CH340 sürücü sorununu ve çözümünü
  • Blink örneğiyle kurulumu doğrulamayı
  • programmer is not responding hatasının yedi olası nedenini
  • Seri Monitör baud hızı eşleşmesini
  • Kart Yöneticisi ile ESP8266/ESP32 desteği eklemeyi
Son güncelleme