Hissələr · 5 dəq oxu

WS2812B NeoPixel LED-dən istifadə: ünvanlana bilən RGB LED bələdçisi

WS2812B NeoPixel nədir və necə qoşulur? Ünvanlana bilən RGB LED lent, halqa və matris, güc hesabı, Adafruit NeoPixel və FastLED kodları, göy qurşağı effekti, ESP32 və Pico nümunələri.

WS2812B daxilində öz sürücü çipi olan RGB LED-dir. Adi RGB LED hər rəng üçün ayrıca pin tələb edir, WS2812B ilə isə yüzlərlə LED-i tək bir data naqili ilə idarə edir, hər birinə ayrıca rəng və parlaqlıq verirsən. NeoPixel Adafruit-in bu ünvanlana bilən LED ailəsinə verdiyi addır. Lent, halqa, çubuq və matris şəklində satılan bu LED-lər mühit işıqlandırmasından LED saatlara, oyunlardan bildiriş lampalarına qədər saysız layihədə istifadə olunur.

WS2812B ünvanlana bilən RGB LED lent hissəsi
Tək bir WS2812B lent hissəsi: data soldakı DI girişindən daxil olur, sağdakı DO çıxışından növbəti LED-ə keçir. Ox işarəsi data istiqamətini göstərir.

WS2812B necə işləyir?

Hər WS2812B-nin 5x5 mm-lik gövdəsində qırmızı, yaşıl və göy üç kiçik LED ilə onları idarə edən xırda bir çip var. Arduino data xəttindən ardıcıl olaraq 24 bitlik rəng paketləri göndərir: 8 bit yaşıl, 8 bit qırmızı, 8 bit göy (GRB sırası). İlk LED gələn ilk 24 biti özünə götürür, qalanını DO pinindən növbəti LED-ə ötürür; hər LED eyni şeyi edir. Data xətti ən azı 50 mikrosaniyə (yeni versiyalarda 280) LOW qaldıqda bütün LED-lər aldıqları rəngi eyni anda göstərir. Hər rəng 256 pillədən ibarət olduğu üçün bir LED 16,7 milyon müxtəlif rəng göstərə bilər.

XüsusiyyətDəyər
Qida gərginliyi5 V (3,5–5,3 V)
Hər LED üçün cərəyanƏn çox ~60 mA (tam ağ), sönükkən ~1 mA
Data sürəti800 kHz, tək naqil
Rəng sırasıGRB (yaşıl, qırmızı, göy)
Rəng dərinliyi24 bit, 16,7 milyon rəng
Korpus5050 SMD (5x5 mm)

Lent, halqa və matris növləri

NövLED sayıTipik istifadə
LentMetrdə 30, 60 və ya 144Mühit işıqlandırması, TV arxası, rəf işığı
Halqa8, 12, 16, 24LED saat, göstərici, masa lampası
Matris8x8 = 64, 16x16 = 256Axan yazı, animasiya, piksel oyunlar
Çubuq (stick)8Səviyyə göstəricisi, vəziyyət işığı
24 LED-li WS2812B NeoPixel halqa
24 LED-li NeoPixel halqa: LED saatlar və dairəvi göstəricilər üçün idealdır; 12 saatlıq ciferblatda hər LED yarım saatı göstərir.

WS2812B qoşulması

WS2812B-nin üç qoşulması var: 5V, GND və DIN (data girişi). Lentin üzərindəki oxlar datanın axdığı istiqaməti göstərir; Arduino-nu həmişə oxun başladığı uca, yəni DIN tərəfinə qoş. Data xəttinə ardıcıl olaraq 330–470 Ω rezistor, lentin qida girişində isə 5V ilə GND arasına 1000 µF kondensator əlavə etmək ilk LED-i ani gərginlik sıçrayışlarından qoruyur.

WS2812B piniQoşulma
5VBir neçə LED üçün Arduino 5V, daha çoxu üçün xarici 5 V adapter
GNDGND (xarici adapterlə Arduino-nun GND-si ortaq olmalıdır)
DIND6 (330 Ω rezistor üzərindən)
DOUTNövbəti LED-in və ya lentin DIN pini
Çox sayda LED-i Arduino-nun 5V pinindən qidalandırma: USB ən çox 500 mA verir, tam ağda tək bir LED belə 60 mA çəkə bilər. Lenti xarici 5 V adapterlə qidalandır, adapterin GND-sini mütləq Arduino-nun GND-sinə qoş və dövrədə enerji varkən data naqilini GND-dən əvvəl taxma; ilk LED xarab ola bilər.

