Masquerade as the Nokia XS-220X-A with the WAS-110 or X-ONU-SFPP¶

Purchase a WAS-110 or X-ONU-SFPP¶

The WAS-110 and X-ONU-SFPP are available from select resellers worldwide. To streamline the process, some resellers are pre-flashing the 8311 community firmware and highly recommended for the X-ONU-SFPP. Purchase at your discretion; we take no responsibility or liability for the listed resellers.

WAS-110 Value-Added Resellers

X-ONU-SFPP Value-Added Resellers

Install the 8311 community firmware¶

As a prerequisite to masquerading as the XS-220X-A, the 8311 community firmware is recommended and required for the remainder of this guide. If you purchased a pre-flashed WAS-110 or X-ONU-SFPP, skip past to the masquerade setup.

Masquerade setup¶

Mandatory identifiers are available on the back label of the XS-220X-A, such as the ONT P/N, ICS, and CLEI code. The CLEI code and ONT P/N are identical for every XS-220X-A; only the serial number is unique to your unit.

from the web UI 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:

   All attributes below are mandatory to achieve O5 operation state

   Replace the PON Serial Number with your unit's serial. MAC cloning and a Registration ID are not required on TDS.

   Attribute	Value	Remarks
   PON Serial Number (ONT ID)	ALCL…	Serial number
   Equipment ID	BVMN300DRAXS220XA	CLEI + Mnemonic
   Hardware Version	3TN00617AAAA	ONT P/N + ICS
   Sync Circuit Pack Version
   Software Version A	3TN00669AOCK59	Seed; auto-updates via OLT
   Software Version B	3TN00669AOCK59	Seed; auto-updates via OLT
   Firmware Version Match	(3TN[0-9A-Z]{11})$	Note the 3TN vendor prefix
   Override active firmware bank	A	OLT inits a reboot if on bank B
   Override committed firmware bank	A	OLT inits a reboot if on bank B
   MIB File	/etc/mibs/prx300_1U.ini	PPTP i.e. default value
   PON Slot	10	internet UNI (see remarks below)

   Only one Ethernet UNI

   The XS-220X-A has both a 1GE and a 10GE port, so the OLT provisions two Ethernet UNIs (instances 257 and 2561). An SFP+ stick has a single physical port and can satisfy only one; the second fails to bind, which is harmless. Internet is carried on the slot-10 UNI, hence PON Slot 10.

3. From the 8311 Configuration page, on the ISP Fixes tab:

   • enable Fix VLANs from the drop-down, and
   • set Internet VLAN to your line's internet VLAN (TDS uses 474).

   Identify VLANs

   If you are unsure of your internet VLAN, first configure with Fix VLANs disabled, connect the fiber, wait for O5 state, then use the VLAN Table Analyser on the table from the VLANs page (https://192.168.11.1/cgi-bin/luci/admin/8311/vlans). Then enable Fix VLANs and set the identified VLAN.

4. Save changes and reboot from the System menu.

from the shell¶

1. Login over secure shell (SSH).

   ssh root@192.168.11.1
   

2. Configure the 8311 U-Boot environment.

   All attributes below are mandatory to achieve O5 operation state

   Replace 8311_gpon_sn with your unit's serial.

   fwenv_set -8 gpon_sn ALCL... # (1)!
   fwenv_set -8 equipment_id BVMN300DRAXS220XA # (2)!
   fwenv_set -8 hw_ver 3TN00617AAAA # (3)!
   fwenv_set -8 cp_hw_ver_sync 1
   fwenv_set -8 sw_verA 3TN00669AOCK59
   fwenv_set -8 sw_verB 3TN00669AOCK59
   fwenv_set -8 -b fw_match '(3TN[0-9A-Z]{11})$'
   fwenv_set -8 override_active A
   fwenv_set -8 override_commit A
   fwenv_set -8 pon_slot 10
   fwenv_set -8 fix_vlans 1
   fwenv_set -8 internet_vlan 474
   

   1. Serial number or S/N
   2. CLEI + Mnemonic
   3. ONT P/N + ICS

   Additional details and variables are described at the original repository ¹

   /usr/sbin/fwenv_set is a helper script that executes /usr/sbin/fw_setenv twice consecutively.

   The WAS-110 functions as an A/B system, requiring the U-Boot environment variables to be set twice, once for each environment.

   The -8 option prefixes the U-Boot environment variable with 8311_.

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

   fw_printenv | grep ^8311
   reboot
   

After rebooting the WAS-110, safely remove the SC/APC cable from the XS-220X-A and connect it to the WAS-110. If all previous steps were followed correctly, the WAS-110 should operate with O5.1 PLOAM status. For troubleshooting, please read the Troubleshoot connectivity issues with the WAS-110 guide before seeking help on the 8311 Discord community server.

Software versions¶

The following are the last known supported software versions. If the Firmware Version Match attribute is configured with the correct regular expression, the Software Version A/B attribute(s) will attempt to auto-update to match the firmware version transferred by the OLT, although this isn't foolproof. Most OLT provisioning systems will attempt to update the firmware via OMCI upon detecting a mismatch. Note that this transfer can take several minutes due to the size of the firmware image.

Please help us by contributing new versions via the 8311 Discord community server or submitting a Pull Request.