تعلّم

شاشة GC9A01 الدائرية على Arduino: واجهة ساعة

متوسط

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: واجهة ساعة على شاشة GC9A01مباشر0.000 s 0.00x
اضغط لفتحه في المحرر
شاشة GC9A01 دائرية مقاس 240x240 على SPI ووحدة DS3231 على I2C، ترسم ساعة بعقارب على ATmega328P مُحاكى.

شاشة GC9A01 هي المتحكم الذي يقف خلف شاشات الألوان الدائرية مقاس 1.28 بوصة المستخدمة في الساعات المنزلية والمقاييس وأعين الروبوتات. الزجاج دائرة قطرها 240 بكسل، وتتواصل عبر SPI، واستدعاءات الرسم هي نفس استدعاءات Adafruit GFX التي قد تعرفها من الشاشات الملونة الأخرى.

الدائرة أعلاه هي Uno ترسم ساعة بعقارب على شاشة GC9A01، مع الوقت من وحدة ساعة DS3231. ترسم القرص مرة واحدة، ثم تحرّك العقارب كل ثانية. اضغط «تشغيل»: يستغرق القرص بضع ثوانٍ ليظهر، لأن لدى Uno الكثير من البكسلات لإرسالها، ثم تبدأ عقربة الثواني بالحركة.

ما تحتاجه

  • Arduino Uno
  • وحدة شاشة GC9A01 دائرية مقاس 1.28 بوصة
  • وحدة ساعة DS3231
  • لوحة تجارب وأسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
GC9A01 VCC5 Vللوحدة منظم جهد خاص بها
GC9A01 GNDGND
GC9A01 SCLالطرف 13ساعة SPI، رغم أنها مكتوبة SCL
GC9A01 SDAالطرف 11بيانات SPI‏ (MOSI)، رغم أنها مكتوبة SDA
GC9A01 CSالطرف 10تحديد الشريحة
GC9A01 DCالطرف 9أمر أم بيانات
GC9A01 RESلا شيءتُرك حرًّا؛ المكتبة تعيد ضبطه بأمر
DS3231 SDA, SCLA4, A5الساعة، على I2C

SCL وSDA، لكنها ليست I2C

التسميات على معظم وحدات GC9A01 تقول SCL وSDA، مما يجعل الجميع يفكر في I2C. لكنها SPI.‏ SCL هي ساعة SPI وتذهب إلى الطرف 13 على Uno، وSDA هي مدخل البيانات وتذهب إلى الطرف 11.‏ CS يختار الشاشة وDC يخبرها إن كان البايت أمرًا أم بكسلًا.

يبقى A4 وA5، أطراف I2C الحقيقية على Uno، حُرّين لوحدة DS3231. الناقلان لا يتعارضان مع بعضهما.

مكتبة Adafruit GC9A01A

ثبّت "Adafruit GC9A01A" من مدير المكتبات، وستأتي معها Adafruit GFX. في Mokxi كلتاهما مدمجتان. يأخذ المُنشئ CS وDC، وهنا Adafruit_GC9A01A tft(10, 9)، مع طرف إعادة ضبط اختياري في الثالث. begin() يرسل جدول بدء التشغيل الطويل، ويوقظ اللوحة ويشغلها.

بعد ذلك ترسم باستخدام GFX:‏ fillScreen() وdrawLine() وdrawCircle() وfillCircle() وsetCursor() وprint(). الألوان أعداد من 16 بت، بأسماء مثل GC9A01A_BLACK وGC9A01A_WHITE وGC9A01A_RED.

الذاكرة مربع 240 في 240، والزجاج الدائري يجلس فوقه. المركز عند (120, 120) ونصف القطر 120، لذا أي شيء ترسمه في الزوايا يُخزَّن لكن لا أحد يراه.

من كود واجهة الساعة الدائرية
#include <SPI.h>
#include <Wire.h>
#include "Adafruit_GFX.h"
#include "Adafruit_GC9A01A.h"

Adafruit_GC9A01A tft(10, 9);  // CS, DC; no reset pin

const int16_t CX = 120;
const int16_t CY = 120;
const uint16_t FACE = GC9A01A_BLACK;

void hand(uint8_t i, int16_t radius, uint16_t color) {
  tft.drawLine(CX, CY, dialX(i, radius), dialY(i, radius), color);
}

void setup() {
  tft.begin();
  drawFace();
  Wire.begin();
}

void loop() {
  // Rub out the old hands, then draw the new ones, longest last.
  if (!first) {
    hand(secondPos, 95, FACE);
    hand(minutePos, 85, FACE);
    hand(hourPos, 55, FACE);
  }
  hourPos = (now[2] % 12) * 5 + now[1] / 12;
  minutePos = now[1];
  secondPos = now[0];

  hand(hourPos, 55, GC9A01A_WHITE);
  hand(minutePos, 85, GC9A01A_WHITE);
  hand(secondPos, 95, GC9A01A_RED);
}

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

