شاشة ST7735 ملونة على لوحة Arduino
متقدم
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
شريحة ST7735 هي الشريحة خلف شاشات الألوان الرخيصة مقاس 1.8 بوصة: 128 في 160 بكسل، و65,536 لونًا، على لوحة حمراء مع فتحة بطاقة SD في الخلف. تتخاطب عبر SPI، فتحتاج إلى طرف ساعة وطرف بيانات وبعض أطراف التحكم، وتتكفل مكتبة Adafruit ST7735 بالباقي.
الدائرة أعلاه هي لوحة Uno مع شاشتين ملونتين: شاشة ST7735 مقاس 1.8 بوصة على أطراف SPI المدمجة في Uno، وشاشة ST7789 مقاس 1.3 بوصة على أطراف خاصة بها. كل شاشة تعرض عنوانًا، ثم يمشي مربع صغير عبرها بلون يتغير أثناء الحركة. اضغط «تشغيل» ولاحظ إضاءة ST7735 أولًا، ثم ST7789 بعد نحو ثانيتين.
ما تحتاجه
- Arduino Uno
- شاشة ST7735 TFT مقاس 1.8 بوصة، بدقة 128x160 (اللوحة الحمراء ذات SPI)
- شاشة ST7789 TFT مقاس 1.3 بوصة، بدقة 240x240 (اختيارية، للنصف الثاني)
- لوحة تجارب وأسلاك توصيل
التوصيل
| القطعة والطرف | يتصل بـ | ملاحظة |
|---|---|---|
| ST7735 VCC | 5 V | اللوحة الحمراء تحتوي على منظم جهد للشريحة |
| ST7735 GND | GND | |
| ST7735 SCK | الطرف 13 | ساعة SPI المدمجة |
| ST7735 SDA | الطرف 11 | بيانات SPI (MOSI). ليست I2C، مهما قال المسمّى |
| ST7735 CS | الطرف 10 | تحديد الشريحة |
| ST7735 A0 | الطرف 9 | ما تسميه اللوحات الأخرى DC: أمر أو بيانات |
| ST7735 RESET | الطرف 8 | |
| ST7735 LED | 5 V | الإضاءة الخلفية |
| ST7789 SCL و SDA | A1 و A0 | SPI برمجية على أي أطراف |
| ST7789 DC و RES | الطرفان 7 و6 | هذه اللوحة لا تحتوي على طرف CS |
كيف يتم التحكم في الشاشة
تحتفظ شريحة ST7735 بالصورة كاملة في ذاكرتها الخاصة، بعمق 16 بت لكل بكسل. للرسم، ترسل Uno أمرًا يحدد نافذة (نطاقًا من الأعمدة، ثم نطاقًا من الصفوف) ثم تبث ألوان كل بكسل فيها. لهذا يكون المربع المملوء سريعًا والصورة الكاملة بطيئة: فالبايتات يجب أن تمر عبر السلك في الحالتين.
يخبر الطرف A0 (المسمى DC في معظم اللوحات الأخرى) الشريحة أي البايتات أوامر وأيها بكسلات: مستوى منخفض للأمر، ومستوى مرتفع للبيانات. ومستوى CS المنخفض يعني "هذه الرسالة موجهة إليك". المكتبة تتحكم في الاثنين نيابة عنك، لكن إذا ارتخى أي من السلكين فلن تفهم الشريحة شيئًا وتبقى الشاشة معتمة.
Colors are 16-bit "565" numbers: 5 bits of red, 6 of green and 5 of blue. ST77XX_GREEN and the other names are ready-made ones, and color565(r, g, b) turns three 0 to 255 values into one, which is how the sketch makes its changing square.
الكود
الدالة Adafruit_ST7735 small(10, 9, 8) تستقبل CS و DC و RESET وتستخدم SPI المدمجة في Uno للساعة والبيانات، على الطرفين 13 و 11. والدالة initR(INITR_BLACKTAB) توقظ الشريحة وتجهزها للوحة، ثم تقوم استدعاءات Adafruit GFX المعتادة بالرسم: fillScreen و setCursor و print و fillRect.
تستخدم ST7789 الباني ذا الأرقام الخمسة، Adafruit_ST7789 square(-1, 7, A0, A1, 6): بدون CS (-1)، و DC على الطرف 7، والبيانات على A0، والساعة على A1، و RES على الطرف 6. وبما أنها تحصل على طرفي ساعة وبيانات خاصين بها، ترسل المكتبة كل بت يدويًا، وهذا يعمل على أي أطراف لكنه أبطأ بكثير من SPI المدمجة. هذا، مع طول زمن إقلاع ST7789، هو سبب إضاءتها بعد نحو ثانيتين من ST7735.
#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Adafruit_ST7789.h>
Adafruit_ST7735 small(10, 9, 8);
Adafruit_ST7789 square(-1, 7, A0, A1, 6); // no CS; DC, SDA, SCL, RES
void setup() {
small.initR(INITR_BLACKTAB);
small.fillScreen(ST77XX_BLACK);
small.setTextColor(ST77XX_GREEN);
small.setCursor(4, 4);
small.print("ST7735 128X160");
square.init(240, 240, SPI_MODE3);
square.setRotation(2);
square.fillRect(0, 0, 240, 40, ST77XX_BLUE);
square.setTextColor(ST77XX_WHITE);
square.setTextSize(2);
square.setCursor(8, 12);
square.print("ST7789 IPS");
}
void loop() {
// A block that walks around each screen, in a color that changes as it goes.
static uint8_t step = 0;
uint16_t color = Adafruit_ST7789::color565((uint8_t)(step * 16), 255 - step * 16, 128);
small.fillRect((int16_t)(8 + (step % 8) * 14), 40, 12, 12, color);
square.fillRect((int16_t)(10 + (step % 8) * 28), 120, 24, 24, color);
step = (uint8_t)((step + 1) % 16);
delay(100);
}افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.
لسان أسود، لسان أخضر، لسان أحمر
ذاكرة الشريحة مقاسها 132 في 162، أي أكبر قليلًا من زجاج مقاس 128 في 160، وتثبّت المصنّعون الزجاج في مواضع متباينة قليلًا داخلها. وتدلّلك على المواضع بلون اللسان على الفيلم الواقي للشاشة، وتتضمن المكتبة إعداد initR لكل لون: INITR_BLACKTAB وINITR_GREENTAB وINITR_REDTAB، بالإضافة إلى INITR_144GREENTAB للمربّعة منها مقاس 1.44 بوصة.
إذا اخترت القيمة الخطأ تنزاح الصورة: شريط ضجيج أو سواد على حافّتين، أو تبديل الأحمر والأزرق. إن كان هذا ما تراه، جرّب بقية الألسنة قبل أن تشك في التوصيلات. نزعت الفيلم وضاع اللسان؟ جرّبها واحدًا تلو الآخر؛ واحد منها سيرسم حواف نظيفة.
ST7735 أم ST7789؟
تتحدث ST7789 تقريبًا نفس الأوامر، لذا لا يتغير الكود كثيرًا، لكنها تتحكم في زجاج IPS أكبر وأوضح: 240 في 240 على اللوحات المربعة مقاس 1.3 بوصة، و240 في 320 على غيرها. لوحات IPS تبدو نفسها من أي زاوية، بينما الزجاج الأرخص في ST7735 يبهت عند الميل.
كثير من لوحات ST7789 مقاس 1.3 بوصة لا تحتوي على طرف CS، لذا تستمع الشريحة إلى كل نبضة ساعة تصل على أسلاكها. إذا وضعت واحدة على ناقل SPI نفسه مع شاشة أخرى، فستعتبر بايتات تلك الشاشة بايتاتها، ولهذا تستخدم الشاشة هنا أطرافًا خاصة بها. كما أنها تحتاج إلى SPI mode 3، وهو الرقم الثالث في init(240, 240, SPI_MODE3).
وللحصول على شاشة أكبر، تستخدم اللوحات مقاس 2.4 و2.8 بوصة شريحة ILI9341 بدقة 240 في 320، مع لمس على كثير منها. توجد صفحة عنها أدناه.
أخطاء شائعة
شاشة معتمة مع إضاءة خلفية مشتعلة. عادة يكون A0 (DC) أو CS غير موصّل، أو موصّل بالطرف الخطأ. اسحب أي منهما في الدائرة أعلاه ولن تعرض ST7735 شيئًا أبدًا.
التعامل مع SDA و SCK كأنهما I2C بسبب الأسماء. إنهما SPI: يوصل SDA إلى الطرف 11 (MOSI) و SCK إلى الطرف 13 على لوحة Uno.
لسان initR الخطأ، مما يعطي صورًا منزاحة أو حواف مشوشة. جرّب البقية.
تغذية أطراف الإشارة بجهد 5 V بشكل دائم. منظم الجهد في اللوحة الحمراء يزود الشريحة بجهد 3.3 V، لكن أطراف الإشارة تدخل الشريحة مباشرة، وST7735 قطعة تعمل بجهد 3.3 V. كثيرون يشغّلونها من Uno بجهد 5 V رغم ذلك؛ المحوّل المستوي للجهد، أو لوحة تعمل بجهد 3.3 V، هو الطريق الآمن.
ترك RESET طائرًا. في الدائرة أعلاه يبدأ الكود مع RESET غير موصّل، لأن initR يرسل إعادة تعيين برمجية أولًا، لكن الطرف الطائر على لوحة حقيقية قد يلتقط ضجيجًا ويعيد تعيين الشريحة عشوائيًا. وصّله بطرف أو بـ VCC.
إعادة رسم الشاشة كاملة في كل دورة. تعبئة 128 في 160 كاملة تعني 40,960 بايت عبر السلك؛ ارسم فقط ما تغيّر.
افتح هذه الدائرة في المحرر. لوحة Arduino Uno مع ST7735 و ST7789، موصولتين كما تعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
افتح الدائرةالأسئلة
كيف أصل شاشة ST7735 بلوحة Arduino Uno؟
VCC إلى 5 V، و GND إلى GND، و SCK إلى 13، و SDA إلى 11، و CS إلى 10، و A0 (DC) إلى 9، و RESET إلى 8، و LED إلى 5 V. ثم Adafruit_ST7735 tft(10, 9, 8) و tft.initR(INITR_BLACKTAB).
أي مكتبة أحتاج لشاشة ST7735؟
مكتبة Adafruit ST7735 and ST7789 Library، مع Adafruit GFX لاستدعاءات الرسم. المكتبة نفسها تتحكم في الشريحتين.
لماذا شاشة ST7735 عندي بيضاء أو فارغة؟
الشاشة البيضاء هي الإضاءة الخلفية بلا أي رسم: تحقق من CS و A0 (DC) و RESET، ومن أن الكود يستدعي initR. الصور المنزاحة أو الحواف المشوشة تعني إعداد اللسان الخطأ.
هل يمكنني استخدام فتحة بطاقة SD على الظهر؟
نعم، على لوحة حقيقية: تشارك SCK و MOSI و MISO، مع طرف CS خاص بها. اللوحة في المحاكي لا تتضمن بطاقة SD.
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.