Belajar

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
Arduino Uno: label harga rak e-paperlive0.000 s 0.00x
Tekan Jalankan, tunggu refreshnya, lalu tekan tombolnya
Contoh Shelf label: panel SSD1680 2,9 inci dengan GxEPD2. Tunggu full refresh selesai, lalu tekan tombol untuk partial refresh.

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 pinDisambung keCatatan
e-paper VCC3.3 VPanel berjalan pada 2,2 sampai 3,7 V
e-paper GNDGND
e-paper SDA (DIN)Pin 11Data SPI (MOSI)
e-paper SCL (CLK)Pin 13Clock SPI
e-paper CSPin 10
e-paper DCPin 9Perintah atau data
e-paper RES (RST)Pin 8
e-paper BUSYPin 7Tinggi saat panel sedang refresh
TombolPin 2 dan GNDINPUT_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".

Sketch label harga rak
#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 ini

Pertanyaan

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.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.