Tampilan e-paper di Arduino: label harga rak
Menengah
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
E-paper (disebut juga e-ink) adalah layar di pembaca e-book dan label harga elektronik. Tampilannya seperti kertas cetak, mudah dibaca di bawah matahari, dan gambarnya tetap ada meski daya dimatikan, jadi sebuah label bisa menampilkan harga bertahun-tahun dengan baterai koin. Kelemahannya adalah kecepatan: full refresh memakan waktu beberapa detik.
Rangkaian di atas adalah Uno yang menggerakkan panel e-paper 2,9 inci, 296 kali 128 piksel, dengan library GxEPD2, sebagai label harga di rak toko. Ia menggambar label sekali dengan full refresh, lalu memasukkan panel ke mode tidur. Tekan tombolnya dan ia menurunkan harga dengan partial refresh cepat pada bagian harga saja. Tekan Jalankan dan beri waktu sekitar enam detik.
Yang kamu butuhkan
- Arduino Uno
- Modul e-paper SPI 2,9 inci, 296x128, SSD1680 (misalnya buatan Waveshare)
- Sebuah tombol tekan
- Breadboard dan kabel jumper
Pengkabelan
| Komponen dan pin | Disambung ke | Catatan |
|---|---|---|
| e-paper VCC | 3.3 V | Panel berjalan pada 2,2 sampai 3,7 V |
| e-paper GND | GND | |
| e-paper SDA (DIN) | Pin 11 | Data SPI (MOSI) |
| e-paper SCL (CLK) | Pin 13 | Clock SPI |
| e-paper CS | Pin 10 | |
| e-paper DC | Pin 9 | Perintah atau data |
| e-paper RES (RST) | Pin 8 | |
| e-paper BUSY | Pin 7 | Tinggi saat panel sedang refresh |
| Tombol | Pin 2 dan GND | INPUT_PULLUP, jadi saat ditekan membaca LOW |
Cara kerja e-paper
Di dalam panel ada jutaan kapsul kecil berisi partikel hitam dan putih dengan muatan berlawanan. Tegangan pada sebuah piksel menarik partikel hitam ke atas atau partikel putih, dan mereka tetap di sana saat tegangan hilang. Itulah kenapa gambarnya bertahan tanpa daya, dan kenapa mengubahnya butuh waktu: partikelnya harus bergerak.
Panel punya controller sendiri, di sini SSD1680, dengan memori untuk gambarnya. Arduino menulis gambar baru ke memori itu lewat SPI, lalu menyuruh controller melakukan refresh. Selama refresh berjalan, controller menahan pin BUSY-nya tinggi, dan mengabaikan apa pun yang kamu kirim.
Sketch-nya
Tampilan disetel dengan GxEPD2_290_BS(10, 9, 8, 7): CS, DC, RES dan BUSY. GxEPD2 menggambar dengan perintah Adafruit GFX, di dalam loop firstPage() / nextPage(). Lalu hibernate() membuat controller tidur dalam, tanpa menggambar apa pun, dan gambarnya tetap di kaca.
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);
}
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Kenapa menggambar per halaman
Gambar penuh untuk panel ini berukuran 128 x 296 / 8 = 4.736 byte, satu bit per piksel. Uno hanya punya 2.048 byte RAM, jadi gambarnya tidak bisa ditahan sekaligus. Solusi GxEPD2 adalah paging: ia menyimpan buffer untuk satu strip layar, menjalankan kode gambar kamu sekali untuk setiap strip, dan mengirim setiap strip begitu selesai.
Dua baris di bagian atas sketch mengatur ukuran buffer itu menjadi 800 byte, yang untuk panel ini berarti 50 baris. 296 baris dalam strip berisi 50 adalah enam strip, jadi kode di dalam loop do ... while (display.nextPage()) berjalan enam kali. Itulah kenapa semua yang kamu gambar harus berada di dalam loop, dan kenapa harus menggambar hal yang sama setiap putaran.
Pada ESP32, dengan RAM yang banyak, kamu bisa memberi template tinggi penuh dan loop berjalan sekali.
Full dan partial refresh
Full refresh menggerakkan setiap piksel melalui hitam dan putih beberapa kali, itulah kedipan yang kamu lihat di panel sungguhan. Di sini butuh sekitar tiga detik dan menghapus jejak gambar lama. Partial refresh hanya mengubah satu area, di sini harganya, tanpa kedipan, dalam sekitar 0,3 detik.
Partial refresh meninggalkan jejak samar seiring waktu, jadi produk sungguhan melakukan full refresh sesekali, misalnya setiap beberapa puluh partial refresh. Dan me-refresh setiap detik itu ide buruk: lambat, dan umur panel dihitung dalam jumlah refresh. E-paper cocok untuk hal yang berubah sesekali: harga, cuaca, daftar tugas.
Kesalahan umum
BUSY tidak tersambung. Uno tidak bisa tahu kapan panelnya selesai, jadi ia mengirim perintah berikutnya ke refresh yang masih berjalan, dan panel mengabaikannya. Cabut kabel BUSY di rangkaian di atas: serial monitor tetap bilang "label drawn", tapi kacanya tetap kosong.
Kelas panel yang salah. GxEPD2 punya satu kelas untuk setiap panel dan controller (GxEPD2_290_BS, GxEPD2_290_T94_V2 dan masih banyak lagi). Kelas yang salah menghasilkan layar kosong, berbintik, atau tergambar sebagian. Cocokkan kelasnya dengan tulisan di belakang panel-mu.
Menggambar di luar loop halaman, atau menggambar hal berbeda tiap putaran. Setiap putaran harus menggambar seluruh gambar.
Memberi daya dari 5 V. Panel ini komponen 3,3 V. Modul Waveshare katanya menerima logika 3,3 V atau 5 V; panel telanjang di adapter biasa butuh 3,3 V di setiap pin.
Membiarkannya tetap bangun. Panggil hibernate() setelah setiap refresh; gambarnya tetap ada, dan panel hanya menarik sedikit daya.
Buka rangkaian ini di editor. Arduino Uno: label harga rak e-paper, dengan kabel seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya lalu jalankan lagi.
Buka rangkaian iniPertanyaan
Library apa yang sebaiknya kupakai untuk tampilan e-paper?
GxEPD2, buatan Jean-Marc Zingg. Mendukung kebanyakan panel Waveshare dan Good Display, menggambar dengan perintah Adafruit GFX, dan menangani paging di board dengan RAM kecil seperti Uno.
Apakah layar e-paper butuh daya untuk mempertahankan gambar?
Tidak. Partikel tetap di tempatnya, jadi gambar tetap ada meski daya mati. Daya hanya dibutuhkan untuk mengubahnya.
Berapa lama waktu refresh e-paper?
Refresh penuh butuh sekitar tiga detik pada panel 2,9 inci seperti ini; refresh sebagian sekitar 0,3 detik. Panel warna dengan merah atau kuning jauh lebih lama, 15 detik atau lebih.
Kenapa layar e-paper saya tidak mau update?
Cek BUSY dulu, lalu apakah class panel cocok dengan panel-mu, lalu kabel SPI. Class yang salah adalah penyebab paling umum panel kosong.
Lanjutkan
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.