home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2670.txt < prev    next >
Encoding:
Text File  |  1999-10-14  |  141.9 KB  |  4,036 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                   M. St. Johns, Ed.
  8. Request for Comments: 2670                                  @Home Network
  9. Category: Proposed Standard                                   August 1999
  10.  
  11.  
  12.        Radio Frequency (RF) Interface Management Information Base
  13.                 for MCNS/DOCSIS compliant RF interfaces
  14.  
  15.  
  16. Status of this Memo
  17.  
  18.    This document specifies an Internet standards track protocol for the
  19.    Internet community, and requests discussion and suggestions for
  20.    improvements.  Please refer to the current edition of the "Internet
  21.    Official Protocol Standards" (STD 1) for the standardization state
  22.    and status of this protocol.  Distribution of this memo is unlimited.
  23.  
  24. Copyright Notice
  25.  
  26.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  27.  
  28. Abstract
  29.  
  30.    This memo defines a portion of the Management Information Base (MIB)
  31.    for use with network management protocols in the Internet community.
  32.    In particular, it defines a basic set of managed objects for SNMP-
  33.    based management of MCNS/DOCSIS compliant Radio Frequency (RF)
  34.    interfaces.
  35.  
  36.    This memo specifies a MIB module in a manner that is compliant to the
  37.    SNMP SMIv2 [5][6][7].  The set of objects are consistent with the
  38.    SNMP framework and existing SNMP standards.
  39.  
  40.    This memo is a product of the IPCDN working group within the Internet
  41.    Engineering Task Force.  Comments are solicited and should be
  42.    addressed to the working group's mailing list at ipcdn@terayon.com
  43.    and/or the author.
  44.  
  45.  Table of Contents
  46.  
  47.    1 The SNMP Management Framework ................................... 3
  48.    2 Glossary ........................................................ 4
  49.    2.1 CATV .......................................................... 4
  50.    2.2 Channel ....................................................... 4
  51.    2.3 CM ............................................................ 4
  52.    2.4 CMTS .......................................................... 4
  53.    2.5 Codeword ...................................................... 4
  54.    2.6 Data Packet ................................................... 4
  55.  
  56.  
  57.  
  58. St. Johns                       Standard                        [Page 1]
  59.  
  60. RFC 2670                DOCSIS RF Interface MIB              August 1999
  61.  
  62.  
  63.    2.7 dBmV .......................................................... 4
  64.    2.8 DOCSIS ........................................................ 5
  65.    2.9 Downstream .................................................... 5
  66.    2.10 Head-end ..................................................... 5
  67.    2.11 MAC Packet ................................................... 5
  68.    2.12 MCNS ......................................................... 5
  69.    2.13 Mini-slot .................................................... 5
  70.    2.14 QPSK ......................................................... 5
  71.    2.15 QAM .......................................................... 5
  72.    2.16 RF ........................................................... 5
  73.    2.17 Symbol-times ................................................. 5
  74.    2.18 Upstream ..................................................... 6
  75.    3 Overview ........................................................ 6
  76.    3.1 Structure of the MIB .......................................... 6
  77.    3.1.1 docsIfBaseObjects ........................................... 6
  78.    3.1.2 docsIfCmObjects ............................................. 7
  79.    3.1.3 docsIfCmtsObjects ........................................... 7
  80.    3.2 Relationship to the Interfaces MIB ............................ 7
  81.    3.2.1 Layering Model .............................................. 7
  82.    3.2.2 Virtual Circuits ............................................ 8
  83.    3.2.3 ifTestTable ................................................. 9
  84.    3.2.4 ifRcvAddressTable ........................................... 9
  85.    3.2.5 ifEntry ..................................................... 9
  86.    3.2.5.1 ifEntry for Downstream interfaces ......................... 9
  87.    3.2.5.1.1 ifEntry for Downstream interfaces in Cable Modem
  88.         Termination Systems .......................................... 9
  89.    3.2.5.1.2 ifEntry for Downstream interfaces in Cable Modems ...... 11
  90.    3.2.5.2 ifEntry for Upstream interfaces .......................... 12
  91.    3.2.5.2.1  ifEntry for Upstream interfaces in Cable Modem
  92.         Termination Systems ......................................... 12
  93.    3.2.5.2.2 ifEntry for Upstream interfaces in Cable Modems ........ 14
  94.    3.2.5.3 ifEntry for the MAC Layer ................................ 15
  95.    4 Definitions .................................................... 18
  96.    5 Acknowledgments ................................................ 69
  97.    6 References ..................................................... 69
  98.    7 Security Considerations ........................................ 70
  99.    8 Intellectual Property .......................................... 71
  100.    9 Author's Address ............................................... 71
  101.    10 Full Copyright Statement ...................................... 72
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. St. Johns                       Standard                        [Page 2]
  115.  
  116. RFC 2670                DOCSIS RF Interface MIB              August 1999
  117.  
  118.  
  119. 1.  The SNMP Management Framework
  120.  
  121.    The SNMP Management Framework presently consists of five major
  122.    components:
  123.  
  124.    o   An overall architecture, described in RFC 2571 [1].
  125.  
  126.    o   Mechanisms for describing and naming objects and events for the
  127.        purpose of management. The first version of this Structure of
  128.        Management Information (SMI) is called SMIv1 and described in STD
  129.        16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The
  130.        second version, called SMIv2, is described in STD 58, RFC 2578
  131.        [5], STD 58, RFC 2579 [6] and STD 58, RFC 2580 [7].
  132.  
  133.    o   Message protocols for transferring management information. The
  134.        first version of the SNMP message protocol is called SNMPv1 and
  135.        described in RFC 1157 [8]. A second version of the SNMP message
  136.        protocol, which is not an Internet standards track protocol, is
  137.        called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10].
  138.        The third version of the message protocol is called SNMPv3 and
  139.        described in RFC 1906 [10], RFC 2572 [11] and RFC 2574 [12].
  140.  
  141.    o   Protocol operations for accessing management information. The
  142.        first set of protocol operations and associated PDU formats is
  143.        described in STD 15, RFC 1157 [8]. A second set of protocol
  144.        operations and associated PDU formats is described in RFC 1905
  145.        [13].
  146.  
  147.    o   A set of fundamental applications described in RFC 2573 [14] and
  148.        the view-based access control mechanism described in RFC 2575
  149.        [15].
  150.  
  151.    Managed objects are accessed via a virtual information store, termed
  152.    the Management Information Base or MIB.  Objects in the MIB are
  153.    defined using the mechanisms defined in the SMI.
  154.  
  155.    This memo specifies a MIB module that is compliant to the SMIv2. A
  156.    MIB conforming to the SMIv1 can be produced through the appropriate
  157.    translations. The resulting translated MIB MUST be semantically
  158.    equivalent, except where objects or events are omitted because no
  159.    translation is possible (use of Counter64). Some machine readable
  160.    information in SMIv2 will be converted into textual descriptions in
  161.    SMIv1 during the translation process. However, this loss of machine
  162.    readable information is not considered to change the semantics of the
  163.    MIB.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. St. Johns                       Standard                        [Page 3]
  171.  
  172. RFC 2670                DOCSIS RF Interface MIB              August 1999
  173.  
  174.  
  175. 2.  Glossary
  176.  
  177.    The terms in this document are derived either from normal cable
  178.    system usage, or from the documents associated with the Data Over
  179.    Cable Service Interface Specification process.
  180.  
  181. 2.1.  CATV
  182.  
  183.    Originally "Community Antenna Television", now used to refer to any
  184.    cable or hybrid fiber and cable system used to deliver video signals
  185.    to a community.
  186.  
  187. 2.2.  Channel
  188.  
  189.    A specific frequency allocation with an RF medium, specified by
  190.    channel width in Hertz (cycles per second) and by center frequency.
  191.    Within the US Cable Systems, upstream channels are generally
  192.    allocated from the 5-42MHz range while down stream channels are
  193.    generally allocated from the 50-750MHz range depending on the
  194.    capabilities of the given system.  The typical broadcast channel
  195.    width in the US is 6MHz.  Upstream channel widths for DOCSIS vary.
  196.  
  197. 2.3.  CM   Cable Modem.
  198.  
  199.    A CM acts as a "slave" station in a DOCSIS compliant cable data
  200.    system.
  201.  
  202. 2.4.  CMTS   Cable Modem Termination System.
  203.  
  204.    A generic term covering a cable bridge or cable router in a head-end.
  205.    A CMTS acts as the master station in a DOCSIS compliant cable data
  206.    system.  It is the only station that transmits downstream, and it
  207.    controls the scheduling of upstream transmissions by its associated
  208.    CMs.
  209.  
  210. 2.5.  Codeword
  211.  
  212.    See [16]. A characteristic of the Foward Error Correction scheme used
  213.    above the RF media layer.
  214.  
  215. 2.6.  Data Packet
  216.  
  217.    The payload portion of the MAC Packet.
  218.  
  219. 2.7.  dBmV
  220.  
  221.    Decibel relative to one milli-volt. A measure of RF power.
  222.  
  223.  
  224.  
  225.  
  226. St. Johns                       Standard                        [Page 4]
  227.  
  228. RFC 2670                DOCSIS RF Interface MIB              August 1999
  229.  
  230.  
  231. 2.8.  DOCSIS
  232.  
  233.    "Data Over Cable Interface Specification".  A term referring to the
  234.    ITU-T J.112 Annex B standard for cable modem systems [20].
  235.  
  236. 2.9.  Downstream
  237.  
  238.    The direction from the head-end towards the subscriber.
  239.  
  240. 2.10.  Head-end
  241.  
  242.    The origination point in most cable systems of the subscriber video
  243.    signals.
  244.  
  245. 2.11.  MAC Packet
  246.  
  247.    A DOCSIS PDU.
  248.  
  249. 2.12.  MCNS
  250.  
  251.    "Multimedia Cable Network System".  Generally replaced in usage by
  252.    DOCSIS.
  253.  
  254. 2.13.  Mini-slot
  255.  
  256.    See [16].  In general, an interval of time which is allocated by the
  257.    CMTS to a given CM for that CM to transmit in an upstream direction.
  258.  
  259. 2.14.  QPSK   Quadrature Phase Shift Keying.
  260.  
  261.    A particular modulation scheme on an RF medium. See [19].
  262.  
  263. 2.15.  QAM   Quadrature Amplitude Modulation.
  264.  
  265.    A particular modulation scheme on on RF medium.  Usually expressed
  266.    with a number indicating the size of the modulation constellation
  267.    (e.g. 16 QAM). See [19], or any other book on digital communications
  268.    over RF for a complete explanation of this.
  269.  
  270. 2.16.  RF
  271.  
  272.    Radio Frequency.
  273.  
  274. 2.17.  Symbol-times
  275.  
  276.    See [16]. A characteristic of the RF modulation scheme.
  277.  
  278.  
  279.  
  280.  
  281.  
  282. St. Johns                       Standard                        [Page 5]
  283.  
  284. RFC 2670                DOCSIS RF Interface MIB              August 1999
  285.  
  286.  
  287. 2.18.  Upstream
  288.  
  289.    The direction from the subscriber towards the head-end.
  290.  
  291. 3.  Overview
  292.  
  293.    This MIB provides a set of objects required for the management of
  294.    MCNS/DOCSIS compliant Cable Modem (CM) and Cable Modem Termination
  295.    System (CMTS) RF interfaces.  The specification is derived in part
  296.    from the parameters and protocols described in DOCSIS Radio Frequency
  297.    Interface Specification [16].
  298.  
  299. 3.1.  Structure of the MIB
  300.  
  301.    This MIB is structured as three groups:
  302.  
  303.    o    Management information pertinent to both Cable Modems (CM) and
  304.         Cable Modem Termination Systems (CMTS) (docsIfBaseObjects).
  305.  
  306.    o    Management information pertinent to Cable Modems only
  307.         (docsIfCmObjects).
  308.  
  309.    o    Management information pertinent to Cable Modem Termination
  310.         Systems only (docsIfCmtsObjects).
  311.  
  312.    Tables within each of these groups group objects functionally - e.g.
  313.    Quality of Service, Channel characteristics, MAC layer management,
  314.    etc.  Rows created automatically (e.g. by the device according to the
  315.    hardware configuration) may and generally will have a mixture of
  316.    configuration and status objects within them.  Rows that are meant to
  317.    be created by the management station are generally restricted to
  318.    configuration (read-create) objects.
  319.  
  320. 3.1.1.  docsIfBaseObjects
  321.  
  322.    docsIfDownstreamChannelTable - This table describes the active
  323.    downstream channels for a CMTS and the received downstream channel
  324.    for a CM.
  325.  
  326.    docsIfUpstreamChannelTable - This table describes the active upstream
  327.    channels for a a CMTS and the current upstream transmission channel
  328.    for a CM.
  329.  
  330.    docsIfQosProfileTable - This table describes the valid Quality of
  331.    Service service profiles for the cable data system.
  332.  
  333.    docsIfSignalQualityTable - This table is used to monitor RF signal
  334.    quality characteristics of received signals.
  335.  
  336.  
  337.  
  338. St. Johns                       Standard                        [Page 6]
  339.  
  340. RFC 2670                DOCSIS RF Interface MIB              August 1999
  341.  
  342.  
  343. 3.1.2.  docsIfCmObjects
  344.  
  345.    docsIfCmMacTable - This table is used to monitor the DOCSIS MAC
  346.    interface and can be considered an extension to the ifEntry.
  347.  
  348.    docsIfCmServiceTable - This table describes the upstream service
  349.    queues available at this CM.  There is a comparable table at the
  350.    CMTS, docsIfCmtsServiceEntry, which describes the service queues from
  351.    the point of view of the CMTS.
  352.  
  353. 3.1.3.  docsIfCmtsObjects
  354.  
  355.    docsIfCmtsStatusTable - This table provides a set of aggregated
  356.    counters which roll-up values and events that occur on the underlying
  357.    sub-interfaces.
  358.  
  359.    docsIfCmtsCmStatusTable - This table is used to hold information
  360.    about known (e.g. registered) cable modems on the system serviced by
  361.    this CMTS.
  362.  
  363.    docsIfCmtsServiceEntry - This table provides access to the
  364.    information related to upstream service queues.
  365.  
  366.    docsIfCmtsModulationTable - This table allows control over the
  367.    modulation profiles for RF channels associated with this CMTS.
  368.  
  369.    docsIfCmtsMacToCmTable - This table allows fast access into the
  370.    docsIfCmtsCmTable via a MAC address (of the CM) interface.
  371.  
  372. 3.2.  Relationship to the Interfaces MIB
  373.  
  374.    This section clarifies the relationship of this MIB to the Interfaces
  375.    MIB [17].  Several areas of correlation are addressed in the
  376.    following subsections.  The implementor is referred to the Interfaces
  377.    MIB document in order to understand the general intent of these
  378.    areas.
  379.  
  380. 3.2.1.  Layering Model
  381.  
  382.    An instance of ifEntry exists for each RF Downstream interface, for
  383.    each RF Upstream interface, and for each RF MAC layer.  The
  384.    ifStackTable [17] MUST be implemented to identify relationships among
  385.    sub-interfaces.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394. St. Johns                       Standard                        [Page 7]
  395.  
  396. RFC 2670                DOCSIS RF Interface MIB              August 1999
  397.  
  398.  
  399.    The following example illustrates a MAC interface with one downstream
  400.    and two upstream channels.
  401.  
  402.                                | <== to network layer
  403.                  +-------------+--------------+
  404.                  |           RF MAC           |
  405.                  +----+---------+-----------+-+
  406.                       |         |           |
  407.             +---------+---+ +---+-------+ +-+---------+
  408.             | Downstream1 | | Upstream1 | | Upstream2 |
  409.             +-------------+ +-----------+ +-----------+
  410.  
  411.    As can be seen from this example, the RF MAC interface is layered on
  412.    top of the downstream and upstream interfaces.
  413.  
  414.    In this example, the assignment of index values could be as follows:
  415.  
  416.       ifIndex ifType                   Description
  417.  
  418.       1    docsCableMaclayer(127)   CATV MAC Layer
  419.       2    docsCableDownstream(128) CATV Downstream interface
  420.       3    docsCableUpstream(129)   CATV Upstream interface
  421.       4    docsCableUpstream(129)   CATV Upstream interface
  422.  
  423.       The corresponding ifStack entries would then be:
  424.  
  425.            | IfStackHigherLayer | ifStackLowerLayer |
  426.            |         0          |         1         |
  427.            |         1          |         2         |
  428.            |         1          |         3         |
  429.            |         1          |         4         |
  430.            |         2          |         0         |
  431.            |         3          |         0         |
  432.            |         4          |         0         |
  433.  
  434.    The same interface model can also be used in Telephony or Telco
  435.    Return systems.  A pure Telco Return system (Cable Modem as well as
  436.    Cable Modem Termination System) would not have upstream, but only
  437.    downstream cable channels.  Systems supporting both Telco Return and
  438.    cable upstream channels can use the above model without modification.
  439.  
  440.    Telco Return Upstream channel(s) are handled by the appropriate MIBs,
  441.    such as PPP or Modem MIBs.
  442.  
  443. 3.2.2.  Virtual Circuits
  444.  
  445.    This medium does not support virtual circuits and this area is not
  446.    applicable to this MIB.
  447.  
  448.  
  449.  
  450. St. Johns                       Standard                        [Page 8]
  451.  
  452. RFC 2670                DOCSIS RF Interface MIB              August 1999
  453.  
  454.  
  455. 3.2.3.  ifTestTable
  456.  
  457.    The ifTestTable is not supported by this MIB.
  458.  
  459. 3.2.4.  ifRcvAddressTable
  460.  
  461.    The ifRcvAddressTable is not supported by this MIB.
  462.  
  463. 3.2.5.  ifEntry
  464.  
  465.    This section documents only the differences from the requirements
  466.    specified in the Interfaces MIB.  See that MIB for columns omitted
  467.    from the descriptions below.
  468.  
  469. 3.2.5.1.  ifEntry for Downstream interfaces
  470.  
  471.    The ifEntry for Downstream interfaces supports the
  472.    ifGeneralInformationGroup and the ifPacketGroup of the Interfaces
  473.    MIB.  This is an output only interface at the CMTS and all input
  474.    status counters - ifIn* - will return zero.  This is an input only
  475.    interface at the CM and all output status counters - ifOut* - will
  476.    return zero.
  477.  
  478. 3.2.5.1.1.  ifEntry for Downstream interfaces in Cable Modem Termination
  479.             Systems
  480.  
  481.    ifTable           Comments
  482.    ==============    ===========================================
  483.    ifIndex           Each RF Cable Downstream interface is represented
  484.                      by an ifEntry.
  485.  
  486.    ifType            The IANA value of docsCableDownstream(128).
  487.  
  488.    ifSpeed           Return the speed of this downstream channel.
  489.                      The returned value the raw bandwidth in bits/s
  490.                      of this interface. This is the symbol rate
  491.                      multiplied with the number of bits per symbol.
  492.  
  493.    ifPhysAddress     Return an empty string.
  494.  
  495.    ifAdminStatus     The administrative status of this interface.
  496.  
  497.    ifOperStatus      The current operational status of this interface.
  498.  
  499.    ifMtu             The size of the largest frame which can be
  500.                      sent on this interface, specified in octets.
  501.                      The value includes the length of the MAC header.
  502.  
  503.  
  504.  
  505.  
  506. St. Johns                       Standard                        [Page 9]
  507.  
  508. RFC 2670                DOCSIS RF Interface MIB              August 1999
  509.  
  510.  
  511.    ifInOctets        Return zero.
  512.  
  513.    ifInUcastPkts     Return zero.
  514.  
  515.    ifInMulticastPkts Return zero.
  516.  
  517.    ifInBroadcastPkts Return zero.
  518.  
  519.    ifInDiscards      Return zero.
  520.  
  521.    ifInErrors        Return zero.
  522.  
  523.    ifInUnknownProtos Return zero.
  524.  
  525.    ifOutOctets       The total number of octets transmitted on this
  526.                      interface. This includes MAC packets as well as
  527.                      data packets, and includes the length of the MAC
  528.                      header.
  529.  
  530.    ifOutUcastPkts    The number of Unicast packets transmitted on this
  531.                      interface. This includes MAC packets as well as
  532.                      data packets.
  533.  
  534.    ifOutMulticastPkts
  535.                      Return the number of Multicast packets transmitted
  536.                      on this interface.
  537.                      This includes MAC packets as well as data packets.
  538.  
  539.    ifOutBroadcastPkts
  540.                      Return the number of broadcast packets transmitted
  541.                      on this interface.
  542.                      This includes MAC packets as well as data packets.
  543.  
  544.    ifOutDiscards     The total number of outbound packets which
  545.                      were discarded. Possible reasons are:
  546.                      buffer shortage.
  547.  
  548.    ifOutErrors       The number of packets which could not be
  549.                      transmitted due to errors.
  550.  
  551.    ifPromiscuousMode Return false.
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562. St. Johns                       Standard                       [Page 10]
  563.  
  564. RFC 2670                DOCSIS RF Interface MIB              August 1999
  565.  
  566.  
  567. 3.2.5.1.2.  ifEntry for Downstream interfaces in Cable Modems
  568.  
  569.    ifTable           Comments
  570.    ==============    ===========================================
  571.    ifIndex           Each RF Cable Downstream interface is represented
  572.                      by an ifEntry.
  573.  
  574.    ifType            The IANA value of docsCableDownstream(128).
  575.  
  576.    ifSpeed           Return the speed of this downstream channel.
  577.                      The returned value the raw bandwidth in bits/s
  578.                      of this interface. This is the symbol rate
  579.                      multiplied with the number of bits per symbol.
  580.  
  581.    ifPhysAddress     Return an empty string.
  582.  
  583.    ifAdminStatus     The administrative status of this interface.
  584.  
  585.    ifOperStatus      The current operational status of this interface.
  586.  
  587.    ifMtu             The size of the largest frame which can be
  588.                      received from this interface, specified in octets.
  589.                      The value includes the length of the MAC header.
  590.  
  591.    ifInOctets        The total number of octets received on this
  592.                      interface. This includes data packets as well as
  593.                      MAC layer packets, and includes the length of the
  594.                      MAC header.
  595.  
  596.    ifInUcastPkts     The number of Unicast packets received on this
  597.                      interface. This includes data packets as well as
  598.                      MAC layer packets.
  599.  
  600.    ifInMulticastPkts Return the number of Multicast packets received
  601.                      on this interface. This includes data packets as
  602.                      well as MAC layer packets.
  603.  
  604.    ifInBroadcastPkts Return the number of Broadcast packets received
  605.                      on this interface. This includes data packets
  606.                      as well as MAC layer packets.
  607.  
  608.    ifInDiscards      The total number of received packets which have
  609.                      been discarded.
  610.                      The possible reasons are: buffer shortage.
  611.  
  612.    ifInErrors        The number of inbound packets that contained
  613.                      errors preventing them from being deliverable
  614.                      to higher layers.
  615.  
  616.  
  617.  
  618. St. Johns                       Standard                       [Page 11]
  619.  
  620. RFC 2670                DOCSIS RF Interface MIB              August 1999
  621.  
  622.  
  623.                      Possible reasons are: MAC FCS error.
  624.  
  625.    ifInUnknownProtos The number of frames with an unknown packet type.
  626.                      These are MAC frames with an unknown packet type.
  627.  
  628.    ifOutOctets       Return zero.
  629.  
  630.    ifOutUcastPkts    Return zero.
  631.  
  632.    ifOutMulticastPkts
  633.                      Return zero.
  634.  
  635.    ifOutBroadcastPkts
  636.                      Return zero.
  637.  
  638.    ifOutDiscards     Return zero.
  639.  
  640.    ifOutErrors       Return zero.
  641.  
  642.    ifPromiscuousMode Refer to the Interfaces MIB.
  643.  
  644. 3.2.5.2.  ifEntry for Upstream interfaces
  645.  
  646.    The ifEntry for Upstream interfaces supports the
  647.    ifGeneralInformationGroup and the ifPacketGroup of the Interfaces
  648.    MIB.  This is an input only interface at the CMTS and all output
  649.    status counters - ifOut* - will return zero.  This is an output only
  650.    interface at the CM and all input status counters - ifIn* - will
  651.    return zero.
  652.  
  653. 3.2.5.2.1.  ifEntry for Upstream interfaces in Cable Modem Termination
  654.             Systems
  655.  
  656.    ifTable           Comments
  657.    ==============    ===========================================
  658.    ifIndex           Each RF Cable Upstream interface is represented
  659.                      by an ifEntry.
  660.  
  661.    ifType            The IANA value of docsCableUpstream(129).
  662.  
  663.    ifSpeed           Return the speed of this upstream channel.
  664.                      The returned value is the raw bandwidth
  665.                      in bits/s of this interface, regarding the
  666.                      highest speed modulation profile that is
  667.                      defined. This is the symbol rate multiplied
  668.                      with the number of bits per symbol for this
  669.                      modulation profile.
  670.  
  671.  
  672.  
  673.  
  674. St. Johns                       Standard                       [Page 12]
  675.  
  676. RFC 2670                DOCSIS RF Interface MIB              August 1999
  677.  
  678.  
  679.    ifPhysAddress     Return an empty string.
  680.  
  681.    ifAdminStatus     The administrative status of this interface.
  682.  
  683.    ifOperStatus      The current operational status of this interface.
  684.  
  685.    ifMtu             The size of the largest frame which can be
  686.                      received on this interface, specified in octets.
  687.                      The value includes the length of the MAC header.
  688.  
  689.    ifInOctets        The total number of octets received on this
  690.                      interface. This includes data packets as well as
  691.                      MAC layer packets, and includes the length of the
  692.                      MAC header.
  693.  
  694.    ifInUcastPkts     The number of Unicast packets received on this
  695.                      interface. This includes data packets as well as
  696.                      MAC layer packets.
  697.  
  698.    ifInMulticastPkts Return the number of Multicast packets received
  699.                      on this interface. This includes data packets as
  700.                      well as MAC layer packets.
  701.  
  702.    ifInBroadcastPkts Return the number of Broadcast packets received
  703.                      on this interface. This includes data packets
  704.                      as well as MAC layer packets.
  705.  
  706.    ifInDiscards      The total number of received packets which have
  707.                      been discarded.
  708.                      The possible reasons are: buffer shortage.
  709.  
  710.    ifInErrors        The number of inbound packets that contained
  711.                      errors preventing them from being deliverable
  712.                      to higher layers.
  713.                      Possible reasons are: MAC FCS error.
  714.  
  715.    ifInUnknownProtos The number of frames with an unknown packet type.
  716.                      This are MAC frames with an unknown packet type.
  717.  
  718.    ifOutOctets       Return zero.
  719.  
  720.    ifOutUcastPkts    Return zero.
  721.  
  722.    ifOutMulticastPkts
  723.                      Return zero.
  724.  
  725.    ifOutBroadcastPkts
  726.                      Return zero.
  727.  
  728.  
  729.  
  730. St. Johns                       Standard                       [Page 13]
  731.  
  732. RFC 2670                DOCSIS RF Interface MIB              August 1999
  733.  
  734.  
  735.    ifOutDiscards     Return zero.
  736.  
  737.    ifOutErrors       Return zero.
  738.  
  739. 3.2.5.2.2.  ifEntry for Upstream interfaces in Cable Modems
  740.  
  741.    ifTable           Comments
  742.    ==============    ===========================================
  743.    ifIndex           Each RF Cable Upstream interface is represented
  744.                      by an ifEntry.
  745.  
  746.    ifType            The IANA value of docsCableUpstream(129).
  747.  
  748.    ifSpeed           Return the speed of this upstream channel.
  749.                      The returned value is the raw bandwidth
  750.                      in bits/s of this interface, regarding the
  751.                      highest speed modulation profile that is
  752.                      defined. This is the symbol rate multiplied
  753.                      with the number of bits per symbol for this
  754.                      modulation profile.
  755.  
  756.    ifPhysAddress     Return an empty string.
  757.  
  758.    ifAdminStatus     The administrative status of this interface.
  759.  
  760.    ifOperStatus      The current operational status of this interface.
  761.  
  762.    ifMtu             The size of the largest frame which can be
  763.                      transmitted on this interface, specified in octets.
  764.                      The value includes the length of the MAC header.
  765.  
  766.    ifInOctets        Return zero.
  767.  
  768.    ifInUcastPkts     Return zero.
  769.  
  770.    ifInMulticastPkts Return zero.
  771.  
  772.    ifInBroadcastPkts Return zero.
  773.  
  774.    ifInDiscards      Return zero.
  775.  
  776.    ifInErrors        Return zero.
  777.  
  778.    ifInUnknownProtos Return zero.
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786. St. Johns                       Standard                       [Page 14]
  787.  
  788. RFC 2670                DOCSIS RF Interface MIB              August 1999
  789.  
  790.  
  791.    ifOutOctets       The total number of octets transmitted on this
  792.                      interface. This includes MAC packets as well as
  793.                      data packets, and includes the length of the MAC
  794.                      header.
  795.  
  796.    ifOutUcastPkts    The number of Unicast packets transmitted on this
  797.                      interface. This includes MAC packets as well as
  798.                      data packets.
  799.  
  800.    ifOutMulticastPkts
  801.                      Return the number of Multicast packets transmitted
  802.                      on this interface.
  803.                      This includes MAC packets as well as data packets.
  804.  
  805.    ifOutBroadcastPkts
  806.                      Return the number of broadcast packets transmitted
  807.                      on this interface.
  808.                      This includes MAC packets as well as data packets.
  809.  
  810.    ifOutDiscards     The total number of outbound packets which
  811.                      were discarded. Possible reasons are:
  812.                      buffer shortage.
  813.  
  814.    ifOutErrors       The number of packets which could not be
  815.                      transmitted due to errors.
  816.  
  817.    ifPromiscuousMode Return false.
  818.  
  819. 3.2.5.3.  ifEntry for the MAC Layer
  820.  
  821.    The ifEntry for the MAC Layer supports the ifGeneralInformationGroup
  822.    and the ifPacketGroup of the Interfaces MIB.  This interface provides
  823.    an aggregate view of status for the lower level Downstream and
  824.    Upstream interfaces.
  825.  
  826.    ifTable           Comments
  827.    ==============    ===========================================
  828.    ifIndex           Each RF Cable MAC layer entity is represented
  829.                      by an ifEntry.
  830.  
  831.    ifType            The IANA value of docsCableMaclayer(127).
  832.  
  833.    ifSpeed           Return zero.
  834.  
  835.    ifPhysAddress     Return the physical address of this interface.
  836.  
  837.    ifAdminStatus     The administrative status of this interface.
  838.  
  839.  
  840.  
  841.  
  842. St. Johns                       Standard                       [Page 15]
  843.  
  844. RFC 2670                DOCSIS RF Interface MIB              August 1999
  845.  
  846.  
  847.    ifOperStatus      The current operational status of the MAC
  848.                      layer interface.
  849.  
  850.    ifHighSpeed       Return zero.
  851.  
  852.    ifMtu             Return 1500.
  853.  
  854.    ifInOctets        The total number of data octets received on this
  855.                      interface, targeted for upper protocol layers.
  856.  
  857.    ifInUcastPkts     The number of Unicast packets received on this
  858.                      interface, targeted for upper protocol layers.
  859.  
  860.    ifInMulticastPkts Return the number of Multicast packets received
  861.                      on this interface, targeted for upper protocol
  862.                      layers.
  863.  
  864.    ifInBroadcastPkts Return the number of Broadcast packets received
  865.                      on this interface, targeted for upper protocol
  866.                      layers.
  867.  
  868.    ifInDiscards      The total number of received packets which have
  869.                      been discarded.
  870.                      The possible reasons are: buffer shortage.
  871.  
  872.    ifInErrors        The number of inbound packets that contained
  873.                      errors preventing them from being deliverable
  874.                      to higher layers.
  875.                      Possible reasons are: data packet FCS error,
  876.                      invalid MAC header.
  877.  
  878.    ifInUnknownProtos The number of frames with an unknown packet type.
  879.                      This is the number of data packets targeted for
  880.                      upper protocol layers with an unknown packet type.
  881.  
  882.    ifOutOctets       The total number of octets, received from upper
  883.                      protocol layers and transmitted on this interface.
  884.  
  885.    ifOutUcastPkts    The number of Unicast packets, received from upper
  886.                      protocol layers and transmitted on this interface.
  887.  
  888.    ifOutMulticastPkts
  889.                      Return the number of Multicast packets received
  890.                      from upper protocol layers and transmitted on this
  891.                      interface.
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898. St. Johns                       Standard                       [Page 16]
  899.  
  900. RFC 2670                DOCSIS RF Interface MIB              August 1999
  901.  
  902.  
  903.    ifOutBroadcastPkts
  904.                      Return the number of broadcast packets received
  905.                      from upper protocol layers and transmitted on this
  906.                      interface.
  907.  
  908.    ifOutDiscards     The total number of outbound packets which
  909.                      were discarded. Possible reasons are:
  910.                      buffer shortage.
  911.  
  912.    ifOutErrors       The number of packets which could not be
  913.                      transmitted due to errors.
  914.  
  915.    ifPromiscuousMode Refer to the Interfaces MIB.
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954. St. Johns                       Standard                       [Page 17]
  955.  
  956. RFC 2670                DOCSIS RF Interface MIB              August 1999
  957.  
  958.  
  959. 4.  Definitions
  960.  
  961. DOCS-IF-MIB DEFINITIONS ::= BEGIN
  962.  
  963.   IMPORTS
  964.         MODULE-IDENTITY,
  965.         OBJECT-TYPE,
  966.   -- do not import        BITS,
  967.         Unsigned32,
  968.         Integer32,
  969.         Counter32,
  970.         TimeTicks,
  971.         IpAddress,
  972.         transmission
  973.                 FROM SNMPv2-SMI
  974.         TEXTUAL-CONVENTION,
  975.         MacAddress,
  976.         RowStatus,
  977.         TruthValue,
  978.         TimeInterval,
  979.         TimeStamp
  980.                 FROM SNMPv2-TC
  981.         OBJECT-GROUP,
  982.  
  983.         MODULE-COMPLIANCE
  984.                 FROM SNMPv2-CONF
  985.         ifIndex, InterfaceIndexOrZero
  986.                 FROM IF-MIB;
  987.  
  988. docsIfMib MODULE-IDENTITY
  989.         LAST-UPDATED    "9908190000Z" -- August 19, 1999
  990.         ORGANIZATION    "IETF IPCDN Working Group"
  991.         CONTACT-INFO
  992.             "        Michael StJohns
  993.              Postal: @Home Network
  994.                      425 Broadway
  995.                      Redwood City, CA
  996.                      U.S.A.
  997.              Phone:  +1 650 569 5368
  998.              E-mail: stjohns@corp.home.net"
  999.         DESCRIPTION
  1000.             "This is the MIB Module for MCNS/DOCSIS compliant Radio
  1001.              Frequency (RF) interfaces in Cable Modems (CM) and
  1002.              Cable Modem Termination Systems (CMTS)."
  1003.         REVISION "9908190000Z"
  1004.         DESCRIPTION
  1005.             "Initial Version, published as RFC 2670.
  1006.              Modified by Mike StJohns to fix problems identified by
  1007.  
  1008.  
  1009.  
  1010. St. Johns                       Standard                       [Page 18]
  1011.  
  1012. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1013.  
  1014.  
  1015.              the first pass of the MIB doctor.  Of special note,
  1016.              docsIfRangingResp and docsIfCmtsInsertionInterval were
  1017.              obsoleted and replaced by other objects with the same
  1018.              functionality, but more appropriate SYNTAX."
  1019.         ::= { transmission 127 }
  1020.  
  1021. -- Textual Conventions
  1022.  
  1023. TenthdBmV ::= TEXTUAL-CONVENTION
  1024.         DISPLAY-HINT "d-1"
  1025.         STATUS       current
  1026.         DESCRIPTION
  1027.             "This data type represents power levels that are normally
  1028.              expressed in dBmV. Units are in tenths of a dBmV;
  1029.              for example, 5.1 dBmV will be represented as 51."
  1030.         SYNTAX       Integer32
  1031.  
  1032. TenthdB ::= TEXTUAL-CONVENTION
  1033.         DISPLAY-HINT "d-1"
  1034.         STATUS       current
  1035.         DESCRIPTION
  1036.             "This data type represents power levels that are normally
  1037.              expressed in dB. Units are in tenths of a dB;
  1038.              for example, 5.1 dB will be represented as 51."
  1039.         SYNTAX       Integer32
  1040.  
  1041. docsIfMibObjects  OBJECT IDENTIFIER ::= { docsIfMib 1 }
  1042. docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 }
  1043. docsIfCmObjects   OBJECT IDENTIFIER ::= { docsIfMibObjects 2 }
  1044. docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 }
  1045.  
  1046. --
  1047. -- BASE GROUP
  1048. --
  1049.  
  1050. --
  1051. -- The following table is implemented on both the Cable Modem (CM)
  1052. -- and the Cable Modem Termination System (CMTS).
  1053. --
  1054.  
  1055. docsIfDownstreamChannelTable OBJECT-TYPE
  1056.         SYNTAX      SEQUENCE OF DocsIfDownstreamChannelEntry
  1057.         MAX-ACCESS  not-accessible
  1058.         STATUS      current
  1059.         DESCRIPTION
  1060.             "This table describes the attributes of downstream
  1061.              channels (frequency bands)."
  1062.         REFERENCE
  1063.  
  1064.  
  1065.  
  1066. St. Johns                       Standard                       [Page 19]
  1067.  
  1068. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1069.  
  1070.  
  1071.             "DOCSIS Radio Frequency Interface Specification,
  1072.              Table 4-12 and Table 4-13."
  1073.         ::= { docsIfBaseObjects 1 }
  1074.  
  1075. docsIfDownstreamChannelEntry OBJECT-TYPE
  1076.         SYNTAX      DocsIfDownstreamChannelEntry
  1077.         MAX-ACCESS  not-accessible
  1078.         STATUS      current
  1079.         DESCRIPTION
  1080.             "An entry provides a list of attributes for a single
  1081.              Downstream channel.
  1082.              An entry in this table exists for each ifEntry with an
  1083.              ifType of docsCableDownstream(128)."
  1084.         INDEX { ifIndex }
  1085.         ::= { docsIfDownstreamChannelTable 1 }
  1086.  
  1087. DocsIfDownstreamChannelEntry ::= SEQUENCE {
  1088.             docsIfDownChannelId               Integer32,
  1089.             docsIfDownChannelFrequency        Integer32,
  1090.             docsIfDownChannelWidth            Integer32,
  1091.             docsIfDownChannelModulation       INTEGER,
  1092.             docsIfDownChannelInterleave       INTEGER,
  1093.             docsIfDownChannelPower            TenthdBmV
  1094.         }
  1095.  
  1096. docsIfDownChannelId OBJECT-TYPE
  1097.         SYNTAX      Integer32 (0..255)
  1098.         MAX-ACCESS  read-only
  1099.         STATUS      current
  1100.         DESCRIPTION
  1101.             "The Cable Modem Termination System (CMTS) identification
  1102.              of the downstream channel within this particular MAC
  1103.              interface. If the interface is down, the object returns
  1104.              the most current value. If the downstream channel ID is
  1105.              unknown, this object returns a value of 0."
  1106.         ::= { docsIfDownstreamChannelEntry 1 }
  1107.  
  1108. docsIfDownChannelFrequency  OBJECT-TYPE
  1109.         SYNTAX      Integer32 (0..1000000000)
  1110.         UNITS       "hertz"
  1111.         MAX-ACCESS  read-write
  1112.         STATUS      current
  1113.         DESCRIPTION
  1114.             "The center of the downstream frequency associated with
  1115.              this channel. This object will return the current tuner
  1116.              frequency. If a CMTS provides IF output, this object
  1117.              will return 0, unless this CMTS is in control of the
  1118.              final downstream RF frequency.  See the associated
  1119.  
  1120.  
  1121.  
  1122. St. Johns                       Standard                       [Page 20]
  1123.  
  1124. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1125.  
  1126.  
  1127.              compliance object for a description of valid frequencies
  1128.              that may be written to this object."
  1129.         REFERENCE
  1130.             "DOCSIS Radio Frequency Interface Specification,
  1131.              Section 4.3.3."
  1132.         ::= { docsIfDownstreamChannelEntry 2 }
  1133.  
  1134. docsIfDownChannelWidth  OBJECT-TYPE
  1135.         SYNTAX      Integer32 (0..16000000)
  1136.         UNITS       "hertz"
  1137.         MAX-ACCESS  read-write
  1138.         STATUS      current
  1139.         DESCRIPTION
  1140.             "The bandwidth of this downstream channel. Most
  1141.              implementations are expected to support a channel width
  1142.              of 6 MHz (North America) and/or 8 MHz (Europe).  See the
  1143.              associated compliance object for a description of the
  1144.              valid channel widths for this object."
  1145.         REFERENCE
  1146.             "DOCSIS Radio Frequency Interface Specification,
  1147.              Table 4-12 and Table 4-13."
  1148.         ::= { docsIfDownstreamChannelEntry 3 }
  1149.  
  1150. docsIfDownChannelModulation OBJECT-TYPE
  1151.         SYNTAX      INTEGER {
  1152.             unknown(1),
  1153.             other(2),
  1154.             qam64(3),
  1155.             qam256(4)
  1156.         }
  1157.         MAX-ACCESS  read-write
  1158.         STATUS      current
  1159.         DESCRIPTION
  1160.             "The modulation type associated with this downstream
  1161.              channel. If the interface is down, this object either
  1162.              returns the configured value (CMTS), the most current
  1163.              value (CM), or the value of unknown(1).  See the
  1164.              associated conformance object for write conditions and
  1165.              limitations. See the reference for specifics on the
  1166.              modulation profiles implied by qam64 and qam256."
  1167.         REFERENCE
  1168.             "DOCSIS Radio Frequency Interface Specification,
  1169.              Section 3.6.2."
  1170.         ::= { docsIfDownstreamChannelEntry 4 }
  1171.  
  1172. docsIfDownChannelInterleave OBJECT-TYPE
  1173.         SYNTAX      INTEGER {
  1174.             unknown(1),
  1175.  
  1176.  
  1177.  
  1178. St. Johns                       Standard                       [Page 21]
  1179.  
  1180. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1181.  
  1182.  
  1183.             other(2),
  1184.             taps8Increment16(3),
  1185.             taps16Increment8(4),
  1186.             taps32Increment4(5),
  1187.             taps64Increment2(6),
  1188.             taps128Increment1(7)
  1189.         }
  1190.         MAX-ACCESS  read-write
  1191.         STATUS      current
  1192.         DESCRIPTION
  1193.             "The Forward Error Correction (FEC) interleaving used
  1194.              for this downstream channel.
  1195.              Values are defined as follows:
  1196.              taps8Increment16(3):   protection 5.9/4.1 usec,
  1197.                                     latency .22/.15 msec
  1198.              taps16Increment8(4):   protection 12/8.2 usec,
  1199.                                     latency .48/.33 msec
  1200.              taps32Increment4(5):   protection 24/16 usec,
  1201.                                     latency .98/.68 msec
  1202.              taps64Increment2(6):   protection 47/33 usec,
  1203.                                     latency 2/1.4 msec
  1204.              taps128Increment1(7):  protection 95/66 usec,
  1205.                                     latency 4/2.8 msec
  1206.              If the interface is down, this object either returns
  1207.              the configured value (CMTS), the most current value (CM),
  1208.              or the value of unknown(1).
  1209.              The value of other(2) is returned if the interleave
  1210.              is known but not defined in the above list.
  1211.              See the associated conformance object for write
  1212.              conditions and limitations. See the reference for the FEC
  1213.              configuration described by the setting of this object."
  1214.         REFERENCE
  1215.             "DOCSIS Radio Frequency Interface Specification,
  1216.              Section 4.3.2."
  1217.         ::= { docsIfDownstreamChannelEntry 5 }
  1218.  
  1219. docsIfDownChannelPower OBJECT-TYPE
  1220.         SYNTAX      TenthdBmV
  1221.         UNITS       "dBmV"
  1222.         MAX-ACCESS  read-write
  1223.         STATUS      current
  1224.         DESCRIPTION
  1225.             "At the CMTS, the operational transmit power. At the CM,
  1226.              the received power level. May be set to zero at the CM
  1227.              if power level measurement is not supported.
  1228.              If the interface is down, this object either returns
  1229.              the configured value (CMTS), the most current value (CM)
  1230.              or the value of 0. See the associated conformance object
  1231.  
  1232.  
  1233.  
  1234. St. Johns                       Standard                       [Page 22]
  1235.  
  1236. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1237.  
  1238.  
  1239.              for write conditions and limitations. See the reference
  1240.              for recommended and required power levels."
  1241.         REFERENCE
  1242.             "DOCSIS Radio Frequency Interface Specification,
  1243.              Table 4-12 and Table 4-13."
  1244.         ::= { docsIfDownstreamChannelEntry 6 }
  1245.  
  1246. --
  1247. -- The following table is implemented on both the CM and the CMTS.
  1248. -- For the CM, only attached channels appear in the table.  For the
  1249. -- CM, this table is read only as well.
  1250. --
  1251.  
  1252. docsIfUpstreamChannelTable OBJECT-TYPE
  1253.         SYNTAX      SEQUENCE OF DocsIfUpstreamChannelEntry
  1254.         MAX-ACCESS  not-accessible
  1255.         STATUS      current
  1256.         DESCRIPTION
  1257.             "This table describes the attributes of attached upstream
  1258.              channels (frequency bands)."
  1259.         ::= { docsIfBaseObjects 2 }
  1260.  
  1261. docsIfUpstreamChannelEntry OBJECT-TYPE
  1262.         SYNTAX      DocsIfUpstreamChannelEntry
  1263.         MAX-ACCESS  not-accessible
  1264.         STATUS      current
  1265.         DESCRIPTION
  1266.             "List of attributes for a single upstream channel.
  1267.              An entry in this table exists for each ifEntry with an
  1268.              ifType of docsCableUpstream(129)."
  1269.         INDEX { ifIndex }
  1270.         ::= { docsIfUpstreamChannelTable 1 }
  1271.  
  1272. DocsIfUpstreamChannelEntry ::= SEQUENCE {
  1273.             docsIfUpChannelId                     Integer32,
  1274.             docsIfUpChannelFrequency              Integer32,
  1275.             docsIfUpChannelWidth                  Integer32,
  1276.             docsIfUpChannelModulationProfile      Unsigned32,
  1277.             docsIfUpChannelSlotSize               Unsigned32,
  1278.             docsIfUpChannelTxTimingOffset         Unsigned32,
  1279.             docsIfUpChannelRangingBackoffStart    Integer32,
  1280.             docsIfUpChannelRangingBackoffEnd      Integer32,
  1281.             docsIfUpChannelTxBackoffStart         Integer32,
  1282.             docsIfUpChannelTxBackoffEnd           Integer32
  1283.         }
  1284.  
  1285. docsIfUpChannelId OBJECT-TYPE
  1286.         SYNTAX      Integer32 (0..255)
  1287.  
  1288.  
  1289.  
  1290. St. Johns                       Standard                       [Page 23]
  1291.  
  1292. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1293.  
  1294.  
  1295.         MAX-ACCESS  read-only
  1296.         STATUS      current
  1297.         DESCRIPTION
  1298.             "The CMTS identification of the upstream channel."
  1299.         ::= { docsIfUpstreamChannelEntry 1 }
  1300.  
  1301. docsIfUpChannelFrequency OBJECT-TYPE
  1302.         SYNTAX      Integer32 (0..1000000000)
  1303.         UNITS       "hertz"
  1304.         MAX-ACCESS  read-write
  1305.         STATUS      current
  1306.         DESCRIPTION
  1307.             "The center of the frequency band associated with this
  1308.              upstream channel. This object returns 0 if the frequency
  1309.              is undefined or unknown. Minimum permitted upstream
  1310.              frequency is 5,000,000 Hz for current technology.  See
  1311.              the associated conformance object for write conditions
  1312.              and limitations."
  1313.         REFERENCE
  1314.             "DOCSIS Radio Frequency Interface Specification,
  1315.              Table 2-2."
  1316.         ::= { docsIfUpstreamChannelEntry 2 }
  1317.  
  1318. docsIfUpChannelWidth OBJECT-TYPE
  1319.         SYNTAX      Integer32 (0..20000000)
  1320.         UNITS       "hertz"
  1321.         MAX-ACCESS  read-write
  1322.         STATUS      current
  1323.         DESCRIPTION
  1324.             "The bandwidth of this upstream channel. This object
  1325.              returns 0 if the channel width is undefined or unknown.
  1326.              Minimum permitted channel width is 200,000 Hz currently.
  1327.              See the associated conformance object for write conditions
  1328.              and limitations."
  1329.         REFERENCE
  1330.             "DOCSIS Radio Frequency Interface Specification,
  1331.              Table 4-3."
  1332.         ::= { docsIfUpstreamChannelEntry 3 }
  1333.  
  1334. docsIfUpChannelModulationProfile OBJECT-TYPE
  1335.         SYNTAX      Unsigned32
  1336.         MAX-ACCESS  read-write
  1337.         STATUS      current
  1338.         DESCRIPTION
  1339.             "An entry identical to the docsIfModIndex in the
  1340.              docsIfCmtsModulationTable that describes this channel.
  1341.              This channel is further instantiated there by a grouping
  1342.              of interval usage codes which together fully describe the
  1343.  
  1344.  
  1345.  
  1346. St. Johns                       Standard                       [Page 24]
  1347.  
  1348. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1349.  
  1350.  
  1351.              channel modulation. This object returns 0 if the
  1352.              docsIfCmtsModulationTable entry does not exist or
  1353.              docsIfCmtsModulationTable is empty. See
  1354.              the associated conformance object for write conditions
  1355.              and limitations."
  1356.         ::= { docsIfUpstreamChannelEntry 4 }
  1357.  
  1358. docsIfUpChannelSlotSize OBJECT-TYPE
  1359.         SYNTAX      Unsigned32
  1360.         MAX-ACCESS  read-write
  1361.         STATUS      current
  1362.         DESCRIPTION
  1363.             "The number of 6.25 microsecond ticks in each upstream mini-
  1364.              slot. Returns zero if the value is undefined or unknown.
  1365.              See the associated conformance object for write
  1366.              conditions and limitations."
  1367.         REFERENCE
  1368.             "DOCSIS Radio Frequency Interface Specification,
  1369.              Section 6.1.2.4."
  1370.         ::= { docsIfUpstreamChannelEntry 5 }
  1371.  
  1372. docsIfUpChannelTxTimingOffset OBJECT-TYPE
  1373.         SYNTAX      Unsigned32
  1374.         MAX-ACCESS  read-only
  1375.         STATUS      current
  1376.         DESCRIPTION
  1377.             "A measure of the current round trip time at the CM, or the
  1378.              maximum round trip time seen by the CMTS.  Used for timing
  1379.              of CM upstream transmissions to ensure synchronized
  1380.              arrivals at the CMTS. Units are in terms of
  1381.              (6.25 microseconds/64)."
  1382.         REFERENCE
  1383.             "DOCSIS Radio Frequency Interface Specification,
  1384.              Section 6.5."
  1385.         ::= { docsIfUpstreamChannelEntry 6 }
  1386.  
  1387. docsIfUpChannelRangingBackoffStart OBJECT-TYPE
  1388.         SYNTAX      Integer32 (0..16)
  1389.         MAX-ACCESS  read-write
  1390.         STATUS      current
  1391.         DESCRIPTION
  1392.             "The initial random backoff window to use when retrying
  1393.              Ranging Requests. Expressed as a power of 2. A value of 16
  1394.              at the CMTS indicates that a proprietary adaptive retry
  1395.              mechanism is to be used. See the associated conformance
  1396.              object for write conditions and limitations."
  1397.         REFERENCE
  1398.             "DOCSIS Radio Frequency Interface Specification,
  1399.  
  1400.  
  1401.  
  1402. St. Johns                       Standard                       [Page 25]
  1403.  
  1404. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1405.  
  1406.  
  1407.              Section 6.4.4."
  1408.         ::= { docsIfUpstreamChannelEntry 7 }
  1409.  
  1410. docsIfUpChannelRangingBackoffEnd OBJECT-TYPE
  1411.         SYNTAX      Integer32 (0..16)
  1412.         MAX-ACCESS  read-write
  1413.         STATUS      current
  1414.         DESCRIPTION
  1415.             "The final random backoff window to use when retrying
  1416.              Ranging Requests. Expressed as a power of 2. A value of 16
  1417.              at the CMTS indicates that a proprietary adaptive retry
  1418.              mechanism is to be used. See the associated conformance
  1419.              object for write conditions and limitations."
  1420.         REFERENCE
  1421.             "DOCSIS Radio Frequency Interface Specification,
  1422.              Section 6.4.4."
  1423.         ::= { docsIfUpstreamChannelEntry 8 }
  1424.  
  1425. docsIfUpChannelTxBackoffStart OBJECT-TYPE
  1426.         SYNTAX      Integer32 (0..16)
  1427.         MAX-ACCESS  read-write
  1428.         STATUS      current
  1429.         DESCRIPTION
  1430.             "The initial random backoff window to use when retrying
  1431.              transmissions. Expressed as a power of 2. A value of 16
  1432.              at the CMTS indicates that a proprietary adaptive retry
  1433.              mechanism is to be used. See the associated conformance
  1434.              object for write conditions and limitations."
  1435.         REFERENCE
  1436.             "DOCSIS Radio Frequency Interface Specification,
  1437.              Section 6.4.4."
  1438.         ::= { docsIfUpstreamChannelEntry 9 }
  1439.  
  1440. docsIfUpChannelTxBackoffEnd OBJECT-TYPE
  1441.         SYNTAX      Integer32 (0..16)
  1442.         MAX-ACCESS  read-write
  1443.         STATUS      current
  1444.         DESCRIPTION
  1445.             "The final random backoff window to use when retrying
  1446.              transmissions. Expressed as a power of 2. A value of 16
  1447.              at the CMTS indicates that a proprietary adaptive retry
  1448.              mechanism is to be used. See the associated conformance
  1449.              object for write conditions and limitations."
  1450.         REFERENCE
  1451.             "DOCSIS Radio Frequency Interface Specification,
  1452.              Section 6.4.4."
  1453.         ::= { docsIfUpstreamChannelEntry 10 }
  1454.  
  1455.  
  1456.  
  1457.  
  1458. St. Johns                       Standard                       [Page 26]
  1459.  
  1460. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1461.  
  1462.  
  1463. -- The following table describes the attributes of each class of
  1464. -- service.  The entries in this table are referenced from the
  1465. -- docsIfServiceEntries.  They exist as a separate table in order to
  1466. -- reduce redundant information in docsIfServiceTable.
  1467. --
  1468. -- This table is implemented at both the CM and the CMTS.
  1469. -- The CM need only maintain entries for the classes of service
  1470. -- referenced by its docsIfServiceTable.
  1471. --
  1472.  
  1473. docsIfQosProfileTable OBJECT-TYPE
  1474.         SYNTAX      SEQUENCE OF DocsIfQosProfileEntry
  1475.         MAX-ACCESS  not-accessible
  1476.         STATUS      current
  1477.         DESCRIPTION
  1478.             "Describes the attributes for each class of service."
  1479.         ::= { docsIfBaseObjects 3 }
  1480.  
  1481. docsIfQosProfileEntry OBJECT-TYPE
  1482.         SYNTAX      DocsIfQosProfileEntry
  1483.         MAX-ACCESS  not-accessible
  1484.         STATUS      current
  1485.         DESCRIPTION
  1486.             "Describes the attributes for a single class of service.
  1487.  
  1488.              If implemented as read-create in the Cable Modem
  1489.              Termination System, creation of entries in this table is
  1490.              controlled by the value of docsIfCmtsQosProfilePermissions.
  1491.  
  1492.              If implemented as read-only, entries are created based
  1493.              on information in REG-REQ MAC messages received from
  1494.              Cable Modems (Cable Modem Termination System
  1495.              implementation), or based on information extracted from
  1496.              the TFTP option file (Cable Modem implementation).
  1497.              In the Cable Modem Termination system, read-only entries
  1498.              are removed if no longer referenced by
  1499.              docsIfCmtsServiceTable.
  1500.  
  1501.              An entry in this table must not be removed while it is
  1502.              referenced by an entry in docsIfCmServiceTable (Cable Modem)
  1503.              or docsIfCmtsServiceTable (Cable Modem Termination System).
  1504.  
  1505.              An entry in this table should not be changeable while
  1506.              it is referenced by an entry in docsIfCmtsServiceTable.
  1507.  
  1508.              If this table is created automatically, there should only
  1509.              be a single entry for each Class of Service. Multiple
  1510.              entries with the same Class of Service parameters are not
  1511.  
  1512.  
  1513.  
  1514. St. Johns                       Standard                       [Page 27]
  1515.  
  1516. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1517.  
  1518.  
  1519.              recommended."
  1520.         INDEX { docsIfQosProfIndex }
  1521.         ::= { docsIfQosProfileTable 1 }
  1522.  
  1523. DocsIfQosProfileEntry ::= SEQUENCE {
  1524.             docsIfQosProfIndex                Integer32,
  1525.             docsIfQosProfPriority             Integer32,
  1526.             docsIfQosProfMaxUpBandwidth       Integer32,
  1527.             docsIfQosProfGuarUpBandwidth      Integer32,
  1528.             docsIfQosProfMaxDownBandwidth     Integer32,
  1529.             docsIfQosProfMaxTxBurst           Integer32,
  1530.             docsIfQosProfBaselinePrivacy      TruthValue,
  1531.             docsIfQosProfStatus               RowStatus
  1532.         }
  1533.  
  1534. docsIfQosProfIndex OBJECT-TYPE
  1535.         SYNTAX      Integer32 (1..16383)
  1536.         MAX-ACCESS  not-accessible
  1537.         STATUS      current
  1538.         DESCRIPTION
  1539.             "The index value which uniquely identifies an entry
  1540.              in the docsIfQosProfileTable."
  1541.         ::= { docsIfQosProfileEntry 1 }
  1542.  
  1543. docsIfQosProfPriority  OBJECT-TYPE
  1544.         SYNTAX      Integer32 (0..7)
  1545.         MAX-ACCESS  read-create
  1546.         STATUS      current
  1547.         DESCRIPTION
  1548.             "A relative priority assigned to this service when
  1549.              allocating bandwidth. Zero indicates lowest priority;
  1550.              and seven indicates highest priority.
  1551.              Interpretation of priority is device-specific.
  1552.              MUST NOT be changed while this row is active."
  1553.         DEFVAL { 0 }
  1554.         ::= { docsIfQosProfileEntry 2 }
  1555.  
  1556. docsIfQosProfMaxUpBandwidth OBJECT-TYPE
  1557.         SYNTAX      Integer32 (0..100000000)
  1558.         MAX-ACCESS  read-create
  1559.         STATUS      current
  1560.         DESCRIPTION
  1561.             "The maximum upstream bandwidth, in bits per second,
  1562.              allowed for a service with this service class.
  1563.              Zero if there is no restriction of upstream bandwidth.
  1564.              MUST NOT be changed while this row is active."
  1565.         DEFVAL { 0 }
  1566.         ::= { docsIfQosProfileEntry 3 }
  1567.  
  1568.  
  1569.  
  1570. St. Johns                       Standard                       [Page 28]
  1571.  
  1572. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1573.  
  1574.  
  1575. docsIfQosProfGuarUpBandwidth OBJECT-TYPE
  1576.         SYNTAX      Integer32 (0..100000000)
  1577.         MAX-ACCESS  read-create
  1578.         STATUS      current
  1579.         DESCRIPTION
  1580.             "Minimum guaranteed upstream bandwidth, in bits per second,
  1581.              allowed for a service with this service class.
  1582.              MUST NOT be changed while this row is active."
  1583.         DEFVAL { 0 }
  1584.         ::= { docsIfQosProfileEntry 4 }
  1585.  
  1586. docsIfQosProfMaxDownBandwidth OBJECT-TYPE
  1587.         SYNTAX      Integer32 (0..100000000)
  1588.         MAX-ACCESS  read-create
  1589.         STATUS      current
  1590.         DESCRIPTION
  1591.             "The maximum downstream bandwidth, in bits per second,
  1592.              allowed for a service with this service class.
  1593.              Zero if there is no restriction of downstream bandwidth.
  1594.              MUST NOT be changed while this row is active."
  1595.         DEFVAL { 0 }
  1596.         ::= { docsIfQosProfileEntry 5 }
  1597.  
  1598. docsIfQosProfMaxTxBurst OBJECT-TYPE
  1599.         SYNTAX      Integer32 (0..255)
  1600.         MAX-ACCESS  read-create
  1601.         STATUS      current
  1602.         DESCRIPTION
  1603.             "The maximum number of mini-slots that may be requested
  1604.              for a single upstream transmission.
  1605.              A value of zero means there is no limit.
  1606.              MUST NOT be changed while this row is active."
  1607.         DEFVAL { 0 }
  1608.         ::= { docsIfQosProfileEntry 6 }
  1609.  
  1610. docsIfQosProfBaselinePrivacy  OBJECT-TYPE
  1611.         SYNTAX      TruthValue
  1612.         MAX-ACCESS  read-create
  1613.         STATUS      current
  1614.         DESCRIPTION
  1615.             "Indicates whether Baseline Privacy is enabled for this
  1616.              service class.
  1617.              MUST NOT be changed while this row is active."
  1618.         DEFVAL { false }
  1619.         ::= { docsIfQosProfileEntry 7 }
  1620.  
  1621. docsIfQosProfStatus OBJECT-TYPE
  1622.         SYNTAX      RowStatus
  1623.  
  1624.  
  1625.  
  1626. St. Johns                       Standard                       [Page 29]
  1627.  
  1628. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1629.  
  1630.  
  1631.         MAX-ACCESS  read-create
  1632.         STATUS      current
  1633.         DESCRIPTION
  1634.             "This is object is to used to create or delete rows in
  1635.              this table.  This object MUST NOT be changed from active
  1636.              while the row is referenced by the any entry in either
  1637.              docsIfCmServiceTable (on the CM), or the
  1638.              docsIfCmtsServiceTable (on the CMTS)."
  1639.         ::= { docsIfQosProfileEntry 8 }
  1640.  
  1641.  
  1642. docsIfSignalQualityTable OBJECT-TYPE
  1643.         SYNTAX      SEQUENCE OF DocsIfSignalQualityEntry
  1644.         MAX-ACCESS  not-accessible
  1645.         STATUS      current
  1646.         DESCRIPTION
  1647.             "At the CM, describes the PHY signal quality of downstream
  1648.              channels. At the CMTS, describes the PHY signal quality of
  1649.              upstream channels. At the CMTS, this table may exclude
  1650.              contention intervals."
  1651.         ::= { docsIfBaseObjects 4 }
  1652.  
  1653. docsIfSignalQualityEntry OBJECT-TYPE
  1654.         SYNTAX      DocsIfSignalQualityEntry
  1655.         MAX-ACCESS  not-accessible
  1656.         STATUS      current
  1657.         DESCRIPTION
  1658.             "At the CM, describes the PHY characteristics of a
  1659.              downstream channel. At the CMTS, describes the PHY signal
  1660.              quality of an upstream channel.
  1661.              An entry in this table exists for each ifEntry with an
  1662.              ifType of docsCableUpstream(129) for Cable Modem Termination
  1663.              Systems and docsCableDownstream(128) for Cable Modems."
  1664.         INDEX { ifIndex }
  1665.         ::= { docsIfSignalQualityTable 1 }
  1666.  
  1667. DocsIfSignalQualityEntry ::= SEQUENCE {
  1668.             docsIfSigQIncludesContention  TruthValue,
  1669.             docsIfSigQUnerroreds          Counter32,
  1670.             docsIfSigQCorrecteds          Counter32,
  1671.             docsIfSigQUncorrectables      Counter32,
  1672.             docsIfSigQSignalNoise         TenthdB,
  1673.             docsIfSigQMicroreflections    Integer32,
  1674.             docsIfSigQEqualizationData    OCTET STRING
  1675.         }
  1676.  
  1677. docsIfSigQIncludesContention OBJECT-TYPE
  1678.         SYNTAX      TruthValue
  1679.  
  1680.  
  1681.  
  1682. St. Johns                       Standard                       [Page 30]
  1683.  
  1684. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1685.  
  1686.  
  1687.         MAX-ACCESS  read-only
  1688.         STATUS      current
  1689.         DESCRIPTION
  1690.             "true(1) if this CMTS includes contention intervals in
  1691.              the counters in this table. Always false(2) for CMs."
  1692.         REFERENCE
  1693.             "DOCSIS Radio Frequency Interface specification,
  1694.              Section 6.4.4"
  1695.         ::= { docsIfSignalQualityEntry 1 }
  1696.  
  1697. docsIfSigQUnerroreds OBJECT-TYPE
  1698.         SYNTAX      Counter32
  1699.         MAX-ACCESS  read-only
  1700.         STATUS      current
  1701.         DESCRIPTION
  1702.             "Codewords received on this channel without error.
  1703.              This includes all codewords, whether or not they
  1704.              were part of frames destined for this device."
  1705.         REFERENCE
  1706.             "DOCSIS Radio Frequency Interface specification,
  1707.              Section 4.2.3 and 4.3.6"
  1708.         ::= { docsIfSignalQualityEntry 2 }
  1709.  
  1710. docsIfSigQCorrecteds OBJECT-TYPE
  1711.         SYNTAX      Counter32
  1712.         MAX-ACCESS  read-only
  1713.         STATUS      current
  1714.         DESCRIPTION
  1715.             "Codewords received on this channel with correctable
  1716.              errors. This includes all codewords, whether or not
  1717.              they were part of frames destined for this device."
  1718.         REFERENCE
  1719.             "DOCSIS Radio Frequency Interface specification,
  1720.              Section 4.2.3 and 4.3.6"
  1721.         ::= { docsIfSignalQualityEntry 3 }
  1722.  
  1723. docsIfSigQUncorrectables OBJECT-TYPE
  1724.         SYNTAX      Counter32
  1725.         MAX-ACCESS  read-only
  1726.         STATUS      current
  1727.         DESCRIPTION
  1728.             "Codewords received on this channel with uncorrectable
  1729.              errors. This includes all codewords, whether or not
  1730.              they were part of frames destined for this device."
  1731.         REFERENCE
  1732.             "DOCSIS Radio Frequency Interface specification,
  1733.              Section 4.2.3 and 4.3.6"
  1734.         ::= { docsIfSignalQualityEntry 4 }
  1735.  
  1736.  
  1737.  
  1738. St. Johns                       Standard                       [Page 31]
  1739.  
  1740. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1741.  
  1742.  
  1743. docsIfSigQSignalNoise OBJECT-TYPE
  1744.         SYNTAX      TenthdB
  1745.         UNITS       "dB"
  1746.         MAX-ACCESS  read-only
  1747.         STATUS      current
  1748.         DESCRIPTION
  1749.             "Signal/Noise ratio as perceived for this channel.
  1750.              At the CM, describes the Signal/Noise of the downstream
  1751.              channel.  At the CMTS, describes the average Signal/Noise
  1752.              of the upstream channel."
  1753.         REFERENCE
  1754.             "DOCSIS Radio Frequency Interface specification,
  1755.              Table 2-1 and 2-2"
  1756.         ::= { docsIfSignalQualityEntry 5 }
  1757.  
  1758. docsIfSigQMicroreflections OBJECT-TYPE
  1759.         SYNTAX      Integer32 (0..255)
  1760.         UNITS       "dBc"
  1761.         MAX-ACCESS  read-only
  1762.         STATUS      current
  1763.         DESCRIPTION
  1764.             "Total microreflections including in-channel response
  1765.              as perceived on this interface, measured in dBc below
  1766.              the signal level.
  1767.              This object is not assumed to return an absolutely
  1768.              accurate value, but should give a rough indication
  1769.              of microreflections received on this interface.
  1770.              It is up to the implementor to provide information
  1771.              as accurate as possible."
  1772.         REFERENCE
  1773.             "DOCSIS Radio Frequency Interface specification,
  1774.              Table 2-1 and 2-2"
  1775.         ::= { docsIfSignalQualityEntry 6 }
  1776.  
  1777. docsIfSigQEqualizationData OBJECT-TYPE
  1778.         SYNTAX      OCTET STRING
  1779.         MAX-ACCESS  read-only
  1780.         STATUS      current
  1781.         DESCRIPTION
  1782.             "At the CM, returns the equalization data for the downstream
  1783.              channel. At the CMTS, returns the average equalization
  1784.              data for the upstream channel. Returns an empty string
  1785.              if the value is unknown or if there is no equalization
  1786.              data available or defined."
  1787.         REFERENCE
  1788.             "DOCSIS Radio Frequency Interface Specification,
  1789.              Figure 6-23."
  1790.         ::= { docsIfSignalQualityEntry 7 }
  1791.  
  1792.  
  1793.  
  1794. St. Johns                       Standard                       [Page 32]
  1795.  
  1796. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1797.  
  1798.  
  1799. --
  1800. -- CABLE MODEM GROUP
  1801. --
  1802.  
  1803. -- #######
  1804.  
  1805. --
  1806. -- The CM MAC Table
  1807. --
  1808.  
  1809. docsIfCmMacTable OBJECT-TYPE
  1810.         SYNTAX      SEQUENCE OF DocsIfCmMacEntry
  1811.         MAX-ACCESS  not-accessible
  1812.         STATUS      current
  1813.         DESCRIPTION
  1814.             "Describes the attributes of each CM MAC interface,
  1815.              extending the information available from ifEntry."
  1816.         ::= { docsIfCmObjects 1 }
  1817.  
  1818. docsIfCmMacEntry OBJECT-TYPE
  1819.         SYNTAX      DocsIfCmMacEntry
  1820.         MAX-ACCESS  not-accessible
  1821.         STATUS      current
  1822.         DESCRIPTION
  1823.             "An entry containing objects describing attributes of
  1824.              each MAC entry, extending the information in ifEntry.
  1825.              An entry in this table exists for each ifEntry with an
  1826.              ifType of docsCableMaclayer(127)."
  1827.         INDEX { ifIndex }
  1828.         ::= { docsIfCmMacTable 1 }
  1829.  
  1830. DocsIfCmMacEntry ::= SEQUENCE {
  1831.             docsIfCmCmtsAddress           MacAddress,
  1832.             docsIfCmCapabilities          BITS,
  1833.             docsIfCmRangingRespTimeout    TimeTicks,
  1834.             docsIfCmRangingTimeout        TimeInterval
  1835.         }
  1836.  
  1837. docsIfCmCmtsAddress OBJECT-TYPE
  1838.         SYNTAX      MacAddress
  1839.         MAX-ACCESS  read-only
  1840.         STATUS      current
  1841.         DESCRIPTION
  1842.             "Identifies the CMTS that is believed to control this MAC
  1843.              domain. At the CM, this will be the source address from
  1844.              SYNC, MAP, and other MAC-layer messages. If the CMTS is
  1845.              unknown, returns 00-00-00-00-00-00."
  1846.         ::= { docsIfCmMacEntry 1 }
  1847.  
  1848.  
  1849.  
  1850. St. Johns                       Standard                       [Page 33]
  1851.  
  1852. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1853.  
  1854.  
  1855. docsIfCmCapabilities OBJECT-TYPE
  1856.         SYNTAX      BITS {
  1857.             atmCells(0),
  1858.             concatenation(1)
  1859.         }
  1860.         MAX-ACCESS  read-only
  1861.         STATUS      current
  1862.         DESCRIPTION
  1863.             "Identifies the capabilities of the MAC implementation
  1864.              at this interface. Note that packet transmission is
  1865.              always supported. Therefore, there is no specific bit
  1866.              required to explicitely indicate this capability."
  1867.         ::= { docsIfCmMacEntry 2 }
  1868.  
  1869. -- This object has been obsoleted and replaced by
  1870. -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New
  1871. -- implementations of the MIB should use docsIfCmRangingTimeout instead.
  1872.  
  1873. docsIfCmRangingRespTimeout OBJECT-TYPE
  1874.         SYNTAX      TimeTicks
  1875.         MAX-ACCESS  read-write
  1876.         STATUS      obsolete
  1877.         DESCRIPTION
  1878.             "Waiting time for a Ranging Response packet."
  1879.         REFERENCE
  1880.             "DOCSIS Radio Frequency Interface specification,
  1881.              Figure 7-6 and 7-7, timer T3."
  1882.         DEFVAL { 20 }
  1883.         ::= { docsIfCmMacEntry 3 }
  1884.  
  1885. docsIfCmRangingTimeout OBJECT-TYPE
  1886.         SYNTAX      TimeInterval
  1887.         MAX-ACCESS  read-write
  1888.         STATUS      current
  1889.         DESCRIPTION
  1890.             "Waiting time for a Ranging Response packet."
  1891.         REFERENCE
  1892.             "DOCSIS Radio Frequency Interface specification,
  1893.              Figure 7-6 and 7-7, timer T3."
  1894.         DEFVAL { 20 }
  1895.         ::= { docsIfCmMacEntry 4 }
  1896.  
  1897. --
  1898. -- CM status table.
  1899. -- This table is implemented only at the CM.
  1900. --
  1901.  
  1902. docsIfCmStatusTable OBJECT-TYPE
  1903.  
  1904.  
  1905.  
  1906. St. Johns                       Standard                       [Page 34]
  1907.  
  1908. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1909.  
  1910.  
  1911.         SYNTAX      SEQUENCE OF DocsIfCmStatusEntry
  1912.         MAX-ACCESS  not-accessible
  1913.         STATUS      current
  1914.         DESCRIPTION
  1915.             "This table maintains a number of status objects
  1916.              and counters for Cable Modems."
  1917.         ::= { docsIfCmObjects 2 }
  1918.  
  1919. docsIfCmStatusEntry OBJECT-TYPE
  1920.         SYNTAX      DocsIfCmStatusEntry
  1921.         MAX-ACCESS  not-accessible
  1922.         STATUS      current
  1923.         DESCRIPTION
  1924.             "A set of status objects and counters for a single MAC
  1925.              layer instance in a Cable Modem.
  1926.              An entry in this table exists for each ifEntry with an
  1927.              ifType of docsCableMaclayer(127)."
  1928.         INDEX { ifIndex }
  1929.         ::= { docsIfCmStatusTable 1 }
  1930.  
  1931. DocsIfCmStatusEntry ::= SEQUENCE {
  1932.             docsIfCmStatusValue                     INTEGER,
  1933.             docsIfCmStatusCode                      OCTET STRING,
  1934.             docsIfCmStatusTxPower                   TenthdBmV,
  1935.             docsIfCmStatusResets                    Counter32,
  1936.             docsIfCmStatusLostSyncs                 Counter32,
  1937.             docsIfCmStatusInvalidMaps               Counter32,
  1938.             docsIfCmStatusInvalidUcds               Counter32,
  1939. --            docsIfCmStatusInvalidRangingResp        Counter32,
  1940.             docsIfCmStatusInvalidRangingResponses   Counter32,
  1941. --            docsIfCmStatusInvalidRegistrationResp   Counter32,
  1942.             docsIfCmStatusInvalidRegistrationResponses Counter32,
  1943.             docsIfCmStatusT1Timeouts                Counter32,
  1944.             docsIfCmStatusT2Timeouts                Counter32,
  1945.             docsIfCmStatusT3Timeouts                Counter32,
  1946.             docsIfCmStatusT4Timeouts                Counter32,
  1947.             docsIfCmStatusRangingAborteds           Counter32
  1948.         }
  1949.  
  1950. docsIfCmStatusValue OBJECT-TYPE
  1951.         SYNTAX      INTEGER {
  1952.             other(1),
  1953.             notReady(2),
  1954.             notSynchronized(3),
  1955.             phySynchronized(4),
  1956.             usParametersAcquired(5),
  1957.             rangingComplete(6),
  1958.             ipComplete(7),
  1959.  
  1960.  
  1961.  
  1962. St. Johns                       Standard                       [Page 35]
  1963.  
  1964. RFC 2670                DOCSIS RF Interface MIB              August 1999
  1965.  
  1966.  
  1967.             todEstablished(8),
  1968.             securityEstablished(9),
  1969.             paramTransferComplete(10),
  1970.             registrationComplete(11),
  1971.             operational(12),
  1972.             accessDenied(13)
  1973.         }
  1974.         MAX-ACCESS  read-only
  1975.         STATUS      current
  1976.         DESCRIPTION
  1977.             "Current Cable Modem connectivity state, as specified
  1978.              in the RF Interface Specification."
  1979.         REFERENCE
  1980.             "DOCSIS Radio Frequency Interface Specification,
  1981.              Chapter 7.2."
  1982.         ::= { docsIfCmStatusEntry 1 }
  1983.  
  1984. docsIfCmStatusCode OBJECT-TYPE
  1985.         SYNTAX      OCTET STRING
  1986.         MAX-ACCESS  read-only
  1987.         STATUS      current
  1988.         DESCRIPTION
  1989.             "Status code for this Cable Modem as defined in the
  1990.              RF Interface Specification. The status code consists
  1991.              of a single character indicating error groups, followed
  1992.              by a two- or three-digit number indicating the status
  1993.              condition."
  1994.         REFERENCE
  1995.             "DOCSIS Radio Frequency Interface Specification,
  1996.              Cable Modem status codes."
  1997.         ::= { docsIfCmStatusEntry 2 }
  1998.  
  1999. docsIfCmStatusTxPower OBJECT-TYPE
  2000.         SYNTAX      TenthdBmV
  2001.         UNITS       "dBmV"
  2002.         MAX-ACCESS  read-only
  2003.         STATUS      current
  2004.         DESCRIPTION
  2005.             "The operational transmit power for the attached upstream
  2006.              channel."
  2007.         REFERENCE
  2008.             "DOCSIS Radio Frequency Interface specification,
  2009.              Section 4.2.8."
  2010.         ::= { docsIfCmStatusEntry 3 }
  2011.  
  2012. docsIfCmStatusResets OBJECT-TYPE
  2013.         SYNTAX      Counter32
  2014.         MAX-ACCESS  read-only
  2015.  
  2016.  
  2017.  
  2018. St. Johns                       Standard                       [Page 36]
  2019.  
  2020. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2021.  
  2022.  
  2023.         STATUS      current
  2024.         DESCRIPTION
  2025.             "Number of times the CM reset or initialized
  2026.              this interface."
  2027.         ::= { docsIfCmStatusEntry 4 }
  2028.  
  2029. docsIfCmStatusLostSyncs OBJECT-TYPE
  2030.         SYNTAX      Counter32
  2031.         MAX-ACCESS  read-only
  2032.         STATUS      current
  2033.         DESCRIPTION
  2034.             "Number of times the CM lost synchronization with
  2035.              the downstream channel."
  2036.         REFERENCE
  2037.             "DOCSIS Radio Frequency Interface specification,
  2038.              Section 6.5."
  2039.         ::= { docsIfCmStatusEntry 5 }
  2040.  
  2041. docsIfCmStatusInvalidMaps OBJECT-TYPE
  2042.         SYNTAX      Counter32
  2043.         MAX-ACCESS  read-only
  2044.         STATUS      current
  2045.         DESCRIPTION
  2046.             "Number of times the CM received invalid MAP messages."
  2047.         REFERENCE
  2048.             "DOCSIS Radio Frequency Interface specification,
  2049.              Section 6.3.2.3 and 6.4.2."
  2050.         ::= { docsIfCmStatusEntry 6 }
  2051.  
  2052. docsIfCmStatusInvalidUcds OBJECT-TYPE
  2053.         SYNTAX      Counter32
  2054.         MAX-ACCESS  read-only
  2055.         STATUS      current
  2056.         DESCRIPTION
  2057.             "Number of times the CM received invalid UCD messages."
  2058.         REFERENCE
  2059.             "DOCSIS Radio Frequency Interface specification,
  2060.              Section 6.3.2.2."
  2061.         ::= { docsIfCmStatusEntry 7 }
  2062.  
  2063. -- docsIfCmStatusInvalidRangingResp replaced for Counter32
  2064. -- naming requirements
  2065.  
  2066. docsIfCmStatusInvalidRangingResponses OBJECT-TYPE
  2067.         SYNTAX      Counter32
  2068.         MAX-ACCESS  read-only
  2069.         STATUS      current
  2070.         DESCRIPTION
  2071.  
  2072.  
  2073.  
  2074. St. Johns                       Standard                       [Page 37]
  2075.  
  2076. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2077.  
  2078.  
  2079.             "Number of times the CM received invalid ranging response
  2080.              messages."
  2081.         ::= { docsIfCmStatusEntry 8 }
  2082.  
  2083. -- docsIfCmStatusInvalidRegistrationResp replaced for
  2084. -- Counter32 naming requirements
  2085. docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE
  2086.         SYNTAX      Counter32
  2087.         MAX-ACCESS  read-only
  2088.         STATUS      current
  2089.         DESCRIPTION
  2090.             "Number of times the CM received invalid registration
  2091.              response messages."
  2092.         ::= { docsIfCmStatusEntry 9 }
  2093.  
  2094. docsIfCmStatusT1Timeouts OBJECT-TYPE
  2095.         SYNTAX      Counter32
  2096.         MAX-ACCESS  read-only
  2097.         STATUS      current
  2098.         DESCRIPTION
  2099.             "Number of times counter T1 expired in the CM."
  2100.         REFERENCE
  2101.             "DOCSIS Radio Frequency Interface specification,
  2102.              Figure 7-3."
  2103.         ::= { docsIfCmStatusEntry 10 }
  2104.  
  2105. docsIfCmStatusT2Timeouts OBJECT-TYPE
  2106.         SYNTAX      Counter32
  2107.         MAX-ACCESS  read-only
  2108.         STATUS      current
  2109.         DESCRIPTION
  2110.             "Number of times counter T2 expired in the CM."
  2111.         REFERENCE
  2112.             "DOCSIS Radio Frequency Interface specification,
  2113.              Figure 7-6."
  2114.         ::= { docsIfCmStatusEntry 11 }
  2115.  
  2116. docsIfCmStatusT3Timeouts OBJECT-TYPE
  2117.         SYNTAX      Counter32
  2118.         MAX-ACCESS  read-only
  2119.         STATUS      current
  2120.         DESCRIPTION
  2121.             "Number of times counter T3 expired in the CM."
  2122.         REFERENCE
  2123.             "DOCSIS Radio Frequency Interface specification,
  2124.              Figure 7-6 and 7-7."
  2125.         ::= { docsIfCmStatusEntry 12 }
  2126.  
  2127.  
  2128.  
  2129.  
  2130. St. Johns                       Standard                       [Page 38]
  2131.  
  2132. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2133.  
  2134.  
  2135. docsIfCmStatusT4Timeouts OBJECT-TYPE
  2136.         SYNTAX      Counter32
  2137.         MAX-ACCESS  read-only
  2138.         STATUS      current
  2139.         DESCRIPTION
  2140.             "Number of times counter T4 expired in the CM."
  2141.         REFERENCE
  2142.             "DOCSIS Radio Frequency Interface specification,
  2143.              Figure 7-7."
  2144.         ::= { docsIfCmStatusEntry 13 }
  2145.  
  2146. docsIfCmStatusRangingAborteds OBJECT-TYPE
  2147.         SYNTAX      Counter32
  2148.         MAX-ACCESS  read-only
  2149.         STATUS      current
  2150.         DESCRIPTION
  2151.             "Number of times the ranging process was aborted
  2152.              by the CMTS."
  2153.         ::= { docsIfCmStatusEntry 14 }
  2154.  
  2155. --
  2156. -- The Cable Modem Service Table
  2157. --
  2158.  
  2159. docsIfCmServiceTable  OBJECT-TYPE
  2160.         SYNTAX      SEQUENCE OF DocsIfCmServiceEntry
  2161.         MAX-ACCESS  not-accessible
  2162.         STATUS      current
  2163.         DESCRIPTION
  2164.             "Describes the attributes of each upstream service queue
  2165.              on a CM."
  2166.         ::= { docsIfCmObjects 3 }
  2167.  
  2168. docsIfCmServiceEntry OBJECT-TYPE
  2169.         SYNTAX      DocsIfCmServiceEntry
  2170.         MAX-ACCESS  not-accessible
  2171.         STATUS      current
  2172.         DESCRIPTION
  2173.             "Describes the attributes of an upstream bandwidth service
  2174.              queue.
  2175.              An entry in this table exists for each Service ID.
  2176.              The primary index is an ifIndex with an ifType of
  2177.              docsCableMaclayer(127)."
  2178.         INDEX { ifIndex, docsIfCmServiceId }
  2179.         ::= { docsIfCmServiceTable 1 }
  2180.  
  2181. DocsIfCmServiceEntry ::= SEQUENCE {
  2182.             docsIfCmServiceId               Integer32,
  2183.  
  2184.  
  2185.  
  2186. St. Johns                       Standard                       [Page 39]
  2187.  
  2188. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2189.  
  2190.  
  2191.             docsIfCmServiceQosProfile       Integer32,
  2192.             docsIfCmServiceTxSlotsImmed     Counter32,
  2193.             docsIfCmServiceTxSlotsDed       Counter32,
  2194.             docsIfCmServiceTxRetries        Counter32,
  2195.  
  2196. --            docsIfCmServiceTxExceeded       Counter32,
  2197.             docsIfCmServiceTxExceededs      Counter32,
  2198.             docsIfCmServiceRqRetries        Counter32,
  2199. --            docsIfCmServiceRqExceeded       Counter32
  2200.             docsIfCmServiceRqExceededs      Counter32
  2201.         }
  2202.  
  2203. docsIfCmServiceId OBJECT-TYPE
  2204.         SYNTAX      Integer32 (1..16383)
  2205.         MAX-ACCESS  not-accessible
  2206.         STATUS      current
  2207.         DESCRIPTION
  2208.             "Identifies a service queue for upstream bandwidth. The
  2209.              attributes of this service queue are shared between the
  2210.              CM and the CMTS. The CMTS allocates upstream bandwidth
  2211.              to this service queue based on requests from the CM and
  2212.              on the class of service associated with this queue."
  2213.         ::= { docsIfCmServiceEntry 1 }
  2214.  
  2215. docsIfCmServiceQosProfile OBJECT-TYPE
  2216.         SYNTAX      Integer32 (0..16383)
  2217.         MAX-ACCESS  read-only
  2218.         STATUS      current
  2219.         DESCRIPTION
  2220.             "The index in docsIfQosProfileTable describing the quality
  2221.              of service attributes associated with this particular
  2222.              service. If no associated entry in docsIfQosProfileTable
  2223.              exists, this object returns a value of zero."
  2224.         ::= { docsIfCmServiceEntry 2 }
  2225.  
  2226. docsIfCmServiceTxSlotsImmed OBJECT-TYPE
  2227.         SYNTAX      Counter32
  2228.         MAX-ACCESS  read-only
  2229.         STATUS      current
  2230.         DESCRIPTION
  2231.             "The number of upstream mini-slots which have been used to
  2232.              transmit data PDUs in immediate (contention) mode. This
  2233.              includes only those PDUs which are presumed to have
  2234.              arrived at the headend (i.e., those which were explicitly
  2235.              acknowledged.) It does not include retransmission attempts
  2236.              or mini-slots used by Requests."
  2237.         REFERENCE
  2238.             "DOCSIS Radio Frequency Interface specification,
  2239.  
  2240.  
  2241.  
  2242. St. Johns                       Standard                       [Page 40]
  2243.  
  2244. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2245.  
  2246.  
  2247.              Section 6.4."
  2248.         ::= { docsIfCmServiceEntry 3 }
  2249.  
  2250. docsIfCmServiceTxSlotsDed OBJECT-TYPE
  2251.         SYNTAX      Counter32
  2252.         MAX-ACCESS  read-only
  2253.         STATUS      current
  2254.         DESCRIPTION
  2255.             "The number of upstream mini-slots which have been used to
  2256.              transmit data PDUs in dedicated mode (i.e., as a result
  2257.              of a unicast Data Grant)."
  2258.         REFERENCE
  2259.             "DOCSIS Radio Frequency Interface specification,
  2260.              Section 6.4."
  2261.         ::= { docsIfCmServiceEntry 4 }
  2262.  
  2263. docsIfCmServiceTxRetries OBJECT-TYPE
  2264.         SYNTAX      Counter32
  2265.         MAX-ACCESS  read-only
  2266.         STATUS      current
  2267.         DESCRIPTION
  2268.             "The number of attempts to transmit data PDUs containing
  2269.              requests for acknowledgment which did not result in
  2270.              acknowledgment."
  2271.         REFERENCE
  2272.             "DOCSIS Radio Frequency Interface specification,
  2273.              Section 6.4."
  2274.         ::= { docsIfCmServiceEntry 5 }
  2275.  
  2276. -- docsIfCmServiceTxExceeded renamed for Counter32 naming requirements
  2277. docsIfCmServiceTxExceededs OBJECT-TYPE
  2278.         SYNTAX      Counter32
  2279.         MAX-ACCESS  read-only
  2280.         STATUS      current
  2281.         DESCRIPTION
  2282.             "The number of data PDUs transmission failures due to
  2283.              excessive retries without acknowledgment."
  2284.         REFERENCE
  2285.             "DOCSIS Radio Frequency Interface specification,
  2286.              Section 6.4."
  2287.         ::= { docsIfCmServiceEntry 6 }
  2288.  
  2289. docsIfCmServiceRqRetries OBJECT-TYPE
  2290.         SYNTAX      Counter32
  2291.         MAX-ACCESS  read-only
  2292.         STATUS      current
  2293.         DESCRIPTION
  2294.             "The number of attempts to transmit bandwidth requests
  2295.  
  2296.  
  2297.  
  2298. St. Johns                       Standard                       [Page 41]
  2299.  
  2300. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2301.  
  2302.  
  2303.              which did not result in acknowledgment."
  2304.         REFERENCE
  2305.             "DOCSIS Radio Frequency Interface specification,
  2306.              Section 6.4."
  2307.         ::= { docsIfCmServiceEntry 7 }
  2308.  
  2309.  
  2310. -- docsIfCmServiceRqExceeded renamed for Counter 32 naming
  2311. -- requirements
  2312. docsIfCmServiceRqExceededs OBJECT-TYPE
  2313.         SYNTAX      Counter32
  2314.         MAX-ACCESS  read-only
  2315.         STATUS      current
  2316.         DESCRIPTION
  2317.             "The number of requests for bandwidth which failed due to
  2318.              excessive retries without acknowledgment."
  2319.         REFERENCE
  2320.             "DOCSIS Radio Frequency Interface specification,
  2321.              Section 6.4."
  2322.         ::= { docsIfCmServiceEntry 8 }
  2323.  
  2324. --
  2325. -- CMTS GROUP
  2326. --
  2327.  
  2328. --
  2329. -- The CMTS MAC Table
  2330. --
  2331.  
  2332. docsIfCmtsMacTable OBJECT-TYPE
  2333.         SYNTAX      SEQUENCE OF DocsIfCmtsMacEntry
  2334.         MAX-ACCESS  not-accessible
  2335.         STATUS      current
  2336.         DESCRIPTION
  2337.             "Describes the attributes of each CMTS MAC interface,
  2338.              extending the information available from ifEntry.
  2339.              Mandatory for all CMTS devices."
  2340.         ::= { docsIfCmtsObjects 1 }
  2341.  
  2342. docsIfCmtsMacEntry OBJECT-TYPE
  2343.         SYNTAX      DocsIfCmtsMacEntry
  2344.         MAX-ACCESS  not-accessible
  2345.         STATUS      current
  2346.         DESCRIPTION
  2347.             "An entry containing objects describing attributes of each
  2348.              MAC entry, extending the information in ifEntry.
  2349.              An entry in this table exists for each ifEntry with an
  2350.              ifType of docsCableMaclayer(127)."
  2351.  
  2352.  
  2353.  
  2354. St. Johns                       Standard                       [Page 42]
  2355.  
  2356. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2357.  
  2358.  
  2359.         INDEX { ifIndex }
  2360.         ::= { docsIfCmtsMacTable 1 }
  2361.  
  2362. DocsIfCmtsMacEntry ::= SEQUENCE {
  2363.             docsIfCmtsCapabilities            BITS,
  2364.             docsIfCmtsSyncInterval            Integer32,
  2365.             docsIfCmtsUcdInterval             Integer32,
  2366.             docsIfCmtsMaxServiceIds           Integer32,
  2367.             docsIfCmtsInsertionInterval       TimeTicks,   -- Obsolete
  2368.             docsIfCmtsInvitedRangingAttempts  Integer32,
  2369.             docsIfCmtsInsertInterval          TimeInterval
  2370.         }
  2371.  
  2372. docsIfCmtsCapabilities OBJECT-TYPE
  2373.         SYNTAX      BITS {
  2374.             atmCells(0),
  2375.             concatenation(1)
  2376.         }
  2377.         MAX-ACCESS  read-only
  2378.         STATUS      current
  2379.         DESCRIPTION
  2380.             "Identifies the capabilities of the CMTS MAC
  2381.              implementation at this interface. Note that packet
  2382.              transmission is always supported. Therefore, there
  2383.              is no specific bit required to explicitely indicate
  2384.              this capability."
  2385.         REFERENCE
  2386.             "DOCSIS Radio Frequency Interface specification,
  2387.              Chapter 6."
  2388.         ::= { docsIfCmtsMacEntry 1 }
  2389.  
  2390. docsIfCmtsSyncInterval OBJECT-TYPE
  2391.         SYNTAX      Integer32 (1..200)
  2392.         UNITS       "Milliseconds"
  2393.         MAX-ACCESS  read-write
  2394.         STATUS      current
  2395.         DESCRIPTION
  2396.             "The interval between CMTS transmission of successive SYNC
  2397.              messages at this interface."
  2398.         REFERENCE
  2399.             "DOCSIS Radio Frequency Interface Specification,
  2400.              Section 6.5 and Appendix B."
  2401.         ::= { docsIfCmtsMacEntry 2 }
  2402.  
  2403. docsIfCmtsUcdInterval OBJECT-TYPE
  2404.         SYNTAX      Integer32 (1..2000)
  2405.         UNITS       "Milliseconds"
  2406.         MAX-ACCESS  read-write
  2407.  
  2408.  
  2409.  
  2410. St. Johns                       Standard                       [Page 43]
  2411.  
  2412. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2413.  
  2414.  
  2415.         STATUS      current
  2416.         DESCRIPTION
  2417.             "The interval between CMTS transmission of successive
  2418.              Upstream Channel Descriptor messages for each upstream
  2419.              channel at this interface."
  2420.         REFERENCE
  2421.             "DOCSIS Radio Frequency Interface Specification,
  2422.              Section 6.5 and Appendix B."
  2423.         ::= { docsIfCmtsMacEntry 3 }
  2424.  
  2425. docsIfCmtsMaxServiceIds OBJECT-TYPE
  2426.         SYNTAX     Integer32 (1..16383)
  2427.         MAX-ACCESS read-only
  2428.         STATUS     current
  2429.         DESCRIPTION
  2430.             "The maximum number of service IDs that may be
  2431.              simultaneously active."
  2432.         ::= { docsIfCmtsMacEntry 4 }
  2433.  
  2434.  
  2435. -- This object has been obsoleted and replaced by
  2436. -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem.  New
  2437. -- implementations of this MIB should use that object instead.
  2438. docsIfCmtsInsertionInterval OBJECT-TYPE
  2439.         SYNTAX      TimeTicks
  2440.         MAX-ACCESS  read-write
  2441.         STATUS      obsolete
  2442.         DESCRIPTION
  2443.             "The amount of time to elapse between each broadcast
  2444.              station maintenance grant. Broadcast station maintenance
  2445.              grants are used to allow new cable modems to join the
  2446.              network. Zero indicates that a vendor-specific algorithm
  2447.              is used instead of a fixed time. Maximum amount of time
  2448.              permitted by the specification is 2 seconds."
  2449.         REFERENCE
  2450.             "DOCSIS Radio Frequency Interface Specification,
  2451.              Appendix B, Ranging Interval."
  2452.         ::= { docsIfCmtsMacEntry 5 }
  2453.  
  2454. docsIfCmtsInvitedRangingAttempts OBJECT-TYPE
  2455.         SYNTAX      Integer32 (0..1024)
  2456.         MAX-ACCESS  read-write
  2457.         STATUS      current
  2458.         DESCRIPTION
  2459.             "The maximum number of attempts to make on invitations
  2460.              for ranging requests. A value of zero means the system
  2461.              should attempt to range forever."
  2462.         REFERENCE
  2463.  
  2464.  
  2465.  
  2466. St. Johns                       Standard                       [Page 44]
  2467.  
  2468. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2469.  
  2470.  
  2471.             "DOCSIS Radio Frequency Interface specification,
  2472.              Section 7.2.5 and Appendix B."
  2473.         ::= { docsIfCmtsMacEntry 6 }
  2474.  
  2475. docsIfCmtsInsertInterval OBJECT-TYPE
  2476.         SYNTAX      TimeInterval
  2477.         MAX-ACCESS  read-write
  2478.         STATUS      current
  2479.         DESCRIPTION
  2480.             "The amount of time to elapse between each broadcast
  2481.              station maintenance grant. Broadcast station maintenance
  2482.              grants are used to allow new cable modems to join the
  2483.              network. Zero indicates that a vendor-specific algorithm
  2484.              is used instead of a fixed time. Maximum amount of time
  2485.              permitted by the specification is 2 seconds."
  2486.         REFERENCE
  2487.             "DOCSIS Radio Frequency Interface Specification,
  2488.              Appendix B."
  2489.         ::= { docsIfCmtsMacEntry 7 }
  2490.  
  2491. --
  2492. --
  2493. -- CMTS status table.
  2494. --
  2495.  
  2496. docsIfCmtsStatusTable OBJECT-TYPE
  2497.         SYNTAX      SEQUENCE OF DocsIfCmtsStatusEntry
  2498.         MAX-ACCESS  not-accessible
  2499.         STATUS      current
  2500.         DESCRIPTION
  2501.             "For the MAC layer, this group maintains a number of
  2502.              status objects and counters."
  2503.         ::= { docsIfCmtsObjects 2 }
  2504.  
  2505. docsIfCmtsStatusEntry OBJECT-TYPE
  2506.         SYNTAX      DocsIfCmtsStatusEntry
  2507.         MAX-ACCESS  not-accessible
  2508.         STATUS      current
  2509.         DESCRIPTION
  2510.             "Status entry for a single MAC layer.
  2511.              An entry in this table exists for each ifEntry with an
  2512.              ifType of docsCableMaclayer(127)."
  2513.         INDEX { ifIndex }
  2514.         ::= { docsIfCmtsStatusTable 1 }
  2515.  
  2516. DocsIfCmtsStatusEntry ::= SEQUENCE {
  2517.             docsIfCmtsStatusInvalidRangeReqs        Counter32,
  2518.             docsIfCmtsStatusRangingAborteds         Counter32,
  2519.  
  2520.  
  2521.  
  2522. St. Johns                       Standard                       [Page 45]
  2523.  
  2524. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2525.  
  2526.  
  2527.             docsIfCmtsStatusInvalidRegReqs          Counter32,
  2528.             docsIfCmtsStatusFailedRegReqs           Counter32,
  2529.             docsIfCmtsStatusInvalidDataReqs         Counter32,
  2530.             docsIfCmtsStatusT5Timeouts              Counter32
  2531.         }
  2532.  
  2533. docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE
  2534.         SYNTAX      Counter32
  2535.         MAX-ACCESS  read-only
  2536.         STATUS      current
  2537.         DESCRIPTION
  2538.             "This object counts invalid RNG-REQ messages received on
  2539.              this interface."
  2540.         ::= { docsIfCmtsStatusEntry 1 }
  2541.  
  2542. docsIfCmtsStatusRangingAborteds OBJECT-TYPE
  2543.         SYNTAX      Counter32
  2544.         MAX-ACCESS  read-only
  2545.         STATUS      current
  2546.         DESCRIPTION
  2547.             "This object counts ranging attempts that were explicitely
  2548.              aborted by the CMTS."
  2549.         ::= { docsIfCmtsStatusEntry 2 }
  2550.  
  2551. docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE
  2552.         SYNTAX      Counter32
  2553.         MAX-ACCESS  read-only
  2554.         STATUS      current
  2555.         DESCRIPTION
  2556.             "This object counts invalid REG-REQ messages received on
  2557.              this interface."
  2558.         ::= { docsIfCmtsStatusEntry 3 }
  2559.  
  2560. docsIfCmtsStatusFailedRegReqs OBJECT-TYPE
  2561.         SYNTAX      Counter32
  2562.         MAX-ACCESS  read-only
  2563.         STATUS      current
  2564.         DESCRIPTION
  2565.             "This object counts failed registration attempts, i.e.,
  2566.              authentication failures and class of service failures,
  2567.              on this interface."
  2568.         ::= { docsIfCmtsStatusEntry 4 }
  2569.  
  2570. docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE
  2571.         SYNTAX      Counter32
  2572.         MAX-ACCESS  read-only
  2573.         STATUS      current
  2574.         DESCRIPTION
  2575.  
  2576.  
  2577.  
  2578. St. Johns                       Standard                       [Page 46]
  2579.  
  2580. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2581.  
  2582.  
  2583.             "This object counts invalid data request messages
  2584.              received on this interface."
  2585.         ::= { docsIfCmtsStatusEntry 5 }
  2586.  
  2587. docsIfCmtsStatusT5Timeouts OBJECT-TYPE
  2588.         SYNTAX      Counter32
  2589.         MAX-ACCESS  read-only
  2590.         STATUS      current
  2591.         DESCRIPTION
  2592.             "This object counts the number of times counter T5
  2593.              expired on this interface."
  2594.         ::= { docsIfCmtsStatusEntry 6 }
  2595.  
  2596. --
  2597. -- CM status table (within CMTS).
  2598. -- This table is implemented only at the CMTS.
  2599. -- It contains per CM status information available in the CMTS.
  2600. --
  2601.  
  2602. docsIfCmtsCmStatusTable OBJECT-TYPE
  2603.         SYNTAX      SEQUENCE OF DocsIfCmtsCmStatusEntry
  2604.         MAX-ACCESS  not-accessible
  2605.         STATUS      current
  2606.         DESCRIPTION
  2607.             "A set of objects in the CMTS, maintained for each
  2608.              Cable Modem connected to this CMTS."
  2609.         ::= { docsIfCmtsObjects 3 }
  2610.  
  2611. docsIfCmtsCmStatusEntry OBJECT-TYPE
  2612.         SYNTAX      DocsIfCmtsCmStatusEntry
  2613.         MAX-ACCESS  not-accessible
  2614.         STATUS      current
  2615.         DESCRIPTION
  2616.             "Status information for a single Cable Modem.
  2617.              An entry in this table exists for each Cable Modem
  2618.              that is connected to the CMTS implementing this table."
  2619.         INDEX { docsIfCmtsCmStatusIndex }
  2620.         ::= { docsIfCmtsCmStatusTable 1 }
  2621.  
  2622. DocsIfCmtsCmStatusEntry ::= SEQUENCE {
  2623.             docsIfCmtsCmStatusIndex               Integer32,
  2624.             docsIfCmtsCmStatusMacAddress          MacAddress,
  2625.             docsIfCmtsCmStatusIpAddress           IpAddress,
  2626.             docsIfCmtsCmStatusDownChannelIfIndex  InterfaceIndexOrZero,
  2627.             docsIfCmtsCmStatusUpChannelIfIndex    InterfaceIndexOrZero,
  2628.             docsIfCmtsCmStatusRxPower             TenthdBmV,
  2629.             docsIfCmtsCmStatusTimingOffset        Unsigned32,
  2630.             docsIfCmtsCmStatusEqualizationData    OCTET STRING,
  2631.  
  2632.  
  2633.  
  2634. St. Johns                       Standard                       [Page 47]
  2635.  
  2636. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2637.  
  2638.  
  2639.             docsIfCmtsCmStatusValue               INTEGER,
  2640.             docsIfCmtsCmStatusUnerroreds          Counter32,
  2641.             docsIfCmtsCmStatusCorrecteds          Counter32,
  2642.             docsIfCmtsCmStatusUncorrectables      Counter32,
  2643.             docsIfCmtsCmStatusSignalNoise         TenthdB,
  2644.             docsIfCmtsCmStatusMicroreflections    Integer32
  2645.         }
  2646.  
  2647. docsIfCmtsCmStatusIndex OBJECT-TYPE
  2648.         SYNTAX      Integer32 (1..2147483647)
  2649.         MAX-ACCESS  not-accessible
  2650.         STATUS      current
  2651.         DESCRIPTION
  2652.             "Index value to uniquely identify an entry in this table.
  2653.              For an individual Cable Modem, this index value should
  2654.              not change during CMTS uptime."
  2655.         ::= { docsIfCmtsCmStatusEntry 1 }
  2656.  
  2657. docsIfCmtsCmStatusMacAddress OBJECT-TYPE
  2658.         SYNTAX      MacAddress
  2659.         MAX-ACCESS  read-only
  2660.         STATUS      current
  2661.         DESCRIPTION
  2662.             "MAC address of this Cable Modem. If the Cable Modem has
  2663.              multiple MAC addresses, this is the MAC address associated
  2664.              with the Cable interface."
  2665.         ::= { docsIfCmtsCmStatusEntry 2 }
  2666.  
  2667. docsIfCmtsCmStatusIpAddress OBJECT-TYPE
  2668.         SYNTAX      IpAddress
  2669.         MAX-ACCESS  read-only
  2670.         STATUS      current
  2671.         DESCRIPTION
  2672.             "IP address of this Cable Modem. If the Cable Modem has no
  2673.              IP address assigned, or the IP address is unknown, this
  2674.              object returns a value of 0.0.0.0. If the Cable Modem has
  2675.              multiple IP addresses, this object returns the IP address
  2676.              associated with the Cable interface."
  2677.         ::= { docsIfCmtsCmStatusEntry 3 }
  2678.  
  2679. docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE
  2680.         SYNTAX      InterfaceIndexOrZero
  2681.         MAX-ACCESS  read-only
  2682.         STATUS      current
  2683.         DESCRIPTION
  2684.             "IfIndex of the downstream channel this CM is connected
  2685.              to. If the downstream channel is unknown, this object
  2686.              returns a value of zero."
  2687.  
  2688.  
  2689.  
  2690. St. Johns                       Standard                       [Page 48]
  2691.  
  2692. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2693.  
  2694.  
  2695.         ::= { docsIfCmtsCmStatusEntry 4 }
  2696.  
  2697. docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE
  2698.         SYNTAX      InterfaceIndexOrZero
  2699.         MAX-ACCESS  read-only
  2700.         STATUS      current
  2701.         DESCRIPTION
  2702.             "IfIndex of the upstream channel this CM is connected
  2703.              to. If the upstream channel is unknown, this object
  2704.              returns a value of zero."
  2705.         ::= { docsIfCmtsCmStatusEntry 5 }
  2706.  
  2707. docsIfCmtsCmStatusRxPower OBJECT-TYPE
  2708.         SYNTAX      TenthdBmV
  2709.         UNITS       "dBmV"
  2710.         MAX-ACCESS  read-only
  2711.         STATUS      current
  2712.         DESCRIPTION
  2713.             "The receive power as percieved for upstream data from
  2714.              this Cable Modem.
  2715.              If the receive power is unknown, this object returns
  2716.              a value of zero."
  2717.         REFERENCE
  2718.             "DOCSIS Radio Frequency Interface Specification,
  2719.              Table 4-13."
  2720.         ::= { docsIfCmtsCmStatusEntry 6 }
  2721.  
  2722. docsIfCmtsCmStatusTimingOffset OBJECT-TYPE
  2723.         SYNTAX      Unsigned32
  2724.         MAX-ACCESS  read-only
  2725.         STATUS      current
  2726.         DESCRIPTION
  2727.             "A measure of the current round trip time for this CM.
  2728.              Used for timing of CM upstream transmissions to ensure
  2729.              synchronized arrivals at the CMTS. Units are in terms
  2730.              of (6.25 microseconds/64). Returns zero if the value
  2731.              is unknown."
  2732.         REFERENCE
  2733.             "DOCSIS Radio Frequency Interface Specification,
  2734.              Section 6.5."
  2735.         ::= { docsIfCmtsCmStatusEntry 7 }
  2736.  
  2737. docsIfCmtsCmStatusEqualizationData OBJECT-TYPE
  2738.         SYNTAX      OCTET STRING
  2739.         MAX-ACCESS  read-only
  2740.         STATUS      current
  2741.         DESCRIPTION
  2742.             "Equalization data for this CM. Returns an empty string
  2743.  
  2744.  
  2745.  
  2746. St. Johns                       Standard                       [Page 49]
  2747.  
  2748. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2749.  
  2750.  
  2751.              if the value is unknown or if there is no equalization
  2752.              data available or defined."
  2753.         REFERENCE
  2754.             "DOCSIS Radio Frequency Interface Specification,
  2755.              Figure 6-23."
  2756.         ::= { docsIfCmtsCmStatusEntry 8 }
  2757.  
  2758. docsIfCmtsCmStatusValue OBJECT-TYPE
  2759.         SYNTAX      INTEGER {
  2760.             other(1),
  2761.             ranging(2),
  2762.             rangingAborted(3),
  2763.             rangingComplete(4),
  2764.             ipComplete(5),
  2765.             registrationComplete(6),
  2766.             accessDenied(7)
  2767.         }
  2768.         MAX-ACCESS  read-only
  2769.         STATUS      current
  2770.         DESCRIPTION
  2771.             "Current Cable Modem connectivity state, as specified
  2772.              in the RF Interface Specification. Returned status
  2773.              information is the CM status as assumed by the CMTS,
  2774.              and indicates the following events:
  2775.              other(1)
  2776.                 Any state other than below.
  2777.              ranging(2)
  2778.                 The CMTS has received an Initial Ranging Request
  2779.                 message from the CM, and the ranging process is not
  2780.                 yet complete.
  2781.              rangingAborted(3)
  2782.                 The CMTS has sent a Ranging Abort message to the CM.
  2783.              rangingComplete(4)
  2784.                 The CMTS has sent a Ranging Complete message to the CM.
  2785.              ipComplete(5)
  2786.                 The CMTS has received a DHCP reply message and forwarded
  2787.                 it to the CM.
  2788.              registrationComplete(6)
  2789.                 The CMTS has sent a Registration Response mesage to
  2790.                 the CM.
  2791.              accessDenied(7)
  2792.                 The CMTS has sent a Registration Aborted message
  2793.                 to the CM.
  2794.              The CMTS only needs to report states it is able to detect."
  2795.         REFERENCE
  2796.             "DOCSIS Radio Frequency Interface Specification,
  2797.              Chapter 7.2."
  2798.         ::= { docsIfCmtsCmStatusEntry 9 }
  2799.  
  2800.  
  2801.  
  2802. St. Johns                       Standard                       [Page 50]
  2803.  
  2804. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2805.  
  2806.  
  2807. docsIfCmtsCmStatusUnerroreds OBJECT-TYPE
  2808.         SYNTAX      Counter32
  2809.         MAX-ACCESS  read-only
  2810.         STATUS      current
  2811.         DESCRIPTION
  2812.             "Codewords received without error from this Cable Modem."
  2813.         REFERENCE
  2814.             "DOCSIS Radio Frequency Interface specification,
  2815.              Section 4.2.3"
  2816.         ::= { docsIfCmtsCmStatusEntry 10 }
  2817.  
  2818. docsIfCmtsCmStatusCorrecteds OBJECT-TYPE
  2819.         SYNTAX      Counter32
  2820.         MAX-ACCESS  read-only
  2821.         STATUS      current
  2822.         DESCRIPTION
  2823.             "Codewords received with correctable errors from this
  2824.              Cable Modem."
  2825.         REFERENCE
  2826.             "DOCSIS Radio Frequency Interface specification,
  2827.              Section 4.2.3"
  2828.         ::= { docsIfCmtsCmStatusEntry 11 }
  2829.  
  2830. docsIfCmtsCmStatusUncorrectables OBJECT-TYPE
  2831.         SYNTAX      Counter32
  2832.         MAX-ACCESS  read-only
  2833.         STATUS      current
  2834.         DESCRIPTION
  2835.             "Codewords received with uncorrectable errors from this
  2836.              Cable Modem."
  2837.         REFERENCE
  2838.             "DOCSIS Radio Frequency Interface specification,
  2839.              Section 4.2.3"
  2840.         ::= { docsIfCmtsCmStatusEntry 12 }
  2841.  
  2842. docsIfCmtsCmStatusSignalNoise OBJECT-TYPE
  2843.         SYNTAX      TenthdB
  2844.         UNITS       "dB"
  2845.         MAX-ACCESS  read-only
  2846.         STATUS      current
  2847.         DESCRIPTION
  2848.             "Signal/Noise ratio as perceived for upstream data from
  2849.              this Cable Modem.
  2850.              If the Signal/Noise is unknown, this object returns
  2851.              a value of zero."
  2852.         ::= { docsIfCmtsCmStatusEntry 13 }
  2853.  
  2854. docsIfCmtsCmStatusMicroreflections OBJECT-TYPE
  2855.  
  2856.  
  2857.  
  2858. St. Johns                       Standard                       [Page 51]
  2859.  
  2860. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2861.  
  2862.  
  2863.         SYNTAX      Integer32 (0..255)
  2864.         UNITS       "dBc"
  2865.         MAX-ACCESS  read-only
  2866.         STATUS      current
  2867.         DESCRIPTION
  2868.             "Total microreflections including in-channel response
  2869.              as perceived on this interface, measured in dBc below
  2870.              the signal level.
  2871.              This object is not assumed to return an absolutely
  2872.              accurate value, but should give a rough indication
  2873.              of microreflections received on this interface.
  2874.              It is up to the implementor to provide information
  2875.              as accurate as possible."
  2876.         REFERENCE
  2877.             "DOCSIS Radio Frequency Interface specification,
  2878.              Table 2-1 and 2-2"
  2879.         ::= { docsIfCmtsCmStatusEntry 14 }
  2880.  
  2881. --
  2882. -- The CMTS Service Table.
  2883. --
  2884.  
  2885. docsIfCmtsServiceTable OBJECT-TYPE
  2886.         SYNTAX      SEQUENCE OF DocsIfCmtsServiceEntry
  2887.         MAX-ACCESS  not-accessible
  2888.         STATUS      current
  2889.         DESCRIPTION
  2890.             "Describes the attributes of upstream service queues
  2891.              in a Cable Modem Termination System."
  2892.         ::= { docsIfCmtsObjects 4 }
  2893.  
  2894. docsIfCmtsServiceEntry OBJECT-TYPE
  2895.         SYNTAX      DocsIfCmtsServiceEntry
  2896.         MAX-ACCESS  not-accessible
  2897.         STATUS      current
  2898.         DESCRIPTION
  2899.             "Describes the attributes of a single upstream bandwidth
  2900.              service queue.
  2901.              Entries in this table exist for each ifEntry with an
  2902.              ifType of docsCableMaclayer(127), and for each service
  2903.              queue (Service ID) within this MAC layer.
  2904.              Entries in this table are created with the creation of
  2905.              individual Service IDs by the MAC layer and removed
  2906.              when a Service ID is removed."
  2907.         INDEX { ifIndex, docsIfCmtsServiceId }
  2908.         ::= { docsIfCmtsServiceTable 1 }
  2909.  
  2910. DocsIfCmtsServiceEntry ::= SEQUENCE {
  2911.  
  2912.  
  2913.  
  2914. St. Johns                       Standard                       [Page 52]
  2915.  
  2916. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2917.  
  2918.  
  2919.             docsIfCmtsServiceId               Integer32,
  2920.             docsIfCmtsServiceCmStatusIndex    Integer32,
  2921.             docsIfCmtsServiceAdminStatus      INTEGER,
  2922.             docsIfCmtsServiceQosProfile       Integer32,
  2923.             docsIfCmtsServiceCreateTime       TimeStamp,
  2924.             docsIfCmtsServiceInOctets         Counter32,
  2925.             docsIfCmtsServiceInPackets        Counter32
  2926.         }
  2927.  
  2928. docsIfCmtsServiceId OBJECT-TYPE
  2929.         SYNTAX      Integer32 (1..16383)
  2930.         MAX-ACCESS  not-accessible
  2931.         STATUS      current
  2932.         DESCRIPTION
  2933.             "Identifies a service queue for upstream bandwidth. The
  2934.              attributes of this service queue are shared between the
  2935.              Cable Modem and the Cable Modem Termination System.
  2936.              The CMTS allocates upstream bandwidth to this service
  2937.              queue based on requests from the CM and on the class of
  2938.              service associated with this queue."
  2939.         ::= { docsIfCmtsServiceEntry 1 }
  2940.  
  2941. docsIfCmtsServiceCmStatusIndex OBJECT-TYPE
  2942.         SYNTAX      Integer32 (0..65535)
  2943.         MAX-ACCESS  read-only
  2944.         STATUS      current
  2945.         DESCRIPTION
  2946.             "Pointer to an entry in docsIfCmtsCmStatusTable identifying
  2947.              the Cable Modem using this Service Queue. If multiple
  2948.              Cable Modems are using this Service Queue, the value of
  2949.              this object is zero."
  2950.         ::= { docsIfCmtsServiceEntry 2 }
  2951.  
  2952. docsIfCmtsServiceAdminStatus OBJECT-TYPE
  2953.         SYNTAX      INTEGER {
  2954.             enabled(1),
  2955.             disabled(2),
  2956.             destroyed(3) }
  2957.         MAX-ACCESS  read-write
  2958.         STATUS      current
  2959.         DESCRIPTION
  2960.             "Allows a service class for a particular modem to be
  2961.              suppressed, (re-)enabled, or deleted altogether."
  2962.         ::= { docsIfCmtsServiceEntry 3 }
  2963.  
  2964. docsIfCmtsServiceQosProfile OBJECT-TYPE
  2965.         SYNTAX      Integer32 (0..16383)
  2966.         MAX-ACCESS  read-only
  2967.  
  2968.  
  2969.  
  2970. St. Johns                       Standard                       [Page 53]
  2971.  
  2972. RFC 2670                DOCSIS RF Interface MIB              August 1999
  2973.  
  2974.  
  2975.         STATUS      current
  2976.         DESCRIPTION
  2977.             "The index in docsIfQosProfileTable describing the quality
  2978.              of service attributes associated with this particular
  2979.              service. If no associated docsIfQosProfileTable entry
  2980.              exists, this object returns a value of zero."
  2981.         ::= { docsIfCmtsServiceEntry 4 }
  2982.  
  2983. docsIfCmtsServiceCreateTime OBJECT-TYPE
  2984.  
  2985. --      SYNTAX      TimeTicks
  2986.         SYNTAX      TimeStamp
  2987.         MAX-ACCESS  read-only
  2988.         STATUS      current
  2989.         DESCRIPTION
  2990.             "The value of sysUpTime when this entry was created."
  2991.         ::= { docsIfCmtsServiceEntry 5 }
  2992.  
  2993. docsIfCmtsServiceInOctets OBJECT-TYPE
  2994.         SYNTAX      Counter32
  2995.         MAX-ACCESS  read-only
  2996.         STATUS      current
  2997.         DESCRIPTION
  2998.             "The cumulative number of Packet Data octets received
  2999.              on this Service ID. The count does not include the
  3000.              size of the Cable MAC header"
  3001.         ::= { docsIfCmtsServiceEntry 6 }
  3002.  
  3003. docsIfCmtsServiceInPackets OBJECT-TYPE
  3004.         SYNTAX      Counter32
  3005.         MAX-ACCESS  read-only
  3006.         STATUS      current
  3007.         DESCRIPTION
  3008.             "The cumulative number of Packet Data packets received
  3009.              on this Service ID."
  3010.         ::= { docsIfCmtsServiceEntry 7 }
  3011.  
  3012. --
  3013. -- The following table provides upstream channel modulation profiles.
  3014. -- Entries in this table can be
  3015. -- re-used by one or more upstream channels. An upstream channel will
  3016. -- have a modulation profile
  3017. -- for each value of docsIfModIntervalUsageCode.
  3018. --
  3019.  
  3020. docsIfCmtsModulationTable OBJECT-TYPE
  3021.         SYNTAX      SEQUENCE OF DocsIfCmtsModulationEntry
  3022.         MAX-ACCESS  not-accessible
  3023.  
  3024.  
  3025.  
  3026. St. Johns                       Standard                       [Page 54]
  3027.  
  3028. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3029.  
  3030.  
  3031.         STATUS      current
  3032.         DESCRIPTION
  3033.             "Describes a modulation profile associated with one or more
  3034.              upstream channels."
  3035.         ::= { docsIfCmtsObjects 5 }
  3036.  
  3037. docsIfCmtsModulationEntry OBJECT-TYPE
  3038.         SYNTAX      DocsIfCmtsModulationEntry
  3039.         MAX-ACCESS  not-accessible
  3040.         STATUS      current
  3041.         DESCRIPTION
  3042.             "Describes a modulation profile for an Interval Usage Code
  3043.              for one or more upstream channels.
  3044.              Entries in this table are created by the operator. Initial
  3045.              default entries may be created at system initialization
  3046.              time. No individual objects have to be specified in order
  3047.              to create an entry in this table.
  3048.              Note that some objects do not have DEFVALs, but do have
  3049.              calculated defaults and need not be specified during row
  3050.              creation.
  3051.              There is no restriction on the changing of values in this
  3052.              table while their associated rows are active."
  3053.         INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode }
  3054.         ::= { docsIfCmtsModulationTable 1 }
  3055.  
  3056. DocsIfCmtsModulationEntry ::= SEQUENCE {
  3057.             docsIfCmtsModIndex                    Integer32,
  3058.             docsIfCmtsModIntervalUsageCode        INTEGER,
  3059.             docsIfCmtsModControl                  RowStatus,
  3060.             docsIfCmtsModType                     INTEGER,
  3061.             docsIfCmtsModPreambleLen              Integer32,
  3062.             docsIfCmtsModDifferentialEncoding     TruthValue,
  3063.             docsIfCmtsModFECErrorCorrection       Integer32,
  3064.             docsIfCmtsModFECCodewordLength        Integer32,
  3065.             docsIfCmtsModScramblerSeed            Integer32,
  3066.             docsIfCmtsModMaxBurstSize             Integer32,
  3067.             docsIfCmtsModGuardTimeSize            Unsigned32,
  3068.             docsIfCmtsModLastCodewordShortened    TruthValue,
  3069.             docsIfCmtsModScrambler                TruthValue
  3070.         }
  3071.  
  3072. docsIfCmtsModIndex OBJECT-TYPE
  3073.         SYNTAX       Integer32 (1..2147483647)
  3074.         MAX-ACCESS   not-accessible
  3075.         STATUS      current
  3076.         DESCRIPTION
  3077.              "An index into the Channel Modulation table representing
  3078.               a group of Interval Usage Codes, all associated with the
  3079.  
  3080.  
  3081.  
  3082. St. Johns                       Standard                       [Page 55]
  3083.  
  3084. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3085.  
  3086.  
  3087.               same channel."
  3088.         ::= { docsIfCmtsModulationEntry 1 }
  3089.  
  3090. docsIfCmtsModIntervalUsageCode OBJECT-TYPE
  3091.         SYNTAX       INTEGER {
  3092.             request(1),
  3093.             requestData(2),
  3094.             initialRanging(3),
  3095.             periodicRanging(4),
  3096.             shortData(5),
  3097.             longData(6)
  3098.         }
  3099.         MAX-ACCESS  not-accessible
  3100.         STATUS      current
  3101.         DESCRIPTION
  3102.             "An index into the Channel Modulation table which, when
  3103.              grouped with other Interval Usage Codes, fully
  3104.              instantiate all modulation sets for a given upstream
  3105.              channel."
  3106.         REFERENCE
  3107.             "DOCSIS Radio Frequency Interface specification,
  3108.              Table 6-16."
  3109.         ::= { docsIfCmtsModulationEntry 2 }
  3110.  
  3111. docsIfCmtsModControl OBJECT-TYPE
  3112.         SYNTAX      RowStatus
  3113.         MAX-ACCESS  read-create
  3114.         STATUS      current
  3115.         DESCRIPTION
  3116.             "Controls and reflects the status of rows in this table."
  3117.         ::= { docsIfCmtsModulationEntry 3 }
  3118.  
  3119. docsIfCmtsModType OBJECT-TYPE
  3120.         SYNTAX      INTEGER {
  3121.             other(1),
  3122.             qpsk(2),
  3123.             qam16(3)
  3124.         }
  3125.         MAX-ACCESS  read-create
  3126.         STATUS      current
  3127.         DESCRIPTION
  3128.             "The modulation type used on this channel. Returns
  3129.              other(1) if the modulation type is neither qpsk or
  3130.              qam16. See the reference for the modulation profiles
  3131.              implied by qpsk or qam16.  See the conformance object for
  3132.              write conditions and limitations."
  3133.         REFERENCE
  3134.             "DOCSIS Radio Frequency Interface specification,
  3135.  
  3136.  
  3137.  
  3138. St. Johns                       Standard                       [Page 56]
  3139.  
  3140. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3141.  
  3142.  
  3143.              Section 4.2.2."
  3144.         DEFVAL { qpsk }
  3145.         ::= { docsIfCmtsModulationEntry 4 }
  3146.  
  3147. docsIfCmtsModPreambleLen OBJECT-TYPE
  3148.         SYNTAX      Integer32 (0..1024)
  3149.         MAX-ACCESS  read-create
  3150.         STATUS      current
  3151.         DESCRIPTION
  3152.             "The preamble length for this modulation profile in bits.
  3153.              Default value is the minimum needed by the implementation
  3154.              at the CMTS for the given modulation profile."
  3155.         REFERENCE
  3156.             "DOCSIS Radio Frequency Interface specification,
  3157.              Section 4.2.5."
  3158.         ::= { docsIfCmtsModulationEntry 5 }
  3159.  
  3160. docsIfCmtsModDifferentialEncoding OBJECT-TYPE
  3161.         SYNTAX      TruthValue
  3162.         MAX-ACCESS  read-create
  3163.         STATUS      current
  3164.         DESCRIPTION
  3165.             "Specifies whether or not differential encoding is used
  3166.              on this channel."
  3167.         DEFVAL { false }
  3168.         ::= { docsIfCmtsModulationEntry 6 }
  3169.  
  3170. docsIfCmtsModFECErrorCorrection OBJECT-TYPE
  3171.         SYNTAX      Integer32 (0..10)
  3172.         MAX-ACCESS  read-create
  3173.         STATUS      current
  3174.         DESCRIPTION
  3175.             "The number of correctable errored bytes (t) used in
  3176.              forward error correction code. The value of 0 indicates
  3177.              no correction is employed. The number of check bytes
  3178.              appended will be twice this value."
  3179.         REFERENCE
  3180.             "DOCSIS Radio Frequency Interface specification,
  3181.              Section 4.2.3."
  3182.         DEFVAL { 0 }
  3183.         ::= { docsIfCmtsModulationEntry 7 }
  3184.  
  3185. docsIfCmtsModFECCodewordLength OBJECT-TYPE
  3186.         SYNTAX      Integer32 (1..255)
  3187.         MAX-ACCESS  read-create
  3188.         STATUS      current
  3189.         DESCRIPTION
  3190.             "The number of data bytes (k) in the forward error
  3191.  
  3192.  
  3193.  
  3194. St. Johns                       Standard                       [Page 57]
  3195.  
  3196. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3197.  
  3198.  
  3199.              correction codeword.
  3200.              This object is not used if docsIfCmtsModFECErrorCorrection
  3201.              is zero."
  3202.         REFERENCE
  3203.             "DOCSIS Radio Frequency Interface specification,
  3204.              Section 4.2.3."
  3205.         DEFVAL { 32 }
  3206.         ::= { docsIfCmtsModulationEntry 8 }
  3207.  
  3208. docsIfCmtsModScramblerSeed OBJECT-TYPE
  3209.         SYNTAX      Integer32 (0..32767)
  3210.         MAX-ACCESS  read-create
  3211.         STATUS      current
  3212.         DESCRIPTION
  3213.             "The 15 bit seed value for the scrambler polynomial."
  3214.         REFERENCE
  3215.             "DOCSIS Radio Frequency Interface specification,
  3216.              Section 4.2.4."
  3217.         DEFVAL { 0 }
  3218.         ::= { docsIfCmtsModulationEntry 9 }
  3219.  
  3220. docsIfCmtsModMaxBurstSize OBJECT-TYPE
  3221.         SYNTAX      Integer32 (0..255)
  3222.         MAX-ACCESS  read-create
  3223.         STATUS      current
  3224.         DESCRIPTION
  3225.             "The maximum number of mini-slots that can be transmitted
  3226.              during this channel's burst time. Returns zero if the
  3227.              burst length is bounded by the allocation MAP rather than
  3228.              this profile.
  3229.              Default value is 0 except for shortData, where it is 8."
  3230.         ::= { docsIfCmtsModulationEntry 10 }
  3231.  
  3232. docsIfCmtsModGuardTimeSize OBJECT-TYPE
  3233.         SYNTAX      Unsigned32
  3234.         MAX-ACCESS  read-only
  3235.         STATUS      current
  3236.         DESCRIPTION
  3237.             "The number of symbol-times which must follow the end of
  3238.              this channel's burst. Default value is the minimum time
  3239.              needed by the implementation for this modulation profile."
  3240.         REFERENCE
  3241.             "DOCSIS Radio Frequency Interface specification,
  3242.              Section 4.2.7."
  3243.         ::= { docsIfCmtsModulationEntry 11 }
  3244.  
  3245. docsIfCmtsModLastCodewordShortened OBJECT-TYPE
  3246.         SYNTAX      TruthValue
  3247.  
  3248.  
  3249.  
  3250. St. Johns                       Standard                       [Page 58]
  3251.  
  3252. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3253.  
  3254.  
  3255.         MAX-ACCESS  read-create
  3256.         STATUS      current
  3257.         DESCRIPTION
  3258.             "Indicates if the last FEC codeword is truncated."
  3259.         REFERENCE
  3260.             "DOCSIS Radio Frequency Interface specification,
  3261.              Section 4.2.10."
  3262.         DEFVAL { true }
  3263.         ::= { docsIfCmtsModulationEntry 12 }
  3264.  
  3265. docsIfCmtsModScrambler OBJECT-TYPE
  3266.         SYNTAX      TruthValue
  3267.         MAX-ACCESS  read-create
  3268.         STATUS      current
  3269.         DESCRIPTION
  3270.             "Indicates if the scrambler is employed."
  3271.         REFERENCE
  3272.             "DOCSIS Radio Frequency Interface specification,
  3273.              Section 4.2.4."
  3274.         DEFVAL { false }
  3275.         ::= { docsIfCmtsModulationEntry 13 }
  3276.  
  3277. docsIfCmtsQosProfilePermissions OBJECT-TYPE
  3278.         SYNTAX      BITS {
  3279.             createByManagement(0),
  3280.             updateByManagement(1),
  3281.             createByModems(2)
  3282.         }
  3283.         MAX-ACCESS  read-write
  3284.         STATUS      current
  3285.         DESCRIPTION
  3286.             "This object specifies permitted methods of creating
  3287.              entries in docsIfQosProfileTable.
  3288.              CreateByManagement(0) is set if entries can be created
  3289.              using SNMP. UpdateByManagement(1) is set if updating
  3290.              entries using SNMP is permitted. CreateByModems(2)
  3291.              is set if entries can be created based on information
  3292.              in REG-REQ MAC messages received from Cable Modems.
  3293.              Information in this object is only applicable if
  3294.              docsIfQosProfileTable is implemented as read-create.
  3295.              Otherwise, this object is implemented as read-only
  3296.              and returns CreateByModems(2).
  3297.              Either CreateByManagement(0) or CreateByModems(1)
  3298.              must be set when writing to this object."
  3299.         ::= { docsIfCmtsObjects 6 }
  3300.  
  3301. docsIfCmtsMacToCmTable OBJECT-TYPE
  3302.         SYNTAX      SEQUENCE OF DocsIfCmtsMacToCmEntry
  3303.  
  3304.  
  3305.  
  3306. St. Johns                       Standard                       [Page 59]
  3307.  
  3308. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3309.  
  3310.  
  3311.         MAX-ACCESS  not-accessible
  3312.         STATUS      current
  3313.         DESCRIPTION
  3314.             "This is a table to provide a quick access index into the
  3315.              docsIfCmtsCmStatusTable. There is exactly one row in this
  3316.              table for each row in the docsIfCmtsCmStatusTable. In
  3317.              general, the management station should use this table only
  3318.              to get a pointer into the docsIfCmtsCmStatusTable (which
  3319.              corresponds to the CM's RF interface MAC address), and
  3320.              should not iterate (e.g. GetNext through) this table."
  3321.     ::= { docsIfCmtsObjects 7 }
  3322.  
  3323. docsIfCmtsMacToCmEntry OBJECT-TYPE
  3324.         SYNTAX      DocsIfCmtsMacToCmEntry
  3325.         MAX-ACCESS  not-accessible
  3326.         STATUS      current
  3327.         DESCRIPTION
  3328.             "A row in the docsIfCmtsMacToCmTable.
  3329.              An entry in this table exists for each Cable Modem
  3330.              that is connected to the CMTS implementing this table."
  3331.         INDEX   { docsIfCmtsCmMac }
  3332.         ::= {docsIfCmtsMacToCmTable 1 }
  3333.  
  3334. DocsIfCmtsMacToCmEntry ::= SEQUENCE {
  3335.                 docsIfCmtsCmMac     MacAddress,
  3336.                 docsIfCmtsCmPtr     Integer32
  3337.         }
  3338.  
  3339. docsIfCmtsCmMac OBJECT-TYPE
  3340.         SYNTAX      MacAddress
  3341.         MAX-ACCESS  not-accessible
  3342.         STATUS      current
  3343.         DESCRIPTION
  3344.             "The RF side MAC address for the referenced CM. (E.g. the
  3345.              interface on the CM that has docsCableMacLayer(127) as
  3346.              its ifType."
  3347.     ::= { docsIfCmtsMacToCmEntry 1 }
  3348.  
  3349. docsIfCmtsCmPtr OBJECT-TYPE
  3350.         SYNTAX      Integer32 (1..2147483647)
  3351.         MAX-ACCESS  read-only
  3352.         STATUS      current
  3353.         DESCRIPTION
  3354.             "An row index into docsIfCmtsCmStatusTable. When queried
  3355.              with the correct instance value (e.g. a CM's MAC address),
  3356.              returns the index in docsIfCmtsCmStatusTable which
  3357.              represents that CM."
  3358.     ::= { docsIfCmtsMacToCmEntry 2 }
  3359.  
  3360.  
  3361.  
  3362. St. Johns                       Standard                       [Page 60]
  3363.  
  3364. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3365.  
  3366.  
  3367. --
  3368. -- notification group is for future extension.
  3369. --
  3370. docsIfNotification OBJECT IDENTIFIER     ::= { docsIfMib 2 }
  3371.  
  3372. docsIfConformance  OBJECT IDENTIFIER     ::= { docsIfMib 3 }
  3373. docsIfCompliances  OBJECT IDENTIFIER     ::= { docsIfConformance 1 }
  3374. docsIfGroups       OBJECT IDENTIFIER     ::= { docsIfConformance 2 }
  3375.  
  3376. -- compliance statements
  3377.  
  3378. docsIfBasicCompliance MODULE-COMPLIANCE
  3379.         STATUS      current
  3380.         DESCRIPTION
  3381.             "The compliance statement for devices that implement
  3382.              MCNS/DOCSIS compliant Radio Frequency Interfaces."
  3383.  
  3384. MODULE  -- docsIfMib
  3385.  
  3386. -- unconditionally mandatory groups
  3387. MANDATORY-GROUPS {
  3388.         docsIfBasicGroup
  3389.         }
  3390.  
  3391. -- conditionally mandatory group
  3392. GROUP docsIfCmGroup
  3393.         DESCRIPTION
  3394.             "This group is implemented only in Cable Modems, not in
  3395.              Cable Modem Termination Systems."
  3396.  
  3397. -- conditionally mandatory group
  3398. GROUP docsIfCmtsGroup
  3399.         DESCRIPTION
  3400.             "This group is implemented only in Cable Modem Termination
  3401.              Systems, not in Cable Modems."
  3402.  
  3403. OBJECT  docsIfDownChannelFrequency
  3404.     WRITE-SYNTAX Integer32 (54000000..860000000)
  3405.         MIN-ACCESS  read-only
  3406.         DESCRIPTION
  3407.             "Read-write in Cable Modem Termination Systems;
  3408.              read-only in Cable Modems.  The values above are
  3409.              appropriate for a cable plant using a  Sub-Split channel
  3410.              plan.  If DOCSIS is extended to cover other types of
  3411.              channel plans (and frequency allocations) this object
  3412.              will be modified accordingly."
  3413.  
  3414. OBJECT  docsIfDownChannelWidth
  3415.  
  3416.  
  3417.  
  3418. St. Johns                       Standard                       [Page 61]
  3419.  
  3420. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3421.  
  3422.  
  3423.         WRITE-SYNTAX Integer32 (6000000)
  3424.         MIN-ACCESS  read-only
  3425.         DESCRIPTION
  3426.             "It is conformant to implement this object as read-only.
  3427.              In Cable Modems, this object is always implemented as
  3428.              read-only.  The above value is appropriate for cable
  3429.              plants running under  NTSC (National Television
  3430.              Standards Committee) standards.  If DOCSIS is extended to
  3431.              work with other standard (e.g. European standards), this
  3432.              object will be modified accordingly."
  3433.  
  3434. OBJECT  docsIfDownChannelModulation
  3435.         WRITE-SYNTAX INTEGER {
  3436.                                qam64 (3),
  3437.                                qam256 (4)
  3438.                              }
  3439.         MIN-ACCESS  read-only
  3440.         DESCRIPTION
  3441.             "Read-write in Cable Modem Termination Systems;
  3442.              read-only in Cable Modems."
  3443.  
  3444. OBJECT  docsIfDownChannelInterleave
  3445.         WRITE-SYNTAX INTEGER {
  3446.                     taps8Increment16(3),
  3447.                     taps16Increment8(4),
  3448.                     taps32Increment4(5),
  3449.                     taps64Increment2(6),
  3450.                     taps128Increment1(7)
  3451.                      }
  3452.         MIN-ACCESS  read-only
  3453.         DESCRIPTION
  3454.             "Read-write in Cable Modem Termination Systems;
  3455.              read-only in Cable Modems."
  3456.  
  3457. OBJECT  docsIfDownChannelPower
  3458.         MIN-ACCESS  read-only
  3459.         DESCRIPTION
  3460.             "Read-write in Cable Modem Termination Systems;
  3461.              read-only in Cable Modems."
  3462.  
  3463. OBJECT  docsIfUpChannelFrequency
  3464.    WRITE-SYNTAX Integer32 (5000000..42000000)
  3465.         MIN-ACCESS  read-only
  3466.         DESCRIPTION
  3467.             "Read-write in Cable Modem Termination Systems;
  3468.              read-only in Cable Modems.The values above are
  3469.              appropriate for a cable plant using a  Sub-Split channel
  3470.              plan.  If DOCSIS is extended to cover other types of
  3471.  
  3472.  
  3473.  
  3474. St. Johns                       Standard                       [Page 62]
  3475.  
  3476. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3477.  
  3478.  
  3479.              channel plans (and frequency allocations) this object
  3480.              will be modified accordingly."
  3481.  
  3482. OBJECT  docsIfUpChannelWidth
  3483.         WRITE-SYNTAX Integer32 (200000..3200000)
  3484.         MIN-ACCESS  read-only
  3485.         DESCRIPTION
  3486.             "Read-write in Cable Modem Termination Systems;
  3487.              read-only in Cable Modems.The above value is appropriate
  3488.              for cable plants running under  NTSC (National Television
  3489.              Standards Committee) standards.  If DOCSIS is extended to
  3490.              work with other standard (e.g. European standards), this
  3491.              object will be modified accordingly."
  3492.  
  3493. OBJECT  docsIfUpChannelModulationProfile
  3494.         MIN-ACCESS  read-only
  3495.         DESCRIPTION
  3496.             "Read-write in Cable Modem Termination Systems;
  3497.              read-only in Cable Modems."
  3498.  
  3499. OBJECT  docsIfUpChannelSlotSize
  3500.         MIN-ACCESS  read-only
  3501.         DESCRIPTION
  3502.             "This object is always read-only in Cable Modems.
  3503.              It is compliant to implement this object as read-only
  3504.              in Cable Modem Termination Systems."
  3505.  
  3506. OBJECT  docsIfUpChannelRangingBackoffStart
  3507.         MIN-ACCESS  read-only
  3508.         DESCRIPTION
  3509.             "Read-write in Cable Modem Termination Systems;
  3510.              read-only in Cable Modems."
  3511.  
  3512. OBJECT  docsIfUpChannelRangingBackoffEnd
  3513.         MIN-ACCESS  read-only
  3514.         DESCRIPTION
  3515.             "Read-write in Cable Modem Termination Systems;
  3516.              read-only in Cable Modems."
  3517.  
  3518. OBJECT  docsIfUpChannelTxBackoffStart
  3519.         MIN-ACCESS  read-only
  3520.         DESCRIPTION
  3521.             "Read-write in Cable Modem Termination Systems;
  3522.              read-only in Cable Modems."
  3523.  
  3524. OBJECT  docsIfUpChannelTxBackoffEnd
  3525.         MIN-ACCESS  read-only
  3526.         DESCRIPTION
  3527.  
  3528.  
  3529.  
  3530. St. Johns                       Standard                       [Page 63]
  3531.  
  3532. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3533.  
  3534.  
  3535.             "Read-write in Cable Modem Termination Systems;
  3536.              read-only in Cable Modems."
  3537.  
  3538. OBJECT  docsIfQosProfPriority
  3539.         MIN-ACCESS  read-only
  3540.         DESCRIPTION
  3541.             "This object is always read-only in Cable Modems.
  3542.              It is compliant to implement this object as read-only
  3543.              in Cable Modem Termination Systems."
  3544.  
  3545. OBJECT  docsIfQosProfMaxUpBandwidth
  3546.         MIN-ACCESS  read-only
  3547.         DESCRIPTION
  3548.             "This object is always read-only in Cable Modems.
  3549.              It is compliant to implement this object as read-only
  3550.              in Cable Modem Termination Systems."
  3551.  
  3552. OBJECT  docsIfQosProfGuarUpBandwidth
  3553.         MIN-ACCESS  read-only
  3554.         DESCRIPTION
  3555.             "This object is always read-only in Cable Modems.
  3556.              It is compliant to implement this object as read-only
  3557.              in Cable Modem Termination Systems."
  3558.  
  3559. OBJECT  docsIfQosProfMaxDownBandwidth
  3560.         MIN-ACCESS  read-only
  3561.         DESCRIPTION
  3562.             "This object is always read-only in Cable Modems.
  3563.              It is compliant to implement this object as read-only
  3564.              in Cable Modem Termination Systems."
  3565.  
  3566. OBJECT  docsIfQosProfMaxTxBurst
  3567.         MIN-ACCESS  read-only
  3568.         DESCRIPTION
  3569.             "This object is always read-only in Cable Modems.
  3570.              It is compliant to implement this object as read-only
  3571.              in Cable Modem Termination Systems."
  3572.  
  3573. OBJECT  docsIfQosProfBaselinePrivacy
  3574.         MIN-ACCESS  read-only
  3575.         DESCRIPTION
  3576.             "This object is always read-only in Cable Modems.
  3577.              It is compliant to implement this object as read-only
  3578.              in Cable Modem Termination Systems."
  3579.  
  3580. OBJECT  docsIfQosProfStatus
  3581.         MIN-ACCESS  read-only
  3582.         DESCRIPTION
  3583.  
  3584.  
  3585.  
  3586. St. Johns                       Standard                       [Page 64]
  3587.  
  3588. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3589.  
  3590.  
  3591.             "This object is always read-only in Cable Modems.
  3592.              It is compliant to implement this object as read-only
  3593.              in Cable Modem Termination Systems."
  3594.  
  3595. OBJECT  docsIfCmtsServiceAdminStatus
  3596.         MIN-ACCESS  read-only
  3597.         DESCRIPTION
  3598.             "It is compliant to implement this object as read-only."
  3599.  
  3600. OBJECT  docsIfCmtsSyncInterval
  3601.         MIN-ACCESS  read-only
  3602.         DESCRIPTION
  3603.             "It is compliant to implement this object as read-only."
  3604.  
  3605. OBJECT  docsIfCmtsUcdInterval
  3606.         MIN-ACCESS  read-only
  3607.         DESCRIPTION
  3608.             "It is compliant to implement this object as read-only."
  3609.  
  3610. OBJECT  docsIfCmtsInsertInterval
  3611.         MIN-ACCESS  read-only
  3612.         DESCRIPTION
  3613.             "It is compliant to implement this object as read-only."
  3614.  
  3615. OBJECT  docsIfCmtsInvitedRangingAttempts
  3616.         MIN-ACCESS  read-only
  3617.         DESCRIPTION
  3618.             "It is compliant to implement this object as read-only."
  3619.  
  3620. OBJECT  docsIfCmtsQosProfilePermissions
  3621.         MIN-ACCESS  read-only
  3622.         DESCRIPTION
  3623.             "It is compliant to implement this object as read-only."
  3624.  
  3625. OBJECT docsIfCmtsModType
  3626.         WRITE-SYNTAX INTEGER {
  3627.                         qpsk (2),
  3628.                         qam16 (3)
  3629.                          }
  3630.         DESCRIPTION
  3631.             "Management station may only set 16QAM or QPSK modulation,
  3632.              but others might be possible based on device configuration."
  3633.  
  3634.  
  3635.         ::= { docsIfCompliances 1 }
  3636.  
  3637. docsIfBasicGroup OBJECT-GROUP
  3638.         OBJECTS {
  3639.  
  3640.  
  3641.  
  3642. St. Johns                       Standard                       [Page 65]
  3643.  
  3644. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3645.  
  3646.  
  3647.             docsIfDownChannelId,
  3648.             docsIfDownChannelFrequency,
  3649.             docsIfDownChannelWidth,
  3650.             docsIfDownChannelModulation,
  3651.             docsIfDownChannelInterleave,
  3652.             docsIfDownChannelPower,
  3653.             docsIfUpChannelId,
  3654.             docsIfUpChannelFrequency,
  3655.             docsIfUpChannelWidth,
  3656.             docsIfUpChannelModulationProfile,
  3657.             docsIfUpChannelSlotSize,
  3658.             docsIfUpChannelTxTimingOffset,
  3659.             docsIfUpChannelRangingBackoffStart,
  3660.             docsIfUpChannelRangingBackoffEnd,
  3661.             docsIfUpChannelTxBackoffStart,
  3662.             docsIfUpChannelTxBackoffEnd,
  3663.             docsIfQosProfPriority,
  3664.             docsIfQosProfMaxUpBandwidth,
  3665.             docsIfQosProfGuarUpBandwidth,
  3666.             docsIfQosProfMaxDownBandwidth,
  3667.             docsIfQosProfMaxTxBurst,
  3668.             docsIfQosProfBaselinePrivacy,
  3669.             docsIfQosProfStatus,
  3670.             docsIfSigQIncludesContention,
  3671.             docsIfSigQUnerroreds,
  3672.             docsIfSigQCorrecteds,
  3673.             docsIfSigQUncorrectables,
  3674.             docsIfSigQSignalNoise,
  3675.             docsIfSigQMicroreflections,
  3676.             docsIfSigQEqualizationData
  3677.         }
  3678.         STATUS      current
  3679.         DESCRIPTION
  3680.             "Group of objects implemented in both Cable Modems and
  3681.              Cable Modem Termination Systems."
  3682.         ::= { docsIfGroups 1 }
  3683.  
  3684. -- The following  table was modified to correct naming conventions for
  3685. -- Counter32 variables.
  3686. docsIfCmGroup OBJECT-GROUP
  3687.         OBJECTS {
  3688.             docsIfCmCmtsAddress,
  3689.             docsIfCmCapabilities,
  3690. --            docsIfCmRangingRespTimeout,
  3691.             docsIfCmRangingTimeout,
  3692.             docsIfCmStatusValue,
  3693.             docsIfCmStatusCode,
  3694.             docsIfCmStatusTxPower,
  3695.  
  3696.  
  3697.  
  3698. St. Johns                       Standard                       [Page 66]
  3699.  
  3700. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3701.  
  3702.  
  3703.             docsIfCmStatusResets,
  3704.             docsIfCmStatusLostSyncs,
  3705.             docsIfCmStatusInvalidMaps,
  3706.             docsIfCmStatusInvalidUcds,
  3707. --            docsIfCmStatusInvalidRangingResp,
  3708.             docsIfCmStatusInvalidRangingResponses,
  3709. --            docsIfCmStatusInvalidRegistrationResp,
  3710.             docsIfCmStatusInvalidRegistrationResponses,
  3711.             docsIfCmStatusT1Timeouts,
  3712.             docsIfCmStatusT2Timeouts,
  3713.             docsIfCmStatusT3Timeouts,
  3714.             docsIfCmStatusT4Timeouts,
  3715.             docsIfCmStatusRangingAborteds,
  3716.             docsIfCmServiceQosProfile,
  3717.             docsIfCmServiceTxSlotsImmed,
  3718.             docsIfCmServiceTxSlotsDed,
  3719.             docsIfCmServiceTxRetries,
  3720. --            docsIfCmServiceTxExceeded,
  3721.             docsIfCmServiceTxExceededs,
  3722.             docsIfCmServiceRqRetries,
  3723. --            docsIfCmServiceRqExceeded
  3724.             docsIfCmServiceRqExceededs
  3725.         }
  3726.         STATUS      current
  3727.         DESCRIPTION
  3728.             "Group of objects implemented in Cable Modems."
  3729.         ::= { docsIfGroups 2 }
  3730.  
  3731. docsIfCmtsGroup OBJECT-GROUP
  3732.         OBJECTS {
  3733.             docsIfCmtsCapabilities,
  3734.             docsIfCmtsSyncInterval,
  3735.             docsIfCmtsUcdInterval,
  3736.             docsIfCmtsMaxServiceIds,
  3737. --            docsIfCmtsInsertionInterval,
  3738.             docsIfCmtsInvitedRangingAttempts,
  3739.             docsIfCmtsInsertInterval,
  3740.             docsIfCmtsStatusInvalidRangeReqs,
  3741.             docsIfCmtsStatusRangingAborteds,
  3742.             docsIfCmtsStatusInvalidRegReqs,
  3743.             docsIfCmtsStatusFailedRegReqs,
  3744.             docsIfCmtsStatusInvalidDataReqs,
  3745.             docsIfCmtsStatusT5Timeouts,
  3746.             docsIfCmtsCmStatusMacAddress,
  3747.             docsIfCmtsCmStatusIpAddress,
  3748.             docsIfCmtsCmStatusDownChannelIfIndex,
  3749.             docsIfCmtsCmStatusUpChannelIfIndex,
  3750.             docsIfCmtsCmStatusRxPower,
  3751.  
  3752.  
  3753.  
  3754. St. Johns                       Standard                       [Page 67]
  3755.  
  3756. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3757.  
  3758.  
  3759.             docsIfCmtsCmStatusTimingOffset,
  3760.             docsIfCmtsCmStatusEqualizationData,
  3761.             docsIfCmtsCmStatusValue,
  3762.             docsIfCmtsCmStatusUnerroreds,
  3763.             docsIfCmtsCmStatusCorrecteds,
  3764.             docsIfCmtsCmStatusUncorrectables,
  3765.             docsIfCmtsCmStatusSignalNoise,
  3766.             docsIfCmtsCmStatusMicroreflections,
  3767.             docsIfCmtsServiceCmStatusIndex,
  3768.             docsIfCmtsServiceAdminStatus,
  3769.             docsIfCmtsServiceQosProfile,
  3770.             docsIfCmtsServiceCreateTime,
  3771.             docsIfCmtsServiceInOctets,
  3772.             docsIfCmtsServiceInPackets,
  3773.             docsIfCmtsModType,
  3774.             docsIfCmtsModControl,
  3775.             docsIfCmtsModPreambleLen,
  3776.             docsIfCmtsModDifferentialEncoding,
  3777.             docsIfCmtsModFECErrorCorrection,
  3778.             docsIfCmtsModFECCodewordLength,
  3779.             docsIfCmtsModScramblerSeed,
  3780.             docsIfCmtsModMaxBurstSize,
  3781.             docsIfCmtsModGuardTimeSize,
  3782.             docsIfCmtsModLastCodewordShortened,
  3783.             docsIfCmtsModScrambler,
  3784.             docsIfCmtsQosProfilePermissions,
  3785.             docsIfCmtsCmPtr
  3786.         }
  3787.         STATUS      current
  3788.         DESCRIPTION
  3789.             "Group of objects implemented in Cable Modem Termination
  3790.              Systems."
  3791.         ::= { docsIfGroups 3 }
  3792.  
  3793.  
  3794. docsIfObsoleteGroup OBJECT-GROUP
  3795.      OBJECTS {
  3796.             docsIfCmRangingRespTimeout,
  3797.             docsIfCmtsInsertionInterval
  3798.         }
  3799.         STATUS      obsolete
  3800.         DESCRIPTION
  3801.             "Group of objects obsoleted."
  3802.         ::= { docsIfGroups 4 }
  3803.  
  3804. END
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810. St. Johns                       Standard                       [Page 68]
  3811.  
  3812. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3813.  
  3814.  
  3815. 5.  Acknowledgments
  3816.  
  3817.    This document was produced by the IPCDN Working Group.  It is based
  3818.    on a document written by Pam Anderson from CableLabs, Wilson Sawyer
  3819.    from BayNetworks, and Rich Woundy from Continental Cablevision.  The
  3820.    original working group editor, Guenter Roeck of cisco Systems, did
  3821.    much of the grunt work of putting the document into its current form.
  3822.  
  3823.    Special thanks is also due to Azlina Palmer, who helped a lot
  3824.    reviewing the document.
  3825.  
  3826. 6.  References
  3827.  
  3828.    [1]  Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for
  3829.         Describing SNMP Management Frameworks", RFC 2571, April 1999.
  3830.  
  3831.    [2]  Rose, M. and K. McCloghrie, "Structure and Identification of
  3832.         Management Information for TCP/IP-based Internets", STD 16, RFC
  3833.         1155, May 1990.
  3834.  
  3835.    [3]  Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16,
  3836.         RFC 1212, March 1991.
  3837.  
  3838.    [4]  Rose, M., "A Convention for Defining Traps for use with the
  3839.         SNMP", RFC 1215, March 1991.
  3840.  
  3841.    [5]  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Structure of
  3842.         Management Information for Version 2 (SMIv2)", STD 58, RFC 2578,
  3843.         April 1999.
  3844.  
  3845.    [6]  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Textual
  3846.         Conventions for SMIv2", STD 58, RFC 2579, April 1999.
  3847.  
  3848.    [7]  McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Conformance
  3849.         Statements for SMIv2", STD 58, RFC 2580, April 1999.
  3850.  
  3851.    [8]  Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple
  3852.         Management Protocol", STD 15, RFC 1157, May 1990.
  3853.  
  3854.    [9]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  3855.         "Introduction to Community-based SNMPv2", RFC 1901, January
  3856.         1996.
  3857.  
  3858.    [10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Transport
  3859.         Mappings for Version 2 of the Simple Network Management Protocol
  3860.         (SNMPv2)", RFC 1906, January 1996.
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866. St. Johns                       Standard                       [Page 69]
  3867.  
  3868. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3869.  
  3870.  
  3871.    [11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message
  3872.         Processing and Dispatching for the Simple Network Management
  3873.         Protocol (SNMP)", RFC 2572, April 1999.
  3874.  
  3875.    [12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM)
  3876.         for version 3 of the Simple Network Management Protocol
  3877.         (SNMPv3)", RFC 2574, April 1999.
  3878.  
  3879.    [13] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Protocol
  3880.         Operations for Version 2 of the Simple Network Management
  3881.         Protocol (SNMPv2)", RFC 1905, January 1996.
  3882.  
  3883.    [14] Levi, D., Meyer, P. and B. Stewart, "SNMP Applications", RFC
  3884.         2573, April 1999.
  3885.  
  3886.    [15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access
  3887.         Control Model (VACM) for the Simple Network Management Protocol
  3888.         (SNMP)", RFC 2575, April 1999.
  3889.  
  3890.    [16] "Data-Over-Cable Service Interface Specifications: Cable Modem
  3891.         Radio Frequency Interface Specification SP-RFI-I04-980724",
  3892.         DOCSIS, July 1998,
  3893.         http://www.cablemodem.com/public/pubtechspec/SP-RFI-I04-
  3894.         980724.pdf.
  3895.  
  3896.    [17] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB
  3897.         using SMIv2", RFC 2233, November 1997.
  3898.  
  3899.    [18] StJohns, M. , "Cable Device Management Information Base for
  3900.         DOCSIS Compliant Cable Modems and Cable Modem Termination
  3901.         Systems", RFC2669, August 1999.
  3902.  
  3903.    [19] Proakis, John G., "Digital Communications, 3rd Edition",
  3904.         McGraw-Hill, New York, New York, 1995, ISBN 0-07-051726-6
  3905.  
  3906.    [20] "Transmission Systems for Interactive Cable Television Services,
  3907.         Annex B", J.112, International Telecommunications Union, March
  3908.         1998.
  3909.  
  3910. 7.  Security Considerations
  3911.  
  3912.    This MIB relates to a system which will provide metropolitan public
  3913.    internet access.  As such, improper manipulation of the objects
  3914.    represented by this MIB may result in denial of service to a large
  3915.    number of end-users.  In addition, manipulation of the
  3916.    docsIfCmServiceQosProfile, docsIfCmtsServerQosProfile, and the
  3917.    elements of docsIfQosProfileTable may allow an end-user to improve
  3918.    their service response or decrease other subscriber service response.
  3919.  
  3920.  
  3921.  
  3922. St. Johns                       Standard                       [Page 70]
  3923.  
  3924. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3925.  
  3926.  
  3927.    This MIB does not affect confidentiality, authentication or
  3928.    authorization of services on a cable modem system.  For
  3929.    authentication and authorization, please see the related document
  3930.    "Cable Device Management Information Base for DOCSIS compliant Cable
  3931.    Modems and Cable Modem Termination Systems" [18].  For
  3932.    confidentiality, the working group expects to issue a MIB which
  3933.    describes the management of the DOCSIS Baseline Privacy mechanism.
  3934.  
  3935. 8.  Intellectual Property
  3936.  
  3937.    The IETF takes no position regarding the validity or scope of any
  3938.    intellectual property or other rights that might be claimed to
  3939.    pertain to the implementation or use of the technology described in
  3940.    this document or the extent to which any license under such rights
  3941.    might or might not be available; neither does it represent that it
  3942.    has made any effort to identify any such rights.  Information on the
  3943.    IETF's procedures with respect to rights in standards-track and
  3944.    standards-related documentation can be found in BCP-11.  Copies of
  3945.    claims of rights made available for publication and any assurances of
  3946.    licenses to be made available, or the result of an attempt made to
  3947.    obtain a general license or permission for the use of such
  3948.    proprietary rights by implementors or users of this specification can
  3949.    be obtained from the IETF Secretariat.
  3950.  
  3951.    The IETF invites any interested party to bring to its attention any
  3952.    copyrights, patents or patent applications, or other proprietary
  3953.    rights which may cover technology that may be required to practice
  3954.    this standard.  Please address the information to the IETF Executive
  3955.    Director.
  3956.  
  3957. 9.  Author's Address
  3958.  
  3959.    Michael StJohns
  3960.    @Home Network
  3961.    425 Broadway
  3962.    Redwood City, CA 94063
  3963.  
  3964.    Phone: +1 650 569 5368
  3965.    EMail: stjohns@corp.home.net
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978. St. Johns                       Standard                       [Page 71]
  3979.  
  3980. RFC 2670                DOCSIS RF Interface MIB              August 1999
  3981.  
  3982.  
  3983. 10.  Full Copyright Statement
  3984.  
  3985.    Copyright (C) The Internet Society (1999).  All Rights Reserved.
  3986.  
  3987.    This document and translations of it may be copied and furnished to
  3988.    others, and derivative works that comment on or otherwise explain it
  3989.    or assist in its implementation may be prepared, copied, published
  3990.    and distributed, in whole or in part, without restriction of any
  3991.    kind, provided that the above copyright notice and this paragraph are
  3992.    included on all such copies and derivative works.  However, this
  3993.    document itself may not be modified in any way, such as by removing
  3994.    the copyright notice or references to the Internet Society or other
  3995.    Internet organizations, except as needed for the purpose of
  3996.    developing Internet standards in which case the procedures for
  3997.    copyrights defined in the Internet Standards process must be
  3998.    followed, or as required to translate it into languages other than
  3999.    English.
  4000.  
  4001.    The limited permissions granted above are perpetual and will not be
  4002.    revoked by the Internet Society or its successors or assigns.
  4003.  
  4004.    This document and the information contained herein is provided on an
  4005.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  4006.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  4007.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  4008.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  4009.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  4010.  
  4011. Acknowledgement
  4012.  
  4013.    Funding for the RFC Editor function is currently provided by the
  4014.    Internet Society.
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034. St. Johns                       Standard                       [Page 72]
  4035.  
  4036.