idnits 2.17.1 draft-ietf-ipcdn-docs-rfmibv2-09.txt: -(6015): Line appears to be too long, but this could be caused by non-ascii characters in UTF-8 encoding Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** Looks like you're using RFC 2026 boilerplate. This must be updated to follow RFC 3978/3979, as updated by RFC 4748. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- == There is 1 instance of lines with non-ascii characters in the document. == No 'Intended status' indicated for this document; assuming Proposed Standard Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year == Line 501 has weird spacing: '...astPkts inter...' == Line 561 has weird spacing: '...astPkts inte...' == Line 771 has weird spacing: '...astPkts inter...' == Line 841 has weird spacing: '...astPkts inte...' == Line 918 has weird spacing: '...astPkts inte...' == (2 more instances...) == The document seems to use 'NOT RECOMMENDED' as an RFC 2119 keyword, but does not include the phrase in its RFC 2119 key words list. -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (December 2003) is 7431 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Missing Reference: 'RFC2670' is mentioned on line 6012, but not defined ** Obsolete undefined reference: RFC 2670 (Obsoleted by RFC 4546) == Unused Reference: 'ITU-T J.83' is defined on line 6079, but no explicit reference was found in the text ** Obsolete normative reference: RFC 3291 (Obsoleted by RFC 4001) -- Possible downref: Non-RFC (?) normative reference: ref. 'IANA' -- Possible downref: Non-RFC (?) normative reference: ref. 'ITU-T J.83' -- Possible downref: Non-RFC (?) normative reference: ref. 'ITU-T J.112' Summary: 4 errors (**), 0 flaws (~~), 12 warnings (==), 5 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 IPCDN Working Group D. Raftus 3 Internet Draft Terayon Canada Ltd. 4 Document: draft-ietf-ipcdn-docs-rfmibv2-09 E. Cardona (Editor) 5 CableLabs 7 December 2003 8 Expires: June 2004 9 Obsoletes: RFC 2670 11 Radio Frequency (RF) Interface Management Information Base 12 for DOCSIS 2.0 compliant RF interfaces 14 Status of this Memo 16 Internet-Drafts are working documents of the Internet Engineering 17 Task Force (IETF), its areas, and its working groups. Note that 18 other groups may also distribute working documents as Internet- 19 Drafts. 21 Internet-Drafts are draft documents valid for a maximum of six 22 months and may be updated, replaced, or obsoleted by other 23 documents at any time. It is inappropriate to use 24 Internet-Drafts as reference material or to cite them other than 25 as "work in progress." 27 The list of current Internet-Drafts can be accessed at 28 http://www.ietf.org/ietf/1id-abstracts.txt 30 The list of Internet-Draft Shadow Directories can be accessed at 31 http://www.ietf.org/shadow.html. 33 Copyright Notice 35 Copyright (C) The Internet Society (2003). All Rights Reserved. 37 Abstract 39 This memo defines a portion of the Management Information Base (MIB) 40 for use with network management protocols in the Internet community. 41 In particular, it defines a set of managed objects for SNMP-based 42 management of the Radio Frequency (RF) interfaces for systems 43 compliant with the Data Over Cable Service Interface Specifications 44 (DOCSIS). 46 This document revises RFC 2670. Please see section 10 for a 47 description of the changes from RFC 2670. 49 This memo is a product of the IPCDN working group within the 50 Internet Engineering Task Force. Comments are solicited and should 51 be addressed to the working group's mailing list at ipcdn@ietf.org 52 and/or the authors. 54 Conventions used in this document 56 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 57 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in 58 this document are to be interpreted as described in BCP 14, 59 RFC 2119 [RFC2119]. 61 Table of Contents 63 1 The Internet-Standard Management Framework .................... 3 64 2 Glossary ...................................................... 3 65 3 Overview ...................................................... 6 66 3.1 Structure of the MIB ........................................ 6 67 3.1.1 docsIfBaseObjects ......................................... 6 68 3.1.2 docsIfCmObjects ........................................... 7 69 3.1.3 docsIfCmtsObjects ......................................... 7 70 3.2 Relationship to the Interfaces MIB .......................... 7 71 3.2.1 Layering Model ............................................ 8 72 3.2.2 Virtual Circuits .......................................... 9 73 3.2.3 ifTestTable ............................................... 9 74 3.2.4 ifRcvAddressTable ......................................... 9 75 3.2.5 ifEntry ................................................... 9 76 4 Definitions .................................................. 19 77 5 Acknowledgments ............................................. 113 78 6 Revision History ............................................ 113 79 7 Normative References ........................................ 113 80 8 Informative References ...................................... 115 81 9 Security Considerations ..................................... 115 82 10 Changes from RFC 2670 ...................................... 117 83 11 Management Interoperability of DOCSIS 1.0, 1.1 and 2.0...... 118 84 12 Intellectual Property .......................................118 85 13 Author's Address ........................................... 119 86 14 Full Copyright Statement ................................... 119 88 1. The Internet-Standard Management Framework 90 For a detailed overview of the documents that describe the current 91 Internet-Standard Management Framework, please refer to section 7 92 of RFC 3410 [RFC3410]. 94 Managed objects are accessed via a virtual information store, 95 termed the Management Information Base or MIB. MIB objects are 96 generally accessed through the Simple Network Management Protocol 97 (SNMP). 98 Objects in the MIB are defined using the mechanisms defined in the 99 Structure of Management Information (SMI). This memo specifies a 100 MIB module that is compliant to the SMIv2, which is described in 101 STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, 102 RFC 2580 [RFC2580]. 104 2. Glossary 106 The terms in this document are derived either from normal cable 107 system usage, or from the documents associated with the Data Over 108 Cable Service Interface Specification process. 110 2.1. Baseline Privacy 112 Security interface specification designed for DOCSIS compliant 113 cable data systems that ensures device authentication data 114 confidentiality in the CATV plant. See [BPI] and [BPIPLUS]. 116 2.2. CATV 118 Originally "Community Antenna Television", now used to refer to any 119 cable or hybrid fiber and cable system used to deliver video signals 120 to a community. 122 2.3. Channel 124 A specific frequency allocation with an RF medium, specified by 125 channel width in Hertz (cycles per second) and by center frequency. 126 Within the US Cable Systems, upstream channels are generally 127 allocated from the 5-42MHz range while down stream channels are 128 generally allocated from the 50-750MHz range depending on the 129 capabilities of the given system. The typical broadcast channel 130 width in the US is 6MHz. Upstream channel widths for DOCSIS vary. 132 For European cable systems, upstream channels vary by country. The 133 upper edge of upstream channel allocations vary between 25 MHz to 65 134 MHz, and the lower edge of downstream channel allocations vary 135 between 47 MHz and 87.5 MHz. The typical broadcast channel width in 136 Europe is 8MHz. The actual parameters are of concern to systems 137 deploying Euro-DOCSIS technology. 139 2.4. CM Cable Modem. 141 A CM acts as a "slave" station in a DOCSIS compliant cable data 142 system. 144 2.5. CMTS Cable Modem Termination System. 146 A generic term covering a cable bridge or cable router in a 147 head-end. A CMTS acts as the master station in a DOCSIS compliant 148 cable data system. It is the only station that transmits 149 downstream, and it controls the scheduling of upstream 150 transmissions by its associated CMs. 152 2.6. Codeword 154 A characteristic of the Forward Error Correction scheme used 155 above the RF media layer. 157 See "Data-Over-Cable Service Interface Specifications: Radio 158 Frequency Interface Specification SP-RFIv2.0-I04-030730" 160 2.7. Data Packet 161 The payload portion of the MAC Packet. 163 2.8. dBmV 165 A measure of RF signal voltage amplitude, whose power level is 166 determined by the characteristic impedance. A zero dB signal power 167 is equivalent to 48.75 dBmV signal amplitude in a 75 Ohm system. 169 2.9. DOCSIS 171 "Data Over Cable Service Interface Specification". A term 172 referring to the ITU-T J.112 Annex B standard for cable modem 173 systems [ITU-T J.112]. 175 2.9.1. DOCSIS 1.0 177 Cable modem systems CM/CMTS compliant to requirements in [RFI1.0]. 178 A common reference to DOCSIS 1.0 in this document is the upstream 179 channel queuing mechanism known as Class of Service (COS). 181 2.9.2 DOCSIS 1.1 183 Cable modem systems CM/CMTS compliant to requirements in [RFI1.1]. 184 DOCSIS 1.1 references in this document are in part associated with 185 the upstream and downstream Quality of Service (QOS). 186 The term DOCSIS 1.x is used in this document to refer both 187 DOCSIS 1.0 and DOCSIS 1.1. 189 2.9.3. DOCSIS 2.0 191 Cable modem systems CM/CMTS compliant to requirements in [RFI2.0]. 193 2.10. Downstream 195 The direction from the head-end towards the subscriber. 197 2.11. Euro-DOCSIS 198 Cable modem systems CM/CMTS conforming to the European spectrum 199 Lineup and compliant to requirements of Annex F in [RFI2.0] 201 2.12. Head-end 203 The origination point in most cable systems of the subscriber video 204 signals. 206 2.13. MAC Packet 208 A DOCSIS PDU. 210 2.14. MCNS 212 "Multimedia Cable Network System". Generally replaced in usage by 213 DOCSIS. 215 2.15. Mini-slot 217 In general, an interval of time which is allocated by the 218 CMTS to a given CM for that CM to transmit in an upstream direction. 219 See [RFI2.0] 221 2.16. QPSK Quadrature Phase Shift Keying. 223 A particular modulation scheme on an RF medium. See [Proakis00]. 225 2.17. QAM Quadrature Amplitude Modulation. 227 A particular modulation scheme on RF medium. Usually expressed 228 with a number indicating the size of the modulation constellation 229 (e.g. 16 QAM). See [Proakis00]. 231 2.18. RF 233 Radio Frequency. 235 2.19. Symbol-times 237 A characteristic of the RF modulation scheme. 238 See [RFI2.0]. 240 2.20. Upstream 242 The direction from the subscriber towards the head-end. 244 3. Overview 245 This MIB module provides a set of objects required for the 246 management of MCNS/DOCSIS compliant Cable Modem (CM) and Cable Modem 247 Termination System (CMTS) RF interfaces. The specification is 248 derived in part from the parameters and protocols described in 249 [RFI2.0]. 251 3.1. Structure of the MIB 253 This MIB module is structured as three groups: 255 o Management information pertinent to both Cable Modems (CM) and 256 Cable Modem Termination Systems (CMTS) (docsIfBaseObjects). 257 o Management information pertinent to Cable Modems only 258 (docsIfCmObjects). 259 o Management information pertinent to Cable Modem Termination 260 Systems only (docsIfCmtsObjects). 262 Tables within each of these groups group objects functionally - e.g. 263 Quality of Service, Channel characteristics, MAC layer management, 264 etc. Rows created automatically (e.g. by the device according to 265 the hardware configuration) may and generally will have a mixture of 266 configuration and status objects within them. Rows that are meant 267 to be created by the management station are generally restricted to 268 configuration (read-create) objects. 270 3.1.1. docsIfBaseObjects 272 docsIfDownstreamChannelTable - This table describes the existing 273 downstream channels for a CMTS and the received downstream channel 274 for a CM. 276 docsIfUpstreamChannelTable - This table describes the existing 277 upstream channels for a CMTS and the current upstream transmission 278 channel for a CM. 280 docsIfQosProfileTable - This table describes the valid Quality of 281 Service profiles for the cable data system. 283 docsIfSignalQualityTable - This table is used to monitor RF signal 284 quality characteristics of received signals. 286 docsIfDocsisBaseCapability - This object is used to indicate the 287 highest level of DOCSIS version a cable device can support. 289 3.1.2. docsIfCmObjects 291 docsIfCmMacTable - This table is used to monitor the DOCSIS MAC 292 interface and can be considered an extension to the ifEntry. 294 docsIfCmStatusTable - This table maintains a number of status 295 objects and counters for cable modems. There is a comparable table 296 at the CMTS, docsIfCmtsCmStatusTable, which maintains similar 297 counters from the CMTS point of view. 299 docsIfCmServiceTable - This table describes the upstream service 300 queues available at this CM. There is a comparable table at the 301 CMTS, docsIfCmtsServiceEntry, which describes the service queues 302 from the point of view of the CMTS. 304 3.1.3. docsIfCmtsObjects 306 docsIfCmtsMacTable - Describes the attributes of each CMTS MAC 307 interface. 309 docsIfCmtsStatusTable - This table provides a set of aggregated 310 counters which roll-up values and events that occur on the 311 underlying sub-interfaces. 313 docsIfCmtsCmStatusTable - This table is used to hold information 314 about known (i.e. ranging, registered, and/or previously online) 315 cable modems on the system serviced by this CMTS. 317 docsIfCmtsServiceTable - This table provides access to the 318 information related to upstream service queues. 320 docsIfCmtsModulationTable - This table allows control over the 321 modulation profiles for RF channels associated with this CMTS. 323 docsIfCmtsMacToCmTable - This table allows fast access into the 324 docsIfCmtsCmTable via a MAC address (of the CM) interface. 326 docsIfCmtsChannelUtilizationTable - This table provides statistical 327 load usage data for attached upstream and downstream physical 328 channels. 330 docsIfCmtsDownChannelCounterTable - This table provides statistical 331 data for attached downstream channels, appropriate as input for load 332 usage calculations. 334 docsIfCmtsUpChannelCounterTable - This table provides statistical 335 data for attached upstream channels, appropriate as input for load 336 usage calculations. 338 3.2. Relationship to the Interfaces MIB module 340 This section clarifies the relationship of this MIB module to the 341 Interfaces MIB [RFC2863]. Several areas of correlation are addressed 342 in the following subsections. The implementer is referred to the 343 Interfaces MIB document in order to understand the general intent of 344 these areas. 346 3.2.1. Layering Model 347 An instance of ifEntry exists for each RF Downstream interface, for 348 each RF Upstream interface, for each Upstream logical Channel and 349 for each RF MAC layer. 350 The ifStackTable [RFC2863] MUST be implemented to identify the 351 relationships among sub-interfaces. 353 The following example illustrates a CMTS MAC interface with one 354 downstream and two upstream interfaces. 356 | <== to network layer 357 +------------------ --+-------------------------------+ 358 | RF MAC | 359 +--+------------------+------------------------+------+ 360 | | | 361 +-------+-----+ +------+------+ +------+------+ 362 | Downstream1 | | Upstream1 | | Upstream2 | 363 | | | | | | 364 +-------------+ ++-----------++ ++-----------++ 365 | | | | 366 +----+----+ +----+----+ +----+----+ +----+----+ 367 | Ch-1 | | Ch-2 | | Ch-1 | | Ch-2 | 368 |(A/TDMA) | |(S-CDMA) | |(A/TDMA) | |(S-CDMA) | 369 +---------+ +---------+ +---------+ +---------+ 371 As can be seen from this example, the RF MAC interface is layered on 372 top of the downstream and upstream interfaces, and the RF Upstream 373 interface is layered on top of an Upstream Logical Channels. 375 In this example, the assignment of index values could be as follows: 377 ifIndex ifType Description 379 2 docsCableMaclayer(127) CATV MAC Layer 380 3 docsCableDownstream(128) CATV Downstream interface 381 4 docsCableUpstream(129) CATV Upstream interface 382 5 docsCableUpstream(129) CATV Upstream interface 383 6 docsCableUpstreamChannel(205) CATV Upstream Channel 384 7 docsCableUpstreamChannel(205) CATV Upstream Channel 385 8 docsCableUpstreamChannel(205) CATV Upstream Channel 386 9 docsCableUpstreamChannel(205) CATV Upstream Channel 388 The corresponding ifStack entries would then be: 390 | IfStackHigherLayer | ifStackLowerLayer | 391 | 0 | 2 | 392 | 2 | 3 | 393 | 2 | 4 | 394 | 2 | 5 | 395 | 4 | 6 | 396 | 4 | 7 | 397 | 5 | 8 | 398 | 5 | 9 | 399 | 3 | 0 | 400 | 6 | 0 | 401 | 7 | 0 | 402 | 8 | 0 | 403 | 9 | 0 | 405 The same interface model can also be used in Telephony or Telco 406 Return systems. A pure Telco Return system (Cable Modem as well as 407 Cable Modem Termination System) would not have upstream, but only 408 downstream cable channels. Systems supporting both Telco Return and 409 cable upstream channels can use the above model without 410 modification. 412 Telco Return Upstream channel(s) management is outside the scope of 413 this document. 415 3.2.2. Virtual Circuits 417 This medium does not support virtual circuits and this area is not 418 applicable to this MIB module. 420 3.2.3. ifTestTable 422 The ifTestTable is optional for DOCSIS CM/CMTS implementations, but 423 is not specifically influenced by the RF MIB. 425 3.2.4. ifRcvAddressTable 427 The ifRcvAddressTable is optional for DOCSIS CM/CMTS 428 implementations, but is not specifically influenced by the RF MIB. 430 3.2.5. ifEntry 432 This section documents only the differences from the requirements 433 specified in the Interfaces MIB module. See that MIB module for 434 columns omitted from the descriptions below. 436 3.2.5.1. ifEntry for Downstream interfaces 438 The ifEntry for Downstream interfaces supports the 439 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 440 MIB module. This is an output only interface at the CMTS and all 441 input status counters - ifIn* - will return zero. This is an input 442 only interface at the CM and all output status counters - ifOut* - 443 will return zero. 445 3.2.5.1.1. ifEntry for Downstream interfaces in Cable Modem 446 Termination Systems 448 ifTable Comments 449 ============== =========================================== 450 ifIndex Each RF Cable Downstream interface is represented 451 by an ifEntry. 453 ifType The IANA value of docsCableDownstream(128) 454 See [IANA]. 456 ifSpeed Return the speed of this downstream channel. 457 The returned value is the raw bandwidth in bits/s 458 of this interface. This is the symbol rate 459 multiplied with the number of bits per symbol. 461 ifHighSpeed Return the speed of this downstream channel. 462 The returned value is the raw bandwidth in 463 megabits/s of this interface. This is the symbol 464 rate multiplied with the number of bits per 465 symbol. 467 ifPhysAddress Return an empty string. 469 ifAdminStatus The administrative status of this interface. 471 ifOperStatus The current operational status of this interface. 473 ifMtu The size of the largest frame which can be 474 sent on this interface, specified in octets. 475 The value includes the length of the MAC header. 477 ifInOctets Return zero. 478 ifHCInOctets 480 ifInUcastPkts Return zero. 481 ifHCInUcastPkts 483 ifInMulticastPkts Return zero. 484 ifHCInMulticastPkts 486 ifInBroadcastPkts Return zero. 487 ifHCInBroadcastPkts 489 ifInDiscards Return zero. 491 ifInErrors Return zero. 493 ifInUnknownProtos Return zero. 495 ifOutOctets The total number of octets transmitted on this 496 ifHCOutOctets interface. This includes MAC packets as well as 497 data packets, and includes the length of the MAC 498 header. 500 ifOutUcastPkts The number of Unicast packets transmitted on this 501 ifHCOutUcastPkts interface. This includes MAC packets as well as 502 data packets. 504 ifOutMulticastPkts 505 ifHCOutMulticastPkts 506 Return the number of Multicast packets transmitted 507 on this interface. 508 This includes MAC packets as well as data packets. 510 ifOutBroadcastPkts 511 ifHCOutBroadcastPkts 512 Return the number of broadcast packets transmitted 513 on this interface. 514 This includes MAC packets as well as data packets. 516 ifOutDiscards The total number of outbound packets which 517 were discarded. Possible reasons are: 518 buffer shortage. 520 ifOutErrors The number of packets which could not be 521 transmitted due to errors. 523 ifPromiscuousMode Return false. 525 3.2.5.1.2. ifEntry for Downstream interfaces in Cable Modems 527 ifTable Comments 528 ============== =========================================== 529 ifIndex Each RF Cable Downstream interface is represented 530 by an ifEntry. 532 ifType The IANA value of docsCableDownstream(128). 533 See [IANA]. 535 ifSpeed Return the speed of this downstream channel. 536 The returned value the raw bandwidth in bits/s 537 of this interface. This is the symbol rate 538 multiplied with the number of bits per symbol. 540 ifHighSpeed Return the speed of this downstream channel. 541 The returned value the raw bandwidth in megabits/s 542 of this interface. This is the symbol rate 543 multiplied with the number of bits per symbol. 545 ifPhysAddress Return an empty string. 547 ifAdminStatus The administrative status of this interface. 549 ifOperStatus The current operational status of this interface. 551 ifMtu The size of the largest frame which can be 552 received from this interface, specified in octets. 553 The value includes the length of the MAC header. 555 ifInOctets The total number of octets received on this 556 ifHCInOctets interface. This includes data packets as well as 557 MAC packets, and includes the length of the 558 MAC header. 560 ifInUcastPkts The number of Unicast packets received on this 561 ifHCInUcastPkts interface. This includes data packets as well as 562 MAC packets. 564 ifInMulticastPkts 565 ifHCInMulticastPkts 566 Return the number of Multicast packets received 567 on this interface. This includes data packets as 568 well as MAC packets. 570 ifInBroadcastPkts 571 ifHCInBroadcastPkts 572 Return the number of Broadcast packets received 573 on this interface. This includes data packets 574 as well as MAC packets. 576 ifInDiscards The total number of received packets that have 577 been discarded. 578 The possible reasons are: buffer shortage. 580 ifInErrors The number of inbound packets that contained 581 errors preventing them from being deliverable 582 to higher layers. 583 Possible reasons are: MAC FCS error. 585 ifInUnknownProtos The number of frames with an unknown packet type. 586 These are MAC frames with an unknown packet type. 588 ifOutOctets Return zero. 589 ifHCOutOctets 591 ifOutUcastPkts Return zero. 592 ifHCOutUcastPkts 594 ifOutMulticastPkts 595 ifHCOutMulticastPkts 596 Return zero. 598 ifOutBroadcastPkts 599 ifHCOutBroadcastPkts 600 Return zero. 602 ifOutDiscards Return zero. 604 ifOutErrors Return zero. 606 ifPromiscuousMode Refer to the Interfaces MIB. 608 3.2.5.2. ifEntry for Upstream interfaces 610 Each supported interface of the type docsCableUpstream(129) must 611 have a corresponding ifEntry. 612 The ifEntry for Upstream interfaces supports the 613 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 614 MIB. This is an input only interface at the CMTS and all output 615 status counters - ifOut* - will return zero. This is an output only 616 interface at the CM and all input status counters - ifIn* - will 617 return zero. 619 3.2.5.2.1. ifEntry for Upstream interfaces in Cable Modem Termination 620 Systems 622 ifTable Comments 623 ============== =========================================== 624 ifIndex Each RF Cable Upstream interface is represented 625 by an ifEntry. 627 ifType The IANA value of docsCableUpstream (129). 628 See [IANA]. 630 ifSpeed Return the maximum channel throughput (not payload 631 throughput) supported by the interface. 632 The maximum throughput is calculated for the case 633 where upstream channels are configured to maximize 634 interface throughput. 636 ifHighSpeed Return the maximum channel throughput (not payload 637 throughput) supported by the interface. 638 The maximum throughput is calculated for the case 639 where upstream channels are configured to maximize 640 interface throughput. Units for this object are 641 (1/1 000 000) * IfSpeed. 643 ifPhysAddress Return an empty string. 645 ifAdminStatus The administrative status of this interface. 647 ifOperStatus The current operational status of this interface. 648 This reflects the total status of all the channels 649 under this interface. So if at least one channel 650 has a physical connection this interface has 651 connection. 653 ifMtu The size of the largest frame which can be 654 transmitted on this interface, specified in 655 octets. The value includes the length of the MAC 656 header. This is the maximum of all the ifMtu of 657 all the channels under this interface. 659 ifInOctets 660 ifHCInOctets The total (sum) number of octets received on all 661 the Upstream channels under this 662 interface. This includes data packets as well as 663 MAC packets, and includes the length of the 664 MAC header. 666 ifInUcastPkts 667 ifHCInUcastPkts The total number of Unicast packets received on 668 all the upstream channels under this 669 interface. This includes data packets as well as 670 MAC packets. 672 ifInMulticastPkts 673 ifHCInMulticastPkts 674 Return the total number of Multicast packets 675 received on all the Upstream channels under this 676 interface. This includes data packets as well as 677 MAC layer packets. 679 ifInBroadcastPkts 680 ifHCInBroadcastPkts 681 Return the total number of Broadcast packets 682 received on all the Upstream channels under this 683 interface. This includes data packets as well as 684 MAC packets. 686 ifInDiscards The total number of received packets, which have 687 been discarded on all the Upstream channels under 688 this interface. 689 The possible reasons are: buffer shortage. 691 ifInErrors The total number of inbound packets that contained 692 errors preventing them from being deliverable 693 to higher layers. 694 Possible reasons are: MAC FCS error. 696 ifInUnknownProtos The total number of frames with an unknown packet 697 type. These are MAC frames with an unknown packet 698 type. 700 ifOutOctets Return zero. 702 ifHCOutOctets 704 ifOutUcastPkts Return zero. 705 ifHCOutOctets 707 ifOutMulticastPkts 708 ifHCOutMulticastPkts 709 Return zero. 711 ifOutBroadcastPkts 712 ifHCOutBroadcastPkts 713 Return zero. 715 ifOutDiscards Return zero. 717 ifOutErrors Return zero. 719 3.2.5.2.2. ifEntry for Upstream interfaces in Cable Modems 721 ifTable Comments 722 ============== =========================================== 723 ifIndex Each RF Cable Upstream interface is represented 724 by an ifEntry. 726 ifType The IANA value of docsCableUpstream (129). 727 See [IANA]. 729 ifSpeed Return the speed of this upstream interface. 730 The returned value is the raw bandwidth 731 in bits/s of this interface. 733 ifHighSpeed Return the speed of this upstream interface. 734 The returned value is the raw bandwidth 735 in megabits/s of this interface. 737 ifPhysAddress Return an empty string. 739 ifAdminStatus The administrative status of this interface. 741 ifOperStatus The current operational status of this interface. 743 ifMtu The size of the largest frame which can be 744 transmitted on this interface, specified in 745 octets. The value includes the length of the MAC 746 header. 748 ifInOctets Return zero. 749 ifHCInOctets 751 ifInUcastPkts Return zero. 752 ifHCInUcastPkts 753 ifInMulticastPkts Return zero. 754 ifHCInMulticastPkts 756 ifInBroadcastPkts Return zero. 757 ifHCInBroadcastPkts 759 ifInDiscards Return zero. 761 ifInErrors Return zero. 763 ifInUnknownProtos Return zero. 765 ifOutOctets The total number of octets transmitted on this 766 ifHCOutOctets interface. This includes MAC packets as well as 767 data packets, and includes the length of the MAC 768 header. 770 ifOutUcastPkts The number of Unicast packets transmitted on this 771 ifHCOutUcastPkts interface. This includes MAC packets as well as 772 data packets. 774 ifOutMulticastPkts 775 ifHCOutMulticastPkts 776 Return the number of Multicast packets transmitted 777 on this interface. 778 This includes MAC packets as well as data packets. 780 ifOutBroadcastPkts 781 ifHCOutBroadcastPkts 782 Return the number of broadcast packets transmitted 783 on this interface. 784 This includes MAC packets as well as data packets. 786 ifOutDiscards The total number of outbound packets which 787 were discarded. Possible reasons are: 788 buffer shortage. 790 ifOutErrors The number of packets which could not be 791 transmitted due to errors. 793 ifPromiscuousMode Return false. 795 3.2.5.3. ifEntry for Upstream channels 797 Each supported channel of the type docsCableUpstreamChannel(205) 798 must have a corresponding ifEntry. 800 The ifEntry for Upstream channels supports the 801 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 802 MIB. This is an input only interface at the CMTS and all output 803 status counters - ifOut* - will return zero. 804 DOCSIS CMs are not required to support logical upstream channels. 806 3.2.5.3.1. ifEntry for Upstream Channels in Cable Modem Termination 807 Systems 809 ifTable Comments 810 ============== =========================================== 811 ifIndex Each RF Cable Upstream channel is represented 812 by an ifEntry. 814 ifType The IANA value of docsCableUpstreamChannel (205). 815 See [IANA]. 817 ifSpeed Return the speed of this upstream channel. 818 The returned value is the raw bandwidth 819 in bits/s of this channel. 821 ifHighSpeed Return the speed of this upstream channel. 822 The returned value is the raw bandwidth 823 in megabits/s of this channel. 825 ifPhysAddress Return an empty string. 827 ifAdminStatus The administrative status of this interface. 829 ifOperStatus The current operational status of this interface. 831 ifMtu The size of the largest frame which can be 832 received on this interface, specified in octets. 833 The value includes the length of the MAC header. 835 ifInOctets The total number of octets received on this 836 interface. This includes data packets as well as 837 MAC packets, and includes the length of the 838 MAC header. 840 ifInUcastPkts The number of Unicast packets received on this 841 ifHCInUcastPkts interface. This includes data packets as well as 842 MAC packets. 844 ifInMulticastPkts 845 ifHCInMulticastPkts 846 Return the number of Multicast packets received 847 on this interface. This includes data packets as 848 well as MAC layer packets. 850 ifInBroadcastPkts 851 ifHCInBroadcastPkts 852 Return the number of Broadcast packets received 853 on this interface. This includes data packets 854 as well as MAC packets. 856 ifInDiscards The total number of received packets that have 857 been discarded. 858 The possible reasons are: buffer shortage. 860 ifInErrors The number of inbound packets that contained 861 errors preventing them from being deliverable 862 to higher layers. 863 Possible reasons are: MAC FCS error. 865 ifInUnknownProtos The number of frames with an unknown packet type. 866 These are MAC frames with an unknown packet type. 868 ifOutOctets Return zero. 869 ifHCOutOctets 871 ifOutUcastPkts Return zero. 872 ifHCOutUcastPkts 874 ifOutMulticastPkts 875 ifHCOutMulticastPkts 876 Return zero. 878 ifOutBroadcastPkts 879 ifHCOutBroadcastPkts 880 Return zero. 882 ifOutDiscards Return zero. 884 ifOutErrors Return zero. 886 3.2.5.4. ifEntry for the MAC Layer 888 The ifEntry for the MAC Layer supports the ifGeneralInformationGroup 889 and the ifPacketGroup of the Interfaces MIB. This interface 890 provides an aggregate view of status for the lower level Downstream 891 and Upstream interfaces. 893 ifTable Comments 894 ============== =========================================== 895 ifIndex Each RF Cable MAC layer entity is represented 896 by an ifEntry. 898 ifType The IANA value of docsCableMaclayer(127). 899 See [IANA]. 901 ifSpeed Return zero. 903 ifPhysAddress Return the physical address of this interface. 905 ifAdminStatus The administrative status of this interface. 907 ifOperStatus The current operational status of the MAC 908 layer interface. 910 ifHighSpeed Return zero. 912 ifMtu Return 1500. 914 ifInOctets The total number of data octets received on this 915 ifHCInOctets interface, targeted for upper protocol layers. 917 ifInUcastPkts The number of Unicast packets received on this 918 ifHCInUcastPkts interface, targeted for upper protocol layers. 920 ifInMulticastPkts 921 ifHCInMulticastPkts 922 Return the number of Multicast packets received 923 on this interface, targeted for upper protocol 924 layers. 926 ifInBroadcastPkts 927 ifHCInBroadcastPkts 928 Return the number of Broadcast packets received 929 on this interface, targeted for upper protocol 930 layers. 932 ifInDiscards The total number of received packets that have 933 been discarded. 934 The possible reasons are: buffer shortage. 936 ifInErrors The number of inbound packets that contained 937 errors preventing them from being deliverable 938 to higher layers. 939 Possible reasons are: data packet FCS error, 940 invalid MAC header. 942 ifInUnknownProtos The number of frames with an unknown packet type. 943 This is the number of data packets targeted for 944 upper protocol layers with an unknown packet type. 946 ifOutOctets The total number of octets, received from upper 947 ifHCOutOctets protocol layers and transmitted on this interface. 949 ifOutUcastPkts The number of Unicast packets, received from upper 950 ifHCOutUcastPkts protocol layers and transmitted on this interface. 952 ifOutMulticastPkts 953 ifHCOutMulticastPkts 954 Return the number of Multicast packets received 955 from upper protocol layers and transmitted on this 956 interface. 958 ifOutBroadcastPkts 959 ifHCOutBroadcastPkts 960 Return the number of broadcast packets received 961 from upper protocol layers and transmitted on this 962 interface. 964 ifOutDiscards The total number of outbound packets which 965 were discarded. Possible reasons are: 966 buffer shortage. 968 ifOutErrors The number of packets which could not be 969 transmitted due to errors. 971 ifPromiscuousMode Refer to the Interfaces MIB. 973 4. Definitions 975 DOCS-IF-MIB DEFINITIONS ::= BEGIN 977 IMPORTS 978 MODULE-IDENTITY, 979 OBJECT-TYPE, 980 Unsigned32, 981 Integer32, 982 Counter32, 983 Counter64, 984 TimeTicks, 985 IpAddress, 986 transmission 987 FROM SNMPv2-SMI 988 TEXTUAL-CONVENTION, 989 MacAddress, 990 RowStatus, 991 TruthValue, 992 TimeInterval, 993 TimeStamp 994 FROM SNMPv2-TC 995 OBJECT-GROUP, 997 MODULE-COMPLIANCE 998 FROM SNMPv2-CONF 999 ifIndex, InterfaceIndexOrZero 1000 FROM IF-MIB 1001 InetAddressType, 1002 InetAddress 1003 FROM INET-ADDRESS-MIB 1004 IANAifType 1005 FROM IANAifType-MIB; 1007 docsIfMib MODULE-IDENTITY 1008 LAST-UPDATED "200312150000Z" -- December 15 , 2003 1009 ORGANIZATION "IETF IPCDN Working Group" 1010 CONTACT-INFO 1011 " David Raftus 1012 Postal: Terayon Communications 1013 340 Terry Fox Drive, Suite 202 1014 Ottawa Ontario 1015 Canada 1016 Phone: +1 613 592 1052 ext.222 1017 E-mail: david.raftus@terayon.com 1019 Eduardo Cardona 1020 Postal: 1021 Cable Television Laboratories, Inc. 1022 400 Centennial Parkway 1023 Louisville, CO 80027-1266 1024 U.S.A. 1025 Tel: +1 303 661 9100 1026 Fax: +1 303 661 9199 1027 E-mail: e.cardona@cablelabs.com 1029 IETF IPCDN Working Group 1030 General Discussion: ipcdn@ietf.org 1031 Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn 1032 Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn 1033 Co-chairs: Richard Woundy, Richard_Woundy@cable.comcast.com 1034 Jean-Francois Mule, jf.mule@cablelabs.com" 1035 DESCRIPTION 1036 "This is the MIB Module for DOCSIS 2.0 compliant Radio 1037 Frequency (RF) interfaces in Cable Modems (CM) and 1038 Cable Modem Termination Systems (CMTS). 1040 Copyright (C) The Internet Society (2003). This 1041 version of this MIB module is part of RFC XXXX; see 1042 the RFC itself for full legal notices." 1044 REVISION "200312150000Z" 1045 DESCRIPTION 1046 "Revision of the IETF RF MIB module for DOCSIS 2.0. 1047 This version published as RFC XXXX." 1048 -- Note to RFC editor: 1049 -- RFC editor to replace XXXX with this RFC number 1050 -- Delete this note 1052 REVISION "199908190000Z" 1053 DESCRIPTION 1054 "Initial Version, published as RFC 2670. 1055 Modified by Mike StJohns to fix problems identified by 1056 the first pass of the MIB doctor. Of special note, 1057 docsIfRangingResp and docsIfCmtsInsertionInterval were 1058 obsoleted and replaced by other objects with the same 1059 functionality, but more appropriate SYNTAX." 1061 ::= { transmission 127 } 1063 -- Textual Conventions 1065 TenthdBmV ::= TEXTUAL-CONVENTION 1066 DISPLAY-HINT "d-1" 1067 STATUS current 1068 DESCRIPTION 1069 "This data type represents power levels that are normally 1070 expressed in dBmV. Units are in tenths of a dBmV; 1071 for example, 5.1 dBmV will be represented as 51." 1072 SYNTAX Integer32 1074 TenthdB ::= TEXTUAL-CONVENTION 1075 DISPLAY-HINT "d-1" 1076 STATUS current 1077 DESCRIPTION 1078 "This data type represents power levels that are normally 1079 expressed in dB. Units are in tenths of a dB; 1080 for example, 5.1 dB will be represented as 51." 1081 SYNTAX Integer32 1083 DocsisVersion ::= TEXTUAL-CONVENTION 1084 STATUS current 1085 DESCRIPTION "Indicates the DOCSIS version number." 1086 SYNTAX INTEGER { 1087 docsis10 (1), 1088 docsis11 (2), 1089 docsis20 (3) 1090 } 1092 DocsisQosVersion ::= TEXTUAL-CONVENTION 1093 STATUS current 1094 DESCRIPTION "Indicates the quality of service level." 1095 SYNTAX INTEGER { 1096 docsis10 (1), 1097 docsis11 (2) 1098 } 1100 DocsisUpstreamType ::= TEXTUAL-CONVENTION 1101 STATUS current 1102 DESCRIPTION "Indicates the DOCSIS Upstream Channel Type." 1103 SYNTAX INTEGER { 1104 unknown (0), 1105 tdma (1), 1106 atdma (2), 1107 scdma (3), 1108 tdmaAndAtdma (4) 1109 } 1111 DocsisUpstreamTypeStatus ::= TEXTUAL-CONVENTION 1112 STATUS current 1113 DESCRIPTION 1114 "Indicates the DOCSIS Upstream Channel Type Status. 1115 The shared channel indicator type is not valid, since 1116 this type is used to specifically identify PHY mode." 1117 SYNTAX INTEGER { 1118 unknown (0), 1119 tdma (1), 1120 atdma (2), 1121 scdma (3) 1122 } 1124 docsIfMibObjects OBJECT IDENTIFIER ::= { docsIfMib 1 } 1125 docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 } 1126 docsIfCmObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 2 } 1127 docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 } 1129 -- 1130 -- BASE GROUP 1131 -- 1133 -- 1134 -- The following table is implemented on both the Cable Modem (CM) 1135 -- and the Cable Modem Termination System (CMTS). This table is 1136 -- read only for the CM. 1137 -- 1139 docsIfDownstreamChannelTable OBJECT-TYPE 1140 SYNTAX SEQUENCE OF DocsIfDownstreamChannelEntry 1141 MAX-ACCESS not-accessible 1142 STATUS current 1143 DESCRIPTION 1144 "This table describes the attributes of downstream 1145 channels (frequency bands)." 1146 REFERENCE 1147 "Data-Over-Cable Service Interface Specifications: Radio 1148 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1149 Tables 6-16, and 6-17." 1151 ::= { docsIfBaseObjects 1 } 1153 docsIfDownstreamChannelEntry OBJECT-TYPE 1154 SYNTAX DocsIfDownstreamChannelEntry 1155 MAX-ACCESS not-accessible 1156 STATUS current 1157 DESCRIPTION 1158 "An entry provides a list of attributes for a single 1159 Downstream channel. 1160 An entry in this table exists for each ifEntry with an 1161 ifType of docsCableDownstream(128)." 1162 INDEX { ifIndex } 1163 ::= { docsIfDownstreamChannelTable 1 } 1165 DocsIfDownstreamChannelEntry ::= SEQUENCE { 1166 docsIfDownChannelId Integer32, 1167 docsIfDownChannelFrequency Integer32, 1168 docsIfDownChannelWidth Integer32, 1169 docsIfDownChannelModulation INTEGER, 1170 docsIfDownChannelInterleave INTEGER, 1171 docsIfDownChannelPower TenthdBmV, 1172 docsIfDownChannelAnnex INTEGER 1173 } 1175 docsIfDownChannelId OBJECT-TYPE 1176 SYNTAX Integer32 (0..255) 1177 MAX-ACCESS read-only 1178 STATUS current 1179 DESCRIPTION 1180 "The Cable Modem Termination System (CMTS) identification 1181 of the downstream channel within this particular MAC 1182 interface. If the interface is down, the object returns 1183 the most current value. If the downstream channel ID is 1184 unknown, this object returns a value of 0." 1185 ::= { docsIfDownstreamChannelEntry 1 } 1187 docsIfDownChannelFrequency OBJECT-TYPE 1188 SYNTAX Integer32 (0..1000000000) 1189 UNITS "hertz" 1190 MAX-ACCESS read-write 1191 STATUS current 1192 DESCRIPTION 1193 "The center of the downstream frequency associated with 1194 this channel. This object will return the current tuner 1195 frequency. If a CMTS provides IF output, this object 1196 will return 0, unless this CMTS is in control of the 1197 final downstream RF frequency. See the associated 1198 compliance object for a description of valid frequencies 1199 that may be written to this object." 1200 REFERENCE 1201 "Data-Over-Cable Service Interface Specifications: Radio 1202 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1203 Section 6.3.3." 1204 ::= { docsIfDownstreamChannelEntry 2 } 1206 docsIfDownChannelWidth OBJECT-TYPE 1207 SYNTAX Integer32 (0..16000000) 1208 UNITS "hertz" 1209 MAX-ACCESS read-write 1210 STATUS current 1211 DESCRIPTION 1212 "The bandwidth of this downstream channel. Most 1213 implementations are expected to support a channel width 1214 of 6 MHz (North America) and/or 8 MHz (Europe). See the 1215 associated compliance object for a description of the 1216 valid channel widths for this object." 1217 REFERENCE 1218 "Data-Over-Cable Service Interface Specifications: Radio 1219 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1220 Table 6-17." 1221 ::= { docsIfDownstreamChannelEntry 3 } 1223 docsIfDownChannelModulation OBJECT-TYPE 1224 SYNTAX INTEGER { 1225 unknown(1), 1226 other(2), 1227 qam64(3), 1228 qam256(4) 1229 } 1230 MAX-ACCESS read-write 1231 STATUS current 1232 DESCRIPTION 1233 "The modulation type associated with this downstream 1234 channel. If the interface is down, this object either 1235 returns the configured value (CMTS), the most current 1236 value (CM), or the value of unknown(1). See the 1237 associated conformance object for write conditions and 1238 limitations. See the reference for specifics on the 1239 modulation profiles implied by qam64 and qam256." 1240 REFERENCE 1241 "Data-Over-Cable Service Interface Specifications: Radio 1242 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1243 Table 6-17." 1244 ::= { docsIfDownstreamChannelEntry 4 } 1246 docsIfDownChannelInterleave OBJECT-TYPE 1247 SYNTAX INTEGER { 1248 unknown(1), 1249 other(2), 1250 taps8Increment16(3), 1251 taps16Increment8(4), 1252 taps32Increment4(5), 1253 taps64Increment2(6), 1254 taps128Increment1(7), 1255 taps12increment17(8) 1256 } 1257 MAX-ACCESS read-write 1258 STATUS current 1259 DESCRIPTION 1260 "The Forward Error Correction (FEC) interleaving used 1261 for this downstream channel. 1262 Values are defined as follows: 1263 taps8Increment16(3): protection 5.9/4.1 usec, 1264 latency .22/.15 msec 1265 taps16Increment8(4): protection 12/8.2 usec, 1266 latency .48/.33 msec 1267 taps32Increment4(5): protection 24/16 usec, 1268 latency .98/.68 msec 1269 taps64Increment2(6): protection 47/33 usec, 1270 latency 2/1.4 msec 1271 taps128Increment1(7): protection 95/66 usec, 1272 latency 4/2.8 msec 1273 taps12increment17(8): protection 18/14 usec, 1274 latency 0.43/0.32 msec 1276 The value 'taps12increment17' is supported by Euro-DOCSIS 1277 cable systems only and the others by DOCSIS cable systems. 1279 If the interface is down, this object either returns 1280 the configured value (CMTS), the most current value (CM), 1281 or the value of unknown(1). 1282 The value of other(2) is returned if the interleave 1283 is known but not defined in the above list. 1284 See the associated conformance object for write 1285 conditions and limitations. See the reference for the FEC 1286 configuration described by the setting of this object." 1287 REFERENCE 1288 "Data-Over-Cable Service Interface Specifications: Radio 1289 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1290 Table 6-15." 1291 ::= { docsIfDownstreamChannelEntry 5 } 1293 docsIfDownChannelPower OBJECT-TYPE 1294 SYNTAX TenthdBmV 1295 UNITS "dBmV" 1296 MAX-ACCESS read-write 1297 STATUS current 1298 DESCRIPTION 1299 "At the CMTS, the operational transmit power. At the CM, 1300 the received power level. 1301 If the interface is down, this object either returns 1302 the configured value (CMTS), the most current value (CM) 1303 or the value of 0. See the associated conformance object 1304 for write conditions and limitations. See the reference 1305 for recommended and required power levels." 1306 REFERENCE 1307 "Data-Over-Cable Service Interface Specifications: Radio 1308 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1309 Tables 6-16, 6-17." 1310 ::= { docsIfDownstreamChannelEntry 6 } 1312 docsIfDownChannelAnnex OBJECT-TYPE 1313 SYNTAX INTEGER { 1314 unknown(1), 1315 other(2), 1316 annexA(3), 1317 annexB(4), 1318 annexC(5) 1319 } 1320 MAX-ACCESS read-only 1321 STATUS current 1322 DESCRIPTION 1323 "The value of this object indicates the conformance of 1324 the implementation to important regional cable standards. 1325 annexA : Annex A from ITU-T J.83 is used 1326 (equivalent to EN 300 429) 1327 annexB : Annex B from ITU-T J.83 is used. 1328 annexC : Annex C from ITU-T J.83 is used." 1330 REFERENCE 1332 "Data-Over-Cable Service Interface Specifications: Radio 1333 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1334 Sections 6.3.1, and H.3.1." 1336 ::= { docsIfDownstreamChannelEntry 7 } 1338 -- 1339 -- The following table is implemented on both the CM and the CMTS. 1340 -- For the CM, only attached channels appear in the table. For the 1341 -- CM, this table is read only as well. 1342 -- 1344 docsIfUpstreamChannelTable OBJECT-TYPE 1345 SYNTAX SEQUENCE OF DocsIfUpstreamChannelEntry 1346 MAX-ACCESS not-accessible 1347 STATUS current 1348 DESCRIPTION 1349 "This table describes the attributes of attached upstream 1350 channels." 1351 ::= { docsIfBaseObjects 2 } 1353 docsIfUpstreamChannelEntry OBJECT-TYPE 1354 SYNTAX DocsIfUpstreamChannelEntry 1355 MAX-ACCESS not-accessible 1356 STATUS current 1357 DESCRIPTION 1358 "List of attributes for a single upstream channel. For 1359 DOCSIS 2.0 CMTSs, an entry in this table exists for 1360 each ifEntry with an ifType of docsCableUpstreamChannel 1361 (205). 1362 For DOCSIS 1.x CM/CMTSs and DOCSIS 2.0 CMs, an entry in 1363 this table exists for each ifEntry with an ifType of 1364 docsCableUpstreamInterface (129)." 1365 INDEX { ifIndex } 1366 ::= { docsIfUpstreamChannelTable 1 } 1368 DocsIfUpstreamChannelEntry ::= SEQUENCE { 1369 docsIfUpChannelId Integer32, 1370 docsIfUpChannelFrequency Integer32, 1371 docsIfUpChannelWidth Integer32, 1372 docsIfUpChannelModulationProfile Unsigned32, 1373 docsIfUpChannelSlotSize Unsigned32, 1374 docsIfUpChannelTxTimingOffset Unsigned32, 1375 docsIfUpChannelRangingBackoffStart Integer32, 1376 docsIfUpChannelRangingBackoffEnd Integer32, 1377 docsIfUpChannelTxBackoffStart Integer32, 1378 docsIfUpChannelTxBackoffEnd Integer32, 1379 docsIfUpChannelScdmaActiveCodes Unsigned32, 1380 docsIfUpChannelScdmaCodesPerSlot Integer32, 1381 docsIfUpChannelScdmaFrameSize Unsigned32, 1382 docsIfUpChannelScdmaHoppingSeed Unsigned32, 1383 docsIfUpChannelType DocsisUpstreamType, 1384 docsIfUpChannelCloneFrom InterfaceIndexOrZero, 1385 docsIfUpChannelUpdate TruthValue, 1386 docsIfUpChannelStatus RowStatus, 1387 docsIfUpChannelPreEqEnable TruthValue 1388 } 1390 docsIfUpChannelId OBJECT-TYPE 1391 SYNTAX Integer32 (0..255) 1392 MAX-ACCESS read-only 1393 STATUS current 1394 DESCRIPTION 1395 "The CMTS identification of the upstream channel." 1396 ::= { docsIfUpstreamChannelEntry 1 } 1398 docsIfUpChannelFrequency OBJECT-TYPE 1399 SYNTAX Integer32 (0..1000000000) 1400 UNITS "hertz" 1401 MAX-ACCESS read-create 1402 STATUS current 1403 DESCRIPTION 1404 "The center of the frequency band associated with this 1405 upstream interface. This object returns 0 if the frequency 1406 is undefined or unknown. Minimum permitted upstream 1407 frequency is 5,000,000 Hz for current technology. See 1408 the associated conformance object for write conditions 1409 and limitations." 1410 REFERENCE 1411 "Data-Over-Cable Service Interface Specifications: Radio 1412 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1413 Table 4-2." 1414 ::= { docsIfUpstreamChannelEntry 2 } 1416 docsIfUpChannelWidth OBJECT-TYPE 1417 SYNTAX Integer32 (0..64000000) 1418 UNITS "hertz" 1419 MAX-ACCESS read-create 1420 STATUS current 1421 DESCRIPTION 1422 "The bandwidth of this upstream interface. This object 1423 returns 0 if the interface width is undefined or unknown. 1424 Minimum permitted interface width is 200,000 Hz currently. 1425 See the associated conformance object for write conditions 1426 and limitations." 1427 REFERENCE 1428 "Data-Over-Cable Service Interface Specifications: Radio 1429 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1430 Table 6-5." 1431 ::= { docsIfUpstreamChannelEntry 3 } 1433 docsIfUpChannelModulationProfile OBJECT-TYPE 1434 SYNTAX Unsigned32 1435 MAX-ACCESS read-create 1436 STATUS current 1437 DESCRIPTION 1438 "An entry identical to the docsIfModIndex in the 1439 docsIfCmtsModulationTable that describes this channel. 1440 This channel is further instantiated there by a grouping 1441 of interval usage codes (IUCs)which together fully describe 1442 the channel modulation. This object returns 0 if the 1443 docsIfCmtsModulationTable entry does not exist or is empty. 1444 See the associated conformance object for write conditions 1445 and limitations. 1447 Setting this object returns a genErr error if the 1448 following conditions are not satisfied: 1449 1. All the IUC entries in the selected modulation profile 1450 MUST have the same value of docsIfCmtsModChannelType. 1451 2. All of the Modulation parameters in the selected 1452 modulation profile MUST be consistent with the other 1453 parameters in this docsIfUpstreamChannelEntry." 1454 REFERENCE 1455 "Data-Over-Cable Service Interface Specifications: Radio 1456 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1457 Table 8-19." 1458 ::= { docsIfUpstreamChannelEntry 4 } 1460 docsIfUpChannelSlotSize OBJECT-TYPE 1461 SYNTAX Unsigned32 1462 MAX-ACCESS read-create 1463 STATUS current 1464 DESCRIPTION 1465 "Applicable to TDMA and ATDMA channel types only. 1466 The number of 6.25 microsecond ticks in each upstream 1467 mini-slot. Returns zero if the value is undefined, unknown 1468 or in case of an SCDMA channel. 1469 See the associated conformance object for write 1470 conditions and limitations." 1471 REFERENCE 1472 "Data-Over-Cable Service Interface Specifications: Radio 1473 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1474 Section 8.1.2.4." 1475 ::= { docsIfUpstreamChannelEntry 5 } 1477 docsIfUpChannelTxTimingOffset OBJECT-TYPE 1478 SYNTAX Unsigned32 1479 MAX-ACCESS read-only 1480 STATUS current 1481 DESCRIPTION 1482 "At the CM, a measure of the current round trip time 1483 obtained from the ranging offset (initial ranging offset + 1484 ranging offset adjustments). 1485 At the CMTS, the maximum of timing offset, among all the 1486 CMs that are/were present on the channel, taking into 1487 account all ( initial + periodic ) timing offset 1488 corrections that were sent for each of the CMs. Generally, 1489 these measurements are positive, but if the measurements 1490 are negative, the value of this object is zero. Used for 1491 timing of CM upstream transmissions to ensure synchronized 1492 arrivals at the CMTS. 1493 Units are in terms of (6.25 microseconds/64)." 1494 REFERENCE 1495 "Data-Over-Cable Service Interface Specifications: Radio 1496 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1497 Section 6.2.19." 1498 ::= { docsIfUpstreamChannelEntry 6 } 1500 docsIfUpChannelRangingBackoffStart OBJECT-TYPE 1501 SYNTAX Integer32 (0..16) 1502 MAX-ACCESS read-create 1503 STATUS current 1504 DESCRIPTION 1505 "The initial random backoff window to use when retrying 1506 Ranging Requests. Expressed as a power of 2. A value of 1507 16 at the CMTS indicates that a proprietary adaptive retry 1508 mechanism is to be used. See the associated conformance 1509 object for write conditions and limitations." 1510 REFERENCE 1511 "Data-Over-Cable Service Interface Specifications: Radio 1512 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1513 Sections 8.3.4, and 9.4." 1514 ::= { docsIfUpstreamChannelEntry 7 } 1516 docsIfUpChannelRangingBackoffEnd OBJECT-TYPE 1517 SYNTAX Integer32 (0..16) 1518 MAX-ACCESS read-create 1519 STATUS current 1520 DESCRIPTION 1521 "The final random backoff window to use when retrying 1522 Ranging Requests. Expressed as a power of 2. A value of 1523 16 at the CMTS indicates that a proprietary adaptive retry 1524 mechanism is to be used. See the associated conformance 1525 object for write conditions and limitations." 1526 REFERENCE 1527 "Data-Over-Cable Service Interface Specifications: Radio 1528 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1529 Section 8.3.4, and 9.4." 1530 ::= { docsIfUpstreamChannelEntry 8 } 1532 docsIfUpChannelTxBackoffStart OBJECT-TYPE 1533 SYNTAX Integer32 (0..16) 1534 MAX-ACCESS read-create 1535 STATUS current 1536 DESCRIPTION 1537 "The initial random backoff window to use when retrying 1538 transmissions. Expressed as a power of 2. A value of 16 1539 at the CMTS indicates that a proprietary adaptive retry 1540 mechanism is to be used. See the associated conformance 1541 object for write conditions and limitations." 1542 REFERENCE 1543 "Data-Over-Cable Service Interface Specifications: Radio 1544 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1545 Section 8.3.4, and 9.4." 1546 ::= { docsIfUpstreamChannelEntry 9 } 1548 docsIfUpChannelTxBackoffEnd OBJECT-TYPE 1549 SYNTAX Integer32 (0..16) 1550 MAX-ACCESS read-create 1551 STATUS current 1552 DESCRIPTION 1553 "The final random backoff window to use when retrying 1554 transmissions. Expressed as a power of 2. A value of 16 1555 at the CMTS indicates that a proprietary adaptive retry 1556 mechanism is to be used. See the associated conformance 1557 object for write conditions and limitations." 1558 REFERENCE 1559 "Data-Over-Cable Service Interface Specifications: Radio 1560 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1561 Section 8.3.4, and 9.4." 1562 ::= { docsIfUpstreamChannelEntry 10 } 1564 docsIfUpChannelScdmaActiveCodes OBJECT-TYPE 1565 SYNTAX Unsigned32 (0 | 64..128) 1566 MAX-ACCESS read-create 1567 STATUS current 1568 DESCRIPTION 1569 "Applicable for SCDMA channel types only. 1570 Number of active codes. Returns zero for 1571 Non-SCDMA channel types. Note that legal 1572 values from 64..128 MUST be non-prime." 1573 REFERENCE 1574 "Data-Over-Cable Service Interface Specifications: Radio 1575 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1576 Section 6.2.11.2.1." 1577 ::= { docsIfUpstreamChannelEntry 11 } 1579 docsIfUpChannelScdmaCodesPerSlot OBJECT-TYPE 1580 SYNTAX Integer32(0 | 2..32) 1581 MAX-ACCESS read-create 1582 STATUS current 1583 DESCRIPTION 1584 "Applicable for SCDMA channel types only. 1585 The number of SCDMA codes per mini-slot. 1586 Returns zero if the value is undefined, unknown or in 1587 case of a TDMA or ATDMA channel." 1588 REFERENCE 1589 "Data-Over-Cable Service Interface Specifications: Radio 1590 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1591 Section 6.2.11.2.1." 1592 ::= { docsIfUpstreamChannelEntry 12 } 1594 docsIfUpChannelScdmaFrameSize OBJECT-TYPE 1595 SYNTAX Unsigned32 (0..32) 1596 MAX-ACCESS read-create 1597 STATUS current 1598 DESCRIPTION 1599 "Applicable for SCDMA channel types only. 1600 SCDMA Frame size in units of spreading intervals. 1601 This value returns zero for non SCDMA Profiles." 1602 REFERENCE 1603 "Data-Over-Cable Service Interface Specifications: Radio 1604 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1605 Section 6.2.12." 1606 ::= { docsIfUpstreamChannelEntry 13 } 1608 docsIfUpChannelScdmaHoppingSeed OBJECT-TYPE 1609 SYNTAX Unsigned32 (0..32767) 1610 MAX-ACCESS read-create 1611 STATUS current 1612 DESCRIPTION 1613 "Applicable for SCDMA channel types only. 1614 15 bit seed used for code hopping sequence initialization. 1615 Returns zero for non-SCDMA channel types." 1616 REFERENCE 1617 "Data-Over-Cable Service Interface Specifications: Radio 1618 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1619 Section 6.2.14.1." 1620 ::= { docsIfUpstreamChannelEntry 14 } 1622 docsIfUpChannelType OBJECT-TYPE 1623 SYNTAX DocsisUpstreamType 1624 MAX-ACCESS read-only 1625 STATUS current 1626 DESCRIPTION 1627 "Reflects the Upstream channel type. 1628 This object returns the value of docsIfCmtsModChannelType 1629 for the modulation profile selected in 1630 docsIfUpChannelModulationProfile for this row." 1631 REFERENCE 1632 "Data-Over-Cable Service Interface Specifications: Radio 1633 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1634 Section 6.2.1." 1635 ::= { docsIfUpstreamChannelEntry 15 } 1637 docsIfUpChannelCloneFrom OBJECT-TYPE 1638 SYNTAX InterfaceIndexOrZero 1639 MAX-ACCESS read-create 1640 STATUS current 1641 DESCRIPTION 1642 "Intended for use when a temporary upstream 1643 row entry is created for the purpose of manipulating 1644 parameters for a physical upstream channel. 1645 Refer to the descriptions of docsIfUpChannelStatus and 1646 docsIfUpChannelUpdate for details of this procedure. 1648 This object contains the ifIndex value of the physical 1649 upstream row whose parameters are to be adjusted. 1651 Upon setting this object, the values of 1652 docsIfUpChannelFrequency, 1653 docsIfUpChannelWidth, 1654 docsIfUpChannelModulationProfile, 1655 docsIfUpChannelSlotSize, 1656 docsIfUpChannelRangingBackoffStart, 1657 docsIfUpChannelRangingBackoffEnd, 1658 docsIfUpChannelTxBackoffStart, 1659 docsIfUpChannelTxBackoffEnd, 1660 docsIfUpChannelScdmaActiveCodes, 1661 docsIfUpChannelScdmaCodesPerSlot, 1662 docsIfUpChannelScdmaFrameSize, 1663 docsIfUpChannelScdmaHoppingSeed, 1664 docsIfUpChannelType, and 1665 docsIfUpChannelPreEqEnable for this row are populated with 1666 the corresponding values from the row referenced by this 1667 object. Setting this object to a non-existent or temporary 1668 upstream returns an error wrongValue. 1669 This object MUST contain a value of zero for physical 1670 upstream rows." 1671 ::= { docsIfUpstreamChannelEntry 16 } 1673 docsIfUpChannelUpdate OBJECT-TYPE 1674 SYNTAX TruthValue 1675 MAX-ACCESS read-create 1676 STATUS current 1677 DESCRIPTION 1678 "Used to perform the transfer of adjusted parameters 1679 from the temporary upstream row to the physical upstream 1680 row indicated by the docsIfUpChannelCloneFrom object. The 1681 transfer is initiated by setting this object to 'true'. 1682 The SNMP SET returns an error-status value of 1683 genErr (SNMP v1) or commitFailed (SNMPv2c and v3) if the 1684 adjusted parameter values are not compatible with each 1685 other. Reading this object always return 'false'." 1686 ::= { docsIfUpstreamChannelEntry 17 } 1688 docsIfUpChannelStatus OBJECT-TYPE 1689 SYNTAX RowStatus 1690 MAX-ACCESS read-create 1691 STATUS current 1692 DESCRIPTION 1693 "This object is generally intended to be used for the 1694 creation of a temporary upstream row for the purpose 1695 of adjusting channel parameters of a physical upstream 1696 channel row. 1698 The following restrictions apply to this object: 1699 1. Entries with this object set to active(1) are 1700 logically linked to a defined physical interface in 1701 the interface MIB RFC 2863, no temporarily created to 1702 clone parameters. 1703 2. A status transition from active(1) to notInService(2) 1704 or destroy(6) is not permitted. 1705 3. ifAdminStatus from the Interface MIB RFC 2863 should be 1706 used to take an Upstream Channel offline. 1707 4. Temporary inactive rows must be created using 1708 createAndWait(5). 1710 5. The only possible status change of a row created using 1711 createAndWait(5) (i.e. notInService(2)) or notReady(3) 1712 is to destroy(6). 1713 6. Temporary created rows must never be given the status 1714 active(1). 1716 A Mandatory procedure for adjusting an specific physical 1717 Upstream channel is: 1718 1. Create a temporary row through an SNMP SET using 1719 createAndWait(5). Use an ifIndex value outside the 1720 operational range of the system. 1721 2. Set the docsIfUpChannelCloneFrom field to the ifIndex 1722 value of the physical row whose parameters require 1723 adjustment. 1724 3. Adjust the parameter values using the new temporary 1725 row. Ensure all parameters contain desired values 1726 before proceeding to step 4. 1727 4. Update the physical row by setting the object 1728 docsIfUpChannelUpdate to true(1). This operation fails 1729 with error genErr if the adjusted parameters are not 1730 compatible with each other. 1731 5. Delete the temporary row through an SNMP SET using 1732 DELETE." 1733 ::= { docsIfUpstreamChannelEntry 18 } 1735 docsIfUpChannelPreEqEnable OBJECT-TYPE 1736 SYNTAX TruthValue 1737 MAX-ACCESS read-create 1738 STATUS current 1739 DESCRIPTION 1740 "At the CMTS, used to enable or disable pre-equalization on 1741 the upstream channel represented by this table instance. 1742 At the CM, this object is read-only and reflects the 1743 status of pre-equalization as represented in the RNG-RSP. 1744 Pre-equalization is considered enabled at the CM if a 1745 RNG-RSP with pre-equalization data has been received at 1746 least once since the last mac reinit." 1747 DEFVAL {false} 1748 ::= { docsIfUpstreamChannelEntry 19 } 1750 -- The following table describes the attributes of each class of 1751 -- service. The entries in this table are referenced from the 1752 -- docsIfServiceEntries. They exist as a separate table in order to 1753 -- reduce redundant information in docsIfServiceTable. 1754 -- 1755 -- This table is implemented at both the CM and the CMTS. 1756 -- The CM need only maintain entries for the classes of service 1757 -- referenced by its docsIfServiceTable. 1758 -- 1760 docsIfQosProfileTable OBJECT-TYPE 1761 SYNTAX SEQUENCE OF DocsIfQosProfileEntry 1762 MAX-ACCESS not-accessible 1763 STATUS current 1764 DESCRIPTION 1765 "Describes the attributes for each class of service." 1766 ::= { docsIfBaseObjects 3 } 1768 docsIfQosProfileEntry OBJECT-TYPE 1769 SYNTAX DocsIfQosProfileEntry 1770 MAX-ACCESS not-accessible 1771 STATUS current 1772 DESCRIPTION 1773 "Describes the attributes for a single class of service. 1775 If implemented as read-create in the Cable Modem 1776 Termination System, creation of entries in this table is 1777 controlled by the value of 1778 docsIfCmtsQosProfilePermissions. 1780 If implemented as read-only, entries are created based 1781 on information in REG-REQ MAC messages received from 1782 Cable Modems (Cable Modem Termination System 1783 implementation), or based on information extracted from 1784 the TFTP option file (Cable Modem implementation). 1785 In the Cable Modem Termination system, read-only entries 1786 are removed if no longer referenced by 1787 docsIfCmtsServiceTable. 1789 An entry in this table must not be removed while it is 1790 referenced by an entry in docsIfCmServiceTable (Cable 1791 Modem) or docsIfCmtsServiceTable (Cable Modem Termination 1792 System). 1794 An entry in this table should not be changeable while 1795 it is referenced by an entry in docsIfCmtsServiceTable. 1797 If this table is created automatically, there should only 1798 be a single entry for each Class of Service. Multiple 1799 entries with the same Class of Service parameters are not 1800 recommended." 1801 INDEX { docsIfQosProfIndex } 1802 ::= { docsIfQosProfileTable 1 } 1804 DocsIfQosProfileEntry ::= SEQUENCE { 1805 docsIfQosProfIndex Integer32, 1806 docsIfQosProfPriority Integer32, 1807 docsIfQosProfMaxUpBandwidth Integer32, 1808 docsIfQosProfGuarUpBandwidth Integer32, 1809 docsIfQosProfMaxDownBandwidth Integer32, 1810 docsIfQosProfMaxTxBurst Integer32, -- deprecated 1811 docsIfQosProfBaselinePrivacy TruthValue, 1812 docsIfQosProfStatus RowStatus, 1813 docsIfQosProfMaxTransmitBurst Integer32 1814 } 1816 docsIfQosProfIndex OBJECT-TYPE 1817 SYNTAX Integer32 (1..16383) 1818 MAX-ACCESS not-accessible 1819 STATUS current 1820 DESCRIPTION 1821 "The index value that uniquely identifies an entry 1822 in the docsIfQosProfileTable." 1823 ::= { docsIfQosProfileEntry 1 } 1825 docsIfQosProfPriority OBJECT-TYPE 1826 SYNTAX Integer32 (0..7) 1827 MAX-ACCESS read-create 1828 STATUS current 1829 DESCRIPTION 1830 "A relative priority assigned to this service when 1831 allocating bandwidth. Zero indicates lowest priority 1832 and seven indicates highest priority. 1833 Interpretation of priority is device-specific. 1834 MUST NOT be changed while this row is active." 1835 REFERENCE 1836 "Data-Over-Cable Service Interface Specifications: Radio 1837 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1838 Appendix C.1.1.4." 1839 DEFVAL { 0 } 1840 ::= { docsIfQosProfileEntry 2 } 1842 docsIfQosProfMaxUpBandwidth OBJECT-TYPE 1843 SYNTAX Integer32 (0..100000000) 1844 UNITS "bits per second" 1845 MAX-ACCESS read-create 1846 STATUS current 1847 DESCRIPTION 1848 "The maximum upstream bandwidth, in bits per second, 1849 allowed for a service with this service class. 1850 Zero if there is no restriction of upstream bandwidth. 1851 MUST NOT be changed while this row is active." 1852 REFERENCE 1853 "Data-Over-Cable Service Interface Specifications: Radio 1854 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1855 Appendix C.1.1.4." 1857 DEFVAL { 0 } 1858 ::= { docsIfQosProfileEntry 3 } 1860 docsIfQosProfGuarUpBandwidth OBJECT-TYPE 1861 SYNTAX Integer32 (0..100000000) 1862 UNITS "bits per second" 1863 MAX-ACCESS read-create 1864 STATUS current 1865 DESCRIPTION 1866 "Minimum guaranteed upstream bandwidth, in bits per second, 1867 allowed for a service with this service class. 1868 MUST NOT be changed while this row is active." 1869 REFERENCE 1870 "Data-Over-Cable Service Interface Specifications: Radio 1871 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1872 Appendix C.1.1.4." 1873 DEFVAL { 0 } 1874 ::= { docsIfQosProfileEntry 4 } 1876 docsIfQosProfMaxDownBandwidth OBJECT-TYPE 1877 SYNTAX Integer32 (0..100000000) 1878 UNITS "bits per second" 1879 MAX-ACCESS read-create 1880 STATUS current 1881 DESCRIPTION 1882 "The maximum downstream bandwidth, in bits per second, 1883 allowed for a service with this service class. 1884 Zero if there is no restriction of downstream bandwidth. 1885 MUST NOT be changed while this row is active." 1886 REFERENCE 1887 "Data-Over-Cable Service Interface Specifications: Radio 1888 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1889 Appendix C.1.1.4." 1891 DEFVAL { 0 } 1892 ::= { docsIfQosProfileEntry 5 } 1894 docsIfQosProfMaxTxBurst OBJECT-TYPE 1895 SYNTAX Integer32 (0..255) 1896 UNITS "mini-slots" 1897 MAX-ACCESS read-create 1898 STATUS deprecated 1899 DESCRIPTION 1900 "The maximum number of mini-slots that may be requested 1901 for a single upstream transmission. 1902 A value of zero means there is no limit. 1903 MUST NOT be changed while this row is active. 1904 This object has been deprecated and replaced by 1905 docsIfQosProfMaxTransmitBurst, to fix a mismatch 1906 of the units and value range with respect to the DOCSIS 1907 Maximum Upstream Channel Transmit Burst Configuration 1908 Setting." 1909 REFERENCE 1910 "Data-Over-Cable Service Interface Specifications: Radio 1911 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1912 C.1.1.4." 1913 DEFVAL { 0 } 1914 ::= { docsIfQosProfileEntry 6 } 1916 docsIfQosProfBaselinePrivacy OBJECT-TYPE 1917 SYNTAX TruthValue 1918 MAX-ACCESS read-create 1919 STATUS current 1920 DESCRIPTION 1921 "Indicates whether Baseline Privacy is enabled for this 1922 service class. 1923 MUST NOT be changed while this row is active." 1924 DEFVAL { false } 1925 ::= { docsIfQosProfileEntry 7 } 1927 docsIfQosProfStatus OBJECT-TYPE 1928 SYNTAX RowStatus 1929 MAX-ACCESS read-create 1930 STATUS current 1931 DESCRIPTION 1932 "This is object is to used to create or delete rows in 1933 this table. This object MUST NOT be changed from active 1934 while the row is referenced by the any entry in either 1935 docsIfCmServiceTable (on the CM), or the 1936 docsIfCmtsServiceTable (on the CMTS)." 1937 ::= { docsIfQosProfileEntry 8 } 1939 docsIfQosProfMaxTransmitBurst OBJECT-TYPE 1940 SYNTAX Integer32 (0..65535) 1941 UNITS "bytes" 1942 MAX-ACCESS read-create 1943 STATUS current 1944 DESCRIPTION 1945 "The maximum number of bytes that may be requested for a 1946 single upstream transmission. A value of zero means there 1947 is no limit. Note: This value does not include any 1948 physical layer overhead. 1949 MUST NOT be changed while this row is active." 1950 REFERENCE 1951 "Data-Over-Cable Service Interface Specifications: Radio 1952 Frequency Interface Specification SP-RFIv2.0-I04-030730, 1953 Appendix C.1.1.4." 1954 DEFVAL { 0 } 1955 ::= { docsIfQosProfileEntry 9 } 1957 docsIfSignalQualityTable OBJECT-TYPE 1958 SYNTAX SEQUENCE OF DocsIfSignalQualityEntry 1959 MAX-ACCESS not-accessible 1960 STATUS current 1961 DESCRIPTION 1962 "At the CM, describes the PHY signal quality of downstream 1963 channels. At the CMTS, describes the PHY signal quality of 1964 upstream channels. At the CMTS, this table may exclude 1965 contention intervals." 1966 ::= { docsIfBaseObjects 4 } 1968 docsIfSignalQualityEntry OBJECT-TYPE 1969 SYNTAX DocsIfSignalQualityEntry 1970 MAX-ACCESS not-accessible 1971 STATUS current 1972 DESCRIPTION 1973 "At the CM, describes the PHY characteristics of a 1974 downstream channel. At the CMTS, describes the PHY signal 1975 quality of an upstream channel. 1976 An entry in this table exists for each ifEntry with an 1977 ifType of docsCableDownstream(128) for Cable Modems. 1978 For DOCSIS 1.1 Cable Modem Termination Systems, an entry 1979 exists for each ifEntry with an ifType of 1980 docsCableUpstream (129). 1981 For DOCSIS 2.0 Cable Modem Termination Systems, an entry 1982 exists for each ifEntry with an ifType of 1983 docsCableUpstreamChannel (205)." 1984 INDEX { ifIndex } 1985 ::= { docsIfSignalQualityTable 1 } 1987 DocsIfSignalQualityEntry ::= SEQUENCE { 1988 docsIfSigQIncludesContention TruthValue, 1989 docsIfSigQUnerroreds Counter32, 1990 docsIfSigQCorrecteds Counter32, 1991 docsIfSigQUncorrectables Counter32, 1992 docsIfSigQSignalNoise TenthdB, 1993 docsIfSigQMicroreflections Integer32, 1994 docsIfSigQEqualizationData OCTET STRING, 1995 docsIfSigQExtUnerroreds Counter64, 1996 docsIfSigQExtCorrecteds Counter64, 1997 docsIfSigQExtUncorrectables Counter64 1998 } 2000 docsIfSigQIncludesContention OBJECT-TYPE 2001 SYNTAX TruthValue 2002 MAX-ACCESS read-only 2003 STATUS current 2004 DESCRIPTION 2005 "true(1) if this CMTS includes contention intervals in 2006 the counters in this table. Always false(2) for CMs." 2007 REFERENCE 2008 "Data-Over-Cable Service Interface Specifications: Radio 2009 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2010 Section 9.4.1" 2011 ::= { docsIfSignalQualityEntry 1 } 2013 docsIfSigQUnerroreds OBJECT-TYPE 2014 SYNTAX Counter32 2015 UNITS "codewords" 2016 MAX-ACCESS read-only 2017 STATUS current 2018 DESCRIPTION 2019 "Codewords received on this channel without error. 2020 This includes all codewords, whether or not they 2021 were part of frames destined for this device. 2022 Discontinuities in the value of this counter can occur 2023 at reinitialization of the managed system, and at other 2024 times as indicated by the value of 2025 ifCounterDiscontinuityTime for the associated ifIndex." 2026 REFERENCE 2027 "Data-Over-Cable Service Interface Specifications: Radio 2028 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2029 Sections 6.2.4, and 6.3.6." 2030 ::= { docsIfSignalQualityEntry 2 } 2032 docsIfSigQCorrecteds OBJECT-TYPE 2033 SYNTAX Counter32 2034 UNITS "codewords" 2035 MAX-ACCESS read-only 2036 STATUS current 2037 DESCRIPTION 2038 "Codewords received on this channel with correctable 2039 errors. This includes all codewords, whether or not 2040 they were part of frames destined for this device. 2041 Discontinuities in the value of this counter can occur 2042 at reinitialization of the managed system, and at other 2043 times as indicated by the value of 2044 ifCounterDiscontinuityTime for the associated ifIndex." 2045 REFERENCE 2046 "Data-Over-Cable Service Interface Specifications: Radio 2047 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2048 Sections 6.2.4, and 6.3.6." 2049 ::= { docsIfSignalQualityEntry 3 } 2051 docsIfSigQUncorrectables OBJECT-TYPE 2052 SYNTAX Counter32 2053 UNITS "codewords" 2054 MAX-ACCESS read-only 2055 STATUS current 2056 DESCRIPTION 2057 "Codewords received on this channel with uncorrectable 2058 errors. This includes all codewords, whether or not 2059 they were part of frames destined for this device. 2060 Discontinuities in the value of this counter can occur 2061 at reinitialization of the managed system, and at other 2062 times as indicated by the value of 2063 ifCounterDiscontinuityTime for the associated ifIndex." 2064 REFERENCE 2065 "Data-Over-Cable Service Interface Specifications: Radio 2066 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2067 Sections 6.2.4, and 6.3.6." 2068 ::= { docsIfSignalQualityEntry 4 } 2070 docsIfSigQSignalNoise OBJECT-TYPE 2071 SYNTAX TenthdB 2072 UNITS "dB" 2073 MAX-ACCESS read-only 2074 STATUS current 2075 DESCRIPTION 2076 "Signal/Noise ratio as perceived for this channel. 2077 At the CM, describes the Signal/Noise of the downstream 2078 channel. At the CMTS, describes the average Signal/Noise 2079 of the upstream channel." 2080 REFERENCE 2081 "Data-Over-Cable Service Interface Specifications: Radio 2082 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2083 Tables 4-1 and 4-2" 2084 ::= { docsIfSignalQualityEntry 5 } 2086 docsIfSigQMicroreflections OBJECT-TYPE 2087 SYNTAX Integer32 (0..255) 2088 UNITS "dBc" 2089 MAX-ACCESS read-only 2090 STATUS current 2091 DESCRIPTION 2092 "Total microreflections including in-channel response 2093 as perceived on this interface, measured in dBc below 2094 the signal level. 2095 This object is not assumed to return an absolutely 2096 accurate value, but should give a rough indication 2097 of microreflections received on this interface. 2098 It is up to the implementer to provide information 2099 as accurate as possible. 2100 Discontinuities in the value of this counter can occur 2101 at reinitialization of the managed system, and at other 2102 times as indicated by the value of 2103 ifCounterDiscontinuityTime for the associated ifIndex." 2104 REFERENCE 2105 "Data-Over-Cable Service Interface Specifications: Radio 2106 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2107 Tables 4-1 and 4-2" 2108 ::= { docsIfSignalQualityEntry 6 } 2110 docsIfSigQEqualizationData OBJECT-TYPE 2111 SYNTAX OCTET STRING (SIZE (0..512)) 2112 MAX-ACCESS read-only 2113 STATUS current 2114 DESCRIPTION 2115 "At the CM, returns the equalization data for the 2116 downstream channel. At the CMTS, returns the average 2117 equalization data for the upstream channel. Returns an 2118 empty string if the value is unknown or if there is no 2119 equalization data available or defined." 2120 REFERENCE 2121 "Data-Over-Cable Service Interface Specifications: Radio 2122 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2123 Section 6.2.15." 2124 ::= { docsIfSignalQualityEntry 7 } 2126 docsIfSigQExtUnerroreds OBJECT-TYPE 2127 SYNTAX Counter64 2128 UNITS "codewords" 2129 MAX-ACCESS read-only 2130 STATUS current 2131 DESCRIPTION 2132 "Codewords received on this channel without error. 2133 This includes all codewords, whether or not they 2134 were part of frames destined for this device. 2135 This is the 64 bit version of docsIfSigQUnerroreds. 2136 Discontinuities in the value of this counter can occur 2137 at reinitialization of the managed system, and at other 2138 times as indicated by the value of 2139 ifCounterDiscontinuityTime for the associated ifIndex." 2140 REFERENCE 2141 "Data-Over-Cable Service Interface Specifications: Radio 2142 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2143 Sections 6.2.4, and 6.3.6." 2144 ::= { docsIfSignalQualityEntry 8 } 2146 docsIfSigQExtCorrecteds OBJECT-TYPE 2147 SYNTAX Counter64 2148 UNITS "codewords" 2149 MAX-ACCESS read-only 2150 STATUS current 2151 DESCRIPTION 2152 "Codewords received on this channel with correctable 2153 errors. This includes all codewords, whether or not 2154 they were part of frames destined for this device. 2155 This is the 64 bit version of docsIfSigQCorrecteds. 2156 Discontinuities in the value of this counter can occur 2157 at reinitialization of the managed system, and at other 2158 times as indicated by the value of 2159 ifCounterDiscontinuityTime for the associated ifIndex." 2160 REFERENCE 2161 "Data-Over-Cable Service Interface Specifications: Radio 2162 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2163 Sections 6.2.4, and 6.3.6." 2164 ::= { docsIfSignalQualityEntry 9 } 2166 docsIfSigQExtUncorrectables OBJECT-TYPE 2167 SYNTAX Counter64 2168 UNITS "codewords" 2169 MAX-ACCESS read-only 2170 STATUS current 2171 DESCRIPTION 2172 "Codewords received on this channel with uncorrectable 2173 errors. This includes all codewords, whether or not 2174 they were part of frames destined for this device. 2175 This is the 64 bit version of docsIfSigQUncorrectables. 2176 Discontinuities in the value of this counter can occur 2177 at reinitialization of the managed system, and at other 2178 times as indicated by the value of 2179 ifCounterDiscontinuityTime for the associated ifIndex." 2180 REFERENCE 2181 "Data-Over-Cable Service Interface Specifications: Radio 2182 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2183 Sections 6.2.4, 6.3.6." 2184 ::= { docsIfSignalQualityEntry 10 } 2186 -- 2187 -- DOCSIS Version of the device 2188 -- 2190 docsIfDocsisBaseCapability OBJECT-TYPE 2191 SYNTAX DocsisVersion 2192 MAX-ACCESS read-only 2193 STATUS current 2194 DESCRIPTION 2195 "Indication of the DOCSIS capability of the device." 2196 REFERENCE 2197 "Data-Over-Cable Service Interface Specifications: Radio 2198 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2199 Annex G." 2200 ::= { docsIfBaseObjects 5 } 2202 -- 2203 -- CABLE MODEM GROUP 2204 -- 2206 -- ####### 2208 -- 2209 -- The CM MAC Table 2210 -- 2212 docsIfCmMacTable OBJECT-TYPE 2213 SYNTAX SEQUENCE OF DocsIfCmMacEntry 2214 MAX-ACCESS not-accessible 2215 STATUS current 2216 DESCRIPTION 2217 "Describes the attributes of each CM MAC interface, 2218 extending the information available from ifEntry." 2219 ::= { docsIfCmObjects 1 } 2221 docsIfCmMacEntry OBJECT-TYPE 2222 SYNTAX DocsIfCmMacEntry 2223 MAX-ACCESS not-accessible 2224 STATUS current 2225 DESCRIPTION 2226 "An entry containing objects describing attributes of 2227 each MAC entry, extending the information in ifEntry. 2228 An entry in this table exists for each ifEntry with an 2229 ifType of docsCableMaclayer(127)." 2230 INDEX { ifIndex } 2231 ::= { docsIfCmMacTable 1 } 2233 DocsIfCmMacEntry ::= SEQUENCE { 2234 docsIfCmCmtsAddress MacAddress, 2235 docsIfCmCapabilities BITS, 2236 docsIfCmRangingRespTimeout TimeTicks, 2237 docsIfCmRangingTimeout TimeInterval 2238 } 2240 docsIfCmCmtsAddress OBJECT-TYPE 2241 SYNTAX MacAddress 2242 MAX-ACCESS read-only 2243 STATUS current 2244 DESCRIPTION 2245 "Identifies the CMTS that is believed to control this MAC 2246 domain. At the CM, this will be the source address from 2247 SYNC, MAP, and other MAC-layer messages. If the CMTS is 2248 unknown, returns 00-00-00-00-00-00." 2249 REFERENCE 2250 "Data-Over-Cable Service Interface Specifications: Radio 2251 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2252 Section 8.2.2." 2253 ::= { docsIfCmMacEntry 1 } 2255 docsIfCmCapabilities OBJECT-TYPE 2256 SYNTAX BITS { 2257 atmCells(0), 2258 concatenation(1) 2259 } 2260 MAX-ACCESS read-only 2261 STATUS current 2262 DESCRIPTION 2263 "Identifies the capabilities of the MAC implementation 2264 at this interface. Note that packet transmission is 2265 always supported. Therefore, there is no specific bit 2266 required to explicitly indicate this capability. 2267 Note that BITS objects are encoded most significant bit 2268 first. For example, if bit 1 is set, the value of this 2269 object is the octet string '40'H." 2270 ::= { docsIfCmMacEntry 2 } 2272 -- This object has been obsoleted and replaced by 2273 -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New 2274 -- implementations of the MIB should use docsIfCmRangingTimeout 2275 -- instead. 2277 docsIfCmRangingRespTimeout OBJECT-TYPE 2278 SYNTAX TimeTicks 2279 MAX-ACCESS read-write 2280 STATUS obsolete 2281 DESCRIPTION 2282 "Waiting time for a Ranging Response packet." 2283 REFERENCE 2284 "Data-Over-Cable Service Interface Specifications: Radio 2285 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2286 Section 9.1.6." 2287 DEFVAL { 20 } 2288 ::= { docsIfCmMacEntry 3 } 2290 docsIfCmRangingTimeout OBJECT-TYPE 2291 SYNTAX TimeInterval 2292 MAX-ACCESS read-write 2293 STATUS current 2294 DESCRIPTION 2295 "Waiting time for a Ranging Response packet." 2296 REFERENCE 2297 "Data-Over-Cable Service Interface Specifications: Radio 2298 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2299 Section 9.1.6, timer T3." 2300 DEFVAL { 20 } 2301 ::= { docsIfCmMacEntry 4 } 2303 -- 2304 -- CM status table. 2305 -- This table is implemented only at the CM. 2306 -- 2308 docsIfCmStatusTable OBJECT-TYPE 2309 SYNTAX SEQUENCE OF DocsIfCmStatusEntry 2310 MAX-ACCESS not-accessible 2311 STATUS current 2312 DESCRIPTION 2313 "This table maintains a number of status objects 2314 and counters for Cable Modems." 2315 ::= { docsIfCmObjects 2 } 2317 docsIfCmStatusEntry OBJECT-TYPE 2318 SYNTAX DocsIfCmStatusEntry 2319 MAX-ACCESS not-accessible 2320 STATUS current 2321 DESCRIPTION 2322 "A set of status objects and counters for a single MAC 2323 layer instance in a Cable Modem. 2324 An entry in this table exists for each ifEntry with an 2325 ifType of docsCableMaclayer(127)." 2326 INDEX { ifIndex } 2327 ::= { docsIfCmStatusTable 1 } 2329 DocsIfCmStatusEntry ::= SEQUENCE { 2330 docsIfCmStatusValue INTEGER, 2331 docsIfCmStatusCode OCTET STRING, 2332 docsIfCmStatusTxPower TenthdBmV, 2333 docsIfCmStatusResets Counter32, 2334 docsIfCmStatusLostSyncs Counter32, 2335 docsIfCmStatusInvalidMaps Counter32, 2336 docsIfCmStatusInvalidUcds Counter32, 2337 docsIfCmStatusInvalidRangingResponses Counter32, 2338 docsIfCmStatusInvalidRegistrationResponses Counter32, 2339 docsIfCmStatusT1Timeouts Counter32, 2340 docsIfCmStatusT2Timeouts Counter32, 2341 docsIfCmStatusT3Timeouts Counter32, 2342 docsIfCmStatusT4Timeouts Counter32, 2343 docsIfCmStatusRangingAborteds Counter32, 2344 docsIfCmStatusDocsisOperMode DocsisQosVersion, 2345 docsIfCmStatusModulationType DocsisUpstreamTypeStatus, 2346 docsIfCmStatusEqualizationData OCTET STRING, 2347 docsIfCmStatusUCCs Counter32, 2348 docsIfCmStatusUCCFails Counter32 2349 } 2351 docsIfCmStatusValue OBJECT-TYPE 2352 SYNTAX INTEGER { 2353 other(1), 2354 notReady(2), 2355 notSynchronized(3), 2356 phySynchronized(4), 2357 usParametersAcquired(5), 2358 rangingComplete(6), 2359 ipComplete(7), 2360 todEstablished(8), 2361 securityEstablished(9), 2362 paramTransferComplete(10), 2363 registrationComplete(11), 2364 operational(12), 2365 accessDenied(13) 2366 } 2367 MAX-ACCESS read-only 2368 STATUS current 2369 DESCRIPTION 2370 "Current Cable Modem connectivity state, as specified 2371 in the RF Interface Specification. Interpretations for 2372 state values 1-12 are clearly outlined in the SP-RFI 2373 reference given below. 2374 As stated in the description for object 2375 docsIfCmtsCmStatusValue, accessDenied(13)indicates the 2376 CMTS has sent a Registration Aborted message to the CM." 2377 REFERENCE 2378 "Data-Over-Cable Service Interface Specifications: Radio 2379 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2380 Section 11.2. 2381 Data-Over-Cable Service Interface Specifications: 2382 Operations Support System Interface Specification 2383 SP-OSSIv2.0-IO4-030730, Section 6.3.4.2." 2384 ::= { docsIfCmStatusEntry 1 } 2386 docsIfCmStatusCode OBJECT-TYPE 2387 SYNTAX OCTET STRING (SIZE (0..16)) 2388 MAX-ACCESS read-only 2389 STATUS current 2390 DESCRIPTION 2391 "Status code for this Cable Modem as defined in the 2392 OSSI Specification. The status code consists 2393 of a single character indicating error groups, followed 2394 by a two- or three-digit number indicating the status 2395 condition, followed by a decimal." 2396 REFERENCE 2397 "Data-Over-Cable Service Interface Specifications: 2398 Operations Support System Interface Specification 2399 SP-OSSIv2.0-I04-030730, Annex D." 2400 ::= { docsIfCmStatusEntry 2 } 2402 docsIfCmStatusTxPower OBJECT-TYPE 2403 SYNTAX TenthdBmV 2404 UNITS "dBmV" 2405 MAX-ACCESS read-only 2406 STATUS current 2407 DESCRIPTION 2408 "The operational transmit power for the attached upstream 2409 channel." 2410 REFERENCE 2411 "Data-Over-Cable Service Interface Specifications: Radio 2412 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2413 Section 6.2.18." 2414 ::= { docsIfCmStatusEntry 3 } 2416 docsIfCmStatusResets OBJECT-TYPE 2417 SYNTAX Counter32 2418 MAX-ACCESS read-only 2419 STATUS current 2420 DESCRIPTION 2421 "Number of times the CM reset or initialized this 2422 interface." 2423 ::= { docsIfCmStatusEntry 4 } 2425 docsIfCmStatusLostSyncs OBJECT-TYPE 2426 SYNTAX Counter32 2427 MAX-ACCESS read-only 2428 STATUS current 2429 DESCRIPTION 2430 "Number of times the CM lost synchronization with 2431 the downstream channel. 2432 Discontinuities in the value of this counter can occur 2433 at reinitialization of the managed system, and at other 2434 times as indicated by the value of 2435 ifCounterDiscontinuityTime for the associated ifIndex." 2436 REFERENCE 2437 "Data-Over-Cable Service Interface Specifications: Radio 2438 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2439 Section 8.3.2." 2440 ::= { docsIfCmStatusEntry 5 } 2442 docsIfCmStatusInvalidMaps OBJECT-TYPE 2443 SYNTAX Counter32 2444 MAX-ACCESS read-only 2445 STATUS current 2446 DESCRIPTION 2447 "Number of times the CM received invalid MAP messages. 2448 Discontinuities in the value of this counter can occur 2449 at reinitialization of the managed system, and at other 2450 times as indicated by the value of 2451 ifCounterDiscontinuityTime for the associated ifIndex." 2452 REFERENCE 2453 "Data-Over-Cable Service Interface Specifications: Radio 2454 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2455 Section 8.3.4." 2456 ::= { docsIfCmStatusEntry 6 } 2458 docsIfCmStatusInvalidUcds OBJECT-TYPE 2459 SYNTAX Counter32 2460 MAX-ACCESS read-only 2461 STATUS current 2462 DESCRIPTION 2463 "Number of times the CM received invalid UCD messages. 2464 Discontinuities in the value of this counter can occur 2465 at reinitialization of the managed system, and at other 2466 times as indicated by the value of 2467 ifCounterDiscontinuityTime for the associated ifIndex." 2468 REFERENCE 2469 "Data-Over-Cable Service Interface Specifications: Radio 2470 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2471 Section 8.3.3." 2472 ::= { docsIfCmStatusEntry 7 } 2474 docsIfCmStatusInvalidRangingResponses OBJECT-TYPE 2475 SYNTAX Counter32 2476 MAX-ACCESS read-only 2477 STATUS current 2478 DESCRIPTION 2479 "Number of times the CM received invalid ranging response 2480 messages. 2481 Discontinuities in the value of this counter can occur 2482 at reinitialization of the managed system, and at other 2483 times as indicated by the value of 2484 ifCounterDiscontinuityTime for the associated ifIndex." 2485 REFERENCE 2486 "Data-Over-Cable Service Interface Specifications: Radio 2487 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2488 Section 8.3.6." 2489 ::= { docsIfCmStatusEntry 8 } 2491 docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE 2492 SYNTAX Counter32 2493 MAX-ACCESS read-only 2494 STATUS current 2495 DESCRIPTION 2496 "Number of times the CM received invalid registration 2497 response messages. 2498 Discontinuities in the value of this counter can occur 2499 at reinitialization of the managed system, and at other 2500 times as indicated by the value of 2501 ifCounterDiscontinuityTime for the associated ifIndex." 2502 REFERENCE 2503 "Data-Over-Cable Service Interface Specifications: Radio 2504 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2505 Section 8.3.8." 2506 ::= { docsIfCmStatusEntry 9 } 2508 docsIfCmStatusT1Timeouts OBJECT-TYPE 2509 SYNTAX Counter32 2510 MAX-ACCESS read-only 2511 STATUS current 2512 DESCRIPTION 2513 "Number of times counter T1 expired in the CM. 2514 Discontinuities in the value of this counter can occur 2515 at reinitialization of the managed system, and at other 2516 times as indicated by the value of 2517 ifCounterDiscontinuityTime for the associated ifIndex." 2518 REFERENCE 2519 "Data-Over-Cable Service Interface Specifications: Radio 2520 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2521 Figure 9-2." 2522 ::= { docsIfCmStatusEntry 10 } 2524 docsIfCmStatusT2Timeouts OBJECT-TYPE 2525 SYNTAX Counter32 2526 MAX-ACCESS read-only 2527 STATUS current 2528 DESCRIPTION 2529 "Number of times counter T2 expired in the CM. 2530 Discontinuities in the value of this counter can occur 2531 at reinitialization of the managed system, and at other 2532 times as indicated by the value of 2533 ifCounterDiscontinuityTime for the associated ifIndex." 2534 REFERENCE 2535 "Data-Over-Cable Service Interface Specifications: Radio 2536 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2537 Figure 9-2." 2538 ::= { docsIfCmStatusEntry 11 } 2540 docsIfCmStatusT3Timeouts OBJECT-TYPE 2541 SYNTAX Counter32 2542 MAX-ACCESS read-only 2543 STATUS current 2544 DESCRIPTION 2545 "Number of times counter T3 expired in the CM. 2546 Discontinuities in the value of this counter can occur 2547 at reinitialization of the managed system, and at other 2548 times as indicated by the value of 2549 ifCounterDiscontinuityTime for the associated ifIndex." 2550 REFERENCE 2551 "Data-Over-Cable Service Interface Specifications: Radio 2552 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2553 Figure 9-2." 2554 ::= { docsIfCmStatusEntry 12 } 2556 docsIfCmStatusT4Timeouts OBJECT-TYPE 2557 SYNTAX Counter32 2558 MAX-ACCESS read-only 2559 STATUS current 2560 DESCRIPTION 2561 "Number of times counter T4 expired in the CM. 2562 Discontinuities in the value of this counter can occur 2563 at reinitialization of the managed system, and at other 2564 times as indicated by the value of 2565 ifCounterDiscontinuityTime for the associated ifIndex." 2566 REFERENCE 2567 "Data-Over-Cable Service Interface Specifications: Radio 2568 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2569 Figure 9-2." 2570 ::= { docsIfCmStatusEntry 13 } 2572 docsIfCmStatusRangingAborteds OBJECT-TYPE 2573 SYNTAX Counter32 2574 MAX-ACCESS read-only 2575 STATUS current 2576 DESCRIPTION 2577 "Number of times the ranging process was aborted 2578 by the CMTS. 2579 Discontinuities in the value of this counter can occur 2580 at reinitialization of the managed system, and at other 2581 times as indicated by the value of 2582 ifCounterDiscontinuityTime for the associated ifIndex." 2583 REFERENCE 2584 "Data-Over-Cable Service Interface Specifications: Radio 2585 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2586 Section 9.3.3." 2587 ::= { docsIfCmStatusEntry 14 } 2589 docsIfCmStatusDocsisOperMode OBJECT-TYPE 2590 SYNTAX DocsisQosVersion 2591 MAX-ACCESS read-only 2592 STATUS current 2593 DESCRIPTION 2594 "Indication whether the device has registered using 1.0 2595 Class of Service or 1.1 Quality of Service. 2596 An unregistered CM should indicate 'docsis11' for a 2597 docsIfDocsisBaseCapability value of DOCSIS 1.1/2.0. An 2598 unregistered CM should indicate 'docsis10' for a 2599 docsIfDocsisBaseCapability value of DOCSIS 1.0." 2600 REFERENCE 2601 "Data-Over-Cable Service Interface Specifications: Radio 2602 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2603 Annex G." 2604 ::= { docsIfCmStatusEntry 15 } 2606 docsIfCmStatusModulationType OBJECT-TYPE 2607 SYNTAX DocsisUpstreamTypeStatus 2608 MAX-ACCESS read-only 2609 STATUS current 2610 DESCRIPTION 2611 "Indicates modulation type status currently used by the 2612 CM. Since this object specifically identifies PHY mode, 2613 the shared upstream channel type is not permitted." 2614 REFERENCE 2615 "Data-Over-Cable Service Interface Specifications: Radio 2616 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2617 Section 6.2.1." 2619 ::= { docsIfCmStatusEntry 16 } 2621 docsIfCmStatusEqualizationData OBJECT-TYPE 2622 SYNTAX OCTET STRING (SIZE (0..512)) 2623 MAX-ACCESS read-only 2624 STATUS current 2625 DESCRIPTION 2626 "Pre-equalization data for this CM after convolution with 2627 data indicated in the RNG-RSP. This data is valid when 2628 docsIfUpChannelPreEqEnable is set to true. The 2629 value should be formatted as defined in the following 2630 REFERENCE, beginning with the main tap location field. 2631 The type and length fields shown in the referenced figure 2632 must not be included. 2633 Returns an empty string if the value is unknown or if 2634 there is no equalization data available or defined." 2635 REFERENCE 2636 "Data-Over-Cable Service Interface Specifications: Radio 2637 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2638 Figure 8-23." 2639 ::= { docsIfCmStatusEntry 17 } 2641 docsIfCmStatusUCCs OBJECT-TYPE 2642 SYNTAX Counter32 2643 MAX-ACCESS read-only 2644 STATUS current 2645 DESCRIPTION 2646 "The number of successful Upstream Channel Change 2647 transactions. 2648 Discontinuities in the value of this counter can occur 2649 at reinitialization of the managed system, and at other 2650 times as indicated by the value of 2651 ifCounterDiscontinuityTime for the associated ifIndex." 2652 ::= { docsIfCmStatusEntry 18 } 2654 docsIfCmStatusUCCFails OBJECT-TYPE 2655 SYNTAX Counter32 2656 MAX-ACCESS read-only 2657 STATUS current 2658 DESCRIPTION 2659 "The number of failed Upstream Channel Change 2660 transactions. 2661 Discontinuities in the value of this counter can occur 2662 at reinitialization of the managed system, and at other 2663 times as indicated by the value of 2664 ifCounterDiscontinuityTime for the associated ifIndex." 2665 ::= { docsIfCmStatusEntry 19 } 2667 -- 2668 -- The Cable Modem Service Table 2669 -- 2671 docsIfCmServiceTable OBJECT-TYPE 2672 SYNTAX SEQUENCE OF DocsIfCmServiceEntry 2673 MAX-ACCESS not-accessible 2674 STATUS current 2675 DESCRIPTION 2676 "Describes the attributes of each upstream service queue 2677 on a CM." 2678 ::= { docsIfCmObjects 3 } 2680 docsIfCmServiceEntry OBJECT-TYPE 2681 SYNTAX DocsIfCmServiceEntry 2682 MAX-ACCESS not-accessible 2683 STATUS current 2684 DESCRIPTION 2685 "Describes the attributes of an upstream bandwidth service 2686 queue. 2687 An entry in this table exists for each Service ID. 2688 The primary index is an ifIndex with an ifType of 2689 docsCableMaclayer(127)." 2690 INDEX { ifIndex, docsIfCmServiceId } 2691 ::= { docsIfCmServiceTable 1 } 2693 DocsIfCmServiceEntry ::= SEQUENCE { 2694 docsIfCmServiceId Integer32, 2695 docsIfCmServiceQosProfile Integer32, 2696 docsIfCmServiceTxSlotsImmed Counter32, 2697 docsIfCmServiceTxSlotsDed Counter32, 2698 docsIfCmServiceTxRetries Counter32, 2699 docsIfCmServiceTxExceededs Counter32, 2700 docsIfCmServiceRqRetries Counter32, 2701 docsIfCmServiceRqExceededs Counter32, 2702 docsIfCmServiceExtTxSlotsImmed Counter64, 2703 docsIfCmServiceExtTxSlotsDed Counter64 2704 } 2706 docsIfCmServiceId OBJECT-TYPE 2707 SYNTAX Integer32 (1..16383) 2708 MAX-ACCESS not-accessible 2709 STATUS current 2710 DESCRIPTION 2711 "Identifies a service queue for upstream bandwidth. The 2712 attributes of this service queue are shared between the 2713 CM and the CMTS. The CMTS allocates upstream bandwidth 2714 to this service queue based on requests from the CM and 2715 on the class of service associated with this queue." 2716 ::= { docsIfCmServiceEntry 1 } 2718 docsIfCmServiceQosProfile OBJECT-TYPE 2719 SYNTAX Integer32 (0..16383) 2720 MAX-ACCESS read-only 2721 STATUS current 2722 DESCRIPTION 2723 "The index in docsIfQosProfileTable describing the quality 2724 of service attributes associated with this particular 2725 service. If no associated entry in docsIfQosProfileTable 2726 exists, this object returns a value of zero." 2727 ::= { docsIfCmServiceEntry 2 } 2729 docsIfCmServiceTxSlotsImmed OBJECT-TYPE 2730 SYNTAX Counter32 2731 UNITS "mini-slots" 2732 MAX-ACCESS read-only 2733 STATUS current 2734 DESCRIPTION 2735 "The number of upstream mini-slots which have been used to 2736 transmit data PDUs in immediate (contention) mode. This 2737 includes only those PDUs that are presumed to have 2738 arrived at the headend (i.e., those which were explicitly 2739 acknowledged.) It does not include retransmission attempts 2740 or mini-slots used by Requests. 2741 Discontinuities in the value of this counter can occur 2742 at reinitialization of the managed system, and at other 2743 times as indicated by the value of 2744 ifCounterDiscontinuityTime for the associated ifIndex." 2745 REFERENCE 2746 "Data-Over-Cable Service Interface Specifications: Radio 2747 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2748 Section 9.4." 2749 ::= { docsIfCmServiceEntry 3 } 2751 docsIfCmServiceTxSlotsDed OBJECT-TYPE 2752 SYNTAX Counter32 2753 UNITS "mini-slots" 2754 MAX-ACCESS read-only 2755 STATUS current 2756 DESCRIPTION 2757 "The number of upstream mini-slots which have been used to 2758 transmit data PDUs in dedicated mode (i.e., as a result 2759 of a unicast Data Grant). 2760 Discontinuities in the value of this counter can occur 2761 at reinitialization of the managed system, and at other 2762 times as indicated by the value of 2763 ifCounterDiscontinuityTime for the associated ifIndex." 2764 REFERENCE 2765 "Data-Over-Cable Service Interface Specifications: Radio 2766 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2767 Section 9.4." 2768 ::= { docsIfCmServiceEntry 4 } 2770 docsIfCmServiceTxRetries OBJECT-TYPE 2771 SYNTAX Counter32 2772 MAX-ACCESS read-only 2773 STATUS current 2774 DESCRIPTION 2775 "The number of attempts to transmit data PDUs containing 2776 requests for acknowledgment that did not result in 2777 acknowledgment. 2778 Discontinuities in the value of this counter can occur 2779 at reinitialization of the managed system, and at other 2780 times as indicated by the value of 2781 ifCounterDiscontinuityTime for the associated ifIndex." 2782 REFERENCE 2783 "Data-Over-Cable Service Interface Specifications: Radio 2784 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2785 Section 9.4." 2786 ::= { docsIfCmServiceEntry 5 } 2788 docsIfCmServiceTxExceededs OBJECT-TYPE 2789 SYNTAX Counter32 2790 MAX-ACCESS read-only 2791 STATUS current 2792 DESCRIPTION 2793 "The number of data PDUs transmission failures due to 2794 excessive retries without acknowledgment. 2795 Discontinuities in the value of this counter can occur 2796 at reinitialization of the managed system, and at other 2797 times as indicated by the value of 2798 ifCounterDiscontinuityTime for the associated ifIndex." 2799 REFERENCE 2800 "Data-Over-Cable Service Interface Specifications: Radio 2801 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2802 Section 9.4." 2803 ::= { docsIfCmServiceEntry 6 } 2805 docsIfCmServiceRqRetries OBJECT-TYPE 2806 SYNTAX Counter32 2807 MAX-ACCESS read-only 2808 STATUS current 2809 DESCRIPTION 2810 "The number of attempts to transmit bandwidth requests 2811 which did not result in acknowledgment. 2812 Discontinuities in the value of this counter can occur 2813 at reinitialization of the managed system, and at other 2814 times as indicated by the value of 2815 ifCounterDiscontinuityTime for the associated ifIndex." 2816 REFERENCE 2817 "Data-Over-Cable Service Interface Specifications: Radio 2818 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2819 Section 9.4." 2821 ::= { docsIfCmServiceEntry 7 } 2823 docsIfCmServiceRqExceededs OBJECT-TYPE 2824 SYNTAX Counter32 2825 MAX-ACCESS read-only 2826 STATUS current 2827 DESCRIPTION 2828 "The number of requests for bandwidth which failed due to 2829 excessive retries without acknowledgment. 2830 Discontinuities in the value of this counter can occur 2831 at reinitialization of the managed system, and at other 2832 times as indicated by the value of 2833 ifCounterDiscontinuityTime for the associated ifIndex." 2834 REFERENCE 2835 "Data-Over-Cable Service Interface Specifications: Radio 2836 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2837 Section 9.4." 2838 ::= { docsIfCmServiceEntry 8 } 2840 docsIfCmServiceExtTxSlotsImmed OBJECT-TYPE 2841 SYNTAX Counter64 2842 UNITS "mini-slots" 2843 MAX-ACCESS read-only 2844 STATUS current 2845 DESCRIPTION 2846 "The number of upstream mini-slots which have been used to 2847 transmit data PDUs in immediate (contention) mode. This 2848 includes only those PDUs that are presumed to have 2849 arrived at the headend (i.e., those which were explicitly 2850 acknowledged.) It does not include retransmission attempts 2851 or mini-slots used by Requests. 2852 Discontinuities in the value of this counter can occur 2853 at reinitialization of the managed system, and at other 2854 times as indicated by the value of 2855 ifCounterDiscontinuityTime for the associated ifIndex." 2856 REFERENCE 2857 "Data-Over-Cable Service Interface Specifications: Radio 2858 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2859 Section 9.4." 2860 ::= { docsIfCmServiceEntry 9 } 2862 docsIfCmServiceExtTxSlotsDed OBJECT-TYPE 2863 SYNTAX Counter64 2864 UNITS "mini-slots" 2865 MAX-ACCESS read-only 2866 STATUS current 2867 DESCRIPTION 2868 "The number of upstream mini-slots which have been used to 2869 transmit data PDUs in dedicated mode (i.e., as a result 2870 of a unicast Data Grant). 2872 Discontinuities in the value of this counter can occur 2873 at reinitialization of the managed system, and at other 2874 times as indicated by the value of 2875 ifCounterDiscontinuityTime for the associated ifIndex." 2876 REFERENCE 2877 "Data-Over-Cable Service Interface Specifications: Radio 2878 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2879 Section 9.4." 2880 ::= { docsIfCmServiceEntry 10 } 2882 -- 2883 -- CMTS GROUP 2884 -- 2886 -- 2887 -- The CMTS MAC Table 2888 -- 2890 docsIfCmtsMacTable OBJECT-TYPE 2891 SYNTAX SEQUENCE OF DocsIfCmtsMacEntry 2892 MAX-ACCESS not-accessible 2893 STATUS current 2894 DESCRIPTION 2895 "Describes the attributes of each CMTS MAC interface, 2896 extending the information available from ifEntry. 2897 Mandatory for all CMTS devices." 2898 ::= { docsIfCmtsObjects 1 } 2900 docsIfCmtsMacEntry OBJECT-TYPE 2901 SYNTAX DocsIfCmtsMacEntry 2902 MAX-ACCESS not-accessible 2903 STATUS current 2904 DESCRIPTION 2905 "An entry containing objects describing attributes of each 2906 MAC entry, extending the information in ifEntry. 2907 An entry in this table exists for each ifEntry with an 2908 ifType of docsCableMaclayer(127)." 2909 INDEX { ifIndex } 2910 ::= { docsIfCmtsMacTable 1 } 2912 DocsIfCmtsMacEntry ::= SEQUENCE { 2913 docsIfCmtsCapabilities BITS, 2914 docsIfCmtsSyncInterval Integer32, 2915 docsIfCmtsUcdInterval Integer32, 2916 docsIfCmtsMaxServiceIds Integer32, 2917 docsIfCmtsInsertionInterval TimeTicks, -- Obsolete 2918 docsIfCmtsInvitedRangingAttempts Integer32, 2919 docsIfCmtsInsertInterval TimeInterval 2920 } 2922 docsIfCmtsCapabilities OBJECT-TYPE 2923 SYNTAX BITS { 2924 atmCells(0), 2925 concatenation(1) 2926 } 2927 MAX-ACCESS read-only 2928 STATUS current 2929 DESCRIPTION 2930 "Identifies the capabilities of the CMTS MAC 2931 implementation at this interface. Note that packet 2932 transmission is always supported. Therefore, there 2933 is no specific bit required to explicitly indicate 2934 this capability. 2935 Note that BITS objects are encoded most significant bit 2936 first. For example, if bit 1 is set, the value of this 2937 object is the octet string '40'H." 2938 ::= { docsIfCmtsMacEntry 1 } 2940 docsIfCmtsSyncInterval OBJECT-TYPE 2941 SYNTAX Integer32 (1..200) 2942 UNITS "Milliseconds" 2943 MAX-ACCESS read-write 2944 STATUS current 2945 DESCRIPTION 2946 "The interval between CMTS transmission of successive SYNC 2947 messages at this interface." 2948 REFERENCE 2949 "Data-Over-Cable Service Interface Specifications: Radio 2950 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2951 Section 9.3." 2952 ::= { docsIfCmtsMacEntry 2 } 2954 docsIfCmtsUcdInterval OBJECT-TYPE 2955 SYNTAX Integer32 (1..2000) 2956 UNITS "Milliseconds" 2957 MAX-ACCESS read-write 2958 STATUS current 2959 DESCRIPTION 2960 "The interval between CMTS transmission of successive 2961 Upstream Channel Descriptor messages for each upstream 2962 channel at this interface." 2963 REFERENCE 2964 "Data-Over-Cable Service Interface Specifications: Radio 2965 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2966 Section 9.3" 2967 ::= { docsIfCmtsMacEntry 3 } 2969 docsIfCmtsMaxServiceIds OBJECT-TYPE 2970 SYNTAX Integer32 (1..16383) 2971 MAX-ACCESS read-only 2972 STATUS current 2973 DESCRIPTION 2974 "The maximum number of service IDs that may be 2975 simultaneously active." 2976 ::= { docsIfCmtsMacEntry 4 } 2978 -- This object has been obsoleted and replaced by 2979 -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem. New 2980 -- implementations of this MIB should use that object instead. 2981 docsIfCmtsInsertionInterval OBJECT-TYPE 2982 SYNTAX TimeTicks 2983 MAX-ACCESS read-write 2984 STATUS obsolete 2985 DESCRIPTION 2986 "The amount of time to elapse between each broadcast 2987 initial maintenance grant. Broadcast initial maintenance 2988 grants are used to allow new cable modems to join the 2989 network. Zero indicates that a vendor-specific algorithm 2990 is used instead of a fixed time. Maximum amount of time 2991 permitted by the specification is 2 seconds." 2992 REFERENCE 2993 "Data-Over-Cable Service Interface Specifications: Radio 2994 Frequency Interface Specification SP-RFIv2.0-I04-030730, 2995 Annex B." 2996 ::= { docsIfCmtsMacEntry 5 } 2998 docsIfCmtsInvitedRangingAttempts OBJECT-TYPE 2999 SYNTAX Integer32 (0..1024) 3000 MAX-ACCESS read-write 3001 STATUS current 3002 DESCRIPTION 3003 "The maximum number of attempts to make on invitations 3004 for ranging requests. A value of zero means the system 3005 should attempt to range forever." 3006 REFERENCE 3007 "Data-Over-Cable Service Interface Specifications: Radio 3008 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3009 Section 9.3.3 and Annex B." 3010 ::= { docsIfCmtsMacEntry 6 } 3012 docsIfCmtsInsertInterval OBJECT-TYPE 3013 SYNTAX TimeInterval 3014 MAX-ACCESS read-write 3015 STATUS current 3016 DESCRIPTION 3017 "The amount of time to elapse between each broadcast 3018 initial maintenance grant. Broadcast initial maintenance 3019 grants are used to allow new cable modems to join the 3020 network. Zero indicates that a vendor-specific algorithm 3021 is used instead of a fixed time. Maximum amount of time 3022 permitted by the specification is 2 seconds." 3023 REFERENCE 3024 "Data-Over-Cable Service Interface Specifications: Radio 3025 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3026 Annex B." 3027 ::= { docsIfCmtsMacEntry 7 } 3029 -- 3030 -- 3031 -- CMTS status table. 3032 -- 3034 docsIfCmtsStatusTable OBJECT-TYPE 3035 SYNTAX SEQUENCE OF DocsIfCmtsStatusEntry 3036 MAX-ACCESS not-accessible 3037 STATUS current 3038 DESCRIPTION 3039 "For the MAC layer, this group maintains a number of 3040 status objects and counters." 3041 ::= { docsIfCmtsObjects 2 } 3043 docsIfCmtsStatusEntry OBJECT-TYPE 3044 SYNTAX DocsIfCmtsStatusEntry 3045 MAX-ACCESS not-accessible 3046 STATUS current 3047 DESCRIPTION 3048 "Status entry for a single MAC layer. 3049 An entry in this table exists for each ifEntry with an 3050 ifType of docsCableMaclayer(127)." 3051 INDEX { ifIndex } 3052 ::= { docsIfCmtsStatusTable 1 } 3054 DocsIfCmtsStatusEntry ::= SEQUENCE { 3055 docsIfCmtsStatusInvalidRangeReqs Counter32, 3056 docsIfCmtsStatusRangingAborteds Counter32, 3057 docsIfCmtsStatusInvalidRegReqs Counter32, 3058 docsIfCmtsStatusFailedRegReqs Counter32, 3059 docsIfCmtsStatusInvalidDataReqs Counter32, 3060 docsIfCmtsStatusT5Timeouts Counter32 3061 } 3063 docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE 3064 SYNTAX Counter32 3065 MAX-ACCESS read-only 3066 STATUS current 3067 DESCRIPTION 3068 "This object counts invalid RNG-REQ messages received on 3069 this interface. 3070 Discontinuities in the value of this counter can occur 3071 at reinitialization of the managed system, and at other 3072 times as indicated by the value of 3073 ifCounterDiscontinuityTime for the associated ifIndex." 3074 REFERENCE 3075 "Data-Over-Cable Service Interface Specifications: Radio 3076 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3077 Section 8.3.5." 3079 ::= { docsIfCmtsStatusEntry 1 } 3081 docsIfCmtsStatusRangingAborteds OBJECT-TYPE 3082 SYNTAX Counter32 3083 MAX-ACCESS read-only 3084 STATUS current 3085 DESCRIPTION 3086 "This object counts ranging attempts that were explicitly 3087 aborted by the CMTS. 3088 Discontinuities in the value of this counter can occur 3089 at reinitialization of the managed system, and at other 3090 times as indicated by the value of 3091 ifCounterDiscontinuityTime for the associated ifIndex." 3092 REFERENCE 3093 "Data-Over-Cable Service Interface Specifications: Radio 3094 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3095 Section 8.3.6." 3096 ::= { docsIfCmtsStatusEntry 2 } 3098 docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE 3099 SYNTAX Counter32 3100 MAX-ACCESS read-only 3101 STATUS current 3102 DESCRIPTION 3103 "This object counts invalid REG-REQ messages received on 3104 this interface. That is, syntax, out of range parameters, 3105 or erroneous requests. 3106 Discontinuities in the value of this counter can occur 3107 at reinitialization of the managed system, and at other 3108 times as indicated by the value of 3109 ifCounterDiscontinuityTime for the associated ifIndex." 3110 REFERENCE 3111 "Data-Over-Cable Service Interface Specifications: Radio 3112 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3113 Section 8.3.7." 3114 ::= { docsIfCmtsStatusEntry 3 } 3116 docsIfCmtsStatusFailedRegReqs OBJECT-TYPE 3117 SYNTAX Counter32 3118 MAX-ACCESS read-only 3119 STATUS current 3120 DESCRIPTION 3121 "This object counts failed registration attempts. Included 3122 are docsIfCmtsStatusInvalidRegReqs, authentication and 3123 class of service failures. 3124 Discontinuities in the value of this counter can occur 3125 at reinitialization of the managed system, and at other 3126 times as indicated by the value of 3127 ifCounterDiscontinuityTime for the associated ifIndex." 3128 REFERENCE 3129 "Data-Over-Cable Service Interface Specifications: Radio 3130 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3131 Section 8.3.7." 3132 ::= { docsIfCmtsStatusEntry 4 } 3134 docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE 3135 SYNTAX Counter32 3136 MAX-ACCESS read-only 3137 STATUS current 3138 DESCRIPTION 3139 "This object counts invalid data request messages 3140 received on this interface. 3141 Discontinuities in the value of this counter can occur 3142 at reinitialization of the managed system, and at other 3143 times as indicated by the value of 3144 ifCounterDiscontinuityTime for the associated ifIndex." 3145 ::= { docsIfCmtsStatusEntry 5 } 3147 docsIfCmtsStatusT5Timeouts OBJECT-TYPE 3148 SYNTAX Counter32 3149 MAX-ACCESS read-only 3150 STATUS current 3151 DESCRIPTION 3152 "This object counts the number of times counter T5 3153 expired on this interface. 3154 Discontinuities in the value of this counter can occur 3155 at reinitialization of the managed system, and at other 3156 times as indicated by the value of 3157 ifCounterDiscontinuityTime for the associated ifIndex." 3158 REFERENCE 3159 "Data-Over-Cable Service Interface Specifications: Radio 3160 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3161 Figure 9-2." 3162 ::= { docsIfCmtsStatusEntry 6 } 3164 -- 3165 -- CM status table (within CMTS). 3166 -- This table is implemented only at the CMTS. 3167 -- It contains per CM status information available in the CMTS. 3168 -- 3170 docsIfCmtsCmStatusTable OBJECT-TYPE 3171 SYNTAX SEQUENCE OF DocsIfCmtsCmStatusEntry 3172 MAX-ACCESS not-accessible 3173 STATUS current 3174 DESCRIPTION 3175 "A set of objects in the CMTS, maintained for each 3176 Cable Modem connected to this CMTS." 3177 ::= { docsIfCmtsObjects 3 } 3179 docsIfCmtsCmStatusEntry OBJECT-TYPE 3180 SYNTAX DocsIfCmtsCmStatusEntry 3181 MAX-ACCESS not-accessible 3182 STATUS current 3183 DESCRIPTION 3184 "Status information for a single Cable Modem. 3185 An entry in this table exists for each Cable Modem 3186 that is connected to the CMTS implementing this table." 3187 INDEX { docsIfCmtsCmStatusIndex } 3188 ::= { docsIfCmtsCmStatusTable 1 } 3190 DocsIfCmtsCmStatusEntry ::= SEQUENCE { 3191 docsIfCmtsCmStatusIndex Integer32, 3192 docsIfCmtsCmStatusMacAddress MacAddress, 3193 docsIfCmtsCmStatusIpAddress IpAddress, -- deprecated 3194 docsIfCmtsCmStatusDownChannelIfIndex InterfaceIndexOrZero, 3195 docsIfCmtsCmStatusUpChannelIfIndex InterfaceIndexOrZero, 3196 docsIfCmtsCmStatusRxPower TenthdBmV, 3197 docsIfCmtsCmStatusTimingOffset Unsigned32, 3198 docsIfCmtsCmStatusEqualizationData OCTET STRING, 3199 docsIfCmtsCmStatusValue INTEGER, 3200 docsIfCmtsCmStatusUnerroreds Counter32, 3201 docsIfCmtsCmStatusCorrecteds Counter32, 3202 docsIfCmtsCmStatusUncorrectables Counter32, 3203 docsIfCmtsCmStatusSignalNoise TenthdB, 3204 docsIfCmtsCmStatusMicroreflections Integer32, 3205 docsIfCmtsCmStatusExtUnerroreds Counter64, 3206 docsIfCmtsCmStatusExtCorrecteds Counter64, 3207 docsIfCmtsCmStatusExtUncorrectables Counter64, 3208 docsIfCmtsCmStatusDocsisRegMode DocsisQosVersion, 3209 docsIfCmtsCmStatusModulationType DocsisUpstreamTypeStatus, 3210 docsIfCmtsCmStatusInetAddressType InetAddressType, 3211 docsIfCmtsCmStatusInetAddress InetAddress, 3212 docsIfCmtsCmStatusValueLastUpdate TimeStamp, 3213 docsIfCmtsCmStatusHighResolutionTimingOffset Unsigned32 3214 } 3216 docsIfCmtsCmStatusIndex OBJECT-TYPE 3217 SYNTAX Integer32 (1..2147483647) 3218 MAX-ACCESS not-accessible 3219 STATUS current 3220 DESCRIPTION 3221 "Index value to uniquely identify an entry in this table. 3222 For an individual Cable Modem, this index value should 3223 not change during CMTS uptime." 3225 ::= { docsIfCmtsCmStatusEntry 1 } 3227 docsIfCmtsCmStatusMacAddress OBJECT-TYPE 3228 SYNTAX MacAddress 3229 MAX-ACCESS read-only 3230 STATUS current 3231 DESCRIPTION 3232 "MAC address of this Cable Modem. If the Cable Modem has 3233 multiple MAC addresses, this is the MAC address associated 3234 with the Cable interface." 3235 REFERENCE 3236 "Data-Over-Cable Service Interface Specifications: Radio 3237 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3238 Section 8.2.2." 3239 ::= { docsIfCmtsCmStatusEntry 2 } 3241 docsIfCmtsCmStatusIpAddress OBJECT-TYPE 3242 SYNTAX IpAddress 3243 MAX-ACCESS read-only 3244 STATUS deprecated 3245 DESCRIPTION 3246 "IP address of this Cable Modem. If the Cable Modem has no 3247 IP address assigned, or the IP address is unknown, this 3248 object returns a value of 0.0.0.0. If the Cable Modem has 3249 multiple IP addresses, this object returns the IP address 3250 associated with the Cable interface. 3251 This object has been deprecated and replaced by 3252 docsIfCmtsCmStatusInetAddressType and 3253 docsIfCmtsCmStatusInetAddress, to enable IPv6 addressing 3254 in the future." 3255 ::= { docsIfCmtsCmStatusEntry 3 } 3257 docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE 3258 SYNTAX InterfaceIndexOrZero 3259 MAX-ACCESS read-only 3260 STATUS current 3261 DESCRIPTION 3262 "IfIndex of the downstream channel this CM is connected 3263 to. If the downstream channel is unknown, this object 3264 returns a value of zero." 3265 ::= { docsIfCmtsCmStatusEntry 4 } 3267 docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE 3268 SYNTAX InterfaceIndexOrZero 3269 MAX-ACCESS read-only 3270 STATUS current 3271 DESCRIPTION 3272 "IfIndex of the upstream channel this CM is connected 3273 to. If the upstream channel is unknown, this object 3274 returns a value of zero." 3275 ::= { docsIfCmtsCmStatusEntry 5 } 3277 docsIfCmtsCmStatusRxPower OBJECT-TYPE 3278 SYNTAX TenthdBmV 3279 UNITS "dBmV" 3280 MAX-ACCESS read-only 3281 STATUS current 3282 DESCRIPTION 3283 "The receive power as perceived for upstream data from 3284 this Cable Modem. 3285 If the receive power is unknown, this object returns 3286 a value of zero." 3287 REFERENCE 3288 "Data-Over-Cable Service Interface Specifications: Radio 3289 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3290 Section 6.2.18." 3291 ::= { docsIfCmtsCmStatusEntry 6 } 3293 docsIfCmtsCmStatusTimingOffset OBJECT-TYPE 3294 SYNTAX Unsigned32 (0..4294967295) 3295 MAX-ACCESS read-only 3296 STATUS current 3297 DESCRIPTION 3298 "A measure of the current round trip time for this CM. 3299 Used for timing of CM upstream transmissions to ensure 3300 synchronized arrivals at the CMTS. Units are in terms 3301 of (6.25 microseconds/64). Returns zero if the value 3302 is unknown. 3303 For channels requiring finer resolution, please refer to 3304 object docsIfCmtsCmStatusHighResolutionTimingOffset." 3305 REFERENCE 3306 "Data-Over-Cable Service Interface Specifications: Radio 3307 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3308 Section 6.2.17." 3309 ::= { docsIfCmtsCmStatusEntry 7 } 3311 docsIfCmtsCmStatusEqualizationData OBJECT-TYPE 3312 SYNTAX OCTET STRING (SIZE (0..512)) 3313 MAX-ACCESS read-only 3314 STATUS current 3315 DESCRIPTION 3316 "Equalization data for this CM. Returns an empty string 3317 if the value is unknown or if there is no equalization 3318 data available or defined." 3319 REFERENCE 3320 "Data-Over-Cable Service Interface Specifications: Radio 3321 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3322 Figure 8-23." 3323 ::= { docsIfCmtsCmStatusEntry 8 } 3325 docsIfCmtsCmStatusValue OBJECT-TYPE 3326 SYNTAX INTEGER { 3327 other(1), 3328 ranging(2), 3329 rangingAborted(3), 3330 rangingComplete(4), 3331 ipComplete(5), 3332 registrationComplete(6), 3333 accessDenied(7), 3334 operational(8), -- deprecated 3335 registeredBPIInitializing(9) 3336 } 3337 MAX-ACCESS read-only 3338 STATUS current 3339 DESCRIPTION 3340 "Current Cable Modem connectivity state, as specified 3341 in the RF Interface Specification. Returned status 3342 information is the CM status as assumed by the CMTS, 3343 and indicates the following events: 3344 other(1) 3345 Any state other than below. 3346 ranging(2) 3347 The CMTS has received an Initial Ranging Request 3348 message from the CM, and the ranging process is not 3349 yet complete. 3350 rangingAborted(3) 3351 The CMTS has sent a Ranging Abort message to the CM. 3352 rangingComplete(4) 3353 The CMTS has sent a Ranging Complete message to the CM. 3354 ipComplete(5) 3355 The CMTS has received a DHCP reply message and 3356 forwarded it to the CM. 3357 registrationComplete(6) 3358 The CMTS has sent a Registration Response message to 3359 the CM. 3360 accessDenied(7) 3361 The CMTS has sent a Registration Aborted message 3362 to the CM. 3363 operational(8) -- deprecated value 3364 This value has been deprecated in favor of the more 3365 Specific registeredBPIInitializing(9). 3366 registeredBPIInitializing(9) 3367 Baseline Privacy (BPI) is enabled and the CMTS is in the 3368 process of completing BPI initialization. This state 3369 may last for a significant length of time if failures 3370 occur during the initialization process. After 3371 completion of BPI initialization, the CMTS will report 3372 registrationComplete(6). 3373 The CMTS only needs to report states it is able to 3374 detect." 3375 REFERENCE 3376 "Data-Over-Cable Service Interface Specifications: Radio 3377 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3378 Section 11.2." 3379 ::= { docsIfCmtsCmStatusEntry 9 } 3381 docsIfCmtsCmStatusUnerroreds OBJECT-TYPE 3382 SYNTAX Counter32 3383 MAX-ACCESS read-only 3384 STATUS current 3385 DESCRIPTION 3386 "Codewords received without error from this Cable Modem. 3387 Discontinuities in the value of this counter can occur 3388 at reinitialization of the managed system, and at other 3389 times as indicated by the value of 3390 ifCounterDiscontinuityTime for the associated ifIndex." 3391 REFERENCE 3392 "Data-Over-Cable Service Interface Specifications: Radio 3393 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3394 Section 6.2.4." 3395 ::= { docsIfCmtsCmStatusEntry 10 } 3397 docsIfCmtsCmStatusCorrecteds OBJECT-TYPE 3398 SYNTAX Counter32 3399 MAX-ACCESS read-only 3400 STATUS current 3401 DESCRIPTION 3402 "Codewords received with correctable errors from this 3403 Cable Modem. 3404 Discontinuities in the value of this counter can occur 3405 at reinitialization of the managed system, and at other 3406 times as indicated by the value of 3407 ifCounterDiscontinuityTime for the associated ifIndex." 3408 REFERENCE 3409 "Data-Over-Cable Service Interface Specifications: Radio 3410 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3411 Section 6.2.4." 3412 ::= { docsIfCmtsCmStatusEntry 11 } 3414 docsIfCmtsCmStatusUncorrectables OBJECT-TYPE 3415 SYNTAX Counter32 3416 MAX-ACCESS read-only 3417 STATUS current 3418 DESCRIPTION 3419 "Codewords received with uncorrectable errors from this 3420 Cable Modem. 3421 Discontinuities in the value of this counter can occur 3422 at reinitialization of the managed system, and at other 3423 times as indicated by the value of 3424 ifCounterDiscontinuityTime for the associated ifIndex." 3425 REFERENCE 3426 "Data-Over-Cable Service Interface Specifications: Radio 3427 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3428 Section 6.2.4." 3430 ::= { docsIfCmtsCmStatusEntry 12 } 3432 docsIfCmtsCmStatusSignalNoise OBJECT-TYPE 3433 SYNTAX TenthdB 3434 UNITS "dB" 3435 MAX-ACCESS read-only 3436 STATUS current 3437 DESCRIPTION 3438 "Signal/Noise ratio as perceived for upstream data from 3439 this Cable Modem. 3440 If the Signal/Noise is unknown, this object returns 3441 a value of zero." 3442 REFERENCE 3443 "Data-Over-Cable Service Interface Specifications: Radio 3444 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3445 Tables 4-1 and 4-2." 3446 ::= { docsIfCmtsCmStatusEntry 13 } 3448 docsIfCmtsCmStatusMicroreflections OBJECT-TYPE 3449 SYNTAX Integer32 (0..255) 3450 UNITS "dBc" 3451 MAX-ACCESS read-only 3452 STATUS current 3453 DESCRIPTION 3454 "Total microreflections including in-channel response 3455 as perceived on this interface, measured in dBc below 3456 the signal level. 3457 This object is not assumed to return an absolutely 3458 accurate value, but should give a rough indication 3459 of microreflections received on this interface. 3460 It is up to the implementer to provide information 3461 as accurate as possible. 3462 Discontinuities in the value of this counter can occur 3463 at reinitialization of the managed system, and at other 3464 times as indicated by the value of 3465 ifCounterDiscontinuityTime for the associated ifIndex." 3466 REFERENCE 3467 "Data-Over-Cable Service Interface Specifications: Radio 3468 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3469 Tables 4-1 and 4-2" 3470 ::= { docsIfCmtsCmStatusEntry 14 } 3472 docsIfCmtsCmStatusExtUnerroreds OBJECT-TYPE 3473 SYNTAX Counter64 3474 MAX-ACCESS read-only 3475 STATUS current 3476 DESCRIPTION 3477 "Codewords received without error from this Cable Modem. 3478 Discontinuities in the value of this counter can occur 3479 at reinitialization of the managed system, and at other 3480 times as indicated by the value of 3481 ifCounterDiscontinuityTime for the associated ifIndex." 3482 REFERENCE 3483 "Data-Over-Cable Service Interface Specifications: Radio 3484 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3485 Section 6.2.5." 3486 ::= { docsIfCmtsCmStatusEntry 15 } 3488 docsIfCmtsCmStatusExtCorrecteds OBJECT-TYPE 3489 SYNTAX Counter64 3490 MAX-ACCESS read-only 3491 STATUS current 3492 DESCRIPTION 3493 "Codewords received with correctable errors from this 3494 Cable Modem. 3495 Discontinuities in the value of this counter can occur 3496 at reinitialization of the managed system, and at other 3497 times as indicated by the value of 3498 ifCounterDiscontinuityTime for the associated ifIndex." 3499 REFERENCE 3500 "Data-Over-Cable Service Interface Specifications: Radio 3501 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3502 Section 6.2.5." 3503 ::= { docsIfCmtsCmStatusEntry 16 } 3505 docsIfCmtsCmStatusExtUncorrectables OBJECT-TYPE 3506 SYNTAX Counter64 3507 MAX-ACCESS read-only 3508 STATUS current 3509 DESCRIPTION 3510 "Codewords received with uncorrectable errors from this 3511 Cable Modem. 3512 Discontinuities in the value of this counter can occur 3513 at reinitialization of the managed system, and at other 3514 times as indicated by the value of 3515 ifCounterDiscontinuityTime for the associated ifIndex." 3516 REFERENCE 3517 "Data-Over-Cable Service Interface Specifications: Radio 3518 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3519 Section 6.2.5." 3520 ::= { docsIfCmtsCmStatusEntry 17 } 3522 docsIfCmtsCmStatusDocsisRegMode OBJECT-TYPE 3523 SYNTAX DocsisQosVersion 3524 MAX-ACCESS read-only 3525 STATUS current 3526 DESCRIPTION 3527 "Indication whether the CM has registered using 1.0 3528 Class of Service or 1.1 Quality of Service." 3529 REFERENCE 3530 "Data-Over-Cable Service Interface Specifications: Radio 3531 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3532 Annex G." 3533 ::= { docsIfCmtsCmStatusEntry 18 } 3535 docsIfCmtsCmStatusModulationType OBJECT-TYPE 3536 SYNTAX DocsisUpstreamTypeStatus 3537 MAX-ACCESS read-only 3538 STATUS current 3539 DESCRIPTION 3540 "Indicates modulation type currently used by the CM. Since 3541 this object specifically identifies PHY mode, the shared 3542 type is not permitted. If the upstream channel is 3543 unknown, this object returns a value of zero." 3544 REFERENCE 3545 "Data-Over-Cable Service Interface Specifications: Radio 3546 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3547 Table 8-19." 3548 ::= { docsIfCmtsCmStatusEntry 19 } 3550 docsIfCmtsCmStatusInetAddressType OBJECT-TYPE 3551 SYNTAX InetAddressType 3552 MAX-ACCESS read-only 3553 STATUS current 3554 DESCRIPTION 3555 "The type of internet address of 3556 docsIfCmtsCmStatusInetAddress. If the cable modem 3557 Internet address is unassigned or unknown, then the 3558 value of this object is unknown(0)." 3559 ::= { docsIfCmtsCmStatusEntry 20 } 3561 docsIfCmtsCmStatusInetAddress OBJECT-TYPE 3562 SYNTAX InetAddress 3563 MAX-ACCESS read-only 3564 STATUS current 3565 DESCRIPTION 3566 "Internet address of this Cable Modem. If the Cable 3567 Modem has no Internet address assigned, or the Internet 3568 address is unknown, the value of this object is the 3569 empty string. If the Cable Modem has multiple Internet 3570 addresses, this object returns the Internet address 3571 associated with the Cable (i.e. RF MAC) interface." 3572 ::= { docsIfCmtsCmStatusEntry 21 } 3574 docsIfCmtsCmStatusValueLastUpdate OBJECT-TYPE 3575 SYNTAX TimeStamp 3576 MAX-ACCESS read-only 3577 STATUS current 3578 DESCRIPTION 3579 "The value of sysUpTime when docsIfCmtsCmStatusValue 3580 was last updated." 3581 ::= { docsIfCmtsCmStatusEntry 22 } 3583 docsIfCmtsCmStatusHighResolutionTimingOffset OBJECT-TYPE 3584 SYNTAX Unsigned32 (0..4294967295) 3585 MAX-ACCESS read-only 3586 STATUS current 3587 DESCRIPTION 3588 "A measure of the current round trip time for this CM. 3589 Used for timing of CM upstream transmissions to ensure 3590 synchronized arrivals at the CMTS. Units are in terms 3591 of (6.25 microseconds/(64*256)). Returns zero if the value 3592 is unknown. 3593 This is the high resolution version of object 3594 docsIfCmtsCmStatusTimingOffset, for channels requiring 3595 finer resolution." 3596 REFERENCE 3597 "Data-Over-Cable Service Interface Specifications: Radio 3598 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3599 Section 6.2.17." 3600 ::= { docsIfCmtsCmStatusEntry 23 } 3602 -- 3603 -- The CMTS Service Table. 3604 -- 3606 docsIfCmtsServiceTable OBJECT-TYPE 3607 SYNTAX SEQUENCE OF DocsIfCmtsServiceEntry 3608 MAX-ACCESS not-accessible 3609 STATUS current 3610 DESCRIPTION 3611 "Describes the attributes of upstream service queues 3612 in a Cable Modem Termination System." 3613 ::= { docsIfCmtsObjects 4 } 3615 docsIfCmtsServiceEntry OBJECT-TYPE 3616 SYNTAX DocsIfCmtsServiceEntry 3617 MAX-ACCESS not-accessible 3618 STATUS current 3619 DESCRIPTION 3620 "Describes the attributes of a single upstream bandwidth 3621 service queue. 3622 Entries in this table exist for each ifEntry with an 3623 ifType of docsCableMaclayer(127), and for each service 3624 queue (Service ID) within this MAC layer. 3625 Entries in this table are created with the creation of 3626 individual Service IDs by the MAC layer and removed 3627 when a Service ID is removed." 3628 INDEX { ifIndex, docsIfCmtsServiceId } 3629 ::= { docsIfCmtsServiceTable 1 } 3631 DocsIfCmtsServiceEntry ::= SEQUENCE { 3632 docsIfCmtsServiceId Integer32, 3633 docsIfCmtsServiceCmStatusIndex Integer32, -- deprecated 3634 docsIfCmtsServiceAdminStatus INTEGER, 3635 docsIfCmtsServiceQosProfile Integer32, 3636 docsIfCmtsServiceCreateTime TimeStamp, 3637 docsIfCmtsServiceInOctets Counter32, 3638 docsIfCmtsServiceInPackets Counter32, 3639 docsIfCmtsServiceNewCmStatusIndex Integer32 3640 } 3642 docsIfCmtsServiceId OBJECT-TYPE 3643 SYNTAX Integer32 (1..16383) 3644 MAX-ACCESS not-accessible 3645 STATUS current 3646 DESCRIPTION 3647 "Identifies a service queue for upstream bandwidth. The 3648 attributes of this service queue are shared between the 3649 Cable Modem and the Cable Modem Termination System. 3650 The CMTS allocates upstream bandwidth to this service 3651 queue based on requests from the CM and on the class of 3652 service associated with this queue." 3653 ::= { docsIfCmtsServiceEntry 1 } 3655 docsIfCmtsServiceCmStatusIndex OBJECT-TYPE 3656 SYNTAX Integer32 (0..65535) 3657 MAX-ACCESS read-only 3658 STATUS deprecated 3659 DESCRIPTION 3660 "Pointer to an entry in docsIfCmtsCmStatusTable identifying 3661 the Cable Modem using this Service Queue. If multiple 3662 Cable Modems are using this Service Queue, the value of 3663 this object is zero. 3664 This object has been deprecated and replaced by 3665 docsIfCmtsServiceNewCmStatusIndex, to fix a mismatch 3666 of the value range with respect to docsIfCmtsCmStatusIndex 3667 (1..2147483647)." 3668 ::= { docsIfCmtsServiceEntry 2 } 3670 docsIfCmtsServiceAdminStatus OBJECT-TYPE 3671 SYNTAX INTEGER { 3672 enabled(1), 3673 disabled(2), 3674 destroyed(3) } 3675 MAX-ACCESS read-write 3676 STATUS current 3677 DESCRIPTION 3678 "Allows a service class for a particular modem to be 3679 suppressed, (re-)enabled, or deleted altogether." 3680 ::= { docsIfCmtsServiceEntry 3 } 3682 docsIfCmtsServiceQosProfile OBJECT-TYPE 3683 SYNTAX Integer32 (0..16383) 3684 MAX-ACCESS read-only 3685 STATUS current 3686 DESCRIPTION 3687 "The index in docsIfQosProfileTable describing the quality 3688 of service attributes associated with this particular 3689 service. If no associated docsIfQosProfileTable entry 3690 exists, this object returns a value of zero." 3691 ::= { docsIfCmtsServiceEntry 4 } 3693 docsIfCmtsServiceCreateTime OBJECT-TYPE 3694 SYNTAX TimeStamp 3695 MAX-ACCESS read-only 3696 STATUS current 3697 DESCRIPTION 3698 "The value of sysUpTime when this entry was created." 3699 ::= { docsIfCmtsServiceEntry 5 } 3701 docsIfCmtsServiceInOctets OBJECT-TYPE 3702 SYNTAX Counter32 3703 UNITS "bytes" 3704 MAX-ACCESS read-only 3705 STATUS current 3706 DESCRIPTION 3707 "The cumulative number of Packet Data octets received 3708 on this Service ID. The count does not include the 3709 size of the Cable MAC header. 3710 Discontinuities in the value of this counter can occur 3711 at reinitialization of the managed system, and at other 3712 times as indicated by the value of 3713 ifCounterDiscontinuityTime for the associated ifIndex." 3714 ::= { docsIfCmtsServiceEntry 6 } 3716 docsIfCmtsServiceInPackets OBJECT-TYPE 3717 SYNTAX Counter32 3718 UNITS "packets" 3719 MAX-ACCESS read-only 3720 STATUS current 3721 DESCRIPTION 3722 "The cumulative number of Packet Data packets received 3723 on this Service ID. 3724 Discontinuities in the value of this counter can occur 3725 at reinitialization of the managed system, and at other 3726 times as indicated by the value of 3727 ifCounterDiscontinuityTime for the associated ifIndex." 3728 ::= { docsIfCmtsServiceEntry 7 } 3730 docsIfCmtsServiceNewCmStatusIndex OBJECT-TYPE 3731 SYNTAX Integer32 (0..2147483647) 3732 MAX-ACCESS read-only 3733 STATUS current 3734 DESCRIPTION 3735 "Pointer (via docsIfCmtsCmStatusIndex) to an entry in 3736 docsIfCmtsCmStatusTable identifying the Cable Modem 3737 using this Service Queue. If multiple Cable Modems are 3738 using this Service Queue, the value of this object is 3739 zero." 3740 ::= { docsIfCmtsServiceEntry 8 } 3742 -- 3743 -- The following table provides upstream channel modulation profiles. 3744 -- Entries in this table can be 3745 -- re-used by one or more upstream channels. An upstream channel will 3746 -- have a modulation profile 3747 -- for each value of docsIfModIntervalUsageCode. 3748 -- 3750 docsIfCmtsModulationTable OBJECT-TYPE 3751 SYNTAX SEQUENCE OF DocsIfCmtsModulationEntry 3752 MAX-ACCESS not-accessible 3753 STATUS current 3754 DESCRIPTION 3755 "Describes a modulation profile associated with one or more 3756 upstream channels." 3757 ::= { docsIfCmtsObjects 5 } 3759 docsIfCmtsModulationEntry OBJECT-TYPE 3760 SYNTAX DocsIfCmtsModulationEntry 3761 MAX-ACCESS not-accessible 3762 STATUS current 3763 DESCRIPTION 3764 "Describes a modulation profile for an Interval Usage Code 3765 for one or more upstream channels. 3766 Entries in this table are created by the operator. Initial 3767 default entries may be created at system initialization 3768 time. No individual objects have to be specified in order 3769 to create an entry in this table. 3770 Note that some objects do not have default value , 3771 but do have calculated defaults and need not be specified 3772 during row creation. 3773 There is no restriction on the changing of values in this 3774 table while their associated rows are active with the 3775 exception of: 3777 1. If a modulation profile is in use by one or more 3778 upstream channels, the value of docsIfCmtsModChannelType 3779 MUST NOT be changed. 3780 2. If a modulation profile is in use by one or more 3781 upstream channels, the value of docsIfCmtsModControl 3782 MUST NOT be set to destroy(6) or notInService(2)." 3783 INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode} 3784 ::= { docsIfCmtsModulationTable 1 } 3786 DocsIfCmtsModulationEntry ::= SEQUENCE { 3787 docsIfCmtsModIndex Integer32, 3788 docsIfCmtsModIntervalUsageCode INTEGER, 3789 docsIfCmtsModControl RowStatus, 3790 docsIfCmtsModType INTEGER, 3791 docsIfCmtsModPreambleLen Integer32, 3792 docsIfCmtsModDifferentialEncoding TruthValue, 3793 docsIfCmtsModFECErrorCorrection Integer32, 3794 docsIfCmtsModFECCodewordLength Integer32, 3795 docsIfCmtsModScramblerSeed Integer32, 3796 docsIfCmtsModMaxBurstSize Integer32, 3797 docsIfCmtsModGuardTimeSize Unsigned32, 3798 docsIfCmtsModLastCodewordShortened TruthValue, 3799 docsIfCmtsModScrambler TruthValue, 3800 docsIfCmtsModByteInterleaverDepth Unsigned32, 3801 docsIfCmtsModByteInterleaverBlockSize Unsigned32, 3802 docsIfCmtsModPreambleType INTEGER, 3803 docsIfCmtsModTcmErrorCorrectionOn TruthValue, 3804 docsIfCmtsModScdmaInterleaverStepSize Unsigned32, 3805 docsIfCmtsModScdmaSpreaderEnable TruthValue, 3806 docsIfCmtsModScdmaSubframeCodes Unsigned32, 3807 docsIfCmtsModChannelType DocsisUpstreamType 3808 } 3810 docsIfCmtsModIndex OBJECT-TYPE 3811 SYNTAX Integer32 (1..2147483647) 3812 MAX-ACCESS not-accessible 3813 STATUS current 3814 DESCRIPTION 3815 "An index into the Channel Modulation table representing 3816 a group of Interval Usage Codes, all associated with the 3817 same channel." 3818 ::= { docsIfCmtsModulationEntry 1 } 3820 docsIfCmtsModIntervalUsageCode OBJECT-TYPE 3821 SYNTAX INTEGER { 3822 request(1), 3823 requestData(2), 3824 initialRanging(3), 3825 periodicRanging(4), 3826 shortData(5), 3827 longData(6), 3828 advPhyShortData(9), 3829 advPhyLongData(10), 3830 ugs(11) 3831 } 3832 MAX-ACCESS not-accessible 3833 STATUS current 3834 DESCRIPTION 3835 "An index into the Channel Modulation table which, when 3836 grouped with other Interval Usage Codes, fully 3837 instantiate all modulation sets for a given upstream 3838 channel." 3839 REFERENCE 3840 "Data-Over-Cable Service Interface Specifications: Radio 3841 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3842 Table 8-20." 3843 ::= { docsIfCmtsModulationEntry 2 } 3845 docsIfCmtsModControl OBJECT-TYPE 3846 SYNTAX RowStatus 3847 MAX-ACCESS read-create 3848 STATUS current 3849 DESCRIPTION 3850 "Controls and reflects the status of rows in this table." 3851 ::= { docsIfCmtsModulationEntry 3 } 3853 docsIfCmtsModType OBJECT-TYPE 3854 SYNTAX INTEGER { 3855 other(1), 3856 qpsk(2), 3857 qam16(3), 3858 qam8(4), 3859 qam32(5), 3860 qam64(6), 3861 qam128(7) 3862 } 3863 MAX-ACCESS read-create 3864 STATUS current 3865 DESCRIPTION 3866 "The modulation type used on this channel. Returns 3867 other(1) if the modulation type is neither 3868 qpsk, qam16, qam8, qam32, qam64 or qam128. 3869 Type qam128 is used for SCDMA channels only. 3870 See the reference for the modulation profiles 3871 implied by different modulation types." 3872 REFERENCE 3873 "Data-Over-Cable Service Interface Specifications: Radio 3874 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3875 Tables 6-7, and 8-19." 3876 DEFVAL { qpsk } 3877 ::= { docsIfCmtsModulationEntry 4 } 3879 docsIfCmtsModPreambleLen OBJECT-TYPE 3880 SYNTAX Integer32 (0..1536) 3881 UNITS "bits" 3882 MAX-ACCESS read-create 3883 STATUS current 3884 DESCRIPTION 3885 "The preamble length for this modulation profile in bits. 3886 Default value is the minimum needed by the implementation 3887 at the CMTS for the given modulation profile." 3888 REFERENCE 3889 "Data-Over-Cable Service Interface Specifications: Radio 3890 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3891 Tables 6-7, and 8-19." 3892 ::= { docsIfCmtsModulationEntry 5 } 3894 docsIfCmtsModDifferentialEncoding OBJECT-TYPE 3895 SYNTAX TruthValue 3896 MAX-ACCESS read-create 3897 STATUS current 3898 DESCRIPTION 3899 "Specifies whether or not differential encoding is used 3900 on this channel." 3901 REFERENCE 3902 "Data-Over-Cable Service Interface Specifications: Radio 3903 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3904 Tables 6-7, and 8-19." 3905 DEFVAL { false } 3906 ::= { docsIfCmtsModulationEntry 6 } 3908 docsIfCmtsModFECErrorCorrection OBJECT-TYPE 3909 SYNTAX Integer32 (0..16) 3910 UNITS "bytes" 3911 MAX-ACCESS read-create 3912 STATUS current 3913 DESCRIPTION 3914 "The number of correctable errored bytes (t) used in 3915 forward error correction code. The value of 0 indicates 3916 no correction is employed. The number of check bytes 3917 appended will be twice this value." 3918 REFERENCE 3919 "Data-Over-Cable Service Interface Specifications: Radio 3920 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3921 Tables 6-7, and 8-19." 3922 DEFVAL { 0 } 3923 ::= { docsIfCmtsModulationEntry 7 } 3925 docsIfCmtsModFECCodewordLength OBJECT-TYPE 3926 SYNTAX Integer32 (1..255) 3927 UNITS "bytes" 3928 MAX-ACCESS read-create 3929 STATUS current 3930 DESCRIPTION 3931 "The number of data bytes (k) in the forward error 3932 correction codeword. 3933 This object is not used if docsIfCmtsModFECErrorCorrection 3934 is zero." 3935 REFERENCE 3936 "Data-Over-Cable Service Interface Specifications: Radio 3937 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3938 Tables 6-7, and 8-19." 3939 DEFVAL { 32 } 3940 ::= { docsIfCmtsModulationEntry 8 } 3942 docsIfCmtsModScramblerSeed OBJECT-TYPE 3943 SYNTAX Integer32 (0..32767) 3944 MAX-ACCESS read-create 3945 STATUS current 3946 DESCRIPTION 3947 "The 15 bit seed value for the scrambler polynomial." 3948 REFERENCE 3949 "Data-Over-Cable Service Interface Specifications: Radio 3950 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3951 Table 8-19." 3952 DEFVAL { 0 } 3953 ::= { docsIfCmtsModulationEntry 9 } 3955 docsIfCmtsModMaxBurstSize OBJECT-TYPE 3956 SYNTAX Integer32 (0..255) 3957 UNITS "mini-slots" 3958 MAX-ACCESS read-create 3959 STATUS current 3960 DESCRIPTION 3961 "The maximum number of mini-slots that can be transmitted 3962 during this channel's burst time. Returns zero if the 3963 burst length is bounded by the allocation MAP rather than 3964 this profile. 3965 Default value is 0 except for shortData, where it is 8." 3966 REFERENCE 3967 "Data-Over-Cable Service Interface Specifications: Radio 3968 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3969 Table 8-19." 3970 ::= { docsIfCmtsModulationEntry 10 } 3972 docsIfCmtsModGuardTimeSize OBJECT-TYPE 3973 SYNTAX Unsigned32 3974 UNITS "Symbol-times" 3975 MAX-ACCESS read-only 3976 STATUS current 3977 DESCRIPTION 3978 "The number of symbol-times which must follow the end of 3979 this channel's burst. Default value is the minimum time 3980 needed by the implementation for this modulation profile." 3981 REFERENCE 3982 "Data-Over-Cable Service Interface Specifications: Radio 3983 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3984 Tables 6-7, and 8-19." 3985 ::= { docsIfCmtsModulationEntry 11 } 3987 docsIfCmtsModLastCodewordShortened OBJECT-TYPE 3988 SYNTAX TruthValue 3989 MAX-ACCESS read-create 3990 STATUS current 3991 DESCRIPTION 3992 "Indicates if the last FEC codeword is truncated." 3993 REFERENCE 3994 "Data-Over-Cable Service Interface Specifications: Radio 3995 Frequency Interface Specification SP-RFIv2.0-I04-030730, 3996 Tables 6-7, and 8-19." 3997 DEFVAL { true } 3998 ::= { docsIfCmtsModulationEntry 12 } 4000 docsIfCmtsModScrambler OBJECT-TYPE 4001 SYNTAX TruthValue 4002 MAX-ACCESS read-create 4003 STATUS current 4004 DESCRIPTION 4005 "Indicates if the scrambler is employed." 4006 REFERENCE 4007 "Data-Over-Cable Service Interface Specifications: Radio 4008 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4009 Tables 6-7, and 8-19." 4010 DEFVAL { false } 4011 ::= { docsIfCmtsModulationEntry 13 } 4013 docsIfCmtsModByteInterleaverDepth OBJECT-TYPE 4014 SYNTAX Unsigned32 4015 MAX-ACCESS read-create 4016 STATUS current 4017 DESCRIPTION 4018 "ATDMA Byte Interleaver Depth (Ir). This object returns 1 4019 for non ATDMA profiles." 4020 REFERENCE 4021 "Data-Over-Cable Service Interface Specifications: Radio 4022 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4023 Tables 6-7, and 8-19." 4024 DEFVAL { 1 } 4025 ::= { docsIfCmtsModulationEntry 14 } 4027 docsIfCmtsModByteInterleaverBlockSize OBJECT-TYPE 4028 SYNTAX Unsigned32 4029 MAX-ACCESS read-create 4030 STATUS current 4031 DESCRIPTION 4032 "ATDMA Byte Interleaver Block size (Br). This object 4033 returns zero for non ATDMA profiles " 4034 REFERENCE 4035 "Data-Over-Cable Service Interface Specifications: Radio 4036 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4037 Tables 6-7, and 8-19." 4038 DEFVAL { 18 } 4039 ::= { docsIfCmtsModulationEntry 15 } 4041 docsIfCmtsModPreambleType OBJECT-TYPE 4042 SYNTAX INTEGER { 4043 unknown(0), 4044 qpsk0(1), 4045 qpsk1(2) 4046 } 4047 MAX-ACCESS read-create 4048 STATUS current 4049 DESCRIPTION 4050 "Preamble type for DOCSIS 2.0 bursts. The value 4051 'unknown(0)' represents a row entry consisting only of 4052 DOCSIS 1.x bursts" 4053 REFERENCE 4054 "Data-Over-Cable Service Interface Specifications: Radio 4055 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4056 Tables 6-7, and 8-19." 4057 DEFVAL { qpsk0 } 4058 ::= { docsIfCmtsModulationEntry 16 } 4060 docsIfCmtsModTcmErrorCorrectionOn OBJECT-TYPE 4061 SYNTAX TruthValue 4062 MAX-ACCESS read-create 4063 STATUS current 4064 DESCRIPTION 4065 "Trellis Code Modulation (TCM) On/Off. This value returns 4066 false for non S-CDMA profiles." 4067 REFERENCE 4068 "Data-Over-Cable Service Interface Specifications: Radio 4069 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4070 Tables 6-7, and 8-19." 4071 DEFVAL { false } 4072 ::= { docsIfCmtsModulationEntry 17 } 4074 docsIfCmtsModScdmaInterleaverStepSize OBJECT-TYPE 4075 SYNTAX Unsigned32 (0 | 1..32) 4076 MAX-ACCESS read-create 4077 STATUS current 4078 DESCRIPTION 4079 " S-CDMA Interleaver step size. This value returns zero 4080 for non S-CDMA profiles." 4081 REFERENCE 4082 "Data-Over-Cable Service Interface Specifications: Radio 4083 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4084 Tables 6-7, and 8-19." 4085 DEFVAL { 1 } 4086 ::= { docsIfCmtsModulationEntry 18 } 4088 docsIfCmtsModScdmaSpreaderEnable OBJECT-TYPE 4089 SYNTAX TruthValue 4090 MAX-ACCESS read-create 4091 STATUS current 4092 DESCRIPTION 4093 " S-CDMA spreader. This value returns false for non S-CDMA 4094 profiles. Default value for IUC 3 and 4 is OFF, for 4095 all other IUCs it is ON." 4096 REFERENCE 4097 "Data-Over-Cable Service Interface Specifications: Radio 4098 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4099 Tables 6-7, and 8-19." 4100 ::= { docsIfCmtsModulationEntry 19 } 4102 docsIfCmtsModScdmaSubframeCodes OBJECT-TYPE 4103 SYNTAX Unsigned32 (0 | 1..128) 4104 MAX-ACCESS read-create 4105 STATUS current 4106 DESCRIPTION 4107 " S-CDMA sub-frame size. This value returns zero 4108 for non S-CDMA profiles." 4109 REFERENCE 4110 "Data-Over-Cable Service Interface Specifications: Radio 4111 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4112 Table 6-7, and 8-19." 4113 DEFVAL { 1 } 4114 ::= { docsIfCmtsModulationEntry 20 } 4116 docsIfCmtsModChannelType OBJECT-TYPE 4117 SYNTAX DocsisUpstreamType 4118 MAX-ACCESS read-create 4119 STATUS current 4120 DESCRIPTION 4121 "Describes the modulation channel type for this modulation 4122 entry. 4123 All the active entries in a modulation profile (ie all 4124 active entries that share a common docsIfCmtsModIndex) 4125 MUST have the same value of docsIfCmtsModChannelType." 4126 REFERENCE 4127 "Data-Over-Cable Service Interface Specifications: Radio 4128 Frequency Interface Specification SP-RFIv2.0-I04-030730, 4129 Table 8-19." 4130 DEFVAL { tdma } 4131 ::= { docsIfCmtsModulationEntry 21 } 4133 docsIfCmtsQosProfilePermissions OBJECT-TYPE 4134 SYNTAX BITS { 4135 createByManagement(0), 4136 updateByManagement(1), 4137 createByModems(2) 4138 } 4139 MAX-ACCESS read-write 4140 STATUS current 4141 DESCRIPTION 4142 "This object specifies permitted methods of creating 4143 entries in docsIfQosProfileTable. 4144 CreateByManagement(0) is set if entries can be created 4145 using SNMP. UpdateByManagement(1) is set if updating 4146 entries using SNMP is permitted. CreateByModems(2) 4147 is set if entries can be created based on information 4148 in REG-REQ MAC messages received from Cable Modems. 4149 Information in this object is only applicable if 4150 docsIfQosProfileTable is implemented as read-create. 4151 Otherwise, this object is implemented as read-only 4152 and returns CreateByModems(2). 4153 Either CreateByManagement(0) or CreateByModems(1) 4154 must be set when writing to this object. 4155 Note that BITS objects are encoded most significant bit 4156 first. For example, if bit 2 is set, the value of this 4157 object is the octet string '20'H." 4158 ::= { docsIfCmtsObjects 6 } 4160 docsIfCmtsMacToCmTable OBJECT-TYPE 4161 SYNTAX SEQUENCE OF DocsIfCmtsMacToCmEntry 4162 MAX-ACCESS not-accessible 4163 STATUS current 4164 DESCRIPTION 4165 "This is a table to provide a quick access index into the 4166 docsIfCmtsCmStatusTable. There is exactly one row in this 4167 table for each row in the docsIfCmtsCmStatusTable. In 4168 general, the management station should use this table only 4169 to get a pointer into the docsIfCmtsCmStatusTable (which 4170 corresponds to the CM's RF interface MAC address), and 4171 should not iterate (e.g. GetNext through) this table." 4172 ::= { docsIfCmtsObjects 7 } 4174 docsIfCmtsMacToCmEntry OBJECT-TYPE 4175 SYNTAX DocsIfCmtsMacToCmEntry 4176 MAX-ACCESS not-accessible 4177 STATUS current 4178 DESCRIPTION 4179 "A row in the docsIfCmtsMacToCmTable. 4180 An entry in this table exists for each Cable Modem 4181 that is connected to the CMTS implementing this table." 4182 INDEX { docsIfCmtsCmMac } 4183 ::= {docsIfCmtsMacToCmTable 1 } 4185 DocsIfCmtsMacToCmEntry ::= SEQUENCE { 4186 docsIfCmtsCmMac MacAddress, 4187 docsIfCmtsCmPtr Integer32 4188 } 4190 docsIfCmtsCmMac OBJECT-TYPE 4191 SYNTAX MacAddress 4192 MAX-ACCESS not-accessible 4193 STATUS current 4194 DESCRIPTION 4195 "The RF side MAC address for the referenced CM. (E.g. the 4196 interface on the CM that has docsCableMacLayer(127) as 4197 its ifType." 4198 ::= { docsIfCmtsMacToCmEntry 1 } 4200 docsIfCmtsCmPtr OBJECT-TYPE 4201 SYNTAX Integer32 (1..2147483647) 4202 MAX-ACCESS read-only 4203 STATUS current 4204 DESCRIPTION 4205 "An row index into docsIfCmtsCmStatusTable. When queried 4206 with the correct instance value (e.g. a CM's MAC address), 4207 returns the index in docsIfCmtsCmStatusTable which 4208 represents that CM." 4209 ::= { docsIfCmtsMacToCmEntry 2 } 4211 -- The following independent object and associated table provide 4212 -- operators with a mechanism to evaluate the load/utilization of 4213 -- both upstream and downstream physical channels. This information 4214 -- may be used for capacity planning and incident analysis, and may 4215 -- be particularly helpful in provisioning of high value QOS. 4216 -- 4217 -- Utilization is expressed as an index representing the calculated 4218 -- percentage utilization of the upstream or downstream channel in 4219 -- the most recent sampling interval (ie. utilization interval). 4220 -- Refer to the DESCRIPTION field of the docsIfCmtsChannelUtUtilization 4221 -- object for definitions and calculation details. 4223 docsIfCmtsChannelUtilizationInterval OBJECT-TYPE 4224 SYNTAX Integer32 (0..86400) 4225 UNITS "seconds" 4226 MAX-ACCESS read-write 4227 STATUS current 4228 DESCRIPTION 4229 "The time interval in seconds over which the channel 4230 utilization index is calculated. All upstream/downstream 4231 channels use the same 4232 docsIfCmtsChannelUtilizationInterval. 4233 Setting a value of zero disables utilization reporting. 4234 A channel utilization index is calculated over a fixed 4235 window applying to the most recent 4236 docsIfCmtsChannelUtilizationInterval. It would therefore 4237 be prudent to use a relatively short 4238 docsIfCmtsChannelUtilizationInterval. 4239 It is a vendor decision whether to reset the timer when 4240 docsIfCmtsChannelUtilizationInterval is changed during a 4241 utilization sampling period." 4243 ::= { docsIfCmtsObjects 8 } 4245 docsIfCmtsChannelUtilizationTable OBJECT-TYPE 4246 SYNTAX SEQUENCE OF DocsIfCmtsChannelUtilizationEntry 4247 MAX-ACCESS not-accessible 4248 STATUS current 4249 DESCRIPTION 4250 "Reports utilization statistics for attached upstream and 4251 downstream physical channels." 4252 ::= { docsIfCmtsObjects 9 } 4254 docsIfCmtsChannelUtilizationEntry OBJECT-TYPE 4255 SYNTAX DocsIfCmtsChannelUtilizationEntry 4256 MAX-ACCESS not-accessible 4257 STATUS current 4258 DESCRIPTION 4259 "Utilization statistics for a single upstream or downstream 4260 physical channel. An entry exists in this table for each 4261 ifEntry with an ifType equal to 4262 docsCableDownstreamInterface (128) 4263 or docsCableUpstreamInterface (129)." 4264 INDEX { ifIndex, docsIfCmtsChannelUtIfType, 4265 docsIfCmtsChannelUtId } 4266 ::= { docsIfCmtsChannelUtilizationTable 1 } 4268 DocsIfCmtsChannelUtilizationEntry ::= SEQUENCE { 4269 docsIfCmtsChannelUtIfType IANAifType, 4270 docsIfCmtsChannelUtId Integer32, 4271 docsIfCmtsChannelUtUtilization Integer32 4272 } 4274 docsIfCmtsChannelUtIfType OBJECT-TYPE 4275 SYNTAX IANAifType 4276 MAX-ACCESS not-accessible 4277 STATUS current 4278 DESCRIPTION 4279 "The secondary index into this table. Indicates the IANA 4280 interface type associated with this physical channel. 4281 Only docsCableDownstreamInterface (128) and 4282 docsCableUpstreamInterface (129) are valid." 4283 ::= { docsIfCmtsChannelUtilizationEntry 1 } 4285 docsIfCmtsChannelUtId OBJECT-TYPE 4286 SYNTAX Integer32 (0..255) 4287 MAX-ACCESS not-accessible 4288 STATUS current 4289 DESCRIPTION 4290 "The tertiary index into this table. Indicates the CMTS 4291 identifier for this physical channel." 4292 ::= { docsIfCmtsChannelUtilizationEntry 2 } 4294 docsIfCmtsChannelUtUtilization OBJECT-TYPE 4295 SYNTAX Integer32 (0..100) 4296 UNITS "percent" 4297 MAX-ACCESS read-only 4298 STATUS current 4299 DESCRIPTION 4300 "The calculated and truncated utilization index for this 4301 physical upstream or downstream channel, accurate as of 4302 the most recent docsIfCmtsChannelUtilizationInterval. 4304 Upstream Channel Utilization Index: 4305 The upstream channel utilization index is expressed as a 4306 percentage of mini-slots utilized on the physical channel, 4307 regardless of burst type. For an Initial Maintenance 4308 region, the mini-slots for the complete region are 4309 considered utilized if the CMTS received an upstream 4310 burst within the region from any CM on the physical 4311 channel. For contention REQ and REQ/DATA regions, the 4312 mini-slots for a transmission opportunity within the 4313 region are considered utilized if the CMTS received an 4314 upstream burst within the opportunity from any CM on the 4315 physical channel. For all other regions, utilized 4316 mini-slots are those in which the CMTS granted 4317 bandwidth to any unicast SID on the physical channel. 4319 For an upstream interface that has multiple logical 4320 upstream channels enabled, the utilization index is a 4321 weighted sum of utilization indices for the logical 4322 channels. The weight for each utilization index is the 4323 percentage of upstream mini-slots allocated for the 4324 corresponding logical channel. 4325 Example: 4326 If 75% of bandwidth is allocated to the first logical 4327 channel and 25% to the second, and the utilization 4328 indices for each are 60 and 40 respectively, the 4329 utilization index for the upstream physical channel is 4330 (60 * 0.75) + (40 * 0.25) = 55. This figure 4331 applies to the most recent utilization interval. 4333 Downstream Channel Utilization Index: 4334 The downstream channel utilization index is a percentage 4335 expressing the ratio between bytes used to transmit data 4336 versus the total number of bytes transmitted in the raw 4337 bandwidth of the MPEG channel. As with the upstream 4338 utilization index, the calculated value represents 4339 the most recent utilization interval. 4340 Formula: 4341 Downstream utilization index = 4342 (100 * (data bytes / raw bytes)) 4343 Definitions: 4344 Data bytes: Number of bytes transmitted as data in the 4345 docsIfCmtsChannelUtilizationInterval. 4346 Identical to docsIfCmtsDownChannelCtrUsed 4347 Bytes measured over the utilization 4348 interval. 4349 Raw bandwidth: Total number of bytes available for 4350 transmitting data, not including bytes 4351 used for headers and other overhead. 4352 Raw bytes: (raw bandwidth * 4353 docsIfCmtsChannelUtilizationInterval). 4354 Identical to docsIfCmtsDownChannelCtrTotal 4355 Bytes measured over the utilization 4356 interval." 4358 ::= { docsIfCmtsChannelUtilizationEntry 3 } 4360 -- The following table provides operators with input data appropriate 4361 -- for calculating downstream channel utilization. Operators may use 4362 -- the docsIfCmtsChannelUtilizationTable, or perform their own polling 4363 -- of the docsIfCmtsDownChannelCounterTable objects to characterize 4364 -- their downstream channel usage. The 32 bit counter objects are 4365 -- included to provide backward compatibility with SNMPv1 managers, 4366 -- which cannot access 64 bit counter objects. 4368 docsIfCmtsDownChannelCounterTable OBJECT-TYPE 4369 SYNTAX SEQUENCE OF DocsIfCmtsDownChannelCounterEntry 4370 MAX-ACCESS not-accessible 4371 STATUS current 4372 DESCRIPTION 4373 "This table is implemented at the CMTS to collect 4374 downstream channel statistics for utilization 4375 calculations." 4376 ::= { docsIfCmtsObjects 10 } 4378 docsIfCmtsDownChannelCounterEntry OBJECT-TYPE 4379 SYNTAX DocsIfCmtsDownChannelCounterEntry 4380 MAX-ACCESS not-accessible 4381 STATUS current 4382 DESCRIPTION 4383 "An entry provides a list of traffic counters for a single 4384 downstream channel. 4385 An entry in this table exists for each ifEntry with an 4386 ifType of docsCableDownstream(128)." 4387 INDEX { ifIndex } 4388 ::= { docsIfCmtsDownChannelCounterTable 1 } 4390 DocsIfCmtsDownChannelCounterEntry ::= SEQUENCE { 4391 docsIfCmtsDownChnlCtrId Integer32, 4392 docsIfCmtsDownChnlCtrTotalBytes Counter32, 4393 docsIfCmtsDownChnlCtrUsedBytes Counter32, 4394 docsIfCmtsDownChnlCtrExtTotalBytes Counter64, 4395 docsIfCmtsDownChnlCtrExtUsedBytes Counter64 4396 } 4398 docsIfCmtsDownChnlCtrId OBJECT-TYPE 4399 SYNTAX Integer32 (0..255) 4400 MAX-ACCESS read-only 4401 STATUS current 4402 DESCRIPTION 4403 "The Cable Modem Termination System (CMTS) identification 4404 of the downstream channel within this particular MAC 4405 interface. If the interface is down, the object returns 4406 the most current value. If the downstream channel ID is 4407 unknown, this object returns a value of 0." 4408 ::= { docsIfCmtsDownChannelCounterEntry 1 } 4410 docsIfCmtsDownChnlCtrTotalBytes OBJECT-TYPE 4411 SYNTAX Counter32 4412 UNITS "bytes" 4413 MAX-ACCESS read-only 4414 STATUS current 4415 DESCRIPTION 4416 "At the CMTS, the total number of bytes in the Payload 4417 portion of MPEG Packets (ie. not including MPEG header 4418 or pointer_field) transported by this downstream channel 4419 since CMTS initialization. This is the 32 bit version of 4420 docsIfCmtsDownChnlCtrExtTotalBytes, included to provide 4421 back compatibility with SNMPv1 managers. 4422 Discontinuities in the value of this counter can occur 4423 at reinitialization of the managed system, and at other 4424 times as indicated by the value of 4425 ifCounterDiscontinuityTime for the associated ifIndex." 4426 ::= { docsIfCmtsDownChannelCounterEntry 2 } 4428 docsIfCmtsDownChnlCtrUsedBytes OBJECT-TYPE 4429 SYNTAX Counter32 4430 UNITS "bytes" 4431 MAX-ACCESS read-only 4432 STATUS current 4433 DESCRIPTION 4434 "At the CMTS, the total number of DOCSIS data bytes 4435 transported by this downstream channel since CMTS 4436 initialization. The number of data bytes is defined as 4437 the total number of bytes transported in DOCSIS payloads 4438 minus the number of stuff bytes transported in DOCSIS 4439 payloads. 4440 This is the 32 bit version of 4441 docsIfCmtsDownChnlCtrExtUsedBytes, included to provide 4442 back compatibility with SNMPv1 managers. 4443 Discontinuities in the value of this counter can occur 4444 at reinitialization of the managed system, and at other 4445 times as indicated by the value of 4446 ifCounterDiscontinuityTime for the associated ifIndex." 4447 ::= { docsIfCmtsDownChannelCounterEntry 3 } 4449 docsIfCmtsDownChnlCtrExtTotalBytes OBJECT-TYPE 4450 SYNTAX Counter64 4451 UNITS "bytes" 4452 MAX-ACCESS read-only 4453 STATUS current 4454 DESCRIPTION 4455 "At the CMTS, the total number of bytes in the Payload 4456 portion of MPEG Packets (ie. not including MPEG header 4457 or pointer_field) transported by this downstream channel 4458 since CMTS initialization. This is the 64 bit version of 4459 docsIfCmtsDownChnlCtrTotalBytes, and will not be 4460 accessible to SNMPv1 managers. 4461 Discontinuities in the value of this counter can occur 4462 at reinitialization of the managed system, and at other 4463 times as indicated by the value of 4464 ifCounterDiscontinuityTime for the associated ifIndex." 4465 ::= { docsIfCmtsDownChannelCounterEntry 4 } 4467 docsIfCmtsDownChnlCtrExtUsedBytes OBJECT-TYPE 4468 SYNTAX Counter64 4469 UNITS "bytes" 4470 MAX-ACCESS read-only 4471 STATUS current 4472 DESCRIPTION 4473 "At the CMTS, the total number of DOCSIS data bytes 4474 transported by this downstream channel since CMTS 4475 initialization. The number of data bytes is defined as 4476 the total number of bytes transported in DOCSIS payloads 4477 minus the number of stuff bytes transported in DOCSIS 4478 payloads. 4479 This is the 64 bit version of 4480 docsIfCmtsDownChnlCtrUsedBytes, and will not be accessible 4481 to SNMPv1 managers. 4482 Discontinuities in the value of this counter can occur 4483 at reinitialization of the managed system, and at other 4484 times as indicated by the value of 4485 ifCounterDiscontinuityTime for the associated ifIndex." 4486 ::= { docsIfCmtsDownChannelCounterEntry 5 } 4488 -- The following table provides operators with input data appropriate 4489 -- for calculating upstream channel utilization, and for determining 4490 -- the traffic characteristics of upstream channels. Operators may use 4491 -- the docsIfCmtsChannelUtilizationTable, or perform their own polling 4492 -- of the docsIfCmtsUpChannelCounterTable objects for utilization 4493 -- determination. 4494 -- The first four 32 and 64 objects in this table are mandatory. 4495 -- Vendors may choose to implement the remaining optional objects to 4496 -- provide operators with finer characterization of upstream channel 4497 -- traffic patterns. The 32 bit counter objects are included to provide 4498 -- backward compatibility with SNMPv1 managers, which cannot access 64 4499 -- bit counter objects. 4501 docsIfCmtsUpChannelCounterTable OBJECT-TYPE 4502 SYNTAX SEQUENCE OF DocsIfCmtsUpChannelCounterEntry 4503 MAX-ACCESS not-accessible 4504 STATUS current 4505 DESCRIPTION 4506 "This table is implemented at the CMTS to provide upstream 4507 channel statistics appropriate for channel utilization 4508 calculations." 4509 ::= { docsIfCmtsObjects 11 } 4511 docsIfCmtsUpChannelCounterEntry OBJECT-TYPE 4512 SYNTAX DocsIfCmtsUpChannelCounterEntry 4513 MAX-ACCESS not-accessible 4514 STATUS current 4515 DESCRIPTION 4516 "List of traffic statistics for a single upstream channel. 4517 For DOCSIS 2.0 CMTSs, an entry in this table 4518 exists for each ifEntry with an ifType of 4519 docsCableUpstreamChannel (205). 4520 For DOCSIS 1.x CMTSs, an entry in this table 4521 exists for each ifEntry with an ifType of 4522 docsCableUpstreamInterface (129)." 4523 INDEX { ifIndex } 4524 ::= { docsIfCmtsUpChannelCounterTable 1 } 4526 DocsIfCmtsUpChannelCounterEntry ::= SEQUENCE { 4527 docsIfCmtsUpChnlCtrId Integer32, 4528 docsIfCmtsUpChnlCtrTotalMslots Counter32, 4529 docsIfCmtsUpChnlCtrUcastGrantedMslots Counter32, 4530 docsIfCmtsUpChnlCtrTotalCntnMslots Counter32, 4531 docsIfCmtsUpChnlCtrUsedCntnMslots Counter32, 4532 docsIfCmtsUpChnlCtrExtTotalMslots Counter64, 4533 docsIfCmtsUpChnlCtrExtUcastGrantedMslots Counter64, 4534 docsIfCmtsUpChnlCtrExtTotalCntnMslots Counter64, 4535 docsIfCmtsUpChnlCtrExtUsedCntnMslots Counter64, 4536 docsIfCmtsUpChnlCtrCollCntnMslots Counter32, 4537 docsIfCmtsUpChnlCtrTotalCntnReqMslots Counter32, 4538 docsIfCmtsUpChnlCtrUsedCntnReqMslots Counter32, 4539 docsIfCmtsUpChnlCtrCollCntnReqMslots Counter32, 4540 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots Counter32, 4541 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots Counter32, 4542 docsIfCmtsUpChnlCtrCollCntnReqDataMslots Counter32, 4543 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots Counter32, 4544 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots Counter32, 4545 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots Counter32, 4546 docsIfCmtsUpChnlCtrExtCollCntnMslots Counter64, 4547 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots Counter64, 4548 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots Counter64, 4549 docsIfCmtsUpChnlCtrExtCollCntnReqMslots Counter64, 4550 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots Counter64, 4551 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots Counter64, 4552 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots Counter64, 4553 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots Counter64, 4554 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots Counter64, 4555 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots Counter64 4556 } 4558 docsIfCmtsUpChnlCtrId OBJECT-TYPE 4559 SYNTAX Integer32 (0..255) 4560 MAX-ACCESS read-only 4561 STATUS current 4562 DESCRIPTION 4563 "The CMTS identification of the upstream channel." 4564 ::= { docsIfCmtsUpChannelCounterEntry 1 } 4566 docsIfCmtsUpChnlCtrTotalMslots OBJECT-TYPE 4567 SYNTAX Counter32 4568 UNITS "mini-slots" 4569 MAX-ACCESS read-only 4570 STATUS current 4571 DESCRIPTION 4572 "Current count, from CMTS initialization, of all mini-slots 4573 defined for this upstream logical channel. This count 4574 includes all IUCs and SIDs, even those allocated to the 4575 NULL SID for a 2.0 logical channel which is inactive. This 4576 is the 32 bit version of docsIfCmtsUpChnlCtrExtTotalMslots 4577 and is included for back compatibility with SNMPv1 4578 managers. Support for this object is mandatory. 4579 Discontinuities in the value of this counter can occur 4580 at reinitialization of the managed system, and at other 4581 times as indicated by the value of 4582 ifCounterDiscontinuityTime for the associated ifIndex." 4583 ::= { docsIfCmtsUpChannelCounterEntry 2 } 4585 docsIfCmtsUpChnlCtrUcastGrantedMslots OBJECT-TYPE 4586 SYNTAX Counter32 4587 UNITS "mini-slots" 4588 MAX-ACCESS read-only 4589 STATUS current 4590 DESCRIPTION 4591 "Current count, from CMTS initialization, of unicast 4592 granted mini-slots on the upstream logical channel, 4593 regardless of burst type. Unicast granted mini-slots are 4594 those in which the CMTS assigned bandwidth to any unicast 4595 SID on the logical channel. However this object does not 4596 include minis-lots for reserved IUCs, or grants to SIDs 4597 designated as meaning 'no CM'. This is the 32 bit version 4598 of docsIfCmtsUpChnlCtrExtUcastGrantedMslots, and is 4599 included for back compatibility with SNMPv1 managers. 4600 Support for this object is mandatory. 4601 Discontinuities in the value of this counter can occur 4602 at reinitialization of the managed system, and at other 4603 times as indicated by the value of 4604 ifCounterDiscontinuityTime for the associated ifIndex." 4605 ::= { docsIfCmtsUpChannelCounterEntry 3 } 4607 docsIfCmtsUpChnlCtrTotalCntnMslots OBJECT-TYPE 4608 SYNTAX Counter32 4609 UNITS "mini-slots" 4610 MAX-ACCESS read-only 4611 STATUS current 4612 DESCRIPTION 4613 "Current count, from CMTS initialization, of contention 4614 mini-slots defined for this upstream logical channel. This 4615 count includes all mini-slots assigned to a broadcast or 4616 multicast SID on the logical channel. This is the 32 bit 4617 version of docsIfCmtsUpChnlCtrExtTotalCntnMslots, and is 4618 included for back compatibility with SNMPv1 managers. 4619 Support for this object is mandatory. 4620 Discontinuities in the value of this counter can occur 4621 at reinitialization of the managed system, and at other 4622 times as indicated by the value of 4623 ifCounterDiscontinuityTime for the associated ifIndex." 4624 ::= { docsIfCmtsUpChannelCounterEntry 4 } 4626 docsIfCmtsUpChnlCtrUsedCntnMslots OBJECT-TYPE 4627 SYNTAX Counter32 4628 UNITS "mini-slots" 4629 MAX-ACCESS read-only 4630 STATUS current 4631 DESCRIPTION 4632 "Current count, from CMTS initialization, of contention 4633 mini-slots utilized on the upstream logical channel. For 4634 contention regions, utilized mini-slots are those in which 4635 the CMTS correctly received an upstream burst from any CM 4636 on the upstream logical channel. This is the 32 bit 4637 version of docsIfCmtsUpChnlCtrExtUsedCntnMslots, and is 4638 included for back compatibility with SNMPv1 managers. 4640 Support for this object is mandatory. 4641 Discontinuities in the value of this counter can occur 4642 at reinitialization of the managed system, and at other 4643 times as indicated by the value of 4644 ifCounterDiscontinuityTime for the associated ifIndex." 4645 ::= { docsIfCmtsUpChannelCounterEntry 5 } 4647 docsIfCmtsUpChnlCtrExtTotalMslots OBJECT-TYPE 4648 SYNTAX Counter64 4649 UNITS "mini-slots" 4650 MAX-ACCESS read-only 4651 STATUS current 4652 DESCRIPTION 4653 "Current count, from CMTS initialization, of all mini-slots 4654 defined for this upstream logical channel. This count 4655 includes all IUCs and SIDs, even those allocated to the 4656 NULL SID for a 2.0 logical channel which is inactive. This 4657 is the 64 bit version of docsIfCmtsUpChnlCtrTotalMslots, 4658 and will not be accessible to SNMPv1 managers. 4659 Support for this object is mandatory. 4660 Discontinuities in the value of this counter can occur 4661 at reinitialization of the managed system, and at other 4662 times as indicated by the value of 4663 ifCounterDiscontinuityTime for the associated ifIndex." 4664 ::= { docsIfCmtsUpChannelCounterEntry 6 } 4666 docsIfCmtsUpChnlCtrExtUcastGrantedMslots OBJECT-TYPE 4667 SYNTAX Counter64 4668 UNITS "mini-slots" 4669 MAX-ACCESS read-only 4670 STATUS current 4671 DESCRIPTION 4672 "Current count, from CMTS initialization, of unicast 4673 granted mini-slots on the upstream logical channel, 4674 regardless of burst type. Unicast granted mini-slots are 4675 those in which the CMTS assigned bandwidth to any unicast 4676 SID on the logical channel. However this object does not 4677 include mini-slots for reserved IUCs, or grants to SIDs 4678 designated as meaning 'no CM'. This is the 64 bit version 4679 of docsIfCmtsUpChnlCtrUcastGrantedMslots, and will not be 4680 accessible to SNMPv1 managers. 4681 Support for this object is mandatory. 4682 Discontinuities in the value of this counter can occur 4683 at reinitialization of the managed system, and at other 4684 times as indicated by the value of 4685 ifCounterDiscontinuityTime for the associated ifIndex." 4686 ::= { docsIfCmtsUpChannelCounterEntry 7 } 4688 docsIfCmtsUpChnlCtrExtTotalCntnMslots OBJECT-TYPE 4689 SYNTAX Counter64 4690 UNITS "mini-slots" 4691 MAX-ACCESS read-only 4692 STATUS current 4693 DESCRIPTION 4694 "Current count, from CMTS initialization, of contention 4695 mini-slots defined for this upstream logical channel. This 4696 count includes all mini-slots assigned to a broadcast or 4697 multicast SID on the logical channel. This is the 64 bit 4698 version of docsIfCmtsUpChnlCtrTotalCntnMslots, and will 4699 not be accessible to SNMPv1 managers. 4700 Support for this object is mandatory. 4701 Discontinuities in the value of this counter can occur 4702 at reinitialization of the managed system, and at other 4703 times as indicated by the value of 4704 ifCounterDiscontinuityTime for the associated ifIndex." 4705 ::= { docsIfCmtsUpChannelCounterEntry 8 } 4707 docsIfCmtsUpChnlCtrExtUsedCntnMslots OBJECT-TYPE 4708 SYNTAX Counter64 4709 UNITS "mini-slots" 4710 MAX-ACCESS read-only 4711 STATUS current 4712 DESCRIPTION 4713 "Current count, from CMTS initialization, of contention 4714 mini-slots utilized on the upstream logical channel. For 4715 contention regions, utilized mini-slots are those in which 4716 the CMTS correctly received an upstream burst from any CM 4717 on the upstream logical channel. This is the 64 bit 4718 version of docsIfCmtsUpChnlCtrUsedCntnMslots, and will not 4719 be accessible to SNMPv1 managers. 4720 Support for this object is mandatory. 4721 Discontinuities in the value of this counter can occur 4722 at reinitialization of the managed system, and at other 4723 times as indicated by the value of 4724 ifCounterDiscontinuityTime for the associated ifIndex." 4725 ::= { docsIfCmtsUpChannelCounterEntry 9 } 4727 docsIfCmtsUpChnlCtrCollCntnMslots OBJECT-TYPE 4728 SYNTAX Counter32 4729 UNITS "mini-slots" 4730 MAX-ACCESS read-only 4731 STATUS current 4732 DESCRIPTION 4733 "Current count, from CMTS initialization, of contention 4734 mini-slots subjected to collisions on the upstream logical 4735 channel. For contention regions, these are the mini-slots 4736 applicable to bursts that the CMTS detected, but could not 4737 correctly receive. This is the 32 bit version of 4738 docsIfCmtsUpChnlCtrExtCollCntnMslots, and is included for 4739 back compatibility with SNMPv1 managers. 4740 Discontinuities in the value of this counter can occur 4741 at reinitialization of the managed system, and at other 4742 times as indicated by the value of 4743 ifCounterDiscontinuityTime for the associated ifIndex." 4744 ::= { docsIfCmtsUpChannelCounterEntry 10 } 4746 docsIfCmtsUpChnlCtrTotalCntnReqMslots OBJECT-TYPE 4747 SYNTAX Counter32 4748 UNITS "mini-slots" 4749 MAX-ACCESS read-only 4750 STATUS current 4751 DESCRIPTION 4752 "Current count, from CMTS initialization, of contention 4753 request mini-slots defined for this upstream logical 4754 channel. This count includes all mini-slots for IUC1 4755 assigned to a broadcast or multicast SID on the logical 4756 channel. This is the 32 bit version of 4757 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots, and is included 4758 for back compatibility with SNMPv1 managers. 4759 Discontinuities in the value of this counter can occur 4760 at reinitialization of the managed system, and at other 4761 times as indicated by the value of 4762 ifCounterDiscontinuityTime for the associated ifIndex." 4763 ::= { docsIfCmtsUpChannelCounterEntry 11 } 4765 docsIfCmtsUpChnlCtrUsedCntnReqMslots OBJECT-TYPE 4766 SYNTAX Counter32 4767 UNITS "mini-slots" 4768 MAX-ACCESS read-only 4769 STATUS current 4770 DESCRIPTION 4771 "Current count, from CMTS initialization, of contention 4772 request mini-slots utilized on this upstream logical 4773 channel. This count includes all contention mini-slots for 4774 IUC1 applicable to bursts that the CMTS correctly 4775 received. This is the 32 bit version of 4776 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots, and is included 4777 for back compatibility with SNMPv1 managers. 4778 Discontinuities in the value of this counter can occur 4779 at reinitialization of the managed system, and at other 4780 times as indicated by the value of 4781 ifCounterDiscontinuityTime for the associated ifIndex." 4782 ::= { docsIfCmtsUpChannelCounterEntry 12 } 4784 docsIfCmtsUpChnlCtrCollCntnReqMslots OBJECT-TYPE 4785 SYNTAX Counter32 4786 UNITS "mini-slots" 4787 MAX-ACCESS read-only 4788 STATUS current 4789 DESCRIPTION 4790 "Current count, from CMTS initialization, of contention 4791 request mini-slots subjected to collisions on this upstream 4792 logical channel. This includes all contention mini-slots 4793 for IUC1 applicable to bursts that the CMTS detected, but 4794 could not correctly receive. This is the 32 bit version of 4795 docsIfCmtsUpChnlCtrExtCollCntnReqMslots, and is included 4796 for back compatibility with SNMPv1 managers. 4797 Discontinuities in the value of this counter can occur 4798 at reinitialization of the managed system, and at other 4799 times as indicated by the value of 4800 ifCounterDiscontinuityTime for the associated ifIndex." 4801 ::= { docsIfCmtsUpChannelCounterEntry 13 } 4803 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots OBJECT-TYPE 4804 SYNTAX Counter32 4805 UNITS "mini-slots" 4806 MAX-ACCESS read-only 4807 STATUS current 4808 DESCRIPTION 4809 "Current count, from CMTS initialization, of contention 4810 request data mini-slots defined for this upstream logical 4811 channel. This count includes all mini-slots for IUC2 4812 assigned to a broadcast or multicast SID on the logical 4813 channel. This is the 32 bit version of 4814 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots, and is 4815 included for back compatibility with SNMPv1 managers. 4816 Discontinuities in the value of this counter can occur 4817 at reinitialization of the managed system, and at other 4818 times as indicated by the value of 4819 ifCounterDiscontinuityTime for the associated ifIndex." 4820 ::= { docsIfCmtsUpChannelCounterEntry 14 } 4822 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots OBJECT-TYPE 4823 SYNTAX Counter32 4824 UNITS "mini-slots" 4825 MAX-ACCESS read-only 4826 STATUS current 4827 DESCRIPTION 4828 "Current count, from CMTS initialization, of contention 4829 request data mini-slots utilized on this upstream logical 4830 channel. This includes all contention mini-slots for IUC2 4831 applicable to bursts that the CMTS correctly received. 4832 This is the 32 bit version of 4833 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots, and is 4834 included for back compatibility with SNMPv1 managers. 4835 Discontinuities in the value of this counter can occur 4836 at reinitialization of the managed system, and at other 4837 times as indicated by the value of 4838 ifCounterDiscontinuityTime for the associated ifIndex." 4839 ::= { docsIfCmtsUpChannelCounterEntry 15 } 4841 docsIfCmtsUpChnlCtrCollCntnReqDataMslots OBJECT-TYPE 4842 SYNTAX Counter32 4843 UNITS "mini-slots" 4844 MAX-ACCESS read-only 4845 STATUS current 4846 DESCRIPTION 4847 "Current count, from CMTS initialization, of contention 4848 request data mini-slots subjected to collisions on this 4849 upstream logical channel. This includes all contention 4850 mini-slots for IUC2 applicable to bursts that the CMTS 4851 detected, but could not correctly receive. This is the 32 4852 bit version of 4853 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots, and is 4854 included for back compatibility with SNMPv1 managers. 4855 Discontinuities in the value of this counter can occur 4856 at reinitialization of the managed system, and at other 4857 times as indicated by the value of 4858 ifCounterDiscontinuityTime for the associated ifIndex." 4859 ::= { docsIfCmtsUpChannelCounterEntry 16 } 4861 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots OBJECT-TYPE 4862 SYNTAX Counter32 4863 UNITS "mini-slots" 4864 MAX-ACCESS read-only 4865 STATUS current 4866 DESCRIPTION 4867 "Current count, from CMTS initialization, of contention 4868 initial maintenance mini-slots defined for this upstream 4869 logical channel. This includes all mini-slots for IUC3 4870 assigned to a broadcast or multicast SID on the logical 4871 channel. This is the 32 bit version of 4872 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots, 4873 and is included for back compatibility with SNMPv1 4874 managers. 4875 Discontinuities in the value of this counter can occur 4876 at reinitialization of the managed system, and at other 4877 times as indicated by the value of 4878 ifCounterDiscontinuityTime for the associated ifIndex." 4879 ::= { docsIfCmtsUpChannelCounterEntry 17 } 4881 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots OBJECT-TYPE 4882 SYNTAX Counter32 4883 MAX-ACCESS read-only 4884 STATUS current 4885 DESCRIPTION 4886 "Current count, from CMTS initialization, of contention 4887 initial maintenance mini-slots utilized on this upstream 4888 logical channel. This includes all contention mini-slots 4889 for IUC3 applicable to bursts that the CMTS correctly 4890 received. This is the 32 bit version of 4891 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots, 4892 and is included for back compatibility with SNMPv1 4893 managers. 4894 Discontinuities in the value of this counter can occur 4895 at reinitialization of the managed system, and at other 4896 times as indicated by the value of 4897 ifCounterDiscontinuityTime for the associated ifIndex." 4898 ::= { docsIfCmtsUpChannelCounterEntry 18 } 4900 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots OBJECT-TYPE 4901 SYNTAX Counter32 4902 UNITS "mini-slots" 4903 MAX-ACCESS read-only 4904 STATUS current 4905 DESCRIPTION 4906 "Current count, from CMTS initialization, of contention 4907 initial maintenance mini-slots subjected to collisions on 4908 this upstream logical channel. This includes all 4909 contention mini-slots for IUC3 applicable to bursts that 4910 the CMTS detected, but could not correctly receive. 4911 This is the 32 bit version of 4912 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots, 4913 and is included for back compatibility with SNMPv1 4914 managers. 4915 Discontinuities in the value of this counter can occur 4916 at reinitialization of the managed system, and at other 4917 times as indicated by the value of 4918 ifCounterDiscontinuityTime for the associated ifIndex." 4919 ::= { docsIfCmtsUpChannelCounterEntry 19 } 4921 docsIfCmtsUpChnlCtrExtCollCntnMslots OBJECT-TYPE 4922 SYNTAX Counter64 4923 UNITS "mini-slots" 4924 MAX-ACCESS read-only 4925 STATUS current 4926 DESCRIPTION 4927 "Current count, from CMTS initialization, of collision 4928 contention mini-slots on the upstream logical channel. 4929 For contention regions, these are the mini-slots applicable 4930 to bursts that the CMTS detected, but could not correctly 4931 receive. This is the 64 bit version of 4932 docsIfCmtsUpChnlCtrCollCntnMslots, and will not be 4933 accessible to SNMPv1 managers. 4934 Discontinuities in the value of this counter can occur 4935 at reinitialization of the managed system, and at other 4936 times as indicated by the value of 4937 ifCounterDiscontinuityTime for the associated ifIndex." 4938 ::= { docsIfCmtsUpChannelCounterEntry 20 } 4940 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots OBJECT-TYPE 4941 SYNTAX Counter64 4942 UNITS "mini-slots" 4943 MAX-ACCESS read-only 4944 STATUS current 4945 DESCRIPTION 4946 "Current count, from CMTS initialization, of contention 4947 request mini-slots defined for this upstream logical 4948 channel. This count includes all mini-slots for IUC1 4949 assigned to a broadcast or multicast SID on the logical 4950 channel. This is the 64 bit version of 4951 docsIfCmtsUpChnlCtrTotalCntnReqMslots, and will not be 4952 accessible to SNMPv1 managers. 4953 Discontinuities in the value of this counter can occur 4954 at reinitialization of the managed system, and at other 4955 times as indicated by the value of 4956 ifCounterDiscontinuityTime for the associated ifIndex." 4957 ::= { docsIfCmtsUpChannelCounterEntry 21 } 4959 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots OBJECT-TYPE 4960 SYNTAX Counter64 4961 UNITS "mini-slots" 4962 MAX-ACCESS read-only 4963 STATUS current 4964 DESCRIPTION 4965 "Current count, from CMTS initialization, of contention 4966 request mini-slots utilized on this upstream logical 4967 channel. This count includes all contention mini-slots for 4968 IUC1 applicable to bursts that the CMTS correctly 4969 received. This is the 64 bit version of 4970 docsIfCmtsUpChnlCtrUsedCntnReqMslots, and will not be 4971 accessible to SNMPv1 managers. 4972 Discontinuities in the value of this counter can occur 4973 at reinitialization of the managed system, and at other 4974 times as indicated by the value of 4975 ifCounterDiscontinuityTime for the associated ifIndex." 4976 ::= { docsIfCmtsUpChannelCounterEntry 22 } 4978 docsIfCmtsUpChnlCtrExtCollCntnReqMslots OBJECT-TYPE 4979 SYNTAX Counter64 4980 UNITS "mini-slots" 4981 MAX-ACCESS read-only 4982 STATUS current 4983 DESCRIPTION 4984 "Current count, from CMTS initialization, of contention 4985 request mini-slots subjected to collisions on this upstream 4986 logical channel. This includes all contention mini-slots 4987 for IUC1 applicable to bursts that the CMTS detected, 4988 but could not correctly receive. This is the 64 bit 4989 version of docsIfCmtsUpChnlCtrCollCntnReqMslots, and will 4990 not be accessible to SNMPv1 managers. 4991 Discontinuities in the value of this counter can occur 4992 at reinitialization of the managed system, and at other 4993 times as indicated by the value of 4994 ifCounterDiscontinuityTime for the associated ifIndex." 4995 ::= { docsIfCmtsUpChannelCounterEntry 23 } 4997 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots OBJECT-TYPE 4998 SYNTAX Counter64 4999 UNITS "mini-slots" 5000 MAX-ACCESS read-only 5001 STATUS current 5002 DESCRIPTION 5003 "Current count, from CMTS initialization, of contention 5004 request data mini-slots defined for this upstream logical 5005 channel. This count includes all mini-slots for IUC2 5006 assigned to a broadcast or multicast SID on the logical 5007 channel. This is the 64 bit version of 5008 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots, and will not be 5009 accessible to SNMPv1 managers. 5010 Discontinuities in the value of this counter can occur 5011 at reinitialization of the managed system, and at other 5012 times as indicated by the value of 5013 ifCounterDiscontinuityTime for the associated ifIndex." 5014 ::= { docsIfCmtsUpChannelCounterEntry 24 } 5016 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots OBJECT-TYPE 5017 SYNTAX Counter64 5018 UNITS "mini-slots" 5019 MAX-ACCESS read-only 5020 STATUS current 5021 DESCRIPTION 5022 "Current count, from CMTS initialization, of contention 5023 request data mini-slots utilized on this upstream logical 5024 channel. This includes all contention mini-slots for IUC2 5025 applicable to bursts that the CMTS correctly received. 5026 This is the 64 bit version of 5027 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots, and will not be 5028 accessible to SNMPv1 managers. 5029 Discontinuities in the value of this counter can occur 5030 at reinitialization of the managed system, and at other 5031 times as indicated by the value of 5032 ifCounterDiscontinuityTime for the associated ifIndex." 5033 ::= { docsIfCmtsUpChannelCounterEntry 25 } 5035 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots OBJECT-TYPE 5036 SYNTAX Counter64 5037 UNITS "mini-slots" 5038 MAX-ACCESS read-only 5039 STATUS current 5040 DESCRIPTION 5041 "Current count, from CMTS initialization, of contention 5042 request data mini-slots subjected to collisions on this 5043 upstream logical channel. This includes all contention 5044 mini-slots for IUC2 applicable to bursts that the CMTS 5045 detected, but could not correctly receive. This is the 5046 64 bit version of 5047 docsIfCmtsUpChnlCtrCollCntnReqDataMslots, 5048 and will not be accessible to SNMPv1 managers. 5049 Discontinuities in the value of this counter can occur 5050 at reinitialization of the managed system, and at other 5051 times as indicated by the value of 5052 ifCounterDiscontinuityTime for the associated ifIndex." 5053 ::= { docsIfCmtsUpChannelCounterEntry 26 } 5055 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots OBJECT-TYPE 5056 SYNTAX Counter64 5057 UNITS "mini-slots" 5058 MAX-ACCESS read-only 5059 STATUS current 5060 DESCRIPTION 5061 "Current count, from CMTS initialization, of initial 5062 maintenance mini-slots defined for this upstream logical 5063 channel. This count includes all mini-slots for IUC3 5064 assigned to a broadcast or multicast SID on the logical 5065 channel. This is the 64 bit version of 5066 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots, 5067 and will not be accessible to SNMPv1 managers. 5068 Discontinuities in the value of this counter can occur 5069 at reinitialization of the managed system, and at other 5070 times as indicated by the value of 5071 ifCounterDiscontinuityTime for the associated ifIndex." 5072 ::= { docsIfCmtsUpChannelCounterEntry 27 } 5074 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots OBJECT-TYPE 5075 SYNTAX Counter64 5076 UNITS "mini-slots" 5077 MAX-ACCESS read-only 5078 STATUS current 5079 DESCRIPTION 5080 "Current count, from CMTS initialization, of initial 5081 maintenance mini-slots utilized on this upstream logical 5082 channel. This includes all contention mini-slots for IUC3 5083 applicable to bursts that the CMTS correctly received. 5084 This is the 64 bit version of 5085 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots, 5086 and will not be accessible to SNMPv1 managers. 5087 Discontinuities in the value of this counter can occur 5088 at reinitialization of the managed system, and at other 5089 times as indicated by the value of 5090 ifCounterDiscontinuityTime for the associated ifIndex." 5091 ::= { docsIfCmtsUpChannelCounterEntry 28 } 5093 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots OBJECT-TYPE 5094 SYNTAX Counter64 5095 UNITS "mini-slots" 5096 MAX-ACCESS read-only 5097 STATUS current 5098 DESCRIPTION 5099 "Current count, from CMTS initialization, of contention 5100 initial maintenance mini-slots subjected to collisions on 5101 this upstream logical channel. This includes all 5102 contention mini-slots for IUC3 applicable to bursts that 5103 the CMTS detected, but could not correctly receive. 5104 This is the 64 bit version of 5105 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots, and will not 5106 be accessible to SNMPv1 managers. 5107 Discontinuities in the value of this counter can occur 5108 at reinitialization of the managed system, and at other 5109 times as indicated by the value of 5110 ifCounterDiscontinuityTime for the associated ifIndex." 5111 ::= { docsIfCmtsUpChannelCounterEntry 29 } 5113 -- 5114 -- The notification group is for future extension. 5115 -- 5117 docsIfNotification OBJECT IDENTIFIER ::= { docsIfMib 2 } 5119 -- 5120 -- MIB Compliance Statements. 5121 -- 5122 -- 5123 -- RFC 2670 Conformance Definitions 5124 -- 5126 docsIfConformance OBJECT IDENTIFIER ::= { docsIfMib 3 } 5127 docsIfCompliances OBJECT IDENTIFIER ::= { docsIfConformance 1 } 5128 docsIfGroups OBJECT IDENTIFIER ::= { docsIfConformance 2 } 5130 -- 5131 -- RFC XXXX Conformance Definitions 5132 -- 5133 -- ************************************************************ 5134 -- * NOTES TO RFC Editor (to be removed prior to publication) * 5135 -- * * 5136 -- * replace XXXX with the IANA assigned RFC number * 5137 -- of this document * 5138 -- * * 5139 -- ************************************************************ 5141 docsIfCompliancesV2 OBJECT IDENTIFIER ::= { docsIfConformance 3 } 5142 docsIfGroupsV2 OBJECT IDENTIFIER ::= { docsIfConformance 4 } 5144 docsIfBasicCompliance MODULE-COMPLIANCE 5145 STATUS deprecated 5146 DESCRIPTION 5147 "The compliance statement for devices that implement 5148 MCNS/DOCSIS compliant Radio Frequency Interfaces." 5150 MODULE -- docsIfMib 5152 -- unconditionally mandatory groups 5153 MANDATORY-GROUPS { 5154 docsIfBasicGroup 5155 } 5157 -- conditionally mandatory group 5158 GROUP docsIfCmGroup 5159 DESCRIPTION 5160 "This group is implemented only in Cable Modems, not in 5161 Cable Modem Termination Systems." 5163 -- conditionally mandatory group 5164 GROUP docsIfCmtsGroup 5165 DESCRIPTION 5166 "This group is implemented only in Cable Modem Termination 5167 Systems, not in Cable Modems." 5169 OBJECT docsIfDownChannelFrequency 5170 WRITE-SYNTAX Integer32 (54000000..860000000) 5171 MIN-ACCESS read-only 5172 DESCRIPTION 5173 "Read-write in Cable Modem Termination Systems; 5174 read-only in Cable Modems. The values above are 5175 appropriate for a cable plant using a Sub-Split channel 5176 plan. If DOCSIS is extended to cover other types of 5177 channel plans (and frequency allocations) this object 5178 will be modified accordingly." 5180 OBJECT docsIfDownChannelWidth 5181 WRITE-SYNTAX Integer32 (6000000) 5182 MIN-ACCESS read-only 5183 DESCRIPTION 5184 "It is conformant to implement this object as read-only. 5185 In Cable Modems, this object is always implemented as 5186 read-only. The above value is appropriate for cable 5187 plants running under NTSC (National Television 5188 Standards Committee) standards. If DOCSIS is extended to 5189 work with other standard (e.g. European standards), this 5190 object will be modified accordingly." 5192 OBJECT docsIfDownChannelModulation 5193 WRITE-SYNTAX INTEGER { 5194 qam64 (3), 5195 qam256 (4) 5196 } 5197 MIN-ACCESS read-only 5198 DESCRIPTION 5199 "Read-write in Cable Modem Termination Systems; 5200 read-only in Cable Modems." 5202 OBJECT docsIfDownChannelInterleave 5203 WRITE-SYNTAX INTEGER { 5204 taps8Increment16(3), 5205 taps16Increment8(4), 5206 taps32Increment4(5), 5207 taps64Increment2(6), 5208 taps128Increment1(7) 5209 } 5210 MIN-ACCESS read-only 5211 DESCRIPTION 5212 "Read-write in Cable Modem Termination Systems; 5213 read-only in Cable Modems." 5215 OBJECT docsIfDownChannelPower 5216 MIN-ACCESS read-only 5217 DESCRIPTION 5218 "Read-write in Cable Modem Termination Systems; 5219 read-only in Cable Modems." 5221 OBJECT docsIfUpChannelFrequency 5222 WRITE-SYNTAX Integer32 (5000000..42000000) 5223 MIN-ACCESS read-only 5224 DESCRIPTION 5225 "Read-write in Cable Modem Termination Systems; 5226 read-only in Cable Modems.The values above are 5227 appropriate for a cable plant using a Sub-Split channel 5228 plan. If DOCSIS is extended to cover other types of 5229 channel plans (and frequency allocations) this object 5230 will be modified accordingly." 5232 OBJECT docsIfUpChannelWidth 5233 WRITE-SYNTAX Integer32 (200000..3200000) 5234 MIN-ACCESS read-only 5235 DESCRIPTION 5236 "Read-write in Cable Modem Termination Systems; 5237 read-only in Cable Modems.The above value is appropriate 5238 for cable plants running under NTSC (National Television 5239 Standards Committee) standards. If DOCSIS is extended to 5240 work with other standard (e.g. European standards), this 5241 object will be modified accordingly." 5243 OBJECT docsIfUpChannelModulationProfile 5244 MIN-ACCESS read-only 5245 DESCRIPTION 5246 "Read-write in Cable Modem Termination Systems; 5247 read-only in Cable Modems." 5249 OBJECT docsIfUpChannelSlotSize 5250 MIN-ACCESS read-only 5251 DESCRIPTION 5252 "This object is always read-only in Cable Modems. 5253 It is compliant to implement this object as read-only 5254 in Cable Modem Termination Systems." 5256 OBJECT docsIfUpChannelRangingBackoffStart 5257 MIN-ACCESS read-only 5258 DESCRIPTION 5259 "Read-write in Cable Modem Termination Systems; 5260 read-only in Cable Modems." 5262 OBJECT docsIfUpChannelRangingBackoffEnd 5263 MIN-ACCESS read-only 5264 DESCRIPTION 5265 "Read-write in Cable Modem Termination Systems; 5266 read-only in Cable Modems." 5268 OBJECT docsIfUpChannelTxBackoffStart 5269 MIN-ACCESS read-only 5270 DESCRIPTION 5271 "Read-write in Cable Modem Termination Systems; 5272 read-only in Cable Modems." 5274 OBJECT docsIfUpChannelTxBackoffEnd 5275 MIN-ACCESS read-only 5276 DESCRIPTION 5277 "Read-write in Cable Modem Termination Systems; 5278 read-only in Cable Modems." 5280 OBJECT docsIfQosProfPriority 5281 MIN-ACCESS read-only 5282 DESCRIPTION 5283 "This object is always read-only in Cable Modems. 5284 It is compliant to implement this object as read-only 5285 in Cable Modem Termination Systems." 5287 OBJECT docsIfQosProfMaxUpBandwidth 5288 MIN-ACCESS read-only 5289 DESCRIPTION 5290 "This object is always read-only in Cable Modems. 5291 It is compliant to implement this object as read-only 5292 in Cable Modem Termination Systems." 5294 OBJECT docsIfQosProfGuarUpBandwidth 5295 MIN-ACCESS read-only 5296 DESCRIPTION 5297 "This object is always read-only in Cable Modems. 5298 It is compliant to implement this object as read-only 5299 in Cable Modem Termination Systems." 5301 OBJECT docsIfQosProfMaxDownBandwidth 5302 MIN-ACCESS read-only 5303 DESCRIPTION 5304 "This object is always read-only in Cable Modems. 5305 It is compliant to implement this object as read-only 5306 in Cable Modem Termination Systems." 5308 OBJECT docsIfQosProfMaxTxBurst 5309 MIN-ACCESS read-only 5310 DESCRIPTION 5311 "This object is always read-only in Cable Modems. 5312 It is compliant to implement this object as read-only 5313 in Cable Modem Termination Systems." 5315 OBJECT docsIfQosProfBaselinePrivacy 5316 MIN-ACCESS read-only 5317 DESCRIPTION 5318 "This object is always read-only in Cable Modems. 5319 It is compliant to implement this object as read-only 5320 in Cable Modem Termination Systems." 5322 OBJECT docsIfQosProfStatus 5323 MIN-ACCESS read-only 5324 DESCRIPTION 5325 "This object is always read-only in Cable Modems. 5326 It is compliant to implement this object as read-only 5327 in Cable Modem Termination Systems." 5329 OBJECT docsIfCmtsServiceAdminStatus 5330 MIN-ACCESS read-only 5331 DESCRIPTION 5332 "It is compliant to implement this object as read-only." 5334 OBJECT docsIfCmtsSyncInterval 5335 MIN-ACCESS read-only 5336 DESCRIPTION 5337 "It is compliant to implement this object as read-only." 5339 OBJECT docsIfCmtsUcdInterval 5340 MIN-ACCESS read-only 5341 DESCRIPTION 5342 "It is compliant to implement this object as read-only." 5344 OBJECT docsIfCmtsInsertInterval 5345 MIN-ACCESS read-only 5346 DESCRIPTION 5347 "It is compliant to implement this object as read-only." 5349 OBJECT docsIfCmtsInvitedRangingAttempts 5350 MIN-ACCESS read-only 5351 DESCRIPTION 5352 "It is compliant to implement this object as read-only." 5354 OBJECT docsIfCmtsQosProfilePermissions 5355 MIN-ACCESS read-only 5356 DESCRIPTION 5357 "It is compliant to implement this object as read-only." 5359 OBJECT docsIfCmtsModType 5360 WRITE-SYNTAX INTEGER { 5361 qpsk (2), 5362 qam16 (3) 5363 } 5364 DESCRIPTION 5365 "Management station may only set 16QAM or QPSK modulation, 5366 but others might be possible based on device 5367 configuration." 5369 ::= { docsIfCompliances 1 } 5371 docsIfBasicComplianceV2 MODULE-COMPLIANCE 5372 STATUS current 5373 DESCRIPTION 5374 "The compliance statement for devices that implement 5375 MCNS/DOCSIS compliant Radio Frequency Interfaces." 5377 MODULE -- docsIfMib 5379 -- unconditionally mandatory groups 5380 MANDATORY-GROUPS { 5381 docsIfBasicGroupV2 5382 } 5384 -- conditionally mandatory group 5385 GROUP docsIfCmGroupV2 5386 DESCRIPTION 5387 "This group is implemented only in Cable Modems, not in 5388 Cable Modem Termination Systems." 5390 -- conditionally mandatory group 5391 GROUP docsIfCmtsGroupV2 5392 DESCRIPTION 5393 "This group is implemented only in Cable Modem Termination 5394 Systems, not in Cable Modems." 5396 -- Optional groups 5398 GROUP docsIfCmtsOptionalGroupV2 5399 DESCRIPTION 5400 "This group is optional for Cable Modem Termination Systems, 5401 and not applicable for Cable Modems." 5403 OBJECT docsIfDownChannelFrequency 5404 WRITE-SYNTAX Integer32 (47000000..862000000) 5405 MIN-ACCESS read-only 5406 DESCRIPTION 5407 "Read-write in Cable Modem Termination Systems, 5408 read-only in Cable Modems. 5409 A range of 54MHz to 860MHz is appropriate for a cable 5410 plant using a North American Sub-Split channel plan. 5411 The spectrum range has been expanded to accommodate 5412 a lower edge of 47MHz and an upper edge of 862MHz 5413 for some European channel plans. 5414 If DOCSIS is extended to cover other types of channel 5415 plans (and frequency allocations) this object will be 5416 modified accordingly." 5418 OBJECT docsIfDownChannelWidth 5419 WRITE-SYNTAX Integer32 (6000000 | 8000000) 5420 MIN-ACCESS read-only 5421 DESCRIPTION 5422 "It is conformant to implement this object as read-only. 5423 In Cable Modems, this object is always implemented as 5424 read-only. The value of 6 MHz is appropriate for cable 5425 plants running under NTSC (National Television 5426 Standards Committee) standards. The value of 8 MHz is 5427 appropriate for cable plants running under ETSI 5428 standards. For other regional standards, this 5429 object will be modified accordingly." 5431 OBJECT docsIfDownChannelModulation 5432 WRITE-SYNTAX INTEGER { 5433 qam64 (3), 5434 qam256 (4) 5435 } 5436 MIN-ACCESS read-only 5437 DESCRIPTION 5438 "Read-write in Cable Modem Termination Systems, 5439 read-only in Cable Modems." 5441 OBJECT docsIfDownChannelInterleave 5442 WRITE-SYNTAX INTEGER { 5443 taps8Increment16(3), 5444 taps16Increment8(4), 5445 taps32Increment4(5), 5446 taps64Increment2(6), 5447 taps128Increment1(7), 5448 taps12increment17(8) 5449 } 5450 MIN-ACCESS read-only 5451 DESCRIPTION 5452 "Read-write in Cable Modem Termination Systems, 5453 read-only in Cable Modems." 5455 OBJECT docsIfDownChannelPower 5456 MIN-ACCESS read-only 5457 DESCRIPTION 5458 "Read-write in Cable Modem Termination Systems, 5459 read-only in Cable Modems." 5461 OBJECT docsIfUpChannelFrequency 5462 WRITE-SYNTAX Integer32 (5000000..65000000) 5463 MIN-ACCESS read-only 5464 DESCRIPTION 5465 "Read-create in Cable Modem Termination Systems, 5466 read-only in Cable Modems. 5467 A range of 5MHz to 42MHz is appropriate for a cable 5468 plant using a North American Sub-Split channel plan. 5469 The spectrum range has been expanded to accommodate 5470 an upper edge of 65MHz for some European channel plans. 5471 If DOCSIS is extended to cover other types of channel 5472 plans (and frequency allocations) this object will 5473 be modified accordingly." 5475 OBJECT docsIfUpChannelWidth 5476 WRITE-SYNTAX Integer32 (200000..6400000) 5477 MIN-ACCESS read-only 5478 DESCRIPTION 5479 "Read-create in Cable Modem Termination Systems, 5480 read-only in Cable Modems. The above value is appropriate 5481 for cable plants running under NTSC (National Television 5482 Standards Committee) standards. If DOCSIS is extended to 5483 work with other standard (e.g. European standards), this 5484 object will be modified accordingly." 5486 OBJECT docsIfUpChannelModulationProfile 5487 MIN-ACCESS read-only 5488 DESCRIPTION 5489 "Read-create in Cable Modem Termination Systems, 5490 read-only in Cable Modems." 5492 OBJECT docsIfUpChannelSlotSize 5493 MIN-ACCESS read-only 5494 DESCRIPTION 5495 "This object is always read-only in Cable Modems. 5496 It is compliant to implement this object as read-only 5497 in Cable Modem Termination Systems." 5499 OBJECT docsIfUpChannelRangingBackoffStart 5500 MIN-ACCESS read-only 5501 DESCRIPTION 5502 "Read-create in Cable Modem Termination Systems, 5503 read-only in Cable Modems." 5505 OBJECT docsIfUpChannelRangingBackoffEnd 5506 MIN-ACCESS read-only 5507 DESCRIPTION 5508 "Read-create in Cable Modem Termination Systems, 5509 read-only in Cable Modems." 5511 OBJECT docsIfUpChannelTxBackoffStart 5512 MIN-ACCESS read-only 5513 DESCRIPTION 5514 "Read-create in Cable Modem Termination Systems, 5515 read-only in Cable Modems." 5517 OBJECT docsIfUpChannelTxBackoffEnd 5518 MIN-ACCESS read-only 5519 DESCRIPTION 5520 "Read-create in Cable Modem Termination Systems, 5521 read-only in Cable Modems." 5523 OBJECT docsIfUpChannelScdmaActiveCodes 5524 MIN-ACCESS read-only 5525 DESCRIPTION 5526 "Read-create in Cable Modem Termination Systems, 5527 read-only in Cable Modems. 5528 The number of active codes when SCDMA is in use must range 5529 from 64 to 128, and must be a non-Prime value. 5530 Providing this range allows for the following features 5531 and capabilities: 5532 1) Power management in S-CDMA spreader-on frames 5533 (with a 3 dB spread) 5534 2) Avoidance of code 0 5535 3) Flexible mini-slot sizes with and without the use of 5536 code 0" 5538 OBJECT docsIfUpChannelScdmaCodesPerSlot 5539 MIN-ACCESS read-only 5540 DESCRIPTION 5541 "Read-create in Cable Modem Termination Systems, 5542 read-only in Cable Modems." 5544 OBJECT docsIfUpChannelScdmaFrameSize 5545 MIN-ACCESS read-only 5546 DESCRIPTION 5547 "Read-create in Cable Modem Termination Systems, 5548 read-only in Cable Modems." 5550 OBJECT docsIfUpChannelScdmaHoppingSeed 5551 MIN-ACCESS read-only 5552 DESCRIPTION 5553 "Read-create in Cable Modem Termination Systems, 5554 read-only in Cable Modems." 5556 OBJECT docsIfUpChannelCloneFrom 5557 MIN-ACCESS read-only 5558 DESCRIPTION 5559 "Read-create in Cable Modem Termination Systems, 5560 read-only in Cable Modems." 5562 OBJECT docsIfUpChannelUpdate 5563 MIN-ACCESS read-only 5564 DESCRIPTION 5565 "Read-create in Cable Modem Termination Systems, 5566 read-only in Cable Modems." 5568 OBJECT docsIfUpChannelStatus 5569 MIN-ACCESS read-only 5570 DESCRIPTION 5571 "Read-create in Cable Modem Termination Systems, 5572 read-only in Cable Modems." 5574 OBJECT docsIfUpChannelPreEqEnable 5575 MIN-ACCESS read-only 5576 DESCRIPTION 5577 "Read-create in Cable Modem Termination Systems, 5578 read-only in Cable Modems." 5580 OBJECT docsIfQosProfPriority 5581 MIN-ACCESS read-only 5582 DESCRIPTION 5583 "This object is always read-only in Cable Modems. 5584 It is compliant to implement this object as read-only 5585 in Cable Modem Termination Systems." 5587 OBJECT docsIfQosProfMaxUpBandwidth 5588 MIN-ACCESS read-only 5589 DESCRIPTION 5590 "This object is always read-only in Cable Modems. 5591 It is compliant to implement this object as read-only 5592 in Cable Modem Termination Systems." 5594 OBJECT docsIfQosProfGuarUpBandwidth 5595 MIN-ACCESS read-only 5596 DESCRIPTION 5597 "This object is always read-only in Cable Modems. 5598 It is compliant to implement this object as read-only 5599 in Cable Modem Termination Systems." 5601 OBJECT docsIfQosProfMaxDownBandwidth 5602 MIN-ACCESS read-only 5603 DESCRIPTION 5604 "This object is always read-only in Cable Modems. 5605 It is compliant to implement this object as read-only 5606 in Cable Modem Termination Systems." 5608 OBJECT docsIfQosProfBaselinePrivacy 5609 MIN-ACCESS read-only 5610 DESCRIPTION 5611 "This object is always read-only in Cable Modems. 5612 It is compliant to implement this object as read-only 5613 in Cable Modem Termination Systems." 5615 OBJECT docsIfQosProfStatus 5616 MIN-ACCESS read-only 5617 DESCRIPTION 5618 "This object is always read-only in Cable Modems. 5619 It is compliant to implement this object as read-only 5620 in Cable Modem Termination Systems." 5622 OBJECT docsIfQosProfMaxTransmitBurst 5623 MIN-ACCESS read-only 5624 DESCRIPTION 5625 "This object is always read-only in Cable Modems. 5626 It is compliant to implement this object as read-only 5627 in Cable Modem Termination Systems." 5629 OBJECT docsIfCmtsServiceAdminStatus 5630 MIN-ACCESS read-only 5631 DESCRIPTION 5632 "It is compliant to implement this object as read-only." 5634 OBJECT docsIfCmtsSyncInterval 5635 MIN-ACCESS read-only 5636 DESCRIPTION 5637 "It is compliant to implement this object as read-only." 5639 OBJECT docsIfCmtsUcdInterval 5640 MIN-ACCESS read-only 5641 DESCRIPTION 5642 "It is compliant to implement this object as read-only." 5644 OBJECT docsIfCmtsInsertInterval 5645 MIN-ACCESS read-only 5646 DESCRIPTION 5647 "It is compliant to implement this object as read-only." 5649 OBJECT docsIfCmtsInvitedRangingAttempts 5650 MIN-ACCESS read-only 5651 DESCRIPTION 5652 "It is compliant to implement this object as read-only." 5654 OBJECT docsIfCmtsQosProfilePermissions 5655 MIN-ACCESS read-only 5656 DESCRIPTION 5657 "It is compliant to implement this object as read-only." 5659 ::= { docsIfCompliancesV2 1 } 5661 docsIfBasicGroup OBJECT-GROUP 5662 OBJECTS { 5663 docsIfDownChannelId, 5664 docsIfDownChannelFrequency, 5665 docsIfDownChannelWidth, 5666 docsIfDownChannelModulation, 5667 docsIfDownChannelInterleave, 5668 docsIfDownChannelPower, 5669 docsIfUpChannelId, 5670 docsIfUpChannelFrequency, 5671 docsIfUpChannelWidth, 5672 docsIfUpChannelModulationProfile, 5673 docsIfUpChannelSlotSize, 5674 docsIfUpChannelTxTimingOffset, 5675 docsIfUpChannelRangingBackoffStart, 5676 docsIfUpChannelRangingBackoffEnd, 5677 docsIfUpChannelTxBackoffStart, 5678 docsIfUpChannelTxBackoffEnd, 5679 docsIfQosProfPriority, 5680 docsIfQosProfMaxUpBandwidth, 5681 docsIfQosProfGuarUpBandwidth, 5682 docsIfQosProfMaxDownBandwidth, 5683 docsIfQosProfMaxTxBurst, 5684 docsIfQosProfBaselinePrivacy, 5685 docsIfQosProfStatus, 5686 docsIfSigQIncludesContention, 5687 docsIfSigQUnerroreds, 5688 docsIfSigQCorrecteds, 5689 docsIfSigQUncorrectables, 5690 docsIfSigQSignalNoise, 5691 docsIfSigQMicroreflections, 5692 docsIfSigQEqualizationData 5693 } 5694 STATUS deprecated 5695 DESCRIPTION 5696 "Group of objects implemented in both Cable Modems and 5697 Cable Modem Termination Systems." 5698 ::= { docsIfGroups 1 } 5700 docsIfCmGroup OBJECT-GROUP 5701 OBJECTS { 5702 docsIfCmCmtsAddress, 5703 docsIfCmCapabilities, 5704 docsIfCmRangingTimeout, 5705 docsIfCmStatusValue, 5706 docsIfCmStatusCode, 5707 docsIfCmStatusTxPower, 5708 docsIfCmStatusResets, 5709 docsIfCmStatusLostSyncs, 5710 docsIfCmStatusInvalidMaps, 5711 docsIfCmStatusInvalidUcds, 5712 docsIfCmStatusInvalidRangingResponses, 5713 docsIfCmStatusInvalidRegistrationResponses, 5714 docsIfCmStatusT1Timeouts, 5715 docsIfCmStatusT2Timeouts, 5716 docsIfCmStatusT3Timeouts, 5717 docsIfCmStatusT4Timeouts, 5718 docsIfCmStatusRangingAborteds, 5719 docsIfCmServiceQosProfile, 5720 docsIfCmServiceTxSlotsImmed, 5721 docsIfCmServiceTxSlotsDed, 5722 docsIfCmServiceTxRetries, 5723 docsIfCmServiceTxExceededs, 5724 docsIfCmServiceRqRetries, 5725 docsIfCmServiceRqExceededs 5726 } 5727 STATUS deprecated 5728 DESCRIPTION 5729 "Group of objects implemented in Cable Modems." 5730 ::= { docsIfGroups 2 } 5732 docsIfCmtsGroup OBJECT-GROUP 5733 OBJECTS { 5734 docsIfCmtsCapabilities, 5735 docsIfCmtsSyncInterval, 5736 docsIfCmtsUcdInterval, 5737 docsIfCmtsMaxServiceIds, 5738 docsIfCmtsInvitedRangingAttempts, 5739 docsIfCmtsInsertInterval, 5740 docsIfCmtsStatusInvalidRangeReqs, 5741 docsIfCmtsStatusRangingAborteds, 5742 docsIfCmtsStatusInvalidRegReqs, 5743 docsIfCmtsStatusFailedRegReqs, 5744 docsIfCmtsStatusInvalidDataReqs, 5745 docsIfCmtsStatusT5Timeouts, 5746 docsIfCmtsCmStatusMacAddress, 5747 docsIfCmtsCmStatusIpAddress, 5748 docsIfCmtsCmStatusDownChannelIfIndex, 5749 docsIfCmtsCmStatusUpChannelIfIndex, 5750 docsIfCmtsCmStatusRxPower, 5751 docsIfCmtsCmStatusTimingOffset, 5752 docsIfCmtsCmStatusEqualizationData, 5753 docsIfCmtsCmStatusValue, 5754 docsIfCmtsCmStatusUnerroreds, 5755 docsIfCmtsCmStatusCorrecteds, 5756 docsIfCmtsCmStatusUncorrectables, 5757 docsIfCmtsCmStatusSignalNoise, 5758 docsIfCmtsCmStatusMicroreflections, 5759 docsIfCmtsServiceCmStatusIndex, 5760 docsIfCmtsServiceAdminStatus, 5761 docsIfCmtsServiceQosProfile, 5762 docsIfCmtsServiceCreateTime, 5763 docsIfCmtsServiceInOctets, 5764 docsIfCmtsServiceInPackets, 5765 docsIfCmtsModType, 5766 docsIfCmtsModControl, 5767 docsIfCmtsModPreambleLen, 5768 docsIfCmtsModDifferentialEncoding, 5769 docsIfCmtsModFECErrorCorrection, 5770 docsIfCmtsModFECCodewordLength, 5771 docsIfCmtsModScramblerSeed, 5772 docsIfCmtsModMaxBurstSize, 5773 docsIfCmtsModGuardTimeSize, 5774 docsIfCmtsModLastCodewordShortened, 5775 docsIfCmtsModScrambler, 5776 docsIfCmtsQosProfilePermissions, 5777 docsIfCmtsCmPtr 5779 } 5780 STATUS deprecated 5781 DESCRIPTION 5782 "Group of objects implemented in Cable Modem Termination 5783 Systems." 5784 ::= { docsIfGroups 3 } 5786 docsIfObsoleteGroup OBJECT-GROUP 5787 OBJECTS { 5788 docsIfCmRangingRespTimeout, 5789 docsIfCmtsInsertionInterval 5790 } 5791 STATUS obsolete 5792 DESCRIPTION 5793 "Group of objects obsoleted." 5794 ::= { docsIfGroups 5 } 5796 docsIfBasicGroupV2 OBJECT-GROUP 5797 OBJECTS { 5798 docsIfDownChannelId, 5799 docsIfDownChannelFrequency, 5800 docsIfDownChannelWidth, 5801 docsIfDownChannelModulation, 5802 docsIfDownChannelInterleave, 5803 docsIfDownChannelPower, 5804 docsIfDownChannelAnnex, 5805 docsIfUpChannelId, 5806 docsIfUpChannelFrequency, 5807 docsIfUpChannelWidth, 5808 docsIfUpChannelModulationProfile, 5809 docsIfUpChannelSlotSize, 5810 docsIfUpChannelTxTimingOffset, 5811 docsIfUpChannelRangingBackoffStart, 5812 docsIfUpChannelRangingBackoffEnd, 5813 docsIfUpChannelTxBackoffStart, 5814 docsIfUpChannelTxBackoffEnd, 5815 docsIfUpChannelScdmaActiveCodes, 5816 docsIfUpChannelScdmaCodesPerSlot, 5817 docsIfUpChannelScdmaFrameSize, 5818 docsIfUpChannelScdmaHoppingSeed, 5819 docsIfUpChannelType, 5820 docsIfUpChannelCloneFrom, 5821 docsIfUpChannelUpdate, 5822 docsIfUpChannelStatus, 5823 docsIfUpChannelPreEqEnable, 5824 docsIfQosProfPriority, 5825 docsIfQosProfMaxUpBandwidth, 5826 docsIfQosProfGuarUpBandwidth, 5827 docsIfQosProfMaxDownBandwidth, 5828 docsIfQosProfBaselinePrivacy, 5829 docsIfQosProfStatus, 5830 docsIfQosProfMaxTransmitBurst, 5831 docsIfSigQIncludesContention, 5832 docsIfSigQUnerroreds, 5833 docsIfSigQCorrecteds, 5834 docsIfSigQUncorrectables, 5835 docsIfSigQSignalNoise, 5836 docsIfSigQMicroreflections, 5837 docsIfSigQEqualizationData, 5838 docsIfSigQExtUnerroreds, 5839 docsIfSigQExtCorrecteds, 5840 docsIfSigQExtUncorrectables, 5841 docsIfDocsisBaseCapability 5842 } 5843 STATUS current 5844 DESCRIPTION 5845 "Group of objects implemented in both Cable Modems and 5846 Cable Modem Termination Systems." 5847 ::= { docsIfGroupsV2 1 } 5849 docsIfCmGroupV2 OBJECT-GROUP 5850 OBJECTS { 5851 docsIfCmCmtsAddress, 5852 docsIfCmCapabilities, 5853 docsIfCmRangingTimeout, 5854 docsIfCmStatusValue, 5855 docsIfCmStatusCode, 5856 docsIfCmStatusTxPower, 5857 docsIfCmStatusResets, 5858 docsIfCmStatusLostSyncs, 5859 docsIfCmStatusInvalidMaps, 5860 docsIfCmStatusInvalidUcds, 5861 docsIfCmStatusInvalidRangingResponses, 5862 docsIfCmStatusInvalidRegistrationResponses, 5863 docsIfCmStatusT1Timeouts, 5864 docsIfCmStatusT2Timeouts, 5865 docsIfCmStatusT3Timeouts, 5866 docsIfCmStatusT4Timeouts, 5867 docsIfCmStatusRangingAborteds, 5868 docsIfCmStatusDocsisOperMode, 5869 docsIfCmStatusModulationType, 5870 docsIfCmStatusEqualizationData, 5871 docsIfCmStatusUCCs, 5872 docsIfCmStatusUCCFails, 5873 docsIfCmServiceQosProfile, 5874 docsIfCmServiceTxSlotsImmed, 5875 docsIfCmServiceTxSlotsDed, 5876 docsIfCmServiceTxRetries, 5877 docsIfCmServiceTxExceededs, 5878 docsIfCmServiceRqRetries, 5879 docsIfCmServiceRqExceededs, 5880 docsIfCmServiceExtTxSlotsImmed, 5881 docsIfCmServiceExtTxSlotsDed 5883 } 5884 STATUS current 5885 DESCRIPTION 5886 "Group of objects implemented in Cable Modems." 5887 ::= { docsIfGroupsV2 2 } 5889 docsIfCmtsGroupV2 OBJECT-GROUP 5890 OBJECTS { 5891 docsIfCmtsCapabilities, 5892 docsIfCmtsSyncInterval, 5893 docsIfCmtsUcdInterval, 5894 docsIfCmtsMaxServiceIds, 5895 docsIfCmtsInvitedRangingAttempts, 5896 docsIfCmtsInsertInterval, 5897 docsIfCmtsStatusInvalidRangeReqs, 5898 docsIfCmtsStatusRangingAborteds, 5899 docsIfCmtsStatusInvalidRegReqs, 5900 docsIfCmtsStatusFailedRegReqs, 5901 docsIfCmtsStatusInvalidDataReqs, 5902 docsIfCmtsStatusT5Timeouts, 5903 docsIfCmtsCmStatusMacAddress, 5904 docsIfCmtsCmStatusDownChannelIfIndex, 5905 docsIfCmtsCmStatusUpChannelIfIndex, 5906 docsIfCmtsCmStatusRxPower, 5907 docsIfCmtsCmStatusTimingOffset, 5908 docsIfCmtsCmStatusEqualizationData, 5909 docsIfCmtsCmStatusValue, 5910 docsIfCmtsCmStatusUnerroreds, 5911 docsIfCmtsCmStatusCorrecteds, 5912 docsIfCmtsCmStatusUncorrectables, 5913 docsIfCmtsCmStatusSignalNoise, 5914 docsIfCmtsCmStatusMicroreflections, 5915 docsIfCmtsCmStatusExtUnerroreds, 5916 docsIfCmtsCmStatusExtCorrecteds, 5917 docsIfCmtsCmStatusExtUncorrectables, 5918 docsIfCmtsCmStatusDocsisRegMode, 5919 docsIfCmtsCmStatusModulationType, 5920 docsIfCmtsCmStatusInetAddressType, 5921 docsIfCmtsCmStatusInetAddress, 5922 docsIfCmtsCmStatusValueLastUpdate, 5923 docsIfCmtsCmStatusHighResolutionTimingOffset, 5924 docsIfCmtsServiceAdminStatus, 5925 docsIfCmtsServiceQosProfile, 5926 docsIfCmtsServiceCreateTime, 5927 docsIfCmtsServiceInOctets, 5928 docsIfCmtsServiceInPackets, 5929 docsIfCmtsServiceNewCmStatusIndex, 5930 docsIfCmtsModType, 5931 docsIfCmtsModControl, 5932 docsIfCmtsModPreambleLen, 5933 docsIfCmtsModDifferentialEncoding, 5934 docsIfCmtsModFECErrorCorrection, 5935 docsIfCmtsModFECCodewordLength, 5936 docsIfCmtsModScramblerSeed, 5937 docsIfCmtsModMaxBurstSize, 5938 docsIfCmtsModGuardTimeSize, 5939 docsIfCmtsModLastCodewordShortened, 5940 docsIfCmtsModScrambler, 5941 docsIfCmtsModByteInterleaverDepth, 5942 docsIfCmtsModByteInterleaverBlockSize, 5943 docsIfCmtsModPreambleType, 5944 docsIfCmtsModTcmErrorCorrectionOn, 5945 docsIfCmtsModScdmaInterleaverStepSize, 5946 docsIfCmtsModScdmaSpreaderEnable, 5947 docsIfCmtsModScdmaSubframeCodes, 5948 docsIfCmtsModChannelType, 5949 docsIfCmtsQosProfilePermissions, 5950 docsIfCmtsCmPtr, 5951 docsIfCmtsChannelUtilizationInterval, 5952 docsIfCmtsChannelUtUtilization, 5953 docsIfCmtsDownChnlCtrId, 5954 docsIfCmtsDownChnlCtrTotalBytes, 5955 docsIfCmtsDownChnlCtrUsedBytes, 5956 docsIfCmtsDownChnlCtrExtTotalBytes, 5957 docsIfCmtsDownChnlCtrExtUsedBytes, 5958 docsIfCmtsUpChnlCtrId, 5959 docsIfCmtsUpChnlCtrTotalMslots, 5960 docsIfCmtsUpChnlCtrUcastGrantedMslots, 5961 docsIfCmtsUpChnlCtrTotalCntnMslots, 5962 docsIfCmtsUpChnlCtrUsedCntnMslots, 5963 docsIfCmtsUpChnlCtrExtTotalMslots, 5964 docsIfCmtsUpChnlCtrExtUcastGrantedMslots, 5965 docsIfCmtsUpChnlCtrExtTotalCntnMslots, 5966 docsIfCmtsUpChnlCtrExtUsedCntnMslots 5967 } 5968 STATUS current 5969 DESCRIPTION 5970 "Group of objects implemented in Cable Modem Termination 5971 Systems." 5972 ::= { docsIfGroupsV2 3 } 5974 docsIfCmtsOptionalGroupV2 OBJECT-GROUP 5975 OBJECTS { 5976 docsIfCmtsUpChnlCtrCollCntnMslots, 5977 docsIfCmtsUpChnlCtrTotalCntnReqMslots, 5978 docsIfCmtsUpChnlCtrUsedCntnReqMslots, 5979 docsIfCmtsUpChnlCtrCollCntnReqMslots, 5980 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots, 5981 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots, 5982 docsIfCmtsUpChnlCtrCollCntnReqDataMslots, 5983 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots, 5984 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots, 5985 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots, 5986 docsIfCmtsUpChnlCtrExtCollCntnMslots, 5987 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots, 5988 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots, 5989 docsIfCmtsUpChnlCtrExtCollCntnReqMslots, 5990 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots, 5991 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots, 5992 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots, 5993 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots, 5994 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots, 5995 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots 5996 } 5997 STATUS current 5998 DESCRIPTION 5999 "Group of objects implemented optionally in Cable Modem 6000 Termination Systems." 6001 ::= { docsIfGroupsV2 4 } 6003 END 6005 5. Acknowledgments 6007 This document is a production of the IPCDN working group based on 6008 Contributions from numerous members of the CableLabs DOCSIS 2.0 6009 OSS Working Group. 6010 It is a revision of RFC 2670, "Radio Frequency (RF) 6011 Interface Management Information Base for DOCSIS compliant RF 6012 interfaces" [RFC2670]. 6014 The authors and editor wishes to express gratitude to Rich Prodan, 6015 Aviv Goren, Greg Nakanishi, Rich Woundy, Andr� Lejeune, Adi Shaliv, 6016 Greg White, Dan Rice, Minnie Lu and Jean-Francois Mule for their 6017 valued advice and opinions. 6019 6. Revision History 6021 6.1. Scope 6023 This MIB in this document has been developed to accommodate 6024 DOCSIS 2.0 devices and their system capabilities. The MIB is an 6025 update to RFC 2670 with the additional incorporation of Euro-DOCSIS 6026 and DOCSIS specification requirements. 6028 6.2. Extension 6029 We have maintained the MIB objects as defined in RFC 2670. In some 6030 cases new MIB module objects have been created with identical 6031 functionality but greater capacity (i.e. 32 to 64 bits). In these 6032 situations, both the original 32 bit objects and the new 64 bit 6033 objects must be implemented. 6035 7. Normative References 6037 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 6038 Requirement Levels", BCP 14, RFC 2119, March 1997. 6040 [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., 6041 Rose, M. and S. Waldbusser, "Structure of Management 6042 Information Version 2 (SMIv2)", STD 58, RFC 2578, April 6043 1999. 6045 [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., 6046 Rose, M. and S. Waldbusser, "Textual Conventions for 6047 SMIv2", STD 58, RFC 2579, April 1999. 6049 [RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., 6050 Rose, M. and S. Waldbusser, "Conformance Statements for 6051 SMIv2", RFC 2580, STD 58, April 1999. 6053 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 6054 MIB", RFC 2863, June 2000. 6056 [RFC3291] Daniele, M., Haberman, B., Routhier, S., Schoenwaelder, 6057 J., "Textual Conventions for Internet Network Addresses", 6058 RFC 3291, May 2002. 6060 ************************************************************ 6061 * NOTES TO RFC Editor (to be removed prior to publication) * 6062 * * 6063 * The I-D (or a * 6064 * successor) is expected to eventually replace RFC 3291. * 6065 * If that draft (or a successor) is published as an RFC * 6066 * prior to or concurrently with this document, then the * 6067 * normative reference [RFC3291] should be updated to * 6068 * point to the replacement RFC. * 6069 * * 6070 ************************************************************ 6072 [IANA] "Protocol Numbers and Assignment Services", IANA, 6073 http://www.iana.org/assignments/ianaiftype-mib 6075 [EN 300 429] ETSI Standard EN 300 429, Version 1.2.1: Digital Video 6076 Broadcasting (DVB), Framing structure, channel coding 6077 and modulation for cable systems, April 1998. 6079 [ITU-T J.83] ITU-T Recommendation J.83(4/97), "Digital 6080 multi-programme systems for television sound and data 6081 services for cable distribution.", ITU, Apr 1997, 6082 http://www.itu.int/ITU-T/studygroups/com09/ 6084 [RFI1.0] "Data-Over-Cable Service Interface Specifications: DOCSIS 6085 1.0 6086 Radio Frequency Interface (RFI) ANSI/SCTE 22-1 2002", 6087 http://www.scte.org/standards/ 6089 [RFI1.1] "Data-Over-Cable Service Interface Specifications: Cable 6090 Modem Radio Frequency Interface Specification 6091 SP-RFIv1.1-I10-030730", DOCSIS, July 2003, 6092 http://www.cablelabs.com/specifications/archives/ 6094 [RFI2.0] "Data-Over-Cable Service Interface Specifications: Radio 6095 Frequency Interface Specification SP-RFIv2.0-I04-030730", 6096 DOCSIS 2.0, July 2003, 6097 http://www.cablelabs.com/specifications/archives/ 6099 [ITU-T J.112] ITU-T Recommendation J.112(3/98),"Transmission 6100 Systems for Interactive Cable Television Services, 6101 J.112, International Telecommunications Union", 6102 ITU, March 1998, 6103 http://www.itu.int/ITU-T/studygroups/com09/ 6105 8. Informative References 6107 [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, 6108 "Introduction and Applicability Statements for 6109 Internet-Standard Management Framework", RFC 3410, 6110 December 2002. 6112 [OSSI2.0] "Data-Over-Cable Service Interface Specifications: 6113 Operations Support System Interface Specification 6114 SP-OSSIv2.0-I04-030730", DOCSIS 2.0 July 2003, 6115 http://www.cablelabs.com/specifications/archives/ 6117 [OSSI1.1] "Data-Over-Cable Service Interface Specifications: 6118 Operations Support System Interface Specification 6119 SP-OSSIv1.1-I07-030730", DOCSIS 1.1 July 2003, 6120 http://www.cablelabs.com/specifications/archives/ 6122 [BPI] "Data-Over-Cable Service Interface Specifications: DOCSIS 6123 1.0 Baseline Privacy Interface Specification SCTE 22-2 2002", 6124 SCTE Data Standards Subcommittee, 2002, 6125 http://www.scte.org/standards/. 6127 [BPIPLUS] "Data-Over-Cable Service Interface Specifications: 6128 Baseline Privacy Plus Interface Specification 6129 SP-BPI+-I10-030730", CableLabs, July 2003, 6130 http://www.cablelabs.com/specifications/archives/ 6132 [Proakis00] Proakis, John G., "Digital Communications, 4th Edition", 6133 McGraw-Hill, New York, New York, 2000, ISBN 0-07-232111-3 6135 9. Security Considerations 6137 This MIB module relates to a system which will provide metropolitan 6138 public internet access. As such, improper manipulation of the 6139 objects represented by this MIB may result in denial of service to a 6140 large number of end-users. 6142 There are a number of management objects defined in this MIB that 6143 have a MAX-ACCESS clause of read-write or read-create. Such 6144 objects may be considered sensitive or vulnerable in some network 6145 environments. The support for SET operations in a non-secure 6146 environment without proper protection can have a negative effect on 6147 network operations. 6149 In the CM case the only read-write object is docsIfCmRangingTimeout, 6150 which if maliciously SET may not constitute a critical factor of the 6151 service degradation. 6152 The rest of the CM required MIB objects in this MIB module are 6153 read-only by the MIB definitions or by CM compliance statements, the 6154 majority of those MIB objects are controlled by the CMTS. Therefore, 6155 write access to the CMTS MIB objects may compromise the services 6156 offering as defined below. 6158 The CMTS is the controller of most of the parameters of the DOCSIS 6159 RFI Interface, These are the tables and their sensitivity/ 6160 vulnerability: 6162 o Objects in the docsIfBasicGroupv2 if SET maliciously by an 6163 attacker could result in a denial of service either by 6164 service disruption or degradation. Particularly SETs in 6165 objects of tables docsIfDownstreamChannelTable, 6166 docsIfUpstreamChannelTable, docsIfCmtsModulationTable and 6167 docsIfQosProfileTable (the last one in conjunction with 6168 MIB object docsIfCmtsQosProfilePermissions) can alter 6169 negatively the physical and link layers parameters for 6170 upstream and downstream channels. 6172 o The Object docsIfCmtsServiceAdminStatus of the 6173 docsIfCmtsGroupv2 group when SET maliciously by an 6174 attacker to 'destroyed' could interrupt temporarily a cable 6175 modem service by removing its entry in 6176 docsifCmtsServiceTable. 6178 Some of the readable objects in this MIB module (i.e., objects with a 6179 MAX-ACCESS other than not-accessible) may be considered sensitive or 6180 vulnerable in some network environments. It is thus important to 6181 control even GET and/or NOTIFY access to these objects and possibly 6182 to even encrypt the values of these objects when sending them over 6183 the network via SNMP. These are the tables and objects and their 6184 sensitivity/vulnerability: 6186 o Read access to the MIB objects in tables docsIfCmStatusTable 6187 (CM), docsIfSignalQualityTable (CM/CMTS) and mainly CMTS 6188 tables docsIfCmtsCmStatusTable, 6189 docsIfCmtsChannelUtilizationTable, 6190 docsIfCmtsDownChannelCounterTable and 6191 docsIfCmtsUpChannelCounterTable as well as all the tables 6192 described above, could reveal information about the cable 6193 modems distribution among the upstream and downstream 6194 channels and their performance which could be used to gain 6195 access to a different tiered service offer. 6196 The table docsIfCmtsCmStatusTable also contain the MAC and IP 6197 addresses of the cable modems that cam be used of thief of 6198 service and IP spoofing. 6200 SNMP versions prior to SNMPv3 did not include adequate security. 6201 Even if the network itself is secure (for example by using IPSec), 6202 even then, there is no control as to who on the secure network is 6203 allowed to access and GET/SET (read/change/create/delete) the objects 6204 in this MIB module. 6206 It is RECOMMENDED that implementers consider the security features as 6207 provided by the SNMPv3 framework (see [RFC3410], section 8), 6208 including full support for the SNMPv3 cryptographic mechanisms (for 6209 authentication and privacy). 6211 Further, deployment of SNMP versions prior to SNMPv3 is NOT 6212 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 6213 enable cryptographic security. It is then a customer/operator 6214 responsibility to ensure that the SNMP entity giving access to an 6215 instance of this MIB module is properly configured to give access to 6216 the objects only to those principals (users) that have legitimate 6217 rights to indeed GET or SET (change/create/delete) them. 6219 10. Changes from RFC 2670 6221 Upstream now separated into 'physical interfaces' and 'logical 6222 channels'. An instance of the docsIfUpstreamChannelTable exists 6223 for each 'logical channel'. The IANA ifType for 'logical channels' 6224 is 205. The IANA ifType for 'physical interfaces' remains at 129. 6226 Object docsIfDownChannelAnnex added to 6227 docsIfDownstreamChannelTable. This object originated in the 6228 Euro-DOCSIS specifications. 6230 Nine new objects added to the docsIfUpstreamChannelTable. One 6231 describes the channel type in use. Four are specific S-CDMA 6232 parameters. Three are used in the creation of a temporary 6233 inactive upstream row so the channel parameters may be 6234 manipulated 6235 'offline'. One object has been added to enable/disable 6236 pre-equalization on the upstream channel. 6238 Object docsIfQosProfMaxTransmitBurst has been added to the 6239 docsIfQosProfileTable to replace deprecated object 6240 docsIfQosProfMaxTxBurst. This fixes a range error caused by switch 6241 to recording as bytes instead of mini-slots. 6243 Three new 64 bit counters added to the docsIfSignalQualityTable to 6244 extend the capacity of existing 32 bit counters. 6246 A new base object docsIfDocsisBaseCapability has been added which 6247 mirrors the functionality of the DOCSIS specification [OSSI2.0] 6248 defined MIB object docsIfDocsisCapability, extended to include 6249 DOCSIS 2.0. 6251 Five new objects added to the docsIfCmStatusTable. One indicates 6252 the current modulation type. The second mirrors the functionality 6253 of the DOCSIS specification [OSSI2.0] defined MIB object 6254 docsIfDocsisOperMode, while clarifying that it applies to the COS/QOS 6255 mode used by the device. The third new object indicates equalization 6256 data at the CM. Last two objects indicates total and failed UCC 6257 transactions. 6259 Two new 64 bit counters added to the docsIfCmServiceTable to extend 6260 the capacity of existing 32 bit counters. 6262 Nine new objects added to the docsIfCmtsCmStatusTable. Three are 6263 64 bit counters, two add ipv6 capability, one indicates the CM 6264 modulation type in use, one indicates the last update time for the 6265 status value, one is a high resolution of the timing offset MIB 6266 object. 6267 The remaining object mirrors the functionality of the DOCSIS 6268 specification [OSSI2.0] defined MIB object 6269 docsIfCmtsCmStatusDocsisMode, while clarifying that it applies to 6270 the COS/QOS mode used by the device. 6272 One object added to the docsIfCmtsServiceTable to fix a range error 6273 in an existing object, that has been deprecated. 6275 Eight new objects added to the docsIfCmtsModulationTable. Seven of 6276 these describe ATDMA/S-CDMA channel parameters, while the other 6277 describes modulation attributes common to all modulation types. 6279 One new object and three new tables added to provide CMTS upstream 6280 and downstream channel utilization data. 6282 Enumerated values for object docsIfDownChannelInterleave have been 6283 expanded to include a Euro-DOCSIS value. 6285 Enumerated values for object docsIfCmtsModIntervalUsageCode have 6286 been expanded to include new DOCSIS 2.0 values. 6288 Enumerated values for object docsIfCmtsModType have been expanded 6289 to include new DOCSIS 2.0 values. 6291 Compliance statements have been updated to reflect new objects and 6292 to describe Euro-DOCSIS specific implementation features. 6294 The descriptions of objects docsIfCmtsStatusInvalidRegReqs and 6295 docsIfCmtsStatusFailedRegReqs have been clarified. 6297 Separated references into normative and informative. 6299 11. Management Interoperability of DOCSIS 1.0, 1.1 and 2.0 6301 The MIB module contained in this document updates RFC 2670, primarily 6302 to handle the management requirements of the DOCSIS RF Interface of 6303 DOCSIS 2.0 [RFI2.0]. RFC 2670 contains the DOCSIS RF Interface 6304 management requirements for DOCSIS 1.0 and DOCSIS 1.1. 6306 The management requirements of Class of Service (DOCSIS 1.0) pertain 6307 to RFC 2670 are the same as this document update and are contained 6308 in tables docsIfQosProfileTable, docsIfCmServiceTable and 6309 docsIfCmtsServiceTable. 6311 DOCSIS 1.1 and DOCSIS 2.0 Quality of Service management requirements 6312 are defined in the DOCSIS management specifications [DOCSIS1.1] and 6313 [DOCSIS2.0] respectively. 6315 12. Intellectual Property 6316 The IETF takes no position regarding the validity or scope of any 6317 intellectual property or other rights that might be claimed to 6318 pertain to the implementation or use of the technology described in 6319 this document or the extent to which any license under such rights 6320 might or might not be available; neither does it represent that it 6321 has made any effort to identify any such rights. Information on the 6322 IETF's procedures with respect to rights in standards-track and 6323 standards-related documentation can be found in BCP-11. Copies of 6324 claims of rights made available for publication and any assurances 6325 of licenses to be made available, or the result of an attempt made 6326 to obtain a general license or permission for the use of such 6327 proprietary rights by implementers or users of this specification 6328 can be obtained from the IETF Secretariat. 6330 The IETF invites any interested party to bring to its attention any 6331 copyrights, patents or patent applications, or other proprietary 6332 rights that may cover technology that may be required to practice 6333 this standard. Please address the information to the IETF Executive 6334 Director. 6336 13. Author's Address 6338 David Raftus 6339 Terayon Canada Ltd 6340 340 Terry Fox Drive, Suite 202 6341 Ottawa Ontario 6342 Canada 6343 Phone: +1 613 592 1052 ext 222 6344 E-mail: david.raftus@terayon.com 6346 Eduardo Cardona 6347 Cable Television Laboratories, Inc. 6348 400 Centennial Parkway 6349 Louisville, CO 80027-1266 6350 U.S.A. 6351 Phone: +1 303 661 9100 6352 E-mail: e.cardona@cablelabs.com 6354 14. Full Copyright Statement 6356 Copyright (C) The Internet Society (2003). All Rights Reserved. 6358 This document and translations of it may be copied and furnished to 6359 others, and derivative works that comment on or otherwise explain it 6360 or assist in its implementation may be prepared, copied, published 6361 and distributed, in whole or in part, without restriction of any 6362 kind, provided that the above copyright notice and this paragraph 6363 are included on all such copies and derivative works. However, this 6364 document itself may not be modified in any way, such as by removing 6365 the copyright notice or references to the Internet Society or other 6366 Internet organizations, except as needed for the purpose of 6367 developing Internet standards in which case the procedures for 6368 copyrights defined in the Internet Standards process must be 6369 followed, or as required to translate it into languages other than 6370 English. 6372 The limited permissions granted above are perpetual and will not be 6373 revoked by the Internet Society or its successors or assigns. 6375 This document and the information contained herein is provided on an 6376 "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 6377 TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 6378 BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 6379 HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 6380 MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 6382 Funding for the RFC Editor function is currently provided by the 6383 Internet Society.