Home › Guida utente › Dashboard Home Assistant
Home Assistant · passo dopo passo

Crea una dashboard Home Assistant per il proiettore in circa un'ora

L'app ti costruisce già una dashboard funzionante quando sincronizzi: questa pagina è la versione deluxe, fatta a mano. Dieci passaggi, lo YAML di ogni scheda e una vista completa da incollare in un colpo solo. Riquadri in vetro verde, una lettura dell'immagine in tempo reale, le tue Scene e un grafico delle ore laser, il tutto da un solo sensore del proiettore. Cambia due stringhe e diventa tua.

Sync ne costruisce una gratis4 schede HACS per l'aspettoRiquadri info subito attiviPulsanti dopo un solo incolla
La dashboard Projector Pilot completata in Home Assistant: accensione e sorgente, modalità colore, menu immagine completo, HDR e segnale, calibrazione RGB, obiettivo e geometria, manutenzione con grafico delle ore laser e Scene, tutto in riquadri di vetro verde
Ecco cosa stai costruendo. Scorri, oppure clicca per ingrandire.
Ti basta una dashboard funzionante? Ce l'hai già. Tocca Sync With HA nell'app e questa costruisce per te una dashboard Projector Pilot già pronta, nella barra laterale di Home Assistant, con ogni comando e il sensore in tempo reale: niente schede, niente YAML, niente incolla. Vedi Sync costruisce la dashboard per te. Questa pagina serve per costruire a mano la versione più ricca in vetro verde, o per personalizzare quella che Sync ti ha dato.
Hai fretta e vuoi l'aspetto personalizzato? Vai al passaggio 10, scarica la vista completa, cambia due stringhe e i tre ID delle Scene, e incollala. I passaggi intermedi spiegano cosa fa ogni parte, così puoi modificarla.

Prima di iniziare

Questa dashboard si alimenta da due fonti, e la differenza conta a ogni passaggio qui sotto.

Proviene daTi dà
Il sensore del proiettore, sensor.YOUR_PROJECTOROgni lettura. Accensione, ingresso, modalità colore, tutti i valori dell'immagine, HDR e segnale, obiettivo e geometria, ore lampada. Attivo non appena accedi e sincronizzi, senza bisogno del blocco Copia.
Gli script sincronizzati dell'app, script.projpilot_YOURSERIAL_...Ogni comando. Accensione, ingressi, modalità colore, memorie obiettivo e le tue Scene. Esistono solo dopo aver incollato il blocco Copia, riavviato Home Assistant e toccato Sync With HA.
Passaggio 1

Installa quattro schede da HACS

Tutte e quattro sono nello store HACS predefinito. In Home Assistant: HACS › Frontend › Esplora & scarica repository, cerca il nome, premi Scarica, poi ricarica il browser.

CercaServe perSe la salti
MushroomOgni riquadro info, pulsante di comando e riquadro ScenaUsa una scheda button semplice. Funziona, ma ha un aspetto più squadrato.
button-cardL'hero, con la sua etichetta in tempo realeUsa una scheda entity, oppure una scheda template di Mushroom con meno dettagli.
card-modLo sfondo in vetro verde, i bordi e i gradientiTutto funziona comunque. Solo, niente bagliore.
mini-graph-cardLo storico delle ore laser sotto ManutenzioneUsa la scheda history-graph integrata.
Nessuna è necessaria perché funzioni. Ogni comando qui sotto funziona con una normale scheda pulsante di Home Assistant che punta allo stesso script. Le schede personalizzate sono l'aspetto in vetro verde, non l'impianto.
Passaggio 2

Trova il tuo ID entità e il tuo numero di serie

Ogni frammento di questa pagina usa due segnaposto. Trovali una volta sola e il resto è copia e incolla.

Puoi anche filtrare Strumenti per sviluppatori › Stati su projpilot per vedere in un colpo solo tutto l'elenco dei comandi sincronizzati, una volta completati il blocco Copia e la sincronizzazione del passaggio 1.

Ancora nessun elenco di script? È normale prima di aver incollato il blocco Copia. Il sensore esiste e si aggiorna comunque; gli script compaiono solo dopo che Sync With HA è stato eseguito con successo.
Passaggio 3

