Masquerade as the Bouygues S.A Bbox with the WAS-110 or X-ONU-SFPP¶

Determine if you're an XGS-PON subscriber¶

1. Within a web browser, navigate to https://mabbox.bytel.fr/ or https://192.168.1.254 and, if asked, input your Administrator password and click the Connect button.

2. From the Main page, click on the Administration interface to revert to the old interface.

3. From the Administration page, click on the Fiber section inside the Internet panel on the left-hand side.

4. From the Fiber page, verify that the PON Mode is XGS-PON.

   Take note of the Serial Number beginning with SMBS and Software Versions for the WAS-110 configuration

Extract required attributes¶

PON serial number¶

with the web UI¶

1. Within a web browser, navigate to https://mabbox.bytel.fr/ or https://192.168.1.254 and, if asked, input your Administrator password and click the Connect button.

2. From the Main page, click on the Administration interface to revert to the old interface.

3. From the Administration page, click on the Fiber section inside the Internet panel on the left-hand side.

4. From the Fiber page, copy the Serial Number beginning with SMBS.

with the web API¶

1. Within a web browser, navigate to https://mabbox.bytel.fr/api/v1/wan/sfp or https://mabbox.bytel.fr/api/v1/wan/sff, whichever works.

2. From the JSON output, search and copy the Serial Number beginning with SMBS or 0x534d4253. If the Serial Number begins with the hexadecimal notation copy the characters after 0x534d4253 and append to SMBS or use the form below.
   

The above steps can be summarized into a single-line terminal command:

(Invoke-RestMethod -Uri "https://mabbox.bytel.fr/api/v1/wan/sff").wan.serial_number -replace "0x534d4253", "SMBS"

curl -s https://mabbox.bytel.fr/api/v1/wan/sff | plutil -extract 0.wan.serial_number raw - | sed 's/0x534d4253/SMBS/'

curl -s https://mabbox.bytel.fr/api/v1/wan/sff | jq -r '.[] | select(.wan.serial_number != null) | .wan.serial_number | sub("0x534d4253"; "SMBS")'

PLOAM registration ID¶

The registration ID is composed of a seventy-two (72) octets from the fifteen (15) octet IMEI prefixed with five (5) 0's and suffixed with fifty-two (52) 1's.

00000XXXXXXXXXXXXXXX1111111111111111111111111111111111111111111111111111

The IMEI can be obtained from the back label of the Bbox or from the web UI.

1. Within a web browser, navigate to https://mabbox.bytel.fr/ or https://192.168.1.254 and, if asked, input your Administrator password and click the Connect button.

2. From the Main page, click on the Administration interface to revert to the old interface.

3. From the Administration page, click on the Model section inside the Bbox panel on the right-hand side.

4. From the Bbox page, copy the IMEI number.

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 Bbox, 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¶

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

   Attribute	Value	Remarks
   PON Serial Number (ONT ID)	SMBS...	PON serial number
   Registration ID	00000...	PLOAM registration ID
   MIB File	/etc/mibs/prx300_1U.ini

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

   Identify VLANs

   Once configuration is complete and the fiber is connected, wait for successful authentication (O5 state). You can then use the VLAN Table Analyser to identify service VLANs by copying the table from the VLANs page (https://192.168.11.1/cgi-bin/luci/admin/8311/vlans) and pasting it into the tool.

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

   fwenv_set -8 gpon_sn SMBS... # (1)!
   fwenv_set -8 reg_id_hex 00000... # (2)!
   fwenv_set -8 fix_vlans 0
   

   1. PON serial number
   2. PLOAM registration ID

   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 Bbox 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.

Finally, continue with your bypass by consulting the routing guide(s).

Routing guides¶

• LaFibre - Bouygues Telecom Remplacer la Bbox par un routeur