Masquerade as the BCE Inc. Giga Hub with the WAS-110 or X-ONU-SFPP¶

Verify XGS-PON service¶

Your fiber internet subscription can use different underlying technologies. Use one of these methods to confirm if your connection uses XGS-PON:

• Web recommended
• XMO client

Via web recommended¶

1. Within a web browser, navigate to https://home/?c=advancedtools/wan and, if asked, input your Administrator password. (1)

   1. Press the Up/Down arrow buttons on the front of the Giga Hub to select Modem Management or Modem Password and press the OK button to display the password.

2. From the WAN page, verify the displayed current mode is XGS-PON.

Via XMO client¶

The open-source XMO client¹ requires Python 3.10 or newer. For installation instructions, see the Real Python guide: Python 3 Installation & Setup Guide.

Install client

Open a terminal and install the open-source XMO client using:

py --version # (1)!
py -m venv venv
venv\Scripts\activate
py -m pip install --upgrade pip
pip install https://github.com/up-n-atom/sagemcom-modem-scripts/releases/download/v0.0.10/xmo_remote_client-0.0.10-py3-none-any.whl

python3 --version # (1)!
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install --upgrade pip
pip3 install https://github.com/up-n-atom/sagemcom-modem-scripts/releases/download/v0.0.10/xmo_remote_client-0.0.10-py3-none-any.whl

Execute client

Finally, to determine if you have XGS-PON service, execute the following:

xmo-remote-client --password=<password> get-wan-mode # (1)!

1. Replace the <password> argument. Press the Up/Down arrow buttons on the front of the Giga Hub to select Modem Management or Modem Password and press the OK button to display the password.

Purchase WAS-110/X-ONU-SFPP/WT-ONU-STICK ONT¶

The WAS-110, X-ONU-SFPP, and WT-ONU-STICK are available from select resellers worldwide; purchase at your discretion. We assume no responsibility or liability for the listed resellers.

Pre-configuration¶

Before beginning the ONT configuration, ensure you have addressed the following networking requirements to enable successful communication with the PON.

DHCP MAC Spoofing (Bell MTS/Aliant)¶

The ISP’s DHCP server identifies your connection via the Unique MAC address of the original equipment. To ensure the ISP "trusts" your new hardware immediately, you must clone the Giga Hub MAC address onto your gateway's WAN physical interface.

LCT Access Route¶

To install, upgrade, and configure the ONT, your gateway must be able to reach its Local Craft Terminal (LCT) interface. Follow the Accessing the ONT guide to set up the proper network routing between your gateway and the ONT mangement plane.

Install ONT firmware¶

You must first install the 8311 community firmware for VEIP support to masquerade as the Giga Hub on XGS-PON.

Configure ONT settings¶

To masquerade as the Giga Hub, you will need its ONT serial number, which is located on the back label along with other, optional identifiers, as depicted below.

Use your preferred setup method and carefully follow the steps to avoid unnecessary downtime and troubleshooting:

• Web (luci)
• Shell (linux)

Via web recommended¶

1. Within a web browser, navigate to https://192.168.11.1/cgi-bin/luci/admin/8311/config and, if asked, input your root password.

2. From the 8311 Configuration page, on the PON tab, fill in the configuration with the following values:

   Reminder

   Replace the mandatory PON Serial Number and optional IP Host MAC address with the provisioned values on the back label of the Giga Hub.

   Attribute	Value	Mandatory	Remarks
   PON Serial Number (ONT ID)	SMBS…		ONT S/N
   Equipment ID	5690
   Hardware Version	Fast5689EBell
   Sync Circuit Pack Version
   Software Version A	SGC8400058		Version listing
   Software Version B	SGC8400058		Version listing
   MIB File	/etc/mibs/prx300_1V_bell.ini		VEIP and more
   IP Host MAC Address	40:65:A3:FF:A7:B1		@MAC + 1

3. From the 8311 Configuration page, on the ISP Fixes tab, enable Fix VLANs from the drop-down.

4. Save changes and reboot from the System menu.

Via shell¶

1. Login over secure shell (SSH).

   ssh root@192.168.11.1
   

