module DOCS-IF31-MIB {

    yang-version 1;

    namespace
      "urn:ietf:params:xml:ns:yang:smiv2:DOCS-IF31-MIB";

    prefix DOCS-IF31-MIB;

    import DOCS-IF-MIB {
      prefix docs-if;
    }
    import DOCS-IF3-MIB {
      prefix docs-if3;
    }
    import IF-MIB {
      prefix if-mib;
    }
    import SNMPv2-TC {
      prefix snmpv2-tc;
    }
    import ietf-yang-smiv2 {
      prefix smiv2;
    }
    import ietf-yang-types {
      prefix yang;
    }

    organization
      "Cable Television Laboratories, Inc.";

    contact
      "
    Postal: Cable Television Laboratories, Inc.
    858 Coal Creek Circle
    Louisville, Colorado 80027-9750
    U.S.A.
    Phone: +1 303-661-9100
    Fax:   +1 303-661-9199
    E-mail: mibs@cablelabs.com";

    description
      "This MIB module contains the management objects for the
    management of DOCSIS 3.1 features, primarily OFDM and OFDMA
    channels.
    Copyright 2017 Cable Television Laboratories, Inc.
    All rights reserved.";

    revision "2017-07-27" {
      description
        "Revised per ECN DOCS-IF31-MIB-N-17.1765-1
      for changing docsIf31RxChStatusTable to apply to CM only.
      Only descriptive text is changed.";
    }

    revision "2017-05-25" {
      description
        "Revised Version includes ECN change for diplexer objects
      DOCS-IF31-MIB-N-17.1733-1";
    }

    revision "2016-12-15" {
      description
        "Revised Version includes ECN
      DOCS-IF31-MIB-N-16.1621-3.";
    }

    revision "2016-08-18" {
      description
        "Revised Version includes ECN
      DOCS-IF31-MIB-N-16.1549-3.";
    }

    revision "2016-05-05" {
      description
        "Revised Version includes ECN
      CCAP-OSSIv3.1-N-16.1472-4;
      supersedes CCAP-OSSIv3.1-N-16.1432-3.";
    }

    revision "2015-11-04" {
      description
        "Revised per CM-OSSIv3.1-N-15.1385-3,
      which rolls up changes from the following ECNs:
      CM-OSSIv3.1-N-15.1375-1 and CCAP-OSSIv3.1-N-15.1376-1,
      adding additional indices for the
      docsIf31CmUsOfdmaMinislotCfgStateTable per the OSSI-CM spec.";
    }

    revision "2015-07-15" {
      description
        "Revised Version includes ECN
      CCAP-OSSIv3.1-N-15.1324-1";
    }

    revision "2015-05-20" {
      description
        "Revised Version includes ECN
      CCAP-OSSIv3.1-N-15.1308-2
      Synchronized with
      CM-SP-CM-OSSIv3.1-I04 and
      CM-SP-CCAP-OSSIv3.1-I04";
    }

    revision "2015-04-08" {
      description
        "Initial version, per CCAP-OSSIv3.1-N-15.1278-4";
    }

    smiv2:alias "docsIf31CmtsCmRegStatusTable" {
      description "This object defines attributes that represent the CM's
registration status as tracked by the CMTS.
Refer to the individual attribute definitions for
applicability to 3.0 and 3.1 Cable Modems.

This extends the DOCS-IF3-MIB's docsIf3CmtsCmRegStatusTable.";
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3";
    }
    smiv2:alias "docsIf31CmtsCmRegStatusEntry" {
      description "The conceptual row of docsIf31CmtsCmRegStatusTable.";
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1";
    }
    smiv2:alias "docsIf31CmUsScQamChanTable" {
      description "This table describes the attributes of attached upstream
SC-QAM channels for the CM.

This extends the DOCS-IF-MIB's docsIfUpstreamChannelTable.";
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.31";
    }
    smiv2:alias "docsIf31CmUsScQamChanEntry" {
      description "The conceptual row of docsIf31CmUsScQamChanTable.
For DOCSIS 3.1 CMs, an entry in this table exists for each
ifEntry with an ifType of docsCableUpstream (129).";
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.31.1";
    }
    smiv2:alias "docsIf31Mib" {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28";
    }
    smiv2:alias "docsIf31Notifications" {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.0";
    }
    smiv2:alias "docsIf31MibObjects" {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1";
    }
    smiv2:alias "docsIf31CmSystemCfgState" {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18";
    }
    smiv2:alias "docsIf31MibConformance" {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.2";
    }
    smiv2:alias "docsIf31MibCompliances" {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.2.1";
    }
    smiv2:alias "docsIf31MibGroups" {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.2.2";
    }

    typedef ClabsDocsisVersion {
      type enumeration {
        enum "other" {
          value 0;
        }
        enum "docsis10" {
          value 1;
        }
        enum "docsis11" {
          value 2;
        }
        enum "docsis20" {
          value 3;
        }
        enum "docsis30" {
          value 4;
        }
        enum "docsis31" {
          value 5;
        }
      }
      description
        "Indicates the DOCSIS Radio Frequency specification being
      referenced.
      'docsis10' indicates DOCSIS 1.0.
      'docsis11' indicates DOCSIS 1.1.
      'docsis20' indicates DOCSIS 2.0.
      'docsis30' indicates DOCSIS 3.0.
      'docsis31' indicates DOCSIS 3.1.";
    }

    typedef EmIdList {
      type string {
        smiv2:display-hint "2x,";
      }
      description
        "A list of Energy Management Ids displayed as a comma-separated
      list of 15-bit hexadecimal values. These values are encoded into
      16-bits but the high-order bit is always 0.";
    }

    typedef SubcarrierSpacingType {
      type int32 {
        smiv2:display-hint "d";
        range "25|50";
      }
      description
        "This data type defines the subcarrier spacing for the FFT
      mode in use. For downstream OFDM channels, if the FFT mode
      is 4K mode, then spacing is 50 kHz; if it is 8K mode, then
      the spacing is 25 kHz. For upstream OFDMA channels, if the
      FFT mode is 2K mode, then the spacing is 50kHz; if the mode
      is 4K mode, then the spacing is 25kHz. In units of kHz.";
      reference
        "DOCSIS 3.1 Physical Layer Specification CM-SP-PHYv3.1-I03-140610,
        Downstream OFDM Parameters and Upstream OFDMA Parameters tables.";

    }

    typedef PrimaryDsIndicatorType {
      type enumeration {
        enum "other" {
          value 1;
        }
        enum "primary" {
          value 2;
        }
        enum "backupPrimary" {
          value 3;
        }
        enum "nonPrimary" {
          value 4;
        }
      }
      description
        "This data type is defined to represent the channel indicator
      type for the downstream channel.";
    }

    typedef OfdmProfiles {
      type bits {
        bit profile0 {
          position 0;
        }
        bit profile1 {
          position 1;
        }
        bit profile2 {
          position 2;
        }
        bit profile3 {
          position 3;
        }
        bit profile4 {
          position 4;
        }
        bit profile5 {
          position 5;
        }
        bit profile6 {
          position 6;
        }
        bit profile7 {
          position 7;
        }
        bit profile8 {
          position 8;
        }
        bit profile9 {
          position 9;
        }
        bit profile10 {
          position 10;
        }
        bit profile11 {
          position 11;
        }
        bit profile12 {
          position 12;
        }
        bit profile13 {
          position 13;
        }
        bit profile14 {
          position 14;
        }
        bit profile15 {
          position 15;
        }
      }
      description
        "This data type enumerates the configured channel profiles on
      the CM.";
    }

    typedef DsOfdmCyclicPrefix {
      type uint32 {
        smiv2:display-hint "d";
        range "192|256|512|768|1024";
      }
      description
        "This data type is defined to indicate the five possible values
      for the length of cyclic prefix.  This represents the number
      of samples of the 204.8 MHz clock";
    }

    typedef UsOfdmaCyclicPrefix {
      type uint32 {
        smiv2:display-hint "d";
        range
          "96|128|160|192|224|256|288|320|384|512|640";
      }
      description
        "This data type is defined to indicate the eleven possible values
      for the length of cyclic prefix. The cyclic prefix represents the
      number of samples of the 204.8 MHz clock.";
    }

    typedef DsOfdmRollOffPeriod {
      type uint32 {
        smiv2:display-hint "d";
        range "0|64|128|192|256";
      }
      description
        "This data type is defined to indicate the five possible values
      for the windowing roll-off period. This represents the number
      of samples of the 204.8 MHz clock.";
    }

    typedef UsOfdmaRollOffPeriod {
      type uint32 {
        smiv2:display-hint "d";
        range "0|32|64|96|128|160|192|224";
      }
      description
        "This data type is defined to indicate the eight possible values
      for the windowing roll-off period. This represents the number
      of samples of the 204.8 MHz clock";
    }

    typedef TimeInterleaverDepth {
      type uint32 {
        smiv2:display-hint "d";
        range "1..32";
      }
      description
        "This data type is defined to indicate the depth of time
      interleaving used for this downstream channel in symbols.";
    }

    typedef DsOfdmModulationType {
      type enumeration {
        enum "unknownQam" {
          value 0;
        }
        enum "other" {
          value 1;
        }
        enum "zeroValued" {
          value 2;
        }
        enum "qpsk" {
          value 3;
        }
        enum "qam16" {
          value 4;
        }
        enum "qam64" {
          value 5;
        }
        enum "qam128" {
          value 6;
        }
        enum "qam256" {
          value 7;
        }
        enum "qam512" {
          value 8;
        }
        enum "qam1024" {
          value 9;
        }
        enum "qam2048" {
          value 10;
        }
        enum "qam4096" {
          value 11;
        }
        enum "qam8192" {
          value 12;
        }
        enum "qam16384" {
          value 13;
        }
      }
      description
        "This data type is defined to indicate the bit loading of
      subcarriers in an OFDM downstream channel.";
      reference
        "DOCSIS 3.1 Physical layer Specification CM-SP-PHYv3.1-I03-140610,
        Modulation Formats section.";

    }

    typedef UsOfdmaModulationType {
      type enumeration {
        enum "other" {
          value 1;
        }
        enum "zeroValued" {
          value 2;
        }
        enum "bpsk" {
          value 3;
        }
        enum "qpsk" {
          value 4;
        }
        enum "qam8" {
          value 5;
        }
        enum "qam16" {
          value 6;
        }
        enum "qam32" {
          value 7;
        }
        enum "qam64" {
          value 8;
        }
        enum "qam128" {
          value 9;
        }
        enum "qam256" {
          value 10;
        }
        enum "qam512" {
          value 11;
        }
        enum "qam1024" {
          value 12;
        }
        enum "qam2048" {
          value 13;
        }
        enum "qam4096" {
          value 14;
        }
      }
      description
        "This data type is defined to indicate the bit loading of
      subcarriers in an OFDMA upstream channel.";
      reference
        "DOCSIS 3.1 Physical layer Specification CM-SP-PHYv3.1-I03-140610,
        Modulation Formats section.";

    }

    typedef PartialChannelType {
      type bits {
        bit fecErrorsDsProfile {
          position 0;
        }
        bit fecErrorsNcpProfile {
          position 1;
        }
        bit fecErrorsPlc {
          position 2;
        }
      }
      description
        "This data type enumerates each of the possible profiles or channel
      attributes which can contribute to an OFDM channel being considered
      a Partial Channel by the MAC layer. As more than one of these error
      conditions can exist at the same time this data type is based on a
      BITS data type. The bits from low to high are:
              Bit 0: fecErrorsDsProfile
              Bit 1: fecErrorsNcpProfile
              Bit 2: fecErrorsPlc";
      reference
        "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
        Specification CM-SP-MULPIv3.1-I03-140610,
        CM Status Report section.";

    }

    typedef PartialServiceType {
      type enumeration {
        enum "unknown" {
          value 0;
        }
        enum "other" {
          value 1;
        }
        enum "none" {
          value 2;
        }
        enum "partialSvcDsOnlyImpaired" {
          value 3;
        }
        enum "partialSvcUsOnlyImpaired" {
          value 4;
        }
        enum "partialSvcDsAndUsImpaired" {
          value 5;
        }
      }
      description
        "This data type enumerates the type of channel issue which the
      MAC Layer indicates is causing the CM to be in DOCSIS 3.0 Partial
      Service mode. The possible values are as follows:
             other(1)
             none(2)
             partialSvcDsOnlyImpaired(3)
             partialSvcUsOnlyImpaired(4)
             partialSvcDsAndUsImpaired(5)";
      reference
        "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
        Specification CM-SP-MULPIv3.1-I03-140610,
        CM Status Report section.";

    }

    typedef PartialChanReasonType {
      type enumeration {
        enum "none" {
          value 0;
        }
        enum "dsOfdmProfileFailure" {
          value 16;
        }
        enum "dpdMismatch" {
          value 18;
        }
        enum "ncpProfileFailure" {
          value 20;
        }
        enum "plcFailure" {
          value 21;
        }
      }
      description
        "This data type enumerates the CM-STATUS events which
      a CM can utilize to report a Partial Channel situation.";
      reference
        "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
        Specification CM-SP-MULPIv3.1-I03-140610,
        CM Status Report section.";

    }

    typedef PartialSvcReasonType {
      type enumeration {
        enum "none" {
          value 0;
        }
        enum "secondaryChanMddTimeout" {
          value 1;
        }
        enum "lostFecLock" {
          value 2;
        }
      }
      description
        "This data type enumerates the CM-STATUS events which
      a CM can utilize to report a Partial Service situation.";
      reference
        "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
        Specification CM-SP-MULPIv3.1-I03-140610,
        CM Status Report section.";

    }

    typedef HundredthdBmV {
      type int32 {
        smiv2:display-hint "d-2";
      }
      description
        "This data type represents power levels that are normally
      expressed in dBmV.  Units are in hundredths of a dBmV;
      for example, 5.17 dBmV will be represented as 517.";
    }

    typedef HundredthdB {
      type int32 {
        smiv2:display-hint "d-2";
      }
      description
        "This data type represents power levels that are normally
      expressed in dB.  Units are in hundredths of a dB;
      for example, 5.17 dB will be represented as 517.";
    }

