Kodu Anla: Hazır Arduino Kodunu Adım Adım Çözmek ve Değiştirmek

Kodu anla, BlueGrays'te her proje sayfasında Kaynak Kodu bölümünde duran ve hazır Arduino kodunu adım adım açıklayan sekmedir. Kopyalayıp yüklediğin kodun ne yaptığını çözmek için sıra şöyle: önce Bu kod ne yapıyor? özetini oku, sonra Adım adım bölümündeki her kod parçasını açıklamasıyla birlikte tam kodda bul, devre beklediğin gibi çalışmazsa Takıldıysan bölümüne bak, en sonda da Kendin dene göreviyle kodda tek bir şeyi değiştirip sonucu kartta gör. Bu dört bölüm, "çalışıyor ama neden çalıştığını bilmiyorum" noktasından "bu satırı değiştirirsem ne olacağını biliyorum" noktasına geçmenin en kısa yolu.

Bu yazıda Kodu anla sekmesini baştan sona, gerçek bir projenin gerçek içeriği üzerinden anlatıyoruz: 10 numaralı Buton İle Led Yakma (On Off). Proje ücretsiz, Başlangıç seviyesinde ve blok görünümü de var; yani hem kodu hem blokları açıklayan sürümünü herkes açabilir. Sekmenin bölümlerini, kodu açıklamayla eşleştirme yöntemini, 15 dakikalık bir çalışma rutinini, Kendin dene görevlerini çözme stratejisini, hangi değişikliğin hangi kavramı öğrettiğini, Blokları anla görünümünü, Takıldıysan ile Sorun Giderme arasındaki farkı ve öğretmenler için derste kullanım fikirlerini bulacaksın.

Kodu anla sekmesi nerede, kimlere açık?

Bir projeyi açıp Kaynak Kodu bölümüne geldiğinde üstte iki sekmeli bir seçici görürsün: Kod ve Kodu anla. Kod sekmesi programın tamamını gösterir; Kopyala ve Linki Kopyala düğmeleri buradadır. Kodu anla'ya geçtiğinde aynı programın açıklamalı hâli açılır. 200+ projenin her birinde bu sekme var ve Arduino, ESP32 ve Raspberry Pi Pico projelerinde aynı düzende çalışır. Erişim kuralı basit: 60 ücretsiz projede (her platformda 20) Kodu anla herkese açık, ücretsiz bir hesapla da özeti, bütün adımları, Takıldıysan bölümünü ve Kendin dene görevini çözümüyle birlikte görürsün. Premium projelerde sekmenin yerinde "Kodun adım adım açıklaması Premium ile açılır." yazan bir kilit kartı durur. Yani bu yazıdaki yöntemi Led Yakma, Trafik Lambası, Polis Çakar ve buton projelerinde hiçbir ödeme yapmadan uygulayabilirsin.

Bölümler: hangisi ne işe yarar?

Bölümlerin sırası bilinçli: önce büyük resim, sonra parçalar, sonra hatalar, en sonda senin denemen. Kod parçaları programın tamamı değil, yalnız o adımın anlattığı satırlardır; açılan bir süslü parantezin kapanışı bir sonraki adıma kalabilir. Bu yüzden tek bir adıma bakıp geçmek yerine hepsini sırayla okumak daha verimli. İpucu görev metninin hemen altında açık durur; çözüm ise sen Çözümü göster'e dokunana kadar gizlidir. Bu düzen, çözümü görmeden önce kendin düşünmene alan bırakır.

Örnek: Buton İle Led Yakma (On Off) projesinde Kodu anla

Projede bir push buton ve bir LED var. Butonun bir ucu 5V'a, karşı ucu kartın 13 numaralı pinine bağlı; aynı pin 10 kΩ'luk bir dirençle GND'ye çekiliyor. LED'in uzun bacağı 7 numaralı pine, kısa bacağı 330 Ω'luk direnç üzerinden GND'ye gidiyor. Kodu anla'nın özeti programı şöyle anlatıyor: butona her bastığında LED'in durumu bir kez tersine döner, sönükse yanar, yanıksa söner; butonu basılı tutsan bile LED yalnız bir kez değişir ve 50 ms'lik bir bekleme buton sıçramasını yok sayar. Programın tamamı aşağıda, yorumları iki dilli.

