Arduino'da e-kağıt ekran: bir raf fiyat etiketi
Orta
Ya da tüm dersleri gör.
- 526parça tezgahta
- 46kart şu an çalışıyor
- 1.00xgerçek zamanlı, her kartta
E-kağıt (e-ink de denir), e-okuyucularda ve elektronik raf etiketlerinde kullanılan ekrandır. Basılı kâğıda benzer, güneş ışığında iyi okunur ve güç kapalıyken görüntüsünü korur, böylece bir etiket bir pil ile yıllarca fiyat gösterebilir. Tek sorun hız: tam yenileme saniyeler sürer.
Yukarıdaki devre, bir dükkân rafındaki fiyat etiketi gibi, GxEPD2 kütüphanesi ile 2.9 inç, 296'a 128 piksel e-kağıt panelini süren bir Uno. Etiketi tam yenilemeyle bir kez çizer, sonra paneli uyku moduna alır. Butona basarsan fiyatı, yalnızca fiyatın hızlı kısmi yenilemesiyle düşürür. Çalıştır'a bas ve yaklaşık altı saniye ver.
Neye ihtiyacın var?
- Bir Arduino Uno
- 2.9 inç SPI e-kağıt modülü, 296x128, SSD1680 (Waveshare gibi)
- Bir buton
- Bir breadboard ve jumper kablolar
Kablolama
| Parça ve pin | Gittiği yer | Not |
|---|---|---|
| e-kağıt VCC | 3.3 V | Panel 2.2 ile 3.7 V arasında çalışır |
| e-kağıt GND | GND | |
| e-kağıt SDA (DIN) | Pin 11 | SPI veri (MOSI) |
| e-kağıt SCL (CLK) | Pin 13 | SPI saati |
| e-paper CS | Pin 10 | |
| e-paper DC | Pin 9 | Komut ya da veri |
| e-paper RES (RST) | Pin 8 | |
| e-paper BUSY | Pin 7 | Panel yenilenirken yüksek kalır |
| Buton | Pin 2 ve GND | INPUT_PULLUP, yani basılıyken LOW okunur |
E-paper nasıl çalışır
Panelin içinde, zıt yüklü siyah ve beyaz partiküllerden oluşan milyonlarca minik kapsül var. Bir pikselin üzerine uygulanan voltaj siyahları ya da beyazları üste çeker ve voltaj kalkınca da orada kalırlar. Resmin gücü kesilmişken kalıcı olmasının ve değişmesinin biraz zaman almasının sebebi budur: partiküllerin hareket etmesi gerekir.
Panelin kendi denetleyicisi var, burada bir SSD1680, ve resim için belleği var. Arduino yeni resmi SPI üzerinden o belleğe yazar, sonra denetleyiciye yenileme komutunu verir. Yenileme sürerken denetleyici BUSY pinini yüksek tutar ve gönderdiklerini yok sayar.
Kod
Ekran GxEPD2_290_BS(10, 9, 8, 7) ile kurulur: CS, DC, RES ve BUSY. GxEPD2, Adafruit GFX çağrılarıyla, bir firstPage() / nextPage() döngüsünün içinde çizim yapar. Ardından hibernate() denetleyiciyi derin uykuya alır; orada hiçbir şey çizmez ve resim camda kalır.
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);
}
}Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.
Neden sayfalar halinde çiziyor
Bu panel için tam bir resim 128 x 296 / 8 = 4.736 bayttır, piksel başına bir bit. Uno'nun toplam 2.048 bayt RAM'i var, yani resim tek seferde tutulamaz. GxEPD2'nin çözümü sayfalama: ekranın bir şeridi için tampon tutar, çizim kodunu her şerit için bir kez çalıştırır ve her şeridi tamamlandıkça gönderir.
Kodun üstündeki iki satır bu tamponu 800 bayta ayarlar; bu da bu panel için 50 satır demektir. 296 satırın 50'lik şeritlerle altı şeridi olur, yani do ... while (display.nextPage()) döngüsünün içindeki kod altı kez çalışır. Bu yüzden çizdiğin her şeyin döngünün içinde olması ve her turda aynı şeyi çizmesi gerekir.
Bol RAM'li bir ESP32'de şablona tam yüksekliği verebilirsin ve döngü bir kez çalışır.
Tam ve kısmi yenileme
Tam yenileme her pikseli birkaç kez siyahtan beyaza sürer; gerçek bir panelde gördüğün parlama budur. Burada yaklaşık üç saniye sürer ve eski resmin hayaletini tamamen siler. Kısmi yenileme ise parlama olmadan yalnızca bir pencereyi, burada fiyatı, yaklaşık 0,3 saniyede değiştirir.
Kısmi yenilemeler zamanla soluk hayaletler bırakır, bu yüzden gerçek ürünler arada bir, mesela her birkaç düzine kısmi yenilemede bir, tam yenileme yapar. Ve her saniye yenilemek kötü bir fikirdir: hem yavaştır hem de panelin ömrü yenileme sayısıyla ölçülür. E-kağıt ara sıra değişen şeylere uyar: fiyat, hava durumu, bir yapılacaklar listesi.
Sık yapılan hatalar
BUSY bağlanmamış. Uno panelin işini bitirip bitirmediğini anlayamaz, bu yüzden sonraki komutlarını hâlâ süren bir yenilemeye gönderir ve panel bunları yok sayar. Yukarıdaki devrede BUSY kablosunu çıkar: seri monitör yine "etiket çizildi" der ama cam boş kalır.
Yanlış panel sınıfı. GxEPD2'nin her panel ve denetleyici için bir sınıfı var (GxEPD2_290_BS, GxEPD2_290_T94_V2 ve daha birçokları). Yanlış olanı boş, gürültülü ya da yarım çizilmiş bir ekran verir. Sınıfı panelinin arkasıyla eşleştir.
Sayfa döngüsünün dışında çizmek ya da her turda farklı bir şey çizmek. Her turun resmin tamamını çizmesi gerekir.
5 V ile beslemek. Panel 3.3 V'luk bir parçadır. Waveshare'ın modül kartları 3.3 V ya da 5 V mantık kabul ettiklerini söyler; düz bir adaptördeki çıplak panel her pinden 3.3 V ister.
Uyanık bırakmak. Her yenilemeden sonra hibernate() çağır; resim kalır ve panel neredeyse hiçbir şey çizmez.
Bu devreyi düzenleyicide aç. Arduino Uno: bu sayfanın üstünde çalıştığı haliyle kablolanmış bir e-paper raf etiketi. Bir parçayı ya da değeri değiştir ve yeniden çalıştır.
Devreyi açSorular
E-paper ekran için hangi kütüphaneyi kullanmalıyım?
Jean-Marc Zingg'in GxEPD2'si. Waveshare ve Good Display panellerinin çoğunu destekler, Adafruit GFX çağrılarıyla çizim yapar ve Uno gibi az RAM'li kartlarda sayfalama işini halleder.
E-paper ekran görüntüyü korumak için güç ister mi?
Hayır. Parçacıklar bırakıldıkları yerde kalır, yani görüntü güç kapalıyken de kalır. Güç sadece görüntüyü değiştirmek için gerekir.
E-paper yenilemesi ne kadar sürer?
Bunun gibi 2.9 inç bir panelde tam yenileme yaklaşık üç saniye sürer; kısmi yenileme yaklaşık 0.3 saniye. Kırmızı veya sarılı renkli paneller çok daha uzun sürer, 15 saniye veya daha fazla.
E-paper ekranım neden güncellenmiyor?
Önce BUSY'yi kontrol et, sonra panel sınıfının paneline uyduğunu, sonra da SPI kablolarını. Boş panelin en yaygın nedeni yanlış sınıftır.
Devam et
Bunu gerçekten kur
Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.