Collegare un Display OLED ad Arduino

Nella scatola delle meraviglie ho trovato un sacco di componenti ancora confezionati. Tra questi un piccolo display 128×64 pixel. In questo articolo quindi ti mostrerò come è possibile collegare un display OLED ad Arduino e stampare a “video” delle informazioni.

Presentazioni

Partiamo intanto dalla sigla OLED. OLED sta per (Organic Light-Emitting Diode) quindi diodo organico a emissione di luce. A differenza dei display LCD (magari scriverò un articolo anche per loro) che hanno bisogno di una fonte luminosa esterna per essere visibili, questi OLED sono in grado di emettere luce propria e quindi consentono la realizzazione di display dalle ridottissime dimensioni e peso, oltre che alla possibilità di essere piegati.

La maggior parte dei display OLED che troviamo in giro per Arduino, per essere comandati, sfruttano il driver SSD1306 e possono essere interfacciati tramite connessioni SPI e I2C (come nel mio caso).

Oltre alla risoluzione 128×64 esiste anche la versione 128×32 che naturalmente vedrà la parte del display dimezzata. Per quanto riguarda i colori, i più diffusi ed economici sono i modelli monocromatici, che presentato quindi una sola colorazione. Ma ve ne sono alcuni (tipo il mio) che presentano una striscia (quella in alto) del display di un colore e la restante parte dell’altro (generalmente giallo e blu). Questo è comodo per realizzare applicazioni che per esempio mostrano on top informazioni “statiche” come ad esempio la data o l’ora, lo stato della batteria, de segnale etc, lasciando la parte inferiore ai contenuti dell’applicazione.

OLED Display Pinout

La versione I2C del modulo OLED presenta solo quattro pin di connessione, due dedicati all’alimentazione VCC e GND e due per il clock e il bus dati (SCK, SDA). Questi pin dovranno essere collegati ai rispettivi pin I2C di Arduino, che come per l’interfaccia SPI, possono variare in base al modello. L’interfaccia I2C è anche conosciuta con il termine TwoWire (Connection), connessione a due fili.

Display	Arduino
GND	GND
VDD	+5 V
SCK	A5
SDA	A4

Librerie necessarie

In giro esistono svariate librerie in grado di comunicare con il chip SSD1306, io ho deciso di utilizzare la libreria realizzata da Adafruit per i loro display, ma che funziona benissimo con quasi tutti i moduli dello stesso tipo.
La libreria in questione si chiama Adafruit SSD1306 e come al solito è possibile installarla dal library manager di Arduino. Per facilitare la gestione grafica Adafruit ha realizzato un’ulteriore libreria, chiamata GFX Library, grazie alla quale è possibile disegnare primitive geometriche come punti, linee, cerchi, etc… A tal proposito questo è il link alla documentazione ufficiale della libreria, dove potrai trovare un sacco di informazioni utili a riguardo.

Alcune premesse

Grazie a queste librerie è possibile stampare di tutto su questi display, come ad esempio disegnare immagini da file o realizzare animazioni. Ti basterà aprire uno degli esempi che verranno installati assieme alle librerie per scoprire quante cose si riescono a fare.

Questo articolo va inteso come semplice dimostrazione di come stampare a video del testo. Potrebbe essere la base per progetti futuri magari. Per fare questo devi sapere alcune cose base:
Il display va inizializzato passandogli il suo indirizzo I2C che generalmente è stampato dietro al modulo (0x3D o 0x3C in genere). Se non dovessi trovarlo, esistono degli sketch Arduino per eseguire lo scan dei dispositivi I2C collegati. Eccone uno qui.
All’interno del display ci si muove con un cursore su un sistema di coordinate, nella guida Adafruit troverai tutto.
Il display utilizza le funzioni print e println() per scrivere sul suo buffer interno, poi utilizza la funzione display() per mandare a video il contenuto del buffer. Il metodo clearDisplay() serve a ripulire l’intera area di stampa.
Anche nei display monocromatici bisogna settare un colore del testo e questo si fa con la funzione setTextColor() che accetta un uint16_t come valore per il colore. La libreria, al suo interno ha definito delle costanti e per comodità io utilizzerò WHITE anche se il display stampa in giallo o in blu. Non farà alcuna differenza.
Per la dimensione del testo esiste un comodo metodo chiamato setTextSize() che accetta uno o due parametri definendo il livello di ingrandimento del testo sugli assi X e Y. Di default è 1.

Codice

Nel codice, come sempre ampiamente commentato, ho creato delle funzioni per mostrarti diversi esempi di utilizzo. Guardando l’animazione sotto, potrai renderti conto di cosa intendo.

/*
   Collegare un display OLED ad Arduino

   Autore  : Andrea Lombardo
   Web     : http://www.lombardoandrea.com
   Post    : https://wp.me/p27dYH-OS
*/

#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

