Add more info to Nokia G-010S-P

Author: simonebortolin

_ont/ont-nokia-g-010s-p-ymodem.md

@@ -0,0 +1,18 @@
+---
+title: Flash firmware for Nokia G-010S-P (with root)
+has_children: false
+parent: Nokia G-010S-P
+layout: default
+---
+
+This procedure flashes the firmware in the stick via serial. You have to get firmware to flash, some are listed on the [Huawei MA5671A page](/ont-huawei-ma5671a).
+
+{: .text-center .fs-6 }
+<button id="flash-start-button" class="btn btn-blue" data-jtd-toggle="modal" data-jtd-target="#flash-modal">Start flash!</button>
+
+<div id="flash-browser-error" style="display:none">{% include alert.html content="This browser is not compatible with the web-root procedure. See the <a href='https://developer.mozilla.org/en-US/docs/Web/API/Web_Serial_API#browser_compatibility'>Browser compatibility</a>" alert="Note"  icon="svg-warning" color="red" %}</div>
+<noscript>
+{% include alert.html content="Your browser does not support JavaScript!" alert="Note"  icon="svg-warning" color="red" %}
+</noscript>
+
+{% include ymodem_lantiq.html modelName="Nokia G-010S-P" %}

_ont/ont-nokia-g-010s-p.md

@@ -1,6 +1,6 @@
 ---
 title: Nokia G-010S-P
-has_children: false
+has_children: true
 layout: default
 parent: Nokia
 ---
@@ -12,7 +12,7 @@ parent: Nokia
 | Vendor/Brand     | Nokia                                    |
 | Model            | G-010S-P                                 |
 | ODM              | SourcePhotonics                          |
-| ODM Product Code |                                          |
+| ODM Product Code | SPS-34-24T-HP-TDFO                       |
 | Chipset          | Lantiq PEB98035                          |
 | Flash            | 16 MB                                    |
 | RAM              | 64 MB                                    |
@@ -21,7 +21,7 @@ parent: Nokia
 | System           | OpenWRT                                  |
 | HSGMII           | Yes                                      |
 | Optics           | SC/APC                                   |
-| IP address       |                                          |
+| IP address       | 192.168.1.10                             |
 | Web Gui          | Can be enabled                           |
 | SSH              | ✅ user `ONTUSER`, password `SUGAR2A041` |
 | Telnet           |                                          |
@@ -64,6 +64,28 @@ The stick has a TTL 3.3v UART console (configured as 115200 8-N-1) that can be a
 
 ## List of partitions
 
