Controle de espaços
Shelly: identificar modelo, API e estado disponível
Para avaliar um equipamento Shelly, identifique o modelo completo e a geração. Produtos parecidos podem usar protocolos e funções diferentes. Defina primeiro quais informações precisa exibir e qual ação quer coordenar com o sistema AV.
Modelo e geração antes da API
A ficha Plus Plug US descreve medição de potência e energia, Wi-Fi e acesso local ou por serviços de nuvem. Não confunda com Plug US Gen4, Plus Plug S ou Wave Plug US. Confira também a variante conforme país e requisitos elétricos.
A documentação do Home Assistant Core 2026.10.3 diferencia Gen1 com CoIoT de Gen2+ com RPC. A integração Shelly tem requisitos de firmware; confira a versão real em vez de copiar instruções de outro modelo.
| Dado | Referência do exemplo | O que confirmar |
|---|---|---|
| Equipamento | Plus Plug US / SNPL-00116US / Gen2 | Modelo e mercado da unidade. |
| API | switch:0 na documentação Gen2 | Funções e campos conforme firmware. |
| Plataforma | Home Assistant Core 2026.10.3 / Shelly | Versão instalada e integração aplicável. |
Estado elétrico não confirma imagem
Exemplo conceitual com dados fictícios: uma interface mostra “saída informada: ativa” e “potência informada: 18 W”. Esses valores não comprovam projetor pronto, entrada correta ou imagem visível. A confirmação audiovisual precisa do retorno documentado do próprio equipamento AV.
A API diferencia funções de leitura daquelas que alteram a saída. Ao definir a integração, separe os dados que quer exibir de qualquer ação sobre o equipamento e confira os requisitos de cada função.
- Modelo e firmware → API/componente documentados.
- Dado de estado → significado e atualidade na interface.
- Confirmação AV → retorno independente do equipamento audiovisual.
Separar rede local, nuvem e recuperação
Uma via local documentada não comprova continuidade de toda uma sala. Registre dependências de Wi-Fi, plataforma, conta, Internet e alimentação. Defina também quem mantém o comando manual e o que revisar após reconectar.
Em uma unidade existente, identifique horários, scripts e ações configurados antes de propor mudanças. Uma lista autorizada basta para a análise inicial; não exige entrar na rede nem ativar esses elementos.
Como apresentar a necessidade
Conte qual estado quer conhecer, para qual equipamento AV e em qual país. Acrescente modelo, firmware e plataforma se disponíveis. Podemos organizar alternativas audiovisuais e a coordenação antes de definir fornecimento ou integração.
A seleção de cargas e os trabalhos elétricos exigem análise específica. Este guia não ensina a fazer fiação, energizar, redefinir ou acionar cargas. Máquinas, movimentos motorizados e funções críticas estão excluídos.