O problema
Seu modem a cabo rastreia dados de qualidade de sinal — quão forte é sua conexão, quão limpo é o sinal, se erros estão se acumulando. Tudo está enterrado na interface web do modem. Mas esses dados não são acionáveis.
- Sem histórico — você vê um instantâneo de agora, não o que aconteceu às 2h da manhã quando sua conexão caiu
- Sem alertas — o modem não te dirá quando a qualidade do sinal degrada ou erros começam a subir
- Sem prova — quando você liga para seu provedor, "a internet está lenta" não é evidência sobre a qual eles possam agir
- Sem correlação — você não pode conectar "Zoom caiu às 15h" com problemas de sinal que você não estava observando
A solução
Cable Modem Monitor puxa dados de sinal diretamente do seu modem e os traz para o Home Assistant. Rastreie a saúde da conexão ao longo do tempo com gráficos históricos que capturam os problemas que você de outra forma perderia.
O que você ganha
Todo modem compatível expõe o mesmo conjunto de entidades, então painéis e automações funcionam da mesma forma, seja qual for o seu hardware.
Qualidade de sinal por canal
Potência (dBmV), SNR e frequência para cada canal de descida e de subida. Os canais são numerados por posição, então os IDs de entidade sobrevivem a um reinício do modem que os renumere.
Rastreamento de erros
Contagens de palavras de código corrigidas e não corrigíveis, além das taxas de erro por minuto.
Saúde da conexão
Status, tempo de atividade, último boot e detecção de reinícios a partir da zeragem dos contadores.
Sondas de saúde
Latência de ping e HTTP, consultadas em sua própria cadência, separada da leitura completa dos dados.
Reinício remoto
Reinicie o modem por um botão do Home Assistant quando a linha precisar de um empurrão. A consulta recua durante o reinício e volta sozinha assim que o modem responde de novo.
Falhas que dizem o próprio nome
Um modem ocupado, um bloqueio de firmware, um host inalcançável e uma senha realmente errada relatam cada um a sua própria causa — assim você conserta o que de fato quebrou.
Somente local
Sem nuvem, sem telemetria. A integração lê a interface web local do seu modem, as credenciais ficam no armazenamento criptografado do Home Assistant, e números de série e endereços MAC não são coletados de forma alguma.
Por que importa
Prova quando você precisa
Mostre ao seu provedor dados reais — qualidade de sinal caindo, contagens de erros subindo. Evidência é mais difícil de descartar do que "parece lento".
Padrões ao longo do tempo
Capture as quedas das 2h da manhã e problemas intermitentes. Problemas que desaparecem quando você verifica são capturados nos gráficos.
Uma integração, 40 modems
Arris, CommScope, Compal, Hitron, Motorola, Netgear, Sagemcom, SerComm e Technicolor. Cada modem é descrito de forma declarativa no catálogo em vez de carregar o próprio parser, então acrescentar hardware é uma mudança de dados — e cada entrada é testada contra uma captura real de hardware real.
Automação Home Assistant
Configure alertas para degradação de sinal. Receba notificações antes que problemas se tornem interrupções.
Modems suportados
A compatibilidade varia conforme o firmware e as personalizações do provedor. Confira seu modelo aqui antes de instalar.
| Fabricante | Modelo | DOCSIS | Provedores comuns |
|---|---|---|---|
| Arris | CM3500B | 3.1 | Vodafone |
| Arris | CM820B | 3.0 | Volia |
| Arris | S33 | 3.1 | Comcast, Cox, Spectrum |
| Arris | S33 (v2) | 3.1 | Comcast, Cox, Spectrum |
| Arris | S33 (v3) | 3.1 | Comcast, Cox, Spectrum |
| Arris | S34 | 3.1 | Comcast, Cox, Spectrum |
| Arris | SB6141 | 3.0 | Comcast, Cox, Spectrum |
| Arris | SB6183 | 3.0 | Comcast, Cox, Spectrum |
| Arris | SB6190 | 3.0 | Comcast, Spectrum, Cox |
| Arris | SB8200 | 3.1 | Spectrum, Comcast, Cox |
| Arris | SB8200 (Form Login CBN) | 3.1 | Comcast, Cox, Spectrum |
| Arris | SB8200 (HNAP) | 3.1 | Cox |
| Arris | TG3442DE | 3.1 | Vodafone |
| Arris | TM1602A | 3.0 | Spectrum |
| CommScope | G54 | 3.1 | Cox, Spectrum, Comcast |
| Compal | CH7465MT | 3.0 | Magenta AT |
| Hitron | CODA56 | 3.1 | Comcast |
| Motorola | MB7621 | 3.0 | Comcast, Cox, Spectrum |
| Motorola | MB8600 | 3.1 | Comcast, Cox, Spectrum |
| Motorola | MB8611 | 3.1 | Comcast, Cox, Spectrum |
| Netgear | C3700 | 3.0 | Comcast, Cox, Spectrum |
| Netgear | C7000v2 | 3.0 | Comcast |
| Netgear | CM1100 | 3.1 | Comcast |
| Netgear | CM1200 | 3.1 | Comcast, Spectrum, Cox |
| Netgear | CM2000 | 3.1 | Comcast, Cox, Spectrum |
| Netgear | CM2050V | 3.1 | Comcast |
| Netgear | CM2500 | 3.1 | Comcast, Cox, Spectrum |
| Netgear | CM3000 | 3.1 | Comcast, Cox, Spectrum |
| Netgear | CM600 | 3.0 | Comcast, Cox, Spectrum |
| Sagemcom | F3896LG-VMB | 3.1 | Virgin Media UK |
| Sagemcom | F3896LG-ZG | 3.1 | Ziggo |
| SerComm | DM1000 | 3.1 | Koodo |
| Technicolor | CGA2121 | 3.0 | Telia |
| Technicolor | CGA4236 | 3.1 | — |
| Technicolor | CGA6444VF | 3.1 | Vodafone |
| Technicolor | TC4400 | 3.1 | Comcast, Cox, Spectrum |
| Technicolor | XB10 | 4.0 | Comcast |
| Technicolor | XB6 | 3.1 | Rogers |
| Technicolor | XB7 | 3.1 | Rogers, Comcast |
| Technicolor | XB8 | 3.1 | Rogers, Comcast, Cox |
Um modelo listado mais de uma vez tem uma revisão de hardware ou um método de login que exige entrada própria — oriente-se pelo qualificador entre parênteses.
Catálogo completo com chipsets, métodos de autenticação e cobertura de provedores · Modem não listado? Solicite suporte
Instalação
Procure por "Cable Modem Monitor" nas integrações HACS, reinicie o Home Assistant e adicione em Configurações → Dispositivos e serviços. Você vai precisar do IP do seu modem — normalmente 192.168.100.1 — e das credenciais, se ele pedir.
Requer Home Assistant 2024.12.0 ou mais recente.
Contribuir
Cable Modem Monitor cresce através de contribuições da comunidade. Duas formas de ajudar:
Capture seu modem
Uma sessão gravada da interface web do seu modem é tudo o que precisamos para construir um parser. A captura leva cerca de cinco minutos.
Instale nossa ferramenta har-capture
pip install "har-capture[full]" Grave uma sessão no IP do seu modem
har-capture get 192.168.100.1 --patterns network-device Revise o arquivo higienizado em busca do que a redação possa ter deixado passar e anexe-o a uma solicitação de modem
O har-capture remove endereços MAC, números de série, IPs públicos e padrões de credenciais antes mesmo de o arquivo sair da sua máquina. Dados de canais, versão de firmware e tempo de atividade são preservados — é justamente a parte de que precisamos.
Construa a entrada do catálogo
Tem o hardware e quer ir além? O pipeline de entrada transforma uma captura em uma entrada de catálogo funcional.
- Rode o pipeline de entrada sobre a sua captura
- Ele gera modem.yaml, parser.yaml e os golden files
- Verifique se os golden files correspondem ao que seu modem realmente reporta
- Abra um pull request com a entrada
A maioria dos modelos não precisa de Python algum — a análise é YAML declarativo. A assistência de IA ajuda nas etapas de julgamento, mas não é obrigatória.
Guia do contribuidor