Học

Một màn hình e-paper trên Arduino: nhãn giá trên kệ hàng

Trung bình

Hoặc xem mọi bài học.

  • 526linh kiện trên bàn làm mạch
  • 46bo mạch đang chạy
  • 1.00xthời gian thực, trên mọi bo mạch
Arduino Uno: nhãn giá e-paper trên kệ hàngtrực tiếp0.000 s 0.00x
Nhấn Chạy, đợi màn hình làm mới, rồi nhấn nút nhấn
Ví dụ Nhãn giá trên kệ: panel SSD1680 2.9 inch với GxEPD2. Hãy đợi lần làm mới đầy đủ, rồi nhấn nút nhấn để thực hiện một lần làm mới cục bộ.

E-paper (còn gọi là e-ink) là loại màn hình trên máy đọc sách và nhãn giá điện tử. Nó trông như giấy in, đọc rõ dưới nắng và giữ nguyên hình ảnh khi ngắt điện, nên một nhãn có thể hiển thị giá trong nhiều năm chỉ với một pin đồng xu. Nhược điểm là tốc độ: một lần làm mới đầy đủ mất vài giây.

Mạch phía trên là một bo Arduino Uno điều khiển panel e-paper 2.9 inch, 296 x 128 điểm ảnh, bằng thư viện GxEPD2, dùng làm nhãn giá trên kệ hàng trong cửa hàng. Nó vẽ nhãn một lần với lần làm mới đầy đủ, rồi cho panel nghỉ. Nhấn nút nhấn và nó sẽ giảm giá bằng một lần làm mới cục bộ nhanh, chỉ riêng phần giá. Nhấn Chạy và đợi khoảng sáu giây.

Những gì bạn cần

  • Một Arduino Uno
  • Mô-đun e-paper SPI 2.9 inch, 296x128, SSD1680 (như của Waveshare)
  • Một nút nhấn
  • Một breadboard và dây cắm

Đi dây

Linh kiện và chânNối tớiGhi chú
e-paper VCC3.3 VPanel hoạt động ở 2.2 đến 3.7 V
e-paper GNDGND
e-paper SDA (DIN)Chân 11Dữ liệu SPI (MOSI)
e-paper SCL (CLK)Chân 13Xung clock SPI
CS của e-paperChân 10
DC của e-paperChân 9Lệnh hay dữ liệu
RES (RST) của e-paperChân 8
BUSY của e-paperChân 7Mức cao khi màn hình đang làm mới
Nút nhấnChân 2 và GNDINPUT_PULLUP, nên khi nhấn sẽ đọc LOW

Nguyên lý hoạt động của e-paper

Bên trong màn hình là hàng triệu viên nang cực nhỏ chứa các hạt đen và trắng mang điện tích trái dấu. Một điện áp đặt lên một điểm ảnh sẽ kéo các hạt đen hoặc hạt trắng lên trên, và chúng ở nguyên đó cả khi mất điện áp. Đó là lý do hình ảnh được giữ mà không cần nguồn, và cũng là lý do việc thay đổi hình lại mất thời gian: các hạt phải di chuyển.

Màn hình có sẵn bộ điều khiển riêng, ở đây là SSD1680, kèm bộ nhớ để chứa hình ảnh. Arduino ghi hình mới vào bộ nhớ đó qua SPI, rồi báo bộ điều khiển làm mới. Trong lúc làm mới, bộ điều khiển giữ chân BUSY ở mức cao và bỏ qua mọi thứ bạn gửi vào.

Sketch

Màn hình được khai báo bằng GxEPD2_290_BS(10, 9, 8, 7): CS, DC, RES và BUSY. GxEPD2 vẽ bằng các lệnh của Adafruit GFX, bên trong vòng lặp firstPage() / nextPage(). Sau đó hibernate() đưa bộ điều khiển vào chế độ ngủ sâu, nơi nó gần như không tiêu thụ điện, và hình vẫn giữ trên màn hình.

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 nhãn giá kệ hàng
#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);
  }
}

Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.

Vì sao phải vẽ từng trang

Một hình đầy đủ cho màn hình này là 128 x 296 / 8 = 4,736 byte, mỗi điểm ảnh một bit. Uno chỉ có tổng cộng 2,048 byte RAM, nên không thể chứa cả hình cùng lúc. Cách của GxEPD2 là chia trang: nó giữ một bộ đệm cho một dải màn hình, chạy code vẽ của bạn một lần cho mỗi dải, và gửi từng dải ngay khi xong.