/*
   Definisco le dimensioni del display, serviranno per creare l'istanza del display
   e magari riutilizzarle nel codice qualora dovessero servirmi queste informazioni
*/
#define SCREEN_WIDTH 128 // OLED display width, in pixels
#define SCREEN_HEIGHT 64 // OLED display height, in pixels

// Creo istanza del display
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT);

void setup() {

  //Provo ad inizializzare il display all'indirizzo 0x3C (il tuo potrebbe essere diverso)
  if (!display.begin( SSD1306_SWITCHCAPVCC, 0x3C)) {
    /*
      Se non sono riuscito ad inizializzare il display
      creo un loop infinito ed impedisco al programma di andare avanti
    */
    while (true);
  }

  // Pulisco il buffer
  display.clearDisplay();

  // Applico la pulizia al display
  display.display();

  //I due passaggi qui sopra evitano di mostrare il logo adafruit all'avvio
}

void loop() {

  stampaTestoSemplice();

  delay(4000);

  stampaFixedHeader();

  delay(4000);

  stampaMotivational();

  delay(4000);

  stampaFixedHeaderAlt();

  delay(4000);

  stampaBig();

  delay(4000);

}


void stampaTestoSemplice() {

  //Ripulisco il buffer
  display.clearDisplay();

  //Setto il colore del testo a "bianco"
  display.setTextColor( WHITE);

  //Setto dimensione del testo
  display.setTextSize(2);

  //Sposto il cursore a metà altezza del display
  display.setCursor(0, SCREEN_HEIGHT / 2);

  //Stampo una scritta
  display.println(" A + B = C ");

  //La mando in stampa
  display.display();

}

//visto il periodo...
void stampaMotivational() {

  //Ripulisco il buffer
  display.clearDisplay();

  //Setto il colore del testo a "bianco"
  display.setTextColor( WHITE);

  //Setto dimensione del testo
  display.setTextSize(1);

  //Sposto il cursore a metà altezza del display
  display.setCursor(0, SCREEN_HEIGHT / 2);

  //Stampo una scritta
  display.println("     #CELAFAREMO");

  //La mando in stampa
  display.display();

}

void stampaFixedHeader() {

  //Ripulisco il buffer
  display.clearDisplay();

  //Creo un rettangolo alto 16px e largo quanto l'intera larghezza del display
  display.fillRect(0, 0, SCREEN_WIDTH, 16, WHITE);

  //Setto il colore del testo invertito
  display.setTextColor(BLACK, WHITE);

  //Setto dimensione del testo
  display.setTextSize(1);

  //Posiziono il cursore a X = 0 e Y = 4
  display.setCursor(0, 4);

  //Stampo l'esempio di quella che potrebbe essere una data / ora
  display.print(" GG/MM/YYYY     HH:mm");

  //Mando in stampa il display
  display.display();
}


void stampaFixedHeaderAlt() {

  //Ripulisco il buffer
  display.clearDisplay();

  /*
    Creo una linea di divisione a 16px (le coordinate partono da 0)
    dalla parte alta del display e per tutta la sua larghezza
  */
  display.drawLine(0, 15, SCREEN_WIDTH, 15, WHITE);

  //Setto il colore del testo
  display.setTextColor( WHITE);

  //Setto dimensione del testo
  display.setTextSize(1);

  //Posiziono il cursore a X = 0 e Y = 4
  display.setCursor(0, 4);

  //Stampo del testo
  display.print("  LOMBARDOANDREA.COM");

  //Mando in stampa il display
  display.display();
}

void stampaBig() {

  //Ripulisco il buffer
  display.clearDisplay();

  //Setto il colore del testo a "bianco"
  display.setTextColor( WHITE);

  //Setto dimensione del testo
  display.setTextSize(5);

  //Sposto il cursore 20 px a destra e ad un terzo dell'altezza del display
  display.setCursor(20, SCREEN_HEIGHT / 3);

  //Stampo una scritta
  display.println("BIG");

  //La mando in stampa
  display.display();

}

Schema

Lo schema di collegamento è di estrema facilità, ti ricordo solo di prestare attenzione al tuo modello di Arduino per identificare correttamente quali sono i pin SCK e SDA.

A fine pagina trovi il link per scaricare il pacchetto con codici e schemi di collegamento. Come sempre ti ricordo che acquistando prodotti Amazon passando attraverso i link del mio sito, io percepisco una piccola commissione (parliamo di centesimi) in buoni regalo. Questi buoni sommati alle eventuali donazioni PayPal, servono a mantenere attivo il sito web e ad acquistare nuovi componenti.

AZDelivery 0.96 pollici Display OLED I2C SSD1306 Chip 128 x 64 Pixel I2C Modulo di Visualizzazione dello Schermo con Caratteri Bianchi compatibile con Arduino e Raspberry Pi incluso un E-Book!

(1309)

9,99 €

✅ L'innovativa tecnologia OLED conferisce al display da 0,96 pollici un forte contrasto e una visualizzazione nitida. ✅ Se cercate un display OLED che vi consenta di visualizzare quanti più dati possibili, questo è lo schermo lcd giusto per voi. Graz... Continua a leggere

