Học

Vẽ lên OLED SSD1306 với một bo mạch Arduino

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: OLED SSD1306trực tiếp0.000 s 0.00x
Nhấp để mở trong trình soạn thảo
Ví dụ oled: một SSD1306 128x64 trên A4 và A5, vẽ chữ, hình khối và một quả bóng nảy.

OLED SSD1306 cỡ 0,96 inch là màn hình nhỏ trong mọi bộ kit nghiệp dư: 128 nhân 64 điểm ảnh, bốn chân, màu trắng nét trên nền đen. Mạch ở trên là một màn hình như vậy trên Arduino Uno, vẽ một tiêu đề, vài hình khối, một bộ đếm và một quả bóng nảy trong hộp. Nó chạy trên một Uno được mô phỏng, và màn hình được giải mã từ tín hiệu I2C thật trên hai dây, từng bit một, chứ không phải được vẽ từ lối tắt.

Mở nó trong trình soạn thảo để đổi code vẽ và chạy lại. Quá trình biên dịch mất một hai giây, ngay trong trình duyệt.

Những gì bạn cần

  • Một Arduino Uno
  • Một module OLED SSD1306 128x64, phiên bản I2C
  • Bốn dây cắm

Đi dây

Linh kiện và chânNối tớiGhi chú
OLED SDAA4
OLED SCLA5
OLED VCC5 VĐa số module chấp nhận 3,3 V hoặc 5 V
OLED GNDGND

Code của Adafruit

Sketch trong hướng dẫn SSD1306 của Adafruit biên dịch được nguyên vẹn tại đây, trên mọi bo mạch trừ ATtiny85. Các header là của Mokxi, viết trên trình điều khiển màn hình riêng, và giữ nguyên các lệnh mà các hướng dẫn vẫn dùng: clearDisplay(), display(), drawPixel(), đường thẳng, hình chữ nhật, hình chữ nhật bo góc, hình tròn, hình tam giác, bitmap, setTextSize(), setCursor(), print(), setRotation() và invertDisplay().

Có hai điểm khác so với thư viện gốc đáng lưu ý trước khi bắt đầu. Font chữ là font 5 x 7 của Mokxi, chỉ có chữ in hoa, chữ số và dấu câu, nên chữ thường sẽ in ra thành chữ hoa. Và begin() để màn hình trống trong khi thư viện gốc vẽ logo của nó.

Hello trên SSD1306, với các lệnh thư viện Adafruit
#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

Adafruit_SSD1306 display(128, 64, &Wire, -1);

void setup() {
  if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) for (;;);
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0, 0);
  display.println("Hello, world!");
  display.drawRect(0, 20, 40, 20, SSD1306_WHITE);
  display.display();
}

void loop() {}

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 không có gì hiển thị cho đến khi gọi display()

Màn hình không thể đọc ngược lại. Vì vậy một trình điều khiển muốn đổi một điểm ảnh phải nhớ 1023 byte còn lại của khung hình, và nó giữ bản sao đó trong chính bộ nhớ của bo mạch. Mọi lệnh vẽ đều ghi vào bản sao đó; display() mới là thứ gửi nó lên màn hình. Quên display() là bạn đã vẽ một bức tranh hoàn hảo vào RAM mà không ai bao giờ nhìn thấy.

That copy is 1 KB, which is half the Uno’s entire 2 KB of SRAM. It is the real cost of a pixel display on an ATmega328P, and the reason big sketches with an OLED run out of memory. The built-in example also shows a way to go faster: it sends only the 8-column blocks of the screen that changed, so a moving ball is a few dozen bytes on the bus rather than a full kilobyte. Over the Uno’s software I2C a full 1 KB frame takes about a third of a second, which is the difference between two frames a second and the twenty-five this sketch manages.

Thử trong trình soạn thảo

Mở mạch trong trình soạn thảo và chọn màn hình. Đổi địa chỉ của nó từ 0x3C sang 0x3D rồi chạy lại. Serial Monitor sẽ báo không có OLED nào đáp ứng, và màn hình vẫn tối, đây là lỗi đầu tiên phổ biến nhất với các module kiểu này.

Sau đó thay ví dụ bằng sketch Adafruit ở trên, thêm vài lệnh vẽ nữa, một hình tròn, một tam giác tô đặc, một dòng chữ lớn với setTextSize(2), rồi chạy. Mỗi lần biên dịch mất một lúc trong trình duyệt rồi màn hình hiện đúng như code đã vẽ.

Muốn có hình động, hãy vẽ lại bên trong loop() và gọi display() một lần mỗi khung hình. Quả bóng nảy trong ví dụ cho thấy mẹo chỉ xóa phần đã di chuyển.

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

Sai địa chỉ. Đa số module đáp ứng tại 0x3C; một số được nối sẵn về 0x3D. Ở địa chỉ sai sẽ không có gì hiện lên, và một sketch quét I2C sẽ cho bạn biết địa chỉ nào đúng.

Gửi lệnh bật màn hình mà không bật charge pump. Màn hình cần khoảng 7,5 vôn, do một pump bên trong chip tạo ra và pump này khởi đầu ở trạng thái tắt. Một trình điều khiển tự viết mà gửi lệnh bật màn hình nhưng quên khởi động pump sẽ thu về một màn hình đen. Màn hình mô phỏng có mô hình hóa pump, nên lỗi này cũng xảy ra ở đây. Thư viện đã lo phần này cho bạn.

Cạn bộ nhớ trên Uno. Với bộ đệm khung hình chiếm 1 KB, một sketch có mảng lớn hoặc chuỗi dài trong RAM có thể lỗi theo cách lạ lùng. Hãy giữ các chuỗi hằng trong flash.

Kỳ vọng cuộn bằng phần cứng. Các lệnh cuộn của màn hình được chấp nhận nhưng bị bỏ qua bởi màn hình mô phỏng, nên một dải chữ chạy ngang sẽ đứng yên ở đây. Hãy cuộn bằng cách vẽ lại thay thế.

Mở mạch này trong trình soạn thảo. Arduino Uno: OLED SSD1306, nối sẵn như đang 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

Địa chỉ I2C của OLED SSD1306 là gì?

Thường là 0x3C, đôi khi là 0x3D, được đặt bằng jumper hoặc điện trở mặt sau module. Con mô phỏng có địa chỉ là một thuộc tính.

Tôi có thể dùng OLED SSD1306 với ESP32 không?

Được, với các lệnh thư viện giống nhau trên chính các chân I2C của ESP32. Có sẵn các ví dụ ESP32 kèm OLED, bao gồm chính demo chữ và hình này và một trò chơi vợt trên ESP32-C3.

Vì sao chữ trên OLED của tôi toàn chữ hoa?

Vì thư viện mô phỏng dùng font 5 x 7 của Mokxi, chỉ có chữ in hoa, chữ số và dấu câu. Trên phần cứng thật, font của Adafruit có chữ thường.

Màn hình trong trình mô phỏng là một bức tranh hay giao thức thật?

Giao thức thật. Linh kiện là một thiết bị I2C được giải mã từ các cạnh tín hiệu trên chân, với bộ lệnh mà các thư viện thông dụng gửi và 1 KB bộ nhớ màn hình riêng.

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.