Güc hesabı: neçə amper lazımdır?

Ən pis hal üçün düstur sadədir: LED sayı × 60 mA. Animasiyalarda bütün LED-lər nadir hallarda eyni anda tam ağ yanır; praktikada orta hesabla hər LED üçün 20 mA civarında cərəyan müşahidə olunur. Yenə də adapteri ən pis hala görə seçmək və ya parlaqlığı proqramla məhdudlaşdırmaq lazımdır. Vatt ilə gücü tapmaq üçün Om qanunu alətindən, batareya ilə işləyən layihələrdə müddəti təxmin etmək üçün batareya ömrü alətindən istifadə edə bilərsən.

LED sayıƏn pis hal (tam ağ)Tövsiyə olunan qida
80,48 AUSB kifayətdir (parlaqlıq məhduddur)
301,8 A5 V 3 A adapter
603,6 A5 V 4 A adapter
1448,6 A5 V 10 A adapter
Uzun lentlərdə nazik mis yollar gərginliyi aşağı salır və lentin sonu sarımtıl ya da qırmızımtıl görünür. Bunun qarşısını almaq üçün hər 1–2 metrdən bir 5V və GND-ni adapterdən lentə yenidən qoş (güc inyeksiyası). Həmçinin parlaqlığı 20–30%-ə endirmək cərəyanı ciddi şəkildə azaldır və gözlə görünən fərq yaratmır.

Adafruit NeoPixel kitabxanası ilə ilk kod

Library Manager-də Adafruit NeoPixel kitabxanasını axtar və quraşdır. Aşağıdakı kod LED-ləri ardıcıl olaraq qırmızı, yaşıl və göy yandıraraq lenti bir rənglə "silir":

C++ (Arduino IDE)
1#include <Adafruit_NeoPixel.h>
2
3#define PIN 6          // DIN pini / data pin
4#define NUM_LEDS 8     // LED sayısı / number of LEDs
5
6Adafruit_NeoPixel strip(NUM_LEDS, PIN, NEO_GRB + NEO_KHZ800);
7
8void setup() {
9  strip.begin();
10  strip.setBrightness(50);   // 0–255, yalnız bir kez / only once
11  strip.show();              // hepsini söndür / all off
12}
13
14void colorWipe(uint32_t color, int wait) {
15  for (int i = 0; i < NUM_LEDS; i++) {
16    strip.setPixelColor(i, color);
17    strip.show();            // değişikliği gönder / send the change
18    delay(wait);
19  }
20}
21
22void loop() {
23  colorWipe(strip.Color(255, 0, 0), 80);   // kırmızı / red
24  colorWipe(strip.Color(0, 255, 0), 80);   // yeşil / green
25  colorWipe(strip.Color(0, 0, 255), 80);   // mavi / blue
26}

setPixelColor() yalnız yaddaşdakı rəngi dəyişir; LED-lərin həqiqətən yanması üçün show() çağırmalısan. Beləliklə bütün LED-lərin rəngini tənzimləyib birdəfəyə göstərə bilərsən. setBrightness() rəng məlumatını daimi olaraq miqyaslandırdığı üçün onu loop() daxilində davamlı dəyişmək əvəzinə setup() daxilində bir dəfə çağırmaq ən düzgünüdür. Hər LED Arduino-nun RAM-ində 3 bayt yer tutur; Uno-nun 2 KB-lıq yaddaşı yüzlərlə LED-də tez dolur.

Göy qurşağı effekti: HSV rənglər

Rəngləri qırmızı, yaşıl və göy dəyərləri ilə tənzimləmək əvəzinə HSV (ton, doyma, parlaqlıq) istifadə etmək effektləri çox asanlaşdırır: yalnız tonu dəyişərək bütün rəng çevrəsini gəzirsən. Adafruit kitabxanasında ton 0–65535 arasındadır. gamma32() rəngləri gözün qavrayışına görə düzəldərək keçidləri daha təbii göstərir:

