module bbf-hardware-transceivers {

    yang-version 1.1;

    namespace
      "urn:bbf:yang:bbf-hardware-transceivers";

    prefix bbf-hw-xcvr;

    import ietf-hardware {
      prefix hw;
    }
    import bbf-hardware-types {
      prefix bbf-hwt;
    }

    organization
      "Broadband Forum <https://www.broadband-forum.org>
     Common YANG Work Area";

    contact
      "Comments or questions about this Broadband Forum YANG module
     should be directed to <mailto:help@broadband-forum.org>.

     Editor:      Nick Hancock, ADTRAN

     Editor:      Ludwig Pauwels, Nokia

     PS Leader:   Joey Boyd, ADTRAN

     WA Director: Joey Boyd, ADTRAN

     WA Director: Sven Ooghe, Nokia";

    description
      "This module contains a collection of YANG definitions for
     supporting the Broadband Forum requirements on hardware
     management as applicable to access network equipment.
     As such, this module is specific to access network equipment
     (e.g., BBF-specified Access Nodes and FTTdp DPUs).

     Specifically, this module augments the ietf-hardware model with
     management of compact transceivers.

     Copyright (c) 2017-2022, Broadband Forum

     Redistribution and use in source and binary forms, with or
     without modification, are permitted provided that the following
     conditions are met:

     1. Redistributions of source code must retain the above copyright
        notice, this list of conditions and the following disclaimer.

     2. Redistributions in binary form must reproduce the above
        copyright notice, this list of conditions and the following
        disclaimer in the documentation and/or other materials
        provided with the distribution.

     3. Neither the name of the copyright holder nor the names of its
        contributors may be used to endorse or promote products
        derived from this software without specific prior written
        permission.

     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
     CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES,
     INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
     MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
     DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
     CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
     NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
     LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
     CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
     STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
     ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

     The above license is used as a license under copyright only.
     Please reference the Forum IPR Policy for patent licensing terms
     <https://www.broadband-forum.org/ipr-policy>.

     Any moral rights which are necessary to exercise under the above
     license grant are also deemed granted under this license.

     This version of this YANG module is part of TR-383a5; see
     the TR itself for full legal notices.";

    revision "2022-03-01" {
      description
        "Amendment 5.
       * Approval Date:    2022-03-01.
       * Publication Date: 2022-03-01.";
      reference
        "TR-383a5: Common YANG Modules
        	  <https://www.broadband-forum.org/technical/download/
        		   TR-383_Amendment-5.pdf>";

    }

    revision "2021-06-02" {
      description
        "Amendment 4.
       * Approval Date:    2021-06-02.
       * Publication Date: 2021-06-02.";
      reference
        "TR-383a4: Common YANG Modules
        	  <https://www.broadband-forum.org/technical/download/
        		   TR-383_Amendment-4.pdf>";

    }

    revision "2020-10-13" {
      description
        "Amendment 3.
       * Approval Date:    2020-10-13.
       * Publication Date: 2020-10-13.";
      reference
        "TR-383a3: Common YANG Modules
        	  <https://www.broadband-forum.org/technical/download/
        		   TR-383_Amendment-3.pdf>";

    }


    feature vendor-eeprom {
      description
        "Indicates support for reporting the contents of the vendor-
       specific EEPROM data fields.";
      reference
        "SFF-8472 Rev 12.4, Table 4-1, Address A0h, Bytes 96-127;
        SFF-8436 Rev 4.9, Table 29, Upper Memory Map Page 00h,
        Bytes 224-255;
        INF-8077i Rev 4.5, Table 46, Page 01h,
        Bytes 224-255";

    }

    feature vendor-eeprom-string {
      if-feature vendor-eeprom;
      description
        "Indicates support for reporting the contents of the vendor-
       specific EEPROM data fields as a string.";
      reference
        "SFF-8472 Rev 12.4, Table 4-1, Address A0h, Bytes 96-127;
        SFF-8436 Rev 4.9, Table 29, Upper Memory Map Page 00h,
        Bytes 224-255;
        INF-8077i Rev 4.5, Table 46, Page 01h,
        Bytes 224-255";

    }

