This object models a generic optical interface. It defines an {{object|Interface}} object that models a layer 1 optical interface that is capable of transporting Ethernet packets. For historical reasons, the data model definition is based on parts of {{bibref|G.988}}. However, it is not intended to model anything specific to IEEE PON or ITU-T PON technologies. Note that this object is not intended to model the optical transceiver either. {{numentries}} Optical interface table (a stackable interface object as described in {{bibref|TR-181i2|Section 4.2}}). This table models physical optical interfaces. Enables or disables the optical interface. This parameter is based on ''ifAdminStatus'' from {{bibref|RFC2863}}. The current operational state of the optical interface (see {{bibref|TR-181i2|Section 4.2.2}}). {{enum}} When {{param|Enable}} is {{false}} then {{param}} SHOULD normally be {{enum|Down}} (or {{enum|NotPresent}} or {{enum|Error}} if there is a fault condition on the interface). When {{param|Enable}} is changed to {{true}} then {{param}} SHOULD change to {{enum|Up}} if and only if the interface is able to transmit and receive network traffic; it SHOULD change to {{enum|Dormant}} if and only if the interface is operable but is waiting for external actions before it can transmit and receive network traffic (and subsequently change to {{enum|Up}} if still operable when the expected actions have completed); it SHOULD change to {{enum|LowerLayerDown}} if and only if the interface is prevented from entering the {{enum|Up}} state because one or more of the interfaces beneath it is down; it SHOULD remain in the {{enum|Error}} state if there is an error or other fault condition detected on the interface; it SHOULD remain in the {{enum|NotPresent}} state if the interface has missing (typically hardware) components; it SHOULD change to {{enum|Unknown}} if the state of the interface can not be determined for some reason. This parameter is based on ''ifOperStatus'' from {{bibref|RFC2863}}. {{datatype|expand}} The textual name of the optical interface as assigned by the CPE. The accumulated time in {{units}} since the optical interface entered its current operational state. {{list}} {{reference|an interface object that is stacked immediately below this interface object}} See {{bibref|TR-181i2|Section 4.2.1}}. Note: Since {{object}} is a layer 1 interface, it is expected that {{param}} will not be used. Indicates whether the interface points towards the Internet ({{true}}) or towards End Devices ({{false}}). For example: * For an Internet Gateway Device, {{param}} will be {{true}} for all WAN interfaces and {{false}} for all LAN interfaces. * For a standalone WiFi Access Point that is connected via Ethernet to an Internet Gateway Device, {{param}} will be {{true}} for the Ethernet interface and {{false}} for the WiFi Radio interface. * For an End Device, {{param}} will be {{true}} for all interfaces. Current measurement of total downstream optical signal level. {{datatype|expand}} Valid values are -65.536 dBm (coded as -65536), to 65.534 dBm (coded as 65534) in 0.002 dB increments. This parameter is based on ''Optical signal level'' from {{bibref|G.988|Section 9.2.1}}. Optical level that is used to declare the downstream low received optical power alarm. {{datatype|expand}} Valid values are -127.5 dBm (coded as -127500) to 0 dBm (coded as 0) in 0.5 dB increments. The value -127500 indicates the device's internal policy. This parameter is based on ''Lower optical threshold'' from {{bibref|G.988|section 9.2.1}}. {{deprecated|2.15|because it is not intended for the device to raise an optical power alarm.}} Optical level that is used to declare the downstream high received optical power alarm. {{datatype|expand}} Valid values are -127.5 dBm (coded as -127500) to 0 dBm (coded as 0) in 0.5 dB increments. The value -127500 indicates the device's internal policy. This parameter is based on ''Upper optical threshold'' from {{bibref|G.988|section 9.2.1}}. {{deprecated|2.15|because it is not intended for the device to raise an optical power alarm.}} Current measurement of mean optical launch power. {{datatype|expand}} Valid values are -65.536 dBm (coded as -65536), to 65.534 dBm (coded as 65534) in 0.002 dB increments. This parameter is based on ''Transmit optical level'' from {{bibref|G.988|section 9.2.1}}. Minimum mean optical launch power that is used to declare the low transmit optical power alarm. {{datatype|expand}} Valid values are -63.5 dBm (coded as -63500) to +63.5 dBm (coded as 63500) in 0.5 dB increments. The value -63500 indicates the device's internal policy. This parameter is based on ''Lower transmit power threshold'' from {{bibref|G.988|section 9.2.1}}. {{deprecated|2.15|because it is not intended for the device to raise an optical power alarm.}} Maximum mean optical launch power that is used to declare the high transmit optical power alarm. {{datatype|expand}} Valid values are -63.5 dBm (coded as -63500) to +63.5 dBm (coded as 63500) in 0.5 dB increments. The value -63500 indicates the device's internal policy. This parameter is based on ''Upper transmit power threshold'' from {{bibref|G.988|section 9.2.1}}. {{deprecated|2.15|because it is not intended for the device to raise an optical power alarm.}} Throughput statistics for this interface. The CPE MUST reset the interface's Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interface becomes operationally down due to a previous administrative down (i.e. the interface's {{param|#.Status}} parameter transitions to a down state after the interface is disabled) or when the interface becomes administratively up (i.e. the interface's {{param|#.Enable}} parameter transitions from {{false}} to {{true}}). Administrative and operational interface status is discussed in {{bibref|TR-181i2|section 4.2.2}}. The total number of bytes transmitted out of the interface, including framing characters. The total number of bytes received on the interface, including framing characters. The total number of packets transmitted out of the interface. The total number of packets received on the interface. The total number of outbound packets that could not be transmitted because of errors. The total number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol. The total number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. The total number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space.