قوس قزح WS2812B NeoPixel على لوحة ESP32
متوسط
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
تضع مصابيح WS2812B، التي تبيعها Adafruit باسم NeoPixels، في كل بكسل LED أحمر وأخضر وأزرق ومتحكمًا صغيرًا، وتصلها جميعًا على سلك بيانات واحد. الدائرة أعلاه فيها ستة عشر منها على GPIO 5 في ESP32-C3، مع عجلة ألوان تنزلق على الشريط. إنها تعمل الآن، على ESP32-C3 محاكاة ينفّذ البرنامج الثابت المترجم، والشريط يفكّ ترميز النبضات الفعلية على طرف البيانات.
افتحه في المحرر لتغيير عدد المصابيح أو السرعة أو السطوع، ثم شغّله من جديد.
ما تحتاجه
- لوحة ESP32-C3 (هنا DevKitM-1)
- شريط أو حلقة أو مصفوفة WS2812B
- لوحة تجارب وأسلاك توصيل
التوصيل
| القطعة والطرف | يتصل بـ | ملاحظة |
|---|---|---|
| طرف DIN في الشريط | GPIO 5 | خط البيانات إلى LED الأول |
| طرف VDD في الشريط | 5 V | في شريط حقيقي طويل، مزوّد طاقة 5 فولت منفصل |
| طرف VSS في الشريط | GND | مشترك مع اللوحة |
سلك واحد، وبلا ساعة
There is no clock line. Each bit is a high pulse whose length is the bit: about 0.4 microseconds for a nought and 0.8 for a one. Each LED takes the first 24 bits it receives, green first, then red, then blue, and passes the rest along to the next. When the line has been quiet for 50 microseconds, every LED takes up its new color at once.
يفكّ الشريط المحاكى هذه النبضات من حواف الطرف نفسها، وفق نوافذ التوقيت في ورقة البيانات. النبضة القصيرة أو الطويلة أكثر من اللازم تُرفض، تمامًا كما يتوقف شريط حقيقي عن متابعة تدفّق لا يستطيع قراءته. لهذا فإن أي مشغّل يعمل هنا تكون توقيته صحيحة.
كود Adafruit_NeoPixel
يُترجم كود الدرس التطبيقي Adafruit NeoPixel كما هو على لوحات Arduino وعائلة ESP32 وPico وUno R4. الملف الرأسي هو ملف Mokxi الخاص، مبني على مشغّل WS2812 الخاص به، مع setPixelColor() وColor() وColorHSV() وfill() وclear() وsetBrightness() وgamma32() وrainbow(). يستخدم مثال قوس قزح المدمج المشغّل ذا المستوى الأدنى مباشرة، بعجلة ألوان بأرقام صحيحة من 1536 خطوة حول حواف مكعب RGB.
#include <Adafruit_NeoPixel.h>
Adafruit_NeoPixel pixels(8, 4, NEO_GRB + NEO_KHZ800);
void setup() {
pixels.begin();
}
void loop() {
pixels.clear();
pixels.setPixelColor(0, pixels.Color(0, 150, 0));
pixels.show();
delay(500);
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
لماذا يستخدم هذا الدرس لوحة ESP32
On a real Arduino Uno, the Adafruit library drives WS2812s with hand-tuned assembly that counts every one of the 16 MHz clock’s cycles. In Mokxi, the WS2812 driver is a counted loop (assembly on the AVR boards, the core’s cycle counter on the ESP32, Pico and Uno R4), so the NeoPixel header builds on all of them and stops with a message on the boards with no driver. An ESP32 has more memory for large panels, which is why this circuit uses one.
جرّبه في المحرر
Open the circuit in the editor and change LEVEL from 40 to 255. The strip gets much brighter. On a real bench each pixel can draw up to sixty milliamps at full white, and the supply has to be sized for that, which is why the example runs at a sixth of full scale.
Then select the strip and change its layout property to ring. The same sixteen LEDs are drawn as a circle, with LED 0 at the top and the rest clockwise, which is how the rings you can buy are numbered. The sketch does not change at all, because electrically a ring is a strip.
أخيرًا، غيّر SPEED إلى 1 لانسياب بطيء للألوان، أو غيّر SPREAD بحيث يعرض الشريط كله لونًا واحدًا في كل مرة.
أخطاء شائعة
كامل السطوع على كل LED. قد يسحب كل بكسل نحو 60 ملي أمبير عند الأبيض الكامل، لذا فإن شريطًا بـ 60 LED يحتاج أكثر من 3 أمبير. يعمل المثال عند نحو سُدس القدرة الكاملة. لا يحاكي المحاكي تيار مزوّد الطاقة، لذا خطّط للطاقة في البناء الحقيقي بنفسك.
ترتيب الألوان الخاطئ. تتوقع شرائط WS2812B الأخضر أولًا. الكود الذي يرسل الأحمر أولًا، مع NEO_RGB، ينتهي بتبديل الأحمر والأخضر، هنا وعلى المنضدة.
عدم وجود أرضية مشتركة بين اللوحة وشريط مغذًّى بطاقة منفصلة. يُقاس خط البيانات بالنسبة إلى أرضية الشريط.
خط بيانات بجهد 3.3 فولت إلى شريط 5 فولت. كثير من الشرائط الحقيقية تقبله، لكن ليس كلها. مزحزح مستوى، أو بكسل أول يُشغَّل بجهد أدنى قليلًا، يحلّ المشكلة. الشريط المحاكى يقرأ بيانات 3.3 فولت دون اعتراض.
نسيان show(). ضبط بكسل يغيّر المخزن المؤقت في الذاكرة؛ لا شيء يصل إلى الشريط حتى يرسله show().
افتح هذه الدائرة في المحرر. ESP32-C3: قوس قزح WS2812B، موصّل كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّله مرة أخرى.
افتح الدائرةالأسئلة
هل يمكنني استخدام حلقة أو مصفوفة NeoPixel بدلًا من شريط؟
نعم. كهربائيًا كلها شريط. للقطعة المحاكاة خاصية تخطيط للشريط والحلقة والمصفوفة، بما في ذلك المصفوفات المتعرّجة، والترقيم يتبع المنتجات الحقيقية.
كم NeoPixel يمكن لطرف واحد أن يقود؟
بقدر ما لديك من ذاكرة ووقت: ثلاثة بايت لكل واحدة، ونحو 30 ميكروثانية لإرسال كل LED. يحمل الشريط المحاكى حتى 1024 من LED لكل قطعة.
هل تعمل FastLED؟
نعم. يُترجم FastLED.h هنا، وكذلك Adafruit_NeoPixel.h، على لوحات AVR وعائلة ESP32 وPico وUno R4.
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.