تعلّم

NeoPixel مع Arduino: قوس قزح على WS2812B مع Uno

مبتدئ

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: قوس قزح NeoPixelمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
Twenty WS2812Bs on pin 6 and four on pin 5, on a simulated ATmega328P. The knob on A0 sets the speed.

شريط NeoPixel هو صف من وحدات LED RGB صغيرة، لكل منها شريحتها الخاصة. ترسل الألوان عبر سلك بيانات واحد، وكل وحدة LED تحتفظ بلونها حتى ترسل ألوانًا جديدة. تبيعها Adafruit باسم NeoPixel؛ الشريحة داخلها هي WS2812B، والشرائط والحلقات والمصفوفات الرخيصة كلها تستخدم الشريحة نفسها.

الدائرة أعلاه هي Arduino Uno يشغّل شريطين: قوس من عشرين وحدة LED على الطرف 6 ومجموعة من أربع وحدات LED ذهبية على الطرف 5. يتدفق قوس قزح على طول القوس، ومقبض A0 يحدد السرعة. تعمل في متصفحك بالكود أدناه، وكل شريط يفك شيفرة النبضات الحقيقية على طرف البيانات الخاص به، لذا خطأ التوصيل يجعل الدائرة تنطفئ هنا كما تنطفئ على منضدتك.

ما تحتاجه

  • Arduino Uno
  • شريط WS2812B (عشرون وحدة LED هنا) وآخر قصير من أربع وحدات
  • مقاومتان بقيمة 330 أوم، واحدة لكل خط بيانات
  • مقاوم متغيّر بقيمة 10k للسرعة
  • لوحة تجارب نصف الحجم وأسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
الطرف DIN لشريط القوسالطرف 6عبر مقاومة 330 أوم
الطرف DIN للشريط الذهبيالطرف 5عبر مقاومته الخاصة البالغة 330 أوم
الطرف VDD (5V) لكلا الشريطينخط 5 Vاستخدم مصدر 5 V منفصلًا للشريط الطويل
الطرف VSS (GND) لكلا الشريطينخط GNDيجب أن تكون الأرضي مشتركة مع الـ Uno
الطرف الأوسط للمقاوم المتغيّرA0مقبض السرعة
الأطراف الخارجية للمقاوم المتغيّر5 V وGNDأي جهة كانت

سلك واحد، والتوقيت هو البيانات

There is no clock wire. Each bit is one high pulse, and the length of the pulse is the bit: about 0.4 microseconds for a 0 and 0.8 for a 1. Every LED takes 24 bits, eight each for green, red and blue, keeps the first 24 for itself and passes the rest down the strip. When the line goes quiet for 50 microseconds, every LED shows its new color at once.

هذه النبضات أقصر بكثير من أن تُصنع بـ digitalWrite(). مكتبة Adafruit_NeoPixel تضبط توقيتها لك، لذا لا يتعامل كودك إلا مع الألوان. على الـ Uno تُعدّ البتات بلغة التجميع، دورة ساعة واحدة في كل مرة.

الكود، خطوة بخطوة

كل شريط هو كائن واحد: كم وحدة LED، أي طرف، وترتيب الألوان. الإعداد NEO_GRB + NEO_KHZ800 صحيح لكل WS2812B تقريبًا. الدالة begin() تهيّئ الطرف، وsetBrightness() تخفّض كل الألوان، وهذا يوفّر الطاقة وعينيك.

في loop()، يقرأ الكود المقبض ويحوّله إلى سرعة بين 32 و1024. يضيفها إلى درجة لون بداية، ثم يعطي كل وحدة LED درجة لون أبعد قليلًا حول عجلة الألوان. الدالة ColorHSV() تأخذ درجة لون من 0 إلى 65535 وتعيد لونًا، وgamma32() تصحّحه حتى تبدو التدرجات متساوية لعينك. لا يتغيّر شيء على الشريط حتى ترسل show() الإطار كاملًا.

الحلقة تنتظر 20 ميلي ثانية، لذا يتحرك قوس قزح نحو خمسين مرة في الثانية. كل 200 إطار يطبع السرعة. مع المقبض في المنتصف، يقول السطر الأول "Rainbow speed 528". أدره إلى النهاية فيقول 32.

