تعلّم

شاشة TFT لمسية مقاس 3.5 بوصة من نوع ILI9488 على لوحة ESP32

متوسط

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
ESP32 DevKit: الرسم باللمس على ILI9488مباشر0.000 s 0.00x
اضغط لفتحه في المحرر
اضغط «تشغيل» ثم ارسم على مساحة العمل. اضغط على أحد الألوان لتغيير الحبر، وعلى سطر النص للمسح. يقرأ XPT2046 مكان ضغطك، ثم يحوّله الكود إلى بكسلات.

ILI9488 هو الشريحة الموجودة في شاشات SPI الحمراء مقاس 3.5 بوصة: 320 في 480 بكسل، مع لوحة لمس مقاومة XPT2046 على اللوحة نفسها. لوحات 4 بوصة تستخدم ST7796S بنفس الدقة ونفس الأطراف الأربعة عشر. كلتاهما أكبر من أن يرسم عليها Uno بسرعة، وكلتاهما مناسبة تمامًا لـ ESP32 ومكتبة TFT_eSPI.

الدائرة أعلاه هي ESP32 DevKit مع لوحة 3.5 بوصة: صف من عينات الألوان على طول الأعلى، ومساحة عمل سوداء أسفلها. اضغط «تشغيل»، ثم اضغط على لون، ثم ارسم على الشاشة بالفأرة أو بإصبعك.

ما تحتاجه

  • لوحة ESP32 DevKit (نسخة الـ 30 أو الـ 38 طرفًا)
  • شاشة TFT SPI لمسية مقاس 3.5 بوصة ILI9488 (اللوحة الحمراء ذات الـ 14 طرفًا)، أو واحدة مقاس 4 بوصة ST7796S
  • أسلاك التوصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
VCC و LED3V3LED هو الإضاءة الخلفية
GNDGND
CSGPIO 15TFT_CS
DCGPIO 2TFT_DC، خط الأوامر أو البيانات
RSTGPIO 4TFT_RST
MOSI (SDI)GPIO 23TFT_MOSI
SCKGPIO 18TFT_SCLK
MISO (SDO)غير متصلالـ ILI9488 لا يتركه أبدًا
T_CLK و T_DINGPIO 18 و 23اللمس يتشارك الساعة ومخرج البيانات
T_CSGPIO 21TOUCH_CS، طرف اختيار شريحة اللمس
T_DOGPIO 19TFT_MISO: قراءات اللمس تعود من هنا

إعداد TFT_eSPI

لا تأخذ TFT_eSPI الشاشة وأطرافها من الكود. بل تقرأها من ملف في مجلد المكتبة، User_Setup.h، وتعدّل ذلك الملف مرة واحدة: أزل التعليق عن #define ILI9488_DRIVER واضبط TFT_MISO وTFT_MOSI وTFT_SCLK وTFT_CS وTFT_DC وTFT_RST وTOUCH_CS.

في Mokxi تُوضع الأسطر نفسها في أعلى الكود، فوق #include <TFT_eSPI.h>، بالأسماء نفسها. فهذا يبقي الإعداد كله في مكان واحد تراه. انسخها إلى User_Setup.h عندما تبني المشروع فعليًا.

للوحة مقاس 4 بوصة، غيّر ILI9488_DRIVER إلى ST7796_DRIVER. لا يتغيّر شيء آخر في الكود.

كود الرسم باللمس، جزء الإعداد
#define ILI9488_DRIVER
#define TFT_MISO 19
#define TFT_MOSI 23
#define TFT_SCLK 18
#define TFT_CS   15
#define TFT_DC    2
#define TFT_RST   4
#define TOUCH_CS 21

#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
  Serial.begin(115200);
  tft.init();
  tft.setRotation(0);  // portrait, 320x480
  tft.fillScreen(TFT_BLACK);
}

لماذا يحتاج ILI9488 ألوان 18 بت

معظم شاشات TFT الملونة تأخذ البكسل كبايتين، لون 16 بت من نوع «565»: 5 بتات للأحمر و6 للأخضر و5 للأزرق. الـ ILI9488 لا يفعل ذلك عبر SPI. تذكر ورقة بياناته بكسلات 3 بت و18 بت فقط للناقل التسلسلي، فيذهب كل بكسل كثلاثة بايتات، واحد لكل من الأحمر والأخضر والأزرق.

تعرف TFT_eSPI ذلك. مع ILI9488_DRIVER تضبط الشريحة على 18 بت وتحوّل كل لون 565 إلى ثلاثة بايتات عند إرساله، فيظل كودك يستخدم TFT_RED وcolor565(). أما مع مشغّل ILI9341 بدلًا من ذلك، تقرأ الشريحة بكسلين من كل ثلاثة تُرسل إليها، وبألوان خاطئة.

ثلاثة بايتات لكل بكسل هي أيضًا سبب بطء ILI9488. هنا، مع TFT_eSPI على ESP32، يستغرق fillScreen() مدة 261 ms على ILI9488 و192 ms على ST7796S الذي يأخذ لون 16 بت العادي. ارسم ما تغيّر فقط، لا الشاشة كلها.

قراءة لوحة اللمس