C++ (Arduino IDE)
1#include <Adafruit_NeoPixel.h>
2
3#define PIN 6
4#define NUM_LEDS 24
5
6Adafruit_NeoPixel strip(NUM_LEDS, PIN, NEO_GRB + NEO_KHZ800);
7
8void setup() {
9  strip.begin();
10  strip.setBrightness(40);
11}
12
13void loop() {
14  for (long first = 0; first < 65536; first += 256) {
15    for (int i = 0; i < NUM_LEDS; i++) {
16      uint16_t hue = first + i * 65536L / NUM_LEDS;   // her LED'e farklı ton / a different hue per LED
17      strip.setPixelColor(i, strip.gamma32(strip.ColorHSV(hue)));
18    }
19    strip.show();
20    delay(10);
21  }
22}

FastLED kitabxanası

Daha qabaqcıl effektlər üçün FastLED kitabxanası da çox populyardır. LED-ləri CRGB massivində saxlayır, leds[3] = CRGB::Red; kimi oxunaqlı əmrlər təqdim edir və ton aralığı 0–255-dir. fill_rainbow(), fadeToBlackBy() kimi hazır funksiyalar od, ulduz axması və ya nəfəs alma effektlərini bir neçə sətirlə yazmağa imkan verir. Ən faydalı xüsusiyyətlərindən biri FastLED.setMaxPowerInVoltsAndMilliamps(5, 2000); əmridir: kitabxana parlaqlığı avtomatik azaldaraq cərəyanı 2 A-dən aşağı saxlayır.

8x8 NeoPixel matrisdən istifadə

Matrislər də əslində uzun bir lentdir; 64 LED tək data xəttinə ardıcıl qoşulub. Əksər matrislərdə sətirlər ziqzaq (serpentine) düzülür: cüt sətirlər soldan sağa, tək sətirlər sağdan sola gedir. Buna görə x, y koordinatını LED nömrəsinə çevirmək üçün cüt sətirlərdə y × 8 + x, tək sətirlərdə y × 8 + (7 − x) düsturundan istifadə edirsən. 64 LED tam ağda 3,8 A çəkə bildiyi üçün matrislərdə parlaqlığı aşağı saxlamaq xüsusilə vacibdir.

8x8 WS2812B NeoPixel LED matris
8x8 NeoPixel matris: 64 ünvanlana bilən LED tək data xətti ilə idarə olunur; axan yazı və piksel oyunlar üçün idealdır.

ESP32 və Raspberry Pi Pico ilə WS2812B

Adafruit NeoPixel və FastLED kitabxanaları ESP32-də də işləyir; Wi-Fi sayəsində LED-ləri telefondan idarə etmək və ya hava proqnozuna görə rəng dəyişən lampa düzəltmək çox asandır. Diqqət ediləcək nöqtə gərginlik səviyyəsidir: 5 V ilə qidalanan WS2812B data girişində ən azı 3,5 V gözləyir, ESP32 və Pico isə 3,3 V verir. Əksər lentlər yenə də işləyir, amma ilk LED titrəyirsə və ya təsadüfi rənglər çıxırsa, data xəttinə 74AHCT125 kimi səviyyə çeviricisi əlavə et. Raspberry Pi Pico-da MicroPython-un hazır neopixel modulu var:

