El problema
Tu módem de cable rastrea datos de calidad de señal — qué tan fuerte es tu conexión, qué tan limpia es la señal, si los errores se están acumulando. Todo está enterrado en la interfaz web del módem. Pero esos datos no son útiles.
- Sin historial — ves una instantánea de ahora, no lo que pasó a las 2am cuando tu conexión cayó
- Sin alertas — el módem no te dirá cuando la calidad de la señal se degrada o los errores comienzan a aumentar
- Sin prueba — cuando llamas a tu ISP, "el internet está lento" no es evidencia sobre la que puedan actuar
- Sin correlación — no puedes conectar "Zoom se cayó a las 3pm" con problemas de señal que no estabas observando
La solución
Cable Modem Monitor extrae datos de señal directamente de tu módem y los lleva a Home Assistant. Rastrea la salud de la conexión a lo largo del tiempo con gráficos históricos que capturan los problemas que de otra manera perderías.
Lo que obtienes
Cada módem compatible expone el mismo conjunto de entidades, así que los paneles y las automatizaciones funcionan igual sin importar qué hardware tengas.
Calidad de señal por canal
Potencia (dBmV), SNR y frecuencia para cada canal de bajada y de subida. Los canales se numeran por posición, así que los IDs de entidad sobreviven a un reinicio del módem que los renumere.
Seguimiento de errores
Recuentos de palabras de código corregidas y no corregibles, además de tasas de error por minuto.
Salud de la conexión
Estado, tiempo de actividad, último arranque y detección de reinicios a partir del reseteo de contadores.
Sondas de salud
Latencia de ping y HTTP, consultadas con su propia cadencia, aparte de la lectura completa de datos.
Reinicio remoto
Reinicia el módem desde un botón de Home Assistant cuando la línea necesita un empujón. El sondeo se repliega durante el reinicio y se reanuda solo en cuanto el módem vuelve a responder.
Fallos que se nombran solos
Un módem ocupado, un bloqueo del firmware, un host inalcanzable y una contraseña realmente incorrecta informan cada uno de su propia causa — así arreglas lo que de verdad se rompió.
Solo local
Sin nube, sin telemetría. La integración lee la interfaz web local de tu módem, las credenciales permanecen en el almacenamiento cifrado de Home Assistant, y los números de serie y las direcciones MAC no se recopilan en absoluto.
Por qué importa
Prueba cuando la necesitas
Muestra a tu ISP datos reales — calidad de señal cayendo, conteos de errores subiendo. La evidencia es más difícil de descartar que "se siente lento".
Patrones a lo largo del tiempo
Captura las caídas de las 2am y los problemas intermitentes. Los problemas que desaparecen cuando verificas están capturados en los gráficos.
Una integración, 40 módems
Arris, CommScope, Compal, Hitron, Motorola, Netgear, Sagemcom, SerComm y Technicolor. Cada módem se describe de forma declarativa en el catálogo en lugar de llevar su propio parser, así que añadir hardware es un cambio de datos — y cada entrada se prueba contra una captura real de hardware real.
Automatización Home Assistant
Configura alertas para degradación de señal. Recibe notificaciones antes de que los problemas se conviertan en interrupciones.
Módems soportados
La compatibilidad varía según el firmware y las personalizaciones del proveedor. Comprueba tu modelo aquí antes de instalar.
| Fabricante | Modelo | DOCSIS | Proveedores habituales |
|---|---|---|---|
| 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 |
Un modelo que aparece más de una vez tiene una revisión de hardware o un método de acceso que necesita su propia entrada — guíate por el calificador entre paréntesis.
Catálogo completo con chipsets, métodos de autenticación y cobertura de proveedores · ¿Tu módem no aparece? Solicita compatibilidad
Instalación
Busca "Cable Modem Monitor" en las integraciones de HACS, reinicia Home Assistant y luego añádelo en Ajustes → Dispositivos y servicios. Necesitarás la IP de tu módem — normalmente 192.168.100.1 — y credenciales si te las pide.
Requiere Home Assistant 2024.12.0 o posterior.
Contribuir
Cable Modem Monitor crece a través de contribuciones de la comunidad. Dos formas de ayudar:
Captura tu módem
Una sesión grabada desde la interfaz web de tu módem es todo lo que necesitamos para construir un parser. Capturarla lleva unos cinco minutos.
Instala nuestra herramienta har-capture
pip install "har-capture[full]" Graba una sesión contra la IP de tu módem
har-capture get 192.168.100.1 --patterns network-device Revisa el archivo saneado por si la redacción pasó algo por alto, y adjúntalo a una solicitud de módem
har-capture elimina direcciones MAC, números de serie, IP públicas y patrones de credenciales antes de que el archivo salga de tu equipo. Los datos de canales, la versión de firmware y el tiempo de actividad se conservan — esa es justo la parte que necesitamos.
Construye la entrada del catálogo
¿Tienes el hardware y quieres ir más lejos? El pipeline de admisión convierte una captura en una entrada de catálogo funcional.
- Ejecuta el pipeline de admisión sobre tu captura
- Genera modem.yaml, parser.yaml y los golden files
- Verifica que los golden files coincidan con lo que tu módem informa realmente
- Abre un pull request con la entrada
La mayoría de los modelos no necesitan nada de Python — el análisis es YAML declarativo. La asistencia de IA ayuda en los pasos de criterio, pero no es obligatoria.
Guía para colaboradores