Arduino "avrdude: stk500_getsync(): not in sync" Hatası Nasıl Çözülür?

Arduino IDE kodu başarıyla derlediği hâlde karta yükleme yapılamıyorsa sorun çoğunlukla kaynak kodunda değil, bilgisayar ile kart arasındaki iletişim aşamasındadır. Seçili kart veya port, veri aktarabilen USB bağlantısı, seri portu kullanan başka bir uygulama, kart ailesine uygun işlemci seçimi ya da bootloader iletişimi kontrol edilmelidir.

Derleme, yazdığın kodun makine tarafından işlenebilir bir programa dönüştürülüp dönüştürülemeyeceğini kontrol eder. Karta yükleme ise hazırlanan programın USB ve seri iletişim üzerinden karta aktarılmasını gerektirir. Bu nedenle derleme başarılı olsa bile yükleme sırasında ayrı bir hata oluşabilir.

Derleme tamamlandığı hâlde neden karta yükleme başarısız olur?

Derleyicinin başarılı olması, yalnızca kodun sözdizimi ve seçili platform açısından işlenebildiğini gösterir. Yükleme sırasında Arduino IDE, seçilen kartın iletişim yöntemini kullanarak karta ulaşmaya ve programı aktarım için hazır olan bölüme göndermeye çalışır. Seçili port karta ait değilse, USB kablosu yalnızca güç iletiyorsa veya seri port başka bir uygulama tarafından kullanılıyorsa bu iletişim kurulamayabilir.

Bu hata özellikle avrdude kullanan yükleme akışlarında görülür. Arduino'nun resmî avrdude yükleme rehberinde kart ve port seçimi, USB bağlantısı, portu kullanan uygulamalar ve kart üzerindeki bazı bağlantılar temel kontrol noktaları olarak ele alınır. Kart ailesine ve kullanılan yükleme aracına göre aynı durum farklı hata metinleriyle de gösterilebilir.

Hata mesajı ve numaralı teşhis ağacı

avrdude: stk500_getsync(): not in sync

Bu satırı tek başına kaynak kodunun hatalı olduğuna dair bir kanıt olarak yorumlama. Aşağıdaki teşhis ağacı, donanım bağlantısını, IDE ayarlarını ve seri iletişim katmanını birbirinden ayırarak ilerlemeni sağlar. Arduino IDE sürümüne ve karta göre menü adları veya görünen seçenekler değişebilir.

1. Doğru kart ve port seçili mi? IDE içindeki kart seçiminde kullandığın karta uygun seçenek, port seçiminde ise karta ait bağlantı seçili olmalıdır. Kartı çıkarıp yeniden taktığında listede değişen portu gözlemleyebilirsin. Yükleme başarılı olursa sorun büyük olasılıkla önceki kart veya port seçimindedir. Port görünmüyorsa bağlantı, sürücü veya USB tanıma ihtimali güçlenir.
2. USB kablosu veri aktarabiliyor mu? Kartın güç LED'inin yanması, kablonun veri taşıdığını tek başına göstermez. Farklı bir veri kablosu, doğrudan bilgisayar bağlantısı veya başka bir USB portu dene. Sonuç değişirse kablo, port ya da USB bağlantı yolu elenen değil, güçlenen olasılıktır.
3. Seri portu kullanan başka bir uygulama açık mı? Serial Monitor, başka bir Arduino IDE penceresi veya portu izleyen bir uygulama açıksa bunları kapatıp tekrar yükle. Yükleme bundan sonra çalışırsa koddan çok portun meşgul olması etkendir.
4. İşlemci veya bootloader seçimi doğru mu? Kullandığın kart ailesinde bu seçenekler sunuluyorsa kartına uygun işlemci ve bootloader seçimini kontrol et. Seçenek görünmüyorsa rastgele bir ayar değiştirme. Yanlış seçim, IDE'nin karta uygun olmayan iletişim biçimini kullanmasına yol açabilir.
5. Aynı Blink koduyla kontrollü yükleme yapılabiliyor mu? File > Examples > 01.Basics > Blink örneğini açıp yüklemeyi dene. Kart destekliyorsa yerleşik LED'in düzenli aralıklarla yanıp sönmesi beklenir.

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(1000);
  digitalWrite(LED_BUILTIN, LOW);
  delay(1000);
}

