submodule bbf-vdsl-xtu-line-status-body {

    yang-version 1.1;

    belongs-to bbf-vdsl {
        prefix bbf-vdsl;
    }

    import ietf-yang-types {
      prefix yang;
    }
    import bbf-yang-types {
      prefix bbf-yang;
    }

    include bbf-vdsl-base-body;

    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:      Ken Kerpez, ASSIA, Inc.

     Editor:      Joey Boyd, Adtran

     PS Leader:   Joey Boyd, Adtran

     WA Director: Sven Ooghe, Nokia

     WA Director: Joey Boyd, Adtran";

    description
      "This submodule contains a collection of YANG definitions for
     managing Broadband Forum TR-252i3 clause 6.1 xDSL Transceiver
     Unit (xTU) Line Status.

     Copyright (c) 2016-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-355a4; see
     the TR itself for full legal notices.";

    revision "2022-05-23" {
      description
        "Amendment 4.
       * Approval Date:    2022-05-23
       * Publication Date: 2022-05-23.";
      reference
        "TR-355a4: YANG Modules for FTTdp Management
        	    <https://www.broadband-forum.org/download/
        		   TR-355_Amendment-4.pdf>";

    }

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

    }

    revision "2019-10-21" {
      description
        "Amendment 2 Corrigendum 1.
       * Approval Date:    2019-10-21
       * Publication Date: 2019-10-21.";
      reference
        "TR-355a2c1: YANG Modules for FTTdp Management
        	    <https://www.broadband-forum.org/download/
        		   TR-355_Amendment-2.pdf>";

    }

    revision "2019-06-11" {
      description
        "Amendment 2.
       * Approval Date:    2019-06-11
       * Publication Date: 2019-06-11.";
      reference
        "TR-355a2: YANG Modules for FTTdp Management
        	  <https://www.broadband-forum.org/technical/download/
        		 TR-355_Amendment-2.pdf>";

    }

    revision "2018-10-01" {
      description
        "Amendment 1.
       * Approval Date:    2018-10-01
       * Publication Date: 2018-10-01.";
      reference
        "TR-355a1: YANG Modules for FTTdp Management
        	  <https://www.broadband-forum.org/technical/download/
        		 TR-355_Amendment-1.pdf>";

    }

    revision "2017-11-27" {
      description
        "Corrigendum 2 (fixes to the previous revision).
       * Approval Date:    see revision date above.
       * Publication Date: 2018-01-19.";
      reference
        "TR-355c2: YANG Modules for FTTdp Management
        	  <https://www.broadband-forum.org/technical/download/
        		 TR-355_Corrigendum-2.pdf>";

    }

    revision "2017-03-13" {
      description
        "Corrigendum 1 (fixes to the initial revision).
       * Approval Date:    see revision date above.
       * Publication Date: 2017-04-12.";
      reference
        "TR-355c1: YANG Modules for FTTdp Management
        	  <https://www.broadband-forum.org/technical/download/
        		 TR-355_Corrigendum-1.pdf>";

    }

    revision "2016-07-18" {
      description
        "Initial revision.
       * Approval Date:    see revision date above.
       * Publication Date: 2016-08-05.";
      reference
        "TR-355: YANG Modules for FTTdp Management
        	<https://www.broadband-forum.org/technical/download/
        		 TR-355.pdf>";

    }


    typedef time-stamp-or-undefined {
      type union {
        type enumeration {
          enum "undefined" {
            value 0;
            description
              "The value of the time stamp is undefined or unknown.";
          }
        }
        type yang:date-and-time;
      }
      description
        "The date/time associated with a particular time stamp. The
       special value, 'undefined', is used when the event represented
       by the time stamp has not yet occurred.";
    }

    grouping xtu-c-line-failure-parameters {
      description
        "xDSL Transceiver Unit - Central office (xTU-C) failure
       parameters.";
      leaf los {
        type boolean;
        description
          "A Loss of Signal (LOS) failure is declared after 2.5 +- 0.5
         seconds of contiguous LOS defect, or, if LOS defect is
         present when the criteria for Loss of Frame (LOF) failure
         declaration have been met (see LOF definition below). A LOS
         failure is cleared after 10 +- 0.5 seconds of no LOS
         defect.";
        reference
          "ITU-T G.997.1 clause 7.1.1.1.1";

      }

      leaf lof {
        type boolean;
        description
          "A Loss of Frame (LOF) failure is declared after 2.5 +- 0.5
         seconds of contiguous Severly Errored Frame (SEF) defect,
         except when an LOS defect or failure is present (see LOS
         definition above). A LOF failure is cleared when LOS failure
         is declared, or after 10 +- 0.5 seconds of no SEF defect.";
        reference
          "ITU-T G.997.1 clause 7.1.1.1.2";

      }

      leaf lpr {
        type boolean;
        description
          "A Loss of Power (LPR) failure is declared after 2.5 +- 0.5
         seconds of contiguous near-end LPR primitive presence. An LPR
         failure is cleared after 10 +- 0.5 seconds of no near-end LPR
         primitive presence.";
        reference
          "ITU-T G.997.1 clause 7.1.1.1.3";

      }

      leaf linit {
        type boolean;
        description
          "If the line is forced to the L0 state (or into loop
         diagnostic mode) and an attempt to reach the L0 state (or to
         successfully complete the loop diagnostic procedures) fails
         (after a vendor discretionary number of retries and/or within
         a vendor discretionary timeout), then an initialization
         failure occurs. An initialization failure cause and last
         successful transmitted state are given by the line
         initialization (LINIT) failure (see clause 7.5.1.6). A line
         initialization failure will be conveyed to the NMS by the
         xDSL Transceiver Unit - Central office (xTU-C) (over the
         Q-interface) and should be conveyed to the NMS by the xDSL
         Transceiver Unit - Remote side (xTU-R) (over the
         T-/S-interface) after it is detected.";
        reference
          "ITU-T G.997.1 clause 7.1.1.3";

      }

      leaf loss-of-margin {
        type boolean;
        description
          "A Loss of Margin (LOM) failure is declared when a
         re-initialization is triggered by a persistent near-end
         lom defect, except when an Loss of Signal (LOS) or Loss of
         Frame (LOF) defect or failure is present (see los and lof
         definitions above). A LOM failure is cleared when LOS or LOF
         failure is declared, or after 10 +- 0.5 seconds of no LOM
         defect.";
        reference
          "ITU-T G.997.1 clause 7.1.1.1.4";

      }
    }  // grouping xtu-c-line-failure-parameters

    grouping xtu-r-line-failure-parameters {
      description
        "xDSL Transceiver Unit - Remote side (xTU-R) line failure
       parameters.";
      leaf los-fe {
        type boolean;
        description
          "A Far-End Loss of Signal (LOS-FE) failure is declared after
         2.5 +- 0.5 seconds of contiguous far-end Loss of Signal (LOS)
         defects, or, if far-end LOS defect is present when the
         criteria for Loss of Frame (LOF) failure declaration have
         been met (see LOF definition below). A far-end LOS failure is
         cleared after 10 +- 0.5 seconds of no far-end LOS defect.";
        reference
          "ITU-T G.997.1 clause 7.1.1.2.1";

      }

      leaf lof-fe {
        type boolean;
        description
          "A Far-End Loss of Frame (LOF-FE) failure is declared after
         2.5 +- 0.5 seconds of contiguous Remote Defect Indication
         (RDI) defects, except when a far-end Loss of Signal (LOS)
         defect or failure is present (see LOS definition above). A
         far-end Loss of Frame (LOF) failure is cleared when far-end
         LOS failure is declared, or after 10 +- 0.5 seconds of no RDI
         defect.";
        reference
          "ITU-T G.997.1 clause 7.1.1.2.2";

      }

      leaf lpr-fe {
        type boolean;
        description
          "A Far-End Loss of Power (LPR-FE) failure is declared after
         the occurrence of a far-end LPR primitive followed by 2.5 +-
         0.5 seconds of contiguous near-end Loss of Signal (LOS)
         defects. A far-end LPR failure is cleared after 10 +- 0.5
         seconds of no near-end LOS defect.";
        reference
          "ITU-T G.997.1 clause 7.1.1.2.3";

      }

      leaf loss-of-margin-fe {
        type boolean;
        description
          "A Far-End Loss of Margin (LOM-FE) failure is declared when a
         re-initialization is triggered by a persistent far-end lom
         defect, except when an Far-End Loss of Signal (LOS-FE) or
         Far-End Loss of Frame (LOF-FE) defect or failure is present
         (see los-fe and lof-fe definitions above). A far-end LOM
         failure is cleared when far end LOS or LOF failure is
         declared, or after 10 +- 0.5 seconds of no far-end LOM
         defect.";
        reference
          "ITU-T G.997.1 clause 7.1.1.2.4";

      }
    }  // grouping xtu-r-line-failure-parameters

    grouping xtu-line-status {
      description
        "Status parameters for the line.";
      leaf snr-margin {
        type union {
          type int16 {
            range "-640..630";
          }
          type enumeration {
            enum "out-of-range" {
              value 0;
              description
                "Indicates that the value is out of range to
               be represented.";
            }
          }
        }
        units "0.1 dB";
        status obsolete;
        description
          "The signal-to-noise ratio (SNR) margin is the maximum
         increase, in dB, of the noise power received at the
         receiver, such that the Bit Error Rate (BER) requirements are
         met for all bearer channels (SNRMds for xDSL Transceiver
         Unit - Remote side (xTU-R) / SNRMus for xDSL Transceiver
         Unit - Central office (xTU-C)). The SNR margin ranges from
         -64 dB to +63 dB, with 0.1 dB steps. A special value (enum
         out-of-range) indicates the parameter is out of range to be
         represented.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.13 (SNRMds) and 7.5.1.16
          (SNRMus)";

      }

      leaf profile {
        type profiles;
        description
          "This parameter defines the profile in use. It is coded in a
         bit-map representation (0 if in use, 1 if not in use).";
        reference
          "ITU-T G.997.1 clauses 7.3.1.1.11 and 7.5.1.2";

      }

      leaf limitmask {
        type limitmask-descriptor;
        description
          "This configuration parameter contains the G.993.2 limit
         PSD masks of the selected Power Spectral Density (PSD) mask
         class, that is used by the near-end xDSL Transceiver Unit
         (xTU) on this line. One LIMITMASK parameter is defined per
         the G.993.2 Annex.";
        reference
          "ITU-T G.997.1 clause 7.5.1.3";

      }

      leaf us0mask {
        type us0mask-descriptor;
        description
          "This parameter contains none or the one US0 Power Spectral
         Density (PSD) masks in use by the near-end xDSL Transceiver
         Unit (xTU) on the line.";
        reference
          "ITU-T G.997.1 clause 7.5.1.4";

      }

      leaf actual-cyclic-extension {
        type uint8 {
          range "2..16";
        }
        units "n samples";
        description
          "This parameter reports the cyclic extension used on the
         line. It is coded as an unsigned integer from 2 to 16 in
         units of N/32 samples, where 2N is the Inverse Discrete
         Fourier Transform (IDFT) size.";
        reference
          "ITU-T G.997.1 clause 7.5.1.32 (ACTUALCE)";

      }

      leaf actual-aele-mode {
        type enumeration {
          enum "0" {
            value 0;
            description
              "kl0[band] = ELE-M0 VDSL Transceiver Unit - central Office
             (VTU-O) kl0 estimate.";
          }
          enum "1" {
            value 1;
            description
              "kl0[band] = ELEDS [dB], with band in the set
             {upbo_bands}.";
          }
          enum "2" {
            value 2;
            description
              "kl0[band] = ELE[band] [dB], with band in the set
             {upbo_bands}.";
          }
          enum "3" {
            value 3;
            description
              "kl0[band] = MIN(ELEUS, ELEDS) [dB], with band in the
             set {upbo_bands}.";
          }
        }
        description
          "This parameter reports the actual Alternative Electrical
         Length Estimation Mode (AELE-MODE). The value of this
         parameter is 0, 1, 2 or 3.";
        reference
          "ITU-T G.997.1 clause 7.5.1.23.7 (ACT-AELE-MODE);
          ITU-T G.993.2 clause 7.2.1.3.2.1 (AELE-MODE)";

      }

      leaf actual-vector-mode {
        type enumeration {
          enum "0" {
            value 0;
            description
              "If Actual Vector Mode (ACTVECTORMODE) equals 0, the line
             is initialized in G.993.2 mode different from Annex X or
             Annex Y.";
          }
          enum "1" {
            value 1;
            description
              "If Actual Vector Mode (ACTVECTORMODE) equals 1, the line
             is initialized in G.993.2 Annex X.";
          }
          enum "2" {
            value 2;
            description
              "If Actual Vector Mode (ACTVECTORMODE) equals 2, the line
             is initialized in G.993.2 Annex Y.";
          }
          enum "3" {
            value 3;
            description
              "If Actual Vector Mode (ACTVECTORMODE) equals 3, the line
             is initialized in G.993.5.";
          }
        }
        description
          "This parameter reports the vectoring initialization type
         of the line.";
        reference
          "ITU-T G.997.1 clause 7.5.1.43.1 (ACTVECTORMODE)";

      }

      leaf attndr-actual-method {
        type uint8 {
          range "0..2";
        }
        description
          "This parameter indicates the actual Attainable Net Data Rate
         (ATTNDR) Method used for calculation of the ATTNDR in the
         downstream and upstream direction.";
        reference
          "ITU-T G.997.1 clause 7.5.1.41.1 (ATTNDR_ACTMETHOD);
          ITU-T G.993.2 clause 11.4.1.1.7";

      }
    }  // grouping xtu-line-status

    grouping xtu-line-status-receiver-directional {
      description
        "Directional line status for receiver.";
      leaf actual-snr-mode {
        type enumeration {
          enum "1" {
            value 0;
            description
              "If the Actual Signal-to-Noise Ratio Mode (ACTSNRMODE)
             equals 1, the virtual noise is inactive.";
          }
          enum "2" {
            value 1;
            description
              "For downstream, if the Actual Signal-to-Noise Ratio Mode
             (ACTSNRMODE) equals 2, the virtual noise is active.
             For upstream, if ACTSNRMODE equals 2,
             the transmitter-referred virtual noise is active.";
          }
          enum "3" {
            value 2;
            description
              "For upstream, if the Actual Signal-to-Noise Ratio Mode
             (ACTSNRMODE) equals 3, the receiver-referred virtual
             noise is active.";
          }
          enum "4" {
            value 3;
            description
              "For downstream, If the Actual Signal-to-Noise Ratio Mode
             (ACTSNRMODE) equals 4, the virtual noise together with
             the virtual noise scaling factor is active.
             For upstream, if ACTSNRMODE equals 4, the receiver-
             referred virtual noise together with the virtual noise
             scaling factor is active.";
          }
        }
        description
          "This parameter indicates if the transmitter referred virtual
         noise is active on the line in the direction toward the
         receiver (ACTSNRMODEds for xDSL Transceiver Unit - Remote
         side (xTU-R) / ACTSNRMODEus for xDSL Transceiver Unit -
         Central office (xTU-C)).";
        reference
          "ITU-T G.997.1 clauses 7.5.1.15 (ACTSNRMODEds) and 7.5.1.18
          (ACTSNRMODEus)";

      }

      leaf attainable-net-data-rate {
        type bbf-yang:data-rate32-or-undetermined;
        description
          "This parameter indicates the maximum net data rate currently
         attainable from the transmitter (ATTNDRds for xDSL
         Transceiver Unit - Central office (xTU-C) / ATTNDRus for
         xDSL Transceiver Unit - Remote side (xTU-R)). The rate is
         coded in steps of 1000 bits per second.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.19 (ATTNDRds) and 7.5.1.20
          (ATTNDRus)";

      }

      leaf trellis {
        type boolean;
        description
          "This parameter reports whether trellis coding is in use in
         the direction of transmission. It is represented as one bit
         coded as 0 (false) if the trellis is not used and as 1 (true)
         if the trellis is used.";
        reference
          "ITU-T G.997.1 claused 7.5.1.30 (TRELLISds) and 7.5.1.31
          (TRELLISus)";

      }

      leaf actual-ra-mode {
        type enumeration {
          enum "1" {
            value 0;
            description
              "If the Actual Rate Adaptation Mode (ACT-RA-MODE) equals
             1, the link is operating in RA-MODE 1 (MANUAL).";
          }
          enum "2" {
            value 1;
            description
              "If the Actual Rate Adaptation Mode (ACT-RA-MODE) equals
             2, the link is operating in RA-MODE 2 (AT_INIT).";
          }
          enum "3" {
            value 2;
            description
              "If the Actual Rate Adaptation Mode (ACT-RA-MODE) equals
             3, the link is operating in RA-MODE 3 (DYNAMIC).";
          }
          enum "4" {
            value 3;
            description
              "If the Actual Rate Adaptation Mode (ACT-RA-MODE) equals
             4, the link is operating in RA-MODE 4 (DYNAMIC with
             SOS).";
          }
        }
        description
          "This parameter indicates the actual active Rate Adatpation
         Mode (RA-MODE) in the direction of transmission.";
        reference
          "ITU-T G.997.1 claused 7.5.1.33.1 (ACT-RA-MODEds) and
          7.5.1.33.2 (ACT-RA-MODEus)";

      }

      leaf rxthrh {
        type uint8 {
          range "36..100";
        }
        units "dB";
        description
          "This parameter reports the received signal level threshold
         (RXTHRH) value used in the alternative electrical length
         estimation method (ELE-M1) in the direction of transmission.
         This parameter represents an offset from -100 dBm per Hz, and
         ranges from -64 dB to 0 dB in steps of 1 dB.";
        reference
          "ITU-T G.997.1 clauses 7.2.1.3.2.2 (ELE-M1), 7.5.1.23.5
          (RXThrHds) and 7.5.1.23.6 (RXThrHus)";

      }

      leaf actual-inp-roc {
        type uint8 {
          range "0..254 | 255";
        }
        units "0.1 T4k periods";
        description
          "This parameter reports the Actual Impulse Noise Protection
         (ACTINP) of the Robust Overhead Channel (ROC) in the
         direction of transmission. The format and usage is identical
         to the channel status parameter ACTINP.

         A special value (255) is used to indicate the ACTINP is
         greater than 25.4 T4k periods where a T4k period is about
         250 microseconds.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.34.1 (ACTINP-ROC-ds), 7.5.1.34.2
          (ACTINP-ROC-us) and 7.5.2.4 (ACTINP)";

      }

      leaf snr-margin-roc {
        type union {
          type int16 {
            range "-640..630";
          }
          type enumeration {
            enum "out-of-range" {
              value 0;
              description
                "Indicates that the value is out of range to
               be represented.";
            }
          }
        }
        units "0.1 dB";
        description
          "This parameter reports the actual signal-to-noise ratio
         margin of the Robust Overhead Channel (ROC) in the direction
         of transmission.
         The format is identical to the format of the line status
         parameter Signal-to-Noise Ratio Margin (SNRM). The SNRM-ROC
         ranges from -64 dB to +63 dB, with 0.1 dB steps. A special
         value (enum out-of-range) indicates the parameter is out of
         range to be represented.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.35.1 (SNRM-ROC-ds), 7.5.1.35.2
          (SNRM-ROC-us) and 7.5.1.13 (SNRM)";

      }

      leaf stamp-olr {
        type time-stamp-or-undefined;
        description
          "This parameter indicates the date/time of the last
         successful On-Line Reconfiguration (OLR) execution in the
         direction of transmission that has modified the bits or
         gains. This date/time-stamp will include information on the
         Year, Month, Day, Hour, Minute and Second of the last OLR.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.37.1 (STAMP-OLR-ds) and
          7.5.1.37.2 (STAMP-OLR-us)";

      }

      leaf actual-ripolicy {
        type enumeration {
          enum "0" {
            value 0;
            description
              "Re-Initialization Policy (RIPOLICY) 0.";
          }
          enum "1" {
            value 1;
            description
              "Re-Initialization Policy (RIPOLICY) 1.";
          }
        }
        description
          "This parameter indicates the actual Re-Initialization Policy
         (RIPOLICY) in use in the direction of transmission.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.40.1 (ACTRIPOLICYds) and
          7.5.1.40.2 (ACTRIPOLICYus)";

      }

      leaf rtx-used {
        type enumeration {
          enum "1" {
            value 0;
            description
              "Retransmission (RTX) in use.";
          }
          enum "2" {
            value 1;
            description
              "Retransmission (RTX) not in use, due to RTX_MODE =
             FORBIDDEN.";
          }
          enum "3" {
            value 2;
            description
              "Retransmission (RTX) not in use, due to not supported by
             the XTU-C.";
          }
          enum "4" {
            value 3;
            description
              "Retransmission (RTX) not in use, due to not supported by
             the XTU-R.";
          }
          enum "5" {
            value 4;
            description
              "Retransmission (RTX) not in use, due to not supported by
             the XTU-C and XTU-R.";
          }
        }
        description
          "This parameter specifies whether ITU-T G.998.4 Retransmission
         (RTX) is used (i.e., active in showtime) in a given transmit
         direction. In ITU-T G.992.3 and ITU-T G.992.5 only the
         downstream parameter RTX_USED is relevant and the value in
         the upstream direction is ignored. In ITU-T G.993.2, both
         parameters are relevant.";
        reference
          "ITU-T G.997.1 clause 7.5.1.38 (RTX_USED)";

      }

      leaf attndr-actual-inp {
        type uint16 {
          range "0..2046 | 2047";
        }
        units "0.1 symbols";
        description
          "If retransmission is not used in the direction of
         transmission, this parameter indicates the actual impulse
         noise protection used in the improved calculation of the
         Attainable Net Data Rate (ATTNDR) in the direction of
         transmission.
         If retransmission is used in the direction of transmission,
         this parameter indicates the actual impulse noise protection
         against Single High Impulse Noise Event (SHINE) used in the
         improved calculation of the ATTNDR in the direction of
         transmission.
         The value is coded in fractions of Discrete Multi-Tone (DMT)
         symbols with a granularity of 0.1 symbols. The range is from
         0 to 204.6. A special value of 2047 indicates an Actual
         Impulse Noise Protection (ACTINP) of 204.7 or higher.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.41.2 (ATTNDR_ACTINPds) and
          7.5.1.41.3 (ATTNDR_ACTINPus)";

      }

      leaf attndr-actual-inp-rein {
        type uint8 {
          range "0..254 | 255";
        }
        units "0.1 symbols";
        description
          "If retransmission is used in the direction of transmission,
         this parameter reports the actual impulse noise protection
         (INP) against Repetitive Electrical Impulse Noise (REIN) used
         in the improved calculation of the Attainable Net Data Rate
         (ATTNDR) in the direction of transmission.
         The value is coded in fractions of Discrete Multi-Tone (DMT)
         symbols with a granularity of 0.1 symbols. The value is coded
         in fractions of DMT symbols with a granularity of 0.1
         symbols. The range is from 0 to 25.4. A special value of 255
         indicates an ATTNDR_ACTINP_REIN of 25.5 or higher.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.41.4 (ATTNDR_ACTINP_REINds) and
          7.5.1.41.5 (ATTNDR_ACTINP_REINus)";

      }

      leaf attndr-actual-delay {
        type uint8 {
          range "0..254 | 255";
        }
        units "0.1 milliseconds";
        description
          "This parameter indicates the actual delay used in the
         improved calculation of the Attainable Net Data Rate (ATTNDR)
         in the direction of transmission. The value is coded in with
         a granularity of 0.1 milliseconds. The range is from 0 to
         25.4 milliseconds. A special value of 255 indicates an actual
         delay of 25.5 milliseconds or higher.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.41.6 (ATTNDR_ACTDELAYds) and
          7.5.1.41.7 (ATTNDR_ACTDELAYus)";

      }

      leaf snr-margin {
        type union {
          type int16 {
            range "-640..630";
          }
          type enumeration {
            enum "out-of-range" {
              value 0;
              description
                "Indicates that the value is out of range to
               be represented.";
            }
          }
        }
        units "0.1 dB";
        description
          "The Signal-to-Noise Ratio (SNR) margin is the maximum
         increase, in dB, of the noise power received at the
         receiver, such that the Bit Error Rate (BER) requirements are
         met for all bearer channels (SNRMds for xDSL Transceiver
         Unit - Remote side (xTU-R) / SNRMus for xDSL Transceiver
         Unit - Central office (xTU-C)). The SNR margin ranges from
         -64 dB to +63 dB, with 0.1 dB steps. A special value (enum
         out-of-range) indicates the parameter is out of range to be
         represented.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.13 (SNRMds) and 7.5.1.16
          (SNRMus)";

      }
    }  // grouping xtu-line-status-receiver-directional

    grouping xtu-line-status-transmitter-directional {
      description
        "Directional line status for transmitter.";
      leaf last-transmitted-state {
        type uint8;
        description
          "This parameter represents the last successful transmitted
         initialization state known by the transmitter in the last
         full initialization performed on the line (Downstream for
         xDSL Transceiver Unit - Central office (xTU-C) / Upstream for
         xDSL Transceiver Unit - Remote side (xTU-R)). Initialization
         states are defined in the individual xDSL Recommendations and
         are counted from 0 (if ITU-T G.994.1 is used) or 1 (if
         ITU-T G.994.1 is not used) up to showtime. This parameter
         will be interpreted along with the xDSL transmission system.
         This parameter is available only when, after a failed full
         initialization, the loop diagnostic procedures are activated
         on the line. Loop diagnostic procedures can be activated by
         the operator of the system (through the line state forced
         line configuration parameter) or autonomously by the xTU-C or
         xTU-R.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.7 and 7.5.1.8";

      }

      leaf actual-psd {
        type union {
          type int16 {
            range "-900..0";
          }
          type enumeration {
            enum "out-of-range" {
              value 0;
              description
                "Indicates that the parameter is out of range to be
               represented.";
            }
          }
        }
        units "0.1 dB";
        description
          "This parameter is the average transmit Power Spectral Density
         (PSD) over the used subcarriers (subcarriers to which user
         data are allocated) delivered by the xDSL Transceiver Unit -
         Central office (xTU-C) at the U-C reference point (ACTPSDds),
         or delivered by the xDSL Transceiver Unit - Unit - Remote
         side (xTU-R) at the U-R reference point (ACTPSDus), at the
         instant of measurement. The PSD level ranges from -90 dBm per
         Hz to 0 dBm per Hz, with 0.1 dB steps. A special value (enum
         out-of-range) indicates the parameter is out of range to be
         represented.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.21 (ACTPSDds) and 7.5.1.22
          (ACTPSDus);
          ITU-T G.992.3 clause 8.5.1";

      }

      leaf actual-aggregate-transmit-power {
        type union {
          type int16 {
            range "-310..310";
          }
          type enumeration {
            enum "out-of-range" {
              value 0;
              description
                "Indicates that the parameter is out of range to be
               represented.";
            }
          }
        }
        units "0.1 dB";
        description
          "This parameter is the total amount of transmit power
         delivered by the xDSL Transceiver Unit - Central office
         (xTU-C) at the U-C reference point (ACTPSDds), or by the xDSL
         Transceiver Unit - Remote side (xTU-R) at the U-R reference
         point (ACTPSDus), at the instant of measurement. The total
         output power level ranges from -31 dBm to +31 dBm, with
         0.1 dB steps. A special value (enum out-of-range) indicates
         the parameter is out of range to be represented.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.24 (ACTATPds) and 7.5.1.25
          (ACTATPus);
          ITU-T G.992.3 clause 8.12.3.8;
          ITU-T G.993.2 clause 10.3.4.2.1";

      }

      leaf aggachndr {
        type bbf-yang:data-rate32-or-undetermined;
        description
          "This parameter reports the aggregate achievable net data
         rate of the (Near-end) VDSL Transceiver Unit - central Office
         (VTU-O) or (Far-end) VDSL Transceiver Unit - Remote side
         (VTU-R) as specified in G.998.4. The value is coded in step
         of 1000 bits per second. A special value indicates that the
         aggregate achievable net data rate value is reported as being
         undetermined.";
        reference
          "ITU-T G.997.1 clauses 7.5.1.42.1 (AGGACHNDR_NE) and
          7.5.1.42.2 (AGGACHNDR_FE)";

      }
    }  // grouping xtu-line-status-transmitter-directional

    grouping xtu-c-status {
      description
        "xDSL Transceiver Unit - Central office (xTU-C) line status.
       This represents transmission in the upstream direction.";
      leaf stamp-test-ne {
        type time-stamp-or-undefined;
        description
          "This parameter is defined in the Access Node Management
         Information Base (AN MIB) and indicates the date/time when
         the near-end test parameters that can change during showtime
         were last updated. This date/time-stamp will include
         information on the Year, Month, Day, Hour, Minute and Second
         of the last update.";
        reference
          "ITU-T G.997.1 clause 7.5.1.36.3 (STAMP-TEST-NE)";

      }

      container failures {
        description
          "xDSL Transceiver Unit - Central office (xTU-C) line
         failures.";
        uses xtu-c-line-failure-parameters;
      }  // container failures

      container downstream {
        description
          "Downstream xDSL Transceiver Unit (xTU) status.";
        uses xtu-line-status-transmitter-directional;
      }  // container downstream

      container upstream {
        description
          "Upstream xDSL Transceiver Unit (xTU) status.";
        uses xtu-line-status-receiver-directional;
      }  // container upstream
    }  // grouping xtu-c-status

    grouping xtu-r-status {
      description
        "xDSL Transceiver Unit - Remote side (xTU-R) line status. This
       represents transmission in the downstream direction.";
      leaf stamp-test-fe {
        type time-stamp-or-undefined;
        description
          "This parameter is defined in the Access Node Management
         Information Base (AN MIB) and indicates the date/time when
         the far-end test parameters that can change during showtime
         were last updated. This date/time-stamp will include
         information on the Year, Month, Day, Hour, Minute and Second
         of the last update.";
        reference
          "ITU-T G.997.1 clause 7.5.1.36.4 (STAMP-TEST-FE)";

      }

      container failures {
        description
          "xDSL Transceiver Unit - Remote side (xTU-R) line failures.";
        uses xtu-r-line-failure-parameters;
      }  // container failures

      container downstream {
        description
          "Downstream xDSL Transceiver Unit (xTU) status.";
        uses xtu-line-status-receiver-directional;
      }  // container downstream

      container upstream {
        description
          "Upstream xDSL Transceiver Unit (xTU) status.";
        uses xtu-line-status-transmitter-directional;
      }  // container upstream
    }  // grouping xtu-r-status
  }  // submodule bbf-vdsl-xtu-line-status-body