idnits 2.17.1
draft-ietf-ipcdn-docs-rfmibv2-14.txt:
Checking boilerplate required by RFC 5378 and the IETF Trust (see
https://trustee.ietf.org/license-info):
----------------------------------------------------------------------------
** It looks like you're using RFC 3978 boilerplate. You should update this
to the boilerplate described in the IETF Trust License Policy document
(see https://trustee.ietf.org/license-info), which is required now.
-- Found old boilerplate from RFC 3978, Section 5.1 on line 17.
-- Found old boilerplate from RFC 3978, Section 5.5 on line 6777.
-- Found old boilerplate from RFC 3979, Section 5, paragraph 1 on line 6754.
-- Found old boilerplate from RFC 3979, Section 5, paragraph 2 on line 6761.
-- Found old boilerplate from RFC 3979, Section 5, paragraph 3 on line 6767.
** This document has an original RFC 3978 Section 5.4 Copyright Line,
instead of the newer IETF Trust Copyright according to RFC 4748.
** This document has an original RFC 3978 Section 5.5 Disclaimer, instead
of the newer disclaimer which includes the IETF Trust according to 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
Checking nits according to https://www.ietf.org/id-info/checklist :
----------------------------------------------------------------------------
-- The abstract seems to indicate that this document obsoletes RFC2670, but
the header doesn't have an 'Obsoletes:' line to match this.
Miscellaneous warnings:
----------------------------------------------------------------------------
== The copyright year in the RFC 3978 Section 5.4 Copyright Line does not
match the current year
== The document seems to use 'NOT RECOMMENDED' as an RFC 2119 keyword, but
does not include the phrase in its RFC 2119 key words list.
== Using lowercase 'not' together with uppercase 'MUST', 'SHALL', 'SHOULD',
or 'RECOMMENDED' is not an accepted usage according to RFC 2119. Please
use uppercase 'NOT' together with RFC 2119 keywords (if that is what you
mean).
Found 'MUST not' in this paragraph:
An entry in this table MUST not be removed while it is referenced
by an entry in docsIfCmServiceTable (Cable Modem) or
docsIfCmtsServiceTable (Cable Modem Termination System).
== Using lowercase 'not' together with uppercase 'MUST', 'SHALL', 'SHOULD',
or 'RECOMMENDED' is not an accepted usage according to RFC 2119. Please
use uppercase 'NOT' together with RFC 2119 keywords (if that is what you
mean).
Found 'SHOULD not' in this paragraph:
docsIfCmtsMacToCmTable OBJECT-TYPE SYNTAX SEQUENCE OF
DocsIfCmtsMacToCmEntry MAX-ACCESS not-accessible STATUS current
DESCRIPTION "This is a table to provide a quick access index into the
docsIfCmtsCmStatusTable. There is exactly one row in this table for each
row in the docsIfCmtsCmStatusTable. In general, the management station
SHOULD use this table only to get a pointer into the
docsIfCmtsCmStatusTable (which corresponds to the CM's RF interface MAC
address), and SHOULD not iterate (e.g. GetNext through) this table." ::=
{ docsIfCmtsObjects 7 }
-- 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 (October 23, 2005) is 6759 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)
-- Possible downref: Non-RFC (?) normative reference: ref. 'EN-300-429'
-- Possible downref: Non-RFC (?) normative reference: ref. 'IANA'
-- Obsolete informational reference (is this intentional?): RFC 2670
(Obsoleted by RFC 4546)
Summary: 3 errors (**), 0 flaws (~~), 5 warnings (==), 11 comments (--).
Run idnits with the --verbose option for more detailed information about
the items above.
--------------------------------------------------------------------------------
2 IP over Cable Data Network Working D. Raftus
3 Group ATI Technologies Inc.
4 Internet-Draft E. Cardona
5 Expires: April 26, 2006 CableLabs
6 October 23, 2005
8 Radio Frequency (RF) Interface Management Information Base for DOCSIS
9 2.0 compliant RF interfaces
10 draft-ietf-ipcdn-docs-rfmibv2-14
12 Status of this Memo
14 By submitting this Internet-Draft, each author represents that any
15 applicable patent or other IPR claims of which he or she is aware
16 have been or will be disclosed, and any of which he or she becomes
17 aware will be disclosed, in accordance with Section 6 of BCP 79.
19 Internet-Drafts are working documents of the Internet Engineering
20 Task Force (IETF), its areas, and its working groups. Note that
21 other groups may also distribute working documents as Internet-
22 Drafts.
24 Internet-Drafts are draft documents valid for a maximum of six months
25 and may be updated, replaced, or obsoleted by other documents at any
26 time. It is inappropriate to use Internet-Drafts as reference
27 material or to cite them other than as "work in progress."
29 The list of current Internet-Drafts can be accessed at
30 http://www.ietf.org/ietf/1id-abstracts.txt.
32 The list of Internet-Draft Shadow Directories can be accessed at
33 http://www.ietf.org/shadow.html.
35 This Internet-Draft will expire on April 26, 2006.
37 Copyright Notice
39 Copyright (C) The Internet Society (2005).
41 Abstract
43 This memo defines a portion of the Management Information Base (MIB)
44 for use with network management protocols in the Internet community.
45 In particular, it defines a set of managed objects for SNMP-based
46 management of the Radio Frequency (RF) interfaces for systems
47 compliant with the Data Over Cable Service Interface Specifications
48 (DOCSIS).
50 This document revises and obsoletes RFC 2670. Please see section 6
51 for a description of the changes from RFC 2670.
53 Note to RFC Editor (Remove this paragraph prior to publication) This
54 memo is a product of the IPCDN working group within the Internet
55 Engineering Task Force. Comments are solicited and should be
56 addressed to the working group's mailing list at ipcdn@ietf.org
57 and/or the author.
59 Table of Contents
61 1. The Internet-Standard Management Framework . . . . . . . . . 4
62 2. Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . 5
63 2.1. Baseline Privacy . . . . . . . . . . . . . . . . . . . . 5
64 2.2. CATV . . . . . . . . . . . . . . . . . . . . . . . . . . 5
65 2.3. Channel . . . . . . . . . . . . . . . . . . . . . . . . . 5
66 2.4. CM or Cable Modem . . . . . . . . . . . . . . . . . . . . 5
67 2.5. CMTS or Cable Modem Termination System . . . . . . . . . 5
68 2.6. Codeword . . . . . . . . . . . . . . . . . . . . . . . . 6
69 2.7. Data Packet . . . . . . . . . . . . . . . . . . . . . . . 6
70 2.8. dBmV . . . . . . . . . . . . . . . . . . . . . . . . . . 6
71 2.9. DOCSIS . . . . . . . . . . . . . . . . . . . . . . . . . 6
72 2.9.1. DOCSIS 1.0 . . . . . . . . . . . . . . . . . . . . . 6
73 2.9.2. DOCSIS 1.1 . . . . . . . . . . . . . . . . . . . . . 6
74 2.9.3. DOCSIS 2.0 . . . . . . . . . . . . . . . . . . . . . 6
75 2.10. Downstream . . . . . . . . . . . . . . . . . . . . . . . 7
76 2.11. Euro-DOCSIS . . . . . . . . . . . . . . . . . . . . . . . 7
77 2.12. Head-end . . . . . . . . . . . . . . . . . . . . . . . . 7
78 2.13. MAC Packet . . . . . . . . . . . . . . . . . . . . . . . 7
79 2.14. MCNS . . . . . . . . . . . . . . . . . . . . . . . . . . 7
80 2.15. Mini-slot . . . . . . . . . . . . . . . . . . . . . . . . 7
81 2.16. QPSK Quadrature Phase Shift Keying . . . . . . . . . . 7
82 2.17. QAM Quadrature Amplitude Modulation . . . . . . . . . . 7
83 2.18. RF . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
84 2.19. Symbol-times . . . . . . . . . . . . . . . . . . . . . . 7
85 2.20. Upstream . . . . . . . . . . . . . . . . . . . . . . . . 8
86 3. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 9
87 3.1. Textual Conventions . . . . . . . . . . . . . . . . . . . 9
88 3.1.1. Textual Conventions in RFC 2670 . . . . . . . . . . . 9
89 3.1.2. Textual Conventions in RFC XXXX . . . . . . . . . . . 9
90 3.2. Structure of the MIB . . . . . . . . . . . . . . . . . . 9
91 3.2.1. docsIfBaseObjects . . . . . . . . . . . . . . . . . . 10
92 3.2.2. docsIfCmObjects . . . . . . . . . . . . . . . . . . . 10
93 3.2.3. docsIfCmtsObjects . . . . . . . . . . . . . . . . . . 10
94 3.2.4. Relationship to the Interfaces MIB module . . . . . . 11
95 3.2.5. Offline Upstream Parameters Handling . . . . . . . . 25
96 4. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 27
97 5. Revision History . . . . . . . . . . . . . . . . . . . . . . 137
98 5.1. Scope . . . . . . . . . . . . . . . . . . . . . . . . . . 137
99 5.2. Extension . . . . . . . . . . . . . . . . . . . . . . . . 137
100 5.3. Changes from RFC 2670 . . . . . . . . . . . . . . . . . . 137
101 6. Security Considerations . . . . . . . . . . . . . . . . . . . 140
102 7. IANA considerations . . . . . . . . . . . . . . . . . . . . . 142
103 8. Management Interoperability of DOCSIS 1.0, 1.1 and 2.0 . . . 143
104 9. References . . . . . . . . . . . . . . . . . . . . . . . . . 144
105 9.1. Normative References . . . . . . . . . . . . . . . . . . 144
106 9.2. Informative References . . . . . . . . . . . . . . . . . 145
107 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 147
108 Intellectual Property and Copyright Statements . . . . . . . . . 148
110 1. The Internet-Standard Management Framework
112 For a detailed overview of the documents that describe the current
113 Internet-Standard Management Framework, please refer to section 7 of
114 RFC 3410 [RFC3410].
116 Managed objects are accessed via a virtual information store, termed
117 the Management Information Base or MIB. MIB objects are generally
118 accessed through the Simple Network Management Protocol (SNMP).
119 Objects in the MIB are defined using the mechanisms defined in the
120 Structure of Management Information (SMI). This memo specifies a MIB
121 module that is compliant to the SMIv2, which is described in STD 58,
122 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
123 [RFC2580].
125 2. Glossary
127 The terms in this document are derived either from normal cable
128 system usage, or from the documents associated with the Data Over
129 Cable Service Interface Specification process.
131 2.1. Baseline Privacy
133 Security interface specification designed for DOCSIS compliant cable
134 data systems that ensures device authentication data confidentiality
135 in the CATV plant. See [BPI] and [BPIPLUS].
137 2.2. CATV
139 Originally "Community Antenna Television", now used to refer to any
140 cable or hybrid fiber and cable system used to deliver video signals
141 to a community.
143 2.3. Channel
145 A specific frequency allocation with an RF medium, specified by
146 channel width in Hertz (cycles per second) and by center frequency.
147 Within the US Cable Systems, upstream channels are generally
148 allocated from the 5-42MHz range while downstream channels are
149 generally allocated from the 50-750MHz range depending on the
150 capabilities of the given system. The typical broadcast channel
151 width in the US is 6MHz. Upstream channel widths for DOCSIS vary.
153 For European cable systems, upstream channels vary by country. The
154 upper edge of upstream channel allocations vary between 25 MHz to 65
155 MHz, and the lower edge of downstream channel allocations vary
156 between 47 MHz and 87.5 MHz. The typical broadcast channel width in
157 Europe is 8MHz. The actual parameters are of concern to systems
158 deploying Euro-DOCSIS technology.
160 The downstream channels conform to the requirements of ITU-T
161 Recommendation J.83 [ITU-T_J.83]
163 2.4. CM or Cable Modem
165 A CM acts as a "slave" station in a DOCSIS compliant cable data
166 system.
168 2.5. CMTS or Cable Modem Termination System
170 A generic term covering a cable bridge or cable router in a head-end.
171 A CMTS acts as the master station in a DOCSIS compliant cable data
172 system. It is the only station that transmits downstream, and it
173 controls the scheduling of upstream transmissions by its associated
174 CMs.
176 2.6. Codeword
178 A characteristic of the Forward Error Correction scheme used above
179 the RF media layer.
181 See "Data-Over-Cable Service Interface Specifications: Radio
182 Frequency Interface Specification SP-RFIv2.0-I09-050812"
184 2.7. Data Packet
186 The payload portion of the MAC Packet.
188 2.8. dBmV
190 A measure of RF signal voltage amplitude, whose power level is
191 determined by the characteristic impedance. A zero dB signal power
192 is equivalent to 48.75 dBmV signal amplitude in a 75 Ohm system.
194 2.9. DOCSIS
196 "Data Over Cable Service Interface Specification". A term referring
197 to the ITU-T J112 [ITU-T_J.112] Annex B standard for cable modem
198 systems.
200 2.9.1. DOCSIS 1.0
202 Cable modem systems CM/CMTS compliant to requirements in [RFI1.0]. A
203 common reference to DOCSIS 1.0 in this document is the upstream
204 channel queuing mechanism known as Class of Service (COS).
206 2.9.2. DOCSIS 1.1
208 Cable modem systems CM/CMTS compliant to requirements in [ITU-
209 T_J.112]. DOCSIS 1.1 references in this document are in part
210 associated with the upstream and downstream Quality of Service (QOS).
211 The term DOCSIS 1.x is used in this document to refer both DOCSIS 1.0
212 and DOCSIS 1.1.
214 2.9.3. DOCSIS 2.0
216 Cable modem systems CM/CMTS compliant to requirements in [ITU-
217 T_J.122]. DOCSIS 2.0 corresponds to the second generation of radio-
218 frequency interface specifications of DOCSIS.
220 2.10. Downstream
222 The direction from the head-end towards the subscriber.
224 2.11. Euro-DOCSIS
226 Cable modem systems CM/CMTS conforming to the European spectrum
227 lineup and compliant to requirements of Annex F in [ITU-T_J.122].
229 2.12. Head-end
231 The origination point in most cable systems of the subscriber video
232 signals. Generally also the location of the CMTS equipment.
234 2.13. MAC Packet
236 A DOCSIS PDU.
238 2.14. MCNS
240 "Multimedia Cable Network System". Generally replaced in usage by
241 DOCSIS.
243 2.15. Mini-slot
245 In general, an interval of time which is allocated by the CMTS to a
246 given CM for that CM to transmit in an upstream direction. See [ITU-
247 T_J.122]
249 2.16. QPSK Quadrature Phase Shift Keying
251 A particular modulation scheme on an RF medium. See [Proakis00].
253 2.17. QAM Quadrature Amplitude Modulation
255 A particular modulation scheme on RF medium. Usually expressed with
256 a number indicating the size of the modulation constellation (e.g. 16
257 QAM). See [Proakis00].
259 2.18. RF
261 Radio Frequency.
263 2.19. Symbol-times
265 A characteristic of the RF modulation scheme. See [ITU-T_J.122].
267 2.20. Upstream
269 The direction from the subscriber towards the head-end.
271 3. Overview
273 This MIB module provides a set of objects required for the management
274 of DOCSIS compliant Cable Modem (CM) and Cable Modem Termination
275 System (CMTS) RF interfaces. The specification is derived in part
276 from the parameters and protocols described in [ITU-T_J.122].
278 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
279 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
280 document are to be interpreted as described in [RFC2119].
282 3.1. Textual Conventions
284 This MIB module define new textual conventions for CMs and CMTSs
285 indication of DOCSIS 2.0 RFI capabilities, configuration, usage and
286 backward compatible modes of operation defined in [RFI2.0] With the
287 same purpose, there are some textual conventions that represent
288 capabilities and modes of operation of [RFI1.1] that are not covered
289 by RFC 2670, and are managed proprietarily in DOCSIS OSSI 1.1
290 specification [OSSI1.1].
292 3.1.1. Textual Conventions in RFC 2670
294 RFC 2670 defined two textual conventions: TenthdBmV and TenthdB which
295 are power measurement representations.
297 3.1.2. Textual Conventions in RFC XXXX
299 Note to RFC editor: RFC editor to replace XXXX with this RFC number,
300 then, delete note.
302 This MIB module defines the textual convention DocsisUpstreamType to
303 represent the DOCSIS 1.0 [RFI1.0] and DOCSIS 2.0 [RFI2.0] upstream
304 burst modulation profiles types.
306 This MIB module defines the textual conventions DocsisVersion and
307 DocsisQosVersion to represent the DOCSIS 1.0 [RFI1.0] and DOCSIS 1.1
308 [RFI1.1] COS/QOS capabilities and modes of operation.
310 3.2. Structure of the MIB
312 This MIB module is structured as three groups:
314 o Management information pertinent to both Cable Modem (CM) and
315 Cable Modem Termination System (CMTS) (docsIfBaseObjects).
317 o Management information pertinent to Cable Modem only
318 (docsIfCmObjects).
320 o Management information pertinent to Cable Modem Termination System
321 only (docsIfCmtsObjects).
323 Tables within each of these groups cover diferent functions - e.g.
324 upstream queue services, channel characteristics, MAC layer
325 management, etc. Rows created automatically (e.g. by the device
326 according to the hardware configuration) may and generally will have
327 a mixture of configuration and status objects within them. Rows that
328 are meant to be created by the management station are generally
329 restricted to configuration (read-create) objects.
331 3.2.1. docsIfBaseObjects
333 docsIfDownstreamChannelTable - This table describes the existing
334 downstream channels for a CMTS and the received downstream channel
335 for a CM.
337 docsIfUpstreamChannelTable - This table describes the existing
338 upstream channels for a CMTS and the current upstream transmission
339 channel for a CM.
341 docsIfQosProfileTable - This table describes the valid Quality of
342 Service profiles for the cable data system.
344 docsIfSignalQualityTable - This table is used to monitor RF signal
345 quality characteristics of received signals.
347 docsIfDocsisBaseCapability - This object is used to indicate the
348 highest level of DOCSIS version a cable device can support.
350 3.2.2. docsIfCmObjects
352 docsIfCmMacTable - This table is used to monitor the DOCSIS MAC
353 interface and can be considered an extension to the ifEntry.
355 docsIfCmStatusTable - This table maintains a number of status objects
356 and counters for cable modems. There is a comparable table at the
357 CMTS, docsIfCmtsCmStatusTable, which maintains similar counters from
358 the CMTS point of view.
360 docsIfCmServiceTable - This table describes the upstream service
361 queues available at this CM. There is a comparable table at the
362 CMTS, docsIfCmtsServiceEntry, which describes the service queues from
363 the point of view of the CMTS.
365 3.2.3. docsIfCmtsObjects
367 docsIfCmtsMacTable - Describes the attributes of each CMTS MAC
368 interface.
370 docsIfCmtsStatusTable - This table provides a set of aggregated
371 counters which roll-up values and events that occur on the underlying
372 sub-interfaces.
374 docsIfCmtsCmStatusTable - This table is used to hold information
375 about known (i.e. ranging, registered, and/or previously online)
376 cable modems on the system serviced by this CMTS.
378 docsIfCmtsServiceTable - This table provides access to the
379 information related to upstream service queues.
381 docsIfCmtsModulationTable - This table allows control over the
382 modulation profiles for RF channels associated with this CMTS.
384 docsIfCmtsMacToCmTable - This table allows fast access into the
385 docsIfCmtsCmTable via a MAC address (of the CM) interface.
387 docsIfCmtsChannelUtilizationTable - This table provides statistical
388 load usage data for attached upstream and downstream physical
389 channels.
391 docsIfCmtsDownChannelCounterTable - This table provides statistical
392 data for attached downstream channels, appropriate as input for load
393 usage calculations.
395 docsIfCmtsUpChannelCounterTable - This table provides statistical
396 data for attached upstream channels, appropriate as input for load
397 usage calculations.
399 3.2.4. Relationship to the Interfaces MIB module
401 This section clarifies the relationship of this MIB module to the
402 Interfaces MIB [RFC2863]. Several areas of correlation are addressed
403 in the following subsections. The implementer is referred to the
404 Interfaces MIB document in order to understand the general intent of
405 these areas.
407 3.2.4.1. Layering Model
409 An instance of ifEntry exists for each RF downstream interface, for
410 each RF upstream interface, for each upstream logical Channel and for
411 each RF MAC layer.
413 The ifStackTable [RFC2863] MUST be implemented to identify the
414 relationships among sub-interfaces.
416 The following example illustrates a CMTS MAC interface with one
417 downstream and two upstream interfaces.
419 | <== to network layer
420 +------------------ --+-------------------------------+
421 | RF MAC |
422 +--+------------------+------------------------+------+
423 | | |
424 +-------+-----+ +------+------+ +------+------+
425 | Downstream1 | | Upstream1 | | Upstream2 |
426 | | | | | |
427 +-------------+ ++-----------++ ++-----------++
428 | | | |
429 +----+----+ +----+----+ +----+----+ +----+----+
430 | Ch-1 | | Ch-2 | | Ch-1 | | Ch-2 |
431 |(A/TDMA) | |(S-CDMA) | |(A/TDMA) | |(S-CDMA) |
432 +---------+ +---------+ +---------+ +---------+
434 Figure 1
436 As can be seen from this example, the RF MAC interface is layered on
437 top of the downstream and upstream interfaces, and the RF upstream
438 interface is layered on top of an upstream logical channel.
440 In this example, the assignment of index values could be as follows:
442 ifIndex ifType Description
444 2 docsCableMaclayer(127) CATV MAC Layer
445 3 docsCableDownstream(128) CATV Downstream interface
446 4 docsCableUpstream(129) CATV Upstream interface
447 5 docsCableUpstream(129) CATV Upstream interface
448 6 docsCableUpstreamChannel(205) CATV Upstream Channel
449 7 docsCableUpstreamChannel(205) CATV Upstream Channel
450 8 docsCableUpstreamChannel(205) CATV Upstream Channel
451 9 docsCableUpstreamChannel(205) CATV Upstream Channel
453 Figure 2
455 The corresponding ifStack entries would then be:
457 | IfStackHigherLayer | ifStackLowerLayer |
458 | 0 | 2 |
459 | 2 | 3 |
460 | 2 | 4 |
461 | 2 | 5 |
462 | 4 | 6 |
463 | 4 | 7 |
464 | 5 | 8 |
465 | 5 | 9 |
466 | 3 | 0 |
467 | 6 | 0 |
468 | 7 | 0 |
469 | 8 | 0 |
470 | 9 | 0 |
472 The same interface model can also be used in Telephony or Telco
473 Return systems. A pure Telco Return system (Cable Modem as well as
474 Cable Modem Termination System) would not have upstream, but only
475 downstream cable channels. Systems supporting both Telco Return and
476 cable upstream channels can use the above model without modification.
478 Telco Return upstream channel(s) management is outside the scope of
479 this document.
481 3.2.4.2. Virtual Circuits
483 This medium does not support virtual circuits and this area is not
484 applicable to this MIB module.
486 3.2.4.3. ifTestTable
488 The ifTestTable is optional for DOCSIS CM/CMTS implementations, but
489 is not specifically influenced by the RF MIB.
491 3.2.4.4. ifRcvAddressTable
493 The ifRcvAddressTable is optional for DOCSIS CM/CMTS implementations,
494 but is not specifically influenced by the RF MIB.
496 3.2.4.5. ifEntry
498 This section documents only the differences from the requirements
499 specified in the Interfaces MIB module. See that MIB module for
500 columns omitted from the descriptions below.
502 3.2.4.5.1. ifEntry for downstream interfaces
504 The ifEntry for downstream interfaces supports the
505 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces MIB
506 module. This is an output only interface at the CMTS and all input
507 status counters - ifIn* - will return zero. This is an input only
508 interface at the CM and all output status counters - ifOut* - will
509 return zero.
511 3.2.4.5.1.1. ifEntry for downstream interfaces in Cable Modem
512 Termination System
514 ifTable Comments
515 ============== ===========================================
516 ifIndex Each CATV Downstream interface is represented
517 by an ifEntry.
519 ifType The IANA value of docsCableDownstream(128).
521 ifSpeed Return the speed of this downstream channel.
522 The returned value is the raw bandwidth in bits/s
523 of this interface. This is the symbol rate
524 multiplied with the number of bits per symbol.
526 ifHighSpeed Return the speed of this downstream channel.
527 The returned value is the raw bandwidth in
528 megabits/s of this interface. This is the symbol
529 rate multiplied with the number of bits per
530 symbol.
532 ifPhysAddress Return the zero-length OCTET STRING.
534 ifAdminStatus The administrative status of this interface.
536 ifOperStatus The current operational status of this interface.
538 ifMtu The size of the largest frame which can be
539 sent on this interface, specified in octets.
540 The value includes the length of the MAC header.
542 ifInOctets
543 ifHCInOctets Return zero.
545 ifInUcastPkts
546 ifHCInUcastPkts Return zero.
548 ifInMulticastPkts
549 ifHCInMulticastPkts
550 Return zero.
552 ifInBroadcastPkts
553 ifHCInBroadcastPkts
554 Return zero.
556 ifInDiscards Return zero.
558 ifInErrors Return zero.
560 ifInUnknownProtos Return zero.
562 ifOutOctets
563 ifHCOutOctets The total number of octets transmitted on this
564 interface. This includes MAC packets as well as
565 data packets, and includes the length of the MAC
566 header.
567 ifOutUcastPkts
568 ifHCOutUcastPkts The number of unicast packets transmitted on this
569 interface. This includes MAC packets as well as
570 data packets.
572 ifOutMulticastPkts
573 ifHCOutMulticastPkts
574 Return the number of multicast packets
575 transmitted on this interface.
576 This includes MAC packets as well as data
577 packets.
579 ifOutBroadcastPkts
580 ifHCOutBroadcastPkts
581 Return the number of broadcast packets transmitted
582 on this interface.
583 This includes MAC packets as well as data packets.
585 ifOutDiscards The total number of outbound packets which
586 were discarded. Possible reasons are:
587 buffer shortage.
589 ifOutErrors The number of packets which could not be
590 transmitted due to errors.
592 ifPromiscuousMode Return false.
594 3.2.4.5.1.2. ifEntry for downstream interfaces in Cable Modem
596 ifTable Comments
597 ============== ===========================================
598 ifIndex Each CATV Downstream interface is represented
599 by an ifEntry.
601 ifType The IANA value of docsCableDownstream(128).
603 ifSpeed Return the speed of this downstream channel.
604 The returned value the raw bandwidth in bits/s
605 of this interface. This is the symbol rate
606 multiplied with the number of bits per symbol.
608 ifHighSpeed Return the speed of this downstream channel.
609 The returned value the raw bandwidth in megabits/s
610 of this interface. This is the symbol rate
611 multiplied with the number of bits per symbol.
613 ifPhysAddress Return the zero-length OCTET STRING.
615 ifAdminStatus The administrative status of this interface.
617 ifOperStatus The current operational status of this interface.
619 ifMtu The size of the largest frame which can be
620 received from this interface, specified in octets.
621 The value includes the length of the MAC header.
623 ifInOctets
624 ifHCInOctets The total number of octets received on this
625 interface. This includes data packets as well as
626 MAC packets, and includes the length of the
627 MAC header.
629 ifInUcastPkts
630 ifHCInUcastPkts The number of unicast packets received on this
631 interface. This includes data packets as well as
632 MAC packets.
634 ifInMulticastPkts
635 ifHCInMulticastPkts
636 Return the number of multicast packets received
637 on this interface. This includes data packets as
638 well as MAC packets.
640 ifInBroadcastPkts
641 ifHCInBroadcastPkts
642 Return the number of broadcast packets received
643 on this interface. This includes data packets
644 as well as MAC packets.
646 ifInDiscards The total number of received packets that have
647 been discarded.
648 The possible reasons are: buffer shortage.
650 ifInErrors The number of inbound packets that contained
651 errors preventing them from being deliverable
652 to higher layers.
653 Possible reasons are: MAC FCS error.
655 ifInUnknownProtos The number of frames with an unknown packet type.
656 These are MAC frames with an unknown packet type.
658 ifOutOctets Return zero.
659 ifHCOutOctets
661 ifOutUcastPkts Return zero.
662 ifHCOutUcastPkts
664 ifOutMulticastPkts
665 ifHCOutMulticastPkts
666 Return zero.
668 ifOutBroadcastPkts
669 ifHCOutBroadcastPkts
670 Return zero.
672 ifOutDiscards Return zero.
674 ifOutErrors Return zero.
676 ifPromiscuousMode Refer to the Interfaces MIB.
678 3.2.4.5.2. ifEntry for upstream interfaces
680 Each supported interface of the type docsCableUpstream(129) must have
681 a corresponding ifEntry. The ifEntry for upstream interfaces
682 supports the ifGeneralInformationGroup and the ifPacketGroup of the
683 Interfaces MIB. This is an input only interface at the CMTS and all
684 output status counters - ifOut* - will return zero. This is an
685 output only interface at the CM and all input status counters - ifIn*
686 - will return zero.
688 3.2.4.5.2.1. ifEntry for upstream interfaces in Cable Modem Termination
689 System
691 ifTable Comments
692 ============== ===========================================
693 ifIndex Each RF Cable Upstream interface is represented
694 by an ifEntry.
696 ifType The IANA value of docsCableUpstream (129).
698 ifSpeed Return the maximum channel throughput (not payload
699 throughput) supported by the interface.
700 The maximum throughput is calculated for the case
701 where upstream channels are configured to maximize
702 interface throughput.
704 ifHighSpeed Return the maximum channel throughput (not payload
705 throughput) supported by the interface.
706 The maximum throughput is calculated for the case
707 where upstream channels are configured to maximize
708 interface throughput. Units for this object are
709 (1/1 000 000) * IfSpeed.
711 ifPhysAddress Return the zero-length OCTET STRING.
713 ifAdminStatus The administrative status of this interface.
715 ifOperStatus The current operational status of this interface.
716 This reflects the total status of all the channels
717 under this interface. So if at least one channel
718 has a physical connection this interface has
719 connection.
721 ifMtu The size of the largest frame which can be
722 transmitted on this interface, specified in
723 octets. The value includes the length of the MAC
724 header. This is the maximum of all the ifMtu of
725 all the channels under this interface.
727 ifInOctets
728 ifHCInOctets The total (sum) number of octets received on all
729 the upstream channels under this
730 interface. This includes data packets as well as
731 MAC packets, and includes the length of the
732 MAC header.
734 ifInUcastPkts
735 ifHCInUcastPkts The total number of unicast packets received on
736 all the upstream channels under this
737 interface. This includes data packets as well as
738 MAC packets.
740 ifInMulticastPkts
741 ifHCInMulticastPkts
742 Return the total number of multicast packets
743 received on all the upstream channels under this
744 interface. This includes data packets as well as
745 MAC layer packets.
747 ifInBroadcastPkts
748 ifHCInBroadcastPkts
749 Return the total number of broadcast packets
750 received on all the upstream channels under this
751 interface. This includes data packets as well as
752 MAC packets.
754 ifInDiscards The total number of received packets, which have
755 been discarded on all the upstream channels under
756 this interface.
757 The possible reasons are: buffer shortage.
759 ifInErrors The total number of inbound packets that contained
760 errors preventing them from being deliverable
761 to higher layers.
762 Possible reasons are: MAC FCS error.
764 ifInUnknownProtos The total number of frames with an unknown packet
765 type. These are MAC frames with an unknown packet
766 type.
768 ifOutOctets Return zero.
769 ifHCOutOctets
771 ifOutUcastPkts Return zero.
772 ifHCOutOctets
774 ifOutMulticastPkts
775 ifHCOutMulticastPkts
776 Return zero.
778 ifOutBroadcastPkts
779 ifHCOutBroadcastPkts
780 Return zero.
782 ifOutDiscards Return zero.
784 ifOutErrors Return zero.
786 3.2.4.5.2.2. ifEntry for upstream interfaces in Cable Modem
788 ifTable Comments
789 ============== ===========================================
790 ifIndex Each RF Cable Upstream interface is represented
791 by an ifEntry.
793 ifType The IANA value of docsCableUpstream (129).
795 ifSpeed Return the speed of this upstream interface.
796 The returned value is the raw bandwidth
797 in bits/s of this interface.
799 ifHighSpeed Return the speed of this upstream interface.
800 The returned value is the raw bandwidth
801 in megabits/s of this interface.
803 ifPhysAddress Return the zero-length OCTET STRING.
805 ifAdminStatus The administrative status of this interface.
807 ifOperStatus The current operational status of this interface.
809 ifMtu The size of the largest frame which can be
810 transmitted on this interface, specified in
811 octets. The value includes the length of the MAC
812 header.
814 ifInOctets Return zero.
815 ifHCInOctets
817 ifInUcastPkts Return zero.
818 ifHCInUcastPkts
820 ifInMulticastPkts
821 ifHCInMulticastPkts
822 Return zero.
824 ifInBroadcastPkts
825 ifHCInBroadcastPkts
826 Return zero.
828 ifInDiscards Return zero.
830 ifInErrors Return zero.
832 ifInUnknownProtos Return zero.
834 ifOutOctets
835 ifHCOutOctets The total number of octets transmitted on this
836 interface. This includes MAC packets as well as
837 data packets, and includes the length of the MAC
838 header.
840 ifOutUcastPkts
841 ifHCOutUcastPkts The number of unicast packets transmitted on this
842 interface. This includes MAC packets as well as
843 data packets.
845 ifOutMulticastPkts
846 ifHCOutMulticastPkts
847 Return the number of multicast packets transmitted
848 on this interface.
849 This includes MAC packets as well as data packets.
851 ifOutBroadcastPkts
852 ifHCOutBroadcastPkts
853 Return the number of broadcast packets transmitted
854 on this interface.
855 This includes MAC packets as well as data packets.
857 ifOutDiscards The total number of outbound packets which
858 were discarded. Possible reasons are:
859 buffer shortage.
861 ifOutErrors The number of packets which could not be
862 transmitted due to errors.
864 ifPromiscuousMode Return false.
866 3.2.4.5.3. ifEntry for upstream channels
868 Each supported channel of the type docsCableUpstreamChannel(205) must
869 have a corresponding ifEntry.
871 The ifEntry for upstream channels supports the
872 ifGeneralInformationGroup and the ifPacketGroup of the Interfaces
873 MIB. This is an input only interface at the CMTS and all output
874 status counters - ifOut* - will return zero. DOCSIS CMs are not
875 required to support logical upstream channels.
877 3.2.4.5.3.1. ifEntry for upstream Channels in Cable Modem Termination
878 System
880 ifTable Comments
881 ============== ===========================================
882 ifIndex Each RF Cable Upstream channel is represented
883 by an ifEntry.
885 ifType The IANA value of docsCableUpstreamChannel (205).
887 ifSpeed Return the speed of this upstream channel.
888 The returned value is the raw bandwidth
889 in bits/s of this channel.
891 ifHighSpeed Return the speed of this upstream channel.
892 The returned value is the raw bandwidth
893 in megabits/s of this channel.
895 ifPhysAddress Return the zero-length OCTET STRING.
897 ifAdminStatus The administrative status of this interface.
899 ifOperStatus The current operational status of this interface.
901 ifMtu The size of the largest frame which can be
902 received on this interface, specified in octets.
903 The value includes the length of the MAC header.
905 ifInOctets The total number of octets received on this
906 interface. This includes data packets as well as
907 MAC packets, and includes the length of the
908 MAC header.
910 ifInUcastPkts
911 ifHCInUcastPkts
912 The number of unicast packets received on this
913 interface. This includes data packets as well as
914 MAC packets.
916 ifInMulticastPkts
917 ifHCInMulticastPkts
918 Return the number of multicast packets received
919 on this interface. This includes data packets as
920 well as MAC layer packets.
922 ifInBroadcastPkts
923 ifHCInBroadcastPkts
924 Return the number of broadcast packets received
925 on this interface. This includes data packets
926 as well as MAC packets.
928 ifInDiscards The total number of received packets that have
929 been discarded.
930 The possible reasons are: buffer shortage.
932 ifInErrors The number of inbound packets that contained
933 errors preventing them from being deliverable
934 to higher layers.
935 Possible reasons are: MAC FCS error.
937 ifInUnknownProtos The number of frames with an unknown packet type.
938 These are MAC frames with an unknown packet type.
940 ifOutOctets Return zero.
941 ifHCOutOctets
943 ifOutUcastPkts Return zero.
944 ifHCOutUcastPkts
946 ifOutMulticastPkts
947 ifHCOutMulticastPkts
948 Return zero.
950 ifOutBroadcastPkts
951 ifHCOutBroadcastPkts
952 Return zero.
954 ifOutDiscards Return zero.
956 ifOutErrors Return zero.
958 3.2.4.5.4. ifEntry for the MAC Layer
960 The ifEntry for the MAC Layer supports the ifGeneralInformationGroup
961 and the ifPacketGroup of the Interfaces MIB. This interface provides
962 an aggregate view of status for the lower level downstream and
963 upstream interfaces.
965 ifTable Comments
966 ============== ===========================================
967 ifIndex Each RF Cable MAC layer entity is represented
968 by an ifEntry.
970 ifType The IANA value of docsCableMaclayer(127).
972 ifSpeed Return zero.
974 ifPhysAddress Return the physical address of this interface.
976 ifAdminStatus The administrative status of this interface.
978 ifOperStatus The current operational status of the MAC
979 layer interface.
981 ifHighSpeed Return zero.
983 ifMtu Return 1500.
985 ifInOctets
986 ifHCInOctets The total number of data octets received on this
987 interface, targeted for upper protocol layers.
989 ifInUcastPkts
990 ifHCInUcastPkts The number of unicast packets received on this
991 interface, targeted for upper protocol layers.
993 ifInMulticastPkts
994 ifHCInMulticastPkts
995 Return the number of multicast packets received
996 on this interface, targeted for upper protocol
997 layers.
999 ifInBroadcastPkts
1000 ifHCInBroadcastPkts
1001 Return the number of broadcast packets received
1002 on this interface, targeted for upper protocol
1003 layers.
1005 ifInDiscards The total number of received packets that have
1006 been discarded.
1007 The possible reasons are: buffer shortage.
1009 ifInErrors The number of inbound packets that contained
1010 errors preventing them from being deliverable
1011 to higher layers.
1012 Possible reasons are: data packet FCS error,
1013 invalid MAC header.
1015 ifInUnknownProtos The number of frames with an unknown packet type.
1016 This is the number of data packets targeted for
1017 upper protocol layers with an unknown packet type.
1019 ifOutOctets The total number of octets, received from upper
1020 ifHCOutOctets protocol layers and transmitted on this interface.
1022 ifOutUcastPkts
1023 ifHCOutUcastPkts The number of unicast packets, received from upper
1024 protocol layers and transmitted on this interface.
1026 ifOutMulticastPkts
1027 ifHCOutMulticastPkts
1028 Return the number of multicast packets received
1029 from upper protocol layers and transmitted on this
1030 interface.
1032 ifOutBroadcastPkts
1033 ifHCOutBroadcastPkts
1034 Return the number of broadcast packets received
1035 from upper protocol layers and transmitted on this
1036 interface.
1038 ifOutDiscards The total number of outbound packets which
1039 were discarded. Possible reasons are:
1040 buffer shortage.
1042 ifOutErrors The number of packets which could not be
1043 transmitted due to errors.
1045 ifPromiscuousMode Refer to the Interfaces MIB.
1047 3.2.5. Offline Upstream Parameters Handling
1049 3.2.5.1. Overview
1051 This section describes the offline configuration of the DOCSIS 2.0
1052 upstream logical interface parameters. The purpose of this feature
1053 is to guarantee that upstream logical interface parameters such as
1054 modulation profile, channel yype, mini-slot Size and SCDMA attributes
1055 are consistent prior to commit changes to an active upstream logical
1056 interface. This mechanism can reduce possible downtime of the
1057 upstream interface by minimizing SNMP SET operations to in-service
1058 upstream interfaces. This mechanism is supported by CMTSs and is not
1059 applicable to CMs.
1061 3.2.5.2. Operation
1063 This mechanism uses three upstream channel MIB objects defined for
1064 DOCSIS 2.0 CMTS implementations:
1066 docsIfUpChannelStatus - The RowStatus object for the creation of
1067 temporary interfaces in the upstream interface table. A temporary
1068 entry is used to modify, validate and commit upstream parameters of a
1069 physical interface. In the CMTS, a physical upstream interfaces
1070 refers to an upstream logical channel interface.
1072 docsIfUpChannelCloneFrom - This MIB object has the function to
1073 associate a physical interface with a temporary interface for the
1074 purpose of updating the upstream parameters of the physical
1075 interface.
1077 docsIfUpChannelUpdate - This MIB object is the commit object that
1078 transfer the validated upstream parameters from the temporary
1079 interface to the physical interface.
1081 The offline upstream parameters handling operation is as follows:
1083 o A temporary interface is create with docsIfUpChannelStatus set to
1084 'createAndWait', which turns the new create entry status to
1085 'notReady'.
1087 o A SET to docsIfUpChannelCloneFrom in the temporary interface to
1088 the physical interface ifIndex value performs two actions:
1090 * Create the association of the physical interface to the
1091 temporary interface.
1093 * Copy the original upstream parameters from the physical
1094 interface to the temporary interface which turns its status to
1095 'notInService'.
1097 o The operator modifies the temporary interface parameters to the
1098 desired values.
1100 o At this point, a SET to 'active' to the RowStatus of the temporary
1101 interface is successful if all parameters in the temporary
1102 interface are valid for the associated physical interface;
1103 otherwise, the temporary entry remains with status 'notInservice'
1104 and the SET returns error 'commitFailed'.
1106 o When the temporary interface status is 'active' a SET to
1107 docsIfUpChannelUpdate to 'true' transfer the temporary interface
1108 parameters values to the physical interface.
1110 o After completion of the update operations, the temporary interface
1111 is destroyed setting the docsIfUpChannelStatus to 'destroy'.
1113 3.2.5.3. Relation of docsIfUpChannelStatus and ifMib
1115 The main purpose of docsIfUpChannelStatus is the creation of
1116 temporary interfaces for offline handling of the configuration of
1117 physical interfaces; It does not manage the creation or control of
1118 physical interfaces. To maintain a consistent operation and status
1119 report of interfaces, this object does not manage the administrative
1120 and operational status of physical interfaces.
1122 4. Definitions
1124 DOCS-IF-MIB DEFINITIONS ::= BEGIN
1126 IMPORTS
1127 MODULE-IDENTITY,
1128 OBJECT-TYPE,
1129 Unsigned32,
1130 Integer32,
1131 Counter32,
1132 Counter64,
1133 TimeTicks,
1134 IpAddress,
1135 transmission
1136 FROM SNMPv2-SMI -- [RFC2578]
1137 TEXTUAL-CONVENTION,
1138 MacAddress,
1139 RowStatus,
1140 TruthValue,
1141 TimeInterval,
1142 TimeStamp,
1143 StorageType
1144 FROM SNMPv2-TC -- [RFC2579]
1145 OBJECT-GROUP,
1147 MODULE-COMPLIANCE
1148 FROM SNMPv2-CONF -- [RFC2580]
1149 ifIndex, InterfaceIndexOrZero
1150 FROM IF-MIB -- [RFC2863]
1151 InetAddressType,
1152 InetAddress
1153 FROM INET-ADDRESS-MIB -- [RFC4001]
1154 IANAifType
1155 FROM IANAifType-MIB; -- [IANA]
1157 docsIfMib MODULE-IDENTITY
1158 LAST-UPDATED "200510240000Z" -- October 24, 2005
1159 ORGANIZATION "IETF IPCDN Working Group"
1160 CONTACT-INFO
1161 " David Raftus
1162 Postal: ATI Technologies Inc.
1163 340 Terry Fox Drive, Suite 202
1164 Ottawa Ontario
1165 Canada
1166 Phone: +1 613 592 1052 ext.222
1167 E-mail: david.raftus@ati.com
1169 Eduardo Cardona
1170 Postal:
1171 Cable Television Laboratories, Inc.
1172 858 Coal Creek Circle
1173 Louisville, CO 80027-9750
1174 U.S.A.
1175 Tel: +1 303 661 9100
1176 Fax: +1 303 661 9199
1177 E-mail: e.cardona@cablelabs.com;mibs@cablelabs.com
1179 IETF IPCDN Working Group
1180 General Discussion: ipcdn@ietf.org
1181 Subscribe: http://www.ietf.org/mailman/listinfo/ipcdn
1182 Archive: ftp://ftp.ietf.org/ietf-mail-archive/ipcdn
1183 Co-chairs: Richard Woundy, Richard_Woundy@cable.comcast.com
1184 Jean-Francois Mule, jf.mule@cablelabs.com"
1185 DESCRIPTION
1186 "This is the MIB Module for DOCSIS 2.0 compliant Radio
1187 Frequency (RF) interfaces in Cable Modem and
1188 Cable Modem Termination System.
1190 Copyright (C) The Internet Society (2005). This
1191 version of this MIB module is part of RFC XXXX; see
1192 the RFC itself for full legal notices."
1194 REVISION "200510240000Z"
1195 DESCRIPTION
1196 "Revision of the IETF RF MIB module for DOCSIS 2.0.
1197 This version published as RFC XXXX.
1198 This MIB module revision includes among others:
1199 Usage of ifType (205)for upstream Logical channels
1200 Addition of downstream and upstream utilization
1201 counters.
1202 Additional Statistics per upstream interface.
1203 Upstream channel offline configuration mechanism.
1204 Added MIB support for new DOCSIS 2.0 modulation
1205 attributes.
1206 Euro-DOCSIS downstream interleve values.
1207 Adjustments to RFC 2670 definitions based on
1208 the MIB review guidelines from the IETF
1209 Operations and Management Area (OPS)."
1210 -- Note to RFC editor:
1211 -- RFC editor to replace XXXX with this RFC number
1212 -- Delete this note
1214 REVISION "199908190000Z"
1215 DESCRIPTION
1216 "Initial Version, published as RFC 2670.
1217 Modified by Mike StJohns to fix problems identified by
1218 the first pass of the MIB doctor. Of special note,
1219 docsIfRangingResp and docsIfCmtsInsertionInterval were
1220 obsoleted and replaced by other objects with the same
1221 functionality, but more appropriate SYNTAX."
1222 ::= { transmission 127 }
1224 -- Textual Conventions
1226 TenthdBmV ::= TEXTUAL-CONVENTION
1227 DISPLAY-HINT "d-1"
1228 STATUS current
1229 DESCRIPTION
1230 "This data type represents power levels that are normally
1231 expressed in dBmV. Units are in tenths of a dBmV;
1232 for example, 5.1 dBmV will be represented as 51."
1233 SYNTAX Integer32
1235 TenthdB ::= TEXTUAL-CONVENTION
1236 DISPLAY-HINT "d-1"
1237 STATUS current
1238 DESCRIPTION
1239 "This data type represents power levels that are normally
1240 expressed in dB. Units are in tenths of a dB;
1241 for example, 5.1 dB will be represented as 51."
1242 SYNTAX Integer32
1244 DocsisVersion ::= TEXTUAL-CONVENTION
1245 STATUS current
1246 DESCRIPTION
1247 "Indicates the DOCSIS Radio Frequency specification being
1248 referenced.
1249 'docsis10' indicates DOCSIS 1.0,
1250 'docsis11' indicates DOCSIS 1.1
1251 'docsis20' indicates DOCSIS 2.0"
1252 SYNTAX INTEGER {
1253 docsis10 (1),
1254 docsis11 (2),
1255 docsis20 (3)
1256 }
1258 DocsisQosVersion ::= TEXTUAL-CONVENTION
1259 STATUS current
1260 DESCRIPTION
1261 "Indicates the referenced quality of service
1262 level.
1263 'docsis10 refers to DOCSIS 1.0 Class of
1264 Service queuing services, 'docsis11' refers
1265 to DOCSIS 1.1 Quality of Service."
1266 SYNTAX INTEGER {
1267 docsis10 (1),
1268 docsis11 (2)
1269 }
1271 DocsisUpstreamType ::= TEXTUAL-CONVENTION
1272 STATUS current
1273 DESCRIPTION
1274 "Indicates the DOCSIS Upstream Channel Type.
1275 'unknown' means not information available.
1276 'tdma' is related to TDMA, Time Division
1277 Multiple Access, 'atdma' is related to A-TDMA,
1278 Advanced Time Division Multiple Access,
1279 'scdma' is related to S-CDMA, Synchronous
1280 Code Division Multiple Access
1281 'tdmaAndAtdma is related to simultaneous support of
1282 TDMA and A-TDMA modes."
1283 SYNTAX INTEGER {
1284 unknown(0),
1285 tdma(1),
1286 atdma(2),
1287 scdma(3),
1288 tdmaAndAtdma(4)
1289 }
1291 DocsEqualizerData ::= TEXTUAL-CONVENTION
1292 STATUS current
1293 DESCRIPTION
1294 "This data type represents the equalizer data
1295 as measured at the receiver interface.
1296 The format of the equalizer follows the structure of the
1297 Transmit Equalization Adjust RNG-RSP TLV of DOCSIS RFI
1298 v2.0 :
1299 1 byte Main tap location 1..(n + m)
1300 1 byte Number of forward taps per symbol
1301 1 byte Number of forward taps: n
1302 1 byte Number of reverse taps: m
1304 Following are the equalizer coefficients:
1305 First forward taps coefficients :
1306 2 bytes F1 (real), 2 bytes F1 (imag)
1307 ...
1308 2 bytes Fn (real), 2 bytes Fn (imag)
1310 Then reverse taps coefficients :
1311 2 bytes D1 (real), 2 bytes D1 (imag)
1312 ...
1314 2 bytes Dm (real), 2 bytes Dm (imag)
1316 The equalizers coefficient are considered signed 16 bit
1317 integers in the range -32768 (0x8000) to 32767 (0x7FFF).
1319 DOCSIS specifications requires up to a maximum of
1320 64 equalizer taps (n + m), therefore, this object size
1321 can get up 260 bytes (4 + 4x64).
1322 The minimum object size (other than zero) for a t-spaced
1323 Tap with a minimum of 8 symbols will be 36 (4 + 4x8)."
1324 REFERENCE
1325 "Data-Over-Cable Service Interface Specifications: Radio
1326 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1327 Figure 8-23."
1328 SYNTAX OCTET STRING(SIZE (0 | 36..260))
1330 docsIfMibObjects OBJECT IDENTIFIER ::= { docsIfMib 1 }
1331 docsIfBaseObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 1 }
1332 docsIfCmObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 2 }
1333 docsIfCmtsObjects OBJECT IDENTIFIER ::= { docsIfMibObjects 3 }
1335 --
1336 -- BASE GROUP
1337 --
1339 --
1340 -- The following table is implemented on both the Cable Modem
1341 -- and the Cable Modem Termination System. This table is
1342 -- read only for the CM.
1343 --
1345 docsIfDownstreamChannelTable OBJECT-TYPE
1346 SYNTAX SEQUENCE OF DocsIfDownstreamChannelEntry
1347 MAX-ACCESS not-accessible
1348 STATUS current
1349 DESCRIPTION
1350 "This table describes the attributes of downstream
1351 channels (frequency bands)."
1352 REFERENCE
1353 "Data-Over-Cable Service Interface Specifications: Radio
1354 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1355 Tables 6-16, and 6-17."
1356 ::= { docsIfBaseObjects 1 }
1358 docsIfDownstreamChannelEntry OBJECT-TYPE
1359 SYNTAX DocsIfDownstreamChannelEntry
1360 MAX-ACCESS not-accessible
1361 STATUS current
1362 DESCRIPTION
1363 "An entry provides a list of attributes for a single
1364 downstream channel.
1365 An entry in this table exists for each ifEntry with an
1366 ifType of docsCableDownstream(128)."
1367 INDEX { ifIndex }
1368 ::= { docsIfDownstreamChannelTable 1 }
1370 DocsIfDownstreamChannelEntry ::= SEQUENCE {
1371 docsIfDownChannelId Integer32,
1372 docsIfDownChannelFrequency Integer32,
1373 docsIfDownChannelWidth Integer32,
1374 docsIfDownChannelModulation INTEGER,
1375 docsIfDownChannelInterleave INTEGER,
1376 docsIfDownChannelPower TenthdBmV,
1377 docsIfDownChannelAnnex INTEGER,
1378 docsIfDownChannelStorageType StorageType
1379 }
1381 docsIfDownChannelId OBJECT-TYPE
1382 SYNTAX Integer32 (0..255)
1383 MAX-ACCESS read-only
1384 STATUS current
1385 DESCRIPTION
1386 "The Cable Modem Termination System identification of the
1387 downstream channel within this particular MAC interface.
1388 if the interface is down, the object returns the most
1389 current value. If the downstream channel ID is unknown,
1390 this object returns a value of 0."
1391 ::= { docsIfDownstreamChannelEntry 1 }
1393 docsIfDownChannelFrequency OBJECT-TYPE
1394 SYNTAX Integer32 (0..1000000000)
1395 UNITS "hertz"
1396 MAX-ACCESS read-write
1397 STATUS current
1398 DESCRIPTION
1399 "The center of the downstream frequency associated with
1400 this channel. This object will return the current tuner
1401 frequency. If a CMTS provides IF output, this object
1402 will return 0, unless this CMTS is in control of the
1403 final downstream frequency. See the associated
1404 compliance object for a description of valid frequencies
1405 that may be written to this object."
1407 REFERENCE
1408 "Data-Over-Cable Service Interface Specifications: Radio
1409 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1410 Section 6.3.3."
1411 ::= { docsIfDownstreamChannelEntry 2 }
1413 docsIfDownChannelWidth OBJECT-TYPE
1414 SYNTAX Integer32 (0..16000000)
1415 UNITS "hertz"
1416 MAX-ACCESS read-write
1417 STATUS current
1418 DESCRIPTION
1419 "The bandwidth of this downstream channel. Most
1420 implementations are expected to support a channel width
1421 of 6 MHz (North America) and/or 8 MHz (Europe). See the
1422 associated compliance object for a description of the
1423 valid channel widths for this object."
1424 REFERENCE
1425 "Data-Over-Cable Service Interface Specifications: Radio
1426 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1427 Table 6-17."
1428 ::= { docsIfDownstreamChannelEntry 3 }
1430 docsIfDownChannelModulation OBJECT-TYPE
1431 SYNTAX INTEGER {
1432 unknown(1),
1433 other(2),
1434 qam64(3),
1435 qam256(4)
1436 }
1437 MAX-ACCESS read-write
1438 STATUS current
1439 DESCRIPTION
1440 "The modulation type associated with this downstream
1441 channel. If the interface is down, this object either
1442 returns the configured value (CMTS), the most current
1443 value (CM), or the value of unknown(1). See the
1444 associated conformance object for write conditions and
1445 limitations. See the reference for specifics on the
1446 modulation profiles implied by qam64 and qam256."
1447 REFERENCE
1448 "Data-Over-Cable Service Interface Specifications: Radio
1449 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1450 Table 6-17."
1451 ::= { docsIfDownstreamChannelEntry 4 }
1453 docsIfDownChannelInterleave OBJECT-TYPE
1454 SYNTAX INTEGER {
1455 unknown(1),
1456 other(2),
1457 taps8Increment16(3),
1458 taps16Increment8(4),
1459 taps32Increment4(5),
1460 taps64Increment2(6),
1461 taps128Increment1(7),
1462 taps12increment17(8)
1463 }
1464 MAX-ACCESS read-write
1465 STATUS current
1466 DESCRIPTION
1467 "The Forward Error Correction (FEC) interleaving used
1468 for this downstream channel.
1469 Values are defined as follows:
1470 taps8Increment16(3): protection 5.9/4.1 usec,
1471 latency .22/.15 msec
1472 taps16Increment8(4): protection 12/8.2 usec,
1473 latency .48/.33 msec
1474 taps32Increment4(5): protection 24/16 usec,
1475 latency .98/.68 msec
1476 taps64Increment2(6): protection 47/33 usec,
1477 latency 2/1.4 msec
1478 taps128Increment1(7): protection 95/66 usec,
1479 latency 4/2.8 msec
1480 taps12increment17(8): protection 18/14 usec,
1481 latency 0.43/0.32 msec
1483 The value 'taps12increment17' is supported by EuroDOCSIS
1484 cable systems only and the others by DOCSIS cable systems.
1486 If the interface is down, this object either returns
1487 the configured value (CMTS), the most current value (CM),
1488 or the value of unknown(1).
1489 The value of other(2) is returned if the interleave
1490 is known but not defined in the above list.
1491 See the associated conformance object for write
1492 conditions and limitations. See the reference for the FEC
1493 configuration described by the setting of this object."
1494 REFERENCE
1495 "Data-Over-Cable Service Interface Specifications: Radio
1496 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1497 Table 6-15."
1498 ::= { docsIfDownstreamChannelEntry 5 }
1500 docsIfDownChannelPower OBJECT-TYPE
1501 SYNTAX TenthdBmV
1502 UNITS "dBmV"
1503 MAX-ACCESS read-write
1504 STATUS current
1505 DESCRIPTION
1506 "At the CMTS, the operational transmit power. At the CM,
1507 the received power level.
1508 If the interface is down, this object either returns
1509 the configured value (CMTS), the most current value (CM)
1510 or the value of 0. See the associated conformance object
1511 for write conditions and limitations. See the reference
1512 for recommended and required power levels."
1513 REFERENCE
1514 "Data-Over-Cable Service Interface Specifications: Radio
1515 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1516 Tables 6-16, 6-17."
1517 ::= { docsIfDownstreamChannelEntry 6 }
1519 docsIfDownChannelAnnex OBJECT-TYPE
1520 SYNTAX INTEGER {
1521 unknown(1),
1522 other(2),
1523 annexA(3),
1524 annexB(4),
1525 annexC(5)
1526 }
1527 MAX-ACCESS read-only
1528 STATUS current
1529 DESCRIPTION
1530 "The value of this object indicates the conformance of
1531 the implementation to important regional cable standards.
1532 annexA : Annex A from ITU-T J.83 is used
1533 (equivalent to EN 300 429)
1534 annexB : Annex B from ITU-T J.83 is used.
1535 annexC : Annex C from ITU-T J.83 is used."
1536 REFERENCE
1537 "Data-Over-Cable Service Interface Specifications: Radio
1538 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1539 Sections 6.3.1, and H.3.1."
1540 ::= { docsIfDownstreamChannelEntry 7 }
1542 docsIfDownChannelStorageType OBJECT-TYPE
1543 SYNTAX StorageType
1544 MAX-ACCESS read-only
1545 STATUS current
1546 DESCRIPTION
1547 "The storage type for this conceptual row.
1548 Entries with this object set to permanent(4)
1549 do not require write operations for read-write
1550 objects."
1552 ::= { docsIfDownstreamChannelEntry 8 }
1554 --
1555 -- The following table is implemented on both the CM and the CMTS.
1556 -- For the CM, only attached channels appear in the table. For the
1557 -- CM, this table is read only as well.
1558 --
1560 docsIfUpstreamChannelTable OBJECT-TYPE
1561 SYNTAX SEQUENCE OF DocsIfUpstreamChannelEntry
1562 MAX-ACCESS not-accessible
1563 STATUS current
1564 DESCRIPTION
1565 "This table describes the attributes of attached upstream
1566 channels."
1567 ::= { docsIfBaseObjects 2 }
1569 docsIfUpstreamChannelEntry OBJECT-TYPE
1570 SYNTAX DocsIfUpstreamChannelEntry
1571 MAX-ACCESS not-accessible
1572 STATUS current
1573 DESCRIPTION
1574 "List of attributes for a single upstream channel. For
1575 DOCSIS 2.0 CMTSs, an entry in this table exists for
1576 each ifEntry with an ifType of docsCableUpstreamChannel
1577 (205).
1578 For DOCSIS 1.x CM/CMTSs and DOCSIS 2.0 CMs, an entry in
1579 this table exists for each ifEntry with an ifType of
1580 docsCableUpstream (129).
1582 For DOCSIS 2.0 CMTSs two classes of interfaces can be
1583 defined for this table:
1584 o Upstream Physical Interfaces: The traditional DOCSIS
1585 1.x CMTS upstream interface ifType 129 and the DOCSIS
1586 2.0 ifType 205 that are functional. In other words,
1587 interfaces that represents upstream receivers within
1588 an RF MAC interface.
1589 Entries of physical interfaces are exposed to the
1590 management interface with their corresponding
1591 ifStack hierarchy and are not administratively
1592 created by this table.
1594 o Upstream Temporary Interfaces: A fictitious
1595 interface created with the purpose of manipulating
1596 the parameters of a physical interface parameters
1597 offline, then the parameters are validated prior to
1598 update the target physical interface.
1600 In case of a reinitialization of the managed system,
1601 Physial interfaces values persist while the temporary
1602 interfaces are not recreated.
1604 This mechanism helps to minimize service disruption
1605 originated in situations where a group of interface
1606 parameters values need to be inconsistent each other
1607 in SET operations. Instead, a temporary buffer
1608 (temporary interface) is provided to allow the CMTS
1609 to validate the parameters offline."
1610 INDEX { ifIndex }
1611 ::= { docsIfUpstreamChannelTable 1 }
1613 DocsIfUpstreamChannelEntry ::= SEQUENCE {
1614 docsIfUpChannelId Integer32,
1615 docsIfUpChannelFrequency Integer32,
1616 docsIfUpChannelWidth Integer32,
1617 docsIfUpChannelModulationProfile Unsigned32,
1618 docsIfUpChannelSlotSize Unsigned32,
1619 docsIfUpChannelTxTimingOffset Unsigned32,
1620 docsIfUpChannelRangingBackoffStart Integer32,
1621 docsIfUpChannelRangingBackoffEnd Integer32,
1622 docsIfUpChannelTxBackoffStart Integer32,
1623 docsIfUpChannelTxBackoffEnd Integer32,
1624 docsIfUpChannelScdmaActiveCodes Unsigned32,
1625 docsIfUpChannelScdmaCodesPerSlot Integer32,
1626 docsIfUpChannelScdmaFrameSize Unsigned32,
1627 docsIfUpChannelScdmaHoppingSeed Unsigned32,
1628 docsIfUpChannelType DocsisUpstreamType,
1629 docsIfUpChannelCloneFrom InterfaceIndexOrZero,
1630 docsIfUpChannelUpdate TruthValue,
1631 docsIfUpChannelStatus RowStatus,
1632 docsIfUpChannelPreEqEnable TruthValue
1633 }
1635 docsIfUpChannelId OBJECT-TYPE
1636 SYNTAX Integer32 (0..255)
1637 MAX-ACCESS read-only
1638 STATUS current
1639 DESCRIPTION
1640 "The CMTS identification of the upstream channel."
1641 ::= { docsIfUpstreamChannelEntry 1 }
1643 docsIfUpChannelFrequency OBJECT-TYPE
1644 SYNTAX Integer32 (0..1000000000)
1645 UNITS "hertz"
1646 MAX-ACCESS read-create
1647 STATUS current
1648 DESCRIPTION
1649 "The center of the frequency band associated with this
1650 upstream interface. This object returns 0 if the frequency
1651 is undefined or unknown. Minimum permitted upstream
1652 frequency is 5,000,000 Hz for current technology. See
1653 the associated conformance object for write conditions
1654 and limitations."
1655 REFERENCE
1656 "Data-Over-Cable Service Interface Specifications: Radio
1657 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1658 Table 4-2."
1659 ::= { docsIfUpstreamChannelEntry 2 }
1661 docsIfUpChannelWidth OBJECT-TYPE
1662 SYNTAX Integer32 (0..64000000)
1663 UNITS "hertz"
1664 MAX-ACCESS read-create
1665 STATUS current
1666 DESCRIPTION
1667 "The bandwidth of this upstream interface. This object
1668 returns 0 if the interface width is undefined or unknown.
1669 Minimum permitted interface width is 200,000 Hz currently.
1670 See the associated conformance object for write conditions
1671 and limitations."
1672 REFERENCE
1673 "Data-Over-Cable Service Interface Specifications: Radio
1674 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1675 Table 6-5."
1676 ::= { docsIfUpstreamChannelEntry 3 }
1678 docsIfUpChannelModulationProfile OBJECT-TYPE
1679 SYNTAX Unsigned32
1680 MAX-ACCESS read-create
1681 STATUS current
1682 DESCRIPTION
1683 "An entry identical to the docsIfModIndex in the
1684 docsIfCmtsModulationTable that describes this channel.
1685 This channel is further instantiated there by a grouping
1686 of interval usage codes (IUCs)which together fully describe
1687 the channel modulation. This object returns 0 if the
1688 docsIfCmtsModulationTable entry does not exist or is empty.
1689 See the associated conformance object for write conditions
1690 and limitations.
1692 Setting this object returns an 'inconsistentValue' error
1693 error if the following conditions are not satisfied:
1694 1. All the IUC entries in the selected modulation profile
1695 MUST have the same value of docsIfCmtsModChannelType.
1697 2. All of the Modulation parameters in the selected
1698 modulation profile MUST be consistent with the other
1699 parameters in this docsIfUpstreamChannelEntry."
1700 REFERENCE
1701 "Data-Over-Cable Service Interface Specifications: Radio
1702 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1703 Table 8-19."
1704 ::= { docsIfUpstreamChannelEntry 4 }
1706 docsIfUpChannelSlotSize OBJECT-TYPE
1707 SYNTAX Unsigned32
1708 UNITS "ticks"
1709 MAX-ACCESS read-create
1710 STATUS current
1711 DESCRIPTION
1712 "Applicable to TDMA and ATDMA channel types only.
1713 The number of 6.25 microsecond ticks in each upstream
1714 mini-slot. Returns zero if the value is undefined, unknown
1715 or in case of an SCDMA channel.
1716 See the associated conformance object for write
1717 conditions and limitations."
1718 REFERENCE
1719 "Data-Over-Cable Service Interface Specifications: Radio
1720 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1721 Section 8.1.2.4."
1722 ::= { docsIfUpstreamChannelEntry 5 }
1724 docsIfUpChannelTxTimingOffset OBJECT-TYPE
1725 SYNTAX Unsigned32
1726 MAX-ACCESS read-only
1727 STATUS current
1728 DESCRIPTION
1729 "At the CM, a measure of the current round trip time
1730 obtained from the ranging offset (initial ranging offset +
1731 ranging offset adjustments).
1732 At the CMTS, the maximum of timing offset, among all the
1733 CMs that are/were present on the channel, taking into
1734 account all ( initial + periodic ) timing offset
1735 corrections that were sent for each of the CMs. Generally,
1736 these measurements are positive, but if the measurements
1737 are negative, the value of this object is zero. Used for
1738 timing of CM upstream transmissions to ensure synchronized
1739 arrivals at the CMTS.
1740 Units are one 64th fraction of 6.25 microseconds."
1741 REFERENCE
1742 "Data-Over-Cable Service Interface Specifications: Radio
1743 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1744 Section 6.2.19."
1746 ::= { docsIfUpstreamChannelEntry 6 }
1748 docsIfUpChannelRangingBackoffStart OBJECT-TYPE
1749 SYNTAX Integer32 (0..16)
1750 MAX-ACCESS read-create
1751 STATUS current
1752 DESCRIPTION
1753 "The initial random backoff window to use when retrying
1754 Ranging Requests. Expressed as a power of 2. A value of
1755 16 at the CMTS indicates that a proprietary adaptive retry
1756 mechanism is to be used. See the associated conformance
1757 object for write conditions and limitations."
1758 REFERENCE
1759 "Data-Over-Cable Service Interface Specifications: Radio
1760 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1761 Sections 8.3.4, and 9.4."
1762 ::= { docsIfUpstreamChannelEntry 7 }
1764 docsIfUpChannelRangingBackoffEnd OBJECT-TYPE
1765 SYNTAX Integer32 (0..16)
1766 MAX-ACCESS read-create
1767 STATUS current
1768 DESCRIPTION
1769 "The final random backoff window to use when retrying
1770 Ranging Requests. Expressed as a power of 2. A value of
1771 16 at the CMTS indicates that a proprietary adaptive retry
1772 mechanism is to be used. See the associated conformance
1773 object for write conditions and limitations."
1774 REFERENCE
1775 "Data-Over-Cable Service Interface Specifications: Radio
1776 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1777 Section 8.3.4, and 9.4."
1778 ::= { docsIfUpstreamChannelEntry 8 }
1780 docsIfUpChannelTxBackoffStart OBJECT-TYPE
1781 SYNTAX Integer32 (0..16)
1782 MAX-ACCESS read-create
1783 STATUS current
1784 DESCRIPTION
1785 "The initial random backoff window to use when retrying
1786 transmissions. Expressed as a power of 2. A value of 16
1787 at the CMTS indicates that a proprietary adaptive retry
1788 mechanism is to be used. See the associated conformance
1789 object for write conditions and limitations."
1790 REFERENCE
1791 "Data-Over-Cable Service Interface Specifications: Radio
1792 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1793 Section 8.3.4, and 9.4."
1795 ::= { docsIfUpstreamChannelEntry 9 }
1797 docsIfUpChannelTxBackoffEnd OBJECT-TYPE
1798 SYNTAX Integer32 (0..16)
1799 MAX-ACCESS read-create
1800 STATUS current
1801 DESCRIPTION
1802 "The final random backoff window to use when retrying
1803 transmissions. Expressed as a power of 2. A value of 16
1804 at the CMTS indicates that a proprietary adaptive retry
1805 mechanism is to be used. See the associated conformance
1806 object for write conditions and limitations."
1807 REFERENCE
1808 "Data-Over-Cable Service Interface Specifications: Radio
1809 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1810 Section 8.3.4, and 9.4."
1811 ::= { docsIfUpstreamChannelEntry 10 }
1813 docsIfUpChannelScdmaActiveCodes OBJECT-TYPE
1814 SYNTAX Unsigned32 (0|64..66|68..70|72|74..78|80..82|84..88
1815 |90..96|98..100|102|104..106|108
1816 |110..112|114..126|128)
1817 MAX-ACCESS read-create
1818 STATUS current
1819 DESCRIPTION
1820 "Applicable for SCDMA channel types only.
1821 Number of active codes. Returns zero for
1822 Non-SCDMA channel types. Note that legal
1823 values from 64..128 MUST be non-prime."
1824 REFERENCE
1825 "Data-Over-Cable Service Interface Specifications: Radio
1826 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1827 Section 6.2.11.2.1."
1828 ::= { docsIfUpstreamChannelEntry 11 }
1830 docsIfUpChannelScdmaCodesPerSlot OBJECT-TYPE
1831 SYNTAX Integer32(0 | 2..32)
1832 UNITS "codesperMinislots"
1833 MAX-ACCESS read-create
1834 STATUS current
1835 DESCRIPTION
1836 "Applicable for SCDMA channel types only.
1837 The number of SCDMA codes per mini-slot.
1838 Returns zero if the value is undefined, unknown or in
1839 case of a TDMA or ATDMA channel."
1840 REFERENCE
1841 "Data-Over-Cable Service Interface Specifications: Radio
1842 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1843 Section 6.2.11.2.1."
1844 ::= { docsIfUpstreamChannelEntry 12 }
1846 docsIfUpChannelScdmaFrameSize OBJECT-TYPE
1847 SYNTAX Unsigned32 (0..32)
1848 UNITS "spreadIntervals"
1849 MAX-ACCESS read-create
1850 STATUS current
1851 DESCRIPTION
1852 "Applicable for SCDMA channel types only.
1853 SCDMA Frame size in units of spreading intervals.
1854 This value returns zero for non SCDMA Profiles."
1855 REFERENCE
1856 "Data-Over-Cable Service Interface Specifications: Radio
1857 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1858 Section 6.2.12."
1859 ::= { docsIfUpstreamChannelEntry 13 }
1861 docsIfUpChannelScdmaHoppingSeed OBJECT-TYPE
1862 SYNTAX Unsigned32 (0..32767)
1863 MAX-ACCESS read-create
1864 STATUS current
1865 DESCRIPTION
1866 "Applicable for SCDMA channel types only.
1867 15 bit seed used for code hopping sequence initialization.
1868 Returns zero for non-SCDMA channel types.
1869 Setting this value to a value different than zero for
1870 non-SCDMA channel types returns error 'wrongValue'."
1871 REFERENCE
1872 "Data-Over-Cable Service Interface Specifications: Radio
1873 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1874 Section 6.2.14.1."
1875 ::= { docsIfUpstreamChannelEntry 14 }
1877 docsIfUpChannelType OBJECT-TYPE
1878 SYNTAX DocsisUpstreamType
1879 MAX-ACCESS read-only
1880 STATUS current
1881 DESCRIPTION
1882 "Reflects the Upstream channel type.
1883 This object returns the value of docsIfCmtsModChannelType
1884 for the modulation profile selected in
1885 docsIfUpChannelModulationProfile for this row."
1886 REFERENCE
1887 "Data-Over-Cable Service Interface Specifications: Radio
1888 Frequency Interface Specification SP-RFIv2.0-I09-050812,
1889 Section 6.2.1."
1890 ::= { docsIfUpstreamChannelEntry 15 }
1892 docsIfUpChannelCloneFrom OBJECT-TYPE
1893 SYNTAX InterfaceIndexOrZero
1894 MAX-ACCESS read-create
1895 STATUS current
1896 DESCRIPTION
1897 "This object contains the ifIndex value of the physical
1898 interface row entry whose parameters are to be adjusted.
1900 Upon setting this object to the ifIndex value of a
1901 physical interface, that interface objects values are
1902 copied to this entry:
1903 docsIfUpChannelFrequency,
1904 docsIfUpChannelWidth,
1905 docsIfUpChannelModulationProfile,
1906 docsIfUpChannelSlotSize,
1907 docsIfUpChannelRangingBackoffStart,
1908 docsIfUpChannelRangingBackoffEnd,
1909 docsIfUpChannelTxBackoffStart,
1910 docsIfUpChannelTxBackoffEnd,
1911 docsIfUpChannelScdmaActiveCodes,
1912 docsIfUpChannelScdmaCodesPerSlot,
1913 docsIfUpChannelScdmaFrameSize,
1914 docsIfUpChannelScdmaHoppingSeed,
1915 docsIfUpChannelType, and
1916 docsIfUpChannelPreEqEnable
1917 Setting this object to the value of a non-existent or
1918 a temporary upstream interface returns error
1919 'wrongValue'.
1920 This object MUST contain a value of zero for physical
1921 interfaces entries.
1922 Setting this object in row entries that corresponds to
1923 physical interfaces returns error 'wrongValue'."
1924 ::= { docsIfUpstreamChannelEntry 16 }
1926 docsIfUpChannelUpdate OBJECT-TYPE
1927 SYNTAX TruthValue
1928 MAX-ACCESS read-create
1929 STATUS current
1930 DESCRIPTION
1931 "Used to perform the copy of adjusted parameters from the
1932 temporary interface entry to the physical interface
1933 indicated by the docsIfUpChannelCloneFrom object. The
1934 transfer is initiated through an SNMP SET to 'true' of
1935 this object.
1936 A SET to 'true' fails and returns error 'commitFailed'
1937 if docsIfUpChannelStatus value is 'notInService', which
1938 means, the interface parameters values are not
1939 compatible each other, or have not been validated yet.
1941 Reading this object always returns 'false'."
1942 ::= { docsIfUpstreamChannelEntry 17 }
1944 docsIfUpChannelStatus OBJECT-TYPE
1945 SYNTAX RowStatus
1946 MAX-ACCESS read-create
1947 STATUS current
1948 DESCRIPTION
1949 "This object is only used for the creation of a temporary
1950 upstream row with the purpose of updating the parameters
1951 of a physical upstream channel entry.
1953 The following restrictions apply to this object:
1954 1. This object is not writable for physical interfaces.
1955 2. Temporary interface entries are only created by SET
1956 this object to createandWait(5).
1957 3. ifAdminStatus from the Interface MIB RFC 2863 is used
1958 to take a physical upstream channel offline, to be
1959 consistent with DOCSIS 1.x operation indicated in
1960 RFC 2670.
1961 In addition,
1962 o ifAdminStatus 'down' is reflected in this object
1963 as 'notInService'.
1964 o ifOperSatus 'down' while ifAdminStatus 'up' is
1965 reflected in this object as 'notInservice'.
1966 4. Temporary created rows MUST be set to 'active' with
1967 the purpose of validate the upstream parameters
1968 consistency prior to transfer the parameters to the
1969 physical interface.
1971 Below is a mandatory procedure for adjusting the values
1972 of a physical interface :
1973 1. Create a temporary interface entry through an SNMP SET
1974 using 'createAndWait'. At this point, the RowStatus
1975 reports 'notReady'.
1976 The Manager entity uses an ifIndex value outside the
1977 operational range of the physical interfaces for the
1978 creation of a temporary interface.
1979 2. Set the docsIfUpChannelCloneFrom object to the ifIndex
1980 value of the physical row to update. Now
1981 docsIfUpChannelStatus reports 'notInService'.
1982 3. Change the upstream parameters to the desired values
1983 into the temporary row.
1984 4. Validate that all parameters are consistent by setting
1985 docsIfUpChannelStatus to 'active'. A Failure to set the
1986 RowStatus to 'active' returns error 'commitFailed' which
1987 means the parameters are not compatible to be set to the
1988 target physical interface.
1990 5. With docsIfUpChannelStatus 'active'm trasfer the
1991 parameters to the target physical interface by setting
1992 the object docsIfUpChannelUpdate to 'true'.
1993 6. Delete the temporary row by setting
1994 docsIfUpChannelStatus to 'destroy'."
1995 ::= { docsIfUpstreamChannelEntry 18 }
1997 docsIfUpChannelPreEqEnable OBJECT-TYPE
1998 SYNTAX TruthValue
1999 MAX-ACCESS read-create
2000 STATUS current
2001 DESCRIPTION
2002 "At the CMTS, used to enable or disable pre-equalization on
2003 the upstream channel represented by this table instance.
2004 At the CM, this object is read-only and reflects the
2005 status of pre-equalization as represented in the RNG-RSP.
2006 Pre-equalization is considered enabled at the CM if a
2007 RNG-RSP with pre-equalization data has been received at
2008 least once since the last mac reinitialization."
2009 DEFVAL {false}
2010 ::= { docsIfUpstreamChannelEntry 19 }
2012 -- The following table describes the attributes of each class of
2013 -- service. The entries in this table are referenced from the
2014 -- docsIfServiceEntries. They exist as a separate table in order to
2015 -- reduce redundant information in docsIfServiceTable.
2016 --
2017 -- This table is implemented at both the CM and the CMTS.
2018 -- The CM need only maintain entries for the classes of service
2019 -- referenced by its docsIfCmServiceTable.
2020 --
2022 docsIfQosProfileTable OBJECT-TYPE
2023 SYNTAX SEQUENCE OF DocsIfQosProfileEntry
2024 MAX-ACCESS not-accessible
2025 STATUS current
2026 DESCRIPTION
2027 "Describes the attributes for each class of service."
2028 ::= { docsIfBaseObjects 3 }
2030 docsIfQosProfileEntry OBJECT-TYPE
2031 SYNTAX DocsIfQosProfileEntry
2032 MAX-ACCESS not-accessible
2033 STATUS current
2034 DESCRIPTION
2035 "Describes the attributes for a single class of service.
2037 If implemented as read-create in the Cable Modem
2038 Termination System, creation of entries in this table is
2039 controlled by the value of
2040 docsIfCmtsQosProfilePermissions.
2042 If implemented as read-only, entries are created based
2043 on information in REG-REQ MAC messages received from
2044 cable modems (for Cable Modem Termination System), or
2045 based on information extracted from the TFTP option file
2046 (for Cable Modem).
2047 In the Cable Modem Termination System, read-only entries
2048 are removed if no longer referenced by
2049 docsIfCmtsServiceTable.
2051 An entry in this table MUST not be removed while it is
2052 referenced by an entry in docsIfCmServiceTable (Cable
2053 Modem) or docsIfCmtsServiceTable (Cable Modem Termination
2054 System).
2056 An entry in this table SHOULD NOT be changeable while
2057 it is referenced by an entry in docsIfCmtsServiceTable.
2059 If this table is created automatically, there SHOULD only
2060 be a single entry for each Class of Service. Multiple
2061 entries with the same Class of Service parameters are NOT
2062 RECOMMENDED."
2063 INDEX { docsIfQosProfIndex }
2064 ::= { docsIfQosProfileTable 1 }
2066 DocsIfQosProfileEntry ::= SEQUENCE {
2067 docsIfQosProfIndex Integer32,
2068 docsIfQosProfPriority Integer32,
2069 docsIfQosProfMaxUpBandwidth Integer32,
2070 docsIfQosProfGuarUpBandwidth Integer32,
2071 docsIfQosProfMaxDownBandwidth Integer32,
2072 docsIfQosProfMaxTxBurst Integer32, -- deprecated
2073 docsIfQosProfBaselinePrivacy TruthValue,
2074 docsIfQosProfStatus RowStatus,
2075 docsIfQosProfMaxTransmitBurst Integer32,
2076 docsIfQosProfStorageType StorageType
2077 }
2079 docsIfQosProfIndex OBJECT-TYPE
2080 SYNTAX Integer32 (1..16383)
2081 MAX-ACCESS not-accessible
2082 STATUS current
2083 DESCRIPTION
2084 "The index value that uniquely identifies an entry
2085 in the docsIfQosProfileTable."
2086 ::= { docsIfQosProfileEntry 1 }
2088 docsIfQosProfPriority OBJECT-TYPE
2089 SYNTAX Integer32 (0..7)
2090 MAX-ACCESS read-create
2091 STATUS current
2092 DESCRIPTION
2093 "A relative priority assigned to this service when
2094 allocating bandwidth. Zero indicates lowest priority
2095 and seven indicates highest priority.
2096 Interpretation of priority is device-specific.
2097 MUST NOT be changed while this row is active."
2098 REFERENCE
2099 "Data-Over-Cable Service Interface Specifications: Radio
2100 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2101 Annex C.1.1.4."
2102 DEFVAL { 0 }
2103 ::= { docsIfQosProfileEntry 2 }
2105 docsIfQosProfMaxUpBandwidth OBJECT-TYPE
2106 SYNTAX Integer32 (0..100000000)
2107 UNITS "bits per second"
2108 MAX-ACCESS read-create
2109 STATUS current
2110 DESCRIPTION
2111 "The maximum upstream bandwidth, in bits per second,
2112 allowed for a service with this service class.
2113 Zero if there is no restriction of upstream bandwidth.
2114 MUST NOT be changed while this row is active."
2115 REFERENCE
2116 "Data-Over-Cable Service Interface Specifications: Radio
2117 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2118 Annex C.1.1.4."
2119 DEFVAL { 0 }
2120 ::= { docsIfQosProfileEntry 3 }
2122 docsIfQosProfGuarUpBandwidth OBJECT-TYPE
2123 SYNTAX Integer32 (0..100000000)
2124 UNITS "bits per second"
2125 MAX-ACCESS read-create
2126 STATUS current
2127 DESCRIPTION
2128 "Minimum guaranteed upstream bandwidth, in bits per second,
2129 allowed for a service with this service class.
2130 MUST NOT be changed while this row is active."
2131 REFERENCE
2132 "Data-Over-Cable Service Interface Specifications: Radio
2133 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2134 Annex C.1.1.4."
2135 DEFVAL { 0 }
2136 ::= { docsIfQosProfileEntry 4 }
2138 docsIfQosProfMaxDownBandwidth OBJECT-TYPE
2139 SYNTAX Integer32 (0..100000000)
2140 UNITS "bits per second"
2141 MAX-ACCESS read-create
2142 STATUS current
2143 DESCRIPTION
2144 "The maximum downstream bandwidth, in bits per second,
2145 allowed for a service with this service class.
2146 Zero if there is no restriction of downstream bandwidth.
2147 MUST NOT be changed while this row is active."
2148 REFERENCE
2149 "Data-Over-Cable Service Interface Specifications: Radio
2150 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2151 Annex C.1.1.4."
2153 DEFVAL { 0 }
2154 ::= { docsIfQosProfileEntry 5 }
2156 docsIfQosProfMaxTxBurst OBJECT-TYPE
2157 SYNTAX Integer32 (0..255)
2158 UNITS "mini-slots"
2159 MAX-ACCESS read-create
2160 STATUS deprecated
2161 DESCRIPTION
2162 "The maximum number of mini-slots that may be requested
2163 for a single upstream transmission.
2164 A value of zero means there is no limit.
2165 MUST NOT be changed while this row is active.
2166 This object has been deprecated and replaced by
2167 docsIfQosProfMaxTransmitBurst, to fix a mismatch
2168 of the units and value range with respect to the DOCSIS
2169 Maximum Upstream Channel Transmit Burst Configuration
2170 Setting."
2171 REFERENCE
2172 "Data-Over-Cable Service Interface Specifications: Radio
2173 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2174 C.1.1.4."
2175 DEFVAL { 0 }
2176 ::= { docsIfQosProfileEntry 6 }
2178 docsIfQosProfBaselinePrivacy OBJECT-TYPE
2179 SYNTAX TruthValue
2180 MAX-ACCESS read-create
2181 STATUS current
2182 DESCRIPTION
2183 "Indicates whether Baseline Privacy is enabled for this
2184 service class.
2185 MUST NOT be changed while this row is active."
2186 DEFVAL { false }
2187 ::= { docsIfQosProfileEntry 7 }
2189 docsIfQosProfStatus OBJECT-TYPE
2190 SYNTAX RowStatus
2191 MAX-ACCESS read-create
2192 STATUS current
2193 DESCRIPTION
2194 "This is object is to used to create or delete rows in
2195 this table. This object MUST NOT be changed from active
2196 while the row is referenced by the any entry in either
2197 docsIfCmServiceTable (on the CM), or the
2198 docsIfCmtsServiceTable (on the CMTS)."
2199 ::= { docsIfQosProfileEntry 8 }
2201 docsIfQosProfMaxTransmitBurst OBJECT-TYPE
2202 SYNTAX Integer32 (0..65535)
2203 UNITS "bytes"
2204 MAX-ACCESS read-create
2205 STATUS current
2206 DESCRIPTION
2207 "The maximum number of bytes that may be requested for a
2208 single upstream transmission. A value of zero means there
2209 is no limit. Note: This value does not include any
2210 physical layer overhead.
2211 MUST NOT be changed while this row is active."
2212 REFERENCE
2213 "Data-Over-Cable Service Interface Specifications: Radio
2214 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2215 Annex C.1.1.4."
2216 DEFVAL { 0 }
2217 ::= { docsIfQosProfileEntry 9 }
2219 docsIfQosProfStorageType OBJECT-TYPE
2220 SYNTAX StorageType
2221 MAX-ACCESS read-only
2222 STATUS current
2223 DESCRIPTION
2224 "The storage type for this conceptual row.
2225 Entries with this object set to permanent(4)
2226 do not require write operations for writable
2227 objects."
2228 ::= { docsIfQosProfileEntry 10 }
2230 docsIfSignalQualityTable OBJECT-TYPE
2231 SYNTAX SEQUENCE OF DocsIfSignalQualityEntry
2232 MAX-ACCESS not-accessible
2233 STATUS current
2234 DESCRIPTION
2235 "At the CM, describes the PHY signal quality of downstream
2236 channels. At the CMTS, describes the PHY signal quality of
2237 upstream channels. At the CMTS, this table MAY exclude
2238 contention intervals."
2239 ::= { docsIfBaseObjects 4 }
2241 docsIfSignalQualityEntry OBJECT-TYPE
2242 SYNTAX DocsIfSignalQualityEntry
2243 MAX-ACCESS not-accessible
2244 STATUS current
2245 DESCRIPTION
2246 "At the CM, describes the PHY characteristics of a
2247 downstream channel. At the CMTS, describes the PHY signal
2248 quality of an upstream channel.
2249 An entry in this table exists for each ifEntry with an
2250 ifType of docsCableDownstream(128) for Cable Modem.
2251 For DOCSIS 1.1 Cable Modem Termination System, an entry
2252 exists for each ifEntry with an ifType of
2253 docsCableUpstream (129).
2254 For DOCSIS 2.0 Cable Modem Termination System, an entry
2255 exists for each ifEntry with an ifType of
2256 docsCableUpstreamChannel (205)."
2257 INDEX { ifIndex }
2258 ::= { docsIfSignalQualityTable 1 }
2260 DocsIfSignalQualityEntry ::= SEQUENCE {
2261 docsIfSigQIncludesContention TruthValue,
2262 docsIfSigQUnerroreds Counter32,
2263 docsIfSigQCorrecteds Counter32,
2264 docsIfSigQUncorrectables Counter32,
2265 docsIfSigQSignalNoise TenthdB,
2266 docsIfSigQMicroreflections Integer32,
2267 docsIfSigQEqualizationData DocsEqualizerData,
2268 docsIfSigQExtUnerroreds Counter64,
2269 docsIfSigQExtCorrecteds Counter64,
2270 docsIfSigQExtUncorrectables Counter64
2271 }
2273 docsIfSigQIncludesContention OBJECT-TYPE
2274 SYNTAX TruthValue
2275 MAX-ACCESS read-only
2276 STATUS current
2277 DESCRIPTION
2278 "true(1) if this CMTS includes contention intervals in
2279 the counters in this table. Always false(2) for CMs."
2280 REFERENCE
2281 "Data-Over-Cable Service Interface Specifications: Radio
2282 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2283 Section 9.4.1"
2284 ::= { docsIfSignalQualityEntry 1 }
2286 docsIfSigQUnerroreds OBJECT-TYPE
2287 SYNTAX Counter32
2288 UNITS "codewords"
2289 MAX-ACCESS read-only
2290 STATUS current
2291 DESCRIPTION
2292 "Codewords received on this channel without error.
2293 This includes all codewords, whether or not they
2294 were part of frames destined for this device.
2295 Discontinuities in the value of this counter can occur
2296 at reinitialization of the managed system, and at other
2297 times as indicated by the value of
2298 ifCounterDiscontinuityTime for the associated ifIndex."
2299 REFERENCE
2300 "Data-Over-Cable Service Interface Specifications: Radio
2301 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2302 Sections 6.2.4, and 6.3.6."
2303 ::= { docsIfSignalQualityEntry 2 }
2305 docsIfSigQCorrecteds OBJECT-TYPE
2306 SYNTAX Counter32
2307 UNITS "codewords"
2308 MAX-ACCESS read-only
2309 STATUS current
2310 DESCRIPTION
2311 "Codewords received on this channel with correctable
2312 errors. This includes all codewords, whether or not
2313 they were part of frames destined for this device.
2314 Discontinuities in the value of this counter can occur
2315 at reinitialization of the managed system, and at other
2316 times as indicated by the value of
2317 ifCounterDiscontinuityTime for the associated ifIndex."
2318 REFERENCE
2319 "Data-Over-Cable Service Interface Specifications: Radio
2320 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2321 Sections 6.2.4, and 6.3.6."
2322 ::= { docsIfSignalQualityEntry 3 }
2324 docsIfSigQUncorrectables OBJECT-TYPE
2325 SYNTAX Counter32
2326 UNITS "codewords"
2327 MAX-ACCESS read-only
2328 STATUS current
2329 DESCRIPTION
2330 "Codewords received on this channel with uncorrectable
2331 errors. This includes all codewords, whether or not
2332 they were part of frames destined for this device.
2333 Discontinuities in the value of this counter can occur
2334 at reinitialization of the managed system, and at other
2335 times as indicated by the value of
2336 ifCounterDiscontinuityTime for the associated ifIndex."
2337 REFERENCE
2338 "Data-Over-Cable Service Interface Specifications: Radio
2339 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2340 Sections 6.2.4, and 6.3.6."
2341 ::= { docsIfSignalQualityEntry 4 }
2343 docsIfSigQSignalNoise OBJECT-TYPE
2344 SYNTAX TenthdB
2345 UNITS "TenthdB"
2346 MAX-ACCESS read-only
2347 STATUS current
2348 DESCRIPTION
2349 "Signal/Noise ratio as perceived for this channel.
2350 At the CM, describes the Signal/Noise of the downstream
2351 channel. At the CMTS, describes the average Signal/Noise
2352 of the upstream channel."
2353 REFERENCE
2354 "Data-Over-Cable Service Interface Specifications: Radio
2355 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2356 Tables 4-1 and 4-2"
2357 ::= { docsIfSignalQualityEntry 5 }
2359 docsIfSigQMicroreflections OBJECT-TYPE
2360 SYNTAX Integer32 (0..255)
2361 UNITS "-dBc"
2362 MAX-ACCESS read-only
2363 STATUS current
2364 DESCRIPTION
2365 "Microreflections including in-channel response
2366 as perceived on this interface, measured in dBc below
2367 the signal level.
2368 This object is not assumed to return an absolutely
2369 accurate value, but it gives a rough indication
2370 of microreflections received on this interface.
2371 It is up to the implementer to provide information
2372 as accurate as possible. "
2373 REFERENCE
2374 "Data-Over-Cable Service Interface Specifications: Radio
2375 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2376 Tables 4-1 and 4-2"
2377 ::= { docsIfSignalQualityEntry 6 }
2379 docsIfSigQEqualizationData OBJECT-TYPE
2380 SYNTAX DocsEqualizerData
2381 MAX-ACCESS read-only
2382 STATUS current
2383 DESCRIPTION
2384 "At the CM, returns the equalization data for the
2385 downstream channel.
2387 At the CMTS, this object is not applicable and is not
2388 instantiated. Note that previous CMTS implementations
2389 may instantiate this object in two ways:
2390 - An equalization value different of the zero-length
2391 octet string to indicate an equalization average for
2392 the upstream channel. Those values have vendor
2393 dependent interpretation.
2394 - Return the zero-length OCTET STRING to indicate that
2395 the value is unknown or if there is no equalization
2396 data available or defined."
2397 REFERENCE
2398 "DOCSIS Radio Frequency Interface Specification,
2399 Figure 6-23."
2400 ::= { docsIfSignalQualityEntry 7 }
2402 docsIfSigQExtUnerroreds OBJECT-TYPE
2403 SYNTAX Counter64
2404 UNITS "codewords"
2405 MAX-ACCESS read-only
2406 STATUS current
2407 DESCRIPTION
2408 "Codewords received on this channel without error.
2409 This includes all codewords, whether or not they
2410 were part of frames destined for this device.
2411 This is the 64 bit version of docsIfSigQUnerroreds.
2412 Discontinuities in the value of this counter can occur
2413 at reinitialization of the managed system, and at other
2414 times as indicated by the value of
2415 ifCounterDiscontinuityTime for the associated ifIndex."
2416 REFERENCE
2417 "Data-Over-Cable Service Interface Specifications: Radio
2418 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2419 Sections 6.2.4, and 6.3.6."
2420 ::= { docsIfSignalQualityEntry 8 }
2422 docsIfSigQExtCorrecteds OBJECT-TYPE
2423 SYNTAX Counter64
2424 UNITS "codewords"
2425 MAX-ACCESS read-only
2426 STATUS current
2427 DESCRIPTION
2428 "Codewords received on this channel with correctable
2429 errors. This includes all codewords, whether or not
2430 they were part of frames destined for this device.
2431 This is the 64 bit version of docsIfSigQCorrecteds.
2432 Discontinuities in the value of this counter can occur
2433 at reinitialization of the managed system, and at other
2434 times as indicated by the value of
2435 ifCounterDiscontinuityTime for the associated ifIndex."
2436 REFERENCE
2437 "Data-Over-Cable Service Interface Specifications: Radio
2438 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2439 Sections 6.2.4, and 6.3.6."
2440 ::= { docsIfSignalQualityEntry 9 }
2442 docsIfSigQExtUncorrectables OBJECT-TYPE
2443 SYNTAX Counter64
2444 UNITS "codewords"
2445 MAX-ACCESS read-only
2446 STATUS current
2447 DESCRIPTION
2448 "Codewords received on this channel with uncorrectable
2449 errors. This includes all codewords, whether or not
2450 they were part of frames destined for this device.
2451 This is the 64 bit version of docsIfSigQUncorrectables.
2452 Discontinuities in the value of this counter can occur
2453 at reinitialization of the managed system, and at other
2454 times as indicated by the value of
2455 ifCounterDiscontinuityTime for the associated ifIndex."
2456 REFERENCE
2457 "Data-Over-Cable Service Interface Specifications: Radio
2458 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2459 Sections 6.2.4, 6.3.6."
2460 ::= { docsIfSignalQualityEntry 10 }
2462 --
2463 -- DOCSIS Version of the device
2464 --
2466 docsIfDocsisBaseCapability OBJECT-TYPE
2467 SYNTAX DocsisVersion
2468 MAX-ACCESS read-only
2469 STATUS current
2470 DESCRIPTION
2471 "Indication of the DOCSIS capability of the device."
2472 REFERENCE
2473 "Data-Over-Cable Service Interface Specifications: Radio
2474 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2475 Annex G."
2476 ::= { docsIfBaseObjects 5 }
2478 --
2479 -- CABLE MODEM GROUP
2480 --
2482 --
2483 -- The CM MAC Table
2484 --
2486 docsIfCmMacTable OBJECT-TYPE
2487 SYNTAX SEQUENCE OF DocsIfCmMacEntry
2488 MAX-ACCESS not-accessible
2489 STATUS current
2490 DESCRIPTION
2491 "Describes the attributes of each CM MAC interface,
2492 extending the information available from ifEntry."
2493 ::= { docsIfCmObjects 1 }
2495 docsIfCmMacEntry OBJECT-TYPE
2496 SYNTAX DocsIfCmMacEntry
2497 MAX-ACCESS not-accessible
2498 STATUS current
2499 DESCRIPTION
2500 "An entry containing objects describing attributes of
2501 each MAC entry, extending the information in ifEntry.
2502 An entry in this table exists for each ifEntry with an
2503 ifType of docsCableMaclayer(127)."
2504 INDEX { ifIndex }
2505 ::= { docsIfCmMacTable 1 }
2507 DocsIfCmMacEntry ::= SEQUENCE {
2508 docsIfCmCmtsAddress MacAddress,
2509 docsIfCmCapabilities BITS,
2510 docsIfCmRangingRespTimeout TimeTicks,
2511 docsIfCmRangingTimeout TimeInterval
2512 }
2514 docsIfCmCmtsAddress OBJECT-TYPE
2515 SYNTAX MacAddress
2516 MAX-ACCESS read-only
2517 STATUS current
2518 DESCRIPTION
2519 "Identifies the CMTS that is believed to control this MAC
2520 domain. At the CM, this will be the source address from
2521 SYNC, MAP, and other MAC-layer messages. If the CMTS is
2522 unknown, returns 00-00-00-00-00-00."
2523 REFERENCE
2524 "Data-Over-Cable Service Interface Specifications: Radio
2525 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2526 Section 8.2.2."
2527 ::= { docsIfCmMacEntry 1 }
2529 docsIfCmCapabilities OBJECT-TYPE
2530 SYNTAX BITS {
2531 atmCells(0),
2532 concatenation(1)
2533 }
2534 MAX-ACCESS read-only
2535 STATUS current
2536 DESCRIPTION
2537 "Identifies the capabilities of the MAC implementation
2538 at this interface. Note that packet transmission is
2539 always supported. Therefore, there is no specific bit
2540 required to explicitly indicate this capability.
2541 Note that BITS objects are encoded most significant bit
2542 first. For example, if bit 1 is set, the value of this
2543 object is the octet string '40'H."
2544 ::= { docsIfCmMacEntry 2 }
2546 docsIfCmRangingRespTimeout OBJECT-TYPE
2547 SYNTAX TimeTicks
2548 MAX-ACCESS read-write
2549 STATUS obsolete
2550 DESCRIPTION
2551 "Waiting time for a Ranging Response packet.
2552 This object has been obsoleted and replaced by
2553 docsIfCmRangingTimeout to correct the typing to
2554 TimeInterval."
2555 REFERENCE
2556 "Data-Over-Cable Service Interface Specifications: Radio
2557 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2558 Section 9.1.6."
2559 DEFVAL { 20 }
2560 ::= { docsIfCmMacEntry 3 }
2562 docsIfCmRangingTimeout OBJECT-TYPE
2563 SYNTAX TimeInterval
2564 UNITS "HundredOfSeconds"
2565 MAX-ACCESS read-write
2566 STATUS current
2567 DESCRIPTION
2568 "Waiting time for a Ranging Response packet.
2569 This object MUST NOT persist at reinitialization
2570 of the managed system."
2571 REFERENCE
2572 "Data-Over-Cable Service Interface Specifications: Radio
2573 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2574 Section 9.1.6, timer T3."
2575 DEFVAL { 20 }
2576 ::= { docsIfCmMacEntry 4 }
2578 --
2579 -- CM status table.
2580 -- This table is implemented only at the CM.
2581 --
2583 docsIfCmStatusTable OBJECT-TYPE
2584 SYNTAX SEQUENCE OF DocsIfCmStatusEntry
2585 MAX-ACCESS not-accessible
2586 STATUS current
2587 DESCRIPTION
2588 "This table maintains a number of status objects
2589 and counters for Cable Modem."
2590 ::= { docsIfCmObjects 2 }
2592 docsIfCmStatusEntry OBJECT-TYPE
2593 SYNTAX DocsIfCmStatusEntry
2594 MAX-ACCESS not-accessible
2595 STATUS current
2596 DESCRIPTION
2597 "A set of status objects and counters for a single MAC
2598 layer instance in Cable Modem.
2599 An entry in this table exists for each ifEntry with an
2600 ifType of docsCableMaclayer(127)."
2601 INDEX { ifIndex }
2602 ::= { docsIfCmStatusTable 1 }
2604 DocsIfCmStatusEntry ::= SEQUENCE {
2605 docsIfCmStatusValue INTEGER,
2606 docsIfCmStatusCode OCTET STRING,
2607 docsIfCmStatusTxPower TenthdBmV,
2608 docsIfCmStatusResets Counter32,
2609 docsIfCmStatusLostSyncs Counter32,
2610 docsIfCmStatusInvalidMaps Counter32,
2611 docsIfCmStatusInvalidUcds Counter32,
2612 docsIfCmStatusInvalidRangingResponses Counter32,
2613 docsIfCmStatusInvalidRegistrationResponses Counter32,
2614 docsIfCmStatusT1Timeouts Counter32,
2615 docsIfCmStatusT2Timeouts Counter32,
2616 docsIfCmStatusT3Timeouts Counter32,
2617 docsIfCmStatusT4Timeouts Counter32,
2618 docsIfCmStatusRangingAborteds Counter32,
2619 docsIfCmStatusDocsisOperMode DocsisQosVersion,
2620 docsIfCmStatusModulationType DocsisUpstreamType,
2621 docsIfCmStatusEqualizationData DocsEqualizerData,
2622 docsIfCmStatusUCCs Counter32,
2623 docsIfCmStatusUCCFails Counter32
2624 }
2626 docsIfCmStatusValue OBJECT-TYPE
2627 SYNTAX INTEGER {
2628 other(1),
2629 notReady(2),
2630 notSynchronized(3),
2631 phySynchronized(4),
2632 usParametersAcquired(5),
2633 rangingComplete(6),
2634 ipComplete(7),
2635 todEstablished(8),
2636 securityEstablished(9),
2637 paramTransferComplete(10),
2638 registrationComplete(11),
2639 operational(12),
2640 accessDenied(13)
2641 }
2642 MAX-ACCESS read-only
2643 STATUS current
2644 DESCRIPTION
2645 "Current Cable Modem connectivity state, as specified
2646 in the RF Interface Specification. Interpretations for
2647 state values 1-12 are clearly outlined in the SP-RFI
2648 reference given below.
2649 The state value accessDenied(13) indicates the CMTS has
2650 sent a Registration Aborted message to the CM. Same
2651 state is reported as accessDenied(7) by the CMTS object
2652 docsIfCmtsCmStatusValue."
2653 REFERENCE
2654 "Data-Over-Cable Service Interface Specifications: Radio
2655 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2656 Section 11.2.
2657 Data-Over-Cable Service Interface Specifications:
2659 Operations Support System Interface Specification
2660 SP-OSSIv2.0-I09-050812, Section 6.3.4.2."
2661 ::= { docsIfCmStatusEntry 1 }
2663 docsIfCmStatusCode OBJECT-TYPE
2664 SYNTAX OCTET STRING (SIZE( 0 | 5 | 6 ))
2665 MAX-ACCESS read-only
2666 STATUS current
2667 DESCRIPTION
2668 "Status code for Cable Modem as defined in the
2669 OSSI Specification. The status code consists
2670 of a single character indicating error groups, followed
2671 by a two- or three-digit number indicating the status
2672 condition, followed by a decimal.
2673 An example of a returned value could be 'T101.0'
2674 The zero-length OCTET STRING indicates no status code yet
2675 registered."
2676 REFERENCE
2677 "Data-Over-Cable Service Interface Specifications:
2678 Operations Support System Interface Specification
2679 SP-OSSIv2.0-I09-050812, Annex D."
2680 ::= { docsIfCmStatusEntry 2 }
2682 docsIfCmStatusTxPower OBJECT-TYPE
2683 SYNTAX TenthdBmV
2684 UNITS "TenthdBmV"
2685 MAX-ACCESS read-only
2686 STATUS current
2687 DESCRIPTION
2688 "The operational transmit power for the attached upstream
2689 channel."
2690 REFERENCE
2691 "Data-Over-Cable Service Interface Specifications: Radio
2692 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2693 Section 6.2.18."
2694 ::= { docsIfCmStatusEntry 3 }
2696 docsIfCmStatusResets OBJECT-TYPE
2697 SYNTAX Counter32
2698 UNITS "resets"
2699 MAX-ACCESS read-only
2700 STATUS current
2701 DESCRIPTION
2702 "Number of times the CM reset or initialized this
2703 interface.
2704 Discontinuities in the value of this counter can occur
2705 at reinitialization of the managed system, and at other
2706 times as indicated by the value of
2707 ifCounterDiscontinuityTime for the associated ifIndex."
2708 ::= { docsIfCmStatusEntry 4 }
2710 docsIfCmStatusLostSyncs OBJECT-TYPE
2711 SYNTAX Counter32
2712 MAX-ACCESS read-only
2713 STATUS current
2714 DESCRIPTION
2715 "Number of times the CM lost synchronization with
2716 the downstream channel.
2717 Discontinuities in the value of this counter can occur
2718 at reinitialization of the managed system, and at other
2719 times as indicated by the value of
2720 ifCounterDiscontinuityTime for the associated ifIndex."
2721 REFERENCE
2722 "Data-Over-Cable Service Interface Specifications: Radio
2723 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2724 Section 8.3.2."
2725 ::= { docsIfCmStatusEntry 5 }
2727 docsIfCmStatusInvalidMaps OBJECT-TYPE
2728 SYNTAX Counter32
2729 UNITS "maps"
2730 MAX-ACCESS read-only
2731 STATUS current
2732 DESCRIPTION
2733 "Number of times the CM received invalid MAP messages.
2734 Discontinuities in the value of this counter can occur
2735 at reinitialization of the managed system, and at other
2736 times as indicated by the value of
2737 ifCounterDiscontinuityTime for the associated ifIndex."
2738 REFERENCE
2739 "Data-Over-Cable Service Interface Specifications: Radio
2740 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2741 Section 8.3.4."
2742 ::= { docsIfCmStatusEntry 6 }
2744 docsIfCmStatusInvalidUcds OBJECT-TYPE
2745 SYNTAX Counter32
2746 UNITS "messages"
2747 MAX-ACCESS read-only
2748 STATUS current
2749 DESCRIPTION
2750 "Number of times the CM received invalid UCD messages.
2751 Discontinuities in the value of this counter can occur
2752 at reinitialization of the managed system, and at other
2753 times as indicated by the value of
2754 ifCounterDiscontinuityTime for the associated ifIndex."
2755 REFERENCE
2756 "Data-Over-Cable Service Interface Specifications: Radio
2757 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2758 Section 8.3.3."
2759 ::= { docsIfCmStatusEntry 7 }
2761 docsIfCmStatusInvalidRangingResponses OBJECT-TYPE
2762 SYNTAX Counter32
2763 UNITS "messages"
2764 MAX-ACCESS read-only
2765 STATUS current
2766 DESCRIPTION
2767 "Number of times the CM received invalid ranging response
2768 messages.
2769 Discontinuities in the value of this counter can occur
2770 at reinitialization of the managed system, and at other
2771 times as indicated by the value of
2772 ifCounterDiscontinuityTime for the associated ifIndex."
2773 REFERENCE
2774 "Data-Over-Cable Service Interface Specifications: Radio
2775 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2776 Section 8.3.6."
2777 ::= { docsIfCmStatusEntry 8 }
2779 docsIfCmStatusInvalidRegistrationResponses OBJECT-TYPE
2780 SYNTAX Counter32
2781 UNITS "messages"
2782 MAX-ACCESS read-only
2783 STATUS current
2784 DESCRIPTION
2785 "Number of times the CM received invalid registration
2786 response messages.
2787 Discontinuities in the value of this counter can occur
2788 at reinitialization of the managed system, and at other
2789 times as indicated by the value of
2790 ifCounterDiscontinuityTime for the associated ifIndex."
2791 REFERENCE
2792 "Data-Over-Cable Service Interface Specifications: Radio
2793 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2794 Section 8.3.8."
2795 ::= { docsIfCmStatusEntry 9 }
2797 docsIfCmStatusT1Timeouts OBJECT-TYPE
2798 SYNTAX Counter32
2799 UNITS "timeouts"
2800 MAX-ACCESS read-only
2801 STATUS current
2802 DESCRIPTION
2803 "Number of times counter T1 expired in the CM.
2804 Discontinuities in the value of this counter can occur
2805 at reinitialization of the managed system, and at other
2806 times as indicated by the value of
2807 ifCounterDiscontinuityTime for the associated ifIndex."
2808 REFERENCE
2809 "Data-Over-Cable Service Interface Specifications: Radio
2810 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2811 Figure 9-2."
2812 ::= { docsIfCmStatusEntry 10 }
2814 docsIfCmStatusT2Timeouts OBJECT-TYPE
2815 SYNTAX Counter32
2816 UNITS "timeouts"
2817 MAX-ACCESS read-only
2818 STATUS current
2819 DESCRIPTION
2820 "Number of times counter T2 expired in the CM.
2821 Discontinuities in the value of this counter can occur
2822 at reinitialization of the managed system, and at other
2823 times as indicated by the value of
2824 ifCounterDiscontinuityTime for the associated ifIndex."
2825 REFERENCE
2826 "Data-Over-Cable Service Interface Specifications: Radio
2827 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2828 Figure 9-2."
2829 ::= { docsIfCmStatusEntry 11 }
2831 docsIfCmStatusT3Timeouts OBJECT-TYPE
2832 SYNTAX Counter32
2833 UNITS "timeouts"
2834 MAX-ACCESS read-only
2835 STATUS current
2836 DESCRIPTION
2837 "Number of times counter T3 expired in the CM.
2838 Discontinuities in the value of this counter can occur
2839 at reinitialization of the managed system, and at other
2840 times as indicated by the value of
2841 ifCounterDiscontinuityTime for the associated ifIndex."
2842 REFERENCE
2843 "Data-Over-Cable Service Interface Specifications: Radio
2844 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2845 Figure 9-2."
2846 ::= { docsIfCmStatusEntry 12 }
2848 docsIfCmStatusT4Timeouts OBJECT-TYPE
2849 SYNTAX Counter32
2850 UNITS "timeouts"
2851 MAX-ACCESS read-only
2852 STATUS current
2853 DESCRIPTION
2854 "Number of times counter T4 expired in the CM.
2855 Discontinuities in the value of this counter can occur
2856 at reinitialization of the managed system, and at other
2857 times as indicated by the value of
2858 ifCounterDiscontinuityTime for the associated ifIndex."
2859 REFERENCE
2860 "Data-Over-Cable Service Interface Specifications: Radio
2861 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2862 Figure 9-2."
2863 ::= { docsIfCmStatusEntry 13 }
2865 docsIfCmStatusRangingAborteds OBJECT-TYPE
2866 SYNTAX Counter32
2867 UNITS "attempts"
2868 MAX-ACCESS read-only
2869 STATUS current
2870 DESCRIPTION
2871 "Number of times the ranging process was aborted
2872 by the CMTS.
2873 Discontinuities in the value of this counter can occur
2874 at reinitialization of the managed system, and at other
2875 times as indicated by the value of
2876 ifCounterDiscontinuityTime for the associated ifIndex."
2877 REFERENCE
2878 "Data-Over-Cable Service Interface Specifications: Radio
2879 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2880 Section 9.3.3."
2881 ::= { docsIfCmStatusEntry 14 }
2883 docsIfCmStatusDocsisOperMode OBJECT-TYPE
2884 SYNTAX DocsisQosVersion
2885 MAX-ACCESS read-only
2886 STATUS current
2887 DESCRIPTION
2888 "Indication whether the device has registered using 1.0
2889 Class of Service or 1.1 Quality of Service.
2890 An unregistered CM SHOULD indicate 'docsis11' for a
2891 docsIfDocsisBaseCapability value of DOCSIS 1.1/2.0. An
2892 unregistered CM SHOULD indicate 'docsis10' for a
2893 docsIfDocsisBaseCapability value of DOCSIS 1.0."
2894 REFERENCE
2895 "Data-Over-Cable Service Interface Specifications: Radio
2896 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2897 Annex G."
2899 ::= { docsIfCmStatusEntry 15 }
2901 docsIfCmStatusModulationType OBJECT-TYPE
2902 SYNTAX DocsisUpstreamType
2903 MAX-ACCESS read-only
2904 STATUS current
2905 DESCRIPTION
2906 "Indicates modulation type status currently used by the
2907 CM. Since this object specifically identifies PHY mode,
2908 the shared upstream channel type is not permitted."
2909 REFERENCE
2910 "Data-Over-Cable Service Interface Specifications: Radio
2911 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2912 Section 6.2.1."
2914 ::= { docsIfCmStatusEntry 16 }
2916 docsIfCmStatusEqualizationData OBJECT-TYPE
2917 SYNTAX DocsEqualizerData
2918 MAX-ACCESS read-only
2919 STATUS current
2920 DESCRIPTION
2921 "Pre-equalization data for this CM after convolution with
2922 data indicated in the RNG-RSP. This data is valid when
2923 docsIfUpChannelPreEqEnable is set to true."
2924 REFERENCE
2925 "Data-Over-Cable Service Interface Specifications: Radio
2926 Frequency Interface Specification SP-RFIv2.0-I09-050812,
2927 Figure 8-23."
2928 ::= { docsIfCmStatusEntry 17 }
2930 docsIfCmStatusUCCs OBJECT-TYPE
2931 SYNTAX Counter32
2932 UNITS "attempts"
2933 MAX-ACCESS read-only
2934 STATUS current
2935 DESCRIPTION
2936 "The number of successful Upstream Channel Change
2937 transactions.
2938 Discontinuities in the value of this counter can occur
2939 at reinitialization of the managed system, and at other
2940 times as indicated by the value of
2941 ifCounterDiscontinuityTime for the associated ifIndex."
2942 ::= { docsIfCmStatusEntry 18 }
2944 docsIfCmStatusUCCFails OBJECT-TYPE
2945 SYNTAX Counter32
2946 UNITS "attempts"
2947 MAX-ACCESS read-only
2948 STATUS current
2949 DESCRIPTION
2950 "The number of failed Upstream Channel Change
2951 transactions.
2952 Discontinuities in the value of this counter can occur
2953 at reinitialization of the managed system, and at other
2954 times as indicated by the value of
2955 ifCounterDiscontinuityTime for the associated ifIndex."
2956 ::= { docsIfCmStatusEntry 19 }
2958 --
2959 -- The Cable Modem Service Table
2960 --
2962 docsIfCmServiceTable OBJECT-TYPE
2963 SYNTAX SEQUENCE OF DocsIfCmServiceEntry
2964 MAX-ACCESS not-accessible
2965 STATUS current
2966 DESCRIPTION
2967 "Describes the attributes of each upstream service queue
2968 on a CM."
2969 ::= { docsIfCmObjects 3 }
2971 docsIfCmServiceEntry OBJECT-TYPE
2972 SYNTAX DocsIfCmServiceEntry
2973 MAX-ACCESS not-accessible
2974 STATUS current
2975 DESCRIPTION
2976 "Describes the attributes of an upstream bandwidth service
2977 queue.
2978 An entry in this table exists for each Service ID.
2979 The primary index is an ifIndex with an ifType of
2980 docsCableMaclayer(127)."
2981 INDEX { ifIndex, docsIfCmServiceId }
2982 ::= { docsIfCmServiceTable 1 }
2984 DocsIfCmServiceEntry ::= SEQUENCE {
2985 docsIfCmServiceId Integer32,
2986 docsIfCmServiceQosProfile Integer32,
2987 docsIfCmServiceTxSlotsImmed Counter32,
2988 docsIfCmServiceTxSlotsDed Counter32,
2989 docsIfCmServiceTxRetries Counter32,
2990 docsIfCmServiceTxExceededs Counter32,
2991 docsIfCmServiceRqRetries Counter32,
2992 docsIfCmServiceRqExceededs Counter32,
2993 docsIfCmServiceExtTxSlotsImmed Counter64,
2994 docsIfCmServiceExtTxSlotsDed Counter64
2995 }
2997 docsIfCmServiceId OBJECT-TYPE
2998 SYNTAX Integer32 (1..16383)
2999 MAX-ACCESS not-accessible
3000 STATUS current
3001 DESCRIPTION
3002 "Identifies a service queue for upstream bandwidth. The
3003 attributes of this service queue are shared between the
3004 CM and the CMTS. The CMTS allocates upstream bandwidth
3005 to this service queue based on requests from the CM and
3006 on the class of service associated with this queue."
3007 ::= { docsIfCmServiceEntry 1 }
3009 docsIfCmServiceQosProfile OBJECT-TYPE
3010 SYNTAX Integer32 (0..16383)
3011 MAX-ACCESS read-only
3012 STATUS current
3013 DESCRIPTION
3014 "The index in docsIfQosProfileTable describing the quality
3015 of service attributes associated with this particular
3016 service. If no associated entry in docsIfQosProfileTable
3017 exists, this object returns a value of zero."
3018 ::= { docsIfCmServiceEntry 2 }
3020 docsIfCmServiceTxSlotsImmed OBJECT-TYPE
3021 SYNTAX Counter32
3022 UNITS "mini-slots"
3023 MAX-ACCESS read-only
3024 STATUS current
3025 DESCRIPTION
3026 "The number of upstream mini-slots which have been used to
3027 transmit data PDUs in immediate (contention) mode. This
3028 includes only those PDUs that are presumed to have
3029 arrived at the head-end (i.e., those which were explicitly
3030 acknowledged.) It does not include retransmission attempts
3031 or mini-slots used by Requests.
3032 Discontinuities in the value of this counter can occur
3033 at reinitialization of the managed system, and at other
3034 times as indicated by the value of
3035 ifCounterDiscontinuityTime for the associated ifIndex."
3036 REFERENCE
3037 "Data-Over-Cable Service Interface Specifications: Radio
3038 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3039 Section 9.4."
3040 ::= { docsIfCmServiceEntry 3 }
3042 docsIfCmServiceTxSlotsDed OBJECT-TYPE
3043 SYNTAX Counter32
3044 UNITS "mini-slots"
3045 MAX-ACCESS read-only
3046 STATUS current
3047 DESCRIPTION
3048 "The number of upstream mini-slots which have been used to
3049 transmit data PDUs in dedicated mode (i.e., as a result
3050 of a unicast Data Grant).
3051 Discontinuities in the value of this counter can occur
3052 at reinitialization of the managed system, and at other
3053 times as indicated by the value of
3054 ifCounterDiscontinuityTime for the associated ifIndex."
3055 REFERENCE
3056 "Data-Over-Cable Service Interface Specifications: Radio
3057 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3058 Section 9.4."
3059 ::= { docsIfCmServiceEntry 4 }
3061 docsIfCmServiceTxRetries OBJECT-TYPE
3062 SYNTAX Counter32
3063 UNITS "attempts"
3064 MAX-ACCESS read-only
3065 STATUS current
3066 DESCRIPTION
3067 "The number of attempts to transmit data PDUs containing
3068 requests for acknowledgment that did not result in
3069 acknowledgment.
3070 Discontinuities in the value of this counter can occur
3071 at reinitialization of the managed system, and at other
3072 times as indicated by the value of
3073 ifCounterDiscontinuityTime for the associated ifIndex."
3074 REFERENCE
3075 "Data-Over-Cable Service Interface Specifications: Radio
3076 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3077 Section 9.4."
3078 ::= { docsIfCmServiceEntry 5 }
3080 docsIfCmServiceTxExceededs OBJECT-TYPE
3081 SYNTAX Counter32
3082 UNITS "attempts"
3083 MAX-ACCESS read-only
3084 STATUS current
3085 DESCRIPTION
3086 "The number of data PDUs transmission failures due to
3087 excessive retries without acknowledgment.
3088 Discontinuities in the value of this counter can occur
3089 at reinitialization of the managed system, and at other
3090 times as indicated by the value of
3091 ifCounterDiscontinuityTime for the associated ifIndex."
3092 REFERENCE
3093 "Data-Over-Cable Service Interface Specifications: Radio
3094 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3095 Section 9.4."
3096 ::= { docsIfCmServiceEntry 6 }
3098 docsIfCmServiceRqRetries OBJECT-TYPE
3099 SYNTAX Counter32
3100 UNITS "attempts"
3101 MAX-ACCESS read-only
3102 STATUS current
3103 DESCRIPTION
3104 "The number of attempts to transmit bandwidth requests
3105 which did not result in acknowledgment.
3106 Discontinuities in the value of this counter can occur
3107 at reinitialization of the managed system, and at other
3108 times as indicated by the value of
3109 ifCounterDiscontinuityTime for the associated ifIndex."
3110 REFERENCE
3111 "Data-Over-Cable Service Interface Specifications: Radio
3112 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3113 Section 9.4."
3114 ::= { docsIfCmServiceEntry 7 }
3116 docsIfCmServiceRqExceededs OBJECT-TYPE
3117 SYNTAX Counter32
3118 UNITS "attempts"
3119 MAX-ACCESS read-only
3120 STATUS current
3121 DESCRIPTION
3122 "The number of requests for bandwidth which failed due to
3123 excessive retries without acknowledgment.
3124 Discontinuities in the value of this counter can occur
3125 at reinitialization of the managed system, and at other
3126 times as indicated by the value of
3127 ifCounterDiscontinuityTime for the associated ifIndex."
3128 REFERENCE
3129 "Data-Over-Cable Service Interface Specifications: Radio
3130 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3131 Section 9.4."
3132 ::= { docsIfCmServiceEntry 8 }
3134 docsIfCmServiceExtTxSlotsImmed OBJECT-TYPE
3135 SYNTAX Counter64
3136 UNITS "mini-slots"
3137 MAX-ACCESS read-only
3138 STATUS current
3139 DESCRIPTION
3140 "The number of upstream mini-slots which have been used to
3141 transmit data PDUs in immediate (contention) mode. This
3142 includes only those PDUs that are presumed to have
3143 arrived at the head-end (i.e., those which were explicitly
3144 acknowledged.) It does not include retransmission attempts
3145 or mini-slots used by Requests.
3146 Discontinuities in the value of this counter can occur
3147 at reinitialization of the managed system, and at other
3148 times as indicated by the value of
3149 ifCounterDiscontinuityTime for the associated ifIndex."
3150 REFERENCE
3151 "Data-Over-Cable Service Interface Specifications: Radio
3152 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3153 Section 9.4."
3154 ::= { docsIfCmServiceEntry 9 }
3156 docsIfCmServiceExtTxSlotsDed OBJECT-TYPE
3157 SYNTAX Counter64
3158 UNITS "mini-slots"
3159 MAX-ACCESS read-only
3160 STATUS current
3161 DESCRIPTION
3162 "The number of upstream mini-slots which have been used to
3163 transmit data PDUs in dedicated mode (i.e., as a result
3164 of a unicast Data Grant).
3165 Discontinuities in the value of this counter can occur
3166 at reinitialization of the managed system, and at other
3167 times as indicated by the value of
3168 ifCounterDiscontinuityTime for the associated ifIndex."
3169 REFERENCE
3170 "Data-Over-Cable Service Interface Specifications: Radio
3171 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3172 Section 9.4."
3173 ::= { docsIfCmServiceEntry 10 }
3175 --
3176 -- CMTS GROUP
3177 --
3179 --
3180 -- The CMTS MAC Table
3181 --
3183 docsIfCmtsMacTable OBJECT-TYPE
3184 SYNTAX SEQUENCE OF DocsIfCmtsMacEntry
3185 MAX-ACCESS not-accessible
3186 STATUS current
3187 DESCRIPTION
3188 "Describes the attributes of each CMTS MAC interface,
3189 extending the information available from ifEntry.
3190 Mandatory for all CMTS devices."
3191 ::= { docsIfCmtsObjects 1 }
3193 docsIfCmtsMacEntry OBJECT-TYPE
3194 SYNTAX DocsIfCmtsMacEntry
3195 MAX-ACCESS not-accessible
3196 STATUS current
3197 DESCRIPTION
3198 "An entry containing objects describing attributes of each
3199 MAC entry, extending the information in ifEntry.
3200 An entry in this table exists for each ifEntry with an
3201 ifType of docsCableMaclayer(127)."
3202 INDEX { ifIndex }
3203 ::= { docsIfCmtsMacTable 1 }
3205 DocsIfCmtsMacEntry ::= SEQUENCE {
3206 docsIfCmtsCapabilities BITS,
3207 docsIfCmtsSyncInterval Integer32,
3208 docsIfCmtsUcdInterval Integer32,
3209 docsIfCmtsMaxServiceIds Integer32,
3210 docsIfCmtsInsertionInterval TimeTicks, -- Obsolete
3211 docsIfCmtsInvitedRangingAttempts Integer32,
3212 docsIfCmtsInsertInterval TimeInterval,
3213 docsIfCmtsMacStorageType StorageType
3214 }
3216 docsIfCmtsCapabilities OBJECT-TYPE
3217 SYNTAX BITS {
3218 atmCells(0),
3219 concatenation(1)
3220 }
3221 MAX-ACCESS read-only
3222 STATUS current
3223 DESCRIPTION
3224 "Identifies the capabilities of the CMTS MAC
3225 implementation at this interface. Note that packet
3226 transmission is always supported. Therefore, there
3227 is no specific bit required to explicitly indicate
3228 this capability.
3229 Note that BITS objects are encoded most significant bit
3230 first. For example, if bit 1 is set, the value of this
3231 object is the octet string '40'H."
3232 ::= { docsIfCmtsMacEntry 1 }
3234 docsIfCmtsSyncInterval OBJECT-TYPE
3235 SYNTAX Integer32 (1..200)
3236 UNITS "Milliseconds"
3237 MAX-ACCESS read-write
3238 STATUS current
3239 DESCRIPTION
3240 "The interval between CMTS transmission of successive SYNC
3241 messages at this interface."
3242 REFERENCE
3243 "Data-Over-Cable Service Interface Specifications: Radio
3244 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3245 Section 9.3."
3246 ::= { docsIfCmtsMacEntry 2 }
3248 docsIfCmtsUcdInterval OBJECT-TYPE
3249 SYNTAX Integer32 (1..2000)
3250 UNITS "Milliseconds"
3251 MAX-ACCESS read-write
3252 STATUS current
3253 DESCRIPTION
3254 "The interval between CMTS transmission of successive
3255 Upstream Channel Descriptor messages for each upstream
3256 channel at this interface."
3257 REFERENCE
3258 "Data-Over-Cable Service Interface Specifications: Radio
3259 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3260 Section 9.3"
3261 ::= { docsIfCmtsMacEntry 3 }
3263 docsIfCmtsMaxServiceIds OBJECT-TYPE
3264 SYNTAX Integer32 (1..16383)
3265 UNITS "SIDs"
3266 MAX-ACCESS read-only
3267 STATUS current
3268 DESCRIPTION
3269 "The maximum number of service IDs that may be
3270 simultaneously active."
3271 ::= { docsIfCmtsMacEntry 4 }
3273 docsIfCmtsInsertionInterval OBJECT-TYPE
3274 SYNTAX TimeTicks
3275 MAX-ACCESS read-write
3276 STATUS obsolete
3277 DESCRIPTION
3278 "The amount of time to elapse between each broadcast
3279 initial maintenance grant. Broadcast initial maintenance
3280 grants are used to allow new cable modems to join the
3281 network. Zero indicates that a vendor-specific algorithm
3282 is used instead of a fixed time. Maximum amount of time
3283 permitted by the specification is 2 seconds.
3284 This object has been obsoleted and replaced by
3285 docsIfCmtsInsertInterval to fix a SYNTAX typing problem."
3286 REFERENCE
3287 "Data-Over-Cable Service Interface Specifications: Radio
3288 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3289 Annex B."
3290 ::= { docsIfCmtsMacEntry 5 }
3292 docsIfCmtsInvitedRangingAttempts OBJECT-TYPE
3293 SYNTAX Integer32 (0..1024)
3294 UNITS "attempts"
3295 MAX-ACCESS read-write
3296 STATUS current
3297 DESCRIPTION
3298 "The maximum number of attempts to make on invitations
3299 for ranging requests. A value of zero means the system
3300 SHOULD attempt to range forever."
3301 REFERENCE
3302 "Data-Over-Cable Service Interface Specifications: Radio
3303 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3304 Section 9.3.3 and Annex B."
3305 ::= { docsIfCmtsMacEntry 6 }
3307 docsIfCmtsInsertInterval OBJECT-TYPE
3308 SYNTAX TimeInterval
3309 UNITS "HundredOfSeconds"
3310 MAX-ACCESS read-write
3311 STATUS current
3312 DESCRIPTION
3313 "The amount of time to elapse between each broadcast
3314 initial maintenance grant. Broadcast initial maintenance
3315 grants are used to allow new cable modems to join the
3316 network. Zero indicates that a vendor-specific algorithm
3317 is used instead of a fixed time. Maximum amount of time
3318 permitted by the specification is 2 seconds."
3319 REFERENCE
3320 "Data-Over-Cable Service Interface Specifications: Radio
3321 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3322 Annex B."
3323 ::= { docsIfCmtsMacEntry 7 }
3325 docsIfCmtsMacStorageType OBJECT-TYPE
3326 SYNTAX StorageType
3327 MAX-ACCESS read-only
3328 STATUS current
3329 DESCRIPTION
3330 "The storage type for this conceptual row.
3331 Entries with this object set to permanent(4)
3332 do not require write operations for read-write
3333 objects."
3334 ::= { docsIfCmtsMacEntry 8 }
3336 --
3337 --
3338 -- CMTS status table.
3339 --
3341 docsIfCmtsStatusTable OBJECT-TYPE
3342 SYNTAX SEQUENCE OF DocsIfCmtsStatusEntry
3343 MAX-ACCESS not-accessible
3344 STATUS current
3345 DESCRIPTION
3346 "For the MAC layer, this group maintains a number of
3347 status objects and counters."
3348 ::= { docsIfCmtsObjects 2 }
3350 docsIfCmtsStatusEntry OBJECT-TYPE
3351 SYNTAX DocsIfCmtsStatusEntry
3352 MAX-ACCESS not-accessible
3353 STATUS current
3354 DESCRIPTION
3355 "Status entry for a single MAC layer.
3356 An entry in this table exists for each ifEntry with an
3357 ifType of docsCableMaclayer(127)."
3358 INDEX { ifIndex }
3359 ::= { docsIfCmtsStatusTable 1 }
3361 DocsIfCmtsStatusEntry ::= SEQUENCE {
3362 docsIfCmtsStatusInvalidRangeReqs Counter32,
3363 docsIfCmtsStatusRangingAborteds Counter32,
3364 docsIfCmtsStatusInvalidRegReqs Counter32,
3365 docsIfCmtsStatusFailedRegReqs Counter32,
3366 docsIfCmtsStatusInvalidDataReqs Counter32,
3367 docsIfCmtsStatusT5Timeouts Counter32
3368 }
3370 docsIfCmtsStatusInvalidRangeReqs OBJECT-TYPE
3371 SYNTAX Counter32
3372 UNITS "messages"
3373 MAX-ACCESS read-only
3374 STATUS current
3375 DESCRIPTION
3376 "This object counts invalid RNG-REQ messages received on
3377 this interface.
3379 Discontinuities in the value of this counter can occur
3380 at reinitialization of the managed system, and at other
3381 times as indicated by the value of
3382 ifCounterDiscontinuityTime for the associated ifIndex."
3383 REFERENCE
3384 "Data-Over-Cable Service Interface Specifications: Radio
3385 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3386 Section 8.3.5."
3387 ::= { docsIfCmtsStatusEntry 1 }
3389 docsIfCmtsStatusRangingAborteds OBJECT-TYPE
3390 SYNTAX Counter32
3391 UNITS "attempts"
3392 MAX-ACCESS read-only
3393 STATUS current
3394 DESCRIPTION
3395 "This object counts ranging attempts that were explicitly
3396 aborted by the CMTS.
3397 Discontinuities in the value of this counter can occur
3398 at reinitialization of the managed system, and at other
3399 times as indicated by the value of
3400 ifCounterDiscontinuityTime for the associated ifIndex."
3401 REFERENCE
3402 "Data-Over-Cable Service Interface Specifications: Radio
3403 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3404 Section 8.3.6."
3405 ::= { docsIfCmtsStatusEntry 2 }
3407 docsIfCmtsStatusInvalidRegReqs OBJECT-TYPE
3408 SYNTAX Counter32
3409 UNITS "messages"
3410 MAX-ACCESS read-only
3411 STATUS current
3412 DESCRIPTION
3413 "This object counts invalid REG-REQ messages received on
3414 this interface. That is, syntax, out of range parameters,
3415 or erroneous requests.
3416 Discontinuities in the value of this counter can occur
3417 at reinitialization of the managed system, and at other
3418 times as indicated by the value of
3419 ifCounterDiscontinuityTime for the associated ifIndex."
3420 REFERENCE
3421 "Data-Over-Cable Service Interface Specifications: Radio
3422 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3423 Section 8.3.7."
3424 ::= { docsIfCmtsStatusEntry 3 }
3426 docsIfCmtsStatusFailedRegReqs OBJECT-TYPE
3427 SYNTAX Counter32
3428 UNITS "attempts"
3429 MAX-ACCESS read-only
3430 STATUS current
3431 DESCRIPTION
3432 "This object counts failed registration attempts. Included
3433 are docsIfCmtsStatusInvalidRegReqs, authentication and
3434 class of service failures.
3435 Discontinuities in the value of this counter can occur
3436 at reinitialization of the managed system, and at other
3437 times as indicated by the value of
3438 ifCounterDiscontinuityTime for the associated ifIndex."
3439 REFERENCE
3440 "Data-Over-Cable Service Interface Specifications: Radio
3441 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3442 Section 8.3.7."
3443 ::= { docsIfCmtsStatusEntry 4 }
3445 docsIfCmtsStatusInvalidDataReqs OBJECT-TYPE
3446 SYNTAX Counter32
3447 UNITS "messages"
3448 MAX-ACCESS read-only
3449 STATUS current
3450 DESCRIPTION
3451 "This object counts invalid data request messages
3452 received on this interface.
3453 Discontinuities in the value of this counter can occur
3454 at reinitialization of the managed system, and at other
3455 times as indicated by the value of
3456 ifCounterDiscontinuityTime for the associated ifIndex."
3457 ::= { docsIfCmtsStatusEntry 5 }
3459 docsIfCmtsStatusT5Timeouts OBJECT-TYPE
3460 SYNTAX Counter32
3461 UNITS "timeouts"
3462 MAX-ACCESS read-only
3463 STATUS current
3464 DESCRIPTION
3465 "This object counts the number of times counter T5
3466 expired on this interface.
3467 Discontinuities in the value of this counter can occur
3468 at reinitialization of the managed system, and at other
3469 times as indicated by the value of
3470 ifCounterDiscontinuityTime for the associated ifIndex."
3471 REFERENCE
3472 "Data-Over-Cable Service Interface Specifications: Radio
3473 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3474 Figure 9-2."
3476 ::= { docsIfCmtsStatusEntry 6 }
3478 --
3479 -- CM status table (within CMTS).
3480 -- This table is implemented only at the CMTS.
3481 -- It contains per CM status information available in the CMTS.
3482 --
3484 docsIfCmtsCmStatusTable OBJECT-TYPE
3485 SYNTAX SEQUENCE OF DocsIfCmtsCmStatusEntry
3486 MAX-ACCESS not-accessible
3487 STATUS current
3488 DESCRIPTION
3489 "A set of objects in the CMTS, maintained for each
3490 cable modem connected to this CMTS."
3491 ::= { docsIfCmtsObjects 3 }
3493 docsIfCmtsCmStatusEntry OBJECT-TYPE
3494 SYNTAX DocsIfCmtsCmStatusEntry
3495 MAX-ACCESS not-accessible
3496 STATUS current
3497 DESCRIPTION
3498 "Status information for a single cable modem.
3499 An entry in this table exists for each cable modem
3500 that is connected to the CMTS implementing this table."
3501 INDEX { docsIfCmtsCmStatusIndex }
3502 ::= { docsIfCmtsCmStatusTable 1 }
3504 DocsIfCmtsCmStatusEntry ::= SEQUENCE {
3505 docsIfCmtsCmStatusIndex Integer32,
3506 docsIfCmtsCmStatusMacAddress MacAddress,
3507 docsIfCmtsCmStatusIpAddress IpAddress, -- deprecated
3508 docsIfCmtsCmStatusDownChannelIfIndex InterfaceIndexOrZero,
3509 docsIfCmtsCmStatusUpChannelIfIndex InterfaceIndexOrZero,
3510 docsIfCmtsCmStatusRxPower TenthdBmV,
3511 docsIfCmtsCmStatusTimingOffset Unsigned32,
3512 docsIfCmtsCmStatusEqualizationData DocsEqualizerData,
3513 docsIfCmtsCmStatusValue INTEGER,
3514 docsIfCmtsCmStatusUnerroreds Counter32,
3515 docsIfCmtsCmStatusCorrecteds Counter32,
3516 docsIfCmtsCmStatusUncorrectables Counter32,
3517 docsIfCmtsCmStatusSignalNoise TenthdB,
3518 docsIfCmtsCmStatusMicroreflections Integer32,
3519 docsIfCmtsCmStatusExtUnerroreds Counter64,
3520 docsIfCmtsCmStatusExtCorrecteds Counter64,
3521 docsIfCmtsCmStatusExtUncorrectables Counter64,
3522 docsIfCmtsCmStatusDocsisRegMode DocsisQosVersion,
3523 docsIfCmtsCmStatusModulationType DocsisUpstreamType,
3524 docsIfCmtsCmStatusInetAddressType InetAddressType,
3525 docsIfCmtsCmStatusInetAddress InetAddress,
3526 docsIfCmtsCmStatusValueLastUpdate TimeStamp,
3527 docsIfCmtsCmStatusHighResolutionTimingOffset Unsigned32
3528 }
3530 docsIfCmtsCmStatusIndex OBJECT-TYPE
3531 SYNTAX Integer32 (1..2147483647)
3532 MAX-ACCESS not-accessible
3533 STATUS current
3534 DESCRIPTION
3535 "Index value to uniquely identify an entry in this table.
3536 For an individual cable modem, this index value SHOULD
3537 NOT change during CMTS uptime."
3538 ::= { docsIfCmtsCmStatusEntry 1 }
3540 docsIfCmtsCmStatusMacAddress OBJECT-TYPE
3541 SYNTAX MacAddress
3542 MAX-ACCESS read-only
3543 STATUS current
3544 DESCRIPTION
3545 "MAC address of the cable modem. If the cable modem has
3546 multiple MAC addresses, this is the MAC address associated
3547 with the Cable interface."
3548 REFERENCE
3549 "Data-Over-Cable Service Interface Specifications: Radio
3550 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3551 Section 8.2.2."
3552 ::= { docsIfCmtsCmStatusEntry 2 }
3554 docsIfCmtsCmStatusIpAddress OBJECT-TYPE
3555 SYNTAX IpAddress
3556 MAX-ACCESS read-only
3557 STATUS deprecated
3558 DESCRIPTION
3559 "IP address of this cable modem. If the cable modem has no
3560 IP address assigned, or the IP address is unknown, this
3561 object returns a value of 0.0.0.0. If the cable modem has
3562 multiple IP addresses, this object returns the IP address
3563 associated with the Cable interface.
3564 This object has been deprecated and replaced by
3565 docsIfCmtsCmStatusInetAddressType and
3566 docsIfCmtsCmStatusInetAddress, to enable IPv6 addressing
3567 in the future."
3568 ::= { docsIfCmtsCmStatusEntry 3 }
3570 docsIfCmtsCmStatusDownChannelIfIndex OBJECT-TYPE
3571 SYNTAX InterfaceIndexOrZero
3572 MAX-ACCESS read-only
3573 STATUS current
3574 DESCRIPTION
3575 "IfIndex of the downstream channel this CM is connected
3576 to. If the downstream channel is unknown, this object
3577 returns a value of zero."
3578 ::= { docsIfCmtsCmStatusEntry 4 }
3580 docsIfCmtsCmStatusUpChannelIfIndex OBJECT-TYPE
3581 SYNTAX InterfaceIndexOrZero
3582 MAX-ACCESS read-only
3583 STATUS current
3584 DESCRIPTION
3585 "For DOCSIS 2.0, indicates the ifIndex of the logical
3586 upstream channel (ifType 205) this CM is connected to.
3587 For DOCSIS 1.x, indicates the ifIndex of the upstream
3588 channel (ifType 129) this CM is connected to.
3589 If the upstream channel is unknown, this object
3590 returns a value of zero."
3591 ::= { docsIfCmtsCmStatusEntry 5 }
3593 docsIfCmtsCmStatusRxPower OBJECT-TYPE
3594 SYNTAX TenthdBmV
3595 UNITS "ThenthdBmV"
3596 MAX-ACCESS read-only
3597 STATUS current
3598 DESCRIPTION
3599 "The receive power as perceived for upstream data from
3600 this cable modem.
3601 If the receive power is unknown, this object returns
3602 a value of zero."
3603 REFERENCE
3604 "Data-Over-Cable Service Interface Specifications: Radio
3605 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3606 Section 6.2.18."
3607 ::= { docsIfCmtsCmStatusEntry 6 }
3609 docsIfCmtsCmStatusTimingOffset OBJECT-TYPE
3610 SYNTAX Unsigned32 (0..4294967295)
3611 MAX-ACCESS read-only
3612 STATUS current
3613 DESCRIPTION
3614 "A measure of the current round trip time for this CM.
3615 Used for timing of CM upstream transmissions to ensure
3616 synchronized arrivals at the CMTS. Units are in terms
3617 of (6.25 microseconds/64). Returns zero if the value
3618 is unknown.
3619 For channels requiring finer resolution, please refer to
3620 object docsIfCmtsCmStatusHighResolutionTimingOffset."
3621 REFERENCE
3622 "Data-Over-Cable Service Interface Specifications: Radio
3623 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3624 Section 6.2.17."
3625 ::= { docsIfCmtsCmStatusEntry 7 }
3627 docsIfCmtsCmStatusEqualizationData OBJECT-TYPE
3628 SYNTAX DocsEqualizerData
3629 MAX-ACCESS read-only
3630 STATUS current
3631 DESCRIPTION
3632 "Equalization data for this CM as measured by the CMTS.
3633 Returns the zero-length OCTET STRING if the value is
3634 unknown or if there is no equalization data available
3635 or defined."
3636 REFERENCE
3637 "Data-Over-Cable Service Interface Specifications: Radio
3638 Frequency Interface Specification SP-RFIv2.0-I07-041210,
3639 Figure 8-23."
3640 ::= { docsIfCmtsCmStatusEntry 8 }
3642 docsIfCmtsCmStatusValue OBJECT-TYPE
3643 SYNTAX INTEGER {
3644 other(1),
3645 ranging(2),
3646 rangingAborted(3),
3647 rangingComplete(4),
3648 ipComplete(5),
3649 registrationComplete(6),
3650 accessDenied(7),
3651 operational(8),
3652 -- value 8 should not be used
3653 registeredBPIInitializing(9)
3654 }
3655 MAX-ACCESS read-only
3656 STATUS current
3657 DESCRIPTION
3658 "Current cable modem connectivity state, as specified
3659 in the RF Interface Specification. Returned status
3660 information is the CM status as assumed by the CMTS,
3661 and indicates the following events:
3662 other(1)
3663 Any state other than below.
3664 ranging(2)
3665 The CMTS has received an Initial Ranging Request
3666 message from the CM, and the ranging process is not
3667 yet complete.
3669 rangingAborted(3)
3670 The CMTS has sent a Ranging Abort message to the CM.
3671 rangingComplete(4)
3672 The CMTS has sent a Ranging Complete message to the CM.
3673 ipComplete(5)
3674 The CMTS has received a DHCP reply message and
3675 forwarded it to the CM.
3676 registrationComplete(6)
3677 The CMTS has sent a Registration Response message to
3678 the CM.
3679 accessDenied(7)
3680 The CMTS has sent a Registration Aborted message
3681 to the CM.
3682 operational(8)
3683 Value 8 is considered reserved and should not be defined
3684 in future revisions of this MIB module to avoid conflict
3685 with documented implementations that support value 8 to
3686 indicate operational state after completing the BPI
3687 initialization process.
3688 registeredBPIInitializing(9)
3689 Baseline Privacy (BPI) is enabled and the CMTS is in the
3690 process of completing BPI initialization. This state
3691 MAY last for a significant length of time if failures
3692 occur during the initialization process. After
3693 completion of BPI initialization, the CMTS will report
3694 registrationComplete(6).
3695 The CMTS only needs to report states it is able to
3696 detect."
3697 REFERENCE
3698 "Data-Over-Cable Service Interface Specifications: Radio
3699 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3700 Section 11.2."
3701 ::= { docsIfCmtsCmStatusEntry 9 }
3703 docsIfCmtsCmStatusUnerroreds OBJECT-TYPE
3704 SYNTAX Counter32
3705 UNITS "codewords"
3706 MAX-ACCESS read-only
3707 STATUS current
3708 DESCRIPTION
3709 "Codewords received without error from this cable modem.
3710 Discontinuities in the value of this counter can occur
3711 at reinitialization of the managed system, and at other
3712 times as indicated by the value of
3713 ifCounterDiscontinuityTime for the associated ifIndex."
3714 REFERENCE
3715 "Data-Over-Cable Service Interface Specifications: Radio
3716 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3717 Section 6.2.4."
3718 ::= { docsIfCmtsCmStatusEntry 10 }
3720 docsIfCmtsCmStatusCorrecteds OBJECT-TYPE
3721 SYNTAX Counter32
3722 UNITS "codewords"
3723 MAX-ACCESS read-only
3724 STATUS current
3725 DESCRIPTION
3726 "Codewords received with correctable errors from this
3727 cable modem.
3728 Discontinuities in the value of this counter can occur
3729 at reinitialization of the managed system, and at other
3730 times as indicated by the value of
3731 ifCounterDiscontinuityTime for the associated ifIndex."
3732 REFERENCE
3733 "Data-Over-Cable Service Interface Specifications: Radio
3734 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3735 Section 6.2.4."
3736 ::= { docsIfCmtsCmStatusEntry 11 }
3738 docsIfCmtsCmStatusUncorrectables OBJECT-TYPE
3739 SYNTAX Counter32
3740 UNITS "codewords"
3741 MAX-ACCESS read-only
3742 STATUS current
3743 DESCRIPTION
3744 "Codewords received with uncorrectable errors from this
3745 cable modem.
3746 Discontinuities in the value of this counter can occur
3747 at reinitialization of the managed system, and at other
3748 times as indicated by the value of
3749 ifCounterDiscontinuityTime for the associated ifIndex."
3750 REFERENCE
3751 "Data-Over-Cable Service Interface Specifications: Radio
3752 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3753 Section 6.2.4."
3754 ::= { docsIfCmtsCmStatusEntry 12 }
3756 docsIfCmtsCmStatusSignalNoise OBJECT-TYPE
3757 SYNTAX TenthdB
3758 UNITS "TenthdB"
3759 MAX-ACCESS read-only
3760 STATUS current
3761 DESCRIPTION
3762 "Signal/Noise ratio as perceived for upstream data from
3763 this cable modem.
3764 If the Signal/Noise is unknown, this object returns
3765 a value of zero."
3766 REFERENCE
3767 "Data-Over-Cable Service Interface Specifications: Radio
3768 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3769 Tables 4-1 and 4-2."
3770 ::= { docsIfCmtsCmStatusEntry 13 }
3772 docsIfCmtsCmStatusMicroreflections OBJECT-TYPE
3773 SYNTAX Integer32 (0..255)
3774 UNITS "-dBc"
3775 MAX-ACCESS read-only
3776 STATUS current
3777 DESCRIPTION
3778 "Total microreflections including in-channel response
3779 as perceived on this interface, measured in dBc below
3780 the signal level.
3781 This object is not assumed to return an absolutely
3782 accurate value, but it gives a rough indication
3783 of microreflections received on this interface.
3784 It is up to the implementer to provide information
3785 as accurate as possible.
3786 Discontinuities in the value of this counter can occur
3787 at reinitialization of the managed system, and at other
3788 times as indicated by the value of
3789 ifCounterDiscontinuityTime for the associated ifIndex."
3790 REFERENCE
3791 "Data-Over-Cable Service Interface Specifications: Radio
3792 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3793 Tables 4-1 and 4-2"
3794 ::= { docsIfCmtsCmStatusEntry 14 }
3796 docsIfCmtsCmStatusExtUnerroreds OBJECT-TYPE
3797 SYNTAX Counter64
3798 UNITS "codewords"
3799 MAX-ACCESS read-only
3800 STATUS current
3801 DESCRIPTION
3802 "Codewords received without error from this cable modem.
3803 Discontinuities in the value of this counter can occur
3804 at reinitialization of the managed system, and at other
3805 times as indicated by the value of
3806 ifCounterDiscontinuityTime for the associated ifIndex."
3807 REFERENCE
3808 "Data-Over-Cable Service Interface Specifications: Radio
3809 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3810 Section 6.2.5."
3811 ::= { docsIfCmtsCmStatusEntry 15 }
3813 docsIfCmtsCmStatusExtCorrecteds OBJECT-TYPE
3814 SYNTAX Counter64
3815 UNITS "codewords"
3816 MAX-ACCESS read-only
3817 STATUS current
3818 DESCRIPTION
3819 "Codewords received with correctable errors from this
3820 cable modem.
3821 Discontinuities in the value of this counter can occur
3822 at reinitialization of the managed system, and at other
3823 times as indicated by the value of
3824 ifCounterDiscontinuityTime for the associated ifIndex."
3825 REFERENCE
3826 "Data-Over-Cable Service Interface Specifications: Radio
3827 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3828 Section 6.2.5."
3829 ::= { docsIfCmtsCmStatusEntry 16 }
3831 docsIfCmtsCmStatusExtUncorrectables OBJECT-TYPE
3832 SYNTAX Counter64
3833 UNITS "codewords"
3834 MAX-ACCESS read-only
3835 STATUS current
3836 DESCRIPTION
3837 "Codewords received with uncorrectable errors from this
3838 cable modem.
3839 Discontinuities in the value of this counter can occur
3840 at reinitialization of the managed system, and at other
3841 times as indicated by the value of
3842 ifCounterDiscontinuityTime for the associated ifIndex."
3843 REFERENCE
3844 "Data-Over-Cable Service Interface Specifications: Radio
3845 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3846 Section 6.2.5."
3847 ::= { docsIfCmtsCmStatusEntry 17 }
3849 docsIfCmtsCmStatusDocsisRegMode OBJECT-TYPE
3850 SYNTAX DocsisQosVersion
3851 MAX-ACCESS read-only
3852 STATUS current
3853 DESCRIPTION
3854 "Indication whether the CM has registered using 1.0
3855 Class of Service or 1.1 Quality of Service."
3856 REFERENCE
3857 "Data-Over-Cable Service Interface Specifications: Radio
3858 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3859 Annex G."
3860 ::= { docsIfCmtsCmStatusEntry 18 }
3862 docsIfCmtsCmStatusModulationType OBJECT-TYPE
3863 SYNTAX DocsisUpstreamType
3864 MAX-ACCESS read-only
3865 STATUS current
3866 DESCRIPTION
3867 "Indicates modulation type currently used by the CM. Since
3868 this object specifically identifies PHY mode, the shared
3869 type is not permitted. If the upstream channel is
3870 unknown, this object returns a value of zero."
3871 REFERENCE
3872 "Data-Over-Cable Service Interface Specifications: Radio
3873 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3874 Table 8-19."
3875 ::= { docsIfCmtsCmStatusEntry 19 }
3877 docsIfCmtsCmStatusInetAddressType OBJECT-TYPE
3878 SYNTAX InetAddressType
3879 MAX-ACCESS read-only
3880 STATUS current
3881 DESCRIPTION
3882 "The type of internet address of
3883 docsIfCmtsCmStatusInetAddress. If the cable modem
3884 internet address is unassigned or unknown, then the
3885 value of this object is unknown(0)."
3886 ::= { docsIfCmtsCmStatusEntry 20 }
3888 docsIfCmtsCmStatusInetAddress OBJECT-TYPE
3889 SYNTAX InetAddress
3890 MAX-ACCESS read-only
3891 STATUS current
3892 DESCRIPTION
3893 "Internet address of this cable modem. If the Cable
3894 Modem has no Internet address assigned, or the Internet
3895 address is unknown, the value of this object is the
3896 zero-length OCTET STRING. If the cable modem has
3897 multiple Internet addresses, this object returns the
3898 Internet address associated with the Cable
3899 (i.e., RF MAC) interface."
3900 ::= { docsIfCmtsCmStatusEntry 21 }
3902 docsIfCmtsCmStatusValueLastUpdate OBJECT-TYPE
3903 SYNTAX TimeStamp
3904 MAX-ACCESS read-only
3905 STATUS current
3906 DESCRIPTION
3907 "The value of sysUpTime when docsIfCmtsCmStatusValue
3908 was last updated."
3909 ::= { docsIfCmtsCmStatusEntry 22 }
3911 docsIfCmtsCmStatusHighResolutionTimingOffset OBJECT-TYPE
3912 SYNTAX Unsigned32 (0..4294967295)
3913 MAX-ACCESS read-only
3914 STATUS current
3915 DESCRIPTION
3916 "A measure of the current round trip time for this CM.
3917 Used for timing of CM upstream transmissions to ensure
3918 synchronized arrivals at the CMTS. Units are in terms
3919 of (6.25 microseconds/(64*256)). Returns zero if the value
3920 is unknown.
3921 This is the high resolution version of object
3922 docsIfCmtsCmStatusTimingOffset, for channels requiring
3923 finer resolution."
3924 REFERENCE
3925 "Data-Over-Cable Service Interface Specifications: Radio
3926 Frequency Interface Specification SP-RFIv2.0-I09-050812,
3927 Section 6.2.17."
3928 ::= { docsIfCmtsCmStatusEntry 23 }
3930 --
3931 -- The CMTS Service Table.
3932 --
3934 docsIfCmtsServiceTable OBJECT-TYPE
3935 SYNTAX SEQUENCE OF DocsIfCmtsServiceEntry
3936 MAX-ACCESS not-accessible
3937 STATUS current
3938 DESCRIPTION
3939 "Describes the attributes of upstream service queues
3940 in a Cable Modem Termination System."
3941 ::= { docsIfCmtsObjects 4 }
3943 docsIfCmtsServiceEntry OBJECT-TYPE
3944 SYNTAX DocsIfCmtsServiceEntry
3945 MAX-ACCESS not-accessible
3946 STATUS current
3947 DESCRIPTION
3948 "Describes the attributes of a single upstream bandwidth
3949 service queue.
3950 Entries in this table exist for each ifEntry with an
3951 ifType of docsCableMaclayer(127), and for each service
3952 queue (Service ID) within this MAC layer.
3953 Entries in this table are created with the creation of
3954 individual Service IDs by the MAC layer and removed
3955 when a Service ID is removed."
3956 INDEX { ifIndex, docsIfCmtsServiceId }
3957 ::= { docsIfCmtsServiceTable 1 }
3959 DocsIfCmtsServiceEntry ::= SEQUENCE {
3960 docsIfCmtsServiceId Integer32,
3961 docsIfCmtsServiceCmStatusIndex Integer32, -- deprecated
3962 docsIfCmtsServiceAdminStatus INTEGER,
3963 docsIfCmtsServiceQosProfile Integer32,
3964 docsIfCmtsServiceCreateTime TimeStamp,
3965 docsIfCmtsServiceInOctets Counter32,
3966 docsIfCmtsServiceInPackets Counter32,
3967 docsIfCmtsServiceNewCmStatusIndex Integer32
3968 }
3970 docsIfCmtsServiceId OBJECT-TYPE
3971 SYNTAX Integer32 (1..16383)
3972 MAX-ACCESS not-accessible
3973 STATUS current
3974 DESCRIPTION
3975 "Identifies a service queue for upstream bandwidth. The
3976 attributes of this service queue are shared between the
3977 Cable Modem and the Cable Modem Termination System.
3978 The CMTS allocates upstream bandwidth to this service
3979 queue based on requests from the CM and on the class of
3980 service associated with this queue."
3981 ::= { docsIfCmtsServiceEntry 1 }
3983 docsIfCmtsServiceCmStatusIndex OBJECT-TYPE
3984 SYNTAX Integer32 (0..65535)
3985 MAX-ACCESS read-only
3986 STATUS deprecated
3987 DESCRIPTION
3988 "Pointer to an entry in docsIfCmtsCmStatusTable identifying
3989 the cable modem using this Service Queue. If multiple
3990 cable modems are using this Service Queue, the value of
3991 this object is zero.
3992 This object has been deprecated and replaced by
3993 docsIfCmtsServiceNewCmStatusIndex, to fix a mismatch
3994 of the value range with respect to docsIfCmtsCmStatusIndex
3995 (1..2147483647)."
3996 ::= { docsIfCmtsServiceEntry 2 }
3998 docsIfCmtsServiceAdminStatus OBJECT-TYPE
3999 SYNTAX INTEGER {
4000 enabled(1),
4001 disabled(2),
4002 destroyed(3) }
4003 MAX-ACCESS read-write
4004 STATUS current
4005 DESCRIPTION
4006 "Allows a service class for a particular modem to be
4007 suppressed, (re-)enabled, or deleted altogether."
4008 ::= { docsIfCmtsServiceEntry 3 }
4010 docsIfCmtsServiceQosProfile OBJECT-TYPE
4011 SYNTAX Integer32 (0..16383)
4012 MAX-ACCESS read-only
4013 STATUS current
4014 DESCRIPTION
4015 "The index in docsIfQosProfileTable describing the quality
4016 of service attributes associated with this particular
4017 service. If no associated docsIfQosProfileTable entry
4018 exists, this object returns a value of zero."
4019 ::= { docsIfCmtsServiceEntry 4 }
4021 docsIfCmtsServiceCreateTime OBJECT-TYPE
4022 SYNTAX TimeStamp
4023 MAX-ACCESS read-only
4024 STATUS current
4025 DESCRIPTION
4026 "The value of sysUpTime when this entry was created."
4027 ::= { docsIfCmtsServiceEntry 5 }
4029 docsIfCmtsServiceInOctets OBJECT-TYPE
4030 SYNTAX Counter32
4031 UNITS "Bytes"
4032 MAX-ACCESS read-only
4033 STATUS current
4034 DESCRIPTION
4035 "The cumulative number of Packet Data octets received
4036 on this Service ID. The count does not include the
4037 size of the Cable MAC header.
4038 Discontinuities in the value of this counter can occur
4039 at reinitialization of the managed system, and at other
4040 times as indicated by the value of
4041 ifCounterDiscontinuityTime for the associated ifIndex."
4042 ::= { docsIfCmtsServiceEntry 6 }
4044 docsIfCmtsServiceInPackets OBJECT-TYPE
4045 SYNTAX Counter32
4046 UNITS "packets"
4047 MAX-ACCESS read-only
4048 STATUS current
4049 DESCRIPTION
4050 "The cumulative number of Packet Data packets received
4051 on this Service ID.
4052 Discontinuities in the value of this counter can occur
4053 at reinitialization of the managed system, and at other
4054 times as indicated by the value of
4055 ifCounterDiscontinuityTime for the associated ifIndex."
4056 ::= { docsIfCmtsServiceEntry 7 }
4058 docsIfCmtsServiceNewCmStatusIndex OBJECT-TYPE
4059 SYNTAX Integer32 (0..2147483647)
4060 MAX-ACCESS read-only
4061 STATUS current
4062 DESCRIPTION
4063 "Pointer (via docsIfCmtsCmStatusIndex) to an entry in
4064 docsIfCmtsCmStatusTable identifying the cable modem
4065 using this Service Queue. If multiple cable modems are
4066 using this Service Queue, the value of this object is
4067 zero."
4068 ::= { docsIfCmtsServiceEntry 8 }
4070 --
4071 -- The following table provides upstream channel modulation profiles.
4072 -- Entries in this table can be
4073 -- re-used by one or more upstream channels. An upstream channel
4074 -- will have a modulation profile for each value of
4075 -- docsIfModIntervalUsageCode.
4076 --
4078 docsIfCmtsModulationTable OBJECT-TYPE
4079 SYNTAX SEQUENCE OF DocsIfCmtsModulationEntry
4080 MAX-ACCESS not-accessible
4081 STATUS current
4082 DESCRIPTION
4083 "Describes a modulation profile associated with one or more
4084 upstream channels."
4085 ::= { docsIfCmtsObjects 5 }
4087 docsIfCmtsModulationEntry OBJECT-TYPE
4088 SYNTAX DocsIfCmtsModulationEntry
4089 MAX-ACCESS not-accessible
4090 STATUS current
4091 DESCRIPTION
4092 "Describes a modulation profile for an Interval Usage Code
4093 for one or more upstream channels.
4094 Entries in this table are created by the operator.
4096 Initial default entries MAY be created at system
4097 initialization time which could report a value
4098 'permanent' or 'readOnly' for docsIfCmtsModStorageType.
4099 A CMTS MAY reject the creation of additional Interval
4100 Usage Codes for a modulation profile being defined at
4101 Initialization time.
4103 No individual objects have to be specified in order
4104 to create an entry in this table.
4105 Note that some objects do not have DEFVAL clauses,
4106 but do have calculated defaults and need not be specified
4107 during row creation."
4108 INDEX { docsIfCmtsModIndex, docsIfCmtsModIntervalUsageCode}
4109 ::= { docsIfCmtsModulationTable 1 }
4111 DocsIfCmtsModulationEntry ::= SEQUENCE {
4112 docsIfCmtsModIndex Integer32,
4113 docsIfCmtsModIntervalUsageCode INTEGER,
4114 docsIfCmtsModControl RowStatus,
4115 docsIfCmtsModType INTEGER,
4116 docsIfCmtsModPreambleLen Integer32,
4117 docsIfCmtsModDifferentialEncoding TruthValue,
4118 docsIfCmtsModFECErrorCorrection Integer32,
4119 docsIfCmtsModFECCodewordLength Integer32,
4120 docsIfCmtsModScramblerSeed Integer32,
4121 docsIfCmtsModMaxBurstSize Integer32,
4122 docsIfCmtsModGuardTimeSize Unsigned32,
4123 docsIfCmtsModLastCodewordShortened TruthValue,
4124 docsIfCmtsModScrambler TruthValue,
4125 docsIfCmtsModByteInterleaverDepth Unsigned32,
4126 docsIfCmtsModByteInterleaverBlockSize Unsigned32,
4127 docsIfCmtsModPreambleType INTEGER,
4128 docsIfCmtsModTcmErrorCorrectionOn TruthValue,
4129 docsIfCmtsModScdmaInterleaverStepSize Unsigned32,
4130 docsIfCmtsModScdmaSpreaderEnable TruthValue,
4131 docsIfCmtsModScdmaSubframeCodes Unsigned32,
4132 docsIfCmtsModChannelType DocsisUpstreamType,
4133 docsIfCmtsModStorageType StorageType
4134 }
4136 docsIfCmtsModIndex OBJECT-TYPE
4137 SYNTAX Integer32 (1..2147483647)
4138 MAX-ACCESS not-accessible
4139 STATUS current
4140 DESCRIPTION
4141 "An index into the Channel Modulation table representing
4142 a group of Interval Usage Codes, all associated with the
4143 same channel."
4144 ::= { docsIfCmtsModulationEntry 1 }
4146 docsIfCmtsModIntervalUsageCode OBJECT-TYPE
4147 SYNTAX INTEGER {
4148 request(1),
4149 requestData(2),
4150 initialRanging(3),
4151 periodicRanging(4),
4152 shortData(5),
4153 longData(6),
4154 advPhyShortData(9),
4155 advPhyLongData(10),
4156 ugs(11)
4157 }
4158 MAX-ACCESS not-accessible
4159 STATUS current
4160 DESCRIPTION
4161 "An index into the Channel Modulation table which, when
4162 grouped with other Interval Usage Codes, fully
4163 instantiate all modulation sets for a given upstream
4164 channel."
4165 REFERENCE
4166 "Data-Over-Cable Service Interface Specifications: Radio
4167 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4168 Table 8-20."
4169 ::= { docsIfCmtsModulationEntry 2 }
4171 docsIfCmtsModControl OBJECT-TYPE
4172 SYNTAX RowStatus
4173 MAX-ACCESS read-create
4174 STATUS current
4175 DESCRIPTION
4176 "Controls and reflects the status of rows in this table.
4177 There is no restriction on the changing of values in this
4178 table while their associated rows are active with the
4179 exception of:
4181 1. If a modulation profile is being referenced by one
4182 or more upstream channels, an attempt to set the value
4183 of docsIfCmtsModChannelType returns 'inconsistentValue'
4184 error.
4186 2. If a modulation profile is being referenced by one
4187 or more upstream channels, an attempt to set
4188 docsIfCmtsModControl to destroy(6) or notInService(2)
4189 returns 'inconsistentValue' error."
4190 ::= { docsIfCmtsModulationEntry 3 }
4192 docsIfCmtsModType OBJECT-TYPE
4193 SYNTAX INTEGER {
4194 other(1),
4195 qpsk(2),
4196 qam16(3),
4197 qam8(4),
4198 qam32(5),
4199 qam64(6),
4200 qam128(7)
4201 }
4202 MAX-ACCESS read-create
4203 STATUS current
4204 DESCRIPTION
4205 "The modulation type used on this channel. Returns
4206 other(1) if the modulation type is neither
4207 qpsk, qam16, qam8, qam32, qam64 or qam128.
4208 Type qam128 is used for SCDMA channels only.
4209 See the reference for the modulation profiles
4210 implied by different modulation types."
4211 REFERENCE
4212 "Data-Over-Cable Service Interface Specifications: Radio
4213 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4214 Tables 6-7, and 8-19."
4215 DEFVAL { qpsk }
4216 ::= { docsIfCmtsModulationEntry 4 }
4218 docsIfCmtsModPreambleLen OBJECT-TYPE
4219 SYNTAX Integer32 (0..1536)
4220 UNITS "bits"
4221 MAX-ACCESS read-create
4222 STATUS current
4223 DESCRIPTION
4224 "The preamble length for this modulation profile in bits.
4225 Default value is the minimum needed by the implementation
4226 at the CMTS for the given modulation profile."
4227 REFERENCE
4228 "Data-Over-Cable Service Interface Specifications: Radio
4229 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4230 Tables 6-7, and 8-19."
4231 ::= { docsIfCmtsModulationEntry 5 }
4233 docsIfCmtsModDifferentialEncoding OBJECT-TYPE
4234 SYNTAX TruthValue
4235 MAX-ACCESS read-create
4236 STATUS current
4237 DESCRIPTION
4238 "Specifies whether or not differential encoding is used
4239 on this channel."
4240 REFERENCE
4241 "Data-Over-Cable Service Interface Specifications: Radio
4242 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4243 Tables 6-7, and 8-19."
4244 DEFVAL { false }
4245 ::= { docsIfCmtsModulationEntry 6 }
4247 docsIfCmtsModFECErrorCorrection OBJECT-TYPE
4248 SYNTAX Integer32 (0..16)
4249 UNITS "Bytes"
4250 MAX-ACCESS read-create
4251 STATUS current
4252 DESCRIPTION
4253 "The number of correctable errored bytes (t) used in
4254 forward error correction code. The value of 0 indicates
4255 no correction is employed. The number of check bytes
4256 appended will be twice this value."
4257 REFERENCE
4258 "Data-Over-Cable Service Interface Specifications: Radio
4259 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4260 Tables 6-7, and 8-19."
4261 DEFVAL { 0 }
4262 ::= { docsIfCmtsModulationEntry 7 }
4264 docsIfCmtsModFECCodewordLength OBJECT-TYPE
4265 SYNTAX Integer32 (1..255)
4266 UNITS "Bytes"
4267 MAX-ACCESS read-create
4268 STATUS current
4269 DESCRIPTION
4270 "The number of data bytes (k) in the forward error
4271 correction codeword.
4272 This object is not used if docsIfCmtsModFECErrorCorrection
4273 is zero."
4274 REFERENCE
4275 "Data-Over-Cable Service Interface Specifications: Radio
4276 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4277 Tables 6-7, and 8-19."
4278 DEFVAL { 32 }
4279 ::= { docsIfCmtsModulationEntry 8 }
4281 docsIfCmtsModScramblerSeed OBJECT-TYPE
4282 SYNTAX Integer32 (0..32767)
4283 MAX-ACCESS read-create
4284 STATUS current
4285 DESCRIPTION
4286 "The 15 bit seed value for the scrambler polynomial."
4287 REFERENCE
4288 "Data-Over-Cable Service Interface Specifications: Radio
4289 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4290 Table 8-19."
4291 DEFVAL { 0 }
4292 ::= { docsIfCmtsModulationEntry 9 }
4294 docsIfCmtsModMaxBurstSize OBJECT-TYPE
4295 SYNTAX Integer32 (0..255)
4296 UNITS "mini-slots"
4297 MAX-ACCESS read-create
4298 STATUS current
4299 DESCRIPTION
4300 "The maximum number of mini-slots that can be transmitted
4301 during this channel's burst time. Returns zero if the
4302 burst length is bounded by the allocation MAP rather than
4303 this profile.
4304 Default value is 0 except for shortData, where it is 8."
4305 REFERENCE
4306 "Data-Over-Cable Service Interface Specifications: Radio
4307 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4308 Table 8-19."
4309 ::= { docsIfCmtsModulationEntry 10 }
4311 docsIfCmtsModGuardTimeSize OBJECT-TYPE
4312 SYNTAX Unsigned32
4313 UNITS "Symbol-times"
4314 MAX-ACCESS read-only
4315 STATUS current
4316 DESCRIPTION
4317 "The number of symbol-times which MUST follow the end of
4318 this channel's burst. Default value is the minimum time
4319 needed by the implementation for this modulation profile."
4320 REFERENCE
4321 "Data-Over-Cable Service Interface Specifications: Radio
4322 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4323 Tables 6-7, and 8-19."
4324 ::= { docsIfCmtsModulationEntry 11 }
4326 docsIfCmtsModLastCodewordShortened OBJECT-TYPE
4327 SYNTAX TruthValue
4328 MAX-ACCESS read-create
4329 STATUS current
4330 DESCRIPTION
4331 "Indicates if the last FEC codeword is truncated."
4332 REFERENCE
4333 "Data-Over-Cable Service Interface Specifications: Radio
4334 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4335 Tables 6-7, and 8-19."
4336 DEFVAL { true }
4337 ::= { docsIfCmtsModulationEntry 12 }
4339 docsIfCmtsModScrambler OBJECT-TYPE
4340 SYNTAX TruthValue
4341 MAX-ACCESS read-create
4342 STATUS current
4343 DESCRIPTION
4344 "Indicates if the scrambler is employed."
4345 REFERENCE
4346 "Data-Over-Cable Service Interface Specifications: Radio
4347 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4348 Tables 6-7, and 8-19."
4349 DEFVAL { false }
4350 ::= { docsIfCmtsModulationEntry 13 }
4352 docsIfCmtsModByteInterleaverDepth OBJECT-TYPE
4353 SYNTAX Unsigned32
4354 MAX-ACCESS read-create
4355 STATUS current
4356 DESCRIPTION
4357 "ATDMA Byte Interleaver Depth (Ir). This object returns 1
4358 for non ATDMA profiles."
4359 REFERENCE
4360 "Data-Over-Cable Service Interface Specifications: Radio
4361 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4362 Tables 6-7, and 8-19."
4363 DEFVAL { 1 }
4364 ::= { docsIfCmtsModulationEntry 14 }
4366 docsIfCmtsModByteInterleaverBlockSize OBJECT-TYPE
4367 SYNTAX Unsigned32
4368 MAX-ACCESS read-create
4369 STATUS current
4370 DESCRIPTION
4371 "ATDMA Byte Interleaver Block size (Br). This object
4372 returns zero for non ATDMA profiles "
4373 REFERENCE
4374 "Data-Over-Cable Service Interface Specifications: Radio
4375 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4376 Tables 6-7, and 8-19."
4377 DEFVAL { 18 }
4378 ::= { docsIfCmtsModulationEntry 15 }
4380 docsIfCmtsModPreambleType OBJECT-TYPE
4381 SYNTAX INTEGER {
4382 unknown(0),
4383 qpsk0(1),
4384 qpsk1(2)
4385 }
4386 MAX-ACCESS read-create
4387 STATUS current
4388 DESCRIPTION
4389 "Preamble type for DOCSIS 2.0 bursts. The value
4390 'unknown(0)' represents a row entry consisting only of
4391 DOCSIS 1.x bursts"
4392 REFERENCE
4393 "Data-Over-Cable Service Interface Specifications: Radio
4394 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4395 Tables 6-7, and 8-19."
4396 DEFVAL { qpsk0 }
4397 ::= { docsIfCmtsModulationEntry 16 }
4399 docsIfCmtsModTcmErrorCorrectionOn OBJECT-TYPE
4400 SYNTAX TruthValue
4401 MAX-ACCESS read-create
4402 STATUS current
4403 DESCRIPTION
4404 "Trellis Code Modulation (TCM) On/Off. This value returns
4405 false for non S-CDMA profiles."
4406 REFERENCE
4407 "Data-Over-Cable Service Interface Specifications: Radio
4408 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4409 Tables 6-7, and 8-19."
4410 DEFVAL { false }
4411 ::= { docsIfCmtsModulationEntry 17 }
4413 docsIfCmtsModScdmaInterleaverStepSize OBJECT-TYPE
4414 SYNTAX Unsigned32 (0 | 1..32)
4415 MAX-ACCESS read-create
4416 STATUS current
4417 DESCRIPTION
4418 " S-CDMA Interleaver step size. This value returns zero
4419 for non S-CDMA profiles."
4420 REFERENCE
4421 "Data-Over-Cable Service Interface Specifications: Radio
4422 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4423 Tables 6-7, and 8-19."
4424 DEFVAL { 1 }
4425 ::= { docsIfCmtsModulationEntry 18 }
4427 docsIfCmtsModScdmaSpreaderEnable OBJECT-TYPE
4428 SYNTAX TruthValue
4429 MAX-ACCESS read-create
4430 STATUS current
4431 DESCRIPTION
4432 " S-CDMA spreader. This value returns false for non S-CDMA
4433 profiles. Default value for IUC 3 and 4 is OFF, for
4434 all other IUCs it is ON."
4435 REFERENCE
4436 "Data-Over-Cable Service Interface Specifications: Radio
4437 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4438 Tables 6-7, and 8-19."
4440 ::= { docsIfCmtsModulationEntry 19 }
4442 docsIfCmtsModScdmaSubframeCodes OBJECT-TYPE
4443 SYNTAX Unsigned32 (0 | 1..128)
4444 MAX-ACCESS read-create
4445 STATUS current
4446 DESCRIPTION
4447 " S-CDMA sub-frame size. This value returns zero
4448 for non S-CDMA profiles."
4449 REFERENCE
4450 "Data-Over-Cable Service Interface Specifications: Radio
4451 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4452 Table 6-7, and 8-19."
4453 DEFVAL { 1 }
4454 ::= { docsIfCmtsModulationEntry 20 }
4456 docsIfCmtsModChannelType OBJECT-TYPE
4457 SYNTAX DocsisUpstreamType
4458 MAX-ACCESS read-create
4459 STATUS current
4460 DESCRIPTION
4461 "Describes the modulation channel type for this modulation
4462 entry.
4463 All the active entries in a modulation profile (that is all
4464 active entries that share a common docsIfCmtsModIndex)
4465 MUST have the same value of docsIfCmtsModChannelType."
4466 REFERENCE
4467 "Data-Over-Cable Service Interface Specifications: Radio
4468 Frequency Interface Specification SP-RFIv2.0-I09-050812,
4469 Table 8-19."
4470 DEFVAL { tdma }
4471 ::= { docsIfCmtsModulationEntry 21 }
4473 docsIfCmtsModStorageType OBJECT-TYPE
4474 SYNTAX StorageType
4475 MAX-ACCESS read-only
4476 STATUS current
4477 DESCRIPTION
4478 "The storage type for this conceptual row.
4479 Entries with this object set to permanent(4)
4480 do not require write operations for read-write
4481 objects."
4482 DEFVAL { nonVolatile }
4483 ::= { docsIfCmtsModulationEntry 22 }
4485 docsIfCmtsQosProfilePermissions OBJECT-TYPE
4486 SYNTAX BITS {
4487 createByManagement(0),
4488 updateByManagement(1),
4489 createByModems(2)
4490 }
4491 MAX-ACCESS read-write
4492 STATUS current
4493 DESCRIPTION
4494 "This object specifies permitted methods of creating
4495 entries in docsIfQosProfileTable.
4496 createByManagement(0) is set if entries can be created
4497 using SNMP. updateByManagement(1) is set if updating
4498 entries using SNMP is permitted. createByModems(2)
4499 is set if entries can be created based on information
4500 in REG-REQ MAC messages received from cable modems.
4501 Information in this object is only applicable if
4502 docsIfQosProfileTable is implemented as read-create.
4503 Otherwise, this object is implemented as read-only
4504 and returns createByModems(2).
4505 Either createByManagement(0), or updateByManagement(1),
4506 MUST be set when writing to this object.
4507 Note that BITS objects are encoded most significant bit
4508 first. For example, if bit 2 is set, the value of this
4509 object is the octet string '20'H."
4510 ::= { docsIfCmtsObjects 6 }
4512 docsIfCmtsMacToCmTable OBJECT-TYPE
4513 SYNTAX SEQUENCE OF DocsIfCmtsMacToCmEntry
4514 MAX-ACCESS not-accessible
4515 STATUS current
4516 DESCRIPTION
4517 "This is a table to provide a quick access index into the
4518 docsIfCmtsCmStatusTable. There is exactly one row in this
4519 table for each row in the docsIfCmtsCmStatusTable. In
4520 general, the management station SHOULD use this table only
4521 to get a pointer into the docsIfCmtsCmStatusTable (which
4522 corresponds to the CM's RF interface MAC address), and
4523 SHOULD not iterate (e.g. GetNext through) this table."
4524 ::= { docsIfCmtsObjects 7 }
4526 docsIfCmtsMacToCmEntry OBJECT-TYPE
4527 SYNTAX DocsIfCmtsMacToCmEntry
4528 MAX-ACCESS not-accessible
4529 STATUS current
4530 DESCRIPTION
4531 "A row in the docsIfCmtsMacToCmTable.
4532 An entry in this table exists for each cable modem
4533 that is connected to the CMTS implementing this table."
4534 INDEX { docsIfCmtsCmMac }
4535 ::= {docsIfCmtsMacToCmTable 1 }
4537 DocsIfCmtsMacToCmEntry ::= SEQUENCE {
4538 docsIfCmtsCmMac MacAddress,
4539 docsIfCmtsCmPtr Integer32
4540 }
4542 docsIfCmtsCmMac OBJECT-TYPE
4543 SYNTAX MacAddress
4544 MAX-ACCESS not-accessible
4545 STATUS current
4546 DESCRIPTION
4547 "The RF side MAC address for the referenced CM. (E.g. the
4548 interface on the CM that has docsCableMacLayer(127) as
4549 its ifType."
4550 ::= { docsIfCmtsMacToCmEntry 1 }
4552 docsIfCmtsCmPtr OBJECT-TYPE
4553 SYNTAX Integer32 (1..2147483647)
4554 MAX-ACCESS read-only
4555 STATUS current
4556 DESCRIPTION
4557 "An row index into docsIfCmtsCmStatusTable. When queried
4558 with the correct instance value (e.g. a CM's MAC address),
4559 returns the index in docsIfCmtsCmStatusTable which
4560 represents that CM."
4561 ::= { docsIfCmtsMacToCmEntry 2 }
4563 -- The following independent object and associated table provide
4564 -- operators with a mechanism to evaluate the load/utilization of
4565 -- both upstream and downstream physical channels. This information
4566 -- may be used for capacity planning and incident analysis, and may
4567 -- be particularly helpful in provisioning of high value QOS.
4568 --
4569 -- Utilization is expressed as an index representing the calculated
4570 -- percentage utilization of the upstream or downstream channel in
4571 -- the most recent sampling interval (ie. utilization interval).
4572 -- Refer to the DESCRIPTION field of the
4573 -- docsIfCmtsChannelUtUtilization object for definitions and
4574 -- calculation details.
4576 docsIfCmtsChannelUtilizationInterval OBJECT-TYPE
4577 SYNTAX Integer32 (0..86400)
4578 UNITS "seconds"
4579 MAX-ACCESS read-write
4580 STATUS current
4581 DESCRIPTION
4582 "The time interval in seconds over which the channel
4583 utilization index is calculated. All upstream/downstream
4584 channels use the same
4585 docsIfCmtsChannelUtilizationInterval.
4586 Setting a value of zero disables utilization reporting.
4587 A channel utilization index is calculated over a fixed
4588 window applying to the most recent
4589 docsIfCmtsChannelUtilizationInterval. It would therefore
4590 be prudent to use a relatively short
4591 docsIfCmtsChannelUtilizationInterval.
4592 It is a vendor decision whether to reset the timer when
4593 docsIfCmtsChannelUtilizationInterval is changed during a
4594 utilization sampling period."
4595 ::= { docsIfCmtsObjects 8 }
4597 docsIfCmtsChannelUtilizationTable OBJECT-TYPE
4598 SYNTAX SEQUENCE OF DocsIfCmtsChannelUtilizationEntry
4599 MAX-ACCESS not-accessible
4600 STATUS current
4601 DESCRIPTION
4602 "Reports utilization statistics for attached upstream and
4603 downstream physical channels."
4604 ::= { docsIfCmtsObjects 9 }
4606 docsIfCmtsChannelUtilizationEntry OBJECT-TYPE
4607 SYNTAX DocsIfCmtsChannelUtilizationEntry
4608 MAX-ACCESS not-accessible
4609 STATUS current
4610 DESCRIPTION
4611 "Utilization statistics for a single upstream or downstream
4612 physical channel. An entry exists in this table for each
4613 ifEntry with an ifType equal to
4614 docsCableDownstream (128)
4615 or docsCableUpstream (129)."
4616 INDEX { ifIndex, docsIfCmtsChannelUtIfType,
4617 docsIfCmtsChannelUtId }
4618 ::= { docsIfCmtsChannelUtilizationTable 1 }
4620 DocsIfCmtsChannelUtilizationEntry ::= SEQUENCE {
4621 docsIfCmtsChannelUtIfType IANAifType,
4622 docsIfCmtsChannelUtId Integer32,
4623 docsIfCmtsChannelUtUtilization Integer32
4624 }
4626 docsIfCmtsChannelUtIfType OBJECT-TYPE
4627 SYNTAX IANAifType
4628 MAX-ACCESS not-accessible
4629 STATUS current
4630 DESCRIPTION
4631 "The secondary index into this table. Indicates the IANA
4632 interface type associated with this physical channel.
4634 Only docsCableDownstream (128) and
4635 docsCableUpstream (129) are valid."
4636 ::= { docsIfCmtsChannelUtilizationEntry 1 }
4638 docsIfCmtsChannelUtId OBJECT-TYPE
4639 SYNTAX Integer32 (0..255)
4640 MAX-ACCESS not-accessible
4641 STATUS current
4642 DESCRIPTION
4643 "The tertiary index into this table. Indicates the CMTS
4644 identifier for this physical channel."
4645 ::= { docsIfCmtsChannelUtilizationEntry 2 }
4647 docsIfCmtsChannelUtUtilization OBJECT-TYPE
4648 SYNTAX Integer32 (0..100)
4649 UNITS "percent"
4650 MAX-ACCESS read-only
4651 STATUS current
4652 DESCRIPTION
4653 "The calculated and truncated utilization index for this
4654 physical upstream or downstream channel, accurate as of
4655 the most recent docsIfCmtsChannelUtilizationInterval.
4657 Upstream Channel Utilization Index:
4658 The upstream channel utilization index is expressed as a
4659 percentage of mini-slots utilized on the physical channel,
4660 regardless of burst type. For an Initial Maintenance
4661 region, the mini-slots for the complete region are
4662 considered utilized if the CMTS received an upstream
4663 burst within the region from any CM on the physical
4664 channel. For contention REQ and REQ/DATA regions, the
4665 mini-slots for a transmission opportunity within the
4666 region are considered utilized if the CMTS received an
4667 upstream burst within the opportunity from any CM on the
4668 physical channel. For all other regions, utilized
4669 mini-slots are those in which the CMTS granted
4670 bandwidth to any unicast SID on the physical channel.
4672 For an upstream interface that has multiple logical
4673 upstream channels enabled, the utilization index is a
4674 weighted sum of utilization indices for the logical
4675 channels. The weight for each utilization index is the
4676 percentage of upstream mini-slots allocated for the
4677 corresponding logical channel.
4678 Example:
4679 If 75% of bandwidth is allocated to the first logical
4680 channel and 25% to the second, and the utilization
4681 indices for each are 60 and 40 respectively, the
4682 utilization index for the upstream physical channel is
4683 (60 * 0.75) + (40 * 0.25) = 55. This figure
4684 applies to the most recent utilization interval.
4686 Downstream Channel Utilization Index:
4687 The downstream channel utilization index is a percentage
4688 expressing the ratio between bytes used to transmit data
4689 versus the total number of bytes transmitted in the raw
4690 bandwidth of the MPEG channel. As with the upstream
4691 utilization index, the calculated value represents
4692 the most recent utilization interval.
4693 Formula:
4694 Downstream utilization index =
4695 (100 * (data bytes / raw bytes))
4697 Definitions:
4698 Data bytes: Number of bytes transmitted as data in the
4699 docsIfCmtsChannelUtilizationInterval.
4700 Identical to docsIfCmtsDownChannelCtrUsed
4701 Bytes measured over the utilization
4702 interval.
4703 Raw bandwidth: Total number of bytes available for
4704 transmitting data, not including bytes
4705 used for headers and other overhead.
4706 Raw bytes: (raw bandwidth *
4707 docsIfCmtsChannelUtilizationInterval).
4708 Identical to docsIfCmtsDownChannelCtrTotal
4709 Bytes measured over the utilization
4710 interval."
4711 ::= { docsIfCmtsChannelUtilizationEntry 3 }
4713 -- The following table provides operators with input data
4714 -- appropriate for calculating downstream channel utilization.
4715 -- Operators may use the docsIfCmtsChannelUtilizationTable, or
4716 -- perform their own polling of the
4717 -- docsIfCmtsDownChannelCounterTable objects to characterize
4718 -- their downstream channel usage. The 32 bit counter objects are
4719 -- included to provide backward compatibility with SNMPv1 managers,
4720 -- which cannot access 64 bit counter objects.
4722 docsIfCmtsDownChannelCounterTable OBJECT-TYPE
4723 SYNTAX SEQUENCE OF DocsIfCmtsDownChannelCounterEntry
4724 MAX-ACCESS not-accessible
4725 STATUS current
4726 DESCRIPTION
4727 "This table is implemented at the CMTS to collect
4728 downstream channel statistics for utilization
4729 calculations."
4731 ::= { docsIfCmtsObjects 10 }
4733 docsIfCmtsDownChannelCounterEntry OBJECT-TYPE
4734 SYNTAX DocsIfCmtsDownChannelCounterEntry
4735 MAX-ACCESS not-accessible
4736 STATUS current
4737 DESCRIPTION
4738 "An entry provides a list of traffic counters for a single
4739 downstream channel.
4740 An entry in this table exists for each ifEntry with an
4741 ifType of docsCableDownstream(128)."
4742 INDEX { ifIndex }
4743 ::= { docsIfCmtsDownChannelCounterTable 1 }
4745 DocsIfCmtsDownChannelCounterEntry ::= SEQUENCE {
4746 docsIfCmtsDownChnlCtrId Integer32,
4747 docsIfCmtsDownChnlCtrTotalBytes Counter32,
4748 docsIfCmtsDownChnlCtrUsedBytes Counter32,
4749 docsIfCmtsDownChnlCtrExtTotalBytes Counter64,
4750 docsIfCmtsDownChnlCtrExtUsedBytes Counter64
4751 }
4753 docsIfCmtsDownChnlCtrId OBJECT-TYPE
4754 SYNTAX Integer32 (0..255)
4755 MAX-ACCESS read-only
4756 STATUS current
4757 DESCRIPTION
4758 "The Cable Modem Termination System identification
4759 of the downstream channel within this particular MAC
4760 interface. If the interface is down, the object returns
4761 the most current value. If the downstream channel ID is
4762 unknown, this object returns a value of 0."
4763 ::= { docsIfCmtsDownChannelCounterEntry 1 }
4765 docsIfCmtsDownChnlCtrTotalBytes OBJECT-TYPE
4766 SYNTAX Counter32
4767 UNITS "Bytes"
4768 MAX-ACCESS read-only
4769 STATUS current
4770 DESCRIPTION
4771 "At the CMTS, the total number of bytes in the Payload
4772 portion of MPEG Packets (ie. not including MPEG header
4773 or pointer_field) transported by this downstream channel.
4774 This is the 32 bit version of
4775 docsIfCmtsDownChnlCtrExtTotalBytes, included to provide
4776 back compatibility with SNMPv1 managers.
4777 Discontinuities in the value of this counter can occur
4778 at reinitialization of the managed system, and at other
4779 times as indicated by the value of
4780 ifCounterDiscontinuityTime for the associated ifIndex."
4781 ::= { docsIfCmtsDownChannelCounterEntry 2 }
4783 docsIfCmtsDownChnlCtrUsedBytes OBJECT-TYPE
4784 SYNTAX Counter32
4785 UNITS "Bytes"
4786 MAX-ACCESS read-only
4787 STATUS current
4788 DESCRIPTION
4789 "At the CMTS, the total number of DOCSIS data bytes
4790 transported by this downstream channel.
4791 The number of data bytes is defined as the total number
4792 of bytes transported in DOCSIS payloads minus the number
4793 of stuff bytes transported in DOCSIS payloads.
4794 This is the 32 bit version of
4795 docsIfCmtsDownChnlCtrExtUsedBytes, included to provide
4796 back compatibility with SNMPv1 managers.
4797 Discontinuities in the value of this counter can occur
4798 at reinitialization of the managed system, and at other
4799 times as indicated by the value of
4800 ifCounterDiscontinuityTime for the associated ifIndex."
4801 ::= { docsIfCmtsDownChannelCounterEntry 3 }
4803 docsIfCmtsDownChnlCtrExtTotalBytes OBJECT-TYPE
4804 SYNTAX Counter64
4805 UNITS "Bytes"
4806 MAX-ACCESS read-only
4807 STATUS current
4808 DESCRIPTION
4809 "At the CMTS, the total number of bytes in the Payload
4810 portion of MPEG Packets (ie. not including MPEG header
4811 or pointer_field) transported by this downstream
4812 channel.
4813 This is the 64 bit version of
4814 docsIfCmtsDownChnlCtrTotalBytes, and will not be
4815 accessible to SNMPv1 managers.
4816 Discontinuities in the value of this counter can occur
4817 at reinitialization of the managed system, and at other
4818 times as indicated by the value of
4819 ifCounterDiscontinuityTime for the associated ifIndex."
4820 ::= { docsIfCmtsDownChannelCounterEntry 4 }
4822 docsIfCmtsDownChnlCtrExtUsedBytes OBJECT-TYPE
4823 SYNTAX Counter64
4824 UNITS "Bytes"
4825 MAX-ACCESS read-only
4826 STATUS current
4827 DESCRIPTION
4828 "At the CMTS, the total number of DOCSIS data bytes
4829 transported by this downstream channel. The number
4830 of data bytes is defined as the total number of bytes
4831 transported in DOCSIS payloads minus the number of
4832 stuff bytes transported in DOCSIS payloads.
4833 This is the 64 bit version of
4834 docsIfCmtsDownChnlCtrUsedBytes, and will not be accessible
4835 to SNMPv1 managers.
4836 Discontinuities in the value of this counter can occur
4837 at reinitialization of the managed system, and at other
4838 times as indicated by the value of
4839 ifCounterDiscontinuityTime for the associated ifIndex."
4840 ::= { docsIfCmtsDownChannelCounterEntry 5 }
4842 -- The following table provides operators with input data appropriate
4843 -- for calculating upstream channel utilization, and for determining
4844 -- the traffic characteristics of upstream channels. Operators may
4845 -- use the docsIfCmtsChannelUtilizationTable, or perform their own
4846 -- polling of the docsIfCmtsUpChannelCounterTable objects for
4847 -- utilization determination.
4848 -- The first four 32 and 64 objects in this table are mandatory.
4849 -- Vendors may choose to implement the remaining optional objects to
4850 -- provide operators with finer characterization of upstream channel
4851 -- traffic patterns. The 32 bit counter objects are included to
4852 -- provide backward compatibility with SNMPv1 managers, which cannot
4853 -- access 64 bit counter objects.
4855 docsIfCmtsUpChannelCounterTable OBJECT-TYPE
4856 SYNTAX SEQUENCE OF DocsIfCmtsUpChannelCounterEntry
4857 MAX-ACCESS not-accessible
4858 STATUS current
4859 DESCRIPTION
4860 "This table is implemented at the CMTS to provide upstream
4861 channel statistics appropriate for channel utilization
4862 calculations."
4863 ::= { docsIfCmtsObjects 11 }
4865 docsIfCmtsUpChannelCounterEntry OBJECT-TYPE
4866 SYNTAX DocsIfCmtsUpChannelCounterEntry
4867 MAX-ACCESS not-accessible
4868 STATUS current
4869 DESCRIPTION
4870 "List of traffic statistics for a single upstream channel.
4871 For DOCSIS 2.0 CMTSs, an entry in this table
4872 exists for each ifEntry with an ifType of
4873 docsCableUpstreamChannel (205).
4875 For DOCSIS 1.x CMTSs, an entry in this table
4876 exists for each ifEntry with an ifType of
4877 docsCableUpstream (129)."
4878 INDEX { ifIndex }
4879 ::= { docsIfCmtsUpChannelCounterTable 1 }
4881 DocsIfCmtsUpChannelCounterEntry ::= SEQUENCE {
4882 docsIfCmtsUpChnlCtrId Integer32,
4883 docsIfCmtsUpChnlCtrTotalMslots Counter32,
4884 docsIfCmtsUpChnlCtrUcastGrantedMslots Counter32,
4885 docsIfCmtsUpChnlCtrTotalCntnMslots Counter32,
4886 docsIfCmtsUpChnlCtrUsedCntnMslots Counter32,
4887 docsIfCmtsUpChnlCtrExtTotalMslots Counter64,
4888 docsIfCmtsUpChnlCtrExtUcastGrantedMslots Counter64,
4889 docsIfCmtsUpChnlCtrExtTotalCntnMslots Counter64,
4890 docsIfCmtsUpChnlCtrExtUsedCntnMslots Counter64,
4891 docsIfCmtsUpChnlCtrCollCntnMslots Counter32,
4892 docsIfCmtsUpChnlCtrTotalCntnReqMslots Counter32,
4893 docsIfCmtsUpChnlCtrUsedCntnReqMslots Counter32,
4894 docsIfCmtsUpChnlCtrCollCntnReqMslots Counter32,
4895 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots Counter32,
4896 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots Counter32,
4897 docsIfCmtsUpChnlCtrCollCntnReqDataMslots Counter32,
4898 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots Counter32,
4899 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots Counter32,
4900 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots Counter32,
4901 docsIfCmtsUpChnlCtrExtCollCntnMslots Counter64,
4902 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots Counter64,
4903 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots Counter64,
4904 docsIfCmtsUpChnlCtrExtCollCntnReqMslots Counter64,
4905 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots Counter64,
4906 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots Counter64,
4907 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots Counter64,
4908 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots Counter64,
4909 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots Counter64,
4910 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots Counter64
4911 }
4913 docsIfCmtsUpChnlCtrId OBJECT-TYPE
4914 SYNTAX Integer32 (0..255)
4915 MAX-ACCESS read-only
4916 STATUS current
4917 DESCRIPTION
4918 "The CMTS identification of the upstream channel."
4919 ::= { docsIfCmtsUpChannelCounterEntry 1 }
4921 docsIfCmtsUpChnlCtrTotalMslots OBJECT-TYPE
4922 SYNTAX Counter32
4923 UNITS "mini-slots"
4924 MAX-ACCESS read-only
4925 STATUS current
4926 DESCRIPTION
4927 "Current count, from CMTS initialization, of all mini-slots
4928 defined for this upstream logical channel. This count
4929 includes all IUCs and SIDs, even those allocated to the
4930 NULL SID for a 2.0 logical channel which is inactive. This
4931 is the 32 bit version of docsIfCmtsUpChnlCtrExtTotalMslots
4932 and is included for back compatibility with SNMPv1
4933 managers. Support for this object is mandatory.
4934 Discontinuities in the value of this counter can occur
4935 at reinitialization of the managed system, and at other
4936 times as indicated by the value of
4937 ifCounterDiscontinuityTime for the associated ifIndex."
4938 ::= { docsIfCmtsUpChannelCounterEntry 2 }
4940 docsIfCmtsUpChnlCtrUcastGrantedMslots OBJECT-TYPE
4941 SYNTAX Counter32
4942 UNITS "mini-slots"
4943 MAX-ACCESS read-only
4944 STATUS current
4945 DESCRIPTION
4946 "Current count, from CMTS initialization, of unicast
4947 granted mini-slots on the upstream logical channel,
4948 regardless of burst type. Unicast granted mini-slots are
4949 those in which the CMTS assigned bandwidth to any unicast
4950 SID on the logical channel. However this object does not
4951 include minis-lots for reserved IUCs, or grants to SIDs
4952 designated as meaning 'no CM'. This is the 32 bit version
4953 of docsIfCmtsUpChnlCtrExtUcastGrantedMslots, and is
4954 included for back compatibility with SNMPv1 managers.
4955 Support for this object is mandatory.
4956 Discontinuities in the value of this counter can occur
4957 at reinitialization of the managed system, and at other
4958 times as indicated by the value of
4959 ifCounterDiscontinuityTime for the associated ifIndex."
4960 ::= { docsIfCmtsUpChannelCounterEntry 3 }
4962 docsIfCmtsUpChnlCtrTotalCntnMslots OBJECT-TYPE
4963 SYNTAX Counter32
4964 UNITS "mini-slots"
4965 MAX-ACCESS read-only
4966 STATUS current
4967 DESCRIPTION
4968 "Current count, from CMTS initialization, of contention
4969 mini-slots defined for this upstream logical channel. This
4970 count includes all mini-slots assigned to a broadcast or
4971 multicast SID on the logical channel. This is the 32 bit
4972 version of docsIfCmtsUpChnlCtrExtTotalCntnMslots, and is
4973 included for back compatibility with SNMPv1 managers.
4974 Support for this object is mandatory.
4975 Discontinuities in the value of this counter can occur
4976 at reinitialization of the managed system, and at other
4977 times as indicated by the value of
4978 ifCounterDiscontinuityTime for the associated ifIndex."
4979 ::= { docsIfCmtsUpChannelCounterEntry 4 }
4981 docsIfCmtsUpChnlCtrUsedCntnMslots OBJECT-TYPE
4982 SYNTAX Counter32
4983 UNITS "mini-slots"
4984 MAX-ACCESS read-only
4985 STATUS current
4986 DESCRIPTION
4987 "Current count, from CMTS initialization, of contention
4988 mini-slots utilized on the upstream logical channel. For
4989 contention regions, utilized mini-slots are those in which
4990 the CMTS correctly received an upstream burst from any CM
4991 on the upstream logical channel. This is the 32 bit
4992 version of docsIfCmtsUpChnlCtrExtUsedCntnMslots, and is
4993 included for back compatibility with SNMPv1 managers.
4994 Support for this object is mandatory.
4995 Discontinuities in the value of this counter can occur
4996 at reinitialization of the managed system, and at other
4997 times as indicated by the value of
4998 ifCounterDiscontinuityTime for the associated ifIndex."
4999 ::= { docsIfCmtsUpChannelCounterEntry 5 }
5001 docsIfCmtsUpChnlCtrExtTotalMslots OBJECT-TYPE
5002 SYNTAX Counter64
5003 UNITS "mini-slots"
5004 MAX-ACCESS read-only
5005 STATUS current
5006 DESCRIPTION
5007 "Current count, from CMTS initialization, of all mini-slots
5008 defined for this upstream logical channel. This count
5009 includes all IUCs and SIDs, even those allocated to the
5010 NULL SID for a 2.0 logical channel which is inactive. This
5011 is the 64 bit version of docsIfCmtsUpChnlCtrTotalMslots,
5012 and will not be accessible to SNMPv1 managers.
5013 Support for this object is mandatory.
5014 Discontinuities in the value of this counter can occur
5015 at reinitialization of the managed system, and at other
5016 times as indicated by the value of
5017 ifCounterDiscontinuityTime for the associated ifIndex."
5018 ::= { docsIfCmtsUpChannelCounterEntry 6 }
5020 docsIfCmtsUpChnlCtrExtUcastGrantedMslots OBJECT-TYPE
5021 SYNTAX Counter64
5022 UNITS "mini-slots"
5023 MAX-ACCESS read-only
5024 STATUS current
5025 DESCRIPTION
5026 "Current count, from CMTS initialization, of unicast
5027 granted mini-slots on the upstream logical channel,
5028 regardless of burst type. Unicast granted mini-slots are
5029 those in which the CMTS assigned bandwidth to any unicast
5030 SID on the logical channel. However this object does not
5031 include mini-slots for reserved IUCs, or grants to SIDs
5032 designated as meaning 'no CM'. This is the 64 bit version
5033 of docsIfCmtsUpChnlCtrUcastGrantedMslots, and will not be
5034 accessible to SNMPv1 managers.
5035 Support for this object is mandatory.
5036 Discontinuities in the value of this counter can occur
5037 at reinitialization of the managed system, and at other
5038 times as indicated by the value of
5039 ifCounterDiscontinuityTime for the associated ifIndex."
5040 ::= { docsIfCmtsUpChannelCounterEntry 7 }
5042 docsIfCmtsUpChnlCtrExtTotalCntnMslots OBJECT-TYPE
5043 SYNTAX Counter64
5044 UNITS "mini-slots"
5045 MAX-ACCESS read-only
5046 STATUS current
5047 DESCRIPTION
5048 "Current count, from CMTS initialization, of contention
5049 mini-slots defined for this upstream logical channel. This
5050 count includes all mini-slots assigned to a broadcast or
5051 multicast SID on the logical channel. This is the 64 bit
5052 version of docsIfCmtsUpChnlCtrTotalCntnMslots, and will
5053 not be accessible to SNMPv1 managers.
5054 Support for this object is mandatory.
5055 Discontinuities in the value of this counter can occur
5056 at reinitialization of the managed system, and at other
5057 times as indicated by the value of
5058 ifCounterDiscontinuityTime for the associated ifIndex."
5059 ::= { docsIfCmtsUpChannelCounterEntry 8 }
5061 docsIfCmtsUpChnlCtrExtUsedCntnMslots OBJECT-TYPE
5062 SYNTAX Counter64
5063 UNITS "mini-slots"
5064 MAX-ACCESS read-only
5065 STATUS current
5066 DESCRIPTION
5067 "Current count, from CMTS initialization, of contention
5068 mini-slots utilized on the upstream logical channel. For
5069 contention regions, utilized mini-slots are those in which
5070 the CMTS correctly received an upstream burst from any CM
5071 on the upstream logical channel. This is the 64 bit
5072 version of docsIfCmtsUpChnlCtrUsedCntnMslots, and will not
5073 be accessible to SNMPv1 managers.
5074 Support for this object is mandatory.
5075 Discontinuities in the value of this counter can occur
5076 at reinitialization of the managed system, and at other
5077 times as indicated by the value of
5078 ifCounterDiscontinuityTime for the associated ifIndex."
5079 ::= { docsIfCmtsUpChannelCounterEntry 9 }
5081 docsIfCmtsUpChnlCtrCollCntnMslots OBJECT-TYPE
5082 SYNTAX Counter32
5083 UNITS "mini-slots"
5084 MAX-ACCESS read-only
5085 STATUS current
5086 DESCRIPTION
5087 "Current count, from CMTS initialization, of contention
5088 mini-slots subjected to collisions on the upstream logical
5089 channel. For contention regions, these are the mini-slots
5090 applicable to bursts that the CMTS detected, but could not
5091 correctly receive. This is the 32 bit version of
5092 docsIfCmtsUpChnlCtrExtCollCntnMslots, and is included for
5093 back compatibility with SNMPv1 managers.
5094 Discontinuities in the value of this counter can occur
5095 at reinitialization of the managed system, and at other
5096 times as indicated by the value of
5097 ifCounterDiscontinuityTime for the associated ifIndex."
5098 ::= { docsIfCmtsUpChannelCounterEntry 10 }
5100 docsIfCmtsUpChnlCtrTotalCntnReqMslots OBJECT-TYPE
5101 SYNTAX Counter32
5102 UNITS "mini-slots"
5103 MAX-ACCESS read-only
5104 STATUS current
5105 DESCRIPTION
5106 "Current count, from CMTS initialization, of contention
5107 request mini-slots defined for this upstream logical
5108 channel. This count includes all mini-slots for IUC1
5109 assigned to a broadcast or multicast SID on the logical
5110 channel. This is the 32 bit version of
5111 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots, and is included
5112 for back compatibility with SNMPv1 managers.
5113 Discontinuities in the value of this counter can occur
5114 at reinitialization of the managed system, and at other
5115 times as indicated by the value of
5116 ifCounterDiscontinuityTime for the associated ifIndex."
5117 ::= { docsIfCmtsUpChannelCounterEntry 11 }
5119 docsIfCmtsUpChnlCtrUsedCntnReqMslots OBJECT-TYPE
5120 SYNTAX Counter32
5121 UNITS "mini-slots"
5122 MAX-ACCESS read-only
5123 STATUS current
5124 DESCRIPTION
5125 "Current count, from CMTS initialization, of contention
5126 request mini-slots utilized on this upstream logical
5127 channel. This count includes all contention mini-slots for
5128 IUC1 applicable to bursts that the CMTS correctly
5129 received. This is the 32 bit version of
5130 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots, and is included
5131 for back compatibility with SNMPv1 managers.
5132 Discontinuities in the value of this counter can occur
5133 at reinitialization of the managed system, and at other
5134 times as indicated by the value of
5135 ifCounterDiscontinuityTime for the associated ifIndex."
5136 ::= { docsIfCmtsUpChannelCounterEntry 12 }
5138 docsIfCmtsUpChnlCtrCollCntnReqMslots OBJECT-TYPE
5139 SYNTAX Counter32
5140 UNITS "mini-slots"
5141 MAX-ACCESS read-only
5142 STATUS current
5143 DESCRIPTION
5144 "Current count, from CMTS initialization, of contention
5145 request mini-slots subjected to collisions on this upstream
5146 logical channel. This includes all contention mini-slots
5147 for IUC1 applicable to bursts that the CMTS detected, but
5148 could not correctly receive. This is the 32 bit version of
5149 docsIfCmtsUpChnlCtrExtCollCntnReqMslots, and is included
5150 for back compatibility with SNMPv1 managers.
5151 Discontinuities in the value of this counter can occur
5152 at reinitialization of the managed system, and at other
5153 times as indicated by the value of
5154 ifCounterDiscontinuityTime for the associated ifIndex."
5155 ::= { docsIfCmtsUpChannelCounterEntry 13 }
5157 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots OBJECT-TYPE
5158 SYNTAX Counter32
5159 UNITS "mini-slots"
5160 MAX-ACCESS read-only
5161 STATUS current
5162 DESCRIPTION
5163 "Current count, from CMTS initialization, of contention
5164 request data mini-slots defined for this upstream logical
5165 channel. This count includes all mini-slots for IUC2
5166 assigned to a broadcast or multicast SID on the logical
5167 channel. This is the 32 bit version of
5168 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots, and is
5169 included for back compatibility with SNMPv1 managers.
5170 Discontinuities in the value of this counter can occur
5171 at reinitialization of the managed system, and at other
5172 times as indicated by the value of
5173 ifCounterDiscontinuityTime for the associated ifIndex."
5174 ::= { docsIfCmtsUpChannelCounterEntry 14 }
5176 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots OBJECT-TYPE
5177 SYNTAX Counter32
5178 UNITS "mini-slots"
5179 MAX-ACCESS read-only
5180 STATUS current
5181 DESCRIPTION
5182 "Current count, from CMTS initialization, of contention
5183 request data mini-slots utilized on this upstream logical
5184 channel. This includes all contention mini-slots for IUC2
5185 applicable to bursts that the CMTS correctly received.
5186 This is the 32 bit version of
5187 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots, and is
5188 included for back compatibility with SNMPv1 managers.
5189 Discontinuities in the value of this counter can occur
5190 at reinitialization of the managed system, and at other
5191 times as indicated by the value of
5192 ifCounterDiscontinuityTime for the associated ifIndex."
5193 ::= { docsIfCmtsUpChannelCounterEntry 15 }
5195 docsIfCmtsUpChnlCtrCollCntnReqDataMslots OBJECT-TYPE
5196 SYNTAX Counter32
5197 UNITS "mini-slots"
5198 MAX-ACCESS read-only
5199 STATUS current
5200 DESCRIPTION
5201 "Current count, from CMTS initialization, of contention
5202 request data mini-slots subjected to collisions on this
5203 upstream logical channel. This includes all contention
5204 mini-slots for IUC2 applicable to bursts that the CMTS
5205 detected, but could not correctly receive. This is the 32
5206 bit version of
5207 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots, and is
5208 included for back compatibility with SNMPv1 managers.
5209 Discontinuities in the value of this counter can occur
5210 at reinitialization of the managed system, and at other
5211 times as indicated by the value of
5212 ifCounterDiscontinuityTime for the associated ifIndex."
5213 ::= { docsIfCmtsUpChannelCounterEntry 16 }
5215 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots OBJECT-TYPE
5216 SYNTAX Counter32
5217 UNITS "mini-slots"
5218 MAX-ACCESS read-only
5219 STATUS current
5220 DESCRIPTION
5221 "Current count, from CMTS initialization, of contention
5222 initial maintenance mini-slots defined for this upstream
5223 logical channel. This includes all mini-slots for IUC3
5224 assigned to a broadcast or multicast SID on the logical
5225 channel. This is the 32 bit version of
5226 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots,
5227 and is included for back compatibility with SNMPv1
5228 managers.
5229 Discontinuities in the value of this counter can occur
5230 at reinitialization of the managed system, and at other
5231 times as indicated by the value of
5232 ifCounterDiscontinuityTime for the associated ifIndex."
5233 ::= { docsIfCmtsUpChannelCounterEntry 17 }
5235 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots OBJECT-TYPE
5236 SYNTAX Counter32
5237 MAX-ACCESS read-only
5238 STATUS current
5239 DESCRIPTION
5240 "Current count, from CMTS initialization, of contention
5241 initial maintenance mini-slots utilized on this upstream
5242 logical channel. This includes all contention mini-slots
5243 for IUC3 applicable to bursts that the CMTS correctly
5244 received. This is the 32 bit version of
5245 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots,
5246 and is included for back compatibility with SNMPv1
5247 managers.
5248 Discontinuities in the value of this counter can occur
5249 at reinitialization of the managed system, and at other
5250 times as indicated by the value of
5251 ifCounterDiscontinuityTime for the associated ifIndex."
5252 ::= { docsIfCmtsUpChannelCounterEntry 18 }
5254 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots OBJECT-TYPE
5255 SYNTAX Counter32
5256 UNITS "mini-slots"
5257 MAX-ACCESS read-only
5258 STATUS current
5259 DESCRIPTION
5260 "Current count, from CMTS initialization, of contention
5261 initial maintenance mini-slots subjected to collisions on
5262 this upstream logical channel. This includes all
5263 contention mini-slots for IUC3 applicable to bursts that
5264 the CMTS detected, but could not correctly receive.
5265 This is the 32 bit version of
5266 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots,
5267 and is included for back compatibility with SNMPv1
5268 managers.
5269 Discontinuities in the value of this counter can occur
5270 at reinitialization of the managed system, and at other
5271 times as indicated by the value of
5272 ifCounterDiscontinuityTime for the associated ifIndex."
5273 ::= { docsIfCmtsUpChannelCounterEntry 19 }
5275 docsIfCmtsUpChnlCtrExtCollCntnMslots OBJECT-TYPE
5276 SYNTAX Counter64
5277 UNITS "mini-slots"
5278 MAX-ACCESS read-only
5279 STATUS current
5280 DESCRIPTION
5281 "Current count, from CMTS initialization, of collision
5282 contention mini-slots on the upstream logical channel.
5283 For contention regions, these are the mini-slots applicable
5284 to bursts that the CMTS detected, but could not correctly
5285 receive. This is the 64 bit version of
5286 docsIfCmtsUpChnlCtrCollCntnMslots, and will not be
5287 accessible to SNMPv1 managers.
5288 Discontinuities in the value of this counter can occur
5289 at reinitialization of the managed system, and at other
5290 times as indicated by the value of
5291 ifCounterDiscontinuityTime for the associated ifIndex."
5292 ::= { docsIfCmtsUpChannelCounterEntry 20 }
5294 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots OBJECT-TYPE
5295 SYNTAX Counter64
5296 UNITS "mini-slots"
5297 MAX-ACCESS read-only
5298 STATUS current
5299 DESCRIPTION
5300 "Current count, from CMTS initialization, of contention
5301 request mini-slots defined for this upstream logical
5302 channel. This count includes all mini-slots for IUC1
5303 assigned to a broadcast or multicast SID on the logical
5304 channel. This is the 64 bit version of
5305 docsIfCmtsUpChnlCtrTotalCntnReqMslots, and will not be
5306 accessible to SNMPv1 managers.
5307 Discontinuities in the value of this counter can occur
5308 at reinitialization of the managed system, and at other
5309 times as indicated by the value of
5310 ifCounterDiscontinuityTime for the associated ifIndex."
5311 ::= { docsIfCmtsUpChannelCounterEntry 21 }
5313 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots OBJECT-TYPE
5314 SYNTAX Counter64
5315 UNITS "mini-slots"
5316 MAX-ACCESS read-only
5317 STATUS current
5318 DESCRIPTION
5319 "Current count, from CMTS initialization, of contention
5320 request mini-slots utilized on this upstream logical
5321 channel. This count includes all contention mini-slots for
5322 IUC1 applicable to bursts that the CMTS correctly
5323 received. This is the 64 bit version of
5324 docsIfCmtsUpChnlCtrUsedCntnReqMslots, and will not be
5325 accessible to SNMPv1 managers.
5326 Discontinuities in the value of this counter can occur
5327 at reinitialization of the managed system, and at other
5328 times as indicated by the value of
5329 ifCounterDiscontinuityTime for the associated ifIndex."
5330 ::= { docsIfCmtsUpChannelCounterEntry 22 }
5332 docsIfCmtsUpChnlCtrExtCollCntnReqMslots OBJECT-TYPE
5333 SYNTAX Counter64
5334 UNITS "mini-slots"
5335 MAX-ACCESS read-only
5336 STATUS current
5337 DESCRIPTION
5338 "Current count, from CMTS initialization, of contention
5339 request mini-slots subjected to collisions on this upstream
5340 logical channel. This includes all contention mini-slots
5341 for IUC1 applicable to bursts that the CMTS detected,
5342 but could not correctly receive. This is the 64 bit
5343 version of docsIfCmtsUpChnlCtrCollCntnReqMslots, and will
5344 not be accessible to SNMPv1 managers.
5345 Discontinuities in the value of this counter can occur
5346 at reinitialization of the managed system, and at other
5347 times as indicated by the value of
5348 ifCounterDiscontinuityTime for the associated ifIndex."
5349 ::= { docsIfCmtsUpChannelCounterEntry 23 }
5351 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots OBJECT-TYPE
5352 SYNTAX Counter64
5353 UNITS "mini-slots"
5354 MAX-ACCESS read-only
5355 STATUS current
5356 DESCRIPTION
5357 "Current count, from CMTS initialization, of contention
5358 request data mini-slots defined for this upstream logical
5359 channel. This count includes all mini-slots for IUC2
5360 assigned to a broadcast or multicast SID on the logical
5361 channel. This is the 64 bit version of
5362 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots, and will not be
5363 accessible to SNMPv1 managers.
5364 Discontinuities in the value of this counter can occur
5365 at reinitialization of the managed system, and at other
5366 times as indicated by the value of
5367 ifCounterDiscontinuityTime for the associated ifIndex."
5368 ::= { docsIfCmtsUpChannelCounterEntry 24 }
5370 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots OBJECT-TYPE
5371 SYNTAX Counter64
5372 UNITS "mini-slots"
5373 MAX-ACCESS read-only
5374 STATUS current
5375 DESCRIPTION
5376 "Current count, from CMTS initialization, of contention
5377 request data mini-slots utilized on this upstream logical
5378 channel. This includes all contention mini-slots for IUC2
5379 applicable to bursts that the CMTS correctly received.
5380 This is the 64 bit version of
5381 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots, and will not be
5382 accessible to SNMPv1 managers.
5383 Discontinuities in the value of this counter can occur
5384 at reinitialization of the managed system, and at other
5385 times as indicated by the value of
5386 ifCounterDiscontinuityTime for the associated ifIndex."
5387 ::= { docsIfCmtsUpChannelCounterEntry 25 }
5389 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots OBJECT-TYPE
5390 SYNTAX Counter64
5391 UNITS "mini-slots"
5392 MAX-ACCESS read-only
5393 STATUS current
5394 DESCRIPTION
5395 "Current count, from CMTS initialization, of contention
5396 request data mini-slots subjected to collisions on this
5397 upstream logical channel. This includes all contention
5398 mini-slots for IUC2 applicable to bursts that the CMTS
5399 detected, but could not correctly receive. This is the
5400 64 bit version of
5401 docsIfCmtsUpChnlCtrCollCntnReqDataMslots,
5402 and will not be accessible to SNMPv1 managers.
5403 Discontinuities in the value of this counter can occur
5404 at reinitialization of the managed system, and at other
5405 times as indicated by the value of
5406 ifCounterDiscontinuityTime for the associated ifIndex."
5407 ::= { docsIfCmtsUpChannelCounterEntry 26 }
5409 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots OBJECT-TYPE
5410 SYNTAX Counter64
5411 UNITS "mini-slots"
5412 MAX-ACCESS read-only
5413 STATUS current
5414 DESCRIPTION
5415 "Current count, from CMTS initialization, of initial
5416 maintenance mini-slots defined for this upstream logical
5417 channel. This count includes all mini-slots for IUC3
5418 assigned to a broadcast or multicast SID on the logical
5419 channel. This is the 64 bit version of
5420 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots,
5421 and will not be accessible to SNMPv1 managers.
5422 Discontinuities in the value of this counter can occur
5423 at reinitialization of the managed system, and at other
5424 times as indicated by the value of
5425 ifCounterDiscontinuityTime for the associated ifIndex."
5426 ::= { docsIfCmtsUpChannelCounterEntry 27 }
5428 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots OBJECT-TYPE
5429 SYNTAX Counter64
5430 UNITS "mini-slots"
5431 MAX-ACCESS read-only
5432 STATUS current
5433 DESCRIPTION
5434 "Current count, from CMTS initialization, of initial
5435 maintenance mini-slots utilized on this upstream logical
5436 channel. This includes all contention mini-slots for IUC3
5437 applicable to bursts that the CMTS correctly received.
5438 This is the 64 bit version of
5439 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots,
5440 and will not be accessible to SNMPv1 managers.
5441 Discontinuities in the value of this counter can occur
5442 at reinitialization of the managed system, and at other
5443 times as indicated by the value of
5444 ifCounterDiscontinuityTime for the associated ifIndex."
5445 ::= { docsIfCmtsUpChannelCounterEntry 28 }
5447 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots OBJECT-TYPE
5448 SYNTAX Counter64
5449 UNITS "mini-slots"
5450 MAX-ACCESS read-only
5451 STATUS current
5452 DESCRIPTION
5453 "Current count, from CMTS initialization, of contention
5454 initial maintenance mini-slots subjected to collisions on
5455 this upstream logical channel. This includes all
5456 contention mini-slots for IUC3 applicable to bursts that
5457 the CMTS detected, but could not correctly receive.
5458 This is the 64 bit version of
5459 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots, and will not
5460 be accessible to SNMPv1 managers.
5461 Discontinuities in the value of this counter can occur
5462 at reinitialization of the managed system, and at other
5463 times as indicated by the value of
5464 ifCounterDiscontinuityTime for the associated ifIndex."
5465 ::= { docsIfCmtsUpChannelCounterEntry 29 }
5467 --
5468 -- notification group is for future extension.
5469 --
5471 docsIfNotification OBJECT IDENTIFIER ::= { docsIfMib 2 }
5473 --
5474 -- MIB Compliance statements.
5475 --
5477 --
5478 -- Conformance definitions
5479 --
5481 docsIfConformance OBJECT IDENTIFIER ::= { docsIfMib 3 }
5482 docsIfCompliances OBJECT IDENTIFIER ::= { docsIfConformance 1 }
5483 docsIfGroups OBJECT IDENTIFIER ::= { docsIfConformance 2 }
5485 docsIfBasicCompliance MODULE-COMPLIANCE
5486 STATUS deprecated
5487 DESCRIPTION
5488 "The compliance statement for devices that implement
5489 DOCSIS 1.x compliant Radio Frequency Interfaces."
5491 MODULE -- docsIfMib
5493 -- unconditionally mandatory groups
5494 MANDATORY-GROUPS {
5495 docsIfBasicGroup
5496 }
5498 -- conditionally mandatory group
5499 GROUP docsIfCmGroup
5500 DESCRIPTION
5501 "This group is implemented only in cable modems, not in
5502 cable modem termination systems."
5504 -- conditionally mandatory group
5505 GROUP docsIfCmtsGroup
5506 DESCRIPTION
5507 "This group is implemented only in cable modem termination
5508 systems, not in cable modems."
5510 OBJECT docsIfDownChannelFrequency
5511 WRITE-SYNTAX Integer32 (54000000..860000000)
5512 MIN-ACCESS read-only
5513 DESCRIPTION
5514 "Read-write in cable modem termination systems;
5515 read-only in cable modems. The values above are
5516 appropriate for a cable plant using a Sub-Split channel
5517 plan. If DOCSIS is extended to cover other types of
5518 channel plans (and frequency allocations) this object
5519 will be modified accordingly."
5521 OBJECT docsIfDownChannelWidth
5522 WRITE-SYNTAX Integer32 (6000000)
5523 MIN-ACCESS read-only
5524 DESCRIPTION
5525 "It is conformant to implement this object as read-only.
5526 In cable modems, this object is always implemented as
5527 read-only. The above value is appropriate for cable
5528 plants running under NTSC (National Television
5529 Standards Committee) standards. If DOCSIS is extended to
5530 work with other standard (e.g. European standards), this
5531 object will be modified accordingly."
5533 OBJECT docsIfDownChannelModulation
5534 WRITE-SYNTAX INTEGER {
5535 qam64 (3),
5536 qam256 (4)
5537 }
5538 MIN-ACCESS read-only
5539 DESCRIPTION
5540 "Read-write in cable modem termination systems;
5541 read-only in cable modems."
5543 OBJECT docsIfDownChannelInterleave
5544 WRITE-SYNTAX INTEGER {
5545 taps8Increment16(3),
5546 taps16Increment8(4),
5547 taps32Increment4(5),
5548 taps64Increment2(6),
5549 taps128Increment1(7)
5550 }
5551 MIN-ACCESS read-only
5552 DESCRIPTION
5553 "Read-write in cable modem termination systems;
5554 read-only in cable modems."
5556 OBJECT docsIfDownChannelPower
5557 MIN-ACCESS read-only
5558 DESCRIPTION
5559 "Read-write in cable modem termination systems;
5560 read-only in cable modems."
5562 OBJECT docsIfUpChannelFrequency
5563 WRITE-SYNTAX Integer32 (5000000..42000000)
5564 MIN-ACCESS read-only
5565 DESCRIPTION
5566 "Read-write in cable modem termination systems;
5567 read-only in cable modems. The values above are
5568 appropriate for a cable plant using a Sub-Split channel
5569 plan. If DOCSIS is extended to cover other types of
5570 channel plans (and frequency allocations) this object
5571 will be modified accordingly."
5573 OBJECT docsIfUpChannelWidth
5574 WRITE-SYNTAX Integer32 (200000..3200000)
5575 MIN-ACCESS read-only
5576 DESCRIPTION
5577 "Read-write in cable modem termination systems;
5578 read-only in cable modems. The above value is appropriate
5579 for cable plants running under NTSC (National Television
5580 Standards Committee) standards. If DOCSIS is extended to
5581 work with other standard (e.g. European standards), this
5582 object will be modified accordingly."
5584 OBJECT docsIfUpChannelModulationProfile
5585 MIN-ACCESS read-only
5586 DESCRIPTION
5587 "Read-write in cable modem termination systems;
5588 read-only in cable modems."
5590 OBJECT docsIfUpChannelSlotSize
5591 MIN-ACCESS read-only
5592 DESCRIPTION
5593 "This object is always read-only in cable modems.
5595 It is compliant to implement this object as read-only
5596 in cable modem termination systems."
5598 OBJECT docsIfUpChannelRangingBackoffStart
5599 MIN-ACCESS read-only
5600 DESCRIPTION
5601 "Read-write in cable modem termination systems;
5602 read-only in cable modems."
5604 OBJECT docsIfUpChannelRangingBackoffEnd
5605 MIN-ACCESS read-only
5606 DESCRIPTION
5607 "Read-write in cable modem termination systems;
5608 read-only in cable modems."
5610 OBJECT docsIfUpChannelTxBackoffStart
5611 MIN-ACCESS read-only
5612 DESCRIPTION
5613 "Read-write in cable modem termination systems;
5614 read-only in cable modems."
5616 OBJECT docsIfUpChannelTxBackoffEnd
5617 MIN-ACCESS read-only
5618 DESCRIPTION
5619 "Read-write in cable modem termination systems;
5620 read-only in cable modems."
5622 OBJECT docsIfQosProfPriority
5623 MIN-ACCESS read-only
5624 DESCRIPTION
5625 "This object is always read-only in cable modems.
5626 It is compliant to implement this object as read-only
5627 in cable modem termination systems."
5629 OBJECT docsIfQosProfMaxUpBandwidth
5630 MIN-ACCESS read-only
5631 DESCRIPTION
5632 "This object is always read-only in cable modems.
5633 It is compliant to implement this object as read-only
5634 in cable modem termination systems."
5636 OBJECT docsIfQosProfGuarUpBandwidth
5637 MIN-ACCESS read-only
5638 DESCRIPTION
5639 "This object is always read-only in cable modems.
5640 It is compliant to implement this object as read-only
5641 in cable modem termination systems."
5643 OBJECT docsIfQosProfMaxDownBandwidth
5644 MIN-ACCESS read-only
5645 DESCRIPTION
5646 "This object is always read-only in cable modems.
5647 It is compliant to implement this object as read-only
5648 in cable modem termination systems."
5650 OBJECT docsIfQosProfMaxTxBurst
5651 MIN-ACCESS read-only
5652 DESCRIPTION
5653 "This object is always read-only in cable modems.
5654 It is compliant to implement this object as read-only
5655 in cable modem termination systems."
5657 OBJECT docsIfQosProfBaselinePrivacy
5658 MIN-ACCESS read-only
5659 DESCRIPTION
5660 "This object is always read-only in cable modems.
5661 It is compliant to implement this object as read-only
5662 in cable modem termination systems."
5664 OBJECT docsIfQosProfStatus
5665 MIN-ACCESS read-only
5666 DESCRIPTION
5667 "This object is always read-only in cable modems.
5668 It is compliant to implement this object as read-only
5669 in cable modem termination systems."
5671 OBJECT docsIfCmtsServiceAdminStatus
5672 MIN-ACCESS read-only
5673 DESCRIPTION
5674 "It is compliant to implement this object as read-only."
5676 OBJECT docsIfCmtsSyncInterval
5677 MIN-ACCESS read-only
5678 DESCRIPTION
5679 "It is compliant to implement this object as read-only."
5681 OBJECT docsIfCmtsUcdInterval
5682 MIN-ACCESS read-only
5683 DESCRIPTION
5684 "It is compliant to implement this object as read-only."
5686 OBJECT docsIfCmtsInsertInterval
5687 MIN-ACCESS read-only
5688 DESCRIPTION
5689 "It is compliant to implement this object as read-only."
5691 OBJECT docsIfCmtsInvitedRangingAttempts
5692 MIN-ACCESS read-only
5693 DESCRIPTION
5694 "It is compliant to implement this object as read-only."
5696 OBJECT docsIfCmtsQosProfilePermissions
5697 WRITE-SYNTAX BITS {
5698 createByManagement(0),
5699 updateByManagement(1)
5700 }
5701 MIN-ACCESS read-only
5702 DESCRIPTION
5703 "It is compliant to implement this object as read-only."
5705 OBJECT docsIfCmtsModType
5706 WRITE-SYNTAX INTEGER {
5707 qpsk (2),
5708 qam16 (3)
5709 }
5710 DESCRIPTION
5711 "Management station MAY only set 16QAM or QPSK modulation,
5712 but others might be possible based on device
5713 configuration."
5715 OBJECT docsIfCmtsModPreambleLen
5716 SYNTAX Integer32 (0..1024)
5717 DESCRIPTION
5718 "The range of the values for this MODULE-COMPLIANCE
5719 is 0..1024."
5721 OBJECT docsIfCmtsModFECErrorCorrection
5722 SYNTAX Integer32 (0..10)
5723 DESCRIPTION
5724 "The range of the values for this MODULE-COMPLIANCE
5725 is 0..10."
5727 ::= { docsIfCompliances 1 }
5729 docsIfBasicComplianceV2 MODULE-COMPLIANCE
5730 STATUS current
5731 DESCRIPTION
5732 "The compliance statement for devices that implement
5733 DOCSIS 2.0 Radio Frequency Interfaces."
5735 MODULE -- docsIfMib
5737 -- unconditionally mandatory groups
5738 MANDATORY-GROUPS {
5739 docsIfBasicGroupV2
5740 }
5742 -- conditionally mandatory group
5743 GROUP docsIfCmGroupV2
5744 DESCRIPTION
5745 "This group is implemented only in cable modems, not in
5746 cable modem termination systems."
5748 -- conditionally mandatory group
5749 GROUP docsIfCmtsGroupV2
5750 DESCRIPTION
5751 "This group is implemented only in cable modem termination
5752 systems, not in cable modems."
5754 OBJECT docsIfDownChannelFrequency
5755 WRITE-SYNTAX Integer32 (47000000..862000000)
5756 MIN-ACCESS read-only
5757 DESCRIPTION
5758 "Read-write in cable modem termination systems,
5759 read-only in cable modems.
5760 A range of 54MHz to 860MHz is appropriate for a cable
5761 plant using a North American Sub-Split channel plan.
5762 The spectrum range has been expanded to accommodate
5763 a lower edge of 47MHz and an upper edge of 862MHz
5764 for some European channel plans.
5765 If DOCSIS is extended to cover other types of channel
5766 plans (and frequency allocations) this object will be
5767 modified accordingly."
5769 OBJECT docsIfDownChannelWidth
5770 WRITE-SYNTAX Integer32 (6000000 | 8000000)
5771 MIN-ACCESS read-only
5772 DESCRIPTION
5773 "It is conformant to implement this object as read-only.
5774 In cable modems, this object is always implemented as
5775 read-only. The value of 6 MHz is appropriate for cable
5776 plants running under NTSC (National Television
5777 Standards Committee) standards. The value of 8 MHz is
5778 appropriate for cable plants running under ETSI
5779 standards. For other regional standards, this
5780 object will be modified accordingly."
5782 OBJECT docsIfDownChannelModulation
5783 WRITE-SYNTAX INTEGER {
5784 qam64 (3),
5785 qam256 (4)
5787 }
5788 MIN-ACCESS read-only
5789 DESCRIPTION
5790 "Read-write in cable modem termination systems,
5791 read-only in cable modems."
5793 OBJECT docsIfDownChannelInterleave
5794 WRITE-SYNTAX INTEGER {
5795 taps8Increment16(3),
5796 taps16Increment8(4),
5797 taps32Increment4(5),
5798 taps64Increment2(6),
5799 taps128Increment1(7),
5800 taps12increment17(8)
5801 }
5802 MIN-ACCESS read-only
5803 DESCRIPTION
5804 "Read-write in cable modem termination systems,
5805 read-only in cable modems."
5807 OBJECT docsIfDownChannelPower
5808 MIN-ACCESS read-only
5809 DESCRIPTION
5810 "Read-write in cable modem termination systems,
5811 read-only in cable modems."
5813 OBJECT docsIfUpChannelFrequency
5814 WRITE-SYNTAX Integer32 (5000000..65000000)
5815 MIN-ACCESS read-only
5816 DESCRIPTION
5817 "Read-create in cable modem termination systems,
5818 read-only in cable modems.
5819 A range of 5MHz to 42MHz is appropriate for a cable
5820 plant using a North American Sub-Split channel plan.
5821 The spectrum range has been expanded to accommodate
5822 an upper edge of 65MHz for some European channel plans.
5823 If DOCSIS is extended to cover other types of channel
5824 plans (and frequency allocations) this object will
5825 be modified accordingly."
5827 OBJECT docsIfUpChannelWidth
5828 WRITE-SYNTAX Integer32 (200000..6400000)
5829 MIN-ACCESS read-only
5830 DESCRIPTION
5831 "Read-create in cable modem termination systems,
5832 read-only in cable modems. The above value is appropriate
5833 for cable plants running under NTSC (National Television
5834 Standards Committee) standards. If DOCSIS is extended to
5835 work with other standard (e.g. European standards), this
5836 object will be modified accordingly."
5838 OBJECT docsIfUpChannelModulationProfile
5839 MIN-ACCESS read-only
5840 DESCRIPTION
5841 "Read-create in cable modem termination systems,
5842 read-only in cable modems."
5844 OBJECT docsIfUpChannelSlotSize
5845 MIN-ACCESS read-only
5846 DESCRIPTION
5847 "This object is always read-only in cable modems.
5848 It is compliant to implement this object as read-only
5849 in cable modem termination systems."
5851 OBJECT docsIfUpChannelRangingBackoffStart
5852 MIN-ACCESS read-only
5853 DESCRIPTION
5854 "Read-create in cable modem termination systems,
5855 read-only in cable modems."
5857 OBJECT docsIfUpChannelRangingBackoffEnd
5858 MIN-ACCESS read-only
5859 DESCRIPTION
5860 "Read-create in cable modem termination systems,
5861 read-only in cable modems."
5863 OBJECT docsIfUpChannelTxBackoffStart
5864 MIN-ACCESS read-only
5865 DESCRIPTION
5866 "Read-create in cable modem termination systems,
5867 read-only in cable modems."
5869 OBJECT docsIfUpChannelTxBackoffEnd
5870 MIN-ACCESS read-only
5871 DESCRIPTION
5872 "Read-create in cable modem termination systems,
5873 read-only in cable modems."
5875 OBJECT docsIfUpChannelScdmaActiveCodes
5876 MIN-ACCESS read-only
5877 DESCRIPTION
5878 "Read-create in cable modem termination systems,
5879 read-only in cable modems.
5880 The number of active codes when SCDMA is in use MUST range
5881 from 64 to 128, and MUST be a non-Prime value.
5882 Providing this range allows for the following features
5883 and capabilities:
5884 1) Power management in S-CDMA spreader-on frames
5885 (with a 3 dB spread)
5886 2) Avoidance of code 0
5887 3) Flexible mini-slot sizes with and without the use of
5888 code 0"
5890 OBJECT docsIfUpChannelScdmaCodesPerSlot
5891 MIN-ACCESS read-only
5892 DESCRIPTION
5893 "Read-create in cable modem termination systems,
5894 read-only in cable modems."
5896 OBJECT docsIfUpChannelScdmaFrameSize
5897 MIN-ACCESS read-only
5898 DESCRIPTION
5899 "Read-create in cable modem termination systems,
5900 read-only in cable modems."
5902 OBJECT docsIfUpChannelScdmaHoppingSeed
5903 MIN-ACCESS read-only
5904 DESCRIPTION
5905 "Read-create in cable modem termination systems,
5906 read-only in cable modems."
5908 OBJECT docsIfUpChannelCloneFrom
5909 MIN-ACCESS read-only
5910 DESCRIPTION
5911 "Read-create in cable modem termination systems,
5912 read-only in cable modems."
5914 OBJECT docsIfUpChannelUpdate
5915 MIN-ACCESS read-only
5916 DESCRIPTION
5917 "Read-create in cable modem termination systems,
5918 read-only in cable modems."
5920 OBJECT docsIfUpChannelStatus
5921 MIN-ACCESS read-only
5922 DESCRIPTION
5923 "Read-create in Cable Modem Termination Systems,
5924 read-only in Cable Modems.
5925 Entries associated to physical interfaces only support
5926 read-only value 'active'."
5928 OBJECT docsIfUpChannelPreEqEnable
5929 MIN-ACCESS read-only
5930 DESCRIPTION
5931 "Read-create in cable modem termination systems,
5932 read-only in cable modems."
5934 OBJECT docsIfQosProfPriority
5935 MIN-ACCESS read-only
5936 DESCRIPTION
5937 "This object is always read-only in cable modems.
5938 It is compliant to implement this object as read-only
5939 in cable modem termination systems."
5941 OBJECT docsIfQosProfMaxUpBandwidth
5942 MIN-ACCESS read-only
5943 DESCRIPTION
5944 "This object is always read-only in cable modems.
5945 It is compliant to implement this object as read-only
5946 in cable modem termination systems."
5948 OBJECT docsIfQosProfGuarUpBandwidth
5949 MIN-ACCESS read-only
5950 DESCRIPTION
5951 "This object is always read-only in cable modems.
5952 It is compliant to implement this object as read-only
5953 in cable modem termination systems."
5955 OBJECT docsIfQosProfMaxDownBandwidth
5956 MIN-ACCESS read-only
5957 DESCRIPTION
5958 "This object is always read-only in cable modems.
5959 It is compliant to implement this object as read-only
5960 in cable modem termination systems."
5962 OBJECT docsIfQosProfBaselinePrivacy
5963 MIN-ACCESS read-only
5964 DESCRIPTION
5965 "This object is always read-only in cable modems.
5966 It is compliant to implement this object as read-only
5967 in cable modem termination systems."
5969 OBJECT docsIfQosProfStatus
5970 MIN-ACCESS read-only
5971 DESCRIPTION
5972 "This object is always read-only in cable modems.
5973 It is compliant to implement this object as read-only
5974 in cable modem termination systems."
5976 OBJECT docsIfQosProfMaxTransmitBurst
5977 MIN-ACCESS read-only
5978 DESCRIPTION
5979 "This object is always read-only in cable modems.
5980 It is compliant to implement this object as read-only
5981 in cable modem termination systems."
5983 OBJECT docsIfCmRangingTimeout
5984 MIN-ACCESS read-only
5985 DESCRIPTION
5986 "It is compliant to implement this object as read-only."
5988 OBJECT docsIfCmStatusModulationType
5989 SYNTAX INTEGER {
5990 unknown(0),
5991 tdma(1),
5992 atdma(2),
5993 scdma(3)
5994 }
5995 DESCRIPTION
5996 "CM does not uses both modulation burst profiles of a
5997 'tdmAndAtdma' ChannelType; therefore 'tdmAndAtdma'is
5998 not supported."
6000 OBJECT docsIfCmtsServiceAdminStatus
6001 MIN-ACCESS read-only
6002 DESCRIPTION
6003 "It is compliant to implement this object as read-only."
6005 OBJECT docsIfCmtsSyncInterval
6006 MIN-ACCESS read-only
6007 DESCRIPTION
6008 "It is compliant to implement this object as read-only."
6010 OBJECT docsIfCmtsUcdInterval
6011 MIN-ACCESS read-only
6012 DESCRIPTION
6013 "It is compliant to implement this object as read-only."
6015 OBJECT docsIfCmtsInsertInterval
6016 MIN-ACCESS read-only
6017 DESCRIPTION
6018 "It is compliant to implement this object as read-only."
6020 OBJECT docsIfCmtsInvitedRangingAttempts
6021 MIN-ACCESS read-only
6022 DESCRIPTION
6023 "It is compliant to implement this object as read-only."
6025 OBJECT docsIfCmtsQosProfilePermissions
6026 WRITE-SYNTAX BITS {
6027 createByManagement(0),
6028 updateByManagement(1)
6029 }
6030 MIN-ACCESS read-only
6031 DESCRIPTION
6032 "It is compliant to implement this object as read-only."
6034 OBJECT docsIfCmtsModType
6035 WRITE-SYNTAX INTEGER {
6036 qpsk(2),
6037 qam16(3),
6038 qam64(6)
6039 }
6040 DESCRIPTION
6041 "Management station MAY only set 64QAM, 16QAM or QPSK
6042 modulation for Time or Code division Multiple Access,
6043 but others might be possible based on device
6044 configuration."
6046 OBJECT docsIfCmtsCmStatusModulationType
6047 SYNTAX INTEGER {
6048 unknown(0),
6049 tdma(1),
6050 atdma(2),
6051 scdma(3)
6052 }
6053 DESCRIPTION
6054 "CM does not uses both modulation burst profiles of a
6055 'tdmAndAtdma' ChannelType; therefore 'tdmAndAtdma'is
6056 not supported."
6058 ::= { docsIfCompliances 2 }
6060 docsIfBasicGroup OBJECT-GROUP
6061 OBJECTS {
6062 docsIfDownChannelId,
6063 docsIfDownChannelFrequency,
6064 docsIfDownChannelWidth,
6065 docsIfDownChannelModulation,
6066 docsIfDownChannelInterleave,
6067 docsIfDownChannelPower,
6068 docsIfUpChannelId,
6069 docsIfUpChannelFrequency,
6070 docsIfUpChannelWidth,
6071 docsIfUpChannelModulationProfile,
6072 docsIfUpChannelSlotSize,
6073 docsIfUpChannelTxTimingOffset,
6074 docsIfUpChannelRangingBackoffStart,
6075 docsIfUpChannelRangingBackoffEnd,
6076 docsIfUpChannelTxBackoffStart,
6077 docsIfUpChannelTxBackoffEnd,
6078 docsIfQosProfPriority,
6079 docsIfQosProfMaxUpBandwidth,
6080 docsIfQosProfGuarUpBandwidth,
6081 docsIfQosProfMaxDownBandwidth,
6082 docsIfQosProfMaxTxBurst,
6083 docsIfQosProfBaselinePrivacy,
6084 docsIfQosProfStatus,
6085 docsIfSigQIncludesContention,
6086 docsIfSigQUnerroreds,
6087 docsIfSigQCorrecteds,
6088 docsIfSigQUncorrectables,
6089 docsIfSigQSignalNoise,
6090 docsIfSigQMicroreflections,
6091 docsIfSigQEqualizationData
6092 }
6093 STATUS deprecated
6094 DESCRIPTION
6095 "Group of objects implemented in both cable modems and
6096 cable modem termination systems."
6097 ::= { docsIfGroups 1 }
6099 docsIfCmGroup OBJECT-GROUP
6100 OBJECTS {
6101 docsIfCmCmtsAddress,
6102 docsIfCmCapabilities,
6103 docsIfCmRangingTimeout,
6104 docsIfCmStatusValue,
6105 docsIfCmStatusCode,
6106 docsIfCmStatusTxPower,
6107 docsIfCmStatusResets,
6108 docsIfCmStatusLostSyncs,
6109 docsIfCmStatusInvalidMaps,
6110 docsIfCmStatusInvalidUcds,
6111 docsIfCmStatusInvalidRangingResponses,
6112 docsIfCmStatusInvalidRegistrationResponses,
6113 docsIfCmStatusT1Timeouts,
6114 docsIfCmStatusT2Timeouts,
6115 docsIfCmStatusT3Timeouts,
6116 docsIfCmStatusT4Timeouts,
6117 docsIfCmStatusRangingAborteds,
6118 docsIfCmServiceQosProfile,
6119 docsIfCmServiceTxSlotsImmed,
6120 docsIfCmServiceTxSlotsDed,
6121 docsIfCmServiceTxRetries,
6122 docsIfCmServiceTxExceededs,
6123 docsIfCmServiceRqRetries,
6124 docsIfCmServiceRqExceededs
6125 }
6126 STATUS deprecated
6127 DESCRIPTION
6128 "Group of objects implemented in cable modems."
6129 ::= { docsIfGroups 2 }
6131 docsIfCmtsGroup OBJECT-GROUP
6132 OBJECTS {
6133 docsIfCmtsCapabilities,
6134 docsIfCmtsSyncInterval,
6135 docsIfCmtsUcdInterval,
6136 docsIfCmtsMaxServiceIds,
6137 docsIfCmtsInvitedRangingAttempts,
6138 docsIfCmtsInsertInterval,
6139 docsIfCmtsStatusInvalidRangeReqs,
6140 docsIfCmtsStatusRangingAborteds,
6141 docsIfCmtsStatusInvalidRegReqs,
6142 docsIfCmtsStatusFailedRegReqs,
6143 docsIfCmtsStatusInvalidDataReqs,
6144 docsIfCmtsStatusT5Timeouts,
6145 docsIfCmtsCmStatusMacAddress,
6146 docsIfCmtsCmStatusIpAddress,
6147 docsIfCmtsCmStatusDownChannelIfIndex,
6148 docsIfCmtsCmStatusUpChannelIfIndex,
6149 docsIfCmtsCmStatusRxPower,
6150 docsIfCmtsCmStatusTimingOffset,
6151 docsIfCmtsCmStatusEqualizationData,
6152 docsIfCmtsCmStatusValue,
6153 docsIfCmtsCmStatusUnerroreds,
6154 docsIfCmtsCmStatusCorrecteds,
6155 docsIfCmtsCmStatusUncorrectables,
6156 docsIfCmtsCmStatusSignalNoise,
6157 docsIfCmtsCmStatusMicroreflections,
6158 docsIfCmtsServiceCmStatusIndex,
6159 docsIfCmtsServiceAdminStatus,
6160 docsIfCmtsServiceQosProfile,
6161 docsIfCmtsServiceCreateTime,
6162 docsIfCmtsServiceInOctets,
6163 docsIfCmtsServiceInPackets,
6164 docsIfCmtsModType,
6165 docsIfCmtsModControl,
6166 docsIfCmtsModPreambleLen,
6167 docsIfCmtsModDifferentialEncoding,
6168 docsIfCmtsModFECErrorCorrection,
6169 docsIfCmtsModFECCodewordLength,
6170 docsIfCmtsModScramblerSeed,
6171 docsIfCmtsModMaxBurstSize,
6172 docsIfCmtsModGuardTimeSize,
6173 docsIfCmtsModLastCodewordShortened,
6174 docsIfCmtsModScrambler,
6175 docsIfCmtsQosProfilePermissions,
6176 docsIfCmtsCmPtr
6177 }
6178 STATUS deprecated
6179 DESCRIPTION
6180 "Group of objects implemented in Cable Modem Termination
6181 Systems."
6182 ::= { docsIfGroups 3 }
6184 -- obsolete group
6185 -- RFC 2670 already had a obsolete group, even though RFC2670
6186 -- was the first version of this MIB Module
6188 docsIfObsoleteGroup OBJECT-GROUP
6189 OBJECTS {
6190 docsIfCmRangingRespTimeout,
6191 docsIfCmtsInsertionInterval
6192 }
6193 STATUS obsolete
6194 DESCRIPTION
6195 "Group of objects obsoleted."
6196 ::= { docsIfGroups 4 }
6198 docsIfBasicGroupV2 OBJECT-GROUP
6199 OBJECTS {
6200 docsIfDownChannelId,
6201 docsIfDownChannelFrequency,
6202 docsIfDownChannelWidth,
6203 docsIfDownChannelModulation,
6204 docsIfDownChannelInterleave,
6205 docsIfDownChannelPower,
6206 docsIfDownChannelAnnex,
6207 docsIfUpChannelId,
6208 docsIfUpChannelFrequency,
6209 docsIfUpChannelWidth,
6210 docsIfUpChannelModulationProfile,
6211 docsIfUpChannelSlotSize,
6212 docsIfUpChannelTxTimingOffset,
6213 docsIfUpChannelRangingBackoffStart,
6214 docsIfUpChannelRangingBackoffEnd,
6215 docsIfUpChannelTxBackoffStart,
6216 docsIfUpChannelTxBackoffEnd,
6217 docsIfUpChannelScdmaActiveCodes,
6218 docsIfUpChannelScdmaCodesPerSlot,
6219 docsIfUpChannelScdmaFrameSize,
6220 docsIfUpChannelScdmaHoppingSeed,
6221 docsIfUpChannelType,
6222 docsIfUpChannelCloneFrom,
6223 docsIfUpChannelUpdate,
6224 docsIfUpChannelStatus,
6225 docsIfUpChannelPreEqEnable,
6226 docsIfQosProfPriority,
6227 docsIfQosProfMaxUpBandwidth,
6228 docsIfQosProfGuarUpBandwidth,
6229 docsIfQosProfMaxDownBandwidth,
6230 docsIfQosProfBaselinePrivacy,
6231 docsIfQosProfStatus,
6232 docsIfQosProfMaxTransmitBurst,
6233 docsIfSigQIncludesContention,
6234 docsIfSigQUnerroreds,
6235 docsIfSigQCorrecteds,
6236 docsIfSigQUncorrectables,
6237 docsIfSigQSignalNoise,
6238 docsIfSigQMicroreflections,
6239 docsIfSigQExtUnerroreds,
6240 docsIfSigQExtCorrecteds,
6241 docsIfSigQExtUncorrectables,
6242 docsIfDocsisBaseCapability
6243 }
6244 STATUS current
6245 DESCRIPTION
6246 "Group of objects implemented in both cable modems and
6247 cable modem termination systems."
6248 ::= { docsIfGroups 5 }
6250 docsIfCmGroupV2 OBJECT-GROUP
6251 OBJECTS {
6252 docsIfCmCmtsAddress,
6253 docsIfCmCapabilities,
6254 docsIfCmRangingTimeout,
6255 docsIfCmStatusValue,
6256 docsIfCmStatusCode,
6257 docsIfCmStatusTxPower,
6258 docsIfCmStatusResets,
6259 docsIfCmStatusLostSyncs,
6260 docsIfCmStatusInvalidMaps,
6261 docsIfCmStatusInvalidUcds,
6262 docsIfCmStatusInvalidRangingResponses,
6263 docsIfCmStatusInvalidRegistrationResponses,
6264 docsIfCmStatusT1Timeouts,
6265 docsIfCmStatusT2Timeouts,
6266 docsIfCmStatusT3Timeouts,
6267 docsIfCmStatusT4Timeouts,
6268 docsIfCmStatusRangingAborteds,
6269 docsIfCmStatusDocsisOperMode,
6270 docsIfCmStatusModulationType,
6271 docsIfCmStatusEqualizationData,
6272 docsIfCmStatusUCCs,
6273 docsIfCmStatusUCCFails,
6274 docsIfCmServiceQosProfile,
6275 docsIfCmServiceTxSlotsImmed,
6276 docsIfCmServiceTxSlotsDed,
6277 docsIfCmServiceTxRetries,
6278 docsIfCmServiceTxExceededs,
6279 docsIfCmServiceRqRetries,
6280 docsIfCmServiceRqExceededs,
6281 docsIfCmServiceExtTxSlotsImmed,
6282 docsIfCmServiceExtTxSlotsDed,
6283 docsIfSigQEqualizationData
6284 }
6285 STATUS current
6286 DESCRIPTION
6287 "Group of objects implemented in cable modems."
6288 ::= { docsIfGroups 6 }
6290 docsIfCmtsGroupV2 OBJECT-GROUP
6291 OBJECTS {
6292 docsIfCmtsCapabilities,
6293 docsIfCmtsSyncInterval,
6294 docsIfCmtsUcdInterval,
6295 docsIfCmtsMaxServiceIds,
6296 docsIfCmtsInvitedRangingAttempts,
6297 docsIfCmtsInsertInterval,
6298 docsIfCmtsMacStorageType,
6299 docsIfCmtsStatusInvalidRangeReqs,
6300 docsIfCmtsStatusRangingAborteds,
6301 docsIfCmtsStatusInvalidRegReqs,
6302 docsIfCmtsStatusFailedRegReqs,
6303 docsIfCmtsStatusInvalidDataReqs,
6304 docsIfCmtsStatusT5Timeouts,
6305 docsIfCmtsCmStatusMacAddress,
6306 docsIfCmtsCmStatusDownChannelIfIndex,
6307 docsIfCmtsCmStatusUpChannelIfIndex,
6308 docsIfCmtsCmStatusRxPower,
6309 docsIfCmtsCmStatusTimingOffset,
6310 docsIfCmtsCmStatusEqualizationData,
6311 docsIfCmtsCmStatusValue,
6312 docsIfCmtsCmStatusUnerroreds,
6313 docsIfCmtsCmStatusCorrecteds,
6314 docsIfCmtsCmStatusUncorrectables,
6315 docsIfCmtsCmStatusSignalNoise,
6316 docsIfCmtsCmStatusMicroreflections,
6317 docsIfCmtsCmStatusExtUnerroreds,
6318 docsIfCmtsCmStatusExtCorrecteds,
6319 docsIfCmtsCmStatusExtUncorrectables,
6320 docsIfCmtsCmStatusDocsisRegMode,
6321 docsIfCmtsCmStatusModulationType,
6322 docsIfCmtsCmStatusInetAddressType,
6323 docsIfCmtsCmStatusInetAddress,
6324 docsIfCmtsCmStatusValueLastUpdate,
6325 docsIfCmtsCmStatusHighResolutionTimingOffset,
6326 docsIfCmtsServiceAdminStatus,
6327 docsIfCmtsServiceQosProfile,
6328 docsIfCmtsServiceCreateTime,
6329 docsIfCmtsServiceInOctets,
6330 docsIfCmtsServiceInPackets,
6331 docsIfCmtsServiceNewCmStatusIndex,
6332 docsIfCmtsModType,
6333 docsIfCmtsModControl,
6334 docsIfCmtsModPreambleLen,
6335 docsIfCmtsModDifferentialEncoding,
6336 docsIfCmtsModFECErrorCorrection,
6337 docsIfCmtsModFECCodewordLength,
6338 docsIfCmtsModScramblerSeed,
6339 docsIfCmtsModMaxBurstSize,
6340 docsIfCmtsModGuardTimeSize,
6341 docsIfCmtsModLastCodewordShortened,
6342 docsIfCmtsModScrambler,
6343 docsIfCmtsModByteInterleaverDepth,
6344 docsIfCmtsModByteInterleaverBlockSize,
6345 docsIfCmtsModPreambleType,
6346 docsIfCmtsModTcmErrorCorrectionOn,
6347 docsIfCmtsModScdmaInterleaverStepSize,
6348 docsIfCmtsModScdmaSpreaderEnable,
6349 docsIfCmtsModScdmaSubframeCodes,
6350 docsIfCmtsModChannelType,
6351 docsIfCmtsModStorageType,
6352 docsIfCmtsQosProfilePermissions,
6353 docsIfCmtsCmPtr,
6354 docsIfCmtsChannelUtilizationInterval,
6355 docsIfCmtsChannelUtUtilization,
6356 docsIfCmtsDownChnlCtrId,
6357 docsIfCmtsDownChnlCtrTotalBytes,
6358 docsIfCmtsDownChnlCtrUsedBytes,
6359 docsIfCmtsDownChnlCtrExtTotalBytes,
6360 docsIfCmtsDownChnlCtrExtUsedBytes,
6361 docsIfCmtsUpChnlCtrId,
6362 docsIfCmtsUpChnlCtrTotalMslots,
6363 docsIfCmtsUpChnlCtrUcastGrantedMslots,
6364 docsIfCmtsUpChnlCtrTotalCntnMslots,
6365 docsIfCmtsUpChnlCtrUsedCntnMslots,
6366 docsIfCmtsUpChnlCtrExtTotalMslots,
6367 docsIfCmtsUpChnlCtrExtUcastGrantedMslots,
6368 docsIfCmtsUpChnlCtrExtTotalCntnMslots,
6369 docsIfCmtsUpChnlCtrExtUsedCntnMslots,
6370 docsIfCmtsUpChnlCtrCollCntnMslots,
6371 docsIfCmtsUpChnlCtrTotalCntnReqMslots,
6372 docsIfCmtsUpChnlCtrUsedCntnReqMslots,
6373 docsIfCmtsUpChnlCtrCollCntnReqMslots,
6374 docsIfCmtsUpChnlCtrTotalCntnReqDataMslots,
6375 docsIfCmtsUpChnlCtrUsedCntnReqDataMslots,
6376 docsIfCmtsUpChnlCtrCollCntnReqDataMslots,
6377 docsIfCmtsUpChnlCtrTotalCntnInitMaintMslots,
6378 docsIfCmtsUpChnlCtrUsedCntnInitMaintMslots,
6379 docsIfCmtsUpChnlCtrCollCntnInitMaintMslots,
6380 docsIfCmtsUpChnlCtrExtCollCntnMslots,
6381 docsIfCmtsUpChnlCtrExtTotalCntnReqMslots,
6382 docsIfCmtsUpChnlCtrExtUsedCntnReqMslots,
6383 docsIfCmtsUpChnlCtrExtCollCntnReqMslots,
6384 docsIfCmtsUpChnlCtrExtTotalCntnReqDataMslots,
6385 docsIfCmtsUpChnlCtrExtUsedCntnReqDataMslots,
6386 docsIfCmtsUpChnlCtrExtCollCntnReqDataMslots,
6387 docsIfCmtsUpChnlCtrExtTotalCntnInitMaintMslots,
6388 docsIfCmtsUpChnlCtrExtUsedCntnInitMaintMslots,
6389 docsIfCmtsUpChnlCtrExtCollCntnInitMaintMslots,
6390 docsIfDownChannelStorageType,
6391 docsIfQosProfStorageType
6393 }
6394 STATUS current
6395 DESCRIPTION
6396 "Group of objects implemented in Cable Modem Termination
6397 Systems."
6398 ::= { docsIfGroups 7 }
6400 END
6402 5. Revision History
6404 5.1. Scope
6406 The MIB module in this document has been developed to accommodate
6407 DOCSIS 2.0 devices and their system capabilities. The MIB module is
6408 an update to RFC 2670 [RFC2670] with the additional incorporation of
6409 DOCSIS 2.0 [RFI2.0] and Euro-DOCSIS specification requirements [EN-
6410 300-429].
6412 5.2. Extension
6414 We have maintained the MIB objects as defined in RFC 2670 [RFC2670].
6415 In some cases new MIB objects have been created with identical
6416 functionality but greater capacity (i.e. 32 to 64 bits). In these
6417 situations, both the original 32 bit objects and the new 64 bit
6418 objects must be implemented.
6420 5.3. Changes from RFC 2670
6422 o Upstream now separated into 'physical interfaces' and 'logical
6423 channels'. An instance of the docsIfUpstreamChannelTable exists
6424 for each 'logical channel'. The IANA ifType for 'logical
6425 channels' is 205. The IANA ifType for 'physical interfaces'
6426 remains at 129.
6428 o Object docsIfDownChannelAnnex added to
6429 docsIfDownstreamChannelTable. This object originated in the Euro-
6430 DOCSIS specifications.
6432 o Nine new objects added to the docsIfUpstreamChannelTable. One
6433 describes the channel type in use. Four are specific S-CDMA
6434 parameters. Three are used in the creation of a temporary
6435 inactive upstream row so parameters of physical channel may be
6436 manipulated 'offline'.
6438 o One object has been added to enable/disable pre-equalization on
6439 the upstream channel.
6441 o Object docsIfQosProfMaxTransmitBurst has been added to the
6442 docsIfQosProfileTable to replace deprecated object
6443 docsIfQosProfMaxTxBurst. This fixes a range error caused by
6444 switch to recording as bytes instead of mini-slots.
6446 o Three new 64 bit counters added to the docsIfSignalQualityTable to
6447 extend the capacity of existing 32 bit counters.
6449 o A new base object docsIfDocsisBaseCapability has been added which
6450 mirrors the functionality of the DOCSIS specification [OSSI2.0]
6451 defined MIB object docsIfDocsisCapability, extended to include
6452 DOCSIS 2.0.
6454 o Five new objects added to the docsIfCmStatusTable. One indicates
6455 the current modulation type. The second mirrors the functionality
6456 of the DOCSIS specification [OSSI2.0] defined MIB object
6457 docsIfDocsisOperMode, while clarifying that it applies to the COS/
6458 QOS mode used by the device. The third new object indicates
6459 equalization data at the CM. Last two objects indicates total and
6460 failed UCC transactions.
6462 o Two new 64 bit counters added to the docsIfCmServiceTable to
6463 extend the capacity of existing 32 bit counters.
6465 o Nine new objects added to the docsIfCmtsCmStatusTable. Three are
6466 64 bit counters, two add ipv6 capability, one indicates the CM
6467 modulation type in use, one indicates the last update time for the
6468 status value, one is a high resolution of the timing offset MIB
6469 object and the remaining object, indicates the DOCSIS MAC mode of
6470 operation (Cos or QOS).
6472 o One object added to the docsIfCmtsServiceTable to fix a range
6473 error in an existing object, that has been deprecated.
6475 o Eight new objects added to the docsIfCmtsModulationTable. Seven
6476 of these describe ATDMA/S-CDMA channel parameters, while the other
6477 describes modulation attributes common to all modulation types.
6479 o One new object and three new tables added to provide CMTS upstream
6480 and downstream channel utilization data.
6482 o Enumerated values for object docsIfDownChannelInterleave have been
6483 expanded to include a Euro-DOCSIS value.
6485 o Enumerated values for object docsIfCmtsModIntervalUsageCode have
6486 been expanded to include new DOCSIS 2.0 values.
6488 o Enumerated values for object docsIfCmtsModType have been expanded
6489 to include new DOCSIS 2.0 values.
6491 o Compliance statements have been updated to reflect new objects and
6492 to describe Euro-DOCSIS specific implementation features.
6494 o The descriptions of objects docsIfCmtsStatusInvalidRegReqs and
6495 docsIfCmtsStatusFailedRegReqs have been clarified.
6497 o
6499 o Added five Textual Conventions: Two for upstream channels types,
6500 two for DOCSIS PHY and MAC modes of operation and one for the
6501 format of equalization data.
6503 o One object added to the docsIfCmtsModulationTable to indicate
6504 storage type of the table entries to differentiate factory and
6505 user configuration.
6507 o General persistence statements for read-create and read-write
6508 objects.
6510 o Updated DESCRIPTION and UNITS clauses for object
6511 docsIfSigQMicroreflections.
6513 o Corrected DESCRIPTION clause of object docsIfCmStatusValue.
6515 o Separated references into normative and informative.
6517 o Expanded security considerations section.
6519 o Updated IPR Notice and Disclosure to RFC 3667 section 5.1 and RFC
6520 3668 as well as Copyright to RFC 3667 sections 5.4 and 5.5.
6522 6. Security Considerations
6524 This MIB module relates to a system which will provide metropolitan
6525 public internet access. As such, improper manipulation of the MIB
6526 objects represented by this MIB module may result in denial of
6527 service to a large number of end-users.
6529 There are a number of management objects defined in this MIB that
6530 have a MAX-ACCESS clause of read-write or read-create. Such objects
6531 may be considered sensitive or vulnerable in some network
6532 environments. The support for SET operations in a non-secure
6533 environment without proper protection can have a negative effect on
6534 network operations.
6536 The CMTS is the controller of most of the parameters of the DOCSIS
6537 RFI Interface. Therefore, write access to the CMTS MIB objects may
6538 compromise the end-user's services.
6540 In the CM case, the only read-write object of this MIB module is
6541 docsIfCmRangingTimeout that if SET maliciously, may not constitute a
6542 critical factor of service degradation.
6544 The rest of the CM required MIB objects in this MIB module are read-
6545 only, either by definition, or by compliance statements.
6547 The CMTS is the controller of most of the parameters of the DOCSIS
6548 RFI Interface. Below are the CMTS MIB objects vulnerabilities:
6550 o Objects in the docsIfBasicGroupv2 if SET maliciously, could result
6551 in a denial of service. Particularly, SETs to objects in
6552 docsIfDownstreamChannelTable, docsIfUpstreamChannelTable,
6553 docsIfCmtsModulationTable and docsIfQosProfileTable (the last one
6554 in conjunction with the MIB object
6555 docsIfCmtsQosProfilePermissions) can alter negatively the the
6556 physical and link layers parameters of upstream and downstream
6557 channels.
6559 o The Object docsIfCmtsServiceAdminStatus of the docsIfCmtsGroupv2
6560 group when SET maliciously by an attacker to 'disabled' or
6561 'destroyed', will interrupt the service of the corresponding cable
6562 modem.
6564 Some of the readable objects in this MIB module (i.e., objects with a
6565 MAX-ACCESS other than not-accessible) may be considered sensitive or
6566 vulnerable in some network environments. It is thus important to
6567 control even GET and/or NOTIFY access to these objects and possibly
6568 to even encrypt the values of these objects when sending them over
6569 the network via SNMP. Below are some sensitivity considerations:
6571 o Read access to the MIB objects in tables docsIfCmStatusTable (CM),
6572 docsIfSignalQualityTable (CM/CMTS) and CMTS tables
6573 docsIfCmtsCmStatusTable, docsIfCmtsChannelUtilizationTable,
6574 docsIfCmtsDownChannelCounterTable and
6575 docsIfCmtsUpChannelCounterTable, could reveal information about
6576 the cable modems distribution among the upstream and downstream
6577 channels and their performance, which could be used to gain access
6578 to a different tiered service offer. The table
6579 docsIfCmtsCmStatusTable also contain the MAC and IP addresses of
6580 the cable modems which can be used for theft of service.
6582 SNMP versions prior to SNMPv3 did not include adequate security.
6583 Even if the network itself is secure (for example by using IPSec),
6584 even then, there is no control as to who on the secure network is
6585 allowed to access and GET/SET (read/change/create/delete) the objects
6586 in this MIB module.
6588 It is RECOMMENDED that implementers consider the security features as
6589 provided by the SNMPv3 framework (see [RFC3410], section 8),
6590 including full support for the SNMPv3 cryptographic mechanisms (for
6591 authentication and privacy).
6593 Further, deployment of SNMP versions prior to SNMPv3 is NOT
6594 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
6595 enable cryptographic security. It is then a customer/operator
6596 responsibility to ensure that the SNMP entity giving access to an
6597 instance of this MIB module is properly configured to give access to
6598 the objects only to those principals (users) that have legitimate
6599 rights to indeed GET or SET (change/create/delete) them.
6601 7. IANA considerations
6603 This document has no actions for IANA.
6605 8. Management Interoperability of DOCSIS 1.0, 1.1 and 2.0
6607 The MIB module contained in this document updates RFC 2670 [RFC2670],
6608 primarily to handle the management requirements of the DOCSIS RF
6609 Interface of DOCSIS 2.0 [ITU-T_J.122]. RFC 2670 contains the DOCSIS
6610 RF Interface management requirements for DOCSIS 1.0 and DOCSIS 1.1.
6612 The management requirements of Class of Service (DOCSIS 1.0) pertain
6613 to RFC 2670 are the same as this document update and are contained in
6614 tables docsIfQosProfileTable, docsIfCmServiceTable and
6615 docsIfCmtsServiceTable.
6617 DOCSIS 1.1 and DOCSIS 2.0 Quality of Service management requirements
6618 are defined in the DOCSIS management specifications [OSSI1.1] and
6619 [OSSI2.0] respectively.
6621 9. References
6623 9.1. Normative References
6625 [EN-300-429]
6626 European Telecommunications Standard Institute, "ETSI
6627 Standard EN 300 429, Version 1.2.1: Digital Video
6628 Broadcasting (DVB), Framing structure, channel coding and
6629 modulation for cable systems", April 1998.
6631 [IANA] Internet Assigned Numbers Authority, "Internet Assigned
6632 Numbers Authority", October 2005,
6633 .
6635 [ITU-T_J.112]
6636 Telecommunication Standardization Sector of International
6637 Telecommunications Union, "Transmission Systems for
6638 Interactive Cable Television Services, Annex B.",
6639 March 2001, .
6641 [ITU-T_J.122]
6642 Telecommunication Standardization Sector of International
6643 Telecommunications Union, "Second-Generation Transmission
6644 Systems for Interactive Cable Television Services.",
6645 December 2002,
6646 .
6648 [ITU-T_J.83]
6649 Telecommunication Standardization Sector of International
6650 Telecommunications Union, "ITU-T Recommendation
6651 J.83(4/97), Digital multi-programme systems for television
6652 sound and data services for cable distribution.",
6653 April 1997, .
6655 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
6656 Requirement Levels", BCP 14, RFC 2119, March 1997.
6658 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J.
6659 Schoenwaelder, Ed., "Structure of Management Information
6660 Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
6662 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
6663 Schoenwaelder, Ed., "Textual Conventions for SMIv2",
6664 STD 58, RFC 2579, April 1999.
6666 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
6667 "Conformance Statements for SMIv2", STD 58, RFC 2580,
6668 April 1999.
6670 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
6671 MIB", RFC 2863, June 2000.
6673 [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J.
6674 Schoenwaelder, "Textual Conventions for Internet Network
6675 Addresses", RFC 4001, February 2005.
6677 [RFI1.1] CableLabs, "Data-Over-Cable Service Interface
6678 Specifications: Radio Frequency Interface Specification
6679 SP-RFIv1.1-C01-050907", September 2005,
6680 .
6682 [RFI2.0] CableLabs, "Data-Over-Cable Service Interface
6683 Specifications: Radio Frequency Interface Specification
6684 SP-RFIv2.0-I09-050812", August 2005,
6685 .
6687 9.2. Informative References
6689 [BPI] SCTE Data Standards Subcommittee, "Data-Over-Cable Service
6690 Interface Specifications: DOCSIS 1.0 Baseline Privacy
6691 Interface Specification SCTE 22-2 2002", 2002,
6692 .
6694 [BPIPLUS] CableLabs, "Data-Over-Cable Service Interface
6695 Specifications: Baseline Privacy Plus Interface
6696 Specification SP-BPI+-I12-050812", August 2005,
6697 .
6699 [OSSI1.1] CableLabs, "Data-Over-Cable Service Interface
6700 Specifications: Operations Support System Interface
6701 Specification SP-OSSIv1.1-C01-050907", September 2005,
6702 .
6704 [OSSI2.0] CableLabs, "Data-Over-Cable Service Interface
6705 Specifications: Operations Support System Interface
6706 Specification SP-OSSIv2.0-I09-050812", September 2005,
6707 .
6709 [Proakis00]
6710 McGraw-Hill, "Digital Communications, 4th Edition", 2000.
6712 [RFC2670] St. Johns, M., "Radio Frequency (RF) Interface Management
6713 Information Base for MCNS/DOCSIS compliant RF interfaces",
6714 RFC 2670, August 1999.
6716 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
6717 "Introduction and Applicability Statements for Internet-
6718 Standard Management Framework", RFC 3410, December 2002.
6720 [RFI1.0] SCTE Data Standards Subcommittee, "Data-Over-Cable Service
6721 Interface Specifications: DOCSIS 1.0 Radio Frequency
6722 Interface Specification SCTE 22-1 2002", 2002,
6723 .
6725 Authors' Addresses
6727 David Raftus
6728 ATI Technologies
6729 340 Terry Fox Drive, Suite 202
6730 Ottawa, Ontario
6731 Canada
6733 Phone: +1 613 592 1052 ext.222
6734 Email: david.raftus@ati.com
6736 Eduardo Cardona
6737 Cable Television Laboratories, Inc.
6738 858 Coal Creek Circle
6739 Louisville, CO 80020
6740 USA
6742 Phone: +1 303 661 3375
6743 Email: e.cardona@cablelabs.com
6745 Intellectual Property Statement
6747 The IETF takes no position regarding the validity or scope of any
6748 Intellectual Property Rights or other rights that might be claimed to
6749 pertain to the implementation or use of the technology described in
6750 this document or the extent to which any license under such rights
6751 might or might not be available; nor does it represent that it has
6752 made any independent effort to identify any such rights. Information
6753 on the procedures with respect to rights in RFC documents can be
6754 found in BCP 78 and BCP 79.
6756 Copies of IPR disclosures made to the IETF Secretariat and any
6757 assurances of licenses to be made available, or the result of an
6758 attempt made to obtain a general license or permission for the use of
6759 such proprietary rights by implementers or users of this
6760 specification can be obtained from the IETF on-line IPR repository at
6761 http://www.ietf.org/ipr.
6763 The IETF invites any interested party to bring to its attention any
6764 copyrights, patents or patent applications, or other proprietary
6765 rights that may cover technology that may be required to implement
6766 this standard. Please address the information to the IETF at
6767 ietf-ipr@ietf.org.
6769 Disclaimer of Validity
6771 This document and the information contained herein are provided on an
6772 "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
6773 OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
6774 ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
6775 INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
6776 INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
6777 WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
6779 Copyright Statement
6781 Copyright (C) The Internet Society (2005). This document is subject
6782 to the rights, licenses and restrictions contained in BCP 78, and
6783 except as set forth therein, the authors retain all their rights.
6785 Acknowledgment
6787 Funding for the RFC Editor function is currently provided by the
6788 Internet Society.