1int ledState = 0;     // LED durumu: 0 sönük, 1 yanık / LED state: 0 = off, 1 = on
2int lastButton = 0;   // Butonun önceki okuması / Previous button reading
3
4void setup() {
5  pinMode(13, INPUT);   // Buton girişi, harici pull-down / Button input, external pull-down
6  pinMode(7, OUTPUT);   // LED çıkışı / LED output
7}
8
9void loop() {
10  int button = digitalRead(13);   // Butonu oku / Read the button
11  if (button != lastButton) {     // Buton durumu değişti / Button state changed
12    if (button == 1) {            // Yalnız basış anında (LOW -> HIGH) / Only at the press (LOW -> HIGH)
13      ledState = !ledState;       // Durumu tersine çevir / Flip the state
14      digitalWrite(7, ledState);  // Yeni durumu LED'e yaz / Write the new state to the LED
15    }
16    delay(50);                    // Sıçramayı atlamak için kısa bekleme / Short wait to skip the bounce
17    lastButton = button;          // Bu okumayı sakla / Store this reading
18  }
19}

Adımları okurken dikkat etmen gereken şey, açıklamanın sana yalnız ne olduğunu değil, olmasaydı ne olacağını da söylemesi. 1. adım, ledState'in 0 ile başladığını ve bu yüzden kart açıldığında LED'in sönük olduğunu hatırlatıyor. Buradan güzel bir soru çıkar: değeri 1 yaparsan LED açılışta yanar mı? Yanmaz, çünkü bu satır yalnız değişkeni değiştirir; setup() LED'e hiçbir şey yazmadığı için LED sönük başlar ve ilk basışta ledState 0'a döndüğünden yine sönük kalır. Değişkenin değeri ile pinin gerçek durumu ayrı şeylerdir. 2. adım ise butonda INPUT kullanılmasını devredeki 10 kΩ dirence bağlıyor: direnç, basılmadığında pini GND'ye çeker ve 0 okunur. Direnci çıkarırsan pin havada kalır ve rastgele değer okunur; Takıldıysan bölümündeki "LED kendi kendine yanıp sönüyor" belirtisi tam olarak buna karşılık gelir.

3. ve 5. adımlar birlikte okunmalı. 3. adımdaki karşılaştırma ancak lastButton her değişimden sonra güncellenirse çalışır; o güncelleme de 5. adımdaki lastButton = button satırında. İki adımı eşleştirdiğinde programın asıl fikri ortaya çıkar: kod butonun basılı olup olmadığına değil, durumunun değişip değişmediğine bakıyor. Basılı tutarken her turda 1 okunur ama lastButton da 1'dir, karşılaştırma yanlış çıkar ve LED değişmez. 4. adımdaki ! işareti ise iki satırlık bir aç/kapa anahtarıdır. 5. adım bir uyarıyla biter: bekleme çok kısa olursa LED bazen tek basışta birden fazla kez değişebilir. Bu da görevden önce yapabileceğin ilk deneyi söylüyor: 50'yi 5'e indir, birkaç kez basıp LED'in arada bir iki kez değişip değişmediğini gözle; sonuç butonun kalitesine göre değişir. Debounce konusunu ayrıntılı görmek istersen Arduino'ya buton nasıl bağlanır yazısına bakabilirsin.

Bu projenin Takıldıysan bölümünde beş belirti var: LED hiç yanmıyor; LED butona dokunmadan kendi kendine değişiyor; butona basınca hiçbir şey olmuyor; buton hep basılı gibi davranıyor; kod yüklenmiyor. Her belirtinin karşısında somut bir kontrol yazıyor. Örneğin "hep basılı" belirtisinde, buton bacakları yanlış yönde takılınca D13'ün sürekli 5V'a bağlı kaldığı ve butonu 90 derece çevirmen gerektiği anlatılıyor. Kendin dene görevi ise şu: LED butona bastığında değil, butonu bıraktığın anda değişsin. İpucu, basış anında button değişkeninin 1, bırakma anında 0 olduğunu hatırlatıyor. Çözüm tek karakterlik bir değişiklik: if (button == 1) satırı if (button == 0) olur. Bu küçük görev, 3. adımda okuduğun kenar algılama fikrini gerçekten anlayıp anlamadığını sınar.

