Menggambar di OLED SSD1306 dengan sebuah Arduino
Menengah
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
OLED SSD1306 0.96 inci adalah layar kecil di setiap kit hobi: 128 kali 64 piksel, empat pin, putih tajam di atas hitam. Rangkaian di atas adalah salah satunya di Arduino Uno, menggambar judul, beberapa bentuk, penghitung, dan bola yang memantul dalam kotak. Ini berjalan di Uno simulasi, dan tampilannya didekode dari lalu lintas I2C sungguhan di dua kabel, bit demi bit, bukan digambar dari jalan pintas.
Buka di editor untuk mengubah kode gambarnya dan jalankan lagi. Build-nya butuh satu-dua detik, di browser.
Yang kamu butuhkan
- Arduino Uno
- Modul OLED SSD1306 128x64, versi I2C
- Empat kabel jumper
Pengkabelan
| Komponen dan pin | Disambung ke | Catatan |
|---|---|---|
| OLED SDA | A4 | |
| OLED SCL | A5 | |
| OLED VCC | 5 V | Sebagian besar modul menerima 3.3 V atau 5 V |
| OLED GND | GND |
Kode Adafruit
Sketch tutorial SSD1306 dari Adafruit bisa dikompilasi di sini apa adanya, di setiap board kecuali ATtiny85. Header-nya buatan Mokxi sendiri, ditulis di atas driver display-nya, dan tetap memakai pemanggilan yang dipakai tutorial: clearDisplay(), display(), drawPixel(), garis, persegi panjang, persegi panjang sudut membulat, lingkaran dan segitiga, bitmap, setTextSize(), setCursor(), print(), setRotation() dan invertDisplay().
Ada dua perbedaan dengan library aslinya yang perlu kamu tahu sebelum mulai. Font-nya buatan Mokxi sendiri, 5 kali 7, hanya berisi huruf kapital, angka dan tanda baca, jadi huruf kecil dicetak sebagai kapital. Dan begin() membiarkan panel kosong, sedangkan library aslinya menggambar logonya.
#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() {}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Kenapa tidak ada apa pun yang muncul sampai display()
Panel tidak bisa dibaca kembali. Jadi driver yang ingin mengubah satu piksel harus mengingat 1023 byte lainnya dari frame, dan menyimpan salinannya di memori board itu sendiri. Setiap pemanggilan menggambar menulis ke salinan itu; display() adalah yang mengirimkannya ke panel. Lupa memanggil display() dan kamu sudah menggambar gambar sempurna ke RAM yang tidak akan pernah dilihat siapa pun.
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.
Coba di editor
Buka rangkaian di editor dan pilih display-nya. Ubah alamatnya dari 0x3C ke 0x3D lalu jalankan lagi. Serial monitor akan bilang tidak ada OLED yang menjawab, dan panel tetap gelap, ini adalah kesalahan pertama yang paling umum dengan modul-modul ini.
Lalu ganti contoh dengan sketch Adafruit di atas, tambahkan beberapa pemanggilan menggambar lagi, satu lingkaran, satu segitiga berisi, satu baris teks besar dengan setTextSize(2), lalu jalankan. Setiap build butuh sebentar di browser, lalu panel menampilkan persis apa yang digambar oleh kode.
Untuk gambar bergerak, gambar ulang di dalam loop() dan panggil display() sekali per frame. Bola yang memantul di contoh menunjukkan trik menghapus hanya bagian yang bergerak.
Kesalahan umum
Alamat yang salah. Sebagian besar modul menjawab di 0x3C; beberapa diatur ke 0x3D. Tidak ada apa pun yang muncul di alamat yang salah, dan sketch I2C scanner akan memberitahumu mana yang benar.
Mengirim perintah menyalakan display tanpa charge pump. Panel butuh sekitar 7,5 volt, dibuat oleh pump di dalam chip yang mulai dalam keadaan mati. Driver buatan tangan yang mengirim display-on tapi lupa menyalakan pump akan mendapat layar hitam. Panel simulasi memodelkan pump-nya, jadi kesalahan ini juga terjadi di sini. Library menanganinya untukmu.
Kehabisan memori di Uno. Dengan frame buffer mengambil 1 KB, sketch dengan array besar atau string panjang di RAM bisa crash dengan cara aneh. Simpan string konstanta di flash.
Berharap ada scrolling perangkat keras. Perintah scroll panel diterima tapi diabaikan oleh display simulasi, jadi banner bergulir diam di sini. Lakukan scroll dengan menggambar ulang.
Buka rangkaian ini di editor. Arduino Uno: SSD1306 OLED, dirangkai seperti saat berjalan di bagian atas halaman ini. Ubah komponen atau nilainya lalu jalankan lagi.
Buka rangkaian iniPertanyaan
Berapa alamat I2C dari SSD1306 OLED?
Biasanya 0x3C, kadang 0x3D, diatur oleh jumper atau resistor di bagian belakang modul. Versi simulasi memiliki alamat sebagai properti.
Bisakah aku memakai SSD1306 OLED dengan ESP32?
Bisa, dengan pemanggilan library yang sama di pin I2C milik ESP32 sendiri. Ada contoh bawaan ESP32 dengan OLED, termasuk demo teks dan bentuk yang sama ini serta game paddle di ESP32-C3.
Kenapa teks OLED-ku semua huruf kapital?
Karena library simulasi memakai font 5 kali 7 buatan Mokxi, yang hanya berisi huruf kapital, angka dan tanda baca. Di perangkat keras sungguhan, font Adafruit punya huruf kecil.
Apakah display di simulator berupa gambar atau protokol sungguhan?
Protokol sungguhan. Komponen ini adalah perangkat I2C yang didekode dari tepi sinyal pin, dengan set perintah yang dikirim library umum dan 1 KB memori display miliknya sendiri.
Lanjutkan
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.