Crea la vista

  1. Impostazioni › Dashboard › Aggiungi dashboard › Nuova dashboard da zero. Chiamala Projector Pilot.
  2. Aprila, poi tocca l'icona della matita in alto a destra per modificare.
  3. Aggiungi una vista. Va bene qualsiasi layout; la dashboard vera usa la pila di schede predefinita, una sotto l'altra, che è la più semplice in cui incollare.
  4. Per incollare lo YAML, usa il menu a tre puntini di una scheda e scegli Modifica in YAML, oppure il menu a tre puntini della dashboard e Editor di configurazione grezzo per incollare un'intera vista in una volta.

Le impostazioni della vista, se preferisci digitarle:

title: Projector Pilot
views:
- title: Projector Pilot
  path: projector-pilot
  icon: mdi:projector
  cards: []
Passaggio 4

Aggiungi un riquadro info in tempo reale

Parti da qualcosa che si limita a leggere, così sai che il tuo ID entità è giusto prima di toccare qualunque cosa invii un comando. Questo è attivo non appena esiste il sensore del tuo proiettore, senza blocco Copia e senza sincronizzazione. Aggiungi una scheda, Modifica in YAML, incolla:

type: custom:mushroom-template-card
primary: Brightness
secondary: '{{ state_attr(''sensor.YOUR_PROJECTOR'',''brightness'') }}'
icon: mdi:brightness-6
icon_color: green
layout: vertical
fill_container: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px);
    min-height: 104px; }'

La stessa struttura legge uno qualsiasi dei circa 80 attributi del sensore: sostituisci brightness con contrast, gamma, color_temp, hdr_pq, lamp_hours, qualunque cosa tu voglia nel riquadro.

Salvalo. Se compare un numero o una parola reale, il tuo ID entità è giusto e tutto ciò che segue funzionerà. Se resta vuoto, torna al passaggio 2.

Passaggio 5

Aggiungi un'intestazione di sezione verde

Un semplice titolo è spazio sprecato. Questa è una scheda markdown con uno sfondo sfumato di card-mod, ed è ciò che trasforma una pila di riquadri in sezioni con un nome. Ogni sezione della dashboard si apre con una di queste, cambiano solo etichetta ed emoji.

type: markdown
content: '🔌    **POWER & SOURCE**'
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.30), rgba(16,120,60,0.30));
    border: 1px solid rgba(61,220,107,0.45); border-radius: 14px; box-shadow: 0 6px 20px rgba(0,0,0,0.3); }
    ha-markdown { padding: 12px 20px !important; } ha-markdown p { margin: 0 !important;
    letter-spacing: 3px; color: #eafff0; font-size: 14px; font-weight: 700; }'

Cambia il codice dell'emoji e il testo dell'etichetta; il blocco card-mod è identico in ogni sezione.

Passaggio 6

Aggiungi un pulsante di comando

Questo invia un comando invece di limitarsi a leggere un valore, quindi gli script devono già esistere. Richiama script.projpilot_YOURSERIAL_power_on, che l'app scrive solo dopo che hai incollato il suo blocco Copia in configuration.yaml, riavviato Home Assistant e toccato Sync With HA.

type: custom:mushroom-template-card
primary: Power On
icon: mdi:power
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_power_on
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

La stessa scheda vale per Spegni, Schermo nero, HDMI 1, HDMI 2, A/V Mute, una modalità colore o una memoria obiettivo: cambiano solo l'etichetta, l'icona e service.

Se sembra giusto ma non succede nulla quando lo tocchi, il blocco Copia non è stato incollato oppure Home Assistant non è stato riavviato da allora. Esegui Test connessione nell'app, che controlla proprio questo, prima di pensare che la dashboard sia sbagliata.
Passaggio 7

Aggiungi l'hero

L'hero in cima alla dashboard è una scheda button-card: un grande stato di accensione, un riepilogo di una riga costruito da più attributi insieme e il trattamento in vetro verde sull'intera scheda, non solo sul bordo.

type: custom:button-card
entity: sensor.YOUR_PROJECTOR
name: Epson QB1000
show_state: true
show_label: true
size: 48px
state_display: '[[[ return entity.state==''on'' ? ''Powered on'' : ''Standby''; ]]]'
label: '[[[ var a=entity.attributes; return (a.input||''-'')+''  •  ''+(a.color_mode||''-'')+
  ''  •  ''+(a.video_range||''-'')+''  •  ''+(a.lamp_hours||0)+''  h''; ]]]'
