Her LED veri hattını saatin yükselen kenarında okur, yani hızını kart belirler: yavaş bir digitalWrite() döngüsü, donanım SPI'si veya bir karenin ortasındaki kesme tümüyle çalışır. Bir WS2812 ise her bitin mikrosaniyenin küçük bir kesrine göre zamanlanmasını ister. count, şeridin kaç LED'e sahip olduğunu belirler, 1 ile 1024 arası.
Pins
| Pin | Ne yapar |
|---|---|
VCC |
Besleme, 5 V (veri sayfasındaki tipik değer; en fazla 5,5 V). DotStar şerit üzerinde 5V yazılıdır. |
CI |
Saat girişi, karttan gelir. |
DI |
Veri girişi, karttan gelir. |
GND |
Toprak. |
CO |
Saat çıkışı, bir sonraki şeridin CI ucuna gider. |
DO |
Veri çıkışı, bir sonraki şeridin DI ucuna gider. |
Kareler
APA102 veri sayfasından, bir defada 32 bit, en önemli bit önce:
| Çerçeve | Bitler |
|---|---|
| Başla | 32 zeros |
| LED başına bir tane | 111, 5 bitlik genel parlaklık, sonra mavi, yeşil ve kırmızı, her biri 8 bit |
| Son | Ones, at least one clock for every two LEDs |
Genel parlaklık LED'in akımını 31 adımda belirler (11111 tam, 00000 kapalı), her rengin 0 ile 255 arası görev döngüsünün üzerine biner. Şerit her kanalı renk x parlaklık / 31 olarak gösterir. İlk LED başlangıç karesinden sonraki ilk kareyi tutar ve gerisini geçirir, böylece ikinci LED ikinci kareyi alır, ve böyle devam eder.
Son kare neden gerekli: her LED veriyi yarım saat geç geçirir, ama saatin kendisi gecikmez. 30 LED'in sonuncusu karesini ancak kart gönderdikten 15 saat sonra tamamen almış olur. Mokxi bunu hesaba katar, yani son kare göndermeyen bir kod, şeridin uzak ucunun bir show() gecikmeli güncellendiğini görür, tıpkı gerçek bir şerit gibi.
Bir kod içinde
Adafruit_DotStar.h (veri ve saat pinleri, ya da bunları boş bıraktığınızda kartın SPI pinleri) ve FastLED'in addLeds<APA102, DATA_PIN, CLOCK_PIN, BGR> ikisi de yakar. Parça renkleri veri sayfasındaki mavi, yeşil, kırmızı sırasıyla alır, yani DOTSTAR_BGR kullan. Adafruit'in örnekleri DOTSTAR_BRG der çünkü bazı şeritler öyle kabloludur; bu parçada o sıra kırmızıyla yeşili yer değiştirir.
#include <Adafruit_DotStar.h>
#include <SPI.h>
Adafruit_DotStar strip(30, 4, 5, DOTSTAR_BGR); // data pin 4, clock pin 5
void setup() {
strip.begin();
strip.setBrightness(96);
}
void loop() {
strip.rainbow(millis() * 64);
strip.show();
delay(20);
}
DotStar gökkuşağı örneği bunu bir Uno üzerinde çalıştırır ve her show() çağrısının ne kadar sürdüğünü yazdırır.
Seviyeler
Girişler, beslemenin 0,7'i üzerinde yüksek, 0,3'ü altında düşük okunur. 5 V'luk bir şeritte bu 3,5 V demektir, yani 3,3 V'luk bir kart (bir ESP32 veya bir Pico) onu saatleyemez: CI ve DI üzerine bir 74AHCT125 seviye çevirici koy, ya da şeridi 3,3 V ile besle. 3 V altında şerit kapalıdır.
Modellemediği şeyler
LED'ler ortalama renklerini gösterir, altındaki PWM titremesini değil. İlk üç biti 111 olmayan bir kare yok sayılır (veri sayfasındaki kendini algılama modu). En fazla saat hızı zorunlu kılınmaz, çünkü veri sayfası bir şey söylemez; gerçek şeritler 1 ile 10 MHz arasında çalışır ve uzun olanlar daha yavaş ister. Şerit beslemeden akım çekmez, oysa gerçek olanı tam beyazda LED başına yaklaşık 60 mA'ye kadar çeker.