2. Configure the 8311 U-Boot environment.

   Highlighted lines are mandatory

   Replace the mandatory 8311_gpon_sn and optional 8311_iphost_mac with the provisioned values on the back label of the Giga Hub.

   fwenv_set mib_file
   fwenv_set -8 iphost_mac 40:65:A3:FF:A7:B1 # (1)!
   fwenv_set -8 gpon_sn SMBS... # (2)!
   fwenv_set -8 equipment_id 5690
   fwenv_set -8 hw_ver Fast5689EBell
   fwenv_set -8 cp_hw_ver_sync 1
   fwenv_set -8 sw_verA SGC8400058 # (3)!
   fwenv_set -8 sw_verB SGC8400058
   fwenv_set -8 mib_file /etc/mibs/prx300_1V_bell.ini
   fwenv_set -8 fix_vlans 1
   

   1. @MAC + 1, e.g. 40:65:A3:FF:A7:B0 becomes 40:65:A3:FF:A7:B1
   2. ONT S/N
   3. Version listing

3. Verify the 8311 U-boot environment and reboot.

   fw_printenv | grep ^8311
   reboot
   

Verify ONT connectivity¶

Hot plug fiber cable¶

After rebooting the WAS-110 or X-ONU-SFPP, safely remove the SC/APC fiber optic cable from the Giga Hub and connect it to the WAS-110 or X-ONU-SFPP.

1. Navigate to https://192.168.11.1/cgi-bin/luci/admin/status/overview and, if asked, input your root password.
2. From the PON Status section, evaluate that the RX Power and TX Power are within spec.

Validate OLT authentication¶

Check for O5.1 PLOAM status

1. Navigate to https://192.168.11.1/cgi-bin/luci/admin/status/overview and, if asked, input your root password.
2. From the PON Status section, verify that the PON PLOAM Status is in an 05.1, Associated state.

Check for OLT associated VLAN filters

1. Navigate to https://192.168.11.1/cgi-bin/luci/admin/8311/vlans and, if asked, input your root password.
2. From the VLAN Tables page, if the textarea states "No Extended VLAN Tables Detected", the ONT configuration has not satisfied the OLT.

Bell home phone¶

Bell does not provide SIP credentials, which requires the Giga Hub to remain in service. To integrate the WAS-110 or X-ONU-SFPP, you must use a managed, unmanaged, or virtual switch to connect both devices and configure a VLAN to bridge them.

Set Giga Hub WAN mode¶

1. Within a web browser, navigate to https://home/?c=advancedtools/wan and, if asked, input your Administrator password. (1)

   1. Press the Up/Down arrow buttons on the front of the Giga Hub to select Modem Management or Modem Password and press the OK button to display the password.

2. From the WAN mode drop-down, switch to WAN Ethernet and click Save.

3. Set the Voice WAN modes to include wan (default: gpon,xgspon) using the xmo-remote-client.

   xmo-remote-client --password=<password> set-value ---path "Device/Services/BellNetworkCfg/VoiceAllowedWANModes" --value "gpon,xgspon,wan" # (1)!
   

   1. Replace the <password> argument. Press the Up/Down arrow buttons on the front of the Giga Hub to select Modem Management or Modem Password and press the OK button to display the password.

Set WAS-110/X-ONU-SFPP Internet VLAN¶

WebShell

1. Within a web browser, navigate to https://192.168.11.1/cgi-bin/luci/admin/8311/config and, if asked, input your root password.

2. From the 8311 Configuration page, on the ISP Fixes tab, set Internet VLAN to 35.

3. Save changes and reboot from the System menu.

fwenv_set -8 internet_vlan 35

Router tips¶

Managed switch tips¶

• Filter or disable any Layer 2 management protocols (e.g., (R)STP) and discovery protocols (e.g., LLDP, CDP, FDP, MNDP, RoMON).

Software versions¶

The Giga Hub uses CWMP instead of OMCI for firmware updates. While the OLT rarely requires approval for specific software versions, keeping the WAS-110 or X-ONU-SFPP up-to-date is beneficial but not strictly necessary.

If you would like to help us maintain the software listing, you can contribute new versions via the 8311 Discord community server or by submitting a Pull Request on GitHub.

Use the following command to extract the external firmware version. This command utilizes the Giga Hub's XMO JSON-RPC and the xmo-remote-client described earlier in this guide.

xmo-remote-client -p <password> get-value --path "Device/DeviceInfo/SoftwareVersion" --path "Device/DeviceInfo/ExternalFirmwareVersion"