https://github.com/dkwolf1/ha-ziggo-modem
Home Assistant integration for Ziggo (Sagemcom) modems with cable diagnostics, DOCSIS signal monitoring and local API support
https://github.com/dkwolf1/ha-ziggo-modem
custom-integration docsis ha hacs home-assistant iot modem monitoring network sagemcom ziggo
Last synced: about 2 months ago
JSON representation
Home Assistant integration for Ziggo (Sagemcom) modems with cable diagnostics, DOCSIS signal monitoring and local API support
- Host: GitHub
- URL: https://github.com/dkwolf1/ha-ziggo-modem
- Owner: dkwolf1
- License: mpl-2.0
- Created: 2026-04-16T10:08:32.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-16T12:22:45.000Z (about 2 months ago)
- Last Synced: 2026-04-16T12:40:57.188Z (about 2 months ago)
- Topics: custom-integration, docsis, ha, hacs, home-assistant, iot, modem, monitoring, network, sagemcom, ziggo
- Language: Python
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Ziggo Modem
[](https://github.com/dkwolf1/ha-ziggo-modem/releases)
[](https://github.com/dkwolf1/ha-ziggo-modem/commits/main)
[](LICENSE)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/astral-sh/ruff)
[](https://hacs.xyz)
[]()
[](https://www.home-assistant.io/)
---
## 🔧 Ziggo Modem - Home Assistant Integratie
Lokale Home Assistant integratie voor Ziggo kabelmodems (Sagemcom).
Deze integratie geeft inzicht in je DOCSIS-verbinding, zoals signaalkwaliteit, kanaalstatistieken, fouttellingen en netwerkstatus — volledig lokaal en zonder cloud.
---
## ✨ Features
- Modemstatus en uptime
- Downstream signaalanalyse (power, SNR, fouten)
- Upstream monitoring (power, timeouts)
- SC-QAM en OFDM foutanalyse
- Snelheidsprofiel detectie (download / upload)
- Kabelkwaliteit classificatie (Goed / Matig / Slecht)
- Kabelkwaliteit analyse met score, reden en advies
- Binary sensors voor verbindingsproblemen
- Volledig lokale API (geen cloud afhankelijkheid)
---
## 📦 Installatie
### HACS (aanbevolen)
1. Ga naar **HACS → Integraties**
2. Klik op **⋮ → Custom repositories**
3. Voeg deze repository toe
4. Kies categorie **Integration**
5. Installeer **Ziggo Modem**
6. Herstart Home Assistant
---
### Handmatig
1. Kopieer:
custom_components/ziggo_modem
naar je Home Assistant configuratiemap
2. Herstart Home Assistant
---
## ⚙️ Configuratie
De integratie werkt volledig via de UI:
**Instellingen → Apparaten & Diensten → Integratie toevoegen → Ziggo Modem**
Voer in:
- IP-adres (standaard: `192.168.100.1`)
- Gebruikersnaam
- Wachtwoord
---
## 📊 Sensoren
### Algemeen
- Modemstatus
- Uptime
- Kabelkwaliteit
### Downstream
- Downstream Power (dBmV)
- Downstream SNR (dB)
- Aantal kanalen
- Gelockte kanalen
- Fouten (SC-QAM / OFDM)
### Upstream
- Upstream Power (dBmV)
- Aantal kanalen
- T3 timeouts
### Snelheidsprofiel
- Downloadprofiel (Mbit/s)
- Uploadprofiel (Mbit/s)
---
## 🚨 Binary sensors
- Kabelprobleem
- Internet storing
- Upstream timeouts aanwezig
- Internettoegang
---
## ⚠️ Opmerkingen
- Gebruikt een ongedocumenteerde Ziggo modem API
- Werkt alleen lokaal (192.168.100.1)
- OFDM-waarden kunnen verschillen per firmware
- Primair getest op Sagemcom Ziggo modems
---
## ⚖️ Disclaimer
Dit project is niet gelieerd aan Ziggo.
Gebruik op eigen risico. API endpoints kunnen wijzigen bij firmware-updates.
---
## 🤝 Bijdragen
Zie [CONTRIBUTING.md](CONTRIBUTING.md)
---
## 📜 Licentie
Dit project valt onder de **MPL-2.0 licentie**