Tag: oled

Questo progetto realizza un sistema RFID completo basato su ESP32, pensato per il controllo accessi e perfettamente integrabile con Home Assistant. Il dispositivo utilizza un lettore RC522 per rilevare i tag RFID, un display OLED per mostrare lo stato del sistema e due LED per fornire un feedback visivo immediato all’utente.

Il cuore del progetto è il firmware sviluppato con ESPHome, che gestisce in modo autonomo la lettura dei badge, la verifica delle autorizzazioni e la visualizzazione delle informazioni. Quando un tag viene avvicinato al lettore, il sistema ne acquisisce l’UID e lo confronta con una lista interna di codici autorizzati. Se il badge è valido, il dispositivo segnala l’accesso consentito tramite il LED verde e una schermata dedicata sul display. In caso contrario, viene mostrato un messaggio di accesso negato e si attiva il LED rosso.

Per evitare letture ripetute dello stesso tag, è presente un sistema di controllo che introduce un intervallo minimo tra una scansione e l’altra. Questo rende il comportamento più stabile e impedisce attivazioni multiple indesiderate.

Il display OLED svolge un ruolo importante nell’esperienza utente: mostra lo stato di attesa, conferma l’accesso o segnala un rifiuto, con testi chiari e ben leggibili. I LED completano il feedback visivo, rendendo il sistema utilizzabile anche senza guardare il display.

Il firmware espone inoltre diversi sensori utili per l’integrazione con Home Assistant, come l’ultimo tag letto, lo stato dell’accesso, l’indirizzo IP del dispositivo e il tempo di attività. Questo permette di creare automazioni avanzate, registrare gli accessi o attivare scenari personalizzati.

Il risultato è un sistema RFID affidabile, semplice da usare e completamente personalizzabile, ideale per progetti di domotica, controllo accessi domestici o piccoli sistemi di sicurezza.

📌 Collegamenti RC522 (SPI → ESP32)

📌 Collegamenti Display OLED SSD1306 (I2C → ESP32)

📌 Collegamenti LED di Stato

📌 Riepilogo Pin Utilizzati

esphome:
  name: esphome-web-568b34
  friendly_name: Esp32 RFID
  min_version: 2025.11.0
  name_add_mac_suffix: false

esp32:
  variant: esp32
  framework:
    type: esp-idf

logger:
  level: DEBUG

api:

ota:
  platform: esphome

wifi:
  ssid: "xxxxxxxxx"
  password: "xxxxxxxx"

# ---------------- SPI + RC522 ----------------
spi:
  clk_pin: 18
  mosi_pin: 23
  miso_pin: 19

rc522_spi:
  cs_pin: 5
  reset_pin: 22
  update_interval: 1s
  on_tag:
    then:
      - lambda: |-
          std::string uid = x;

          // --- ANTILOOP: evita letture ripetute entro 2 secondi ---
          uint32_t now = millis();
          if (now - id(ultimo_lettura) < 2000) {
            return;
          }
          id(ultimo_lettura) = now;

          ESP_LOGI("rfid", "Tag rilevato: %s", uid.c_str());

          // Aggiorna sensore ultimo tag
          id(ultimo_tag).publish_state(uid);

          // Controllo accesso
          for (auto &t : id(tag_autorizzati)) {
            if (t == uid) {
              ESP_LOGI("rfid", "Accesso consentito");

              id(accesso_consentito).publish_state(true);
              id(accesso_negato).publish_state(false);

              id(led_ok).execute();
              id(display_ok).execute();

              return;
            }
          }

          ESP_LOGW("rfid", "Accesso negato");

          id(accesso_consentito).publish_state(false);
          id(accesso_negato).publish_state(true);

          id(led_ko).execute();
          id(display_ko).execute();

# ---------------- Lista badge autorizzati ----------------
globals:
  - id: tag_autorizzati
    type: std::vector<std::string>
    initial_value: '{"67-89-90-C9", "67-FA-0A-c9"}'

  # --- Cooldown letture RFID ---
  - id: ultimo_lettura
    type: uint32_t
    initial_value: '0'

# ---------------- OUTPUT (LED) ----------------
output:
  - platform: gpio
    pin: 14
    id: led_verde_pin

  - platform: gpio
    pin: 27
    id: led_rosso_pin
  
# ---------------- Script vari ----------------
script:
  - id: led_ok
    then:
      - light.turn_on: led_verde
      - delay: 15s
      - light.turn_off: led_verde
      - lambda: |-
          id(accesso_consentito).publish_state(false);

  - id: led_ko
    then:
      - light.turn_on: led_rosso
      - delay: 15s
      - light.turn_off: led_rosso
      - lambda: |-
          id(accesso_negato).publish_state(false);

  # --- SCRIPT DISPLAY OK ---
  - id: display_ok
    then:
      - display.page.show: page_ok
      - delay: 15s
      - display.page.show: page_idle

  # --- SCRIPT DISPLAY KO ---
  - id: display_ko
    then:
      - display.page.show: page_ko
      - delay: 15s
      - display.page.show: page_idle
  
# ---------------- LED verde e rosso ----------------
light:
  - platform: binary
    id: led_verde
    name: "LED Verde RFID"
    output: led_verde_pin

  - platform: binary
    id: led_rosso
    name: "LED Rosso RFID"
    output: led_rosso_pin

# ---------------- SENSORI RFID AGGIUNTI ----------------
text_sensor:
  - platform: template
    id: ultimo_tag
    name: "Ultimo TAG RFID"
  - platform: wifi_info
    ip_address:
      name: "ESP32 IP Address"
    ssid:
      name: "ESP32 WiFi SSID"
  - platform: version
    name: "Firmware ESPHome"           

button:
  - platform: restart
    id: riavvia_esp
    name: "Riavvia Proxy ESP32"  
          
binary_sensor:
  - platform: template
    id: accesso_consentito
    name: "Accesso RFID Consentito"

  - platform: template
    id: accesso_negato
    name: "Accesso RFID Negato"

# ---------------- OLED SSD1306 ----------------
i2c:
  sda: 21
  scl: 17
  scan: true

font:
  - file: "gfonts://Roboto"
    id: font1
    size: 20

display:
  - platform: ssd1306_i2c
    model: "SSD1306 128x64"
    address: 0x3C
    id: oled
    pages:
      - id: page_idle
        lambda: |-
          it.printf(0, 0, id(font1), "RFID");
          it.printf(0, 28, id(font1), "READY");

      - id: page_ok
        lambda: |-
          it.printf(0, 0, id(font1), "ACCESSO");
          it.printf(0, 28, id(font1), "CONSENTITO");

      - id: page_ko
        lambda: |-
          it.printf(0, 0, id(font1), "ACCESSO");
          it.printf(0, 28, id(font1), "NEGATO");

sensor:
  - platform: uptime
    name: Uptime Sensor
    filters:
      - lambda: return x / 3600;
    unit_of_measurement: "h"
    accuracy_decimals: 2