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:
- Open HACS in Home Assistant
- Go to Integrations → + Explore & Download Repositories
- Search for “8311 HA Bridge”
- Download and restart Home Assistant
- Go to Settings → Devices & Services → + Add Integration
- Search for “WAS-110 8311”
- 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