NdR-PhoneUI
NdR-PhoneUI copied to clipboard
NdR91
NDR PHoneUI
README NON COMPLETO
Screenshots
Credits:
- Questa Dashboard è ispirata al lavoro di TBens: lovelace-ui-minimalist
- Molte delle icone utilizzate provengono dall'ottima repo di elax46: custom-brand-icons
Se ti piace il mio lavoro...
Indice
- Preparazione
- File configuration.yaml
- Card
- Split della configurazione
- File button-card-template.yaml
- Esempi
- Localizzazione
- Avviso entità non disponibile
Preparazione
Per installare ed adattare la Dashboard, è prima necessario eseguire una serie di passi.
File configuration.yaml
Il metodo migliore per lavorare su una UI così complessa, è quello di utilizzare un file .yaml al posto degli strumenti messi a disposizione sul Frontend di Home Assistant.
Per conservare la possibilità di utilizzare entrambi i metodi (ovvero la creazione di "Plance" sia da frontend che da file yaml), sarà necessario inserire questo paragrafo al configuration.yaml:
lovelace:
# MODE
mode: storage
# ------------------------------------------------------
# Dashoards
dashboards:
# NdR Phone UI
ndr-phoneui: #<-- Nome a piacimento
mode: yaml
title: NdR Phone UI #<-- Titolo a piacimento
icon: mdi:home-assistant #<-- Icona a piacimento
show_in_sidebar: true
filename: ndr_phoneui.yaml #<-- Nome a piacimento
# ----------------------------------------------------
Nota: molto importante la parte mode: storage. Questo significa che potrete utilizzare sia Dashboard create da Frontend che in modalità yaml
Card ed Integrazioni
Il numero ed il tipo di Card ed Integrazioni da utilizzare è totalmente soggettivo. Quelle che però risultano necessarie per ottenere il risultato mostrato negli screenshots, sono le seguenti:
- [x] Layout Card
- [x] Card Mod
- [x] Button Card
- [x] Browser Mod
Le istruzioni per l'installazione di ogni componente aggiuntivo sono disponibili nelle repo GitHub linkate.
Split della configurazione
Come avviene per il configuration.yaml, anche il file relativo alla Dashboard può essere "spezzettato" in più file.
Questa pratica non è obbligatoria, serve solo a creare ordine.
Nell'esempio di questa Repo, troverete questa configurazione all'interno del file ndr_phoneui.yaml:
Ricordo che il nome del file può essere cambiato a piacimento. L'importante è che il nome combaci con il campo
filename:presente nelconfiguration.yaml
# Titolo
title: Home
# --------------------------------------------------------
# Button Card Templates
button_card_templates: !include lovelace/NdR-PhoneUI/button_card_templates.yaml
# --------------------------------------------------------
# Viste
views: !include_dir_merge_list lovelace/NdR-PhoneUI/views/
# --------------------------------------------------------
Come intuibile, queste poche righe non fanno altro che indicare dove Home Assistant dovrà andare a trovare i file contenenti gli elementi che compongono la Dashboard.
Oltre a quanto sopra, si aggiungono i "Popup", realizzati grazie all'integrazione Browser Mod. Per ridurre ulteriormente la dimensione di ogni file, ho deciso di spostare le card relative ai Popup in una cartella dedicata.
Per fare questo, è bastato richiamare il percorso in questo modo:
tap_action:
action: fire-dom-event
browser_mod:
command: popup
title: []
style:
card: !include /config/lovelace/NdR-PhoneUI/popup/person.yaml
In sostanza, questa è la rappresentazione dell'organizzazione ho ho voluto dare:
ndr_phoneui.yaml
├── lovelace/NdR-PhoneUI
│ ├── button_card_templates.yaml
│ ├── views
│ │ ├── 01_home.yaml
│ │ ├── 02_power.yaml
│ │ ├── 03_system.yaml
│ │ ├── 04_rooms.yaml
│ ├── popup
│ │ ├── alarm.yaml
│ │ ├── person.yaml
│ │ ├── tvremote.yaml
All'atto pratico, cosa significa tutto questo? E' molto semplice:
Se, come descritto sopra, nel file di lovelace (ndr_phoneui.yaml nell'esempio in questa repo) è presente:
views: !include_dir_merge_list lovelace/NdR-PhoneUI/views/
E dentro la cartella views abbiamo il file 01_home.yaml, con al suo interno qualcosa tipo:
- title: Home
path: home
icon: 'mdi:home-roof'
panel: false
type: custom:grid-layout
badges: []
cards:
Il risultato, per Home Assistant, è come se avessimo un unico file ndr_phoneui.yaml contenente tutto:
# Titolo
title: Home
# --------------------------------------------------------
# Button Card Templates
button_card_templates: !include lovelace/NdR-PhoneUI/button_card_templates.yaml
# --------------------------------------------------------
# Viste
views:
- title: Home
path: home
icon: 'mdi:home-roof'
panel: false
type: custom:grid-layout
badges: []
cards:
File button-card-templates.yaml
Il file button-card-templates.yaml funziona in modo molto simile ai popup di browser-mod.
In sostanza esso contiene una serie di "frazioni di button card standard", che possono essere richiamate dalle "viste"
Anche questo caso, l'utilizzo del file button-card-templates.yaml non è obbligatorio: serve solo per mantenere ordinati i file della Dashboard.
Il suo funzionamento è semplice, se avete già compreso i concetti esposti nel paragrafo precedente: creando una card 'custom:button-card', si può utilizzare la variabile template per richiamare delle porzioni di codice presenti nel file button-card-templates.yaml.
Esempio pratico:
Nella vista 01_home.yaml troviamo, fra le altre, la seguente card:
- type: 'custom:button-card'
template: chips_temperature
Questo significa che, nel file button-card-templates.yaml, dovrà essere presente una porzione relativa a chips_temperature:
chips_temperature:
template: chips
tap_action:
action: none
haptic: light
label: |
[[[
var inter = states['sensor.daikin_sala_inside_temperature'].state;
var exter = states['sensor.openweathermap_temperature'].state;
var icon = '☀️';
if (states['sensor.openweathermap_weather'].state == 'clear-day'){
var icon = '☀️';
...
} else if(states['sensor.openweathermap_weather'].state == 'partly-cloudy-night'){
var icon = '⛅';
}
return icon + ' ' + inter + '° / ' + exter + '°' ;
]]]
Nota: la voce "label" è stata appositamente abbreviata per praticità
Come si può notare, anche il template chips_temperature richiama a sua volta un altro template chips:
chips:
tap_action:
action: more-info
haptic: light
show_icon: false
show_name: false
show_state: false
show_label: true
size: 80%
styles:
img_cell:
- width: 24px
card:
- border-radius: 30px
- box-shadow: var(--box-shadow)
- height: 36px
- width: auto
- padding-left: 6px
- padding-right: 6px
grid:
- grid-template-areas: '"l"'
label:
- justify-self: center
- padding: 0px 6px
- font-weight: bold
- font-size: 14px
Il tutto, equivale alla card seguente:
- type: 'custom:button-card'
tap_action:
action: none
haptic: light
label: |
[[[
var inter = states['sensor.daikin_sala_inside_temperature'].state;
var exter = states['sensor.openweathermap_temperature'].state;
var icon = '☀️';
if (states['sensor.openweathermap_weather'].state == 'clear-day'){
var icon = '☀️';
...
} else if(states['sensor.openweathermap_weather'].state == 'partly-cloudy-night'){
var icon = '⛅';
}
return icon + ' ' + inter + '° / ' + exter + '°' ;
]]]
show_icon: false
show_name: false
show_state: false
show_label: true
size: 80%
styles:
img_cell:
- width: 24px
card:
- border-radius: 30px
- box-shadow: var(--box-shadow)
- height: 36px
- width: auto
- padding-left: 6px
- padding-right: 6px
grid:
- grid-template-areas: '"l"'
label:
- justify-self: center
- padding: 0px 6px
- font-weight: bold
- font-size: 14px
Una cosa, molto importante, da notare, è che alcune voci possono ripetersi nei vari template. In questo caso la variabile tap_action è presente sia nel template chips_temperature che in cheaps.
Il risultato sarà che il primo template, per ordine di inserimento, prevarrà sui successivi.
README in aggiornamento...
Esempi
Localizzazione
Icona Batteria
Avviso entità non disponibile
Stato Entità
NdR91