(a partire da 28 Marzo 2023 15:03 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

5 Pezzi 0,96 Pollici Modulo OLED 128x64 Driver Scheda Display IIC I2C Seriale Auto-Luminosa Compatibile con Arduino Raspberry PI (Blu e Giallo)

(105)

19,94 €

Applicazioni: modulo OLED da 0,96 pollici per visualizzare informazioni grafiche e testuali direttamente sui progetti del microcontrollore; Supporta molti chip: compatibile con Arduino Mega, Raspberry pi, 51 MCU, STIM 32, ecc. Risoluzione: 128 x 64; ... Continua a leggere

(a partire da 28 Marzo 2023 15:04 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

Seamuig I2C OLED Display Module I2C Schermo Minuscolo Modulo 0.91 Pollice Bianco 128X32 I2C OLED Driver DC 3.3V a 5V per Arduino (confezione da 2)

(32)

7,99 €

Piccolo display OLED, nessuna retroilluminazione necessaria, auto-illuminazione, colore del display: bianco. Nota: Questi moduli di visualizzazione OLED I2C sono disponibili senza intestazioni pin Le prestazioni del display sono migliori rispetto al ... Continua a leggere

(a partire da 28 Marzo 2023 15:03 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

ARCELI 0.96 Pollici Modulo OLED 12864 128x64 Blue White Driver I2C Serial Display Board Auto-Luminoso per Arduino Raspberry PI

(235)

6,99 € 6,92 €

Modulo OLED da 0,96 pollici di UCTRONICS per la visualizzazione di informazioni grafiche e testuali direttamente sui progetti di micro-controller. Supporta molti chip: Arduino UNO e Mega, Raspberry pi, 51 MCU, STIM 32, ecc., L'UNO mostrato nella foto... Continua a leggere

(a partire da 28 Marzo 2023 15:02 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

AZDelivery 3 x 0.91 pollici Display OLED I2C SSD1306 Chip 128 x 32 Pixel I2C Modulo di Visualizzazione dello Schermo con Caratteri Bianchi compatibile con Arduino e Raspberry Pi incluso un E-Book!

(280)

15,49 € 13,98 €

✅ Ottieni ora 3 x Display OLED a caratteri bianchi 128 x 32 Pixel 0,91 Pollici I2C ad un prezzo speciale con sconto quantità! ✅ Se cercate un display che vi consenta di visualizzare quanti più elementi possibili, questo è il display lcd giusto per vo... Continua a leggere

(a partire da 28 Marzo 2023 22:31 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

Arduino UNO Rev3 [A000066]

(7391)

29,99 € 25,90 €

Con questa scheda potete cominciare la vostra esperienza straordinaria con Arduino: ideale per imparare le basi del funzionamento di sensori e attuatori, è uno strumento essenziale per le vostre esigenze di prototipazione rapida Arduino Uno è la sche... Continua a leggere

(a partire da 28 Marzo 2023 20:15 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

Arduino Uno SMD Rev3

(389)

28,00 € 26,50 €

Arduino UNO Rev3 è la famiglia perfetta con cui iniziare: flessibile, robusta, duratura e standard Ideale per principianti: ben documentata, con tantissimi progetti da cui prendere ispirazione Semplice da connettere e alimentare:con un cavo USB, con ... Continua a leggere

(a partire da 28 Marzo 2023 16:23 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

Arduino UNO WiFi REV2 [ABX00021]

(249)

57,00 € 48,99 €

Il modo più semplice per costruire un progetto Arduino interconnesso. Funziona con applicazioni WiFi e Bluetooth a bassa energia. Connessione wireless sicura a Internet grazie al suo criptochip presente nella scheda. Ideale per i settori dell'Interne... Continua a leggere

(a partire da 28 Marzo 2023 16:23 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

Arduino UNO Mini Limited Edition [ABX00062]

(87)

60,00 € 52,99 €

Arduino Uno Mini Limited Edition è un oggetto da collezionista per seri amanti di Arduino: hobbisti, studenti, produttori, reinimaginieri, sognatori, hopers, fan, ingegneri, designer, interrogatori, produttori di torte, risolutori di problemi, puzzle... Continua a leggere

(a partire da 28 Marzo 2023 16:23 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

Arduino MKR WiFi 1010 [ABX00023] & Uno REV3 [A000066]

85,98 €

Prodotto 1: MKR 1010 semplifica la prototipazione di applicazioni IoT basate su WiFi, facilmente collegabili e configurabili con altri prodotti Arduino. Non è necessario essere esperti di rete! Prodotto 1: Il modulo di connettività ibrido WiFi / BLE ... Continua a leggere

(a partire da 28 Marzo 2023 15:59 GMT +02:00 - Altre informazioniProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)

Collegare un display OLED ad Arduino - File

1 file(s) 409.07 KB

Scarica

• https://www lombardoandrea com/collegare-un-display-oled-ad-arduino/ (2)