تعلّم

ارسم على شاشة SSD1306 OLED بواسطة لوحة Arduino

متوسط

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: شاشة SSD1306 OLEDمباشر0.000 s 0.00x
اضغط لفتحه في المحرر
مثال oled: شاشة SSD1306 بدقة 128x64 على A4 و A5، ترسم نصًا وأشكالًا وكرة نطاطة.

شاشة SSD1306 OLED مقاس 0.96 بوصة هي الشاشة الصغيرة الموجودة في كل مجموعة هواة: 128 في 64 بكسل، أربعة أطراف، أبيض نقي على أسود. الدائرة في الأعلى شاشة على لوحة Arduino Uno، ترسم عنوانًا وبعض الأشكال وعدادًا وكرة تنط داخل صندوق. تعمل على Uno محاكاة، وتُفكّ رموز الشاشة من حركة I2C الفعلية على السلكين، بتًا ببت، لا من اختصار.

افتحها في المحرر لتغيير كود الرسم وشغّلها مرة أخرى. تستغرق الترجمة ثانية أو ثنتين، في المتصفح.

ما تحتاجه

  • Arduino Uno
  • وحدة شاشة SSD1306 OLED بدقة 128x64، نسخة I2C
  • أربعة أسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
OLED SDAA4
OLED SCLA5
OLED VCC5 Vمعظم الوحدات تقبل 3.3 فولت أو 5 فولت
OLED GNDGND

كود Adafruit

كود الدرس التعليمي الخاص بـ SSD1306 من Adafruit يُترجم هنا كما هو دون أي تغيير، على كل لوحة باستثناء ATtiny85. ملفات الترويسة هي من Mokxi نفسه، مكتوبة على معرّض الشاشة الخاص به، وتحتفظ بالاستدعاءات التي تستخدمها الدروس التعليمية: clearDisplay() و display() و drawPixel() والخطوط والمستطيلات والمستطيلات المستديرة الأركان والدوائر والمثلثات والصور النقطية و setTextSize() و setCursor() و print() و setRotation() و invertDisplay().

هناك فرقان عن المكتبة الأصلية يجدر بك معرفتهما قبل أن تبدأ. الخط هو خط Mokxi الخاص بمقاس 5 في 7، ويضم الأحرف الكبيرة والأرقام وعلامات الترقيم، لذا تُطبع الأحرف الصغيرة كأحرف كبيرة. كما أن begin() تترك اللوحة فارغة بينما ترسم المكتبة الأصلية شعارها.

كتابة Hello على شاشة SSD1306 باستدعاءات مكتبة Adafruit
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

Adafruit_SSD1306 display(128, 64, &Wire, -1);

void setup() {
  if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) for (;;);
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0, 0);
  display.println("Hello, world!");
  display.drawRect(0, 20, 40, 20, SSD1306_WHITE);
  display.display();
}

void loop() {}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

لماذا لا يظهر أي شيء قبل display()

لا يمكن قراءة محتوى اللوحة مرة أخرى. لذا فإن أي مشغّل (driver) يريد تغيير بكسل واحد عليه أن يتذكر البايتات الأخرى البالغ عددها 1023 من الإطار، ويحتفظ بهذه النسخة في ذاكرة اللوحة نفسها. كل استدعاء رسم يكتب في تلك النسخة؛ أما display() فهي التي ترسلها إلى اللوحة. انسَ display() وتكون قد رسمت صورة مثالية في ذاكرة RAM لن يراها أحد أبدًا.

That copy is 1 KB, which is half the Uno’s entire 2 KB of SRAM. It is the real cost of a pixel display on an ATmega328P, and the reason big sketches with an OLED run out of memory. The built-in example also shows a way to go faster: it sends only the 8-column blocks of the screen that changed, so a moving ball is a few dozen bytes on the bus rather than a full kilobyte. Over the Uno’s software I2C a full 1 KB frame takes about a third of a second, which is the difference between two frames a second and the twenty-five this sketch manages.

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

