Buongiorno a tutti, ecco qui una piccola guida per muovere i prima passi con i display OLED con ESPHome

Per questa guida ho utilizzato un ESP32 Heltec con display oled incorporato che potete trovare al seguente link:
https://it.aliexpress.com/item/32958037260.html?spm=a2g0s.9042311.0.0.27424c4dE6ZhzW

La seguente guida è basata sull'add-on ESPHome per Home Assistant Core

Create un nuovo Progetto dal wizard di ESPHome
Il primo punto servirà per assegnare un nome al progetto
Al secondo punto sarà necessario scegliere il tipo di scheda utilizzata, in questo caso Heltec WiFi Kit 32 (se non fosse disponibile inseritene uno diverso perchè poi si potrà cambaire dall'editor del codice)
Al terzo punto andrà indicata la vostra rete wifi a cui il dispositivio si collegherà

Terminato il wizard vi ritrovere questa nuova entità in ESPHOME

Cliccando sul tasto edit si aprirà l'editor di configurazione

il primo passo sarà configurare correttamente ESPHome

esphome:
  name: oled2
  platform: ESP32
  board: heltec_wifi_kit_32
wifi:
  ssid: "SSID"
  password: "passwordWIFI"
  # Enable fallback hotspot (captive portal) in case wifi connection fails
  ap:
    ssid: "Oled2 Fallback Hotspot"
    password: "Zf9oas35HAIZ"
captive_portal:
# Enable logging
logger:
# Enable Home Assistant API
api:
ota:

utilizzando Board diverse è necessario modificare i campi platform e board (per esmepio nel caso si utilizza un esp8266 o simili)

subito dopo inseriremo i sensori presenti su Home assistant che vorremo visualizzare, i nomi saranno esattamente quelli di home assistant

sensor:
  - platform: homeassistant
    id: solare_temperature
    entity_id: sensor.solare_termico
    internal: true
  
  - platform: homeassistant
    id: puffer_temperature
    entity_id: sensor.puffer_medio_alto
    internal: true
    
  - platform: homeassistant
    id: pdc_power
    entity_id: sensor.consumo_attuale_pdc
    internal: true

platform indicherà la piattaforma su cui sono presenti i sensori
id sarà l'id utilizzato nel progetto ESPHome
entity_id sarà l'id dell'entità di home assistant
I sensori inseririt qui seguiranno tutte le normali regole di ESPHOME

altro componente indispensabile sarà un sensore time recueprato sempre da home assistant:

time:
  - platform: homeassistant
    id: time1

passiamo ora alla configurazione del display connesso tramite i2c

i2c:
  sda: GPIO4
  scl: GPIO15
  scan: false
  frequency: 700khz

questa configurazione dipenderà dal tipo di display utlizzato

Passimao ora alla configurazione dei font da utilizzare sul display:

font:
- file: 'arialblk.ttf'
  id: font1
  size: 48
- file: 'arial.ttf'
  id: font2
  size: 15
- file: 'arial.ttf'
  id: font3
  size: 8

N.B: i fonti non sono presenti di default, pertanto andranno caricati all'interno del path config/esphome (stessa cone per i file .png delle icone)

eventuali cone andranno indicate cosi:

image:
  - file: "solar-power.png"
    id: solar_icon

Nel csao in cui si voglia visualizzare molti valori sul display sarà possibile creare più pagine e impostare degli intervalli per passare da una all'altra, in questo caso faremo cosi:

interval:
  - interval: 3s
    then:
      - display.page.show_next: my_display
      - component.update: my_display

passiamo ora alla visualizzazione dei dati sul display vera e propria:

display:
  - platform: ssd1306_i2c
    model: "SSD1306 128x64"
    reset_pin: GPIO16
    address: 0x3C
    id: my_display
    pages:
      - id: page1
        lambda: |-
          it.printf(40, 1, id(font3), TextAlign::TOP_CENTER, "Solare Termico");
          it.image(1, 30, id(solar_icon));
          it.printf(50, 30, id(font2), TextAlign::BASELINE_LEFT , "%.1f°", id(solare_temperature).state);
      - id: page2
        lambda: |-
          it.printf(1, 30, id(font2), TextAlign::BASELINE_LEFT , "Puffer PDC %.1f°", id(puffer_temperature).state);
      - id: page3
        lambda: |-
          it.printf(1, 45, id(font2), TextAlign::BASELINE_LEFT , "Pot PDC %.1fW", id(pdc_power).state);
      - id: page4
        lambda: |-
          it.strftime(0, 60, id(font1), TextAlign::BASELINE_LEFT, "%l:%M", id(time1).now());

In questo caso si tratta di un testo formattato quindi in printf andremo ad indicare le coordinate da cui si inizierà la scrittura (x, y)
Ogni pagina di testo formattato andrà scritta in lambda seguendo l'esempio indicato sopra

Il risultato finale sarà il seguente:

Per ogni altra informazione vi invito a visitare la pagina ufficiale relativa ai display di ESPHOME
https://esphome.io/components/display/index.html

in particoalre per i display OLED:
https://esphome.io/components/display/ssd1306.html

il progetto completo invece sarà presente qui:
https://pastebin.com/GGC19NUL