Yılbaşı Ağacı LED Arduino: WS2812B ile Kar ve Gökkuşağı Efekti

Yılbaşı ağacı LED projesi için Arduino ve WS2812B şerit LED kullanmak, hazır ağaç ışıklarının sunduğu birkaç sabit modun ötesine geçmenin en eğlenceli yoludur. Her LED'in rengini ve parlaklığını tek tek kontrol edebildiğin için ağacına tepeden aşağı süzülen kar taneleri, dalların etrafında dönen bir gökkuşağı ya da rastgele yanıp sönen kırmızı, yeşil ve altın sarısı yıldızlar ekleyebilirsin. Üstelik bütün bunlar için yalnızca tek bir veri kablosu, bir buton ve doğru seçilmiş bir 5 V adaptör yeterlidir.

Bu rehberde malzeme listesinden başlayıp şerit uzunluğuna göre güç kaynağı hesabını, adaptör, kart ve şerit arasındaki doğru bağlantıyı, butonla efekt değiştiren eksiksiz bir Arduino Uno programını (FastLED) ve aynı projenin ESP32 (Adafruit NeoPixel) ile Raspberry Pi Pico (MicroPython) sürümlerini adım adım kuracağız. Sonunda şeridi ağaca nasıl saracağını, güvenlikte nelere dikkat edeceğini ve en sık karşılaşılan sorunları nasıl çözeceğini de öğreneceksin.

Yılbaşı ağacı için neden WS2812B şerit LED?

Klasik yılbaşı ışıklarında bütün ampuller aynı anda yanar ya da birkaç grup hâlinde sırayla çalışır. WS2812B'de ise her LED'in içinde küçük bir sürücü yonga bulunur. Arduino veri hattından art arda renk bilgisi gönderir; ilk LED kendi 24 bitlik payını alır, kalanını bir sonraki LED'e aktarır. Böylece 100 ya da 300 LED'lik bir şeridi tek bir pinle yönetirsin ve her LED'e ayrı bir renk verebilirsin. Bu yapı sayesinde kar yağışı gibi hareketli efektler, sabit ışıklarla imkânsız olan bir canlılık kazanır. Adreslenebilir LED'lerin çalışma mantığını daha derinlemesine öğrenmek istersen WS2812B NeoPixel LED yazısına göz atabilirsin.

Malzeme listesi

• WS2812B şerit LED: 1,5–1,8 m boyunda bir ağaç için 60 LED/m yoğunluklu 2,5 m ya da 30 LED/m'lik 5 m şerit iyi bir başlangıçtır. Silikon kaplı IP65 modeller dallara takılmaya ve tozlanmaya karşı daha dayanıklıdır.
• Kontrol kartı: Arduino Uno, Nano, ESP32 ya da Raspberry Pi Pico.
• 5 V adaptör: Akım değerini aşağıdaki tabloya göre seç; 100 LED için 5 V 4 A rahat bir seçimdir.
• Dişi DC jak (vidalı klemensli): Adaptörün fişini lehim yapmadan kablolara bağlamak için.
• 1000 µF / 10 V elektrolitik kondansatör: Şerit girişindeki ani akım dalgalanmalarını yumuşatır.
• 330 Ω direnç: Veri hattına seri bağlanır; sinyaldeki yansımaları ve ilk LED'in giriş akımını sınırlar.
• Push buton: Efektler arasında geçiş yapmak için.
• Kalın kablo: 5V ve GND hatları için en az 0,75–1,5 mm² kesitli kablo.
• İsteğe bağlı 74AHCT125 ya da 74HCT245: ESP32 ve Pico'nun 3,3 V'luk veri sinyalini 5 V'a yükseltmek için.

Güç kaynağı hesabı: kaç amperlik adaptör gerekir?

WS2812B'nin içindeki kırmızı, yeşil ve mavi yongaların her biri tam parlaklıkta yaklaşık 20 mA çeker; yani bir LED tam beyazda yaklaşık 60 mA harcar. En kötü durum akımını I = LED sayısı × 60 mA formülüyle bulursun. 100 LED'lik bir şerit bütün LED'ler bembeyaz ve tam parlaklıktayken 6 A çeker; bu da P = 5 V × 6 A = 30 W demektir. Gökkuşağı, kar ve yıldız efektlerinde LED'lerin çoğu tek renkte ya da kısık olduğu için pratikte akım en kötü durumun üçte biri civarında kalır. Güvenli bir seçim için bu tipik akımı 2 ile çarpıp en yakın adaptör değerine yuvarla, yazılımdaki akım sınırını da adaptörün yaklaşık %80'ine ayarla. Akım, gerilim ve güç arasındaki ilişkiyi Ohm Kanunu hesaplayıcısıyla kolayca kontrol edebilirsin.

