8311 HA Bridge - Monitor XGS-PON Fiber ONU in Home Assistant

Share your Projects! Custom Integrations
1

8311 HA Bridge Logo
8311 HA Bridge Logo617×256 137 KB

What is 8311 HA Bridge?

Monitor your XGS-PON fiber ONU optical diagnostics directly in Home Assistant. If you’re running 8311 community firmware on a WAS-110 or compatible ONU, this integration gives you real-time visibility into your fiber connection: RX/TX power levels, temperatures, PON link status, and more.

40+ sensors across 9 categories, all auto-discovered with no YAML configuration required.

Features

  • Optical Power Monitoring - RX/TX power in dBm and mW
  • Temperature Sensors - Optic module, CPU0, CPU1
  • PON Link Status - Binary sensor with O-state codes (O1-O9)
  • ISP Auto-Detection - Identifies AT&T, Frontier, Bell Canada, and others from GPON serial prefix
  • GTC Error Counters - BIP errors, FEC corrected/uncorrected, LODS events
  • Device Information - Firmware bank, hardware revision, PON mode, vendor info
  • System Metrics - ONU uptime, memory usage
  • Diagnostics Platform - Download device diagnostics with sensitive data redacted

Supported Hardware

Device Status
BFW Solutions WAS-110 Primary (tested)
Potron GP7001X Compatible
Other 8311-compatible XGS-PON ONUs Should work

Requirement: Device must be running 8311 community firmware with SSH access enabled.

Installation (HACS)

Recommended method:

  1. Open HACS in Home Assistant
  2. Go to Integrations → + Explore & Download Repositories
  3. Search for “8311 HA Bridge”
  4. Download and restart Home Assistant
  5. Go to Settings → Devices & Services → + Add Integration
  6. Search for “WAS-110 8311”
  7. Enter your ONU IP address (default: 192.168.11.1) and SSH credentials

Sensors auto-discover immediately. No YAML needed.

Deployment Options

Choose the setup that fits your environment:

Method Best For Documentation
HACS Integration Most users (Recommended) README
Docker Separate host, MQTT bridge Wiki: Home
systemd Bare metal Linux server Wiki: Alternative Deployments
Proxmox LXC Virtualized environment Wiki: Alternative Deployments
Synology NAS NAS-based Docker Wiki: Alternative Deployments
Kubernetes/k3s Orchestrated deployments Wiki: Alternative Deployments

Documentation

Credits

  • 8311 Community Firmware - The firmware that makes this possible
  • PON Wiki - XGS-PON documentation and resources
  • Community contributors who shared their monitoring approaches

Feedback

Questions, issues, or feature requests? Open an issue on GitHub

3 Likes
2

Absolutely awesome! Going to give it a try right now. Thanks!!

1 Like
3

Update: v2.1.0 — Health Monitoring & Stability Fix

Thanks to everyone who’s tried the integration since launch, and thanks to @AlvaroHA for the kind words!

A quick update on what’s new since the initial release.

SSH Connection Leak Fix

A community member reported that the integration was leaving SSH connections open on the ONU — sometimes accumulating 90+ orphaned sessions until the SSH daemon became unresponsive. Turned out the integration was dropping its reference to the

connection on timeout/error without actually closing it first. This is fixed in v2.1.0 — connections are now properly closed before reconnecting. If you’ve experienced SSH instability or needed to reboot your ONU periodically, this update should resolve it.

New Health Monitoring Sensors

v2.1.0 adds 7 diagnostic sensors that make connection health visible and automatable:

  • Consecutive Errors — Back-to-back poll failures (resets on success)
  • SSH Reconnections — Lifetime reconnect count
  • Error Rate — % of total polls that failed
  • Total Updates — Lifetime successful poll count
  • Availability — % of successful polls over the last hour
  • ONU Reboot Count — Detected reboots via uptime rollback
  • Last Reboot Detected — Timestamp of most recent reboot

These are all diagnostic entities — they won’t clutter your default dashboard but are available for graphs and automations. For example, you could trigger an alert when availability drops below 90%.

Docker Bridge: MQTT Last Will & Testament

For Docker/MQTT bridge users, entities now go unavailable instantly when the bridge process stops, instead of waiting for the MQTT keepalive timeout.

Upgrade

Update via HACS → Integrations → 8311 ONU Monitor → Redownload, then restart HA.

Full changelog: CHANGELOG.md