ارسم ما يتحرك، لا الشاشة كاملة

الشاشة الكاملة 240 في 240 بكسلًا ببايتين لكل بكسل: 115,200 بايت. هذا أكثر من خمسين ضعف ذاكرة Uno، لذا لا تستطيع Uno الاحتفاظ بنسخة من الشاشة. ترسل البكسلات مباشرة إلى الشاشة أثناء رسمها. في الدائرة هنا، ملء الشاشة بالأسود ورسم القرص يستغرق نحو ثلاث ثوانٍ، ولهذا تظهر الواجهة بعد قليل من ضغطك «تشغيل».

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

تأتي العقارب من جدول صغير لقيم الجيب بخطوات 6 درجات، دقيقة واحدة من القرص. تبدأ DS3231 عند 10:08:30، لذا تشير عقربة الدقائق إلى علامة الدقيقة 8 وعقربة الساعات إلى الموضع 50 على القرص، وهو (10 x 5) زائد 8 / 12 مقربًا إلى الأسفل.

الوقت من DS3231

لا يستخدم الكود مكتبة RTC. يقرأ أول ثلاثة سجلات في DS3231 عبر Wire: الثواني والدقائق والساعات، بدءًا من السجل 0. تخزن الشريحة كل قيمة كرقمين عشريين محشوين في بايت واحد، ويسمى BCD، لذا يحوّل fromBcd() القيمة 0x38 إلى 38 قبل أن يستخدمها الكود.

يقرأ loop() الساعة كل 20 ميلي ثانية ولا يعيد الرسم إلا عندما تتغير الثواني. هكذا تتحرك العقارب مرة كل ثانية، وتبقى الشاشة خاملة بقية الوقت. إذا لم تُجب الساعة، يعيد readClock() القيمة false ويحاول الكود مرة أخرى بعد 20 ميلي ثانية.

الألوان والتدوير والنص

زجاج GC9A01 من نوع IPS، ويعرض الألوان معكوسة حتى يخبره المشغّل بغير ذلك. تفعل المكتبة ذلك في begin()، لذا لن ترى ذلك إلا إذا كتبت مشغّلك الخاص: الأسود يظهر أبيض. الألوان 16 بت، خمس منها للأحمر وست للأخضر وخمس للأزرق، ولهذا يكون الأحمر الصافي 0xF800.

setRotation() يدير الصورة بخطوات 90 درجة، وهو مفيد عند تركيب الوحدة بالمقلوب. يعمل النص مع setCursor() وsetTextColor() وprint()، وهي نفس استدعاءات GFX كما على الشاشات الملونة الأخرى؛ في Mokxi الخط مقاس 5x8.

إذا وصّلت طرف إعادة ضبط، مرره كوسيطة ثالثة: Adafruit_GC9A01A tft(10, 9, 8). هناك أيضًا صيغة بخمسة أطراف تأخذ طرفي البيانات والساعة أيضًا، لـ SPI البرمجي على أي أطراف، على حساب السرعة.

أخطاء شائعة

توصيل SCL وSDA بـ A5 وA4 لأن التسميات توحي بـ I2C. على Uno تذهبان إلى الطرفين 13 و11.

إعادة رسم الشاشة كاملة في loop(). يعمل، لكن ببطء، ووميض. امحُ وأعد رسم الأجزاء المتغيرة فقط.

الرسم في زوايا ذاكرة الشاشة المربعة، خارج الزجاج الدائري.

ترك وحدة الساعة دون توصيل وتوقع قراءة وقت. وصّل سلك SDA الخاص بـ DS3231 هنا وسيظل القرص يُرسم، لكن العقارب لن تظهر أبدًا، لأن الكود ينتظر وقتًا لن يصله أبدًا.

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

افتح الدائرة

الأسئلة

أي مكتبة أستخدم لشاشة GC9A01 على Arduino؟

Adafruit GC9A01A (Adafruit_GC9A01A.h) مع Adafruit GFX. تدعم TFT_eSPI أيضًا شاشة GC9A01، خصوصًا على لوحات ESP32.

هل تعمل GC9A01 عبر SPI أم I2C؟

SPI. الأطراف المسمّاة SCL و SDA هي إشارة الساعة والبيانات في SPI، لذا توصل بالطرفين 13 و 11 على لوحة Uno.

ما دقة الشاشة الدائرية GC9A01؟

240 في 240 بكسل، مع الزجاج الدائري متمركزًا عند (120, 120) ونصف قطره 120.

لماذا تكون شاشة GC9A01 بطيئة على Arduino Uno؟

الشاشة الكاملة هي 115,200 بايت، ولوحة Uno ترسلها بايتًا تلو الآخر عبر SPI. ارسم ما يتغيّر فقط، كما تفعل واجهة الساعة مع عقاربها.

المصادر

من أين جاءت الحقائق في هذه الصفحة

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

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