Bir Arduino ile SSD1306 OLED'e çizim yapma
Orta
Ya da tüm dersleri gör.
- 526parça tezgahta
- 46kart şu an çalışıyor
- 1.00xgerçek zamanlı, her kartta
0.96 inç SSD1306 OLED, her hobi kitindeki küçük ekrandır: 128 çarpı 64 piksel, dört pin, siyah üzerinde net beyaz. Yukarıdaki devre, bir Arduino Uno üzerinde başlık, birkaç şekil, bir sayaç ve bir kutuda zıplayan top çiziyor. Simüle edilen bir Uno üzerinde çalışıyor ve ekran, bir kestirmeden çizilmek yerine, iki kablodaki gerçek I2C trafiğinden bit bit çözümleniyor.
Düzenleyicide açıp çizim kodunu değiştir ve yeniden çalıştır. Derleme bir iki saniye sürer, tarayıcıda.
Neye ihtiyacın var?
- Bir Arduino Uno
- 128x64 SSD1306 OLED modülü, I2C sürümü
- Dört jumper kablo
Kablolama
| Parça ve pin | Gittiği yer | Not |
|---|---|---|
| OLED SDA | A4 | |
| OLED SCL | A5 | |
| OLED VCC | 5 V | Çoğu modül 3.3 V veya 5 V kabul eder |
| OLED GND | GND |
Adafruit kodu
Adafruit SSD1306 eğitim kodu burada olduğu gibi derlenir, ATtiny85 dışındaki her kartta. Başlık dosyaları Mokxi'nin kendisine ait, kendi görüntü sürücüsü üzerine yazılmış ve eğitimlerde kullanılan çağrıları içeriyor: clearDisplay(), display(), drawPixel(), çizgiler, dikdörtgenler, yuvarlatılmış dikdörtgenler, daireler ve üçgenler, bitmap'ler, setTextSize(), setCursor(), print(), setRotation() ve invertDisplay().
Başlamadan önce üst kütüphaneden bilinmeye değer iki fark var. Yazı tipi Mokxi'nin kendi 5'e 7'si olup büyük harfler, rakamlar ve noktalama işaretleri içerir, bu yüzden küçük harfler büyük harf olarak yazılır. Ayrıca begin() paneli boş bırakır; üst kütüphane ise logoyu çizer.
#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() {}Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.
display() çağrılana kadar neden hiçbir şey görünmüyor
Panel geri okunamıyor. Yani tek bir pikseli değiştirmek isteyen bir sürücü karenin diğer 1023 baytını hatırlamak zorunda ve bu kopyayı kartın kendi belleğinde tutuyor. Her çizim çağrısı bu kopyaya yazar; onu panele gönderen display()'dir. display()'i unutursanız, kimsenin hiç görmeyeceği mükemmel bir resmi RAM'e çizmiş olursunuz.
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.
Düzenleyicide dene
Devreyi düzenleyicide açın ve ekranı seçin. Adresini 0x3C'den 0x3D'ye değiştirin ve yeniden çalıştırın. Seri monitör hiçbir OLED'in yanıtlamadığını söyler ve panel karanlık kalır; bu, bu modüllerde en yaygın ilk hatadır.
Sonra örneği yukarıdaki Adafruit koduyla değiştirin, birkaç çizim çağrısı daha ekleyin: bir daire, içi dolu bir üçgen, setTextSize(2) ile büyük harfli bir yazı satırı ve çalıştırın. Her derleme tarayıcıda bir an sürer ve sonra panel tam olarak kodun çizdiğini gösterir.
Hareketli bir görüntü için loop() içinde yeniden çizip her karede display() çağırın. Örneğin zıplayan topu, yalnızca hareket eden kısmı silme hilesini gösterir.
Sık yapılan hatalar
Yanlış adres. Modüllerin çoğu 0x3C'de yanıt verir; bazıları 0x3D'ye ayarlanmıştır. Yanlış olanda hiçbir şey görünmez ve bir I2C tarayıcı kodu hangisinin doğru olduğunu söyler.
Şarj pompası olmadan display-on komutunu göndermek. Panel yaklaşık 7.5 volt ister ve bu, çipin içindeki, başlangıçta kapalı olan bir pompa ile üretilir. Display-on gönderip pompayı başlatmayı unutan elle yazılmış bir sürücü siyah ekran alır. Simüle edilen panel pompayı modellediği için bu hata burada da olur. Kütüphane bunu sizin için halleder.
Uno'da bellek tükenmesi. Kare tamponu 1 KB aldığından, RAM'de büyük dizileri veya uzun dizeleri olan bir kod tuhaf şekillerde çökebilir. Sabit dizeleri flash'ta tutun.
Donanım kaydırmayı beklemek. Panelin kaydırma komutları simüle edilen ekran tarafından kabul edilir ama yok sayılır, bu yüzden kayan bir banner burada durur. Bunun yerine yeniden çizerek kaydırın.
Bu devreyi düzenleyicide açın. Arduino Uno: SSD1306 OLED, bu sayfanın üstünde çalıştığı gibi kablolandı. Bir parçayı veya değeri değiştirin ve yeniden çalıştırın.
Devreyi açSorular
Bir SSD1306 OLED'in I2C adresi nedir?
Genellikle 0x3C, bazen 0x3D; modülün arkasındaki bir jumper veya dirençle belirlenir. Simüle edilenin adresi bir özellik olarak ayarlanabilir.
SSD1306 OLED'i bir ESP32 ile kullanabilir miyim?
Evet, aynı kütüphane çağrılarıyla ESP32'nin kendi I2C pinlerinde. OLED'li hazır ESP32 örnekleri var; bu aynı yazı ve şekil tanıtımı ve bir ESP32-C3 üzerinde bir raket oyunu dahil.
OLED yazım neden hep büyük harf?
Çünkü simüle edilen kütüphane Mokxi'nin 5'e 7 yazı tipini kullanıyor ve bunda yalnızca büyük harfler, rakamlar ve noktalama işaretleri var. Gerçek donanımda Adafruit yazı tipinde küçük harfler de vardır.
Simülatördeki ekran bir resim mi yoksa gerçek protokol mü?
Gerçek protokol. Parça, pin kenarlarından çözülen bir I2C aygıttır; yaygın kütüphanelerin gönderdiği komut setine ve kendi 1 KB görüntü belleğine sahiptir.
Devam et
Bunu gerçekten kur
Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.