bbf-selt-processing-derived-parameter-body

This submodule contains a collection of YANG definitions for Single Ended Line Test Processing (SELT-P) derived parameters. Cop...

  • Version: 2022-05-23

    bbf-selt-processing-derived-parameter-body@2022-05-23


    
      submodule bbf-selt-processing-derived-parameter-body {
    
        yang-version 1.1;
    
        belongs-to bbf-selt {
            prefix bbf-selt;
        }
    
        import bbf-yang-types {
          prefix bbf-yang;
        }
    
        include bbf-selt-pmd-measurement-parameter-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
         Single Ended Line Test Processing (SELT-P) derived parameters.
    
         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-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>";
    
        }
    
    
        feature extended-bandwidth-selt-tflog {
          description
            "Indicates support for extended bandwidth Single Ended Line Test
           (SELT) for reporting the logarithmic power transfer function
           Tflog(f).";
        }
    
        typedef per-sub-carrier-uint16 {
          type binary {
            length "0..16384";
          }
          description
            "A binary type where each pair of octets represents data
           belonging to a sub-carrier group. The first pair represents
           sub-carrier group 0 and the last represents sub-carrier
           group (length/2 - 1).";
        }
    
        grouping downstream-upstream-derived-parameters {
          description
            "Derived parameters that are common between the downstream and
           upstream directions.";
          leaf capacity-estimate {
            type bbf-yang:data-rate32;
            description
              "This parameter represents a best-effort estimate of the
             achievable net data rate (in kilobits per second) on the loop
             under test, under the following assumptions:
    
             - Fast mode (i.e., operation with interleaver depth D=1, and
               INP=0 (no impulse noise protection))
             - use of Trellis coding
             - target margin equal to CAP-TARSNRM (see clause B.2.1.4)
             - transmit signal PSD at the U-interface of the
               xTU-transmitter equal to CAP-SIGNALPSD
             - noise PSD at the U-interface of the xTU-receiver equal to
               CAP-NOISEPSD
             - support of bit loading from 1 to 15 bits included, in
               steps of 1 bit increments.
    
             As the capacity is a best-effort estimate, accuracy for this
             parameter is vendor proprietary. The parameter in the
             downstream direction is CAPACITYds, and the parameter in the
             upstream direction is CAPACITYus.";
            reference
              "ITU-T G.996.2 clauses B.2.1.2, B.2.1.3 and B.2.2.7
              (CAP-EST)";
    
          }
        }  // grouping downstream-upstream-derived-parameters
    
        grouping processing-derived-parameters {
          description
            "Defines the Single Ended Line Test Processing (SELT-P) derived
           parameters.";
          leaf loop-termination-indicator {
            type enumeration {
              enum "open" {
                value 0;
                description "Open.";
              }
              enum "short" {
                value 1;
                description "Short.";
              }
              enum "powered-by-cpe" {
                value 2;
                description
                  "Powered on Customer Premises Equipment (CPE).";
              }
              enum "unknown" {
                value 3;
                description
                  "Unknown (i.e., failure in identifying the termination).";
              }
            }
            description
              "Loop termination indicator is a three state indication of
             the loop termination defined as follows.
    
             1) Open
             2) Short
             3) Powered on CPE
             4) Unknown (i.e., failure in identifying the termination).";
            reference
              "ITU-T G.996.2 clause B.2.2.1 (LOOP-TERM)";
    
          }
    
          leaf loop-length {
            type uint16 {
              range "0..16383";
            }
            units "meters";
            description
              "This parameter is the physical length (in metres) of the
             loop between the U-C and the U-R interface. The loop length
             shall be measured with a granularity of 1 meter, with valid
             range of 0 to 16383 meters.";
            reference
              "ITU-T G.996.2 clause B.2.2.2 (LOOP-LEN)";
    
          }
    
          container loop-topology {
            description
              "The loop topology consists of a description of the loop
             structure, with indication of the physical length of each
             loop segment. In this parameter, a loop segment is defined
             as delimited by either a loop termination, or the presence
             of a bridged tap.
    
             NOTE 1 - Two cables with different gauges/cable-types
                      connected in series are considered as a single loop
                      segment.
    
             The loop topology is reported as a list of loop segments,
             using the following conventions:
    
             1) The first loop segment in the list shall be the segment
                connected to the Single Ended Line Test Physical Medium
                Dependent (SELT-PMD) block measuring the SELT-PMD
                measurement parameters (i.e., the SELT-PMD block shall be
                the starting point of the topology description).
             2) Subsequent loop segments in the list shall describe the
                loop in the direction toward the farend loop termination.
             3) Consecutive loop segments indicated as 'bridged tap'
                represent bridged taps, each branching off from the main
                loop at the same point.
    
             NOTE 2 - Identification of a bridged tap branching off on a
                      bridged tap is not supported by this parameter.
                      A single loop segment is specified with two
                      sub-parameters: loop segment length (see clause
                      B.1.1.3.1) and loop segment bridged tap indicator
                      (see clause B.1.1.3.2).
    
             If this parameter is supported, reporting of up to three
             segments is a mandatory capability. Reporting of additional
             segments is optional.";
            reference
              "ITU-T G.996.2 clause B.2.2.3 (LOOP-TOPOLOGY)";
    
            list loop {
              key "i";
              description
                "A list of loop segments including the length and whether
               there is a bridged tap.";
              leaf i {
                type uint8;
                description
                  "The segment number. The first loop segment in the list
                 shall be the segment connected to the Single Ended Line
                 Test Physical Medium Dependent (SELT-PMD) block measuring
                 the SELT-PMD measurement parameters (i.e., the SELT-PMD
                 block shall be the starting point of the topology
                 description). Subsequent loop segments in the list shall
                 shall describe the loop in the direction toward the
                 far-end loop termination.";
              }
    
              leaf len {
                type uint16 {
                  range "0..16383";
                }
                units "meters";
                description
                  "This parameter specifies the physical length of the loop
                 segment, in metres. The loop segment length shall be
                 measured with a granularity of 1 meter, with a valid
                 range of 0 to 16383 meters.";
                reference
                  "ITU-T G.996.2 clause B.1.1.3.1 (LOOP_SEGM_LENGTH)";
    
              }
    
              leaf bti {
                type enumeration {
                  enum "in-series" {
                    value 0;
                    description "In series.";
                  }
                  enum "bridged-tap" {
                    value 1;
                    description "Bridged tap.";
                  }
                }
                description
                  "This parameter specifies whether the loop segment is a
                 bridged tap or arranged in series (i.e., not branching,
                 not a bridged tap).
    
                 The valid values are:
    
                 1) in series
                 2) bridged tap.";
                reference
                  "ITU-T G.996.2 clause B.1.1.3.1 (LOOP_SEGM_LENGTH)";
    
              }
            }  // list loop
          }  // container loop-topology
    
          container attenuation-characteristics {
            description
              "The line attenuation TFlog(f) is the logarithmic power
             transfer function of the line as a function of frequency
             when both the near-end and far-end line terminations have
             the following values:
    
             - Source impedance = purely resistive equal to 100 ohms
             - Termination impedance = purely resistive equal to 100 ohms
    
             The definition for reporting the line attenuation TFlog(f)
             depends on whether or not the option for extended bandwidth
             Single Ended Line Test (SELT) is applied.
    
             The function TFlog(f) consists of an array of values
             TFlog(i * TFlog_G * Df), with Df = 4.3125 kHz.
    
             NOTE - In the case where the instantiation of the LT unit is
                    the same as the instantiation of the xTU transceiver
                    unit, this value may be independent of the subcarrier
                    spacing used for the xDSL DMT modulation.
    
             The range of valid values for the index i is 0 to 8191.
    
             The attenuation characteristics group size, TFlog_G, has
             three valid values: 1, 2, and 12, indicating whether the
             measurements were performed using a subcarrier spacing of
             4.3125 kHz, 8.625 kHz, or 51.75 kHz respectively.
    
             The range of valid values for TFlog(i * Df) is from +6.0 dB
             down to -96.2 dB, with a granularity of 0.1 dB (represented
             as values 0 to 1022). A special value, 1023, is used to
             indicate that no measurement could be done for this
             subcarrier because the attenuation is out of the range that
             can be represented.";
            reference
              "ITU-T G.996.2 clause B.2.2.6 (ATT-CHAR)";
    
            leaf tflog-g {
              type uint8 {
                range "1 | 2 | 12";
              }
              description
                "The attenuation characteristics group size (TFlog_G) is a
               reported parameter identifying the attenuation
               characteristics, TFlog(f), at a frequency spacing equal to
               TFlog_G x Df with Df = 4.3125 kHz. TFlog_G has three valid
               values: 1, 2, and 12.";
            }
    
            leaf tflog {
              type per-sub-carrier-uint16;
              description
                "An array of values for Tflog(f).";
            }
          }  // container attenuation-characteristics
    
          leaf missing-micro-filter {
            type boolean;
            description
              "This parameter is a binary indication of a missing or
             incorrectly installed splitter or micro-filter at the U-R
             reference point. A value of 'true' for this flag represents a
             missing splitter. This parameter is only defined for the
             SELT-P-R functionality.";
            reference
              "ITU-T G.996.2 clause B.2.2.4 (MIS-FILTER)";
    
          }
    
          container downstream {
            description
              "Managed data nodes applicable in the downstream direction.";
            uses downstream-upstream-derived-parameters;
          }  // container downstream
    
          container upstream {
            description
              "Managed data nodes applicable in the upstream direction.";
            uses downstream-upstream-derived-parameters;
          }  // container upstream
        }  // grouping processing-derived-parameters
      }  // submodule bbf-selt-processing-derived-parameter-body
    

© 2023 YumaWorks, Inc. All rights reserved.