summaryrefslogtreecommitdiffstats
path: root/_ont/ont-genexis-ft-g2110c.md
blob: 4aeee5a66d610c44587785649a34e2c9b218429c (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
---
title: FiberTwist G2110C-2.5G
has_children: false
layout: default
parent: Genexis
---

# Hardware Specifications

|                 |                                                              |
| --------------- | ------------------------------------------------------------ |
| Vendor/Brand    | Genexis FiberTwist                                           |
| Model           | G2110C-2.5G                                                  |
| Chipset         | Realtek RTL9601D                                             |
| Flash           | 128MB                                                        |
| RAM             | 32MB                                                         |
| System          | Linux 3.18 (Luna SDK 3.3)                                    |
| 2.5GBaseT       | Yes                                                          |
| Optics          | SC/APC                                                       |
| IP address      | 192.168.100.1/24 or 192.168.1.1/24                           |
| Web Gui         | Can be enabled, locked down by iptables rule and missing CSS |
| SSH             |                                                              |
| Telnet          | ✅ user `company`, password `amyM77yY`                       |
| Serial          | ✅                                                           |
| Serial baud     | 115200                                                       |
| Serial encoding | 8-N-1                                                        |
| Form Factor     | ONT                                                          |

{% include image.html file="ft-g2110c-front.jpg"  alt="FiberTwist G2110C-2.5G Front" caption="FiberTwist G2110C-2.5G Front" %}

{% include image.html file="ft-g2110c-back.jpg"  alt="FiberTwist G2110C-2.5G Back" caption="FiberTwist G2110C-2.5G Back" %}

## Optical Header installation backplate
{% include image.html file="ft-g2110c-optical-header-1.jpg"  alt="FiberTwist G2110C-2.5G Optical Header installation backplate" caption="FiberTwist G2110C-2.5G Optical Header installation backplate" %}

{% include image.html file="ft-g2110c-optical-header-2.jpg"  alt="FiberTwist G2110C-2.5G Optical Header installation backplate" caption="FiberTwist G2110C-2.5G Optical Header installation backplate" %}

{% include image.html file="ft-g2110c-optical-header-3.jpg"  alt="FiberTwist G2110C-2.5G Optical Header installation backplate" caption="FiberTwist G2110C-2.5G Optical Header installation backplate" %}

## Serial

The ONT has a TTL 3.3v UART console (configured as 115200 8-N-1) that can be accessed from the top surface. To accept TX line commands, the GND of the TTL adapter should be attached to the ONT's shield:

{% include image.html file="ft-g2110c-internal.jpg"  alt="FiberTwist G2110C-2.5G Internal" caption="FiberTwist G2110C-2.5G Internal" %}

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

## List of software versions
- C-5.6.1-R
- C-5.7.0-R
- C-5.7.1-DEV3
- C-5.7.1-EFT1

## List of partitions

| dev   | size     | erasesize | name            |
| ----- | -------- | --------- | --------------- |
| mtd0  | 00040000 | 00001000  | "boot"          |
| mtd1  | 00002000 | 00001000  | "env"           |
| mtd2  | 00002000 | 00001000  | "env2"          |
| mtd3  | 0003c000 | 00001000  | "config"        |
| mtd4  | 00300000 | 00001000  | "k0"            |
| mtd5  | 004c0000 | 00001000  | "r0"            |
| mtd6  | 00300000 | 00001000  | "k1"            |
| mtd7  | 004c0000 | 00001000  | "r1"            |
| mtd8  | 00001000 | 00001000  | "Partition_008" |
| mtd9  | 00001000 | 00001000  | "Partition_009" |
| mtd10 | 00001000 | 00001000  | "Partition_010" |
| mtd11 | 00001000 | 00001000  | "Partition_011" |
| mtd12 | 00300000 | 00001000  | "linux"         |
| mtd13 | 004c0000 | 00001000  | "rootfs"        |

This ONT supports dual boot. 

`k0` and `r0` respectively contain the kernel and firmware of the first image, `k1` and `r1` the kernel and the firmware of the second one

# GPON/OMCI settings

{% include alert.html content="Some variables are write-protected, you need to unlock them before proceeding" alert="Info" icon="svg-info" color="blue" %}

Use the following command to unlock write-protected variables:

```sh
# nv setenv ProtectEnv 0
```

## Getting/Setting ONU GPON Serial Number

{% include alert.html content="If your serial number has letters after the Vendor ID (e.g. ZTEGAAA01234), put them in lower case (e.g. ZTEGaaa01234)" alert="Info" icon="svg-info" color="blue" %}

```sh
# nv setenv GponSn ZTEGaaa01234
```
Reboot the ONT to apply any changes

You can check if the serial number was correctly changed using the following command:

```sh
# diag gpon get serialnumber
ZTEGaaa01234
```

## Getting/Setting ONU GPON PLOAM password

{% include alert.html content="The PLOAM password is stored in ASCII format" alert="Info" icon="svg-info" color="blue" %}

```sh
# /etc/scripts/flash get GPON_PLOAM_PASSWD
GPON_PLOAM_PASSWD=AAAAAAAAAA
# /etc/scripts/flash set GPON_PLOAM_PASSWD AAAAAAAAAA
```
It seems Genexis has also included a U-Boot variable to store the PLOAM. On currently known firmwares (5.6.1 and 5.7.0) it is not read by the `omci_app` daemon.
For future-proofing reasons, set your PLOAM also on the before-mentioned U-Boot env using the following command in the OS shell:

```sh
# nv setenv ploampwd 1234567890
ploampwd=1234567890
```
## Setting OMCI software version (ME 7)

The stock firware does not allow changing of the primary and standby software version. 
As the ONT uses the Luna SDK, the `/etc/scripts/flash` shell script can be easily modified by creating a custom firmware with the same set of patches suggested e.g. for the [Technicolor AFM0002](/ont-technicolor-afm0002) ONT.

You can then check if the software version was changed correctly with this command (take a look at the `Version` field):

```sh
# omcicli mib get 7
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
SWImage
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
=================================
EntityID: 0x00
Active: 0
Committed: 0
Valid: 1
*Version: V6.0.10N14*
ProductCode:
ImageHash: 0x00000000000000000000000000000000
=================================
=================================
EntityID: 0x01
Active: 1
Committed: 1
Valid: 1
*Version: V6.0.10N14*
ProductCode:
ImageHash: 0x00000000000000000000000000000000
=================================
```

## Setting OMCI hardware version (ME 256)

```sh
# nv setenv HV G2110CE2V1D0
```
Reboot the ONT to apply the change

## Setting OMCI equipment ID (ME 257)

```sh
# nv setenv ProdName FT-G2110C-2.5G
```
Reboot the ONT to apply the change

# Advanced settings

## Setting management IP
```sh
# /etc/scripts/flash get LAN_IP_ADDR
LAN_IP_ADDR=192.168.1.1
# /etc/scripts/flash set LAN_IP_ADDR 192.168.1.1
 ```

# Known Bugs
- The web UI can be enabled by modding the firmware, but the daemon will crash if no optical signal is received

# Miscellaneous Links
- [FiberTwist G2110C-2.5G](https://genexis.eu/content/uploads/2020/07/FiberTwist-G2110C-2.5G-Installation-Guide-v1.0-EN.pdf)