Okuma yöntemi: özet, eşleştirme, deneme

1. Özeti oku, tek cümleyle yaz: Bu kod ne yapıyor? kısmını oku, sonra telefona bakmadan programı bir cümleyle deftere yaz. Buton projesi için: "Her basışta LED bir kez açılır ya da kapanır."
2. Kodu yukarıdan aşağı adımlarla eşleştir: Kodu Arduino IDE'de aç (Kaynak Kodu'ndaki Linki Kopyala bunu kolaylaştırır), her adımın kod parçasını tam kodda bul ve satırın yanına adım numarasını yorum olarak ekle. Adımlar kodun sırasını izler: genel değişkenler, setup(), loop().
3. Eşleşmeyen satırları işaretle: Hiçbir adımda geçmeyen bir satır kaldıysa (çoğunlukla yalnız kapanış parantezleri kalır) neden açıklanmadığını düşün; parantez değilse o satırı açıklamalarda yeniden ara.
4. Devrede dene: Kodu yükle ve özetteki davranışı tek tek test et. Buton projesinde üç test yeter: tek basış, basılı tutma, hızlı art arda basış. Her testten önce ne olacağını yüksek sesle söyle.

Eşleştirme adımı en çok atlanan ama en çok kazandıran adım. Satırların yanına adım numarası yazdığında kodun iskeleti görünür hâle gelir: hangi satır bir kez, hangisi sürekli çalışıyor, hangi değişken nerede okunup nerede yazılıyor. Buton projesinde lastButton iki yerde geçer; 1. adımda tanımlanır, 5. adımda güncellenir. Bunu kendi gözünle görmek, "değişken bir kutudur" cümlesini okumaktan çok daha kalıcıdır. Değişken, döngü ve fonksiyon kavramlarını ayrıca çalışmak istersen Arduino programlama temelleri yazısına bakabilirsin.

15 dakikalık Kodu anla çalışma rutini

Bu rutin, devresi kurulmuş bir proje için. Devreyi ilk kez kuruyorsan ona ayrıca 10–15 dakika ayır ya da Kodu anla rutinini ertesi güne bırak. Rutinin son iki dakikası en değerli kısım: çözümü gördükten sonra kendi küçük değişikliğini yapmak, ezberlediğin cevabı değil anladığın fikri sınar. Buton projesinde örneğin LED'i başka bir pine taşımayı ya da 50 ms'lik beklemeyi 300 ms yapıp hızlı basışlara ne olduğunu gözlemeyi seçebilirsin. Günde bir proje bu tempoyla, bir haftada beş ücretsiz projeyi gerçekten anlayarak bitirmek demek. Daha uzun bir plan istersen 30 günlük Arduino yol haritası yazısına bak.

Kendin dene görevlerini çözme stratejisi

Kendin dene görevleri kısa ama bilinçli seçilmiş: hepsi tek bir değişiklik ister ve sonucu gözle görülür ya da kulakla duyulur. Onları çözerken şu sırayı bozmamak öğrenmeyi ikiye katlar:

1. Tahmin et: Görevi oku; kodun hangi satırına dokunacağını ve değişince ne göreceğini önce kendin söyle. Tahmini yazmak, sonradan "zaten öyle düşünmüştüm" yanılgısını engeller.
2. Değiştir: Yalnız bir şeyi değiştir. Aynı anda iki satırı değiştirirsen hangi değişikliğin neye yol açtığını ayıramazsın.
3. Yükle: Kodu karta yükle ve yüklemenin bittiğini gösteren mesajı bekle. Derleme hatası alırsan değiştirdiğin satırdaki noktalı virgüle ve parantezlere bak.
4. Gözle: Sonucu tahmininle karşılaştır. Süre görevlerinde saniye say, ses görevlerinde eski ve yeni sesi art arda dinle.
5. İpucuna bak: Tahminin tutmadıysa ya da hangi satıra dokunacağını bulamadıysan ipucunu oku. İpucu görevin hemen altında açık durduğu için ilk okumada elinle kapatmak işe yarar.
6. Çözümü en son aç: Çözümü göster'e ancak kendi denemeni yaptıktan sonra dokun. Çözüm seninkiyle aynıysa neden doğru olduğunu, farklıysa iki yolun neden farklı sonuç verdiğini düşün.