الحلقة، من مثال قوس قزح
void loop() {
  int speed = map(analogRead(A0), 0, 1023, 32, 1024);
  start += speed;
  for (int i = 0; i < ARCH; i++) {
    uint16_t hue = start + (uint32_t)i * 65536 / ARCH;
    arch.setPixelColor(i, arch.gamma32(arch.ColorHSV(hue)));
  }
  for (int i = 0; i < POT; i++) {
    int glint = random(0, 10) == 0 ? 255 : random(140, 200);
    gold.setPixelColor(i, glint, glint * 3 / 5, 0);
  }
  arch.show();
  gold.show();
  frames++;
  if (frames % 200 == 1) {
    Serial.print("Rainbow speed ");
    Serial.println(speed);
  }
  delay(20);
}

الطاقة: الجزء الذي لا يستطيع المحاكي تحذيرك منه

كل وحدة WS2812B قد تسحب نحو 60 ميلي أمبير عند الأبيض الكامل. عشرون منها تعني أكثر من أمبير، وهذا أكثر مما يجب أن يعطيه طرف 5 V على الـ Uno. لأكثر من حفنة من وحدات LED، غذِّ الشريط من مصدر 5 V خاص به، وصّل أرضيه بأرضي الـ Uno، وأبقِ السطوع منخفضًا. مكثف بقيمة 1000 ميكروفاراد عبر سلكي طاقة الشريط، كما توصي Adafruit، يحمي أول وحدة LED عند التوصيل.

لا يحاكي Mokxi التيار الذي تسحبه كل وحدة LED، لذا الشريط الطويل هنا لا يُضعف اللوحة أبدًا. هذا حد حقيقي للمحاكاة، وهو سبب وجود هذا القسم.

جرّبه في المحرر

اجعل قوس قزح يجري في الاتجاه الآخر بتغيير start += speed إلى start -= speed. غيّر ARCH إلى 60 وخاصية count على الشريط إلى 60 لقوس أطول. أعطِ الوعاء لمعانًا أخضر بتبديل الأرقام في استدعاء setPixelColor() الخاص به.

ثم احذف سلك الأرضي للقوس واضغط «تشغيل». يبقى القوس مظلمًا، لأن نبضات البيانات لا تجد مسارًا تعود عبره. أعده وسيعود قوس قزح.

أخطاء شائعة

لا أرضي مشترك. الشريط على مصدره الخاص ما زال يحتاج إلى ربط GND الخاص به بـ GND الـ Uno، وإلا فلن يعني خط البيانات شيئًا له.

نسيان show(). الدالة setPixelColor() تغيّر قائمة في الذاكرة فقط. لا يتغيّر الشريط حتى ترسل show() المحتوى.

ترتيب الألوان الخاطئ. WS2812B يحتاج NEO_GRB. استخدم NEO_RGB فيخرج الأحمر والأخضر معكوسين، هنا وعلى شريط حقيقي.

التوصيل بالطرف الخاطئ. البيانات تدخل من DIN. السهم المطبوع على الشريط يشير بعيدًا عن المدخل، نحو DOUT.

تشغيل شريط طويل من طرف 5 V على الـ Uno بأقصى سطوع. انظر قسم الطاقة أعلاه.

افتح هذه الدائرة في المحرر. Arduino Uno: قوس قزح NeoPixel، موصّلًا كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّله مرة أخرى.

افتح الدائرة

الأسئلة

أي طرف أستخدم لوحدات NeoPixel على Arduino Uno؟

أي طرف رقمي يعمل. المكتبة تضبط توقيت النبضات بنفسها، لذا لا يحتاج الطرف إلى PWM. يستخدم هذا المثال الطرفين 6 و5، كل منهما عبر مقاومة 330 أوم.

هل يمكنني استخدام FastLED بدلًا من Adafruit_NeoPixel؟

نعم. كلتا المكتبتين تتم ترجمتهما في Mokxi، على لوحات AVR وعائلة ESP32 وPico وUno R4. على لوحة لا تدعم مشغّل WS2812 هنا، مثل لوحات STM32، يخبرك الترويسة بذلك عند البناء.

كم وحدة NeoPixel يمكن لـ Uno تشغيلها؟

تحتفظ المكتبة بثلاثة بايتات من الذاكرة لكل وحدة LED، والـ Uno لديه 2 KB من RAM، لذا بضع مئات هي الحد العملي قبل أن ينفد الكود من المساحة. الطاقة عادة هي الحد الحقيقي الأول. في Mokxi كل شريط في الكود يشارك مجموعة ثابتة من 1024 وحدة LED.

هل يعمل هذا على ESP32 أيضًا؟

نعم، بالكود نفسه. درس NeoPixel على ESP32 يشغّل قوس قزح على ESP32-C3، ويشرح كيف تضبط تلك اللوحة توقيت البتات.

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.