styles:
  card:
  - height: 176px
  - background: linear-gradient(135deg, rgba(61,220,107,0.32), rgba(11,64,34,0.6))
  - border: 1px solid rgba(61,220,107,0.5)
  - border-radius: 22px
  - box-shadow: 0 12px 36px rgba(0,0,0,0.42)
  - padding: 20px
  state:
  - color: '[[[ return entity.state==''on'' ? ''#3ddc6b'' : ''#8a9'' ]]]'

Ridotto ai pezzi che cambiano a ogni installazione. La scheda completa imposta anche le posizioni nella griglia di icona, nome ed etichetta; trovi tutto nel download del passaggio 10.

Preferisci una striscia più sottile? Una scheda mushroom-chips-card fa lo stesso lavoro in una sola riga di piccoli chip: stato di accensione, ingresso, modalità colore, gamma video e ore lampada, ciascuno un template che legge state_attr('sensor.YOUR_PROJECTOR', ...). Usane una o l'altra, non entrambe, in cima alla dashboard.

Passaggio 8

Aggiungi le tue Scene

Ogni Scena che salvi nell'app diventa uno script chiamato script.projpilot_YOURSERIAL_scene_<id> dopo la sincronizzazione, e il riquadro di una Scena è la stessa scheda pulsante del passaggio 6 con il nome e l'icona della Scena.

type: custom:mushroom-template-card
primary: Movie Night
icon: mdi:movie-open
icon_color: green
layout: vertical
fill_container: true
tap_action:
  action: call-service
  service: script.projpilot_YOURSERIAL_scene_YOURSCENE1
card_mod:
  style: 'ha-card { background: linear-gradient(135deg, rgba(61,220,107,0.16), rgba(16,90,46,0.20));
    border: 1px solid rgba(61,220,107,0.34); border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32);
    min-height: 92px; }'

Sostituisci YOURSCENE1 con l'ID mostrato per quella Scena nell'elenco dei comandi sincronizzati dell'app. Un riquadro per Scena, in una scheda horizontal-stack.

Passaggio 9

Aggiungi lo storico delle ore laser

Home Assistant registra il sensore del proiettore come qualsiasi altro, quindi lamp_hours ha uno storico gratis. Nessun sensore aggiuntivo, nessun helper, niente da configurare prima, nella sezione Manutenzione.

type: custom:mini-graph-card
entities:
- entity: sensor.YOUR_PROJECTOR
  attribute: lamp_hours
  name: Laser hours
name: Laser hours
icon: mdi:lightbulb-on-outline
line_color: '#3ddc6b'
line_width: 4
hours_to_show: 336
points_per_hour: 0.5
height: 96
animate: true
card_mod:
  style: 'ha-card { background: rgba(18,26,20,0.60); border: 1px solid rgba(61,220,107,0.20);
    border-radius: 16px; box-shadow: 0 6px 22px rgba(0,0,0,0.32); backdrop-filter: blur(8px); }'

336 ore sono due settimane. Le ore laser e lampada crescono in modo costante invece di saltare, quindi una finestra di due settimane di solito basta per vedere l'andamento senza che il grafico sembri piatto.

Passaggio 10

Oppure prendi tutto quanto

La vista completa, con ogni sezione e ogni scheda dello screenshot in cima a questa pagina, con segnaposto al posto degli ID entità.

  1. Scarica lo YAML della vista.
  2. Aprilo in un qualsiasi editor di testo e sostituisci, ovunque compaiano: YOUR_PROJECTOR con l'ID entità del tuo sensore del proiettore dal passaggio 2, e YOURSERIAL con il tuo ID derivato dal numero di serie dal passaggio 2.
  3. Nella sezione Scene verso il fondo, sostituisci YOURSCENE1, YOURSCENE2 e YOURSCENE3 con i tuoi tre ID di Scena, oppure aggiungi e rimuovi riquadri in base a quante Scene hai davvero.
  4. In Home Assistant, apri la tua dashboard, icona della matita, menu a tre puntini, Editor di configurazione grezzo, e incollala come vista.
I nomi e il numero delle tue Scene non corrisponderanno. Il file include tre Scene di esempio: Serata cinema, Gaming, Giornata sportiva. Rinomina i riquadri, puntali ai tuoi ID di Scena e aggiungi o elimina riquadri finché la sezione corrisponde a quante Scene hai davvero salvato.
I riquadri info funzionano subito dopo l'incolla. Hanno bisogno solo che il sensore esista. I pulsanti dei comandi e delle Scene restano inattivi finché il blocco Copia non è incollato in configuration.yaml, Home Assistant non è riavviato e non hai toccato Sync With HA.

