问题
您的有线调制解调器跟踪信号质量数据——您的连接有多强、信号有多干净、错误是否正在累积。所有这些都埋藏在调制解调器的 Web 界面中。但这些数据无法操作。
- 没有历史记录——您看到的是现在的快照,而不是凌晨 2 点连接断开时发生的情况
- 没有警报——调制解调器不会在信号质量下降或错误开始增加时告诉您
- 没有证据——当您致电 ISP 时,"网络很慢"不是他们可以采取行动的证据
- 没有关联——您无法将"下午 3 点 Zoom 掉线"与您没有观察到的信号问题联系起来
解决方案
Cable Modem Monitor 直接从您的调制解调器拉取信号数据并将其带入 Home Assistant。通过历史图表跟踪随时间的连接健康状况,捕获您原本会错过的问题。
您将获得
每一款受支持的调制解调器都提供相同的实体集合，因此无论您使用哪种硬件，仪表板和自动化的用法都是一样的。
逐通道信号质量
每个下行和上行通道的功率 (dBmV)、信噪比和频率。通道按位置编号，因此实体 ID 能在调制解调器重启并重新编号后依然保持不变。
错误跟踪
已纠正和无法纠正的码字计数，以及每分钟的错误率。
连接健康状况
状态、运行时间、上次启动时间，以及依据计数器归零判断的重启检测。
健康探测
Ping 和 HTTP 延迟，按各自的节奏轮询，与完整数据读取相互独立。
远程重启
线路需要重来一次时，通过 Home Assistant 中的按钮重启调制解调器。轮询会在重启期间退避，并在调制解调器重新响应后自行恢复。
会自报家门的故障
调制解调器繁忙、固件锁定、主机不可达，以及密码确实错误——每一种都会报告自己的原因，让你修的是真正出问题的地方。
纯本地
无云端，无遥测。集成读取调制解调器的本地 Web 界面，凭据始终保存在 Home Assistant 的加密存储中，序列号和 MAC 地址则完全不予采集。
为什么重要
需要时提供证据
向您的 ISP 显示实际数据——信号质量下降、错误计数上升。证据比"感觉很慢"更难被驳回。
随时间的模式
捕获凌晨 2 点的断线和间歇性问题。在您检查时消失的问题会被捕获在图表中。
一个集成，40 款调制解调器
Arris、CommScope、Compal、Hitron、Motorola、Netgear、Sagemcom、SerComm 和 Technicolor。每款调制解调器都在目录中以声明式描述，而不是各自携带 parser，因此新增硬件只是一次数据变更——而每一条目都针对真实硬件的真实抓包进行测试。
Home Assistant 自动化
设置信号降级警报。在问题变成中断之前收到通知。
支持的调制解调器
兼容性会因固件和运营商定制而异。安装前请在此查看您的型号。
| 制造商 | 型号 | DOCSIS | 常见运营商 |
|---|---|---|---|
| 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 |
多次出现的型号，说明其某个硬件版本或登录方式需要单独的条目——请以括号中的限定词为准。
安装
在 HACS 集成中搜索 "Cable Modem Monitor"，重启 Home Assistant，然后在设置 → 设备与服务中添加。您需要调制解调器的 IP 地址（通常是 192.168.100.1），如果提示则还需要凭据。
需要 Home Assistant 2024.12.0 或更高版本。
贡献
Cable Modem Monitor 通过社区贡献而成长。两种帮助方式:
抓取您的调制解调器
一份从调制解调器 Web 界面录制的会话，就是我们构建 parser 所需的全部内容。抓取大约需要五分钟。
安装我们的 har-capture 工具
pip install "har-capture[full]" 针对调制解调器的 IP 地址录制一次会话
har-capture get 192.168.100.1 --patterns network-device 检查清理后的文件，看看脱敏是否有遗漏，然后附到调制解调器申请中
har-capture 会在文件离开您的电脑之前去除 MAC 地址、序列号、公网 IP 和凭据模式。通道数据、固件版本和运行时间会保留——这正是我们需要的部分。
构建目录条目
有硬件并想更进一步？接入流水线可以把一份抓包变成可用的目录条目。
- 对您的抓包运行接入流水线
- 它会生成 modem.yaml、parser.yaml 和 golden files
- 核对 golden files 是否与您的调制解调器实际上报的数据一致
- 提交包含该条目的 pull request
大多数型号完全不需要写 Python——解析是声明式 YAML。AI 辅助有助于需要判断的环节，但并非必需。
贡献者指南