Setiap LED membaca jalur datanya saat clock naik, jadi board yang mengatur ritmenya: loop digitalWrite() yang lambat, hardware SPI, atau interrupt di tengah frame, semuanya bisa. WS2812 sebaliknya butuh setiap bit dihitung waktunya hingga sepersekian mikrodetik. count mengatur jumlah LED di strip, 1 sampai 1024.
Pins
| Pin | Fungsinya |
|---|---|
VCC |
Supply, 5 V (tipikal menurut datasheet; maksimal 5,5 V). Tercetak 5V pada strip DotStar. |
CI |
Clock masuk, dari board. |
DI |
Data masuk, dari board. |
GND |
Ground. |
CO |
Clock keluar, ke CI strip berikutnya. |
DO |
Data keluar, ke DI strip berikutnya. |
Frame-frame-nya
Dari datasheet APA102, 32 bit sekaligus, bit paling signifikan duluan:
| Frame | Bit |
|---|---|
| Mulai | 32 zeros |
| Satu per LED | 111, kecerahan global 5 bit, lalu biru, hijau dan merah, masing-masing 8 bit |
| Akhir | Ones, at least one clock for every two LEDs |
Kecerahan global mengatur arus LED dalam 31 tingkat (11111 penuh, 00000 mati) di atas duty 0 sampai 255 tiap warna. Strip menampilkan setiap channel sebagai color x brightness / 31. LED pertama menyimpan frame pertama setelah start frame dan meneruskan sisanya, jadi LED kedua mendapat frame kedua, dan seterusnya.
Kenapa ada end frame: setiap LED meneruskan data setengah clock lebih lambat, tapi clocknya sendiri tidak tertunda. LED terakhir dari 30 baru menerima frame utuhnya 15 clock setelah board mengirimnya. Mokxi menghitung hal ini, jadi sketch yang tidak mengirim end frame akan melihat ujung strip terjauh diperbarui satu show() lebih lambat, seperti strip sungguhan.
Dalam sketch
Adafruit_DotStar.h (pin data dan clock, atau pin SPI board kalau tidak ditulis) dan addLeds<APA102, DATA_PIN, CLOCK_PIN, BGR> dari FastLED keduanya bisa menyalakannya. Komponen ini menerima warna dalam urutan biru, hijau, merah sesuai datasheet, jadi gunakan DOTSTAR_BGR. Contoh dari Adafruit menulis DOTSTAR_BRG karena beberapa strip memang dirangkai begitu; pada komponen ini urutan itu menukar merah dan hijau.
#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);
}
Contoh pelangi DotStar menjalankan ini di Uno dan mencetak berapa lama setiap show() berjalan.
Level
Input terbaca tinggi di atas 0,7 dari supply dan rendah di bawah 0,3 dari supply. Pada strip 5 V itu berarti 3,5 V, jadi board 3,3 V (ESP32 atau Pico) tidak bisa memberi clock: pasang level shifter 74AHCT125 pada CI dan DI, atau jalankan strip dari 3,3 V. Di bawah 3 V strip mati.
Apa yang tidak dimodelkannya
LED menampilkan warna rata-ratanya, bukan kedipan PWM di bawahnya. Frame yang tiga bit pertamanya bukan 111 diabaikan (mode deteksi sendiri dari datasheet). Tidak ada batas kecepatan clock maksimum yang diberlakukan, karena datasheet tidak menyebutkannya; strip sungguhan berjalan di 1 sampai 10 MHz dan yang panjang lebih suka lambat. Strip ini tidak menarik arus dari supply, padahal yang asli menarik sampai sekitar 60 mA per LED saat putih penuh.