ATENÇÃO
: Este tutorial foi feito usando a versão 0.95.4 do HA e 0.11.1 do HACS, e pode em futuras versões sofrer algumas alterações
Hoje vamos falar sobre o novo componente HACS (Home Assistant Community Store), que vem fazer basicamente o mesmo que o custom_updater mas com uma interface integrada no HA e semi-automatizado.
O que o HACS trás de novo?
O HACS é, não mais nem menos, do que um gerenciador de Custom Components e Cartões Lovelace do Home Assistant, o que vai facilitar na instalação, actualização e descoberta de novos cartões e integrações (custom_components).
O HACS pode ser encontrado no GitHub em:
Instalação do HACS
Começar por ir ao repositório (ver link acima) e fazer o download do ficheiro Source code
.
Depois de feito o download, vamos extrair a pasta hacs
que se encontra dentro da pasta custom componentes
e que vai ser colocada dentro da vossa pasta custom components .
Para quem não tem a pasta
custom_components
, deve criar uma pasta chamadacustom_components
dentro da pasta config. Por fim devem reiniciar o HA.
ATENÇÂO: Quem já tinha o custom_updater vai ter de apagar totalmente a pasta
custom updater
e os custom cards que já tinham…`
Não se esqueçam que após fazer o setup do HACS tem de reinstalar TODOS os cartões novamente.
Configuração do HACS
O HACS recorre ao uso da API do GitHub para retirar informação do mesmo, logo tem de fazer a sua configuração.
Vão ter de ir ao GitHub Developer Settings em https://github.com/settings/tokens e gerar um novo token
Se for pedido para fazer o login, vão ter de o fazer. Seguidamente criam um nome para o token.
Mais abaixo vão carregar gerar em Generate Token.
Copiam o token.
De seguida abrem o configuration.yaml
e inserem a seguinte entrada com o vosso token.
hacs:
token: !secret hacs_github_access_token
No meu caso, o token está escondido no secrets.yaml mas caso não usem !secret
simplemente ponham lá o vosso token.
hacs:
token: 696969696969issoqueriastuwuhjeiwjijsd
Reiniciem o HA e neste momento tudo deve estar em ordem. Após reiniciar, já deve aparecer uma nova entrada no menu do lado esquerdo do HA chamada Community
.
E é isto, neste momento o HACS já esta todo configurado. Só precisam e ir ao link STORE
para escolher e instalar os cards e components que necessitem.
Não se esqueçam de pôr as entradas do resources nos devidos sítios. Leiam as instruções que aparecem ao instalar pois o HACS tem boas instruções de como instalar os cartões e os componentes
Caso algum card só tenha o - url:
não se esqueçam que é sempre necessário a entrada type:
. As entradas podem ser de dois tipos: ou type: js
ou type: module
. Caso não o tenham, tem de ir ao repositório do cartão para ver qual será o seu tipo.
Espero ter ajudado,
Happy coding