Blink de yüklenemiyorsa sorun kaynak kodundan çok kart, port, USB bağlantısı veya yükleme ayarlarıyla ilgilidir. Blink yükleniyor, kendi kodun yüklenmiyorsa derleme sonrası oluşan başka bir ayarı ya da kodun çalışma davranışını ayrıca incelemek gerekir.

Kart, port ve USB bağlantısını kontrol et

Bu aşamada fiziksel bağlantıyı, IDE içindeki kart ve port seçiminden ayrı değerlendirmek gerekir. Kart seçimi, IDE'nin yükleme sırasında hangi iletişim yöntemini kullanacağını belirler; port seçimi ise bilgisayarın bağlı cihaza atadığı bağlantıyı belirtir. Arduino IDE'de kart ailesini ve portu ayrı ayrı seçebilirsin. Arduino’nun kart ve port seçimi rehberi, bu iki ayarın birbirinden farklı görevleri olduğunu açıklar.

1. Kartın fiziksel olarak bağlı olduğunu kontrol et: USB kablosunu hem karta hem bilgisayara tam oturt. Kart üzerindeki güç göstergelerinin davranışı, bağlantı hakkında ilk ipucunu verebilir. Beklenen sonuç, kartın bilgisayardan güç almasıdır. Hiçbir belirti yoksa kablo, USB girişi veya kartın fiziksel bağlantısı yeniden incelenmelidir.
2. Veri aktarımı destekleyen bir USB kablosu dene: Bazı kablolar yalnızca şarj için üretilir ve bilgisayarla veri iletişimi kurmaz. Farklı, veri aktarımı desteklediğinden emin olduğun bir kabloyla tekrar dene. Beklenen sonuç, işletim sisteminde yeni bir aygıtın veya IDE'de yeni bir portun görünmesidir. Port görünürse önceki kablonun olası etkisi güçlenir.
3. USB çoklayıcısını aradan çıkar: Kartı mümkünse doğrudan bilgisayarın USB girişine bağla. Ardından farklı bir USB girişinde aynı kontrolü yap. Beklenen sonuç, kart takıldığında port listesinin güncellenmesidir. Çoklayıcıyı kaldırınca port görünüyorsa sorun karttan çok ara bağlantıyla ilişkili olabilir.
4. Kart ailesini seç: IDE'deki kart seçiminin elindeki kartla eşleştiğini doğrula. Beklenen sonuç, derleme ve yükleme ayarlarının seçilen kart için hazırlanmasıdır. Yanlış kart seçimi, port doğru olsa bile yükleme iletişimini etkileyebilir.
5. Doğru portu seç: Kartı çıkarırken kaybolan, yeniden taktığında görünen portu not al ve IDE'de onu seç. Beklenen sonuç, seçilen portun fiziksel olarak bağlı karta karşılık gelmesidir. Kart hiç görünmüyorsa fiziksel bağlantı veya sürücü tarafı incelenmelidir.

Sürücülerin ve aygıtın işletim sisteminde nasıl göründüğünün, kartın USB arayüzüne ve kullanılan işletim sistemine göre değişebileceğini unutma. Bu nedenle port görünmüyorsa işletim sisteminin aygıt yöneticisi ya da USB aygıt listesi üzerinden kartın algılanıp algılanmadığını kontrol etmek anlamlıdır.

Seri portu kullanan uygulamaları ve IDE ayarlarını incele

Doğru kart ve port seçilmiş olsa bile seri port başka bir uygulama tarafından kullanılıyorsa yükleme başlayamayabilir. Bu durum, yanlış port seçimiyle aynı şey değildir: yanlış portta IDE başka bir cihaza ulaşmaya çalışır; meşgul portta ise doğru cihaza ait bağlantı başka bir işlem tarafından tutulur.