افتح الدائرة في المحرر وحدد الشاشة. غيّر عنوانها من 0x3C إلى 0x3D ثم اضغط «تشغيل» مرة أخرى. ستقول الشاشة التسلسلية إنه لا يوجد OLED استجاب، وتبقى اللوحة مظلمة، وهذا هو أول عطل شائع مع هذه الوحدات.

ثم استبدل المثال بكود Adafruit أعلاه، وأضف بضع استدعاءات رسم أخرى: دائرة، ومثلث مملوء، وسطرًا من نص كبير باستخدام setTextSize(2)، وشغّله. تستغرق كل عملية بناء لحظة في المتصفح ثم تعرض اللوحة تمامًا ما رسمه الكود.

للحصول على صورة متحركة، أعد الرسم داخل loop() واستدعِ display() مرة واحدة لكل إطار. الكرة المرتدة في المثال توضح حيلة مسح ما تحرك فقط.

أخطاء شائعة

العنوان الخاطئ. معظم الوحدات تستجيب عند 0x3C؛ وبعضها مضبوط على 0x3D. لا يظهر أي شيء عند العنوان الخاطئ، وكود فحص I2C يخبرك أيهما الصحيح.

إرسال أمر تشغيل الشاشة دون مضخة الشحن. تحتاج اللوحة إلى نحو 7.5 فولت، تصنعها مضخة داخل الشريحة تبدأ مطفأة. أي مشغّل مكتوب يدويًا يرسل أمر تشغيل الشاشة وينسى تشغيل المضخة سيحصل على شاشة سوداء. اللوحة المحاكاة تمثل المضخة، لذا يحدث هذا العطل هنا أيضًا. المكتبة تتولى ذلك عنك.

نفاد الذاكرة في Uno. مع مخزن الإطار الذي يستهلك 1 KB، قد ينهار كود يحتوي مصفوفات كبيرة أو سلاسل نصية طويلة في RAM بطرق غريبة. احفظ السلاسل الثابتة في ذاكرة flash.

انتظار التمرير عبر العتاد. تُقبل أوامر تمرير اللوحة ويتم تجاهلها في الشاشة المحاكاة، لذا يبقى الشريط المتحرك ثابتًا هنا. مرّر بإعادة الرسم بدلًا من ذلك.

افتح هذه الدائرة في المحرر. Arduino Uno: شاشة SSD1306 OLED، موصّلة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة واضغط «تشغيل» مرة أخرى.

افتح الدائرة

الأسئلة

ما هو عنوان I2C لشاشة SSD1306 OLED؟

عادة 0x3C، وأحيانًا 0x3D، ويُحدد بمقاومة أو جسر ملحم على ظهر الوحدة. الوحدة المحاكاة لها العنوان كخاصية.

هل يمكنني استخدام شاشة SSD1306 OLED مع ESP32؟

نعم، بنفس استدعاءات المكتبة على أطراف I2C الخاصة بـ ESP32 نفسه. توجد أمثلة مدمجة لـ ESP32 مع شاشة OLED، منها هذا العرض نفسه للنصوص والأشكال، ولعبة مضرب على ESP32-C3.

لماذا يظهر نص OLED لدي بأحرف كبيرة فقط؟

لأن المكتبة المحاكاة تستخدم خط Mokxi بمقاس 5 في 7، الذي يحتوي على الأحرف الكبيرة والأرقام وعلامات الترقيم فقط. على العتاد الحقيقي يحتوي خط Adafruit على الأحرف الصغيرة.

هل الشاشة في المحاكي صورة أم البروتوكول الحقيقي؟

البروتوكول الحقيقي. القطعة جهاز I2C يُفك ترميزه من حواف الأطراف، مع مجموعة الأوامر التي ترسلها المكتبات الشائعة وذاكرة عرض خاصة به حجمها 1 KB.

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

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