Risoluzione dei problemi

Un riquadro mostra Sconosciuto

Controlla il nome dell'attributo rispetto a quelli che il sensore ha davvero: Strumenti per sviluppatori › Stati, la tua entità sensor.YOUR_PROJECTOR, e leggi l'elenco dei suoi attributi. Alcune letture, come HDR PQ o HDR HLG, si popolano solo mentre il proiettore riceve davvero quel tipo di segnale, quindi Sconosciuto su questi due può essere corretto e non un guasto. Se l'intero sensore sembra scarso, sveglia il proiettore: un'unità in standby pubblica pochissimo.

Un pulsante non fa nulla

Non hai ancora incollato il blocco Copia, oppure Home Assistant non è stato riavviato da quando l'hai fatto. I pulsanti dei comandi e delle Scene richiamano script scritti dall'app, e quegli script non esistono finché in Impostazioni › Automazione domestica › Home Assistant dell'app il blocco Copia non è incollato in configuration.yaml, Home Assistant non è riavviato una volta e non è stato toccato Sync With HA. Esegui prima Test connessione nell'app: ti dice se il blocco è presente prima che tu cerchi un errore nella dashboard.

Gli script che mi aspetto mancano in Strumenti per sviluppatori › Stati

Filtra su projpilot invece che sull'intero numero di serie: è più facile vedere tutto l'elenco. Se un comando o una Scena aggiunti di recente mancano, tocca di nuovo Sync With HA; si aggiorna sul posto senza richiedere una nuova configurazione. Se script vecchi e inutilizzati ingombrano l'elenco dopo aver eliminato una Scena, usa Rimuovi script orfani nell'app.

Il mio ID entità non assomiglia a quello di questa guida

Lo schema è fisso, la parte centrale no. Il tuo sensore prende il nome dal modello del tuo proiettore, e ogni script riporta il numero di serie del tuo proiettore, non i segnaposto di questa pagina. Ricavali entrambi da Strumenti per sviluppatori › Stati e dalla schermata Home Assistant dell'app, come nel passaggio 2, e usa quelli invece di digitare il testo di esempio.

Tutto il tuo proiettore, su una sola parete

L'Automazione domestica è un componente aggiuntivo a pagamento una tantum. Nessun abbonamento, nessun account, nessun cloud. Un solo acquisto lo sblocca su tutte le piattaforme che possiedi.

Google Play - disponibile ora App Store - in attesa di approvazione Microsoft Store - in attesa di approvazione Mac App Store - in attesa di approvazione

Torna ad Automazione domestica → · Guida utente completa →

FAQ

Risposte rapide

Devo costruire questa dashboard a mano?

No. Quando tocchi Sync With HA nell'app, questa costruisce per te una dashboard Projector Pilot già pronta direttamente in Home Assistant, con il sensore del proiettore in tempo reale più un pulsante per ogni comando e Scena, e compare nella barra laterale come Projector Pilot. Questa pagina serve per costruire a mano la versione più ricca in vetro verde, o per personalizzare ciò che Sync ha creato.

Mi servono schede personalizzate da HACS per crearla?

Per ottenere l'aspetto dello screenshot, sì: Mushroom, button-card, card-mod e mini-graph-card. Nessuna è necessaria per far funzionare i comandi di base: ogni pulsante è una semplice chiamata a uno script, e le schede personalizzate sono solo la veste grafica.

Perché i riquadri informativi mostrano un valore ma i pulsanti non fanno nulla?

Il sensore del proiettore pubblica le sue letture non appena accedi e sincronizzi nell'app, quindi i riquadri informativi sono attivi subito. I pulsanti dei comandi e delle Scene richiamano script che esistono in Home Assistant solo dopo aver incollato il blocco Copia dell'app in configuration.yaml, riavviato Home Assistant e toccato Sync With HA una volta.

I miei ID entità corrisponderanno a quelli di questa guida?

Lo schema sì, i caratteri esatti no. Il sensore del proiettore prende il nome dal modello del tuo proiettore, e ogni script prende il nome dal suo numero di serie. Dove questa pagina scrive YOUR_PROJECTOR, inserisci l'ID entità del tuo sensore; dove scrive YOURSERIAL, inserisci l'ID derivato dal numero di serie mostrato nella schermata Home Assistant dell'app.