Bridge Mode Compatibility

Bridge Mode Compatibility

Overview

DOCSight works with cable modems in both Router Mode and Bridge Mode. Bridge mode does not affect DOCSight's ability to collect DOCSIS signal data because the modem still exposes its web interface on the LAN side.

Tested Configurations

Vodafone Station (TG3442DE)

Status: ✅ Fully compatible

Tested Setup:

• Modem: Vodafone Station TG3442DE
• Firmware: 01.05.063.13.EURO.PC20
• Mode: Bridge Mode (behind Unifi router)
• Network: 192.168.100.1 (custom IP)

Authentication: Uses AES-CCM encrypted credentials with CSRF nonce.

Data Collection: DOCSIS data via /php/status_docsis_data.php endpoint (33 DS + 5 US channels confirmed).

Issue Reference: #40

---

How Bridge Mode Affects DOCSight

Aspect	Router Mode	Bridge Mode
DOCSIS Signal Data	✅ Available	✅ Available
Modem Web Interface	✅ Accessible	✅ Accessible
DHCP/Routing	Modem handles	External router handles
Connection Info	Full info available	Limited (modem-side only)
DOCSight Access	Same network	Same network

Bottom line: Bridge mode only affects routing/DHCP, not DOCSIS monitoring. The modem's cable interface (downstream/upstream channels) is independent of bridge mode configuration.

---

Troubleshooting Bridge Mode

Modem Not Reachable

Symptom: DOCSight cannot connect to modem after enabling bridge mode.

Cause: Bridge mode often changes the modem's IP address.

Solution:

1. Check modem's new IP (often 192.168.100.1 instead of 192.168.178.1)
2. Update MODEM_URL in DOCSight settings
3. Ensure your Docker host can reach the modem network

Authentication Fails

Symptom: TG login attempt failed: non-hexadecimal number found in fromhex()

Cause: Older driver version (pre-v2.0) had incorrect variable extraction for TG3442DE.

Solution: Update to latest latest image:

docker compose pull && docker compose up -d

Fixed in: c5bfb3b (February 2026)

404 Errors on Data Fetch

Symptom: 404 Client Error: Not Found for url: .../ajaxGet_device_networkstatus_498.html

Cause: Older driver used wrong DOCSIS endpoint.

Solution: Update to latest latest image (see above).

Fixed in: d5fa532 (February 2026)

---

Network Configuration

Option 1: Same Network (Recommended)

[Internet] -> [Cable Modem (192.168.100.1, Bridge)] -> [Router (192.168.1.1)] -> [DOCSight Host]
                    ▲                                                                   │
                    └───────────────── Modem Web UI accessible ──────────────────────────┘

DOCSight can reach modem directly at 192.168.100.1.

Option 2: Different Subnet

If your router uses a different subnet (e.g., 10.0.0.0/24) than the modem's management IP (192.168.100.1), you may need:

• Static route on your router
• Or run DOCSight on a device with dual network access

Most home routers: Same network is default, no config needed.

---

Supported Modems in Bridge Mode

Modem	Bridge Mode	Notes
Fritz!Box Cable	✅ Supported	Called "exposed host" or "IP client" mode
Vodafone Station TG3442DE	✅ Tested	Firmware 01.05.063.13.EURO.PC20 confirmed
Vodafone Station CGA4233	⚠️ Untested	Should work (same driver)
Technicolor TC4400	⚠️ Untested	Likely compatible
Vodafone Ultra Hub 7	⚠️ Untested	Likely compatible
Arris SURFboard (S33/S34/SB8200)	⚠️ Untested	HTTPS, usually at 192.168.100.1
Arris CM8200A	⚠️ Untested	HTTPS, usually at 192.168.100.1
Arris SB6141	⚠️ Untested	No auth, usually at 192.168.100.1
Sagemcom F@st 3896	⚠️ Untested	Usually at 192.168.100.1
Hitron CODA-56	⚠️ Untested	No auth, usually at 192.168.100.1
Compal CH7465 (Connect Box)	⚠️ Untested	Usually at 192.168.100.1
Netgear CM3000	⚠️ Untested	Usually at 192.168.100.1

Legend:

• ✅ Tested and confirmed working
• ⚠️ Untested but likely compatible
• ❌ Known incompatible

---

FAQ

Does bridge mode affect signal quality?

No. Bridge mode is a routing configuration. DOCSIS signal quality (power, SNR, errors) is determined by the physical cable connection and has nothing to do with router vs bridge mode.

Will DOCSight show "poor" health in bridge mode?

Health assessment is based purely on DOCSIS signal thresholds. If you see "poor" health in bridge mode, it means your cable signal is actually poor, not a bridge mode issue.

Can I use DOCSight and bridge mode together?

Yes! That's exactly what Issue #40 confirmed. DOCSight works perfectly in bridge mode as long as the modem's web interface remains reachable.

---

Related

• Installation Guide
• Adding Modem Support
• Issue #40: TG3442DE Bridge Mode