Início › Guia do utilizador › Painel do Home Assistant
Home Assistant · passo a passo

Crie um painel de projetor no Home Assistant em cerca de uma hora

A app já cria um painel funcional quando sincroniza - esta página é a versão de luxo, feita à mão. Dez passos, o YAML de cada cartão e uma vista completa que pode colar de uma só vez. Mosaicos de vidro verde, uma leitura da imagem em direto, as suas Cenas e um gráfico das horas do laser, tudo a partir de um único sensor do projetor. Mude duas cadeias de texto e fica seu.

A sincronização cria um de graça4 cartões HACS para o aspetoMosaicos de informação logo em diretoBotões depois de uma colagem
O painel Projector Pilot terminado no Home Assistant: energia e fonte, modos de cor, o menu de imagem completo, HDR e sinal, calibração RGB, lente e geometria, manutenção com um gráfico das horas do laser, e Cenas, tudo em mosaicos de vidro verde
O que vai construir. Faça scroll ou clique para ampliar.
Só quer um painel que funcione? Já tem um. Toque em Sincronizar com o HA na app e ela cria por si um painel Projector Pilot pronto a usar, na barra lateral do Home Assistant, com todos os controlos e o sensor em direto - sem cartões, sem YAML, sem colar. Veja A sincronização cria o painel por si. Esta página serve para construir à mão a versão mais rica em vidro verde, ou para personalizar o que a sincronização lhe deu.
Com pressa pelo aspeto personalizado? Salte para o passo 10, descarregue a vista completa, mude duas cadeias de texto e os três IDs das Cenas, e cole. Os passos intermédios explicam o que cada peça faz, para que possa alterá-la.

Antes de começar

Este painel é alimentado por duas coisas, e a diferença conta em todos os passos seguintes.

OrigemO que oferece
O sensor do projetor, sensor.YOUR_PROJECTORTodas as leituras. Energia, entrada, modo de cor, todos os valores da imagem, HDR e sinal, lente e geometria, horas da lâmpada. Em direto assim que inicia sessão e sincroniza, sem precisar do bloco Copiar.
Os scripts sincronizados da app, script.projpilot_YOURSERIAL_...Todos os controlos. Energia, entradas, modos de cor, memórias da lente e as suas Cenas. Estes só existem depois de colar o bloco Copiar, reiniciar o Home Assistant e tocar em Sincronizar com o HA.
Passo 1

Instale quatro cartões a partir do HACS

Os quatro estão na loja predefinida do HACS. No Home Assistant: HACS › Frontend › Explore & Download Repositories, procure o nome, clique em Download e recarregue o navegador.

Procurar porServe paraSe o ignorar
MushroomTodos os mosaicos de informação, botões de controlo e mosaicos de CenaUse um cartão button simples. Funciona, mas fica mais quadrado.
button-cardO destaque, com a respetiva etiqueta em diretoUse um cartão entity, ou um cartão de modelo Mushroom com menos detalhe.
card-modO fundo de vidro verde, os contornos e os gradientesTudo continua a funcionar. Só falta o brilho.
mini-graph-cardO histórico das horas do laser em ManutençãoUse o cartão history-graph incorporado.
Nenhum deles é necessário para funcionar. Cada controlo abaixo corre a partir de um cartão de botão normal do Home Assistant apontado para o mesmo script. Os cartões personalizados são o aspeto de vidro verde, não a canalização.
Passo 2

Encontre o ID da sua entidade e o seu número de série

Todos os excertos desta página usam dois marcadores de posição. Encontre os seus uma vez e o resto é copiar e colar.

Também pode filtrar Ferramentas de programação › Estados por projpilot para ver de uma vez toda a lista de controlos sincronizados, depois de concluídos o bloco Copiar e a sincronização do passo 1.

Ainda sem lista de scripts? É o esperado antes de colar o bloco Copiar. O sensor continua a existir e a atualizar-se; os scripts só aparecem depois de Sincronizar com o HA correr com sucesso.
Passo 3

Crie a vista

  1. Definições › Painéis › Adicionar painel › Novo painel de raiz. Chame-lhe Projector Pilot.
  2. Abra-o e depois o ícone do lápis, em cima à direita, para editar.
  3. Adicione uma vista. Qualquer disposição serve; o painel real usa a pilha de cartões predefinida, um por baixo do outro, que é a mais simples para colar.
  4. Para colar YAML, use o menu de três pontos de um cartão e escolha Editar em YAML, ou o menu de três pontos do painel e Editor de configuração em bruto para colar uma vista inteira de uma vez.