Hai dòng đầu tiên của sketch đặt bộ đệm đó là 800 byte, tương ứng với 50 hàng ở màn hình này. 296 hàng chia thành các dải 50 hàng là sáu dải, nên code bên trong vòng lặp do ... while (display.nextPage()) chạy sáu lần. Vì vậy mọi thứ bạn vẽ phải nằm trong vòng lặp, và mỗi vòng phải vẽ giống hệt nhau.

Trên ESP32, với lượng RAM dồi dào, bạn có thể đặt chiều cao đầy đủ cho template và vòng lặp chỉ chạy một lần.

Làm mới toàn phần và một phần

Làm mới toàn phần đẩy mọi điểm ảnh qua đen và trắng vài lần, đó là hiện tượng chớp sáng bạn thấy trên màn hình thật. Ở đây nó mất khoảng ba giây và xóa sạch vết mờ của hình cũ. Làm mới một phần chỉ thay đổi một vùng, ở đây là giá, không có chớp sáng, mất khoảng 0,3 giây.

Các lần làm mới một phần để lại vệt mờ nhạt theo thời gian, nên các sản phẩm thật thỉnh thoảng lại làm mới toàn phần, chẳng hạn sau vài chục lần làm mới một phần. Và việc làm mới mỗi giây là ý tưởng tồi: nó chậm, và tuổi thọ màn hình được tính bằng số lần làm mới. E-paper hợp với những thứ chỉ thỉnh thoảng thay đổi: một mức giá, thời tiết, một danh sách việc cần làm.

Những lỗi thường gặp

BUSY chưa được nối. Uno không biết được khi nào màn hình xong, nên nó gửi các lệnh tiếp theo vào một lần làm mới đang chạy, và màn hình bỏ qua chúng. Rút dây BUSY khỏi mạch ở trên: Serial Monitor vẫn hiển thị "label drawn", nhưng màn hình vẫn trống không.

Sai lớp màn hình. GxEPD2 có một lớp cho từng loại màn hình và bộ điều khiển (GxEPD2_290_BS, GxEPD2_290_T94_V2 và nhiều nữa). Chọn sai lớp sẽ cho màn hình trống, nhiễu hoặc vẽ lệch. Hãy khớp lớp với mặt sau màn hình của bạn.

Vẽ ngoài vòng lặp trang, hoặc vẽ thứ khác nhau ở mỗi vòng. Mỗi vòng phải vẽ toàn bộ hình.

Cấp nguồn 5 V. Màn hình là linh kiện 3.3 V. Các bo mạch module của Waveshare ghi nhận 3.3 V hoặc 5 V cho tín hiệu; một màn hình trần trên bộ chuyển đổi thường thì cần 3.3 V trên mọi chân.

Để nó thức. Hãy gọi hibernate() sau mỗi lần làm mới; hình vẫn giữ, và màn hình gần như không tiêu thụ điện.

Mở mạch này trong trình soạn thảo. Arduino Uno: nhãn giá kệ hàng e-paper, được nối dây như khi chạy ở đầu trang này. Thay một linh kiện hoặc một giá trị rồi chạy lại.

Mở mạch

Câu hỏi

Nên dùng thư viện nào cho màn hình e-paper?

GxEPD2, do Jean-Marc Zingg viết. Nó hỗ trợ hầu hết các màn hình Waveshare và Good Display, vẽ bằng các lệnh Adafruit GFX, và tự xử lý chia trang trên các bo mạch ít RAM như Uno.

Màn hình e-paper có cần điện để giữ hình không?

Không. Các hạt vẫn ở chỗ chúng được đặt, nên hình vẫn giữ nguyên khi mất điện. Chỉ cần điện khi muốn thay đổi hình.

Màn hình e-paper mất bao lâu để refresh?

Một lần refresh đầy đủ mất khoảng ba giây trên màn 2.9 inch như màn này; refresh một phần khoảng 0.3 giây. Màn màu có đỏ hoặc vàng lâu hơn nhiều, 15 giây trở lên.

Tại sao màn hình e-paper của mình không cập nhật?

Kiểm tra BUSY trước, sau đó xem lớp màn có khớp với màn của bạn không, rồi đến các dây SPI. Lớp sai là nguyên nhân phổ biến nhất khiến màn không hiển thị gì.

Lắp mạch này ngoài đời

Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.