IPCDN Working Group D. Raftus Internet Draft Terayon Canada Ltd. Document: draft-ietf-ipcdn-docs-rfmibv2-11 E. Cardona (Editor) CableLabs July 2004 Expires:January 2005 Obsoletes: RFC 2670 Radio Frequency (RF) Interface Management Information Base for DOCSIS 2.0 compliant RF interfaces Status of this Memo By submitting this Internet-Draft, I certify that any applicable patent or other IPR claims of which I am aware have been disclosed, and any of which I become aware will be disclosed, in accordance with RFC 3668. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Copyright Notice Copyright (C) The Internet Society (2004). All Rights Reserved. Abstract This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it defines a set of managed objects for SNMP-based management of the Radio Frequency (RF) interfaces for systems compliant with the Data Over Cable Service Interface Specifications (DOCSIS). This document revises RFC 2670. Please see section 10 for a Raftus/Cardona [Page 1] Internet Draft DOCSIS RF Interface MIB July 2004 description of the changes from RFC 2670. This memo is a product of the IPCDN working group within the Internet Engineering Task Force. Comments are solicited and should be addressed to the working group's mailing list at ipcdn@ietf.org and/or the authors. Conventions used in this document The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14, RFC 2119 [RFC2119]. Table of Contents 1 The Internet-Standard Management Framework .................... 2 2 Glossary ...................................................... 3 3 Overview ...................................................... 6 3.1 Structure of the MIB ........................................ 6 3.1.1 docsIfBaseObjects ......................................... 6 3.1.2 docsIfCmObjects ........................................... 6 3.1.3 docsIfCmtsObjects ......................................... 7 3.2 Relationship to the Interfaces MIB .......................... 7 3.2.1 Layering Model ............................................ 8 3.2.2 Virtual Circuits .......................................... 9 3.2.3 ifTestTable ............................................... 9 3.2.4 ifRcvAddressTable ......................................... 9 3.2.5 ifEntry ................................................... 9 4 Definitions .................................................. 20 5 Acknowledgments ............................................. 122 6 Revision History ............................................ 123 7 Normative References ........................................ 123 8 Informative References ...................................... 124 9 Security Considerations ..................................... 125 10 Changes from RFC 2670 ...................................... 127 11 Management Interoperability of DOCSIS 1.0, 1.1 and 2.0...... 128 12 Intellectual Property .......................................129 13 Author's Address ........................................... 129 14 Disclaimer of Validity ......................................130 15 Copyright Notice.............................................130 1. The Internet-Standard Management Framework For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 Raftus/Cardona Expires January 2005 [Page 2] Internet Draft DOCSIS RF Interface MIB July 2004 of RFC 3410 [RFC3410]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies a MIB module that is compliant to the SMIv2, which is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580]. 2. Glossary The terms in this document are derived either from normal cable system usage, or from the documents associated with the Data Over Cable Service Interface Specification process. 2.1. Baseline Privacy Security interface specification designed for DOCSIS compliant cable data systems that ensures device authentication data confidentiality in the CATV plant. See [BPI] and [BPIPLUS]. 2.2. CATV Originally "Community Antenna Television", now used to refer to any cable or hybrid fiber and cable system used to deliver video signals to a community. 2.3. Channel A specific frequency allocation with an RF medium, specified by channel width in Hertz (cycles per second) and by center frequency. Within the US Cable Systems, upstream channels are generally allocated from the 5-42MHz range while down stream channels are generally allocated from the 50-750MHz range depending on the capabilities of the given system. The typical broadcast channel width in the US is 6MHz. Upstream channel widths for DOCSIS vary. For European cable systems, upstream channels vary by country. The upper edge of upstream channel allocations vary between 25 MHz to 65 MHz, and the lower edge of downstream channel allocations vary between 47 MHz and 87.5 MHz. The typical broadcast channel width in Europe is 8MHz. The actual parameters are of concern to systems deploying Euro-DOCSIS technology. 2.4. CM Cable Modem. Raftus/Cardona Expires January 2005 [Page 3] Internet Draft DOCSIS RF Interface MIB July 2004 A CM acts as a "slave" station in a DOCSIS compliant cable data system. 2.5. CMTS Cable Modem Termination System. A generic term covering a cable bridge or cable router in a head-end. A CMTS acts as the master station in a DOCSIS compliant cable data system. It is the only station that transmits downstream, and it controls the scheduling of upstream transmissions by its associated CMs. 2.6. Codeword A characteristic of the Forward Error Correction scheme used above the RF media layer. See "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407" 2.7. Data Packet The payload portion of the MAC Packet. 2.8. dBmV A measure of RF signal voltage amplitude, whose power level is determined by the characteristic impedance. A zero dB signal power is equivalent to 48.75 dBmV signal amplitude in a 75 Ohm system. 2.9. DOCSIS "Data Over Cable Service Interface Specification". A term referring to the ITU-T J112 Annex B standard for cable modem systems [ITU-T J112]. 2.9.1. DOCSIS 1.0 Cable modem systems CM/CMTS compliant to requirements in [RFI1.0]. A common reference to DOCSIS 1.0 in this document is the upstream channel queuing mechanism known as Class of Service (COS). 2.9.2 DOCSIS 1.1 Cable modem systems CM/CMTS compliant to requirements in [ITU-T J112]. DOCSIS 1.1 references in this document are in part associated with the upstream and downstream Quality of Service (QOS). The term DOCSIS 1.x is used in this document to refer both DOCSIS 1.0 and DOCSIS 1.1. 2.9.3. DOCSIS 2.0 Raftus/Cardona Expires January 2005 [Page 4] Internet Draft DOCSIS RF Interface MIB July 2004 Cable modem systems CM/CMTS compliant to requirements in [ITU-T-J122]. 2.10. Downstream The direction from the head-end towards the subscriber. 2.11. Euro-DOCSIS Cable modem systems CM/CMTS conforming to the European spectrum Lineup and compliant to requirements of Annex F in [ITU-T-J122] 2.12. Head-end The origination point in most cable systems of the subscriber video signals. 2.13. MAC Packet A DOCSIS PDU. 2.14. MCNS "Multimedia Cable Network System". Generally replaced in usage by DOCSIS. 2.15. Mini-slot In general, an interval of time which is allocated by the CMTS to a given CM for that CM to transmit in an upstream direction. See [ITU-T-J122] 2.16. QPSK Quadrature Phase Shift Keying. A particular modulation scheme on an RF medium. See [Proakis00]. 2.17. QAM Quadrature Amplitude Modulation. A particular modulation scheme on RF medium. Usually expressed with a number indicating the size of the modulation constellation (e.g. 16 QAM). See [Proakis00]. 2.18. RF Radio Frequency. 2.19. Symbol-times A characteristic of the RF modulation scheme. Raftus/Cardona Expires January 2005 [Page 5] Internet Draft DOCSIS RF Interface MIB July 2004 See [ITU-T-J122]. 2.20. Upstream The direction from the subscriber towards the head-end. 3. Overview This MIB module provides a set of objects required for the management of MCNS/DOCSIS compliant Cable Modem (CM) and Cable Modem Termination System (CMTS) RF interfaces. The specification is derived in part from the parameters and protocols described in [ITU-T-J122]. 3.1. Structure of the MIB This MIB module is structured as three groups: o Management information pertinent to both Cable Modems (CM) and Cable Modem Termination Systems (CMTS) (docsIfBaseObjects). o Management information pertinent to Cable Modems only (docsIfCmObjects). o Management information pertinent to Cable Modem Termination Systems only (docsIfCmtsObjects). Tables within each of these groups group objects functionally - e.g. Quality of Service, Channel characteristics, MAC layer management, etc. Rows created automatically (e.g. by the device according to the hardware configuration) may and generally will have a mixture of configuration and status objects within them. Rows that are meant to be created by the management station are generally restricted to configuration (read-create) objects. 3.1.1. docsIfBaseObjects docsIfDownstreamChannelTable - This table describes the existing downstream channels for a CMTS and the received downstream channel for a CM. docsIfUpstreamChannelTable - This table describes the existing upstream channels for a CMTS and the current upstream transmission channel for a CM. docsIfQosProfileTable - This table describes the valid Quality of Service profiles for the cable data system. docsIfSignalQualityTable - This table is used to monitor RF signal quality characteristics of received signals. Raftus/Cardona Expires January 2005 [Page 6] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfDocsisBaseCapability - This object is used to indicate the highest level of DOCSIS version a cable device can support. 3.1.2. docsIfCmObjects docsIfCmMacTable - This table is used to monitor the DOCSIS MAC interface and can be considered an extension to the ifEntry. docsIfCmStatusTable - This table maintains a number of status objects and counters for cable modems. There is a comparable table at the CMTS, docsIfCmtsCmStatusTable, which maintains similar counters from the CMTS point of view. docsIfCmServiceTable - This table describes the upstream service queues available at this CM. There is a comparable table at the CMTS, docsIfCmtsServiceEntry, which describes the service queues from the point of view of the CMTS. 3.1.3. docsIfCmtsObjects docsIfCmtsMacTable - Describes the attributes of each CMTS MAC interface. docsIfCmtsStatusTable - This table provides a set of aggregated counters which roll-up values and events that occur on the underlying sub-interfaces. docsIfCmtsCmStatusTable - This table is used to hold information about known (i.e. ranging, registered, and/or previously online) cable modems on the system serviced by this CMTS. docsIfCmtsServiceTable - This table provides access to the information related to upstream service queues. docsIfCmtsModulationTable - This table allows control over the modulation profiles for RF channels associated with this CMTS. docsIfCmtsMacToCmTable - This table allows fast access into the docsIfCmtsCmTable via a MAC address (of the CM) interface. docsIfCmtsChannelUtilizationTable - This table provides statistical load usage data for attached upstream and downstream physical channels. docsIfCmtsDownChannelCounterTable - This table provides statistical data for attached downstream channels, appropriate as input for load usage calculations. docsIfCmtsUpChannelCounterTable - This table provides statistical Raftus/Cardona Expires January 2005 [Page 7] Internet Draft DOCSIS RF Interface MIB July 2004 data for attached upstream channels, appropriate as input for load usage calculations. 3.2. Relationship to the Interfaces MIB module This section clarifies the relationship of this MIB module to the Interfaces MIB [RFC2863]. Several areas of correlation are Addressed in the following subsections. The implementer is referred to the Interfaces MIB document in order to understand the general intent of these areas. 3.2.1. Layering Model An instance of ifEntry exists for each RF Downstream interface, for each RF Upstream interface, for each Upstream logical Channel and for each RF MAC layer. The ifStackTable [RFC2863] MUST be implemented to identify the relationships among sub-interfaces. The following example illustrates a CMTS MAC interface with one downstream and two upstream interfaces. | <== to network layer +------------------ --+-------------------------------+ | RF MAC | +--+------------------+------------------------+------+ | | | +-------+-----+ +------+------+ +------+------+ | Downstream1 | | Upstream1 | | Upstream2 | | | | | | | +-------------+ ++-----------++ ++-----------++ | | | | +----+----+ +----+----+ +----+----+ +----+----+ | Ch-1 | | Ch-2 | | Ch-1 | | Ch-2 | |(A/TDMA) | |(S-CDMA) | |(A/TDMA) | |(S-CDMA) | +---------+ +---------+ +---------+ +---------+ As can be seen from this example, the RF MAC interface is layered on top of the downstream and upstream interfaces, and the RF Upstream interface is layered on top of an Upstream Logical Channels. In this example, the assignment of index values could be as follows: ifIndex ifType Description 2 docsCableMaclayer(127) CATV MAC Layer 3 docsCableDownstream(128) CATV Downstream interface 4 docsCableUpstream(129) CATV Upstream interface 5 docsCableUpstream(129) CATV Upstream interface 6 docsCableUpstreamChannel(205) CATV Upstream Channel Raftus/Cardona Expires January 2005 [Page 8] Internet Draft DOCSIS RF Interface MIB July 2004 7 docsCableUpstreamChannel(205) CATV Upstream Channel 8 docsCableUpstreamChannel(205) CATV Upstream Channel 9 docsCableUpstreamChannel(205) CATV Upstream Channel The corresponding ifStack entries would then be: | IfStackHigherLayer | ifStackLowerLayer | | 0 | 2 | | 2 | 3 | | 2 | 4 | | 2 | 5 | | 4 | 6 | | 4 | 7 | | 5 | 8 | | 5 | 9 | | 3 | 0 | | 6 | 0 | | 7 | 0 | | 8 | 0 | | 9 | 0 | The same interface model can also be used in Telephony or Telco Return systems. A pure Telco Return system (Cable Modem as well as Cable Modem Termination System) would not have upstream, but only downstream cable channels. Systems supporting both Telco Return and cable upstream channels can use the above model without modification. Telco Return Upstream channel(s) management is outside the scope of this document. 3.2.2. Virtual Circuits This medium does not support virtual circuits and this area is not applicable to this MIB module. 3.2.3. ifTestTable The ifTestTable is optional for DOCSIS CM/CMTS implementations, but is not specifically influenced by the RF MIB. 3.2.4. ifRcvAddressTable The ifRcvAddressTable is optional for DOCSIS CM/CMTS implementations, but is not specifically influenced by the RF MIB. 3.2.5. ifEntry This section documents only the differences from the requirements specified in the Interfaces MIB module. See that MIB module for Raftus/Cardona Expires January 2005 [Page 9] Internet Draft DOCSIS RF Interface MIB July 2004 columns omitted from the descriptions below. 3.2.5.1. ifEntry for Downstream interfaces The ifEntry for Downstream interfaces supports the ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB module. This is an output only interface at the CMTS and all input status counters - ifIn* - will return zero. This is an input only interface at the CM and all output status counters - ifOut* - will return zero. 3.2.5.1.1. ifEntry for Downstream interfaces in Cable Modem Termination Systems ifTable Comments ============== =========================================== ifIndex Each RF Cable Downstream interface is represented by an ifEntry. ifType The IANA value of docsCableDownstream(128) See [IANA]. ifSpeed Return the speed of this downstream channel. The returned value is the raw bandwidth in bits/s of this interface. This is the symbol rate multiplied with the number of bits per symbol. ifHighSpeed Return the speed of this downstream channel. The returned value is the raw bandwidth in megabits/s of this interface. This is the symbol rate multiplied with the number of bits per symbol. ifPhysAddress Return an empty string. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of this interface. ifMtu The size of the largest frame which can be sent on this interface, specified in octets. The value includes the length of the MAC header. ifInOctets Return zero. ifHCInOctets ifInUcastPkts Return zero. ifHCInUcastPkts ifInMulticastPkts Return zero. Raftus/Cardona Expires January 2005 [Page 10] Internet Draft DOCSIS RF Interface MIB July 2004 ifHCInMulticastPkts ifInBroadcastPkts Return zero. ifHCInBroadcastPkts ifInDiscards Return zero. ifInErrors Return zero. ifInUnknownProtos Return zero. ifOutOctets The total number of octets transmitted on this ifHCOutOctets interface. This includes MAC packets as well as data packets, and includes the length of the MAC header. ifOutUcastPkts The number of Unicast packets transmitted on this ifHCOutUcastPkts interface. This includes MAC packets as well as data packets. ifOutMulticastPkts ifHCOutMulticastPkts Return the number of Multicast packets transmitted on this interface. This includes MAC packets as well as data packets. ifOutBroadcastPkts ifHCOutBroadcastPkts Return the number of broadcast packets transmitted on this interface. This includes MAC packets as well as data packets. ifOutDiscards The total number of outbound packets which were discarded. Possible reasons are: buffer shortage. ifOutErrors The number of packets which could not be transmitted due to errors. ifPromiscuousMode Return false. 3.2.5.1.2. ifEntry for Downstream interfaces in Cable Modems ifTable Comments ============== =========================================== ifIndex Each RF Cable Downstream interface is represented by an ifEntry. ifType The IANA value of docsCableDownstream(128). See [IANA]. Raftus/Cardona Expires January 2005 [Page 11] Internet Draft DOCSIS RF Interface MIB July 2004 ifSpeed Return the speed of this downstream channel. The returned value the raw bandwidth in bits/s of this interface. This is the symbol rate multiplied with the number of bits per symbol. ifHighSpeed Return the speed of this downstream channel. The returned value the raw bandwidth in megabits/s of this interface. This is the symbol rate multiplied with the number of bits per symbol. ifPhysAddress Return an empty string. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of this interface. ifMtu The size of the largest frame which can be received from this interface, specified in octets. The value includes the length of the MAC header. ifInOctets The total number of octets received on this ifHCInOctets interface. This includes data packets as well as MAC packets, and includes the length of the MAC header. ifInUcastPkts The number of Unicast packets received on this ifHCInUcastPkts interface. This includes data packets as well as MAC packets. ifInMulticastPkts ifHCInMulticastPkts Return the number of Multicast packets received on this interface. This includes data packets as well as MAC packets. ifInBroadcastPkts ifHCInBroadcastPkts Return the number of Broadcast packets received on this interface. This includes data packets as well as MAC packets. ifInDiscards The total number of received packets that have been discarded. The possible reasons are: buffer shortage. ifInErrors The number of inbound packets that contained errors preventing them from being deliverable to higher layers. Possible reasons are: MAC FCS error. Raftus/Cardona Expires January 2005 [Page 12] Internet Draft DOCSIS RF Interface MIB July 2004 ifInUnknownProtos The number of frames with an unknown packet type. These are MAC frames with an unknown packet type. ifOutOctets Return zero. ifHCOutOctets ifOutUcastPkts Return zero. ifHCOutUcastPkts ifOutMulticastPkts ifHCOutMulticastPkts Return zero. ifOutBroadcastPkts ifHCOutBroadcastPkts Return zero. ifOutDiscards Return zero. ifOutErrors Return zero. ifPromiscuousMode Refer to the Interfaces MIB. 3.2.5.2. ifEntry for Upstream interfaces Each supported interface of the type docsCableUpstream(129) must have a corresponding ifEntry. The ifEntry for Upstream interfaces supports the ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. This is an input only interface at the CMTS and all output status counters - ifOut* - will return zero. This is an output only interface at the CM and all input status counters - ifIn* - will return zero. 3.2.5.2.1. ifEntry for Upstream interfaces in Cable Modem Termination Systems ifTable Comments ============== =========================================== ifIndex Each RF Cable Upstream interface is represented by an ifEntry. ifType The IANA value of docsCableUpstream (129). See [IANA]. ifSpeed Return the maximum channel throughput (not payload throughput) supported by the interface. The maximum throughput is calculated for the case where upstream channels are configured to maximize Raftus/Cardona Expires January 2005 [Page 13] Internet Draft DOCSIS RF Interface MIB July 2004 interface throughput. ifHighSpeed Return the maximum channel throughput (not payload throughput) supported by the interface. The maximum throughput is calculated for the case where upstream channels are configured to maximize interface throughput. Units for this object are (1/1 000 000) * IfSpeed. ifPhysAddress Return an empty string. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of this interface. This reflects the total status of all the channels under this interface. So if at least one channel has a physical connection this interface has connection. ifMtu The size of the largest frame which can be transmitted on this interface, specified in octets. The value includes the length of the MAC header. This is the maximum of all the ifMtu of all the channels under this interface. ifInOctets ifHCInOctets The total (sum) number of octets received on all the Upstream channels under this interface. This includes data packets as well as MAC packets, and includes the length of the MAC header. ifInUcastPkts ifHCInUcastPkts The total number of Unicast packets received on all the upstream channels under this interface. This includes data packets as well as MAC packets. ifInMulticastPkts ifHCInMulticastPkts Return the total number of Multicast packets received on all the Upstream channels under this interface. This includes data packets as well as MAC layer packets. ifInBroadcastPkts ifHCInBroadcastPkts Return the total number of Broadcast packets received on all the Upstream channels under this interface. This includes data packets as well as Raftus/Cardona Expires January 2005 [Page 14] Internet Draft DOCSIS RF Interface MIB July 2004 MAC packets. ifInDiscards The total number of received packets, which have been discarded on all the Upstream channels under this interface. The possible reasons are: buffer shortage. ifInErrors The total number of inbound packets that contained errors preventing them from being deliverable to higher layers. Possible reasons are: MAC FCS error. ifInUnknownProtos The total number of frames with an unknown packet type. These are MAC frames with an unknown packet type. ifOutOctets Return zero. ifHCOutOctets ifOutUcastPkts Return zero. ifHCOutOctets ifOutMulticastPkts ifHCOutMulticastPkts Return zero. ifOutBroadcastPkts ifHCOutBroadcastPkts Return zero. ifOutDiscards Return zero. ifOutErrors Return zero. 3.2.5.2.2. ifEntry for Upstream interfaces in Cable Modems ifTable Comments ============== =========================================== ifIndex Each RF Cable Upstream interface is represented by an ifEntry. ifType The IANA value of docsCableUpstream (129). See [IANA]. ifSpeed Return the speed of this upstream interface. The returned value is the raw bandwidth in bits/s of this interface. ifHighSpeed Return the speed of this upstream interface. The returned value is the raw bandwidth Raftus/Cardona Expires January 2005 [Page 15] Internet Draft DOCSIS RF Interface MIB July 2004 in megabits/s of this interface. ifPhysAddress Return an empty string. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of this interface. ifMtu The size of the largest frame which can be transmitted on this interface, specified in octets. The value includes the length of the MAC header. ifInOctets Return zero. ifHCInOctets ifInUcastPkts Return zero. ifHCInUcastPkts ifInMulticastPkts Return zero. ifHCInMulticastPkts ifInBroadcastPkts Return zero. ifHCInBroadcastPkts ifInDiscards Return zero. ifInErrors Return zero. ifInUnknownProtos Return zero. ifOutOctets The total number of octets transmitted on this ifHCOutOctets interface. This includes MAC packets as well as data packets, and includes the length of the MAC header. ifOutUcastPkts The number of Unicast packets transmitted on this ifHCOutUcastPkts interface. This includes MAC packets as well as data packets. ifOutMulticastPkts ifHCOutMulticastPkts Return the number of Multicast packets transmitted on this interface. This includes MAC packets as well as data packets. ifOutBroadcastPkts ifHCOutBroadcastPkts Return the number of broadcast packets transmitted on this interface. Raftus/Cardona Expires January 2005 [Page 16] Internet Draft DOCSIS RF Interface MIB July 2004 This includes MAC packets as well as data packets. ifOutDiscards The total number of outbound packets which were discarded. Possible reasons are: buffer shortage. ifOutErrors The number of packets which could not be transmitted due to errors. ifPromiscuousMode Return false. 3.2.5.3. ifEntry for Upstream channels Each supported channel of the type docsCableUpstreamChannel(205) must have a corresponding ifEntry. The ifEntry for Upstream channels supports the ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. This is an input only interface at the CMTS and all output status counters - ifOut* - will return zero. DOCSIS CMs are not required to support logical upstream channels. 3.2.5.3.1. ifEntry for Upstream Channels in Cable Modem Termination Systems ifTable Comments ============== =========================================== ifIndex Each RF Cable Upstream channel is represented by an ifEntry. ifType The IANA value of docsCableUpstreamChannel (205). See [IANA]. ifSpeed Return the speed of this upstream channel. The returned value is the raw bandwidth in bits/s of this channel. ifHighSpeed Return the speed of this upstream channel. The returned value is the raw bandwidth in megabits/s of this channel. ifPhysAddress Return an empty string. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of this interface. ifMtu The size of the largest frame which can be received on this interface, specified in octets. The value includes the length of the MAC header. Raftus/Cardona Expires January 2005 [Page 17] Internet Draft DOCSIS RF Interface MIB July 2004 ifInOctets The total number of octets received on this interface. This includes data packets as well as MAC packets, and includes the length of the MAC header. ifInUcastPkts The number of Unicast packets received on this ifHCInUcastPkts interface. This includes data packets as well as MAC packets. ifInMulticastPkts ifHCInMulticastPkts Return the number of Multicast packets received on this interface. This includes data packets as well as MAC layer packets. ifInBroadcastPkts ifHCInBroadcastPkts Return the number of Broadcast packets received on this interface. This includes data packets as well as MAC packets. ifInDiscards The total number of received packets that have been discarded. The possible reasons are: buffer shortage. ifInErrors The number of inbound packets that contained errors preventing them from being deliverable to higher layers. Possible reasons are: MAC FCS error. ifInUnknownProtos The number of frames with an unknown packet type. These are MAC frames with an unknown packet type. ifOutOctets Return zero. ifHCOutOctets ifOutUcastPkts Return zero. ifHCOutUcastPkts ifOutMulticastPkts ifHCOutMulticastPkts Return zero. ifOutBroadcastPkts ifHCOutBroadcastPkts Return zero. ifOutDiscards Return zero. Raftus/Cardona Expires January 2005 [Page 18] Internet Draft DOCSIS RF Interface MIB July 2004 ifOutErrors Return zero. 3.2.5.4. ifEntry for the MAC Layer The ifEntry for the MAC Layer supports the ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB. This interface provides an aggregate view of status for the lower level Downstream and Upstream interfaces. ifTable Comments ============== =========================================== ifIndex Each RF Cable MAC layer entity is represented by an ifEntry. ifType The IANA value of docsCableMaclayer(127). See [IANA]. ifSpeed Return zero. ifPhysAddress Return the physical address of this interface. ifAdminStatus The administrative status of this interface. ifOperStatus The current operational status of the MAC layer interface. ifHighSpeed Return zero. ifMtu Return 1500. ifInOctets The total number of data octets received on this ifHCInOctets interface, targeted for upper protocol layers. ifInUcastPkts The number of Unicast packets received on this ifHCInUcastPkts interface, targeted for upper protocol layers. ifInMulticastPkts ifHCInMulticastPkts Return the number of Multicast packets received on this interface, targeted for upper protocol layers. ifInBroadcastPkts ifHCInBroadcastPkts Return the number of Broadcast packets received on this interface, targeted for upper protocol layers. ifInDiscards The total number of received packets that have been discarded. Raftus/Cardona Expires January 2005 [Page 19] Internet Draft DOCSIS RF Interface MIB July 2004 The possible reasons are: buffer shortage. ifInErrors The number of inbound packets that contained errors preventing them from being deliverable to higher layers. Possible reasons are: data packet FCS error, invalid MAC header. ifInUnknownProtos The number of frames with an unknown packet type. This is the number of data packets targeted for upper protocol layers with an unknown packet type. ifOutOctets The total number of octets, received from upper ifHCOutOctets protocol layers and transmitted on this interface. ifOutUcastPkts The number of Unicast packets, received from upper ifHCOutUcastPkts protocol layers and transmitted on this interface. ifOutMulticastPkts ifHCOutMulticastPkts Return the number of Multicast packets received from upper protocol layers and transmitted on this interface. ifOutBroadcastPkts ifHCOutBroadcastPkts Return the number of broadcast packets received from upper protocol layers and transmitted on this interface. ifOutDiscards The total number of outbound packets which were discarded. Possible reasons are: buffer shortage. ifOutErrors The number of packets which could not be transmitted due to errors. ifPromiscuousMode Refer to the Interfaces MIB. 4. Definitions DOCS-IF-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, Integer32, Counter32, Raftus/Cardona Expires January 2005 [Page 20] Internet Draft DOCSIS RF Interface MIB July 2004 Counter64, TimeTicks, IpAddress, transmission FROM SNMPv2-SMI -- [RFC2578] TEXTUAL-CONVENTION, MacAddress, RowStatus, TruthValue, TimeInterval, TimeStamp, StorageType FROM SNMPv2-TC -- [RFC2579] OBJECT-GROUP, MODULE-COMPLIANCE FROM SNMPv2-CONF -- [RFC2580] ifIndex, InterfaceIndexOrZero FROM IF-MIB -- [RFC2863] InetAddressType, InetAddress FROM INET-ADDRESS-MIB -- [RFC3291] IANAifType FROM IANAifType-MIB; -- [IANA] docsIfMib MODULE-IDENTITY LAST-UPDATED "200407190000Z" -- July 19, 2004 ORGANIZATION "IETF IPCDN Working Group" CONTACT-INFO " David Raftus Postal: Terayon Communications 340 Terry Fox Drive, Suite 202 Ottawa Ontario Canada Phone: +1 613 592 1052 ext.222 E-mail: david.raftus@terayon.com Eduardo Cardona Postal: Cable Television Laboratories, Inc. 858 Coal Creek Circle Louisville, CO 80027-9750 U.S.A. Tel: +1 303 661 9100 Fax: +1 303 661 9199 E-mail: e.cardona@cablelabs.com;mibs@cablelabs.com IETF IPCDN Working Group General Discussion: ipcdn@ietf.org Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn Raftus/Cardona Expires January 2005 [Page 21] Internet Draft DOCSIS RF Interface MIB July 2004 Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn Co-chairs: Richard Woundy, Richard_Woundy@cable.comcast.com Jean-Francois Mule, jf.mule@cablelabs.com" DESCRIPTION "This is the MIB Module for DOCSIS 2.0 compliant Radio Frequency (RF) interfaces in Cable Modems (CM) and Cable Modem Termination Systems (CMTS). Copyright (C) The Internet Society (2004). This version of this MIB module is part of RFC XXXX; see the RFC itself for full legal notices." REVISION "200407190000Z" DESCRIPTION "Revision of the IETF RF MIB module for DOCSIS 2.0. This version published as RFC XXXX." -- Note to RFC editor: -- RFC editor to replace XXXX with this RFC number -- Delete this note REVISION "199908190000Z" DESCRIPTION "Initial Version, published as RFC 2670. Modified by Mike StJohns to fix problems identified by the first pass of the MIB doctor. Of special note, docsIfRangingResp and docsIfCmtsInsertionInterval were obsoleted and replaced by other objects with the same functionality, but more appropriate SYNTAX." ::= { transmission 127 } -- Textual Conventions TenthdBmV ::= TEXTUAL-CONVENTION DISPLAY-HINT "d-1" STATUS current DESCRIPTION "This data type represents power levels that are normally expressed in dBmV. Units are in tenths of a dBmV; for example, 5.1 dBmV will be represented as 51." SYNTAX Integer32 TenthdB ::= TEXTUAL-CONVENTION DISPLAY-HINT "d-1" STATUS current DESCRIPTION "This data type represents power levels that are normally expressed in dB. Units are in tenths of a dB; for example, 5.1 dB will be represented as 51." SYNTAX Integer32 Raftus/Cardona Expires January 2005 [Page 22] Internet Draft DOCSIS RF Interface MIB July 2004 DocsisVersion ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Indicates the DOCSIS version number." SYNTAX INTEGER { docsis10 (1), docsis11 (2), docsis20 (3) } DocsisQosVersion ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Indicates the quality of service level." SYNTAX INTEGER { docsis10 (1), docsis11 (2) } DocsisUpstreamType ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Indicates the DOCSIS Upstream Channel Type." SYNTAX INTEGER { unknown (0), tdma (1), atdma (2), scdma (3), tdmaAndAtdma (4) } DocsisUpstreamTypeStatus ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Indicates the DOCSIS Upstream Channel Type Status. The shared channel indicator type is not valid, since this type is used to specifically identify PHY mode." SYNTAX INTEGER { unknown (0), tdma (1), atdma (2), scdma (3) } docsIfMibObjects OBJECT IDENTIFIER ::= { docsIfMib 1 } docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 } docsIfCmObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 2 } docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 } Raftus/Cardona Expires January 2005 [Page 23] Internet Draft DOCSIS RF Interface MIB July 2004 -- -- BASE GROUP -- -- -- The following table is implemented on both the Cable Modem (CM) -- and the Cable Modem Termination System (CMTS). This table is -- read only for the CM. -- docsIfDownstreamChannelTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfDownstreamChannelEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes the attributes of downstream channels (frequency bands)." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-16, and 6-17." ::= { docsIfBaseObjects 1 } docsIfDownstreamChannelEntry OBJECT-TYPE SYNTAX DocsIfDownstreamChannelEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry provides a list of attributes for a single Downstream channel. An entry in this table exists for each ifEntry with an ifType of docsCableDownstream(128)." INDEX { ifIndex } ::= { docsIfDownstreamChannelTable 1 } DocsIfDownstreamChannelEntry ::= SEQUENCE { docsIfDownChannelId Integer32, docsIfDownChannelFrequency Integer32, docsIfDownChannelWidth Integer32, docsIfDownChannelModulation INTEGER, docsIfDownChannelInterleave INTEGER, docsIfDownChannelPower TenthdBmV, docsIfDownChannelAnnex INTEGER, docsIfDownChannelStorageType StorageType } docsIfDownChannelId OBJECT-TYPE SYNTAX Integer32 (0..255) Raftus/Cardona Expires January 2005 [Page 24] Internet Draft DOCSIS RF Interface MIB July 2004 MAX-ACCESS read-only STATUS current DESCRIPTION "The Cable Modem Termination System (CMTS) identification of the downstream channel within this particular MAC interface. If the interface is down, the object returns the most current value. If the downstream channel ID is unknown, this object returns a value of 0." ::= { docsIfDownstreamChannelEntry 1 } docsIfDownChannelFrequency OBJECT-TYPE SYNTAX Integer32 (0..1000000000) UNITS "hertz" MAX-ACCESS read-write STATUS current DESCRIPTION "The center of the downstream frequency associated with this channel. This object will return the current tuner frequency. If a CMTS provides IF output, this object will return 0, unless this CMTS is in control of the final downstream RF frequency. See the associated compliance object for a description of valid frequencies that may be written to this object." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.3.3." ::= { docsIfDownstreamChannelEntry 2 } docsIfDownChannelWidth OBJECT-TYPE SYNTAX Integer32 (0..16000000) UNITS "hertz" MAX-ACCESS read-write STATUS current DESCRIPTION "The bandwidth of this downstream channel. Most implementations are expected to support a channel width of 6 MHz (North America) and/or 8 MHz (Europe). See the associated compliance object for a description of the valid channel widths for this object." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 6-17." ::= { docsIfDownstreamChannelEntry 3 } docsIfDownChannelModulation OBJECT-TYPE SYNTAX INTEGER { unknown(1), other(2), Raftus/Cardona Expires January 2005 [Page 25] Internet Draft DOCSIS RF Interface MIB July 2004 qam64(3), qam256(4) } MAX-ACCESS read-write STATUS current DESCRIPTION "The modulation type associated with this downstream channel. If the interface is down, this object either returns the configured value (CMTS), the most current value (CM), or the value of unknown(1). See the associated conformance object for write conditions and limitations. See the reference for specifics on the modulation profiles implied by qam64 and qam256." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 6-17." ::= { docsIfDownstreamChannelEntry 4 } docsIfDownChannelInterleave OBJECT-TYPE SYNTAX INTEGER { unknown(1), other(2), taps8Increment16(3), taps16Increment8(4), taps32Increment4(5), taps64Increment2(6), taps128Increment1(7), taps12increment17(8) } MAX-ACCESS read-write STATUS current DESCRIPTION "The Forward Error Correction (FEC) interleaving used for this downstream channel. Values are defined as follows: taps8Increment16(3): protection 5.9/4.1 usec, latency .22/.15 msec taps16Increment8(4): protection 12/8.2 usec, latency .48/.33 msec taps32Increment4(5): protection 24/16 usec, latency .98/.68 msec taps64Increment2(6): protection 47/33 usec, latency 2/1.4 msec taps128Increment1(7): protection 95/66 usec, latency 4/2.8 msec taps12increment17(8): protection 18/14 usec, latency 0.43/0.32 msec The value 'taps12increment17' is supported by EuroDOCSIS Raftus/Cardona Expires January 2005 [Page 26] Internet Draft DOCSIS RF Interface MIB July 2004 cable systems only and the others by DOCSIS cable systems. If the interface is down, this object either returns the configured value (CMTS), the most current value (CM), or the value of unknown(1). The value of other(2) is returned if the interleave is known but not defined in the above list. See the associated conformance object for write conditions and limitations. See the reference for the FEC configuration described by the setting of this object." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 6-15." ::= { docsIfDownstreamChannelEntry 5 } docsIfDownChannelPower OBJECT-TYPE SYNTAX TenthdBmV UNITS "dBmV" MAX-ACCESS read-write STATUS current DESCRIPTION "At the CMTS, the operational transmit power. At the CM, the received power level. If the interface is down, this object either returns the configured value (CMTS), the most current value (CM) or the value of 0. See the associated conformance object for write conditions and limitations. See the reference for recommended and required power levels." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-16, 6-17." ::= { docsIfDownstreamChannelEntry 6 } docsIfDownChannelAnnex OBJECT-TYPE SYNTAX INTEGER { unknown(1), other(2), annexA(3), annexB(4), annexC(5) } MAX-ACCESS read-only STATUS current DESCRIPTION "The value of this object indicates the conformance of the implementation to important regional cable standards. annexA : Annex A from ITU-T J.83 is used (equivalent to EN 300 429) Raftus/Cardona Expires January 2005 [Page 27] Internet Draft DOCSIS RF Interface MIB July 2004 annexB : Annex B from ITU-T J.83 is used. annexC : Annex C from ITU-T J.83 is used." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 6.3.1, and H.3.1." ::= { docsIfDownstreamChannelEntry 7 } docsIfDownChannelStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-only STATUS current DESCRIPTION "The storage type for this conceptual row." ::= { docsIfDownstreamChannelEntry 8 } -- -- The following table is implemented on both the CM and the CMTS. -- For the CM, only attached channels appear in the table. For the -- CM, this table is read only as well. -- docsIfUpstreamChannelTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfUpstreamChannelEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table describes the attributes of attached upstream channels." ::= { docsIfBaseObjects 2 } docsIfUpstreamChannelEntry OBJECT-TYPE SYNTAX DocsIfUpstreamChannelEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "List of attributes for a single upstream channel. For DOCSIS 2.0 CMTSs, an entry in this table exists for each ifEntry with an ifType of docsCableUpstreamChannel (205). For DOCSIS 1.x CM/CMTSs and DOCSIS 2.0 CMs, an entry in this table exists for each ifEntry with an ifType of docsCableUpstreamInterface (129)." INDEX { ifIndex } ::= { docsIfUpstreamChannelTable 1 } DocsIfUpstreamChannelEntry ::= SEQUENCE { docsIfUpChannelId Integer32, docsIfUpChannelFrequency Integer32, docsIfUpChannelWidth Integer32, Raftus/Cardona Expires January 2005 [Page 28] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfUpChannelModulationProfile Unsigned32, docsIfUpChannelSlotSize Unsigned32, docsIfUpChannelTxTimingOffset Unsigned32, docsIfUpChannelRangingBackoffStart Integer32, docsIfUpChannelRangingBackoffEnd Integer32, docsIfUpChannelTxBackoffStart Integer32, docsIfUpChannelTxBackoffEnd Integer32, docsIfUpChannelScdmaActiveCodes Unsigned32, docsIfUpChannelScdmaCodesPerSlot Integer32, docsIfUpChannelScdmaFrameSize Unsigned32, docsIfUpChannelScdmaHoppingSeed Unsigned32, docsIfUpChannelType DocsisUpstreamType, docsIfUpChannelCloneFrom InterfaceIndexOrZero, docsIfUpChannelUpdate TruthValue, docsIfUpChannelStatus RowStatus, docsIfUpChannelPreEqEnable TruthValue } docsIfUpChannelId OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The CMTS identification of the upstream channel." ::= { docsIfUpstreamChannelEntry 1 } docsIfUpChannelFrequency OBJECT-TYPE SYNTAX Integer32 (0..1000000000) UNITS "hertz" MAX-ACCESS read-create STATUS current DESCRIPTION "The center of the frequency band associated with this upstream interface. This object returns 0 if the frequency is undefined or unknown. Minimum permitted upstream frequency is 5,000,000 Hz for current technology. See the associated conformance object for write conditions and limitations." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 4-2." ::= { docsIfUpstreamChannelEntry 2 } docsIfUpChannelWidth OBJECT-TYPE SYNTAX Integer32 (0..64000000) UNITS "hertz" MAX-ACCESS read-create STATUS current DESCRIPTION Raftus/Cardona Expires January 2005 [Page 29] Internet Draft DOCSIS RF Interface MIB July 2004 "The bandwidth of this upstream interface. This object returns 0 if the interface width is undefined or unknown. Minimum permitted interface width is 200,000 Hz currently. See the associated conformance object for write conditions and limitations." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 6-5." ::= { docsIfUpstreamChannelEntry 3 } docsIfUpChannelModulationProfile OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "An entry identical to the docsIfModIndex in the docsIfCmtsModulationTable that describes this channel. This channel is further instantiated there by a grouping of interval usage codes (IUCs)which together fully describe the channel modulation. This object returns 0 if the docsIfCmtsModulationTable entry does not exist or is empty. See the associated conformance object for write conditions and limitations. Setting this object returns a genErr error if the following conditions are not satisfied: 1. All the IUC entries in the selected modulation profile MUST have the same value of docsIfCmtsModChannelType. 2. All of the Modulation parameters in the selected modulation profile MUST be consistent with the other parameters in this docsIfUpstreamChannelEntry." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 8-19." ::= { docsIfUpstreamChannelEntry 4 } docsIfUpChannelSlotSize OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Applicable to TDMA and ATDMA channel types only. The number of 6.25 microsecond ticks in each upstream mini-slot. Returns zero if the value is undefined, unknown or in case of an SCDMA channel. See the associated conformance object for write conditions and limitations." REFERENCE Raftus/Cardona Expires January 2005 [Page 30] Internet Draft DOCSIS RF Interface MIB July 2004 "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.1.2.4." ::= { docsIfUpstreamChannelEntry 5 } docsIfUpChannelTxTimingOffset OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "At the CM, a measure of the current round trip time obtained from the ranging offset (initial ranging offset + ranging offset adjustments). At the CMTS, the maximum of timing offset, among all the CMs that are/were present on the channel, taking into account all ( initial + periodic ) timing offset corrections that were sent for each of the CMs. Generally, these measurements are positive, but if the measurements are negative, the value of this object is zero. Used for timing of CM upstream transmissions to ensure synchronized arrivals at the CMTS. Units are in terms of (6.25 microseconds/64)." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.19." ::= { docsIfUpstreamChannelEntry 6 } docsIfUpChannelRangingBackoffStart OBJECT-TYPE SYNTAX Integer32 (0..16) MAX-ACCESS read-create STATUS current DESCRIPTION "The initial random backoff window to use when retrying Ranging Requests. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. See the associated conformance object for write conditions and limitations." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 8.3.4, and 9.4." ::= { docsIfUpstreamChannelEntry 7 } docsIfUpChannelRangingBackoffEnd OBJECT-TYPE SYNTAX Integer32 (0..16) MAX-ACCESS read-create STATUS current DESCRIPTION "The final random backoff window to use when retrying Raftus/Cardona Expires January 2005 [Page 31] Internet Draft DOCSIS RF Interface MIB July 2004 Ranging Requests. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. See the associated conformance object for write conditions and limitations." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.4, and 9.4." ::= { docsIfUpstreamChannelEntry 8 } docsIfUpChannelTxBackoffStart OBJECT-TYPE SYNTAX Integer32 (0..16) MAX-ACCESS read-create STATUS current DESCRIPTION "The initial random backoff window to use when retrying transmissions. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. See the associated conformance object for write conditions and limitations." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.4, and 9.4." ::= { docsIfUpstreamChannelEntry 9 } docsIfUpChannelTxBackoffEnd OBJECT-TYPE SYNTAX Integer32 (0..16) MAX-ACCESS read-create STATUS current DESCRIPTION "The final random backoff window to use when retrying transmissions. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. See the associated conformance object for write conditions and limitations." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.4, and 9.4." ::= { docsIfUpstreamChannelEntry 10 } docsIfUpChannelScdmaActiveCodes OBJECT-TYPE SYNTAX Unsigned32 (0 | 64..128) MAX-ACCESS read-create STATUS current DESCRIPTION "Applicable for SCDMA channel types only. Number of active codes. Returns zero for Non-SCDMA channel types. Note that legal Raftus/Cardona Expires January 2005 [Page 32] Internet Draft DOCSIS RF Interface MIB July 2004 values from 64..128 MUST be non-prime." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.11.2.1." ::= { docsIfUpstreamChannelEntry 11 } docsIfUpChannelScdmaCodesPerSlot OBJECT-TYPE SYNTAX Integer32(0 | 2..32) MAX-ACCESS read-create STATUS current DESCRIPTION "Applicable for SCDMA channel types only. The number of SCDMA codes per mini-slot. Returns zero if the value is undefined, unknown or in case of a TDMA or ATDMA channel." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.11.2.1." ::= { docsIfUpstreamChannelEntry 12 } docsIfUpChannelScdmaFrameSize OBJECT-TYPE SYNTAX Unsigned32 (0..32) MAX-ACCESS read-create STATUS current DESCRIPTION "Applicable for SCDMA channel types only. SCDMA Frame size in units of spreading intervals. This value returns zero for non SCDMA Profiles." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.12." ::= { docsIfUpstreamChannelEntry 13 } docsIfUpChannelScdmaHoppingSeed OBJECT-TYPE SYNTAX Unsigned32 (0..32767) MAX-ACCESS read-create STATUS current DESCRIPTION "Applicable for SCDMA channel types only. 15 bit seed used for code hopping sequence initialization. Returns zero for non-SCDMA channel types." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.14.1." ::= { docsIfUpstreamChannelEntry 14 } Raftus/Cardona Expires January 2005 [Page 33] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfUpChannelType OBJECT-TYPE SYNTAX DocsisUpstreamType MAX-ACCESS read-only STATUS current DESCRIPTION "Reflects the Upstream channel type. This object returns the value of docsIfCmtsModChannelType for the modulation profile selected in docsIfUpChannelModulationProfile for this row." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.1." ::= { docsIfUpstreamChannelEntry 15 } docsIfUpChannelCloneFrom OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "Intended for use when a temporary upstream row entry is created for the purpose of manipulating parameters for a physical upstream channel. Refer to the descriptions of docsIfUpChannelStatus and docsIfUpChannelUpdate for details of this procedure. This object contains the ifIndex value of the physical upstream row whose parameters are to be adjusted. Upon setting this object, the values of docsIfUpChannelFrequency, docsIfUpChannelWidth, docsIfUpChannelModulationProfile, docsIfUpChannelSlotSize, docsIfUpChannelRangingBackoffStart, docsIfUpChannelRangingBackoffEnd, docsIfUpChannelTxBackoffStart, docsIfUpChannelTxBackoffEnd, docsIfUpChannelScdmaActiveCodes, docsIfUpChannelScdmaCodesPerSlot, docsIfUpChannelScdmaFrameSize, docsIfUpChannelScdmaHoppingSeed, docsIfUpChannelType, and docsIfUpChannelPreEqEnable for this row are populated with the corresponding values from the row referenced by this object. Setting this object to a non-existent or temporary upstream returns an error wrongValue. This object MUST contain a value of zero for physical upstream rows." ::= { docsIfUpstreamChannelEntry 16 } Raftus/Cardona Expires January 2005 [Page 34] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfUpChannelUpdate OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION " Used to perform the transfer of adjusted parameters from the temporary upstream row to the physical upstream row indicated by the docsIfUpChannelCloneFrom object. The transfer is initiated through an SNMP SET to 'true' of this object. The SNMP SET failure returns an error genError (snmpv1) or commitFailed (snmpv2c/v3) if the adjusted parameter values are not compatible with each other. Reading this object always return 'false'." ::= { docsIfUpstreamChannelEntry 17 } docsIfUpChannelStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object is generally intended to be used for the creation of a temporary upstream row for the purpose of adjusting channel parameters of a physical upstream channel row. The following restrictions apply to this object: 1. Entries with this object set to active(1) are extensions of defined physical interfaces in the interface MIB RFC 2863. Entries created by RowStatus createandWait(5) are referred as temporary inactive rows used to clone parameters. 2. A status transition from active(1) to notInService(2) or destroy(6) is not permitted. 3. ifAdminStatus from the Interface MIB RFC 2863 is used to take an Upstream Channel offline. 4. Temporary inactive rows MUST be created using createAndWait(5). 5. The only possible status change of a row created using createAndWait(5) (i.e. notInService(2)) or notReady(3) is to destroy(6). 6. Temporary created rows MUST never be given the status active(1). A mandatory procedure for adjusting an specific physical Upstream channel is: 1. Create a temporary row through an SNMP SET using createAndWait(5). Use an ifIndex value outside the operational range of the system. Raftus/Cardona Expires January 2005 [Page 35] Internet Draft DOCSIS RF Interface MIB July 2004 2. Set the docsIfUpChannelCloneFrom field to the ifIndex value of the physical row whose parameters require adjustment. 3. Adjust the parameter values using the new temporary row. Ensure all parameters contain desired values before proceeding to step 4. 4. Update the physical row by setting the object docsIfUpChannelUpdate to true(1). 5. Delete the temporary row through an SNMP SET using destroy(6). Temporary entries MUST NOT persist at reinitialization of the managed system." ::= { docsIfUpstreamChannelEntry 18 } docsIfUpChannelPreEqEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "At the CMTS, used to enable or disable pre-equalization on the upstream channel represented by this table instance. At the CM, this object is read-only and reflects the status of pre-equalization as represented in the RNG-RSP. Pre-equalization is considered enabled at the CM if a RNG-RSP with pre-equalization data has been received at least once since the last mac reinit." DEFVAL {false} ::= { docsIfUpstreamChannelEntry 19 } -- The following table describes the attributes of each class of -- service. The entries in this table are referenced from the -- docsIfServiceEntries. They exist as a separate table in order to -- reduce redundant information in docsIfServiceTable. -- -- This table is implemented at both the CM and the CMTS. -- The CM need only maintain entries for the classes of service -- referenced by its docsIfCmServiceTable. -- docsIfQosProfileTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfQosProfileEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes the attributes for each class of service." ::= { docsIfBaseObjects 3 } docsIfQosProfileEntry OBJECT-TYPE SYNTAX DocsIfQosProfileEntry Raftus/Cardona Expires January 2005 [Page 36] Internet Draft DOCSIS RF Interface MIB July 2004 MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes the attributes for a single class of service. If implemented as read-create in the Cable Modem Termination System, creation of entries in this table is controlled by the value of docsIfCmtsQosProfilePermissions. If implemented as read-only, entries are created based on information in REG-REQ MAC messages received from Cable Modems (Cable Modem Termination System implementation), or based on information extracted from the TFTP option file (Cable Modem implementation). In the Cable Modem Termination system, read-only entries are removed if no longer referenced by docsIfCmtsServiceTable. An entry in this table MUST not be removed while it is referenced by an entry in docsIfCmServiceTable (Cable Modem) or docsIfCmtsServiceTable (Cable Modem Termination System). An entry in this table SHOULD NOT be changeable while it is referenced by an entry in docsIfCmtsServiceTable. If this table is created automatically, there SHOULD only be a single entry for each Class of Service. Multiple entries with the same Class of Service parameters are NOT RECOMMENDED." INDEX { docsIfQosProfIndex } ::= { docsIfQosProfileTable 1 } DocsIfQosProfileEntry ::= SEQUENCE { docsIfQosProfIndex Integer32, docsIfQosProfPriority Integer32, docsIfQosProfMaxUpBandwidth Integer32, docsIfQosProfGuarUpBandwidth Integer32, docsIfQosProfMaxDownBandwidth Integer32, docsIfQosProfMaxTxBurst Integer32, -- deprecated docsIfQosProfBaselinePrivacy TruthValue, docsIfQosProfStatus RowStatus, docsIfQosProfMaxTransmitBurst Integer32, docsIfQosProfStorageType StorageType } docsIfQosProfIndex OBJECT-TYPE SYNTAX Integer32 (1..16383) MAX-ACCESS not-accessible Raftus/Cardona Expires January 2005 [Page 37] Internet Draft DOCSIS RF Interface MIB July 2004 STATUS current DESCRIPTION "The index value that uniquely identifies an entry in the docsIfQosProfileTable." ::= { docsIfQosProfileEntry 1 } docsIfQosProfPriority OBJECT-TYPE SYNTAX Integer32 (0..7) MAX-ACCESS read-create STATUS current DESCRIPTION "A relative priority assigned to this service when allocating bandwidth. Zero indicates lowest priority and seven indicates highest priority. Interpretation of priority is device-specific. MUST NOT be changed while this row is active." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex C.1.1.4." DEFVAL { 0 } ::= { docsIfQosProfileEntry 2 } docsIfQosProfMaxUpBandwidth OBJECT-TYPE SYNTAX Integer32 (0..100000000) UNITS "bits per second" MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum upstream bandwidth, in bits per second, allowed for a service with this service class. Zero if there is no restriction of upstream bandwidth. MUST NOT be changed while this row is active." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex C.1.1.4." DEFVAL { 0 } ::= { docsIfQosProfileEntry 3 } docsIfQosProfGuarUpBandwidth OBJECT-TYPE SYNTAX Integer32 (0..100000000) UNITS "bits per second" MAX-ACCESS read-create STATUS current DESCRIPTION "Minimum guaranteed upstream bandwidth, in bits per second, allowed for a service with this service class. MUST NOT be changed while this row is active." REFERENCE Raftus/Cardona Expires January 2005 [Page 38] Internet Draft DOCSIS RF Interface MIB July 2004 "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex C.1.1.4." DEFVAL { 0 } ::= { docsIfQosProfileEntry 4 } docsIfQosProfMaxDownBandwidth OBJECT-TYPE SYNTAX Integer32 (0..100000000) UNITS "bits per second" MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum downstream bandwidth, in bits per second, allowed for a service with this service class. Zero if there is no restriction of downstream bandwidth. MUST NOT be changed while this row is active." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex C.1.1.4." DEFVAL { 0 } ::= { docsIfQosProfileEntry 5 } docsIfQosProfMaxTxBurst OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "mini-slots" MAX-ACCESS read-create STATUS deprecated DESCRIPTION "The maximum number of mini-slots that may be requested for a single upstream transmission. A value of zero means there is no limit. MUST NOT be changed while this row is active. This object has been deprecated and replaced by docsIfQosProfMaxTransmitBurst, to fix a mismatch of the units and value range with respect to the DOCSIS Maximum Upstream Channel Transmit Burst Configuration Setting." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, C.1.1.4." DEFVAL { 0 } ::= { docsIfQosProfileEntry 6 } docsIfQosProfBaselinePrivacy OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current Raftus/Cardona Expires January 2005 [Page 39] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "Indicates whether Baseline Privacy is enabled for this service class. MUST NOT be changed while this row is active." DEFVAL { false } ::= { docsIfQosProfileEntry 7 } docsIfQosProfStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This is object is to used to create or delete rows in this table. This object MUST NOT be changed from active while the row is referenced by the any entry in either docsIfCmServiceTable (on the CM), or the docsIfCmtsServiceTable (on the CMTS)." ::= { docsIfQosProfileEntry 8 } docsIfQosProfMaxTransmitBurst OBJECT-TYPE SYNTAX Integer32 (0..65535) UNITS "bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum number of bytes that may be requested for a single upstream transmission. A value of zero means there is no limit. Note: This value does not include any physical layer overhead. MUST NOT be changed while this row is active." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex C.1.1.4." DEFVAL { 0 } ::= { docsIfQosProfileEntry 9 } docsIfQosProfStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-only STATUS current DESCRIPTION "The storage type for this conceptual row." ::= { docsIfQosProfileEntry 10 } docsIfSignalQualityTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfSignalQualityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION Raftus/Cardona Expires January 2005 [Page 40] Internet Draft DOCSIS RF Interface MIB July 2004 "At the CM, describes the PHY signal quality of downstream channels. At the CMTS, describes the PHY signal quality of upstream channels. At the CMTS, this table MAY exclude contention intervals." ::= { docsIfBaseObjects 4 } docsIfSignalQualityEntry OBJECT-TYPE SYNTAX DocsIfSignalQualityEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "At the CM, describes the PHY characteristics of a downstream channel. At the CMTS, describes the PHY signal quality of an upstream channel. An entry in this table exists for each ifEntry with an ifType of docsCableDownstream(128) for Cable Modems. For DOCSIS 1.1 Cable Modem Termination Systems, an entry exists for each ifEntry with an ifType of docsCableUpstream (129). For DOCSIS 2.0 Cable Modem Termination Systems, an entry exists for each ifEntry with an ifType of docsCableUpstreamChannel (205)." INDEX { ifIndex } ::= { docsIfSignalQualityTable 1 } DocsIfSignalQualityEntry ::= SEQUENCE { docsIfSigQIncludesContention TruthValue, docsIfSigQUnerroreds Counter32, docsIfSigQCorrecteds Counter32, docsIfSigQUncorrectables Counter32, docsIfSigQSignalNoise TenthdB, docsIfSigQMicroreflections Integer32, docsIfSigQEqualizationData OCTET STRING, docsIfSigQExtUnerroreds Counter64, docsIfSigQExtCorrecteds Counter64, docsIfSigQExtUncorrectables Counter64 } docsIfSigQIncludesContention OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "true(1) if this CMTS includes contention intervals in the counters in this table. Always false(2) for CMs." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4.1" ::= { docsIfSignalQualityEntry 1 } Raftus/Cardona Expires January 2005 [Page 41] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfSigQUnerroreds OBJECT-TYPE SYNTAX Counter32 UNITS "codewords" MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received on this channel without error. This includes all codewords, whether or not they were part of frames destined for this device. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 6.2.4, and 6.3.6." ::= { docsIfSignalQualityEntry 2 } docsIfSigQCorrecteds OBJECT-TYPE SYNTAX Counter32 UNITS "codewords" MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received on this channel with correctable errors. This includes all codewords, whether or not they were part of frames destined for this device. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 6.2.4, and 6.3.6." ::= { docsIfSignalQualityEntry 3 } docsIfSigQUncorrectables OBJECT-TYPE SYNTAX Counter32 UNITS "codewords" MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received on this channel with uncorrectable errors. This includes all codewords, whether or not they were part of frames destined for this device. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other Raftus/Cardona Expires January 2005 [Page 42] Internet Draft DOCSIS RF Interface MIB July 2004 times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 6.2.4, and 6.3.6." ::= { docsIfSignalQualityEntry 4 } docsIfSigQSignalNoise OBJECT-TYPE SYNTAX TenthdB UNITS "dB" MAX-ACCESS read-only STATUS current DESCRIPTION "Signal/Noise ratio as perceived for this channel. At the CM, describes the Signal/Noise of the downstream channel. At the CMTS, describes the average Signal/Noise of the upstream channel." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 4-1 and 4-2" ::= { docsIfSignalQualityEntry 5 } docsIfSigQMicroreflections OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "-dBc" MAX-ACCESS read-only STATUS current DESCRIPTION "Microreflections including in-channel response as perceived on this interface, measured in dBc below the signal level. This object is not assumed to return an absolutely accurate value, but SHOULD give a rough indication of microreflections received on this interface. It is up to the implementer to provide information as accurate as possible. " REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 4-1 and 4-2" ::= { docsIfSignalQualityEntry 6 } docsIfSigQEqualizationData OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..512)) MAX-ACCESS read-only STATUS current DESCRIPTION "At the CM, returns the equalization data for the Raftus/Cardona Expires January 2005 [Page 43] Internet Draft DOCSIS RF Interface MIB July 2004 downstream channel. At the CMTS, returns the average equalization data for the upstream channel. Returns an empty string if the value is unknown or if there is no equalization data available or defined." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.15." ::= { docsIfSignalQualityEntry 7 } docsIfSigQExtUnerroreds OBJECT-TYPE SYNTAX Counter64 UNITS "codewords" MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received on this channel without error. This includes all codewords, whether or not they were part of frames destined for this device. This is the 64 bit version of docsIfSigQUnerroreds. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 6.2.4, and 6.3.6." ::= { docsIfSignalQualityEntry 8 } docsIfSigQExtCorrecteds OBJECT-TYPE SYNTAX Counter64 UNITS "codewords" MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received on this channel with correctable errors. This includes all codewords, whether or not they were part of frames destined for this device. This is the 64 bit version of docsIfSigQCorrecteds. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 6.2.4, and 6.3.6." ::= { docsIfSignalQualityEntry 9 } Raftus/Cardona Expires January 2005 [Page 44] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfSigQExtUncorrectables OBJECT-TYPE SYNTAX Counter64 UNITS "codewords" MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received on this channel with uncorrectable errors. This includes all codewords, whether or not they were part of frames destined for this device. This is the 64 bit version of docsIfSigQUncorrectables. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Sections 6.2.4, 6.3.6." ::= { docsIfSignalQualityEntry 10 } -- -- DOCSIS Version of the device -- docsIfDocsisBaseCapability OBJECT-TYPE SYNTAX DocsisVersion MAX-ACCESS read-only STATUS current DESCRIPTION "Indication of the DOCSIS capability of the device." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex G." ::= { docsIfBaseObjects 5 } -- -- CABLE MODEM GROUP -- -- -- The CM MAC Table -- docsIfCmMacTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmMacEntry MAX-ACCESS not-accessible Raftus/Cardona Expires January 2005 [Page 45] Internet Draft DOCSIS RF Interface MIB July 2004 STATUS current DESCRIPTION "Describes the attributes of each CM MAC interface, extending the information available from ifEntry." ::= { docsIfCmObjects 1 } docsIfCmMacEntry OBJECT-TYPE SYNTAX DocsIfCmMacEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing objects describing attributes of each MAC entry, extending the information in ifEntry. An entry in this table exists for each ifEntry with an ifType of docsCableMaclayer(127)." INDEX { ifIndex } ::= { docsIfCmMacTable 1 } DocsIfCmMacEntry ::= SEQUENCE { docsIfCmCmtsAddress MacAddress, docsIfCmCapabilities BITS, docsIfCmRangingRespTimeout TimeTicks, docsIfCmRangingTimeout TimeInterval } docsIfCmCmtsAddress OBJECT-TYPE SYNTAX MacAddress MAX-ACCESS read-only STATUS current DESCRIPTION "Identifies the CMTS that is believed to control this MAC domain. At the CM, this will be the source address from SYNC, MAP, and other MAC-layer messages. If the CMTS is unknown, returns 00-00-00-00-00-00." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.2.2." ::= { docsIfCmMacEntry 1 } docsIfCmCapabilities OBJECT-TYPE SYNTAX BITS { atmCells(0), concatenation(1) } MAX-ACCESS read-only STATUS current DESCRIPTION "Identifies the capabilities of the MAC implementation at this interface. Note that packet transmission is Raftus/Cardona Expires January 2005 [Page 46] Internet Draft DOCSIS RF Interface MIB July 2004 always supported. Therefore, there is no specific bit required to explicitly indicate this capability. Note that BITS objects are encoded most significant bit first. For example, if bit 1 is set, the value of this object is the octet string '40'H." ::= { docsIfCmMacEntry 2 } -- This object has been obsoleted and replaced by -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New -- implementations of the MIB SHOULD use docsIfCmRangingTimeout -- instead. docsIfCmRangingRespTimeout OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-write STATUS obsolete DESCRIPTION "Waiting time for a Ranging Response packet." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.1.6." DEFVAL { 20 } ::= { docsIfCmMacEntry 3 } docsIfCmRangingTimeout OBJECT-TYPE SYNTAX TimeInterval MAX-ACCESS read-write STATUS current DESCRIPTION "Waiting time for a Ranging Response packet. This object MUST NOT persist at reinitialization of the managed system." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.1.6, timer T3." DEFVAL { 20 } ::= { docsIfCmMacEntry 4 } -- -- CM status table. -- This table is implemented only at the CM. -- docsIfCmStatusTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION Raftus/Cardona Expires January 2005 [Page 47] Internet Draft DOCSIS RF Interface MIB July 2004 "This table maintains a number of status objects and counters for Cable Modems." ::= { docsIfCmObjects 2 } docsIfCmStatusEntry OBJECT-TYPE SYNTAX DocsIfCmStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A set of status objects and counters for a single MAC layer instance in a Cable Modem. An entry in this table exists for each ifEntry with an ifType of docsCableMaclayer(127)." INDEX { ifIndex } ::= { docsIfCmStatusTable 1 } DocsIfCmStatusEntry ::= SEQUENCE { docsIfCmStatusValue INTEGER, docsIfCmStatusCode OCTET STRING, docsIfCmStatusTxPower TenthdBmV, docsIfCmStatusResets Counter32, docsIfCmStatusLostSyncs Counter32, docsIfCmStatusInvalidMaps Counter32, docsIfCmStatusInvalidUcds Counter32, docsIfCmStatusInvalidRangingResponses Counter32, docsIfCmStatusInvalidRegistrationResponses Counter32, docsIfCmStatusT1Timeouts Counter32, docsIfCmStatusT2Timeouts Counter32, docsIfCmStatusT3Timeouts Counter32, docsIfCmStatusT4Timeouts Counter32, docsIfCmStatusRangingAborteds Counter32, docsIfCmStatusDocsisOperMode DocsisQosVersion, docsIfCmStatusModulationType DocsisUpstreamTypeStatus, docsIfCmStatusEqualizationData OCTET STRING, docsIfCmStatusUCCs Counter32, docsIfCmStatusUCCFails Counter32 } docsIfCmStatusValue OBJECT-TYPE SYNTAX INTEGER { other(1), notReady(2), notSynchronized(3), phySynchronized(4), usParametersAcquired(5), rangingComplete(6), ipComplete(7), todEstablished(8), securityEstablished(9), paramTransferComplete(10), Raftus/Cardona Expires January 2005 [Page 48] Internet Draft DOCSIS RF Interface MIB July 2004 registrationComplete(11), operational(12), accessDenied(13) } MAX-ACCESS read-only STATUS current DESCRIPTION "Current Cable Modem connectivity state, as specified in the RF Interface Specification. Interpretations for state values 1-12 are clearly outlined in the SP-RFI reference given below. The state value accessDenied(13) indicates the CMTS has sent a Registration Aborted message to the CM. Same state is reported as accessDenied(7) by the CMTS object docsIfCmtsCmStatusValue." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 11.2. Data-Over-Cable Service Interface Specifications: Operations Support System Interface Specification SP-OSSIv2.0-IO4-030730, Section 6.3.4.2." ::= { docsIfCmStatusEntry 1 } docsIfCmStatusCode OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..16)) MAX-ACCESS read-only STATUS current DESCRIPTION "Status code for this Cable Modem as defined in the OSSI Specification. The status code consists of a single character indicating error groups, followed by a two- or three-digit number indicating the status condition, followed by a decimal." REFERENCE "Data-Over-Cable Service Interface Specifications: Operations Support System Interface Specification SP-OSSIv2.0-I04-030730, Annex D." ::= { docsIfCmStatusEntry 2 } docsIfCmStatusTxPower OBJECT-TYPE SYNTAX TenthdBmV UNITS "dBmV" MAX-ACCESS read-only STATUS current DESCRIPTION "The operational transmit power for the attached upstream channel." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Raftus/Cardona Expires January 2005 [Page 49] Internet Draft DOCSIS RF Interface MIB July 2004 Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.18." ::= { docsIfCmStatusEntry 3 } docsIfCmStatusResets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times the CM reset or initialized this interface." ::= { docsIfCmStatusEntry 4 } docsIfCmStatusLostSyncs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times the CM lost synchronization with the downstream channel. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.2." ::= { docsIfCmStatusEntry 5 } docsIfCmStatusInvalidMaps OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times the CM received invalid MAP messages. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.4." ::= { docsIfCmStatusEntry 6 } docsIfCmStatusInvalidUcds OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Raftus/Cardona Expires January 2005 [Page 50] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "Number of times the CM received invalid UCD messages. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.3." ::= { docsIfCmStatusEntry 7 } docsIfCmStatusInvalidRangingResponses OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times the CM received invalid ranging response messages. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.6." ::= { docsIfCmStatusEntry 8 } docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times the CM received invalid registration response messages. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.8." ::= { docsIfCmStatusEntry 9 } docsIfCmStatusT1Timeouts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Raftus/Cardona Expires January 2005 [Page 51] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "Number of times counter T1 expired in the CM. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Figure 9-2." ::= { docsIfCmStatusEntry 10 } docsIfCmStatusT2Timeouts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times counter T2 expired in the CM. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Figure 9-2." ::= { docsIfCmStatusEntry 11 } docsIfCmStatusT3Timeouts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times counter T3 expired in the CM. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Figure 9-2." ::= { docsIfCmStatusEntry 12 } docsIfCmStatusT4Timeouts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times counter T4 expired in the CM. Raftus/Cardona Expires January 2005 [Page 52] Internet Draft DOCSIS RF Interface MIB July 2004 Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Figure 9-2." ::= { docsIfCmStatusEntry 13 } docsIfCmStatusRangingAborteds OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of times the ranging process was aborted by the CMTS. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.3.3." ::= { docsIfCmStatusEntry 14 } docsIfCmStatusDocsisOperMode OBJECT-TYPE SYNTAX DocsisQosVersion MAX-ACCESS read-only STATUS current DESCRIPTION "Indication whether the device has registered using 1.0 Class of Service or 1.1 Quality of Service. An unregistered CM SHOULD indicate 'docsis11' for a docsIfDocsisBaseCapability value of DOCSIS 1.1/2.0. An unregistered CM SHOULD indicate 'docsis10' for a docsIfDocsisBaseCapability value of DOCSIS 1.0." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex G." ::= { docsIfCmStatusEntry 15 } docsIfCmStatusModulationType OBJECT-TYPE SYNTAX DocsisUpstreamTypeStatus MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates modulation type status currently used by the Raftus/Cardona Expires January 2005 [Page 53] Internet Draft DOCSIS RF Interface MIB July 2004 CM. Since this object specifically identifies PHY mode, the shared upstream channel type is not permitted." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.1." ::= { docsIfCmStatusEntry 16 } docsIfCmStatusEqualizationData OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..512)) MAX-ACCESS read-only STATUS current DESCRIPTION "Pre-equalization data for this CM after convolution with data indicated in the RNG-RSP. This data is valid when docsIfUpChannelPreEqEnable is set to true. The value SHOULD be formatted as defined in the following REFERENCE, beginning with the main tap location field. The type and length fields shown in the referenced figure MUST NOT be included. Returns an empty string if the value is unknown or if there is no equalization data available or defined." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Figure 8-23." ::= { docsIfCmStatusEntry 17 } docsIfCmStatusUCCs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of successful Upstream Channel Change transactions. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmStatusEntry 18 } docsIfCmStatusUCCFails OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of failed Upstream Channel Change transactions. Discontinuities in the value of this counter can occur Raftus/Cardona Expires January 2005 [Page 54] Internet Draft DOCSIS RF Interface MIB July 2004 at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmStatusEntry 19 } -- -- The Cable Modem Service Table -- docsIfCmServiceTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmServiceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes the attributes of each upstream service queue on a CM." ::= { docsIfCmObjects 3 } docsIfCmServiceEntry OBJECT-TYPE SYNTAX DocsIfCmServiceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes the attributes of an upstream bandwidth service queue. An entry in this table exists for each Service ID. The primary index is an ifIndex with an ifType of docsCableMaclayer(127)." INDEX { ifIndex, docsIfCmServiceId } ::= { docsIfCmServiceTable 1 } DocsIfCmServiceEntry ::= SEQUENCE { docsIfCmServiceId Integer32, docsIfCmServiceQosProfile Integer32, docsIfCmServiceTxSlotsImmed Counter32, docsIfCmServiceTxSlotsDed Counter32, docsIfCmServiceTxRetries Counter32, docsIfCmServiceTxExceededs Counter32, docsIfCmServiceRqRetries Counter32, docsIfCmServiceRqExceededs Counter32, docsIfCmServiceExtTxSlotsImmed Counter64, docsIfCmServiceExtTxSlotsDed Counter64 } docsIfCmServiceId OBJECT-TYPE SYNTAX Integer32 (1..16383) MAX-ACCESS not-accessible STATUS current DESCRIPTION Raftus/Cardona Expires January 2005 [Page 55] Internet Draft DOCSIS RF Interface MIB July 2004 "Identifies a service queue for upstream bandwidth. The attributes of this service queue are shared between the CM and the CMTS. The CMTS allocates upstream bandwidth to this service queue based on requests from the CM and on the class of service associated with this queue." ::= { docsIfCmServiceEntry 1 } docsIfCmServiceQosProfile OBJECT-TYPE SYNTAX Integer32 (0..16383) MAX-ACCESS read-only STATUS current DESCRIPTION "The index in docsIfQosProfileTable describing the quality of service attributes associated with this particular service. If no associated entry in docsIfQosProfileTable exists, this object returns a value of zero." ::= { docsIfCmServiceEntry 2 } docsIfCmServiceTxSlotsImmed OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "The number of upstream mini-slots which have been used to transmit data PDUs in immediate (contention) mode. This includes only those PDUs that are presumed to have arrived at the headend (i.e., those which were explicitly acknowledged.) It does not include retransmission attempts or mini-slots used by Requests. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 3 } docsIfCmServiceTxSlotsDed OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "The number of upstream mini-slots which have been used to transmit data PDUs in dedicated mode (i.e., as a result of a unicast Data Grant). Discontinuities in the value of this counter can occur Raftus/Cardona Expires January 2005 [Page 56] Internet Draft DOCSIS RF Interface MIB July 2004 at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 4 } docsIfCmServiceTxRetries OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of attempts to transmit data PDUs containing requests for acknowledgment that did not result in acknowledgment. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 5 } docsIfCmServiceTxExceededs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of data PDUs transmission failures due to excessive retries without acknowledgment. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 6 } docsIfCmServiceRqRetries OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of attempts to transmit bandwidth requests Raftus/Cardona Expires January 2005 [Page 57] Internet Draft DOCSIS RF Interface MIB July 2004 which did not result in acknowledgment. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 7 } docsIfCmServiceRqExceededs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of requests for bandwidth which failed due to excessive retries without acknowledgment. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 8 } docsIfCmServiceExtTxSlotsImmed OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "The number of upstream mini-slots which have been used to transmit data PDUs in immediate (contention) mode. This includes only those PDUs that are presumed to have arrived at the headend (i.e., those which were explicitly acknowledged.) It does not include retransmission attempts or mini-slots used by Requests. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 9 } Raftus/Cardona Expires January 2005 [Page 58] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmServiceExtTxSlotsDed OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "The number of upstream mini-slots which have been used to transmit data PDUs in dedicated mode (i.e., as a result of a unicast Data Grant). Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.4." ::= { docsIfCmServiceEntry 10 } -- -- CMTS GROUP -- -- -- The CMTS MAC Table -- docsIfCmtsMacTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsMacEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes the attributes of each CMTS MAC interface, extending the information available from ifEntry. Mandatory for all CMTS devices." ::= { docsIfCmtsObjects 1 } docsIfCmtsMacEntry OBJECT-TYPE SYNTAX DocsIfCmtsMacEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry containing objects describing attributes of each MAC entry, extending the information in ifEntry. An entry in this table exists for each ifEntry with an ifType of docsCableMaclayer(127)." INDEX { ifIndex } ::= { docsIfCmtsMacTable 1 } Raftus/Cardona Expires January 2005 [Page 59] Internet Draft DOCSIS RF Interface MIB July 2004 DocsIfCmtsMacEntry ::= SEQUENCE { docsIfCmtsCapabilities BITS, docsIfCmtsSyncInterval Integer32, docsIfCmtsUcdInterval Integer32, docsIfCmtsMaxServiceIds Integer32, docsIfCmtsInsertionInterval TimeTicks, -- Obsolete docsIfCmtsInvitedRangingAttempts Integer32, docsIfCmtsInsertInterval TimeInterval, docsIfCmtsMacStorageType StorageType } docsIfCmtsCapabilities OBJECT-TYPE SYNTAX BITS { atmCells(0), concatenation(1) } MAX-ACCESS read-only STATUS current DESCRIPTION "Identifies the capabilities of the CMTS MAC implementation at this interface. Note that packet transmission is always supported. Therefore, there is no specific bit required to explicitly indicate this capability. Note that BITS objects are encoded most significant bit first. For example, if bit 1 is set, the value of this object is the octet string '40'H." ::= { docsIfCmtsMacEntry 1 } docsIfCmtsSyncInterval OBJECT-TYPE SYNTAX Integer32 (1..200) UNITS "Milliseconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The interval between CMTS transmission of successive SYNC messages at this interface." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.3." ::= { docsIfCmtsMacEntry 2 } docsIfCmtsUcdInterval OBJECT-TYPE SYNTAX Integer32 (1..2000) UNITS "Milliseconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The interval between CMTS transmission of successive Raftus/Cardona Expires January 2005 [Page 60] Internet Draft DOCSIS RF Interface MIB July 2004 Upstream Channel Descriptor messages for each upstream channel at this interface." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.3" ::= { docsIfCmtsMacEntry 3 } docsIfCmtsMaxServiceIds OBJECT-TYPE SYNTAX Integer32 (1..16383) MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum number of service IDs that may be simultaneously active." ::= { docsIfCmtsMacEntry 4 } -- This object has been obsoleted and replaced by -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem. New -- implementations of this MIB SHOULD use that object instead. docsIfCmtsInsertionInterval OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-write STATUS obsolete DESCRIPTION "The amount of time to elapse between each broadcast initial maintenance grant. Broadcast initial maintenance grants are used to allow new cable modems to join the network. Zero indicates that a vendor-specific algorithm is used instead of a fixed time. Maximum amount of time permitted by the specification is 2 seconds." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex B." ::= { docsIfCmtsMacEntry 5 } docsIfCmtsInvitedRangingAttempts OBJECT-TYPE SYNTAX Integer32 (0..1024) MAX-ACCESS read-write STATUS current DESCRIPTION "The maximum number of attempts to make on invitations for ranging requests. A value of zero means the system SHOULD attempt to range forever." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 9.3.3 and Annex B." ::= { docsIfCmtsMacEntry 6 } Raftus/Cardona Expires January 2005 [Page 61] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsInsertInterval OBJECT-TYPE SYNTAX TimeInterval MAX-ACCESS read-write STATUS current DESCRIPTION "The amount of time to elapse between each broadcast initial maintenance grant. Broadcast initial maintenance grants are used to allow new cable modems to join the network. Zero indicates that a vendor-specific algorithm is used instead of a fixed time. Maximum amount of time permitted by the specification is 2 seconds." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex B." ::= { docsIfCmtsMacEntry 7 } docsIfCmtsMacStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-only STATUS current DESCRIPTION "The storage type for this conceptual row." ::= { docsIfCmtsMacEntry 8 } -- -- -- CMTS status table. -- docsIfCmtsStatusTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "For the MAC layer, this group maintains a number of status objects and counters." ::= { docsIfCmtsObjects 2 } docsIfCmtsStatusEntry OBJECT-TYPE SYNTAX DocsIfCmtsStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Status entry for a single MAC layer. An entry in this table exists for each ifEntry with an ifType of docsCableMaclayer(127)." INDEX { ifIndex } ::= { docsIfCmtsStatusTable 1 } Raftus/Cardona Expires January 2005 [Page 62] Internet Draft DOCSIS RF Interface MIB July 2004 DocsIfCmtsStatusEntry ::= SEQUENCE { docsIfCmtsStatusInvalidRangeReqs Counter32, docsIfCmtsStatusRangingAborteds Counter32, docsIfCmtsStatusInvalidRegReqs Counter32, docsIfCmtsStatusFailedRegReqs Counter32, docsIfCmtsStatusInvalidDataReqs Counter32, docsIfCmtsStatusT5Timeouts Counter32 } docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object counts invalid RNG-REQ messages received on this interface. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.5." ::= { docsIfCmtsStatusEntry 1 } docsIfCmtsStatusRangingAborteds OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object counts ranging attempts that were explicitly aborted by the CMTS. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.6." ::= { docsIfCmtsStatusEntry 2 } docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION Raftus/Cardona Expires January 2005 [Page 63] Internet Draft DOCSIS RF Interface MIB July 2004 "This object counts invalid REG-REQ messages received on this interface. That is, syntax, out of range parameters, or erroneous requests. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.7." ::= { docsIfCmtsStatusEntry 3 } docsIfCmtsStatusFailedRegReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object counts failed registration attempts. Included are docsIfCmtsStatusInvalidRegReqs, authentication and class of service failures. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.3.7." ::= { docsIfCmtsStatusEntry 4 } docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object counts invalid data request messages received on this interface. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsStatusEntry 5 } docsIfCmtsStatusT5Timeouts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object counts the number of times counter T5 Raftus/Cardona Expires January 2005 [Page 64] Internet Draft DOCSIS RF Interface MIB July 2004 expired on this interface. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Figure 9-2." ::= { docsIfCmtsStatusEntry 6 } -- -- CM status table (within CMTS). -- This table is implemented only at the CMTS. -- It contains per CM status information available in the CMTS. -- docsIfCmtsCmStatusTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsCmStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A set of objects in the CMTS, maintained for each Cable Modem connected to this CMTS." ::= { docsIfCmtsObjects 3 } docsIfCmtsCmStatusEntry OBJECT-TYPE SYNTAX DocsIfCmtsCmStatusEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Status information for a single Cable Modem. An entry in this table exists for each Cable Modem that is connected to the CMTS implementing this table." INDEX { docsIfCmtsCmStatusIndex } ::= { docsIfCmtsCmStatusTable 1 } DocsIfCmtsCmStatusEntry ::= SEQUENCE { docsIfCmtsCmStatusIndex Integer32, docsIfCmtsCmStatusMacAddress MacAddress, docsIfCmtsCmStatusIpAddress IpAddress, -- deprecated docsIfCmtsCmStatusDownChannelIfIndex InterfaceIndexOrZero, docsIfCmtsCmStatusUpChannelIfIndex InterfaceIndexOrZero, docsIfCmtsCmStatusRxPower TenthdBmV, docsIfCmtsCmStatusTimingOffset Unsigned32, docsIfCmtsCmStatusEqualizationData OCTET STRING, docsIfCmtsCmStatusValue INTEGER, docsIfCmtsCmStatusUnerroreds Counter32, docsIfCmtsCmStatusCorrecteds Counter32, docsIfCmtsCmStatusUncorrectables Counter32, Raftus/Cardona Expires January 2005 [Page 65] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsCmStatusSignalNoise TenthdB, docsIfCmtsCmStatusMicroreflections Integer32, docsIfCmtsCmStatusExtUnerroreds Counter64, docsIfCmtsCmStatusExtCorrecteds Counter64, docsIfCmtsCmStatusExtUncorrectables Counter64, docsIfCmtsCmStatusDocsisRegMode DocsisQosVersion, docsIfCmtsCmStatusModulationType DocsisUpstreamTypeStatus, docsIfCmtsCmStatusInetAddressType InetAddressType, docsIfCmtsCmStatusInetAddress InetAddress, docsIfCmtsCmStatusValueLastUpdate TimeStamp, docsIfCmtsCmStatusHighResolutionTimingOffset Unsigned32 } docsIfCmtsCmStatusIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "Index value to uniquely identify an entry in this table. For an individual Cable Modem, this index value SHOULD not change during CMTS uptime." ::= { docsIfCmtsCmStatusEntry 1 } docsIfCmtsCmStatusMacAddress OBJECT-TYPE SYNTAX MacAddress MAX-ACCESS read-only STATUS current DESCRIPTION "MAC address of this Cable Modem. If the Cable Modem has multiple MAC addresses, this is the MAC address associated with the Cable interface." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 8.2.2." ::= { docsIfCmtsCmStatusEntry 2 } docsIfCmtsCmStatusIpAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS deprecated DESCRIPTION "IP address of this Cable Modem. If the Cable Modem has no IP address assigned, or the IP address is unknown, this object returns a value of 0.0.0.0. If the Cable Modem has multiple IP addresses, this object returns the IP address associated with the Cable interface. This object has been deprecated and replaced by docsIfCmtsCmStatusInetAddressType and docsIfCmtsCmStatusInetAddress, to enable IPv6 addressing Raftus/Cardona Expires January 2005 [Page 66] Internet Draft DOCSIS RF Interface MIB July 2004 in the future." ::= { docsIfCmtsCmStatusEntry 3 } docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "IfIndex of the downstream channel this CM is connected to. If the downstream channel is unknown, this object returns a value of zero." ::= { docsIfCmtsCmStatusEntry 4 } docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "For DOCSIS 2.0, indicates the ifIndex of the logical upstream channel (ifType 205) this CM is connected to. For DOCSIS 1.x, indicates the ifIndex of the upstream channel (ifType 129) this CM is connected to. If the upstream channel is unknown, this object returns a value of zero." ::= { docsIfCmtsCmStatusEntry 5 } docsIfCmtsCmStatusRxPower OBJECT-TYPE SYNTAX TenthdBmV UNITS "dBmV" MAX-ACCESS read-only STATUS current DESCRIPTION "The receive power as perceived for upstream data from this Cable Modem. If the receive power is unknown, this object returns a value of zero." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.18." ::= { docsIfCmtsCmStatusEntry 6 } docsIfCmtsCmStatusTimingOffset OBJECT-TYPE SYNTAX Unsigned32 (0..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION "A measure of the current round trip time for this CM. Used for timing of CM upstream transmissions to ensure synchronized arrivals at the CMTS. Units are in terms Raftus/Cardona Expires January 2005 [Page 67] Internet Draft DOCSIS RF Interface MIB July 2004 of (6.25 microseconds/64). Returns zero if the value is unknown. For channels requiring finer resolution, please refer to object docsIfCmtsCmStatusHighResolutionTimingOffset." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.17." ::= { docsIfCmtsCmStatusEntry 7 } docsIfCmtsCmStatusEqualizationData OBJECT-TYPE SYNTAX OCTET STRING (SIZE (0..512)) MAX-ACCESS read-only STATUS current DESCRIPTION "Equalization data for this CM. Returns an empty string if the value is unknown or if there is no equalization data available or defined." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Figure 8-23." ::= { docsIfCmtsCmStatusEntry 8 } docsIfCmtsCmStatusValue OBJECT-TYPE SYNTAX INTEGER { other(1), ranging(2), rangingAborted(3), rangingComplete(4), ipComplete(5), registrationComplete(6), accessDenied(7), operational(8), -- deprecated registeredBPIInitializing(9) } MAX-ACCESS read-only STATUS current DESCRIPTION "Current Cable Modem connectivity state, as specified in the RF Interface Specification. Returned status information is the CM status as assumed by the CMTS, and indicates the following events: other(1) Any state other than below. ranging(2) The CMTS has received an Initial Ranging Request message from the CM, and the ranging process is not yet complete. rangingAborted(3) Raftus/Cardona Expires January 2005 [Page 68] Internet Draft DOCSIS RF Interface MIB July 2004 The CMTS has sent a Ranging Abort message to the CM. rangingComplete(4) The CMTS has sent a Ranging Complete message to the CM. ipComplete(5) The CMTS has received a DHCP reply message and forwarded it to the CM. registrationComplete(6) The CMTS has sent a Registration Response message to the CM. accessDenied(7) The CMTS has sent a Registration Aborted message to the CM. operational(8) -- deprecated value This value has been deprecated in favor of the more Specific registeredBPIInitializing(9). registeredBPIInitializing(9) Baseline Privacy (BPI) is enabled and the CMTS is in the process of completing BPI initialization. This state MAY last for a significant length of time if failures occur during the initialization process. After completion of BPI initialization, the CMTS will report registrationComplete(6). The CMTS only needs to report states it is able to detect." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 11.2." ::= { docsIfCmtsCmStatusEntry 9 } docsIfCmtsCmStatusUnerroreds OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received without error from this Cable Modem. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.4." ::= { docsIfCmtsCmStatusEntry 10 } docsIfCmtsCmStatusCorrecteds OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current Raftus/Cardona Expires January 2005 [Page 69] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "Codewords received with correctable errors from this Cable Modem. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.4." ::= { docsIfCmtsCmStatusEntry 11 } docsIfCmtsCmStatusUncorrectables OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received with uncorrectable errors from this Cable Modem. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.4." ::= { docsIfCmtsCmStatusEntry 12 } docsIfCmtsCmStatusSignalNoise OBJECT-TYPE SYNTAX TenthdB UNITS "dB" MAX-ACCESS read-only STATUS current DESCRIPTION "Signal/Noise ratio as perceived for upstream data from this Cable Modem. If the Signal/Noise is unknown, this object returns a value of zero." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 4-1 and 4-2." ::= { docsIfCmtsCmStatusEntry 13 } docsIfCmtsCmStatusMicroreflections OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "dBc" MAX-ACCESS read-only Raftus/Cardona Expires January 2005 [Page 70] Internet Draft DOCSIS RF Interface MIB July 2004 STATUS current DESCRIPTION "Total microreflections including in-channel response as perceived on this interface, measured in dBc below the signal level. This object is not assumed to return an absolutely accurate value, but SHOULD give a rough indication of microreflections received on this interface. It is up to the implementer to provide information as accurate as possible. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 4-1 and 4-2" ::= { docsIfCmtsCmStatusEntry 14 } docsIfCmtsCmStatusExtUnerroreds OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received without error from this Cable Modem. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.5." ::= { docsIfCmtsCmStatusEntry 15 } docsIfCmtsCmStatusExtCorrecteds OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received with correctable errors from this Cable Modem. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Raftus/Cardona Expires January 2005 [Page 71] Internet Draft DOCSIS RF Interface MIB July 2004 Section 6.2.5." ::= { docsIfCmtsCmStatusEntry 16 } docsIfCmtsCmStatusExtUncorrectables OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "Codewords received with uncorrectable errors from this Cable Modem. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.5." ::= { docsIfCmtsCmStatusEntry 17 } docsIfCmtsCmStatusDocsisRegMode OBJECT-TYPE SYNTAX DocsisQosVersion MAX-ACCESS read-only STATUS current DESCRIPTION "Indication whether the CM has registered using 1.0 Class of Service or 1.1 Quality of Service." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Annex G." ::= { docsIfCmtsCmStatusEntry 18 } docsIfCmtsCmStatusModulationType OBJECT-TYPE SYNTAX DocsisUpstreamTypeStatus MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates modulation type currently used by the CM. Since this object specifically identifies PHY mode, the shared type is not permitted. If the upstream channel is unknown, this object returns a value of zero." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 8-19." ::= { docsIfCmtsCmStatusEntry 19 } docsIfCmtsCmStatusInetAddressType OBJECT-TYPE SYNTAX InetAddressType Raftus/Cardona Expires January 2005 [Page 72] Internet Draft DOCSIS RF Interface MIB July 2004 MAX-ACCESS read-only STATUS current DESCRIPTION "The type of internet address of docsIfCmtsCmStatusInetAddress. If the cable modem Internet address is unassigned or unknown, then the value of this object is unknown(0)." ::= { docsIfCmtsCmStatusEntry 20 } docsIfCmtsCmStatusInetAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION "Internet address of this Cable Modem. If the Cable Modem has no Internet address assigned, or the Internet address is unknown, the value of this object is the empty string. If the Cable Modem has multiple Internet addresses, this object returns the Internet address associated with the Cable (i.e. RF MAC) interface." ::= { docsIfCmtsCmStatusEntry 21 } docsIfCmtsCmStatusValueLastUpdate OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime when docsIfCmtsCmStatusValue was last updated." ::= { docsIfCmtsCmStatusEntry 22 } docsIfCmtsCmStatusHighResolutionTimingOffset OBJECT-TYPE SYNTAX Unsigned32 (0..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION "A measure of the current round trip time for this CM. Used for timing of CM upstream transmissions to ensure synchronized arrivals at the CMTS. Units are in terms of (6.25 microseconds/(64*256)). Returns zero if the value is unknown. This is the high resolution version of object docsIfCmtsCmStatusTimingOffset, for channels requiring finer resolution." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Section 6.2.17." ::= { docsIfCmtsCmStatusEntry 23 } Raftus/Cardona Expires January 2005 [Page 73] Internet Draft DOCSIS RF Interface MIB July 2004 -- -- The CMTS Service Table. -- docsIfCmtsServiceTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsServiceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes the attributes of upstream service queues in a Cable Modem Termination System." ::= { docsIfCmtsObjects 4 } docsIfCmtsServiceEntry OBJECT-TYPE SYNTAX DocsIfCmtsServiceEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes the attributes of a single upstream bandwidth service queue. Entries in this table exist for each ifEntry with an ifType of docsCableMaclayer(127), and for each service queue (Service ID) within this MAC layer. Entries in this table are created with the creation of individual Service IDs by the MAC layer and removed when a Service ID is removed." INDEX { ifIndex, docsIfCmtsServiceId } ::= { docsIfCmtsServiceTable 1 } DocsIfCmtsServiceEntry ::= SEQUENCE { docsIfCmtsServiceId Integer32, docsIfCmtsServiceCmStatusIndex Integer32, -- deprecated docsIfCmtsServiceAdminStatus INTEGER, docsIfCmtsServiceQosProfile Integer32, docsIfCmtsServiceCreateTime TimeStamp, docsIfCmtsServiceInOctets Counter32, docsIfCmtsServiceInPackets Counter32, docsIfCmtsServiceNewCmStatusIndex Integer32 } docsIfCmtsServiceId OBJECT-TYPE SYNTAX Integer32 (1..16383) MAX-ACCESS not-accessible STATUS current DESCRIPTION "Identifies a service queue for upstream bandwidth. The attributes of this service queue are shared between the Cable Modem and the Cable Modem Termination System. The CMTS allocates upstream bandwidth to this service queue based on requests from the CM and on the class of Raftus/Cardona Expires January 2005 [Page 74] Internet Draft DOCSIS RF Interface MIB July 2004 service associated with this queue." ::= { docsIfCmtsServiceEntry 1 } docsIfCmtsServiceCmStatusIndex OBJECT-TYPE SYNTAX Integer32 (0..65535) MAX-ACCESS read-only STATUS deprecated DESCRIPTION "Pointer to an entry in docsIfCmtsCmStatusTable identifying the Cable Modem using this Service Queue. If multiple Cable Modems are using this Service Queue, the value of this object is zero. This object has been deprecated and replaced by docsIfCmtsServiceNewCmStatusIndex, to fix a mismatch of the value range with respect to docsIfCmtsCmStatusIndex (1..2147483647)." ::= { docsIfCmtsServiceEntry 2 } docsIfCmtsServiceAdminStatus OBJECT-TYPE SYNTAX INTEGER { enabled(1), disabled(2), destroyed(3) } MAX-ACCESS read-write STATUS current DESCRIPTION "Allows a service class for a particular modem to be suppressed, (re-)enabled, or deleted altogether." ::= { docsIfCmtsServiceEntry 3 } docsIfCmtsServiceQosProfile OBJECT-TYPE SYNTAX Integer32 (0..16383) MAX-ACCESS read-only STATUS current DESCRIPTION "The index in docsIfQosProfileTable describing the quality of service attributes associated with this particular service. If no associated docsIfQosProfileTable entry exists, this object returns a value of zero." ::= { docsIfCmtsServiceEntry 4 } docsIfCmtsServiceCreateTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime when this entry was created." ::= { docsIfCmtsServiceEntry 5 } docsIfCmtsServiceInOctets OBJECT-TYPE Raftus/Cardona Expires January 2005 [Page 75] Internet Draft DOCSIS RF Interface MIB July 2004 SYNTAX Counter32 UNITS "Bytes" MAX-ACCESS read-only STATUS current DESCRIPTION "The cumulative number of Packet Data octets received on this Service ID. The count does not include the size of the Cable MAC header. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsServiceEntry 6 } docsIfCmtsServiceInPackets OBJECT-TYPE SYNTAX Counter32 UNITS "packets" MAX-ACCESS read-only STATUS current DESCRIPTION "The cumulative number of Packet Data packets received on this Service ID. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsServiceEntry 7 } docsIfCmtsServiceNewCmStatusIndex OBJECT-TYPE SYNTAX Integer32 (0..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "Pointer (via docsIfCmtsCmStatusIndex) to an entry in docsIfCmtsCmStatusTable identifying the Cable Modem using this Service Queue. If multiple Cable Modems are using this Service Queue, the value of this object is zero." ::= { docsIfCmtsServiceEntry 8 } -- -- The following table provides upstream channel modulation profiles. -- Entries in this table can be -- re-used by one or more upstream channels. An upstream channel will -- have a modulation profile -- for each value of docsIfModIntervalUsageCode. -- docsIfCmtsModulationTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsModulationEntry Raftus/Cardona Expires January 2005 [Page 76] Internet Draft DOCSIS RF Interface MIB July 2004 MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes a modulation profile associated with one or more upstream channels." ::= { docsIfCmtsObjects 5 } docsIfCmtsModulationEntry OBJECT-TYPE SYNTAX DocsIfCmtsModulationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes a modulation profile for an Interval Usage Code for one or more upstream channels. Entries in this table are created by the operator. Initial default entries MAY be created at system initialization time which could report a value 'permanent' or 'readOnly' for docsIfCmtsModStorageType. A CMTS MAY reject the creation of additional Interval Usage Codes for a modulation profile being defined at Initialization time. No individual objects have to be specified in order to create an entry in this table. Note that some objects do not have DEFVAL clauses, but do have calculated defaults and need not be specified during row creation. There is no restriction on the changing of values in this table while their associated rows are active with the exception of: 1. If a modulation profile is being referenced by one or more upstream channels, an attempt to set the value of docsIfCmtsModChannelType returns 'inconsistentValue' error. 2. If a modulation profile is being referenced by one or more upstream channels, an attempt to set docsIfCmtsModControl to destroy(6) or notInService(2) returns 'inconsistentValue' error." INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode} ::= { docsIfCmtsModulationTable 1 } DocsIfCmtsModulationEntry ::= SEQUENCE { docsIfCmtsModIndex Integer32, docsIfCmtsModIntervalUsageCode INTEGER, docsIfCmtsModControl RowStatus, docsIfCmtsModType INTEGER, docsIfCmtsModPreambleLen Integer32, Raftus/Cardona Expires January 2005 [Page 77] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsModDifferentialEncoding TruthValue, docsIfCmtsModFECErrorCorrection Integer32, docsIfCmtsModFECCodewordLength Integer32, docsIfCmtsModScramblerSeed Integer32, docsIfCmtsModMaxBurstSize Integer32, docsIfCmtsModGuardTimeSize Unsigned32, docsIfCmtsModLastCodewordShortened TruthValue, docsIfCmtsModScrambler TruthValue, docsIfCmtsModByteInterleaverDepth Unsigned32, docsIfCmtsModByteInterleaverBlockSize Unsigned32, docsIfCmtsModPreambleType INTEGER, docsIfCmtsModTcmErrorCorrectionOn TruthValue, docsIfCmtsModScdmaInterleaverStepSize Unsigned32, docsIfCmtsModScdmaSpreaderEnable TruthValue, docsIfCmtsModScdmaSubframeCodes Unsigned32, docsIfCmtsModChannelType DocsisUpstreamType, docsIfCmtsModStorageType StorageType } docsIfCmtsModIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index into the Channel Modulation table representing a group of Interval Usage Codes, all associated with the same channel." ::= { docsIfCmtsModulationEntry 1 } docsIfCmtsModIntervalUsageCode OBJECT-TYPE SYNTAX INTEGER { request(1), requestData(2), initialRanging(3), periodicRanging(4), shortData(5), longData(6), advPhyShortData(9), advPhyLongData(10), ugs(11) } MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index into the Channel Modulation table which, when grouped with other Interval Usage Codes, fully instantiate all modulation sets for a given upstream channel." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Raftus/Cardona Expires January 2005 [Page 78] Internet Draft DOCSIS RF Interface MIB July 2004 Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 8-20." ::= { docsIfCmtsModulationEntry 2 } docsIfCmtsModControl OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "Controls and reflects the status of rows in this table." ::= { docsIfCmtsModulationEntry 3 } docsIfCmtsModType OBJECT-TYPE SYNTAX INTEGER { other(1), qpsk(2), qam16(3), qam8(4), qam32(5), qam64(6), qam128(7) } MAX-ACCESS read-create STATUS current DESCRIPTION "The modulation type used on this channel. Returns other(1) if the modulation type is neither qpsk, qam16, qam8, qam32, qam64 or qam128. Type qam128 is used for SCDMA channels only. See the reference for the modulation profiles implied by different modulation types." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { qpsk } ::= { docsIfCmtsModulationEntry 4 } docsIfCmtsModPreambleLen OBJECT-TYPE SYNTAX Integer32 (0..1536) UNITS "bits" MAX-ACCESS read-create STATUS current DESCRIPTION "The preamble length for this modulation profile in bits. Default value is the minimum needed by the implementation at the CMTS for the given modulation profile." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Raftus/Cardona Expires January 2005 [Page 79] Internet Draft DOCSIS RF Interface MIB July 2004 Tables 6-7, and 8-19." ::= { docsIfCmtsModulationEntry 5 } docsIfCmtsModDifferentialEncoding OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies whether or not differential encoding is used on this channel." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { false } ::= { docsIfCmtsModulationEntry 6 } docsIfCmtsModFECErrorCorrection OBJECT-TYPE SYNTAX Integer32 (0..16) UNITS "Bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "The number of correctable errored bytes (t) used in forward error correction code. The value of 0 indicates no correction is employed. The number of check bytes appended will be twice this value." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { 0 } ::= { docsIfCmtsModulationEntry 7 } docsIfCmtsModFECCodewordLength OBJECT-TYPE SYNTAX Integer32 (1..255) UNITS "Bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "The number of data bytes (k) in the forward error correction codeword. This object is not used if docsIfCmtsModFECErrorCorrection is zero." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { 32 } ::= { docsIfCmtsModulationEntry 8 } Raftus/Cardona Expires January 2005 [Page 80] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsModScramblerSeed OBJECT-TYPE SYNTAX Integer32 (0..32767) MAX-ACCESS read-create STATUS current DESCRIPTION "The 15 bit seed value for the scrambler polynomial." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 8-19." DEFVAL { 0 } ::= { docsIfCmtsModulationEntry 9 } docsIfCmtsModMaxBurstSize OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "mini-slots" MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum number of mini-slots that can be transmitted during this channel's burst time. Returns zero if the burst length is bounded by the allocation MAP rather than this profile. Default value is 0 except for shortData, where it is 8." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 8-19." ::= { docsIfCmtsModulationEntry 10 } docsIfCmtsModGuardTimeSize OBJECT-TYPE SYNTAX Unsigned32 UNITS "Symbol-times" MAX-ACCESS read-only STATUS current DESCRIPTION "The number of symbol-times which MUST follow the end of this channel's burst. Default value is the minimum time needed by the implementation for this modulation profile." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." ::= { docsIfCmtsModulationEntry 11 } docsIfCmtsModLastCodewordShortened OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current Raftus/Cardona Expires January 2005 [Page 81] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "Indicates if the last FEC codeword is truncated." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { true } ::= { docsIfCmtsModulationEntry 12 } docsIfCmtsModScrambler OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "Indicates if the scrambler is employed." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { false } ::= { docsIfCmtsModulationEntry 13 } docsIfCmtsModByteInterleaverDepth OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "ATDMA Byte Interleaver Depth (Ir). This object returns 1 for non ATDMA profiles." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { 1 } ::= { docsIfCmtsModulationEntry 14 } docsIfCmtsModByteInterleaverBlockSize OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "ATDMA Byte Interleaver Block size (Br). This object returns zero for non ATDMA profiles " REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { 18 } ::= { docsIfCmtsModulationEntry 15 } Raftus/Cardona Expires January 2005 [Page 82] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsModPreambleType OBJECT-TYPE SYNTAX INTEGER { unknown(0), qpsk0(1), qpsk1(2) } MAX-ACCESS read-create STATUS current DESCRIPTION "Preamble type for DOCSIS 2.0 bursts. The value 'unknown(0)' represents a row entry consisting only of DOCSIS 1.x bursts" REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { qpsk0 } ::= { docsIfCmtsModulationEntry 16 } docsIfCmtsModTcmErrorCorrectionOn OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "Trellis Code Modulation (TCM) On/Off. This value returns false for non S-CDMA profiles." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { false } ::= { docsIfCmtsModulationEntry 17 } docsIfCmtsModScdmaInterleaverStepSize OBJECT-TYPE SYNTAX Unsigned32 (0 | 1..32) MAX-ACCESS read-create STATUS current DESCRIPTION " S-CDMA Interleaver step size. This value returns zero for non S-CDMA profiles." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." DEFVAL { 1 } ::= { docsIfCmtsModulationEntry 18 } docsIfCmtsModScdmaSpreaderEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create Raftus/Cardona Expires January 2005 [Page 83] Internet Draft DOCSIS RF Interface MIB July 2004 STATUS current DESCRIPTION " S-CDMA spreader. This value returns false for non S-CDMA profiles. Default value for IUC 3 and 4 is OFF, for all other IUCs it is ON." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Tables 6-7, and 8-19." ::= { docsIfCmtsModulationEntry 19 } docsIfCmtsModScdmaSubframeCodes OBJECT-TYPE SYNTAX Unsigned32 (0 | 1..128) MAX-ACCESS read-create STATUS current DESCRIPTION " S-CDMA sub-frame size. This value returns zero for non S-CDMA profiles." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 6-7, and 8-19." DEFVAL { 1 } ::= { docsIfCmtsModulationEntry 20 } docsIfCmtsModChannelType OBJECT-TYPE SYNTAX DocsisUpstreamType MAX-ACCESS read-create STATUS current DESCRIPTION "Describes the modulation channel type for this modulation entry. All the active entries in a modulation profile (ie all active entries that share a common docsIfCmtsModIndex) MUST have the same value of docsIfCmtsModChannelType." REFERENCE "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407, Table 8-19." DEFVAL { tdma } ::= { docsIfCmtsModulationEntry 21 } docsIfCmtsModStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-only STATUS current DESCRIPTION "The storage type for this conceptual row." DEFVAL { nonVolatile } ::= { docsIfCmtsModulationEntry 22 } Raftus/Cardona Expires January 2005 [Page 84] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsQosProfilePermissions OBJECT-TYPE SYNTAX BITS { createByManagement(0), updateByManagement(1), createByModems(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "This object specifies permitted methods of creating entries in docsIfQosProfileTable. CreateByManagement(0) is set if entries can be created using SNMP. UpdateByManagement(1) is set if updating entries using SNMP is permitted. CreateByModems(2) is set if entries can be created based on information in REG-REQ MAC messages received from Cable Modems. Information in this object is only applicable if docsIfQosProfileTable is implemented as read-create. Otherwise, this object is implemented as read-only and returns CreateByModems(2). Either CreateByManagement(0) or CreateByModems(1) MUST be set when writing to this object. Note that BITS objects are encoded most significant bit first. For example, if bit 2 is set, the value of this object is the octet string '20'H." ::= { docsIfCmtsObjects 6 } docsIfCmtsMacToCmTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsMacToCmEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This is a table to provide a quick access index into the docsIfCmtsCmStatusTable. There is exactly one row in this table for each row in the docsIfCmtsCmStatusTable. In general, the management station SHOULD use this table only to get a pointer into the docsIfCmtsCmStatusTable (which corresponds to the CM's RF interface MAC address), and SHOULD not iterate (e.g. GetNext through) this table." ::= { docsIfCmtsObjects 7 } docsIfCmtsMacToCmEntry OBJECT-TYPE SYNTAX DocsIfCmtsMacToCmEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A row in the docsIfCmtsMacToCmTable. An entry in this table exists for each Cable Modem that is connected to the CMTS implementing this table." Raftus/Cardona Expires January 2005 [Page 85] Internet Draft DOCSIS RF Interface MIB July 2004 INDEX { docsIfCmtsCmMac } ::= {docsIfCmtsMacToCmTable 1 } DocsIfCmtsMacToCmEntry ::= SEQUENCE { docsIfCmtsCmMac MacAddress, docsIfCmtsCmPtr Integer32 } docsIfCmtsCmMac OBJECT-TYPE SYNTAX MacAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The RF side MAC address for the referenced CM. (E.g. the interface on the CM that has docsCableMacLayer(127) as its ifType." ::= { docsIfCmtsMacToCmEntry 1 } docsIfCmtsCmPtr OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS read-only STATUS current DESCRIPTION "An row index into docsIfCmtsCmStatusTable. When queried with the correct instance value (e.g. a CM's MAC address), returns the index in docsIfCmtsCmStatusTable which represents that CM." ::= { docsIfCmtsMacToCmEntry 2 } -- The following independent object and associated table provide -- operators with a mechanism to evaluate the load/utilization of -- both upstream and downstream physical channels. This information -- may be used for capacity planning and incident analysis, and may -- be particularly helpful in provisioning of high value QOS. -- -- Utilization is expressed as an index representing the calculated -- percentage utilization of the upstream or downstream channel in -- the most recent sampling interval (ie. utilization interval). -- Refer to the DESCRIPTION field of the docsIfCmtsChannelUtUtilization -- object for definitions and calculation details. docsIfCmtsChannelUtilizationInterval OBJECT-TYPE SYNTAX Integer32 (0..86400) UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "The time interval in seconds over which the channel utilization index is calculated. All upstream/downstream channels use the same Raftus/Cardona Expires January 2005 [Page 86] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsChannelUtilizationInterval. Setting a value of zero disables utilization reporting. A channel utilization index is calculated over a fixed window applying to the most recent docsIfCmtsChannelUtilizationInterval. It would therefore be prudent to use a relatively short docsIfCmtsChannelUtilizationInterval. It is a vendor decision whether to reset the timer when docsIfCmtsChannelUtilizationInterval is changed during a utilization sampling period." ::= { docsIfCmtsObjects 8 } docsIfCmtsChannelUtilizationTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsChannelUtilizationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Reports utilization statistics for attached upstream and downstream physical channels." ::= { docsIfCmtsObjects 9 } docsIfCmtsChannelUtilizationEntry OBJECT-TYPE SYNTAX DocsIfCmtsChannelUtilizationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Utilization statistics for a single upstream or downstream physical channel. An entry exists in this table for each ifEntry with an ifType equal to docsCableDownstreamInterface (128) or docsCableUpstreamInterface (129)." INDEX { ifIndex, docsIfCmtsChannelUtIfType, docsIfCmtsChannelUtId } ::= { docsIfCmtsChannelUtilizationTable 1 } DocsIfCmtsChannelUtilizationEntry ::= SEQUENCE { docsIfCmtsChannelUtIfType IANAifType, docsIfCmtsChannelUtId Integer32, docsIfCmtsChannelUtUtilization Integer32 } docsIfCmtsChannelUtIfType OBJECT-TYPE SYNTAX IANAifType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The secondary index into this table. Indicates the IANA interface type associated with this physical channel. Only docsCableDownstreamInterface (128) and docsCableUpstreamInterface (129) are valid." Raftus/Cardona Expires January 2005 [Page 87] Internet Draft DOCSIS RF Interface MIB July 2004 ::= { docsIfCmtsChannelUtilizationEntry 1 } docsIfCmtsChannelUtId OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The tertiary index into this table. Indicates the CMTS identifier for this physical channel." ::= { docsIfCmtsChannelUtilizationEntry 2 } docsIfCmtsChannelUtUtilization OBJECT-TYPE SYNTAX Integer32 (0..100) UNITS "percent" MAX-ACCESS read-only STATUS current DESCRIPTION "The calculated and truncated utilization index for this physical upstream or downstream channel, accurate as of the most recent docsIfCmtsChannelUtilizationInterval. Upstream Channel Utilization Index: The upstream channel utilization index is expressed as a percentage of mini-slots utilized on the physical channel, regardless of burst type. For an Initial Maintenance region, the mini-slots for the complete region are considered utilized if the CMTS received an upstream burst within the region from any CM on the physical channel. For contention REQ and REQ/DATA regions, the mini-slots for a transmission opportunity within the region are considered utilized if the CMTS received an upstream burst within the opportunity from any CM on the physical channel. For all other regions, utilized mini-slots are those in which the CMTS granted bandwidth to any unicast SID on the physical channel. For an upstream interface that has multiple logical upstream channels enabled, the utilization index is a weighted sum of utilization indices for the logical channels. The weight for each utilization index is the percentage of upstream mini-slots allocated for the corresponding logical channel. Example: If 75% of bandwidth is allocated to the first logical channel and 25% to the second, and the utilization indices for each are 60 and 40 respectively, the utilization index for the upstream physical channel is (60 * 0.75) + (40 * 0.25) = 55. This figure applies to the most recent utilization interval. Raftus/Cardona Expires January 2005 [Page 88] Internet Draft DOCSIS RF Interface MIB July 2004 Downstream Channel Utilization Index: The downstream channel utilization index is a percentage expressing the ratio between bytes used to transmit data versus the total number of bytes transmitted in the raw bandwidth of the MPEG channel. As with the upstream utilization index, the calculated value represents the most recent utilization interval. Formula: Downstream utilization index = (100 * (data bytes / raw bytes)) Definitions: Data bytes: Number of bytes transmitted as data in the docsIfCmtsChannelUtilizationInterval. Identical to docsIfCmtsDownChannelCtrUsed Bytes measured over the utilization interval. Raw bandwidth: Total number of bytes available for transmitting data, not including bytes used for headers and other overhead. Raw bytes: (raw bandwidth * docsIfCmtsChannelUtilizationInterval). Identical to docsIfCmtsDownChannelCtrTotal Bytes measured over the utilization interval." ::= { docsIfCmtsChannelUtilizationEntry 3 } -- The following table provides operators with input data appropriate -- for calculating downstream channel utilization. Operators may use -- the docsIfCmtsChannelUtilizationTable, or perform their own polling -- of the docsIfCmtsDownChannelCounterTable objects to characterize -- their downstream channel usage. The 32 bit counter objects are -- included to provide backward compatibility with SNMPv1 managers, -- which cannot access 64 bit counter objects. docsIfCmtsDownChannelCounterTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsDownChannelCounterEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table is implemented at the CMTS to collect downstream channel statistics for utilization calculations." ::= { docsIfCmtsObjects 10 } docsIfCmtsDownChannelCounterEntry OBJECT-TYPE SYNTAX DocsIfCmtsDownChannelCounterEntry MAX-ACCESS not-accessible STATUS current Raftus/Cardona Expires January 2005 [Page 89] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "An entry provides a list of traffic counters for a single downstream channel. An entry in this table exists for each ifEntry with an ifType of docsCableDownstream(128)." INDEX { ifIndex } ::= { docsIfCmtsDownChannelCounterTable 1 } DocsIfCmtsDownChannelCounterEntry ::= SEQUENCE { docsIfCmtsDownChnlCtrId Integer32, docsIfCmtsDownChnlCtrTotalBytes Counter32, docsIfCmtsDownChnlCtrUsedBytes Counter32, docsIfCmtsDownChnlCtrExtTotalBytes Counter64, docsIfCmtsDownChnlCtrExtUsedBytes Counter64 } docsIfCmtsDownChnlCtrId OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The Cable Modem Termination System (CMTS) identification of the downstream channel within this particular MAC interface. If the interface is down, the object returns the most current value. If the downstream channel ID is unknown, this object returns a value of 0." ::= { docsIfCmtsDownChannelCounterEntry 1 } docsIfCmtsDownChnlCtrTotalBytes OBJECT-TYPE SYNTAX Counter32 UNITS "Bytes" MAX-ACCESS read-only STATUS current DESCRIPTION "At the CMTS, the total number of bytes in the Payload portion of MPEG Packets (ie. not including MPEG header or pointer_field) transported by this downstream channel since CMTS initialization. This is the 32 bit version of docsIfCmtsDownChnlCtrExtTotalBytes, included to provide back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsDownChannelCounterEntry 2 } docsIfCmtsDownChnlCtrUsedBytes OBJECT-TYPE SYNTAX Counter32 UNITS "Bytes" MAX-ACCESS read-only Raftus/Cardona Expires January 2005 [Page 90] Internet Draft DOCSIS RF Interface MIB July 2004 STATUS current DESCRIPTION "At the CMTS, the total number of DOCSIS data bytes transported by this downstream channel since CMTS initialization. The number of data bytes is defined as the total number of bytes transported in DOCSIS payloads minus the number of stuff bytes transported in DOCSIS payloads. This is the 32 bit version of docsIfCmtsDownChnlCtrExtUsedBytes, included to provide back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsDownChannelCounterEntry 3 } docsIfCmtsDownChnlCtrExtTotalBytes OBJECT-TYPE SYNTAX Counter64 UNITS "Bytes" MAX-ACCESS read-only STATUS current DESCRIPTION "At the CMTS, the total number of bytes in the Payload portion of MPEG Packets (ie. not including MPEG header or pointer_field) transported by this downstream channel since CMTS initialization. This is the 64 bit version of docsIfCmtsDownChnlCtrTotalBytes, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsDownChannelCounterEntry 4 } docsIfCmtsDownChnlCtrExtUsedBytes OBJECT-TYPE SYNTAX Counter64 UNITS "Bytes" MAX-ACCESS read-only STATUS current DESCRIPTION "At the CMTS, the total number of DOCSIS data bytes transported by this downstream channel since CMTS initialization. The number of data bytes is defined as the total number of bytes transported in DOCSIS payloads minus the number of stuff bytes transported in DOCSIS payloads. This is the 64 bit version of docsIfCmtsDownChnlCtrUsedBytes, and will not be accessible to SNMPv1 managers. Raftus/Cardona Expires January 2005 [Page 91] Internet Draft DOCSIS RF Interface MIB July 2004 Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsDownChannelCounterEntry 5 } -- The following table provides operators with input data appropriate -- for calculating upstream channel utilization, and for determining -- the traffic characteristics of upstream channels. Operators may use -- the docsIfCmtsChannelUtilizationTable, or perform their own polling -- of the docsIfCmtsUpChannelCounterTable objects for utilization -- determination. -- The first four 32 and 64 objects in this table are mandatory. -- Vendors may choose to implement the remaining optional objects to -- provide operators with finer characterization of upstream channel -- traffic patterns. The 32 bit counter objects are included to provide -- backward compatibility with SNMPv1 managers, which cannot access 64 -- bit counter objects. docsIfCmtsUpChannelCounterTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsIfCmtsUpChannelCounterEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table is implemented at the CMTS to provide upstream channel statistics appropriate for channel utilization calculations." ::= { docsIfCmtsObjects 11 } docsIfCmtsUpChannelCounterEntry OBJECT-TYPE SYNTAX DocsIfCmtsUpChannelCounterEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "List of traffic statistics for a single upstream channel. For DOCSIS 2.0 CMTSs, an entry in this table exists for each ifEntry with an ifType of docsCableUpstreamChannel (205). For DOCSIS 1.x CMTSs, an entry in this table exists for each ifEntry with an ifType of docsCableUpstreamInterface (129)." INDEX { ifIndex } ::= { docsIfCmtsUpChannelCounterTable 1 } DocsIfCmtsUpChannelCounterEntry ::= SEQUENCE { docsIfCmtsUpChnlCtrId Integer32, docsIfCmtsUpChnlCtrTotalMslots Counter32, docsIfCmtsUpChnlCtrUcastGrantedMslots Counter32, docsIfCmtsUpChnlCtrTotalCntnMslots Counter32, Raftus/Cardona Expires January 2005 [Page 92] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsUpChnlCtrUsedCntnMslots Counter32, docsIfCmtsUpChnlCtrExtTotalMslots Counter64, docsIfCmtsUpChnlCtrExtUcastGrantedMslots Counter64, docsIfCmtsUpChnlCtrExtTotalCntnMslots Counter64, docsIfCmtsUpChnlCtrExtUsedCntnMslots Counter64, docsIfCmtsUpChnlCtrCollCntnMslots Counter32, docsIfCmtsUpChnlCtrTotalCntnReqMslots Counter32, docsIfCmtsUpChnlCtrUsedCntnReqMslots Counter32, docsIfCmtsUpChnlCtrCollCntnReqMslots Counter32, docsIfCmtsUpChnlCtrTotalCntnReqDataMslots Counter32, docsIfCmtsUpChnlCtrUsedCntnReqDataMslots Counter32, docsIfCmtsUpChnlCtrCollCntnReqDataMslots Counter32, docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots Counter32, docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots Counter32, docsIfCmtsUpChnlCtrCollCntnInitMaintMslots Counter32, docsIfCmtsUpChnlCtrExtCollCntnMslots Counter64, docsIfCmtsUpChnlCtrExtTotalCntnReqMslots Counter64, docsIfCmtsUpChnlCtrExtUsedCntnReqMslots Counter64, docsIfCmtsUpChnlCtrExtCollCntnReqMslots Counter64, docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots Counter64, docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots Counter64, docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots Counter64, docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots Counter64, docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots Counter64, docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots Counter64 } docsIfCmtsUpChnlCtrId OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "The CMTS identification of the upstream channel." ::= { docsIfCmtsUpChannelCounterEntry 1 } docsIfCmtsUpChnlCtrTotalMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of all mini-slots defined for this upstream logical channel. This count includes all IUCs and SIDs, even those allocated to the NULL SID for a 2.0 logical channel which is inactive. This is the 32 bit version of docsIfCmtsUpChnlCtrExtTotalMslots and is included for back compatibility with SNMPv1 managers. Support for this object is mandatory. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other Raftus/Cardona Expires January 2005 [Page 93] Internet Draft DOCSIS RF Interface MIB July 2004 times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 2 } docsIfCmtsUpChnlCtrUcastGrantedMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of unicast granted mini-slots on the upstream logical channel, regardless of burst type. Unicast granted mini-slots are those in which the CMTS assigned bandwidth to any unicast SID on the logical channel. However this object does not include minis-lots for reserved IUCs, or grants to SIDs designated as meaning 'no CM'. This is the 32 bit version of docsIfCmtsUpChnlCtrExtUcastGrantedMslots, and is included for back compatibility with SNMPv1 managers. Support for this object is mandatory. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 3 } docsIfCmtsUpChnlCtrTotalCntnMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention mini-slots defined for this upstream logical channel. This count includes all mini-slots assigned to a broadcast or multicast SID on the logical channel. This is the 32 bit version of docsIfCmtsUpChnlCtrExtTotalCntnMslots, and is included for back compatibility with SNMPv1 managers. Support for this object is mandatory. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 4 } docsIfCmtsUpChnlCtrUsedCntnMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current Raftus/Cardona Expires January 2005 [Page 94] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "Current count, from CMTS initialization, of contention mini-slots utilized on the upstream logical channel. For contention regions, utilized mini-slots are those in which the CMTS correctly received an upstream burst from any CM on the upstream logical channel. This is the 32 bit version of docsIfCmtsUpChnlCtrExtUsedCntnMslots, and is included for back compatibility with SNMPv1 managers. Support for this object is mandatory. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 5 } docsIfCmtsUpChnlCtrExtTotalMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of all mini-slots defined for this upstream logical channel. This count includes all IUCs and SIDs, even those allocated to the NULL SID for a 2.0 logical channel which is inactive. This is the 64 bit version of docsIfCmtsUpChnlCtrTotalMslots, and will not be accessible to SNMPv1 managers. Support for this object is mandatory. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 6 } docsIfCmtsUpChnlCtrExtUcastGrantedMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of unicast granted mini-slots on the upstream logical channel, regardless of burst type. Unicast granted mini-slots are those in which the CMTS assigned bandwidth to any unicast SID on the logical channel. However this object does not include mini-slots for reserved IUCs, or grants to SIDs designated as meaning 'no CM'. This is the 64 bit version of docsIfCmtsUpChnlCtrUcastGrantedMslots, and will not be accessible to SNMPv1 managers. Support for this object is mandatory. Raftus/Cardona Expires January 2005 [Page 95] Internet Draft DOCSIS RF Interface MIB July 2004 Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 7 } docsIfCmtsUpChnlCtrExtTotalCntnMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention mini-slots defined for this upstream logical channel. This count includes all mini-slots assigned to a broadcast or multicast SID on the logical channel. This is the 64 bit version of docsIfCmtsUpChnlCtrTotalCntnMslots, and will not be accessible to SNMPv1 managers. Support for this object is mandatory. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 8 } docsIfCmtsUpChnlCtrExtUsedCntnMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention mini-slots utilized on the upstream logical channel. For contention regions, utilized mini-slots are those in which the CMTS correctly received an upstream burst from any CM on the upstream logical channel. This is the 64 bit version of docsIfCmtsUpChnlCtrUsedCntnMslots, and will not be accessible to SNMPv1 managers. Support for this object is mandatory. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 9 } docsIfCmtsUpChnlCtrCollCntnMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current Raftus/Cardona Expires January 2005 [Page 96] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "Current count, from CMTS initialization, of contention mini-slots subjected to collisions on the upstream logical channel. For contention regions, these are the mini-slots applicable to bursts that the CMTS detected, but could not correctly receive. This is the 32 bit version of docsIfCmtsUpChnlCtrExtCollCntnMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 10 } docsIfCmtsUpChnlCtrTotalCntnReqMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request mini-slots defined for this upstream logical channel. This count includes all mini-slots for IUC1 assigned to a broadcast or multicast SID on the logical channel. This is the 32 bit version of docsIfCmtsUpChnlCtrExtTotalCntnReqMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 11 } docsIfCmtsUpChnlCtrUsedCntnReqMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request mini-slots utilized on this upstream logical channel. This count includes all contention mini-slots for IUC1 applicable to bursts that the CMTS correctly received. This is the 32 bit version of docsIfCmtsUpChnlCtrExtUsedCntnReqMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." Raftus/Cardona Expires January 2005 [Page 97] Internet Draft DOCSIS RF Interface MIB July 2004 ::= { docsIfCmtsUpChannelCounterEntry 12 } docsIfCmtsUpChnlCtrCollCntnReqMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request mini-slots subjected to collisions on this upstream logical channel. This includes all contention mini-slots for IUC1 applicable to bursts that the CMTS detected, but could not correctly receive. This is the 32 bit version of docsIfCmtsUpChnlCtrExtCollCntnReqMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 13 } docsIfCmtsUpChnlCtrTotalCntnReqDataMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request data mini-slots defined for this upstream logical channel. This count includes all mini-slots for IUC2 assigned to a broadcast or multicast SID on the logical channel. This is the 32 bit version of docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 14 } docsIfCmtsUpChnlCtrUsedCntnReqDataMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request data mini-slots utilized on this upstream logical channel. This includes all contention mini-slots for IUC2 applicable to bursts that the CMTS correctly received. Raftus/Cardona Expires January 2005 [Page 98] Internet Draft DOCSIS RF Interface MIB July 2004 This is the 32 bit version of docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 15 } docsIfCmtsUpChnlCtrCollCntnReqDataMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request data mini-slots subjected to collisions on this upstream logical channel. This includes all contention mini-slots for IUC2 applicable to bursts that the CMTS detected, but could not correctly receive. This is the 32 bit version of docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 16 } docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention initial maintenance mini-slots defined for this upstream logical channel. This includes all mini-slots for IUC3 assigned to a broadcast or multicast SID on the logical channel. This is the 32 bit version of docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 17 } docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots OBJECT-TYPE Raftus/Cardona Expires January 2005 [Page 99] Internet Draft DOCSIS RF Interface MIB July 2004 SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention initial maintenance mini-slots utilized on this upstream logical channel. This includes all contention mini-slots for IUC3 applicable to bursts that the CMTS correctly received. This is the 32 bit version of docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 18 } docsIfCmtsUpChnlCtrCollCntnInitMaintMslots OBJECT-TYPE SYNTAX Counter32 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention initial maintenance mini-slots subjected to collisions on this upstream logical channel. This includes all contention mini-slots for IUC3 applicable to bursts that the CMTS detected, but could not correctly receive. This is the 32 bit version of docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots, and is included for back compatibility with SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 19 } docsIfCmtsUpChnlCtrExtCollCntnMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of collision contention mini-slots on the upstream logical channel. For contention regions, these are the mini-slots applicable to bursts that the CMTS detected, but could not correctly receive. This is the 64 bit version of Raftus/Cardona Expires January 2005 [Page 100] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsUpChnlCtrCollCntnMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 20 } docsIfCmtsUpChnlCtrExtTotalCntnReqMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request mini-slots defined for this upstream logical channel. This count includes all mini-slots for IUC1 assigned to a broadcast or multicast SID on the logical channel. This is the 64 bit version of docsIfCmtsUpChnlCtrTotalCntnReqMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 21 } docsIfCmtsUpChnlCtrExtUsedCntnReqMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request mini-slots utilized on this upstream logical channel. This count includes all contention mini-slots for IUC1 applicable to bursts that the CMTS correctly received. This is the 64 bit version of docsIfCmtsUpChnlCtrUsedCntnReqMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 22 } docsIfCmtsUpChnlCtrExtCollCntnReqMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only Raftus/Cardona Expires January 2005 [Page 101] Internet Draft DOCSIS RF Interface MIB July 2004 STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request mini-slots subjected to collisions on this upstream logical channel. This includes all contention mini-slots for IUC1 applicable to bursts that the CMTS detected, but could not correctly receive. This is the 64 bit version of docsIfCmtsUpChnlCtrCollCntnReqMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 23 } docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request data mini-slots defined for this upstream logical channel. This count includes all mini-slots for IUC2 assigned to a broadcast or multicast SID on the logical channel. This is the 64 bit version of docsIfCmtsUpChnlCtrTotalCntnReqDataMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 24 } docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request data mini-slots utilized on this upstream logical channel. This includes all contention mini-slots for IUC2 applicable to bursts that the CMTS correctly received. This is the 64 bit version of docsIfCmtsUpChnlCtrUsedCntnReqDataMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of Raftus/Cardona Expires January 2005 [Page 102] Internet Draft DOCSIS RF Interface MIB July 2004 ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 25 } docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention request data mini-slots subjected to collisions on this upstream logical channel. This includes all contention mini-slots for IUC2 applicable to bursts that the CMTS detected, but could not correctly receive. This is the 64 bit version of docsIfCmtsUpChnlCtrCollCntnReqDataMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 26 } docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of initial maintenance mini-slots defined for this upstream logical channel. This count includes all mini-slots for IUC3 assigned to a broadcast or multicast SID on the logical channel. This is the 64 bit version of docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 27 } docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of initial maintenance mini-slots utilized on this upstream logical Raftus/Cardona Expires January 2005 [Page 103] Internet Draft DOCSIS RF Interface MIB July 2004 channel. This includes all contention mini-slots for IUC3 applicable to bursts that the CMTS correctly received. This is the 64 bit version of docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 28 } docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots OBJECT-TYPE SYNTAX Counter64 UNITS "mini-slots" MAX-ACCESS read-only STATUS current DESCRIPTION "Current count, from CMTS initialization, of contention initial maintenance mini-slots subjected to collisions on this upstream logical channel. This includes all contention mini-slots for IUC3 applicable to bursts that the CMTS detected, but could not correctly receive. This is the 64 bit version of docsIfCmtsUpChnlCtrCollCntnInitMaintMslots, and will not be accessible to SNMPv1 managers. Discontinuities in the value of this counter can occur at reinitialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the associated ifIndex." ::= { docsIfCmtsUpChannelCounterEntry 29 } -- -- notification group is for future extension. -- docsIfNotification OBJECT IDENTIFIER ::= { docsIfMib 2 } -- -- MIB Compliance statements. -- -- -- RFC 2670 Conformance definitions -- docsIfConformance OBJECT IDENTIFIER ::= { docsIfMib 3 } docsIfCompliances OBJECT IDENTIFIER ::= { docsIfConformance 1 } docsIfGroups OBJECT IDENTIFIER ::= { docsIfConformance 2 } Raftus/Cardona Expires January 2005 [Page 104] Internet Draft DOCSIS RF Interface MIB July 2004 -- -- RFC XXXX Conformance definitions -- -- ************************************************************ -- * NOTES TO RFC Editor (to be removed prior to publication) * -- * * -- * replace XXXX with the IANA assigned RFC number * -- of this document * -- * * -- ************************************************************ docsIfCompliancesV2 OBJECT IDENTIFIER ::= { docsIfConformance 3 } docsIfGroupsV2 OBJECT IDENTIFIER ::= { docsIfConformance 4 } docsIfBasicCompliance MODULE-COMPLIANCE STATUS deprecated DESCRIPTION "The compliance statement for devices that implement MCNS/DOCSIS compliant Radio Frequency Interfaces." MODULE -- docsIfMib -- unconditionally mandatory groups MANDATORY-GROUPS { docsIfBasicGroup } -- conditionally mandatory group GROUP docsIfCmGroup DESCRIPTION "This group is implemented only in Cable Modems, not in Cable Modem Termination Systems." -- conditionally mandatory group GROUP docsIfCmtsGroup DESCRIPTION "This group is implemented only in Cable Modem Termination Systems, not in Cable Modems." OBJECT docsIfDownChannelFrequency WRITE-SYNTAX Integer32 (54000000..860000000) MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems. The values above are appropriate for a cable plant using a Sub-Split channel plan. If DOCSIS is extended to cover other types of channel plans (and frequency allocations) this object will be modified accordingly." Raftus/Cardona Expires January 2005 [Page 105] Internet Draft DOCSIS RF Interface MIB July 2004 OBJECT docsIfDownChannelWidth WRITE-SYNTAX Integer32 (6000000) MIN-ACCESS read-only DESCRIPTION "It is conformant to implement this object as read-only. In Cable Modems, this object is always implemented as read-only. The above value is appropriate for cable plants running under NTSC (National Television Standards Committee) standards. If DOCSIS is extended to work with other standard (e.g. European standards), this object will be modified accordingly." OBJECT docsIfDownChannelModulation WRITE-SYNTAX INTEGER { qam64 (3), qam256 (4) } MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." OBJECT docsIfDownChannelInterleave WRITE-SYNTAX INTEGER { taps8Increment16(3), taps16Increment8(4), taps32Increment4(5), taps64Increment2(6), taps128Increment1(7) } MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." OBJECT docsIfDownChannelPower MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." OBJECT docsIfUpChannelFrequency WRITE-SYNTAX Integer32 (5000000..42000000) MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems. The values above are appropriate for a cable plant using a Sub-Split channel plan. If DOCSIS is extended to cover other types of channel plans (and frequency allocations) this object Raftus/Cardona Expires January 2005 [Page 106] Internet Draft DOCSIS RF Interface MIB July 2004 will be modified accordingly." OBJECT docsIfUpChannelWidth WRITE-SYNTAX Integer32 (200000..3200000) MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems. The above value is appropriate for cable plants running under NTSC (National Television Standards Committee) standards. If DOCSIS is extended to work with other standard (e.g. European standards), this object will be modified accordingly." OBJECT docsIfUpChannelModulationProfile MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." OBJECT docsIfUpChannelSlotSize MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfUpChannelRangingBackoffStart MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." OBJECT docsIfUpChannelRangingBackoffEnd MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." OBJECT docsIfUpChannelTxBackoffStart MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." OBJECT docsIfUpChannelTxBackoffEnd MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems; read-only in Cable Modems." Raftus/Cardona Expires January 2005 [Page 107] Internet Draft DOCSIS RF Interface MIB July 2004 OBJECT docsIfQosProfPriority MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfMaxUpBandwidth MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfGuarUpBandwidth MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfMaxDownBandwidth MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfMaxTxBurst MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfBaselinePrivacy MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfStatus MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfCmtsServiceAdminStatus Raftus/Cardona Expires January 2005 [Page 108] Internet Draft DOCSIS RF Interface MIB July 2004 MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsSyncInterval MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsUcdInterval MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsInsertInterval MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsInvitedRangingAttempts MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsQosProfilePermissions MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsModType WRITE-SYNTAX INTEGER { qpsk (2), qam16 (3) } DESCRIPTION "Management station MAY only set 16QAM or QPSK modulation, but others might be possible based on device configuration." ::= { docsIfCompliances 1 } docsIfBasicComplianceV2 MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for devices that implement MCNS/DOCSIS compliant Radio Frequency Interfaces." MODULE -- docsIfMib -- unconditionally mandatory groups Raftus/Cardona Expires January 2005 [Page 109] Internet Draft DOCSIS RF Interface MIB July 2004 MANDATORY-GROUPS { docsIfBasicGroupV2 } -- conditionally mandatory group GROUP docsIfCmGroupV2 DESCRIPTION "This group is implemented only in Cable Modems, not in Cable Modem Termination Systems." -- conditionally mandatory group GROUP docsIfCmtsGroupV2 DESCRIPTION "This group is implemented only in Cable Modem Termination Systems, not in Cable Modems." -- Optional groups GROUP docsIfCmtsOptionalGroupV2 DESCRIPTION "This group is optional for Cable Modem Termination Systems, and not applicable for Cable Modems." OBJECT docsIfDownChannelFrequency WRITE-SYNTAX Integer32 (47000000..862000000) MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems, read-only in Cable Modems. A range of 54MHz to 860MHz is appropriate for a cable plant using a North American Sub-Split channel plan. The spectrum range has been expanded to accommodate a lower edge of 47MHz and an upper edge of 862MHz for some European channel plans. If DOCSIS is extended to cover other types of channel plans (and frequency allocations) this object will be modified accordingly." OBJECT docsIfDownChannelWidth WRITE-SYNTAX Integer32 (6000000 | 8000000) MIN-ACCESS read-only DESCRIPTION "It is conformant to implement this object as read-only. In Cable Modems, this object is always implemented as read-only. The value of 6 MHz is appropriate for cable plants running under NTSC (National Television Standards Committee) standards. The value of 8 MHz is appropriate for cable plants running under ETSI standards. For other regional standards, this object will be modified accordingly." Raftus/Cardona Expires January 2005 [Page 110] Internet Draft DOCSIS RF Interface MIB July 2004 OBJECT docsIfDownChannelModulation WRITE-SYNTAX INTEGER { qam64 (3), qam256 (4) } MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfDownChannelInterleave WRITE-SYNTAX INTEGER { taps8Increment16(3), taps16Increment8(4), taps32Increment4(5), taps64Increment2(6), taps128Increment1(7), taps12increment17(8) } MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfDownChannelPower MIN-ACCESS read-only DESCRIPTION "Read-write in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelFrequency WRITE-SYNTAX Integer32 (5000000..65000000) MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems. A range of 5MHz to 42MHz is appropriate for a cable plant using a North American Sub-Split channel plan. The spectrum range has been expanded to accommodate an upper edge of 65MHz for some European channel plans. If DOCSIS is extended to cover other types of channel plans (and frequency allocations) this object will be modified accordingly." OBJECT docsIfUpChannelWidth WRITE-SYNTAX Integer32 (200000..6400000) MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, Raftus/Cardona Expires January 2005 [Page 111] Internet Draft DOCSIS RF Interface MIB July 2004 read-only in Cable Modems. The above value is appropriate for cable plants running under NTSC (National Television Standards Committee) standards. If DOCSIS is extended to work with other standard (e.g. European standards), this object will be modified accordingly." OBJECT docsIfUpChannelModulationProfile MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelSlotSize MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfUpChannelRangingBackoffStart MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelRangingBackoffEnd MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelTxBackoffStart MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelTxBackoffEnd MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelScdmaActiveCodes MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems. The number of active codes when SCDMA is in use MUST range from 64 to 128, and MUST be a non-Prime value. Raftus/Cardona Expires January 2005 [Page 112] Internet Draft DOCSIS RF Interface MIB July 2004 Providing this range allows for the following features and capabilities: 1) Power management in S-CDMA spreader-on frames (with a 3 dB spread) 2) Avoidance of code 0 3) Flexible mini-slot sizes with and without the use of code 0" OBJECT docsIfUpChannelScdmaCodesPerSlot MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelScdmaFrameSize MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelScdmaHoppingSeed MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelCloneFrom MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelUpdate MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfUpChannelStatus SYNTAX RowStatus {active(1), notReady(3)} WRITE-SYNTAX RowStatus {createAndWait(5), destroy(6)} MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems. Entries associated to upstream channels rows in ifTable only support read-only value active(1). Entries used for cloning purposes support values notReady(2), createAndWait(5) and destroy(6)." Raftus/Cardona Expires January 2005 [Page 113] Internet Draft DOCSIS RF Interface MIB July 2004 OBJECT docsIfUpChannelPreEqEnable MIN-ACCESS read-only DESCRIPTION "Read-create in Cable Modem Termination Systems, read-only in Cable Modems." OBJECT docsIfQosProfPriority MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfMaxUpBandwidth MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfGuarUpBandwidth MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfMaxDownBandwidth MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfBaselinePrivacy MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfStatus MIN-ACCESS read-only DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfQosProfMaxTransmitBurst MIN-ACCESS read-only Raftus/Cardona Expires January 2005 [Page 114] Internet Draft DOCSIS RF Interface MIB July 2004 DESCRIPTION "This object is always read-only in Cable Modems. It is compliant to implement this object as read-only in Cable Modem Termination Systems." OBJECT docsIfCmRangingTimeout MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsServiceAdminStatus MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsSyncInterval MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsUcdInterval MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsInsertInterval MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsInvitedRangingAttempts MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." OBJECT docsIfCmtsQosProfilePermissions MIN-ACCESS read-only DESCRIPTION "It is compliant to implement this object as read-only." ::= { docsIfCompliancesV2 1 } docsIfBasicGroup OBJECT-GROUP OBJECTS { docsIfDownChannelId, docsIfDownChannelFrequency, docsIfDownChannelWidth, docsIfDownChannelModulation, docsIfDownChannelInterleave, docsIfDownChannelPower, Raftus/Cardona Expires January 2005 [Page 115] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfUpChannelId, docsIfUpChannelFrequency, docsIfUpChannelWidth, docsIfUpChannelModulationProfile, docsIfUpChannelSlotSize, docsIfUpChannelTxTimingOffset, docsIfUpChannelRangingBackoffStart, docsIfUpChannelRangingBackoffEnd, docsIfUpChannelTxBackoffStart, docsIfUpChannelTxBackoffEnd, docsIfQosProfPriority, docsIfQosProfMaxUpBandwidth, docsIfQosProfGuarUpBandwidth, docsIfQosProfMaxDownBandwidth, docsIfQosProfMaxTxBurst, docsIfQosProfBaselinePrivacy, docsIfQosProfStatus, docsIfSigQIncludesContention, docsIfSigQUnerroreds, docsIfSigQCorrecteds, docsIfSigQUncorrectables, docsIfSigQSignalNoise, docsIfSigQMicroreflections, docsIfSigQEqualizationData } STATUS deprecated DESCRIPTION "Group of objects implemented in both Cable Modems and Cable Modem Termination Systems." ::= { docsIfGroups 1 } docsIfCmGroup OBJECT-GROUP OBJECTS { docsIfCmCmtsAddress, docsIfCmCapabilities, docsIfCmRangingTimeout, docsIfCmStatusValue, docsIfCmStatusCode, docsIfCmStatusTxPower, docsIfCmStatusResets, docsIfCmStatusLostSyncs, docsIfCmStatusInvalidMaps, docsIfCmStatusInvalidUcds, docsIfCmStatusInvalidRangingResponses, docsIfCmStatusInvalidRegistrationResponses, docsIfCmStatusT1Timeouts, docsIfCmStatusT2Timeouts, docsIfCmStatusT3Timeouts, docsIfCmStatusT4Timeouts, docsIfCmStatusRangingAborteds, Raftus/Cardona Expires January 2005 [Page 116] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmServiceQosProfile, docsIfCmServiceTxSlotsImmed, docsIfCmServiceTxSlotsDed, docsIfCmServiceTxRetries, docsIfCmServiceTxExceededs, docsIfCmServiceRqRetries, docsIfCmServiceRqExceededs } STATUS deprecated DESCRIPTION "Group of objects implemented in Cable Modems." ::= { docsIfGroups 2 } docsIfCmtsGroup OBJECT-GROUP OBJECTS { docsIfCmtsCapabilities, docsIfCmtsSyncInterval, docsIfCmtsUcdInterval, docsIfCmtsMaxServiceIds, docsIfCmtsInvitedRangingAttempts, docsIfCmtsInsertInterval, docsIfCmtsStatusInvalidRangeReqs, docsIfCmtsStatusRangingAborteds, docsIfCmtsStatusInvalidRegReqs, docsIfCmtsStatusFailedRegReqs, docsIfCmtsStatusInvalidDataReqs, docsIfCmtsStatusT5Timeouts, docsIfCmtsCmStatusMacAddress, docsIfCmtsCmStatusIpAddress, docsIfCmtsCmStatusDownChannelIfIndex, docsIfCmtsCmStatusUpChannelIfIndex, docsIfCmtsCmStatusRxPower, docsIfCmtsCmStatusTimingOffset, docsIfCmtsCmStatusEqualizationData, docsIfCmtsCmStatusValue, docsIfCmtsCmStatusUnerroreds, docsIfCmtsCmStatusCorrecteds, docsIfCmtsCmStatusUncorrectables, docsIfCmtsCmStatusSignalNoise, docsIfCmtsCmStatusMicroreflections, docsIfCmtsServiceCmStatusIndex, docsIfCmtsServiceAdminStatus, docsIfCmtsServiceQosProfile, docsIfCmtsServiceCreateTime, docsIfCmtsServiceInOctets, docsIfCmtsServiceInPackets, docsIfCmtsModType, docsIfCmtsModControl, docsIfCmtsModPreambleLen, docsIfCmtsModDifferentialEncoding, Raftus/Cardona Expires January 2005 [Page 117] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsModFECErrorCorrection, docsIfCmtsModFECCodewordLength, docsIfCmtsModScramblerSeed, docsIfCmtsModMaxBurstSize, docsIfCmtsModGuardTimeSize, docsIfCmtsModLastCodewordShortened, docsIfCmtsModScrambler, docsIfCmtsQosProfilePermissions, docsIfCmtsCmPtr } STATUS deprecated DESCRIPTION "Group of objects implemented in Cable Modem Termination Systems." ::= { docsIfGroups 3 } docsIfObsoleteGroup OBJECT-GROUP OBJECTS { docsIfCmRangingRespTimeout, docsIfCmtsInsertionInterval } STATUS obsolete DESCRIPTION "Group of objects obsoleted." ::= { docsIfGroups 5 } docsIfBasicGroupV2 OBJECT-GROUP OBJECTS { docsIfDownChannelId, docsIfDownChannelFrequency, docsIfDownChannelWidth, docsIfDownChannelModulation, docsIfDownChannelInterleave, docsIfDownChannelPower, docsIfDownChannelAnnex, docsIfUpChannelId, docsIfUpChannelFrequency, docsIfUpChannelWidth, docsIfUpChannelModulationProfile, docsIfUpChannelSlotSize, docsIfUpChannelTxTimingOffset, docsIfUpChannelRangingBackoffStart, docsIfUpChannelRangingBackoffEnd, docsIfUpChannelTxBackoffStart, docsIfUpChannelTxBackoffEnd, docsIfUpChannelScdmaActiveCodes, docsIfUpChannelScdmaCodesPerSlot, docsIfUpChannelScdmaFrameSize, docsIfUpChannelScdmaHoppingSeed, docsIfUpChannelType, Raftus/Cardona Expires January 2005 [Page 118] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfUpChannelCloneFrom, docsIfUpChannelUpdate, docsIfUpChannelStatus, docsIfUpChannelPreEqEnable, docsIfQosProfPriority, docsIfQosProfMaxUpBandwidth, docsIfQosProfGuarUpBandwidth, docsIfQosProfMaxDownBandwidth, docsIfQosProfBaselinePrivacy, docsIfQosProfStatus, docsIfQosProfMaxTransmitBurst, docsIfSigQIncludesContention, docsIfSigQUnerroreds, docsIfSigQCorrecteds, docsIfSigQUncorrectables, docsIfSigQSignalNoise, docsIfSigQMicroreflections, docsIfSigQEqualizationData, docsIfSigQExtUnerroreds, docsIfSigQExtCorrecteds, docsIfSigQExtUncorrectables, docsIfDocsisBaseCapability } STATUS current DESCRIPTION "Group of objects implemented in both Cable Modems and Cable Modem Termination Systems." ::= { docsIfGroupsV2 1 } docsIfCmGroupV2 OBJECT-GROUP OBJECTS { docsIfCmCmtsAddress, docsIfCmCapabilities, docsIfCmRangingTimeout, docsIfCmStatusValue, docsIfCmStatusCode, docsIfCmStatusTxPower, docsIfCmStatusResets, docsIfCmStatusLostSyncs, docsIfCmStatusInvalidMaps, docsIfCmStatusInvalidUcds, docsIfCmStatusInvalidRangingResponses, docsIfCmStatusInvalidRegistrationResponses, docsIfCmStatusT1Timeouts, docsIfCmStatusT2Timeouts, docsIfCmStatusT3Timeouts, docsIfCmStatusT4Timeouts, docsIfCmStatusRangingAborteds, docsIfCmStatusDocsisOperMode, docsIfCmStatusModulationType, Raftus/Cardona Expires January 2005 [Page 119] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmStatusEqualizationData, docsIfCmStatusUCCs, docsIfCmStatusUCCFails, docsIfCmServiceQosProfile, docsIfCmServiceTxSlotsImmed, docsIfCmServiceTxSlotsDed, docsIfCmServiceTxRetries, docsIfCmServiceTxExceededs, docsIfCmServiceRqRetries, docsIfCmServiceRqExceededs, docsIfCmServiceExtTxSlotsImmed, docsIfCmServiceExtTxSlotsDed } STATUS current DESCRIPTION "Group of objects implemented in Cable Modems." ::= { docsIfGroupsV2 2 } docsIfCmtsGroupV2 OBJECT-GROUP OBJECTS { docsIfCmtsCapabilities, docsIfCmtsSyncInterval, docsIfCmtsUcdInterval, docsIfCmtsMaxServiceIds, docsIfCmtsInvitedRangingAttempts, docsIfCmtsInsertInterval, docsIfCmtsMacStorageType, docsIfCmtsStatusInvalidRangeReqs, docsIfCmtsStatusRangingAborteds, docsIfCmtsStatusInvalidRegReqs, docsIfCmtsStatusFailedRegReqs, docsIfCmtsStatusInvalidDataReqs, docsIfCmtsStatusT5Timeouts, docsIfCmtsCmStatusMacAddress, docsIfCmtsCmStatusDownChannelIfIndex, docsIfCmtsCmStatusUpChannelIfIndex, docsIfCmtsCmStatusRxPower, docsIfCmtsCmStatusTimingOffset, docsIfCmtsCmStatusEqualizationData, docsIfCmtsCmStatusValue, docsIfCmtsCmStatusUnerroreds, docsIfCmtsCmStatusCorrecteds, docsIfCmtsCmStatusUncorrectables, docsIfCmtsCmStatusSignalNoise, docsIfCmtsCmStatusMicroreflections, docsIfCmtsCmStatusExtUnerroreds, docsIfCmtsCmStatusExtCorrecteds, docsIfCmtsCmStatusExtUncorrectables, docsIfCmtsCmStatusDocsisRegMode, Raftus/Cardona Expires January 2005 [Page 120] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfCmtsCmStatusModulationType, docsIfCmtsCmStatusInetAddressType, docsIfCmtsCmStatusInetAddress, docsIfCmtsCmStatusValueLastUpdate, docsIfCmtsCmStatusHighResolutionTimingOffset, docsIfCmtsServiceAdminStatus, docsIfCmtsServiceQosProfile, docsIfCmtsServiceCreateTime, docsIfCmtsServiceInOctets, docsIfCmtsServiceInPackets, docsIfCmtsServiceNewCmStatusIndex, docsIfCmtsModType, docsIfCmtsModControl, docsIfCmtsModPreambleLen, docsIfCmtsModDifferentialEncoding, docsIfCmtsModFECErrorCorrection, docsIfCmtsModFECCodewordLength, docsIfCmtsModScramblerSeed, docsIfCmtsModMaxBurstSize, docsIfCmtsModGuardTimeSize, docsIfCmtsModLastCodewordShortened, docsIfCmtsModScrambler, docsIfCmtsModByteInterleaverDepth, docsIfCmtsModByteInterleaverBlockSize, docsIfCmtsModPreambleType, docsIfCmtsModTcmErrorCorrectionOn, docsIfCmtsModScdmaInterleaverStepSize, docsIfCmtsModScdmaSpreaderEnable, docsIfCmtsModScdmaSubframeCodes, docsIfCmtsModChannelType, docsIfCmtsModStorageType, docsIfCmtsQosProfilePermissions, docsIfCmtsCmPtr, docsIfCmtsChannelUtilizationInterval, docsIfCmtsChannelUtUtilization, docsIfCmtsDownChnlCtrId, docsIfCmtsDownChnlCtrTotalBytes, docsIfCmtsDownChnlCtrUsedBytes, docsIfCmtsDownChnlCtrExtTotalBytes, docsIfCmtsDownChnlCtrExtUsedBytes, docsIfCmtsUpChnlCtrId, docsIfCmtsUpChnlCtrTotalMslots, docsIfCmtsUpChnlCtrUcastGrantedMslots, docsIfCmtsUpChnlCtrTotalCntnMslots, docsIfCmtsUpChnlCtrUsedCntnMslots, docsIfCmtsUpChnlCtrExtTotalMslots, docsIfCmtsUpChnlCtrExtUcastGrantedMslots, docsIfCmtsUpChnlCtrExtTotalCntnMslots, docsIfCmtsUpChnlCtrExtUsedCntnMslots, docsIfDownChannelStorageType, Raftus/Cardona Expires January 2005 [Page 121] Internet Draft DOCSIS RF Interface MIB July 2004 docsIfQosProfStorageType } STATUS current DESCRIPTION "Group of objects implemented in Cable Modem Termination Systems." ::= { docsIfGroupsV2 3 } docsIfCmtsOptionalGroupV2 OBJECT-GROUP OBJECTS { docsIfCmtsUpChnlCtrCollCntnMslots, docsIfCmtsUpChnlCtrTotalCntnReqMslots, docsIfCmtsUpChnlCtrUsedCntnReqMslots, docsIfCmtsUpChnlCtrCollCntnReqMslots, docsIfCmtsUpChnlCtrTotalCntnReqDataMslots, docsIfCmtsUpChnlCtrUsedCntnReqDataMslots, docsIfCmtsUpChnlCtrCollCntnReqDataMslots, docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots, docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots, docsIfCmtsUpChnlCtrCollCntnInitMaintMslots, docsIfCmtsUpChnlCtrExtCollCntnMslots, docsIfCmtsUpChnlCtrExtTotalCntnReqMslots, docsIfCmtsUpChnlCtrExtUsedCntnReqMslots, docsIfCmtsUpChnlCtrExtCollCntnReqMslots, docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots, docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots, docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots, docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots, docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots, docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots } STATUS current DESCRIPTION "Group of objects implemented optionally in Cable Modem Termination Systems." ::= { docsIfGroupsV2 4 } END 5. Acknowledgments This document is a production of the IPCDN working group based on Contributions from numerous members of the CableLabs DOCSIS 2.0 OSS Working Group. It is a revision of RFC 2670, "Radio Frequency (RF) Interface Management Information Base for DOCSIS compliant RF interfaces" [RFC2670]. Raftus/Cardona Expires January 2005 [Page 122] Internet Draft DOCSIS RF Interface MIB July 2004 The authors and editor wishes to express gratitude to Rich Prodan, Aviv Goren, Greg Nakanishi, Rich Woundy, Andr‰ Lejeune, Adi Shaliv, Greg White, Dan Rice, Minnie Lu, and Jean-Francois Mule for their valued advice and opinions. 6. Revision History 6.1. Scope The MIB module in this document has been developed to accommodate DOCSIS 2.0 devices and their system capabilities. The MIB module is an update to RFC 2670 with the additional incorporation of DOCSIS and Euro-DOCSIS specification requirements. 6.2. Extension We have maintained the MIB objects as defined in RFC 2670. In some cases new MIB objects have been created with identical functionality but greater capacity (i.e. 32 to 64 bits). In these situations, both the original 32 bit objects and the new 64 bit objects must be implemented. 7. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999. [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M. and S. Waldbusser, "Conformance Statements for SMIv2", RFC 2580, STD 58, April 1999. [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, June 2000. [RFC3291] Daniele, M., Haberman, B., Routhier, S., Schoenwaelder, J., "Textual Conventions for Internet Network Addresses", RFC 3291, May 2002. Raftus/Cardona Expires January 2005 [Page 123] Internet Draft DOCSIS RF Interface MIB July 2004 ************************************************************ * NOTES TO RFC Editor (to be removed prior to publication) * * * * The I-D (or a * * successor) is expected to eventually replace RFC 3291. * * If that draft (or a successor) is published as an RFC * * prior to or concurrently with this document, then the * * normative reference [RFC3291] should be updated to * * point to the replacement RFC. * * * ************************************************************ [IANA] "Protocol Numbers and Assignment Services", IANA, http://www.iana.org/assignments/ianaiftype-mib [EN 300 429] ETSI Standard EN 300 429, Version 1.2.1: Digital Video Broadcasting (DVB), Framing structure, channel coding and modulation for cable systems, April 1998. [ITU-T J83] ITU-T Recommendation J.83(4/97), "Digital multi-programme systems for television sound and data services for cable distribution.", ITU, Apr 1997, http://www.itu.int/ITU-T/studygroups/com09/ [RFI2.0] "Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification SP-RFIv2.0-I05-040407", DOCSIS 2.0, April 2004, http://www.cablemodem.com/specifications/ [ITU-T J112] Transmission Systems for Interactive Cable Television Services, Annex B,ITU-T, March 2001 [ITU-T-J122] Second-Generation Transmission Systems for Interactive Cable Television Services, J.122, ITU-T, December, 2002. 8. Informative References [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, "Introduction and Applicability Statements for Internet-Standard Management Framework", RFC 3410, December 2002. [RFI1.0] "Data-Over-Cable Service Interface Specifications: DOCSIS 1.0 Radio Frequency Interface (RFI) ANSI/SCTE 22-1 2002", http://www.scte.org/standards/. [OSSI2.0] "Data-Over-Cable Service Interface Specifications: Operations Support System Interface Specification SP-OSSIv2.0-I05-040407", DOCSIS 2.0 April 2004, Raftus/Cardona Expires January 2005 [Page 124] Internet Draft DOCSIS RF Interface MIB July 2004 http://www.cablemodem.com/specifications/ [OSSI1.1] "Data-Over-Cable Service Interface Specifications: Operations Support System Interface Specification SP-OSSIv1.1-I07-030730", DOCSIS 1.1 July 2003, http://www.cablemodem.com/specifications/ [BPI] "Data-Over-Cable Service Interface Specifications: DOCSIS 1.0 Baseline Privacy Interface Specification SCTE 22-2 2002", SCTE Data Standards Subcommittee, 2002, http://www.scte.org/standards/. [BPIPLUS] "Data-Over-Cable Service Interface Specifications: Baseline Privacy Plus Interface Specification BPI+_I11-040407", CableLabs, April 2004, http://www.cablemodem.com/specifications/ [Proakis00] Proakis, John G., "Digital Communications, 4th Edition", McGraw-Hill, New York, New York, 2000, ISBN 0-07-232111-3 9. Security Considerations This MIB module relates to a system which will provide metropolitan public internet access. As such, improper manipulation of the MIB objects represented by this MIB module may result in denial of service to a large number of end-users. There are a number of management objects defined in this MIB that have a MAX-ACCESS clause of read-write or read-create. Such objects may be considered sensitive or vulnerable in some network environments. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations. In the CM case the only read-write object is docsIfCmRangingTimeout, which if maliciously SET may not constitute a critical factor of the service degradation. The rest of the CM required MIB objects in this MIB module are read-only by the MIB definitions or by CM compliance statements, the majority of those MIB objects are controlled by the CMTS. Therefore, write access to the CMTS MIB objects may compromise the services offering as defined below. The CMTS is the controller of most of the parameters of the DOCSIS RFI Interface, These are the tables and their sensitivity/ vulnerability: o Objects in the docsIfBasicGroupv2 if SET maliciously by an attacker could result in a denial of service either by Raftus/Cardona Expires January 2005 [Page 125] Internet Draft DOCSIS RF Interface MIB July 2004 service disruption or degradation. Particularly SETs in objects of tables docsIfDownstreamChannelTable, docsIfUpstreamChannelTable, docsIfCmtsModulationTable and docsIfQosProfileTable (the last one in conjunction with MIB object docsIfCmtsQosProfilePermissions) can alter negatively the physical and link layers parameters for upstream and downstream channels. o The Object docsIfCmtsServiceAdminStatus of the docsIfCmtsGroupv2 group when SET maliciously by an attacker to 'destroyed' could interrupt temporarily a cable modem service by removing its entry in docsifCmtsServiceTable. Some of the readable objects in this MIB module (i.e., objects with a MAX-ACCESS other than not-accessible) may be considered sensitive or vulnerable in some network environments. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. These are the tables and objects and their sensitivity/vulnerability: o Read access to the MIB objects in tables docsIfCmStatusTable (CM), docsIfSignalQualityTable (CM/CMTS) and mainly CMTS tables docsIfCmtsCmStatusTable, docsIfCmtsChannelUtilizationTable, docsIfCmtsDownChannelCounterTable and docsIfCmtsUpChannelCounterTable as well as all the tables described above, could reveal information about the cable modems distribution among the upstream and downstream channels and their performance which could be used to gain access to a different tiered service offer. The table docsIfCmtsCmStatusTable also contain the MAC and IP addresses of the cable modems that cam be used of thief of service and IP spoofing. SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), even then, there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module. It is RECOMMENDED that implementers consider the security features as provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy). Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator Raftus/Cardona Expires January 2005 [Page 126] Internet Draft DOCSIS RF Interface MIB July 2004 responsibility to ensure that the SNMP entity giving access to an instance of this MIB module is properly configured to give access to the objects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them. 10. Changes from RFC 2670 Upstream now separated into 'physical interfaces' and 'logical channels'. An instance of the docsIfUpstreamChannelTable exists for each 'logical channel'. The IANA ifType for 'logical channels' is 205. The IANA ifType for 'physical interfaces' remains at 129. Object docsIfDownChannelAnnex added to docsIfDownstreamChannelTable. This object originated in the Euro-DOCSIS specifications. Nine new objects added to the docsIfUpstreamChannelTable. One describes the channel type in use. Four are specific S-CDMA parameters. Three are used in the creation of a temporary inactive upstream row so the channel parameters may be manipulated'offline'. One object has been added to enable/disable pre-equalization on the upstream channel. Object docsIfQosProfMaxTransmitBurst has been added to the docsIfQosProfileTable to replace deprecated object docsIfQosProfMaxTxBurst. This fixes a range error caused by switch to recording as bytes instead of mini-slots. Three new 64 bit counters added to the docsIfSignalQualityTable to extend the capacity of existing 32 bit counters. A new base object docsIfDocsisBaseCapability has been added which mirrors the functionality of the DOCSIS specification [OSSI2.0] defined MIB object docsIfDocsisCapability, extended to include DOCSIS 2.0. Five new objects added to the docsIfCmStatusTable. One indicates the current modulation type. The second mirrors the functionality of the DOCSIS specification [OSSI2.0] defined MIB object docsIfDocsisOperMode, while clarifying that it applies to the COS/QOS mode used by the device. The third new object indicates equalization data at the CM. Last two objects indicates total and failed UCC transactions. Two new 64 bit counters added to the docsIfCmServiceTable to extend the capacity of existing 32 bit counters. Nine new objects added to the docsIfCmtsCmStatusTable. Three are Raftus/Cardona Expires January 2005 [Page 127] Internet Draft DOCSIS RF Interface MIB July 2004 64 bit counters, two add ipv6 capability, one indicates the CM modulation type in use, one indicates the last update time for the status value, one is a high resolution of the timing offset MIB object. The remaining object mirrors the functionality of the DOCSIS specification [OSSI2.0] defined MIB object docsIfCmtsCmStatusDocsisMode, while clarifying that it applies to the COS/QOS mode used by the device. One object added to the docsIfCmtsServiceTable to fix a range error in an existing object, that has been deprecated. Eight new objects added to the docsIfCmtsModulationTable. Seven of these describe ATDMA/S-CDMA channel parameters, while the other describes modulation attributes common to all modulation types. One new object and three new tables added to provide CMTS upstream and downstream channel utilization data. Enumerated values for object docsIfDownChannelInterleave have been expanded to include a Euro-DOCSIS value. Enumerated values for object docsIfCmtsModIntervalUsageCode have been expanded to include new DOCSIS 2.0 values. Enumerated values for object docsIfCmtsModType have been expanded to include new DOCSIS 2.0 values. Compliance statements have been updated to reflect new objects and to describe Euro-DOCSIS specific implementation features. The descriptions of objects docsIfCmtsStatusInvalidRegReqs and docsIfCmtsStatusFailedRegReqs have been clarified. Separated references into normative and informative. One object added to the docsIfCmtsModulationTable to indicate storage type of the table entries to differentiate factory and user configuration. General persistence statements for read-create and read-write objects. Updated DESCRIPTION and and UNITS clauses for object docsIfSigQMicroreflections. Corrected DESCRIPTION clause of object docsIfCmStatusValue. Updated IPR Notice and Disclosure to RFC 3667 section 5.1 and RFC 3668 as well as Copyright to RFC 3667 sections 5.4 and 5.5. Raftus/Cardona Expires January 2005 [Page 128] Internet Draft DOCSIS RF Interface MIB July 2004 11. Management Interoperability of DOCSIS 1.0, 1.1 and 2.0 The MIB module contained in this document updates RFC 2670, primarily to handle the management requirements of the DOCSIS RF Interface of DOCSIS 2.0 [ITU-T-J122]. RFC 2670 contains the DOCSIS RF Interface management requirements for DOCSIS 1.0 and DOCSIS 1.1. The management requirements of Class of Service (DOCSIS 1.0) pertain to RFC 2670 are the same as this document update and are contained in tables docsIfQosProfileTable, docsIfCmServiceTable and docsIfCmtsServiceTable. DOCSIS 1.1 and DOCSIS 2.0 Quality of Service management requirements are defined in the DOCSIS management specifications [OSSI1.1] and [OSSI2.0] respectively. 12. Intellectual Property The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. 13. Author's Address David Raftus Terayon Canada Ltd Raftus/Cardona Expires January 2005 [Page 129] Internet Draft DOCSIS RF Interface MIB July 2004 340 Terry Fox Drive, Suite 202 Ottawa Ontario Canada Phone: +1 613 592 1052 ext 222 E-mail: david.raftus@terayon.com Eduardo Cardona Cable Television Laboratories, Inc. 858 Coal Creek Circle Louisville, CO 80027-9750 U.S.A. Phone: +1 303 661 9100 E-mail: e.cardona@cablelabs.com 14. Disclaimer of Validity This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 15. Copyright Notice Copyright (C) The Internet Society (2004). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. Acknowledgment Funding for the RFC Editor function is currently provided by the Internet Society. Raftus/Cardona Expires January 2005 [Page 130]