    feature vendor-eeprom-binary {
      if-feature vendor-eeprom;
      description
        "Indicates support for reporting the contents of the vendor-
       specific EEPROM data fields in binary format.";
      reference
        "SFF-8472 Rev 12.4, Table 4-1, Address A0h, Bytes 96-127;
        SFF-8436 Rev 4.9, Table 29, Upper Memory Map Page 00h,
        Bytes 224-255;
        INF-8077i Rev 4.5, Table 46, Page 01h,
        Bytes 224-255";

    }

    feature extended-information {
      description
        "Indicates whether reporting extended information data fields
       of the transceiver are supported.";
      reference
        "SFF-8472 Rev 12.4, Section 10";

    }

    feature user-eeprom {
      if-feature extended-information;
      description
        "Indicates support for reporting the contents of the user-
       writable EEPROM data fields.";
      reference
        "SFF-8472 Rev 12.4, Table 10-4, Address A2h, Page 00h/01h,
        Bytes 128-247;
        SFF-8436 Rev 4.9, Section 7.6.4 Upper Memory Map Page 02h,
        Bytes 128-255;
        INF-8077i Rev 4.5, Section 5.45 Upper Memory Map Table 02h,
        Bytes 128-255";

    }

    feature user-eeprom-string {
      if-feature user-eeprom;
      description
        "Indicates support for reporting the contents of the user-
       writable EEPROM data fields as a string.";
      reference
        "SFF-8472 Rev 12.4, Table 10-4, Address A2h, Page 00h/01h,
        Bytes 128-247;
        SFF-8436 Rev 4.9, Section 7.6.4 Upper Memory Map Page 02h,
        Bytes 128-255;
        INF-8077i Rev 4.5, Section 5.45 Upper Memory Map Table 02h,
        Bytes 128-255";

    }

    feature user-eeprom-binary {
      if-feature user-eeprom;
      description
        "Indicates support for reporting the contents of the user-
       writable EEPROM data fields in binary format.";
      reference
        "SFF-8472 Rev 12.4, Table 10-4, Address A2h, Page 00h/01h,
        Bytes 128-247;
        SFF-8436 Rev 4.9, Section 7.6.4 Upper Memory Map Page 02h,
        Bytes 128-255;
        INF-8077i Rev 4.5, Section 5.45 Upper Memory Map Table 02h,
        Bytes 128-255";

    }

    identity transceiver-alarm-warning {
      description
        "Base identity for the basic alarm and warning flags of the
       transceiver.

       This identity is abstract and MUST NOT be used for a
       transceiver alarm or warning flag.";
    }

    identity temperature-high {
      base transceiver-alarm-warning;
      description
        "The internal temperature has exceeded the high level
       threshold.";
    }

    identity temperature-low {
      base transceiver-alarm-warning;
      description
        "The internal temperature has dropped below the low level
       threshold.";
    }

    identity supply-voltage-high {
      base transceiver-alarm-warning;
      description
        "The internal supply voltage has exceeded the high level
       threshold.";
    }

    identity supply-voltage-low {
      base transceiver-alarm-warning;
      description
        "The internal supply voltage has dropped below the low level
       threshold.";
    }

    identity link-alarm-warning {
      description
        "Base identity for the physical links of alarm and warning flags
       of the transceiver.

       This identity is abstract and MUST NOT be used for a
       transceiver link alarm or warning flag.";
    }

    identity tx-bias-high {
      base link-alarm-warning;
      description
        "The transmit (TX) bias current has exceeded the high level
       threshold.";
    }

    identity tx-bias-low {
      base link-alarm-warning;
      description
        "The transmit (TX) bias current has dropped below the low level
       threshold.";
    }

    identity tx-power-high {
      base link-alarm-warning;
      description
        "The transmit (TX) output power has exceeded the high level
       threshold.";
    }