Bu sıranın bir faydası da hatayı öğretici hâle getirmesi. Diyelim ki Trafik Lambası projesinin görevinde yeşilden sonraki sarıyı 1,5 saniyeye çıkarmak isterken yanlışlıkla ilk delay(300) satırını değiştirdin. Beklediğin sonuç yerine kırmızıdan sonraki sarının uzadığını görürsün. Bu yanlış, kodda iki ayrı sarı faz olduğunu ve loop()'un satır sırasıyla çalıştığını sana çözümden çok daha iyi öğretir. Görevin çözümü de bunu söylüyor: loop()'un en sonundaki delay(300) satırı delay(1500) olur, kırmızıdan sonraki sarı 0,3 saniyede kalır.

Değişiklik türleri: hangisi hangi kavramı öğretir?

Ücretsiz projelerdeki görevlere bakınca hepsinin birkaç türden birine girdiğini görürsün. Türü tanımak, yeni bir projede kendi görevini kurmanı da kolaylaştırır. Tablodaki örnekler ücretsiz projelerin gerçek Kendin dene görevlerinden; pin değiştirme satırı ise aynı projede kendin yapabileceğin bir deneme.

Blokları anla: aynı açıklama bloklarla

Blok görünümü olan projelerde Kaynak Kodu bölümünde Bloklarla göster anahtarı bulunur. Anahtarı açtığında kod yerine aynı program uygulamanın dilinde bloklar olarak görünür ve yandaki sekmenin adı Kodu anla'dan Blokları anla'ya döner. Bu görünümde özet, Takıldıysan ve görev aynı kalır; değişen Adım adım bölümüdür: her adımda kod parçası yerine o adımın blokları görünür ve görsele dokununca tam ekran açılır. 100'ü aşkın projede blok görünümü var, ücretsiz projelerin de 30'dan fazlasında. Bloklar okumak içindir; uygulamada düzenlenmez ve karta yüklenmez, karta her zaman gerçek kod yüklenir.

Blokları anla'yı en iyi kullanma yolu iki görünüm arasında gidip gelmek. Buton projesinde 3. adımın blokları "button değişkenine 13 numaralı pini oku ata" bloğu ile iç içe iki "eğer" bloğundan oluşur; koddaki karşılığı int button = digitalRead(13); satırı ve iç içe iki if'tir. 4. adımdaki "ledState değişkenine ledState değil ata" bloğu ise ledState = !ledState; satırının ta kendisi. Önce bloğu okuyup ne yaptığını söyle, sonra anahtarı kapatıp aynı adımın kod parçasına bak. Blok ile kod arasındaki bu eşleştirme, blok kodlamadan metin tabanlı koda geçişin en sağlam yolu; konuya baştan girmek istersen blok kodlama nedir ve eğer bloğu yazılarına bakabilirsin.

Takıldıysan ile Sorun Giderme arasındaki fark

Pratikte sıra şöyle: devre çalışmadığında önce belirtiyi tek cümleyle tarif et ve Takıldıysan'da ara. Belirtin listede varsa çözüm çoğunlukla tek bir kablo, direnç ya da satırdır. Listede yoksa ya da önerilen çözüm işe yaramadıysa Sorun Giderme'deki adımları sırayla geç; orada atladığın temel bir kontrolü (kartın beslemesi, doğru port, ortak GND) yakalama ihtimalin yüksek. Yükleme aşamasında takıldıysan Arduino kod yüklenmiyor, derleme hatasında derleme hataları yazısı da işini görür.

Öğretmen için: Kodu anla'yı derste kullanmak

