# ponmngr

## About ponmngr

The ponmngr package helps manage pon configuration and exposes pon related information
over the ubus and to the data model.

## Features

- Configuration of pon parameters.
- Reading pon related information.

## Configuration of pon parameters

At present, configuration support for enabling/disabling pon and serial number is
present via the UCI file as follows

```
config ani 'ani'
	option enable '1'
	option serial_number 'IOPS18000001'
```

`serial_number` is the unique for each ONU and essential for ONU registration, hence,
if the serial number is not configured in the uci, then, it is read from the
production data (using the gponsn variable). If it has not been written in the
production data then,  `serial_number` is generated using the combination of vendor
"IOPS" and last 4 octet of device mac address.

## Reading pon related information

After ubus starts the xpon methods can be invoked to get the status


```
root@iopsys:~# ubus call xpon status
{
    "ONU": [
        {
            "Enable": true,
            "Version": "",
            "EquipmentID": "BVM4K00BRA",
            "softwareImage": [
                {
                    "ID": 0,
                    "Version": "7.2.0alpha0-5",
                    "IsValid": true,
                    "IsActive": false,
                    "IsCommitted": false
                },
                {
                    "ID": 1,
                    "Version": "7.2.0alpha0-5",
                    "IsValid": true,
                    "IsActive": true,
                    "IsCommitted": true
                }
            ],
            "EthernetUNI": [
                {
                    "Enable": true,
                    "Status": "UP",
                    "ANIs": "gpon0.0",
                    "InterDomainID": "(VEIP,1025)",
                    "InterDomainName": "VEIP",
                    "Stats": {
                        "BytesSent": 39891,
                        "BytesReceived": 50296,
                        "PacketsSent": 314,
                        "PacketsReceived": 384
                    }
                },
                {
                    "Enable": true,
                    "Status": "UP",
                    "ANIs": "gpon0.0",
                    "InterDomainID": "(VEIP,1025)",
                    "InterDomainName": "VEIP",
                    "Stats": {
                        "BytesSent": 54499,
                        "BytesReceived": 47908,
                        "PacketsSent": 286,
                        "PacketsReceived": 273
                    }
                },
                {
                    "Enable": false,
                    "Status": "DOWN",
                    "ANIs": "gpon0.0",
                    "InterDomainID": "(VEIP,1025)",
                    "InterDomainName": "VEIP",
                    "Stats": {
                        "BytesSent": 0,
                        "BytesReceived": 0,
                        "PacketsSent": 0,
                        "PacketsReceived": 0
                    }
                },
                {
                    "Enable": false,
                    "Status": "DOWN",
                    "ANIs": "gpon0.0",
                    "InterDomainID": "(VEIP,1025)",
                    "InterDomainName": "VEIP",
                    "Stats": {
                        "BytesSent": 0,
                        "BytesReceived": 0,
                        "PacketsSent": 0,
                        "PacketsReceived": 0
                    }
                }
            ],
            "ANI": [
                {
                    "Enable": true,
                    "Status": "Up",
                    "PONMode": "GPON",
                    "Stats": {
                        "BytesSent": 228,
                        "BytesReceived": 408394,
                        "PacketsSent": 2,
                        "PacketsReceived": 2328
                    }
                }
            ],
            "Transceiver": [
                {
                    "ID": 0,
                    "Identifier": 3,
                    "ModuleVendor": "MENTECHOPTO",
                    "ModuleName": "MSOG22-LDCC-ACCO",
                    "ModuleVersion": "MNC221K90309",
                    "ModuleFirmwareVersion": "1.0",
                    "PONMode": "GPON",
                    "TxPower": 16,
                    "RxPower": -240,
                    "Voltage": 3300,
                    "Bias": 15744,
                    "Temperature": 270
                }
            ]
        }
    ]
}
```