Uzun şeritlerde ikinci sorun gerilim düşümüdür. Şeridin üzerindeki ince bakır yollar direnç gösterdiği için 5 m'lik bir şeridin sonunda gerilim 4 V'un altına inebilir; bu durumda mavi ve yeşil yongalar zayıflar, beyaz renk sarımsı ve soluk görünür. Çözüm, 5V ve GND'yi yalnızca şeridin başından değil, her 1–1,5 metrede bir (ya da her 100–150 LED'de bir) adaptörden gelen ayrı kablolarla yeniden beslemektir. Buna güç enjeksiyonu denir. Bu kablolarda 5 amper için en az 0,75 mm², 10 amper için 1,5 mm² kesit kullan; veri hattını ise yalnızca şeridin başına bağla.

Bağlantı şeması: 5 V adaptör, şerit ve kart

1. Şeridin üzerindeki okları bul ve okun başladığı uca (DIN) kablo lehimle. Ok yönünün tersinden, yani DOUT ucundan veri gönderirsen hiçbir LED yanmaz.
2. Adaptörün +5 V çıkışını şeridin 5V (bazı şeritlerde +5V ya da VCC yazar) ucuna, adaptörün GND'sini şeridin GND ucuna bağla.
3. 1000 µF kondansatörü şeridin girişinde 5V ile GND arasına bağla; uzun bacak (artı) 5V'a, gövdesinde şerit işareti olan bacak (eksi) GND'ye gelmeli.
4. Kartın GND pinini adaptörün GND'sine bağla. Ortak GND olmadan veri sinyalinin bir referansı olmaz.
5. Kartın veri pinini (Uno'da D6) 330 Ω direnç üzerinden şeridin DIN ucuna bağla; direnci şeride yakın tarafa koymak daha iyi sonuç verir.
6. Butonun bir bacağını D2'ye, diğerini GND'ye bağla; dahili pull-up direnci kodda açılacak.
7. 150'den fazla LED kullanıyorsan şeridin ortasına ve sonuna da adaptörden ayrı 5V ve GND kabloları çek.
8. Geliştirme sırasında kartı USB'den, şeridi adaptörden besle. Proje bitince adaptörün 5 V'unu Uno'nun 5V pinine verebilirsin; bu durumda USB kablosunu aynı anda takma.

Arduino Uno kodu (FastLED): üç efekt ve butonla mod değiştirme

Arduino IDE'de Kütüphane Yöneticisi'ni açıp FastLED aratarak kütüphaneyi kur; ayrıntılı anlatım için Arduino'ya kütüphane ekleme yazısına bakabilirsin. Aşağıdaki program gökkuşağı, kar yağışı ve yıldız gibi yanıp sönme efektlerini içerir; butona her basışta bir sonraki efekte geçer. Kod delay() yerine millis() kullandığı için efekt çalışırken buton her an algılanır. Bu yöntemin mantığını millis ve delay farkı yazısında bulabilirsin.

1#include <FastLED.h>
2
3#define LED_PIN     6      // şeridin DIN girişi (330 ohm üzerinden) / strip DIN input (via 330 ohm)
4#define BUTTON_PIN  2      // buton, diğer bacak GND / button, other leg to GND
5#define NUM_LEDS    100    // şeritteki LED sayısı / number of LEDs on the strip
6#define BRIGHTNESS  120    // genel parlaklık 0-255 / global brightness 0-255
7#define MAX_MA      3200   // 4 A adaptörün %80'i / 80% of a 4 A supply
8
9CRGB leds[NUM_LEDS];
10
11const uint8_t MODE_COUNT = 3;                          // 0 gökkuşağı, 1 kar, 2 yıldız / 0 rainbow, 1 snow, 2 twinkle
12const uint16_t FRAME_MS[MODE_COUNT] = {20, 60, 30};    // kare süreleri (ms) / frame times (ms)
13const CRGB XMAS[4] = {CRGB::Red, CRGB::Green, CRGB::Gold, CRGB::White};
14
15uint8_t mode = 0;
16uint8_t hue = 0;
17
18void setup() {
19  pinMode(BUTTON_PIN, INPUT_PULLUP);
20  FastLED.addLeds<WS2812B, LED_PIN, GRB>(leds, NUM_LEDS);
21  FastLED.setMaxPowerInVoltsAndMilliamps(5, MAX_MA);  // akım sınırı / current limit
22  FastLED.setBrightness(BRIGHTNESS);
23  FastLED.clear(true);                                // açılışta hepsini söndür / all off at start
24}
25
26void checkButton() {
27  static bool lastState = HIGH;
28  static unsigned long lastChange = 0;
29  bool state = digitalRead(BUTTON_PIN);
30  if (state != lastState && millis() - lastChange > 50) {  // 50 ms zıplama filtresi / 50 ms debounce
31    lastChange = millis();
32    lastState = state;
33    if (state == LOW) {                                     // basıldı / pressed
34      mode = (mode + 1) % MODE_COUNT;
35      FastLED.clear();
36    }
37  }
38}
39
40void rainbow() {
41  fill_rainbow(leds, NUM_LEDS, hue, 3);   // her LED'de ton 3 artar / hue +3 per LED
42  hue += 2;                               // renkler döner / colours rotate
43}
44
45void snowfall() {
46  for (int i = 0; i < NUM_LEDS - 1; i++) {
47    leds[i] = leds[i + 1];                // bir LED aşağı kaydır / shift one LED down
48  }
49  if (random8() < 38) {
50    leds[NUM_LEDS - 1] = CRGB::White;     // tepede yeni kar tanesi / new flake at the top
51  } else {
52    leds[NUM_LEDS - 1] = CRGB(0, 0, 24);  // koyu mavi gece / dark blue night
53  }
54}
55
56void twinkle() {
57  fadeToBlackBy(leds, NUM_LEDS, 20);      // hepsini biraz kıs / dim everything a little
58  if (random8() < 80) {
59    leds[random16(NUM_LEDS)] = XMAS[random8(4)];  // rastgele yıldız / random star
60  }
61}
62
63void loop() {
64  checkButton();
65  static unsigned long lastFrame = 0;
66  if (millis() - lastFrame >= FRAME_MS[mode]) {
67    lastFrame = millis();
68    if (mode == 0) rainbow();
69    else if (mode == 1) snowfall();
70    else twinkle();
71    FastLED.show();                       // renkleri şeride gönder / push colours to the strip
72  }
73}

Efektler nasıl çalışıyor?

Gökkuşağı: fill_rainbow fonksiyonu ilk LED'e verilen renk tonundan (hue) başlayarak her LED'de tonu 3 adım artırır. FastLED'de renk tonu 0–255 arasındadır; 100 LED'de ton toplam 300 adım ilerlediği için şeridin üzerinde bir tam renk çemberinden biraz fazlası görünür. Her karede hue değişkenini 2 artırdığımız için renkler ağacın etrafında yavaşça döner. Daha geniş renk bantları istersen 3 yerine 1 ya da 2 kullan.

Kar yağışı: Şerit ağaca alttan yukarı sarıldığında ilk LED en altta, son LED tepededir. Her karede bütün renkleri bir LED aşağı kaydırıp tepeye ya beyaz bir kar tanesi ya da koyu mavi bir gece pikseli ekliyoruz. random8() 0–255 arası bir sayı ürettiği için 38'den küçük çıkma olasılığı yaklaşık %15'tir; bu sayıyı büyütürsen kar yoğunlaşır. 60 ms'lik kare süresiyle bir kar tanesi 100 LED'i 6 saniyede iner. Yanıp sönme (yıldız): fadeToBlackBy her karede bütün LED'leri yaklaşık %8 kısar; aynı anda rastgele seçilen bir LED kırmızı, yeşil, altın sarısı ya da beyaz olarak tam parlaklıkta yanar. Sonuç, eski tip yılbaşı ışıklarını andıran ama çok daha canlı bir pırıltıdır.

ESP32 ile yılbaşı ağacı (Adafruit NeoPixel)

ESP32'de FastLED de çalışır, ancak burada aynı projeyi Adafruit NeoPixel kütüphanesiyle yazıyoruz; böylece iki popüler kütüphaneyi de tanımış olacaksın. Kütüphanenin güncel sürümü ESP32 Arduino çekirdeğinin 2.x ve 3.x sürümleriyle aynı kodla derlenir ve sinyali donanım RMT birimiyle üretir. Adafruit NeoPixel'de setBrightness ile kısılan renkler geri okunurken bozulabildiği için efektleri kendi parlaklık dizimizde (level) hesaplayıp her karede şeride baştan yazıyoruz. Veri pini GPIO 13, buton GPIO 4'tür. İleride ağacı telefondan yönetmek istersen WLED kurulumu yazısı hazır bir arayüz sunar.

1#include <Adafruit_NeoPixel.h>
2
3#define LED_PIN     13     // şeridin DIN girişi (330 ohm üzerinden) / strip DIN input (via 330 ohm)
4#define BUTTON_PIN  4      // buton, diğer bacak GND / button, other leg to GND
5#define NUM_LEDS    100    // şeritteki LED sayısı / number of LEDs on the strip
6
7Adafruit_NeoPixel strip(NUM_LEDS, LED_PIN, NEO_GRB + NEO_KHZ800);
8
9const uint8_t MODE_COUNT = 3;                          // 0 gökkuşağı, 1 kar, 2 yıldız / 0 rainbow, 1 snow, 2 twinkle
10const uint16_t FRAME_MS[MODE_COUNT] = {20, 60, 30};    // kare süreleri (ms) / frame times (ms)
11const uint8_t PALETTE[4][3] = {{255, 0, 0}, {0, 255, 0}, {255, 160, 0}, {255, 255, 255}};
12
13uint8_t level[NUM_LEDS];      // LED başına parlaklık / per-LED level
14uint8_t colorIdx[NUM_LEDS];   // yıldız rengi / star colour index
15uint8_t mode = 0;
16uint16_t hue = 0;
17
18void setup() {
19  pinMode(BUTTON_PIN, INPUT_PULLUP);
20  strip.begin();
21  strip.setBrightness(110);   // genel parlaklık / global brightness
22  strip.clear();
23  strip.show();
24}
25
26void checkButton() {
27  static bool lastState = HIGH;
28  static unsigned long lastChange = 0;
29  bool state = digitalRead(BUTTON_PIN);
30  if (state != lastState && millis() - lastChange > 50) {  // 50 ms zıplama filtresi / 50 ms debounce
31    lastChange = millis();
32    lastState = state;
33    if (state == LOW) {                                     // basıldı / pressed
34      mode = (mode + 1) % MODE_COUNT;
35      memset(level, 0, sizeof(level));                      // efekt belleğini sıfırla / reset effect buffer
36      strip.clear();
37    }
38  }
39}
40
41void rainbow() {
42  for (int i = 0; i < NUM_LEDS; i++) {
43    uint16_t h = hue + (uint32_t)i * 65536UL / NUM_LEDS;   // LED'e göre ton / hue per LED
44    strip.setPixelColor(i, strip.gamma32(strip.ColorHSV(h)));
45  }
46  hue += 256;                                              // renkler döner / colours rotate
47}
48
49void snowfall() {
50  for (int i = 0; i < NUM_LEDS - 1; i++) level[i] = level[i + 1];   // bir LED aşağı kaydır / shift one LED down
51  level[NUM_LEDS - 1] = (random(100) < 15) ? 255 : 0;               // tepede yeni kar / new flake on top
52  for (int i = 0; i < NUM_LEDS; i++) {
53    if (level[i]) strip.setPixelColor(i, 255, 255, 255);            // kar tanesi / snowflake
54    else strip.setPixelColor(i, 0, 0, 24);                          // koyu mavi gece / dark blue night
55  }
56}
57
58void twinkle() {
59  for (int i = 0; i < NUM_LEDS; i++) {
60    level[i] = (level[i] > 12) ? level[i] - 12 : 0;                 // yavaşça sön / fade out
61  }
62  if (random(100) < 30) {
63    int p = random(NUM_LEDS);
64    level[p] = 255;                                                 // yeni yıldız / new star
65    colorIdx[p] = random(4);
66  }
67  for (int i = 0; i < NUM_LEDS; i++) {
68    const uint8_t *c = PALETTE[colorIdx[i]];
69    strip.setPixelColor(i, c[0] * level[i] / 255, c[1] * level[i] / 255, c[2] * level[i] / 255);
70  }
71}
72
73void loop() {
74  checkButton();
75  static unsigned long lastFrame = 0;
76  if (millis() - lastFrame >= FRAME_MS[mode]) {
77    lastFrame = millis();
78    if (mode == 0) rainbow();
79    else if (mode == 1) snowfall();
80    else twinkle();
81    strip.show();                                                   // renkleri şeride gönder / push colours to the strip
82  }
83}

Raspberry Pi Pico ve MicroPython ile yılbaşı ağacı

Raspberry Pi Pico'nun MicroPython yazılımında neopixel modülü hazır gelir; ayrıca bir şey kurman gerekmez. Modül WS2812B'nin hassas zamanlamasını kendisi hallettiği için herhangi bir GP pinini kullanabilirsin; aşağıda veri GP0'a, buton GP15'e bağlıdır. MicroPython'da genel bir parlaklık ayarı olmadığı için renkleri BRIGHT katsayısıyla kendimiz kısıyoruz. Python, C++'a göre daha yavaş çalıştığından 100 LED'de efektler akıcıdır; 300 LED'in üzerinde kare süreleri uzayabilir. MicroPython'a yeniysen MicroPython temelleri yazısıyla başlayabilirsin.

1from machine import Pin
2import neopixel, time, random
3
4NUM_LEDS = 100
5BRIGHT = 0.4                                   # 0-1 parlaklık / brightness
6np = neopixel.NeoPixel(Pin(0), NUM_LEDS)       # veri GP0 / data on GP0
7button = Pin(15, Pin.IN, Pin.PULL_UP)          # buton GP15-GND / button GP15-GND
8
9mode = 0
10MODE_COUNT = 3                                 # 0 gökkuşağı, 1 kar, 2 yıldız / 0 rainbow, 1 snow, 2 twinkle
11FRAME_MS = (20, 60, 30)                        # kare süreleri / frame times
12level = [0] * NUM_LEDS                         # LED başına parlaklık / per-LED level
13color_idx = [0] * NUM_LEDS                     # yıldız rengi / star colour index
14PALETTE = ((255, 0, 0), (0, 255, 0), (255, 160, 0), (255, 255, 255))
15hue = 0
16
17def scale(r, g, b):
18    return (int(r * BRIGHT), int(g * BRIGHT), int(b * BRIGHT))
19
20def wheel(pos):
21    # 0-255 -> gökkuşağı rengi / rainbow colour
22    pos = pos & 255
23    if pos < 85:
24        return (255 - pos * 3, pos * 3, 0)
25    if pos < 170:
26        pos -= 85
27        return (0, 255 - pos * 3, pos * 3)
28    pos -= 170
29    return (pos * 3, 0, 255 - pos * 3)
30
31def rainbow():
32    global hue
33    for i in range(NUM_LEDS):
34        np[i] = scale(*wheel(hue + i * 256 // NUM_LEDS))
35    hue = (hue + 2) & 255                      # renkler döner / colours rotate
36
37def snowfall():
38    for i in range(NUM_LEDS - 1):
39        level[i] = level[i + 1]                # bir LED aşağı kaydır / shift one LED down
40    level[-1] = 255 if random.randint(0, 99) < 15 else 0
41    for i in range(NUM_LEDS):
42        np[i] = scale(255, 255, 255) if level[i] else scale(0, 0, 24)
43
44def twinkle():
45    for i in range(NUM_LEDS):
46        level[i] = level[i] - 12 if level[i] > 12 else 0   # yavaşça sön / fade out
47    if random.randint(0, 99) < 30:
48        p = random.randint(0, NUM_LEDS - 1)
49        level[p] = 255                         # yeni yıldız / new star
50        color_idx[p] = random.randint(0, 3)
51    for i in range(NUM_LEDS):
52        r, g, b = PALETTE[color_idx[i]]
53        k = level[i] * BRIGHT / 255
54        np[i] = (int(r * k), int(g * k), int(b * k))
55
56effects = (rainbow, snowfall, twinkle)
57last_btn = 1
58last_change = time.ticks_ms()
59last_frame = time.ticks_ms()
60
61while True:
62    now = time.ticks_ms()
63    state = button.value()
64    if state != last_btn and time.ticks_diff(now, last_change) > 50:   # zıplama filtresi / debounce
65        last_change = now
66        last_btn = state
67        if state == 0:                         # basıldı / pressed
68            mode = (mode + 1) % MODE_COUNT
69            for i in range(NUM_LEDS):
70                level[i] = 0
71    if time.ticks_diff(now, last_frame) >= FRAME_MS[mode]:
72        last_frame = now
73        effects[mode]()
74        np.write()                             # şeride gönder / push to the strip

Şeridi ağaca yerleştirme ve güvenlik

• Alttan başla: Şeridin DIN ucunu ağacın dibine, kontrol kutusunun yanına koy ve şeridi spiral şeklinde yukarı doğru sar. Böylece kar efekti tepeden aşağı akar ve veri kablosu kısa kalır.
• Spiral aralığı: 1,8 m'lik bir ağaçta 20–25 cm aralıkla sarmak, 5 m'lik şeridi dallara dengeli dağıtır; ağacın tepesine doğru tur çapı küçüldüğü için aralığı biraz daraltabilirsin.
• Dikey şeritler: Şeridi tepeden aşağı ve aşağıdan yukarı zikzak şeklinde de döşeyebilirsin. Bu yerleşimde kar efektinin yönü her ikinci şeritte ters döner, bu yüzden LED sırasını şerit numarasına göre hesaplayan küçük bir düzenleme yapman gerekir.
• Isı: WS2812B şerit yüksek parlaklıkta ısınır; kâğıt süslerin ve kuru dalların üzerine sıkıca bastırma. Parlaklığı 100–150 civarında tutmak hem ısıyı hem akımı azaltır.
• Adaptör güvenliği: 220 V tarafında kendi devreni kurma; CE işaretli, kapalı kasalı hazır bir 5 V adaptör kullan. Kontrol kutusunu sudan ve saksı sulamasından uzak tut, evden çıkarken ağacı kapat.
• Sigorta: 5 A'nın üzerindeki sistemlerde adaptör çıkışına uygun değerde bir bıçak sigorta eklemek, olası bir kısa devreye karşı iyi bir önlemdir.

Yılbaşı ağacı için proje fikirleri

• Müziğe duyarlı ağaç: Bir mikrofonla ışıkları şarkının ritmine göre yak; ayrıntılar müziğe duyarlı LED yazısında.
• Yılbaşı geri sayımı: Gece yarısına kalan süreyi bir ekranda göster, saat 00:00 olduğunda ağaçta havai fişek efekti başlat; yılbaşı geri sayım sayacı yazısına göz at.
• Kendiliğinden açılan ağaç: Hava karardığında ışıkları bir LDR ışık sensörü ile otomatik aç.
• Yaklaşınca parlayan ağaç: Odaya biri girdiğinde PIR hareket sensörü ile parlaklığı artır, oda boşken kıs.
• Telefondan kontrol: ESP32 ile bir web sayfası açıp efektleri ve renkleri telefondan seç; ESP32 web sunucusu yazısı iyi bir başlangıç noktası.
• Tepe yıldızı ekranı: Ağacın tepesine küçük bir WS2812B LED matris yerleştirip yıldız ya da kar tanesi animasyonu oynat.

Sık yapılan hatalar ve çözümleri

Birkaç metre şerit LED, tek bir buton ve doğru boyutlandırılmış bir 5 V adaptörle yılbaşı ağacın her yıl yeni efektlerle yenilenebilen, programlanabilir bir ışık gösterisine dönüşür. Renk paletleriyle ve kare süreleriyle oynayarak kendi efektlerini tasarlayabilir, güç ve bağlantı konusunda kafana takılanlar için Arduino güç besleme rehberine dönebilirsin. BlueGrays uygulamasında WS2812B ile yürüyen LED, karaşimşek, polis çakar ve animasyon projelerini, ayrıca ESP32 ile NeoPixel şerit kontrolünü adım adım devre şemaları ve kodlarıyla bulabilirsin.