Проблема
Ваш кабельный модем отслеживает данные о качестве сигнала — насколько сильно ваше соединение, насколько чист сигнал, накапливаются ли ошибки. Все это скрыто в веб-интерфейсе модема. Но эти данные не действенны.
- Нет истории — вы видите моментальный снимок сейчас, а не то, что произошло в 2 ночи, когда ваше соединение упало
- Нет оповещений — модем не сообщит вам, когда качество сигнала ухудшается или ошибки начинают расти
- Нет доказательств — когда вы звоните своему провайдеру, "интернет медленный" не является доказательством, на которое они могут действовать
- Нет корреляции — вы не можете связать "Zoom упал в 15:00" с проблемами сигнала, которые вы не наблюдали
Решение
Cable Modem Monitor извлекает данные сигнала непосредственно из вашего модема и переносит их в Home Assistant. Отслеживайте здоровье соединения со временем с помощью исторических графиков, которые фиксируют проблемы, которые вы иначе бы пропустили.
Что вы получаете
Каждый поддерживаемый модем предоставляет один и тот же набор сущностей, поэтому панели и автоматизации работают одинаково независимо от вашего оборудования.
Качество сигнала по каналам
Мощность (dBmV), отношение сигнал/шум и частота для каждого нисходящего и восходящего канала. Каналы нумеруются по позиции, поэтому ID сущностей переживают перезагрузку модема, которая их перенумеровывает.
Учёт ошибок
Счётчики исправленных и неисправимых кодовых слов, а также частота ошибок в минуту.
Состояние соединения
Статус, время работы, время последней загрузки и определение перезагрузок по сбросу счётчиков.
Проверки состояния
Задержка ping и HTTP, опрашиваемая в собственном ритме, отдельно от полного считывания данных.
Удалённая перезагрузка
Перезагрузите модем кнопкой в Home Assistant, когда линии нужен толчок. На время перезагрузки опрос отступает и возобновляется сам, как только модем снова отвечает.
Сбои, которые называют себя сами
Занятый модем, блокировка прошивки, недоступный хост и действительно неверный пароль — каждый сообщает свою собственную причину, так что вы чините то, что на самом деле сломалось.
Только локально
Без облака и телеметрии. Интеграция читает локальный веб-интерфейс вашего модема, учётные данные остаются в зашифрованном хранилище Home Assistant, а серийные номера и MAC-адреса не собираются вовсе.
Почему это важно
Доказательства, когда они вам нужны
Покажите своему провайдеру реальные данные — падающее качество сигнала, растущее количество ошибок. Доказательства труднее отклонить, чем "кажется медленным".
Шаблоны со временем
Фиксируйте сбои в 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 |
Модель, указанная более одного раза, имеет аппаратную ревизию или способ входа, которым нужна отдельная запись — ориентируйтесь на уточнение в скобках.
Полный каталог с чипсетами, способами авторизации и охватом провайдеров · Вашего модема нет в списке? Запросите поддержку
Установка
Найдите "Cable Modem Monitor" в интеграциях HACS, перезапустите Home Assistant, затем добавьте интеграцию в разделе Настройки → Устройства и службы. Понадобится IP-адрес модема — обычно 192.168.100.1 — и учётные данные, если он их запросит.
Требуется Home Assistant 2024.12.0 или новее.
Внести вклад
Cable Modem Monitor растет благодаря вкладу сообщества. Два способа помочь:
Запишите свой модем
Записанная сессия из веб-интерфейса вашего модема — это всё, что нужно для создания 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 и эталонные файлы
- Убедитесь, что эталонные файлы совпадают с тем, что модем сообщает на самом деле
- Откройте pull request с этой записью
Большинству моделей Python не нужен вовсе — разбор описывается декларативным YAML. Помощь ИИ полезна на шагах, требующих суждения, но не обязательна.
Руководство для участников