Sobre o projeto

Este repositório fornece uma integração personalizada do Home Assistant para sensores ambientais Cisco Meraki MT. Ela lê dados dos sensores através da API do Meraki Dashboard e registra cada sensor físico como um dispositivo do Home Assistant, com métricas individuais expostas como entidades separadas. As leituras suportadas incluem temperatura, umidade, detecção de água, status de porta, pressionamentos de botão, CO2, TVOC, PM2.5, ruído, índice de qualidade do ar interno, nível de bateria, medições elétricas (voltagem, corrente, potência), intensidade do sinal (RSSI) e métricas de conectividade de última visualização. O hardware suportado é a série MT: MT10, MT12, MT14, MT15, MT20, MT30 e MT40. A instalação é oferecida através do HACS a partir do repositório padrão, ou manualmente copiando a pasta custom_components/meraki_dashboard. A configuração requer uma chave de API Meraki e uma seleção de organização; os usuários podem escolher dispositivos específicos ou monitorar todos, definir o intervalo de atualização e ativar ou desativar a descoberta automática com seu próprio intervalo de varredura. Uma opção permite uma sondagem mais frequente de dispositivos MT15/MT40. Avisos importantes estão documentados. A versão 0.38.0 é um lançamento com mudanças que quebram a compatibilidade, tornando a integração exclusiva para MT: o suporte para pontos de acesso MR, switches MS e câmeras MV foi removido, e a atualização migra a entrada de configuração e remove dispositivos e entidades não-MT, emitindo um aviso de reparo. Eventos de porta MT20 e botão MT30 são detectados por sondagem em vez de webhooks, então eventos breves entre sondagens podem ser perdidos ou relatados com atraso. Os sensores Meraki MT também atualizam aproximadamente a cada 20 minutos por padrão, então intervalos de sondagem mais curtos não necessariamente produzem dados mais recentes. O README inclui exemplos YAML para uma automação de vazamento de água e um cartão de entidades para painel, convenções de nomenclatura de entidades, atributos de sensores (serial, modelo, id/nome da rede, timestamp do último relatório), configuração de registro de depuração, notas de solução de problemas e instruções de desenvolvimento local usando Poetry, pytest, ruff e hassfest. O projeto é licenciado sob Apache 2.0 e declara que não é afiliado ou endossado pela Cisco.