As definições da própria vista, se preferir escrevê-las:

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

Adicione um mosaico de informação em direto

Comece por algo que apenas lê, para saber que o ID da sua entidade está certo antes de mexer em algo que envia um comando. Este fica em direto assim que o sensor do projetor existe, sem bloco Copiar nem sincronização. Adicione um cartão, Editar em YAML, cole:

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; }'

A mesma forma lê qualquer um dos cerca de 80 atributos que o sensor tem: troque brightness por contrast, gamma, color_temp, hdr_pq, lamp_hours, o que quiser no mosaico.

Guarde. Se aparecer um número ou uma palavra real, o ID da sua entidade está certo e tudo o que se segue vai funcionar. Se aparecer em branco, volte ao passo 2.

Passo 5

Adicione um cabeçalho de secção verde

Um título simples é espaço morto. Este é um cartão markdown com um fundo em gradiente do card-mod, e é o que transforma uma pilha de mosaicos em secções com nome. Cada secção do painel abre com um destes, só muda a etiqueta e o 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; }'

Mude o código do emoji e o texto da etiqueta; o bloco card-mod é idêntico em todas as secções.

Passo 6

Adicione um botão de controlo

Este envia um comando em vez de apenas ler um valor, por isso precisa que os scripts existam primeiro. Chama script.projpilot_YOURSERIAL_power_on, que a app só escreve depois de colar o bloco Copiar em configuration.yaml, reiniciar o Home Assistant e tocar em Sincronizar com o 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; }'

O mesmo cartão serve para Desligar, Ecrã em branco, HDMI 1, HDMI 2, A/V Mute, um modo de cor ou uma memória da lente: só mudam a etiqueta, o ícone e service.

Se parece certo mas nada acontece quando toca, o bloco Copiar ainda não foi colado ou o Home Assistant não foi reiniciado desde então. Execute Testar ligação na app, que verifica exatamente isso, antes de presumir que o painel está errado.
Passo 7

Adicione o destaque

O destaque no topo do painel é um button-card: um grande estado de energia, um resumo de uma linha construído a partir de vários atributos em simultâneo e o efeito de vidro verde no cartão inteiro e não apenas no contorno.

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'' ]]]'

Reduzido às peças que mudam em cada instalação. O cartão completo também define o ícone, o nome e as posições da grelha das etiquetas; veja a transferência no passo 10 para tudo isso.

Prefere uma faixa mais fina? Um mushroom-chips-card faz o mesmo trabalho numa linha de pequenas etiquetas: estado de energia, entrada, modo de cor, gama de vídeo e horas da lâmpada, cada uma um modelo que lê state_attr('sensor.YOUR_PROJECTOR', ...). Use um ou outro, não ambos, no topo do painel.

Passo 8

Adicione as suas Cenas

Cada Cena que guarda na app torna-se, depois de sincronizar, um script com o nome script.projpilot_YOURSERIAL_scene_<id>, e um mosaico para uma delas é o mesmo cartão de botão de controlo do passo 6, com o nome e o ícone da Cena.

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; }'

Substitua YOURSCENE1 pelo ID mostrado para essa Cena na lista de controlos sincronizados da app. Um mosaico por Cena, num horizontal-stack.

Passo 9

Adicione o histórico das horas do laser

O sensor do projetor é registado pelo Home Assistant como qualquer outro, por isso lamp_hours tem um histórico de graça. Sem sensores extra, sem auxiliares, nada para configurar primeiro, na secção Manutenção.

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 horas são duas semanas. As horas do laser e da lâmpada sobem de forma constante, sem saltos, por isso uma janela de duas semanas costuma chegar para ver a tendência sem o gráfico parecer plano.

Passo 10

Ou leve tudo

A vista completa, com todas as secções e todos os cartões da captura de ecrã no topo desta página, com marcadores no lugar dos IDs das entidades.

  1. Descarregar o YAML da vista.
  2. Abra-o num editor de texto qualquer e substitua, em todos os sítios onde aparecem: YOUR_PROJECTOR pelo ID da entidade do sensor do seu projetor do passo 2, e YOURSERIAL pelo seu ID derivado do número de série do passo 2.
  3. Na secção de Cenas, perto do fim, substitua YOURSCENE1, YOURSCENE2 e YOURSCENE3 pelos IDs das suas três Cenas, ou adicione e remova mosaicos conforme o número de Cenas que realmente tem.
  4. No Home Assistant, abra o seu painel, o ícone do lápis, o menu de três pontos, Editor de configuração em bruto, e cole-o como uma vista.
