idnits 2.17.1 draft-ietf-ipcdn-docs-rfmibv2-03.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 1 longer page, the longest (page 1) being 59 lines Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The document seems to lack an IANA Considerations section. (See Section 2.2 of https://www.ietf.org/id-info/checklist for how to handle the case when there are no actions for IANA.) ** The document seems to lack separate sections for Informative/Normative References. All references will be assumed normative when checking for downward references. ** There are 654 instances of too long lines in the document, the longest one being 152 characters in excess of 72. ** There is 1 instance 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 is 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 1519: '...alues from 64..128 MUST be non-prime."...' RFC 2119 keyword, line 1721: '... MUST NOT be changed w...' RFC 2119 keyword, line 1735: '... 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 (March 2002) is 8078 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) == Unused Reference: '16' is defined on line 4129, but no explicit reference was found in the text == Unused Reference: '18' is defined on line 4136, but no explicit reference was found in the text == Unused Reference: '23' is defined on line 4155, but no explicit reference was found in the text == Unused Reference: '24' is defined on line 4159, but no explicit reference was found in the text == Unused Reference: '27' is defined on line 4170, but no explicit reference was found in the text ** Obsolete normative reference: RFC 2571 (ref. '1') (Obsoleted by RFC 3411) ** Downref: Normative reference to an Informational RFC: RFC 1215 (ref. '4') ** Downref: Normative reference to an Historic RFC: RFC 1157 (ref. '8') ** Downref: Normative reference to an Historic RFC: RFC 1901 (ref. '9') ** Obsolete normative reference: RFC 1906 (ref. '10') (Obsoleted by RFC 3417) ** Obsolete normative reference: RFC 2572 (ref. '11') (Obsoleted by RFC 3412) ** Obsolete normative reference: RFC 2574 (ref. '12') (Obsoleted by RFC 3414) ** Obsolete normative reference: RFC 1905 (ref. '13') (Obsoleted by RFC 3416) ** Obsolete normative reference: RFC 2573 (ref. '14') (Obsoleted by RFC 3413) ** Obsolete normative reference: RFC 2575 (ref. '15') (Obsoleted by RFC 3415) -- Possible downref: Non-RFC (?) normative reference: ref. '16' ** Obsolete normative reference: RFC 2669 (ref. '18') (Obsoleted by RFC 4639) -- Possible downref: Non-RFC (?) normative reference: ref. '19' -- Possible downref: Non-RFC (?) normative reference: ref. '20' ** Obsolete normative reference: RFC 2570 (ref. '21') (Obsoleted by RFC 3410) ** Obsolete normative reference: RFC 2670 (ref. '22') (Obsoleted by RFC 4546) -- Possible downref: Non-RFC (?) normative reference: ref. '23' -- Possible downref: Non-RFC (?) normative reference: ref. '24' -- Possible downref: Non-RFC (?) normative reference: ref. '25' -- Possible downref: Non-RFC (?) normative reference: ref. '26' ** Downref: Normative reference to an Informational RFC: RFC 3083 (ref. '27') -- Possible downref: Non-RFC (?) normative reference: ref. '28' Summary: 21 errors (**), 0 flaws (~~), 15 warnings (==), 10 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-03.txt Terayon/Imedia 4 Expires: September 2002 March 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 "0203170000Z" -- March 17, 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 "0203170000Z" 1024 DESCRIPTION 1025 "Modified by David Raftus to add new textual convention 1026 describing upstream modulation status. Also clarified 1027 some object descriptions, fixed error in 1028 docsIfSignalQualityEntry, fixed upstreamTable compliance 1029 statements." 1030 REVISION "0202070000Z" 1031 DESCRIPTION 1032 "Modified by David Raftus to add capability to adjust 1033 and verify upstream channel parameters as a group. 1034 Also adjusted syntax and clarified descriptions of 1035 selected objects. " 1036 REVISION "0111200000Z" 1037 DESCRIPTION 1038 "Modified by Aviv Goren and David Raftus to accommodate 1039 Docsis 2.0 Advanced Phy capabilities, as well as to 1040 incorporate objects from the docsIfExt mib. " 1041 REVISION "0102230000Z" 1042 DESCRIPTION 1043 "Modified by Rich Woundy to use IPv6-friendly 1044 address objects, to accommodate EuroDOCSIS, and 1045 to correct the SYNTAX of various objects." 1046 REVISION "9908190000Z" 1047 DESCRIPTION 1048 "Initial Version, published as RFC 2670. 1049 Modified by Mike StJohns to fix problems identified by 1050 the first pass of the MIB doctor. Of special note, 1051 docsIfRangingResp and docsIfCmtsInsertionInterval were 1052 obsoleted and replaced by other objects with the same 1053 functionality, but more appropriate SYNTAX." 1054 ::= { transmission 127 } 1056 -- Textual Conventions 1058 TenthdBmV ::= TEXTUAL-CONVENTION 1059 DISPLAY-HINT "d-1" 1060 STATUS current 1061 DESCRIPTION 1062 "This data type represents power levels that are normally 1063 expressed in dBmV. Units are in tenths of a dBmV; 1064 for example, 5.1 dBmV will be represented as 51." 1065 SYNTAX Integer32 1067 TenthdB ::= TEXTUAL-CONVENTION 1068 DISPLAY-HINT "d-1" 1069 STATUS current 1070 DESCRIPTION 1071 "This data type represents power levels that are normally 1072 expressed in dB. Units are in tenths of a dB; 1073 for example, 5.1 dB will be represented as 51." 1074 SYNTAX Integer32 1076 DocsisVersion ::= TEXTUAL-CONVENTION 1077 STATUS current 1078 DESCRIPTION "Indicates the DOCSIS version number." 1079 SYNTAX INTEGER { 1080 docsis10 (1), 1081 docsis11 (2), 1082 docsis20 (3) 1083 } 1085 DocsisQosVersion ::= TEXTUAL-CONVENTION 1086 STATUS current 1087 DESCRIPTION "Indicates the quality of service level." 1088 SYNTAX INTEGER { 1089 docsis10 (1), 1090 docsis11 (2) 1091 } 1093 DocsisUpstreamType ::= TEXTUAL-CONVENTION 1094 STATUS current 1095 DESCRIPTION "Indicates the DOCSIS Upstream Channel Type." 1096 SYNTAX INTEGER { 1097 tdma (1), 1098 atdma (2), 1099 scdma (3), 1100 tdmaAndAtdma (4) 1101 } 1103 DocsisUpstreamTypeStatus ::= TEXTUAL-CONVENTION 1104 STATUS current 1105 DESCRIPTION "Indicates the DOCSIS Upstream Channel Type Status. 1106 The shared channel indicator type is not valid, since 1107 this type is used to specifically identify PHY mode." 1108 SYNTAX INTEGER { 1109 tdma (1), 1110 atdma (2), 1111 scdma (3) 1112 } 1114 docsIfMibObjects OBJECT IDENTIFIER ::= { docsIfMib 1 } 1115 docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 } 1116 docsIfCmObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 2 } 1117 docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 } 1119 -- 1120 -- BASE GROUP 1121 -- 1123 -- 1124 -- The following table is implemented on both the Cable Modem (CM) 1125 -- and the Cable Modem Termination System (CMTS). This table is 1126 -- read only for the CM. 1127 -- 1129 docsIfDownstreamChannelTable OBJECT-TYPE 1130 SYNTAX SEQUENCE OF DocsIfDownstreamChannelEntry 1131 MAX-ACCESS not-accessible 1132 STATUS current 1133 DESCRIPTION 1134 "This table describes the attributes of downstream 1135 channels (frequency bands)." 1136 REFERENCE 1137 "Document [25] from References, Table 6-12 and Table 6-13." 1138 ::= { docsIfBaseObjects 1 } 1140 docsIfDownstreamChannelEntry OBJECT-TYPE 1141 SYNTAX DocsIfDownstreamChannelEntry 1142 MAX-ACCESS not-accessible 1143 STATUS current 1144 DESCRIPTION 1145 "An entry provides a list of attributes for a single 1146 Downstream channel. 1147 An entry in this table exists for each ifEntry with an 1148 ifType of docsCableDownstream(128)." 1149 INDEX { ifIndex } 1150 ::= { docsIfDownstreamChannelTable 1 } 1152 DocsIfDownstreamChannelEntry ::= SEQUENCE { 1153 docsIfDownChannelId Integer32, 1154 docsIfDownChannelFrequency Integer32, 1155 docsIfDownChannelWidth Integer32, 1156 docsIfDownChannelModulation INTEGER, 1157 docsIfDownChannelInterleave INTEGER, 1158 docsIfDownChannelPower TenthdBmV, 1159 docsIfDownChannelAnnex INTEGER 1160 } 1162 docsIfDownChannelId OBJECT-TYPE 1163 SYNTAX Integer32 (0..255) 1164 MAX-ACCESS read-only 1165 STATUS current 1166 DESCRIPTION 1167 "The Cable Modem Termination System (CMTS) identification 1168 of the downstream channel within this particular MAC 1169 interface. If the interface is down, the object returns 1170 the most current value. If the downstream channel ID is 1171 unknown, this object returns a value of 0." 1172 ::= { docsIfDownstreamChannelEntry 1 } 1174 docsIfDownChannelFrequency OBJECT-TYPE 1175 SYNTAX Integer32 (0..1000000000) 1176 UNITS "hertz" 1177 MAX-ACCESS read-write 1178 STATUS current 1179 DESCRIPTION 1180 "The center of the downstream frequency associated with 1181 this channel. This object will return the current tuner 1182 frequency. If a CMTS provides IF output, this object 1183 will return 0, unless this CMTS is in control of the 1184 final downstream RF frequency. See the associated 1185 compliance object for a description of valid frequencies 1186 that may be written to this object." 1187 REFERENCE 1188 "Document [25] from References, Tables 4-1, 6-14." 1189 ::= { docsIfDownstreamChannelEntry 2 } 1191 docsIfDownChannelWidth OBJECT-TYPE 1192 SYNTAX Integer32 (0..16000000) 1193 UNITS "hertz" 1194 MAX-ACCESS read-write 1195 STATUS current 1196 DESCRIPTION 1197 "The bandwidth of this downstream channel. Most 1198 implementations are expected to support a channel width 1199 of 6 MHz (North America) and/or 8 MHz (Europe). See the 1200 associated compliance object for a description of the 1201 valid channel widths for this object." 1202 REFERENCE 1203 "Document [25] from References, Table 6-14." 1204 ::= { docsIfDownstreamChannelEntry 3 } 1206 docsIfDownChannelModulation OBJECT-TYPE 1207 SYNTAX INTEGER { 1208 unknown(1), 1209 other(2), 1210 qam64(3), 1211 qam256(4) 1212 } 1213 MAX-ACCESS read-write 1214 STATUS current 1215 DESCRIPTION 1216 "The modulation type associated with this downstream 1217 channel. If the interface is down, this object either 1218 returns the configured value (CMTS), the most current 1219 value (CM), or the value of unknown(1). See the 1220 associated conformance object for write conditions and 1221 limitations. See the reference for specifics on the 1222 modulation profiles implied by qam64 and qam256." 1223 REFERENCE 1224 "Document [25] from References, Table 6-14." 1225 ::= { docsIfDownstreamChannelEntry 4 } 1227 docsIfDownChannelInterleave OBJECT-TYPE 1228 SYNTAX INTEGER { 1229 unknown(1), 1230 other(2), 1231 taps8Increment16(3), 1232 taps16Increment8(4), 1233 taps32Increment4(5), 1234 taps64Increment2(6), 1235 taps128Increment1(7), 1236 taps12increment17(8) 1237 } 1238 MAX-ACCESS read-write 1239 STATUS current 1240 DESCRIPTION 1241 "The Forward Error Correction (FEC) interleaving used 1242 for this downstream channel. 1243 Values are defined as follows: 1244 taps8Increment16(3): protection 5.9/4.1 usec, 1245 latency .22/.15 msec 1246 taps16Increment8(4): protection 12/8.2 usec, 1247 latency .48/.33 msec 1248 taps32Increment4(5): protection 24/16 usec, 1249 latency .98/.68 msec 1250 taps64Increment2(6): protection 47/33 usec, 1251 latency 2/1.4 msec 1252 taps128Increment1(7): protection 95/66 usec, 1253 latency 4/2.8 msec 1254 taps12increment17(8): protection 18/14 usec, 1255 latency 0.43/0.32 msec 1256 taps12increment17 is implemented in 1257 conformance with EuroDOCSIS document 1258 'Adapted MIB-definitions - and a 1259 clarification for MPEG-related issues - for 1260 EuroDOCSIS cable modem systems' by tComLabs 1261 and should only be used for a EuroDOCSIS MAC 1262 interface. 1264 If the interface is down, this object either returns 1265 the configured value (CMTS), the most current value (CM), 1266 or the value of unknown(1). 1267 The value of other(2) is returned if the interleave 1268 is known but not defined in the above list. 1269 See the associated conformance object for write 1270 conditions and limitations. See the reference for the FEC 1271 configuration described by the setting of this object." 1272 REFERENCE 1273 "Document [25] from References, Table 6-13." 1274 ::= { docsIfDownstreamChannelEntry 5 } 1276 docsIfDownChannelPower OBJECT-TYPE 1277 SYNTAX TenthdBmV 1278 UNITS "dBmV" 1279 MAX-ACCESS read-write 1280 STATUS current 1281 DESCRIPTION 1282 "At the CMTS, the operational transmit power. At the CM, 1283 the received power level. May be set to zero at the CM 1284 if power level measurement is not supported. 1285 If the interface is down, this object either returns 1286 the configured value (CMTS), the most current value (CM) 1287 or the value of 0. See the associated conformance object 1288 for write conditions and limitations. See the reference 1289 for recommended and required power levels." 1290 REFERENCE 1291 "Document [25] from References,Table 6-15." 1292 ::= { docsIfDownstreamChannelEntry 6 } 1294 docsIfDownChannelAnnex OBJECT-TYPE 1295 SYNTAX INTEGER { 1296 unknown(1), 1297 other(2), 1298 annexA(3), 1299 annexB(4), 1300 annexC(5) 1301 } 1302 MAX-ACCESS read-only 1303 STATUS current 1304 DESCRIPTION 1305 "The value of this object indicates the conformance of 1306 the implementation to important regional cable standards. 1307 annexA : Annex A from ITU-J83 is used. 1308 annexB : Annex B from ITU-J83 is used. 1309 annexC : Annex C from ITU-J83 is used. 1310 AnnexB is used for DOCSIS implementations" 1311 REFERENCE 1312 "Document [28] from References, Section 2.2" 1313 ::= { docsIfDownstreamChannelEntry 7 } 1315 -- 1316 -- The following table is implemented on both the CM and the CMTS. 1318 -- For the CM, only attached channels appear in the table. For the 1319 -- CM, this table is read only as well. 1320 -- 1322 docsIfUpstreamChannelTable OBJECT-TYPE 1323 SYNTAX SEQUENCE OF DocsIfUpstreamChannelEntry 1324 MAX-ACCESS not-accessible 1325 STATUS current 1326 DESCRIPTION 1327 "This table describes the attributes of attached upstream 1328 channels." 1329 ::= { docsIfBaseObjects 2 } 1331 docsIfUpstreamChannelEntry OBJECT-TYPE 1332 SYNTAX DocsIfUpstreamChannelEntry 1333 MAX-ACCESS not-accessible 1334 STATUS current 1335 DESCRIPTION 1336 "List of attributes for a single upstream channel. For 1337 Docsis 2.0 CMTSs, an entry in this table exists for 1338 each ifEntry with an ifType of docsCableUpstreamChannel (205). 1339 For Docsis 1.x CM/CMTSs and Docsis 2.0 CMs, an entry in this table exists 1340 for each ifEntry with an ifType of docsCableUpstreamInterface (129)." 1341 INDEX { ifIndex } 1342 ::= { docsIfUpstreamChannelTable 1 } 1344 DocsIfUpstreamChannelEntry ::= SEQUENCE { 1345 docsIfUpChannelId Integer32, 1346 docsIfUpChannelFrequency Integer32, 1347 docsIfUpChannelWidth Integer32, 1348 docsIfUpChannelModulationProfile Unsigned32, 1349 docsIfUpChannelSlotSize Unsigned32, 1350 docsIfUpChannelTxTimingOffset Unsigned32, 1351 docsIfUpChannelRangingBackoffStart Integer32, 1352 docsIfUpChannelRangingBackoffEnd Integer32, 1353 docsIfUpChannelTxBackoffStart Integer32, 1354 docsIfUpChannelTxBackoffEnd Integer32, 1355 docsIfUpChannelScdmaActiveCodes Unsigned32, 1356 docsIfUpChannelScdmaCodesPerSlot Integer32, 1357 docsIfUpChannelScdmaFrameSize Unsigned32, 1358 docsIfUpChannelScdmaHoppingSeed Unsigned32, 1359 docsIfUpChannelType DocsisUpstreamType, 1360 docsIfUpChannelCloneFrom InterfaceIndexOrZero, 1361 docsIfUpChannelUpdate TruthValue, 1362 docsIfUpChannelStatus RowStatus 1363 } 1365 docsIfUpChannelId OBJECT-TYPE 1366 SYNTAX Integer32 (0..255) 1367 MAX-ACCESS read-only 1368 STATUS current 1369 DESCRIPTION 1370 "The CMTS identification of the upstream channel." 1371 ::= { docsIfUpstreamChannelEntry 1 } 1373 docsIfUpChannelFrequency OBJECT-TYPE 1374 SYNTAX Integer32 (0..1000000000) 1375 UNITS "hertz" 1376 MAX-ACCESS read-create 1377 STATUS current 1378 DESCRIPTION 1379 "The center of the frequency band associated with this 1380 upstream interface. This object returns 0 if the frequency 1381 is undefined or unknown. Minimum permitted upstream 1382 frequency is 5,000,000 Hz for current technology. See 1383 the associated conformance object for write conditions 1384 and limitations." 1385 REFERENCE 1386 "Document [25] from References, Table 4-2." 1387 ::= { docsIfUpstreamChannelEntry 2 } 1389 docsIfUpChannelWidth OBJECT-TYPE 1390 SYNTAX Integer32 (0..64000000) 1391 UNITS "hertz" 1392 MAX-ACCESS read-create 1393 STATUS current 1394 DESCRIPTION 1395 "The bandwidth of this upstream interface. This object 1396 returns 0 if the interface width is undefined or unknown. 1397 Minimum permitted interface width is 200,000 Hz currently. 1398 See the associated conformance object for write conditions 1399 and limitations." 1400 REFERENCE 1401 "Document [25] from References, Table 6-12." 1402 ::= { docsIfUpstreamChannelEntry 3 } 1404 docsIfUpChannelModulationProfile OBJECT-TYPE 1405 SYNTAX Unsigned32 1406 MAX-ACCESS read-create 1407 STATUS current 1408 DESCRIPTION 1409 "An entry identical to the docsIfModIndex in the 1410 docsIfCmtsModulationTable that describes this channel. 1411 This channel is further instantiated there by a grouping 1412 of interval usage codes which together fully describe the 1413 channel modulation. This object returns 0 if the 1414 docsIfCmtsModulationTable entry does not exist or 1415 docsIfCmtsModulationTable is empty. See 1416 the associated conformance object for write conditions 1417 and limitations." 1418 REFERENCE 1419 "Document [25] from References, Table 8-19." 1420 ::= { docsIfUpstreamChannelEntry 4 } 1422 docsIfUpChannelSlotSize OBJECT-TYPE 1423 SYNTAX Unsigned32 1424 MAX-ACCESS read-create 1425 STATUS current 1426 DESCRIPTION 1427 "Applicable to TDMA and ATDMA channel types only. 1428 The number of 6.25 microsecond ticks in each upstream mini- 1429 slot. Returns zero if the value is undefined, unknown or in 1430 case of an SCDMA channel. 1431 See the associated conformance object for write 1432 conditions and limitations. " 1433 REFERENCE 1434 "Document [25] from References, Section 8.1.2.4." 1435 ::= { docsIfUpstreamChannelEntry 5 } 1437 docsIfUpChannelTxTimingOffset OBJECT-TYPE 1438 SYNTAX Unsigned32 1439 MAX-ACCESS read-only 1440 STATUS current 1441 DESCRIPTION 1442 "At the CM, a measure of the current round trip time obtained from the 1443 ranging offset (initial ranging offset + ranging offset adjustments). 1444 At the CMTS, the maximum of timing offset, among all the CMs that 1445 are/were present on the channel, taking into account all ( initial + 1446 periodic )timing offset corrections that were sent for each of the CMs. 1447 Generally, these measurements are positive, but if the 1448 measurements are negative, the value of this object is zero. Used for 1449 timing of CM upstream transmissions to ensure synchronized arrivals at 1450 the CMTS. Units are in terms of (6.25 microseconds/64)." 1451 REFERENCE 1452 "Document [25] from References, Section 6.2.18." 1453 ::= { docsIfUpstreamChannelEntry 6 } 1455 docsIfUpChannelRangingBackoffStart OBJECT-TYPE 1456 SYNTAX Integer32 (0..16) 1457 MAX-ACCESS read-create 1458 STATUS current 1459 DESCRIPTION 1460 "The initial random backoff window to use when retrying 1461 Ranging Requests. Expressed as a power of 2. A value of 16 1462 at the CMTS indicates that a proprietary adaptive retry 1463 mechanism is to be used. See the associated conformance 1464 object for write conditions and limitations." 1465 REFERENCE 1466 "Document [25] from References, Section 8.3.4." 1467 ::= { docsIfUpstreamChannelEntry 7 } 1469 docsIfUpChannelRangingBackoffEnd OBJECT-TYPE 1470 SYNTAX Integer32 (0..16) 1471 MAX-ACCESS read-create 1472 STATUS current 1473 DESCRIPTION 1474 "The final random backoff window to use when retrying 1475 Ranging Requests. Expressed as a power of 2. A value of 16 1476 at the CMTS indicates that a proprietary adaptive retry 1477 mechanism is to be used. See the associated conformance 1478 object for write conditions and limitations." 1479 REFERENCE 1480 "Document [25] from References, Section 8.3.4." 1481 ::= { docsIfUpstreamChannelEntry 8 } 1483 docsIfUpChannelTxBackoffStart OBJECT-TYPE 1484 SYNTAX Integer32 (0..16) 1485 MAX-ACCESS read-create 1486 STATUS current 1487 DESCRIPTION 1488 "The initial random backoff window to use when retrying 1489 transmissions. Expressed as a power of 2. A value of 16 1490 at the CMTS indicates that a proprietary adaptive retry 1491 mechanism is to be used. See the associated conformance 1492 object for write conditions and limitations." 1493 REFERENCE 1494 "Document [25] from References, Section 8.3.4." 1495 ::= { docsIfUpstreamChannelEntry 9 } 1497 docsIfUpChannelTxBackoffEnd OBJECT-TYPE 1498 SYNTAX Integer32 (0..16) 1499 MAX-ACCESS read-create 1500 STATUS current 1501 DESCRIPTION 1502 "The final random backoff window to use when retrying 1503 transmissions. Expressed as a power of 2. A value of 16 1504 at the CMTS indicates that a proprietary adaptive retry 1505 mechanism is to be used. See the associated conformance 1506 object for write conditions and limitations." 1507 REFERENCE 1508 "Document [25] from References, Section 8.3.4." 1509 ::= { docsIfUpstreamChannelEntry 10 } 1511 docsIfUpChannelScdmaActiveCodes OBJECT-TYPE 1512 SYNTAX Unsigned32 (0 | 64..128) 1513 MAX-ACCESS read-create 1514 STATUS current 1515 DESCRIPTION 1516 "Applicable for SCDMA channel types only. 1517 Number of active codes. Returns zero for 1518 Non-SCDMA channel types. Note that legal 1519 values from 64..128 MUST be non-prime." 1520 REFERENCE 1521 "Document [25] from References, Section 6.2.11.2.1." 1522 ::= { docsIfUpstreamChannelEntry 11 } 1524 docsIfUpChannelScdmaCodesPerSlot OBJECT-TYPE 1525 SYNTAX Integer32(0 | 2..32) 1526 MAX-ACCESS read-create 1527 STATUS current 1528 DESCRIPTION 1529 "Applicable for SCDMA channel types only. 1530 The number of SCDMA codes per mini-slot. 1531 Returns zero if the value is undefined, unknown or in 1532 case of a TDMA or ATDMA channel." 1533 REFERENCE 1534 "Document [25] from References, Section 6.2.11.2.1." 1535 ::= { docsIfUpstreamChannelEntry 12 } 1537 docsIfUpChannelScdmaFrameSize OBJECT-TYPE 1538 SYNTAX Unsigned32 (0..32) 1539 MAX-ACCESS read-create 1540 STATUS current 1541 DESCRIPTION 1542 "Applicable for SCDMA channel types only. 1543 SCDMA Frame size in units of spreading intervals. 1544 This value returns zero for non SCDMA Profiles." 1545 REFERENCE 1546 " Document [25] from References, Section 6.2.12." 1547 ::= { docsIfUpstreamChannelEntry 13 } 1549 docsIfUpChannelScdmaHoppingSeed OBJECT-TYPE 1550 SYNTAX Unsigned32 (0..32767) 1551 MAX-ACCESS read-create 1552 STATUS current 1553 DESCRIPTION 1554 "Applicable for SCDMA channel types only. 1555 15 bit seed used for code hopping sequence initialization. 1556 Returns zero for non-SCDMA channel types." 1557 REFERENCE 1558 "Document [25] from References, Section 6.2.14.1." 1559 ::= { docsIfUpstreamChannelEntry 14 } 1561 docsIfUpChannelType OBJECT-TYPE 1562 SYNTAX DocsisUpstreamType 1563 MAX-ACCESS read-create 1564 STATUS current 1565 DESCRIPTION 1566 "Defines the Upstream channel type. 1567 Given the channel type, other channel attributes can be checked 1568 for value validity at the time of entry creation and update." 1569 REFERENCE 1570 "Document [25] from References, Section 6.2.1." 1571 ::= { docsIfUpstreamChannelEntry 15 } 1573 docsIfUpChannelCloneFrom OBJECT-TYPE 1574 SYNTAX InterfaceIndexOrZero 1575 MAX-ACCESS read-create 1576 STATUS current 1577 DESCRIPTION 1578 "Intended for use when a temporary inactive upstream table row is 1579 created for the purpose of manipulating SCDMA parameters for an 1580 active row. Refer to the descriptions of docsIfUpChannelStatus 1581 and docsIfUpChannelUpdate for details of this procedure. 1582 This object contains the ifIndex value of the active upstream 1583 row whose SCDMA parameters are to be adjusted. 1584 Although this object was created to facilitate SCDMA parameter 1585 adjustment, it may also be used at the vendor's discretion for 1586 non-SCDMA parameter adjustment. 1587 This object must contain a value of zero for active upstream rows." 1588 ::= { docsIfUpstreamChannelEntry 16 } 1590 docsIfUpChannelUpdate OBJECT-TYPE 1591 SYNTAX TruthValue 1592 MAX-ACCESS read-create 1593 STATUS current 1594 DESCRIPTION 1595 "Used to perform the transfer of adjusted SCDMA parameters from the 1596 temporary upstream row to the active upstream row indicated by the 1597 docsIfUpChannelCloneFrom object. The transfer is initiated through 1598 an SNMP SET of TRUE to this object. The SNMP SET will fail with a 1599 GEN_ERROR (snmpv1) or COMMIT_FAILED_ERROR (snmpv2c/v3) if the adjusted 1600 SCDMA parameter values are not compatible with each other. 1601 Although this object was created to facilitate SCDMA parameter 1602 adjustment, it may also be used at the vendor's discretion for 1603 non-SCDMA parameter adjustment. 1604 An SNMP GET of this object always returns FALSE." 1605 ::= { docsIfUpstreamChannelEntry 17 } 1607 docsIfUpChannelStatus OBJECT-TYPE 1608 SYNTAX RowStatus 1609 MAX-ACCESS read-create 1610 STATUS current 1611 DESCRIPTION 1612 "This object is generally intended to be used for the creation of 1613 a temporary inactive upstream row for the purpose of adjusting 1614 the SCDMA channel parameters of an active upstream row. 1615 The recommended procedure is: 1616 1) Create an inactive row through an SNMP SET using CREATEandWAIT. 1617 Use an ifIndex value outside the operational range of the system. 1618 2) Set the docsIfUpChannelCloneFrom field to the ifIndex value of 1619 the active row whose SCDMA parameters require adjustment. 1620 3) Adjust the SCDMA parameter values using the new temporary inactive 1621 row. 1622 4) Update the active row by setting object docsIfUpChannelUpdate to 1623 TRUE. This SET will fail if the adjusted SCDMA parameters are not 1624 compatible with each other. 1625 5) Delete the temporary row through an SNMP SET using DELETE. 1627 The following restrictions apply to this object: 1629 1) This object must contain a value of ACTIVE for active rows. 1630 2) Temporary inactive rows must be created using CREATEandWAIT. 1631 3) The only possible status change of a row created using 1632 CREATEandWAIT (ie NotInService) is to DELETE. These temporary 1633 rows must never become active. 1634 Although this object was created to facilitate SCDMA parameter 1635 adjustment, it may also be used at the vendor's discretion for 1636 non-SCDMA parameter adjustment." 1637 ::= { docsIfUpstreamChannelEntry 18 } 1639 -- The following table describes the attributes of each class of 1640 -- service. The entries in this table are referenced from the 1641 -- docsIfServiceEntries. They exist as a separate table in order to 1642 -- reduce redundant information in docsIfServiceTable. 1643 -- 1644 -- This table is implemented at both the CM and the CMTS. 1645 -- The CM need only maintain entries for the classes of service 1646 -- referenced by its docsIfServiceTable. 1647 -- 1649 docsIfQosProfileTable OBJECT-TYPE 1650 SYNTAX SEQUENCE OF DocsIfQosProfileEntry 1651 MAX-ACCESS not-accessible 1652 STATUS current 1653 DESCRIPTION 1654 "Describes the attributes for each class of service." 1655 ::= { docsIfBaseObjects 3 } 1657 docsIfQosProfileEntry OBJECT-TYPE 1658 SYNTAX DocsIfQosProfileEntry 1659 MAX-ACCESS not-accessible 1660 STATUS current 1661 DESCRIPTION 1662 "Describes the attributes for a single class of service. 1664 If implemented as read-create in the Cable Modem 1665 Termination System, creation of entries in this table is 1666 controlled by the value of docsIfCmtsQosProfilePermissions. 1668 If implemented as read-only, entries are created based 1669 on information in REG-REQ MAC messages received from 1670 Cable Modems (Cable Modem Termination System 1671 implementation), or based on information extracted from 1672 the TFTP option file (Cable Modem implementation). 1673 In the Cable Modem Termination system, read-only entries 1674 are removed if no longer referenced by 1675 docsIfCmtsServiceTable. 1677 An entry in this table must not be removed while it is 1678 referenced by an entry in docsIfCmServiceTable (Cable Modem) 1679 or docsIfCmtsServiceTable (Cable Modem Termination System). 1681 An entry in this table should not be changeable while 1682 it is referenced by an entry in docsIfCmtsServiceTable. 1684 If this table is created automatically, there should only 1685 be a single entry for each Class of Service. Multiple 1686 entries with the same Class of Service parameters are not 1687 recommended." 1688 INDEX { docsIfQosProfIndex } 1689 ::= { docsIfQosProfileTable 1 } 1691 DocsIfQosProfileEntry ::= SEQUENCE { 1692 docsIfQosProfIndex Integer32, 1693 docsIfQosProfPriority Integer32, 1694 docsIfQosProfMaxUpBandwidth Integer32, 1695 docsIfQosProfGuarUpBandwidth Integer32, 1696 docsIfQosProfMaxDownBandwidth Integer32, 1697 docsIfQosProfMaxTxBurst Integer32, -- Deprecated 1698 docsIfQosProfBaselinePrivacy TruthValue, 1699 docsIfQosProfStatus RowStatus, 1700 docsIfQosProfMaxTransmitBurst Integer32 1701 } 1703 docsIfQosProfIndex OBJECT-TYPE 1704 SYNTAX Integer32 (1..16383) 1705 MAX-ACCESS not-accessible 1706 STATUS current 1707 DESCRIPTION 1708 "The index value that uniquely identifies an entry 1709 in the docsIfQosProfileTable." 1710 ::= { docsIfQosProfileEntry 1 } 1712 docsIfQosProfPriority OBJECT-TYPE 1713 SYNTAX Integer32 (0..7) 1714 MAX-ACCESS read-create 1715 STATUS current 1716 DESCRIPTION 1717 "A relative priority assigned to this service when 1718 allocating bandwidth. Zero indicates lowest priority 1719 and seven indicates highest priority. 1720 Interpretation of priority is device-specific. 1721 MUST NOT be changed while this row is active." 1722 REFERENCE 1723 "Document [25] from References, Appendix C.1.1.4." 1724 DEFVAL { 0 } 1725 ::= { docsIfQosProfileEntry 2 } 1727 docsIfQosProfMaxUpBandwidth OBJECT-TYPE 1728 SYNTAX Integer32 (0..100000000) 1729 MAX-ACCESS read-create 1730 STATUS current 1731 DESCRIPTION 1732 "The maximum upstream bandwidth, in bits per second, 1733 allowed for a service with this service class. 1734 Zero if there is no restriction of upstream bandwidth. 1735 MUST NOT be changed while this row is active." 1736 REFERENCE 1737 "Document [25] from References, Appendix C.1.1.4." 1739 DEFVAL { 0 } 1740 ::= { docsIfQosProfileEntry 3 } 1742 docsIfQosProfGuarUpBandwidth OBJECT-TYPE 1743 SYNTAX Integer32 (0..100000000) 1744 MAX-ACCESS read-create 1745 STATUS current 1746 DESCRIPTION 1747 "Minimum guaranteed upstream bandwidth, in bits per second, 1748 allowed for a service with this service class. 1749 MUST NOT be changed while this row is active." 1750 REFERENCE 1751 "Document [25] from References, Appendix C.1.1.4." 1752 DEFVAL { 0 } 1753 ::= { docsIfQosProfileEntry 4 } 1755 docsIfQosProfMaxDownBandwidth OBJECT-TYPE 1756 SYNTAX Integer32 (0..100000000) 1757 MAX-ACCESS read-create 1758 STATUS current 1759 DESCRIPTION 1760 "The maximum downstream bandwidth, in bits per second, 1761 allowed for a service with this service class. 1762 Zero if there is no restriction of downstream bandwidth. 1763 MUST NOT be changed while this row is active." 1764 REFERENCE 1765 "Document [25] from References, Appendix C.1.1.4." 1767 DEFVAL { 0 } 1768 ::= { docsIfQosProfileEntry 5 } 1770 docsIfQosProfMaxTxBurst OBJECT-TYPE 1771 SYNTAX Integer32 (0..255) 1772 MAX-ACCESS read-create 1773 STATUS deprecated 1774 DESCRIPTION 1775 "The maximum number of mini-slots that may be requested 1776 for a single upstream transmission. 1777 A value of zero means there is no limit. 1778 MUST NOT be changed while this row is active. 1779 This object has been deprecated and replaced by 1780 docsIfQosProfMaxTransmitBurst, to fix a mismatch 1781 of the units and value range with respect to the DOCSIS 1782 Maximum Upstream Channel Transmit Burst Configuration 1783 Setting." 1784 REFERENCE 1785 "Document [25] from References, C.1.1.4." 1786 DEFVAL { 0 } 1787 ::= { docsIfQosProfileEntry 6 } 1789 docsIfQosProfBaselinePrivacy OBJECT-TYPE 1790 SYNTAX TruthValue 1791 MAX-ACCESS read-create 1792 STATUS current 1793 DESCRIPTION 1794 "Indicates whether Baseline Privacy is enabled for this 1795 service class. 1796 MUST NOT be changed while this row is active." 1797 DEFVAL { false } 1798 ::= { docsIfQosProfileEntry 7 } 1800 docsIfQosProfStatus OBJECT-TYPE 1801 SYNTAX RowStatus 1802 MAX-ACCESS read-create 1803 STATUS current 1804 DESCRIPTION 1805 "This is object is to used to create or delete rows in 1806 this table. This object MUST NOT be changed from active 1807 while the row is referenced by the any entry in either 1808 docsIfCmServiceTable (on the CM), or the 1809 docsIfCmtsServiceTable (on the CMTS)." 1810 ::= { docsIfQosProfileEntry 8 } 1812 docsIfQosProfMaxTransmitBurst OBJECT-TYPE 1813 SYNTAX Integer32 (0..1522) 1814 MAX-ACCESS read-create 1815 STATUS current 1816 DESCRIPTION 1817 "The maximum number of bytes that may be requested for a 1818 single upstream transmission. A value of zero means there 1819 is no limit. Note: This value does not include any 1820 physical layer overhead. 1821 MUST NOT be changed while this row is active." 1822 REFERENCE 1823 "Document [25] from References, Appendix C.1.1.4." 1824 DEFVAL { 0 } 1825 ::= { docsIfQosProfileEntry 9 } 1827 docsIfSignalQualityTable OBJECT-TYPE 1828 SYNTAX SEQUENCE OF DocsIfSignalQualityEntry 1829 MAX-ACCESS not-accessible 1830 STATUS current 1831 DESCRIPTION 1832 "At the CM, describes the PHY signal quality of downstream 1833 channels. At the CMTS, describes the PHY signal quality of 1834 upstream channels. At the CMTS, this table may exclude 1835 contention intervals." 1836 ::= { docsIfBaseObjects 4 } 1838 docsIfSignalQualityEntry OBJECT-TYPE 1839 SYNTAX DocsIfSignalQualityEntry 1840 MAX-ACCESS not-accessible 1841 STATUS current 1842 DESCRIPTION 1843 "At the CM, describes the PHY characteristics of a 1844 downstream channel. At the CMTS, describes the PHY signal 1845 quality of an upstream channel. 1846 An entry in this table exists for each ifEntry with an 1847 ifType of docsCableUpstreamChannel(205) for Cable Modem Termination 1848 Systems and docsCableDownstream(128) for Cable Modems." 1849 INDEX { ifIndex } 1850 ::= { docsIfSignalQualityTable 1 } 1852 DocsIfSignalQualityEntry ::= SEQUENCE { 1853 docsIfSigQIncludesContention TruthValue, 1854 docsIfSigQUnerroreds Counter32, 1855 docsIfSigQCorrecteds Counter32, 1856 docsIfSigQUncorrectables Counter32, 1857 docsIfSigQSignalNoise TenthdB, 1858 docsIfSigQMicroreflections Integer32, 1859 docsIfSigQEqualizationData OCTET STRING 1860 } 1862 docsIfSigQIncludesContention OBJECT-TYPE 1863 SYNTAX TruthValue 1864 MAX-ACCESS read-only 1865 STATUS current 1866 DESCRIPTION 1867 "true(1) if this CMTS includes contention intervals in 1868 the counters in this table. Always false(2) for CMs." 1869 REFERENCE 1870 "Document [25] from References, 1871 Section 9.4.1" 1872 ::= { docsIfSignalQualityEntry 1 } 1874 docsIfSigQUnerroreds OBJECT-TYPE 1875 SYNTAX Counter32 1876 MAX-ACCESS read-only 1877 STATUS current 1878 DESCRIPTION 1879 "Codewords received on this channel without error. 1880 This includes all codewords, whether or not they 1881 were part of frames destined for this device." 1882 REFERENCE 1883 "Document [25] from References, Section 6.2.5." 1884 ::= { docsIfSignalQualityEntry 2 } 1886 docsIfSigQCorrecteds OBJECT-TYPE 1887 SYNTAX Counter32 1888 MAX-ACCESS read-only 1889 STATUS current 1890 DESCRIPTION 1891 "Codewords received on this channel with correctable 1892 errors. This includes all codewords, whether or not 1893 they were part of frames destined for this device." 1894 REFERENCE 1895 "Document [25] from References, Section 6.2.5." 1896 ::= { docsIfSignalQualityEntry 3 } 1898 docsIfSigQUncorrectables OBJECT-TYPE 1899 SYNTAX Counter32 1900 MAX-ACCESS read-only 1901 STATUS current 1902 DESCRIPTION 1903 "Codewords received on this channel with uncorrectable 1904 errors. This includes all codewords, whether or not 1905 they were part of frames destined for this device." 1906 REFERENCE 1907 "Document [25] from References, Section 6.2.5." 1908 ::= { docsIfSignalQualityEntry 4 } 1910 docsIfSigQSignalNoise OBJECT-TYPE 1911 SYNTAX TenthdB 1912 UNITS "dB" 1913 MAX-ACCESS read-only 1914 STATUS current 1915 DESCRIPTION 1916 "Signal/Noise ratio as perceived for this channel. 1917 At the CM, describes the Signal/Noise of the downstream 1918 channel. At the CMTS, describes the average Signal/Noise 1919 of the upstream channel." 1920 REFERENCE 1921 "Document [25] from References, Tables 4-1 and 4-2" 1922 ::= { docsIfSignalQualityEntry 5 } 1924 docsIfSigQMicroreflections OBJECT-TYPE 1925 SYNTAX Integer32 (0..255) 1926 UNITS "dBc" 1927 MAX-ACCESS read-only 1928 STATUS current 1929 DESCRIPTION 1930 "Total microreflections including in-channel response 1931 as perceived on this interface, measured in dBc below 1932 the signal level. 1933 This object is not assumed to return an absolutely 1934 accurate value, but should give a rough indication 1935 of microreflections received on this interface. 1936 It is up to the implementer to provide information 1937 as accurate as possible." 1938 REFERENCE 1939 "Document [25] from References, Tables 4-1 and 4-2" 1940 ::= { docsIfSignalQualityEntry 6 } 1942 docsIfSigQEqualizationData OBJECT-TYPE 1943 SYNTAX OCTET STRING 1944 MAX-ACCESS read-only 1945 STATUS current 1946 DESCRIPTION 1947 "At the CM, returns the equalization data for the downstream 1948 channel. At the CMTS, returns the average equalization 1949 data for the upstream channel. Returns an empty string 1950 if the value is unknown or if there is no equalization 1951 data available or defined." 1952 REFERENCE 1953 "Document [25] from References, Table 8-21." 1954 ::= { docsIfSignalQualityEntry 7 } 1956 -- 1957 -- DOCSIS Version of the device 1958 -- 1960 docsIfDocsisBaseCapability OBJECT-TYPE 1961 SYNTAX DocsisVersion 1962 MAX-ACCESS read-only 1963 STATUS current 1964 DESCRIPTION 1965 "Indication of the DOCSIS capability of the device. 1966 This object mirrors docsIfDocsisCapability from the 1967 DocsIfExt mib." 1968 REFERENCE 1969 "Document [25] from References, Annex G." 1970 ::= { docsIfBaseObjects 5 } 1972 -- 1973 -- CABLE MODEM GROUP 1974 -- 1976 -- ####### 1978 -- 1979 -- The CM MAC Table 1980 -- 1982 docsIfCmMacTable OBJECT-TYPE 1983 SYNTAX SEQUENCE OF DocsIfCmMacEntry 1984 MAX-ACCESS not-accessible 1985 STATUS current 1986 DESCRIPTION 1987 "Describes the attributes of each CM MAC interface, 1988 extending the information available from ifEntry." 1989 ::= { docsIfCmObjects 1 } 1991 docsIfCmMacEntry OBJECT-TYPE 1992 SYNTAX DocsIfCmMacEntry 1993 MAX-ACCESS not-accessible 1994 STATUS current 1995 DESCRIPTION 1996 "An entry containing objects describing attributes of 1997 each MAC entry, extending the information in ifEntry. 1998 An entry in this table exists for each ifEntry with an 1999 ifType of docsCableMaclayer(127)." 2000 INDEX { ifIndex } 2001 ::= { docsIfCmMacTable 1 } 2003 DocsIfCmMacEntry ::= SEQUENCE { 2004 docsIfCmCmtsAddress MacAddress, 2005 docsIfCmCapabilities BITS, 2006 docsIfCmRangingRespTimeout TimeTicks, 2007 docsIfCmRangingTimeout TimeInterval 2008 } 2010 docsIfCmCmtsAddress OBJECT-TYPE 2011 SYNTAX MacAddress 2012 MAX-ACCESS read-only 2013 STATUS current 2014 DESCRIPTION 2015 "Identifies the CMTS that is believed to control this MAC 2016 domain. At the CM, this will be the source address from 2017 SYNC, MAP, and other MAC-layer messages. If the CMTS is 2018 unknown, returns 00-00-00-00-00-00." 2019 REFERENCE 2020 "Document [25] from References, Section 8.2.2." 2021 ::= { docsIfCmMacEntry 1 } 2023 docsIfCmCapabilities OBJECT-TYPE 2024 SYNTAX BITS { 2025 atmCells(0), 2026 concatenation(1) 2027 } 2028 MAX-ACCESS read-only 2029 STATUS current 2030 DESCRIPTION 2031 "Identifies the capabilities of the MAC implementation 2032 at this interface. Note that packet transmission is 2033 always supported. Therefore, there is no specific bit 2034 required to explicitly indicate this capability. 2035 Note that BITS objects are encoded most significant bit 2036 first. For example, if bit 1 is set, the value of this 2037 object is the octet string '40'H." 2038 ::= { docsIfCmMacEntry 2 } 2040 -- This object has been obsoleted and replaced by 2041 -- docsIfCmRangingTimeout to correct the typing to TimeInterval. New 2042 -- implementations of the MIB should use docsIfCmRangingTimeout instead. 2044 docsIfCmRangingRespTimeout OBJECT-TYPE 2045 SYNTAX TimeTicks 2046 MAX-ACCESS read-write 2047 STATUS obsolete 2048 DESCRIPTION 2049 "Waiting time for a Ranging Response packet." 2050 REFERENCE 2051 "Document [25] from References, Section 9.1.6." 2052 DEFVAL { 20 } 2053 ::= { docsIfCmMacEntry 3 } 2055 docsIfCmRangingTimeout OBJECT-TYPE 2056 SYNTAX TimeInterval 2057 MAX-ACCESS read-write 2058 STATUS current 2059 DESCRIPTION 2060 "Waiting time for a Ranging Response packet." 2061 REFERENCE 2062 "Document [25] from References, 2063 Section 9.1.6, timer T3." 2064 DEFVAL { 20 } 2065 ::= { docsIfCmMacEntry 4 } 2067 -- 2068 -- CM status table. 2069 -- This table is implemented only at the CM. 2070 -- 2072 docsIfCmStatusTable OBJECT-TYPE 2073 SYNTAX SEQUENCE OF DocsIfCmStatusEntry 2074 MAX-ACCESS not-accessible 2075 STATUS current 2076 DESCRIPTION 2077 "This table maintains a number of status objects 2078 and counters for Cable Modems." 2079 ::= { docsIfCmObjects 2 } 2081 docsIfCmStatusEntry OBJECT-TYPE 2082 SYNTAX DocsIfCmStatusEntry 2083 MAX-ACCESS not-accessible 2084 STATUS current 2085 DESCRIPTION 2086 "A set of status objects and counters for a single MAC 2087 layer instance in a Cable Modem. 2088 An entry in this table exists for each ifEntry with an 2089 ifType of docsCableMaclayer(127)." 2090 INDEX { ifIndex } 2091 ::= { docsIfCmStatusTable 1 } 2093 DocsIfCmStatusEntry ::= SEQUENCE { 2094 docsIfCmStatusValue INTEGER, 2095 docsIfCmStatusCode OCTET STRING, 2096 docsIfCmStatusTxPower TenthdBmV, 2097 docsIfCmStatusResets Counter32, 2098 docsIfCmStatusLostSyncs Counter32, 2099 docsIfCmStatusInvalidMaps Counter32, 2100 docsIfCmStatusInvalidUcds Counter32, 2101 docsIfCmStatusInvalidRangingResponses Counter32, 2102 docsIfCmStatusInvalidRegistrationResponses Counter32, 2103 docsIfCmStatusT1Timeouts Counter32, 2104 docsIfCmStatusT2Timeouts Counter32, 2105 docsIfCmStatusT3Timeouts Counter32, 2106 docsIfCmStatusT4Timeouts Counter32, 2107 docsIfCmStatusRangingAborteds Counter32, 2108 docsIfCmStatusDocsisOperMode DocsisQosVersion, 2109 docsIfCmStatusModulationType DocsisUpstreamTypeStatus 2110 } 2112 docsIfCmStatusValue OBJECT-TYPE 2113 SYNTAX INTEGER { 2114 other(1), 2115 notReady(2), 2116 notSynchronized(3), 2117 phySynchronized(4), 2118 usParametersAcquired(5), 2119 rangingComplete(6), 2120 ipComplete(7), 2121 todEstablished(8), 2122 securityEstablished(9), 2123 paramTransferComplete(10), 2124 registrationComplete(11), 2125 operational(12), 2126 accessDenied(13) 2127 } 2128 MAX-ACCESS read-only 2129 STATUS current 2130 DESCRIPTION 2131 "Current Cable Modem connectivity state, as specified 2132 in the RF Interface Specification." 2133 REFERENCE 2134 "Document [25] from References, Section 11.2." 2135 ::= { docsIfCmStatusEntry 1 } 2137 docsIfCmStatusCode OBJECT-TYPE 2138 SYNTAX OCTET STRING 2139 MAX-ACCESS read-only 2140 STATUS current 2141 DESCRIPTION 2142 "Status code for this Cable Modem as defined in the 2143 RF Interface Specification. The status code consists 2144 of a single character indicating error groups, followed 2145 by a two- or three-digit number indicating the status 2146 condition." 2147 REFERENCE 2148 "Document [26] from References, Appendix F." 2149 ::= { docsIfCmStatusEntry 2 } 2151 docsIfCmStatusTxPower OBJECT-TYPE 2152 SYNTAX TenthdBmV 2153 UNITS "dBmV" 2154 MAX-ACCESS read-only 2155 STATUS current 2156 DESCRIPTION 2157 "The operational transmit power for the attached upstream 2158 channel." 2159 REFERENCE 2160 "Document [25] from References, Section 6.2.18." 2161 ::= { docsIfCmStatusEntry 3 } 2163 docsIfCmStatusResets OBJECT-TYPE 2164 SYNTAX Counter32 2165 MAX-ACCESS read-only 2166 STATUS current 2167 DESCRIPTION 2168 "Number of times the CM reset or initialized this interface." 2169 ::= { docsIfCmStatusEntry 4 } 2171 docsIfCmStatusLostSyncs OBJECT-TYPE 2172 SYNTAX Counter32 2173 MAX-ACCESS read-only 2174 STATUS current 2175 DESCRIPTION 2176 "Number of times the CM lost synchronization with 2177 the downstream channel." 2178 REFERENCE 2179 "Document [25] from References, Section 8.3.2." 2180 ::= { docsIfCmStatusEntry 5 } 2182 docsIfCmStatusInvalidMaps OBJECT-TYPE 2183 SYNTAX Counter32 2184 MAX-ACCESS read-only 2185 STATUS current 2186 DESCRIPTION 2187 "Number of times the CM received invalid MAP messages." 2188 REFERENCE 2189 "Document [25] from References, Section 8.3.4." 2190 ::= { docsIfCmStatusEntry 6 } 2192 docsIfCmStatusInvalidUcds OBJECT-TYPE 2193 SYNTAX Counter32 2194 MAX-ACCESS read-only 2195 STATUS current 2196 DESCRIPTION 2197 "Number of times the CM received invalid UCD messages." 2198 REFERENCE 2199 "Document [25] from References, Section 8.3.3." 2200 ::= { docsIfCmStatusEntry 7 } 2202 docsIfCmStatusInvalidRangingResponses OBJECT-TYPE 2203 SYNTAX Counter32 2204 MAX-ACCESS read-only 2205 STATUS current 2206 DESCRIPTION 2207 "Number of times the CM received invalid ranging response 2208 messages." 2209 REFERENCE 2210 "Document [25] from References, Section 8.3.6." 2211 ::= { docsIfCmStatusEntry 8 } 2213 docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE 2214 SYNTAX Counter32 2215 MAX-ACCESS read-only 2216 STATUS current 2217 DESCRIPTION 2218 "Number of times the CM received invalid registration 2219 response messages." 2220 REFERENCE 2221 "Document [25] from References, Section 8.3.8." 2222 ::= { docsIfCmStatusEntry 9 } 2224 docsIfCmStatusT1Timeouts OBJECT-TYPE 2225 SYNTAX Counter32 2226 MAX-ACCESS read-only 2227 STATUS current 2228 DESCRIPTION 2229 "Number of times counter T1 expired in the CM." 2230 REFERENCE 2231 "Document [25] from References, Figure 9-2." 2232 ::= { docsIfCmStatusEntry 10 } 2234 docsIfCmStatusT2Timeouts OBJECT-TYPE 2235 SYNTAX Counter32 2236 MAX-ACCESS read-only 2237 STATUS current 2238 DESCRIPTION 2239 "Number of times counter T2 expired in the CM." 2240 REFERENCE 2241 "Document [25] from References, Figure 9-2." 2242 ::= { docsIfCmStatusEntry 11 } 2244 docsIfCmStatusT3Timeouts OBJECT-TYPE 2245 SYNTAX Counter32 2246 MAX-ACCESS read-only 2247 STATUS current 2248 DESCRIPTION 2249 "Number of times counter T3 expired in the CM." 2250 REFERENCE 2251 "Document [25] from References, Figure 9-2." 2252 ::= { docsIfCmStatusEntry 12 } 2254 docsIfCmStatusT4Timeouts OBJECT-TYPE 2255 SYNTAX Counter32 2256 MAX-ACCESS read-only 2257 STATUS current 2258 DESCRIPTION 2259 "Number of times counter T4 expired in the CM." 2260 REFERENCE 2261 "Document [25] from References, Figure 9-2." 2262 ::= { docsIfCmStatusEntry 13 } 2264 docsIfCmStatusRangingAborteds OBJECT-TYPE 2265 SYNTAX Counter32 2266 MAX-ACCESS read-only 2267 STATUS current 2268 DESCRIPTION 2269 "Number of times the ranging process was aborted 2270 by the CMTS." 2271 REFERENCE 2272 "Document [25] from References, Section 9.3.3." 2273 ::= { docsIfCmStatusEntry 14 } 2275 docsIfCmStatusDocsisOperMode OBJECT-TYPE 2276 SYNTAX DocsisQosVersion 2277 MAX-ACCESS read-only 2278 STATUS current 2279 DESCRIPTION 2280 "Indication whether the device has registered using 1.0 Class of 2281 Service or 1.1 Quality of Service. 2282 An unregistered CM should indicate 1.1 QOS for a 2283 docsIfDocsisBaseCapability value of Docsis 1.1/2.0. An unregistered 2284 CM should indicate 1.0 COS for a docsIfDocsisBaseCapability value 2285 of Docsis 1.0. 2286 This object mirrors docsIfCmDocsisOperMode from the docsIfExt mib." 2287 REFERENCE 2288 "Document [25] from References, Annex G." 2289 ::= { docsIfCmStatusEntry 15 } 2291 docsIfCmStatusModulationType OBJECT-TYPE 2292 SYNTAX DocsisUpstreamTypeStatus 2293 MAX-ACCESS read-only 2294 STATUS current 2295 DESCRIPTION 2296 "Indicates modulation type status currently used by the CM. 2297 Since this object specifically identifies PHY mode, the shared 2298 upstream channel type is not permitted." 2300 REFERENCE 2301 "Document [25] from References, Section 6.2.1." 2303 ::= { docsIfCmStatusEntry 16 } 2305 -- 2306 -- The Cable Modem Service Table 2307 -- 2309 docsIfCmServiceTable OBJECT-TYPE 2310 SYNTAX SEQUENCE OF DocsIfCmServiceEntry 2311 MAX-ACCESS not-accessible 2312 STATUS current 2313 DESCRIPTION 2314 "Describes the attributes of each upstream service queue 2315 on a CM." 2316 ::= { docsIfCmObjects 3 } 2318 docsIfCmServiceEntry OBJECT-TYPE 2319 SYNTAX DocsIfCmServiceEntry 2320 MAX-ACCESS not-accessible 2321 STATUS current 2322 DESCRIPTION 2323 "Describes the attributes of an upstream bandwidth service 2324 queue. 2325 An entry in this table exists for each Service ID. 2326 The primary index is an ifIndex with an ifType of 2327 docsCableMaclayer(127)." 2328 INDEX { ifIndex, docsIfCmServiceId } 2329 ::= { docsIfCmServiceTable 1 } 2331 DocsIfCmServiceEntry ::= SEQUENCE { 2332 docsIfCmServiceId Integer32, 2333 docsIfCmServiceQosProfile Integer32, 2334 docsIfCmServiceTxSlotsImmed Counter32, 2335 docsIfCmServiceTxSlotsDed Counter32, 2336 docsIfCmServiceTxRetries Counter32, 2337 docsIfCmServiceTxExceededs Counter32, 2338 docsIfCmServiceRqRetries Counter32, 2339 docsIfCmServiceRqExceededs Counter32, 2340 docsIfCmServiceExtTxSlotsImmed Counter64, 2341 docsIfCmServiceExtTxSlotsDed Counter64 2342 } 2344 docsIfCmServiceId OBJECT-TYPE 2345 SYNTAX Integer32 (1..16383) 2346 MAX-ACCESS not-accessible 2347 STATUS current 2348 DESCRIPTION 2349 "Identifies a service queue for upstream bandwidth. The 2350 attributes of this service queue are shared between the 2351 CM and the CMTS. The CMTS allocates upstream bandwidth 2352 to this service queue based on requests from the CM and 2353 on the class of service associated with this queue." 2354 ::= { docsIfCmServiceEntry 1 } 2356 docsIfCmServiceQosProfile OBJECT-TYPE 2357 SYNTAX Integer32 (0..16383) 2358 MAX-ACCESS read-only 2359 STATUS current 2360 DESCRIPTION 2361 "The index in docsIfQosProfileTable describing the quality 2362 of service attributes associated with this particular 2363 service. If no associated entry in docsIfQosProfileTable 2364 exists, this object returns a value of zero." 2365 ::= { docsIfCmServiceEntry 2 } 2367 docsIfCmServiceTxSlotsImmed OBJECT-TYPE 2368 SYNTAX Counter32 2369 MAX-ACCESS read-only 2370 STATUS current 2371 DESCRIPTION 2372 "The number of upstream mini-slots which have been used to 2373 transmit data PDUs in immediate (contention) mode. This 2374 includes only those PDUs that are presumed to have 2375 arrived at the headend (i.e., those which were explicitly 2376 acknowledged.) It does not include retransmission attempts 2377 or mini-slots used by Requests." 2378 REFERENCE 2379 "Document [25] from References, Section 9.4." 2380 ::= { docsIfCmServiceEntry 3 } 2382 docsIfCmServiceTxSlotsDed OBJECT-TYPE 2383 SYNTAX Counter32 2384 MAX-ACCESS read-only 2385 STATUS current 2386 DESCRIPTION 2387 "The number of upstream mini-slots which have been used to 2388 transmit data PDUs in dedicated mode (i.e., as a result 2389 of a unicast Data Grant)." 2390 REFERENCE 2391 "Document [25] from References, Section 9.4." 2392 ::= { docsIfCmServiceEntry 4 } 2394 docsIfCmServiceTxRetries OBJECT-TYPE 2395 SYNTAX Counter32 2396 MAX-ACCESS read-only 2397 STATUS current 2398 DESCRIPTION 2399 "The number of attempts to transmit data PDUs containing 2400 requests for acknowledgment that did not result in 2401 acknowledgment." 2402 REFERENCE 2403 "Document [25] from References, Section 9.4." 2405 ::= { docsIfCmServiceEntry 5 } 2407 docsIfCmServiceTxExceededs OBJECT-TYPE 2408 SYNTAX Counter32 2409 MAX-ACCESS read-only 2410 STATUS current 2411 DESCRIPTION 2412 "The number of data PDUs transmission failures due to 2413 excessive retries without acknowledgment." 2414 REFERENCE 2415 "Document [25] from References, Section 9.4." 2416 ::= { docsIfCmServiceEntry 6 } 2418 docsIfCmServiceRqRetries OBJECT-TYPE 2419 SYNTAX Counter32 2420 MAX-ACCESS read-only 2421 STATUS current 2422 DESCRIPTION 2423 "The number of attempts to transmit bandwidth requests 2424 which did not result in acknowledgment." 2425 REFERENCE 2426 "Document [25] from References, Section 9.4." 2427 ::= { docsIfCmServiceEntry 7 } 2429 docsIfCmServiceRqExceededs OBJECT-TYPE 2430 SYNTAX Counter32 2431 MAX-ACCESS read-only 2432 STATUS current 2433 DESCRIPTION 2434 "The number of requests for bandwidth which failed due to 2435 excessive retries without acknowledgment." 2436 REFERENCE 2437 "Document [25] from References, Section 9.4." 2438 ::= { docsIfCmServiceEntry 8 } 2440 docsIfCmServiceExtTxSlotsImmed OBJECT-TYPE 2441 SYNTAX Counter64 2442 MAX-ACCESS read-only 2443 STATUS current 2444 DESCRIPTION 2445 "The number of upstream mini-slots which have been used to 2446 transmit data PDUs in immediate (contention) mode. This 2447 includes only those PDUs that are presumed to have 2448 arrived at the headend (i.e., those which were explicitly 2449 acknowledged.) It does not include retransmission attempts 2450 or mini-slots used by Requests." 2451 REFERENCE 2452 "Document [25] from References, Section 9.4." 2453 ::= { docsIfCmServiceEntry 9 } 2455 docsIfCmServiceExtTxSlotsDed OBJECT-TYPE 2456 SYNTAX Counter64 2457 MAX-ACCESS read-only 2458 STATUS current 2459 DESCRIPTION 2460 "The number of upstream mini-slots which have been used to 2461 transmit data PDUs in dedicated mode (i.e., as a result 2462 of a unicast Data Grant)." 2463 REFERENCE 2464 "Document [25] from References, Section 9.4." 2465 ::= { docsIfCmServiceEntry 10 } 2467 -- 2468 -- CMTS GROUP 2469 -- 2471 -- 2472 -- The CMTS MAC Table 2473 -- 2475 docsIfCmtsMacTable OBJECT-TYPE 2476 SYNTAX SEQUENCE OF DocsIfCmtsMacEntry 2477 MAX-ACCESS not-accessible 2478 STATUS current 2479 DESCRIPTION 2480 "Describes the attributes of each CMTS MAC interface, 2481 extending the information available from ifEntry. 2482 Mandatory for all CMTS devices." 2483 ::= { docsIfCmtsObjects 1 } 2485 docsIfCmtsMacEntry OBJECT-TYPE 2486 SYNTAX DocsIfCmtsMacEntry 2487 MAX-ACCESS not-accessible 2488 STATUS current 2489 DESCRIPTION 2490 "An entry containing objects describing attributes of each 2491 MAC entry, extending the information in ifEntry. 2492 An entry in this table exists for each ifEntry with an 2493 ifType of docsCableMaclayer(127)." 2494 INDEX { ifIndex } 2495 ::= { docsIfCmtsMacTable 1 } 2497 DocsIfCmtsMacEntry ::= SEQUENCE { 2498 docsIfCmtsCapabilities BITS, 2499 docsIfCmtsSyncInterval Integer32, 2500 docsIfCmtsUcdInterval Integer32, 2501 docsIfCmtsMaxServiceIds Integer32, 2502 docsIfCmtsInsertionInterval TimeTicks, -- Obsolete 2503 docsIfCmtsInvitedRangingAttempts Integer32, 2504 docsIfCmtsInsertInterval TimeInterval 2505 } 2507 docsIfCmtsCapabilities OBJECT-TYPE 2508 SYNTAX BITS { 2509 atmCells(0), 2510 concatenation(1) 2511 } 2512 MAX-ACCESS read-only 2513 STATUS current 2514 DESCRIPTION 2515 "Identifies the capabilities of the CMTS MAC 2516 implementation at this interface. Note that packet 2517 transmission is always supported. Therefore, there 2518 is no specific bit required to explicitly indicate 2519 this capability. 2520 Note that BITS objects are encoded most significant bit 2521 first. For example, if bit 1 is set, the value of this 2522 object is the octet string '40'H." 2523 ::= { docsIfCmtsMacEntry 1 } 2525 docsIfCmtsSyncInterval OBJECT-TYPE 2526 SYNTAX Integer32 (1..200) 2527 UNITS "Milliseconds" 2528 MAX-ACCESS read-write 2529 STATUS current 2530 DESCRIPTION 2531 "The interval between CMTS transmission of successive SYNC 2532 messages at this interface." 2533 REFERENCE 2534 "Document [25] from References, Section 9.3." 2535 ::= { docsIfCmtsMacEntry 2 } 2537 docsIfCmtsUcdInterval OBJECT-TYPE 2538 SYNTAX Integer32 (1..2000) 2539 UNITS "Milliseconds" 2540 MAX-ACCESS read-write 2541 STATUS current 2542 DESCRIPTION 2543 "The interval between CMTS transmission of successive 2544 Upstream Channel Descriptor messages for each upstream 2545 channel at this interface." 2546 REFERENCE 2547 "Document [25] from References, Section 9.3" 2548 ::= { docsIfCmtsMacEntry 3 } 2550 docsIfCmtsMaxServiceIds OBJECT-TYPE 2551 SYNTAX Integer32 (1..16383) 2552 MAX-ACCESS read-only 2553 STATUS current 2554 DESCRIPTION 2555 "The maximum number of service IDs that may be 2556 simultaneously active." 2558 ::= { docsIfCmtsMacEntry 4 } 2560 -- This object has been obsoleted and replaced by 2561 -- docsIfCmtsInsertInterval to fix a SYNTAX typing problem. New 2562 -- implementations of this MIB should use that object instead. 2563 docsIfCmtsInsertionInterval OBJECT-TYPE 2564 SYNTAX TimeTicks 2565 MAX-ACCESS read-write 2566 STATUS obsolete 2567 DESCRIPTION 2568 "The amount of time to elapse between each broadcast 2569 station maintenance grant. Broadcast station maintenance 2570 grants are used to allow new cable modems to join the 2571 network. Zero indicates that a vendor-specific algorithm 2572 is used instead of a fixed time. Maximum amount of time 2573 permitted by the specification is 2 seconds." 2574 REFERENCE 2575 "Document [25] from References, Annex B." 2576 ::= { docsIfCmtsMacEntry 5 } 2578 docsIfCmtsInvitedRangingAttempts OBJECT-TYPE 2579 SYNTAX Integer32 (0..1024) 2580 MAX-ACCESS read-write 2581 STATUS current 2582 DESCRIPTION 2583 "The maximum number of attempts to make on invitations 2584 for ranging requests. A value of zero means the system 2585 should attempt to range forever." 2586 REFERENCE 2587 "Document [25] from References, Section 9.3.3 and Annex B." 2588 ::= { docsIfCmtsMacEntry 6 } 2590 docsIfCmtsInsertInterval OBJECT-TYPE 2591 SYNTAX TimeInterval 2592 MAX-ACCESS read-write 2593 STATUS current 2594 DESCRIPTION 2595 "The amount of time to elapse between each broadcast 2596 station maintenance grant. Broadcast station maintenance 2597 grants are used to allow new cable modems to join the 2598 network. Zero indicates that a vendor-specific algorithm 2599 is used instead of a fixed time. Maximum amount of time 2600 permitted by the specification is 2 seconds." 2601 REFERENCE 2602 "Document [25] from References, Annex B." 2603 ::= { docsIfCmtsMacEntry 7 } 2605 -- 2606 -- 2607 -- CMTS status table. 2608 -- 2609 docsIfCmtsStatusTable OBJECT-TYPE 2610 SYNTAX SEQUENCE OF DocsIfCmtsStatusEntry 2611 MAX-ACCESS not-accessible 2612 STATUS current 2613 DESCRIPTION 2614 "For the MAC layer, this group maintains a number of 2615 status objects and counters." 2616 ::= { docsIfCmtsObjects 2 } 2618 docsIfCmtsStatusEntry OBJECT-TYPE 2619 SYNTAX DocsIfCmtsStatusEntry 2620 MAX-ACCESS not-accessible 2621 STATUS current 2622 DESCRIPTION 2623 "Status entry for a single MAC layer. 2624 An entry in this table exists for each ifEntry with an 2625 ifType of docsCableMaclayer(127)." 2626 INDEX { ifIndex } 2627 ::= { docsIfCmtsStatusTable 1 } 2629 DocsIfCmtsStatusEntry ::= SEQUENCE { 2630 docsIfCmtsStatusInvalidRangeReqs Counter32, 2631 docsIfCmtsStatusRangingAborteds Counter32, 2632 docsIfCmtsStatusInvalidRegReqs Counter32, 2633 docsIfCmtsStatusFailedRegReqs Counter32, 2634 docsIfCmtsStatusInvalidDataReqs Counter32, 2635 docsIfCmtsStatusT5Timeouts Counter32 2636 } 2638 docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE 2639 SYNTAX Counter32 2640 MAX-ACCESS read-only 2641 STATUS current 2642 DESCRIPTION 2643 "This object counts invalid RNG-REQ messages received on 2644 this interface." 2645 REFERENCE 2646 "Document [25] from References, Section 8.3.5." 2648 ::= { docsIfCmtsStatusEntry 1 } 2650 docsIfCmtsStatusRangingAborteds OBJECT-TYPE 2651 SYNTAX Counter32 2652 MAX-ACCESS read-only 2653 STATUS current 2654 DESCRIPTION 2655 "This object counts ranging attempts that were explicitly 2656 aborted by the CMTS." 2657 REFERENCE 2658 "Document [25] from References, Section 8.3.6." 2659 ::= { docsIfCmtsStatusEntry 2 } 2661 docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE 2662 SYNTAX Counter32 2663 MAX-ACCESS read-only 2664 STATUS current 2665 DESCRIPTION 2666 "This object counts invalid REG-REQ messages received on 2667 this interface. That is, syntax, out of range parameters, 2668 or erroneous requests." 2669 REFERENCE 2670 "Document [25] from References, Section 8.3.7." 2671 ::= { docsIfCmtsStatusEntry 3 } 2673 docsIfCmtsStatusFailedRegReqs OBJECT-TYPE 2674 SYNTAX Counter32 2675 MAX-ACCESS read-only 2676 STATUS current 2677 DESCRIPTION 2678 "This object counts failed registration attempts. Included are 2679 docsIfCmtsStatusInvalidRegReqs, authentication and class of 2680 service failures." 2681 REFERENCE 2682 "Document [25] from References, Section 8.3.7." 2683 ::= { docsIfCmtsStatusEntry 4 } 2685 docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE 2686 SYNTAX Counter32 2687 MAX-ACCESS read-only 2688 STATUS current 2689 DESCRIPTION 2690 "This object counts invalid data request messages 2691 received on this interface." 2692 ::= { docsIfCmtsStatusEntry 5 } 2694 docsIfCmtsStatusT5Timeouts OBJECT-TYPE 2695 SYNTAX Counter32 2696 MAX-ACCESS read-only 2697 STATUS current 2698 DESCRIPTION 2699 "This object counts the number of times counter T5 2700 expired on this interface." 2701 REFERENCE 2702 "Document [25] from References, Figure 9-2." 2703 ::= { docsIfCmtsStatusEntry 6 } 2705 -- 2706 -- CM status table (within CMTS). 2707 -- This table is implemented only at the CMTS. 2708 -- It contains per CM status information available in the CMTS. 2709 -- 2710 docsIfCmtsCmStatusTable OBJECT-TYPE 2711 SYNTAX SEQUENCE OF DocsIfCmtsCmStatusEntry 2712 MAX-ACCESS not-accessible 2713 STATUS current 2714 DESCRIPTION 2715 "A set of objects in the CMTS, maintained for each 2716 Cable Modem connected to this CMTS." 2717 ::= { docsIfCmtsObjects 3 } 2719 docsIfCmtsCmStatusEntry OBJECT-TYPE 2720 SYNTAX DocsIfCmtsCmStatusEntry 2721 MAX-ACCESS not-accessible 2722 STATUS current 2723 DESCRIPTION 2724 "Status information for a single Cable Modem. 2725 An entry in this table exists for each Cable Modem 2726 that is connected to the CMTS implementing this table." 2727 INDEX { docsIfCmtsCmStatusIndex } 2728 ::= { docsIfCmtsCmStatusTable 1 } 2730 DocsIfCmtsCmStatusEntry ::= SEQUENCE { 2731 docsIfCmtsCmStatusIndex Integer32, 2732 docsIfCmtsCmStatusMacAddress MacAddress, 2733 docsIfCmtsCmStatusIpAddress IpAddress, -- Deprecated 2734 docsIfCmtsCmStatusDownChannelIfIndex InterfaceIndexOrZero, 2735 docsIfCmtsCmStatusUpChannelIfIndex InterfaceIndexOrZero, 2736 docsIfCmtsCmStatusRxPower TenthdBmV, 2737 docsIfCmtsCmStatusTimingOffset Unsigned32, 2738 docsIfCmtsCmStatusEqualizationData OCTET STRING, 2739 docsIfCmtsCmStatusValue INTEGER, 2740 docsIfCmtsCmStatusUnerroreds Counter32, 2741 docsIfCmtsCmStatusCorrecteds Counter32, 2742 docsIfCmtsCmStatusUncorrectables Counter32, 2743 docsIfCmtsCmStatusSignalNoise TenthdB, 2744 docsIfCmtsCmStatusMicroreflections Integer32, 2745 docsIfCmtsCmStatusExtUnerroreds Counter64, 2746 docsIfCmtsCmStatusExtCorrecteds Counter64, 2747 docsIfCmtsCmStatusExtUncorrectables Counter64, 2748 docsIfCmtsCmStatusDocsisRegMode DocsisQosVersion, 2749 docsIfCmtsCmStatusModulationType DocsisUpstreamTypeStatus, 2750 docsIfCmtsCmStatusInetAddressType InetAddressType, 2751 docsIfCmtsCmStatusInetAddress InetAddress 2752 } 2754 docsIfCmtsCmStatusIndex OBJECT-TYPE 2755 SYNTAX Integer32 (1..2147483647) 2756 MAX-ACCESS not-accessible 2757 STATUS current 2758 DESCRIPTION 2759 "Index value to uniquely identify an entry in this table. 2760 For an individual Cable Modem, this index value should 2761 not change during CMTS uptime." 2763 ::= { docsIfCmtsCmStatusEntry 1 } 2765 docsIfCmtsCmStatusMacAddress OBJECT-TYPE 2766 SYNTAX MacAddress 2767 MAX-ACCESS read-only 2768 STATUS current 2769 DESCRIPTION 2770 "MAC address of this Cable Modem. If the Cable Modem has 2771 multiple MAC addresses, this is the MAC address associated 2772 with the Cable interface." 2773 REFERENCE 2774 "Document [25] from References, Section 8.2.2." 2775 ::= { docsIfCmtsCmStatusEntry 2 } 2777 docsIfCmtsCmStatusIpAddress OBJECT-TYPE 2778 SYNTAX IpAddress 2779 MAX-ACCESS read-only 2780 STATUS deprecated 2781 DESCRIPTION 2782 "IP address of this Cable Modem. If the Cable Modem has no 2783 IP address assigned, or the IP address is unknown, this 2784 object returns a value of 0.0.0.0. If the Cable Modem has 2785 multiple IP addresses, this object returns the IP address 2786 associated with the Cable interface.n 2787 This object has been deprecated and replaced by 2788 docsIfCmtsCmStatusInetAddressType and 2789 docsIfCmtsCmStatusInetAddress, to enable IPv6 addressing 2790 in the future." 2791 ::= { docsIfCmtsCmStatusEntry 3 } 2793 docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE 2794 SYNTAX InterfaceIndexOrZero 2795 MAX-ACCESS read-only 2796 STATUS current 2797 DESCRIPTION 2798 "IfIndex of the downstream channel this CM is connected 2799 to. If the downstream channel is unknown, this object 2800 returns a value of zero." 2801 ::= { docsIfCmtsCmStatusEntry 4 } 2803 docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE 2804 SYNTAX InterfaceIndexOrZero 2805 MAX-ACCESS read-only 2806 STATUS current 2807 DESCRIPTION 2808 "IfIndex of the upstream channel this CM is connected 2809 to. If the upstream channel is unknown, this object 2810 returns a value of zero." 2811 ::= { docsIfCmtsCmStatusEntry 5 } 2813 docsIfCmtsCmStatusRxPower OBJECT-TYPE 2814 SYNTAX TenthdBmV 2815 UNITS "dBmV" 2816 MAX-ACCESS read-only 2817 STATUS current 2818 DESCRIPTION 2819 "The receive power as perceived for upstream data from 2820 this Cable Modem. 2821 If the receive power is unknown, this object returns 2822 a value of zero." 2823 REFERENCE 2824 "Document [25] from References, Table 6-11." 2825 ::= { docsIfCmtsCmStatusEntry 6 } 2827 docsIfCmtsCmStatusTimingOffset OBJECT-TYPE 2828 SYNTAX Unsigned32 2829 MAX-ACCESS read-only 2830 STATUS current 2831 DESCRIPTION 2832 "A measure of the current round trip time for this CM. 2833 Used for timing of CM upstream transmissions to ensure 2834 synchronized arrivals at the CMTS. Units are in terms 2835 of 6.25 microseconds/(64*256). Returns zero if the value 2836 is unknown." 2837 REFERENCE 2838 "Document [25] from References, Section 6.2.18." 2839 ::= { docsIfCmtsCmStatusEntry 7 } 2841 docsIfCmtsCmStatusEqualizationData OBJECT-TYPE 2842 SYNTAX OCTET STRING 2843 MAX-ACCESS read-only 2844 STATUS current 2845 DESCRIPTION 2846 "Equalization data for this CM. Returns an empty string 2847 if the value is unknown or if there is no equalization 2848 data available or defined." 2849 REFERENCE 2850 "Document [25] from References, Figure 8-23." 2851 ::= { docsIfCmtsCmStatusEntry 8 } 2853 docsIfCmtsCmStatusValue OBJECT-TYPE 2854 SYNTAX INTEGER { 2855 other(1), 2856 ranging(2), 2857 rangingAborted(3), 2858 rangingComplete(4), 2859 ipComplete(5), 2860 registrationComplete(6), 2861 accessDenied(7) 2862 } 2863 MAX-ACCESS read-only 2864 STATUS current 2865 DESCRIPTION 2866 "Current Cable Modem connectivity state, as specified 2867 in the RF Interface Specification. Returned status 2868 information is the CM status as assumed by the CMTS, 2869 and indicates the following events: 2870 other(1) 2871 Any state other than below. 2872 ranging(2) 2873 The CMTS has received an Initial Ranging Request 2874 message from the CM, and the ranging process is not 2875 yet complete. 2876 rangingAborted(3) 2877 The CMTS has sent a Ranging Abort message to the CM. 2878 rangingComplete(4) 2879 The CMTS has sent a Ranging Complete message to the CM. 2880 ipComplete(5) 2881 The CMTS has received a DHCP reply message and forwarded 2882 it to the CM. 2883 registrationComplete(6) 2884 The CMTS has sent a Registration Response message to 2885 the CM. 2886 accessDenied(7) 2887 The CMTS has sent a Registration Aborted message 2888 to the CM. 2889 The CMTS only needs to report states it is able to detect." 2890 REFERENCE 2891 "Document [25] from References, Section 11.2." 2892 ::= { docsIfCmtsCmStatusEntry 9 } 2894 docsIfCmtsCmStatusUnerroreds OBJECT-TYPE 2895 SYNTAX Counter32 2896 MAX-ACCESS read-only 2897 STATUS current 2898 DESCRIPTION 2899 "Codewords received without error from this Cable Modem." 2900 REFERENCE 2901 "Document [25] from References, Section 6.2.5." 2902 ::= { docsIfCmtsCmStatusEntry 10 } 2904 docsIfCmtsCmStatusCorrecteds OBJECT-TYPE 2905 SYNTAX Counter32 2906 MAX-ACCESS read-only 2907 STATUS current 2908 DESCRIPTION 2909 "Codewords received with correctable errors from this 2910 Cable Modem." 2911 REFERENCE 2912 "Document [25] from References, Section 6.2.5." 2913 ::= { docsIfCmtsCmStatusEntry 11 } 2915 docsIfCmtsCmStatusUncorrectables OBJECT-TYPE 2916 SYNTAX Counter32 2917 MAX-ACCESS read-only 2918 STATUS current 2919 DESCRIPTION 2920 "Codewords received with uncorrectable errors from this 2921 Cable Modem." 2922 REFERENCE 2923 "Document [25] from References, Section 6.2.5." 2924 ::= { docsIfCmtsCmStatusEntry 12 } 2926 docsIfCmtsCmStatusSignalNoise OBJECT-TYPE 2927 SYNTAX TenthdB 2928 UNITS "dB" 2929 MAX-ACCESS read-only 2930 STATUS current 2931 DESCRIPTION 2932 "Signal/Noise ratio as perceived for upstream data from 2933 this Cable Modem. 2934 If the Signal/Noise is unknown, this object returns 2935 a value of zero." 2936 REFERENCE 2937 "Document [25] from References, Tables 4-1 and 4-2." 2938 ::= { docsIfCmtsCmStatusEntry 13 } 2940 docsIfCmtsCmStatusMicroreflections OBJECT-TYPE 2941 SYNTAX Integer32 (0..255) 2942 UNITS "dBc" 2943 MAX-ACCESS read-only 2944 STATUS current 2945 DESCRIPTION 2946 "Total microreflections including in-channel response 2947 as perceived on this interface, measured in dBc below 2948 the signal level. 2949 This object is not assumed to return an absolutely 2950 accurate value, but should give a rough indication 2951 of microreflections received on this interface. 2952 It is up to the implementer to provide information 2953 as accurate as possible." 2954 REFERENCE 2955 "Document [25] from References, Tables 4-1 and 4-2" 2956 ::= { docsIfCmtsCmStatusEntry 14 } 2958 docsIfCmtsCmStatusExtUnerroreds OBJECT-TYPE 2959 SYNTAX Counter64 2960 MAX-ACCESS read-only 2961 STATUS current 2962 DESCRIPTION 2963 "Codewords received without error from this Cable Modem." 2964 REFERENCE 2965 "Document [25] from References, Section 6.2.5." 2966 ::= { docsIfCmtsCmStatusEntry 15 } 2968 docsIfCmtsCmStatusExtCorrecteds OBJECT-TYPE 2969 SYNTAX Counter64 2970 MAX-ACCESS read-only 2971 STATUS current 2972 DESCRIPTION 2973 "Codewords received with correctable errors from this 2974 Cable Modem." 2975 REFERENCE 2976 "Document [25] from References, Section 6.2.5." 2977 ::= { docsIfCmtsCmStatusEntry 16 } 2979 docsIfCmtsCmStatusExtUncorrectables OBJECT-TYPE 2980 SYNTAX Counter64 2981 MAX-ACCESS read-only 2982 STATUS current 2983 DESCRIPTION 2984 "Codewords received with uncorrectable errors from this 2985 Cable Modem." 2986 REFERENCE 2987 "Document [25] from References, Section 6.2.5." 2988 ::= { docsIfCmtsCmStatusEntry 17 } 2990 docsIfCmtsCmStatusDocsisRegMode OBJECT-TYPE 2991 SYNTAX DocsisQosVersion 2992 MAX-ACCESS read-only 2993 STATUS current 2994 DESCRIPTION 2995 " Indication whether the CM has registered using 1.0 Class of 2996 Service or 1.1 Quality of Service. 2997 This object mirrors docsIfCmtsCmStatusDocsisMode from the 2998 docsIfExt mib." 2999 REFERENCE 3000 "Document [25] from References, Annex G." 3001 ::= { docsIfCmtsCmStatusEntry 18 } 3003 docsIfCmtsCmStatusModulationType OBJECT-TYPE 3004 SYNTAX DocsisUpstreamTypeStatus 3005 MAX-ACCESS read-only 3006 STATUS current 3007 DESCRIPTION 3008 "Indicates modulation type currently used by the CM. Since 3009 this object specifically identifies PHY mode, the shared 3010 type is not permitted." 3011 REFERENCE 3012 "Document [25] from References, Table 8-19." 3013 ::= { docsIfCmtsCmStatusEntry 19 } 3015 docsIfCmtsCmStatusInetAddressType OBJECT-TYPE 3016 SYNTAX InetAddressType 3017 MAX-ACCESS read-only 3018 STATUS current 3019 DESCRIPTION 3020 "The type of internet address of 3021 docsIfCmtsCmStatusInetAddress. If the cable modem 3022 Internet address is unassigned or unknown, then the 3023 value of this object is unknown(0)." 3024 ::= { docsIfCmtsCmStatusEntry 20 } 3026 docsIfCmtsCmStatusInetAddress OBJECT-TYPE 3027 SYNTAX InetAddress 3028 MAX-ACCESS read-only 3029 STATUS current 3030 DESCRIPTION 3031 "Internet address of this Cable Modem. If the Cable Modem 3032 has no Internet address assigned, or the Internet address 3033 is unknown, the value of this object is the empty string. 3034 If the Cable Modem has multiple Internet addresses, this 3035 object returns the Internet address associated with the 3036 Cable (i.e. RF MAC) interface." 3037 ::= { docsIfCmtsCmStatusEntry 21 } 3039 -- 3040 -- The CMTS Service Table. 3041 -- 3043 docsIfCmtsServiceTable OBJECT-TYPE 3044 SYNTAX SEQUENCE OF DocsIfCmtsServiceEntry 3045 MAX-ACCESS not-accessible 3046 STATUS current 3047 DESCRIPTION 3048 "Describes the attributes of upstream service queues 3049 in a Cable Modem Termination System." 3050 ::= { docsIfCmtsObjects 4 } 3052 docsIfCmtsServiceEntry OBJECT-TYPE 3053 SYNTAX DocsIfCmtsServiceEntry 3054 MAX-ACCESS not-accessible 3055 STATUS current 3056 DESCRIPTION 3057 "Describes the attributes of a single upstream bandwidth 3058 service queue. 3060 Entries in this table exist for each ifEntry with an 3061 ifType of docsCableMaclayer(127), and for each service 3062 queue (Service ID) within this MAC layer. 3063 Entries in this table are created with the creation of 3064 individual Service IDs by the MAC layer and removed 3065 when a Service ID is removed." 3066 INDEX { ifIndex, docsIfCmtsServiceId } 3067 ::= { docsIfCmtsServiceTable 1 } 3069 DocsIfCmtsServiceEntry ::= SEQUENCE { 3070 docsIfCmtsServiceId Integer32, 3071 docsIfCmtsServiceCmStatusIndex Integer32, -- Deprecated 3072 docsIfCmtsServiceAdminStatus INTEGER, 3073 docsIfCmtsServiceQosProfile Integer32, 3074 docsIfCmtsServiceCreateTime TimeStamp, 3075 docsIfCmtsServiceInOctets Counter32, 3076 docsIfCmtsServiceInPackets Counter32, 3077 docsIfCmtsServiceNewCmStatusIndex Integer32 3078 } 3080 docsIfCmtsServiceId OBJECT-TYPE 3081 SYNTAX Integer32 (1..16383) 3082 MAX-ACCESS not-accessible 3083 STATUS current 3084 DESCRIPTION 3085 "Identifies a service queue for upstream bandwidth. The 3086 attributes of this service queue are shared between the 3087 Cable Modem and the Cable Modem Termination System. 3088 The CMTS allocates upstream bandwidth to this service 3089 queue based on requests from the CM and on the class of 3090 service associated with this queue." 3091 ::= { docsIfCmtsServiceEntry 1 } 3093 docsIfCmtsServiceCmStatusIndex OBJECT-TYPE 3094 SYNTAX Integer32 (0..65535) 3095 MAX-ACCESS read-only 3096 STATUS deprecated 3097 DESCRIPTION 3098 "Pointer to an entry in docsIfCmtsCmStatusTable identifying 3099 the Cable Modem using this Service Queue. If multiple 3100 Cable Modems are using this Service Queue, the value of 3101 this object is zero. 3102 This object has been deprecated and replaced by 3103 docsIfCmtsServiceNewCmStatusIndex, to fix a mismatch 3104 of the value range with respect to docsIfCmtsCmStatusIndex 3105 (1..2147483647)." 3106 ::= { docsIfCmtsServiceEntry 2 } 3108 docsIfCmtsServiceAdminStatus OBJECT-TYPE 3109 SYNTAX INTEGER { 3110 enabled(1), 3111 disabled(2), 3112 destroyed(3) } 3113 MAX-ACCESS read-write 3114 STATUS current 3115 DESCRIPTION 3116 "Allows a service class for a particular modem to be 3117 suppressed, (re-)enabled, or deleted altogether." 3118 ::= { docsIfCmtsServiceEntry 3 } 3120 docsIfCmtsServiceQosProfile OBJECT-TYPE 3121 SYNTAX Integer32 (0..16383) 3122 MAX-ACCESS read-only 3123 STATUS current 3124 DESCRIPTION 3125 "The index in docsIfQosProfileTable describing the quality 3126 of service attributes associated with this particular 3127 service. If no associated docsIfQosProfileTable entry 3128 exists, this object returns a value of zero." 3129 ::= { docsIfCmtsServiceEntry 4 } 3131 docsIfCmtsServiceCreateTime OBJECT-TYPE 3133 SYNTAX TimeStamp 3134 MAX-ACCESS read-only 3135 STATUS current 3136 DESCRIPTION 3137 "The value of sysUpTime when this entry was created." 3138 ::= { docsIfCmtsServiceEntry 5 } 3140 docsIfCmtsServiceInOctets OBJECT-TYPE 3141 SYNTAX Counter32 3142 MAX-ACCESS read-only 3143 STATUS current 3144 DESCRIPTION 3145 "The cumulative number of Packet Data octets received 3146 on this Service ID. The count does not include the 3147 size of the Cable MAC header" 3148 ::= { docsIfCmtsServiceEntry 6 } 3150 docsIfCmtsServiceInPackets OBJECT-TYPE 3151 SYNTAX Counter32 3152 MAX-ACCESS read-only 3153 STATUS current 3154 DESCRIPTION 3155 "The cumulative number of Packet Data packets received 3156 on this Service ID." 3157 ::= { docsIfCmtsServiceEntry 7 } 3159 docsIfCmtsServiceNewCmStatusIndex OBJECT-TYPE 3160 SYNTAX Integer32 (0..2147483647) 3161 MAX-ACCESS read-only 3162 STATUS current 3163 DESCRIPTION 3164 "Pointer (via docsIfCmtsCmStatusIndex) to an entry in 3165 docsIfCmtsCmStatusTable identifying the Cable Modem 3166 using this Service Queue. If multiple Cable Modems are 3167 using this Service Queue, the value of this object is 3168 zero." 3169 ::= { docsIfCmtsServiceEntry 8 } 3171 -- 3172 -- The following table provides upstream channel modulation profiles. 3173 -- Entries in this table can be 3174 -- re-used by one or more upstream channels. An upstream channel will 3175 -- have a modulation profile 3176 -- for each value of docsIfModIntervalUsageCode. 3177 -- 3179 docsIfCmtsModulationTable OBJECT-TYPE 3180 SYNTAX SEQUENCE OF DocsIfCmtsModulationEntry 3181 MAX-ACCESS not-accessible 3182 STATUS current 3183 DESCRIPTION 3184 "Describes a modulation profile associated with one or more 3185 upstream channels." 3186 ::= { docsIfCmtsObjects 5 } 3188 docsIfCmtsModulationEntry OBJECT-TYPE 3189 SYNTAX DocsIfCmtsModulationEntry 3190 MAX-ACCESS not-accessible 3191 STATUS current 3192 DESCRIPTION 3193 "Describes a modulation profile for an Interval Usage Code 3194 for one or more upstream channels. 3195 Entries in this table are created by the operator. Initial 3196 default entries may be created at system initialization 3197 time. No individual objects have to be specified in order 3198 to create an entry in this table. 3199 Note that some objects do not have DEFVALs, but do have 3200 calculated defaults and need not be specified during row 3201 creation. 3202 There is no restriction on the changing of values in this 3203 table while their associated rows are active." 3204 INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode} 3205 ::= { docsIfCmtsModulationTable 1 } 3207 DocsIfCmtsModulationEntry ::= SEQUENCE { 3208 docsIfCmtsModIndex Integer32, 3209 docsIfCmtsModIntervalUsageCode INTEGER, 3210 docsIfCmtsModControl RowStatus, 3211 docsIfCmtsModType INTEGER, 3212 docsIfCmtsModPreambleLen Integer32, 3213 docsIfCmtsModDifferentialEncoding TruthValue, 3214 docsIfCmtsModFECErrorCorrection Integer32, 3215 docsIfCmtsModFECCodewordLength Integer32, 3216 docsIfCmtsModScramblerSeed Integer32, 3217 docsIfCmtsModMaxBurstSize Integer32, 3218 docsIfCmtsModGuardTimeSize Unsigned32, 3219 docsIfCmtsModLastCodewordShortened TruthValue, 3220 docsIfCmtsModScrambler TruthValue, 3221 docsIfCmtsModByteInterleaverDepth Unsigned32, 3222 docsIfCmtsModByteInterleaverBlockSize Unsigned32, 3223 docsIfCmtsModPreambleType INTEGER, 3224 docsIfCmtsModTcmErrorCorrectionOn TruthValue, 3225 docsIfCmtsModScdmaInterleaverStepSize Unsigned32, 3226 docsIfCmtsModScdmaSpreaderEnable TruthValue, 3227 docsIfCmtsModScdmaSubframeCodes Unsigned32, 3228 docsIfCmtsModChannelType DocsisUpstreamType 3229 } 3231 docsIfCmtsModIndex OBJECT-TYPE 3232 SYNTAX Integer32 (1..2147483647) 3233 MAX-ACCESS not-accessible 3234 STATUS current 3235 DESCRIPTION 3236 "An index into the Channel Modulation table representing 3237 a group of Interval Usage Codes, all associated with the 3238 same channel." 3239 ::= { docsIfCmtsModulationEntry 1 } 3241 docsIfCmtsModIntervalUsageCode OBJECT-TYPE 3242 SYNTAX INTEGER { 3243 request(1), 3244 requestData(2), 3245 initialRanging(3), 3246 periodicRanging(4), 3247 shortData(5), 3248 longData(6), 3249 advPhyShortData(9), 3250 advPhyLongData(10), 3251 ugs(11) 3252 } 3253 MAX-ACCESS not-accessible 3254 STATUS current 3255 DESCRIPTION 3256 "An index into the Channel Modulation table which, when 3257 grouped with other Interval Usage Codes, fully 3258 instantiate all modulation sets for a given upstream 3259 channel." 3260 REFERENCE 3261 "Document [25] from References, Table 8-20." 3262 ::= { docsIfCmtsModulationEntry 2 } 3264 docsIfCmtsModControl OBJECT-TYPE 3265 SYNTAX RowStatus 3266 MAX-ACCESS read-create 3267 STATUS current 3268 DESCRIPTION 3269 "Controls and reflects the status of rows in this table." 3270 ::= { docsIfCmtsModulationEntry 3 } 3272 docsIfCmtsModType OBJECT-TYPE 3273 SYNTAX INTEGER { 3274 other(1), 3275 qpsk(2), 3276 qam16(3), 3277 qam8(4), 3278 qam32(5), 3279 qam64(6), 3280 qam128(7) 3281 } 3282 MAX-ACCESS read-create 3283 STATUS current 3284 DESCRIPTION 3285 "The modulation type used on this channel. Returns 3286 other(1) if the modulation type is neither 3287 qpsk, qam16, qam8, qam32, qam64 or qam128. 3288 Type qam128 is used for SCDMA channels only. 3289 See the reference for the modulation profiles 3290 implied by different modulation types. 3291 See the conformance object for write conditions and limitations." 3292 REFERENCE 3293 "Document [25] from References, Table 8-19." 3294 DEFVAL { qpsk } 3295 ::= { docsIfCmtsModulationEntry 4 } 3297 docsIfCmtsModPreambleLen OBJECT-TYPE 3298 SYNTAX Integer32 (0..1536) 3299 MAX-ACCESS read-create 3300 STATUS current 3301 DESCRIPTION 3302 "The preamble length for this modulation profile in bits. 3303 Default value is the minimum needed by the implementation 3304 at the CMTS for the given modulation profile." 3305 REFERENCE 3306 "Document [25] from References, Table 8-19." 3307 ::= { docsIfCmtsModulationEntry 5 } 3309 docsIfCmtsModDifferentialEncoding OBJECT-TYPE 3310 SYNTAX TruthValue 3311 MAX-ACCESS read-create 3312 STATUS current 3313 DESCRIPTION 3314 "Specifies whether or not differential encoding is used 3315 on this channel." 3316 REFERENCE 3317 "Document [25] from References, Table 8-19." 3318 DEFVAL { false } 3319 ::= { docsIfCmtsModulationEntry 6 } 3321 docsIfCmtsModFECErrorCorrection OBJECT-TYPE 3322 SYNTAX Integer32 (0..16) 3323 MAX-ACCESS read-create 3324 STATUS current 3325 DESCRIPTION 3326 "The number of correctable errored bytes (t) used in 3327 forward error correction code. The value of 0 indicates 3328 no correction is employed. The number of check bytes 3329 appended will be twice this value." 3330 REFERENCE 3331 "Document [25] from References, Table 8-19." 3332 DEFVAL { 0 } 3333 ::= { docsIfCmtsModulationEntry 7 } 3335 docsIfCmtsModFECCodewordLength OBJECT-TYPE 3336 SYNTAX Integer32 (1..255) 3337 MAX-ACCESS read-create 3338 STATUS current 3339 DESCRIPTION 3340 "The number of data bytes (k) in the forward error 3341 correction codeword. 3342 This object is not used if docsIfCmtsModFECErrorCorrection 3343 is zero." 3344 REFERENCE 3345 "Document [25] from References, Table 8-19." 3346 DEFVAL { 32 } 3347 ::= { docsIfCmtsModulationEntry 8 } 3349 docsIfCmtsModScramblerSeed OBJECT-TYPE 3350 SYNTAX Integer32 (0..32767) 3351 MAX-ACCESS read-create 3352 STATUS current 3353 DESCRIPTION 3354 "The 15 bit seed value for the scrambler polynomial." 3355 REFERENCE 3356 "Document [25] from References, Table 8-19." 3357 DEFVAL { 0 } 3358 ::= { docsIfCmtsModulationEntry 9 } 3360 docsIfCmtsModMaxBurstSize OBJECT-TYPE 3361 SYNTAX Integer32 (0..255) 3362 MAX-ACCESS read-create 3363 STATUS current 3364 DESCRIPTION 3365 "The maximum number of mini-slots that can be transmitted 3366 during this channel's burst time. Returns zero if the 3367 burst length is bounded by the allocation MAP rather than 3368 this profile. 3369 Default value is 0 except for shortData, where it is 8." 3370 REFERENCE 3371 "Document [25] from References, Table 8-19." 3372 ::= { docsIfCmtsModulationEntry 10 } 3374 docsIfCmtsModGuardTimeSize OBJECT-TYPE 3375 SYNTAX Unsigned32 3376 MAX-ACCESS read-only 3377 STATUS current 3378 DESCRIPTION 3379 "The number of symbol-times which must follow the end of 3380 this channel's burst. Default value is the minimum time 3381 needed by the implementation for this modulation profile." 3382 REFERENCE 3383 "Document [25] from References, Table 8-19." 3384 ::= { docsIfCmtsModulationEntry 11 } 3386 docsIfCmtsModLastCodewordShortened OBJECT-TYPE 3387 SYNTAX TruthValue 3388 MAX-ACCESS read-create 3389 STATUS current 3390 DESCRIPTION 3391 "Indicates if the last FEC codeword is truncated." 3392 REFERENCE 3393 "Document [25] from References, Table 8-19." 3394 DEFVAL { true } 3395 ::= { docsIfCmtsModulationEntry 12 } 3397 docsIfCmtsModScrambler OBJECT-TYPE 3398 SYNTAX TruthValue 3399 MAX-ACCESS read-create 3400 STATUS current 3401 DESCRIPTION 3402 "Indicates if the scrambler is employed." 3403 REFERENCE 3404 "Document [25] from References, Table 8-19." 3405 DEFVAL { false } 3406 ::= { docsIfCmtsModulationEntry 13 } 3408 docsIfCmtsModByteInterleaverDepth OBJECT-TYPE 3409 SYNTAX Unsigned32 3410 MAX-ACCESS read-create 3411 STATUS current 3412 DESCRIPTION 3413 " ATDMA Byte Interleaver Depth (Ir). This object returns 1 for 3414 non ATDMA profiles. " 3415 REFERENCE 3416 "Document [25] from References, Table 8-19." 3417 DEFVAL { 1 } 3418 ::= { docsIfCmtsModulationEntry 14 } 3420 docsIfCmtsModByteInterleaverBlockSize OBJECT-TYPE 3421 SYNTAX Unsigned32 3422 MAX-ACCESS read-create 3423 STATUS current 3424 DESCRIPTION 3425 " ATDMA Byte Interleaver Block size (Br). This object returns 3426 zero for non ATDMA profiles " 3427 REFERENCE 3428 "Document [25] from References, Table 8-19." 3429 DEFVAL { 18 } 3430 ::= { docsIfCmtsModulationEntry 15 } 3432 docsIfCmtsModPreambleType OBJECT-TYPE 3433 SYNTAX INTEGER { 3434 qpsk0(1), 3435 qpsk1(2) 3436 } 3437 MAX-ACCESS read-create 3438 STATUS current 3439 DESCRIPTION 3440 "Preamble type for DOCSIS 2.0 bursts" 3441 REFERENCE 3442 "Document [25] from References, Table 8-19." 3443 DEFVAL { qpsk0 } 3444 ::= { docsIfCmtsModulationEntry 16 } 3446 docsIfCmtsModTcmErrorCorrectionOn OBJECT-TYPE 3447 SYNTAX TruthValue 3448 MAX-ACCESS read-create 3449 STATUS current 3450 DESCRIPTION 3451 " Trellis Code Modulation (TCM) On/Off. This value returns false for 3452 non S-CDMA profiles." 3453 REFERENCE 3454 "Document [25] from References, Table 8-19." 3455 DEFVAL { false } 3456 ::= { docsIfCmtsModulationEntry 17 } 3458 docsIfCmtsModScdmaInterleaverStepSize OBJECT-TYPE 3459 SYNTAX Unsigned32 (0 | 1..32) 3460 MAX-ACCESS read-create 3461 STATUS current 3462 DESCRIPTION 3463 " S-CDMA Interleaver step size. This value returns zero 3464 for non S-CDMA profiles." 3465 REFERENCE 3466 "Document [25] from References, Table 8-19." 3468 DEFVAL { 1 } 3469 ::= { docsIfCmtsModulationEntry 18 } 3471 docsIfCmtsModScdmaSpreaderEnable OBJECT-TYPE 3472 SYNTAX TruthValue 3473 MAX-ACCESS read-create 3474 STATUS current 3475 DESCRIPTION 3476 " S-CDMA spreader. This value returns false for non S-CDMA 3477 profiles. Default value for IUC 3 and 4 is OFF, for 3478 all other IUCs it is ON." 3479 REFERENCE 3480 "Document [25] from References, Table 8-19." 3481 ::= { docsIfCmtsModulationEntry 19 } 3483 docsIfCmtsModScdmaSubframeCodes OBJECT-TYPE 3484 SYNTAX Unsigned32 (0 | 1..128) 3485 MAX-ACCESS read-create 3486 STATUS current 3487 DESCRIPTION 3488 " S-CDMA sub-frame size. This value returns zero 3489 for non S-CDMA profiles." 3490 REFERENCE 3491 "Document [25] from References, Table 8-19." 3492 DEFVAL { 1 } 3493 ::= { docsIfCmtsModulationEntry 20 } 3495 docsIfCmtsModChannelType OBJECT-TYPE 3496 SYNTAX DocsisUpstreamType 3497 MAX-ACCESS read-create 3498 STATUS current 3499 DESCRIPTION 3500 "Describes the modulation channel type for this modulation entry." 3501 REFERENCE 3502 "Document [25] from References, Table 8-19." 3503 DEFVAL { tdma } 3504 ::= { docsIfCmtsModulationEntry 21 } 3506 docsIfCmtsQosProfilePermissions OBJECT-TYPE 3507 SYNTAX BITS { 3508 createByManagement(0), 3509 updateByManagement(1), 3510 createByModems(2) 3511 } 3512 MAX-ACCESS read-write 3513 STATUS current 3514 DESCRIPTION 3515 "This object specifies permitted methods of creating 3516 entries in docsIfQosProfileTable. 3517 CreateByManagement(0) is set if entries can be created 3518 using SNMP. UpdateByManagement(1) is set if updating 3519 entries using SNMP is permitted. CreateByModems(2) 3520 is set if entries can be created based on information 3521 in REG-REQ MAC messages received from Cable Modems. 3522 Information in this object is only applicable if 3523 docsIfQosProfileTable is implemented as read-create. 3524 Otherwise, this object is implemented as read-only 3525 and returns CreateByModems(2). 3526 Either CreateByManagement(0) or CreateByModems(1) 3527 must be set when writing to this object. 3528 Note that BITS objects are encoded most significant bit 3529 first. For example, if bit 2 is set, the value of this 3530 object is the octet string '20'H." 3531 ::= { docsIfCmtsObjects 6 } 3533 docsIfCmtsMacToCmTable OBJECT-TYPE 3534 SYNTAX SEQUENCE OF DocsIfCmtsMacToCmEntry 3535 MAX-ACCESS not-accessible 3536 STATUS current 3537 DESCRIPTION 3538 "This is a table to provide a quick access index into the 3539 docsIfCmtsCmStatusTable. There is exactly one row in this 3540 table for each row in the docsIfCmtsCmStatusTable. In 3541 general, the management station should use this table only 3542 to get a pointer into the docsIfCmtsCmStatusTable (which 3543 corresponds to the CM's RF interface MAC address), and 3544 should not iterate (e.g. GetNext through) this table." 3545 ::= { docsIfCmtsObjects 7 } 3547 docsIfCmtsMacToCmEntry OBJECT-TYPE 3548 SYNTAX DocsIfCmtsMacToCmEntry 3549 MAX-ACCESS not-accessible 3550 STATUS current 3551 DESCRIPTION 3552 "A row in the docsIfCmtsMacToCmTable. 3553 An entry in this table exists for each Cable Modem 3554 that is connected to the CMTS implementing this table." 3555 INDEX { docsIfCmtsCmMac } 3556 ::= {docsIfCmtsMacToCmTable 1 } 3558 DocsIfCmtsMacToCmEntry ::= SEQUENCE { 3559 docsIfCmtsCmMac MacAddress, 3560 docsIfCmtsCmPtr Integer32 3561 } 3563 docsIfCmtsCmMac OBJECT-TYPE 3564 SYNTAX MacAddress 3565 MAX-ACCESS not-accessible 3566 STATUS current 3567 DESCRIPTION 3568 "The RF side MAC address for the referenced CM. (E.g. the 3569 interface on the CM that has docsCableMacLayer(127) as 3570 its ifType." 3571 ::= { docsIfCmtsMacToCmEntry 1 } 3573 docsIfCmtsCmPtr OBJECT-TYPE 3574 SYNTAX Integer32 (1..2147483647) 3575 MAX-ACCESS read-only 3576 STATUS current 3577 DESCRIPTION 3578 "An row index into docsIfCmtsCmStatusTable. When queried 3579 with the correct instance value (e.g. a CM's MAC address), 3580 returns the index in docsIfCmtsCmStatusTable which 3581 represents that CM." 3582 ::= { docsIfCmtsMacToCmEntry 2 } 3584 -- 3585 -- notification group is for future extension. 3586 -- 3588 docsIfNotification OBJECT IDENTIFIER ::= { docsIfMib 2 } 3590 docsIfConformance OBJECT IDENTIFIER ::= { docsIfMib 3 } 3591 docsIfCompliances OBJECT IDENTIFIER ::= { docsIfConformance 1 } 3592 docsIfGroups OBJECT IDENTIFIER ::= { docsIfConformance 2 } 3594 -- compliance statements 3596 docsIfBasicCompliance MODULE-COMPLIANCE 3597 STATUS current 3598 DESCRIPTION 3599 "The compliance statement for devices that implement 3600 MCNS/DOCSIS compliant Radio Frequency Interfaces." 3602 MODULE -- docsIfMib 3604 -- unconditionally mandatory groups 3605 MANDATORY-GROUPS { 3606 docsIfBasicGroup 3607 } 3609 -- conditionally mandatory group 3610 GROUP docsIfCmGroup 3611 DESCRIPTION 3612 "This group is implemented only in Cable Modems, not in 3613 Cable Modem Termination Systems." 3614 -- conditionally mandatory group 3615 GROUP docsIfCmtsGroup 3616 DESCRIPTION 3617 "This group is implemented only in Cable Modem Termination 3618 Systems, not in Cable Modems." 3620 OBJECT docsIfDownChannelFrequency 3621 WRITE-SYNTAX Integer32 (47000000..862000000) 3622 MIN-ACCESS read-only 3623 DESCRIPTION 3624 "Read-write in Cable Modem Termination Systems; 3625 read-only in Cable Modems. 3626 A range of 54MHz to 860MHz is appropriate for a cable 3627 plant using a North American Sub-Split channel plan. 3628 The spectrum range has been expanded to accommodate 3629 a lower edge of 47MHz and an upper edge of 862MHz 3630 for some European channel plans. 3631 If DOCSIS is extended to cover other types of channel 3632 plans (and frequency allocations) this object will be 3633 modified accordingly." 3635 OBJECT docsIfDownChannelWidth 3636 WRITE-SYNTAX Integer32 (6000000 | 8000000) 3637 MIN-ACCESS read-only 3638 DESCRIPTION 3639 "It is conformant to implement this object as read-only. 3640 In Cable Modems, this object is always implemented as 3641 read-only. The value of 6 MHz is appropriate for cable 3642 plants running under NTSC (National Television 3643 Standards Committee) standards. The value of 8 MHz is 3644 appropriate for cable plants running under ETSI 3645 standards. For other regional standards, this 3646 object will be modified accordingly." 3648 OBJECT docsIfDownChannelModulation 3649 WRITE-SYNTAX INTEGER { 3650 qam64 (3), 3651 qam256 (4) 3652 } 3653 MIN-ACCESS read-only 3654 DESCRIPTION 3655 "Read-write in Cable Modem Termination Systems; 3656 read-only in Cable Modems." 3658 OBJECT docsIfDownChannelInterleave 3659 WRITE-SYNTAX INTEGER { 3660 taps8Increment16(3), 3661 taps16Increment8(4), 3662 taps32Increment4(5), 3663 taps64Increment2(6), 3664 taps128Increment1(7), 3665 taps12increment17(8) 3666 } 3667 MIN-ACCESS read-only 3668 DESCRIPTION 3669 "Read-write in Cable Modem Termination Systems; 3670 read-only in Cable Modems." 3672 OBJECT docsIfDownChannelPower 3673 MIN-ACCESS read-only 3674 DESCRIPTION 3675 "Read-write in Cable Modem Termination Systems; 3676 read-only in Cable Modems." 3678 OBJECT docsIfUpChannelFrequency 3679 WRITE-SYNTAX Integer32 (5000000..65000000) 3680 MIN-ACCESS read-only 3681 DESCRIPTION 3682 "Read-create in Cable Modem Termination Systems; 3683 read-only in Cable Modems. 3684 A range of 5MHz to 42MHz is appropriate for a cable 3685 plant using a North American Sub-Split channel plan. 3686 The spectrum range has been expanded to accommodate 3687 an upper edge of 65MHz for some European channel plans. 3688 If DOCSIS is extended to cover other types of channel 3689 plans (and frequency allocations) this object will 3690 be modified accordingly." 3692 OBJECT docsIfUpChannelWidth 3693 WRITE-SYNTAX Integer32 (200000..3200000) 3694 MIN-ACCESS read-only 3695 DESCRIPTION 3696 "Read-create in Cable Modem Termination Systems; 3697 read-only in Cable Modems. The above value is appropriate 3698 for cable plants running under NTSC (National Television 3699 Standards Committee) standards. If DOCSIS is extended to 3700 work with other standard (e.g. European standards), this 3701 object will be modified accordingly." 3703 OBJECT docsIfUpChannelModulationProfile 3704 MIN-ACCESS read-only 3705 DESCRIPTION 3706 "Read-create in Cable Modem Termination Systems; 3707 read-only in Cable Modems." 3709 OBJECT docsIfUpChannelSlotSize 3710 MIN-ACCESS read-only 3711 DESCRIPTION 3712 "This object is always read-only in Cable Modems. 3713 It is compliant to implement this object as read-only 3714 in Cable Modem Termination Systems." 3716 OBJECT docsIfUpChannelRangingBackoffStart 3717 MIN-ACCESS read-only 3718 DESCRIPTION 3719 "Read-create in Cable Modem Termination Systems; 3720 read-only in Cable Modems." 3722 OBJECT docsIfUpChannelRangingBackoffEnd 3723 MIN-ACCESS read-only 3724 DESCRIPTION 3725 "Read-create in Cable Modem Termination Systems; 3726 read-only in Cable Modems." 3728 OBJECT docsIfUpChannelTxBackoffStart 3729 MIN-ACCESS read-only 3730 DESCRIPTION 3731 "Read-create in Cable Modem Termination Systems; 3732 read-only in Cable Modems." 3734 OBJECT docsIfUpChannelTxBackoffEnd 3735 MIN-ACCESS read-only 3736 DESCRIPTION 3737 "Read-create in Cable Modem Termination Systems; 3738 read-only in Cable Modems." 3740 OBJECT docsIfUpChannelScdmaActiveCodes 3741 MIN-ACCESS read-only 3742 DESCRIPTION 3743 "This object is always read-only in Cable Modems. The number of active 3744 codes when SCDMA is in use must range from 64 to 128, and must be a non- 3745 Prime value. Providing this range allows for the following features and 3746 capabilities: 3747 1) Power management in S-CDMA spreader-on frames (with a 3 dB spread) 3748 2) Avoidance of code 0 3749 3) Flexible minislot sizes with and without the use of code 0" 3751 OBJECT docsIfUpChannelScdmaCodesPerSlot 3752 MIN-ACCESS read-only 3753 DESCRIPTION 3754 "Read-create in Cable Modem Termination Systems; 3755 read-only in Cable Modems." 3757 OBJECT docsIfUpChannelScdmaFrameSize 3758 MIN-ACCESS read-only 3759 DESCRIPTION 3760 "Read-create in Cable Modem Termination Systems; 3761 read-only in Cable Modems." 3763 OBJECT docsIfUpChannelScdmaHoppingSeed 3764 MIN-ACCESS read-only 3765 DESCRIPTION 3766 "This object is always read-only in Cable Modems." 3768 OBJECT docsIfUpChannelType 3769 MIN-ACCESS read-only 3770 DESCRIPTION 3771 "Read-create in Cable Modem Termination Systems; 3772 read-only in Cable Modems." 3774 OBJECT docsIfUpChannelCloneFrom 3775 MIN-ACCESS read-only 3776 DESCRIPTION 3777 "Read-create in Cable Modem Termination Systems; 3778 read-only in Cable Modems." 3780 OBJECT docsIfUpChannelUpdate 3781 MIN-ACCESS read-only 3782 DESCRIPTION 3783 "Read-create in Cable Modem Termination Systems; 3784 read-only in Cable Modems." 3786 OBJECT docsIfUpChannelStatus 3787 MIN-ACCESS read-only 3788 DESCRIPTION 3789 "Read-create in Cable Modem Termination Systems; 3790 read-only in Cable Modems." 3792 OBJECT docsIfQosProfPriority 3793 MIN-ACCESS read-only 3794 DESCRIPTION 3795 "This object is always read-only in Cable Modems. 3796 It is compliant to implement this object as read-only 3797 in Cable Modem Termination Systems." 3799 OBJECT docsIfQosProfMaxUpBandwidth 3800 MIN-ACCESS read-only 3801 DESCRIPTION 3802 "This object is always read-only in Cable Modems. 3803 It is compliant to implement this object as read-only 3804 in Cable Modem Termination Systems." 3806 OBJECT docsIfQosProfGuarUpBandwidth 3807 MIN-ACCESS read-only 3808 DESCRIPTION 3809 "This object is always read-only in Cable Modems. 3810 It is compliant to implement this object as read-only 3811 in Cable Modem Termination Systems." 3813 OBJECT docsIfQosProfMaxDownBandwidth 3814 MIN-ACCESS read-only 3815 DESCRIPTION 3816 "This object is always read-only in Cable Modems. 3817 It is compliant to implement this object as read-only 3818 in Cable Modem Termination Systems." 3820 OBJECT docsIfQosProfBaselinePrivacy 3821 MIN-ACCESS read-only 3822 DESCRIPTION 3823 "This object is always read-only in Cable Modems. 3824 It is compliant to implement this object as read-only 3825 in Cable Modem Termination Systems." 3827 OBJECT docsIfQosProfStatus 3828 MIN-ACCESS read-only 3829 DESCRIPTION 3830 "This object is always read-only in Cable Modems. 3831 It is compliant to implement this object as read-only 3832 in Cable Modem Termination Systems." 3834 OBJECT docsIfQosProfMaxTransmitBurst 3835 MIN-ACCESS read-only 3836 DESCRIPTION 3837 "This object is always read-only in Cable Modems. 3838 It is compliant to implement this object as read-only 3839 in Cable Modem Termination Systems." 3841 OBJECT docsIfCmtsServiceAdminStatus 3842 MIN-ACCESS read-only 3843 DESCRIPTION 3844 "It is compliant to implement this object as read-only." 3846 OBJECT docsIfCmtsSyncInterval 3847 MIN-ACCESS read-only 3848 DESCRIPTION 3849 "It is compliant to implement this object as read-only." 3851 OBJECT docsIfCmtsUcdInterval 3852 MIN-ACCESS read-only 3853 DESCRIPTION 3854 "It is compliant to implement this object as read-only." 3856 OBJECT docsIfCmtsInsertInterval 3857 MIN-ACCESS read-only 3858 DESCRIPTION 3859 "It is compliant to implement this object as read-only." 3861 OBJECT docsIfCmtsInvitedRangingAttempts 3862 MIN-ACCESS read-only 3863 DESCRIPTION 3864 "It is compliant to implement this object as read-only." 3866 OBJECT docsIfCmtsQosProfilePermissions 3867 MIN-ACCESS read-only 3868 DESCRIPTION 3869 "It is compliant to implement this object as read-only." 3871 ::= { docsIfCompliances 1 } 3873 docsIfBasicGroup OBJECT-GROUP 3874 OBJECTS { 3875 docsIfDownChannelId, 3876 docsIfDownChannelFrequency, 3877 docsIfDownChannelWidth, 3878 docsIfDownChannelModulation, 3879 docsIfDownChannelInterleave, 3880 docsIfDownChannelPower, 3881 docsIfDownChannelAnnex, 3882 docsIfUpChannelId, 3883 docsIfUpChannelFrequency, 3884 docsIfUpChannelWidth, 3885 docsIfUpChannelModulationProfile, 3886 docsIfUpChannelSlotSize, 3887 docsIfUpChannelTxTimingOffset, 3888 docsIfUpChannelRangingBackoffStart, 3889 docsIfUpChannelRangingBackoffEnd, 3890 docsIfUpChannelTxBackoffStart, 3891 docsIfUpChannelTxBackoffEnd, 3892 docsIfUpChannelScdmaActiveCodes, 3893 docsIfUpChannelScdmaCodesPerSlot, 3894 docsIfUpChannelScdmaFrameSize, 3895 docsIfUpChannelScdmaHoppingSeed, 3896 docsIfUpChannelType, 3897 docsIfUpChannelCloneFrom, 3898 docsIfUpChannelUpdate, 3899 docsIfUpChannelStatus, 3900 docsIfQosProfPriority, 3901 docsIfQosProfMaxUpBandwidth, 3902 docsIfQosProfGuarUpBandwidth, 3903 docsIfQosProfMaxDownBandwidth, 3904 docsIfQosProfBaselinePrivacy, 3905 docsIfQosProfStatus, 3906 docsIfQosProfMaxTransmitBurst, 3907 docsIfSigQIncludesContention, 3908 docsIfSigQUnerroreds, 3909 docsIfSigQCorrecteds, 3910 docsIfSigQUncorrectables, 3911 docsIfSigQSignalNoise, 3912 docsIfSigQMicroreflections, 3913 docsIfSigQEqualizationData, 3914 docsIfDocsisBaseCapability 3915 } 3916 STATUS current 3917 DESCRIPTION 3918 "Group of objects implemented in both Cable Modems and 3919 Cable Modem Termination Systems." 3920 ::= { docsIfGroups 1 } 3922 docsIfCmGroup OBJECT-GROUP 3923 OBJECTS { 3924 docsIfCmCmtsAddress, 3925 docsIfCmCapabilities, 3926 docsIfCmRangingTimeout, 3927 -- docsIfCmRangingRespTimeout, 3928 docsIfCmStatusValue, 3929 docsIfCmStatusCode, 3930 docsIfCmStatusTxPower, 3931 docsIfCmStatusResets, 3932 docsIfCmStatusLostSyncs, 3933 docsIfCmStatusInvalidMaps, 3934 docsIfCmStatusInvalidUcds, 3935 docsIfCmStatusInvalidRangingResponses, 3936 docsIfCmStatusInvalidRegistrationResponses, 3937 docsIfCmStatusT1Timeouts, 3938 docsIfCmStatusT2Timeouts, 3939 docsIfCmStatusT3Timeouts, 3940 docsIfCmStatusT4Timeouts, 3941 docsIfCmStatusRangingAborteds, 3942 docsIfCmStatusDocsisOperMode, 3943 docsIfCmStatusModulationType, 3944 docsIfCmServiceQosProfile, 3945 docsIfCmServiceTxSlotsImmed, 3946 docsIfCmServiceTxSlotsDed, 3947 docsIfCmServiceTxRetries, 3948 docsIfCmServiceTxExceededs, 3949 docsIfCmServiceRqRetries, 3950 docsIfCmServiceRqExceededs, 3951 docsIfCmServiceExtTxSlotsImmed, 3952 docsIfCmServiceExtTxSlotsDed 3954 } 3955 STATUS current 3956 DESCRIPTION 3957 "Group of objects implemented in Cable Modems." 3958 ::= { docsIfGroups 2 } 3960 docsIfCmtsGroup OBJECT-GROUP 3961 OBJECTS { 3962 docsIfCmtsCapabilities, 3963 docsIfCmtsSyncInterval, 3964 docsIfCmtsUcdInterval, 3965 docsIfCmtsMaxServiceIds, 3966 -- docsIfCmtsInsertionInterval, 3967 docsIfCmtsInvitedRangingAttempts, 3968 docsIfCmtsInsertInterval, 3969 docsIfCmtsStatusInvalidRangeReqs, 3970 docsIfCmtsStatusRangingAborteds, 3971 docsIfCmtsStatusInvalidRegReqs, 3972 docsIfCmtsStatusFailedRegReqs, 3973 docsIfCmtsStatusInvalidDataReqs, 3974 docsIfCmtsStatusT5Timeouts, 3975 docsIfCmtsCmStatusMacAddress, 3976 docsIfCmtsCmStatusDownChannelIfIndex, 3977 docsIfCmtsCmStatusUpChannelIfIndex, 3978 docsIfCmtsCmStatusRxPower, 3979 docsIfCmtsCmStatusTimingOffset, 3980 docsIfCmtsCmStatusEqualizationData, 3981 docsIfCmtsCmStatusValue, 3982 docsIfCmtsCmStatusUnerroreds, 3983 docsIfCmtsCmStatusCorrecteds, 3984 docsIfCmtsCmStatusUncorrectables, 3985 docsIfCmtsCmStatusSignalNoise, 3986 docsIfCmtsCmStatusMicroreflections, 3987 docsIfCmtsCmStatusExtUnerroreds, 3988 docsIfCmtsCmStatusExtCorrecteds, 3989 docsIfCmtsCmStatusExtUncorrectables, 3990 docsIfCmtsCmStatusDocsisRegMode, 3991 docsIfCmtsCmStatusModulationType, 3992 docsIfCmtsCmStatusInetAddressType, 3993 docsIfCmtsCmStatusInetAddress, 3994 docsIfCmtsServiceAdminStatus, 3995 docsIfCmtsServiceQosProfile, 3996 docsIfCmtsServiceCreateTime, 3997 docsIfCmtsServiceInOctets, 3998 docsIfCmtsServiceInPackets, 3999 docsIfCmtsServiceNewCmStatusIndex, 4000 docsIfCmtsModType, 4001 docsIfCmtsModControl, 4002 docsIfCmtsModPreambleLen, 4003 docsIfCmtsModDifferentialEncoding, 4004 docsIfCmtsModFECErrorCorrection, 4005 docsIfCmtsModFECCodewordLength, 4006 docsIfCmtsModScramblerSeed, 4007 docsIfCmtsModMaxBurstSize, 4008 docsIfCmtsModGuardTimeSize, 4009 docsIfCmtsModLastCodewordShortened, 4010 docsIfCmtsModScrambler, 4011 docsIfCmtsModByteInterleaverDepth, 4012 docsIfCmtsModByteInterleaverBlockSize, 4013 docsIfCmtsModPreambleType, 4014 docsIfCmtsModTcmErrorCorrectionOn, 4015 docsIfCmtsModScdmaInterleaverStepSize, 4016 docsIfCmtsModScdmaSpreaderEnable, 4017 docsIfCmtsModScdmaSubframeCodes, 4018 docsIfCmtsModChannelType, 4019 docsIfCmtsQosProfilePermissions, 4020 docsIfCmtsCmPtr 4021 } 4022 STATUS current 4023 DESCRIPTION 4024 "Group of objects implemented in Cable Modem Termination 4025 Systems." 4026 ::= { docsIfGroups 3 } 4028 docsIfObsoleteGroup OBJECT-GROUP 4029 OBJECTS { 4030 docsIfCmRangingRespTimeout, 4031 docsIfCmtsInsertionInterval 4032 } 4033 STATUS obsolete 4034 DESCRIPTION 4035 "Group of objects obsoleted." 4036 ::= { docsIfGroups 4 } 4038 docsIfDeprecatedGroup OBJECT-GROUP 4039 OBJECTS { 4040 docsIfQosProfMaxTxBurst, 4041 docsIfCmtsCmStatusIpAddress, 4042 docsIfCmtsServiceCmStatusIndex 4043 } 4044 STATUS deprecated 4045 DESCRIPTION 4046 "Group of objects deprecated." 4047 ::= { docsIfGroups 5 } 4049 END 4050 5. Acknowledgments 4051 This document is a production of the Docsis 2.0 OSS Working Group. 4052 It is a revision based on RFC2670, "Radio Frequency (RF) Interface 4053 Management Information Base for DOCSIS compliant RF interfaces" [22]. 4055 The current editors wish to express gratitude to Rich Prodan, Greg 4056 Nakanishi, Rich Woundy, Eduardo Cardona, and Adi Shaliv for their 4057 valued advice and opinions. 4059 6. Revision History 4061 6.1. Scope 4063 This MIB in this document has been developed to accommodate DOCSIS 2.0 devices 4064 and their system capabilities. The MIB is an update to RFC2670 with the 4065 additional incorporation of EuroDocsis specific items and the DOCS_IF_EXT mib. 4067 6.2. Extension 4069 We have maintained the MIB objects as defined in RFC 2670. In some cases new mib 4070 objects have been created with identical functionality but greater capacity (ie 4071 32 to 64 bits). In these situations, both the original 32 bit objects and the new 4072 64 bit objects must be implemented. 4074 7. References 4076 [1] Harrington, D., Presuhn, R. and B. Wijnen, "An Architecture for 4077 Describing SNMP Management Frameworks", RFC 2571, April 1999. 4079 [2] Rose, M. and K. McCloghrie, "Structure and Identification of 4080 Management Information for TCP/IP-based Internets", STD 16, RFC 4081 1155, May 1990. 4083 [3] Rose, M. and K. McCloghrie, "Concise MIB Definitions", STD 16, 4084 RFC 1212, March 1991. 4086 [4] Rose, M., "A Convention for Defining Traps for use with the 4087 SNMP", RFC 1215, March 1991. 4089 [5] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Structure of 4090 Management Information for Version 2 (SMIv2)", STD 58, RFC 2578, 4091 April 1999. 4093 [6] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Textual 4094 Conventions for SMIv2", STD 58, RFC 2579, April 1999. 4096 [7] McCloghrie, K., Perkins, D. and J. Schoenwaelder, "Conformance 4097 Statements for SMIv2", STD 58, RFC 2580, April 1999. 4099 [8] Case, J., Fedor, M., Schoffstall, M. and J. Davin, "Simple 4100 Management Protocol", STD 15, RFC 1157, May 1990. 4102 [9] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, 4103 "Introduction to Community-based SNMPv2", RFC 1901, January 4104 1996. 4106 [10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Transport 4107 Mappings for Version 2 of the Simple Network Management Protocol 4108 (SNMPv2)", RFC 1906, January 1996. 4110 [11] Case, J., Harrington D., Presuhn R. and B. Wijnen, "Message 4111 Processing and Dispatching for the Simple Network Management 4112 Protocol (SNMP)", RFC 2572, April 1999. 4114 [12] Blumenthal, U. and B. Wijnen, "User-based Security Model (USM) 4115 for version 3 of the Simple Network Management Protocol 4116 (SNMPv3)", RFC 2574, April 1999. 4118 [13] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser, "Protocol 4119 Operations for Version 2 of the Simple Network Management 4120 Protocol (SNMPv2)", RFC 1905, January 1996. 4122 [14] Levi, D., Meyer, P. and B. Stewart, "SNMP Applications", RFC 4123 2573, April 1999. 4125 [15] Wijnen, B., Presuhn, R. and K. McCloghrie, "View-based Access 4126 Control Model (VACM) for the Simple Network Management Protocol 4127 (SNMP)", RFC 2575, April 1999. 4129 [16] "Data-Over-Cable Service Interface Specifications: Cable 4130 Modem Radio Frequency Interface Specification SP-RFI-I05-991105", 4131 DOCSIS, November 1999, http://www.cablemodem.com/. 4133 [17] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB 4134 using SMIv2", RFC 2863, June 2000. 4136 [18] StJohns, M. , "Cable Device Management Information Base for 4137 DOCSIS Compliant Cable Modems and Cable Modem Termination 4138 Systems", RFC2669, August 1999. 4140 [19] Proakis, John G., "Digital Communications, 3rd Edition", 4141 McGraw-Hill, New York, New York, 1995, ISBN 0-07-051726-6 4143 [20] "Transmission Systems for Interactive Cable Television Services, 4144 Annex B", J.112, International Telecommunications Union, March 4145 1998. 4147 [21] Case, J., Mundy, R., Partain, D., and B. Stewart, 4148 "Introduction to Version 3 of the Internet-standard Network Management 4149 Framework", RFC 2570, April 1999. 4151 [22] StJohns, M., "Radio Frequency (RF) Interface Management 4152 Information Base for MCNS/DOCSIS compliant RF interfaces", 4153 RFC 2670, August 1999. 4155 [23] "Data-Over-Cable Service Interface Specifications: Cable 4156 Modem Radio Frequency Interface Specification SP-RFIv1.1-I06- 4157 001215", DOCSIS, December 2000, http://www.cablemodem.com/. 4159 [24] "Document for the certification of EuroDOCSIS CMs and CMTSs, 4160 Version 3.3", EuroDOCSIS, February 2000. 4162 [25] "Data-Over-Cable Service Interface Specifications: Radio Frequency 4163 Interface Specification SP-RFIv2.0-W04-011119", DOCSIS 2.0 4164 November 2001. 4166 [26] "Data-Over-Cable Service Interface Specifications: Operations 4167 Support System Interface Specification SP-OSSIv2.0-W01-011119", 4168 DOCSIS 2.0 November 2001. 4170 [27] Woundy, R., "Baseline Privacy Interface Management 4171 Information Base for DOCSIS Compliant Cable Modems 4172 and Cable Modem Termination Systems", RFC3083, March 2001. 4174 [28] "Adapted MIB-definitions and a clarification for MPEG-related 4175 issues for EuroDOCSIS cable modem systems v1.01", tComLabs, 4176 May 2000. 4178 8. Security Considerations 4180 This MIB relates to a system which will provide metropolitan public 4181 internet access. As such, improper manipulation of the objects 4182 represented by this MIB may result in denial of service to a large 4183 number of end-users. In addition, manipulation of the 4184 docsIfCmServiceQosProfile, docsIfCmtsServerQosProfile, and the 4185 elements of docsIfQosProfileTable and docsIfCmtsModulationTable may 4186 allow an end-user to improve their service response or diminish other 4187 subscriber's service response. 4189 There are a number of management objects defined in this MIB that 4190 have a MAX-ACCESS clause of read-write and/or read-create. Such 4191 objects may be considered sensitive or vulnerable in some network 4192 environments. The support for SET operations in a non-secure 4193 environment without proper protection can have a negative effect on 4194 network operations. 4196 SNMPv1 by itself is not a secure environment. Even if the network 4197 itself is secure (for example by using IPSec), even then, there is no 4198 control as to who on the secure network is allowed to access and 4199 GET/SET (read/change/create/delete) the objects in this MIB. 4201 It is recommended that the implementers consider the security 4202 features as provided by the SNMPv3 framework. Specifically, the use 4203 of the User-based Security Model RFC 2574 [12] and the View- based 4204 Access Control Model RFC 2575 [15] is recommended. 4206 It is then a customer/user responsibility to ensure that the SNMP 4207 entity giving access to an instance of this MIB, is properly 4208 configured to give access to the objects only to those principals 4209 (users) that have legitimate rights to indeed GET or SET 4210 (change/create/delete) them. 4212 9. Changes from RFC2670 4214 Upstream now separated into 'physical interfaces' and 'logical channels'. An 4215 instance of the docsIfUpstreamChannelTable exists for each 'logical channel'. 4216 The IANA ifType for 'logical channels' is 205. The IANA ifType for 'physical 4217 interfaces' remains at 129. 4219 Object docsIfDownChannelAnnex added to docsIfDownstreamChannelTable. This object 4220 originated in the EuroDocsis specifications. 4222 Eight new objects added to the docsIfUpstreamChannelTable. One describes the 4223 channel type in use, while four are specific S-CDMA parameters. The remaining 4224 three additions are used in the creation of a temporary inactive upstream row 4225 so the S-CDMA parameters may be manipulated 'offline'. 4227 Object docsIfQosProfMaxTransmitBurst has been added to the docsIfQosProfileTable 4228 to replace deprecated object docsIfQosProfMaxTxBurst. This fixes a range error 4229 caused by switch to recording as bytes instead of minislots. 4231 A new base object docsIfDocsisBaseCapability has been added which mirrors the 4232 functionality of the docsifExt mib object docsIfDocsisCapability, extended to 4233 include Docsis 2.0. 4235 Two new objects added to the docsIfCmStatusTable. One indicates the current 4236 modulation type. The other mirrors the functionality of the docsIfExt object 4237 docsIfDocsisOperMode, while clarifying that it applies to the COS/QOS mode 4238 used by the device. 4240 Two new 64 bit counters added to the docsIfCmServiceTable to extend the capacity 4241 of existing 32 bit counters. 4243 Seven new objects added to the docsIfCmtsCmStatusTable. Three are 64 bit 4244 counters, two add ipv6 capability, and one indicates the CM modulation type 4245 in use. The remaining object mirrors the functionality of the docsIfExt object 4246 docsIfCmtsCmStatusDocsisMode, while clarifying that it applies to the COS/QOS 4247 mode used by the device. 4249 One object added to the docsIfCmtsServiceTable to fix a range error in an 4250 existing object, that has been deprecated. 4252 Eight new objects added to the docsIfCmtsModulationTable. Seven of these 4253 describe ATDMA/S-CDMA channel parameters, while the other describes modulation 4254 attributes common to all modulation types. 4256 Enumerated values for object docsIfDownChannelInterleave have been expanded to 4257 include a EuroDocsis value. 4259 Enumerated values for object docsIfCmtsModIntervalUsageCode have been expanded 4260 to include new Docsis 2.0 values. 4262 Enumerated values for object docsIfCmtsModType have been expanded to include new 4263 Docsis 2.0 values. 4265 Compliance statements have been updated to reflect new objects and to describe 4266 EuroDocsis specific implementation features. 4268 The descriptions of objects docsIfCmtsStatusInvalidRegReqs and 4269 docsIfCmtsStatusFailedRegReqs have been clarified. 4271 10. Conflict Resolution with docsIfExt MIB 4273 The docsIfExt MIB originated as an engineering change notification (ECN) to the 4274 Docsis 1.1 specifications, and consisted of three objects - two for CM 4275 implementation and one for the CMTS. These three objects have been incorporated 4276 into this new version of the RF MIB, and have been assigned new object 4277 identifiers. 4279 It is the intention of the authors to deprecate the docsIfExt MIB. Due to 4280 backward compatibility concerns with Docsis 1.1 implementations, both the new RF 4281 MIB objects and the former docsIfExt MIB objects will be required for Docsis 2.0 4282 designs for the immediate future. An influencing factor in this decision is that 4283 the docsCableDeviceTrap MIB (from the same design update as the docsIfExt MIB) 4284 contains references to docsIfExt MIB objects in various trap definitions. 4286 The following process will be used to accomplish the eventual deprecation of the 4287 docsIfExt MIB: 4289 1) Create a Docsis ECN that will require Docsis 1.1 implementations to 4290 support the new location of the three docsIfExt objects in the RF MIB. 4292 2) The same ECN will update the docsCableDeviceTrap MIB to reference the 4293 new location of the three docsIfExt objects, and deprecate the former 4294 references. 4296 3) The same ECN will deprecate the docsIfExt MIB. 4298 Following these steps, the state of affairs will be: 4299 a) Docsis 1.1 MUST support new RF MIB docsIfExt objects. 4300 b) Docsis 1.1 MAY support remaining RF MIB 2.0 objects. 4301 c) Docsis 1.1 MAY support former docsIfExt MIB objects. 4302 d) Docsis 2.0 MUST support all new RF MIB objects. 4303 e) Docsis 2.0 MAY support former docsIfExt MIB objects. 4305 11. Intellectual Property 4307 The IETF takes no position regarding the validity or scope of any 4308 intellectual property or other rights that might be claimed to 4309 pertain to the implementation or use of the technology described in 4310 this document or the extent to which any license under such rights 4311 might or might not be available; neither does it represent that it 4312 has made any effort to identify any such rights. Information on the 4313 IETF's procedures with respect to rights in standards-track and 4314 standards-related documentation can be found in BCP-11. Copies of 4315 claims of rights made available for publication and any assurances of 4316 licenses to be made available, or the result of an attempt made to 4317 obtain a general license or permission for the use of such 4318 proprietary rights by implementers or users of this specification can 4319 be obtained from the IETF Secretariat. 4321 The IETF invites any interested party to bring to its attention any 4322 copyrights, patents or patent applications, or other proprietary 4323 rights that may cover technology that may be required to practice 4324 this standard. Please address the information to the IETF Executive 4325 Director. 4327 12. Authors' Addresses 4329 Aviv Goren 4330 Terayon 4331 2952 Bunker Hill Lane 4332 Santa Clara, CA 4333 U.S.A. 4334 Phone: +1 408 727 4400 4335 E-mail: aviv.goren@terayon.com 4337 David Raftus 4338 Imedia Semiconductor 4339 340 Terry Fox Drive, Suite 202 4340 Ottawa Ontario 4341 Canada 4342 Phone: +1 613 592 1052 4343 E-mail: david.raftus@imedia.com 4345 13. Full Copyright Statement 4347 Copyright (C) The Internet Society (2002). All Rights Reserved. 4349 This document and translations of it may be copied and furnished to 4350 others, and derivative works that comment on or otherwise explain it 4351 or assist in its implementation may be prepared, copied, published 4352 and distributed, in whole or in part, without restriction of any 4353 kind, provided that the above copyright notice and this paragraph are 4354 included on all such copies and derivative works. However, this 4355 document itself may not be modified in any way, such as by removing 4356 the copyright notice or references to the Internet Society or other 4357 Internet organizations, except as needed for the purpose of 4358 developing Internet standards in which case the procedures for 4359 copyrights defined in the Internet Standards process must be 4360 followed, or as required to translate it into languages other than 4361 English. 4363 The limited permissions granted above are perpetual and will not be 4364 revoked by the Internet Society or its successors or assigns. 4366 This document and the information contained herein is provided on an 4367 "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING 4368 TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 4369 BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION 4370 HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF 4371 MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 4373 Acknowledgement 4375 Funding for the RFC Editor function is currently provided by the 4376 Internet Society.