• Projeksiyonla ortak okuma: Dersin başında telefon ekranını yansıt, Bu kod ne yapıyor? özetini birlikte oku ve sınıfa programı tek cümleyle özetlet. Ardından Bloklarla göster açıkken aynı adımları bloklarla göster; blokla başlayan öğrenciler için bu geçiş bir köprü olur.
• Adım başına bir grup: 5 adımlı bir projede sınıfı 5 gruba böl; her grup bir adımı okur, kod parçasını tam kodda bulur ve iki dakikada sınıfa anlatır. Grup anlatırken diğerleri "bu satır olmasaydı ne olurdu?" diye sorar.
• Tahmin kâğıdı: Kendin dene görevini tahtaya yaz; her grup değişikliği yapmadan önce tahminini bir kâğıda yazsın, sonra değiştirip yüklesin. Tahmin ile sonuç arasındaki farkı konuşmak, görevi yapmaktan daha çok şey öğretir.
• Çıkış sorusu: Dersin son iki dakikasında herkes bir soruyu yanıtlasın. Buton projesi için örnekler: lastButton olmasaydı butonu basılı tutunca ne olurdu? delay(50) silinirse ne değişir? 10 kΩ direnci çıkarırsan LED neden kendi kendine değişebilir?

Erişimi planlarken şunu bil: ücretsiz projelerde Kodu anla herkese açık olduğu için Led Yakma, Trafik Lambası, Polis Çakar ve iki buton projesiyle öğrencilerin hiçbir ödeme yapmadan bu yöntemi uygulayabilir. Premium projelerde Kodu anla Premium ile açılır; sınıfça Premium projelere geçmek istersen öğrencilere tek tek abonelik aldırmak yerine eğitmen paketlerindeki kodları dağıtabilirsin, ayrıntılar sınıf için Arduino uygulaması yazısında. Kendi tasarladığın bir devreyi paylaşmak istersen Forum'da Rehber konusu açabilirsin; orada Kodu anla adımları ve blok görünümü olmaz, açıklamayı konu metninde kendin yazar, kodu Kod ekle ile eklersin (kendi projenle ders vermek). Uygulamada öğrencinin hangi görevi çözdüğünü sana gösteren bir panel de yok; görevi derste, çalışan devreye bakarak ya da fotoğrafla kontrol edersin.

Sık hatalar ve kolay çözümleri

• Çözümü hemen açmak: Görevi okur okumaz Çözümü göster'e dokunursan cevabı öğrenirsin ama fikri öğrenmezsin. Kural: önce tahmin, sonra deneme, sonra ipucu, en son çözüm.
• Adımları okumadan kopyalamak: Kodu Kopyala ile alıp yüklemek işe yarar, ama Adım adım'ı okumadan bir sonraki projeye geçersen her projede sıfırdan başlarsın. Yükledikten sonra en azından özeti ve adımları oku.
• Kod parçasını programın tamamı sanmak: Kod parçaları yalnız o adımın satırlarıdır; parçayı tek başına IDE'ye yapıştırırsan derlenmez. Değişikliği her zaman tam kodda yap.
• Aynı anda birden fazla şey değiştirmek: İki satırı birden değiştirip beklenmedik bir sonuç görünce hangisinin sorumlu olduğunu bilemezsin. Her yüklemede tek değişiklik.
• Pin numarasını yalnız bir yerde değiştirmek: pinMode'u değiştirip digitalWrite'ı ya da kabloyu unutmak en sık görülen hatalardan. Değiştirmeden önce numaranın koddaki bütün geçtiği yerleri işaretle.
• Takıldıysan'ı atlayıp hemen forumda sormak: Sorunun cevabı çoğu zaman o projenin Takıldıysan listesinde zaten yazılı. Önce oraya, sonra Sorun Giderme'ye bak; yine çözülmezse forumda devrenin fotoğrafı ve kodunla sor.
• Görevi bitirip orada bırakmak: Çözümle karşılaştırdıktan sonra kendi küçük değişikliğini yapmazsan öğrendiğin şey o göreve bağlı kalır. Bir sayıyı, bir pini ya da bir koşulu kendin seç.

Kodu anla'yı birkaç projede bu sırayla kullandığında hazır kod kapalı bir kutu olmaktan çıkar: hangi satırın neyi belirlediğini, neyi değiştirince ne olacağını önceden söyleyebilirsin. Buton İle Led Yakma (On Off) bu alışkanlık için iyi bir başlangıç, çünkü kısa bir kodda genel değişkeni, kenar algılamayı, toggle'ı ve debounce'u bir arada gösteriyor. Denemek istersen BlueGrays uygulamasında bu projeyi açıp Kodu anla sekmesindeki görevle başlayabilirsin; 60 ücretsiz projenin hepsinde aynı bölümler var.