    identity tx-power-low {
      base link-alarm-warning;
      description
        "The transmit (TX) output power has dropped below the low
       level threshold.";
    }

    identity rx-power-high {
      base link-alarm-warning;
      description
        "The receive (RX) input power has exceeded the high level
       threshold.";
    }

    identity rx-power-low {
      base link-alarm-warning;
      description
        "The receive (RX) input power has dropped below the low level
       threshold.";
    }

    identity laser-temperature-high {
      base link-alarm-warning;
      description
        "The laser temperature has exceeded the high level threshold.";
    }

    identity laser-temperature-low {
      base link-alarm-warning;
      description
        "The laser temperature has dropped below the low level
       threshold.";
    }

    identity tec-current-high {
      base link-alarm-warning;
      description
        "The Thermoelectric Cooler (TEC) current has exceeded the high
       level threshold.";
    }

    identity tec-current-low {
      base link-alarm-warning;
      description
        "The Thermoelectric Cooler (TEC) current has dropped below the
       low level threshold.";
    }

    identity physical-device {
      description
        "Identifies the physical device.

       This identity is abstract and MUST NOT be used to represent a
       physical device.";
      reference
        "SFF-8472 Rev 12.4, Table 5-1, Address A0h, Byte 0";

    }

    identity unknown-physical-device {
      base physical-device;
      description "Unknown or unspecified.";
      reference
        "SFF-8472 Rev 12.4, Table 5-1, Address A0h, Byte 0, Value 00h;
        SFF-8024 Rev 4.8a, Table 4-1, Value 00h";

    }

    identity gbic {
      base physical-device;
      description "GBIC.";
      reference
        "SFF-8472 Rev 12.4, Table 5-1, Address A0h, Byte 0, Value 01h;
        SFF-8024 Rev 4.8a, Table 4-1, Value 01h";

    }

    identity sff {
      base physical-device;
      description
        "Module/connector soldered to a motherboard (using SFF-8472).";
      reference
        "SFF-8472 Rev 12.4, Table 5-1, Address A0h, Byte 0, Value 02h;
        SFF-8024 Rev 4.8a, Table 4-1, Value 02h";

    }

    identity sfp {
      base physical-device;
      description "SFP/SFP+/SFP28.";
      reference
        "SFF-8472 Rev 12.4, Table 5-1, Address A0h, Byte 0, Value 03h;
        SFF-8024 Rev 4.8a, Table 4-1, Value 03h";

    }

    identity xbi-300-pin {
      base physical-device;
      description "300 pin XBI.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 04h";

    }

    identity xenpak {
      base physical-device;
      description "XENPAK.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 05h";

    }

    identity xfp {
      base physical-device;
      description "XFP.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 06h";

    }

    identity xff {
      base physical-device;
      description "XFF.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 07h";

    }

    identity xfp-e {
      base physical-device;
      description "XFP-E.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 08h";

    }

    identity xpak {
      base physical-device;
      description "XPAK.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 09h";

    }

    identity x2 {
      base physical-device;
      description "X2.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 0Ah";

    }

    identity dwdm-sfp {
      base physical-device;
      description
        "DWDM-SFP/SFP+ (not using SFF-8472).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 0Bh";

    }

    identity qsfp {
      base physical-device;
      description "QSFP (INF-8438).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 0Ch";

    }