MicroPython
1from machine import Pin
2import neopixel
3import time
4
5NUM = 8
6np = neopixel.NeoPixel(Pin(0), NUM)      # GP0 → DIN
7
8def wheel(pos):                          # 0–255 → renk çemberi / colour wheel
9    if pos < 85:
10        return (255 - pos * 3, pos * 3, 0)
11    if pos < 170:
12        pos -= 85
13        return (0, 255 - pos * 3, pos * 3)
14    pos -= 170
15    return (pos * 3, 0, 255 - pos * 3)
16
17j = 0
18while True:
19    for i in range(NUM):
20        r, g, b = wheel((i * 256 // NUM + j) & 255)
21        np[i] = (r // 5, g // 5, b // 5)  # parlaklığı düşür / dim it
22    np.write()
23    j = (j + 2) & 255
24    time.sleep_ms(20)

WS2812B ilə layihə ideyaları

  • TV arxası mühit işığı: Televizorun arxasına yapışdırılan lentlə otağa yumşaq bir rəng ver.
  • NeoPixel saat: 60 LED-li halqada saatı, dəqiqəni və saniyəni fərqli rənglərlə göstər.
  • Səs səviyyəsi göstəricisi: Mikrofon modulu ilə musiqinin şiddətinə görə yüksələn LED çubuğu düzəlt.
  • Bildiriş lampası: ESP32 ilə internetdən gələn hava proqnozuna və ya e-poçta görə rəng dəyiş.
  • Polis siqnalı və qaçan işıq (Knight Rider): Qırmızı-göy yanıb-sönmə və ya irəli-geri sürüşən işıq effektləri yaz.
  • Piksel ilan oyunu: 8x8 matris və coystik ilə klassik ilan oyununu yenidən düzəlt.

Tez-tez edilən səhvlər və həlləri

  • Heç bir LED yanmır: Arduino lentin yanlış ucuna, DOUT tərəfinə qoşulub; oxlara bax və DIN ucundan istifadə et.
  • Rənglər qarışıqdır (qırmızı əvəzinə yaşıl yanır): Rəng sırası səhvdir; kodda NEO_GRB istifadə et, bəzi lentlər üçün NEO_RGB lazım ola bilər.
  • İlk LED titrəyir və ya təsadüfi rənglər çıxır: Ardıcıl rezistor yoxdur, GND ortaq deyil və ya 3,3 V data siqnalı kifayət etmir.
  • Lentin sonu sarımtıl görünür: Gərginlik düşməsi var; lentə bir neçə nöqtədən qida ver və ya parlaqlığı azalt.
  • LED-lər yananda Arduino yenidən başlayır: USB-dən çox cərəyan çəkilir; xarici adapter və 1000 µF kondensator istifadə et.
  • Yalnız ilk bir neçə LED yanır: Koddakı NUM_LEDS dəyəri real LED sayından kiçikdir və ya lentin bir nöqtəsində qırıq qoşulma var.

WS2812B rənglərin necə qarışdığını anlamaq üçün əla başlanğıc nöqtəsidir; rəng məntiqini RGB LED istifadəsi yazısında, parlaqlıq idarəsini PWM nədir? yazısında tapa bilərsən. BlueGrays tətbiqində WS2812B istifadəsi, polis siqnalı, qaçan LED, Knight Rider, animasiya effektləri və ESP32 ilə NeoPixel lent idarəsi layihələrini dövrə sxemləri və kodları ilə tapa bilərsən.

Tez-tez verilən suallar

WS2812B ilə NeoPixel arasındakı fərq nədir?

NeoPixel Adafruit-in WS2812, WS2812B və SK6812 kimi ünvanlana bilən LED-lər üçün istifadə etdiyi marka adıdır. Hamısı eyni data protokolundan istifadə edir, buna görə eyni kitabxanalarla eyni şəkildə idarə olunur.

Bir Arduino-ya neçə WS2812B qoşula bilər?

Data tərəfdə qəti limit yoxdur, amma üç şey məhdudlaşdırır: RAM (hər LED 3 bayt, Uno-da praktikada bir neçə yüz LED), yenilənmə müddəti (hər LED 30 mikrosaniyə; 1000 LED təxminən 30 ms, yəni saniyədə ~33 kadr) və qida mənbəyi.

WS2812B-ni Arduino-nun 5V pinindən qidalandıra bilərəmmi?

Yalnız bir neçə LED-i aşağı parlaqlıqda qidalandıra bilərsən; məsələn, 8 LED-lik çubuq parlaqlıq 50 civarında olanda USB ilə işləyir. Daha çox LED üçün xarici 5 V adapter istifadə et və GND-ləri birləşdir.

Rezistor və kondensator şərtdirmi?

Şərt deyil, amma mütləq tövsiyə olunur. Data xəttindəki 330–470 Ω rezistor siqnaldakı sıçrayışları yumşaldaraq ilk LED-i qoruyur; qida girişindəki 1000 µF kondensator isə enerji verildiyi anda yaranan ani cərəyan zərbəsini söndürür.

WS2812B ESP32 və 3,3 V platalarla işləyirmi?

Əksər hallarda işləyir, amma zəmanət yoxdur: 5 V ilə qidalanan WS2812B data girişində ən azı 3,5 V gözləyir. Titrəmə və ya yanlış rəng görsən, 74AHCT125 kimi səviyyə çeviricisi ilə data siqnalını 5 V-a qaldır.

WS2812B, WS2811, WS2813 və SK6812 arasında hansı fərqlər var?

WS2811 ayrıca sürücü çipidir və adətən 12 V lentlərdə üç LED-i birlikdə idarə edir. WS2813-də ehtiyat data xətti var, bir LED xarab olsa belə zəncir davam edir. SK6812 uyğun alternativdir və ağ LED-li RGBW versiyası da var; bunun üçün kodda NEO_GRBW istifadə olunur.

Bütün layihələrə bax
WS2812B istifadəsi
AR-69Orta
Premium

WS2812B istifadəsi

Hər işığı ayrıca rəngləndirə bildiyin ağıllı LED lentlə tanış olursan. Arduino əvvəlcə lentdəki ilk beş LED-i qırmızı yandırır, bir saniyə sonra qalan beşini göy yandırır, sonra hamısını söndürür və…

4.8(54)
70
WS2812B ilə polis mayakı düzəltmək
AR-70Orta
Premium

WS2812B ilə polis mayakı düzəltmək

Polis maşınlarının üstündəki qırmızı-göy mayakı stolunun üstünə gətirirsən. On LED-lik WS2812B lentin bir yarısı üç dəfə sürətlə qırmızı, o biri yarısı üç dəfə göy yanıb-sönür və bu ardıcıllıq…

4.8(67)
86
WS2812B qaçan LED
AR-71Orta
Premium

WS2812B qaçan LED

On LED-lik lentdə yaşıl işıq nöqtəsi əvvəldən sona tək-tək irəliləyir, sona çatanda yenidən başa qayıdır; hər LED-də saniyənin üçdə biri qədər dayanır.

4.8(58)
75
WS2812B qaçan LED (yığılmaqla)
AR-72Orta
Premium

WS2812B qaçan LED (yığılmaqla)

Stəkana su dolduran kimi dolub boşalan işıq lenti. Arduino on rəngli LED-i narıncı rənglə tək-tək yandırır və hamısı yanıq qalır, lent dolanda eyni ardıcıllıqla tək-tək söndürür və nümayiş yenidən…

4.7(50)
65
WS2812B qaçan işıq effekti
AR-73Orta
Premium

WS2812B qaçan işıq effekti

Ağıllı LED lentdə qırmızı işıq nöqtəsi bir ucdan o biri uca sürüşür, sonra geri qayıdır və bu gediş-gəliş dayanmır.

4.9(73)
94
WS2812B qaçan işıq (3 LED)
AR-74Orta
Premium

WS2812B qaçan işıq (3 LED)

Göy qurşağının bütün rəngləri 56 LED-lik lentin üzərində yavaşca sürüşür. Hər LED qonşusundan bir az fərqli rəngdə yanır və rənglər həmişə eyni istiqamətdə axır; lent sanki canlı işıq çayına çevrilir.

4.8(61)
79
WS2812B Animasiya 1
AR-75Orta
Premium

WS2812B Animasiya 1

56 LED-lik lentdə göy qurşağının bütün rəngləri yan-yana düzülür və dayanmadan axır, sanki lentin üstündə işıqdan çay sürüşür.

4.9(69)
89
WS2812B Animasiya 2
AR-76Orta
Premium

WS2812B Animasiya 2

Otağında özü-özünə rəng dəyişən işıq nümayişi qur. Arduino 30 LED-lik lentdə rəngləri dayanmadan axıdır və bir neçə saniyədən bir yeni rəng dəstinə keçir: göy qurşağı, bənövşəyi-yaşıl zolaqlar…

4.8(65)
84
ESP32 WS2812B NeoPixel lent idarəsi
ES-24Orta
Premium

ESP32 WS2812B NeoPixel lent idarəsi

WS2812B (NeoPixel) ünvanlana bilən LED-lər tək data pini üzərindən zəncirvari idarə oluna bilən ağıllı RGB LED-lərdir. Bu layihədə 8 LED-lik WS2812B lentini Adafruit_NeoPixel kitabxanası ilə idarə edib axıcı göy qurşağı animasiyası yaradacağıq. ESP32-nin 3,3V məntiq səviyyəsi əksər WS2812B partiyalarında problemsiz işləsə də, qeyri-sabitlik olsa, 470Ω ardıcıl rezistor və 1000µF kondensator həllini göstərəcəyik. Animasiya HSV rəng məkanında ton (hue) dəyərini sürüşdürməklə əldə edilir.

4.9(19)
30