summaryrefslogtreecommitdiffstats
path: root/_ont/ont-nokia-g-010s-p.md
blob: 0daa460160bebcbcdba42822c57b542d39d3f4e9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
---
title: Nokia G-010S-P
has_children: true
layout: default
parent: Nokia
---

# Hardware Specifications

|                  |                                          |
| ---------------- | ---------------------------------------- |
| Vendor/Brand     | Nokia                                    |
| Model            | G-010S-P                                 |
| ODM              | SourcePhotonics                          |
| ODM Product Code | SPS-34-24T-HP-TDFO                       |
| Chipset          | Lantiq PEB98035                          |
| Flash            | 16 MB                                    |
| RAM              | 64 MB                                    |
| CPU              | MIPS 34Kc interAptiv                     |
| CPU Clock        | 400MHz                                   |
| System           | OpenWRT                                  |
| HSGMII           | Yes                                      |
| Optics           | SC/APC                                   |
| IP address       | 192.168.1.10                             |
| Web Gui          | Can be enabled                           |
| SSH              | ✅ user `ONTUSER`, password `SUGAR2A041` |
| Telnet           |                                          |
| Serial           | ✅ on SFP                                |
| Serial baud      | 115200                                   |
| Serial encoding  | 8-N-1                                    |
| Form Factor      | miniONT SFP                              |

{% include image.html file="g-010s-p.jpg"  alt="G-010S-P" caption="G-010S-P" %}
<br/>
{% include image.html file="g-010s-p-and-ma5671a.jpg"  alt="G-010S-P and MA5671A Teardown" caption="G-010S-P and MA5671A Teardown" %}
<br/>
{% include alert.html content="G-010S-P and other models will not expose an ethernet interface unless fiber cable is connected ([source](https://forum.mikrotik.com/viewtopic.php?t=116364&start=300))" alert="Warning" icon="svg-warning" color="yellow" %}

## Firmware is interchangeable with:

- [Huawei MA5671A](/ont-huawei-ma5671a)
- [ONT FS.com GPON ONU Stick with MAC / SourcePhotonics SPS-34-24T-HP-TDFO](/ont-fs-com-gpon-onu-stick-with-mac)
- [Hilink HL23446](/ont-hilink-hl23446)
- {:.text-red-200 } Dasan H650SFP 
- {:.text-red-200 } DpOptics D23446    
- {:.text-red-200 } Photonics SPS-34-24T-HP-TDFO

The [Nokia G-010S-A](/ont-nokia-g-010s-a) can be flashed with the Nokia G-010S-P firmware, provided the MTD layout has been changed beforehand to match the new one. For the full procedure, see the post on [lafibre.info](https://lafibre.info/remplacer-livebox/guide-de-connexion-fibre-directement-sur-un-routeur-voire-meme-en-2gbps/msg870551/#msg870551)

## List of software versions

- 3FE56853AOPD39

## Serial

The stick has a TTL 3.3v UART console (configured as 115200 8-N-1) that can be accessed from the SFP connector.

| USB TTL(UART) Adapter | SFP 20pins Molex connector |
| --------------------- | -------------------------- |
| 3.3V                  | pin #15 and #16            |
| TX                    | pin #2                     |
| RX                    | pin #7                     |
| GND                   | pin #14 and #10            |

{% include alert.html content="Try PIN 10 or other GND PINs if the connection doesn't work by using PIN 14." alert="Note"  icon="svg-warning" color="yellow" %}

{% include alert.html content="Some USB TTL adapters label TX and RX pins the other way around: try to swap them if the connection doesn't work." alert="Note"  icon="svg-warning" color="yellow" %}

## 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"       |
| mtd1 | 00080000 | 00010000  | "uboot_env"   |
| mtd2 | 00740000 | 00010000  | "linux"       |
| mtd3 | 0061eedc | 00010000  | "rootfs"      |
| 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" %}

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)

```sh
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 root@192.168.1.10:/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:
```sh
scp ONTUSER@192.168.1.10:/tmp/mtdX ./
```

## Checking the currently active image

```sh
# fw_printenv committed_image
```

## Booting to a different image


```sh
# fw_setenv committed_image 0|1
# fw_setenv image0|1_is_valid 1
```

## Cloning of mtd1 (image 0) into mtd5 (image 1)

{% include alert.html content="Image 0 can be flashed to image 1, while image 1 cannot be flashed to image 0 because it has larger rootfs_data" alert="Warning" icon="svg-warning" color="yellow" %}

The following commands are used to clone image0 to image1 and then boot to it
```sh
# cat /dev/mtd2 > /tmp/mtd2.bin
# mtd -e image1 write /tmp/mtd2.bin image1
# fw_setenv committed_image 1
# fw_setenv image1_is_valid 1
# reboot
```

## 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
```

## Getting/Setting Speed LAN Mode

| Velue | Speed                              |
| ----- | ---------------------------------- |
| 4     | 1 Gbps / SGMII                     |
| 5     | 2.5 Gbps / HSGMII with auto-neg on |