+Partition layouts change depending on which image is booted, in particular:
+
+When booting image0:
+```
+mtd2 ---> image0 (linux)
+mtd5 --> image1
+mtd3 --> rootfs
+mtd4 --> rootfs_data
+```
+When booting image0:
+```
+mtd2 ---> image0
+mtd3 --> image1 (linux)
+mtd4 --> rootfs
+mtd5 --> rootfs_data
+```
+
+For more info [XPONos partition layout](https://github.com/XPONos/linux_lantiq-falcon/commit/456f68f69a84c846a542a9f0ea47c37476535dcb).
+
+
+### When booting from image0
+
 | dev  | size     | erasesize | name          |
 | ---- | -------- | --------- | ------------- |
 | mtd0 | 00040000 | 00010000  | "uboot"       |
@@ -73,17 +95,188 @@ The stick has a TTL 3.3v UART console (configured as 115200 8-N-1) that can be a
 | mtd4 | 00370000 | 00010000  | "rootfs_data" |
 | mtd5 | 00800000 | 00010000  | "image1"      |
 
+### When booting from image1
+
+| dev  | size     | erasesize | name          |
+| ---- | -------- | --------- | ------------- |
+| mtd0 | 00040000 | 00010000  | "uboot"       |
+| mtd1 | 00080000 | 00010000  | "uboot_env"   |
+| mtd2 | 00740000 | 00010000  | "image0"      |
+| mtd3 | 00800000 | 00010000  | "linux"       |
+| mtd4 | 006d8077 | 00010000  | "rootfs"      |
+| mtd5 | 00410000 | 00010000  | "rootfs_data" |
+
 # General Settings and Useful Commands
 
+## Bootloader unlock from shell
+{% include alert.html content="It is strongly recommended that you unlock the bootloader before making any major changes to the firmware." alert="Warning"  icon="svg-warning" color="yellow" %}
+```sh
+fw_setenv bootdelay 5
+fw_setenv asc0 0
+fw_setenv preboot "gpio set 3;gpio input 2;gpio input 105;gpio input 106;gpio input 107;gpio input 108"
+```
+
+{% include alert.html content="In general, the last command is not needed because by default serial is already enabled on SFP PINs." alert="Info"  icon="svg-info" color="blue" %}
+
+## Emergency bootloader unlock via TTL serial
+
+{% include alert.html content="This is not necessary if you have already unlocked the bootloader from the shell as specified above." alert="Warning"  icon="svg-warning" color="yellow" %}
+
+If for some reason you are in the situation where you do not have a bootable firmware on your SFP stick you can do an emergency unlock via TTL serial.
+
+To perform the emergency unlock is necessary to have:
+- TTL-USB adapter
+- SFP adapter to connect the TTL-USB cables to the SFP stick
+
+The electrical connections are the same as those of the Huawei MA5671A, see the [Huawei root guide](/ont-huawei-ma5671a-root-web) for accurate details on how to connect the TTL-USB to the SFP adapter.
+
+When you are ready with everything plugged in you need to press the button below. A window will open that will execute the emergency unlock.
+
+{: .text-center .fs-6 }
+<button id="start-button" class="btn btn-blue" data-jtd-toggle="modal" data-jtd-target="#root-modal" disabled>Start emergency unlock!</button>
+{% include root_lantiq.html modelName="Nokia G-010S-P" unlockHuaweiShell=false %}
+
+<div id="browser-error" style="display:none">{% include alert.html content="This browser is not compatible with the emergency unlock procedure. See the <a href='https://developer.mozilla.org/en-US/docs/Web/API/Web_Serial_API#browser_compatibility'>Browser compatibility</a>" alert="Note"  icon="svg-warning" color="red" %}</div>
+<noscript>
+{% include alert.html content="Your browser does not support JavaScript!" alert="Note"  icon="svg-warning" color="red" %}
+</noscript>
+
+
+## Getting and Setting S/N
+To check the current serial number:
+```sh
+onu gtcsng
+```
+
+To set the current serial number:
+```sh
+onu gtcsns ABCD12345678
+```
+
+## Getting and Setting PLOAM Password
+To check the current password (the password field contains decimal values of ASCII characters):
+```sh
+onu gtccg
+```
+
+To set the current password:
+```sh
+uci set gpon.ploam.nPassword="0x30 0x31 0x32 0x33 0x34 0x35 0x36 0x37 0x38 0x39"
+uci commit 
+```
+
+{% include alert.html content="There is also the `onu gtc_password_set` command to set the ploam password but it does not seem to work." alert="Info"  icon="svg-info" color="blue" %}
+
+
+## Getting/Setting Speed LAN Mode
+
+The known speed values are as follows:
+
+| Value | Speed    |
+| ----- | -------- |
+| 4     | 1 Gbps   |
+| 5     | 2.5 Gbps |
+
+To set the (H)SGMII Mode:
+
+```sh
+fw_setenv sgmii_mode 5
+```
+
+To remove the value (back to default):
+```sh
+fw_setenv sgmii_mode
+```
+
+To get the (H)SGMII Mode:
+
+```sh
+onu lanpsg 0
+```
+
+The `link_status` value shows the speed.
+
 ##  Disabling Dying Gasp
 ```sh
 fw_setenv nDyingGaspEnable 0
 ```
 
+## Rebooting the ONU
+```sh
+reboot
+```
+
+## Checking whether the connection with the OLT was successful (O5 state)
+
+```shell
+onu ploamsg
+```
+
 ## Enabling the Web UI
 
 To activate the web-ui you can use the following guide on [dslreport](https://www.dslreports.com/forum/r32458588-).
 
+## Transferring files to the stick
+
+{% include alert.html content="If you use a modern OpenSSH version (e.g. >= 8.8) you will have to use the legacy protocol and enable some deprecated algorithms: scp `-oKexAlgorithms=+diffie-hellman-group1-sha1 -oHostKeyAlgorithms=+ssh-dss [...]`" alert="Info" icon="svg-info" color="blue" %}
+
+```sh
+# scp rootfs.bin [email protected]:/tmp/
+```
+
+## Backup of all partition
+
+Make a backup of all partitions, an easy way is:
+- On the stick run:
+```sh
+cat /proc/mtd
+```
+- For each mtdX run in the lantiq shell:
+```sh
+cp /dev/mtdX /tmp
+```
+
+{% include alert.html content="If you use a modern OpenSSH version (e.g. >= 8.8) you will have to use the legacy protocol and enable some deprecated algorithms: `scp -oKexAlgorithms=+diffie-hellman-group1-sha1 -oHostKeyAlgorithms=+ssh-dss [...]`" alert="Info" icon="svg-info" color="blue" %}
+
+And in the computer shell:
+```shell
+scp [email protected]:/tmp/mtdX ./
+```
+
+## Flashing a new rootfs via SSH
+
+{% include alert.html content="Only the inactive image can be flashed" alert="Info" icon="svg-info" color="blue" %}
+
+The following commands are used to flash a new rootfs to image1 and then boot to it
+```sh
+# mtd -e image1 write /tmp/rootfs.bin image1
+# fw_setenv committed_image 1
+# fw_setenv image1_is_valid 1
+# reboot
+```
+
+{% include alert.html content="Some OLTs don't like when ONTs don't boot from image 0, therefore the previous procedure must be preceded by the following procedure with inverted images, as to clone image 1 into image 0" alert="Warning" icon="svg-warning" color="yellow" %}
+
+## Flashing a new rootfs via Serial
+
+If you wish to change the firmware via serial, we recommend using the web app: [Web Serial Flash](/ont-nokia-g-010s-p-ymodem)
+
+# TX Fault / Serial
+
+The stick stays in a perpetual "TX Fault" state since the same SFP pin is used for both serial and TX Fault signaling, if that causes you issues (normally it shouldn't) you can issue the commands below to disable it. Note that it will disable both the TX Fault signal and Serial on the stick after boot.
+
+```sh
+fw_setenv asc0 1
+fw_setenv preboot "gpio set 3;gpio input 100;gpio input 105;gpio input 106;gpio input 107;gpio input 108"
+```
+
+In case you need to re-enable it issue the following commands from the bootloader (FALCON)
+
+```sh
+FALCON => setenv asc0 0
+FALCON => saveenv
+```
+
 # Miscellaneous Links
 
 - [alcatel_lucent-lantiq_falcon](https://github.com/minhng99/alcatel_lucent-lantiq_falcon)