Il problema
Il tuo modem via cavo tiene traccia dei dati di qualità del segnale — quanto è forte la tua connessione, quanto è pulito il segnale, se gli errori si stanno accumulando. È tutto sepolto nell'interfaccia web del modem. Ma quei dati non sono utilizzabili.
- Nessuno storico — vedi un'istantanea di adesso, non cosa è successo alle 2 di notte quando la tua connessione è caduta
- Nessun avviso — il modem non ti dice quando la qualità del segnale si degrada o gli errori iniziano a salire
- Nessuna prova — quando chiami il tuo ISP, "internet è lento" non è una prova su cui possono agire
- Nessuna correlazione — non puoi collegare "Zoom è caduto alle 15" con problemi di segnale che non stavi osservando
La soluzione
Cable Modem Monitor preleva i dati del segnale direttamente dal tuo modem e li porta in Home Assistant. Traccia la salute della connessione nel tempo con grafici storici che catturano i problemi che altrimenti perderesti.
Cosa ottieni
Ogni modem supportato espone lo stesso insieme di entità, così dashboard e automazioni funzionano allo stesso modo qualunque sia il tuo hardware.
Qualità del segnale per canale
Potenza (dBmV), SNR e frequenza per ogni canale downstream e upstream. I canali sono numerati per posizione, così gli ID delle entità sopravvivono a un riavvio del modem che li rinumera.
Tracciamento degli errori
Conteggi di parole di codice corrette e non correggibili, più i tassi di errore al minuto.
Salute della connessione
Stato, tempo di attività, ultimo avvio e rilevamento dei riavvii dall'azzeramento dei contatori.
Sonde di stato
Latenza ping e HTTP, interrogate con una cadenza propria, separata dalla lettura completa dei dati.
Riavvio remoto
Riavvia il modem da un pulsante di Home Assistant quando la linea ha bisogno di una spinta. Il polling si ritrae durante il riavvio e riprende da solo non appena il modem risponde di nuovo.
Errori che si dichiarano da soli
Un modem occupato, un blocco del firmware, un host irraggiungibile e una password davvero sbagliata segnalano ciascuno la propria causa — così sistemi ciò che si è rotto davvero.
Solo locale
Nessun cloud, nessuna telemetria. L'integrazione legge l'interfaccia web locale del tuo modem, le credenziali restano nell'archivio cifrato di Home Assistant e numeri di serie e indirizzi MAC non vengono raccolti affatto.
Perché è importante
Prova quando ne hai bisogno
Mostra al tuo ISP dati reali — qualità del segnale in calo, conteggio errori in aumento. Le prove sono più difficili da respingere di "sembra lento".
Pattern nel tempo
Cattura le cadute alle 2 di notte e i problemi intermittenti. I problemi che svaniscono quando controlli sono catturati nei grafici.
Un'integrazione, 40 modem
Arris, CommScope, Compal, Hitron, Motorola, Netgear, Sagemcom, SerComm e Technicolor. Ogni modem è descritto in modo dichiarativo nel catalogo invece di portarsi dietro il proprio parser, così aggiungere hardware è una modifica di dati — e ogni voce è testata contro una cattura reale da hardware reale.
Automazione Home Assistant
Imposta avvisi per il degrado del segnale. Ricevi notifiche prima che i problemi diventino interruzioni.
Modem supportati
La compatibilità varia in base al firmware e alle personalizzazioni dell'operatore. Controlla qui il tuo modello prima di installare.
| Produttore | Modello | DOCSIS | Operatori comuni |
|---|---|---|---|
| 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 modello elencato più di una volta ha una revisione hardware o un metodo di accesso che richiede una voce propria — fai riferimento al qualificatore tra parentesi.
Catalogo completo con chipset, metodi di autenticazione e copertura degli operatori · Modem non presente? Richiedi il supporto
Installazione
Cerca "Cable Modem Monitor" nelle integrazioni HACS, riavvia Home Assistant, poi aggiungilo da Impostazioni → Dispositivi e servizi. Ti serviranno l'IP del tuo modem — di solito 192.168.100.1 — e le credenziali se le richiede.
Richiede Home Assistant 2024.12.0 o successivo.
Contribuisci
Cable Modem Monitor cresce attraverso i contributi della community. Due modi per aiutare:
Cattura il tuo modem
Una sessione registrata dall'interfaccia web del tuo modem è tutto ciò che serve per costruire un parser. Catturarla richiede circa cinque minuti.
Installa il nostro strumento har-capture
pip install "har-capture[full]" Registra una sessione sull'IP del tuo modem
har-capture get 192.168.100.1 --patterns network-device Controlla il file ripulito per qualcosa che l'oscuramento potrebbe aver mancato, poi allegalo a una richiesta di modem
har-capture rimuove indirizzi MAC, numeri di serie, IP pubblici e schemi di credenziali prima ancora che il file lasci il tuo computer. Dati dei canali, versione del firmware e tempo di attività vengono mantenuti — è proprio la parte che ci serve.
Costruisci la voce del catalogo
Hai l'hardware e vuoi andare oltre? La pipeline di intake trasforma una cattura in una voce di catalogo funzionante.
- Esegui la pipeline di intake sulla tua cattura
- Genera modem.yaml, parser.yaml e i golden file
- Verifica che i golden file corrispondano a ciò che il tuo modem riporta davvero
- Apri una pull request con la voce
La maggior parte dei modelli non richiede alcun Python — il parsing è YAML dichiarativo. L'assistenza dell'IA aiuta nei passaggi che richiedono valutazione, ma non è necessaria.
Guida per i contributori