1. Seri Monitör'ü kapat: Arduino IDE içindeki Seri Monitör açık ise kapatıp yeniden yüklemeyi dene. Ayrıca açık kalmış başka bir IDE penceresi varsa onu da kapat. Beklenen sonuç, portun yükleme işlemi için serbest kalmasıdır.
2. Diğer seri araçları kapat: Seri terminal, port izleme aracı veya karta erişebilen geliştirme yazılımlarını tamamen kapat. Beklenen sonuç, yüklemenin port erişimi hatası olmadan başlayabilmesidir. Sorun düzelirse hata, karttan değil portu kullanan uygulamadan kaynaklanmış olabilir.
3. IDE'yi yeniden başlat ve port listesini karşılaştır: Kart takılıyken görünen portu not al, kartı çıkarınca hangi portun kaybolduğunu gözlemle, ardından kartı yeniden bağlayıp aynı portu seç. Beklenen sonuç, seçilen portun kartın bağlanma ve ayrılma davranışıyla eşleşmesidir.

IDE sürümü, işletim sistemi ve kartın USB arayüzüne göre port adları ile menülerin görünümü değişebilir. Ancak Arduino’nun hata rehberi, doğru portun seçilmesini ve portu engelleyebilecek diğer IDE örnekleri, seri monitörler ya da yazılımların kapatılmasını önerir. Arduino’nun avrdude yükleme hataları rehberi bu ayrımı kontrol etmek için kullanılabilir.

İşlemci ve bootloader seçimi hangi kartlarda kontrol edilir?

İşlemci veya bootloader seçimi, tüm Arduino kartları için ortak bir çözüm değildir. Bu seçenekler yalnızca seçtiğin kart tanımında IDE tarafından sunuluyorsa kontrol edilmelidir. Örneğin Arduino’nun resmî yardımında klasik Nano için ek işlemci seçeneklerinin bulunduğu ve yanlış seçim yapıldığında IDE’nin kartın bootloader’ıyla iletişim kuramayabileceği belirtilir.

Önce kartın doğru modelini seçtiğinden emin ol. Ardından IDE’de Araçlar > Kart menüsünü aç. Seçtiğin kart için İşlemci veya benzer bir alt menü görünüyorsa, kart üzerindeki işlemciyle IDE’deki seçimin eşleşip eşleşmediğini kartın resmî belgelerinden kontrol et. İlgili menü görünmüyorsa rastgele bir işlemci ya da bootloader seçmeye çalışma. Böyle bir menünün bulunmaması, seçtiğin kart tanımında bu ayarın kullanıcı tarafından değiştirilmesinin beklenmediğini gösterebilir.

Seçenek sunulan kartlarda uygun işlemci veya bootloader seçeneğini belirledikten sonra Blink kodunu yeniden yüklemeyi dene. Yükleme bu kez başlarsa sorun büyük olasılıkla IDE yapılandırmasındadır. Hata aynı şekilde devam ederse işlemci seçimini tekrar tekrar değiştirmek yerine USB kablosu, port, sürücü ve kartın seri iletişimi gibi önceki teşhis adımlarına dön. Arduino IDE’de kart seçimi, derleme sırasında kullanılacak kart tanımını ve yükleme iletişim yöntemini etkiler.

Blink koduyla yüklemeyi test et ve kontrollü tekrar yap

Hatanın belirli bir projeden kaynaklanıp kaynaklanmadığını anlamak için kısa bir Blink kodu kullanabilirsin. Aşağıdaki örnek, kartın yerleşik LED tanımını kullanır:

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(1000);

  digitalWrite(LED_BUILTIN, LOW);
  delay(1000);
}

Bu kodun derlenmesi yalnızca sözdiziminin ve seçili kart tanımının uygun olduğunu gösterir. Derleme başarılı olsa bile kodun karta aktarılması için doğru portun, USB bağlantısının ve kartla iletişim ayarlarının da çalışması gerekir. Arduino’nun yerleşik Blink örneği temel örnekler arasında yer alır.