    container DOCS-IF31-MIB {
      config false;
      container docsIf31MibObjects {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1";
        leaf docsIf31DocsisBaseCapability {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.1";
          type ClabsDocsisVersion;
          description
            "This attribute reports the DOCSIS capability of the device.
          A CMTS reports its highest supported DOCSIS version while
          a CM reports its supported DOCSIS version.
          
          This attribute replaces docsIfDocsisBaseCapability defined
          in RFC 4546.";
        }
      }  // container docsIf31MibObjects

      container docsIf31CmSystemCfgState {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18";
        leaf docsIf31CmSystemCfgStateDiplexerCapability {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18.1";
          type uint32;
          description
            "This attribute specifies the maximum diplexer upstream upper band edge
          supported by the CM device. This corresponds to the maximum
          capability reported by the CM in the Diplexer Upstream Upper Band Edge
          modem capability.";
          reference
            "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
            Specification CM-SP-MULPIv3.1-I11-xxxxxx,
            Diplexer Upstream Upper Band Edge section.";

        }

        leaf docsIf31CmSystemCfgStateDiplexerCfgBandEdge {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18.2";
          type uint32;
          description
            "This attribute specifies the current configured value for the upstream
          upper band edge of the diplexer in the CM device. This corresponds
          to the Diplexer Upstream Upper Band Edge Configuration reported by the
          CM in its REG-REQ.";
          reference
            "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
            Specification CM-SP-MULPIv3.1-I11-xxxxxx,
            Diplexer Upstream Upper Band Edge Configuration section.";

        }

        leaf docsIf31CmSystemCfgStateDiplexerDsLowerCapability {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18.3";
          type uint32;
          description
            "This attribute specifies the minimum diplexer downstream
          lower band edge supported by the CM device. This corresponds
          to the minimum capability reported by the CM in the Diplexer
          Downstream Lower Band Edge modem capability.";
          reference
            "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
            Specification CM-SP-MULPIv3.1-I11-xxxxxx,
            Diplexer Downstream Lower Band Edge section.";

        }

        leaf docsIf31CmSystemCfgStateDiplexerCfgDsLowerBandEdge {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18.4";
          type uint32;
          description
            "This attribute specifies the current configured value for the
          downstream lower band edge of the diplexer in the CM device. This
          corresponds to the Diplexer Downstream Lower Band Edge Configuration
          reported by the CM in its REG-REQ.";
          reference
            "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
            Specification CM-SP-MULPIv3.1-I11-xxxxxx,
            Diplexer Downstream Lower Band Edge Configuration section.";

        }

        leaf docsIf31CmSystemCfgStateDiplexerDsUpperCapability {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18.5";
          type uint32;
          description
            "This attribute specifies the maximum diplexer downstream
          upper band edge supported by the CM device. This corresponds
          to the maximum capability reported by the CM in the Diplexer
          Downstream Upper Band Edge modem capability.";
          reference
            "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
            Specification CM-SP-MULPIv3.1-I11-xxxxxx,
            Diplexer Downstream Upper Band Edge section.";

        }

        leaf docsIf31CmSystemCfgStateDiplexerCfgDsUpperBandEdge {
          smiv2:max-access "read-only";
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.18.6";
          type uint32;
          description
            "This attribute specifies the current configured value for the
          Downstream upper band edge of the diplexer in the CM device.
          This corresponds to the Diplexer Downstream Upper Band Edge
          Configuration reported by the CM in its REG-REQ.";
          reference
            "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
            Specification CM-SP-MULPIv3.1-I11-xxxxxx,
            Diplexer Downstream Upper Band Edge Configuration section.";

        }
      }  // container docsIf31CmSystemCfgState

      container docsIf31RxChStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.2";
        description
          "The Receive Channel Status object reports the status
        of the statically-configured and dynamically-created
        Receive Channels within an RCC.
        This table is supported by the CM only.";
        list docsIf31RxChStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.2.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31RxChStatusTable.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31RxChStatusPrimaryDsIndicator {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.2.1.1";
            type PrimaryDsIndicatorType;
            description
              "This attribute is used to identify the downstream channel
            as primary, backup primary or non-primary. A value of
            'primary(2)' indicates that OFDM channel is assigned to be the
            CM's primary downstream channel. A value of 'backupPrimary(3)'
            indicates that the OFDM channel is assigned to be the CM's
            backup primary downstream channel. A value of 'nonPrimary(4)'
            indicates the OFDM channel is not assigned to be CM's primary
            or backup primary downstream channel.";
          }

          leaf docsIf31RxChStatusOfdmProfiles {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.2.1.2";
            type OfdmProfiles;
            description
              "This attribute is used to identify the downstream channel
            profiles provisioned on the CM.
            
            Example: A Cable Modem configured with OFDM Profiles 3 and 8
            returns a query response as follows.
            EnumBits: 0001000010000000 or 0x1080.
            
            Default value is 0x0.  The SC-QAM is always reported as
            the default value.";
          }
        }  // list docsIf31RxChStatusEntry
      }  // container docsIf31RxChStatusTable

      container docsIf31CmtsCmUsOfdmaChannelStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4";
        description
          "This object defines current status information of the CM
        on each OFDMA upstream channel, as reported by the CMTS.";
        list docsIf31CmtsCmUsOfdmaChannelStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1";
          key "docsIf3CmtsCmRegStatusId ifIndex";
          description
            "The conceptual row of docsIf31CmtsCmUsOfdmaChannelStatusTable.
          A separate entry exists for every OFDMA channel of every CM
          currently assigned to an OFDMA channel.";
          leaf docsIf3CmtsCmRegStatusId {
            type leafref {
              path "/docs-if3:DOCS-IF3-MIB/docs-if3:docsIf3CmtsCmRegStatusTable/docs-if3:docsIf3CmtsCmRegStatusEntry/docs-if3:docsIf3CmtsCmRegStatusId";
            }
          }

          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsCmUsOfdmaChannelRxPower {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.1";
            type docs-if:TenthdBmV;
            description
              "This attribute is the total received power in a specified
            OFDMA channel, normalized to power in a 1.6 MHz bandwidth, at
            the RF input port of the CMTS for a given CM.";
            reference
              "DOCSIS 3.1 Physical layer Specification CM-SP-PHYv3.1-I03-140610,
              Upstream Channel Power section.";

          }

          leaf docsIf31CmtsCmUsOfdmaChannelMeanRxMer {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.2";
            type HundredthdB;
            description
              "This attribute is the mean of the dB values of the RxMER
            measurements of all active subcarriers. The mean is computed
            directly on the dB values as follows:
            
            Mean = sum of (RxMER dB values) / number of RxMER values";
            reference
              "DOCSIS 3.1 Physical layer Specification CM-SP-PHYv3.1-I03-140610,
              Upstream Receive Modulation Error Ratio (RxMER) Per Subcarrier
              section.";

          }

          leaf docsIf31CmtsCmUsOfdmaChannelStdDevRxMer {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.3";
            type HundredthdB;
            description
              "This attribute is the standard deviation of the dB values of
            the RxMER measurements of all active subcarriers. The standard
            deviation is computed directly on the dB values as follows:
            
            StdDev = sqrt(sum of (RxMER dB vals - RxMER_mean)^2 / # RxMER vals)";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelRxMerThreshold {
            smiv2:defval "2";
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.4";
            type uint32;
            units "percentile";
            description
              "This attribute specifies the percentile (such as 2nd percentile
            or 5th percentile) of all active subcarriers in an OFDM channel
            at which the ThresholdRxMerValue occurs. That is, (Percentile) %
            of the subcarriers have RxMER <= ThresholdRxMerValue.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelThresholdRxMerValue {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.5";
            type HundredthdB;
            description
              "This attribute is the RxMER value corresponding to the specified
            docsIf31CmtsCmUsOfdmaChannelRxMerThreshold percentile value. The
            CCAP sorts the subcarriers in ascending order of RxMER, resulting
            in a post-sorting subcarrier index ranging from 1 to the number of
            active subcarriers. If the percentile value corresponds to a non-
            integer post-sorting subcarrier index, the post-sorting index is
            truncated (floor function is applied); that is, the post-sorting
            index is selected which is the greatest integer less than or equal
            to the corresponding percentile value. For example, if there are
            3677 active subcarriers and the 2nd percentile is specified, the
            CCAP computes floor(3677*0.02) = 73.  That is, the RxMER value of
            the 73rd subcarrier in the sorted list is associated with the 2nd
            percentile.
            This is displayed in hundredth of a dB, but is only accurate to
            a quarter dB.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelThresholdRxMerHighestFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.6";
            type uint32;
            units "Hz";
            description
              "This attribute is the frequency in Hz of the highest-frequency
            subcarrier having RxMER = ThresholdRxMer value.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelMicroreflections {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.7";
            type uint32;
            units "dBc";
            description
              "This attribute represents microreflections received on this
            upstream channel in dBc.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelHighResolutionTimingOffset {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.8";
            type int32;
            units "time tick/(64*256)";
            description
              "This attribute represents the current measured round trip
            time on this CM's upstream channel in units of
            (6.25 microseconds/(64*256)).
            This attribute returns zero if the value is unknown.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelIsMuted {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.9";
            type boolean;
            description
              "This attribute has a value 'true' to indicate that the CM's
            upstream channel has been muted via CM-CTRL-REQ/CM-CTRL-RSP
            message exchange.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelRangingStatus {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.10";
            type docs-if3:RangingState;
            description
              "This attribute denotes the ranging state of the CM.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelCurPartialSvcReasonCode {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.11";
            type PartialSvcReasonType;
            description
              "This attribute returns the current CM-STATUS Event Code which
            indicates the reason that this CM is experiencing Partial Service
            with a bonding group utilizing this upstream OFDMA channel. A
            value of 0 indicates that the CM is not currently experiencing
            Partial Service involving this OFDMA channel.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelLastPartialSvcTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.12";
            type snmpv2-tc:DateAndTime;
            description
              "This attribute returns the date and time when the MAC indicated
            that this CM recovered from its most recent Partial Service
            incident on this upstream OFDMA channel.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelLastPartialSvcReasonCode {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.13";
            type PartialSvcReasonType;
            description
              "This attribute returns the last CM-STATUS Event Code which
            indicates the reason that this CM was experiencing Partial
            Service on this upstream OFDMA channel. (Note: if the CM is
            currently experiencing Partial Service, this is the Event Code
            from the previous Partial Service event.) A value of 0 indicates
            that the CM has not experienced Partial Service involving this
            OFDMA channel during the CCAP's history of this CM.";
          }

          leaf docsIf31CmtsCmUsOfdmaChannelNumPartialSvcIncidents {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.4.1.14";
            type yang:counter32;
            description
              "This attribute returns the number of Partial Service incidents
            the MAC layer has reported for this CM on this upstream OFDMA
            channel.";
          }
        }  // list docsIf31CmtsCmUsOfdmaChannelStatusEntry
      }  // container docsIf31CmtsCmUsOfdmaChannelStatusTable

      container docsIf31CmtsCmUsOfdmaProfileStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.5";
        description
          "This object defines current status information of the CM on
        each OFDMA upstream channel profile, as reported by the CMTS.";
        list docsIf31CmtsCmUsOfdmaProfileStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.5.1";
          key "docsIf3CmtsCmRegStatusId ifIndex docsIf31CmtsUsOfdmaStatsIuc";
          description
            "The conceptual row of docsIf31CmtsCmUsOfdmaProfileStatusTable.
          A separate entry exists for every Data IUC assigned to the CM
          for every OFDMA channel of every CM currently assigned to an
          OFDMA channel.";
          leaf docsIf3CmtsCmRegStatusId {
            type leafref {
              path "/docs-if3:DOCS-IF3-MIB/docs-if3:docsIf3CmtsCmRegStatusTable/docs-if3:docsIf3CmtsCmRegStatusEntry/docs-if3:docsIf3CmtsCmRegStatusId";
            }
          }

          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsUsOfdmaStatsIuc {
            type leafref {
              path "/DOCS-IF31-MIB:DOCS-IF31-MIB/DOCS-IF31-MIB:docsIf31CmtsUsOfdmaDataIucStatsTable/DOCS-IF31-MIB:docsIf31CmtsUsOfdmaDataIucStatsEntry/DOCS-IF31-MIB:docsIf31CmtsUsOfdmaStatsIuc";
            }
          }

          leaf docsIf31CmtsCmUsOfdmaProfileTotalCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.5.1.1";
            type yang:counter64;
            description
              "This attribute represents the count of the total number
            of FEC codewords received from the CM on this Profile/Data
            IUC for this upstream OFDMA channel.
            
            Discontinuities in the value of this counter can occur at
            re-initialization of the managed system, and at other times
            as indicated by the value of ifCounterDiscontinuityTime for
            the associated upstream OFDMA channel";
          }

          leaf docsIf31CmtsCmUsOfdmaProfileCorrectedCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.5.1.2";
            type yang:counter64;
            description
              "This attribute represents the count of codewords received
            that failed the pre-decoding syndrome check, but passed the
            post-decoding syndrome check from the CM on this Profile/Data
            IUC for this upstream OFDMA channel.
            
            Discontinuities in the value of this counter can occur at
            re-initialization of the managed system, and at other times
            as indicated by the value of ifCounterDiscontinuityTime for
            the associated upstream OFDMA channel.";
          }

          leaf docsIf31CmtsCmUsOfdmaProfileUnreliableCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.5.1.3";
            type yang:counter64;
            description
              "This attribute represents the count of codewords that
            failed the post-decoding syndrome check received from the
            CM on this Profile/Data IUC for this upstream OFDMA channel.
            
            Discontinuities in the value of this counter can occur at
            re-initialization of the managed system, and at other times
            as indicated by the value of ifCounterDiscontinuityTime for
            the associated upstream OFDMA channel.";
          }
        }  // list docsIf31CmtsCmUsOfdmaProfileStatusEntry
      }  // container docsIf31CmtsCmUsOfdmaProfileStatusTable

      container docsIf31CmtsCmDsOfdmChannelStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.6";
        description
          "This object defines current status information of the CM
        on each OFDM downstream channel, as reported by the CMTS.
        A separate entry exists for every OFDM channel of every CM
        currently assigned to an OFDM channel.";
        list docsIf31CmtsCmDsOfdmChannelStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.6.1";
          key "docsIf3CmtsCmRegStatusId ifIndex";
          description
            "The conceptual row of docsIf31CmtsCmDsOfdmChannelStatusTable.
          If the CM has never experienced a partial service or partial
          channel event with respect to this channel since the last CCAP
          reinitialization, no entry should exist in this table.";
          leaf docsIf3CmtsCmRegStatusId {
            type leafref {
              path "/docs-if3:DOCS-IF3-MIB/docs-if3:docsIf3CmtsCmRegStatusTable/docs-if3:docsIf3CmtsCmRegStatusEntry/docs-if3:docsIf3CmtsCmRegStatusId";
            }
          }

          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsCmDsOfdmChannelCurPartialSvcReasonCode {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.6.1.1";
            type PartialSvcReasonType;
            description
              "This attribute returns the current CM-STATUS Event Code
            which indicates the reason that this CM is experiencing
            Partial Service with a bonding group utilizing this downstream
            OFDM channel. A value of 0 indicates that the CM is not
            currently experiencing Partial Service involving this OFDM channel.";
          }

          leaf docsIf31CmtsCmDsOfdmChannelLastPartialSvcTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.6.1.2";
            type snmpv2-tc:DateAndTime;
            description
              "This attribute returns the date and time when the MAC
            indicated that this CM recovered from its most recent
            Partial Service incident on this downstream OFDM channel.";
          }

          leaf docsIf31CmtsCmDsOfdmChannelLastPartialSvcReasonCode {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.6.1.3";
            type PartialSvcReasonType;
            description
              "This attribute returns the last CM-STATUS Event Code which
            indicates the reason that this CM was experiencing Partial
            Service on this downstream OFDM channel. (Note: if the CM is
            currently experiencing Partial Service, this is the Event Code
            from the previous Partial Service event.)
            
            A value of 0 indicates that the CM has not experienced Partial
            Service involving this OFDM channel during the CCAP's history
            of this CM.";
          }

          leaf docsIf31CmtsCmDsOfdmChannelNumPartialSvcIncidents {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.6.1.4";
            type yang:counter32;
            description
              "This attribute returns the number of Partial Service incidents
            the MAC layer has reported for this CM on this downstream OFDM
            channel";
          }

          leaf docsIf31CmtsCmDsOfdmChannelNumPartialChanIncidents {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.6.1.5";
            type yang:counter32;
            description
              "This attribute returns the number of Partial Channel incidents
            the MAC layer has reported for this CM on this downstream OFDM
            channel";
          }
        }  // list docsIf31CmtsCmDsOfdmChannelStatusEntry
      }  // container docsIf31CmtsCmDsOfdmChannelStatusTable

      container docsIf31CmtsCmDsOfdmProfileStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.7";
        description
          "This object defines current status information of the CM on
        each OFDM downstream channel profile, as reported by the CMTS.";
        list docsIf31CmtsCmDsOfdmProfileStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.7.1";
          key "docsIf3CmtsCmRegStatusId ifIndex docsIf31CmtsDsOfdmStatsProfId";
          description
            "The conceptual row of docsIf31CmtsCmDsOfdmProfileStatusTable.
          A separate entry exists for every Profile assigned to the CM
          for every OFDM channel of every CM currently assigned to an
          OFDM channel.
          If the CM has never experienced a partial channel event with
          respect to this profile since the last CCAP reinitialization,
          no entry should exist in the table.";
          leaf docsIf3CmtsCmRegStatusId {
            type leafref {
              path "/docs-if3:DOCS-IF3-MIB/docs-if3:docsIf3CmtsCmRegStatusTable/docs-if3:docsIf3CmtsCmRegStatusEntry/docs-if3:docsIf3CmtsCmRegStatusId";
            }
          }

          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsDsOfdmStatsProfId {
            type leafref {
              path "/DOCS-IF31-MIB:DOCS-IF31-MIB/DOCS-IF31-MIB:docsIf31CmtsDsOfdmProfileStatsTable/DOCS-IF31-MIB:docsIf31CmtsDsOfdmProfileStatsEntry/DOCS-IF31-MIB:docsIf31CmtsDsOfdmStatsProfId";
            }
          }

          leaf docsIf31CmtsCmDsOfdmProfilePartialChanReasonCode {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.7.1.1";
            type PartialChanReasonType;
            description
              "This attribute returns the current CM-STATUS Event Code
            which indicates the reason that this CM is in a Partial
            Channel state utilizing this Profile on this downstream
            OFDM channel. A value of 0 indicates that the CM is not
            currently experiencing Partial Channel involving this
            Profile on this OFDM channel.";
          }

          leaf docsIf31CmtsCmDsOfdmProfileLastPartialChanTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.7.1.2";
            type snmpv2-tc:DateAndTime;
            description
              "This attribute returns the date and time when the MAC
            indicated that this CM recovered from its most recent
            Partial Channel incident for this Profile on this downstream
            OFDM channel.";
          }

          leaf docsIf31CmtsCmDsOfdmProfileLastPartialChanReasonCode {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.7.1.3";
            type PartialChanReasonType;
            description
              "This attribute returns the last CM-STATUS Event Code
            which indicates the reason that this CM was experiencing
            a Partial Channel event for this Profile on this downstream
            OFDM channel. A value of 0 indicates that the CM has not
            experienced a Partial Channel incident involving this Profile
            on this OFDM channel during the CCAP's history of this CM.";
          }
        }  // list docsIf31CmtsCmDsOfdmProfileStatusEntry
      }  // container docsIf31CmtsCmDsOfdmProfileStatusTable

      container docsIf31CmtsCmEmStatsTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.8";
        description
          "This table defines Energy Management mode statistics for the
        CM as reported by the CMTS.  For example, such metrics can
        provide insight into configuration of appropriate EM 1x1 Mode
        Activity Detection thresholds on the CM and/or to get feedback
        on how/if the current thresholds are working well or are
        causing user experience issues.";
        list docsIf31CmtsCmEmStatsEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.8.1";
          key "docsIf3CmtsCmRegStatusId";
          description
            "The conceptual row of docsIf31CmtsCmEmStatsTable.
          
          A row exists in this table for every CM capable of
          Energy Management (either 1x1 or DLS).";
          leaf docsIf3CmtsCmRegStatusId {
            type leafref {
              path "/docs-if3:DOCS-IF3-MIB/docs-if3:docsIf3CmtsCmRegStatusTable/docs-if3:docsIf3CmtsCmRegStatusEntry/docs-if3:docsIf3CmtsCmRegStatusId";
            }
          }

          leaf docsIf31CmtsCmEmStatsEm1x1ModeTotalDuration {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.8.1.1";
            type uint32;
            units "seconds";
            description
              "This attribute indicates the total time duration, in seconds
            since registration, the CM identified by
            docsIf3CmtsCmRegStatusId has been in Energy Management 1x1
            mode, as controlled by the DBC-REQ Energy Management 1x1
            Mode Indicator TLV.";
          }

          leaf docsIf31CmtsCmEmStatsDlsModeTotalDuration {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.8.1.2";
            type uint32;
            units "seconds";
            description
              "This attribute indicates the total time duration, in seconds
            since registration, the CM identified by
            docsIf3CmtsCmRegStatusId has been in DLS mode.";
          }

          leaf docsIf31CmtsCmEmStatsLastDlsTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.8.1.3";
            type snmpv2-tc:DateAndTime;
            description
              "This attribute indicates the time of the last DLS wakeup
            event for this CM. If this CM is currently in DLS mode, then
            this attribute returns 0.";
          }

          leaf docsIf31CmtsCmEmStatsDlsWakeupEvents {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.8.1.4";
            type yang:counter32;
            description
              "This attribute indicates the total number of wakeup events
            that this CM has experienced over the CCAP's history for this CM.";
          }
        }  // list docsIf31CmtsCmEmStatsEntry
      }  // container docsIf31CmtsCmEmStatsTable

      container docsIf31CmDsOfdmChanTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9";
        description
          "This table describes the CM's downstream OFDM channels.";
        list docsIf31CmDsOfdmChanEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmDsOfdmChanTable.
          
          An entry exists in this table for each ifEntry with an
          ifType value of docsOfdmDownstream(277).";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmDsOfdmChanChannelId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.1";
            type int32 {
              range "0..255";
            }
            description
              "The Cable Modem identification of the OFDM downstream channel
            within this particular MAC interface. If the interface is down,
            the object returns the most current value.  If the downstream
            channel ID is unknown, this object returns a value of 0.";
          }

          leaf docsIf31CmDsOfdmChanChanIndicator {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.2";
            type PrimaryDsIndicatorType;
            description
              "This attribute is used to identify the OFDM downstream channel
            as primary, backup primary or non-primary. A value of
            'primary(2)' indicates that OFDM channel is assigned to be the
            CM's primary downstream channel. A value of 'backupPrimary(3)'
            indicates that the OFDM channel is assigned to be the CM's
            backup primary downstream channel. A value of 'nonPrimary(4)'
            indicates the OFDM channel is not assigned to be CM's primary
            or backup primary downstream channel.";
          }

          leaf docsIf31CmDsOfdmChanSubcarrierZeroFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.3";
            type uint32;
            units "Hz";
            description
              "This attribute specifies the center frequency of the
            subcarrier 0 of the OFDM transmission. Note that since
            subcarrier 0 is always excluded, it will actually be below the
            allowed downstream spectrum band. This is the frequency of
            subcarrier X(0) in the definition of the DFT.";
          }

          leaf docsIf31CmDsOfdmChanFirstActiveSubcarrierNum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.4";
            type uint32;
            description
              "This attribute corresponds to the number of the first
            non-excluded subcarrier. The valid range is 148 to 7895";
          }

          leaf docsIf31CmDsOfdmChanLastActiveSubcarrierNum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.5";
            type uint32;
            description
              "This attribute corresponds to the number of the last
            non-excluded subcarrier. The valid range is 148 to 7895";
          }

          leaf docsIf31CmDsOfdmChanNumActiveSubcarriers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.6";
            type uint32;
            description
              "This attribute represents the number of active data
            subcarriers within the OFDM downstream channel (i.e. this
            exclude subcarriers for continuous pilots and the PLC).
            For 4K FFT mode, the maximum number of subcarriers including
            continuous pilots and the PLC cannot exceed 3800, and for
            8K FFT mode, the maximum number of active subcarriers including
            continuous pilots and the PLC cannot be greater than 7600.
            
            However, there are a minimum of 56 continuous pilots in a 192MHz
            channel that has no exclusions, and the size of the PLC is
            8 subcarriers for 4K FFT mode and 16 subcarriers for 8K FFT mode.
            Therefore the maximum value of NumActiveSubcarriers is 3736
            (or 3800 - 56 - 8) for 4K FFT mode and 7528 (or 7600 - 56 - 16)
            for 8K FFT mode.";
          }

          leaf docsIf31CmDsOfdmChanSubcarrierSpacing {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.7";
            type SubcarrierSpacingType;
            units "kHz";
            description
              "This attribute defines the subcarrier spacing associated with
            a particular FFT mode configured on the OFDM downstream
            channel. If it is 4K mode, then the subcarrier spacing is
            50kHz. If it is 8K mode, then the subcarrier spacing is
            25kHz.";
          }

          leaf docsIf31CmDsOfdmChanCyclicPrefix {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.8";
            type DsOfdmCyclicPrefix;
            units "number of samples";
            description
              "Cyclic prefix enables the receiver to overcome the effects of
            inter-symbol-interference and intercarrier-interference caused
            by micro-reflections in the channel. There are five possible
            values for the length of the CP and the choice depends on the
            delay spread of the channel - a longer delay spread requires a
            longer cyclic prefix. The cyclic prefix (in usec) are converted
            into samples using the sample rate of 204.8 Msamples/s and is
            an integer multiple of: 1/64 * 20 us.";
          }

          leaf docsIf31CmDsOfdmChanRollOffPeriod {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.9";
            type DsOfdmRollOffPeriod;
            units "number of samples";
            description
              "Roll off period maximizes channel capacity by sharpening the
            edges of the spectrum of the OFDM signal. For windowing
            purposes another segment at the start of the IDFT output is
            appended to the end of the IDFT output - the roll-off postfix
            (RP). There are five possible values for the (RP), and the
            choice depends on the bandwidth of the channel and the number
            of exclusion bands within the channel. A larger RP provides
            sharper edges in the spectrum of the OFDM signal; however,
            there is a time vs. frequency trade-off. Larger RP values
            reduce the efficiency of transmission in the time domain,
            but because the spectral edges are sharper, more useful
            subcarriers appear in the frequency domain. There is an
            optimum value for the RP that maximizes capacity for a given
            bandwidth and/or exclusion band scenario.";
          }

          leaf docsIf31CmDsOfdmChanPlcFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.10";
            type uint32;
            units "Hz";
            description
              "This is the PHY Link Channel (PLC) frequency. It is the center
            frequency of the lowest frequency subcarrier of the PLC. The
            aim of the PLC is for the CMTS to convey to the CM the
            physical properties of the OFDM channel.";
          }

          leaf docsIf31CmDsOfdmChanNumPilots {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.11";
            type uint32;
            description
              "This attribute indicates the number of continuous pilots configured
            for the OFDM downstream channel as received in the OCD message.";
          }

          leaf docsIf31CmDsOfdmChanTimeInterleaverDepth {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.12";
            type TimeInterleaverDepth;
            units "symbols";
            description
              "The time interleaving used for this downstream channel as
            received in the OCD message.";
          }

          leaf docsIf31CmDsOfdmChanPlcTotalCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.13";
            type yang:counter64;
            description
              "This attribute represents the total number of PLC codewords
            received by the CM.";
          }

          leaf docsIf31CmDsOfdmChanPlcUnreliableCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.14";
            type yang:counter64;
            description
              "This attribute represents the total number of PLC codewords
            which failed post-decoding LDPC syndrome check.";
          }

          leaf docsIf31CmDsOfdmChanNcpTotalFields {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.15";
            type yang:counter64;
            description
              "This attribute represents the total number of NCP fields
            received by the CM.";
          }

          leaf docsIf31CmDsOfdmChanNcpFieldCrcFailures {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.9.1.16";
            type yang:counter64;
            description
              "This attribute represents the total number of NCP fields
            received by the CM which failed the CRC check.";
          }
        }  // list docsIf31CmDsOfdmChanEntry
      }  // container docsIf31CmDsOfdmChanTable

      container docsIf31CmDsOfdmProfileStatsTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10";
        description
          "This CM table specifies the attributes of the Downstream
        profile assigned to an OFDM downstream channel.
        This table is not applicable to NCP profiles.";
        list docsIf31CmDsOfdmProfileStatsEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1";
          key "ifIndex docsIf31CmDsOfdmProfileStatsProfileId";
          description
            "The conceptual row of docsIf31CmDsOfdmProfileStatsTable.
          
          An entry exists in this table for each DS Profile assigned to
          this CM on channels with an ifType value of
          docsOfdmDownstream(277).
          A row entry is created when a profile is assigned. The row
          entry is deleted when a profile id becomes unassigned.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmDsOfdmProfileStatsProfileId {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.1";
            type uint32 {
              range "0..255";
            }
            description
              "This attribute is the unique identifier of the downstream
            profile associated with the OFDM downstream channel. Profile ID
            with a value of 255 corresponds to NCP profile.";
            reference
              "DOCSIS 3.1 MAC and Upper Layer Protocols Interface Specification
              CM-SP-MULPIv3.1-I03-140610, Downstream Profile Descriptor.";

          }

          leaf docsIf31CmDsOfdmProfileStatsConfigChangeCt {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.2";
            type uint32 {
              range "0..255";
            }
            description
              "This attribute contains the value of the Configuration Change
            Count field in the Downstream Profile Descriptor (DPD) MAC
            Management Message corresponding to this profile.";
          }

          leaf docsIf31CmDsOfdmProfileStatsTotalCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.3";
            type yang:counter64;
            description
              "This attribute defines the total number of codewords
            (including full-length and shortened) measured on this profile.";
          }

          leaf docsIf31CmDsOfdmProfileStatsCorrectedCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.4";
            type yang:counter64;
            description
              "This attribute defines the number of codewords measured on this
            profile that failed pre-decoding LDPC syndrome check and passed
            BCH decoding.";
          }

          leaf docsIf31CmDsOfdmProfileStatsUncorrectableCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.5";
            type yang:counter64;
            description
              "This attribute defines the number of codewords measured on this
            profile that failed BCH decoding.";
          }

          leaf docsIf31CmDsOfdmProfileStatsInOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.6";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer octets received
            by the CM on this Profile. This value is the size of all
            unicast, multicast or broadcast frames (including all MAC-
            layer framing) delivered from the Phy to the MAC; this
            includes user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmDsOfdmProfileStatsInUnicastOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.7";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer unicast octets received
            by the CM on this profile. This value is the size of all unicast
            frames (including all MAC-layer framing) delivered from the Phy
            to the MAC; this includes user data, DOCSIS MAC Management
            Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmDsOfdmProfileStatsInMulticastOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.8";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer multicast and broadcast
            octets received by the CM on this profile. This value is the size
            of all frames (including all MAC-layer framing) delivered from the
            Phy to the MAC and addressed to a multicast MAC address;
            this includes user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmDsOfdmProfileStatsInFrames {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.9";
            type yang:counter64;
            description
              "This attribute is the count of frames received by the CM
            on this profile. This value is the count of all unicast,
            multicast or broadcast frames delivered from the Phy to the MAC;
            this includes user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmDsOfdmProfileStatsInUnicastFrames {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.10";
            type yang:counter64;
            description
              "This attribute is the count of frames received by the CM
            on this profile. This value is the count of all unicast,
            multicast or broadcast frames delivered from the Phy to the MAC;
            this includes user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmDsOfdmProfileStatsInMulticastFrames {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.11";
            type yang:counter64;
            description
              "This attribute is the count of multicast frames received
            by the CM on this profile. This value is the count of all
            frames delivered from the Phy to the MAC and addressed to a
            multicast MAC address; this includes user data, DOCSIS MAC
            Management Messages, etc., but excludes frames sent to a
            broadcast address.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmDsOfdmProfileStatsInFrameCrcFailures {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.12";
            type yang:counter64;
            description
              "This attribute defines the number of MAC frames measured on
            this profile that failed the MAC frame CRC check.";
          }

          leaf docsIf31CmDsOfdmProfileStatsCtrDiscontinuityTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.10.1.13";
            type yang:timestamp;
            description
              "This attribute is the value of sysUpTime on the most recent
            occasion at which any one or more of this entry's counters
            suffered a discontinuity. If no such discontinuities have
            occurred since the last re-initialization of the local
            management subsystem, then this attribute contains a zero value.";
          }
        }  // list docsIf31CmDsOfdmProfileStatsEntry
      }  // container docsIf31CmDsOfdmProfileStatsTable

      container docsIf31CmDsOfdmChannelPowerTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.11";
        description
          "This CM object provides measurements of the channel power
        in 6 MHz wide bands at the F connector input of the CM.";
        list docsIf31CmDsOfdmChannelPowerEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.11.1";
          key "ifIndex docsIf31CmDsOfdmChannelBandIndex";
          description
            "The conceptual row of docsIf31CmDsOfdmChannelPowerTable.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmDsOfdmChannelBandIndex {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.11.1.1";
            type uint32;
            description
              "This attribute is a unique index used by the CM to identify
            each of the 6 MHz bands of a given OFDM downstream channel
            (from the lowest 6MHz band of the Occupied Bandwidth to the
            highest 6MHz band of the Occupied Bandwidth). The CM assigns
            indices in frequency order from the OFDM channel's lowest to
            highest 6 MHz frequency band for each of the 6 MHz bands of
            the channel, using an index of 1 to represent the lowest frequency
            band of the Occupied Bandwidth. Thus, an index of 33 represents
            the highest possible 6 MHz frequency band of the Occupied Bandwidth
            of a DOCSIS 3.1 OFDM channel. The CM also provides the power of the
            PLC channel and utilize a value of 0 to represent the PLC
            channel in this table.";
          }

          leaf docsIf31CmDsOfdmChannelPowerCenterFrequency {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.11.1.2";
            type uint32;
            units "Hz";
            description
              "This attribute corresponds to the center frequency of the 6 MHz
            band the CM measured the average channel power.
            
            See Reference for specific details on this attribute.";
            reference
              "DOCSIS 3.1 CM Operations Support System Interface
              Specification CM-SP-CM OSSIv3.1-I03-15MMDD,
              CenterFrequency";

          }

          leaf docsIf31CmDsOfdmChannelPowerRxPower {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.11.1.3";
            type docs-if:TenthdBmV;
            units "TenthdBmV";
            description
              "This attribute provides an estimate of the average power measured
            at the F connector input of the CM in the receive downstream channel
            set for this 6 MHz band.
            
            If the band index is 0, then this attribute provides an
            estimate of the average power measured at the F connector input
            of the CM for a 6 MHz encompassed spectrum containing the
            DOCSIS 3.1 PLC at its center.";
          }
        }  // list docsIf31CmDsOfdmChannelPowerEntry
      }  // container docsIf31CmDsOfdmChannelPowerTable

      container docsIf31CmStatusOfdmaUsTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12";
        description
          "This object defines PHY and MAC information about
        the CM's upstream channels operating in OFDMA mode.
        This object provides per-CM Upstream channel information
        previously available in the table docsIf3CmStatusTable.";
        list docsIf31CmStatusOfdmaUsEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmStatusOfdmaUsTable.
          An instance exist for each of the CM's OFDMA upstream channels
          which are configured for data transmission.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmStatusOfdmaUsT3Timeouts {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12.1.2";
            type yang:counter32;
            units "timeouts";
            description
              "This attribute denotes the number of times counter
            T3 expired in the CM for this upstream channel. Discontinuities
            in the value of this counter can occur at
            re-initialization of the managed system, and at other
            times as indicated by the value of ifCounterDiscontinuityTime
            for the associated upstream channel.";
            reference
              "RFC 2863.";

          }

          leaf docsIf31CmStatusOfdmaUsT4Timeouts {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12.1.3";
            type yang:counter32;
            units "timeouts";
            description
              "This attribute denotes the number of times counter
            T4 expired in the CM for this upstream channel. Discontinuities
            in the value of this counter can occur at
            re-initialization of the managed system, and at other
            times as indicated by the value of ifCounterDiscontinuityTime
            for the associated upstream channel.";
            reference
              "RFC 2863.";

          }

          leaf docsIf31CmStatusOfdmaUsRangingAborteds {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12.1.4";
            type yang:counter32;
            units "attempts";
            description
              "This attribute denotes the number of times the ranging
            process was aborted by the CMTS. Discontinuities
            in the value of this counter can occur at re-initialization
            of the managed system, and at other times as
            indicated by the value of ifCounterDiscontinuityTime
            ([RFC2863]) for the associated upstream channel.";
            reference
              "RFC 2863.";

          }

          leaf docsIf31CmStatusOfdmaUsT3Exceededs {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12.1.5";
            type yang:counter32;
            units "timeouts";
            description
              "This attribute denotes the number of times for excessive
            T3 timeouts. Discontinuities in the value of
            this counter can occur at re-initialization of the managed
            system, and at other times as indicated by the
            value of ifCounterDiscontinuityTime for the associated
            upstream channel.";
            reference
              "RFC 2863.";

          }

          leaf docsIf31CmStatusOfdmaUsIsMuted {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12.1.6";
            type boolean;
            description
              "This attribute denotes whether the upstream
            channel is muted.";
            reference
              "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
              Specification CM-SP-MULPIv3.1-I03-140610 CM Control
              Request section.";

          }

          leaf docsIf31CmStatusOfdmaUsRangingStatus {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.12.1.7";
            type docs-if3:RangingState;
            description
              "This attribute denotes the ranging state of the CM.";
            reference
              "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
              Specification CM-SP-MULPIv3.1-I03-140610 Ranging section.";

          }
        }  // list docsIf31CmStatusOfdmaUsEntry
      }  // container docsIf31CmStatusOfdmaUsTable

      container docsIf31CmUsOfdmaChanTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13";
        description
          "This object specifies the CM upstream OFDMA channel.";
        list docsIf31CmUsOfdmaChanEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmUsOfdmaChanTable.
          An instance exist for the CM OFDMA upstream interface.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmUsOfdmaChanConfigChangeCt {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.1";
            type uint32 {
              range "0..255";
            }
            description
              "This attribute contains the value of the Configuration Change
            Count field in the Upstream Channel Descriptor (UCD) MAC
            Management Message corresponding to this OFDMA channel.";
          }

          leaf docsIf31CmUsOfdmaChanSubcarrierZeroFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.2";
            type uint32;
            units "Hz";
            description
              "This attribute defines the lower edge frequency of the OFDMA
            upstream channel";
          }

          leaf docsIf31CmUsOfdmaChanFirstActiveSubcarrierNum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.3";
            type uint32;
            description
              "This attribute defines the upper edge of the OFDMA upstream
            channel. The minimum channel width for an OFDMA upstream
            channel is 6.4 MHz in 4K mode and 10MHz in 2K mode. The valid
            range is 74 to 3947.";
          }

          leaf docsIf31CmUsOfdmaChanLastActiveSubcarrierNum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.4";
            type uint32;
            description
              "This attribute defines the last active subcarrier number.
            The valid range is 74 to 3947.";
          }

          leaf docsIf31CmUsOfdmaChanNumActiveSubcarriers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.5";
            type uint32;
            description
              "This attribute defines the number of active subcarriers within
            the OFDMA upstream channel. The valid range is 1 to 3800.";
          }

          leaf docsIf31CmUsOfdmaChanSubcarrierSpacing {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.6";
            type SubcarrierSpacingType;
            units "kHz";
            description
              "This attribute defines the subcarrier spacing associated with
            a particular FFT mode configured on the OFDMA upstream
            channel. If it is 2K mode, then the subcarrier spacing is 50kHz.
            If it is 4K mode, then the subcarrier spacing is 25kHz.";
          }

          leaf docsIf31CmUsOfdmaChanCyclicPrefix {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.7";
            type UsOfdmaCyclicPrefix;
            units "number of samples";
            description
              "Cyclic prefix is added in order to enable the receiver to
            overcome the effects of inter-symbol interference (ISI) and
            inter-carrier interference caused by microreflections in the
            channel. The cyclic prefix (in usec) is converted into samples
            using the sample rate of 102.4 Msamples/s. There are eleven
            values for the length of the CP and the choice depends on the
            delay spread of the channel; a longer delay spread requires a
            longer cyclic prefix.";
          }

          leaf docsIf31CmUsOfdmaChanRollOffPeriod {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.8";
            type UsOfdmaRollOffPeriod;
            units "number of samples";
            description
              "Windowing is applied in order to maximize channel capacity
            by sharpening the edges of the spectrum of the OFDMA signal.
            Windowing is applied in the time domain by tapering (or
            rolling off) the edges using a raised cosine function. There
            are eight possible values of roll-off prefix. The Roll-Off
            Period is given in us and in number of samples using the
            sample rate of 102.4 Msamples/s. The configuration where
            Roll-off prefix value is greater than or equal to cyclic
            prefix value is considered invalid.";
          }

          leaf docsIf31CmUsOfdmaChanNumSymbolsPerFrame {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.9";
            type uint32;
            description
              "This attribute is the number of symbol periods per frame.
            For channel bandwidth greater than 72MHz, the maximum number
            of symbol periods per frame is 18 for 2K mode and 9 for 4K
            mode. For channel bandwidth less than 72 MHz but greater than
            48MHz, the maximum number of symbols per frame is 24 for 2K
            mode and 12 for 4K mode. For channel bandwidth less than
            48MHz, the maximum number of symbol periods is 36 for 2K mode
            and 18 for 4K mode. The minimum number of symbol periods per
            frame is 6 for both the FFT modes and is independent of the
            channel bandwidth.";
          }

          leaf docsIf31CmUsOfdmaChanTxPower {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.10";
            type uint32;
            units "QuarterdBmV";
            description
              "This attribute represents the operational transmit power for
            the associated OFDMA upstream channel.The CM reports its Target
            Power, P1.6r_n as described in [PHYv3.1]. Valid values for this
            object are 68 to (213 + (4*(Pmax - 65 dBmV))), since 68 quarter dBmV
            represents the lowest Tx power value 17 dBmV and 213 represents the
            nearest quarter dBmV to the highest Tx power value 53.2 dBmV.";
          }

          leaf docsIf31CmUsOfdmaChanPreEqEnabled {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.11";
            type boolean;
            description
              "This attribute defines whether pre-equalization is enabled on
            the associated OFDMA upstream channel.";
          }

          leaf docsIf31CmUsOfdmaChanChannelId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.13.1.12";
            type uint32 {
              range "0..255";
            }
            description
              "The Cable Modem identification of the OFDMA upstream channel
            within this particular MAC interface. If the interface is down,
            the object returns the most current value.  If the upstream
            channel ID is unknown, this object returns a value of 0.";
          }
        }  // list docsIf31CmUsOfdmaChanEntry
      }  // container docsIf31CmUsOfdmaChanTable

      container docsIf31CmUsOfdmaProfileStatsTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.14";
        description
          "This CM object specifies the attributes of the Upstream
        profile assigned to an OFDM upstream channel.";
        list docsIf31CmUsOfdmaProfileStatsEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.14.1";
          key "ifIndex docsIf31CmUsOfdmaProfileStatsIuc";
          description
            "The conceptual row of docsIf31CmUsOfdmaProfileStatsTable.
          An instance exist for each profile associated with the OFDMA
          upstream interface.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmUsOfdmaProfileStatsIuc {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.14.1.1";
            type uint32;
            description
              "This attribute is the unique identifier of the upstream
            profile/IUC associated with the OFDMA upstream channel. It
            is a key defined to provide an index into the table. In
            DOCSIS 3.1 the valid Data Profile IUCs are: 5, 6, 9, 10,
            11, 12 and 13.";
            reference
              "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
              Specification CM-SP-MULPIv3.1-I03-140610,
              Required Burst Attributes on OFDMA Channels.";

          }

          leaf docsIf31CmUsOfdmaProfileStatsOutOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.14.1.2";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer octets transmitted by
            the CM using this Data IUC profile. This value is the size of
            all unicast, multicast or broadcast frames (including all MAC-
            layer framing) delivered from the MAC to the Phy -- this includes
            user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmUsOfdmaProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmUsOfdmaProfileStatsCtrDiscontinuityTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.14.1.3";
            type yang:timestamp;
            description
              "This attribute is the value of sysUpTime on the most recent
            occasion at which any one or more of this entry's counters
            suffered a discontinuity. If no such discontinuities have
            occurred since the last re-initialization of the local
            management subsystem, then this attribute contains a zero value.";
          }
        }  // list docsIf31CmUsOfdmaProfileStatsEntry
      }  // container docsIf31CmUsOfdmaProfileStatsTable

      container docsIf31CmUsOfdmaMinislotCfgStateTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.15";
        description
          "This CM object specifies the attributes of the minislot
        configuration associated with a OFDMA upstream channel.";
        list docsIf31CmUsOfdmaMinislotCfgStateEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.15.1";
          key "ifIndex docsIf31CmUsOfdmaProfileStatsIuc docsIf31CmUsOfdmaMinislotCfgStateStartMinislotNum";
          description
            "The conceptual row of docsIf31CmUsOfdmaMinislotCfgStateTable.
          An instance exists for each OFDMA minislot.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmUsOfdmaProfileStatsIuc {
            type leafref {
              path "/DOCS-IF31-MIB:DOCS-IF31-MIB/DOCS-IF31-MIB:docsIf31CmUsOfdmaProfileStatsTable/DOCS-IF31-MIB:docsIf31CmUsOfdmaProfileStatsEntry/DOCS-IF31-MIB:docsIf31CmUsOfdmaProfileStatsIuc";
            }
          }

          leaf docsIf31CmUsOfdmaMinislotCfgStateStartMinislotNum {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.15.1.1";
            type uint32;
            description
              "This attribute is the unique identifier of the starting
            minislot in the group of consecutive minislots. The
            valid range is 1 to 240.";
          }

          leaf docsIf31CmUsOfdmaMinislotCfgStateFirstSubcarrierId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.15.1.2";
            type uint32;
            description
              "This attribute is subcarrier identifier of the first
            subcarrier in the minislot. The valid range is 0 to 4095.";
          }

          leaf docsIf31CmUsOfdmaMinislotCfgStateNumConsecutiveMinislots {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.15.1.3";
            type uint32;
            description
              "This attribute defines the number of continuous minislots
            which have the same bit loading, starting with the StartMinislotNum,
            defined in the associated upstream profile. The valid range
            is 1 to 237.";
          }

          leaf docsIf31CmUsOfdmaMinislotCfgStateMinislotPilotPattern {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.15.1.4";
            type uint32;
            description
              "This attribute specifies the id of the pilot pattern used for
            the minislot.  The actual range varies depending on the FFT
            size in use, either 1-8 for 2K or 1-14 for 4K mode. The valid
            range is 1 to 14.";
          }

          leaf docsIf31CmUsOfdmaMinislotCfgStateDataSymbolModulation {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.15.1.5";
            type UsOfdmaModulationType;
            description
              "This attribute defines the bit loading of the data
            subcarriers in the minislot.";
          }
        }  // list docsIf31CmUsOfdmaMinislotCfgStateEntry
      }  // container docsIf31CmUsOfdmaMinislotCfgStateTable

      container docsIf31CmEmDlsStatsTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16";
        description
          "This CM object provides statistics on the DLS feature, when
        enabled.";
        list docsIf31CmEmDlsStatsEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmEmDlsStatsTable. An
          instance exists for each of the Cable Modem's MAC Domains.
          It is indexed by the ifIndex of the corresponding MAC Domain.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmEmDlsStatsNumberTimesCrossedBelowUsEntryThrshlds {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.1";
            type uint32;
            description
              "This attribute indicates the number of times since
            registration the CM crossed below the upstream entry bitrate
            threshold for a number of consecutive seconds equal to or
            exceeding the upstream entry time threshold.";
          }

          leaf docsIf31CmEmDlsStatsNumberTimesCrossedBelowDsEntryThrshlds {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.2";
            type uint32;
            description
              "This attribute indicates the number of times since
            registration the CM crossed below the downstream entry
            bitrate threshold for a number of consecutive seconds equal
            to or exceeding the downstream entry time threshold.";
          }

          leaf docsIf31CmEmDlsStatsTotalDuration {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.3";
            type uint32;
            units "seconds";
            description
              "This attribute indicates the total time duration, in seconds
            since registration, the CM has been in Energy Management DLS
            mode, as controlled by the DBC-REQ Energy Management DLS Mode
            Indicator TLV. This attribute differs from
            docsIf31CmEmDlsStatsTotalDurationBelowUsDsThrshlds because it
            is dependent on effects of the Energy Management Cycle
            Period, and processing of EM-REQ/EM-RSP messages and DBC
            messages that specifically indicate entry into or exit from
            Energy Management DLS mode.";
          }

          leaf docsIf31CmEmDlsStatsTotalDurationBelowUsThrshlds {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.4";
            type uint32;
            units "seconds";
            description
              "This attribute indicates the total time duration, in seconds
            since registration, the CM satisfied upstream conditions for
            entry into or remaining in Energy Management DLS mode.";
          }

          leaf docsIf31CmEmDlsStatsTotalDurationBelowDsThrshlds {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.5";
            type uint32;
            units "seconds";
            description
              "This attribute indicates the total time duration, in seconds
            since registration, the CM satisfied downstream conditions for
            entry into or remaining in Energy Management DLS mode.";
          }

          leaf docsIf31CmEmDlsStatsTotalDurationBelowUsDsThrshlds {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.6";
            type uint32;
            units "seconds";
            description
              "This attribute indicates the total time duration, in seconds
            since registration, the CM, with respect to both upstream and
            downstream entry and exit thresholds, satisfied conditions for
            entry into and remaining in Energy Management DLS mode.  This
            attribute differs from docsIf31CmEmDlsStatsTotalDuration
            because it is not dependent on effects of the Energy
            Management Cycle Period or processing of EM-REQ/EM-RSP
            messages and DBC messages that specifically indicate entry
            into or exit from Energy Management DLS mode.";
          }

          leaf docsIf31CmEmDlsStatsNumSleepLatencyTriggers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.7";
            type yang:counter32;
            description
              "This attribute indicates the number of times since
            registration the CM transitioned to the DLS wake state
            due to the DLS Maximum Sleep Latency being exceeded.";
          }

          leaf docsIf31CmEmDlsStatsNumSleepByteCtTriggers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.16.1.8";
            type yang:counter32;
            description
              "This attribute indicates the number of times since
            registration the CM transitioned to the DLS wake state
            due to the DLS Maximum Byte Count being exceeded.";
          }
        }  // list docsIf31CmEmDlsStatsEntry
      }  // container docsIf31CmEmDlsStatsTable

      container docsIf31CmEmDlsStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.17";
        description
          "This CM object provides statistics on the DLS feature, when
        enabled.";
        list docsIf31CmEmDlsStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.17.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmEmDlsStatusTable. An
          instance exists for each of the Cable Modem's MAC Domains.
          It is indexed by the ifIndex of the corresponding MAC Domain.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmEmDlsStatusAssignedEmIds {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.17.1.1";
            type EmIdList;
            description
              "This attribute reports the set of CMTS-assigned EM-IDs for this CM.
            This attribute is encoded as an array 16-bit binary values with up
            to 3 elements. The broadcast EM-ID is not included in the list";
          }

          leaf docsIf31CmEmDlsStatusReceiveTimer {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.17.1.2";
            type uint32;
            description
              "This attribute specifies how long the CM is required to
            continue listening on the downstream for traffic, after
            reception of the EMM with Sleep Time with a non-zero value.
            The CMTS communicates the EM Receive Timer to the CM during
            registration or in DBC message. The DLS Receive Timer is
            specified in units of PLC frame intervals. The valid range
            is 0 - 2.";
          }

          leaf docsIf31CmEmDlsStatusMaxSleepLatency {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.17.1.3";
            type uint32 {
              range "1..255";
            }
            units "milliseconds";
            description
              "This attribute specifies the amount of time the CM would allow
            an upstream channel to queue the packets without transitioning
            to DLS wake state. The Max Sleep Latency is specified in msec.";
          }

          leaf docsIf31CmEmDlsStatusMaxSleepBytes {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.17.1.4";
            type uint32 {
              range "1..65535";
            }
            description
              "This attribute specifies the maximum number of bytes a CM would
            allow an upstream service flow to enqueue without transitioning
            to DLS wake state. The MaxSleepBytes is specified in bytes.";
          }
        }  // list docsIf31CmEmDlsStatusEntry
      }  // container docsIf31CmEmDlsStatusTable

      container docsIf31CmtsDsOfdmChanTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19";
        description
          "This CMTS object reports the status of the downstream OFDM channels.";
        list docsIf31CmtsDsOfdmChanEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmtsDsOfdmTable.
          An instance exists for each downstream OFDM channel.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsDsOfdmChanChannelId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.1";
            type int32 {
              range "0..255";
            }
            description
              "The Cable Modem Termination System identification of the
            OFDM downstream channel within this particular MAC interface.
            if the interface is down, the object returns the most
            current value.  If the downstream channel ID is unknown,
            this object returns a value of 0.";
          }

          leaf docsIf31CmtsDsOfdmChanLowerBdryFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.2";
            type uint32;
            units "Hz";
            description
              "This attribute represents either the lower boundary frequency
            of the lower guardband or (if no guardband is defined) the
            lower boundary frequency of the lowest active subcarrier of the
            OFDM downstream channel.";
          }

          leaf docsIf31CmtsDsOfdmChanUpperBdryFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.3";
            type uint32;
            units "Hz";
            description
              "This attribute represents either the upper boundary frequency
            of the upper guardband or (if no guardband is defined) the
            upper boundary frequency of the highest active subcarrier of the
            OFDM downstream channel.";
          }

          leaf docsIf31CmtsDsOfdmChanLowerBdryEncompSpectrum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.4";
            type uint32;
            units "Hz";
            description
              "This attribute represents the lower boundary frequency
            of the encompassed spectrum.";
          }

          leaf docsIf31CmtsDsOfdmChanUpperBdryEncompSpectrum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.5";
            type uint32;
            units "Hz";
            description
              "This attribute represents the upper boundary frequency
            of the encompassed spectrum.";
          }

          leaf docsIf31CmtsDsOfdmChanPlcFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.6";
            type uint32;
            units "Hz";
            description
              "This is the PHY Link Channel (PLC) frequency. It is the center
            frequency of the lowest frequency subcarrier of the PLC. The
            aim of the PLC is for the CMTS to convey to the CM the
            physical properties of the OFDM channel.";
          }

          leaf docsIf31CmtsDsOfdmChanSubcarrierZeroFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.7";
            type uint32;
            units "Hz";
            description
              "This attribute specifies the center frequency of the
            subcarrier 0 of the OFDM transmission. Note that since
            subcarrier 0 is always excluded, it will actually be below the
            allowed downstream spectrum band. This is the frequency of
            subcarrier X(0) in the definition of the DFT.";
          }

          leaf docsIf31CmtsDsOfdmChanFirstActiveSubcarrierNum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.8";
            type uint32;
            description
              "This attribute corresponds to the number of the first
            non-excluded subcarrier. The valid range is 148 to 7895.";
          }

          leaf docsIf31CmtsDsOfdmChanLastActiveSubcarrierNum {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.9";
            type uint32;
            description
              "This attribute corresponds to the number of the last
            non-excluded subcarrier. The valid range is 148 to 7895";
          }

          leaf docsIf31CmtsDsOfdmChanNumActiveSubcarriers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.10";
            type uint32;
            description
              "This attribute represents the number of active data
            subcarriers within the OFDM downstream channel (i.e. this
            exclude subcarriers for continuous pilots and the PLC).
            For 4K FFT mode, the maximum number of subcarriers including
            continuous pilots and the PLC cannot exceed 3800, and for
            8K FFT mode, the maximum number of active subcarriers including
            continuous pilots and the PLC cannot be greater than 7600.
            
            However, there are a minimum of 56 continuous pilots in a 192MHz
            channel that has no exclusions, and the size of the PLC is
            8 subcarriers for 4K FFT mode and 16 subcarriers for 8K FFT mode.
            Therefore the maximum value of NumActiveSubcarriers is 3736
            (or 3800 - 56 - 8) for 4K FFT mode and 7528 (or 7600 - 56 - 16)
            for 8K FFT mode.";
          }

          leaf docsIf31CmtsDsOfdmChanSubcarrierSpacing {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.11";
            type SubcarrierSpacingType;
            units "kHz";
            description
              "This attribute defines the subcarrier spacing associated with
            a particular FFT mode configured on the OFDM downstream
            channel. If it is 4K mode, then the subcarrier spacing is
            50kHz. If it is 8K mode, then the subcarrier spacing is
            25kHz.";
          }

          leaf docsIf31CmtsDsOfdmChanLowerGuardbandWidth {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.12";
            type uint32;
            description
              "This attribute is the width in Hertz of the lower guard
            band of the OFDM channel. The valid range is 0 or
            1MHz to 1.77GHz.";
          }

          leaf docsIf31CmtsDsOfdmChanUpperGuardbandWidth {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.13";
            type uint32;
            description
              "This attribute is the width in Hertz of the upper guard
            band of the OFDM channel. The valid range is 0 or
            1MHz to 1.77GHz";
          }

          leaf docsIf31CmtsDsOfdmChanCyclicPrefix {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.14";
            type DsOfdmCyclicPrefix;
            units "number of samples";
            description
              "Cyclic prefix enables the receiver to overcome the effects of
            inter-symbol-interference and intercarrier-interference caused
            by micro-reflections in the channel. There are five possible
            values for the length of the CP and the choice depends on the
            delay spread of the channel - a longer delay spread requires a
            longer cyclic prefix. The cyclic prefix (in usec) are converted
            into samples using the sample rate of 204.8 Msamples/s and is
            an integer multiple of: 1/64 * 20 us.";
          }

          leaf docsIf31CmtsDsOfdmChanRollOffPeriod {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.15";
            type DsOfdmRollOffPeriod;
            units "number of samples";
            description
              "Roll off period maximizes channel capacity by sharpening the
            edges of the spectrum of the OFDM signal. For windowing
            purposes another segment at the start of the IDFT output is
            appended to the end of the IDFT output - the roll-off postfix
            (RP). There are five possible values for the (RP), and the
            choice depends on the bandwidth of the channel and the number
            of exclusion bands within the channel. A larger RP provides
            sharper edges in the spectrum of the OFDM signal; however,
            there is a time vs. frequency trade-off. Larger RP values
            reduce the efficiency of transmission in the time domain,
            but because the spectral edges are sharper, more useful
            subcarriers appear in the frequency domain. There is an
            optimum value for the RP that maximizes capacity for a given
            bandwidth and/or exclusion band scenario.";
          }

          leaf docsIf31CmtsDsOfdmChanTimeInterleaverDepth {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.16";
            type TimeInterleaverDepth;
            units "symbols";
            description
              "This attribute represents the number of samples for the
            OFDM Downstream channel. This is limited to 16 samples for
            and 32 samples for 50 kHz and 25 kHz Subcarrier Spacing,
            respectively.";
          }

          leaf docsIf31CmtsDsOfdmChanNumPilots {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.17";
            type uint32;
            description
              "This attribute is the number of continuous pilots
            for the OFDM downstream channel.";
          }

          leaf docsIf31CmtsDsOfdmChanPilotScaleFactor {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.18";
            type uint32;
            description
              "This attribute represents the scale factor for calculating
            the number of continuous pilots. ";
          }

          leaf docsIf31CmtsDsOfdmChanNcpModulation {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.19";
            type DsOfdmModulationType;
            description
              "This attribute represents the modulation of all subcarriers in
            the NCP channel. Valid values are qpsk, qam16 and qam64.";
          }

          leaf docsIf31CmtsDsOfdmChanUtilization {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.19.1.20";
            type uint32 {
              range "0..100";
            }
            units "percent";
            description
              "The utilization for this OFDM downstream channel, accurate as
            of the most recent docsIfCmtsChannelUtilizationInterval.
            
            See Reference for specific details on this attribute.";
            reference
              "DOCSIS 3.1 CCAP Operations Support System Interface
              Specification CM-SP-CCAP OSSIv3.1-I04-15MMDD,
              OfdmChannelUtilization.";

          }
        }  // list docsIf31CmtsDsOfdmChanEntry
      }  // container docsIf31CmtsDsOfdmChanTable

      container docsIf31CmtsDsOfdmProfileStatsTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20";
        description
          "This CMTS table provides DS OFDM statistics on a per Profile basis.";
        list docsIf31CmtsDsOfdmProfileStatsEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1";
          key "ifIndex docsIf31CmtsDsOfdmStatsProfId";
          description
            "The conceptual row of docsIf31CmtsDsOfdmProfileStatsTable.
          An instance exists for each Profile Id on a given DS OFDM channel.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsDsOfdmStatsProfId {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.1";
            type uint32 {
              range "0..255";
            }
            description
              "This attribute is the identifier of a profile associated
            with the OFDM downstream channel. The value of this attribute
            is zero-based due to constraints of the definition of Profile Id.";
            reference
              "DOCSIS 3.1 MAC and Upper Layer Protocols Interface Specification
              CM-SP-MULPIv3.1-I03-140610, Downstream Profile Descriptor.";

          }

          leaf docsIf31CmtsDsOfdmProfileStatsConfigChangeCt {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.2";
            type uint32 {
              range "0..255";
            }
            description
              "This attribute contains the value of the Configuration Change
            Count field in the Downstream Profile Descriptor (DPD) MAC
            Management Message corresponding to this profile.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsFullChannelSpeed {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.3";
            type yang:gauge64;
            description
              "This attribute is the speed of the associated channel in bps
            if this were the only profile and 100% of data-capable subcarriers
            were utilized to transmit MAC frames in full codewords.
            
            See Reference for specific details on this attribute.";
            reference
              "DOCSIS 3.1 CCAP Operations Support System Interface
              Specification CM-SP-CCAP OSSIv3.1-I03-15MMDD,
              ProfileFullChannelSpeed.";

          }

          leaf docsIf31CmtsDsOfdmProfileStatsOutOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.4";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer octets transmitted
            by the CCAP using this profile. This value is the size of all
            unicast, multicast or broadcast frames (including all MAC-layer
            framing) delivered from the MAC to the Phy -- this includes user
            data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsOutUnicastOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.5";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer Unicast octets transmitted
            by the CCAP using this profile. This value is the size of all unicast
            frames (including all MAC-layer framing) delivered from the
            MAC to the Phy -- this includes user data, DOCSIS MAC Management
            Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsOutMulticastOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.6";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer Multicast and broadcast
            octets transmitted by the CCAP using this profile. This value is
            the size of all frames (including all MAC-layer framing) delivered
            from the MAC to the Phy and addressed to a multicast MAC address
            -- this includes user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsOutFrames {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.7";
            type yang:counter64;
            description
              "This attribute is the count of frames transmitted by the CCAP
            using this profile. This value is the count of all unicast,
            multicast or broadcast frames delivered from the MAC to the Phy
            -- this includes user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsOutUnicastFrames {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.8";
            type yang:counter64;
            description
              "This attribute is the count of unicast frames transmitted by
            the CCAP using this profile. This value is the count of all
            frames delivered from the MAC to the Phy and addressed to a
            unicast MAC address -- this include user data, DOCSIS MAC Management
            Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsOutMulticastFrames {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.9";
            type yang:counter64;
            description
              "This attribute is the count of multicast frames transmitted
            by the CCAP using this profile. This value is the count of all
            frames delivered from the MAC to the Phy and addressed to a
            multicast MAC address -- this include user data, DOCSIS MAC
            Management Messages, etc, but excludes frames sent to a broadcast
            address.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsDsOfdmProfileStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsCtrDiscontinuityTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.10";
            type yang:timestamp;
            description
              "This attribute is the value of sysUpTime on the most recent
            occasion at which any one or more of this entry's counters
            suffered a discontinuity. If no such discontinuities have
            occurred since the last re-initialization of the local
            management subsystem, then this attribute contains a zero value.";
          }

          leaf docsIf31CmtsDsOfdmProfileStatsAssignedCmCt {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.20.1.11";
            type uint32;
            description
              "This attribute is the count of CMs currently assigned to
            this profile.";
          }
        }  // list docsIf31CmtsDsOfdmProfileStatsEntry
      }  // container docsIf31CmtsDsOfdmProfileStatsTable

      container docsIf31CmtsDsOfdmSubcarrierStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.21";
        description
          "This CMTS object provides the status of each of the OFDM subcarriers
        which comprise this OFDM channel.";
        list docsIf31CmtsDsOfdmSubcarrierStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.21.1";
          key "ifIndex docsIf31CmtsDsOfdmStatsProfId docsIf31CmtsDsOfdmSubcarrierStatusStartId";
          description
            "The conceptual row of docsIf31CmtsDsOfdmSubcarrierStatusTable.
          An instance exists for each Profile on a given OFDM downstream.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsDsOfdmStatsProfId {
            type leafref {
              path "/DOCS-IF31-MIB:DOCS-IF31-MIB/DOCS-IF31-MIB:docsIf31CmtsDsOfdmProfileStatsTable/DOCS-IF31-MIB:docsIf31CmtsDsOfdmProfileStatsEntry/DOCS-IF31-MIB:docsIf31CmtsDsOfdmStatsProfId";
            }
          }

          leaf docsIf31CmtsDsOfdmSubcarrierStatusStartId {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.21.1.1";
            type uint32;
            description
              "This attribute is an identifier for the first subcarrier
            in the range of active subcarriers with the same modulation.";
          }

          leaf docsIf31CmtsDsOfdmSubcarrierStatusEndId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.21.1.2";
            type uint32;
            description
              "This attribute is the subcarrier number of the last subcarrier
            in the group.";
          }

          leaf docsIf31CmtsDsOfdmSubcarrierStatusMainModulation {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.21.1.3";
            type DsOfdmModulationType;
            description
              "This attribute indicates the main modulation order of the
            subcarriers in the range. In case of skip modulation enabled
            the MainModulation is the modulation order of the first, the
            third, the fifth, etc. subcarriers in the range.";
          }

          leaf docsIf31CmtsDsOfdmSubcarrierStatusSkip {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.21.1.4";
            type int32 {
              range "0..2";
            }
            description
              "This attribute indicates whether the skip modulation method
            is used. If true the modulation order of the subcarriers in
            the range is alternating between the MainModulation and
            SkipModulation.";
          }

          leaf docsIf31CmtsDsOfdmSubcarrierStatusSkipModulation {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.21.1.5";
            type DsOfdmModulationType;
            description
              "This attribute indicates the modulation order for every other
            subcarrier in the range.";
          }
        }  // list docsIf31CmtsDsOfdmSubcarrierStatusEntry
      }  // container docsIf31CmtsDsOfdmSubcarrierStatusTable

      container docsIf31CmtsDsOfdmChanPowerTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.22";
        description
          "This object provides measurements of the downstream OFDM channel
        power in 6 MHz-wide bands at the output of the CCAP.";
        list docsIf31CmtsDsOfdmChanPowerEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.22.1";
          key "ifIndex docsIf31CmtsDsOfdmChanPowerBandIndex";
          description
            "The conceptual row of the docsIf31CmtsDsOfdmChanPowerTable.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsDsOfdmChanPowerBandIndex {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.22.1.1";
            type uint32;
            description
              "This attribute is a unique index used by the CCAP to
            identify each of the 6 MHz bands of a given OFDM downstream
            channel (from the lowest 6MHz band of the Occupied Bandwidth
            to the highest 6MHz band of the Occupied Bandwidth). The CCAP
            assigns indices in frequency order from the OFDM channel's
            lowest to highest 6 MHz frequency band for each of the 6 MHz
            bands of the channel, using an index of 1 to represent the lowest
            frequency band of the Occupied Bandwidth.  Thus, an index of 33
            represents the highest possible 6 MHz frequency band of the
            Occupied Bandwidth of an OFDM channel.
            
            The CCAP also provides the power of the PLC channel and utilizes
            a value of 0 to represent the PLC channel in this table. ";
          }

          leaf docsIf31CmtsDsOfdmChanPowerCenterFrequency {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.22.1.2";
            type uint32;
            units "Hz";
            description
              "This attribute corresponds to the center frequency of the 6 MHz
            band the CM measured the average channel power.
            
            See Reference for specific details on this attribute.";
            reference
              "DOCSIS 3.1 CCAP Operations Support System Interface
              Specification CM-SP-CCAP OSSIv3.1-I04-15MMDD,
              CenterFrequency";

          }

          leaf docsIf31CmtsDsOfdmChanPowerTxPower {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.22.1.3";
            type docs-if:TenthdBmV;
            units "TenthdBmV";
            description
              "This attribute provides an estimate of the average power
            measured at the output of the CCAP in the downstream channel
            set for this 6 MHz band.
            
            If the docsIf31CmtsDsOfdmChanPowerBandIndex is 0, then this
            attribute provides an estimate of the average power measured
            at the output of the CCAP for a 6 MHz encompassed spectrum
            containing the DOCSIS 3.1 PLC at its center.";
          }
        }  // list docsIf31CmtsDsOfdmChanPowerEntry
      }  // container docsIf31CmtsDsOfdmChanPowerTable

      container docsIf31CmtsUsOfdmaChanTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23";
        description
          "This object provides channel-level visibility into Upstream
        OFDMA channel configuration and status.";
        list docsIf31CmtsUsOfdmaChanEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmtsUsOfdmaChanTable.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsUsOfdmaChanTemplateIndex {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.1";
            type uint32;
            description
              "The index of the UsOfdmaModulationTemplate object which the
            CMTS/CCAP utilized when configuring this channel.";
          }

          leaf docsIf31CmtsUsOfdmaChanConfigChangeCt {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.2";
            type uint32 {
              range "0..255";
            }
            description
              "This attribute contains the value of the Configuration
            Change Count field in the Upstream Channel Descriptor (UCD) MAC
            Management Message currently in use on this channel.";
          }

          leaf docsIf31CmtsUsOfdmaChanTargetRxPower {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.3";
            type docs-if:TenthdBmV;
            units "TenthdBmV";
            description
              "This attribute provides the power of the expected commanded
            received signal in the channel, referenced to the CCAP input.
            The value represents the power spectral density in an
            equivalent 1.6 MHz spectrum.";
          }

          leaf docsIf31CmtsUsOfdmaChanLowerBdryFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.4";
            type uint32;
            units "Hz";
            description
              "This attribute provides the lower frequency for the OFDMA US
            channel.";
          }

          leaf docsIf31CmtsUsOfdmaChanUpperBdryFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.5";
            type uint32;
            units "Hz";
            description
              "This attribute provides the upper frequency for the OFDMA US
            channel.";
          }

          leaf docsIf31CmtsUsOfdmaChanSubcarrierSpacing {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.6";
            type SubcarrierSpacingType;
            units "kHz";
            description
              "This attribute defines the subcarrier spacing associated with
            a particular FFT mode configured on the OFDMA upstream channel.";
          }

          leaf docsIf31CmtsUsOfdmaChanCyclicPrefix {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.7";
            type UsOfdmaCyclicPrefix;
            units "number of samples";
            description
              "The cyclic prefix assigned to this channel for mitigating
            interference due to microreflections.";
          }

          leaf docsIf31CmtsUsOfdmaChanNumSymbolsPerFrame {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.8";
            type uint32;
            description
              "This attribute is the number of symbol periods per frame.";
          }

          leaf docsIf31CmtsUsOfdmaChanRollOffPeriod {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.9";
            type UsOfdmaRollOffPeriod;
            units "number of samples";
            description
              "This attribute is the windowing roll-off period.";
          }

          leaf docsIf31CmtsUsOfdmaChanPreEqEnable {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.10";
            type boolean;
            description
              "This attribute indicates pre-equalization is enabled on the
            OFDMA upstream channel when its value is true, or disabled when
            its value is false.";
          }

          leaf docsIf31CmtsUsOfdmaChanFineRngGuardband {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.11";
            type uint32;
            units "Hz";
            description
              "This attribute is the sum of the upper and lower guard
            bands for fine ranging in Hz.";
          }

          leaf docsIf31CmtsUsOfdmaChanFineRngNumSubcarriers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.12";
            type uint32;
            description
              "This attribute is the maximum number of subcarriers for
            fine ranging.";
          }

          leaf docsIf31CmtsUsOfdmaChanFineRngPreambleLen {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.13";
            type uint32;
            units "bits";
            description
              "This attribute is the length of the OFDMA fine ranging IUC
            preamble in bits.";
          }

          leaf docsIf31CmtsUsOfdmaChanInitRngGuardband {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.14";
            type uint32;
            units "Hz";
            description
              "This attribute is the sum of the upper and lower guard bands
            for initial ranging in Hz.";
          }

          leaf docsIf31CmtsUsOfdmaChanInitRngNumSubcarriers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.15";
            type uint32;
            description
              "This attribute is the maximum number of subcarriers for
            initial ranging.";
          }

          leaf docsIf31CmtsUsOfdmaChanInitRngPreambleLen {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.16";
            type uint32;
            units "bits";
            description
              "This attribute is the maximum number of subcarriers for
            initial ranging.";
          }

          leaf docsIf31CmtsUsOfdmaChanProvAttribMask {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.17";
            type docs-if3:AttributeMask;
            description
              "This attribute provides the Provisioned Attribute Mask for
            the OFDMA upstream channel.";
          }

          leaf docsIf31CmtsUsOfdmaChanTxBackoffStart {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.18";
            type int32 {
              range "0..16";
            }
            description
              "The initial random backoff window to use when retrying
            transmissions.  Expressed as a power of 2.  A value of 16
            at the CMTS indicates that a proprietary adaptive retry
            mechanism is to be used.";
          }

          leaf docsIf31CmtsUsOfdmaChanTxBackoffEnd {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.19";
            type int32 {
              range "0..16";
            }
            description
              "The final random backoff window to use when retrying
            transmissions.  Expressed as a power of 2.  A value of 16
            at the CMTS indicates that a proprietary adaptive retry
            mechanism is to be used.";
          }

          leaf docsIf31CmtsUsOfdmaChanRangingBackoffStart {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.20";
            type int32 {
              range "0..16";
            }
            description
              "The initial random backoff window to use when retrying
            Ranging Requests.  Expressed as a power of 2.  A value of
            16 at the CMTS indicates that a proprietary adaptive retry
            mechanism is to be used.";
          }

          leaf docsIf31CmtsUsOfdmaChanRangingBackoffEnd {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.21";
            type int32 {
              range "0..16";
            }
            description
              "The final random backoff window to use when retrying
            Ranging Requests.  Expressed as a power of 2.  A value of
            16 at the CMTS indicates that a proprietary adaptive retry
            mechanism is to be used.";
          }

          leaf docsIf31CmtsUsOfdmaChanUtilization {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.22";
            type uint32 {
              range "0..100";
            }
            units "percent";
            description
              "The calculated and truncated utilization for this physical
            upstream channel, accurate as of the most recent
            docsIfCmtsChannelUtilizationInterval.
            
            The upstream channel utilization is expressed as a percentage
            of minislots utilized on the physical channel, regardless of
            burst type.
            
            The utilization calculation can be expressed by the
            following equation:
            
            Utilization = MinislotsUtilized/MinislotsAllocated * 100%
            
            For an Initial Maintenance region, the minislots for the
            complete region are considered utilized if the CMTS received
            an upstream burst within the region from any CM on the physical
            channel. For contention REQ and REQ/DATA regions, the minislots
            for a transmission opportunity within the region are considered
            utilized if the CMTS received an upstream burst within the
            opportunity from any CM on the physical channel. For all other
            regions, utilized minislots are those in which the CMTS granted
            bandwidth to any unicast SID on the physical channel.
            
            For an upstream interface that has multiple logical upstream
            channels enabled, the utilization index is a weighted sum of
            utilization indices for the logical channels. The weight for
            each utilization index is the percentage of upstream mini-slots
            allocated for the corresponding logical channel.
            
            Example:
            If 75% of bandwidth is allocated to the first logical channel
            and 25% to the second, and the utilization for each are 60 and 40,
            respectively, the utilization for the upstream physical channel is
            (60 * 0.75) + (40 * 0.25) = 55. This figure applies to the most
            recent utilization interval.";
          }

          leaf docsIf31CmtsUsOfdmaChanId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.23.1.23";
            type int32;
            description
              "This attribute is the upstream Channel Id signaled in the
            DOCSIS protocol for the OFDMA upstream channel. The Channel
            Id is unique within the associated MacDomain.";
          }
        }  // list docsIf31CmtsUsOfdmaChanEntry
      }  // container docsIf31CmtsUsOfdmaChanTable

      container docsIf31CmtsUsOfdmaDataIucStatsTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24";
        description
          "This CMTS table provides DS OFDM statistics on a per Profile basis.";
        list docsIf31CmtsUsOfdmaDataIucStatsEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1";
          key "ifIndex docsIf31CmtsUsOfdmaStatsIuc";
          description
            "The conceptual row of docsIf31CmtsUsOfdmaDataIucStatsTable.
          An instance exists for each Data IUC profile on a given
          US OFDMA channel.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsUsOfdmaStatsIuc {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.1";
            type uint32;
            description
              "This attribute represents the OFDMA Data IUC that these
            statistics correspond to.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsMinislotPilotPattern {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.2";
            type uint32;
            description
              "This attribute contains the identifier for the default pilot
            pattern specified in the template for minislots using this
            Data IUC. The valid range is 1 - 14.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsMinislotModulation {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.3";
            type UsOfdmaModulationType;
            description
              "This attribute contains the default modulation order specified
            in the template for minislots using this Data IUC.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsTotalCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.4";
            type yang:counter64;
            description
              "This attribute contains the count of the total number of
            FEC codewords received on this channel using this Data IUC.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsUsOfdmaDataIucStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsCorrectedCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.5";
            type yang:counter64;
            description
              "This attribute contains the count of codewords received
            on this channel using this Data IUC that failed the pre-decoding
            syndrome check, but passed the post-decoding syndrome check.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsUsOfdmaDataIucStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsUnreliableCodewords {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.6";
            type yang:counter64;
            description
              "This attribute contains the count of codewords received on
            this channel using this Data IUC that failed the post-decoding
            syndrome check.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsUsOfdmaDataIucStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsInOctets {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.7";
            type yang:counter64;
            description
              "This attribute is the count of MAC-layer octets received
            by the CCAP on this Data IUC. This value is the size of all
            unicast, multicast or broadcast octets (including all MAC-
            layer framing) and CCF PMD overhead (segment headers and
            stuffing bytes) delivered from the Phy to the MAC; this
            includes user data, DOCSIS MAC Management Messages, etc.
            
            Discontinuities in the value of this counter can occur at
            reinitialization of the managed system, and at other times as
            indicated by the value of docsIf31CmtsUsOfdmaDataIucStats-
            CtrDiscontinuityTime.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsCtrDiscontinuityTime {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.8";
            type yang:timestamp;
            description
              "This attribute is the value of sysUpTime on the most recent
            occasion at which any one or more of this entry's counters
            suffered a discontinuity. If no such discontinuities have
            occurred since the last re-initialization of the local
            management subsystem, then this attribute contains a zero value.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucStatsAssignedCmCt {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.24.1.9";
            type uint32;
            description
              "This attribute is the count of CMs currently assigned to
            this Data IUC.";
          }
        }  // list docsIf31CmtsUsOfdmaDataIucStatsEntry
      }  // container docsIf31CmtsUsOfdmaDataIucStatsTable

      container docsIf31CmtsUsOfdmaDataIucDetailStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.25";
        description
          "This CMTS table provides exceptions to the US channel template
        for this Data IUC.";
        list docsIf31CmtsUsOfdmaDataIucDetailStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.25.1";
          key "ifIndex docsIf31CmtsUsOfdmaStatsIuc docsIf31CmtsUsOfdmaDataIucDetailStatusLowerFreq";
          description
            "The conceptual row of docsIf31CmtsUsOfdmaDataIucDetailStatusTable.
          An instance exists for each exception to the template for a Data
          IUC profile on a given US OFDMA channel.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsUsOfdmaStatsIuc {
            type leafref {
              path "/DOCS-IF31-MIB:DOCS-IF31-MIB/DOCS-IF31-MIB:docsIf31CmtsUsOfdmaDataIucStatsTable/DOCS-IF31-MIB:docsIf31CmtsUsOfdmaDataIucStatsEntry/DOCS-IF31-MIB:docsIf31CmtsUsOfdmaStatsIuc";
            }
          }

          leaf docsIf31CmtsUsOfdmaDataIucDetailStatusLowerFreq {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.25.1.1";
            type uint32;
            units "Hz";
            description
              "This attribute indicates the lower frequency where the
            minislots will use the pilot pattern and modulation";
          }

          leaf docsIf31CmtsUsOfdmaDataIucDetailStatusUpperFreq {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.25.1.2";
            type uint32;
            units "Hz";
            description
              "This attribute indicates the upper frequency where the
            minislots will use the pilot pattern and modulation";
          }

          leaf docsIf31CmtsUsOfdmaDataIucDetailStatusMinislotPilotPattern {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.25.1.3";
            type uint32;
            description
              "This attribute contains the identifier for the pilot
            pattern this frequency range. All minislots in the frequency
            range have this pilot pattern. The valid range is 1 - 14.";
          }

          leaf docsIf31CmtsUsOfdmaDataIucDetailStatusMinislotModulation {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.25.1.4";
            type UsOfdmaModulationType;
            description
              "This attribute contains the modulation order for this
            frequency range. All minislots in the frequency range have
            this modulation.";
          }
        }  // list docsIf31CmtsUsOfdmaDataIucDetailStatusEntry
      }  // container docsIf31CmtsUsOfdmaDataIucDetailStatusTable

      container docsIf31CmtsUsOfdmaRangingIucStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.26";
        description
          "This CMTS table provides details on status of ranging IUCs.";
        list docsIf31CmtsUsOfdmaRangingIucStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.26.1";
          key "ifIndex docsIf31CmtsUsOfdmaRangingIucStatusIuc";
          description
            "The conceptual row of docsIf31CmtsUsOfdmaRangingIucStatusTable.
          An instance exists for each Ranging IUC profile on a given
          US OFDMA channel.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsUsOfdmaRangingIucStatusIuc {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.26.1.1";
            type uint32;
            description
              "This attribute indicates the OFDMA Ranging IUC that this
            status information corresponds to.";
          }

          leaf docsIf31CmtsUsOfdmaRangingIucStatusGuardband {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.26.1.2";
            type uint32;
            units "Hz";
            description
              "This attribute is the sum of the upper and lower guard bands
            for this ranging IUC in Hz. ";
          }

          leaf docsIf31CmtsUsOfdmaRangingIucStatusNumSubcarriers {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.26.1.3";
            type uint32;
            description
              "This attribute indicates the maximum number of subcarriers
            for this ranging IUC.";
          }
        }  // list docsIf31CmtsUsOfdmaRangingIucStatusEntry
      }  // container docsIf31CmtsUsOfdmaRangingIucStatusTable

      container docsIf31CmtsDsOfdmSubcarrierTypeTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.27";
        description
          "This object specifies the subcarrier type for a group of subcarriers
        in the active spectrum of this OFDM channel. Groups of subcarriers of
        the same type are presented together; non-data subcarriers in these
        ranges are ignored.";
        list docsIf31CmtsDsOfdmSubcarrierTypeEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.27.1";
          key "ifIndex docsIf31CmtsDsOfdmSubcarrierTypeStartSubcarrierId";
          description
            "The conceptual row of docsIf31CmtsDsOfdmSubcarrierTypeTable.
          An instance exists for each OFDM downstream channel.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsDsOfdmSubcarrierTypeStartSubcarrierId {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.27.1.1";
            type uint32;
            description
              "This attribute is a key defined to provide an index into the table
            and represents the subcarrier number of the first subcarrier in the
            group. ";
          }

          leaf docsIf31CmtsDsOfdmSubcarrierTypeEndSubcarrierId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.27.1.2";
            type uint32;
            description
              "This attribute is the subcarrier number of the last subcarrier in
            the group. ";
          }

          leaf docsIf31CmtsDsOfdmSubcarrierTypeSubcarrierType {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.27.1.3";
            type enumeration {
              enum "data" {
                value 1;
              }
              enum "plc" {
                value 2;
              }
              enum "continuousPilot" {
                value 3;
              }
              enum "excluded" {
                value 4;
              }
            }
            description
              "This attribute specifies which type of subcarrier is represented in
            this group.";
          }
        }  // list docsIf31CmtsDsOfdmSubcarrierTypeEntry
      }  // container docsIf31CmtsDsOfdmSubcarrierTypeTable

      container docsIf31CmtsUsOfdmaSubcarrierTypeTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.28";
        description
          "This object specifies the subcarrier type for a group of subcarriers
        in the active spectrum of this OFDMA channel. Groups of subcarriers of
        the same type are presented together; non-data subcarriers in these
        ranges are ignored.";
        list docsIf31CmtsUsOfdmaSubcarrierTypeEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.28.1";
          key "ifIndex docsIf31CmtsUsOfdmaSubcarrierTypeStartSubcarrierId";
          description
            "The conceptual row of docsIf31CmtsUsOfdmaSubcarrierStatusTable.
          An instance exists for each Profile on a given OFDMA upstream.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmtsUsOfdmaSubcarrierTypeStartSubcarrierId {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.28.1.1";
            type uint32;
            description
              "This attribute is a key defined to provide an index into the table
            and represents the subcarrier number of the first subcarrier in the
            group. ";
          }

          leaf docsIf31CmtsUsOfdmaSubcarrierTypeEndSubcarrierId {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.28.1.2";
            type uint32;
            description
              "This attribute is the subcarrier number of the last subcarrier in
            the group. ";
          }

          leaf docsIf31CmtsUsOfdmaSubcarrierTypeSubcarrierType {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.28.1.3";
            type enumeration {
              enum "data" {
                value 1;
              }
              enum "excluded" {
                value 2;
              }
              enum "unused" {
                value 3;
              }
            }
            description
              "This attribute specifies which type of subcarrier is represented in
            this group.";
          }
        }  // list docsIf31CmtsUsOfdmaSubcarrierTypeEntry
      }  // container docsIf31CmtsUsOfdmaSubcarrierTypeTable

      container docsIf31CmStatusTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.29";
        description
          "This object defines attributes of the CM status.
        This object is an extension to the SNMP table
        docsIf3CmStatusTable.";
        list docsIf31CmStatusEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.29.1";
          key "ifIndex";
          description
            "The conceptual row of docsIf31CmStatusTable.
          An instance exist for the CM MAC Domain Interface.";
          leaf ifIndex {
            type leafref {
              path "/if-mib:IF-MIB/if-mib:ifTable/if-mib:ifEntry/if-mib:ifIndex";
            }
          }

          leaf docsIf31CmStatusEmDlsOperStatus {
            smiv2:max-access "read-only";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.29.1.1";
            type boolean;
            description
              "This attribute indicates whether the CM is currently operating
            in Energy Management DLS Mode. If this attribute returns true,
            the CM is operating in Energy Management DLS Mode.";
            reference
              "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
              Specification CM-SP-MULPIv3.1-I08-151210,
              Energy Management Mode Indicator section.";

          }
        }  // list docsIf31CmStatusEntry
      }  // container docsIf31CmStatusTable

      container docsIf31CmEmDlsCfgTable {
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.30";
        description
          "This object provides configuration state information
        on the CM for the Energy Management 1x1 Mode feature.";
        reference
          "DOCSIS 3.1 MAC and Upper Layer Protocols Interface
          Specification CM-SP-MULPIv3.1-I08-151210,
          Energy Management DLS Encodings section.";

        list docsIf31CmEmDlsCfgEntry {
          smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.30.1";
          key "docsIf31CmEmDlsCfgDirection";
          description
            "The conceptual row of docsIf31CmEmDlsCfgTable.";
          leaf docsIf31CmEmDlsCfgDirection {
            smiv2:max-access "not-accessible";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.30.1.1";
            type docs-if3:IfDirection;
            description
              "This index indicates whether the threshold applies to the
            upstream or downstream.";
          }

          leaf docsIf31CmEmDlsCfgEntryBitrateThrshld {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.30.1.2";
            type uint32;
            units "bps";
            description
              "This attribute specifies the upstream or downstream bitrate
            threshold (in bps) below which the CM will request to enter
            Energy Management DLS Mode operation.";
          }

          leaf docsIf31CmEmDlsCfgEntryTimeThrshld {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.30.1.3";
            type uint32 {
              range "1..65535";
            }
            units "seconds";
            description
              "This attribute specifies the number of consecutive seconds
            that the upstream or downstream data rate needs to remain below
            the Upstream or Downstream Entry Bitrate Threshold in order to
            determine that a transition to Energy Management DLS Mode is
            required.";
          }

          leaf docsIf31CmEmDlsCfgExitBitrateThrshld {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.30.1.4";
            type uint32;
            units "bps";
            description
              "This attribute specifies the upstream or downstream bitrate
            threshold (in bps) above which the CM will request to leave
            Energy Management DLS Mode operation.";
          }

          leaf docsIf31CmEmDlsCfgExitTimeThrshld {
            smiv2:max-access "read-write";
            smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.30.1.5";
            type uint32 {
              range "1..65535";
            }
            units "seconds";
            description
              "This attribute specifies the number of consecutive seconds
            that the upstream or downstream data rate needs to remain above
            the Upstream or Downstream Exit Bitrate Threshold in order to
            determine that a transition out of Energy Management DLS Mode
            is required.";
          }
        }  // list docsIf31CmEmDlsCfgEntry
      }  // container docsIf31CmEmDlsCfgTable
    }  // container DOCS-IF31-MIB

    augment /docs-if3:DOCS-IF3-MIB/docs-if3:docsIf3CmtsCmRegStatusTable/docs-if3:docsIf3CmtsCmRegStatusEntry {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1";
      description
        "The conceptual row of docsIf31CmtsCmRegStatusTable.";
      leaf docsIf31CmtsCmRegStatusAssignedEmIds {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.1";
        type EmIdList;
        description
          "This attribute reports the set of CMTS-assigned EM-IDs for
        this CM. This attribute is encoded as an array 16-bit binary
        values with up to 3 elements. The broadcast EM-ID is not
        included in the list.
        If the EM-ID is unknown the CMTS returns a zero length string.
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns a zero length string.";
      }

      leaf docsIf31CmtsCmRegStatusDsProfileIdList {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.2";
        type binary {
          length "0|6..72";
        }
        description
          "This attribute is a variable length series of hexadecimal
        octets where each series entry consists of the following fields
        (encoded in the following order):
        
        - The ifIndex (4 octets) of the OFDM channel where the
        downstream Profile IDs are assigned.
        
        - The number or count of Profile IDs (1 octet with valid values
        of 1-4) assigned to the CM on that channel.
        
        - The list of Profile IDs (1 octet each with valid values of
        0-15) assigned to this CM on that channel. Profile ID 0 is
        commonly referred to as Profile A.  Likewise, Profile IDs 1,
        2 and 3 are commonly referred to as Profiles B, C and D.
        
        The CCAP encodes each OFDM channel in a CM's RCS as a separate
        n-octet entry in the ProfileIdList.
        
        Examples: a CM with a single OFDM channel (ifIndex 34) and
        four assigned profiles (Profile IDs 0, 8, 9 and 10) would
        have a ProfileIdList value of 0x00000022040008090A. A CM with a
        2 OFDM channel bonding group each with two assigned profiles
        (Profile IDs 0 and 15 on channel with ifIndex 34 and Profile IDs
        0 and 14 on channel with ifIndex 35) would have a ProfileIdList
        value of 0x0000002202000F0000002302000E).
        
        Note: the CCAP must not include the transitional profile or
        test profile in the ProfileIdList.
        
        Note that octet string lengths greater than 18 are optional.
        
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns a zero length octet string.";
      }

      leaf docsIf31CmtsCmRegStatusUsProfileIucList {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.3";
        type binary {
          length "0|6..72";
        }
        description
          "This attribute is a variable length series of hexadecimal
        octets where each series entry consists of the following fields
        (encoded in the following order):
        
        - The ifIndex (4 octets) of the OFDMA channel where the
        Profile IUCs are assigned.
        
        - The number or count of Data IUCs (1 octet with valid values
        of 1-2) assigned to this CM on that channel.
        
        - The list of Data IUCs (1 octet each with valid values of
        5, 6, 9-13) assigned to this CM on that channel.
        
        The CCAP encodes each OFDMA channel in a CM's TCS as a separate
        n-octet entry in the UsProfileIucList.
        
        Examples: a CM with a single OFDMA channel (ifIndex 36) and two
        assigned Data IUCs (5 and 6) would have a ProfileIdList value of
        0x00000024020506. A CM with a 2 OFDMA channel bonding group each
        with one assigned Data IUC (IUC 5 on channel with ifIndex 34 and
        IUC 13 on channel with ifIndex 35) would have a UsProfileIucList
        value of 0x00000022010500000023010D).
        
        Note: the CCAP MUST NOT include transitional IUCs or test IUCs in
        the UsProfileIucList.
        
        Note that octet string lengths greater than 18 are optional.
        
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns a zero length octet string.";
      }

      leaf docsIf31CmtsCmRegStatusTcsPhigh {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.4";
        type uint32 {
          range "0|68..320";
        }
        description
          "This attribute reports the P1.6hi value for the CM's Transmit
        Channel Set.
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns zero.";
      }

      leaf docsIf31CmtsCmRegStatusTcsDrwTop {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.5";
        type uint32;
        units "dBmV";
        description
          "This attribute reports the level of the top of the Dynamic Range
        Window. The value is expressed in dBmV and is the result of a
        calculation equal to P1.6hi - P1.6load_min_set.
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns zero.";
      }

      leaf docsIf31CmtsCmRegStatusMinUsableDsFreq {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.6";
        type uint32;
        units "Hz";
        description
          "This attribute is the higher of the CCAP's minimum supported
        downstream frequency and the CM's minimum supported downstream
        frequency. It indicates the lowest downstream frequency the
        CCAP can use to communicate with this CM taking into account
        the capabilities of both devices.
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns zero.";
      }

      leaf docsIf31CmtsCmRegStatusMaxUsableDsFreq {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.7";
        type uint32;
        units "Hz";
        description
          "This attribute is the lower of the CCAP's maximum supported
        downstream frequency and the CM's maximum supported downstream
        frequency. It indicates the highest downstream frequency the
        CCAP can use to communicate with this CM taking into account
        the capabilities of both devices.
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns zero.";
      }

      leaf docsIf31CmtsCmRegStatusMaxUsableUsFreq {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.8";
        type uint32;
        units "Hz";
        description
          "This attribute is the lower of the CCAP's maximum supported
        upstream frequency and the CM's maximum supported upstream
        frequency. It indicates the highest upstream frequency the CCAP
        can use to receive signals from this CM taking into account the
        capabilities of both devices.
        
        Note: there is no minimum usable upstream frequency attribute as
        this is 5MHz for both CCAP and CM devices.
        
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns zero.";
      }

      leaf docsIf31CmtsCmRegStatusPartialSvcState {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.9";
        type PartialServiceType;
        description
          "This attribute indicates the type of 'bonding group' issue
        that this CM is experiencing, based on what the MAC-layer
        shows. See PartialServiceType for further detail.
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns 'other'.";
      }

      leaf docsIf31CmtsCmRegStatusPartialChanState {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.3.1.10";
        type PartialChannelType;
        description
          "This attribute is a bit-field which indicates the type of OFDM
        channel issue that this CM is experiencing, based on what the
        MAC-layer shows. See PartialChannelType for further detail.
        This object is applicable to DOCSIS 3.1 modems but not to prior
        versions of DOCSIS modems. If the CM is a pre-DOCSIS 3.1 modem,
        the CMTS returns 0x0 (no bits set).";
      }
    }

    augment /docs-if:DOCS-IF-MIB/docs-if:docsIfUpstreamChannelTable/docs-if:docsIfUpstreamChannelEntry {
      smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.31.1";
      description
        "The conceptual row of docsIf31CmUsScQamChanTable.
      For DOCSIS 3.1 CMs, an entry in this table exists for each
      ifEntry with an ifType of docsCableUpstream (129).";
      leaf docsIf31CmUsScQamChanTxPsd {
        smiv2:max-access "read-only";
        smiv2:oid "1.3.6.1.4.1.4491.2.1.28.1.31.1.1";
        type uint32;
        units "QuarterdBmV";
        description
          "This attribute represents P1.6r_n, the power spectral density
        in 1.6 MHz, for the associated SC-QAM upstream channel.";
      }
    }
  }  // module DOCS-IF31-MIB