[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 RFC 4546

     Internet Draft                                         Aviv Goren/David Raftus
     draft-ietf-ipcdn-docs-rfmibv2-03.txt                            Terayon/Imedia
     Expires: September 2002                                             March 2002
     Obsoletes: RFC2670
     
     
            Radio Frequency (RF) Interface Management Information Base
                        for DOCSIS 2.0 compliant RF interfaces
     
     Status of this Memo
     
        This document is an Internet-Draft and is in full conformance with
        all provisions of Section 10 of RFC2026.
     
        Internet-Drafts are working documents of the Internet Engineering
        Task Force (IETF), its areas, and its working groups.  Note that
        other groups may also distribute working documents as Internet-
        Drafts.
     
        Internet-Drafts are draft documents valid for a maximum of six months
        and may be updated, replaced, or obsoleted by other documents at any
        time.  It is inappropriate to use Internet-Drafts as reference
        material or to cite them other than as "work in progress."
     
        The list of current Internet-Drafts can be accessed at
        http://www.ietf.org/ietf/1id-abstracts.txt
     
        The list of Internet-Draft Shadow Directories can be accessed at
        http://www.ietf.org/shadow.html.
     
     Copyright Notice
     
        Copyright (C) The Internet Society (2002). All Rights Reserved.
     
     Abstract
     
        This memo is a draft revision of the standards track RFC-2670.
        Please see "Section 9 Changes from RFC2670" for a description of modifications.
        This document or its successor will obsolete RFC-2670 when accepted.
     
        This memo defines a portion of the Management Information Base (MIB)
        for use with network management protocols in the Internet community.
        In particular, it defines a basic set of managed objects for SNMP-
        based management of DOCSIS compliant Radio Frequency (RF) interfaces.
     
        This memo specifies a MIB module in a manner that is compliant to the
        SNMP SMIv2 [5][6][7].  The set of objects are consistent with the
        SNMP framework and existing SNMP standards.
     
     
     
     
     
     
     
     Goren/Raftus                                                     [Page 1]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     
     
     Table of Contents
     
        1 The SNMP Management Framework ................................... 3
        2 Glossary ........................................................ 4
        2.1 CATV .......................................................... 4
        2.2 Channel ....................................................... 4
        2.3 CM ............................................................ 4
        2.4 CMTS .......................................................... 4
        2.5 Codeword ...................................................... 4
        2.6 Data Packet ................................................... 4
        2.7 dBmV .......................................................... 4
        2.8 DOCSIS ........................................................ 5
        2.9 Downstream .................................................... 5
        2.10 Head-end ..................................................... 5
        2.11 MAC Packet ................................................... 5
        2.12 MCNS ......................................................... 5
        2.13 Mini-slot .................................................... 5
        2.14 QPSK ......................................................... 5
        2.15 QAM .......................................................... 5
        2.16 RF ........................................................... 5
        2.17 Symbol-times ................................................. 5
        2.18 Upstream ..................................................... 6
        3 Overview ........................................................ 6
        3.1 Structure of the MIB .......................................... 6
        3.1.1 docsIfBaseObjects ........................................... 6
        3.1.2 docsIfCmObjects ............................................. 7
        3.1.3 docsIfCmtsObjects ........................................... 7
        3.2 Relationship to the Interfaces MIB ............................ 7
        3.2.1 Layering Model .............................................. 7
        3.2.2 Virtual Circuits ............................................ 8
        3.2.3 ifTestTable ................................................. 9
        3.2.4 ifRcvAddressTable ........................................... 9
        3.2.5 ifEntry ..................................................... 9
        3.2.5.1 ifEntry for Downstream interfaces ......................... 9
        3.2.5.1.1 ifEntry for Downstream interfaces in Cable Modem
             Termination Systems .......................................... 9
        3.2.5.1.2 ifEntry for Downstream interfaces in Cable Modems ...... 11
        3.2.5.2 ifEntry for Upstream interfaces .......................... 12
        3.2.5.2.1  ifEntry for Upstream interfaces in Cable Modem
             Termination Systems ......................................... 13
        3.2.5.2.2 ifEntry for Upstream interfaces in Cable Modems ........ 15
        3.2.5.3 ifEntry for the MAC Layer ................................ 18
        4 Definitions .................................................... 20
        5 Acknowledgments ................................................ 79
        6 Revision Descriptions ...........................................79
        7 References ..................................................... 79
        8 Security Considerations ........................................ 81
        9 Changes from RFC2670 ........................................... 82
        10 Conflict Resolution with docsIfExt MIB ........................ 83
     
     Goren/Raftus               Expires September 2002                   [Page 2]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        11 Intellectual Property ..........................................84
        12 Author's Address .............................................. 84
        13 Full Copyright Statement ...................................... 85
     
     
     1.  The SNMP Management Framework
     
        The SNMP Management Framework presently consists of five major
        components:
     
        o   An overall architecture, described in RFC 2571 [1].
     
        o   Mechanisms for describing and naming objects and events for the
            purpose of management. The first version of this Structure of
            Management Information (SMI) is called SMIv1 and described in STD
            16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The
            second version, called SMIv2, is described in STD 58, RFC 2578
            [5], STD 58, RFC 2579 [6] and STD 58, RFC 2580 [7].
     
        o   Message protocols for transferring management information. The
            first version of the SNMP message protocol is called SNMPv1 and
            described in RFC 1157 [8]. A second version of the SNMP message
            protocol, which is not an Internet standards track protocol, is
            called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10].
            The third version of the message protocol is called SNMPv3 and
            described in RFC 1906 [10], RFC 2572 [11] and RFC 2574 [12].
     
        o   Protocol operations for accessing management information. The
            first set of protocol operations and associated PDU formats is
            described in STD 15, RFC 1157 [8]. A second set of protocol
            operations and associated PDU formats is described in RFC 1905
            [13].
     
        o   A set of fundamental applications described in RFC 2573 [14] and
            the view-based access control mechanism described in RFC 2575
            [15].
     
        A more detailed introduction to the current SNMP Management Framework
        can be found in RFC 2570 [21].
     
        Managed objects are accessed via a virtual information store, termed
        the Management Information Base or MIB.  Objects in the MIB are
        defined using the mechanisms defined in the SMI.
     
        This memo specifies a MIB module that is compliant to the SMIv2. A
        MIB conforming to the SMIv1 can be produced through the appropriate
        translations. The resulting translated MIB MUST be semantically
        equivalent, except where objects or events are omitted because no
        translation is possible (use of Counter64). Some machine readable
        information in SMIv2 will be converted into textual descriptions in
        SMIv1 during the translation process. However, this loss of machine
        readable information is not considered to change the semantics of the
     
     Goren/Raftus               Expires September 2002                   [Page 3]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        MIB.
     
     
     2.  Glossary
     
        The terms in this document are derived either from normal cable
        system usage, or from the documents associated with the Data Over
        Cable Service Interface Specification process.
     
     2.1.  CATV
     
        Originally "Community Antenna Television", now used to refer to any
        cable or hybrid fiber and cable system used to deliver video signals
        to a community.
     
     2.2.  Channel
     
        A specific frequency allocation with an RF medium, specified by
        channel width in Hertz (cycles per second) and by center frequency.
        Within the US Cable Systems, upstream channels are generally
        allocated from the 5-42MHz range while down stream channels are
        generally allocated from the 50-750MHz range depending on the
        capabilities of the given system.  The typical broadcast channel
        width in the US is 6MHz.  Upstream channel widths for DOCSIS vary.
     
        For European cable systems, upstream channels vary by country. The
        upper edge of upstream channel allocations vary between 25 MHz to 65
        MHz, and the lower edge of downstream channel allocations vary
        between 47 MHz and 87.5 MHz. The typical broadcast channel width in
        Europe is 8MHz. The actual parameters are of concern to systems
        deploying EuroDOCSIS technology.
     
     2.3.  CM   Cable Modem.
     
        A CM acts as a "slave" station in a DOCSIS compliant cable data
        system.
     
     2.4.  CMTS   Cable Modem Termination System.
     
        A generic term covering a cable bridge or cable router in a head-end.
        A CMTS acts as the master station in a DOCSIS compliant cable data
        system.  It is the only station that transmits downstream, and it
        controls the scheduling of upstream transmissions by its associated
        CMs.
     
     2.5.  Codeword
     
        See [25]. A characteristic of the Forward Error Correction scheme used
        above the RF media layer.
     
     2.6.  Data Packet
     
     
     Goren/Raftus               Expires September 2002                   [Page 4]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        The payload portion of the MAC Packet.
     
     2.7.  dBmV
     
        Decibel relative to one milli-volt. A measure of RF power.
     
     2.8.  DOCSIS
     
        "Data Over Cable Service Interface Specification".  A term referring to the
        ITU-T J.112 Annex B standard for cable modem systems [20].
     
     2.9.  Downstream
     
        The direction from the head-end towards the subscriber.
     
     2.10.  Head-end
     
        The origination point in most cable systems of the subscriber video
        signals.
     
     2.11.  MAC Packet
     
        A DOCSIS PDU.
     
     2.12.  MCNS
     
        "Multimedia Cable Network System".  Generally replaced in usage by
        DOCSIS.
     
     2.13.  Mini-slot
     
        See [25].  In general, an interval of time which is allocated by the
        CMTS to a given CM for that CM to transmit in an upstream direction.
     
     2.14.  QPSK   Quadrature Phase Shift Keying.
     
        A particular modulation scheme on an RF medium. See [19].
     
     2.15.  QAM   Quadrature Amplitude Modulation.
     
        A particular modulation scheme on RF medium.  Usually expressed
        with a number indicating the size of the modulation constellation
        (e.g. 16 QAM). See [19], or any other book on digital communications
        over RF for a complete explanation of this.
     
     2.16.  RF
     
        Radio Frequency.
     
     2.17.  Symbol-times
     
        See [25]. A characteristic of the RF modulation scheme.
     
     Goren/Raftus               Expires September 2002                   [Page 5]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     2.18.  Upstream
     
        The direction from the subscriber towards the head-end.
     
     3.  Overview
     
        This MIB provides a set of objects required for the management of
        MCNS/DOCSIS compliant Cable Modem (CM) and Cable Modem Termination
        System (CMTS) RF interfaces.  The specification is derived in part
        from the parameters and protocols described in DOCSIS Radio Frequency
        Interface Specification [25].
     
     3.1.  Structure of the MIB
     
        This MIB is structured as three groups:
     
        o    Management information pertinent to both Cable Modems (CM) and
             Cable Modem Termination Systems (CMTS) (docsIfBaseObjects).
     
        o    Management information pertinent to Cable Modems only
             (docsIfCmObjects).
     
        o    Management information pertinent to Cable Modem Termination
             Systems only (docsIfCmtsObjects).
     
        Tables within each of these groups group objects functionally - e.g.
        Quality of Service, Channel characteristics, MAC layer management,
        etc.  Rows created automatically (e.g. by the device according to the
        hardware configuration) may and generally will have a mixture of
        configuration and status objects within them.  Rows that are meant to
        be created by the management station are generally restricted to
        configuration (read-create) objects.
     
     3.1.1.  docsIfBaseObjects
     
        docsIfDownstreamChannelTable - This table describes the active
        downstream channels for a CMTS and the received downstream channel
        for a CM.
     
        docsIfUpstreamChannelTable - This table describes the active upstream
        channels for a CMTS and the current upstream transmission channel
        for a CM.
     
        docsIfQosProfileTable - This table describes the valid Quality of
        Service profiles for the cable data system.
     
        docsIfSignalQualityTable - This table is used to monitor RF signal
        quality characteristics of received signals.
     
        docsIfDocsisBaseCapability  - This object is used to indicate the highest level
        of DOCSIS version a cable device can support.
     
     Goren/Raftus               Expires September 2002                   [Page 6]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     3.1.2.  docsIfCmObjects
     
        docsIfCmMacTable - This table is used to monitor the DOCSIS MAC
        interface and can be considered an extension to the ifEntry.
     
        docsIfCmServiceTable - This table describes the upstream service
        queues available at this CM.  There is a comparable table at the
        CMTS, docsIfCmtsServiceEntry, which describes the service queues from
        the point of view of the CMTS.
     
     3.1.3.  docsIfCmtsObjects
     
        docsIfCmtsStatusTable - This table provides a set of aggregated
        counters which roll-up values and events that occur on the underlying
        sub-interfaces.
     
        docsIfCmtsCmStatusTable - This table is used to hold information
        about known (i.e. ranging, registered, and/or previously online)
        cable modems on the system serviced by this CMTS.
     
        docsIfCmtsServiceEntry - This table provides access to the
        information related to upstream service queues.
     
        docsIfCmtsModulationTable - This table allows control over the
        modulation profiles for RF channels associated with this CMTS.
     
        docsIfCmtsMacToCmTable - This table allows fast access into the
        docsIfCmtsCmTable via a MAC address (of the CM) interface.
     
     3.2.  Relationship to the Interfaces MIB
     
        This section clarifies the relationship of this MIB to the Interfaces
        MIB [17].  Several areas of correlation are addressed in the
        following subsections.  The implementer is referred to the Interfaces
        MIB document in order to understand the general intent of these
        areas.
     
     3.2.1.  Layering Model
     
        An instance of ifEntry exists for each RF Downstream interface, for
        each RF Upstream interface, for each Upstream logical Channel and for
        each RF MAC layer.
        The ifStackTable [17] MUST be implemented to identify relationships among
        sub-interfaces.
     
        The following example illustrates a CMTS MAC interface with one downstream
        and two upstream interfaces.
     
                                   | <== to network layer
             +------------------ --+-------------------------------+
             |                     RF MAC                          |
     
     Goren/Raftus               Expires September 2002                   [Page 7]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             +--+------------------+------------------------+------+
                |                  |                        |
        +-------+-----+     +------+------+          +------+------+
        | Downstream1 |     |  Upstream1  |          |  Upstream2  |
        |             |     |             |          |             |
        +-------------+     ++-----------++          ++-----------++
                             |           |            |           |
                        +----+----+ +----+----+  +----+----+ +----+----+
                        |  Ch-1   | |  Ch-2   |  |  Ch-1   | |  Ch-2   |
                        |(A/TDMA) | |(S-CDMA) |  |(A/TDMA) | |(S-CDMA) |
                        +---------+ +---------+  +---------+ +---------+
     
     
        As can be seen from this example, the RF MAC interface is layered on
        top of the downstream and upstream interfaces, and the RF Upstream interface
        is layered on top of an Upstream Logical Channels.
     
        In this example, the assignment of index values could be as follows:
     
        ifIndex       ifType                     Description
     
           2    docsCableMaclayer(127)           CATV MAC Layer
           3    docsCableDownstream(128)         CATV Downstream interface
           4    docsCableUpstream(129)           CATV Upstream interface
           5    docsCableUpstream(129)           CATV Upstream interface
           6    docsCableUpstreamChannel(205)    CATV Upstream Channel
           7    docsCableUpstreamChannel(205)    CATV Upstream Channel
           8    docsCableUpstreamChannel(205)    CATV Upstream Channel
           9    docsCableUpstreamChannel(205)    CATV Upstream Channel
     
     
           The corresponding ifStack entries would then be:
     
                | IfStackHigherLayer | ifStackLowerLayer |
                |         0          |         2         |
                |         2          |         3         |
                |         2          |         4         |
                |         2          |         5         |
                |         4          |         6         |
                |         4          |         7         |
                |         5          |         8         |
                |         5          |         9         |
                |         3          |         0         |
                |         6          |         0         |
                |         7          |         0         |
                |         8          |         0         |
                |         9          |         0         |
     
        The same interface model can also be used in Telephony or Telco
        Return systems.  A pure Telco Return system (Cable Modem as well as
        Cable Modem Termination System) would not have upstream, but only
        downstream cable channels.  Systems supporting both Telco Return and
     
     Goren/Raftus               Expires September 2002                   [Page 8]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        cable upstream channels can use the above model without modification.
     
        Telco Return Upstream channel(s) are handled by the appropriate MIBs,
        such as PPP or Modem MIBs.
     
     3.2.2.  Virtual Circuits
     
        This medium does not support virtual circuits and this area is not
        applicable to this MIB.
     
     3.2.3.  ifTestTable
     
        The ifTestTable is optional for Docsis CM/CMTS implementations, but is
        not specifically influenced by the RF mib.
     
     3.2.4.  ifRcvAddressTable
     
        The ifRcvAddressTable is optional for Docsis CM/CMTS implementations, but is
        not specifically influenced by the RF mib.
     
     3.2.5.  ifEntry
     
        This section documents only the differences from the requirements
        specified in the Interfaces MIB.  See that MIB for columns omitted
        from the descriptions below.
     
     3.2.5.1.  ifEntry for Downstream interfaces
     
        The ifEntry for Downstream interfaces supports the
        ifGeneralInformationGroup and the ifPacketGroup of the Interfaces
        MIB.  This is an output only interface at the CMTS and all input
        status counters - ifIn* - will return zero.  This is an input only
        interface at the CM and all output status counters - ifOut* - will
        return zero.
     
     3.2.5.1.1.  ifEntry for Downstream interfaces in Cable Modem Termination
                 Systems
     
        ifTable           Comments
        ==============    ===========================================
        ifIndex           Each RF Cable Downstream interface is represented
                          by an ifEntry.
     
        ifType            The IANA value of docsCableDownstream(128).
     
        ifSpeed           Return the speed of this downstream channel.
                          The returned value is the raw bandwidth in bits/s
                          of this interface. This is the symbol rate
                          multiplied with the number of bits per symbol.
     
        ifHighSpeed       Return the speed of this downstream channel.
                          The returned value is the raw bandwidth in megabits/s
     
     Goren/Raftus               Expires September 2002                   [Page 9]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                          of this interface. This is the symbol rate
                          multiplied with the number of bits per symbol.
     
        ifPhysAddress     Return an empty string.
     
        ifAdminStatus     The administrative status of this interface.
     
        ifOperStatus      The current operational status of this interface.
     
        ifMtu             The size of the largest frame which can be
                          sent on this interface, specified in octets.
                          The value includes the length of the MAC header.
     
        ifInOctets        Return zero.
        ifHCInOctets
     
        ifInUcastPkts     Return zero.
        ifHCInUcastPkts
     
        ifInMulticastPkts Return zero.
        ifHCInMulticastPkts
     
        ifInBroadcastPkts Return zero.
        ifHCInBroadcastPkts
     
        ifInDiscards      Return zero.
     
        ifInErrors        Return zero.
     
        ifInUnknownProtos Return zero.
     
        ifOutOctets       The total number of octets transmitted on this
        ifHCOutOctets     interface. This includes MAC packets as well as
                          data packets, and includes the length of the MAC
                          header.
     
        ifOutUcastPkts    The number of Unicast packets transmitted on this
        ifHCOutUcastPkts  interface. This includes MAC packets as well as
                          data packets.
     
        ifOutMulticastPkts
        ifHCOutMulticastPkts
                          Return the number of Multicast packets transmitted
                          on this interface.
                          This includes MAC packets as well as data packets.
     
        ifOutBroadcastPkts
        ifHCOutBroadcastPkts
                          Return the number of broadcast packets transmitted
                          on this interface.
                          This includes MAC packets as well as data packets.
     
     
     Goren/Raftus               Expires September 2002                  [Page 10]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        ifOutDiscards     The total number of outbound packets which
                          were discarded. Possible reasons are:
                          buffer shortage.
     
        ifOutErrors       The number of packets which could not be
                          transmitted due to errors.
     
        ifPromiscuousMode Return false.
     
     
     3.2.5.1.2.  ifEntry for Downstream interfaces in Cable Modems
     
        ifTable           Comments
        ==============    ===========================================
        ifIndex           Each RF Cable Downstream interface is represented
                          by an ifEntry.
     
        ifType            The IANA value of docsCableDownstream(128).
     
        ifSpeed           Return the speed of this downstream channel.
                          The returned value the raw bandwidth in bits/s
                          of this interface. This is the symbol rate
                          multiplied with the number of bits per symbol.
     
        ifHighSpeed       Return the speed of this downstream channel.
                          The returned value the raw bandwidth in megabits/s
                          of this interface. This is the symbol rate
                          multiplied with the number of bits per symbol.
     
        ifPhysAddress     Return an empty string.
     
        ifAdminStatus     The administrative status of this interface.
     
        ifOperStatus      The current operational status of this interface.
     
        ifMtu             The size of the largest frame which can be
                          received from this interface, specified in octets.
                          The value includes the length of the MAC header.
     
        ifInOctets        The total number of octets received on this
        ifHCInOctets      interface. This includes data packets as well as
                          MAC layer packets, and includes the length of the
                          MAC header.
     
        ifInUcastPkts     The number of Unicast packets received on this
        ifHCInUcastPkts   interface. This includes data packets as well as
                          MAC layer packets.
     
        ifInMulticastPkts
        ifHCInMulticastPkts
                          Return the number of Multicast packets received
                          on this interface. This includes data packets as
     
     Goren/Raftus               Expires September 2002                  [Page 11]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                          well as MAC layer packets.
     
        ifInBroadcastPkts
        ifHCInBroadcastPkts
                          Return the number of Broadcast packets received
                          on this interface. This includes data packets
                          as well as MAC layer packets.
     
        ifInDiscards      The total number of received packets that have
                          been discarded.
                          The possible reasons are: buffer shortage.
     
        ifInErrors        The number of inbound packets that contained
                          errors preventing them from being deliverable
                          to higher layers.
                          Possible reasons are: MAC FCS error.
     
        ifInUnknownProtos The number of frames with an unknown packet type.
                          These are MAC frames with an unknown packet type.
     
        ifOutOctets       Return zero.
        ifHCOutOctets
     
        ifOutUcastPkts    Return zero.
        ifHCOutUcastPkts
     
        ifOutMulticastPkts
        ifHCOutMulticastPkts
                          Return zero.
     
        ifOutBroadcastPkts
        ifHCOutBroadcastPkts
                          Return zero.
     
        ifOutDiscards     Return zero.
     
        ifOutErrors       Return zero.
     
        ifPromiscuousMode Refer to the Interfaces MIB.
     
     
     3.2.5.2.  ifEntry for Upstream interfaces
     
        Each supported interface of the type docsCableUpstream(129) must have a
        corresponding ifEntry.
        The ifEntry for Upstream interfaces supports the
        ifGeneralInformationGroup and the ifPacketGroup of the Interfaces
        MIB.  This is an input only interface at the CMTS and all output
        status counters - ifOut* - will return zero.  This is an output only
        interface at the CM and all input status counters - ifIn* - will
        return zero.
     
     
     Goren/Raftus               Expires September 2002                  [Page 12]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     
     3.2.5.2.1.  ifEntry for Upstream interfaces in Cable Modem Termination
                 Systems
     
     
        ifTable           Comments
        ==============    ===========================================
        ifIndex           Each RF Cable Upstream interface is represented
                          by an ifEntry.
     
        ifType            The IANA value of docsCableUpstream (129).
     
        ifSpeed           Return the maximum channel throughput (not payload
                          throughput) supported by the interface.
                          The maximum throughput is calculated for the case where
                          upstream channels are configured to maximize interface
                          throughput.
     
        ifHighSpeed       Return the maximum channel throughput (not payload
                          throughput) supported by the interface.
                          The maximum throughput is calculated for the case where
                          upstream channels are configured to maximize interface
                          throughput. Units for this object are (1/1 000 000) *
                          IfSpeed.
     
        ifPhysAddress     Return an empty string.
     
        ifAdminStatus     The administrative status of this interface.
                          This reflect the total status of all the channels
                          under this interface. So if at least one channel has a
                          physical connection this interface has connection.
                          Any SNMP SET on this interface will cause a SET to all the
                          channels under this interface.
     
     
        ifOperStatus      The current operational status of this interface.
                          This reflects the total status of all the channels
                          under this interface. So if at least one channel has a
                          physical connection this interface has connection.
     
     
        ifMtu             The size of the largest frame which can be
                          transmitted on this interface, specified in octets.
                          The value includes the length of the MAC header.
                          This is the maximum of all the ifMtu of all the channels
                          under this interface.
     
        ifInOctets        The total (sum) number of octets received on all
        ifHCInOctets      the Upstream channels under this
                          interface. This includes data packets as well as
                          MAC layer packets, and includes the length of the
     
     Goren/Raftus               Expires September 2002                  [Page 13]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                          MAC header.
     
        ifInUcastPkts     The total number of Unicast packets received on all the
        ifHCInUcastPkts   upstream channels under this
                          interface. This includes data packets as well as
                          MAC layer packets.
     
        ifInMulticastPkts
        ifHCInMulticastPkts
                          Return the total number of Multicast packets received
                          on all the Upstream channels under this interface.
                          This includes data packets as
                          well as MAC layer packets.
     
        ifInBroadcastPkts
        ifHCInBroadcastPkts
                          Return the total number of Broadcast packets received
                          on all the Upstream channels under this interface.
                          This includes data packets
                          as well as MAC layer packets.
     
        ifInDiscards      The total number of received packets, which have
                          been discarded on all the Upstream channels under this
                          interface.
                          The possible reasons are: buffer shortage.
     
        ifInErrors        The total number of inbound packets that contained
                          errors preventing them from being deliverable
                          to higher layers.
                          Possible reasons are: MAC FCS error.
     
        ifInUnknownProtos The total number of frames with an unknown packet type.
                          These are MAC frames with an unknown packet type.
     
        ifOutOctets       Return zero.
        ifHCOutOctets
     
        ifOutUcastPkts    Return zero.
        ifHCOutOctets
     
        ifOutMulticastPkts
        ifHCOutMulticastPkts
                          Return zero.
     
        ifOutBroadcastPkts
        ifHCOutBroadcastPkts
                          Return zero.
     
        ifOutDiscards     Return zero.
     
        ifOutErrors       Return zero.
     
     
     Goren/Raftus               Expires September 2002                  [Page 14]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     3.2.5.2.2.  ifEntry for Upstream interfaces in Cable Modems
     
     
        ifTable           Comments
        ==============    ===========================================
        ifIndex           Each RF Cable Upstream interface is represented
                          by an ifEntry.
     
        ifType            The IANA value of docsCableUpstream (129).
     
        ifSpeed           Return the speed of this upstream interface.
                          The returned value is the raw bandwidth
                          in bits/s of this interface.
     
        ifHighSpeed       Return the speed of this upstream interface.
                          The returned value is the raw bandwidth
                          in megabits/s of this interface.
     
     
        ifPhysAddress     Return an empty string.
     
        ifAdminStatus     The administrative status of this interface.
     
        ifOperStatus      The current operational status of this interface.
     
        ifMtu             The size of the largest frame which can be
                          transmitted on this interface, specified in octets.
                          The value includes the length of the MAC header.
     
        ifInOctets        Return zero.
        ifHCInOctets
     
        ifInUcastPkts     Return zero.
        ifHCInUcastPkts
                                                                                                                                   \
        ifInMulticastPkts Return zero.
        ifHCInMulticastPkts
     
        ifInBroadcastPkts Return zero.
        ifHCInBroadcastPkts
     
        ifInDiscards      Return zero.
     
        ifInErrors        Return zero.
     
        ifInUnknownProtos Return zero.
     
        ifOutOctets       The total number of octets transmitted on this
        ifHCOutOctets     interface. This includes MAC packets as well as
                          data packets, and includes the length of the MAC
                          header.
     
     Goren/Raftus               Expires September 2002                  [Page 15]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
        ifOutUcastPkts    The number of Unicast packets transmitted on this
        ifHCOutUcastPkts  interface. This includes MAC packets as well as
                          data packets.
     
        ifOutMulticastPkts
        ifHCOutMulticastPkts
                          Return the number of Multicast packets transmitted
                          on this interface.
                          This includes MAC packets as well as data packets.
     
        ifOutBroadcastPkts
        ifHCOutBroadcastPkts
                          Return the number of broadcast packets transmitted
                          on this interface.
                          This includes MAC packets as well as data packets.
     
        ifOutDiscards     The total number of outbound packets which
                          were discarded. Possible reasons are:
                          buffer shortage.
     
        ifOutErrors       The number of packets which could not be
                          transmitted due to errors.
     
        ifPromiscuousMode Return false.
     
     
     
     3.2.5.3.  ifEntry for Upstream channels
     
        Each supported channel of the type docsCableUpstreamChannel(205) must have a
        corresponding ifEntry.
        The ifEntry for Upstream channels supports the
        ifGeneralInformationGroup and the ifPacketGroup of the Interfaces
        MIB.  This is an input only interface at the CMTS and all output
        status counters - ifOut* - will return zero. At the time of this mib creation,
        DOCSIS CMs are not required to support logical upstream channels.
     
     
     3.2.5.3.1.  ifEntry for Upstream Channels in Cable Modem Termination
                 Systems
     
        ifTable           Comments
        ==============    ===========================================
        ifIndex           Each RF Cable Upstream channel is represented
                          by an ifEntry.
     
        ifType            The IANA value of docsCableUpstreamChannel (205).
     
        ifSpeed           Return the speed of this upstream channel.
                          The returned value is the raw bandwidth
                          in bits/s of this channel.
     
     Goren/Raftus               Expires September 2002                  [Page 16]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
        ifHighSpeed       Return the speed of this upstream channel.
                          The returned value is the raw bandwidth
                          in megabits/s of this channel.
     
     
        ifPhysAddress     Return an empty string.
     
        ifAdminStatus     The administrative status of this interface.
     
        ifOperStatus      The current operational status of this interface.
     
        ifMtu             The size of the largest frame which can be
                          received on this interface, specified in octets.
                          The value includes the length of the MAC header.
     
        ifInOctets        The total number of octets received on this
                          interface. This includes data packets as well as
                          MAC layer packets, and includes the length of the
                          MAC header.
     
        ifInUcastPkts     The number of Unicast packets received on this
        ifHCInUcastPkts   interface. This includes data packets as well as
                          MAC layer packets.
     
        ifInMulticastPkts
        ifHCInMulticastPkts
                          Return the number of Multicast packets received
                          on this interface. This includes data packets as
                          well as MAC layer packets.
     
        ifInBroadcastPkts
        ifHCInBroadcastPkts
                          Return the number of Broadcast packets received
                          on this interface. This includes data packets
                          as well as MAC layer packets.
     
        ifInDiscards      The total number of received packets that have
                          been discarded.
                          The possible reasons are: buffer shortage.
     
        ifInErrors        The number of inbound packets that contained
                          errors preventing them from being deliverable
                          to higher layers.
                          Possible reasons are: MAC FCS error.
     
        ifInUnknownProtos The number of frames with an unknown packet type.
                          These are MAC frames with an unknown packet type.
     
        ifOutOctets       Return zero.
        ifHCOutOctets
     
     
     Goren/Raftus               Expires September 2002                  [Page 17]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        ifOutUcastPkts    Return zero.
        ifHCOutUcastPkts
     
        ifOutMulticastPkts
        ifHCOutMulticastPkts
                          Return zero.
     
        ifOutBroadcastPkts
        ifHCOutBroadcastPkts
                          Return zero.
     
        ifOutDiscards     Return zero.
     
        ifOutErrors       Return zero.
     
     
     
     3.2.5.4.  ifEntry for the MAC Layer
     
        The ifEntry for the MAC Layer supports the ifGeneralInformationGroup
        and the ifPacketGroup of the Interfaces MIB.  This interface provides
        an aggregate view of status for the lower level Downstream and
        Upstream interfaces.
     
        ifTable           Comments
        ==============    ===========================================
        ifIndex           Each RF Cable MAC layer entity is represented
                          by an ifEntry.
     
        ifType            The IANA value of docsCableMaclayer(127).
     
        ifSpeed           Return zero.
     
        ifPhysAddress     Return the physical address of this interface.
     
        ifAdminStatus     The administrative status of this interface.
     
        ifOperStatus      The current operational status of the MAC
                          layer interface.
     
        ifHighSpeed       Return zero.
     
        ifMtu             Return 1500.
     
        ifInOctets        The total number of data octets received on this
        ifHCInOctets      interface, targeted for upper protocol layers.
     
        ifInUcastPkts     The number of Unicast packets received on this
        ifHCInUcastPkts   interface, targeted for upper protocol layers.
     
        ifInMulticastPkts
        ifHCInMulticastPkts
     
     Goren/Raftus               Expires September 2002                  [Page 18]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                          Return the number of Multicast packets received
                          on this interface, targeted for upper protocol
                          layers.
     
        ifInBroadcastPkts
        ifHCInBroadcastPkts
                          Return the number of Broadcast packets received
                          on this interface, targeted for upper protocol
                          layers.
     
        ifInDiscards      The total number of received packets that have
                          been discarded.
                          The possible reasons are: buffer shortage.
     
        ifInErrors        The number of inbound packets that contained
                          errors preventing them from being deliverable
                          to higher layers.
                          Possible reasons are: data packet FCS error,
                          invalid MAC header.
     
        ifInUnknownProtos The number of frames with an unknown packet type.
                          This is the number of data packets targeted for
                          upper protocol layers with an unknown packet type.
     
        ifOutOctets       The total number of octets, received from upper
        ifHCOutOctets     protocol layers and transmitted on this interface.
     
        ifOutUcastPkts    The number of Unicast packets, received from upper
        ifHCOutUcastPkts  protocol layers and transmitted on this interface.
     
        ifOutMulticastPkts
        ifHCOutMulticastPkts
                          Return the number of Multicast packets received
                          from upper protocol layers and transmitted on this
                          interface.
     
     
     
        ifOutBroadcastPkts
        ifHCOutBroadcastPkts
                          Return the number of broadcast packets received
                          from upper protocol layers and transmitted on this
                          interface.
     
        ifOutDiscards     The total number of outbound packets which
                          were discarded. Possible reasons are:
                          buffer shortage.
     
        ifOutErrors       The number of packets which could not be
                          transmitted due to errors.
     
        ifPromiscuousMode Refer to the Interfaces MIB.
     
     Goren/Raftus               Expires September 2002                  [Page 19]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     
     
     4.  Definitions
     
     DOCS-IF-MIB DEFINITIONS ::= BEGIN
     
       IMPORTS
             MODULE-IDENTITY,
             OBJECT-TYPE,
       -- do not import        BITS,
             Unsigned32,
             Integer32,
             Counter32,
             Counter64,
             TimeTicks,
             IpAddress,
             transmission
                     FROM SNMPv2-SMI
             TEXTUAL-CONVENTION,
             MacAddress,
             RowStatus,
             TruthValue,
             TimeInterval,
             TimeStamp
                     FROM SNMPv2-TC
             OBJECT-GROUP,
     
             MODULE-COMPLIANCE
                     FROM SNMPv2-CONF
             ifIndex, InterfaceIndexOrZero
                     FROM IF-MIB
             InetAddressType,
             InetAddress
                     FROM INET-ADDRESS-MIB;
     
     docsIfMib MODULE-IDENTITY
             LAST-UPDATED    "0203170000Z" -- March 17, 2002
             ORGANIZATION    "IETF IPCDN Working Group"
             CONTACT-INFO
                 "        Aviv Goren
                  Postal: Terayon
                          2952 Bunker Hill Lane
                          Santa Clara, CA
                          U.S.A.
                  Phone:  +1 408 727 4400
                  E-mail: aviv.goren@terayon.com
     
                          David Raftus
                  Postal: Imedia Semiconductor
                          340 Terry Fox Drive, Suite 202
                          Ottawa Ontario
     
     Goren/Raftus               Expires September 2002                  [Page 20]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                          Canada
                  Phone:  +1 613 592 1052
                  E-mail: david.raftus@imedia.com
     
                  IETF IPCDN Working Group
                  General Discussion: ipcdn@ietf.org
                  Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn
                  Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn
                  Co-chairs: Richard Woundy, rwoundy@cisco.com
                             Andrew Valentine, a.valentine@eu.hns.com"
             DESCRIPTION
                 "This is the MIB Module for DOCSIS 2.0 compliant Radio
                  Frequency (RF) interfaces in Cable Modems (CM) and
                  Cable Modem Termination Systems (CMTS)."
             REVISION "0203170000Z"
             DESCRIPTION
                 "Modified by David Raftus to add new textual convention
                  describing upstream modulation status. Also clarified
                  some object descriptions, fixed error in
                  docsIfSignalQualityEntry, fixed upstreamTable compliance
                  statements."
             REVISION "0202070000Z"
             DESCRIPTION
                 "Modified by David Raftus to add capability to adjust
                  and verify upstream channel parameters as a group.
                  Also adjusted syntax and clarified descriptions of
                  selected objects. "
             REVISION "0111200000Z"
             DESCRIPTION
                 "Modified by Aviv Goren and David Raftus to accommodate
                  Docsis 2.0 Advanced Phy capabilities, as well as to
                  incorporate objects from the docsIfExt mib. "
             REVISION "0102230000Z"
             DESCRIPTION
                 "Modified by Rich Woundy to use IPv6-friendly
                  address objects, to accommodate EuroDOCSIS, and
                  to correct the SYNTAX of various objects."
             REVISION "9908190000Z"
             DESCRIPTION
                 "Initial Version, published as RFC 2670.
                  Modified by Mike StJohns to fix problems identified by
                  the first pass of the MIB doctor.  Of special note,
                  docsIfRangingResp and docsIfCmtsInsertionInterval were
                  obsoleted and replaced by other objects with the same
                  functionality, but more appropriate SYNTAX."
             ::= { transmission 127 }
     
     
     
     -- Textual Conventions
     
     TenthdBmV ::= TEXTUAL-CONVENTION
     
     Goren/Raftus               Expires September 2002                  [Page 21]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             DISPLAY-HINT "d-1"
             STATUS       current
             DESCRIPTION
                 "This data type represents power levels that are normally
                  expressed in dBmV. Units are in tenths of a dBmV;
                  for example, 5.1 dBmV will be represented as 51."
             SYNTAX       Integer32
     
     TenthdB ::= TEXTUAL-CONVENTION
             DISPLAY-HINT "d-1"
             STATUS       current
             DESCRIPTION
                 "This data type represents power levels that are normally
                  expressed in dB. Units are in tenths of a dB;
                  for example, 5.1 dB will be represented as 51."
             SYNTAX       Integer32
     
     DocsisVersion ::= TEXTUAL-CONVENTION
            STATUS          current
            DESCRIPTION     "Indicates the DOCSIS version number."
            SYNTAX          INTEGER {
                docsis10 (1),
                docsis11 (2),
                docsis20 (3)
            }
     
     DocsisQosVersion ::= TEXTUAL-CONVENTION
            STATUS          current
            DESCRIPTION     "Indicates the quality of service level."
            SYNTAX          INTEGER {
                docsis10 (1),
                docsis11 (2)
            }
     
     DocsisUpstreamType ::= TEXTUAL-CONVENTION
            STATUS          current
            DESCRIPTION     "Indicates the DOCSIS Upstream Channel Type."
            SYNTAX          INTEGER {
                tdma (1),
                atdma (2),
                scdma (3),
                tdmaAndAtdma (4)
            }
     
     DocsisUpstreamTypeStatus ::= TEXTUAL-CONVENTION
            STATUS          current
            DESCRIPTION     "Indicates the DOCSIS Upstream Channel Type Status.
                             The shared channel indicator type is not valid, since
                             this type is used to specifically identify PHY mode."
            SYNTAX          INTEGER {
                tdma (1),
                atdma (2),
     
     Goren/Raftus               Expires September 2002                  [Page 22]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                scdma (3)
            }
     
     
     docsIfMibObjects  OBJECT IDENTIFIER ::= { docsIfMib 1 }
     docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 }
     docsIfCmObjects   OBJECT IDENTIFIER ::= { docsIfMibObjects 2 }
     docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 }
     
     --
     -- BASE GROUP
     --
     
     --
     -- The following table is implemented on both the Cable Modem (CM)
     -- and the Cable Modem Termination System (CMTS). This table is
     -- read only for the CM.
     --
     
     
     docsIfDownstreamChannelTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfDownstreamChannelEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "This table describes the attributes of downstream
                  channels (frequency bands)."
             REFERENCE
                 "Document [25] from References, Table 6-12 and Table 6-13."
             ::= { docsIfBaseObjects 1 }
     
     docsIfDownstreamChannelEntry OBJECT-TYPE
             SYNTAX      DocsIfDownstreamChannelEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "An entry provides a list of attributes for a single
                  Downstream channel.
                  An entry in this table exists for each ifEntry with an
                  ifType of docsCableDownstream(128)."
             INDEX { ifIndex }
             ::= { docsIfDownstreamChannelTable 1 }
     
     DocsIfDownstreamChannelEntry ::= SEQUENCE {
                 docsIfDownChannelId               Integer32,
                 docsIfDownChannelFrequency        Integer32,
                 docsIfDownChannelWidth            Integer32,
                 docsIfDownChannelModulation       INTEGER,
                 docsIfDownChannelInterleave       INTEGER,
                 docsIfDownChannelPower            TenthdBmV,
                 docsIfDownChannelAnnex            INTEGER
             }
     
     Goren/Raftus               Expires September 2002                  [Page 23]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfDownChannelId OBJECT-TYPE
             SYNTAX      Integer32 (0..255)
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The Cable Modem Termination System (CMTS) identification
                  of the 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."
             ::= { docsIfDownstreamChannelEntry 1 }
     
     docsIfDownChannelFrequency  OBJECT-TYPE
             SYNTAX      Integer32 (0..1000000000)
             UNITS       "hertz"
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The center of the downstream frequency associated with
                  this channel. This object will return the current tuner
                  frequency. If a CMTS provides IF output, this object
                  will return 0, unless this CMTS is in control of the
                  final downstream RF frequency.  See the associated
                  compliance object for a description of valid frequencies
                  that may be written to this object."
             REFERENCE
                 "Document [25] from References, Tables 4-1, 6-14."
             ::= { docsIfDownstreamChannelEntry 2 }
     
     docsIfDownChannelWidth  OBJECT-TYPE
             SYNTAX      Integer32 (0..16000000)
             UNITS       "hertz"
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The bandwidth of this downstream channel. Most
                  implementations are expected to support a channel width
                  of 6 MHz (North America) and/or 8 MHz (Europe).  See the
                  associated compliance object for a description of the
                  valid channel widths for this object."
             REFERENCE
                 "Document [25] from References, Table 6-14."
             ::= { docsIfDownstreamChannelEntry 3 }
     
     docsIfDownChannelModulation OBJECT-TYPE
             SYNTAX      INTEGER {
                 unknown(1),
                 other(2),
                 qam64(3),
                 qam256(4)
             }
     
     Goren/Raftus               Expires September 2002                  [Page 24]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The modulation type associated with this downstream
                  channel. If the interface is down, this object either
                  returns the configured value (CMTS), the most current
                  value (CM), or the value of unknown(1).  See the
                  associated conformance object for write conditions and
                  limitations. See the reference for specifics on the
                  modulation profiles implied by qam64 and qam256."
             REFERENCE
                 "Document [25] from References, Table 6-14."
             ::= { docsIfDownstreamChannelEntry 4 }
     
     docsIfDownChannelInterleave OBJECT-TYPE
             SYNTAX      INTEGER {
                 unknown(1),
                 other(2),
                 taps8Increment16(3),
                 taps16Increment8(4),
                 taps32Increment4(5),
                 taps64Increment2(6),
                 taps128Increment1(7),
                 taps12increment17(8)
             }
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The Forward Error Correction (FEC) interleaving used
                  for this downstream channel.
                  Values are defined as follows:
                  taps8Increment16(3):   protection 5.9/4.1 usec,
                                         latency .22/.15 msec
                  taps16Increment8(4):   protection 12/8.2 usec,
                                         latency .48/.33 msec
                  taps32Increment4(5):   protection 24/16 usec,
                                         latency .98/.68 msec
                  taps64Increment2(6):   protection 47/33 usec,
                                         latency 2/1.4 msec
                  taps128Increment1(7):  protection 95/66 usec,
                                         latency 4/2.8 msec
                  taps12increment17(8):  protection 18/14 usec,
                                         latency 0.43/0.32 msec
                                         taps12increment17 is implemented in
                                         conformance with EuroDOCSIS document
                                         'Adapted MIB-definitions - and a
                                         clarification for MPEG-related issues - for
                                         EuroDOCSIS cable modem systems' by tComLabs
                                         and should only be used for a EuroDOCSIS MAC
                                         interface.
     
                  If the interface is down, this object either returns
     
     Goren/Raftus               Expires September 2002                  [Page 25]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  the configured value (CMTS), the most current value (CM),
                  or the value of unknown(1).
                  The value of other(2) is returned if the interleave
                  is known but not defined in the above list.
                  See the associated conformance object for write
                  conditions and limitations. See the reference for the FEC
                  configuration described by the setting of this object."
             REFERENCE
                 "Document [25] from References, Table 6-13."
             ::= { docsIfDownstreamChannelEntry 5 }
     
     docsIfDownChannelPower OBJECT-TYPE
             SYNTAX      TenthdBmV
             UNITS       "dBmV"
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "At the CMTS, the operational transmit power. At the CM,
                  the received power level. May be set to zero at the CM
                  if power level measurement is not supported.
                  If the interface is down, this object either returns
                  the configured value (CMTS), the most current value (CM)
                  or the value of 0. See the associated conformance object
                  for write conditions and limitations. See the reference
                  for recommended and required power levels."
             REFERENCE
                 "Document [25] from References,Table 6-15."
             ::= { docsIfDownstreamChannelEntry 6 }
     
     docsIfDownChannelAnnex OBJECT-TYPE
             SYNTAX      INTEGER {
                 unknown(1),
                 other(2),
                 annexA(3),
                 annexB(4),
                 annexC(5)
             }
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The value of this object indicates the conformance of
                  the implementation to important regional cable standards.
                  annexA : Annex A from ITU-J83 is used.
                  annexB : Annex B from ITU-J83 is used.
                  annexC : Annex C from ITU-J83 is used.
                  AnnexB is used for DOCSIS implementations"
             REFERENCE
                 "Document [28] from References, Section 2.2"
             ::= { docsIfDownstreamChannelEntry 7 }
     
     --
     -- The following table is implemented on both the CM and the CMTS.
     
     Goren/Raftus               Expires September 2002                  [Page 26]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     -- For the CM, only attached channels appear in the table.  For the
     -- CM, this table is read only as well.
     --
     
     docsIfUpstreamChannelTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfUpstreamChannelEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "This table describes the attributes of attached upstream
                  channels."
             ::= { docsIfBaseObjects 2 }
     
     docsIfUpstreamChannelEntry OBJECT-TYPE
             SYNTAX      DocsIfUpstreamChannelEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "List of attributes for a single upstream channel. For
                  Docsis 2.0 CMTSs, an entry in this table exists for
                  each ifEntry with an ifType of docsCableUpstreamChannel (205).
                  For Docsis 1.x CM/CMTSs and Docsis 2.0 CMs, an entry in this table exists
                  for each ifEntry with an ifType of docsCableUpstreamInterface (129)."
             INDEX { ifIndex }
             ::= { docsIfUpstreamChannelTable 1 }
     
     DocsIfUpstreamChannelEntry ::= SEQUENCE {
                 docsIfUpChannelId                     Integer32,
                 docsIfUpChannelFrequency              Integer32,
                 docsIfUpChannelWidth                  Integer32,
                 docsIfUpChannelModulationProfile      Unsigned32,
                 docsIfUpChannelSlotSize               Unsigned32,
                 docsIfUpChannelTxTimingOffset         Unsigned32,
                 docsIfUpChannelRangingBackoffStart    Integer32,
                 docsIfUpChannelRangingBackoffEnd      Integer32,
                 docsIfUpChannelTxBackoffStart         Integer32,
                 docsIfUpChannelTxBackoffEnd           Integer32,
                 docsIfUpChannelScdmaActiveCodes       Unsigned32,
                 docsIfUpChannelScdmaCodesPerSlot      Integer32,
                 docsIfUpChannelScdmaFrameSize         Unsigned32,
                 docsIfUpChannelScdmaHoppingSeed       Unsigned32,
                 docsIfUpChannelType                   DocsisUpstreamType,
                 docsIfUpChannelCloneFrom              InterfaceIndexOrZero,
                 docsIfUpChannelUpdate                 TruthValue,
                 docsIfUpChannelStatus                 RowStatus
             }
     
     docsIfUpChannelId OBJECT-TYPE
             SYNTAX      Integer32 (0..255)
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
     
     Goren/Raftus               Expires September 2002                  [Page 27]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 "The CMTS identification of the upstream channel."
             ::= { docsIfUpstreamChannelEntry 1 }
     
     docsIfUpChannelFrequency OBJECT-TYPE
             SYNTAX      Integer32 (0..1000000000)
             UNITS       "hertz"
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The center of the frequency band associated with this
                  upstream interface. This object returns 0 if the frequency
                  is undefined or unknown. Minimum permitted upstream
                  frequency is 5,000,000 Hz for current technology.  See
                  the associated conformance object for write conditions
                  and limitations."
             REFERENCE
                 "Document [25] from References, Table 4-2."
             ::= { docsIfUpstreamChannelEntry 2 }
     
     docsIfUpChannelWidth OBJECT-TYPE
             SYNTAX      Integer32 (0..64000000)
             UNITS       "hertz"
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The bandwidth of this upstream interface. This object
                  returns 0 if the interface width is undefined or unknown.
                  Minimum permitted interface width is 200,000 Hz currently.
                  See the associated conformance object for write conditions
                  and limitations."
             REFERENCE
                 "Document [25] from References, Table 6-12."
             ::= { docsIfUpstreamChannelEntry 3 }
     
     
     docsIfUpChannelModulationProfile OBJECT-TYPE
             SYNTAX      Unsigned32
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "An entry identical to the docsIfModIndex in the
                  docsIfCmtsModulationTable that describes this channel.
                  This channel is further instantiated there by a grouping
                  of interval usage codes which together fully describe the
                  channel modulation. This object returns 0 if the
                  docsIfCmtsModulationTable entry does not exist or
                  docsIfCmtsModulationTable is empty. See
                  the associated conformance object for write conditions
                  and limitations."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             ::= { docsIfUpstreamChannelEntry 4 }
     
     Goren/Raftus               Expires September 2002                  [Page 28]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfUpChannelSlotSize OBJECT-TYPE
             SYNTAX      Unsigned32
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Applicable to TDMA and ATDMA channel types only.
                  The number of 6.25 microsecond ticks in each upstream mini-
                  slot. Returns zero if the value is undefined, unknown or in
                  case of an SCDMA channel.
                  See the associated conformance object for write
                  conditions and limitations. "
             REFERENCE
                 "Document [25] from References, Section 8.1.2.4."
             ::= { docsIfUpstreamChannelEntry 5 }
     
     docsIfUpChannelTxTimingOffset OBJECT-TYPE
             SYNTAX      Unsigned32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "At the CM, a measure of the current round trip time obtained from the
                  ranging offset (initial ranging offset + ranging offset adjustments).
                  At the CMTS, the maximum of timing offset, among all the CMs that
                  are/were present on the channel, taking into account all ( initial +
                  periodic )timing offset corrections that were sent for each of the CMs.
                  Generally, these measurements are positive, but if the
                  measurements are negative, the value of this object is zero. Used for
                  timing of CM upstream transmissions to ensure synchronized arrivals at
                  the CMTS. Units are in terms of (6.25 microseconds/64)."
             REFERENCE
                 "Document [25] from References, Section 6.2.18."
             ::= { docsIfUpstreamChannelEntry 6 }
     
     docsIfUpChannelRangingBackoffStart OBJECT-TYPE
             SYNTAX      Integer32 (0..16)
             MAX-ACCESS  read-create
             STATUS      current
             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. See the associated conformance
                  object for write conditions and limitations."
             REFERENCE
                 "Document [25] from References, Section 8.3.4."
             ::= { docsIfUpstreamChannelEntry 7 }
     
     docsIfUpChannelRangingBackoffEnd OBJECT-TYPE
             SYNTAX      Integer32 (0..16)
             MAX-ACCESS  read-create
             STATUS      current
     
     Goren/Raftus               Expires September 2002                  [Page 29]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             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. See the associated conformance
                  object for write conditions and limitations."
             REFERENCE
                 "Document [25] from References, Section 8.3.4."
             ::= { docsIfUpstreamChannelEntry 8 }
     
     docsIfUpChannelTxBackoffStart OBJECT-TYPE
             SYNTAX      Integer32 (0..16)
             MAX-ACCESS  read-create
             STATUS      current
             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. See the associated conformance
                  object for write conditions and limitations."
             REFERENCE
                 "Document [25] from References, Section 8.3.4."
             ::= { docsIfUpstreamChannelEntry 9 }
     
     docsIfUpChannelTxBackoffEnd OBJECT-TYPE
             SYNTAX      Integer32 (0..16)
             MAX-ACCESS  read-create
             STATUS      current
             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. See the associated conformance
                  object for write conditions and limitations."
             REFERENCE
                 "Document [25] from References, Section 8.3.4."
             ::= { docsIfUpstreamChannelEntry 10 }
     
     docsIfUpChannelScdmaActiveCodes  OBJECT-TYPE
             SYNTAX     Unsigned32 (0 | 64..128)
             MAX-ACCESS read-create
             STATUS     current
             DESCRIPTION
                 "Applicable for SCDMA channel types only.
                  Number of active codes. Returns zero for
                  Non-SCDMA channel types. Note that legal
                  values from 64..128 MUST be non-prime."
             REFERENCE
                 "Document [25] from References, Section 6.2.11.2.1."
             ::= { docsIfUpstreamChannelEntry 11 }
     
     docsIfUpChannelScdmaCodesPerSlot OBJECT-TYPE
     
     Goren/Raftus               Expires September 2002                  [Page 30]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             SYNTAX      Integer32(0 | 2..32)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Applicable for SCDMA channel types only.
                  The number of SCDMA codes per mini-slot.
                  Returns zero if the value is undefined, unknown or in
                  case of a TDMA or ATDMA channel."
             REFERENCE
                 "Document [25] from References, Section 6.2.11.2.1."
             ::= { docsIfUpstreamChannelEntry 12 }
     
     docsIfUpChannelScdmaFrameSize OBJECT-TYPE
             SYNTAX      Unsigned32 (0..32)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Applicable for SCDMA channel types only.
                  SCDMA Frame size in units of spreading intervals.
                  This value returns zero for non SCDMA Profiles."
             REFERENCE
                 " Document [25] from References, Section 6.2.12."
             ::= { docsIfUpstreamChannelEntry 13 }
     
     docsIfUpChannelScdmaHoppingSeed OBJECT-TYPE
             SYNTAX     Unsigned32 (0..32767)
             MAX-ACCESS read-create
             STATUS     current
             DESCRIPTION
                 "Applicable for SCDMA channel types only.
                  15 bit seed used for code hopping sequence initialization.
                  Returns zero for non-SCDMA channel types."
             REFERENCE
                 "Document [25] from References, Section 6.2.14.1."
             ::= { docsIfUpstreamChannelEntry 14 }
     
     docsIfUpChannelType OBJECT-TYPE
             SYNTAX      DocsisUpstreamType
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Defines the Upstream channel type.
                  Given the channel type, other channel attributes can be checked
                  for value validity at the time of entry creation and update."
             REFERENCE
                 "Document [25] from References, Section 6.2.1."
             ::= { docsIfUpstreamChannelEntry 15 }
     
     docsIfUpChannelCloneFrom OBJECT-TYPE
             SYNTAX      InterfaceIndexOrZero
             MAX-ACCESS  read-create
             STATUS      current
     
     Goren/Raftus               Expires September 2002                  [Page 31]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             DESCRIPTION
                 "Intended for use when a temporary inactive upstream table row is
                  created for the purpose of manipulating SCDMA parameters for an
                  active row. Refer to the descriptions of docsIfUpChannelStatus
                  and docsIfUpChannelUpdate for details of this procedure.
                  This object contains the ifIndex value of the active upstream
                  row whose SCDMA parameters are to be adjusted.
                  Although this object was created to facilitate SCDMA parameter
                  adjustment, it may also be used at the vendor's discretion for
                  non-SCDMA parameter adjustment.
                  This object must contain a value of zero for active upstream rows."
             ::= { docsIfUpstreamChannelEntry 16 }
     
     docsIfUpChannelUpdate OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Used to perform the transfer of adjusted SCDMA parameters from the
                  temporary upstream row to the active upstream row indicated by the
                  docsIfUpChannelCloneFrom object. The transfer is initiated through
                  an SNMP SET of TRUE to this object. The SNMP SET will fail with a
                  GEN_ERROR (snmpv1) or COMMIT_FAILED_ERROR (snmpv2c/v3) if the adjusted
                  SCDMA parameter values are not compatible with each other.
                  Although this object was created to facilitate SCDMA parameter
                  adjustment, it may also be used at the vendor's discretion for
                  non-SCDMA parameter adjustment.
                  An SNMP GET of this object always returns FALSE."
             ::= { docsIfUpstreamChannelEntry 17 }
     
     
     docsIfUpChannelStatus OBJECT-TYPE
             SYNTAX      RowStatus
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "This object is generally intended to be used for the creation of
                  a temporary inactive upstream row for the purpose of adjusting
                  the SCDMA channel parameters of an active upstream row.
                  The recommended procedure is:
                  1) Create an inactive row through an SNMP SET using CREATEandWAIT.
                     Use an ifIndex value outside the operational range of the system.
                  2) Set the docsIfUpChannelCloneFrom field to the ifIndex value of
                     the active row whose SCDMA parameters require adjustment.
                  3) Adjust the SCDMA parameter values using the new temporary inactive
                     row.
                  4) Update the active row by setting object docsIfUpChannelUpdate to
                     TRUE. This SET will fail if the adjusted SCDMA parameters are not
                     compatible with each other.
                  5) Delete the temporary row through an SNMP SET using DELETE.
     
                  The following restrictions apply to this object:
     
     Goren/Raftus               Expires September 2002                  [Page 32]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  1) This object must contain a value of ACTIVE for active rows.
                  2) Temporary inactive rows must be created using CREATEandWAIT.
                  3) The only possible status change of a row created using
                     CREATEandWAIT (ie NotInService) is to DELETE. These temporary
                     rows must never become active.
                  Although this object was created to facilitate SCDMA parameter
                  adjustment, it may also be used at the vendor's discretion for
                  non-SCDMA parameter adjustment."
             ::= { docsIfUpstreamChannelEntry 18 }
     
     -- The following table describes the attributes of each class of
     -- service.  The entries in this table are referenced from the
     -- docsIfServiceEntries.  They exist as a separate table in order to
     -- reduce redundant information in docsIfServiceTable.
     --
     -- This table is implemented at both the CM and the CMTS.
     -- The CM need only maintain entries for the classes of service
     -- referenced by its docsIfServiceTable.
     --
     
     docsIfQosProfileTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfQosProfileEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes for each class of service."
             ::= { docsIfBaseObjects 3 }
     
     docsIfQosProfileEntry OBJECT-TYPE
             SYNTAX      DocsIfQosProfileEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes for a single class of service.
     
                  If implemented as read-create in the Cable Modem
                  Termination System, creation of entries in this table is
                  controlled by the value of docsIfCmtsQosProfilePermissions.
     
                  If implemented as read-only, entries are created based
                  on information in REG-REQ MAC messages received from
                  Cable Modems (Cable Modem Termination System
                  implementation), or based on information extracted from
                  the TFTP option file (Cable Modem implementation).
                  In the Cable Modem Termination system, read-only entries
                  are removed if no longer referenced by
                  docsIfCmtsServiceTable.
     
                  An entry in this table must not be removed while it is
                  referenced by an entry in docsIfCmServiceTable (Cable Modem)
                  or docsIfCmtsServiceTable (Cable Modem Termination System).
     
     
     Goren/Raftus               Expires September 2002                  [Page 33]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  An entry in this table should not be changeable while
                  it is referenced by an entry in docsIfCmtsServiceTable.
     
                  If this table is created automatically, there should only
                  be a single entry for each Class of Service. Multiple
                  entries with the same Class of Service parameters are not
                  recommended."
             INDEX { docsIfQosProfIndex }
             ::= { docsIfQosProfileTable 1 }
     
     DocsIfQosProfileEntry ::= SEQUENCE {
                 docsIfQosProfIndex                Integer32,
                 docsIfQosProfPriority             Integer32,
                 docsIfQosProfMaxUpBandwidth       Integer32,
                 docsIfQosProfGuarUpBandwidth      Integer32,
                 docsIfQosProfMaxDownBandwidth     Integer32,
                 docsIfQosProfMaxTxBurst           Integer32,  -- Deprecated
                 docsIfQosProfBaselinePrivacy      TruthValue,
                 docsIfQosProfStatus               RowStatus,
                 docsIfQosProfMaxTransmitBurst     Integer32
             }
     
     docsIfQosProfIndex OBJECT-TYPE
             SYNTAX      Integer32 (1..16383)
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "The index value that uniquely identifies an entry
                  in the docsIfQosProfileTable."
             ::= { docsIfQosProfileEntry 1 }
     
     docsIfQosProfPriority  OBJECT-TYPE
             SYNTAX      Integer32 (0..7)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "A relative priority assigned to this service when
                  allocating bandwidth. Zero indicates lowest priority
                  and seven indicates highest priority.
                  Interpretation of priority is device-specific.
                  MUST NOT be changed while this row is active."
             REFERENCE
                 "Document [25] from References, Appendix C.1.1.4."
             DEFVAL { 0 }
             ::= { docsIfQosProfileEntry 2 }
     
     docsIfQosProfMaxUpBandwidth OBJECT-TYPE
             SYNTAX      Integer32 (0..100000000)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The maximum upstream bandwidth, in bits per second,
     
     Goren/Raftus               Expires September 2002                  [Page 34]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  allowed for a service with this service class.
                  Zero if there is no restriction of upstream bandwidth.
                  MUST NOT be changed while this row is active."
             REFERENCE
                 "Document [25] from References, Appendix C.1.1.4."
     
             DEFVAL { 0 }
             ::= { docsIfQosProfileEntry 3 }
     
     docsIfQosProfGuarUpBandwidth OBJECT-TYPE
             SYNTAX      Integer32 (0..100000000)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Minimum guaranteed upstream bandwidth, in bits per second,
                  allowed for a service with this service class.
                  MUST NOT be changed while this row is active."
             REFERENCE
                 "Document [25] from References, Appendix C.1.1.4."
             DEFVAL { 0 }
             ::= { docsIfQosProfileEntry 4 }
     
     docsIfQosProfMaxDownBandwidth OBJECT-TYPE
             SYNTAX      Integer32 (0..100000000)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The maximum downstream bandwidth, in bits per second,
                  allowed for a service with this service class.
                  Zero if there is no restriction of downstream bandwidth.
                  MUST NOT be changed while this row is active."
             REFERENCE
                 "Document [25] from References, Appendix C.1.1.4."
     
             DEFVAL { 0 }
             ::= { docsIfQosProfileEntry 5 }
     
     docsIfQosProfMaxTxBurst OBJECT-TYPE
             SYNTAX      Integer32 (0..255)
             MAX-ACCESS  read-create
             STATUS      deprecated
             DESCRIPTION
                 "The maximum number of mini-slots that may be requested
                  for a single upstream transmission.
                  A value of zero means there is no limit.
                  MUST NOT be changed while this row is active.
                  This object has been deprecated and replaced by
                  docsIfQosProfMaxTransmitBurst, to fix a mismatch
                  of the units and value range with respect to the DOCSIS
                  Maximum Upstream Channel Transmit Burst Configuration
                  Setting."
             REFERENCE
     
     Goren/Raftus               Expires September 2002                  [Page 35]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 "Document [25] from References, C.1.1.4."
             DEFVAL { 0 }
             ::= { docsIfQosProfileEntry 6 }
     
     docsIfQosProfBaselinePrivacy  OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Indicates whether Baseline Privacy is enabled for this
                  service class.
                  MUST NOT be changed while this row is active."
             DEFVAL { false }
             ::= { docsIfQosProfileEntry 7 }
     
     docsIfQosProfStatus OBJECT-TYPE
             SYNTAX      RowStatus
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "This is object is to used to create or delete rows in
                  this table.  This object MUST NOT be changed from active
                  while the row is referenced by the any entry in either
                  docsIfCmServiceTable (on the CM), or the
                  docsIfCmtsServiceTable (on the CMTS)."
             ::= { docsIfQosProfileEntry 8 }
     
     docsIfQosProfMaxTransmitBurst OBJECT-TYPE
             SYNTAX      Integer32 (0..1522)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The maximum number of bytes that may be requested for a
                  single upstream transmission. A value of zero means there
                  is no limit. Note: This value does not include any
                  physical layer overhead.
                  MUST NOT be changed while this row is active."
             REFERENCE
                 "Document [25] from References, Appendix C.1.1.4."
             DEFVAL { 0 }
             ::= { docsIfQosProfileEntry 9 }
     
     docsIfSignalQualityTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfSignalQualityEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "At the CM, describes the PHY signal quality of downstream
                  channels. At the CMTS, describes the PHY signal quality of
                  upstream channels. At the CMTS, this table may exclude
                  contention intervals."
             ::= { docsIfBaseObjects 4 }
     
     Goren/Raftus               Expires September 2002                  [Page 36]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfSignalQualityEntry OBJECT-TYPE
             SYNTAX      DocsIfSignalQualityEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "At the CM, describes the PHY characteristics of a
                  downstream channel. At the CMTS, describes the PHY signal
                  quality of an upstream channel.
                  An entry in this table exists for each ifEntry with an
                  ifType of docsCableUpstreamChannel(205) for Cable Modem Termination
                  Systems and docsCableDownstream(128) for Cable Modems."
             INDEX { ifIndex }
             ::= { docsIfSignalQualityTable 1 }
     
     DocsIfSignalQualityEntry ::= SEQUENCE {
                 docsIfSigQIncludesContention  TruthValue,
                 docsIfSigQUnerroreds          Counter32,
                 docsIfSigQCorrecteds          Counter32,
                 docsIfSigQUncorrectables      Counter32,
                 docsIfSigQSignalNoise         TenthdB,
                 docsIfSigQMicroreflections    Integer32,
                 docsIfSigQEqualizationData    OCTET STRING
             }
     
     docsIfSigQIncludesContention OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "true(1) if this CMTS includes contention intervals in
                  the counters in this table. Always false(2) for CMs."
             REFERENCE
                 "Document [25] from References,
                  Section 9.4.1"
             ::= { docsIfSignalQualityEntry 1 }
     
     docsIfSigQUnerroreds OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Codewords received on this channel without error.
                  This includes all codewords, whether or not they
                  were part of frames destined for this device."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfSignalQualityEntry 2 }
     
     docsIfSigQCorrecteds OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
     
     Goren/Raftus               Expires September 2002                  [Page 37]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             STATUS      current
             DESCRIPTION
                 "Codewords received on this channel with correctable
                  errors. This includes all codewords, whether or not
                  they were part of frames destined for this device."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfSignalQualityEntry 3 }
     
     docsIfSigQUncorrectables OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Codewords received on this channel with uncorrectable
                  errors. This includes all codewords, whether or not
                  they were part of frames destined for this device."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfSignalQualityEntry 4 }
     
     docsIfSigQSignalNoise OBJECT-TYPE
             SYNTAX      TenthdB
             UNITS       "dB"
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Signal/Noise ratio as perceived for this channel.
                  At the CM, describes the Signal/Noise of the downstream
                  channel.  At the CMTS, describes the average Signal/Noise
                  of the upstream channel."
             REFERENCE
                 "Document [25] from References, Tables 4-1 and 4-2"
             ::= { docsIfSignalQualityEntry 5 }
     
     docsIfSigQMicroreflections OBJECT-TYPE
             SYNTAX      Integer32 (0..255)
             UNITS       "dBc"
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Total microreflections including in-channel response
                  as perceived on this interface, measured in dBc below
                  the signal level.
                  This object is not assumed to return an absolutely
                  accurate value, but should give a rough indication
                  of microreflections received on this interface.
                  It is up to the implementer to provide information
                  as accurate as possible."
             REFERENCE
                 "Document [25] from References, Tables 4-1 and 4-2"
             ::= { docsIfSignalQualityEntry 6 }
     
     Goren/Raftus               Expires September 2002                  [Page 38]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfSigQEqualizationData OBJECT-TYPE
             SYNTAX      OCTET STRING
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "At the CM, returns the equalization data for the downstream
                  channel. At the CMTS, returns the average equalization
                  data for the upstream channel. Returns an empty string
                  if the value is unknown or if there is no equalization
                  data available or defined."
             REFERENCE
                 "Document [25] from References, Table 8-21."
             ::= { docsIfSignalQualityEntry 7 }
     
     
     --
     -- DOCSIS Version of the device
     --
     
     docsIfDocsisBaseCapability  OBJECT-TYPE
                SYNTAX      DocsisVersion
                MAX-ACCESS  read-only
                STATUS      current
                DESCRIPTION
                     "Indication of the DOCSIS capability of the device.
                      This object mirrors docsIfDocsisCapability from the
                      DocsIfExt mib."
             REFERENCE
                 "Document [25] from References, Annex G."
                ::= { docsIfBaseObjects 5 }
     
     
     --
     -- CABLE MODEM GROUP
     --
     
     -- #######
     
     
     --
     -- The CM MAC Table
     --
     
     docsIfCmMacTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmMacEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes of each CM MAC interface,
                  extending the information available from ifEntry."
             ::= { docsIfCmObjects 1 }
     
     Goren/Raftus               Expires September 2002                  [Page 39]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfCmMacEntry OBJECT-TYPE
             SYNTAX      DocsIfCmMacEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "An entry containing objects describing attributes of
                  each MAC entry, extending the information in ifEntry.
                  An entry in this table exists for each ifEntry with an
                  ifType of docsCableMaclayer(127)."
             INDEX { ifIndex }
             ::= { docsIfCmMacTable 1 }
     
     DocsIfCmMacEntry ::= SEQUENCE {
                 docsIfCmCmtsAddress           MacAddress,
                 docsIfCmCapabilities          BITS,
                 docsIfCmRangingRespTimeout    TimeTicks,
                 docsIfCmRangingTimeout        TimeInterval
              }
     
     docsIfCmCmtsAddress OBJECT-TYPE
             SYNTAX      MacAddress
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Identifies the CMTS that is believed to control this MAC
                  domain. At the CM, this will be the source address from
                  SYNC, MAP, and other MAC-layer messages. If the CMTS is
                  unknown, returns 00-00-00-00-00-00."
             REFERENCE
                 "Document [25] from References, Section 8.2.2."
             ::= { docsIfCmMacEntry 1 }
     
     docsIfCmCapabilities OBJECT-TYPE
             SYNTAX      BITS {
                 atmCells(0),
                 concatenation(1)
             }
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Identifies the capabilities of the MAC implementation
                  at this interface. Note that packet transmission is
                  always supported. Therefore, there is no specific bit
                  required to explicitly indicate this capability.
                  Note that BITS objects are encoded most significant bit
                  first. For example, if bit 1 is set, the value of this
                  object is the octet string '40'H."
             ::= { docsIfCmMacEntry 2 }
     
     
     -- This object has been obsoleted and replaced by
     
     Goren/Raftus               Expires September 2002                  [Page 40]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New
     -- implementations of the MIB should use docsIfCmRangingTimeout instead.
     
     docsIfCmRangingRespTimeout OBJECT-TYPE
             SYNTAX      TimeTicks
             MAX-ACCESS  read-write
             STATUS      obsolete
             DESCRIPTION
                 "Waiting time for a Ranging Response packet."
             REFERENCE
                 "Document [25] from References, Section 9.1.6."
             DEFVAL { 20 }
             ::= { docsIfCmMacEntry 3 }
     
     docsIfCmRangingTimeout OBJECT-TYPE
             SYNTAX      TimeInterval
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "Waiting time for a Ranging Response packet."
             REFERENCE
                 "Document [25] from References,
                  Section 9.1.6, timer T3."
             DEFVAL { 20 }
             ::= { docsIfCmMacEntry 4 }
     
     --
     -- CM status table.
     -- This table is implemented only at the CM.
     --
     
     docsIfCmStatusTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmStatusEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "This table maintains a number of status objects
                  and counters for Cable Modems."
             ::= { docsIfCmObjects 2 }
     
     docsIfCmStatusEntry OBJECT-TYPE
             SYNTAX      DocsIfCmStatusEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "A set of status objects and counters for a single MAC
                  layer instance in a Cable Modem.
                  An entry in this table exists for each ifEntry with an
                  ifType of docsCableMaclayer(127)."
             INDEX { ifIndex }
             ::= { docsIfCmStatusTable 1 }
     
     
     Goren/Raftus               Expires September 2002                  [Page 41]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     DocsIfCmStatusEntry ::= SEQUENCE {
                 docsIfCmStatusValue                     INTEGER,
                 docsIfCmStatusCode                      OCTET STRING,
                 docsIfCmStatusTxPower                   TenthdBmV,
                 docsIfCmStatusResets                    Counter32,
                 docsIfCmStatusLostSyncs                 Counter32,
                 docsIfCmStatusInvalidMaps               Counter32,
                 docsIfCmStatusInvalidUcds               Counter32,
                 docsIfCmStatusInvalidRangingResponses   Counter32,
                 docsIfCmStatusInvalidRegistrationResponses Counter32,
                 docsIfCmStatusT1Timeouts                Counter32,
                 docsIfCmStatusT2Timeouts                Counter32,
                 docsIfCmStatusT3Timeouts                Counter32,
                 docsIfCmStatusT4Timeouts                Counter32,
                 docsIfCmStatusRangingAborteds           Counter32,
                 docsIfCmStatusDocsisOperMode            DocsisQosVersion,
                 docsIfCmStatusModulationType            DocsisUpstreamTypeStatus
             }
     
     
     docsIfCmStatusValue OBJECT-TYPE
             SYNTAX      INTEGER {
                 other(1),
                 notReady(2),
                 notSynchronized(3),
                 phySynchronized(4),
                 usParametersAcquired(5),
                 rangingComplete(6),
                 ipComplete(7),
                 todEstablished(8),
                 securityEstablished(9),
                 paramTransferComplete(10),
                 registrationComplete(11),
                 operational(12),
                 accessDenied(13)
             }
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Current Cable Modem connectivity state, as specified
                  in the RF Interface Specification."
             REFERENCE
                 "Document [25] from References, Section 11.2."
             ::= { docsIfCmStatusEntry 1 }
     
     docsIfCmStatusCode OBJECT-TYPE
             SYNTAX      OCTET STRING
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Status code for this Cable Modem as defined in the
                  RF Interface Specification. The status code consists
     
     Goren/Raftus               Expires September 2002                  [Page 42]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  of a single character indicating error groups, followed
                  by a two- or three-digit number indicating the status
                  condition."
             REFERENCE
                 "Document [26] from References, Appendix F."
             ::= { docsIfCmStatusEntry 2 }
     
     docsIfCmStatusTxPower OBJECT-TYPE
             SYNTAX      TenthdBmV
             UNITS       "dBmV"
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The operational transmit power for the attached upstream
                  channel."
             REFERENCE
                 "Document [25] from References, Section 6.2.18."
             ::= { docsIfCmStatusEntry 3 }
     
     docsIfCmStatusResets OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times the CM reset or initialized this interface."
             ::= { docsIfCmStatusEntry 4 }
     
     docsIfCmStatusLostSyncs OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times the CM lost synchronization with
                  the downstream channel."
             REFERENCE
                 "Document [25] from References, Section 8.3.2."
             ::= { docsIfCmStatusEntry 5 }
     
     
     docsIfCmStatusInvalidMaps OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times the CM received invalid MAP messages."
             REFERENCE
                 "Document [25] from References, Section 8.3.4."
             ::= { docsIfCmStatusEntry 6 }
     
     docsIfCmStatusInvalidUcds OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
     
     Goren/Raftus               Expires September 2002                  [Page 43]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             STATUS      current
             DESCRIPTION
                 "Number of times the CM received invalid UCD messages."
             REFERENCE
                 "Document [25] from References, Section 8.3.3."
             ::= { docsIfCmStatusEntry 7 }
     
     docsIfCmStatusInvalidRangingResponses OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times the CM received invalid ranging response
                  messages."
             REFERENCE
                 "Document [25] from References, Section 8.3.6."
             ::= { docsIfCmStatusEntry 8 }
     
     docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times the CM received invalid registration
                  response messages."
             REFERENCE
                 "Document [25] from References, Section 8.3.8."
             ::= { docsIfCmStatusEntry 9 }
     
     docsIfCmStatusT1Timeouts OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times counter T1 expired in the CM."
             REFERENCE
                 "Document [25] from References, Figure 9-2."
             ::= { docsIfCmStatusEntry 10 }
     
     docsIfCmStatusT2Timeouts OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times counter T2 expired in the CM."
             REFERENCE
                 "Document [25] from References, Figure 9-2."
             ::= { docsIfCmStatusEntry 11 }
     
     docsIfCmStatusT3Timeouts OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
     
     Goren/Raftus               Expires September 2002                  [Page 44]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             STATUS      current
             DESCRIPTION
                 "Number of times counter T3 expired in the CM."
             REFERENCE
                 "Document [25] from References, Figure 9-2."
             ::= { docsIfCmStatusEntry 12 }
     
     docsIfCmStatusT4Timeouts OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times counter T4 expired in the CM."
             REFERENCE
                 "Document [25] from References, Figure 9-2."
             ::= { docsIfCmStatusEntry 13 }
     
     docsIfCmStatusRangingAborteds OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Number of times the ranging process was aborted
                  by the CMTS."
             REFERENCE
                 "Document [25] from References, Section 9.3.3."
             ::= { docsIfCmStatusEntry 14 }
     
     docsIfCmStatusDocsisOperMode OBJECT-TYPE
             SYNTAX      DocsisQosVersion
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                  "Indication whether the device has registered using 1.0 Class of
                   Service or 1.1 Quality of Service.
                   An unregistered CM should indicate 1.1 QOS for a
                   docsIfDocsisBaseCapability value of Docsis 1.1/2.0. An unregistered
                 CM should indicate 1.0 COS for a docsIfDocsisBaseCapability value
                   of Docsis 1.0.
                   This object mirrors docsIfCmDocsisOperMode from the docsIfExt mib."
             REFERENCE
                 "Document [25] from References, Annex G."
             ::= { docsIfCmStatusEntry 15 }
     
     docsIfCmStatusModulationType OBJECT-TYPE
              SYNTAX      DocsisUpstreamTypeStatus
              MAX-ACCESS  read-only
              STATUS      current
              DESCRIPTION
                  "Indicates modulation type status currently used by the CM.
                   Since this object specifically identifies PHY mode, the shared
                   upstream channel type is not permitted."
     
     Goren/Raftus               Expires September 2002                  [Page 45]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             REFERENCE
                 "Document [25] from References, Section 6.2.1."
     
              ::= { docsIfCmStatusEntry 16 }
     
     --
     -- The Cable Modem Service Table
     --
     
     docsIfCmServiceTable  OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmServiceEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes of each upstream service queue
                  on a CM."
             ::= { docsIfCmObjects 3 }
     
     docsIfCmServiceEntry OBJECT-TYPE
             SYNTAX      DocsIfCmServiceEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes of an upstream bandwidth service
                  queue.
                  An entry in this table exists for each Service ID.
                  The primary index is an ifIndex with an ifType of
                  docsCableMaclayer(127)."
             INDEX { ifIndex, docsIfCmServiceId }
             ::= { docsIfCmServiceTable 1 }
     
     DocsIfCmServiceEntry ::= SEQUENCE {
                 docsIfCmServiceId               Integer32,
                 docsIfCmServiceQosProfile       Integer32,
                 docsIfCmServiceTxSlotsImmed     Counter32,
                 docsIfCmServiceTxSlotsDed       Counter32,
                 docsIfCmServiceTxRetries        Counter32,
                 docsIfCmServiceTxExceededs      Counter32,
                 docsIfCmServiceRqRetries        Counter32,
                 docsIfCmServiceRqExceededs      Counter32,
                 docsIfCmServiceExtTxSlotsImmed  Counter64,
                 docsIfCmServiceExtTxSlotsDed    Counter64
              }
     
     docsIfCmServiceId OBJECT-TYPE
             SYNTAX      Integer32 (1..16383)
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Identifies a service queue for upstream bandwidth. The
                  attributes of this service queue are shared between the
                  CM and the CMTS. The CMTS allocates upstream bandwidth
     
     Goren/Raftus               Expires September 2002                  [Page 46]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  to this service queue based on requests from the CM and
                  on the class of service associated with this queue."
             ::= { docsIfCmServiceEntry 1 }
     
     docsIfCmServiceQosProfile OBJECT-TYPE
             SYNTAX      Integer32 (0..16383)
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The index in docsIfQosProfileTable describing the quality
                  of service attributes associated with this particular
                  service. If no associated entry in docsIfQosProfileTable
                  exists, this object returns a value of zero."
             ::= { docsIfCmServiceEntry 2 }
     
     docsIfCmServiceTxSlotsImmed OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of upstream mini-slots which have been used to
                  transmit data PDUs in immediate (contention) mode. This
                  includes only those PDUs that are presumed to have
                  arrived at the headend (i.e., those which were explicitly
                  acknowledged.) It does not include retransmission attempts
                  or mini-slots used by Requests."
             REFERENCE
                 "Document [25] from References, Section 9.4."
             ::= { docsIfCmServiceEntry 3 }
     
     docsIfCmServiceTxSlotsDed OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of upstream mini-slots which have been used to
                  transmit data PDUs in dedicated mode (i.e., as a result
                  of a unicast Data Grant)."
             REFERENCE
                 "Document [25] from References, Section 9.4."
             ::= { docsIfCmServiceEntry 4 }
     
     docsIfCmServiceTxRetries OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of attempts to transmit data PDUs containing
                  requests for acknowledgment that did not result in
                  acknowledgment."
             REFERENCE
                 "Document [25] from References, Section 9.4."
     
     Goren/Raftus               Expires September 2002                  [Page 47]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             ::= { docsIfCmServiceEntry 5 }
     
     docsIfCmServiceTxExceededs OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of data PDUs transmission failures due to
                  excessive retries without acknowledgment."
             REFERENCE
                 "Document [25] from References, Section 9.4."
             ::= { docsIfCmServiceEntry 6 }
     
     docsIfCmServiceRqRetries OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of attempts to transmit bandwidth requests
                  which did not result in acknowledgment."
             REFERENCE
                 "Document [25] from References, Section 9.4."
             ::= { docsIfCmServiceEntry 7 }
     
     
     docsIfCmServiceRqExceededs OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of requests for bandwidth which failed due to
                  excessive retries without acknowledgment."
             REFERENCE
                 "Document [25] from References, Section 9.4."
             ::= { docsIfCmServiceEntry 8 }
     
     docsIfCmServiceExtTxSlotsImmed OBJECT-TYPE
             SYNTAX      Counter64
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of upstream mini-slots which have been used to
                  transmit data PDUs in immediate (contention) mode. This
                  includes only those PDUs that are presumed to have
                  arrived at the headend (i.e., those which were explicitly
                  acknowledged.) It does not include retransmission attempts
                  or mini-slots used by Requests."
             REFERENCE
                 "Document [25] from References, Section 9.4."
             ::= { docsIfCmServiceEntry 9 }
     
     docsIfCmServiceExtTxSlotsDed OBJECT-TYPE
     
     Goren/Raftus               Expires September 2002                  [Page 48]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             SYNTAX      Counter64
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The number of upstream mini-slots which have been used to
                  transmit data PDUs in dedicated mode (i.e., as a result
                  of a unicast Data Grant)."
             REFERENCE
                 "Document [25] from References, Section 9.4."
             ::= { docsIfCmServiceEntry 10 }
     
     
     
     --
     -- CMTS GROUP
     --
     
     --
     -- The CMTS MAC Table
     --
     
     docsIfCmtsMacTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmtsMacEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes of each CMTS MAC interface,
                  extending the information available from ifEntry.
                  Mandatory for all CMTS devices."
             ::= { docsIfCmtsObjects 1 }
     
     docsIfCmtsMacEntry OBJECT-TYPE
             SYNTAX      DocsIfCmtsMacEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "An entry containing objects describing attributes of each
                  MAC entry, extending the information in ifEntry.
                  An entry in this table exists for each ifEntry with an
                  ifType of docsCableMaclayer(127)."
             INDEX { ifIndex }
             ::= { docsIfCmtsMacTable 1 }
     
     DocsIfCmtsMacEntry ::= SEQUENCE {
                 docsIfCmtsCapabilities            BITS,
                 docsIfCmtsSyncInterval            Integer32,
                 docsIfCmtsUcdInterval             Integer32,
                 docsIfCmtsMaxServiceIds           Integer32,
                 docsIfCmtsInsertionInterval       TimeTicks,   -- Obsolete
                 docsIfCmtsInvitedRangingAttempts  Integer32,
                 docsIfCmtsInsertInterval          TimeInterval
             }
     
     Goren/Raftus               Expires September 2002                  [Page 49]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     
     docsIfCmtsCapabilities OBJECT-TYPE
             SYNTAX      BITS {
                 atmCells(0),
                 concatenation(1)
             }
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Identifies the capabilities of the CMTS MAC
                  implementation at this interface. Note that packet
                  transmission is always supported. Therefore, there
                  is no specific bit required to explicitly indicate
                  this capability.
                  Note that BITS objects are encoded most significant bit
                  first. For example, if bit 1 is set, the value of this
                  object is the octet string '40'H."
             ::= { docsIfCmtsMacEntry 1 }
     
     docsIfCmtsSyncInterval OBJECT-TYPE
             SYNTAX      Integer32 (1..200)
             UNITS       "Milliseconds"
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The interval between CMTS transmission of successive SYNC
                  messages at this interface."
             REFERENCE
                 "Document [25] from References, Section 9.3."
             ::= { docsIfCmtsMacEntry 2 }
     
     docsIfCmtsUcdInterval OBJECT-TYPE
             SYNTAX      Integer32 (1..2000)
             UNITS       "Milliseconds"
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The interval between CMTS transmission of successive
                  Upstream Channel Descriptor messages for each upstream
                  channel at this interface."
             REFERENCE
                 "Document [25] from References, Section 9.3"
             ::= { docsIfCmtsMacEntry 3 }
     
     docsIfCmtsMaxServiceIds OBJECT-TYPE
             SYNTAX     Integer32 (1..16383)
             MAX-ACCESS read-only
             STATUS     current
             DESCRIPTION
                 "The maximum number of service IDs that may be
                  simultaneously active."
     
     Goren/Raftus               Expires September 2002                  [Page 50]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             ::= { docsIfCmtsMacEntry 4 }
     
     -- This object has been obsoleted and replaced by
     -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem.  New
     -- implementations of this MIB should use that object instead.
     docsIfCmtsInsertionInterval OBJECT-TYPE
             SYNTAX      TimeTicks
             MAX-ACCESS  read-write
             STATUS      obsolete
             DESCRIPTION
                 "The amount of time to elapse between each broadcast
                  station maintenance grant. Broadcast station maintenance
                  grants are used to allow new cable modems to join the
                  network. Zero indicates that a vendor-specific algorithm
                  is used instead of a fixed time. Maximum amount of time
                  permitted by the specification is 2 seconds."
             REFERENCE
                 "Document [25] from References, Annex B."
             ::= { docsIfCmtsMacEntry 5 }
     
     docsIfCmtsInvitedRangingAttempts OBJECT-TYPE
             SYNTAX      Integer32 (0..1024)
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The maximum number of attempts to make on invitations
                  for ranging requests. A value of zero means the system
                  should attempt to range forever."
             REFERENCE
                 "Document [25] from References, Section 9.3.3 and Annex B."
             ::= { docsIfCmtsMacEntry 6 }
     
     docsIfCmtsInsertInterval OBJECT-TYPE
             SYNTAX      TimeInterval
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "The amount of time to elapse between each broadcast
                  station maintenance grant. Broadcast station maintenance
                  grants are used to allow new cable modems to join the
                  network. Zero indicates that a vendor-specific algorithm
                  is used instead of a fixed time. Maximum amount of time
                  permitted by the specification is 2 seconds."
             REFERENCE
                 "Document [25] from References, Annex B."
             ::= { docsIfCmtsMacEntry 7 }
     
     
     --
     --
     -- CMTS status table.
     --
     
     Goren/Raftus               Expires September 2002                  [Page 51]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfCmtsStatusTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmtsStatusEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "For the MAC layer, this group maintains a number of
                  status objects and counters."
             ::= { docsIfCmtsObjects 2 }
     
     docsIfCmtsStatusEntry OBJECT-TYPE
             SYNTAX      DocsIfCmtsStatusEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                "Status entry for a single MAC layer.
                  An entry in this table exists for each ifEntry with an
                  ifType of docsCableMaclayer(127)."
             INDEX { ifIndex }
             ::= { docsIfCmtsStatusTable 1 }
     
     DocsIfCmtsStatusEntry ::= SEQUENCE {
                 docsIfCmtsStatusInvalidRangeReqs        Counter32,
                 docsIfCmtsStatusRangingAborteds         Counter32,
                 docsIfCmtsStatusInvalidRegReqs          Counter32,
                 docsIfCmtsStatusFailedRegReqs           Counter32,
                 docsIfCmtsStatusInvalidDataReqs         Counter32,
                 docsIfCmtsStatusT5Timeouts              Counter32
             }
     
     docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "This object counts invalid RNG-REQ messages received on
                  this interface."
             REFERENCE
                 "Document [25] from References, Section 8.3.5."
     
             ::= { docsIfCmtsStatusEntry 1 }
     
     docsIfCmtsStatusRangingAborteds OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "This object counts ranging attempts that were explicitly
                  aborted by the CMTS."
             REFERENCE
                 "Document [25] from References, Section 8.3.6."
             ::= { docsIfCmtsStatusEntry 2 }
     
     Goren/Raftus               Expires September 2002                  [Page 52]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "This object counts invalid REG-REQ messages received on
                  this interface. That is, syntax, out of range parameters,
                  or erroneous requests."
             REFERENCE
                 "Document [25] from References, Section 8.3.7."
             ::= { docsIfCmtsStatusEntry 3 }
     
     docsIfCmtsStatusFailedRegReqs OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "This object counts failed registration attempts. Included are
                 docsIfCmtsStatusInvalidRegReqs, authentication and class of
                 service failures."
             REFERENCE
                 "Document [25] from References, Section 8.3.7."
             ::= { docsIfCmtsStatusEntry 4 }
     
     docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "This object counts invalid data request messages
                  received on this interface."
             ::= { docsIfCmtsStatusEntry 5 }
     
     docsIfCmtsStatusT5Timeouts OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "This object counts the number of times counter T5
                  expired on this interface."
             REFERENCE
                 "Document [25] from References, Figure 9-2."
             ::= { docsIfCmtsStatusEntry 6 }
     
     
     --
     -- CM status table (within CMTS).
     -- This table is implemented only at the CMTS.
     -- It contains per CM status information available in the CMTS.
     --
     
     
     Goren/Raftus               Expires September 2002                  [Page 53]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     docsIfCmtsCmStatusTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmtsCmStatusEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "A set of objects in the CMTS, maintained for each
                  Cable Modem connected to this CMTS."
             ::= { docsIfCmtsObjects 3 }
     
     docsIfCmtsCmStatusEntry OBJECT-TYPE
             SYNTAX      DocsIfCmtsCmStatusEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Status information for a single Cable Modem.
                  An entry in this table exists for each Cable Modem
                  that is connected to the CMTS implementing this table."
             INDEX { docsIfCmtsCmStatusIndex }
             ::= { docsIfCmtsCmStatusTable 1 }
     
     DocsIfCmtsCmStatusEntry ::= SEQUENCE {
                 docsIfCmtsCmStatusIndex               Integer32,
                 docsIfCmtsCmStatusMacAddress          MacAddress,
                 docsIfCmtsCmStatusIpAddress           IpAddress,   -- Deprecated
                 docsIfCmtsCmStatusDownChannelIfIndex  InterfaceIndexOrZero,
                 docsIfCmtsCmStatusUpChannelIfIndex    InterfaceIndexOrZero,
                 docsIfCmtsCmStatusRxPower             TenthdBmV,
                 docsIfCmtsCmStatusTimingOffset        Unsigned32,
                 docsIfCmtsCmStatusEqualizationData    OCTET STRING,
                 docsIfCmtsCmStatusValue               INTEGER,
                 docsIfCmtsCmStatusUnerroreds          Counter32,
                 docsIfCmtsCmStatusCorrecteds          Counter32,
                 docsIfCmtsCmStatusUncorrectables      Counter32,
                 docsIfCmtsCmStatusSignalNoise         TenthdB,
                 docsIfCmtsCmStatusMicroreflections    Integer32,
                 docsIfCmtsCmStatusExtUnerroreds       Counter64,
                 docsIfCmtsCmStatusExtCorrecteds       Counter64,
                 docsIfCmtsCmStatusExtUncorrectables   Counter64,
                 docsIfCmtsCmStatusDocsisRegMode       DocsisQosVersion,
                 docsIfCmtsCmStatusModulationType      DocsisUpstreamTypeStatus,
                 docsIfCmtsCmStatusInetAddressType     InetAddressType,
                 docsIfCmtsCmStatusInetAddress         InetAddress
             }
     
     docsIfCmtsCmStatusIndex OBJECT-TYPE
             SYNTAX      Integer32 (1..2147483647)
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Index value to uniquely identify an entry in this table.
                  For an individual Cable Modem, this index value should
                  not change during CMTS uptime."
     
     Goren/Raftus               Expires September 2002                  [Page 54]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             ::= { docsIfCmtsCmStatusEntry 1 }
     
     docsIfCmtsCmStatusMacAddress OBJECT-TYPE
             SYNTAX      MacAddress
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "MAC address of this Cable Modem. If the Cable Modem has
                  multiple MAC addresses, this is the MAC address associated
                  with the Cable interface."
             REFERENCE
                 "Document [25] from References, Section 8.2.2."
             ::= { docsIfCmtsCmStatusEntry 2 }
     
     docsIfCmtsCmStatusIpAddress OBJECT-TYPE
             SYNTAX      IpAddress
             MAX-ACCESS  read-only
             STATUS      deprecated
             DESCRIPTION
                 "IP address of this Cable Modem. If the Cable Modem has no
                  IP address assigned, or the IP address is unknown, this
                  object returns a value of 0.0.0.0. If the Cable Modem has
                  multiple IP addresses, this object returns the IP address
                  associated with the Cable interface.n
                  This object has been deprecated and replaced by
                  docsIfCmtsCmStatusInetAddressType and
                  docsIfCmtsCmStatusInetAddress, to enable IPv6 addressing
                  in the future."
             ::= { docsIfCmtsCmStatusEntry 3 }
     
     docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE
             SYNTAX      InterfaceIndexOrZero
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "IfIndex of the downstream channel this CM is connected
                  to. If the downstream channel is unknown, this object
                  returns a value of zero."
             ::= { docsIfCmtsCmStatusEntry 4 }
     
     docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE
             SYNTAX      InterfaceIndexOrZero
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "IfIndex of the upstream channel this CM is connected
                  to. If the upstream channel is unknown, this object
                  returns a value of zero."
             ::= { docsIfCmtsCmStatusEntry 5 }
     
     docsIfCmtsCmStatusRxPower OBJECT-TYPE
             SYNTAX      TenthdBmV
     
     Goren/Raftus               Expires September 2002                  [Page 55]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             UNITS       "dBmV"
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The receive power as perceived for upstream data from
                  this Cable Modem.
                  If the receive power is unknown, this object returns
                  a value of zero."
             REFERENCE
                 "Document [25] from References, Table 6-11."
             ::= { docsIfCmtsCmStatusEntry 6 }
     
     docsIfCmtsCmStatusTimingOffset OBJECT-TYPE
             SYNTAX      Unsigned32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "A measure of the current round trip time for this CM.
                  Used for timing of CM upstream transmissions to ensure
                  synchronized arrivals at the CMTS. Units are in terms
                  of 6.25 microseconds/(64*256). Returns zero if the value
                  is unknown."
             REFERENCE
                 "Document [25] from References, Section 6.2.18."
             ::= { docsIfCmtsCmStatusEntry 7 }
     
     docsIfCmtsCmStatusEqualizationData OBJECT-TYPE
             SYNTAX      OCTET STRING
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Equalization data for this CM. Returns an empty string
                  if the value is unknown or if there is no equalization
                  data available or defined."
             REFERENCE
                 "Document [25] from References, Figure 8-23."
             ::= { docsIfCmtsCmStatusEntry 8 }
     
     docsIfCmtsCmStatusValue OBJECT-TYPE
             SYNTAX      INTEGER {
                 other(1),
                 ranging(2),
                 rangingAborted(3),
                 rangingComplete(4),
                 ipComplete(5),
                 registrationComplete(6),
                 accessDenied(7)
             }
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Current Cable Modem connectivity state, as specified
     
     Goren/Raftus               Expires September 2002                  [Page 56]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  in the RF Interface Specification. Returned status
                  information is the CM status as assumed by the CMTS,
                  and indicates the following events:
                  other(1)
                     Any state other than below.
                  ranging(2)
                     The CMTS has received an Initial Ranging Request
                     message from the CM, and the ranging process is not
                     yet complete.
                  rangingAborted(3)
                     The CMTS has sent a Ranging Abort message to the CM.
                  rangingComplete(4)
                     The CMTS has sent a Ranging Complete message to the CM.
                  ipComplete(5)
                     The CMTS has received a DHCP reply message and forwarded
                     it to the CM.
                  registrationComplete(6)
                     The CMTS has sent a Registration Response message to
                     the CM.
                  accessDenied(7)
                     The CMTS has sent a Registration Aborted message
                     to the CM.
                  The CMTS only needs to report states it is able to detect."
             REFERENCE
                 "Document [25] from References, Section 11.2."
             ::= { docsIfCmtsCmStatusEntry 9 }
     
     docsIfCmtsCmStatusUnerroreds OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Codewords received without error from this Cable Modem."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfCmtsCmStatusEntry 10 }
     
     docsIfCmtsCmStatusCorrecteds OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Codewords received with correctable errors from this
                  Cable Modem."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfCmtsCmStatusEntry 11 }
     
     docsIfCmtsCmStatusUncorrectables OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
     
     Goren/Raftus               Expires September 2002                  [Page 57]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             DESCRIPTION
                 "Codewords received with uncorrectable errors from this
                  Cable Modem."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfCmtsCmStatusEntry 12 }
     
     docsIfCmtsCmStatusSignalNoise OBJECT-TYPE
             SYNTAX      TenthdB
             UNITS       "dB"
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Signal/Noise ratio as perceived for upstream data from
                  this Cable Modem.
                  If the Signal/Noise is unknown, this object returns
                  a value of zero."
             REFERENCE
                 "Document [25] from References, Tables 4-1 and 4-2."
             ::= { docsIfCmtsCmStatusEntry 13 }
     
     docsIfCmtsCmStatusMicroreflections OBJECT-TYPE
             SYNTAX      Integer32 (0..255)
             UNITS       "dBc"
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Total microreflections including in-channel response
                  as perceived on this interface, measured in dBc below
                  the signal level.
                  This object is not assumed to return an absolutely
                  accurate value, but should give a rough indication
                  of microreflections received on this interface.
                  It is up to the implementer to provide information
                  as accurate as possible."
             REFERENCE
                 "Document [25] from References, Tables 4-1 and 4-2"
             ::= { docsIfCmtsCmStatusEntry 14 }
     
     docsIfCmtsCmStatusExtUnerroreds OBJECT-TYPE
             SYNTAX      Counter64
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Codewords received without error from this Cable Modem."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfCmtsCmStatusEntry 15 }
     
     docsIfCmtsCmStatusExtCorrecteds OBJECT-TYPE
             SYNTAX      Counter64
             MAX-ACCESS  read-only
     
     Goren/Raftus               Expires September 2002                  [Page 58]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             STATUS      current
             DESCRIPTION
                 "Codewords received with correctable errors from this
                  Cable Modem."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfCmtsCmStatusEntry 16 }
     
     docsIfCmtsCmStatusExtUncorrectables OBJECT-TYPE
             SYNTAX      Counter64
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Codewords received with uncorrectable errors from this
                  Cable Modem."
             REFERENCE
                 "Document [25] from References, Section 6.2.5."
             ::= { docsIfCmtsCmStatusEntry 17 }
     
     docsIfCmtsCmStatusDocsisRegMode OBJECT-TYPE
                SYNTAX      DocsisQosVersion
                MAX-ACCESS  read-only
                STATUS      current
                DESCRIPTION
                    " Indication whether the CM has registered using 1.0 Class of
                      Service or 1.1 Quality of Service.
                      This object mirrors docsIfCmtsCmStatusDocsisMode from the
                      docsIfExt mib."
             REFERENCE
                 "Document [25] from References, Annex G."
                ::= { docsIfCmtsCmStatusEntry 18 }
     
     docsIfCmtsCmStatusModulationType OBJECT-TYPE
              SYNTAX      DocsisUpstreamTypeStatus
              MAX-ACCESS  read-only
              STATUS      current
              DESCRIPTION
                  "Indicates modulation type currently used by the CM. Since
                   this object specifically identifies PHY mode, the shared
                   type is not permitted."
             REFERENCE
                 "Document [25] from References, Table 8-19."
              ::= { docsIfCmtsCmStatusEntry 19 }
     
     docsIfCmtsCmStatusInetAddressType OBJECT-TYPE
                SYNTAX      InetAddressType
                MAX-ACCESS  read-only
                STATUS      current
                DESCRIPTION
                    "The type of internet address of
                     docsIfCmtsCmStatusInetAddress. If the cable modem
                     Internet address is unassigned or unknown, then the
     
     Goren/Raftus               Expires September 2002                  [Page 59]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                     value of this object is unknown(0)."
                ::= { docsIfCmtsCmStatusEntry 20 }
     
        docsIfCmtsCmStatusInetAddress OBJECT-TYPE
               SYNTAX      InetAddress
               MAX-ACCESS  read-only
               STATUS      current
               DESCRIPTION
                    "Internet address of this Cable Modem. If the Cable Modem
                     has no Internet address assigned, or the Internet address
                     is unknown, the value of this object is the empty string.
                     If the Cable Modem has multiple Internet addresses, this
                     object returns the Internet address associated with the
                     Cable (i.e. RF MAC) interface."
                ::= { docsIfCmtsCmStatusEntry 21 }
     
     --
     -- The CMTS Service Table.
     --
     
     docsIfCmtsServiceTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmtsServiceEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes of upstream service queues
                  in a Cable Modem Termination System."
             ::= { docsIfCmtsObjects 4 }
     
     docsIfCmtsServiceEntry OBJECT-TYPE
             SYNTAX      DocsIfCmtsServiceEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes the attributes of a single upstream bandwidth
                  service queue.
     
     
     Expires May 2002                                             [Page 52]
     

     INTERNET-DRAFT          DOCSIS RF Interface MIB            November 2001
     
     
     
                  Entries in this table exist for each ifEntry with an
                  ifType of docsCableMaclayer(127), and for each service
                  queue (Service ID) within this MAC layer.
                  Entries in this table are created with the creation of
                  individual Service IDs by the MAC layer and removed
                  when a Service ID is removed."
             INDEX { ifIndex, docsIfCmtsServiceId }
     
     Goren/Raftus               Expires September 2002                  [Page 60]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             ::= { docsIfCmtsServiceTable 1 }
     
     DocsIfCmtsServiceEntry ::= SEQUENCE {
                 docsIfCmtsServiceId               Integer32,
                 docsIfCmtsServiceCmStatusIndex    Integer32,   -- Deprecated
                 docsIfCmtsServiceAdminStatus      INTEGER,
                 docsIfCmtsServiceQosProfile       Integer32,
                 docsIfCmtsServiceCreateTime       TimeStamp,
                 docsIfCmtsServiceInOctets         Counter32,
                 docsIfCmtsServiceInPackets        Counter32,
                 docsIfCmtsServiceNewCmStatusIndex Integer32
             }
     
     docsIfCmtsServiceId OBJECT-TYPE
             SYNTAX      Integer32 (1..16383)
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Identifies a service queue for upstream bandwidth. The
                  attributes of this service queue are shared between the
                  Cable Modem and the Cable Modem Termination System.
                  The CMTS allocates upstream bandwidth to this service
                  queue based on requests from the CM and on the class of
                  service associated with this queue."
             ::= { docsIfCmtsServiceEntry 1 }
     
     docsIfCmtsServiceCmStatusIndex OBJECT-TYPE
             SYNTAX      Integer32 (0..65535)
             MAX-ACCESS  read-only
             STATUS      deprecated
             DESCRIPTION
                 "Pointer to an entry in docsIfCmtsCmStatusTable identifying
                  the Cable Modem using this Service Queue. If multiple
                  Cable Modems are using this Service Queue, the value of
                  this object is zero.
                  This object has been deprecated and replaced by
                  docsIfCmtsServiceNewCmStatusIndex, to fix a mismatch
                  of the value range with respect to docsIfCmtsCmStatusIndex
                  (1..2147483647)."
             ::= { docsIfCmtsServiceEntry 2 }
     
     docsIfCmtsServiceAdminStatus OBJECT-TYPE
             SYNTAX      INTEGER {
                 enabled(1),
                 disabled(2),
                 destroyed(3) }
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "Allows a service class for a particular modem to be
                  suppressed, (re-)enabled, or deleted altogether."
             ::= { docsIfCmtsServiceEntry 3 }
     
     Goren/Raftus               Expires September 2002                  [Page 61]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfCmtsServiceQosProfile OBJECT-TYPE
             SYNTAX      Integer32 (0..16383)
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The index in docsIfQosProfileTable describing the quality
                  of service attributes associated with this particular
                  service. If no associated docsIfQosProfileTable entry
                  exists, this object returns a value of zero."
             ::= { docsIfCmtsServiceEntry 4 }
     
     docsIfCmtsServiceCreateTime OBJECT-TYPE
     
             SYNTAX      TimeStamp
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The value of sysUpTime when this entry was created."
             ::= { docsIfCmtsServiceEntry 5 }
     
     docsIfCmtsServiceInOctets OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The cumulative number of Packet Data octets received
                  on this Service ID. The count does not include the
                  size of the Cable MAC header"
             ::= { docsIfCmtsServiceEntry 6 }
     
     docsIfCmtsServiceInPackets OBJECT-TYPE
             SYNTAX      Counter32
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "The cumulative number of Packet Data packets received
                  on this Service ID."
             ::= { docsIfCmtsServiceEntry 7 }
     
     docsIfCmtsServiceNewCmStatusIndex OBJECT-TYPE
             SYNTAX      Integer32 (0..2147483647)
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "Pointer (via docsIfCmtsCmStatusIndex) to an entry in
                  docsIfCmtsCmStatusTable identifying the Cable Modem
                  using this Service Queue. If multiple Cable Modems are
                  using this Service Queue, the value of this object is
                  zero."
             ::= { docsIfCmtsServiceEntry 8 }
     
     
     Goren/Raftus               Expires September 2002                  [Page 62]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     --
     -- The following table provides upstream channel modulation profiles.
     -- Entries in this table can be
     -- re-used by one or more upstream channels. An upstream channel will
     -- have a modulation profile
     -- for each value of docsIfModIntervalUsageCode.
     --
     
     
     docsIfCmtsModulationTable OBJECT-TYPE
             SYNTAX      SEQUENCE OF DocsIfCmtsModulationEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes a modulation profile associated with one or more
                  upstream channels."
             ::= { docsIfCmtsObjects 5 }
     
     docsIfCmtsModulationEntry OBJECT-TYPE
             SYNTAX      DocsIfCmtsModulationEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "Describes a modulation profile for an Interval Usage Code
                  for one or more upstream channels.
                  Entries in this table are created by the operator. Initial
                  default entries may be created at system initialization
                  time. No individual objects have to be specified in order
                  to create an entry in this table.
                  Note that some objects do not have DEFVALs, but do have
                  calculated defaults and need not be specified during row
                  creation.
                  There is no restriction on the changing of values in this
                  table while their associated rows are active."
             INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode}
             ::= { docsIfCmtsModulationTable 1 }
     
     DocsIfCmtsModulationEntry ::= SEQUENCE {
                 docsIfCmtsModIndex                    Integer32,
                 docsIfCmtsModIntervalUsageCode        INTEGER,
                 docsIfCmtsModControl                  RowStatus,
                 docsIfCmtsModType                     INTEGER,
                 docsIfCmtsModPreambleLen              Integer32,
                 docsIfCmtsModDifferentialEncoding     TruthValue,
                 docsIfCmtsModFECErrorCorrection       Integer32,
                 docsIfCmtsModFECCodewordLength        Integer32,
                 docsIfCmtsModScramblerSeed            Integer32,
                 docsIfCmtsModMaxBurstSize             Integer32,
                 docsIfCmtsModGuardTimeSize            Unsigned32,
                 docsIfCmtsModLastCodewordShortened    TruthValue,
                 docsIfCmtsModScrambler                TruthValue,
                 docsIfCmtsModByteInterleaverDepth     Unsigned32,
     
     Goren/Raftus               Expires September 2002                  [Page 63]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 docsIfCmtsModByteInterleaverBlockSize Unsigned32,
                 docsIfCmtsModPreambleType             INTEGER,
                 docsIfCmtsModTcmErrorCorrectionOn     TruthValue,
                 docsIfCmtsModScdmaInterleaverStepSize Unsigned32,
                 docsIfCmtsModScdmaSpreaderEnable      TruthValue,
                 docsIfCmtsModScdmaSubframeCodes       Unsigned32,
                 docsIfCmtsModChannelType              DocsisUpstreamType
             }
     
     docsIfCmtsModIndex OBJECT-TYPE
             SYNTAX       Integer32 (1..2147483647)
             MAX-ACCESS   not-accessible
             STATUS      current
             DESCRIPTION
                  "An index into the Channel Modulation table representing
                   a group of Interval Usage Codes, all associated with the
                   same channel."
             ::= { docsIfCmtsModulationEntry 1 }
     
     docsIfCmtsModIntervalUsageCode OBJECT-TYPE
             SYNTAX       INTEGER {
                 request(1),
                 requestData(2),
                 initialRanging(3),
                 periodicRanging(4),
                 shortData(5),
                 longData(6),
                 advPhyShortData(9),
                 advPhyLongData(10),
                 ugs(11)
             }
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "An index into the Channel Modulation table which, when
                  grouped with other Interval Usage Codes, fully
                  instantiate all modulation sets for a given upstream
                  channel."
             REFERENCE
                 "Document [25] from References, Table 8-20."
             ::= { docsIfCmtsModulationEntry 2 }
     
     docsIfCmtsModControl OBJECT-TYPE
             SYNTAX      RowStatus
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Controls and reflects the status of rows in this table."
             ::= { docsIfCmtsModulationEntry 3 }
     
     docsIfCmtsModType  OBJECT-TYPE
             SYNTAX      INTEGER {
     
     Goren/Raftus               Expires September 2002                  [Page 64]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 other(1),
                 qpsk(2),
                 qam16(3),
                 qam8(4),
                 qam32(5),
                 qam64(6),
                 qam128(7)
             }
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The modulation type used on this channel. Returns
                  other(1) if the modulation type is neither
                  qpsk, qam16, qam8, qam32, qam64 or qam128.
                  Type qam128 is used for SCDMA channels only.
                  See the reference for the modulation profiles
                  implied by different modulation types.
                  See the conformance object for write conditions and limitations."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { qpsk }
             ::= { docsIfCmtsModulationEntry 4 }
     
     docsIfCmtsModPreambleLen OBJECT-TYPE
             SYNTAX      Integer32 (0..1536)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The preamble length for this modulation profile in bits.
                  Default value is the minimum needed by the implementation
                  at the CMTS for the given modulation profile."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             ::= { docsIfCmtsModulationEntry 5 }
     
     docsIfCmtsModDifferentialEncoding OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Specifies whether or not differential encoding is used
                  on this channel."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { false }
             ::= { docsIfCmtsModulationEntry 6 }
     
     docsIfCmtsModFECErrorCorrection OBJECT-TYPE
             SYNTAX      Integer32 (0..16)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
     
     Goren/Raftus               Expires September 2002                  [Page 65]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 "The number of correctable errored bytes (t) used in
                  forward error correction code. The value of 0 indicates
                  no correction is employed. The number of check bytes
                  appended will be twice this value."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { 0 }
             ::= { docsIfCmtsModulationEntry 7 }
     
     docsIfCmtsModFECCodewordLength OBJECT-TYPE
             SYNTAX      Integer32 (1..255)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The number of data bytes (k) in the forward error
                  correction codeword.
                  This object is not used if docsIfCmtsModFECErrorCorrection
                  is zero."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { 32 }
             ::= { docsIfCmtsModulationEntry 8 }
     
     docsIfCmtsModScramblerSeed OBJECT-TYPE
             SYNTAX      Integer32 (0..32767)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The 15 bit seed value for the scrambler polynomial."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { 0 }
             ::= { docsIfCmtsModulationEntry 9 }
     
     docsIfCmtsModMaxBurstSize OBJECT-TYPE
             SYNTAX      Integer32 (0..255)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "The maximum number of mini-slots that can be transmitted
                  during this channel's burst time. Returns zero if the
                  burst length is bounded by the allocation MAP rather than
                  this profile.
                  Default value is 0 except for shortData, where it is 8."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             ::= { docsIfCmtsModulationEntry 10 }
     
     docsIfCmtsModGuardTimeSize OBJECT-TYPE
             SYNTAX      Unsigned32
             MAX-ACCESS  read-only
             STATUS      current
     
     Goren/Raftus               Expires September 2002                  [Page 66]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             DESCRIPTION
                 "The number of symbol-times which must follow the end of
                  this channel's burst. Default value is the minimum time
                  needed by the implementation for this modulation profile."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             ::= { docsIfCmtsModulationEntry 11 }
     
     docsIfCmtsModLastCodewordShortened OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Indicates if the last FEC codeword is truncated."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { true }
             ::= { docsIfCmtsModulationEntry 12 }
     
     docsIfCmtsModScrambler OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Indicates if the scrambler is employed."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { false }
             ::= { docsIfCmtsModulationEntry 13 }
     
     docsIfCmtsModByteInterleaverDepth     OBJECT-TYPE
             SYNTAX      Unsigned32
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 " ATDMA Byte Interleaver Depth (Ir). This object returns 1 for
                   non ATDMA profiles. "
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { 1 }
             ::= { docsIfCmtsModulationEntry 14 }
     
     docsIfCmtsModByteInterleaverBlockSize OBJECT-TYPE
             SYNTAX      Unsigned32
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 " ATDMA Byte Interleaver Block size (Br). This object returns
                   zero for non ATDMA profiles "
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { 18 }
     
     Goren/Raftus               Expires September 2002                  [Page 67]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             ::= { docsIfCmtsModulationEntry 15 }
     
     docsIfCmtsModPreambleType        OBJECT-TYPE
             SYNTAX       INTEGER {
                 qpsk0(1),
                 qpsk1(2)
             }
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Preamble type for DOCSIS 2.0 bursts"
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { qpsk0 }
             ::= { docsIfCmtsModulationEntry 16 }
     
     docsIfCmtsModTcmErrorCorrectionOn OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 " Trellis Code Modulation (TCM) On/Off. This value returns false for
                   non S-CDMA profiles."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { false }
             ::= { docsIfCmtsModulationEntry 17 }
     
     docsIfCmtsModScdmaInterleaverStepSize OBJECT-TYPE
             SYNTAX      Unsigned32 (0 | 1..32)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 " S-CDMA Interleaver step size. This value returns zero
                   for non S-CDMA profiles."
             REFERENCE
                 "Document [25] from References, Table 8-19."
     
             DEFVAL { 1 }
             ::= { docsIfCmtsModulationEntry 18 }
     
     docsIfCmtsModScdmaSpreaderEnable      OBJECT-TYPE
             SYNTAX      TruthValue
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 " S-CDMA spreader. This value returns false for non S-CDMA
                   profiles. Default value for IUC 3 and 4 is OFF, for
                   all other IUCs it is ON."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             ::= { docsIfCmtsModulationEntry 19 }
     
     Goren/Raftus               Expires September 2002                  [Page 68]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     docsIfCmtsModScdmaSubframeCodes      OBJECT-TYPE
             SYNTAX      Unsigned32 (0 | 1..128)
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 " S-CDMA sub-frame size. This value returns zero
                   for non S-CDMA profiles."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { 1 }
             ::= { docsIfCmtsModulationEntry 20 }
     
     docsIfCmtsModChannelType              OBJECT-TYPE
             SYNTAX      DocsisUpstreamType
             MAX-ACCESS  read-create
             STATUS      current
             DESCRIPTION
                 "Describes the modulation channel type for this modulation entry."
             REFERENCE
                 "Document [25] from References, Table 8-19."
             DEFVAL { tdma }
             ::= { docsIfCmtsModulationEntry 21 }
     
     docsIfCmtsQosProfilePermissions OBJECT-TYPE
             SYNTAX      BITS {
                 createByManagement(0),
                 updateByManagement(1),
                 createByModems(2)
             }
             MAX-ACCESS  read-write
             STATUS      current
             DESCRIPTION
                 "This object specifies permitted methods of creating
                  entries in docsIfQosProfileTable.
                  CreateByManagement(0) is set if entries can be created
                  using SNMP. UpdateByManagement(1) is set if updating
                  entries using SNMP is permitted. CreateByModems(2)
                  is set if entries can be created based on information
                  in REG-REQ MAC messages received from Cable Modems.
                  Information in this object is only applicable if
                  docsIfQosProfileTable is implemented as read-create.
                  Otherwise, this object is implemented as read-only
                  and returns CreateByModems(2).
                  Either CreateByManagement(0) or CreateByModems(1)
                  must be set when writing to this object.
                  Note that BITS objects are encoded most significant bit
                  first. For example, if bit 2 is set, the value of this
                  object is the octet string '20'H."
             ::= { docsIfCmtsObjects 6 }
     
     docsIfCmtsMacToCmTable OBJECT-TYPE
     
     Goren/Raftus               Expires September 2002                  [Page 69]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             SYNTAX      SEQUENCE OF DocsIfCmtsMacToCmEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "This is a table to provide a quick access index into the
                  docsIfCmtsCmStatusTable. There is exactly one row in this
                  table for each row in the docsIfCmtsCmStatusTable. In
                  general, the management station should use this table only
                  to get a pointer into the docsIfCmtsCmStatusTable (which
                  corresponds to the CM's RF interface MAC address), and
                  should not iterate (e.g. GetNext through) this table."
         ::= { docsIfCmtsObjects 7 }
     
     docsIfCmtsMacToCmEntry OBJECT-TYPE
             SYNTAX      DocsIfCmtsMacToCmEntry
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "A row in the docsIfCmtsMacToCmTable.
                  An entry in this table exists for each Cable Modem
                  that is connected to the CMTS implementing this table."
             INDEX   { docsIfCmtsCmMac }
             ::= {docsIfCmtsMacToCmTable 1 }
     
     DocsIfCmtsMacToCmEntry ::= SEQUENCE {
                     docsIfCmtsCmMac     MacAddress,
                     docsIfCmtsCmPtr     Integer32
             }
     
     docsIfCmtsCmMac OBJECT-TYPE
             SYNTAX      MacAddress
             MAX-ACCESS  not-accessible
             STATUS      current
             DESCRIPTION
                 "The RF side MAC address for the referenced CM. (E.g. the
                  interface on the CM that has docsCableMacLayer(127) as
                  its ifType."
         ::= { docsIfCmtsMacToCmEntry 1 }
     
     docsIfCmtsCmPtr OBJECT-TYPE
             SYNTAX      Integer32 (1..2147483647)
             MAX-ACCESS  read-only
             STATUS      current
             DESCRIPTION
                 "An row index into docsIfCmtsCmStatusTable. When queried
                  with the correct instance value (e.g. a CM's MAC address),
                  returns the index in docsIfCmtsCmStatusTable which
                  represents that CM."
         ::= { docsIfCmtsMacToCmEntry 2 }
     
     
     --
     
     Goren/Raftus               Expires September 2002                  [Page 70]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     -- notification group is for future extension.
     --
     
     docsIfNotification OBJECT IDENTIFIER     ::= { docsIfMib 2 }
     
     docsIfConformance  OBJECT IDENTIFIER     ::= { docsIfMib 3 }
     docsIfCompliances  OBJECT IDENTIFIER     ::= { docsIfConformance 1 }
     docsIfGroups       OBJECT IDENTIFIER     ::= { docsIfConformance 2 }
     
     -- compliance statements
     
     docsIfBasicCompliance MODULE-COMPLIANCE
             STATUS      current
             DESCRIPTION
                 "The compliance statement for devices that implement
                  MCNS/DOCSIS compliant Radio Frequency Interfaces."
     
     MODULE  -- docsIfMib
     
     -- unconditionally mandatory groups
     MANDATORY-GROUPS {
             docsIfBasicGroup
             }
     
     -- conditionally mandatory group
     GROUP docsIfCmGroup
             DESCRIPTION
                 "This group is implemented only in Cable Modems, not in
                  Cable Modem Termination Systems."
     -- conditionally mandatory group
     GROUP docsIfCmtsGroup
             DESCRIPTION
                 "This group is implemented only in Cable Modem Termination
                  Systems, not in Cable Modems."
     
     OBJECT  docsIfDownChannelFrequency
             WRITE-SYNTAX Integer32 (47000000..862000000)
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-write in Cable Modem Termination Systems;
                  read-only in Cable Modems.
                  A range of 54MHz to 860MHz is appropriate for a cable
                  plant using a North American Sub-Split channel plan.
                  The spectrum range has been expanded to accommodate
                  a lower edge of 47MHz and an upper edge of 862MHz
                  for some European channel plans.
                  If DOCSIS is extended to cover other types of channel
                  plans (and frequency allocations) this object will be
                  modified accordingly."
     
     OBJECT  docsIfDownChannelWidth
             WRITE-SYNTAX Integer32 (6000000 | 8000000)
     
     Goren/Raftus               Expires September 2002                  [Page 71]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             MIN-ACCESS  read-only
             DESCRIPTION
                 "It is conformant to implement this object as read-only.
                  In Cable Modems, this object is always implemented as
                  read-only.  The value of 6 MHz is appropriate for cable
                  plants running under NTSC (National Television
                  Standards Committee) standards.  The value of 8 MHz is
                  appropriate for cable plants running under ETSI
                  standards.  For other regional standards, this
                  object will be modified accordingly."
     
     OBJECT  docsIfDownChannelModulation
             WRITE-SYNTAX INTEGER {
                                    qam64 (3),
                                    qam256 (4)
                                  }
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-write in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfDownChannelInterleave
             WRITE-SYNTAX INTEGER {
                         taps8Increment16(3),
                         taps16Increment8(4),
                         taps32Increment4(5),
                         taps64Increment2(6),
                         taps128Increment1(7),
                         taps12increment17(8)
                          }
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-write in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfDownChannelPower
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-write in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelFrequency
             WRITE-SYNTAX Integer32 (5000000..65000000)
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems.
                  A range of 5MHz to 42MHz is appropriate for a cable
                  plant using a North American Sub-Split channel plan.
                  The spectrum range has been expanded to accommodate
                  an upper edge of 65MHz for some European channel plans.
                  If DOCSIS is extended to cover other types of channel
     
     Goren/Raftus               Expires September 2002                  [Page 72]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                  plans (and frequency allocations) this object will
                  be modified accordingly."
     
     OBJECT  docsIfUpChannelWidth
             WRITE-SYNTAX Integer32 (200000..3200000)
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems. The above value is appropriate
                  for cable plants running under  NTSC (National Television
                  Standards Committee) standards.  If DOCSIS is extended to
                  work with other standard (e.g. European standards), this
                  object will be modified accordingly."
     
     OBJECT  docsIfUpChannelModulationProfile
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelSlotSize
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfUpChannelRangingBackoffStart
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelRangingBackoffEnd
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelTxBackoffStart
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelTxBackoffEnd
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelScdmaActiveCodes
     
     Goren/Raftus               Expires September 2002                  [Page 73]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             MIN-ACCESS  read-only
             DESCRIPTION
                                                                                                                                                          "This object is always read-only in Cable Modems. The number of active
                codes when SCDMA is in use must range from 64 to 128, and must be a non-
                Prime value. Providing this range allows for the following features and
                capabilities:
                1) Power management in S-CDMA spreader-on frames (with a 3 dB spread)
                2) Avoidance of code 0
                3) Flexible minislot sizes with and without the use of code 0"
     
     OBJECT  docsIfUpChannelScdmaCodesPerSlot
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelScdmaFrameSize
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelScdmaHoppingSeed
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelType
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelCloneFrom
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelUpdate
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfUpChannelStatus
             MIN-ACCESS  read-only
             DESCRIPTION
                 "Read-create in Cable Modem Termination Systems;
                  read-only in Cable Modems."
     
     OBJECT  docsIfQosProfPriority
     
     Goren/Raftus               Expires September 2002                  [Page 74]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfQosProfMaxUpBandwidth
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfQosProfGuarUpBandwidth
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfQosProfMaxDownBandwidth
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfQosProfBaselinePrivacy
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfQosProfStatus
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfQosProfMaxTransmitBurst
             MIN-ACCESS  read-only
             DESCRIPTION
                 "This object is always read-only in Cable Modems.
                  It is compliant to implement this object as read-only
                  in Cable Modem Termination Systems."
     
     OBJECT  docsIfCmtsServiceAdminStatus
             MIN-ACCESS  read-only
             DESCRIPTION
                 "It is compliant to implement this object as read-only."
     
     Goren/Raftus               Expires September 2002                  [Page 75]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     OBJECT  docsIfCmtsSyncInterval
             MIN-ACCESS  read-only
             DESCRIPTION
                 "It is compliant to implement this object as read-only."
     
     OBJECT  docsIfCmtsUcdInterval
             MIN-ACCESS  read-only
             DESCRIPTION
                 "It is compliant to implement this object as read-only."
     
     OBJECT  docsIfCmtsInsertInterval
             MIN-ACCESS  read-only
             DESCRIPTION
                 "It is compliant to implement this object as read-only."
     
     OBJECT  docsIfCmtsInvitedRangingAttempts
             MIN-ACCESS  read-only
             DESCRIPTION
                 "It is compliant to implement this object as read-only."
     
     OBJECT  docsIfCmtsQosProfilePermissions
             MIN-ACCESS  read-only
             DESCRIPTION
                 "It is compliant to implement this object as read-only."
     
             ::= { docsIfCompliances 1 }
     
     docsIfBasicGroup OBJECT-GROUP
             OBJECTS {
                 docsIfDownChannelId,
                 docsIfDownChannelFrequency,
                 docsIfDownChannelWidth,
                 docsIfDownChannelModulation,
                 docsIfDownChannelInterleave,
                 docsIfDownChannelPower,
                 docsIfDownChannelAnnex,
                 docsIfUpChannelId,
                 docsIfUpChannelFrequency,
                 docsIfUpChannelWidth,
                 docsIfUpChannelModulationProfile,
                 docsIfUpChannelSlotSize,
                 docsIfUpChannelTxTimingOffset,
                 docsIfUpChannelRangingBackoffStart,
                 docsIfUpChannelRangingBackoffEnd,
                 docsIfUpChannelTxBackoffStart,
                 docsIfUpChannelTxBackoffEnd,
                 docsIfUpChannelScdmaActiveCodes,
                 docsIfUpChannelScdmaCodesPerSlot,
                 docsIfUpChannelScdmaFrameSize,
                 docsIfUpChannelScdmaHoppingSeed,
                 docsIfUpChannelType,
     
     Goren/Raftus               Expires September 2002                  [Page 76]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 docsIfUpChannelCloneFrom,
                 docsIfUpChannelUpdate,
                 docsIfUpChannelStatus,
                 docsIfQosProfPriority,
                 docsIfQosProfMaxUpBandwidth,
                 docsIfQosProfGuarUpBandwidth,
                 docsIfQosProfMaxDownBandwidth,
                 docsIfQosProfBaselinePrivacy,
                 docsIfQosProfStatus,
                 docsIfQosProfMaxTransmitBurst,
                 docsIfSigQIncludesContention,
                 docsIfSigQUnerroreds,
                 docsIfSigQCorrecteds,
                 docsIfSigQUncorrectables,
                 docsIfSigQSignalNoise,
                 docsIfSigQMicroreflections,
                 docsIfSigQEqualizationData,
                 docsIfDocsisBaseCapability
             }
             STATUS      current
             DESCRIPTION
                 "Group of objects implemented in both Cable Modems and
                  Cable Modem Termination Systems."
             ::= { docsIfGroups 1 }
     
     docsIfCmGroup OBJECT-GROUP
             OBJECTS {
                 docsIfCmCmtsAddress,
                 docsIfCmCapabilities,
                 docsIfCmRangingTimeout,
     --            docsIfCmRangingRespTimeout,
                 docsIfCmStatusValue,
                 docsIfCmStatusCode,
                 docsIfCmStatusTxPower,
                 docsIfCmStatusResets,
                 docsIfCmStatusLostSyncs,
                 docsIfCmStatusInvalidMaps,
                 docsIfCmStatusInvalidUcds,
                 docsIfCmStatusInvalidRangingResponses,
                 docsIfCmStatusInvalidRegistrationResponses,
                 docsIfCmStatusT1Timeouts,
                 docsIfCmStatusT2Timeouts,
                 docsIfCmStatusT3Timeouts,
                 docsIfCmStatusT4Timeouts,
                 docsIfCmStatusRangingAborteds,
                 docsIfCmStatusDocsisOperMode,
                 docsIfCmStatusModulationType,
                 docsIfCmServiceQosProfile,
                 docsIfCmServiceTxSlotsImmed,
                 docsIfCmServiceTxSlotsDed,
                 docsIfCmServiceTxRetries,
                 docsIfCmServiceTxExceededs,
     
     Goren/Raftus               Expires September 2002                  [Page 77]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 docsIfCmServiceRqRetries,
                 docsIfCmServiceRqExceededs,
                 docsIfCmServiceExtTxSlotsImmed,
                 docsIfCmServiceExtTxSlotsDed
     
             }
             STATUS      current
             DESCRIPTION
                 "Group of objects implemented in Cable Modems."
             ::= { docsIfGroups 2 }
     
     docsIfCmtsGroup OBJECT-GROUP
             OBJECTS {
                 docsIfCmtsCapabilities,
                 docsIfCmtsSyncInterval,
                 docsIfCmtsUcdInterval,
                 docsIfCmtsMaxServiceIds,
     --            docsIfCmtsInsertionInterval,
                 docsIfCmtsInvitedRangingAttempts,
                 docsIfCmtsInsertInterval,
                 docsIfCmtsStatusInvalidRangeReqs,
                 docsIfCmtsStatusRangingAborteds,
                 docsIfCmtsStatusInvalidRegReqs,
                 docsIfCmtsStatusFailedRegReqs,
                 docsIfCmtsStatusInvalidDataReqs,
                 docsIfCmtsStatusT5Timeouts,
                 docsIfCmtsCmStatusMacAddress,
                 docsIfCmtsCmStatusDownChannelIfIndex,
                 docsIfCmtsCmStatusUpChannelIfIndex,
                 docsIfCmtsCmStatusRxPower,
                 docsIfCmtsCmStatusTimingOffset,
                 docsIfCmtsCmStatusEqualizationData,
                 docsIfCmtsCmStatusValue,
                 docsIfCmtsCmStatusUnerroreds,
                 docsIfCmtsCmStatusCorrecteds,
                 docsIfCmtsCmStatusUncorrectables,
                 docsIfCmtsCmStatusSignalNoise,
                 docsIfCmtsCmStatusMicroreflections,
                 docsIfCmtsCmStatusExtUnerroreds,
                 docsIfCmtsCmStatusExtCorrecteds,
                 docsIfCmtsCmStatusExtUncorrectables,
                 docsIfCmtsCmStatusDocsisRegMode,
                 docsIfCmtsCmStatusModulationType,
               docsIfCmtsCmStatusInetAddressType,
               docsIfCmtsCmStatusInetAddress,
                 docsIfCmtsServiceAdminStatus,
                 docsIfCmtsServiceQosProfile,
                 docsIfCmtsServiceCreateTime,
                 docsIfCmtsServiceInOctets,
                 docsIfCmtsServiceInPackets,
                 docsIfCmtsServiceNewCmStatusIndex,
                 docsIfCmtsModType,
     
     Goren/Raftus               Expires September 2002                  [Page 78]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
                 docsIfCmtsModControl,
                 docsIfCmtsModPreambleLen,
                 docsIfCmtsModDifferentialEncoding,
                 docsIfCmtsModFECErrorCorrection,
                 docsIfCmtsModFECCodewordLength,
                 docsIfCmtsModScramblerSeed,
                 docsIfCmtsModMaxBurstSize,
                 docsIfCmtsModGuardTimeSize,
                 docsIfCmtsModLastCodewordShortened,
                 docsIfCmtsModScrambler,
                 docsIfCmtsModByteInterleaverDepth,
                 docsIfCmtsModByteInterleaverBlockSize,
                 docsIfCmtsModPreambleType,
                 docsIfCmtsModTcmErrorCorrectionOn,
                 docsIfCmtsModScdmaInterleaverStepSize,
                 docsIfCmtsModScdmaSpreaderEnable,
                 docsIfCmtsModScdmaSubframeCodes,
                 docsIfCmtsModChannelType,
                 docsIfCmtsQosProfilePermissions,
                 docsIfCmtsCmPtr
             }
             STATUS      current
             DESCRIPTION
                 "Group of objects implemented in Cable Modem Termination
                  Systems."
             ::= { docsIfGroups 3 }
     
     
     docsIfObsoleteGroup OBJECT-GROUP
          OBJECTS {
                 docsIfCmRangingRespTimeout,
                 docsIfCmtsInsertionInterval
             }
             STATUS      obsolete
             DESCRIPTION
                 "Group of objects obsoleted."
             ::= { docsIfGroups 4 }
     
     docsIfDeprecatedGroup OBJECT-GROUP
          OBJECTS {
                 docsIfQosProfMaxTxBurst,
                 docsIfCmtsCmStatusIpAddress,
               docsIfCmtsServiceCmStatusIndex
             }
             STATUS      deprecated
             DESCRIPTION
                 "Group of objects deprecated."
             ::= { docsIfGroups 5 }
     
     
     END
     
     
     Goren/Raftus               Expires September 2002                  [Page 79]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     
     5.  Acknowledgments
          This document is a production of the Docsis 2.0 OSS Working Group.
          It is a revision based on RFC2670, "Radio Frequency (RF) Interface
          Management Information Base for DOCSIS compliant RF interfaces" [22].
     
          The current editors wish to express gratitude to Rich Prodan, Greg
          Nakanishi, Rich Woundy, Eduardo Cardona, and Adi Shaliv for their
          valued advice and opinions.
     
     
     6.  Revision History
     
     6.1. Scope
     
          This MIB in this document has been developed to accommodate DOCSIS 2.0 devices
          and their system capabilities. The MIB is an update to RFC2670 with the
          additional incorporation of EuroDocsis specific items and the DOCS_IF_EXT mib.
     
     6.2. Extension
     
         We have maintained the MIB objects as defined in RFC 2670. In some cases new mib
         objects have been created with identical functionality but greater capacity (ie
         32 to 64 bits). In these situations, both the original 32 bit objects and the new
         64 bit objects must be implemented.
     
     7.  References
     
        [1]  Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for
             Describing SNMP Management Frameworks", RFC 2571, April 1999.
     
        [2]  Rose, M. and K. McCloghrie, "Structure and Identification of
             Management Information for TCP/IP-based Internets", STD 16, RFC
             1155, May 1990.
     
        [3]  Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16,
             RFC 1212, March 1991.
     
        [4]  Rose, M., "A Convention for Defining Traps for use with the
             SNMP", RFC 1215, March 1991.
     
        [5]  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Structure of
             Management Information for Version 2 (SMIv2)", STD 58, RFC 2578,
             April 1999.
     
        [6]  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Textual
             Conventions for SMIv2", STD 58, RFC 2579, April 1999.
     
        [7]  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Conformance
             Statements for SMIv2", STD 58, RFC 2580, April 1999.
     
     
     Goren/Raftus               Expires September 2002                  [Page 80]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        [8]  Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple
             Management Protocol", STD 15, RFC 1157, May 1990.
     
        [9]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
             "Introduction to Community-based SNMPv2", RFC 1901, January
             1996.
     
        [10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Transport
             Mappings for Version 2 of the Simple Network Management Protocol
             (SNMPv2)", RFC 1906, January 1996.
     
        [11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message
             Processing and Dispatching for the Simple Network Management
             Protocol (SNMP)", RFC 2572, April 1999.
     
        [12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM)
             for version 3 of the Simple Network Management Protocol
             (SNMPv3)", RFC 2574, April 1999.
     
        [13] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Protocol
             Operations for Version 2 of the Simple Network Management
             Protocol (SNMPv2)", RFC 1905, January 1996.
     
        [14] Levi, D., Meyer, P. and B. Stewart, "SNMP Applications", RFC
             2573, April 1999.
     
        [15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access
             Control Model (VACM) for the Simple Network Management Protocol
             (SNMP)", RFC 2575, April 1999.
     
        [16] "Data-Over-Cable Service Interface Specifications: Cable
              Modem Radio Frequency Interface Specification SP-RFI-I05-991105",
              DOCSIS, November 1999, http://www.cablemodem.com/.
     
        [17] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB
             using SMIv2", RFC 2863, June 2000.
     
        [18] StJohns, M. , "Cable Device Management Information Base for
             DOCSIS Compliant Cable Modems and Cable Modem Termination
             Systems", RFC2669, August 1999.
     
        [19] Proakis, John G., "Digital Communications, 3rd Edition",
             McGraw-Hill, New York, New York, 1995, ISBN 0-07-051726-6
     
        [20] "Transmission Systems for Interactive Cable Television Services,
             Annex B", J.112, International Telecommunications Union, March
             1998.
     
        [21] Case, J., Mundy, R., Partain, D., and B. Stewart,
             "Introduction to Version 3 of the Internet-standard Network Management
              Framework", RFC 2570, April 1999.
     
     
     Goren/Raftus               Expires September 2002                  [Page 81]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        [22] StJohns, M., "Radio Frequency (RF) Interface Management
             Information Base for MCNS/DOCSIS compliant RF interfaces",
             RFC 2670, August 1999.
     
        [23] "Data-Over-Cable Service Interface Specifications: Cable
              Modem Radio Frequency Interface Specification SP-RFIv1.1-I06-
              001215", DOCSIS, December 2000, http://www.cablemodem.com/.
     
        [24] "Document for the certification of EuroDOCSIS CMs and CMTSs,
              Version 3.3", EuroDOCSIS, February 2000.
     
        [25] "Data-Over-Cable Service Interface Specifications: Radio Frequency
             Interface Specification SP-RFIv2.0-W04-011119", DOCSIS 2.0
             November 2001.
     
        [26] "Data-Over-Cable Service Interface Specifications: Operations
             Support System Interface Specification SP-OSSIv2.0-W01-011119",
             DOCSIS 2.0 November 2001.
     
        [27] Woundy, R., "Baseline Privacy Interface Management
             Information Base for DOCSIS Compliant Cable Modems
             and Cable Modem Termination Systems", RFC3083, March 2001.
     
        [28] "Adapted MIB-definitions and a clarification for MPEG-related
              issues for EuroDOCSIS cable modem systems v1.01", tComLabs,
              May 2000.
     
     
     8.  Security Considerations
     
        This MIB relates to a system which will provide metropolitan public
         internet access.  As such, improper manipulation of the objects
         represented by this MIB may result in denial of service to a large
         number of end-users.  In addition, manipulation of the
         docsIfCmServiceQosProfile, docsIfCmtsServerQosProfile, and the
         elements of docsIfQosProfileTable and docsIfCmtsModulationTable may
         allow an end-user to improve their service response or diminish other
         subscriber's service response.
     
         There are a number of management objects defined in this MIB that
         have a MAX-ACCESS clause of read-write and/or read-create.  Such
         objects may be considered sensitive or vulnerable in some network
         environments.  The support for SET operations in a non-secure
         environment without proper protection can have a negative effect on
         network operations.
     
         SNMPv1 by itself is not a secure environment.  Even if the network
         itself is secure (for example by using IPSec), even then, there is no
         control as to who on the secure network is allowed to access and
         GET/SET (read/change/create/delete) the objects in this MIB.
     
         It is recommended that the implementers consider the security
     
     Goren/Raftus               Expires September 2002                  [Page 82]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
         features as provided by the SNMPv3 framework.  Specifically, the use
         of the User-based Security Model RFC 2574 [12] and the View- based
         Access Control Model RFC 2575 [15] is recommended.
     
         It is then a customer/user responsibility to ensure that the SNMP
         entity giving access to an instance of this MIB, is properly
         configured to give access to the objects only to those principals
         (users) that have legitimate rights to indeed GET or SET
         (change/create/delete) them.
     
     
     9.  Changes from RFC2670
     
          Upstream now separated into 'physical interfaces' and 'logical channels'. An
          instance of the docsIfUpstreamChannelTable exists for each 'logical channel'.
          The IANA ifType for 'logical channels' is 205. The IANA ifType for 'physical
          interfaces' remains at 129.
     
          Object docsIfDownChannelAnnex added to docsIfDownstreamChannelTable. This object
          originated in the EuroDocsis specifications.
     
          Eight new objects added to the docsIfUpstreamChannelTable. One describes the
          channel type in use, while four are specific S-CDMA parameters. The remaining
          three additions are used in the creation of a temporary inactive upstream row
          so the S-CDMA parameters may be manipulated 'offline'.
     
          Object docsIfQosProfMaxTransmitBurst has been added to the docsIfQosProfileTable
          to replace deprecated object docsIfQosProfMaxTxBurst. This fixes a range error
          caused by switch to recording as bytes instead of minislots.
     
          A new base object docsIfDocsisBaseCapability has been added which mirrors the
          functionality of the docsifExt mib object docsIfDocsisCapability, extended to
          include Docsis 2.0.
     
          Two new objects added to the docsIfCmStatusTable. One indicates the current
          modulation type. The other mirrors the functionality of the docsIfExt object
          docsIfDocsisOperMode, while clarifying that it applies to the COS/QOS mode
          used by the device.
     
          Two new 64 bit counters added to the docsIfCmServiceTable to extend the capacity
          of existing 32 bit counters.
     
          Seven new objects added to the docsIfCmtsCmStatusTable. Three are 64 bit
          counters, two add ipv6 capability, and one indicates the CM modulation type
          in use. The remaining object mirrors the functionality of the docsIfExt object
          docsIfCmtsCmStatusDocsisMode, while clarifying that it applies to the COS/QOS
          mode used by the device.
     
          One object added to the docsIfCmtsServiceTable to fix a range error in an
          existing object, that has been deprecated.
     
     
     
     Goren/Raftus               Expires September 2002                  [Page 83]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
          Eight new objects added to the docsIfCmtsModulationTable. Seven of these
          describe ATDMA/S-CDMA channel parameters, while the other describes modulation
          attributes common to all modulation types.
     
          Enumerated values for object docsIfDownChannelInterleave have been expanded to
          include a EuroDocsis value.
     
          Enumerated values for object docsIfCmtsModIntervalUsageCode have been expanded
          to include new Docsis 2.0 values.
     
          Enumerated values for object docsIfCmtsModType have been expanded to include new
          Docsis 2.0 values.
     
          Compliance statements have been updated to reflect new objects and to describe
          EuroDocsis specific implementation features.
     
          The descriptions of objects docsIfCmtsStatusInvalidRegReqs and
          docsIfCmtsStatusFailedRegReqs have been clarified.
     
     10.  Conflict Resolution with docsIfExt MIB
     
          The docsIfExt MIB originated as an engineering change notification (ECN) to the
          Docsis 1.1 specifications, and consisted of three objects - two for CM
          implementation and one for the CMTS. These three objects have been incorporated
          into this new version of the RF MIB, and have been assigned new object
          identifiers.
     
          It is the intention of the authors to deprecate the docsIfExt MIB. Due to
          backward compatibility concerns with Docsis 1.1 implementations, both the new RF
          MIB objects and the former docsIfExt MIB objects will be required for Docsis 2.0
          designs for the immediate future. An influencing factor in this decision is that
          the docsCableDeviceTrap MIB (from the same design update as the docsIfExt MIB)
          contains references to docsIfExt MIB objects in various trap definitions.
     
          The following process will be used to accomplish the eventual deprecation of the
          docsIfExt MIB:
     
               1) Create a Docsis ECN that will require Docsis 1.1 implementations to
               support the new location of the three docsIfExt objects in the RF MIB.
     
               2) The same ECN will update the docsCableDeviceTrap MIB to reference the
               new location of the three docsIfExt objects, and deprecate the former
               references.
     
               3) The same ECN will deprecate the docsIfExt MIB.
     
          Following these steps, the state of affairs will be:
               a) Docsis 1.1 MUST support new RF MIB docsIfExt objects.
               b) Docsis 1.1 MAY support remaining RF MIB 2.0 objects.
               c) Docsis 1.1 MAY support former docsIfExt MIB objects.
               d) Docsis 2.0 MUST support all new RF MIB objects.
               e) Docsis 2.0 MAY support former docsIfExt MIB objects.
     
     Goren/Raftus               Expires September 2002                  [Page 84]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
     
     
     11.  Intellectual Property
     
        The IETF takes no position regarding the validity or scope of any
        intellectual property or other rights that might be claimed to
        pertain to the implementation or use of the technology described in
        this document or the extent to which any license under such rights
        might or might not be available; neither does it represent that it
        has made any effort to identify any such rights.  Information on the
        IETF's procedures with respect to rights in standards-track and
        standards-related documentation can be found in BCP-11.  Copies of
        claims of rights made available for publication and any assurances of
        licenses to be made available, or the result of an attempt made to
        obtain a general license or permission for the use of such
        proprietary rights by implementers or users of this specification can
        be obtained from the IETF Secretariat.
     
        The IETF invites any interested party to bring to its attention any
        copyrights, patents or patent applications, or other proprietary
        rights that may cover technology that may be required to practice
        this standard.  Please address the information to the IETF Executive
        Director.
     
     12.  Authors' Addresses
     
          Aviv Goren
          Terayon
          2952 Bunker Hill Lane
          Santa Clara, CA
          U.S.A.
          Phone:  +1 408 727 4400
          E-mail: aviv.goren@terayon.com
     
          David Raftus
          Imedia Semiconductor
          340 Terry Fox Drive, Suite 202
          Ottawa Ontario
          Canada
          Phone:  +1 613 592 1052
          E-mail: david.raftus@imedia.com
     
     13.  Full Copyright Statement
     
        Copyright (C) The Internet Society (2002).  All Rights Reserved.
     
        This document and translations of it may be copied and furnished to
        others, and derivative works that comment on or otherwise explain it
        or assist in its implementation may be prepared, copied, published
        and distributed, in whole or in part, without restriction of any
        kind, provided that the above copyright notice and this paragraph are
        included on all such copies and derivative works.  However, this
     
     Goren/Raftus               Expires September 2002                  [Page 85]
     

     Internet Draft             DOCSIS RF Interface MIB                 March 2002
     
        document itself may not be modified in any way, such as by removing
        the copyright notice or references to the Internet Society or other
        Internet organizations, except as needed for the purpose of
        developing Internet standards in which case the procedures for
        copyrights defined in the Internet Standards process must be
        followed, or as required to translate it into languages other than
        English.
     
        The limited permissions granted above are perpetual and will not be
        revoked by the Internet Society or its successors or assigns.
     
        This document and the information contained herein is provided on an
        "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
        TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
        BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
        HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
        MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
     
     Acknowledgement
     
        Funding for the RFC Editor function is currently provided by the
        Internet Society.
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     Goren/Raftus               Expires September 2002                  [Page 86]
     

Html markup produced by rfcmarkup 1.107, available from http://tools.ietf.org/tools/rfcmarkup/