Yükleme tamamlandıktan sonra kart üzerindeki yerleşik LED’in düzenli aralıklarla yanıp sönmesi beklenir. Ancak LED_BUILTIN tanımının bağlı olduğu pin ve yerleşik LED’in fiziksel davranışı kart ailesine göre değişebilir. Bu nedenle seçtiğin kartın resmî pinout belgesinde yerleşik LED bilgisini kontrol et. Örneğin resmî pinout belgelerinde farklı kartlar için yerleşik LED bağlantıları ayrı ayrı gösterilir.

Blink yüklenmezse her denemede yalnızca bir değişkeni değiştirerek ilerle:

1. IDE’yi ve kartı yeniden başlat: IDE’yi kapatıp aç ve kartın USB bağlantısını yenile. Yükleme başlarsa geçici IDE veya bağlantı durumu elenmiş olur.
2. Farklı bir veri kablosu dene: Yeni kabloyla port görünür ve yükleme başlarsa önceki kabloyla ilgili olasılık güçlenir.
3. Farklı bir USB portu kullan: Kart başka bir USB portunda tanınırsa bilgisayardaki port veya bağlantı yolu incelenmelidir.
4. Aynı kartı ve kabloyu farklı bir bilgisayarda dene: Yükleme orada çalışırsa sorun karttan çok ilk bilgisayarın IDE, sürücü veya port yapılandırmasında olabilir.

Her denemeden sonra hata mesajının değişip değişmediğine bak. Sonuç değişmiyorsa bu, yaptığın değişikliğin ilgili olasılığı elemediğini gösterir. Bu yöntem bütün kartlar için kesin çözüm vaat etmez, fakat sorunun koddan mı, IDE ayarlarından mı, USB bağlantısından mı yoksa kart iletişiminden mi kaynaklandığını daha kontrollü biçimde ayırmana yardımcı olur.

Sık Sorulan Sorular

Kod derlendiği hâlde Arduino karta neden yüklenmez?

Derleme, kodun bilgisayar tarafından seçilen kart tanımına göre hazırlanabildiğini gösterir. Karta yükleme ise ayrıca doğru kart, port, USB veri bağlantısı ve uygun iletişim ayarları gerektirir. Bu katmanlardan biri eşleşmezse derleme başarılı olsa bile yükleme başarısız olabilir.

USB kablosunun veri aktarabildiği nasıl anlaşılır?

Kartı bağladığında IDE’nin port listesinde yeni bir port görünmesi pratik bir işarettir. Yalnızca güç LED’inin yanması yeterli kanıt değildir; bu durum kartın enerji aldığını, veri iletişiminin kesin olarak çalıştığını göstermez.

Arduino IDE’de doğru port görünmüyorsa hangi kontroller yapılmalı?

Kartı doğrudan bilgisayara bağla, USB hub kullanıyorsan devreden çıkar, farklı bir USB portu ve veri kablosu dene. Kartın güç aldığını kontrol et ve destekliyorsa reset düğmesine iki kez basarak bootloader modunu dene. Bazı kartlarda bu işlem portun yeniden görünmesini sağlayabilir.

İşlemci ve bootloader seçeneği ne zaman değiştirilmelidir?

Yalnızca seçtiğin kart için IDE’de böyle bir seçenek bulunuyorsa ve kartın resmî belgeleri farklı bir seçim gerektiğini gösteriyorsa değiştirilmelidir. Menü yoksa rastgele seçim yapma. Doğru seçimden sonra yükleme başlarsa sorun yapılandırmadadır; sonuç değişmiyorsa USB, port veya kart iletişimini incelemeye dön.

avrdude: stk500_getsync(): not in sync hatasını çözerken her adımı tek tek denemek, hangi katmanda sorun olduğunu anlamayı kolaylaştırır. Derleme ile yüklemenin farklı aşamalar olduğunu hatırlayarak kart, port, kablo ve IDE ayarlarını ayrı ayrı kontrol edebilirsin.