XPT2046 هي شريحة ثانية على اللوحة، ولها طرف اختيار خاص بها (T_CS). تتشارك خطي الساعة والبيانات مع الشاشة، وترد على T_DO. تخبر tft.getTouchRawZ() بقوة الضغط على اللوحة، وتعطي tft.getTouchRaw(&x, &y) رقمين خامين من حوالي 200 عند أحد حافتي الزجاج إلى حوالي 3900 عند الحافة الأخرى.

يفحص الكود الضغط أولًا، ثم يحوّل الرقمين الخام إلى بكسلات باستخدام map(). في الدوران 0 تسير أرقام X بعكس اتجاه الصورة، لذا يبدأ خريطة X من 3890 نزولًا إلى 205. على لوحة لمس حقيقية، تجد tft.calibrateTouch() الحواف من أجلك.

كود الرسم باللمس، الحلقة
void loop() {
  if (tft.getTouchRawZ() < 300) return;  // not pressed
  uint16_t rx, ry;
  tft.getTouchRaw(&rx, &ry);
  int x = constrain(map(rx, 3890, 205, 0, 319), 0, 319);
  int y = constrain(map(ry, 205, 3890, 0, 479), 0, 479);
  tft.fillCircle(x, y, 4, TFT_YELLOW);
}

تدوير الشاشة على جانبها

يدير tft.setRotation(1) الصورة ربع دورة، إلى 480 عرضًا في 320 ارتفاعًا، ويتبادل tft.width() وtft.height() ليطابقا ذلك. الدورانان 0 و2 بالوضع الرأسي، و1 و3 بالوضع الأفقي. الشريحة هي من يقوم بالتدوير: تكتب TFT_eSPI بايتًا واحدًا يسمى MADCTL يخبرها بالاتجاه الذي تسير فيه في ذاكرتها.

لوحة اللمس لا تدور معه، لأن الفيلم مثبت على الزجاج، لا على الصورة. الكود الذي يدير الشاشة عليه أن يبدّل أرقام اللمس ويعكسها بالطريقة نفسها، أو يترك tft.calibrateTouch() يحسبها لهذا الدوران.

ILI9488 أم ST7796S؟

اللوحتان متشابهتان وتستخدمان الأطراف نفسها، فالاختيار يتعلق بالحجم والسرعة. شاشة ST7796S مقاس 4 بوصة صورتها أكبر وتقبل لونًا بدقة 16 بت، فتملأ الشاشة أسرع بنحو الربع على الأسلاك نفسها. أما ILI9488 مقاس 3.5 بوصة فأصغر وأرخص وأسهل في الحصول عليها.

ينتقل الكود بينهما بسطر واحد: تعريف المشغّل. شريحة اللمس والتوصيلات وكل استدعاءات الرسم تبقى كما هي. بعض لوحات مقاس 4 بوصات هي لوحات IPS تعرض صورة سالبة حتى تضيف #define TFT_INVERSION_ON؛ اللوحة العادية TN هنا لا تحتاج إليه.

أخطاء شائعة

توصيل MISO الخاص بالشاشة مع T_DO. تحافظ شريحة ILI9488 على إشارة الخرج من طرف SDO حتى عندما لا تكون مختارة، فتعود قراءات اللمس بيانات فاسدة. اترك طرف MISO الخاص بالشاشة غير موصول.

تعريف المشغّل الخاطئ. ILI9341_DRIVER أو ST7796_DRIVER على شريحة ILI9488 يعطي ألوانًا خاطئة؛ وكذلك ILI9488_DRIVER على شريحة ST7796S.

تشغيله من لوحة Uno. يعمل مع مكتبة ILI9488، لكن 320 في 480 بكسل بثلاثة بايت لكل منها حمولة كبيرة على منفذ SPI للوحة تعمل عند 16 MHz، كما أن مكتبة TFT_eSPI لا تعمل على لوحات AVR إطلاقًا.

رسم الشاشة كاملة في كل تكرار للحلقة. حتى على ESP32، ملء الشاشة كاملة يستغرق ربع ثانية.

افتح هذه الدائرة في المحرر. لوحة ESP32 DevKit: رسم باللمس على شاشة ILI9488، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

افتح الدائرة

الأسئلة

هل تدعم مكتبة TFT_eSPI شريحة ILI9488؟

نعم. ضع #define ILI9488_DRIVER في ملف User_Setup.h (أو فوق سطر التضمين، في Mokxi). ترسل ألوانًا بدقة 18 بت، وهي صيغة الألوان الكاملة الوحيدة التي تقبلها ILI9488 عبر SPI.

ما الفرق بين ILI9488 و ST7796S؟

كلتاهما متحكمات شاشات TFT بمنفذ SPI بدقة 320x480 على لوحات لمس بـ 14 طرفًا. شريحة ST7796S (عادة 4 بوصات) تقبل لونًا بدقة 16 بت مثل ILI9341، فتملأ أسرع؛ وشريحة ILI9488 (عادة 3.5 بوصات) تقبل اللون بدقة 18 بت فقط.

لماذا تظهر الألوان خاطئة على شريحة ILI9488 لديّ؟

غالبًا يستخدم الكود مشغّل ILI9341، الذي يرسل لونًا بدقة 16 بت. استخدم ILI9488_DRIVER في مكتبة TFT_eSPI، أو مكتبة ILI9488.

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

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