idnits 2.17.1 draft-ietf-ipcdn-docs-rfmibv2-04.txt: 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: ---------------------------------------------------------------------------- == No 'Intended status' indicated for this document; assuming Proposed Standard == The page length should not exceed 58 lines per page, but there was 2 longer pages, the longest (page 21) being 64 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack a Security Considerations section. (A line matching the expected section header was found, but with an unexpected indentation: ' 8. Security Considerations' ) ** 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.) ** The document seems to lack an Authors' Addresses Section. ** There are 655 instances of too long lines in the document, the longest one being 152 characters in excess of 72. ** There are 10 instances of lines with control characters in the document. ** The abstract seems to contain references ([5], [6], [7]), which it shouldn't. Please replace those with straight textual mentions of the documents in question. == There are 4 instances of lines with non-RFC6890-compliant IPv4 addresses in the document. If these are example addresses, they should be changed. ** The document seems to lack a both a reference to RFC 2119 and the recommended RFC 2119 boilerplate, even if it appears to use RFC 2119 keywords. RFC 2119 keyword, line 144: '...ng translated MIB MUST be semantically...' RFC 2119 keyword, line 347: '... The ifStackTable [17] MUST be implemented to identify relationships among...' RFC 2119 keyword, line 1525: '...alues from 64..128 MUST be non-prime."...' RFC 2119 keyword, line 1725: '... MUST NOT be changed w...' RFC 2119 keyword, line 1739: '... MUST NOT be changed w...' (11 more instances...) Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the RFC 3978 Section 5.4 Copyright Line does not match the current year == Line 495 has weird spacing: '...astPkts inter...' == Line 554 has weird spacing: '...astPkts inte...' == Line 662 has weird spacing: '...astPkts upst...' == Line 762 has weird spacing: '...astPkts inter...' == Line 830 has weird spacing: '...astPkts inte...' == (2 more instances...) -- 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 (April 2002) is 8046 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 section? '5' on line 4093 looks like a reference -- Missing reference section? '6' on line 4097 looks like a reference -- Missing reference section? '7' on line 4100 looks like a reference -- Missing reference section? '1' on line 4080 looks like a reference -- Missing reference section? '2' on line 4083 looks like a reference -- Missing reference section? '3' on line 4087 looks like a reference -- Missing reference section? '4' on line 4090 looks like a reference -- Missing reference section? '8' on line 4103 looks like a reference -- Missing reference section? '9' on line 4106 looks like a reference -- Missing reference section? '10' on line 4110 looks like a reference -- Missing reference section? '11' on line 4114 looks like a reference -- Missing reference section? '12' on line 4207 looks like a reference -- Missing reference section? '13' on line 4122 looks like a reference -- Missing reference section? '14' on line 4126 looks like a reference -- Missing reference section? '15' on line 4208 looks like a reference -- Missing reference section? '21' on line 4151 looks like a reference -- Missing reference section? '25' on line 4166 looks like a reference -- Missing reference section? '20' on line 4147 looks like a reference -- Missing reference section? '19' on line 4144 looks like a reference -- Missing reference section? '17' on line 4137 looks like a reference -- Missing reference section? '28' on line 4178 looks like a reference -- Missing reference section? '26' on line 4170 looks like a reference -- Missing reference section? '22' on line 4155 looks like a reference -- Missing reference section? '16' on line 4133 looks like a reference -- Missing reference section? '18' on line 4140 looks like a reference -- Missing reference section? '23' on line 4159 looks like a reference -- Missing reference section? '24' on line 4163 looks like a reference -- Missing reference section? '27' on line 4174 looks like a reference Summary: 8 errors (**), 0 flaws (~~), 10 warnings (==), 30 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Internet Draft Aviv Goren/David Raftus 3 draft-ietf-ipcdn-docs-rfmibv2-04.txt Terayon/Imedia 4 Expires: October 2002 April 2002 5 Obsoletes: RFC2670 7 Radio Frequency (RF) Interface Management Information Base 8 for DOCSIS 2.0 compliant RF interfaces 10 Status of this Memo 12 This document is an Internet-Draft and is in full conformance with 13 all provisions of Section 10 of RFC2026. 15 Internet-Drafts are working documents of the Internet Engineering 16 Task Force (IETF), its areas, and its working groups. Note that 17 other groups may also distribute working documents as Internet- 18 Drafts. 20 Internet-Drafts are draft documents valid for a maximum of six months 21 and may be updated, replaced, or obsoleted by other documents at any 22 time. It is inappropriate to use Internet-Drafts as reference 23 material or to cite them other than as "work in progress." 25 The list of current Internet-Drafts can be accessed at 26 http://www.ietf.org/ietf/1id-abstracts.txt 28 The list of Internet-Draft Shadow Directories can be accessed at 29 http://www.ietf.org/shadow.html. 31 Copyright Notice 33 Copyright (C) The Internet Society (2002). All Rights Reserved. 35 Abstract 37 This memo is a draft revision of the standards track RFC-2670. 38 Please see "Section 9 Changes from RFC2670" for a description of modifications. 39 This document or its successor will obsolete RFC-2670 when accepted. 41 This memo defines a portion of the Management Information Base (MIB) 42 for use with network management protocols in the Internet community. 43 In particular, it defines a basic set of managed objects for SNMP- 44 based management of DOCSIS compliant Radio Frequency (RF) interfaces. 46 This memo specifies a MIB module in a manner that is compliant to the 47 SNMP SMIv2 [5][6][7]. The set of objects are consistent with the 48 SNMP framework and existing SNMP standards. 50 Table of Contents 52 1 The SNMP Management Framework ................................... 3 53 2 Glossary ........................................................ 4 54 2.1 CATV .......................................................... 4 55 2.2 Channel ....................................................... 4 56 2.3 CM ............................................................ 4 57 2.4 CMTS .......................................................... 4 58 2.5 Codeword ...................................................... 4 59 2.6 Data Packet ................................................... 4 60 2.7 dBmV .......................................................... 4 61 2.8 DOCSIS ........................................................ 5 62 2.9 Downstream .................................................... 5 63 2.10 Head-end ..................................................... 5 64 2.11 MAC Packet ................................................... 5 65 2.12 MCNS ......................................................... 5 66 2.13 Mini-slot .................................................... 5 67 2.14 QPSK ......................................................... 5 68 2.15 QAM .......................................................... 5 69 2.16 RF ........................................................... 5 70 2.17 Symbol-times ................................................. 5 71 2.18 Upstream ..................................................... 6 72 3 Overview ........................................................ 6 73 3.1 Structure of the MIB .......................................... 6 74 3.1.1 docsIfBaseObjects ........................................... 6 75 3.1.2 docsIfCmObjects ............................................. 7 76 3.1.3 docsIfCmtsObjects ........................................... 7 77 3.2 Relationship to the Interfaces MIB ............................ 7 78 3.2.1 Layering Model .............................................. 7 79 3.2.2 Virtual Circuits ............................................ 8 80 3.2.3 ifTestTable ................................................. 9 81 3.2.4 ifRcvAddressTable ........................................... 9 82 3.2.5 ifEntry ..................................................... 9 83 3.2.5.1 ifEntry for Downstream interfaces ......................... 9 84 3.2.5.1.1 ifEntry for Downstream interfaces in Cable Modem 85 Termination Systems .......................................... 9 86 3.2.5.1.2 ifEntry for Downstream interfaces in Cable Modems ...... 11 87 3.2.5.2 ifEntry for Upstream interfaces .......................... 12 88 3.2.5.2.1 ifEntry for Upstream interfaces in Cable Modem 89 Termination Systems ......................................... 13 90 3.2.5.2.2 ifEntry for Upstream interfaces in Cable Modems ........ 15 91 3.2.5.3 ifEntry for the MAC Layer ................................ 18 92 4 Definitions .................................................... 20 93 5 Acknowledgments ................................................ 79 94 6 Revision Descriptions ...........................................79 95 7 References ..................................................... 79 96 8 Security Considerations ........................................ 81 97 9 Changes from RFC2670 ........................................... 82 98 10 Conflict Resolution with docsIfExt MIB ........................ 83 99 11 Intellectual Property ..........................................84 100 12 Author's Address .............................................. 84 101 13 Full Copyright Statement ...................................... 85 103 1. The SNMP Management Framework 105 The SNMP Management Framework presently consists of five major 106 components: 108 o An overall architecture, described in RFC 2571 [1]. 110 o Mechanisms for describing and naming objects and events for the 111 purpose of management. The first version of this Structure of 112 Management Information (SMI) is called SMIv1 and described in STD 113 16, RFC 1155 [2], STD 16, RFC 1212 [3] and RFC 1215 [4]. The 114 second version, called SMIv2, is described in STD 58, RFC 2578 115 [5], STD 58, RFC 2579 [6] and STD 58, RFC 2580 [7]. 117 o Message protocols for transferring management information. The 118 first version of the SNMP message protocol is called SNMPv1 and 119 described in RFC 1157 [8]. A second version of the SNMP message 120 protocol, which is not an Internet standards track protocol, is 121 called SNMPv2c and described in RFC 1901 [9] and RFC 1906 [10]. 122 The third version of the message protocol is called SNMPv3 and 123 described in RFC 1906 [10], RFC 2572 [11] and RFC 2574 [12]. 125 o Protocol operations for accessing management information. The 126 first set of protocol operations and associated PDU formats is 127 described in STD 15, RFC 1157 [8]. A second set of protocol 128 operations and associated PDU formats is described in RFC 1905 129 [13]. 131 o A set of fundamental applications described in RFC 2573 [14] and 132 the view-based access control mechanism described in RFC 2575 133 [15]. 135 A more detailed introduction to the current SNMP Management Framework 136 can be found in RFC 2570 [21]. 138 Managed objects are accessed via a virtual information store, termed 139 the Management Information Base or MIB. Objects in the MIB are 140 defined using the mechanisms defined in the SMI. 142 This memo specifies a MIB module that is compliant to the SMIv2. A 143 MIB conforming to the SMIv1 can be produced through the appropriate 144 translations. The resulting translated MIB MUST be semantically 145 equivalent, except where objects or events are omitted because no 146 translation is possible (use of Counter64). Some machine readable 147 information in SMIv2 will be converted into textual descriptions in 148 SMIv1 during the translation process. However, this loss of machine 149 readable information is not considered to change the semantics of the 150 MIB. 152 2. Glossary 154 The terms in this document are derived either from normal cable 155 system usage, or from the documents associated with the Data Over 156 Cable Service Interface Specification process. 158 2.1. CATV 160 Originally "Community Antenna Television", now used to refer to any 161 cable or hybrid fiber and cable system used to deliver video signals 162 to a community. 164 2.2. Channel 166 A specific frequency allocation with an RF medium, specified by 167 channel width in Hertz (cycles per second) and by center frequency. 168 Within the US Cable Systems, upstream channels are generally 169 allocated from the 5-42MHz range while down stream channels are 170 generally allocated from the 50-750MHz range depending on the 171 capabilities of the given system. The typical broadcast channel 172 width in the US is 6MHz. Upstream channel widths for DOCSIS vary. 174 For European cable systems, upstream channels vary by country. The 175 upper edge of upstream channel allocations vary between 25 MHz to 65 176 MHz, and the lower edge of downstream channel allocations vary 177 between 47 MHz and 87.5 MHz. The typical broadcast channel width in 178 Europe is 8MHz. The actual parameters are of concern to systems 179 deploying EuroDOCSIS technology. 181 2.3. CM Cable Modem. 183 A CM acts as a "slave" station in a DOCSIS compliant cable data 184 system. 186 2.4. CMTS Cable Modem Termination System. 188 A generic term covering a cable bridge or cable router in a head-end. 189 A CMTS acts as the master station in a DOCSIS compliant cable data 190 system. It is the only station that transmits downstream, and it 191 controls the scheduling of upstream transmissions by its associated 192 CMs. 194 2.5. Codeword 196 See [25]. A characteristic of the Forward Error Correction scheme used 197 above the RF media layer. 199 2.6. Data Packet 200 The payload portion of the MAC Packet. 202 2.7. dBmV 204 Decibel relative to one milli-volt. A measure of RF power. 206 2.8. DOCSIS 208 "Data Over Cable Service Interface Specification". A term referring to the 209 ITU-T J.112 Annex B standard for cable modem systems [20]. 211 2.9. Downstream 213 The direction from the head-end towards the subscriber. 215 2.10. Head-end 217 The origination point in most cable systems of the subscriber video 218 signals. 220 2.11. MAC Packet 222 A DOCSIS PDU. 224 2.12. MCNS 226 "Multimedia Cable Network System". Generally replaced in usage by 227 DOCSIS. 229 2.13. Mini-slot 231 See [25]. In general, an interval of time which is allocated by the 232 CMTS to a given CM for that CM to transmit in an upstream direction. 234 2.14. QPSK Quadrature Phase Shift Keying. 236 A particular modulation scheme on an RF medium. See [19]. 238 2.15. QAM Quadrature Amplitude Modulation. 240 A particular modulation scheme on RF medium. Usually expressed 241 with a number indicating the size of the modulation constellation 242 (e.g. 16 QAM). See [19], or any other book on digital communications 243 over RF for a complete explanation of this. 245 2.16. RF 247 Radio Frequency. 249 2.17. Symbol-times 251 See [25]. A characteristic of the RF modulation scheme. 253 2.18. Upstream 255 The direction from the subscriber towards the head-end. 257 3. Overview 259 This MIB provides a set of objects required for the management of 260 MCNS/DOCSIS compliant Cable Modem (CM) and Cable Modem Termination 261 System (CMTS) RF interfaces. The specification is derived in part 262 from the parameters and protocols described in DOCSIS Radio Frequency 263 Interface Specification [25]. 265 3.1. Structure of the MIB 267 This MIB is structured as three groups: 269 o Management information pertinent to both Cable Modems (CM) and 270 Cable Modem Termination Systems (CMTS) (docsIfBaseObjects). 272 o Management information pertinent to Cable Modems only 273 (docsIfCmObjects). 275 o Management information pertinent to Cable Modem Termination 276 Systems only (docsIfCmtsObjects). 278 Tables within each of these groups group objects functionally - e.g. 279 Quality of Service, Channel characteristics, MAC layer management, 280 etc. Rows created automatically (e.g. by the device according to the 281 hardware configuration) may and generally will have a mixture of 282 configuration and status objects within them. Rows that are meant to 283 be created by the management station are generally restricted to 284 configuration (read-create) objects. 286 3.1.1. docsIfBaseObjects 288 docsIfDownstreamChannelTable - This table describes the active 289 downstream channels for a CMTS and the received downstream channel 290 for a CM. 292 docsIfUpstreamChannelTable - This table describes the active upstream 293 channels for a CMTS and the current upstream transmission channel 294 for a CM. 296 docsIfQosProfileTable - This table describes the valid Quality of 297 Service profiles for the cable data system. 299 docsIfSignalQualityTable - This table is used to monitor RF signal 300 quality characteristics of received signals. 302 docsIfDocsisBaseCapability - This object is used to indicate the highest level 303 of DOCSIS version a cable device can support. 305 3.1.2. docsIfCmObjects 307 docsIfCmMacTable - This table is used to monitor the DOCSIS MAC 308 interface and can be considered an extension to the ifEntry. 310 docsIfCmServiceTable - This table describes the upstream service 311 queues available at this CM. There is a comparable table at the 312 CMTS, docsIfCmtsServiceEntry, which describes the service queues from 313 the point of view of the CMTS. 315 3.1.3. docsIfCmtsObjects 317 docsIfCmtsStatusTable - This table provides a set of aggregated 318 counters which roll-up values and events that occur on the underlying 319 sub-interfaces. 321 docsIfCmtsCmStatusTable - This table is used to hold information 322 about known (i.e. ranging, registered, and/or previously online) 323 cable modems on the system serviced by this CMTS. 325 docsIfCmtsServiceEntry - This table provides access to the 326 information related to upstream service queues. 328 docsIfCmtsModulationTable - This table allows control over the 329 modulation profiles for RF channels associated with this CMTS. 331 docsIfCmtsMacToCmTable - This table allows fast access into the 332 docsIfCmtsCmTable via a MAC address (of the CM) interface. 334 3.2. Relationship to the Interfaces MIB 336 This section clarifies the relationship of this MIB to the Interfaces 337 MIB [17]. Several areas of correlation are addressed in the 338 following subsections. The implementer is referred to the Interfaces 339 MIB document in order to understand the general intent of these 340 areas. 342 3.2.1. Layering Model 344 An instance of ifEntry exists for each RF Downstream interface, for 345 each RF Upstream interface, for each Upstream logical Channel and for 346 each RF MAC layer. 347 The ifStackTable [17] MUST be implemented to identify relationships among 348 sub-interfaces. 350 The following example illustrates a CMTS MAC interface with one downstream 351 and two upstream interfaces. 353 | <== to network layer 354 +------------------ --+-------------------------------+ 355 | RF MAC | 356 +--+------------------+------------------------+------+ 357 | | | 358 +-------+-----+ +------+------+ +------+------+ 359 | Downstream1 | | Upstream1 | | Upstream2 | 360 | | | | | | 361 +-------------+ ++-----------++ ++-----------++ 362 | | | | 363 +----+----+ +----+----+ +----+----+ +----+----+ 364 | Ch-1 | | Ch-2 | | Ch-1 | | Ch-2 | 365 |(A/TDMA) | |(S-CDMA) | |(A/TDMA) | |(S-CDMA) | 366 +---------+ +---------+ +---------+ +---------+ 368 As can be seen from this example, the RF MAC interface is layered on 369 top of the downstream and upstream interfaces, and the RF Upstream interface 370 is layered on top of an Upstream Logical Channels. 372 In this example, the assignment of index values could be as follows: 374 ifIndex ifType Description 376 2 docsCableMaclayer(127) CATV MAC Layer 377 3 docsCableDownstream(128) CATV Downstream interface 378 4 docsCableUpstream(129) CATV Upstream interface 379 5 docsCableUpstream(129) CATV Upstream interface 380 6 docsCableUpstreamChannel(205) CATV Upstream Channel 381 7 docsCableUpstreamChannel(205) CATV Upstream Channel 382 8 docsCableUpstreamChannel(205) CATV Upstream Channel 383 9 docsCableUpstreamChannel(205) CATV Upstream Channel 385 The corresponding ifStack entries would then be: 387 | IfStackHigherLayer | ifStackLowerLayer | 388 | 0 | 2 | 389 | 2 | 3 | 390 | 2 | 4 | 391 | 2 | 5 | 392 | 4 | 6 | 393 | 4 | 7 | 394 | 5 | 8 | 395 | 5 | 9 | 396 | 3 | 0 | 397 | 6 | 0 | 398 | 7 | 0 | 399 | 8 | 0 | 400 | 9 | 0 | 402 The same interface model can also be used in Telephony or Telco 403 Return systems. A pure Telco Return system (Cable Modem as well as 404 Cable Modem Termination System) would not have upstream, but only 405 downstream cable channels. Systems supporting both Telco Return and 406 cable upstream channels can use the above model without modification. 408 Telco Return Upstream channel(s) are handled by the appropriate MIBs, 409 such as PPP or Modem MIBs. 411 3.2.2. Virtual Circuits 413 This medium does not support virtual circuits and this area is not 414 applicable to this MIB. 416 3.2.3. ifTestTable 418 The ifTestTable is optional for Docsis CM/CMTS implementations, but is 419 not specifically influenced by the RF mib. 421 3.2.4. ifRcvAddressTable 423 The ifRcvAddressTable is optional for Docsis CM/CMTS implementations, but is 424 not specifically influenced by the RF mib. 426 3.2.5. ifEntry 428 This section documents only the differences from the requirements 429 specified in the Interfaces MIB. See that MIB for columns omitted 430 from the descriptions below. 432 3.2.5.1. ifEntry for Downstream interfaces 434 The ifEntry for Downstream interfaces supports the 435 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 436 MIB. This is an output only interface at the CMTS and all input 437 status counters - ifIn* - will return zero. This is an input only 438 interface at the CM and all output status counters - ifOut* - will 439 return zero. 441 3.2.5.1.1. ifEntry for Downstream interfaces in Cable Modem Termination 442 Systems 444 ifTable Comments 445 ============== =========================================== 446 ifIndex Each RF Cable Downstream interface is represented 447 by an ifEntry. 449 ifType The IANA value of docsCableDownstream(128). 451 ifSpeed Return the speed of this downstream channel. 452 The returned value is the raw bandwidth in bits/s 453 of this interface. This is the symbol rate 454 multiplied with the number of bits per symbol. 456 ifHighSpeed Return the speed of this downstream channel. 457 The returned value is the raw bandwidth in megabits/s 458 of this interface. This is the symbol rate 459 multiplied with the number of bits per symbol. 461 ifPhysAddress Return an empty string. 463 ifAdminStatus The administrative status of this interface. 465 ifOperStatus The current operational status of this interface. 467 ifMtu The size of the largest frame which can be 468 sent on this interface, specified in octets. 469 The value includes the length of the MAC header. 471 ifInOctets Return zero. 472 ifHCInOctets 474 ifInUcastPkts Return zero. 475 ifHCInUcastPkts 477 ifInMulticastPkts Return zero. 478 ifHCInMulticastPkts 480 ifInBroadcastPkts Return zero. 481 ifHCInBroadcastPkts 483 ifInDiscards Return zero. 485 ifInErrors Return zero. 487 ifInUnknownProtos Return zero. 489 ifOutOctets The total number of octets transmitted on this 490 ifHCOutOctets interface. This includes MAC packets as well as 491 data packets, and includes the length of the MAC 492 header. 494 ifOutUcastPkts The number of Unicast packets transmitted on this 495 ifHCOutUcastPkts interface. This includes MAC packets as well as 496 data packets. 498 ifOutMulticastPkts 499 ifHCOutMulticastPkts 500 Return the number of Multicast packets transmitted 501 on this interface. 502 This includes MAC packets as well as data packets. 504 ifOutBroadcastPkts 505 ifHCOutBroadcastPkts 506 Return the number of broadcast packets transmitted 507 on this interface. 508 This includes MAC packets as well as data packets. 510 ifOutDiscards The total number of outbound packets which 511 were discarded. Possible reasons are: 512 buffer shortage. 514 ifOutErrors The number of packets which could not be 515 transmitted due to errors. 517 ifPromiscuousMode Return false. 519 3.2.5.1.2. ifEntry for Downstream interfaces in Cable Modems 521 ifTable Comments 522 ============== =========================================== 523 ifIndex Each RF Cable Downstream interface is represented 524 by an ifEntry. 526 ifType The IANA value of docsCableDownstream(128). 528 ifSpeed Return the speed of this downstream channel. 529 The returned value the raw bandwidth in bits/s 530 of this interface. This is the symbol rate 531 multiplied with the number of bits per symbol. 533 ifHighSpeed Return the speed of this downstream channel. 534 The returned value the raw bandwidth in megabits/s 535 of this interface. This is the symbol rate 536 multiplied with the number of bits per symbol. 538 ifPhysAddress Return an empty string. 540 ifAdminStatus The administrative status of this interface. 542 ifOperStatus The current operational status of this interface. 544 ifMtu The size of the largest frame which can be 545 received from this interface, specified in octets. 546 The value includes the length of the MAC header. 548 ifInOctets The total number of octets received on this 549 ifHCInOctets interface. This includes data packets as well as 550 MAC layer packets, and includes the length of the 551 MAC header. 553 ifInUcastPkts The number of Unicast packets received on this 554 ifHCInUcastPkts interface. This includes data packets as well as 555 MAC layer packets. 557 ifInMulticastPkts 558 ifHCInMulticastPkts 559 Return the number of Multicast packets received 560 on this interface. This includes data packets as 561 well as MAC layer packets. 563 ifInBroadcastPkts 564 ifHCInBroadcastPkts 565 Return the number of Broadcast packets received 566 on this interface. This includes data packets 567 as well as MAC layer packets. 569 ifInDiscards The total number of received packets that have 570 been discarded. 571 The possible reasons are: buffer shortage. 573 ifInErrors The number of inbound packets that contained 574 errors preventing them from being deliverable 575 to higher layers. 576 Possible reasons are: MAC FCS error. 578 ifInUnknownProtos The number of frames with an unknown packet type. 579 These are MAC frames with an unknown packet type. 581 ifOutOctets Return zero. 582 ifHCOutOctets 584 ifOutUcastPkts Return zero. 585 ifHCOutUcastPkts 587 ifOutMulticastPkts 588 ifHCOutMulticastPkts 589 Return zero. 591 ifOutBroadcastPkts 592 ifHCOutBroadcastPkts 593 Return zero. 595 ifOutDiscards Return zero. 597 ifOutErrors Return zero. 599 ifPromiscuousMode Refer to the Interfaces MIB. 601 3.2.5.2. ifEntry for Upstream interfaces 603 Each supported interface of the type docsCableUpstream(129) must have a 604 corresponding ifEntry. 605 The ifEntry for Upstream interfaces supports the 606 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 607 MIB. This is an input only interface at the CMTS and all output 608 status counters - ifOut* - will return zero. This is an output only 609 interface at the CM and all input status counters - ifIn* - will 610 return zero. 612 3.2.5.2.1. ifEntry for Upstream interfaces in Cable Modem Termination 613 Systems 615 ifTable Comments 616 ============== =========================================== 617 ifIndex Each RF Cable Upstream interface is represented 618 by an ifEntry. 620 ifType The IANA value of docsCableUpstream (129). 622 ifSpeed Return the maximum channel throughput (not payload 623 throughput) supported by the interface. 624 The maximum throughput is calculated for the case where 625 upstream channels are configured to maximize interface 626 throughput. 628 ifHighSpeed Return the maximum channel throughput (not payload 629 throughput) supported by the interface. 630 The maximum throughput is calculated for the case where 631 upstream channels are configured to maximize interface 632 throughput. Units for this object are (1/1 000 000) * 633 IfSpeed. 635 ifPhysAddress Return an empty string. 637 ifAdminStatus The administrative status of this interface. 638 This reflect the total status of all the channels 639 under this interface. So if at least one channel has a 640 physical connection this interface has connection. 641 Any SNMP SET on this interface will cause a SET to all the 642 channels under this interface. 644 ifOperStatus The current operational status of this interface. 645 This reflects the total status of all the channels 646 under this interface. So if at least one channel has a 647 physical connection this interface has connection. 649 ifMtu The size of the largest frame which can be 650 transmitted on this interface, specified in octets. 651 The value includes the length of the MAC header. 652 This is the maximum of all the ifMtu of all the channels 653 under this interface. 655 ifInOctets The total (sum) number of octets received on all 656 ifHCInOctets the Upstream channels under this 657 interface. This includes data packets as well as 658 MAC layer packets, and includes the length of the 659 MAC header. 661 ifInUcastPkts The total number of Unicast packets received on all the 662 ifHCInUcastPkts upstream channels under this 663 interface. This includes data packets as well as 664 MAC layer packets. 666 ifInMulticastPkts 667 ifHCInMulticastPkts 668 Return the total number of Multicast packets received 669 on all the Upstream channels under this interface. 670 This includes data packets as 671 well as MAC layer packets. 673 ifInBroadcastPkts 674 ifHCInBroadcastPkts 675 Return the total number of Broadcast packets received 676 on all the Upstream channels under this interface. 677 This includes data packets 678 as well as MAC layer packets. 680 ifInDiscards The total number of received packets, which have 681 been discarded on all the Upstream channels under this 682 interface. 683 The possible reasons are: buffer shortage. 685 ifInErrors The total number of inbound packets that contained 686 errors preventing them from being deliverable 687 to higher layers. 688 Possible reasons are: MAC FCS error. 690 ifInUnknownProtos The total number of frames with an unknown packet type. 691 These are MAC frames with an unknown packet type. 693 ifOutOctets Return zero. 694 ifHCOutOctets 696 ifOutUcastPkts Return zero. 697 ifHCOutOctets 699 ifOutMulticastPkts 700 ifHCOutMulticastPkts 701 Return zero. 703 ifOutBroadcastPkts 704 ifHCOutBroadcastPkts 705 Return zero. 707 ifOutDiscards Return zero. 709 ifOutErrors Return zero. 711 3.2.5.2.2. ifEntry for Upstream interfaces in Cable Modems 713 ifTable Comments 714 ============== =========================================== 715 ifIndex Each RF Cable Upstream interface is represented 716 by an ifEntry. 718 ifType The IANA value of docsCableUpstream (129). 720 ifSpeed Return the speed of this upstream interface. 721 The returned value is the raw bandwidth 722 in bits/s of this interface. 724 ifHighSpeed Return the speed of this upstream interface. 725 The returned value is the raw bandwidth 726 in megabits/s of this interface. 728 ifPhysAddress Return an empty string. 730 ifAdminStatus The administrative status of this interface. 732 ifOperStatus The current operational status of this interface. 734 ifMtu The size of the largest frame which can be 735 transmitted on this interface, specified in octets. 736 The value includes the length of the MAC header. 738 ifInOctets Return zero. 739 ifHCInOctets 741 ifInUcastPkts Return zero. 742 ifHCInUcastPkts 743 \ 744 ifInMulticastPkts Return zero. 745 ifHCInMulticastPkts 747 ifInBroadcastPkts Return zero. 748 ifHCInBroadcastPkts 750 ifInDiscards Return zero. 752 ifInErrors Return zero. 754 ifInUnknownProtos Return zero. 756 ifOutOctets The total number of octets transmitted on this 757 ifHCOutOctets interface. This includes MAC packets as well as 758 data packets, and includes the length of the MAC 759 header. 761 ifOutUcastPkts The number of Unicast packets transmitted on this 762 ifHCOutUcastPkts interface. This includes MAC packets as well as 763 data packets. 765 ifOutMulticastPkts 766 ifHCOutMulticastPkts 767 Return the number of Multicast packets transmitted 768 on this interface. 769 This includes MAC packets as well as data packets. 771 ifOutBroadcastPkts 772 ifHCOutBroadcastPkts 773 Return the number of broadcast packets transmitted 774 on this interface. 775 This includes MAC packets as well as data packets. 777 ifOutDiscards The total number of outbound packets which 778 were discarded. Possible reasons are: 779 buffer shortage. 781 ifOutErrors The number of packets which could not be 782 transmitted due to errors. 784 ifPromiscuousMode Return false. 786 3.2.5.3. ifEntry for Upstream channels 788 Each supported channel of the type docsCableUpstreamChannel(205) must have a 789 corresponding ifEntry. 790 The ifEntry for Upstream channels supports the 791 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces 792 MIB. This is an input only interface at the CMTS and all output 793 status counters - ifOut* - will return zero. At the time of this mib creation, 794 DOCSIS CMs are not required to support logical upstream channels. 796 3.2.5.3.1. ifEntry for Upstream Channels in Cable Modem Termination 797 Systems 799 ifTable Comments 800 ============== =========================================== 801 ifIndex Each RF Cable Upstream channel is represented 802 by an ifEntry. 804 ifType The IANA value of docsCableUpstreamChannel (205). 806 ifSpeed Return the speed of this upstream channel. 807 The returned value is the raw bandwidth 808 in bits/s of this channel. 810 ifHighSpeed Return the speed of this upstream channel. 811 The returned value is the raw bandwidth 812 in megabits/s of this channel. 814 ifPhysAddress Return an empty string. 816 ifAdminStatus The administrative status of this interface. 818 ifOperStatus The current operational status of this interface. 820 ifMtu The size of the largest frame which can be 821 received on this interface, specified in octets. 822 The value includes the length of the MAC header. 824 ifInOctets The total number of octets received on this 825 interface. This includes data packets as well as 826 MAC layer packets, and includes the length of the 827 MAC header. 829 ifInUcastPkts The number of Unicast packets received on this 830 ifHCInUcastPkts interface. This includes data packets as well as 831 MAC layer packets. 833 ifInMulticastPkts 834 ifHCInMulticastPkts 835 Return the number of Multicast packets received 836 on this interface. This includes data packets as 837 well as MAC layer packets. 839 ifInBroadcastPkts 840 ifHCInBroadcastPkts 841 Return the number of Broadcast packets received 842 on this interface. This includes data packets 843 as well as MAC layer packets. 845 ifInDiscards The total number of received packets that have 846 been discarded. 847 The possible reasons are: buffer shortage. 849 ifInErrors The number of inbound packets that contained 850 errors preventing them from being deliverable 851 to higher layers. 852 Possible reasons are: MAC FCS error. 854 ifInUnknownProtos The number of frames with an unknown packet type. 855 These are MAC frames with an unknown packet type. 857 ifOutOctets Return zero. 858 ifHCOutOctets 859 ifOutUcastPkts Return zero. 860 ifHCOutUcastPkts 862 ifOutMulticastPkts 863 ifHCOutMulticastPkts 864 Return zero. 866 ifOutBroadcastPkts 867 ifHCOutBroadcastPkts 868 Return zero. 870 ifOutDiscards Return zero. 872 ifOutErrors Return zero. 874 3.2.5.4. ifEntry for the MAC Layer 876 The ifEntry for the MAC Layer supports the ifGeneralInformationGroup 877 and the ifPacketGroup of the Interfaces MIB. This interface provides 878 an aggregate view of status for the lower level Downstream and 879 Upstream interfaces. 881 ifTable Comments 882 ============== =========================================== 883 ifIndex Each RF Cable MAC layer entity is represented 884 by an ifEntry. 886 ifType The IANA value of docsCableMaclayer(127). 888 ifSpeed Return zero. 890 ifPhysAddress Return the physical address of this interface. 892 ifAdminStatus The administrative status of this interface. 894 ifOperStatus The current operational status of the MAC 895 layer interface. 897 ifHighSpeed Return zero. 899 ifMtu Return 1500. 901 ifInOctets The total number of data octets received on this 902 ifHCInOctets interface, targeted for upper protocol layers. 904 ifInUcastPkts The number of Unicast packets received on this 905 ifHCInUcastPkts interface, targeted for upper protocol layers. 907 ifInMulticastPkts 908 ifHCInMulticastPkts 909 Return the number of Multicast packets received 910 on this interface, targeted for upper protocol 911 layers. 913 ifInBroadcastPkts 914 ifHCInBroadcastPkts 915 Return the number of Broadcast packets received 916 on this interface, targeted for upper protocol 917 layers. 919 ifInDiscards The total number of received packets that have 920 been discarded. 921 The possible reasons are: buffer shortage. 923 ifInErrors The number of inbound packets that contained 924 errors preventing them from being deliverable 925 to higher layers. 926 Possible reasons are: data packet FCS error, 927 invalid MAC header. 929 ifInUnknownProtos The number of frames with an unknown packet type. 930 This is the number of data packets targeted for 931 upper protocol layers with an unknown packet type. 933 ifOutOctets The total number of octets, received from upper 934 ifHCOutOctets protocol layers and transmitted on this interface. 936 ifOutUcastPkts The number of Unicast packets, received from upper 937 ifHCOutUcastPkts protocol layers and transmitted on this interface. 939 ifOutMulticastPkts 940 ifHCOutMulticastPkts 941 Return the number of Multicast packets received 942 from upper protocol layers and transmitted on this 943 interface. 945 ifOutBroadcastPkts 946 ifHCOutBroadcastPkts 947 Return the number of broadcast packets received 948 from upper protocol layers and transmitted on this 949 interface. 951 ifOutDiscards The total number of outbound packets which 952 were discarded. Possible reasons are: 953 buffer shortage. 955 ifOutErrors The number of packets which could not be 956 transmitted due to errors. 958 ifPromiscuousMode Refer to the Interfaces MIB. 960 4. Definitions 962 DOCS-IF-MIB DEFINITIONS ::= BEGIN 964 IMPORTS 965 MODULE-IDENTITY, 966 OBJECT-TYPE, 967 -- do not import BITS, 968 Unsigned32, 969 Integer32, 970 Counter32, 971 Counter64, 972 TimeTicks, 973 IpAddress, 974 transmission 975 FROM SNMPv2-SMI 976 TEXTUAL-CONVENTION, 977 MacAddress, 978 RowStatus, 979 TruthValue, 980 TimeInterval, 981 TimeStamp 982 FROM SNMPv2-TC 983 OBJECT-GROUP, 985 MODULE-COMPLIANCE 986 FROM SNMPv2-CONF 987 ifIndex, InterfaceIndexOrZero 988 FROM IF-MIB 989 InetAddressType, 990 InetAddress 991 FROM INET-ADDRESS-MIB; 993 docsIfMib MODULE-IDENTITY 994 LAST-UPDATED "0204260000Z" -- April 26, 2002 995 ORGANIZATION "IETF IPCDN Working Group" 996 CONTACT-INFO 997 " Aviv Goren 998 Postal: Terayon 999 2952 Bunker Hill Lane 1000 Santa Clara, CA 1001 U.S.A. 1002 Phone: +1 408 727 4400 1003 E-mail: aviv.goren@terayon.com 1005 David Raftus 1006 Postal: Imedia Semiconductor 1007 340 Terry Fox Drive, Suite 202 1008 Ottawa Ontario 1009 Canada 1010 Phone: +1 613 592 1052 1011 E-mail: david.raftus@imedia.com 1013 IETF IPCDN Working Group 1014 General Discussion: ipcdn@ietf.org 1015 Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn 1016 Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn 1017 Co-chairs: Richard Woundy, rwoundy@cisco.com 1018 Andrew Valentine, a.valentine@eu.hns.com" 1019 DESCRIPTION 1020 "This is the MIB Module for DOCSIS 2.0 compliant Radio 1021 Frequency (RF) interfaces in Cable Modems (CM) and 1022 Cable Modem Termination Systems (CMTS)." 1023 REVISION "0204260000Z" 1024 DESCRIPTION 1025 "Modified by David Raftus to fix docsIfUpChannelWidth range 1026 in compliance statements to accommodate 6.4Mhz channel at 1027 5.12 Msymbol/sec. Also adjusted description of 1028 docsIfUpChannelStatus to use correct rowStatus terminology." 1029 REVISION "0203170000Z" 1030 DESCRIPTION 1031 "Modified by David Raftus to add new textual convention 1032 describing upstream modulation status. Also clarified 1033 some object descriptions, fixed error in 1034 docsIfSignalQualityEntry, fixed upstreamTable compliance 1035 statements." 1036 REVISION "0202070000Z" 1037 DESCRIPTION 1038 "Modified by David Raftus to add capability to adjust 1039 and verify upstream channel parameters as a group. 1040 Also adjusted syntax and clarified descriptions of 1041 selected objects. " 1042 REVISION "0111200000Z" 1043 DESCRIPTION 1044 "Modified by Aviv Goren and David Raftus to accommodate 1045 Docsis 2.0 Advanced Phy capabilities, as well as to 1046 incorporate objects from the docsIfExt mib. " 1047 REVISION "0102230000Z" 1048 DESCRIPTION 1049 "Modified by Rich Woundy to use IPv6-friendly 1050 address objects, to accommodate EuroDOCSIS, and 1051 to correct the SYNTAX of various objects." 1052 REVISION "9908190000Z" 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." 1060 ::= { transmission 127 } 1062 -- Textual Conventions 1064 TenthdBmV ::= TEXTUAL-CONVENTION 1065 DISPLAY-HINT "d-1" 1066 STATUS current 1067 DESCRIPTION 1068 "This data type represents power levels that are normally 1069 expressed in dBmV. Units are in tenths of a dBmV; 1070 for example, 5.1 dBmV will be represented as 51." 1071 SYNTAX Integer32 1073 TenthdB ::= TEXTUAL-CONVENTION 1074 DISPLAY-HINT "d-1" 1075 STATUS current 1076 DESCRIPTION 1077 "This data type represents power levels that are normally 1078 expressed in dB. Units are in tenths of a dB; 1079 for example, 5.1 dB will be represented as 51." 1080 SYNTAX Integer32 1082 DocsisVersion ::= TEXTUAL-CONVENTION 1083 STATUS current 1084 DESCRIPTION "Indicates the DOCSIS version number." 1085 SYNTAX INTEGER { 1086 docsis10 (1), 1087 docsis11 (2), 1088 docsis20 (3) 1089 } 1091 DocsisQosVersion ::= TEXTUAL-CONVENTION 1092 STATUS current 1093 DESCRIPTION "Indicates the quality of service level." 1094 SYNTAX INTEGER { 1095 docsis10 (1), 1096 docsis11 (2) 1097 } 1099 DocsisUpstreamType ::= TEXTUAL-CONVENTION 1100 STATUS current 1101 DESCRIPTION "Indicates the DOCSIS Upstream Channel Type." 1102 SYNTAX INTEGER { 1103 tdma (1), 1104 atdma (2), 1105 scdma (3), 1106 tdmaAndAtdma (4) 1107 } 1109 DocsisUpstreamTypeStatus ::= TEXTUAL-CONVENTION 1110 STATUS current 1111 DESCRIPTION "Indicates the DOCSIS Upstream Channel Type Status. 1112 The shared channel indicator type is not valid, since 1113 this type is used to specifically identify PHY mode." 1114 SYNTAX INTEGER { 1115 tdma (1), 1116 atdma (2), 1117 scdma (3) 1118 } 1120 docsIfMibObjects OBJECT IDENTIFIER ::= { docsIfMib 1 } 1121 docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 } 1122 docsIfCmObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 2 } 1123 docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 } 1125 -- 1126 -- BASE GROUP 1127 -- 1129 -- 1130 -- The following table is implemented on both the Cable Modem (CM) 1131 -- and the Cable Modem Termination System (CMTS). This table is 1132 -- read only for the CM. 1133 -- 1135 docsIfDownstreamChannelTable OBJECT-TYPE 1136 SYNTAX SEQUENCE OF DocsIfDownstreamChannelEntry 1137 MAX-ACCESS not-accessible 1138 STATUS current 1139 DESCRIPTION 1140 "This table describes the attributes of downstream 1141 channels (frequency bands)." 1142 REFERENCE 1143 "Document [25] from References, Table 6-12 and Table 6-13." 1144 ::= { docsIfBaseObjects 1 } 1146 docsIfDownstreamChannelEntry OBJECT-TYPE 1147 SYNTAX DocsIfDownstreamChannelEntry 1148 MAX-ACCESS not-accessible 1149 STATUS current 1150 DESCRIPTION 1151 "An entry provides a list of attributes for a single 1152 Downstream channel. 1153 An entry in this table exists for each ifEntry with an 1154 ifType of docsCableDownstream(128)." 1155 INDEX { ifIndex } 1156 ::= { docsIfDownstreamChannelTable 1 } 1158 DocsIfDownstreamChannelEntry ::= SEQUENCE { 1159 docsIfDownChannelId Integer32, 1160 docsIfDownChannelFrequency Integer32, 1161 docsIfDownChannelWidth Integer32, 1162 docsIfDownChannelModulation INTEGER, 1163 docsIfDownChannelInterleave INTEGER, 1164 docsIfDownChannelPower TenthdBmV, 1165 docsIfDownChannelAnnex INTEGER 1166 } 1168 docsIfDownChannelId OBJECT-TYPE 1169 SYNTAX Integer32 (0..255) 1170 MAX-ACCESS read-only 1171 STATUS current 1172 DESCRIPTION 1173 "The Cable Modem Termination System (CMTS) identification 1174 of the downstream channel within this particular MAC 1175 interface. If the interface is down, the object returns 1176 the most current value. If the downstream channel ID is 1177 unknown, this object returns a value of 0." 1178 ::= { docsIfDownstreamChannelEntry 1 } 1180 docsIfDownChannelFrequency OBJECT-TYPE 1181 SYNTAX Integer32 (0..1000000000) 1182 UNITS "hertz" 1183 MAX-ACCESS read-write 1184 STATUS current 1185 DESCRIPTION 1186 "The center of the downstream frequency associated with 1187 this channel. This object will return the current tuner 1188 frequency. If a CMTS provides IF output, this object 1189 will return 0, unless this CMTS is in control of the 1190 final downstream RF frequency. See the associated 1191 compliance object for a description of valid frequencies 1192 that may be written to this object." 1193 REFERENCE 1194 "Document [25] from References, Tables 4-1, 6-14." 1195 ::= { docsIfDownstreamChannelEntry 2 } 1197 docsIfDownChannelWidth OBJECT-TYPE 1198 SYNTAX Integer32 (0..16000000) 1199 UNITS "hertz" 1200 MAX-ACCESS read-write 1201 STATUS current 1202 DESCRIPTION 1203 "The bandwidth of this downstream channel. Most 1204 implementations are expected to support a channel width 1205 of 6 MHz (North America) and/or 8 MHz (Europe). See the 1206 associated compliance object for a description of the 1207 valid channel widths for this object." 1208 REFERENCE 1209 "Document [25] from References, Table 6-14." 1210 ::= { docsIfDownstreamChannelEntry 3 } 1212 docsIfDownChannelModulation OBJECT-TYPE 1213 SYNTAX INTEGER { 1214 unknown(1), 1215 other(2), 1216 qam64(3), 1217 qam256(4) 1218 } 1219 MAX-ACCESS read-write 1220 STATUS current 1221 DESCRIPTION 1222 "The modulation type associated with this downstream 1223 channel. If the interface is down, this object either 1224 returns the configured value (CMTS), the most current 1225 value (CM), or the value of unknown(1). See the 1226 associated conformance object for write conditions and 1227 limitations. See the reference for specifics on the 1228 modulation profiles implied by qam64 and qam256." 1229 REFERENCE 1230 "Document [25] from References, Table 6-14." 1231 ::= { docsIfDownstreamChannelEntry 4 } 1233 docsIfDownChannelInterleave OBJECT-TYPE 1234 SYNTAX INTEGER { 1235 unknown(1), 1236 other(2), 1237 taps8Increment16(3), 1238 taps16Increment8(4), 1239 taps32Increment4(5), 1240 taps64Increment2(6), 1241 taps128Increment1(7), 1242 taps12increment17(8) 1243 } 1244 MAX-ACCESS read-write 1245 STATUS current 1246 DESCRIPTION 1247 "The Forward Error Correction (FEC) interleaving used 1248 for this downstream channel. 1249 Values are defined as follows: 1250 taps8Increment16(3): protection 5.9/4.1 usec, 1251 latency .22/.15 msec 1252 taps16Increment8(4): protection 12/8.2 usec, 1253 latency .48/.33 msec 1254 taps32Increment4(5): protection 24/16 usec, 1255 latency .98/.68 msec 1256 taps64Increment2(6): protection 47/33 usec, 1257 latency 2/1.4 msec 1258 taps128Increment1(7): protection 95/66 usec, 1259 latency 4/2.8 msec 1260 taps12increment17(8): protection 18/14 usec, 1261 latency 0.43/0.32 msec 1262 taps12increment17 is implemented in 1263 conformance with EuroDOCSIS document 1264 'Adapted MIB-definitions - and a 1265 clarification for MPEG-related issues - for 1266 EuroDOCSIS cable modem systems' by tComLabs 1267 and should only be used for a EuroDOCSIS MAC 1268 interface. 1270 If the interface is down, this object either returns 1271 the configured value (CMTS), the most current value (CM), 1272 or the value of unknown(1). 1273 The value of other(2) is returned if the interleave 1274 is known but not defined in the above list. 1275 See the associated conformance object for write 1276 conditions and limitations. See the reference for the FEC 1277 configuration described by the setting of this object." 1278 REFERENCE 1279 "Document [25] from References, Table 6-13." 1280 ::= { docsIfDownstreamChannelEntry 5 } 1282 docsIfDownChannelPower OBJECT-TYPE 1283 SYNTAX TenthdBmV 1284 UNITS "dBmV" 1285 MAX-ACCESS read-write 1286 STATUS current 1287 DESCRIPTION 1288 "At the CMTS, the operational transmit power. At the CM, 1289 the received power level. May be set to zero at the CM 1290 if power level measurement is not supported. 1291 If the interface is down, this object either returns 1292 the configured value (CMTS), the most current value (CM) 1293 or the value of 0. See the associated conformance object 1294 for write conditions and limitations. See the reference 1295 for recommended and required power levels." 1296 REFERENCE 1297 "Document [25] from References,Table 6-15." 1298 ::= { docsIfDownstreamChannelEntry 6 } 1300 docsIfDownChannelAnnex OBJECT-TYPE 1301 SYNTAX INTEGER { 1302 unknown(1), 1303 other(2), 1304 annexA(3), 1305 annexB(4), 1306 annexC(5) 1307 } 1308 MAX-ACCESS read-only 1309 STATUS current 1310 DESCRIPTION 1311 "The value of this object indicates the conformance of 1312 the implementation to important regional cable standards. 1313 annexA : Annex A from ITU-J83 is used. 1314 annexB : Annex B from ITU-J83 is used. 1315 annexC : Annex C from ITU-J83 is used. 1316 AnnexB is used for DOCSIS implementations" 1317 REFERENCE 1318 "Document [28] from References, Section 2.2" 1319 ::= { docsIfDownstreamChannelEntry 7 } 1321 -- 1322 -- The following table is implemented on both the CM and the CMTS. 1324 -- For the CM, only attached channels appear in the table. For the 1325 -- CM, this table is read only as well. 1326 -- 1328 docsIfUpstreamChannelTable OBJECT-TYPE 1329 SYNTAX SEQUENCE OF DocsIfUpstreamChannelEntry 1330 MAX-ACCESS not-accessible 1331 STATUS current 1332 DESCRIPTION 1333 "This table describes the attributes of attached upstream 1334 channels." 1335 ::= { docsIfBaseObjects 2 } 1337 docsIfUpstreamChannelEntry OBJECT-TYPE 1338 SYNTAX DocsIfUpstreamChannelEntry 1339 MAX-ACCESS not-accessible 1340 STATUS current 1341 DESCRIPTION 1342 "List of attributes for a single upstream channel. For 1343 Docsis 2.0 CMTSs, an entry in this table exists for 1344 each ifEntry with an ifType of docsCableUpstreamChannel (205). 1345 For Docsis 1.x CM/CMTSs and Docsis 2.0 CMs, an entry in this table exists 1346 for each ifEntry with an ifType of docsCableUpstreamInterface (129)." 1347 INDEX { ifIndex } 1348 ::= { docsIfUpstreamChannelTable 1 } 1350 DocsIfUpstreamChannelEntry ::= SEQUENCE { 1351 docsIfUpChannelId Integer32, 1352 docsIfUpChannelFrequency Integer32, 1353 docsIfUpChannelWidth Integer32, 1354 docsIfUpChannelModulationProfile Unsigned32, 1355 docsIfUpChannelSlotSize Unsigned32, 1356 docsIfUpChannelTxTimingOffset Unsigned32, 1357 docsIfUpChannelRangingBackoffStart Integer32, 1358 docsIfUpChannelRangingBackoffEnd Integer32, 1359 docsIfUpChannelTxBackoffStart Integer32, 1360 docsIfUpChannelTxBackoffEnd Integer32, 1361 docsIfUpChannelScdmaActiveCodes Unsigned32, 1362 docsIfUpChannelScdmaCodesPerSlot Integer32, 1363 docsIfUpChannelScdmaFrameSize Unsigned32, 1364 docsIfUpChannelScdmaHoppingSeed Unsigned32, 1365 docsIfUpChannelType DocsisUpstreamType, 1366 docsIfUpChannelCloneFrom InterfaceIndexOrZero, 1367 docsIfUpChannelUpdate TruthValue, 1368 docsIfUpChannelStatus RowStatus 1369 } 1371 docsIfUpChannelId OBJECT-TYPE 1372 SYNTAX Integer32 (0..255) 1373 MAX-ACCESS read-only 1374 STATUS current 1375 DESCRIPTION 1376 "The CMTS identification of the upstream channel." 1377 ::= { docsIfUpstreamChannelEntry 1 } 1379 docsIfUpChannelFrequency OBJECT-TYPE 1380 SYNTAX Integer32 (0..1000000000) 1381 UNITS "hertz" 1382 MAX-ACCESS read-create 1383 STATUS current 1384 DESCRIPTION 1385 "The center of the frequency band associated with this 1386 upstream interface. This object returns 0 if the frequency 1387 is undefined or unknown. Minimum permitted upstream 1388 frequency is 5,000,000 Hz for current technology. See 1389 the associated conformance object for write conditions 1390 and limitations." 1391 REFERENCE 1392 "Document [25] from References, Table 4-2." 1393 ::= { docsIfUpstreamChannelEntry 2 } 1395 docsIfUpChannelWidth OBJECT-TYPE 1396 SYNTAX Integer32 (0..64000000) 1397 UNITS "hertz" 1398 MAX-ACCESS read-create 1399 STATUS current 1400 DESCRIPTION 1401 "The bandwidth of this upstream interface. This object 1402 returns 0 if the interface width is undefined or unknown. 1403 Minimum permitted interface width is 200,000 Hz currently. 1404 See the associated conformance object for write conditions 1405 and limitations." 1406 REFERENCE 1407 "Document [25] from References, Table 6-12." 1408 ::= { docsIfUpstreamChannelEntry 3 } 1410 docsIfUpChannelModulationProfile OBJECT-TYPE 1411 SYNTAX Unsigned32 1412 MAX-ACCESS read-create 1413 STATUS current 1414 DESCRIPTION 1415 "An entry identical to the docsIfModIndex in the 1416 docsIfCmtsModulationTable that describes this channel. 1417 This channel is further instantiated there by a grouping 1418 of interval usage codes which together fully describe the 1419 channel modulation. This object returns 0 if the 1420 docsIfCmtsModulationTable entry does not exist or 1421 docsIfCmtsModulationTable is empty. See 1422 the associated conformance object for write conditions 1423 and limitations." 1424 REFERENCE 1425 "Document [25] from References, Table 8-19." 1426 ::= { docsIfUpstreamChannelEntry 4 } 1428 docsIfUpChannelSlotSize OBJECT-TYPE 1429 SYNTAX Unsigned32 1430 MAX-ACCESS read-create 1431 STATUS current 1432 DESCRIPTION 1433 "Applicable to TDMA and ATDMA channel types only. 1434 The number of 6.25 microsecond ticks in each upstream mini- 1435 slot. Returns zero if the value is undefined, unknown or in 1436 case of an SCDMA channel. 1437 See the associated conformance object for write 1438 conditions and limitations. " 1439 REFERENCE 1440 "Document [25] from References, Section 8.1.2.4." 1441 ::= { docsIfUpstreamChannelEntry 5 } 1443 docsIfUpChannelTxTimingOffset OBJECT-TYPE 1444 SYNTAX Unsigned32 1445 MAX-ACCESS read-only 1446 STATUS current 1447 DESCRIPTION 1448 "At the CM, a measure of the current round trip time obtained from the 1449 ranging offset (initial ranging offset + ranging offset adjustments). 1450 At the CMTS, the maximum of timing offset, among all the CMs that 1451 are/were present on the channel, taking into account all ( initial + 1452 periodic )timing offset corrections that were sent for each of the CMs. 1453 Generally, these measurements are positive, but if the 1454 measurements are negative, the value of this object is zero. Used for 1455 timing of CM upstream transmissions to ensure synchronized arrivals at 1456 the CMTS. Units are in terms of (6.25 microseconds/64)." 1457 REFERENCE 1458 "Document [25] from References, Section 6.2.18." 1459 ::= { docsIfUpstreamChannelEntry 6 } 1461 docsIfUpChannelRangingBackoffStart OBJECT-TYPE 1462 SYNTAX Integer32 (0..16) 1463 MAX-ACCESS read-create 1464 STATUS current 1465 DESCRIPTION 1466 "The initial random backoff window to use when retrying 1467 Ranging Requests. Expressed as a power of 2. A value of 16 1468 at the CMTS indicates that a proprietary adaptive retry 1469 mechanism is to be used. See the associated conformance 1470 object for write conditions and limitations." 1471 REFERENCE 1472 "Document [25] from References, Section 8.3.4." 1473 ::= { docsIfUpstreamChannelEntry 7 } 1475 docsIfUpChannelRangingBackoffEnd OBJECT-TYPE 1476 SYNTAX Integer32 (0..16) 1477 MAX-ACCESS read-create 1478 STATUS current 1479 DESCRIPTION 1480 "The final random backoff window to use when retrying 1481 Ranging Requests. Expressed as a power of 2. A value of 16 1482 at the CMTS indicates that a proprietary adaptive retry 1483 mechanism is to be used. See the associated conformance 1484 object for write conditions and limitations." 1485 REFERENCE 1486 "Document [25] from References, Section 8.3.4." 1487 ::= { docsIfUpstreamChannelEntry 8 } 1489 docsIfUpChannelTxBackoffStart OBJECT-TYPE 1490 SYNTAX Integer32 (0..16) 1491 MAX-ACCESS read-create 1492 STATUS current 1493 DESCRIPTION 1494 "The initial random backoff window to use when retrying 1495 transmissions. Expressed as a power of 2. A value of 16 1496 at the CMTS indicates that a proprietary adaptive retry 1497 mechanism is to be used. See the associated conformance 1498 object for write conditions and limitations." 1499 REFERENCE 1500 "Document [25] from References, Section 8.3.4." 1501 ::= { docsIfUpstreamChannelEntry 9 } 1503 docsIfUpChannelTxBackoffEnd OBJECT-TYPE 1504 SYNTAX Integer32 (0..16) 1505 MAX-ACCESS read-create 1506 STATUS current 1507 DESCRIPTION 1508 "The final random backoff window to use when retrying 1509 transmissions. Expressed as a power of 2. A value of 16 1510 at the CMTS indicates that a proprietary adaptive retry 1511 mechanism is to be used. See the associated conformance 1512 object for write conditions and limitations." 1513 REFERENCE 1514 "Document [25] from References, Section 8.3.4." 1515 ::= { docsIfUpstreamChannelEntry 10 } 1517 docsIfUpChannelScdmaActiveCodes OBJECT-TYPE 1518 SYNTAX Unsigned32 (0 | 64..128) 1519 MAX-ACCESS read-create 1520 STATUS current 1521 DESCRIPTION 1522 "Applicable for SCDMA channel types only. 1523 Number of active codes. Returns zero for 1524 Non-SCDMA channel types. Note that legal 1525 values from 64..128 MUST be non-prime." 1526 REFERENCE 1527 "Document [25] from References, Section 6.2.11.2.1." 1528 ::= { docsIfUpstreamChannelEntry 11 } 1530 docsIfUpChannelScdmaCodesPerSlot OBJECT-TYPE 1531 SYNTAX Integer32(0 | 2..32) 1532 MAX-ACCESS read-create 1533 STATUS current 1534 DESCRIPTION 1535 "Applicable for SCDMA channel types only. 1536 The number of SCDMA codes per mini-slot. 1537 Returns zero if the value is undefined, unknown or in 1538 case of a TDMA or ATDMA channel." 1539 REFERENCE 1540 "Document [25] from References, Section 6.2.11.2.1." 1541 ::= { docsIfUpstreamChannelEntry 12 } 1543 docsIfUpChannelScdmaFrameSize OBJECT-TYPE 1544 SYNTAX Unsigned32 (0..32) 1545 MAX-ACCESS read-create 1546 STATUS current 1547 DESCRIPTION 1548 "Applicable for SCDMA channel types only. 1549 SCDMA Frame size in units of spreading intervals. 1550 This value returns zero for non SCDMA Profiles." 1551 REFERENCE 1552 " Document [25] from References, Section 6.2.12." 1553 ::= { docsIfUpstreamChannelEntry 13 } 1555 docsIfUpChannelScdmaHoppingSeed OBJECT-TYPE 1556 SYNTAX Unsigned32 (0..32767) 1557 MAX-ACCESS read-create 1558 STATUS current 1559 DESCRIPTION 1560 "Applicable for SCDMA channel types only. 1561 15 bit seed used for code hopping sequence initialization. 1562 Returns zero for non-SCDMA channel types." 1563 REFERENCE 1564 "Document [25] from References, Section 6.2.14.1." 1565 ::= { docsIfUpstreamChannelEntry 14 } 1567 docsIfUpChannelType OBJECT-TYPE 1568 SYNTAX DocsisUpstreamType 1569 MAX-ACCESS read-create 1570 STATUS current 1571 DESCRIPTION 1572 "Defines the Upstream channel type. 1573 Given the channel type, other channel attributes can be checked 1574 for value validity at the time of entry creation and update." 1575 REFERENCE 1576 "Document [25] from References, Section 6.2.1." 1577 ::= { docsIfUpstreamChannelEntry 15 } 1579 docsIfUpChannelCloneFrom OBJECT-TYPE 1580 SYNTAX InterfaceIndexOrZero 1581 MAX-ACCESS read-create 1582 STATUS current 1583 DESCRIPTION 1584 "Intended for use when a temporary inactive upstream table row is 1585 created for the purpose of manipulating SCDMA parameters for an 1586 active row. Refer to the descriptions of docsIfUpChannelStatus 1587 and docsIfUpChannelUpdate for details of this procedure. 1588 This object contains the ifIndex value of the active upstream 1589 row whose SCDMA parameters are to be adjusted. 1590 Although this object was created to facilitate SCDMA parameter 1591 adjustment, it may also be used at the vendor's discretion for 1592 non-SCDMA parameter adjustment. 1593 This object must contain a value of zero for active upstream rows." 1594 ::= { docsIfUpstreamChannelEntry 16 } 1596 docsIfUpChannelUpdate OBJECT-TYPE 1597 SYNTAX TruthValue 1598 MAX-ACCESS read-create 1599 STATUS current 1600 DESCRIPTION 1601 "Used to perform the transfer of adjusted SCDMA parameters from the 1602 temporary upstream row to the active upstream row indicated by the 1603 docsIfUpChannelCloneFrom object. The transfer is initiated through 1604 an SNMP SET of TRUE to this object. The SNMP SET will fail with a 1605 GEN_ERROR (snmpv1) or COMMIT_FAILED_ERROR (snmpv2c/v3) if the adjusted 1606 SCDMA parameter values are not compatible with each other. 1607 Although this object was created to facilitate SCDMA parameter 1608 adjustment, it may also be used at the vendor's discretion for 1609 non-SCDMA parameter adjustment. 1610 An SNMP GET of this object always returns FALSE." 1611 ::= { docsIfUpstreamChannelEntry 17 } 1613 docsIfUpChannelStatus OBJECT-TYPE 1614 SYNTAX RowStatus 1615 MAX-ACCESS read-create 1616 STATUS current 1617 DESCRIPTION 1618 "This object is generally intended to be used for the creation of 1619 a temporary inactive upstream row for the purpose of adjusting 1620 the SCDMA channel parameters of an active upstream row. 1621 The recommended procedure is: 1622 1) Create an inactive row through an SNMP SET using createAndWait(5). 1623 Use an ifIndex value outside the operational range of the system. 1624 2) Set the docsIfUpChannelCloneFrom field to the ifIndex value of 1625 the active row whose SCDMA parameters require adjustment. 1626 3) Adjust the SCDMA parameter values using the new temporary inactive 1627 row. 1628 4) Update the active row by setting object docsIfUpChannelUpdate to 1629 TRUE. This SET will fail if the adjusted SCDMA parameters are not 1630 compatible with each other. 1631 5) Delete the temporary row through an SNMP SET using DELETE. 1633 The following restrictions apply to this object: 1634 1) This object must contain a value of active(1) for active rows. 1635 2) Temporary inactive rows must be created using createAndWait(5). 1636 3) The only possible status change of a row created using 1637 createAndWait(5) (ie notInService(2)) is to destroy(6). 1638 These temporary rows must never become active. 1639 Although this object was created to facilitate SCDMA parameter 1640 adjustment, it may also be used at the vendor's discretion for 1641 non-SCDMA parameter adjustment." 1643 -- The following table describes the attributes of each class of 1644 -- service. The entries in this table are referenced from the 1645 -- docsIfServiceEntries. They exist as a separate table in order to 1646 -- reduce redundant information in docsIfServiceTable. 1647 -- 1648 -- This table is implemented at both the CM and the CMTS. 1649 -- The CM need only maintain entries for the classes of service 1650 -- referenced by its docsIfServiceTable. 1651 -- 1653 docsIfQosProfileTable OBJECT-TYPE 1654 SYNTAX SEQUENCE OF DocsIfQosProfileEntry 1655 MAX-ACCESS not-accessible 1656 STATUS current 1657 DESCRIPTION 1658 "Describes the attributes for each class of service." 1659 ::= { docsIfBaseObjects 3 } 1661 docsIfQosProfileEntry OBJECT-TYPE 1662 SYNTAX DocsIfQosProfileEntry 1663 MAX-ACCESS not-accessible 1664 STATUS current 1665 DESCRIPTION 1666 "Describes the attributes for a single class of service. 1668 If implemented as read-create in the Cable Modem 1669 Termination System, creation of entries in this table is 1670 controlled by the value of docsIfCmtsQosProfilePermissions. 1672 If implemented as read-only, entries are created based 1673 on information in REG-REQ MAC messages received from 1674 Cable Modems (Cable Modem Termination System 1675 implementation), or based on information extracted from 1676 the TFTP option file (Cable Modem implementation). 1677 In the Cable Modem Termination system, read-only entries 1678 are removed if no longer referenced by 1679 docsIfCmtsServiceTable. 1681 An entry in this table must not be removed while it is 1682 referenced by an entry in docsIfCmServiceTable (Cable Modem) 1683 or docsIfCmtsServiceTable (Cable Modem Termination System). 1685 An entry in this table should not be changeable while 1686 it is referenced by an entry in docsIfCmtsServiceTable. 1688 If this table is created automatically, there should only 1689 be a single entry for each Class of Service. Multiple 1690 entries with the same Class of Service parameters are not 1691 recommended." 1692 INDEX { docsIfQosProfIndex } 1693 ::= { docsIfQosProfileTable 1 } 1695 DocsIfQosProfileEntry ::= SEQUENCE { 1696 docsIfQosProfIndex Integer32, 1697 docsIfQosProfPriority Integer32, 1698 docsIfQosProfMaxUpBandwidth Integer32, 1699 docsIfQosProfGuarUpBandwidth Integer32, 1700 docsIfQosProfMaxDownBandwidth Integer32, 1701 docsIfQosProfMaxTxBurst Integer32, -- Deprecated 1702 docsIfQosProfBaselinePrivacy TruthValue, 1703 docsIfQosProfStatus RowStatus, 1704 docsIfQosProfMaxTransmitBurst Integer32 1705 } 1707 docsIfQosProfIndex OBJECT-TYPE 1708 SYNTAX Integer32 (1..16383) 1709 MAX-ACCESS not-accessible 1710 STATUS current 1711 DESCRIPTION 1712 "The index value that uniquely identifies an entry 1713 in the docsIfQosProfileTable." 1714 ::= { docsIfQosProfileEntry 1 } 1716 docsIfQosProfPriority OBJECT-TYPE 1717 SYNTAX Integer32 (0..7) 1718 MAX-ACCESS read-create 1719 STATUS current 1720 DESCRIPTION 1721 "A relative priority assigned to this service when 1722 allocating bandwidth. Zero indicates lowest priority 1723 and seven indicates highest priority. 1724 Interpretation of priority is device-specific. 1725 MUST NOT be changed while this row is active." 1726 REFERENCE 1727 "Document [25] from References, Appendix C.1.1.4." 1728 DEFVAL { 0 } 1729 ::= { docsIfQosProfileEntry 2 } 1731 docsIfQosProfMaxUpBandwidth OBJECT-TYPE 1732 SYNTAX Integer32 (0..100000000) 1733 MAX-ACCESS read-create 1734 STATUS current 1735 DESCRIPTION 1736 "The maximum upstream bandwidth, in bits per second, 1737 allowed for a service with this service class. 1738 Zero if there is no restriction of upstream bandwidth. 1739 MUST NOT be changed while this row is active." 1740 REFERENCE 1741 "Document [25] from References, Appendix C.1.1.4." 1743 DEFVAL { 0 } 1744 ::= { docsIfQosProfileEntry 3 } 1746 docsIfQosProfGuarUpBandwidth OBJECT-TYPE 1747 SYNTAX Integer32 (0..100000000) 1748 MAX-ACCESS read-create 1749 STATUS current 1750 DESCRIPTION 1751 "Minimum guaranteed upstream bandwidth, in bits per second, 1752 allowed for a service with this service class. 1753 MUST NOT be changed while this row is active." 1754 REFERENCE 1755 "Document [25] from References, Appendix C.1.1.4." 1756 DEFVAL { 0 } 1757 ::= { docsIfQosProfileEntry 4 } 1759 docsIfQosProfMaxDownBandwidth OBJECT-TYPE 1760 SYNTAX Integer32 (0..100000000) 1761 MAX-ACCESS read-create 1762 STATUS current 1763 DESCRIPTION 1764 "The maximum downstream bandwidth, in bits per second, 1765 allowed for a service with this service class. 1766 Zero if there is no restriction of downstream bandwidth. 1767 MUST NOT be changed while this row is active." 1768 REFERENCE 1769 "Document [25] from References, Appendix C.1.1.4." 1771 DEFVAL { 0 } 1772 ::= { docsIfQosProfileEntry 5 } 1774 docsIfQosProfMaxTxBurst OBJECT-TYPE 1775 SYNTAX Integer32 (0..255) 1776 MAX-ACCESS read-create 1777 STATUS deprecated 1778 DESCRIPTION 1779 "The maximum number of mini-slots that may be requested 1780 for a single upstream transmission. 1781 A value of zero means there is no limit. 1782 MUST NOT be changed while this row is active. 1783 This object has been deprecated and replaced by 1784 docsIfQosProfMaxTransmitBurst, to fix a mismatch 1785 of the units and value range with respect to the DOCSIS 1786 Maximum Upstream Channel Transmit Burst Configuration 1787 Setting." 1788 REFERENCE 1789 "Document [25] from References, C.1.1.4." 1790 DEFVAL { 0 } 1791 ::= { docsIfQosProfileEntry 6 } 1793 docsIfQosProfBaselinePrivacy OBJECT-TYPE 1794 SYNTAX TruthValue 1795 MAX-ACCESS read-create 1796 STATUS current 1797 DESCRIPTION 1798 "Indicates whether Baseline Privacy is enabled for this 1799 service class. 1800 MUST NOT be changed while this row is active." 1801 DEFVAL { false } 1802 ::= { docsIfQosProfileEntry 7 } 1804 docsIfQosProfStatus OBJECT-TYPE 1805 SYNTAX RowStatus 1806 MAX-ACCESS read-create 1807 STATUS current 1808 DESCRIPTION 1809 "This is object is to used to create or delete rows in 1810 this table. This object MUST NOT be changed from active 1811 while the row is referenced by the any entry in either 1812 docsIfCmServiceTable (on the CM), or the 1813 docsIfCmtsServiceTable (on the CMTS)." 1814 ::= { docsIfQosProfileEntry 8 } 1816 docsIfQosProfMaxTransmitBurst OBJECT-TYPE 1817 SYNTAX Integer32 (0..1522) 1818 MAX-ACCESS read-create 1819 STATUS current 1820 DESCRIPTION 1821 "The maximum number of bytes that may be requested for a 1822 single upstream transmission. A value of zero means there 1823 is no limit. Note: This value does not include any 1824 physical layer overhead. 1825 MUST NOT be changed while this row is active." 1826 REFERENCE 1827 "Document [25] from References, Appendix C.1.1.4." 1828 DEFVAL { 0 } 1829 ::= { docsIfQosProfileEntry 9 } 1831 docsIfSignalQualityTable OBJECT-TYPE 1832 SYNTAX SEQUENCE OF DocsIfSignalQualityEntry 1833 MAX-ACCESS not-accessible 1834 STATUS current 1835 DESCRIPTION 1836 "At the CM, describes the PHY signal quality of downstream 1837 channels. At the CMTS, describes the PHY signal quality of 1838 upstream channels. At the CMTS, this table may exclude 1839 contention intervals." 1840 ::= { docsIfBaseObjects 4 } 1842 docsIfSignalQualityEntry OBJECT-TYPE 1843 SYNTAX DocsIfSignalQualityEntry 1844 MAX-ACCESS not-accessible 1845 STATUS current 1846 DESCRIPTION 1847 "At the CM, describes the PHY characteristics of a 1848 downstream channel. At the CMTS, describes the PHY signal 1849 quality of an upstream channel. 1850 An entry in this table exists for each ifEntry with an 1851 ifType of docsCableUpstreamChannel(205) for Cable Modem Termination 1852 Systems and docsCableDownstream(128) for Cable Modems." 1853 INDEX { ifIndex } 1854 ::= { docsIfSignalQualityTable 1 } 1856 DocsIfSignalQualityEntry ::= SEQUENCE { 1857 docsIfSigQIncludesContention TruthValue, 1858 docsIfSigQUnerroreds Counter32, 1859 docsIfSigQCorrecteds Counter32, 1860 docsIfSigQUncorrectables Counter32, 1861 docsIfSigQSignalNoise TenthdB, 1862 docsIfSigQMicroreflections Integer32, 1863 docsIfSigQEqualizationData OCTET STRING 1864 } 1866 docsIfSigQIncludesContention OBJECT-TYPE 1867 SYNTAX TruthValue 1868 MAX-ACCESS read-only 1869 STATUS current 1870 DESCRIPTION 1871 "true(1) if this CMTS includes contention intervals in 1872 the counters in this table. Always false(2) for CMs." 1873 REFERENCE 1874 "Document [25] from References, 1875 Section 9.4.1" 1876 ::= { docsIfSignalQualityEntry 1 } 1878 docsIfSigQUnerroreds OBJECT-TYPE 1879 SYNTAX Counter32 1880 MAX-ACCESS read-only 1881 STATUS current 1882 DESCRIPTION 1883 "Codewords received on this channel without error. 1884 This includes all codewords, whether or not they 1885 were part of frames destined for this device." 1886 REFERENCE 1887 "Document [25] from References, Section 6.2.5." 1888 ::= { docsIfSignalQualityEntry 2 } 1890 docsIfSigQCorrecteds OBJECT-TYPE 1891 SYNTAX Counter32 1892 MAX-ACCESS read-only 1893 STATUS current 1894 DESCRIPTION 1895 "Codewords received on this channel with correctable 1896 errors. This includes all codewords, whether or not 1897 they were part of frames destined for this device." 1898 REFERENCE 1899 "Document [25] from References, Section 6.2.5." 1900 ::= { docsIfSignalQualityEntry 3 } 1902 docsIfSigQUncorrectables OBJECT-TYPE 1903 SYNTAX Counter32 1904 MAX-ACCESS read-only 1905 STATUS current 1906 DESCRIPTION 1907 "Codewords received on this channel with uncorrectable 1908 errors. This includes all codewords, whether or not 1909 they were part of frames destined for this device." 1910 REFERENCE 1911 "Document [25] from References, Section 6.2.5." 1912 ::= { docsIfSignalQualityEntry 4 } 1914 docsIfSigQSignalNoise OBJECT-TYPE 1915 SYNTAX TenthdB 1916 UNITS "dB" 1917 MAX-ACCESS read-only 1918 STATUS current 1919 DESCRIPTION 1920 "Signal/Noise ratio as perceived for this channel. 1921 At the CM, describes the Signal/Noise of the downstream 1922 channel. At the CMTS, describes the average Signal/Noise 1923 of the upstream channel." 1924 REFERENCE 1925 "Document [25] from References, Tables 4-1 and 4-2" 1926 ::= { docsIfSignalQualityEntry 5 } 1928 docsIfSigQMicroreflections OBJECT-TYPE 1929 SYNTAX Integer32 (0..255) 1930 UNITS "dBc" 1931 MAX-ACCESS read-only 1932 STATUS current 1933 DESCRIPTION 1934 "Total microreflections including in-channel response 1935 as perceived on this interface, measured in dBc below 1936 the signal level. 1937 This object is not assumed to return an absolutely 1938 accurate value, but should give a rough indication 1939 of microreflections received on this interface. 1940 It is up to the implementer to provide information 1941 as accurate as possible." 1942 REFERENCE 1943 "Document [25] from References, Tables 4-1 and 4-2" 1944 ::= { docsIfSignalQualityEntry 6 } 1946 docsIfSigQEqualizationData OBJECT-TYPE 1947 SYNTAX OCTET STRING 1948 MAX-ACCESS read-only 1949 STATUS current 1950 DESCRIPTION 1951 "At the CM, returns the equalization data for the downstream 1952 channel. At the CMTS, returns the average equalization 1953 data for the upstream channel. Returns an empty string 1954 if the value is unknown or if there is no equalization 1955 data available or defined." 1956 REFERENCE 1957 "Document [25] from References, Table 8-21." 1958 ::= { docsIfSignalQualityEntry 7 } 1960 -- 1961 -- DOCSIS Version of the device 1962 -- 1964 docsIfDocsisBaseCapability OBJECT-TYPE 1965 SYNTAX DocsisVersion 1966 MAX-ACCESS read-only 1967 STATUS current 1968 DESCRIPTION 1969 "Indication of the DOCSIS capability of the device. 1970 This object mirrors docsIfDocsisCapability from the 1971 DocsIfExt mib." 1972 REFERENCE 1973 "Document [25] from References, Annex G." 1974 ::= { docsIfBaseObjects 5 } 1976 -- 1977 -- CABLE MODEM GROUP 1978 -- 1980 -- ####### 1982 -- 1983 -- The CM MAC Table 1984 -- 1986 docsIfCmMacTable OBJECT-TYPE 1987 SYNTAX SEQUENCE OF DocsIfCmMacEntry 1988 MAX-ACCESS not-accessible 1989 STATUS current 1990 DESCRIPTION 1991 "Describes the attributes of each CM MAC interface, 1992 extending the information available from ifEntry." 1993 ::= { docsIfCmObjects 1 } 1995 docsIfCmMacEntry OBJECT-TYPE 1996 SYNTAX DocsIfCmMacEntry 1997 MAX-ACCESS not-accessible 1998 STATUS current 1999 DESCRIPTION 2000 "An entry containing objects describing attributes of 2001 each MAC entry, extending the information in ifEntry. 2002 An entry in this table exists for each ifEntry with an 2003 ifType of docsCableMaclayer(127)." 2004 INDEX { ifIndex } 2005 ::= { docsIfCmMacTable 1 } 2007 DocsIfCmMacEntry ::= SEQUENCE { 2008 docsIfCmCmtsAddress MacAddress, 2009 docsIfCmCapabilities BITS, 2010 docsIfCmRangingRespTimeout TimeTicks, 2011 docsIfCmRangingTimeout TimeInterval 2012 } 2014 docsIfCmCmtsAddress OBJECT-TYPE 2015 SYNTAX MacAddress 2016 MAX-ACCESS read-only 2017 STATUS current 2018 DESCRIPTION 2019 "Identifies the CMTS that is believed to control this MAC 2020 domain. At the CM, this will be the source address from 2021 SYNC, MAP, and other MAC-layer messages. If the CMTS is 2022 unknown, returns 00-00-00-00-00-00." 2023 REFERENCE 2024 "Document [25] from References, Section 8.2.2." 2025 ::= { docsIfCmMacEntry 1 } 2027 docsIfCmCapabilities OBJECT-TYPE 2028 SYNTAX BITS { 2029 atmCells(0), 2030 concatenation(1) 2031 } 2032 MAX-ACCESS read-only 2033 STATUS current 2034 DESCRIPTION 2035 "Identifies the capabilities of the MAC implementation 2036 at this interface. Note that packet transmission is 2037 always supported. Therefore, there is no specific bit 2038 required to explicitly indicate this capability. 2039 Note that BITS objects are encoded most significant bit 2040 first. For example, if bit 1 is set, the value of this 2041 object is the octet string '40'H." 2042 ::= { docsIfCmMacEntry 2 } 2044 -- This object has been obsoleted and replaced by 2045 -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New 2046 -- implementations of the MIB should use docsIfCmRangingTimeout instead. 2048 docsIfCmRangingRespTimeout OBJECT-TYPE 2049 SYNTAX TimeTicks 2050 MAX-ACCESS read-write 2051 STATUS obsolete 2052 DESCRIPTION 2053 "Waiting time for a Ranging Response packet." 2054 REFERENCE 2055 "Document [25] from References, Section 9.1.6." 2056 DEFVAL { 20 } 2057 ::= { docsIfCmMacEntry 3 } 2059 docsIfCmRangingTimeout OBJECT-TYPE 2060 SYNTAX TimeInterval 2061 MAX-ACCESS read-write 2062 STATUS current 2063 DESCRIPTION 2064 "Waiting time for a Ranging Response packet." 2065 REFERENCE 2066 "Document [25] from References, 2067 Section 9.1.6, timer T3." 2068 DEFVAL { 20 } 2069 ::= { docsIfCmMacEntry 4 } 2071 -- 2072 -- CM status table. 2073 -- This table is implemented only at the CM. 2074 -- 2076 docsIfCmStatusTable OBJECT-TYPE 2077 SYNTAX SEQUENCE OF DocsIfCmStatusEntry 2078 MAX-ACCESS not-accessible 2079 STATUS current 2080 DESCRIPTION 2081 "This table maintains a number of status objects 2082 and counters for Cable Modems." 2083 ::= { docsIfCmObjects 2 } 2085 docsIfCmStatusEntry OBJECT-TYPE 2086 SYNTAX DocsIfCmStatusEntry 2087 MAX-ACCESS not-accessible 2088 STATUS current 2089 DESCRIPTION 2090 "A set of status objects and counters for a single MAC 2091 layer instance in a Cable Modem. 2092 An entry in this table exists for each ifEntry with an 2093 ifType of docsCableMaclayer(127)." 2094 INDEX { ifIndex } 2095 ::= { docsIfCmStatusTable 1 } 2097 DocsIfCmStatusEntry ::= SEQUENCE { 2098 docsIfCmStatusValue INTEGER, 2099 docsIfCmStatusCode OCTET STRING, 2100 docsIfCmStatusTxPower TenthdBmV, 2101 docsIfCmStatusResets Counter32, 2102 docsIfCmStatusLostSyncs Counter32, 2103 docsIfCmStatusInvalidMaps Counter32, 2104 docsIfCmStatusInvalidUcds Counter32, 2105 docsIfCmStatusInvalidRangingResponses Counter32, 2106 docsIfCmStatusInvalidRegistrationResponses Counter32, 2107 docsIfCmStatusT1Timeouts Counter32, 2108 docsIfCmStatusT2Timeouts Counter32, 2109 docsIfCmStatusT3Timeouts Counter32, 2110 docsIfCmStatusT4Timeouts Counter32, 2111 docsIfCmStatusRangingAborteds Counter32, 2112 docsIfCmStatusDocsisOperMode DocsisQosVersion, 2113 docsIfCmStatusModulationType DocsisUpstreamTypeStatus 2114 } 2116 docsIfCmStatusValue OBJECT-TYPE 2117 SYNTAX INTEGER { 2118 other(1), 2119 notReady(2), 2120 notSynchronized(3), 2121 phySynchronized(4), 2122 usParametersAcquired(5), 2123 rangingComplete(6), 2124 ipComplete(7), 2125 todEstablished(8), 2126 securityEstablished(9), 2127 paramTransferComplete(10), 2128 registrationComplete(11), 2129 operational(12), 2130 accessDenied(13) 2131 } 2132 MAX-ACCESS read-only 2133 STATUS current 2134 DESCRIPTION 2135 "Current Cable Modem connectivity state, as specified 2136 in the RF Interface Specification." 2137 REFERENCE 2138 "Document [25] from References, Section 11.2." 2139 ::= { docsIfCmStatusEntry 1 } 2141 docsIfCmStatusCode OBJECT-TYPE 2142 SYNTAX OCTET STRING 2143 MAX-ACCESS read-only 2144 STATUS current 2145 DESCRIPTION 2146 "Status code for this Cable Modem as defined in the 2147 RF Interface Specification. The status code consists 2148 of a single character indicating error groups, followed 2149 by a two- or three-digit number indicating the status 2150 condition." 2151 REFERENCE 2152 "Document [26] from References, Appendix F." 2153 ::= { docsIfCmStatusEntry 2 } 2155 docsIfCmStatusTxPower OBJECT-TYPE 2156 SYNTAX TenthdBmV 2157 UNITS "dBmV" 2158 MAX-ACCESS read-only 2159 STATUS current 2160 DESCRIPTION 2161 "The operational transmit power for the attached upstream 2162 channel." 2163 REFERENCE 2164 "Document [25] from References, Section 6.2.18." 2165 ::= { docsIfCmStatusEntry 3 } 2167 docsIfCmStatusResets OBJECT-TYPE 2168 SYNTAX Counter32 2169 MAX-ACCESS read-only 2170 STATUS current 2171 DESCRIPTION 2172 "Number of times the CM reset or initialized this interface." 2173 ::= { docsIfCmStatusEntry 4 } 2175 docsIfCmStatusLostSyncs OBJECT-TYPE 2176 SYNTAX Counter32 2177 MAX-ACCESS read-only 2178 STATUS current 2179 DESCRIPTION 2180 "Number of times the CM lost synchronization with 2181 the downstream channel." 2182 REFERENCE 2183 "Document [25] from References, Section 8.3.2." 2184 ::= { docsIfCmStatusEntry 5 } 2186 docsIfCmStatusInvalidMaps OBJECT-TYPE 2187 SYNTAX Counter32 2188 MAX-ACCESS read-only 2189 STATUS current 2190 DESCRIPTION 2191 "Number of times the CM received invalid MAP messages." 2192 REFERENCE 2193 "Document [25] from References, Section 8.3.4." 2194 ::= { docsIfCmStatusEntry 6 } 2196 docsIfCmStatusInvalidUcds OBJECT-TYPE 2197 SYNTAX Counter32 2198 MAX-ACCESS read-only 2199 STATUS current 2200 DESCRIPTION 2201 "Number of times the CM received invalid UCD messages." 2202 REFERENCE 2203 "Document [25] from References, Section 8.3.3." 2204 ::= { docsIfCmStatusEntry 7 } 2206 docsIfCmStatusInvalidRangingResponses OBJECT-TYPE 2207 SYNTAX Counter32 2208 MAX-ACCESS read-only 2209 STATUS current 2210 DESCRIPTION 2211 "Number of times the CM received invalid ranging response 2212 messages." 2213 REFERENCE 2214 "Document [25] from References, Section 8.3.6." 2215 ::= { docsIfCmStatusEntry 8 } 2217 docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE 2218 SYNTAX Counter32 2219 MAX-ACCESS read-only 2220 STATUS current 2221 DESCRIPTION 2222 "Number of times the CM received invalid registration 2223 response messages." 2224 REFERENCE 2225 "Document [25] from References, Section 8.3.8." 2226 ::= { docsIfCmStatusEntry 9 } 2228 docsIfCmStatusT1Timeouts OBJECT-TYPE 2229 SYNTAX Counter32 2230 MAX-ACCESS read-only 2231 STATUS current 2232 DESCRIPTION 2233 "Number of times counter T1 expired in the CM." 2234 REFERENCE 2235 "Document [25] from References, Figure 9-2." 2236 ::= { docsIfCmStatusEntry 10 } 2238 docsIfCmStatusT2Timeouts OBJECT-TYPE 2239 SYNTAX Counter32 2240 MAX-ACCESS read-only 2241 STATUS current 2242 DESCRIPTION 2243 "Number of times counter T2 expired in the CM." 2244 REFERENCE 2245 "Document [25] from References, Figure 9-2." 2246 ::= { docsIfCmStatusEntry 11 } 2248 docsIfCmStatusT3Timeouts OBJECT-TYPE 2249 SYNTAX Counter32 2250 MAX-ACCESS read-only 2251 STATUS current 2252 DESCRIPTION 2253 "Number of times counter T3 expired in the CM." 2254 REFERENCE 2255 "Document [25] from References, Figure 9-2." 2256 ::= { docsIfCmStatusEntry 12 } 2258 docsIfCmStatusT4Timeouts OBJECT-TYPE 2259 SYNTAX Counter32 2260 MAX-ACCESS read-only 2261 STATUS current 2262 DESCRIPTION 2263 "Number of times counter T4 expired in the CM." 2264 REFERENCE 2265 "Document [25] from References, Figure 9-2." 2266 ::= { docsIfCmStatusEntry 13 } 2268 docsIfCmStatusRangingAborteds OBJECT-TYPE 2269 SYNTAX Counter32 2270 MAX-ACCESS read-only 2271 STATUS current 2272 DESCRIPTION 2273 "Number of times the ranging process was aborted 2274 by the CMTS." 2275 REFERENCE 2276 "Document [25] from References, Section 9.3.3." 2277 ::= { docsIfCmStatusEntry 14 } 2279 docsIfCmStatusDocsisOperMode OBJECT-TYPE 2280 SYNTAX DocsisQosVersion 2281 MAX-ACCESS read-only 2282 STATUS current 2283 DESCRIPTION 2284 "Indication whether the device has registered using 1.0 Class of 2285 Service or 1.1 Quality of Service. 2286 An unregistered CM should indicate 1.1 QOS for a 2287 docsIfDocsisBaseCapability value of Docsis 1.1/2.0. An unregistered 2288 CM should indicate 1.0 COS for a docsIfDocsisBaseCapability value 2289 of Docsis 1.0. 2290 This object mirrors docsIfCmDocsisOperMode from the docsIfExt mib." 2291 REFERENCE 2292 "Document [25] from References, Annex G." 2293 ::= { docsIfCmStatusEntry 15 } 2295 docsIfCmStatusModulationType OBJECT-TYPE 2296 SYNTAX DocsisUpstreamTypeStatus 2297 MAX-ACCESS read-only 2298 STATUS current 2299 DESCRIPTION 2300 "Indicates modulation type status currently used by the CM. 2301 Since this object specifically identifies PHY mode, the shared 2302 upstream channel type is not permitted." 2304 REFERENCE 2305 "Document [25] from References, Section 6.2.1." 2307 ::= { docsIfCmStatusEntry 16 } 2309 -- 2310 -- The Cable Modem Service Table 2311 -- 2313 docsIfCmServiceTable OBJECT-TYPE 2314 SYNTAX SEQUENCE OF DocsIfCmServiceEntry 2315 MAX-ACCESS not-accessible 2316 STATUS current 2317 DESCRIPTION 2318 "Describes the attributes of each upstream service queue 2319 on a CM." 2320 ::= { docsIfCmObjects 3 } 2322 docsIfCmServiceEntry OBJECT-TYPE 2323 SYNTAX DocsIfCmServiceEntry 2324 MAX-ACCESS not-accessible 2325 STATUS current 2326 DESCRIPTION 2327 "Describes the attributes of an upstream bandwidth service 2328 queue. 2329 An entry in this table exists for each Service ID. 2330 The primary index is an ifIndex with an ifType of 2331 docsCableMaclayer(127)." 2332 INDEX { ifIndex, docsIfCmServiceId } 2333 ::= { docsIfCmServiceTable 1 } 2335 DocsIfCmServiceEntry ::= SEQUENCE { 2336 docsIfCmServiceId Integer32, 2337 docsIfCmServiceQosProfile Integer32, 2338 docsIfCmServiceTxSlotsImmed Counter32, 2339 docsIfCmServiceTxSlotsDed Counter32, 2340 docsIfCmServiceTxRetries Counter32, 2341 docsIfCmServiceTxExceededs Counter32, 2342 docsIfCmServiceRqRetries Counter32, 2343 docsIfCmServiceRqExceededs Counter32, 2344 docsIfCmServiceExtTxSlotsImmed Counter64, 2345 docsIfCmServiceExtTxSlotsDed Counter64 2346 } 2348 docsIfCmServiceId OBJECT-TYPE 2349 SYNTAX Integer32 (1..16383) 2350 MAX-ACCESS not-accessible 2351 STATUS current 2352 DESCRIPTION 2353 "Identifies a service queue for upstream bandwidth. The 2354 attributes of this service queue are shared between the 2355 CM and the CMTS. The CMTS allocates upstream bandwidth 2356 to this service queue based on requests from the CM and 2357 on the class of service associated with this queue." 2358 ::= { docsIfCmServiceEntry 1 } 2360 docsIfCmServiceQosProfile OBJECT-TYPE 2361 SYNTAX Integer32 (0..16383) 2362 MAX-ACCESS read-only 2363 STATUS current 2364 DESCRIPTION 2365 "The index in docsIfQosProfileTable describing the quality 2366 of service attributes associated with this particular 2367 service. If no associated entry in docsIfQosProfileTable 2368 exists, this object returns a value of zero." 2369 ::= { docsIfCmServiceEntry 2 } 2371 docsIfCmServiceTxSlotsImmed OBJECT-TYPE 2372 SYNTAX Counter32 2373 MAX-ACCESS read-only 2374 STATUS current 2375 DESCRIPTION 2376 "The number of upstream mini-slots which have been used to 2377 transmit data PDUs in immediate (contention) mode. This 2378 includes only those PDUs that are presumed to have 2379 arrived at the headend (i.e., those which were explicitly 2380 acknowledged.) It does not include retransmission attempts 2381 or mini-slots used by Requests." 2382 REFERENCE 2383 "Document [25] from References, Section 9.4." 2384 ::= { docsIfCmServiceEntry 3 } 2386 docsIfCmServiceTxSlotsDed OBJECT-TYPE 2387 SYNTAX Counter32 2388 MAX-ACCESS read-only 2389 STATUS current 2390 DESCRIPTION 2391 "The number of upstream mini-slots which have been used to 2392 transmit data PDUs in dedicated mode (i.e., as a result 2393 of a unicast Data Grant)." 2394 REFERENCE 2395 "Document [25] from References, Section 9.4." 2396 ::= { docsIfCmServiceEntry 4 } 2398 docsIfCmServiceTxRetries OBJECT-TYPE 2399 SYNTAX Counter32 2400 MAX-ACCESS read-only 2401 STATUS current 2402 DESCRIPTION 2403 "The number of attempts to transmit data PDUs containing 2404 requests for acknowledgment that did not result in 2405 acknowledgment." 2406 REFERENCE 2407 "Document [25] from References, Section 9.4." 2409 ::= { docsIfCmServiceEntry 5 } 2411 docsIfCmServiceTxExceededs OBJECT-TYPE 2412 SYNTAX Counter32 2413 MAX-ACCESS read-only 2414 STATUS current 2415 DESCRIPTION 2416 "The number of data PDUs transmission failures due to 2417 excessive retries without acknowledgment." 2418 REFERENCE 2419 "Document [25] from References, Section 9.4." 2420 ::= { docsIfCmServiceEntry 6 } 2422 docsIfCmServiceRqRetries OBJECT-TYPE 2423 SYNTAX Counter32 2424 MAX-ACCESS read-only 2425 STATUS current 2426 DESCRIPTION 2427 "The number of attempts to transmit bandwidth requests 2428 which did not result in acknowledgment." 2429 REFERENCE 2430 "Document [25] from References, Section 9.4." 2431 ::= { docsIfCmServiceEntry 7 } 2433 docsIfCmServiceRqExceededs OBJECT-TYPE 2434 SYNTAX Counter32 2435 MAX-ACCESS read-only 2436 STATUS current 2437 DESCRIPTION 2438 "The number of requests for bandwidth which failed due to 2439 excessive retries without acknowledgment." 2440 REFERENCE 2441 "Document [25] from References, Section 9.4." 2442 ::= { docsIfCmServiceEntry 8 } 2444 docsIfCmServiceExtTxSlotsImmed OBJECT-TYPE 2445 SYNTAX Counter64 2446 MAX-ACCESS read-only 2447 STATUS current 2448 DESCRIPTION 2449 "The number of upstream mini-slots which have been used to 2450 transmit data PDUs in immediate (contention) mode. This 2451 includes only those PDUs that are presumed to have 2452 arrived at the headend (i.e., those which were explicitly 2453 acknowledged.) It does not include retransmission attempts 2454 or mini-slots used by Requests." 2455 REFERENCE 2456 "Document [25] from References, Section 9.4." 2457 ::= { docsIfCmServiceEntry 9 } 2459 docsIfCmServiceExtTxSlotsDed OBJECT-TYPE 2460 SYNTAX Counter64 2461 MAX-ACCESS read-only 2462 STATUS current 2463 DESCRIPTION 2464 "The number of upstream mini-slots which have been used to 2465 transmit data PDUs in dedicated mode (i.e., as a result 2466 of a unicast Data Grant)." 2467 REFERENCE 2468 "Document [25] from References, Section 9.4." 2469 ::= { docsIfCmServiceEntry 10 } 2471 -- 2472 -- CMTS GROUP 2473 -- 2475 -- 2476 -- The CMTS MAC Table 2477 -- 2479 docsIfCmtsMacTable OBJECT-TYPE 2480 SYNTAX SEQUENCE OF DocsIfCmtsMacEntry 2481 MAX-ACCESS not-accessible 2482 STATUS current 2483 DESCRIPTION 2484 "Describes the attributes of each CMTS MAC interface, 2485 extending the information available from ifEntry. 2486 Mandatory for all CMTS devices." 2487 ::= { docsIfCmtsObjects 1 } 2489 docsIfCmtsMacEntry OBJECT-TYPE 2490 SYNTAX DocsIfCmtsMacEntry 2491 MAX-ACCESS not-accessible 2492 STATUS current 2493 DESCRIPTION 2494 "An entry containing objects describing attributes of each 2495 MAC entry, extending the information in ifEntry. 2496 An entry in this table exists for each ifEntry with an 2497 ifType of docsCableMaclayer(127)." 2498 INDEX { ifIndex } 2499 ::= { docsIfCmtsMacTable 1 } 2501 DocsIfCmtsMacEntry ::= SEQUENCE { 2502 docsIfCmtsCapabilities BITS, 2503 docsIfCmtsSyncInterval Integer32, 2504 docsIfCmtsUcdInterval Integer32, 2505 docsIfCmtsMaxServiceIds Integer32, 2506 docsIfCmtsInsertionInterval TimeTicks, -- Obsolete 2507 docsIfCmtsInvitedRangingAttempts Integer32, 2508 docsIfCmtsInsertInterval TimeInterval 2509 } 2511 docsIfCmtsCapabilities OBJECT-TYPE 2512 SYNTAX BITS { 2513 atmCells(0), 2514 concatenation(1) 2515 } 2516 MAX-ACCESS read-only 2517 STATUS current 2518 DESCRIPTION 2519 "Identifies the capabilities of the CMTS MAC 2520 implementation at this interface. Note that packet 2521 transmission is always supported. Therefore, there 2522 is no specific bit required to explicitly indicate 2523 this capability. 2524 Note that BITS objects are encoded most significant bit 2525 first. For example, if bit 1 is set, the value of this 2526 object is the octet string '40'H." 2527 ::= { docsIfCmtsMacEntry 1 } 2529 docsIfCmtsSyncInterval OBJECT-TYPE 2530 SYNTAX Integer32 (1..200) 2531 UNITS "Milliseconds" 2532 MAX-ACCESS read-write 2533 STATUS current 2534 DESCRIPTION 2535 "The interval between CMTS transmission of successive SYNC 2536 messages at this interface." 2537 REFERENCE 2538 "Document [25] from References, Section 9.3." 2539 ::= { docsIfCmtsMacEntry 2 } 2541 docsIfCmtsUcdInterval OBJECT-TYPE 2542 SYNTAX Integer32 (1..2000) 2543 UNITS "Milliseconds" 2544 MAX-ACCESS read-write 2545 STATUS current 2546 DESCRIPTION 2547 "The interval between CMTS transmission of successive 2548 Upstream Channel Descriptor messages for each upstream 2549 channel at this interface." 2550 REFERENCE 2551 "Document [25] from References, Section 9.3" 2552 ::= { docsIfCmtsMacEntry 3 } 2554 docsIfCmtsMaxServiceIds OBJECT-TYPE 2555 SYNTAX Integer32 (1..16383) 2556 MAX-ACCESS read-only 2557 STATUS current 2558 DESCRIPTION 2559 "The maximum number of service IDs that may be 2560 simultaneously active." 2562 ::= { docsIfCmtsMacEntry 4 } 2564 -- This object has been obsoleted and replaced by 2565 -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem. New 2566 -- implementations of this MIB should use that object instead. 2567 docsIfCmtsInsertionInterval OBJECT-TYPE 2568 SYNTAX TimeTicks 2569 MAX-ACCESS read-write 2570 STATUS obsolete 2571 DESCRIPTION 2572 "The amount of time to elapse between each broadcast 2573 station maintenance grant. Broadcast station maintenance 2574 grants are used to allow new cable modems to join the 2575 network. Zero indicates that a vendor-specific algorithm 2576 is used instead of a fixed time. Maximum amount of time 2577 permitted by the specification is 2 seconds." 2578 REFERENCE 2579 "Document [25] from References, Annex B." 2580 ::= { docsIfCmtsMacEntry 5 } 2582 docsIfCmtsInvitedRangingAttempts OBJECT-TYPE 2583 SYNTAX Integer32 (0..1024) 2584 MAX-ACCESS read-write 2585 STATUS current 2586 DESCRIPTION 2587 "The maximum number of attempts to make on invitations 2588 for ranging requests. A value of zero means the system 2589 should attempt to range forever." 2590 REFERENCE 2591 "Document [25] from References, Section 9.3.3 and Annex B." 2592 ::= { docsIfCmtsMacEntry 6 } 2594 docsIfCmtsInsertInterval OBJECT-TYPE 2595 SYNTAX TimeInterval 2596 MAX-ACCESS read-write 2597 STATUS current 2598 DESCRIPTION 2599 "The amount of time to elapse between each broadcast 2600 station maintenance grant. Broadcast station maintenance 2601 grants are used to allow new cable modems to join the 2602 network. Zero indicates that a vendor-specific algorithm 2603 is used instead of a fixed time. Maximum amount of time 2604 permitted by the specification is 2 seconds." 2605 REFERENCE 2606 "Document [25] from References, Annex B." 2607 ::= { docsIfCmtsMacEntry 7 } 2609 -- 2610 -- 2611 -- CMTS status table. 2612 -- 2613 docsIfCmtsStatusTable OBJECT-TYPE 2614 SYNTAX SEQUENCE OF DocsIfCmtsStatusEntry 2615 MAX-ACCESS not-accessible 2616 STATUS current 2617 DESCRIPTION 2618 "For the MAC layer, this group maintains a number of 2619 status objects and counters." 2620 ::= { docsIfCmtsObjects 2 } 2622 docsIfCmtsStatusEntry OBJECT-TYPE 2623 SYNTAX DocsIfCmtsStatusEntry 2624 MAX-ACCESS not-accessible 2625 STATUS current 2626 DESCRIPTION 2627 "Status entry for a single MAC layer. 2628 An entry in this table exists for each ifEntry with an 2629 ifType of docsCableMaclayer(127)." 2630 INDEX { ifIndex } 2631 ::= { docsIfCmtsStatusTable 1 } 2633 DocsIfCmtsStatusEntry ::= SEQUENCE { 2634 docsIfCmtsStatusInvalidRangeReqs Counter32, 2635 docsIfCmtsStatusRangingAborteds Counter32, 2636 docsIfCmtsStatusInvalidRegReqs Counter32, 2637 docsIfCmtsStatusFailedRegReqs Counter32, 2638 docsIfCmtsStatusInvalidDataReqs Counter32, 2639 docsIfCmtsStatusT5Timeouts Counter32 2640 } 2642 docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE 2643 SYNTAX Counter32 2644 MAX-ACCESS read-only 2645 STATUS current 2646 DESCRIPTION 2647 "This object counts invalid RNG-REQ messages received on 2648 this interface." 2649 REFERENCE 2650 "Document [25] from References, Section 8.3.5." 2652 ::= { docsIfCmtsStatusEntry 1 } 2654 docsIfCmtsStatusRangingAborteds OBJECT-TYPE 2655 SYNTAX Counter32 2656 MAX-ACCESS read-only 2657 STATUS current 2658 DESCRIPTION 2659 "This object counts ranging attempts that were explicitly 2660 aborted by the CMTS." 2661 REFERENCE 2662 "Document [25] from References, Section 8.3.6." 2663 ::= { docsIfCmtsStatusEntry 2 } 2665 docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE 2666 SYNTAX Counter32 2667 MAX-ACCESS read-only 2668 STATUS current 2669 DESCRIPTION 2670 "This object counts invalid REG-REQ messages received on 2671 this interface. That is, syntax, out of range parameters, 2672 or erroneous requests." 2673 REFERENCE 2674 "Document [25] from References, Section 8.3.7." 2675 ::= { docsIfCmtsStatusEntry 3 } 2677 docsIfCmtsStatusFailedRegReqs OBJECT-TYPE 2678 SYNTAX Counter32 2679 MAX-ACCESS read-only 2680 STATUS current 2681 DESCRIPTION 2682 "This object counts failed registration attempts. Included are 2683 docsIfCmtsStatusInvalidRegReqs, authentication and class of 2684 service failures." 2685 REFERENCE 2686 "Document [25] from References, Section 8.3.7." 2687 ::= { docsIfCmtsStatusEntry 4 } 2689 docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE 2690 SYNTAX Counter32 2691 MAX-ACCESS read-only 2692 STATUS current 2693 DESCRIPTION 2694 "This object counts invalid data request messages 2695 received on this interface." 2696 ::= { docsIfCmtsStatusEntry 5 } 2698 docsIfCmtsStatusT5Timeouts OBJECT-TYPE 2699 SYNTAX Counter32 2700 MAX-ACCESS read-only 2701 STATUS current 2702 DESCRIPTION 2703 "This object counts the number of times counter T5 2704 expired on this interface." 2705 REFERENCE 2706 "Document [25] from References, Figure 9-2." 2707 ::= { docsIfCmtsStatusEntry 6 } 2709 -- 2710 -- CM status table (within CMTS). 2711 -- This table is implemented only at the CMTS. 2712 -- It contains per CM status information available in the CMTS. 2713 -- 2714 docsIfCmtsCmStatusTable OBJECT-TYPE 2715 SYNTAX SEQUENCE OF DocsIfCmtsCmStatusEntry 2716 MAX-ACCESS not-accessible 2717 STATUS current 2718 DESCRIPTION 2719 "A set of objects in the CMTS, maintained for each 2720 Cable Modem connected to this CMTS." 2721 ::= { docsIfCmtsObjects 3 } 2723 docsIfCmtsCmStatusEntry OBJECT-TYPE 2724 SYNTAX DocsIfCmtsCmStatusEntry 2725 MAX-ACCESS not-accessible 2726 STATUS current 2727 DESCRIPTION 2728 "Status information for a single Cable Modem. 2729 An entry in this table exists for each Cable Modem 2730 that is connected to the CMTS implementing this table." 2731 INDEX { docsIfCmtsCmStatusIndex } 2732 ::= { docsIfCmtsCmStatusTable 1 } 2734 DocsIfCmtsCmStatusEntry ::= SEQUENCE { 2735 docsIfCmtsCmStatusIndex Integer32, 2736 docsIfCmtsCmStatusMacAddress MacAddress, 2737 docsIfCmtsCmStatusIpAddress IpAddress, -- Deprecated 2738 docsIfCmtsCmStatusDownChannelIfIndex InterfaceIndexOrZero, 2739 docsIfCmtsCmStatusUpChannelIfIndex InterfaceIndexOrZero, 2740 docsIfCmtsCmStatusRxPower TenthdBmV, 2741 docsIfCmtsCmStatusTimingOffset Unsigned32, 2742 docsIfCmtsCmStatusEqualizationData OCTET STRING, 2743 docsIfCmtsCmStatusValue INTEGER, 2744 docsIfCmtsCmStatusUnerroreds Counter32, 2745 docsIfCmtsCmStatusCorrecteds Counter32, 2746 docsIfCmtsCmStatusUncorrectables Counter32, 2747 docsIfCmtsCmStatusSignalNoise TenthdB, 2748 docsIfCmtsCmStatusMicroreflections Integer32, 2749 docsIfCmtsCmStatusExtUnerroreds Counter64, 2750 docsIfCmtsCmStatusExtCorrecteds Counter64, 2751 docsIfCmtsCmStatusExtUncorrectables Counter64, 2752 docsIfCmtsCmStatusDocsisRegMode DocsisQosVersion, 2753 docsIfCmtsCmStatusModulationType DocsisUpstreamTypeStatus, 2754 docsIfCmtsCmStatusInetAddressType InetAddressType, 2755 docsIfCmtsCmStatusInetAddress InetAddress 2756 } 2758 docsIfCmtsCmStatusIndex OBJECT-TYPE 2759 SYNTAX Integer32 (1..2147483647) 2760 MAX-ACCESS not-accessible 2761 STATUS current 2762 DESCRIPTION 2763 "Index value to uniquely identify an entry in this table. 2764 For an individual Cable Modem, this index value should 2765 not change during CMTS uptime." 2767 ::= { docsIfCmtsCmStatusEntry 1 } 2769 docsIfCmtsCmStatusMacAddress OBJECT-TYPE 2770 SYNTAX MacAddress 2771 MAX-ACCESS read-only 2772 STATUS current 2773 DESCRIPTION 2774 "MAC address of this Cable Modem. If the Cable Modem has 2775 multiple MAC addresses, this is the MAC address associated 2776 with the Cable interface." 2777 REFERENCE 2778 "Document [25] from References, Section 8.2.2." 2779 ::= { docsIfCmtsCmStatusEntry 2 } 2781 docsIfCmtsCmStatusIpAddress OBJECT-TYPE 2782 SYNTAX IpAddress 2783 MAX-ACCESS read-only 2784 STATUS deprecated 2785 DESCRIPTION 2786 "IP address of this Cable Modem. If the Cable Modem has no 2787 IP address assigned, or the IP address is unknown, this 2788 object returns a value of 0.0.0.0. If the Cable Modem has 2789 multiple IP addresses, this object returns the IP address 2790 associated with the Cable interface.n 2791 This object has been deprecated and replaced by 2792 docsIfCmtsCmStatusInetAddressType and 2793 docsIfCmtsCmStatusInetAddress, to enable IPv6 addressing 2794 in the future." 2795 ::= { docsIfCmtsCmStatusEntry 3 } 2797 docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE 2798 SYNTAX InterfaceIndexOrZero 2799 MAX-ACCESS read-only 2800 STATUS current 2801 DESCRIPTION 2802 "IfIndex of the downstream channel this CM is connected 2803 to. If the downstream channel is unknown, this object 2804 returns a value of zero." 2805 ::= { docsIfCmtsCmStatusEntry 4 } 2807 docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE 2808 SYNTAX InterfaceIndexOrZero 2809 MAX-ACCESS read-only 2810 STATUS current 2811 DESCRIPTION 2812 "IfIndex of the upstream channel this CM is connected 2813 to. If the upstream channel is unknown, this object 2814 returns a value of zero." 2815 ::= { docsIfCmtsCmStatusEntry 5 } 2817 docsIfCmtsCmStatusRxPower OBJECT-TYPE 2818 SYNTAX TenthdBmV 2819 UNITS "dBmV" 2820 MAX-ACCESS read-only 2821 STATUS current 2822 DESCRIPTION 2823 "The receive power as perceived for upstream data from 2824 this Cable Modem. 2825 If the receive power is unknown, this object returns 2826 a value of zero." 2827 REFERENCE 2828 "Document [25] from References, Table 6-11." 2829 ::= { docsIfCmtsCmStatusEntry 6 } 2831 docsIfCmtsCmStatusTimingOffset OBJECT-TYPE 2832 SYNTAX Unsigned32 2833 MAX-ACCESS read-only 2834 STATUS current 2835 DESCRIPTION 2836 "A measure of the current round trip time for this CM. 2837 Used for timing of CM upstream transmissions to ensure 2838 synchronized arrivals at the CMTS. Units are in terms 2839 of 6.25 microseconds/(64*256). Returns zero if the value 2840 is unknown." 2841 REFERENCE 2842 "Document [25] from References, Section 6.2.18." 2843 ::= { docsIfCmtsCmStatusEntry 7 } 2845 docsIfCmtsCmStatusEqualizationData OBJECT-TYPE 2846 SYNTAX OCTET STRING 2847 MAX-ACCESS read-only 2848 STATUS current 2849 DESCRIPTION 2850 "Equalization data for this CM. Returns an empty string 2851 if the value is unknown or if there is no equalization 2852 data available or defined." 2853 REFERENCE 2854 "Document [25] from References, Figure 8-23." 2855 ::= { docsIfCmtsCmStatusEntry 8 } 2857 docsIfCmtsCmStatusValue OBJECT-TYPE 2858 SYNTAX INTEGER { 2859 other(1), 2860 ranging(2), 2861 rangingAborted(3), 2862 rangingComplete(4), 2863 ipComplete(5), 2864 registrationComplete(6), 2865 accessDenied(7) 2866 } 2867 MAX-ACCESS read-only 2868 STATUS current 2869 DESCRIPTION 2870 "Current Cable Modem connectivity state, as specified 2871 in the RF Interface Specification. Returned status 2872 information is the CM status as assumed by the CMTS, 2873 and indicates the following events: 2874 other(1) 2875 Any state other than below. 2876 ranging(2) 2877 The CMTS has received an Initial Ranging Request 2878 message from the CM, and the ranging process is not 2879 yet complete. 2880 rangingAborted(3) 2881 The CMTS has sent a Ranging Abort message to the CM. 2882 rangingComplete(4) 2883 The CMTS has sent a Ranging Complete message to the CM. 2884 ipComplete(5) 2885 The CMTS has received a DHCP reply message and forwarded 2886 it to the CM. 2887 registrationComplete(6) 2888 The CMTS has sent a Registration Response message to 2889 the CM. 2890 accessDenied(7) 2891 The CMTS has sent a Registration Aborted message 2892 to the CM. 2893 The CMTS only needs to report states it is able to detect." 2894 REFERENCE 2895 "Document [25] from References, Section 11.2." 2896 ::= { docsIfCmtsCmStatusEntry 9 } 2898 docsIfCmtsCmStatusUnerroreds OBJECT-TYPE 2899 SYNTAX Counter32 2900 MAX-ACCESS read-only 2901 STATUS current 2902 DESCRIPTION 2903 "Codewords received without error from this Cable Modem." 2904 REFERENCE 2905 "Document [25] from References, Section 6.2.5." 2906 ::= { docsIfCmtsCmStatusEntry 10 } 2908 docsIfCmtsCmStatusCorrecteds OBJECT-TYPE 2909 SYNTAX Counter32 2910 MAX-ACCESS read-only 2911 STATUS current 2912 DESCRIPTION 2913 "Codewords received with correctable errors from this 2914 Cable Modem." 2915 REFERENCE 2916 "Document [25] from References, Section 6.2.5." 2917 ::= { docsIfCmtsCmStatusEntry 11 } 2919 docsIfCmtsCmStatusUncorrectables OBJECT-TYPE 2920 SYNTAX Counter32 2921 MAX-ACCESS read-only 2922 STATUS current 2923 DESCRIPTION 2924 "Codewords received with uncorrectable errors from this 2925 Cable Modem." 2926 REFERENCE 2927 "Document [25] from References, Section 6.2.5." 2928 ::= { docsIfCmtsCmStatusEntry 12 } 2930 docsIfCmtsCmStatusSignalNoise OBJECT-TYPE 2931 SYNTAX TenthdB 2932 UNITS "dB" 2933 MAX-ACCESS read-only 2934 STATUS current 2935 DESCRIPTION 2936 "Signal/Noise ratio as perceived for upstream data from 2937 this Cable Modem. 2938 If the Signal/Noise is unknown, this object returns 2939 a value of zero." 2940 REFERENCE 2941 "Document [25] from References, Tables 4-1 and 4-2." 2942 ::= { docsIfCmtsCmStatusEntry 13 } 2944 docsIfCmtsCmStatusMicroreflections OBJECT-TYPE 2945 SYNTAX Integer32 (0..255) 2946 UNITS "dBc" 2947 MAX-ACCESS read-only 2948 STATUS current 2949 DESCRIPTION 2950 "Total microreflections including in-channel response 2951 as perceived on this interface, measured in dBc below 2952 the signal level. 2953 This object is not assumed to return an absolutely 2954 accurate value, but should give a rough indication 2955 of microreflections received on this interface. 2956 It is up to the implementer to provide information 2957 as accurate as possible." 2958 REFERENCE 2959 "Document [25] from References, Tables 4-1 and 4-2" 2960 ::= { docsIfCmtsCmStatusEntry 14 } 2962 docsIfCmtsCmStatusExtUnerroreds OBJECT-TYPE 2963 SYNTAX Counter64 2964 MAX-ACCESS read-only 2965 STATUS current 2966 DESCRIPTION 2967 "Codewords received without error from this Cable Modem." 2968 REFERENCE 2969 "Document [25] from References, Section 6.2.5." 2970 ::= { docsIfCmtsCmStatusEntry 15 } 2972 docsIfCmtsCmStatusExtCorrecteds OBJECT-TYPE 2973 SYNTAX Counter64 2974 MAX-ACCESS read-only 2975 STATUS current 2976 DESCRIPTION 2977 "Codewords received with correctable errors from this 2978 Cable Modem." 2979 REFERENCE 2980 "Document [25] from References, Section 6.2.5." 2981 ::= { docsIfCmtsCmStatusEntry 16 } 2983 docsIfCmtsCmStatusExtUncorrectables OBJECT-TYPE 2984 SYNTAX Counter64 2985 MAX-ACCESS read-only 2986 STATUS current 2987 DESCRIPTION 2988 "Codewords received with uncorrectable errors from this 2989 Cable Modem." 2990 REFERENCE 2991 "Document [25] from References, Section 6.2.5." 2992 ::= { docsIfCmtsCmStatusEntry 17 } 2994 docsIfCmtsCmStatusDocsisRegMode OBJECT-TYPE 2995 SYNTAX DocsisQosVersion 2996 MAX-ACCESS read-only 2997 STATUS current 2998 DESCRIPTION 2999 " Indication whether the CM has registered using 1.0 Class of 3000 Service or 1.1 Quality of Service. 3001 This object mirrors docsIfCmtsCmStatusDocsisMode from the 3002 docsIfExt mib." 3003 REFERENCE 3004 "Document [25] from References, Annex G." 3005 ::= { docsIfCmtsCmStatusEntry 18 } 3007 docsIfCmtsCmStatusModulationType OBJECT-TYPE 3008 SYNTAX DocsisUpstreamTypeStatus 3009 MAX-ACCESS read-only 3010 STATUS current 3011 DESCRIPTION 3012 "Indicates modulation type currently used by the CM. Since 3013 this object specifically identifies PHY mode, the shared 3014 type is not permitted." 3015 REFERENCE 3016 "Document [25] from References, Table 8-19." 3017 ::= { docsIfCmtsCmStatusEntry 19 } 3019 docsIfCmtsCmStatusInetAddressType OBJECT-TYPE 3020 SYNTAX InetAddressType 3021 MAX-ACCESS read-only 3022 STATUS current 3023 DESCRIPTION 3024 "The type of internet address of 3025 docsIfCmtsCmStatusInetAddress. If the cable modem 3026 Internet address is unassigned or unknown, then the 3027 value of this object is unknown(0)." 3028 ::= { docsIfCmtsCmStatusEntry 20 } 3030 docsIfCmtsCmStatusInetAddress OBJECT-TYPE 3031 SYNTAX InetAddress 3032 MAX-ACCESS read-only 3033 STATUS current 3034 DESCRIPTION 3035 "Internet address of this Cable Modem. If the Cable Modem 3036 has no Internet address assigned, or the Internet address 3037 is unknown, the value of this object is the empty string. 3038 If the Cable Modem has multiple Internet addresses, this 3039 object returns the Internet address associated with the 3040 Cable (i.e. RF MAC) interface." 3041 ::= { docsIfCmtsCmStatusEntry 21 } 3043 -- 3044 -- The CMTS Service Table. 3045 -- 3047 docsIfCmtsServiceTable OBJECT-TYPE 3048 SYNTAX SEQUENCE OF DocsIfCmtsServiceEntry 3049 MAX-ACCESS not-accessible 3050 STATUS current 3051 DESCRIPTION 3052 "Describes the attributes of upstream service queues 3053 in a Cable Modem Termination System." 3054 ::= { docsIfCmtsObjects 4 } 3056 docsIfCmtsServiceEntry OBJECT-TYPE 3057 SYNTAX DocsIfCmtsServiceEntry 3058 MAX-ACCESS not-accessible 3059 STATUS current 3060 DESCRIPTION 3061 "Describes the attributes of a single upstream bandwidth 3062 service queue. 3064 Entries in this table exist for each ifEntry with an 3065 ifType of docsCableMaclayer(127), and for each service 3066 queue (Service ID) within this MAC layer. 3067 Entries in this table are created with the creation of 3068 individual Service IDs by the MAC layer and removed 3069 when a Service ID is removed." 3070 INDEX { ifIndex, docsIfCmtsServiceId } 3071 ::= { docsIfCmtsServiceTable 1 } 3073 DocsIfCmtsServiceEntry ::= SEQUENCE { 3074 docsIfCmtsServiceId Integer32, 3075 docsIfCmtsServiceCmStatusIndex Integer32, -- Deprecated 3076 docsIfCmtsServiceAdminStatus INTEGER, 3077 docsIfCmtsServiceQosProfile Integer32, 3078 docsIfCmtsServiceCreateTime TimeStamp, 3079 docsIfCmtsServiceInOctets Counter32, 3080 docsIfCmtsServiceInPackets Counter32, 3081 docsIfCmtsServiceNewCmStatusIndex Integer32 3082 } 3084 docsIfCmtsServiceId OBJECT-TYPE 3085 SYNTAX Integer32 (1..16383) 3086 MAX-ACCESS not-accessible 3087 STATUS current 3088 DESCRIPTION 3089 "Identifies a service queue for upstream bandwidth. The 3090 attributes of this service queue are shared between the 3091 Cable Modem and the Cable Modem Termination System. 3092 The CMTS allocates upstream bandwidth to this service 3093 queue based on requests from the CM and on the class of 3094 service associated with this queue." 3095 ::= { docsIfCmtsServiceEntry 1 } 3097 docsIfCmtsServiceCmStatusIndex OBJECT-TYPE 3098 SYNTAX Integer32 (0..65535) 3099 MAX-ACCESS read-only 3100 STATUS deprecated 3101 DESCRIPTION 3102 "Pointer to an entry in docsIfCmtsCmStatusTable identifying 3103 the Cable Modem using this Service Queue. If multiple 3104 Cable Modems are using this Service Queue, the value of 3105 this object is zero. 3106 This object has been deprecated and replaced by 3107 docsIfCmtsServiceNewCmStatusIndex, to fix a mismatch 3108 of the value range with respect to docsIfCmtsCmStatusIndex 3109 (1..2147483647)." 3110 ::= { docsIfCmtsServiceEntry 2 } 3112 docsIfCmtsServiceAdminStatus OBJECT-TYPE 3113 SYNTAX INTEGER { 3114 enabled(1), 3115 disabled(2), 3116 destroyed(3) } 3117 MAX-ACCESS read-write 3118 STATUS current 3119 DESCRIPTION 3120 "Allows a service class for a particular modem to be 3121 suppressed, (re-)enabled, or deleted altogether." 3122 ::= { docsIfCmtsServiceEntry 3 } 3124 docsIfCmtsServiceQosProfile OBJECT-TYPE 3125 SYNTAX Integer32 (0..16383) 3126 MAX-ACCESS read-only 3127 STATUS current 3128 DESCRIPTION 3129 "The index in docsIfQosProfileTable describing the quality 3130 of service attributes associated with this particular 3131 service. If no associated docsIfQosProfileTable entry 3132 exists, this object returns a value of zero." 3133 ::= { docsIfCmtsServiceEntry 4 } 3135 docsIfCmtsServiceCreateTime OBJECT-TYPE 3137 SYNTAX TimeStamp 3138 MAX-ACCESS read-only 3139 STATUS current 3140 DESCRIPTION 3141 "The value of sysUpTime when this entry was created." 3142 ::= { docsIfCmtsServiceEntry 5 } 3144 docsIfCmtsServiceInOctets OBJECT-TYPE 3145 SYNTAX Counter32 3146 MAX-ACCESS read-only 3147 STATUS current 3148 DESCRIPTION 3149 "The cumulative number of Packet Data octets received 3150 on this Service ID. The count does not include the 3151 size of the Cable MAC header" 3152 ::= { docsIfCmtsServiceEntry 6 } 3154 docsIfCmtsServiceInPackets OBJECT-TYPE 3155 SYNTAX Counter32 3156 MAX-ACCESS read-only 3157 STATUS current 3158 DESCRIPTION 3159 "The cumulative number of Packet Data packets received 3160 on this Service ID." 3161 ::= { docsIfCmtsServiceEntry 7 } 3163 docsIfCmtsServiceNewCmStatusIndex OBJECT-TYPE 3164 SYNTAX Integer32 (0..2147483647) 3165 MAX-ACCESS read-only 3166 STATUS current 3167 DESCRIPTION 3168 "Pointer (via docsIfCmtsCmStatusIndex) to an entry in 3169 docsIfCmtsCmStatusTable identifying the Cable Modem 3170 using this Service Queue. If multiple Cable Modems are 3171 using this Service Queue, the value of this object is 3172 zero." 3173 ::= { docsIfCmtsServiceEntry 8 } 3175 -- 3176 -- The following table provides upstream channel modulation profiles. 3177 -- Entries in this table can be 3178 -- re-used by one or more upstream channels. An upstream channel will 3179 -- have a modulation profile 3180 -- for each value of docsIfModIntervalUsageCode. 3181 -- 3183 docsIfCmtsModulationTable OBJECT-TYPE 3184 SYNTAX SEQUENCE OF DocsIfCmtsModulationEntry 3185 MAX-ACCESS not-accessible 3186 STATUS current 3187 DESCRIPTION 3188 "Describes a modulation profile associated with one or more 3189 upstream channels." 3190 ::= { docsIfCmtsObjects 5 } 3192 docsIfCmtsModulationEntry OBJECT-TYPE 3193 SYNTAX DocsIfCmtsModulationEntry 3194 MAX-ACCESS not-accessible 3195 STATUS current 3196 DESCRIPTION 3197 "Describes a modulation profile for an Interval Usage Code 3198 for one or more upstream channels. 3199 Entries in this table are created by the operator. Initial 3200 default entries may be created at system initialization 3201 time. No individual objects have to be specified in order 3202 to create an entry in this table. 3203 Note that some objects do not have DEFVALs, but do have 3204 calculated defaults and need not be specified during row 3205 creation. 3206 There is no restriction on the changing of values in this 3207 table while their associated rows are active." 3208 INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode} 3209 ::= { docsIfCmtsModulationTable 1 } 3211 DocsIfCmtsModulationEntry ::= SEQUENCE { 3212 docsIfCmtsModIndex Integer32, 3213 docsIfCmtsModIntervalUsageCode INTEGER, 3214 docsIfCmtsModControl RowStatus, 3215 docsIfCmtsModType INTEGER, 3216 docsIfCmtsModPreambleLen Integer32, 3217 docsIfCmtsModDifferentialEncoding TruthValue, 3218 docsIfCmtsModFECErrorCorrection Integer32, 3219 docsIfCmtsModFECCodewordLength Integer32, 3220 docsIfCmtsModScramblerSeed Integer32, 3221 docsIfCmtsModMaxBurstSize Integer32, 3222 docsIfCmtsModGuardTimeSize Unsigned32, 3223 docsIfCmtsModLastCodewordShortened TruthValue, 3224 docsIfCmtsModScrambler TruthValue, 3225 docsIfCmtsModByteInterleaverDepth Unsigned32, 3226 docsIfCmtsModByteInterleaverBlockSize Unsigned32, 3227 docsIfCmtsModPreambleType INTEGER, 3228 docsIfCmtsModTcmErrorCorrectionOn TruthValue, 3229 docsIfCmtsModScdmaInterleaverStepSize Unsigned32, 3230 docsIfCmtsModScdmaSpreaderEnable TruthValue, 3231 docsIfCmtsModScdmaSubframeCodes Unsigned32, 3232 docsIfCmtsModChannelType DocsisUpstreamType 3233 } 3235 docsIfCmtsModIndex OBJECT-TYPE 3236 SYNTAX Integer32 (1..2147483647) 3237 MAX-ACCESS not-accessible 3238 STATUS current 3239 DESCRIPTION 3240 "An index into the Channel Modulation table representing 3241 a group of Interval Usage Codes, all associated with the 3242 same channel." 3243 ::= { docsIfCmtsModulationEntry 1 } 3245 docsIfCmtsModIntervalUsageCode OBJECT-TYPE 3246 SYNTAX INTEGER { 3247 request(1), 3248 requestData(2), 3249 initialRanging(3), 3250 periodicRanging(4), 3251 shortData(5), 3252 longData(6), 3253 advPhyShortData(9), 3254 advPhyLongData(10), 3255 ugs(11) 3256 } 3257 MAX-ACCESS not-accessible 3258 STATUS current 3259 DESCRIPTION 3260 "An index into the Channel Modulation table which, when 3261 grouped with other Interval Usage Codes, fully 3262 instantiate all modulation sets for a given upstream 3263 channel." 3264 REFERENCE 3265 "Document [25] from References, Table 8-20." 3266 ::= { docsIfCmtsModulationEntry 2 } 3268 docsIfCmtsModControl OBJECT-TYPE 3269 SYNTAX RowStatus 3270 MAX-ACCESS read-create 3271 STATUS current 3272 DESCRIPTION 3273 "Controls and reflects the status of rows in this table." 3274 ::= { docsIfCmtsModulationEntry 3 } 3276 docsIfCmtsModType OBJECT-TYPE 3277 SYNTAX INTEGER { 3278 other(1), 3279 qpsk(2), 3280 qam16(3), 3281 qam8(4), 3282 qam32(5), 3283 qam64(6), 3284 qam128(7) 3285 } 3286 MAX-ACCESS read-create 3287 STATUS current 3288 DESCRIPTION 3289 "The modulation type used on this channel. Returns 3290 other(1) if the modulation type is neither 3291 qpsk, qam16, qam8, qam32, qam64 or qam128. 3292 Type qam128 is used for SCDMA channels only. 3293 See the reference for the modulation profiles 3294 implied by different modulation types. 3295 See the conformance object for write conditions and limitations." 3296 REFERENCE 3297 "Document [25] from References, Table 8-19." 3298 DEFVAL { qpsk } 3299 ::= { docsIfCmtsModulationEntry 4 } 3301 docsIfCmtsModPreambleLen OBJECT-TYPE 3302 SYNTAX Integer32 (0..1536) 3303 MAX-ACCESS read-create 3304 STATUS current 3305 DESCRIPTION 3306 "The preamble length for this modulation profile in bits. 3307 Default value is the minimum needed by the implementation 3308 at the CMTS for the given modulation profile." 3309 REFERENCE 3310 "Document [25] from References, Table 8-19." 3311 ::= { docsIfCmtsModulationEntry 5 } 3313 docsIfCmtsModDifferentialEncoding OBJECT-TYPE 3314 SYNTAX TruthValue 3315 MAX-ACCESS read-create 3316 STATUS current 3317 DESCRIPTION 3318 "Specifies whether or not differential encoding is used 3319 on this channel." 3320 REFERENCE 3321 "Document [25] from References, Table 8-19." 3322 DEFVAL { false } 3323 ::= { docsIfCmtsModulationEntry 6 } 3325 docsIfCmtsModFECErrorCorrection OBJECT-TYPE 3326 SYNTAX Integer32 (0..16) 3327 MAX-ACCESS read-create 3328 STATUS current 3329 DESCRIPTION 3330 "The number of correctable errored bytes (t) used in 3331 forward error correction code. The value of 0 indicates 3332 no correction is employed. The number of check bytes 3333 appended will be twice this value." 3334 REFERENCE 3335 "Document [25] from References, Table 8-19." 3336 DEFVAL { 0 } 3337 ::= { docsIfCmtsModulationEntry 7 } 3339 docsIfCmtsModFECCodewordLength OBJECT-TYPE 3340 SYNTAX Integer32 (1..255) 3341 MAX-ACCESS read-create 3342 STATUS current 3343 DESCRIPTION 3344 "The number of data bytes (k) in the forward error 3345 correction codeword. 3346 This object is not used if docsIfCmtsModFECErrorCorrection 3347 is zero." 3348 REFERENCE 3349 "Document [25] from References, Table 8-19." 3350 DEFVAL { 32 } 3351 ::= { docsIfCmtsModulationEntry 8 } 3353 docsIfCmtsModScramblerSeed OBJECT-TYPE 3354 SYNTAX Integer32 (0..32767) 3355 MAX-ACCESS read-create 3356 STATUS current 3357 DESCRIPTION 3358 "The 15 bit seed value for the scrambler polynomial." 3359 REFERENCE 3360 "Document [25] from References, Table 8-19." 3361 DEFVAL { 0 } 3362 ::= { docsIfCmtsModulationEntry 9 } 3364 docsIfCmtsModMaxBurstSize OBJECT-TYPE 3365 SYNTAX Integer32 (0..255) 3366 MAX-ACCESS read-create 3367 STATUS current 3368 DESCRIPTION 3369 "The maximum number of mini-slots that can be transmitted 3370 during this channel's burst time. Returns zero if the 3371 burst length is bounded by the allocation MAP rather than 3372 this profile. 3373 Default value is 0 except for shortData, where it is 8." 3374 REFERENCE 3375 "Document [25] from References, Table 8-19." 3376 ::= { docsIfCmtsModulationEntry 10 } 3378 docsIfCmtsModGuardTimeSize OBJECT-TYPE 3379 SYNTAX Unsigned32 3380 MAX-ACCESS read-only 3381 STATUS current 3382 DESCRIPTION 3383 "The number of symbol-times which must follow the end of 3384 this channel's burst. Default value is the minimum time 3385 needed by the implementation for this modulation profile." 3386 REFERENCE 3387 "Document [25] from References, Table 8-19." 3388 ::= { docsIfCmtsModulationEntry 11 } 3390 docsIfCmtsModLastCodewordShortened OBJECT-TYPE 3391 SYNTAX TruthValue 3392 MAX-ACCESS read-create 3393 STATUS current 3394 DESCRIPTION 3395 "Indicates if the last FEC codeword is truncated." 3396 REFERENCE 3397 "Document [25] from References, Table 8-19." 3398 DEFVAL { true } 3399 ::= { docsIfCmtsModulationEntry 12 } 3401 docsIfCmtsModScrambler OBJECT-TYPE 3402 SYNTAX TruthValue 3403 MAX-ACCESS read-create 3404 STATUS current 3405 DESCRIPTION 3406 "Indicates if the scrambler is employed." 3407 REFERENCE 3408 "Document [25] from References, Table 8-19." 3409 DEFVAL { false } 3410 ::= { docsIfCmtsModulationEntry 13 } 3412 docsIfCmtsModByteInterleaverDepth OBJECT-TYPE 3413 SYNTAX Unsigned32 3414 MAX-ACCESS read-create 3415 STATUS current 3416 DESCRIPTION 3417 " ATDMA Byte Interleaver Depth (Ir). This object returns 1 for 3418 non ATDMA profiles. " 3419 REFERENCE 3420 "Document [25] from References, Table 8-19." 3421 DEFVAL { 1 } 3422 ::= { docsIfCmtsModulationEntry 14 } 3424 docsIfCmtsModByteInterleaverBlockSize OBJECT-TYPE 3425 SYNTAX Unsigned32 3426 MAX-ACCESS read-create 3427 STATUS current 3428 DESCRIPTION 3429 " ATDMA Byte Interleaver Block size (Br). This object returns 3430 zero for non ATDMA profiles " 3431 REFERENCE 3432 "Document [25] from References, Table 8-19." 3433 DEFVAL { 18 } 3434 ::= { docsIfCmtsModulationEntry 15 } 3436 docsIfCmtsModPreambleType OBJECT-TYPE 3437 SYNTAX INTEGER { 3438 qpsk0(1), 3439 qpsk1(2) 3440 } 3441 MAX-ACCESS read-create 3442 STATUS current 3443 DESCRIPTION 3444 "Preamble type for DOCSIS 2.0 bursts" 3445 REFERENCE 3446 "Document [25] from References, Table 8-19." 3447 DEFVAL { qpsk0 } 3448 ::= { docsIfCmtsModulationEntry 16 } 3450 docsIfCmtsModTcmErrorCorrectionOn OBJECT-TYPE 3451 SYNTAX TruthValue 3452 MAX-ACCESS read-create 3453 STATUS current 3454 DESCRIPTION 3455 " Trellis Code Modulation (TCM) On/Off. This value returns false for 3456 non S-CDMA profiles." 3457 REFERENCE 3458 "Document [25] from References, Table 8-19." 3459 DEFVAL { false } 3460 ::= { docsIfCmtsModulationEntry 17 } 3462 docsIfCmtsModScdmaInterleaverStepSize OBJECT-TYPE 3463 SYNTAX Unsigned32 (0 | 1..32) 3464 MAX-ACCESS read-create 3465 STATUS current 3466 DESCRIPTION 3467 " S-CDMA Interleaver step size. This value returns zero 3468 for non S-CDMA profiles." 3469 REFERENCE 3470 "Document [25] from References, Table 8-19." 3472 DEFVAL { 1 } 3473 ::= { docsIfCmtsModulationEntry 18 } 3475 docsIfCmtsModScdmaSpreaderEnable OBJECT-TYPE 3476 SYNTAX TruthValue 3477 MAX-ACCESS read-create 3478 STATUS current 3479 DESCRIPTION 3480 " S-CDMA spreader. This value returns false for non S-CDMA 3481 profiles. Default value for IUC 3 and 4 is OFF, for 3482 all other IUCs it is ON." 3483 REFERENCE 3484 "Document [25] from References, Table 8-19." 3485 ::= { docsIfCmtsModulationEntry 19 } 3487 docsIfCmtsModScdmaSubframeCodes OBJECT-TYPE 3488 SYNTAX Unsigned32 (0 | 1..128) 3489 MAX-ACCESS read-create 3490 STATUS current 3491 DESCRIPTION 3492 " S-CDMA sub-frame size. This value returns zero 3493 for non S-CDMA profiles." 3494 REFERENCE 3495 "Document [25] from References, Table 8-19." 3496 DEFVAL { 1 } 3497 ::= { docsIfCmtsModulationEntry 20 } 3499 docsIfCmtsModChannelType OBJECT-TYPE 3500 SYNTAX DocsisUpstreamType 3501 MAX-ACCESS read-create 3502 STATUS current 3503 DESCRIPTION 3504 "Describes the modulation channel type for this modulation entry." 3505 REFERENCE 3506 "Document [25] from References, Table 8-19." 3507 DEFVAL { tdma } 3508 ::= { docsIfCmtsModulationEntry 21 } 3510 docsIfCmtsQosProfilePermissions OBJECT-TYPE 3511 SYNTAX BITS { 3512 createByManagement(0), 3513 updateByManagement(1), 3514 createByModems(2) 3515 } 3516 MAX-ACCESS read-write 3517 STATUS current 3518 DESCRIPTION 3519 "This object specifies permitted methods of creating 3520 entries in docsIfQosProfileTable. 3521 CreateByManagement(0) is set if entries can be created 3522 using SNMP. UpdateByManagement(1) is set if updating 3523 entries using SNMP is permitted. CreateByModems(2) 3524 is set if entries can be created based on information 3525 in REG-REQ MAC messages received from Cable Modems. 3526 Information in this object is only applicable if 3527 docsIfQosProfileTable is implemented as read-create. 3528 Otherwise, this object is implemented as read-only 3529 and returns CreateByModems(2). 3530 Either CreateByManagement(0) or CreateByModems(1) 3531 must be set when writing to this object. 3532 Note that BITS objects are encoded most significant bit 3533 first. For example, if bit 2 is set, the value of this 3534 object is the octet string '20'H." 3535 ::= { docsIfCmtsObjects 6 } 3537 docsIfCmtsMacToCmTable OBJECT-TYPE 3538 SYNTAX SEQUENCE OF DocsIfCmtsMacToCmEntry 3539 MAX-ACCESS not-accessible 3540 STATUS current 3541 DESCRIPTION 3542 "This is a table to provide a quick access index into the 3543 docsIfCmtsCmStatusTable. There is exactly one row in this 3544 table for each row in the docsIfCmtsCmStatusTable. In 3545 general, the management station should use this table only 3546 to get a pointer into the docsIfCmtsCmStatusTable (which 3547 corresponds to the CM's RF interface MAC address), and 3548 should not iterate (e.g. GetNext through) this table." 3549 ::= { docsIfCmtsObjects 7 } 3551 docsIfCmtsMacToCmEntry OBJECT-TYPE 3552 SYNTAX DocsIfCmtsMacToCmEntry 3553 MAX-ACCESS not-accessible 3554 STATUS current 3555 DESCRIPTION 3556 "A row in the docsIfCmtsMacToCmTable. 3557 An entry in this table exists for each Cable Modem 3558 that is connected to the CMTS implementing this table." 3559 INDEX { docsIfCmtsCmMac } 3560 ::= {docsIfCmtsMacToCmTable 1 } 3562 DocsIfCmtsMacToCmEntry ::= SEQUENCE { 3563 docsIfCmtsCmMac MacAddress, 3564 docsIfCmtsCmPtr Integer32 3565 } 3567 docsIfCmtsCmMac OBJECT-TYPE 3568 SYNTAX MacAddress 3569 MAX-ACCESS not-accessible 3570 STATUS current 3571 DESCRIPTION 3572 "The RF side MAC address for the referenced CM. (E.g. the 3573 interface on the CM that has docsCableMacLayer(127) as 3574 its ifType." 3575 ::= { docsIfCmtsMacToCmEntry 1 } 3577 docsIfCmtsCmPtr OBJECT-TYPE 3578 SYNTAX Integer32 (1..2147483647) 3579 MAX-ACCESS read-only 3580 STATUS current 3581 DESCRIPTION 3582 "An row index into docsIfCmtsCmStatusTable. When queried 3583 with the correct instance value (e.g. a CM's MAC address), 3584 returns the index in docsIfCmtsCmStatusTable which 3585 represents that CM." 3586 ::= { docsIfCmtsMacToCmEntry 2 } 3588 -- 3589 -- notification group is for future extension. 3590 -- 3592 docsIfNotification OBJECT IDENTIFIER ::= { docsIfMib 2 } 3594 docsIfConformance OBJECT IDENTIFIER ::= { docsIfMib 3 } 3595 docsIfCompliances OBJECT IDENTIFIER ::= { docsIfConformance 1 } 3596 docsIfGroups OBJECT IDENTIFIER ::= { docsIfConformance 2 } 3598 -- compliance statements 3600 docsIfBasicCompliance MODULE-COMPLIANCE 3601 STATUS current 3602 DESCRIPTION 3603 "The compliance statement for devices that implement 3604 MCNS/DOCSIS compliant Radio Frequency Interfaces." 3606 MODULE -- docsIfMib 3608 -- unconditionally mandatory groups 3609 MANDATORY-GROUPS { 3610 docsIfBasicGroup 3611 } 3613 -- conditionally mandatory group 3614 GROUP docsIfCmGroup 3615 DESCRIPTION 3616 "This group is implemented only in Cable Modems, not in 3617 Cable Modem Termination Systems." 3618 -- conditionally mandatory group 3619 GROUP docsIfCmtsGroup 3620 DESCRIPTION 3621 "This group is implemented only in Cable Modem Termination 3622 Systems, not in Cable Modems." 3624 OBJECT docsIfDownChannelFrequency 3625 WRITE-SYNTAX Integer32 (47000000..862000000) 3626 MIN-ACCESS read-only 3627 DESCRIPTION 3628 "Read-write in Cable Modem Termination Systems; 3629 read-only in Cable Modems. 3630 A range of 54MHz to 860MHz is appropriate for a cable 3631 plant using a North American Sub-Split channel plan. 3632 The spectrum range has been expanded to accommodate 3633 a lower edge of 47MHz and an upper edge of 862MHz 3634 for some European channel plans. 3635 If DOCSIS is extended to cover other types of channel 3636 plans (and frequency allocations) this object will be 3637 modified accordingly." 3639 OBJECT docsIfDownChannelWidth 3640 WRITE-SYNTAX Integer32 (6000000 | 8000000) 3641 MIN-ACCESS read-only 3642 DESCRIPTION 3643 "It is conformant to implement this object as read-only. 3644 In Cable Modems, this object is always implemented as 3645 read-only. The value of 6 MHz is appropriate for cable 3646 plants running under NTSC (National Television 3647 Standards Committee) standards. The value of 8 MHz is 3648 appropriate for cable plants running under ETSI 3649 standards. For other regional standards, this 3650 object will be modified accordingly." 3652 OBJECT docsIfDownChannelModulation 3653 WRITE-SYNTAX INTEGER { 3654 qam64 (3), 3655 qam256 (4) 3656 } 3657 MIN-ACCESS read-only 3658 DESCRIPTION 3659 "Read-write in Cable Modem Termination Systems; 3660 read-only in Cable Modems." 3662 OBJECT docsIfDownChannelInterleave 3663 WRITE-SYNTAX INTEGER { 3664 taps8Increment16(3), 3665 taps16Increment8(4), 3666 taps32Increment4(5), 3667 taps64Increment2(6), 3668 taps128Increment1(7), 3669 taps12increment17(8) 3670 } 3671 MIN-ACCESS read-only 3672 DESCRIPTION 3673 "Read-write in Cable Modem Termination Systems; 3674 read-only in Cable Modems." 3676 OBJECT docsIfDownChannelPower 3677 MIN-ACCESS read-only 3678 DESCRIPTION 3679 "Read-write in Cable Modem Termination Systems; 3680 read-only in Cable Modems." 3682 OBJECT docsIfUpChannelFrequency 3683 WRITE-SYNTAX Integer32 (5000000..65000000) 3684 MIN-ACCESS read-only 3685 DESCRIPTION 3686 "Read-create in Cable Modem Termination Systems; 3687 read-only in Cable Modems. 3688 A range of 5MHz to 42MHz is appropriate for a cable 3689 plant using a North American Sub-Split channel plan. 3690 The spectrum range has been expanded to accommodate 3691 an upper edge of 65MHz for some European channel plans. 3692 If DOCSIS is extended to cover other types of channel 3693 plans (and frequency allocations) this object will 3694 be modified accordingly." 3696 OBJECT docsIfUpChannelWidth 3697 WRITE-SYNTAX Integer32 (200000..6400000) 3698 MIN-ACCESS read-only 3699 DESCRIPTION 3700 "Read-create in Cable Modem Termination Systems; 3701 read-only in Cable Modems. The above value is appropriate 3702 for cable plants running under NTSC (National Television 3703 Standards Committee) standards. If DOCSIS is extended to 3704 work with other standard (e.g. European standards), this 3705 object will be modified accordingly." 3707 OBJECT docsIfUpChannelModulationProfile 3708 MIN-ACCESS read-only 3709 DESCRIPTION 3710 "Read-create in Cable Modem Termination Systems; 3711 read-only in Cable Modems." 3713 OBJECT docsIfUpChannelSlotSize 3714 MIN-ACCESS read-only 3715 DESCRIPTION 3716 "This object is always read-only in Cable Modems. 3717 It is compliant to implement this object as read-only 3718 in Cable Modem Termination Systems." 3720 OBJECT docsIfUpChannelRangingBackoffStart 3721 MIN-ACCESS read-only 3722 DESCRIPTION 3723 "Read-create in Cable Modem Termination Systems; 3724 read-only in Cable Modems." 3726 OBJECT docsIfUpChannelRangingBackoffEnd 3727 MIN-ACCESS read-only 3728 DESCRIPTION 3729 "Read-create in Cable Modem Termination Systems; 3730 read-only in Cable Modems." 3732 OBJECT docsIfUpChannelTxBackoffStart 3733 MIN-ACCESS read-only 3734 DESCRIPTION 3735 "Read-create in Cable Modem Termination Systems; 3736 read-only in Cable Modems." 3738 OBJECT docsIfUpChannelTxBackoffEnd 3739 MIN-ACCESS read-only 3740 DESCRIPTION 3741 "Read-create in Cable Modem Termination Systems; 3742 read-only in Cable Modems." 3744 OBJECT docsIfUpChannelScdmaActiveCodes 3745 MIN-ACCESS read-only 3746 DESCRIPTION 3747 "This object is always read-only in Cable Modems. The number of active 3748 codes when SCDMA is in use must range from 64 to 128, and must be a non- 3749 Prime value. Providing this range allows for the following features and 3750 capabilities: 3751 1) Power management in S-CDMA spreader-on frames (with a 3 dB spread) 3752 2) Avoidance of code 0 3753 3) Flexible minislot sizes with and without the use of code 0" 3755 OBJECT docsIfUpChannelScdmaCodesPerSlot 3756 MIN-ACCESS read-only 3757 DESCRIPTION 3758 "Read-create in Cable Modem Termination Systems; 3759 read-only in Cable Modems." 3761 OBJECT docsIfUpChannelScdmaFrameSize 3762 MIN-ACCESS read-only 3763 DESCRIPTION 3764 "Read-create in Cable Modem Termination Systems; 3765 read-only in Cable Modems." 3767 OBJECT docsIfUpChannelScdmaHoppingSeed 3768 MIN-ACCESS read-only 3769 DESCRIPTION 3770 "This object is always read-only in Cable Modems." 3772 OBJECT docsIfUpChannelType 3773 MIN-ACCESS read-only 3774 DESCRIPTION 3775 "Read-create in Cable Modem Termination Systems; 3776 read-only in Cable Modems." 3778 OBJECT docsIfUpChannelCloneFrom 3779 MIN-ACCESS read-only 3780 DESCRIPTION 3781 "Read-create in Cable Modem Termination Systems; 3782 read-only in Cable Modems." 3784 OBJECT docsIfUpChannelUpdate 3785 MIN-ACCESS read-only 3786 DESCRIPTION 3787 "Read-create in Cable Modem Termination Systems; 3788 read-only in Cable Modems." 3790 OBJECT docsIfUpChannelStatus 3791 MIN-ACCESS read-only 3792 DESCRIPTION 3793 "Read-create in Cable Modem Termination Systems; 3794 read-only in Cable Modems." 3796 OBJECT docsIfQosProfPriority 3797 MIN-ACCESS read-only 3798 DESCRIPTION 3799 "This object is always read-only in Cable Modems. 3800 It is compliant to implement this object as read-only 3801 in Cable Modem Termination Systems." 3803 OBJECT docsIfQosProfMaxUpBandwidth 3804 MIN-ACCESS read-only 3805 DESCRIPTION 3806 "This object is always read-only in Cable Modems. 3807 It is compliant to implement this object as read-only 3808 in Cable Modem Termination Systems." 3810 OBJECT docsIfQosProfGuarUpBandwidth 3811 MIN-ACCESS read-only 3812 DESCRIPTION 3813 "This object is always read-only in Cable Modems. 3814 It is compliant to implement this object as read-only 3815 in Cable Modem Termination Systems." 3817 OBJECT docsIfQosProfMaxDownBandwidth 3818 MIN-ACCESS read-only 3819 DESCRIPTION 3820 "This object is always read-only in Cable Modems. 3821 It is compliant to implement this object as read-only 3822 in Cable Modem Termination Systems." 3824 OBJECT docsIfQosProfBaselinePrivacy 3825 MIN-ACCESS read-only 3826 DESCRIPTION 3827 "This object is always read-only in Cable Modems. 3828 It is compliant to implement this object as read-only 3829 in Cable Modem Termination Systems." 3831 OBJECT docsIfQosProfStatus 3832 MIN-ACCESS read-only 3833 DESCRIPTION 3834 "This object is always read-only in Cable Modems. 3835 It is compliant to implement this object as read-only 3836 in Cable Modem Termination Systems." 3838 OBJECT docsIfQosProfMaxTransmitBurst 3839 MIN-ACCESS read-only 3840 DESCRIPTION 3841 "This object is always read-only in Cable Modems. 3842 It is compliant to implement this object as read-only 3843 in Cable Modem Termination Systems." 3845 OBJECT docsIfCmtsServiceAdminStatus 3846 MIN-ACCESS read-only 3847 DESCRIPTION 3848 "It is compliant to implement this object as read-only." 3850 OBJECT docsIfCmtsSyncInterval 3851 MIN-ACCESS read-only 3852 DESCRIPTION 3853 "It is compliant to implement this object as read-only." 3855 OBJECT docsIfCmtsUcdInterval 3856 MIN-ACCESS read-only 3857 DESCRIPTION 3858 "It is compliant to implement this object as read-only." 3860 OBJECT docsIfCmtsInsertInterval 3861 MIN-ACCESS read-only 3862 DESCRIPTION 3863 "It is compliant to implement this object as read-only." 3865 OBJECT docsIfCmtsInvitedRangingAttempts 3866 MIN-ACCESS read-only 3867 DESCRIPTION 3868 "It is compliant to implement this object as read-only." 3870 OBJECT docsIfCmtsQosProfilePermissions 3871 MIN-ACCESS read-only 3872 DESCRIPTION 3873 "It is compliant to implement this object as read-only." 3875 ::= { docsIfCompliances 1 } 3877 docsIfBasicGroup OBJECT-GROUP 3878 OBJECTS { 3879 docsIfDownChannelId, 3880 docsIfDownChannelFrequency, 3881 docsIfDownChannelWidth, 3882 docsIfDownChannelModulation, 3883 docsIfDownChannelInterleave, 3884 docsIfDownChannelPower, 3885 docsIfDownChannelAnnex, 3886 docsIfUpChannelId, 3887 docsIfUpChannelFrequency, 3888 docsIfUpChannelWidth, 3889 docsIfUpChannelModulationProfile, 3890 docsIfUpChannelSlotSize, 3891 docsIfUpChannelTxTimingOffset, 3892 docsIfUpChannelRangingBackoffStart, 3893 docsIfUpChannelRangingBackoffEnd, 3894 docsIfUpChannelTxBackoffStart, 3895 docsIfUpChannelTxBackoffEnd, 3896 docsIfUpChannelScdmaActiveCodes, 3897 docsIfUpChannelScdmaCodesPerSlot, 3898 docsIfUpChannelScdmaFrameSize, 3899 docsIfUpChannelScdmaHoppingSeed, 3900 docsIfUpChannelType, 3901 docsIfUpChannelCloneFrom, 3902 docsIfUpChannelUpdate, 3903 docsIfUpChannelStatus, 3904 docsIfQosProfPriority, 3905 docsIfQosProfMaxUpBandwidth, 3906 docsIfQosProfGuarUpBandwidth, 3907 docsIfQosProfMaxDownBandwidth, 3908 docsIfQosProfBaselinePrivacy, 3909 docsIfQosProfStatus, 3910 docsIfQosProfMaxTransmitBurst, 3911 docsIfSigQIncludesContention, 3912 docsIfSigQUnerroreds, 3913 docsIfSigQCorrecteds, 3914 docsIfSigQUncorrectables, 3915 docsIfSigQSignalNoise, 3916 docsIfSigQMicroreflections, 3917 docsIfSigQEqualizationData, 3918 docsIfDocsisBaseCapability 3919 } 3920 STATUS current 3921 DESCRIPTION 3922 "Group of objects implemented in both Cable Modems and 3923 Cable Modem Termination Systems." 3924 ::= { docsIfGroups 1 } 3926 docsIfCmGroup OBJECT-GROUP 3927 OBJECTS { 3928 docsIfCmCmtsAddress, 3929 docsIfCmCapabilities, 3930 docsIfCmRangingTimeout, 3931 -- docsIfCmRangingRespTimeout, 3932 docsIfCmStatusValue, 3933 docsIfCmStatusCode, 3934 docsIfCmStatusTxPower, 3935 docsIfCmStatusResets, 3936 docsIfCmStatusLostSyncs, 3937 docsIfCmStatusInvalidMaps, 3938 docsIfCmStatusInvalidUcds, 3939 docsIfCmStatusInvalidRangingResponses, 3940 docsIfCmStatusInvalidRegistrationResponses, 3941 docsIfCmStatusT1Timeouts, 3942 docsIfCmStatusT2Timeouts, 3943 docsIfCmStatusT3Timeouts, 3944 docsIfCmStatusT4Timeouts, 3945 docsIfCmStatusRangingAborteds, 3946 docsIfCmStatusDocsisOperMode, 3947 docsIfCmStatusModulationType, 3948 docsIfCmServiceQosProfile, 3949 docsIfCmServiceTxSlotsImmed, 3950 docsIfCmServiceTxSlotsDed, 3951 docsIfCmServiceTxRetries, 3952 docsIfCmServiceTxExceededs, 3953 docsIfCmServiceRqRetries, 3954 docsIfCmServiceRqExceededs, 3955 docsIfCmServiceExtTxSlotsImmed, 3956 docsIfCmServiceExtTxSlotsDed 3958 } 3959 STATUS current 3960 DESCRIPTION 3961 "Group of objects implemented in Cable Modems." 3962 ::= { docsIfGroups 2 } 3964 docsIfCmtsGroup OBJECT-GROUP 3965 OBJECTS { 3966 docsIfCmtsCapabilities, 3967 docsIfCmtsSyncInterval, 3968 docsIfCmtsUcdInterval, 3969 docsIfCmtsMaxServiceIds, 3970 -- docsIfCmtsInsertionInterval, 3971 docsIfCmtsInvitedRangingAttempts, 3972 docsIfCmtsInsertInterval, 3973 docsIfCmtsStatusInvalidRangeReqs, 3974 docsIfCmtsStatusRangingAborteds, 3975 docsIfCmtsStatusInvalidRegReqs, 3976 docsIfCmtsStatusFailedRegReqs, 3977 docsIfCmtsStatusInvalidDataReqs, 3978 docsIfCmtsStatusT5Timeouts, 3979 docsIfCmtsCmStatusMacAddress, 3980 docsIfCmtsCmStatusDownChannelIfIndex, 3981 docsIfCmtsCmStatusUpChannelIfIndex, 3982 docsIfCmtsCmStatusRxPower, 3983 docsIfCmtsCmStatusTimingOffset, 3984 docsIfCmtsCmStatusEqualizationData, 3985 docsIfCmtsCmStatusValue, 3986 docsIfCmtsCmStatusUnerroreds, 3987 docsIfCmtsCmStatusCorrecteds, 3988 docsIfCmtsCmStatusUncorrectables, 3989 docsIfCmtsCmStatusSignalNoise, 3990 docsIfCmtsCmStatusMicroreflections, 3991 docsIfCmtsCmStatusExtUnerroreds, 3992 docsIfCmtsCmStatusExtCorrecteds, 3993 docsIfCmtsCmStatusExtUncorrectables, 3994 docsIfCmtsCmStatusDocsisRegMode, 3995 docsIfCmtsCmStatusModulationType, 3996 docsIfCmtsCmStatusInetAddressType, 3997 docsIfCmtsCmStatusInetAddress, 3998 docsIfCmtsServiceAdminStatus, 3999 docsIfCmtsServiceQosProfile, 4000 docsIfCmtsServiceCreateTime, 4001 docsIfCmtsServiceInOctets, 4002 docsIfCmtsServiceInPackets, 4003 docsIfCmtsServiceNewCmStatusIndex, 4004 docsIfCmtsModType, 4005 docsIfCmtsModControl, 4006 docsIfCmtsModPreambleLen, 4007 docsIfCmtsModDifferentialEncoding, 4008 docsIfCmtsModFECErrorCorrection, 4009 docsIfCmtsModFECCodewordLength, 4010 docsIfCmtsModScramblerSeed, 4011 docsIfCmtsModMaxBurstSize, 4012 docsIfCmtsModGuardTimeSize, 4013 docsIfCmtsModLastCodewordShortened, 4014 docsIfCmtsModScrambler, 4015 docsIfCmtsModByteInterleaverDepth, 4016 docsIfCmtsModByteInterleaverBlockSize, 4017 docsIfCmtsModPreambleType, 4018 docsIfCmtsModTcmErrorCorrectionOn, 4019 docsIfCmtsModScdmaInterleaverStepSize, 4020 docsIfCmtsModScdmaSpreaderEnable, 4021 docsIfCmtsModScdmaSubframeCodes, 4022 docsIfCmtsModChannelType, 4023 docsIfCmtsQosProfilePermissions, 4024 docsIfCmtsCmPtr 4025 } 4026 STATUS current 4027 DESCRIPTION 4028 "Group of objects implemented in Cable Modem Termination 4029 Systems." 4030 ::= { docsIfGroups 3 } 4032 docsIfObsoleteGroup OBJECT-GROUP 4033 OBJECTS { 4034 docsIfCmRangingRespTimeout, 4035 docsIfCmtsInsertionInterval 4036 } 4037 STATUS obsolete 4038 DESCRIPTION 4039 "Group of objects obsoleted." 4040 ::= { docsIfGroups 4 } 4042 docsIfDeprecatedGroup OBJECT-GROUP 4043 OBJECTS { 4044 docsIfQosProfMaxTxBurst, 4045 docsIfCmtsCmStatusIpAddress, 4046 docsIfCmtsServiceCmStatusIndex 4047 } 4048 STATUS deprecated 4049 DESCRIPTION 4050 "Group of objects deprecated." 4051 ::= { docsIfGroups 5 } 4053 END 4054 5. Acknowledgments 4055 This document is a production of the Docsis 2.0 OSS Working Group. 4056 It is a revision based on RFC2670, "Radio Frequency (RF) Interface 4057 Management Information Base for DOCSIS compliant RF interfaces" [22]. 4059 The current editors wish to express gratitude to Rich Prodan, Greg 4060 Nakanishi, Rich Woundy, Eduardo Cardona, and Adi Shaliv for their 4061 valued advice and opinions. 4063 6. Revision History 4065 6.1. Scope 4067 This MIB in this document has been developed to accommodate DOCSIS 2.0 devices 4068 and their system capabilities. The MIB is an update to RFC2670 with the 4069 additional incorporation of EuroDocsis specific items and the DOCS_IF_EXT mib. 4071 6.2. Extension 4073 We have maintained the MIB objects as defined in RFC 2670. In some cases new mib 4074 objects have been created with identical functionality but greater capacity (ie 4075 32 to 64 bits). In these situations, both the original 32 bit objects and the new 4076 64 bit objects must be implemented. 4078 7. References 4080 [1] Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for 4081 Describing SNMP Management Frameworks", RFC 2571, April 1999. 4083 [2] Rose, M. and K. McCloghrie, "Structure and Identification of 4084 Management Information for TCP/IP-based Internets", STD 16, RFC 4085 1155, May 1990. 4087 [3] Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16, 4088 RFC 1212, March 1991. 4090 [4] Rose, M., "A Convention for Defining Traps for use with the 4091 SNMP", RFC 1215, March 1991. 4093 [5] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Structure of 4094 Management Information for Version 2 (SMIv2)", STD 58, RFC 2578, 4095 April 1999. 4097 [6] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Textual 4098 Conventions for SMIv2", STD 58, RFC 2579, April 1999. 4100 [7] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Conformance 4101 Statements for SMIv2", STD 58, RFC 2580, April 1999. 4103 [8] Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple 4104 Management Protocol", STD 15, RFC 1157, May 1990. 4106 [9] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, 4107 "Introduction to Community-based SNMPv2", RFC 1901, January 4108 1996. 4110 [10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Transport 4111 Mappings for Version 2 of the Simple Network Management Protocol 4112 (SNMPv2)", RFC 1906, January 1996. 4114 [11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message 4115 Processing and Dispatching for the Simple Network Management 4116 Protocol (SNMP)", RFC 2572, April 1999. 4118 [12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM) 4119 for version 3 of the Simple Network Management Protocol 4120 (SNMPv3)", RFC 2574, April 1999. 4122 [13] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Protocol 4123 Operations for Version 2 of the Simple Network Management 4124 Protocol (SNMPv2)", RFC 1905, January 1996. 4126 [14] Levi, D., Meyer, P. and B. Stewart, "SNMP Applications", RFC 4127 2573, April 1999. 4129 [15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access 4130 Control Model (VACM) for the Simple Network Management Protocol 4131 (SNMP)", RFC 2575, April 1999. 4133 [16] "Data-Over-Cable Service Interface Specifications: Cable 4134 Modem Radio Frequency Interface Specification SP-RFI-I05-991105", 4135 DOCSIS, November 1999, http://www.cablemodem.com/. 4137 [17] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB 4138 using SMIv2", RFC 2863, June 2000. 4140 [18] StJohns, M. , "Cable Device Management Information Base for 4141 DOCSIS Compliant Cable Modems and Cable Modem Termination 4142 Systems", RFC2669, August 1999. 4144 [19] Proakis, John G., "Digital Communications, 3rd Edition", 4145 McGraw-Hill, New York, New York, 1995, ISBN 0-07-051726-6 4147 [20] "Transmission Systems for Interactive Cable Television Services, 4148 Annex B", J.112, International Telecommunications Union, March 4149 1998. 4151 [21] Case, J., Mundy, R., Partain, D., and B. Stewart, 4152 "Introduction to Version 3 of the Internet-standard Network Management 4153 Framework", RFC 2570, April 1999. 4155 [22] StJohns, M., "Radio Frequency (RF) Interface Management 4156 Information Base for MCNS/DOCSIS compliant RF interfaces", 4157 RFC 2670, August 1999. 4159 [23] "Data-Over-Cable Service Interface Specifications: Cable 4160 Modem Radio Frequency Interface Specification SP-RFIv1.1-I06- 4161 001215", DOCSIS, December 2000, http://www.cablemodem.com/. 4163 [24] "Document for the certification of EuroDOCSIS CMs and CMTSs, 4164 Version 3.3", EuroDOCSIS, February 2000. 4166 [25] "Data-Over-Cable Service Interface Specifications: Radio Frequency 4167 Interface Specification SP-RFIv2.0-W04-011119", DOCSIS 2.0 4168 November 2001. 4170 [26] "Data-Over-Cable Service Interface Specifications: Operations 4171 Support System Interface Specification SP-OSSIv2.0-W01-011119", 4172 DOCSIS 2.0 November 2001. 4174 [27] Woundy, R., "Baseline Privacy Interface Management 4175 Information Base for DOCSIS Compliant Cable Modems 4176 and Cable Modem Termination Systems", RFC3083, March 2001. 4178 [28] "Adapted MIB-definitions and a clarification for MPEG-related 4179 issues for EuroDOCSIS cable modem systems v1.01", tComLabs, 4180 May 2000. 4182 8. Security Considerations 4184 This MIB relates to a system which will provide metropolitan public 4185 internet access. As such, improper manipulation of the objects 4186 represented by this MIB may result in denial of service to a large 4187 number of end-users. In addition, manipulation of the 4188 docsIfCmServiceQosProfile, docsIfCmtsServerQosProfile, and the 4189 elements of docsIfQosProfileTable and docsIfCmtsModulationTable may 4190 allow an end-user to improve their service response or diminish other 4191 subscriber's service response. 4193 There are a number of management objects defined in this MIB that 4194 have a MAX-ACCESS clause of read-write and/or read-create. Such 4195 objects may be considered sensitive or vulnerable in some network 4196 environments. The support for SET operations in a non-secure 4197 environment without proper protection can have a negative effect on 4198 network operations. 4200 SNMPv1 by itself is not a secure environment. Even if the network 4201 itself is secure (for example by using IPSec), even then, there is no 4202 control as to who on the secure network is allowed to access and 4203 GET/SET (read/change/create/delete) the objects in this MIB. 4205 It is recommended that the implementers consider the security 4206 features as provided by the SNMPv3 framework. Specifically, the use 4207 of the User-based Security Model RFC 2574 [12] and the View- based 4208 Access Control Model RFC 2575 [15] is recommended. 4210 It is then a customer/user responsibility to ensure that the SNMP 4211 entity giving access to an instance of this MIB, is properly 4212 configured to give access to the objects only to those principals 4213 (users) that have legitimate rights to indeed GET or SET 4214 (change/create/delete) them. 4216 9. Changes from RFC2670 4218 Upstream now separated into 'physical interfaces' and 'logical channels'. An 4219 instance of the docsIfUpstreamChannelTable exists for each 'logical channel'. 4220 The IANA ifType for 'logical channels' is 205. The IANA ifType for 'physical 4221 interfaces' remains at 129. 4223 Object docsIfDownChannelAnnex added to docsIfDownstreamChannelTable. This object 4224 originated in the EuroDocsis specifications. 4226 Eight new objects added to the docsIfUpstreamChannelTable. One describes the 4227 channel type in use, while four are specific S-CDMA parameters. The remaining 4228 three additions are used in the creation of a temporary inactive upstream row 4229 so the S-CDMA parameters may be manipulated 'offline'. 4231 Object docsIfQosProfMaxTransmitBurst has been added to the docsIfQosProfileTable 4232 to replace deprecated object docsIfQosProfMaxTxBurst. This fixes a range error 4233 caused by switch to recording as bytes instead of minislots. 4235 A new base object docsIfDocsisBaseCapability has been added which mirrors the 4236 functionality of the docsifExt mib object docsIfDocsisCapability, extended to 4237 include Docsis 2.0. 4239 Two new objects added to the docsIfCmStatusTable. One indicates the current 4240 modulation type. The other mirrors the functionality of the docsIfExt object 4241 docsIfDocsisOperMode, while clarifying that it applies to the COS/QOS mode 4242 used by the device. 4244 Two new 64 bit counters added to the docsIfCmServiceTable to extend the capacity 4245 of existing 32 bit counters. 4247 Seven new objects added to the docsIfCmtsCmStatusTable. Three are 64 bit 4248 counters, two add ipv6 capability, and one indicates the CM modulation type 4249 in use. The remaining object mirrors the functionality of the docsIfExt object 4250 docsIfCmtsCmStatusDocsisMode, while clarifying that it applies to the COS/QOS 4251 mode used by the device. 4253 One object added to the docsIfCmtsServiceTable to fix a range error in an 4254 existing object, that has been deprecated. 4256 Eight new objects added to the docsIfCmtsModulationTable. Seven of these 4257 describe ATDMA/S-CDMA channel parameters, while the other describes modulation 4258 attributes common to all modulation types. 4260 Enumerated values for object docsIfDownChannelInterleave have been expanded to 4261 include a EuroDocsis value. 4263 Enumerated values for object docsIfCmtsModIntervalUsageCode have been expanded 4264 to include new Docsis 2.0 values. 4266 Enumerated values for object docsIfCmtsModType have been expanded to include new 4267 Docsis 2.0 values. 4269 Compliance statements have been updated to reflect new objects and to describe 4270 EuroDocsis specific implementation features. 4272 The descriptions of objects docsIfCmtsStatusInvalidRegReqs and 4273 docsIfCmtsStatusFailedRegReqs have been clarified. 4275 10. Conflict Resolution with docsIfExt MIB 4277 The docsIfExt MIB originated as an engineering change notification (ECN) to the 4278 Docsis 1.1 specifications, and consisted of three objects - two for CM 4279 implementation and one for the CMTS. These three objects have been incorporated 4280 into this new version of the RF MIB, and have been assigned new object 4281 identifiers. 4283 It is the intention of the authors to deprecate the docsIfExt MIB. Due to 4284 backward compatibility concerns with Docsis 1.1 implementations, both the new RF 4285 MIB objects and the former docsIfExt MIB objects will be required for Docsis 2.0 4286 designs for the immediate future. An influencing factor in this decision is that 4287 the docsCableDeviceTrap MIB (from the same design update as the docsIfExt MIB) 4288 contains references to docsIfExt MIB objects in various trap definitions. 4290 The following process will be used to accomplish the eventual deprecation of the 4291 docsIfExt MIB: 4293 1) Create a Docsis ECN that will require Docsis 1.1 implementations to 4294 support the new location of the three docsIfExt objects in the RF MIB. 4296 2) The same ECN will update the docsCableDeviceTrap MIB to reference the 4297 new location of the three docsIfExt objects, and deprecate the former 4298 references. 4300 3) The same ECN will deprecate the docsIfExt MIB. 4302 Following these steps, the state of affairs will be: 4303 a) Docsis 1.1 MUST support new RF MIB docsIfExt objects. 4304 b) Docsis 1.1 MAY support remaining RF MIB 2.0 objects. 4305 c) Docsis 1.1 MAY support former docsIfExt MIB objects. 4306 d) Docsis 2.0 MUST support all new RF MIB objects. 4307 e) Docsis 2.0 MAY support former docsIfExt MIB objects. 4309 11. Intellectual Property 4311 The IETF takes no position regarding the validity or scope of any 4312 intellectual property or other rights that might be claimed to 4313 pertain to the implementation or use of the technology described in 4314 this document or the extent to which any license under such rights 4315 might or might not be available; neither does it represent that it 4316 has made any effort to identify any such rights. Information on the 4317 IETF's procedures with respect to rights in standards-track and 4318 standards-related documentation can be found in BCP-11. Copies of 4319 claims of rights made available for publication and any assurances of 4320 licenses to be made available, or the result of an attempt made to 4321 obtain a general license or permission for the use of such 4322 proprietary rights by implementers or users of this specification can 4323 be obtained from the IETF Secretariat. 4325 The IETF invites any interested party to bring to its attention any 4326 copyrights, patents or patent applications, or other proprietary 4327 rights that may cover technology that may be required to practice 4328 this standard. Please address the information to the IETF Executive 4329 Director. 4331 12. Authors' Addresses 4333 Aviv Goren 4334 Terayon 4335 2952 Bunker Hill Lane 4336 Santa Clara, CA 4337 U.S.A. 4338 Phone: +1 408 727 4400 4339 E-mail: aviv.goren@terayon.com 4341 David Raftus 4342 Imedia Semiconductor 4343 340 Terry Fox Drive, Suite 202 4344 Ottawa Ontario 4345 Canada 4346 Phone: +1 613 592 1052 4347 E-mail: david.raftus@imedia.com 4349 13. Full Copyright Statement 4351 Copyright (C) The Internet Society (2002). All Rights Reserved. 4353 This document and translations of it may be copied and furnished to 4354 others, and derivative works that comment on or otherwise explain it 4355 or assist in its implementation may be prepared, copied, published 4356 and distributed, in whole or in part, without restriction of any 4357 kind, provided that the above copyright notice and this paragraph are 4358 included on all such copies and derivative works. However, this 4359 document itself may not be modified in any way, such as by removing 4360 the copyright notice or references to the Internet Society or other 4361 Internet organizations, except as needed for the purpose of 4362 developing Internet standards in which case the procedures for 4363 copyrights defined in the Internet Standards process must be 4364 followed, or as required to translate it into languages other than 4365 English. 4367 The limited permissions granted above are perpetual and will not be 4368 revoked by the Internet Society or its successors or assigns. 4370 This document and the information contained herein is provided on an 4371 "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 4372 TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 4373 BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 4374 HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 4375 MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 4377 Acknowledgement 4379 Funding for the RFC Editor function is currently provided by the 4380 Internet Society.