شاشة e-paper مع Arduino: بطاقة سعر على رف
متوسط
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
الورق الإلكتروني (e-paper، ويسمى أيضًا e-ink) هو الشاشة المستخدمة في قارئات الكتب الإلكترونية وبطاقات الأسعار الإلكترونية على الرفوف. تبدو كورق مطبوع، وتُقرأ بوضوح في ضوء الشمس، وتحتفظ بالصورة حتى مع انقطاع الطاقة، لذا يمكن لبطاقة أن تعرض سعرًا لسنوات على بطارية زر واحدة. لكن العيب هو السرعة: التحديث الكامل يستغرق ثوانٍ.
الدائرة أعلاه هي لوحة Uno تشغّل لوحة e-paper مقاس 2.9 إنش ودقة 296 في 128 بكسلًا بمكتبة GxEPD2، كبطاقة السعر على رف متجر. ترسم البطاقة مرة واحدة بتحديث كامل، ثم تُدخل اللوحة في وضع النوم. اضغط الزر وستخفّض السعر بتحديث جزئي سريع للسعر وحده. اضغط «تشغيل» وامنحها نحو ست ثوانٍ.
ما تحتاجه
- Arduino Uno
- وحدة e-paper بمقاس 2.9 إنش على SPI، بدقة 296x128، برقاقة SSD1680 (مثل وحدات Waveshare)
- زر ضغط
- لوحة تجارب وأسلاك توصيل
التوصيل
| القطعة والطرف | يتصل بـ | ملاحظة |
|---|---|---|
| VCC الخاص بالورق الإلكتروني | 3.3 V | تعمل اللوحة على جهد من 2.2 إلى 3.7 V |
| GND الخاص بالورق الإلكتروني | GND | |
| SDA للورق الإلكتروني (DIN) | الطرف 11 | بيانات SPI (MOSI) |
| SCL للورق الإلكتروني (CLK) | الطرف 13 | ساعة SPI |
| e-paper CS | الطرف 10 | |
| e-paper DC | الطرف 9 | أمر أم بيانات |
| e-paper RES (RST) | الطرف 8 | |
| e-paper BUSY | الطرف 7 | مرتفع أثناء تحديث اللوحة |
| زر | الطرف 2 وGND | INPUT_PULLUP، فعند الضغط تُقرأ القيمة LOW |
كيف تعمل شاشة e-paper
داخل اللوحة ملايين الكبسولات الدقيقة من الجسيمات السوداء والبيضاء ذات الشحنات المتعاكسة. جهد كهربائي على بكسل واحد يسحب الجسيمات السوداء إلى الأعلى أو البيضاء، وتبقى في مكانها بعد زوال الجهد. لهذا تبقى الصورة دون أي طاقة، ولهذا يستغرق تغييرها بعض الوقت: فالجسيمات يجب أن تتحرك.
لللوحة متحكم خاص بها، هنا SSD1680، فيه ذاكرة للصورة. تكتب لوحة Arduino الصورة الجديدة في تلك الذاكرة عبر SPI، ثم تخبر المتحكم أن يحدّث الشاشة. وأثناء التحديث يبقي المتحكم طرف BUSY مرتفعًا، ويتجاهل ما ترسله.
الكود
تُضبط الشاشة بـ GxEPD2_290_BS(10, 9, 8, 7): وهي CS وDC وRES وBUSY. ترسم GxEPD2 باستدعاءات Adafruit GFX، داخل حلقة firstPage() / nextPage(). ثم تضع hibernate() المتحكم في سبات عميق، فلا يرسم شيئًا، وتبقى الصورة على الزجاج.
Watch the serial monitor and the timing. The label takes about six seconds from Run: nearly three to draw the picture and send it, then about three for the full refresh, with BUSY high. Then "label drawn". Press the button and the price changes from $4.99 to $2.99 with a partial refresh that takes about 0.3 seconds, and the serial monitor says "marked down". Press again for "full price".
#include <GxEPD2_BW.h>
#define MAX_DISPLAY_BUFFER_SIZE 800
#define MAX_HEIGHT(EPD) (EPD::HEIGHT <= MAX_DISPLAY_BUFFER_SIZE / (EPD::WIDTH / 8) ? \
EPD::HEIGHT : MAX_DISPLAY_BUFFER_SIZE / (EPD::WIDTH / 8))
GxEPD2_BW<GxEPD2_290_BS, MAX_HEIGHT(GxEPD2_290_BS)>
display(GxEPD2_290_BS(10, 9, 8, 7)); // CS, DC, RES, BUSY
const int BUTTON = 2;
bool sale = false;
void price() {
display.fillRect(150, 40, 146, 60, GxEPD_WHITE);
display.setTextColor(GxEPD_BLACK);
display.setTextSize(4);
display.setCursor(156, 52);
display.print(sale ? "$2.99" : "$4.99");
}
void drawLabel() {
display.setFullWindow();
display.firstPage();
do {
display.fillScreen(GxEPD_WHITE);
display.fillRect(0, 0, 296, 28, GxEPD_BLACK);
display.setTextColor(GxEPD_WHITE);
display.setTextSize(2);
display.setCursor(8, 6);
display.print("FRESH BREAD");
display.setTextColor(GxEPD_BLACK);
display.setTextSize(2);
display.setCursor(8, 52);
display.print("Sourdough");
display.setCursor(8, 76);
display.print("800 g");
display.drawFastHLine(8, 108, 280, GxEPD_BLACK);
price();
} while (display.nextPage());
}
void drawPrice() {
display.setPartialWindow(150, 40, 146, 60);
display.firstPage();
do {
price();
} while (display.nextPage());
}
void setup() {
Serial.begin(9600);
pinMode(BUTTON, INPUT_PULLUP);
display.init(115200);
display.setRotation(1);
drawLabel();
display.hibernate();
Serial.println("label drawn");
}
void loop() {
if (digitalRead(BUTTON) == LOW) {
sale = !sale;
drawPrice();
display.hibernate();
Serial.println(sale ? "marked down" : "full price");
delay(300);
}
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
لماذا يرسم على شكل صفحات
حجم الصورة الكاملة لهذه اللوحة هو 128 × 296 ÷ 8 = 4,736 بايت، بت واحد لكل بكسل. ولدى Uno ذاكرة RAM بمقدار 2,048 بايت فقط، لذا لا يمكن الاحتفاظ بالصورة كاملة دفعة واحدة. حل GxEPD2 هو التقسيم إلى صفحات: تحتفظ بمخزن مؤقت لشريط من الشاشة، وتشغّل كود الرسم مرة واحدة لكل شريط، وترسل كل شريط فور اكتماله.
السطران في أعلى الكود يضبطان حجم ذلك المخزن على 800 بايت، وهو لهذه اللوحة 50 صفًا. و296 صفًا في شرائح من 50 يعني ست شرائح، لذا يعمل الكود داخل حلقة do ... while (display.nextPage()) ست مرات. لهذا يجب أن يكون كل ما ترسمه داخل الحلقة، وأن يرسم الشيء نفسه في كل دورة.
على ESP32، حيث تتوفر ذاكرة RAM وافرة، يمكنك إعطاء القالب الارتفاع الكامل، فتعمل الحلقة مرة واحدة فقط.
التحديث الكامل والجزئي
التحديث الكامل يمرّر كل بكسل عبر الأسود والأبيض عدة مرات، وهو الوميض الذي تراه على لوحة حقيقية. يستغرق هنا نحو ثلاث ثوانٍ ويمحو أي أثر للصورة القديمة. أما التحديث الجزئي فيغيّر نافذة معينة فقط، هنا السعر، دون وميض، في نحو 0.3 ثانية.
التحديثات الجزئية تترك آثارًا خفيفة مع الوقت، لذا تنفّذ المنتجات الحقيقية تحديثًا كاملًا من حين لآخر، لنقل كل بضع عشرات من التحديثات الجزئية. كما أن التحديث كل ثانية فكرة سيئة: فهو بطيء، وعمر اللوحة يُقاس بعدد التحديثات. تناسب شاشة e-paper الأشياء التي تتغير بين حين وآخر: سعر، حالة الطقس، قائمة مهام.
أخطاء شائعة
عدم توصيل BUSY. لا تستطيع Uno معرفة متى تنتهي اللوحة، فترسل أوامرها التالية أثناء تحديث ما يزال جاريًا، فتتجاهله اللوحة. افصل سلك BUSY في الدائرة أعلاه: ستظل الشاشة التسلسلية تعرض "label drawn"، لكن الزجاج يبقى فارغًا.
اختيار صنف اللوحة الخاطئ. تحتوي GxEPD2 على صنف لكل لوحة ومتحكم (GxEPD2_290_BS وGxEPD2_290_T94_V2 وغيرها الكثير). الصنف الخاطئ يعطي شاشة فارغة أو مشوشة أو نصف مرسومة. طابق الصنف مع ما هو مكتوب على ظهر لوحتك.
الرسم خارج حلقة الصفحات، أو رسم شيء مختلف في كل دورة. كل دورة يجب أن ترسم الصورة كاملة.
تغذيته بـ 5 فولت. اللوحة قطعة تعمل بـ 3.3 فولت. تقول لوحات وحدات Waveshare إنها تقبل منطق 3.3 أو 5 فولت؛ أما اللوحة المجردة على محوّل عادي فتريد 3.3 فولت على كل طرف.
تركها مستيقظة. استدعِ hibernate() بعد كل تحديث؛ تبقى الصورة، ولا تستهلك اللوحة شيئًا تقريبًا.
افتح هذه الدائرة في المحرر. لوحة Arduino Uno: ملصق رف بشاشة e-paper، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
افتح الدائرةالأسئلة
أي مكتبة يجب أن أستخدم لشاشة e-paper؟
GxEPD2، من إعداد Jean-Marc Zingg. تدعم معظم لوحات Waveshare وGood Display، وترسم باستدعاءات Adafruit GFX، وتتولى التقسيم إلى صفحات على اللوحات ذات ذاكرة RAM المحدودة مثل Uno.
هل تحتاج شاشة الورق الإلكتروني إلى طاقة للاحتفاظ بالصورة؟
لا. تبقى الجسيمات حيث وُضعت، لذا تبقى الصورة حتى بعد فصل الطاقة. الطاقة مطلوبة فقط لتغييرها.
كم يستغرق تحديث شاشة الورق الإلكتروني؟
يستغرق التحديث الكامل حوالي ثلاث ثوانٍ في لوحة قياس 2.9 بوصة مثل هذه؛ والتحديث الجزئي حوالي 0.3 ثانية. أما اللوحات الملونة بالأحمر أو الأصفر فتستغرق وقتًا أطول بكثير، 15 ثانية أو أكثر.
لماذا لا تتحدث شاشة الورق الإلكتروني لدي؟
تحقق أولًا من BUSY، ثم من أن فئة اللوحة تطابق لوحتك، ثم من أسلاك SPI. الفئة الخاطئة هي السبب الأكثر شيوعًا للوحة الفارغة.
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.