Os nomes e o número das suas Cenas não vão coincidir. O ficheiro traz três Cenas de exemplo: Movie Night, Gaming, Sports Day. Mude o nome dos mosaicos, aponte-os para os IDs das suas Cenas e adicione ou apague mosaicos até a secção corresponder ao número de Cenas que realmente guardou.
Os mosaicos de informação funcionam logo depois de colar. Só precisam que o sensor exista. Os botões de controlo e de Cena ficam inertes até o bloco Copiar ser colado em configuration.yaml, o Home Assistant ser reiniciado e você tocar em Sincronizar com o HA.

Resolução de problemas

Um mosaico mostra Desconhecido

Compare o nome do atributo com o que o sensor realmente tem: Ferramentas de programação › Estados, a sua entidade sensor.YOUR_PROJECTOR, e leia a lista de atributos. Algumas leituras, como HDR PQ ou HDR HLG, só são preenchidas enquanto o projetor está mesmo a receber esse tipo de sinal, por isso Desconhecido nessas duas pode ser correto e não uma avaria. Se o sensor todo parece escasso, acorde o projetor: uma unidade em standby publica muito pouco.

Um botão não faz nada

Ainda não colou o bloco Copiar, ou o Home Assistant não foi reiniciado desde então. Os botões de controlo e de Cena chamam scripts que a app escreve, e esses scripts não existem enquanto Definições › Automação doméstica › Home Assistant na app não tiver o bloco Copiar colado em configuration.yaml, o Home Assistant reiniciado uma vez e Sincronizar com o HA tocado. Execute primeiro Testar ligação na app - diz-lhe se o bloco está presente antes de ir à procura de um erro no painel.

Os scripts que espero estão em falta em Ferramentas de programação › Estados

Filtre por projpilot em vez do número de série completo - é mais fácil ver a lista toda. Se um controlo ou Cena que adicionou recentemente está em falta, toque outra vez em Sincronizar com o HA; atualiza no local, sem exigir uma configuração nova. Se scripts antigos e mortos estão a atulhar a lista depois de apagar uma Cena, use Remover scripts órfãos na app.

O ID da minha entidade não se parece com o deste guia

O padrão é fixo, o meio não. O seu sensor tem o nome do modelo do seu próprio projetor, e cada script leva o número de série do seu próprio projetor, não os marcadores desta página. Obtenha ambos em Ferramentas de programação › Estados e no ecrã do Home Assistant da app, como no passo 2, e use-os em vez de escrever o texto de exemplo.

O seu projetor inteiro, numa só parede

A Automação doméstica é um extra de compra única. Sem subscrição, sem conta, sem nuvem. Uma compra desbloqueia-a em todas as plataformas que tem.

Google Play - disponível agora App Store - a aguardar aprovação Microsoft Store - a aguardar aprovação Mac App Store - a aguardar aprovação

Voltar a Domótica → · Guia do utilizador completo →

FAQ

Respostas rápidas

Tenho de construir este painel à mão?

Não. Quando toca em Sincronizar com o HA na app, ela cria por si um painel Projector Pilot pronto a usar diretamente no Home Assistant - o sensor do projetor em direto mais um botão para cada controlo e Cena - e aparece na barra lateral como Projector Pilot. Esta página serve para construir à mão a versão mais rica em vidro verde, ou para personalizar o que a sincronização criou.

Preciso de cartões personalizados do HACS para o criar?

Para igualar o aspeto da captura de ecrã, sim: Mushroom, button-card, card-mod e mini-graph-card. Nenhum deles é necessário para os controlos de base funcionarem - cada botão é uma simples chamada de script, e os cartões personalizados são apenas o estilo por cima.

Porque é que os mosaicos de informação mostram um valor mas os botões não fazem nada?

O sensor do projetor publica as suas leituras assim que inicia sessão e sincroniza na app, por isso os mosaicos de informação estão em direto logo de imediato. Os botões de controlo e de Cena chamam scripts que só existem no Home Assistant depois de colar o bloco Copiar da app em configuration.yaml, reiniciar o Home Assistant e tocar uma vez em Sincronizar com o HA.

Os meus IDs de entidade vão coincidir com os deste guia?

O padrão sim, os carateres exatos não. O sensor do seu projetor tem o nome do modelo do projetor, e cada script tem o nome do número de série do projetor. Onde esta página escreve YOUR_PROJECTOR, coloque o ID da entidade do seu próprio sensor; onde escreve YOURSERIAL, coloque o ID derivado do número de série mostrado no ecrã do Home Assistant da app.