To enable the 2.5 Gbps / HSGMII with auto-neg on:

```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` variable tells the current speed

## Querying a particular OMCI ME
```sh
omci_pipe.sh meg MIB_IDX ME_IN
```
Where `MIB_IDX` is the MIB ID and the `ME_IN` is the ME instance number

# EEPROM (I2C slave simulated EEPROM)

The Nokia G-010S-P does not have a physical EEPROM, the Falcon SOC emulates an EEPROM by exposing it on the I2C interface as required by the SFF-8472 specification.

On the I2C interface there will be two memories of 256 bytes each at the addresses `1010000X (A0h)` and `1010001X (A2h)`.

The Zyxel PMG3000-D20B stores the content of the emulated EEPROM1 (A2h) in Boot env variable `sfp_a2_info` to restore it after a reboot.

{% include alert.html content="The contents of EEPROM0 (A0h) are not stored anywhere and is regenerated at each boot" alert="Info" icon="svg-info" color="blue" %}

## EEPROM1 layout

| address | size | name                              | default value                             | description                                                 |
| ------- | ---- | --------------------------------- | ----------------------------------------- | ----------------------------------------------------------- |
|         |      | **DIAGNOSTIC AND CONTROL FIELDS** |                                           |                                                             |
| 0-1     | 2    | Temp High Alarm                   | `0x64 0x00` (100℃)                        | Value expressed in two's complement                         |
| 2-3     | 2    | Temp Low Alarm                    | `0xCE 0x00` (-50℃)                        | Value expressed in two's complement                         |
| 4-5     | 2    | Temp High Warning                 | `0x5F 0x00` (95℃)                         | Value expressed in two's complement                         |
| 6-7     | 2    | Temp Low Warning                  | `0xD8 0x00` (-40℃)                        | Value expressed in two's complement                         |
| 8-9     | 2    | Voltage High Alarm                | `0x8C 0xA0` (3.6V)                        | Value expressed in volt subunits[^subunit]                  |
| 10-11   | 2    | Voltage Low Alarm                 | `0x75 0x30` (3V)                          | Value expressed in volt subunits[^subunit]                  |
| 12-13   | 2    | Voltage High Warning              | `0x88 0xB8` (3.5V)                        | Value expressed in volt subunits[^subunit]                  |
| 14-15   | 2    | Voltage Low Warning               | `0x79 0x18` (3.1V)                        | Value expressed in volt subunits[^subunit]                  |
| 16-17   | 2    | Bias High Alarm                   | `0xAF 0xC8` (4.5mA)                       | Value expressed in milliampere subunits[^subunit]           |
| 18-19   | 2    | Bias Low Alarm                    | `0x00 0x00` (0mA)                         | Value expressed in milliampere subunits[^subunit]           |
| 20-21   | 2    | Bias High Warning                 | `0x88 0xB8` (3.5mA)                       | Value expressed in milliampere subunits[^subunit]           |
| 22-23   | 2    | Bias Low Warning                  | `0x00 0x00` (0mA)                         | Value expressed in milliampere subunits[^subunit]           |
| 24-25   | 2    | TX Power High Alarm               | `0x7B 0x86` (5dBm)                        | Value expressed in watts subunits[^subunit]                 |
| 26-27   | 2    | TX Power Low Alarm                | `0x22 0xD0` (-0dBm)                       | Value expressed in watts subunits[^subunit]                 |
| 28-29   | 2    | TX Power High Warning             | `0x6E 0x17` (4dBm)                        | Value expressed in watts subunits[^subunit]                 |
| 30-31   | 2    | TX Power Low Warning              | `0x27 0x10` (0dBm)                        | Value expressed in watts subunits[^subunit]                 |
| 32-33   | 2    | RX Power High Alarm               | `0x07 0xCB` (-7dBm)                       | Value expressed in watts subunits[^subunit]                 |
| 34-35   | 2    | RX Power Low Alarm                | `0x00 0x0F` (-28dBm)                      | Value expressed in watts subunits[^subunit]                 |
| 36-37   | 2    | RX Power High Warning             | `0x06 0x30` (-8dBm)                       | Value expressed in watts subunits[^subunit]                 |
| 38-39   | 2    | RX Power Low Warning              | `0x00 0x14` (-27dBm)                      | Value expressed in watts subunits[^subunit]                 |
| 40-45   | 6    | MAC address                       | Unique in each SFP                        | Contains the mac address of the SFP, it could also be empty |
| 46-55   | 10   | Reserved                          | `0x00 0x00 0x00...`                       | Reserved                                                    |
| 56-59   | 4    | RX_PWR(4) Calibration             | `0x00 0x00 0x00 0x00`                     | 4th order RSSI calibration coefficient                      |
| 60-63   | 4    | RX_PWR(3) Calibration             | `0x00 0x00 0x00 0x00`                     | 3rd order RSSI calibration coefficient                      |
| 64-67   | 4    | RX_PWR(2) Calibration             | `0x00 0x00 0x00 0x00`                     | 2nd order RSSI calibration coefficient                      |
| 68-71   | 4    | RX_PWR(1) Calibration             | `0x3F 0x80 0x00 0x00`                     | 1st order RSSI calibration coefficient                      |
| 72-75   | 4    | RX_PWR(0) Calibration             | `0x00 0x00 0x00 0x00`                     | 0th order RSSI calibration coefficient                      |
| 76-77   | 2    | TX_I(Slope) Calibration           | `0x01 0x00`                               | Slope for Bias calibration                                  |
| 78-79   | 2    | TX_I(Offset) Calibration          | `0x00 0x00`                               | Offset for Bias calibration                                 |
| 80-81   | 2    | TX_PWR(Slope) Calibration         | `0x01 0x00`                               | Slope for TX Power calibration                              |
| 82-83   | 2    | TX_PWR(Offset) Calibration        | `0x00 0x00`                               | Offset for TX Power calibration                             |
| 84-85   | 2    | T(Slope) Calibration              | `0x01 0x00`                               | Slope for Temperature calibration                           |
| 86-87   | 2    | T(Offset) Calibration             | `0x00 0x00`                               | Offset for Temperature calibration, in units of 256ths °C   |
| 88-89   | 2    | V(Slope) Calibration              | `0x01 0x00`                               | Slope for VCC calibration                                   |
| 90-91   | 2    | V(Offset) Calibration             | `0x00 0x00`                               | Offset for VCC calibration                                  |
| 92-94   | 3    | Reserved                          | `0x00 0x00 0x00`                          | Reserved                                                    |
| 95      | 1    | CC_DMI                            |                                           | Check code for Base Diagnostic Fields (addresses 0 to 94)   |
| 96      | 1    | Temperature MSB                   |                                           | Internally measured module temperature                      |
| 97      | 1    | Temperature LSB                   |                                           |                                                             |
| 98      | 1    | Vcc MSB                           |                                           | Internally measured supply voltage in transceiver           |
| 99      | 1    | Vcc LSB                           |                                           |                                                             |
| 100     | 1    | TX Bias MSB                       |                                           | Internally measured TX Bias Current                         |
| 101     | 1    | TX Bias LSB                       |                                           |                                                             |
| 102     | 1    | TX Power MSB                      |                                           | Measured TX output power                                    |
| 103     | 1    | TX Power LSB                      |                                           |                                                             |
| 104     | 1    | RX Power MSB                      |                                           | Measured RX input power                                     |
| 105     | 1    | RX Power LSB                      |                                           |                                                             |
| 106-109 | 4    | Optional Diagnostics              | `0xFF 0xFF 0xFF 0xFF` (No support)        | Monitor Data for Optional Laser temperature and TEC current |
| 110     | 1    | Status/Control                    | `0x03`                                    | Optional Status and Control Bits                            |
| 111     | 1    | Reserved                          | `0x00`                                    | Reserved                                                    |
| 112-113 | 2    | Alarm Flags                       | Supported                                 | Diagnostic Alarm Flag Status Bits                           |
| 114     | 1    | Tx Input EQ control               | `0xFF` (No support)                       | Tx Input equalization level control                         |
| 115     | 1    | Rx Out Emphasis control           | `0xFF` (No support)                       | Rx Output emphasis level control                            |
| 116-117 | 2    | Warning Flags                     | Supported                                 | Diagnostic Warning Flag Status Bits                         |
| 118-119 | 2    | Ext Status/Control                | `0x00 0x00`                               | Extended module control and status bytes                    |
|         |      | **GENERAL USE FIELDS**            |                                           |                                                             |
| 120-126 | 7    | Vendor Specific                   | `0x70 0x00 0x00 0x00 0x00 0x00 0x20`      | Vendor specific memory addresses                            |
| 127     | 1    | Table Select                      | `0x00`                                    | Optional Page Select                                        |
|         |      | **USER WRITABLE EEPROM**          |                                           |                                                             |
| 128-247 | 120  | Reserved                          | `0x00 0x00 0x00...`                       | Reserved                                                    |
| 248-255 | 8    | Vendor Control                    | `0x00 0x00 0x00 0x00 0x00 0x41 0x41 0x31` | Vendor specific control functions                           |

{% include alert.html content="For more information, see the SFF-8472 Rev 11.0 specification." alert="Info" icon="svg-info" color="blue" %}


# Miscellaneous Links

- [alcatel_lucent-lantiq_falcon](https://github.com/minhng99/alcatel_lucent-lantiq_falcon)
- [uboot lantiq falcon](https://github.com/minhng99/u-boot_lantiq_falcon)
- [Usage GPON module SFP in Spain](https://forum.mikrotik.com/viewtopic.php?t=116364&start=300)

---

[^subunit]: The subunit are 10000 times smaller than the specified unit