HACS guida all’installazione
Aggiornamento: 08.10.2019 Installazione Hacs con integrazione
Forse molti di voi già lo conoscono e lo stanno utilizzando in Home Assistant, ma per coloro che ignorano la sua esistenza vedremo in questo articolo come installarlo.
Hacs è uno store come gli add-on di Hassio che ci permette di installare facilmente custom_component, platform, card ed un sacco di altre cose tutto con istruzioni dettagliate sul da farsi. Hacs si preoccupa di verificare gli aggiornamenti e avvisare la presenza di nuovi pacchetti.
Tutte queste repository presenti in Hacs sono salvate su Github e quelle non ancora direttamente implementate in esso si possono integrare manualmente inserendo l’indirizzo della nuova repository.
Prima dell'installazione
Se avete precedentemente installato la custom_updater dovete procedere alla sua rimozione ed eliminare la voce custom_updater: nel file configuration.yaml
Installazione
Andate a scaricare l’ultima versione del file hacs.zip al link https://github.com/custom-components/hacs/releases
Scompattate il tutto in una cartella a piacere sul Pc, poi copiate la cartella hacs nella cartella config/custom_components di Home Assistant se non la avete createla.
Vi troverete ora questi file nella cartella di Home Assistant ( il contenuto della cartella può variare con le nuove versioni) il percorso sarà:/config/custom_components/hacs
Mentre per Home Assiatant Core il percorso sarà: /home/homeassistant/.homeassistant/custom_components/hacs
Riavviare Home Assistant prima di passare al la fase successiva.
Registrazione e recupero del Token su Github
Hacs necessita di un account Github per essere installato e la creazione di un token da inserire nella configurazione di HA.
Iniziamo a registrare un account Github se lo avete già andate nella sezione creazione token altrimenti andate su https://github.com/join
Create l’account e selezionate il piano che preferite (free)
Verificate la registrazione andando a leggere l’email inviatavi da Github e premento il tasto Verify email address.
Completate la registrazione e concludete con il tasto Create Reposity
Ora andate all’indirizzo https://github.com/settings/tokens e premete su Generate new token
Date un nome a piacere e concludete con Generate token
Copiate il codice token appena generato che vi servirà per la configurazione in HA
Configurazione in Home Assistant
La fase finale di installazione è possibile eseguirla in due modi differenti o tramite integrazione o dichiarandola nel file configuration.yaml, vediamole entrambi.
Integrazione
Dal menù impostazioni, poi integrazioni premete il cerchio con il simbolo +, nell’angolo in basso a destra.
Nella riga di ricerca digitate hacs e premete nella riga sottostante HACS (Home Assistant Comunity Store). Nel caso non comparisse fate un refresh (F5) alla pagina o chiudete e riaprite il browser se ancora non dovesse comparire o se compare ma il processo non va avanti fate un reboot dal menù Supervaisor.
Successivamente vi comparirà questa schermata dove inserirete: il token precedentemente recuperato, il nome che comparirà nella side-bar, l’icona associata ed infine la selezione del monitoraggio di tutte gli altri applicativi di Hacs.
Dichiarazione file yaml
Nel file configuration.yaml aggiungete le seguenti righe con il token appena creato
hacs:
token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Personalizzazioni
Key
token
sidepanel_title
sidepanel_icon
appdaemon
options
Opzione
True
True
True
True
True
Defoult
Comunity
“mdi:alpha-c-box”
False
Descrizione
Un token di accesso personale di Github
Il nome da visualizzare nel pannello laterale
L’icona da associalre
Abilita il tracciamento delle app AppDaemon
Opzioni Aggiuntive
hacs:
token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
option:
...
Opzione
country
release_limit
experimental
Descrizione
Imposta un filtro basato sul tuo codice paese A2 (ISO)
Numero di rilasci da mostrare nel selettore di versione. (Il valore predefinito è 5)
Opzione versione sperimentali (il valore predefinito è False).
Salvate e riavviate HA.
HACS
Dopo il riavvio vi troverete un nuovo menù nel fronted: Comunity
In Overview troverete le repository installate, invece in Shop quelle disponibili per l’installazione; cliccandoci sopra troverete una spiegazione di cosa si tratta e le istruzioni da eseguire.
In alto a destra troverete Setting, all’interno troverete oltre alla versione di Hacs installata alcune funzioni, tra cui la possibilità di aggiornale tutte le repository o inserirle manualmente di nuove.
Ad esempio in guesto plug-in viene richiesto di copiare su lovelace la parte di resources: ed inoltre spiegato come creare la nuova custom_card in questo caso weather-card.
6 risposte
Non trovo HACS nelle integrazioni di Hassio? Perchè?
Scusa la mia imprecisione ma prima devi copiare i file poi hacs lo troverai nell’integrazione.
Ho lo stesso problema anch’io. Ho copiato prima i files, ma non vedo comunque HACS nella lista Integrazione. Come fare?
ciao, hai trovato una soluzione?
Clear your browser cache
Before HACS can show up in the list you need to clear your browser cache.
Press SHIFT + F5 or SHIFT + reload page
Ciao, spero tu possa aiutarti. Ho uploadato i file di Hacs, ho aggiunto l’integrazione e il codice nel configuration.yaml, ma se clicco su Community carica all’infinito e nel log trovo un errore di questo tipo:
File “/usr/src/homeassistant/homeassistant/components/websocket_api/decorators.py”, line 20, in _handle_async_response
await func(hass, connection, msg)
File “/config/custom_components/hacs/ws_api_handlers.py”, line 142, in hacs_repositories
“default_branch”: repo.data.default_branch,
AttributeError: ‘dict’ object has no attribute ‘default_branch’
Da cosa può dipendere?
Grazie mille!