    identity qsfp-plus-or-later {
      base physical-device;
      description
        "QSFP+ or later (SFF-8436, SFF-8635, SFF-8665, SFF-8685 et
       al).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 0Dh";

    }

    identity cxp-or-later {
      base physical-device;
      description "CXP or later.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 0Eh";

    }

    identity shielded-mini-multilane-hd-4x {
      base physical-device;
      description
        "Shielded Mini Multilane HD 4x.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 0Fh";

    }

    identity shielded-mini-multilane-hd-8x {
      base physical-device;
      description
        "Shielded Mini Multilane HD 8x.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 10h";

    }

    identity qsfp28-or-later {
      base physical-device;
      description
        "QSFP28 or later (SFF-8665).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 11h";

    }

    identity cxp2-or-later {
      base physical-device;
      description
        "CXP2 (aka CXP28) or later.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 12h";

    }

    identity cdfp-style1-style2 {
      base physical-device;
      description "CDFP (Style 1/Style 2).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 13h";

    }

    identity shielded-mini-multilane-hd-4x-fanout-cable {
      base physical-device;
      description
        "Shielded Mini Multilane HD 4x Fanout Cable.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 14h";

    }

    identity shielded-mini-multilane-hd-8x-fanout-cable {
      base physical-device;
      description
        "Shielded Mini Multilane HD 8x Fanout Cable.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 15h";

    }

    identity cdfp-style3 {
      base physical-device;
      description "CDFP (Style 3).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 16h";

    }

    identity micro-qsfp {
      base physical-device;
      description "Micro QSFP.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 17h";

    }

    identity qsfp-dd {
      base physical-device;
      description
        "QSFP-DD Double Density 8X Pluggable Transceiver (INF-8628).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Value 18h";

    }

    identity vendor-specific {
      base physical-device;
      description
        "Vendor specific physical device. A vendor may derive specific
       identities from this one.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-1, Values 80h-FFh";

    }

    identity connector-type {
      description
        "Identifies the external optical or electrical cable connector
       provided as the media interface.

       This identity is abstract and MUST NOT be used to represent a
       connector type.";
      reference
        "SFF-8472 Rev 12.4, Section 5.3, Address A0h, Byte 2";

    }

    identity unknown-connector-type {
      base connector-type;
      description "Unknown or unspecified.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 00h";

    }

    identity subscriber-connector {
      base connector-type;
      description
        "SC (Subscriber Connector).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 01h";

    }

    identity fibre-channel-style-1-copper {
      base connector-type;
      description
        "Fibre Channel Style 1 copper connector.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 02h";

    }

    identity fibre-channel-style-2-copper {
      base connector-type;
      description
        "Fibre Channel Style 2 copper connector.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 03h";

    }

    identity bnc-tnc {
      base connector-type;
      description
        "BNC/TNC (Bayonet/Threaded Neill-Concelman).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 04h";

    }

    identity fibre-channel-coax-headers {
      base connector-type;
      description
        "Fibre Channel coax headers.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 05h";

    }

    identity fibre-jack {
      base connector-type;
      description "Fibre Jack.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 06h";

    }

    identity lucent-connector {
      base connector-type;
      description "LC (Lucent Connector).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 07h";

    }

    identity mt-rj {
      base connector-type;
      description
        "MT-RJ (Mechanical Transfer - Registered Jack).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 08h";

    }

    identity mu {
      base connector-type;
      description "MU (Multiple Optical).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 09h";

    }

    identity sg {
      base connector-type;
      description "SG.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 0Ah";

    }

    identity optical-pigtail {
      base connector-type;
      description "Optical Pigtail.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 0Bh";

    }

    identity mpo-1x12 {
      base connector-type;
      description
        "MPO 1x12 (Multifiber Parallel Optic).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 0Ch";

    }

    identity mpo-2x16 {
      base connector-type;
      description
        "MPO 2x16 (Multifiber Parallel Optic).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 0Dh";

    }

    identity hssdc-ii {
      base connector-type;
      description
        "HSSDC II (High Speed Serial Data Connector).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 20h";

    }

    identity copper-pigtail {
      base connector-type;
      description "Copper Pigtail.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 21h";

    }

    identity rj45 {
      base connector-type;
      description "RF45 (Registered Jack).";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 22h";

    }

    identity no-separable-connector {
      base connector-type;
      description "No separable connector.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 23h";

    }

    identity mxc-2x16 {
      base connector-type;
      description "MXC 2x16.";
      reference
        "SFF-8024 Rev 4.8a, Table 4-3, Value 24h";

    }
  }  // module bbf-hardware-transceivers