القطع

شريط LED من نوع APA102 (DotStar)

LEDs ملونة RGB قابلة للعنونة مع سلك ساعة وسلك بيانات، فتعمل بأي سرعة. أسماء أخرى: DotStar، SK9822، APA102C، شريط Adafruit DotStar.

يقرأ كل LED خط بياناته عند الحافة الصاعدة للساعة، فاللوحة هي التي تحدد الإيقاع: حلقة digitalWrite() بطيئة، أو SPI عتادي، أو مقاطعة في منتصف إطار، كلها تعمل. أما WS2812 فيتطلب توقيت كل بتة بدقة أجزاء من الميكروثانية. تحدد count عدد الـ LED في الشريط، من 1 إلى 1024.

Pins

Pin ماذا تفعل
VCC التغذية، 5 فولت (القيمة النموذجية في ورقة البيانات؛ 5.5 فولت كحد أقصى). مطبوع 5V على شريط DotStar.
CI دخل الساعة، من اللوحة.
DI دخل البيانات، من اللوحة.
GND الأرضي.
CO خرج الساعة، إلى CI في الشريط التالي.
DO خرج البيانات، إلى DI في الشريط التالي.

الإطارات

من ورقة بيانات APA102، 32 بت في كل مرة، والبت الأكثر أهمية أولًا:

إطار البتات
ابدأ 32 zeros
واحد لكل LED 111، ثم سطوع عام من 5 بتات، ثم الأزرق والأخضر والأحمر، 8 بتات لكل منها
النهاية Ones, at least one clock for every two LEDs

يحدد السطوع العام تيار الـ LED في 31 درجة (11111 أعلى قيمة، و00000 إيقاف) فوق نسبة تشغيل تتراوح من 0 إلى 255 لكل لون. يعرض الشريط كل قناة كـ color x brightness / 31. يحتفظ أول LED بأول إطار بعد إطار البداية ويمرر البقية، فيصل الإطار الثاني إلى الـ LED الثاني، وهكذا.

لماذا إطار النهاية: يمرر كل LED البيانات بتأخير نصف ساعة، لكن الساعة نفسها لا تتأخر. آخر LED من بين 30 لا يستقبل إطاره كاملًا إلا بعد 15 ساعة من إرسال اللوحة له. يحسب Mokxi هذا، لذا الكود الذي لا يرسل إطار نهاية يرى الطرف البعيد من الشريط يتحدث متأخرًا استدعاء show() واحدًا، كما يحدث في الشريط الحقيقي.

في الكود

كلٌّ من Adafruit_DotStar.h (بطرفي البيانات والساعة، أو بأطراف SPI للوحة إذا تركتهما) وaddLeds<APA102, DATA_PIN, CLOCK_PIN, BGR> من FastLED يشغّله. تستقبل القطعة الألوان بترتيب ورقة البيانات: أزرق ثم أخضر ثم أحمر، فاستخدم DOTSTAR_BGR. تقول أمثلة Adafruit ‏DOTSTAR_BRG لأن بعض الشرائط موصولة بهذه الطريقة؛ على هذه القطعة يبدّل هذا الترتيب الأحمر والأخضر.

#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 يشغّل هذا على Uno ويطبع المدة التي يستغرقها كل show().

المستويات

تقرأ المداخل مستوى عاليًا فوق 0.7 من جهد التغذية ومستوى منخفضًا تحت 0.3 منه. على شريط 5 فولت يعني ذلك 3.5 فولت، فاللوحة ذات 3.3 فولت (مثل ESP32 أو Pico) لا تستطيع إرسال الساعة: ضع محوّل مستويات 74AHCT125 على CI وDI، أو شغّل الشريط بـ 3.3 فولت. تحت 3 فولت ينطفئ الشريط.

ما لا يحاكيه

تعرض الـ LED متوسط لونها، لا رمشات PWM تحتها. أي إطار لا تبدأ أول ثلاث بتات فيه بـ 111 يُتجاهل (وضع الاكتشاف الذاتي في ورقة البيانات). لا تُفرض سرعة ساعة قصوى، لأن ورقة البيانات لا تذكر واحدة؛ الشرائط الحقيقية تعمل بين 1 و10 ميغاهرتز والطويلة تفضّل الأبطأ. لا يسحب الشريط أي تيار من التغذية، بينما الشريط الحقيقي يسحب حتى نحو 60 مللي أمبير لكل LED عند الأبيض الكامل.