1 ETHER-WIS DEFINITIONS ::= BEGIN
4 MODULE-IDENTITY, OBJECT-TYPE,
9 MODULE-COMPLIANCE, OBJECT-GROUP
11 sonetMediumStuff2, sonetSectionStuff2,
12 sonetLineStuff2, sonetFarEndLineStuff2,
13 sonetPathStuff2, sonetFarEndPathStuff2,
14 sonetMediumType, sonetMediumLineCoding,
15 sonetMediumLineType, sonetMediumCircuitIdentifier,
16 sonetMediumLoopbackConfig, sonetSESthresholdSet,
20 etherWisMIB MODULE-IDENTITY
21 LAST-UPDATED "200309190000Z" -- September 19, 2003
22 ORGANIZATION "IETF Ethernet Interfaces and Hub MIB
26 http://www.ietf.org/html.charters/hubmib-charter.html
29 General Discussion: hubmib@ietf.org
30 To Subscribe: hubmib-request@ietf.org
31 In Body: subscribe your_email_address
35 Atidim Technology Park, Bldg. 3
39 E-mail: dromasca@avaya.com
42 Postal: 600 Rainbow Dr. #141
43 Mountain View, CA 94041-2542
46 E-mail: heard@pobox.com"
51 "The objects in this MIB module are used in conjunction
52 with objects in the SONET-MIB and the MAU-MIB to manage
53 the Ethernet WAN Interface Sublayer (WIS).
55 The following reference is used throughout this MIB module:
57 [IEEE 802.3 Std] refers to:
58 IEEE Std 802.3, 2000 Edition: 'IEEE Standard for
59 Information technology - Telecommunications and
60 information exchange between systems - Local and
61 metropolitan area networks - Specific requirements -
62 Part 3: Carrier sense multiple access with collision
63 detection (CSMA/CD) access method and physical layer
64 specifications', as amended by IEEE Std 802.3ae-2002,
65 'IEEE Standard for Carrier Sense Multiple Access with
66 Collision Detection (CSMA/CD) Access Method and
67 Physical Layer Specifications - Media Access Control
68 (MAC) Parameters, Physical Layer and Management
69 Parameters for 10 Gb/s Operation', 30 August 2002.
71 Of particular interest are Clause 50, 'WAN Interface
72 Sublayer (WIS), type 10GBASE-W', Clause 30, '10Mb/s,
73 100Mb/s, 1000Mb/s, and 10Gb/s MAC Control, and Link
74 Aggregation Management', and Clause 45, 'Management
75 Data Input/Output (MDIO) Interface'.
77 Copyright (C) The Internet Society (2003). This version
78 of this MIB module is part of RFC 3637; see the RFC
79 itself for full legal notices."
81 REVISION "200309190000Z" -- September 19, 2003
82 DESCRIPTION "Initial version, published as RFC 3637."
84 ::= { transmission 134 }
86 -- The main sections of the module
88 etherWisObjects OBJECT IDENTIFIER ::= { etherWisMIB 1 }
90 etherWisObjectsPath OBJECT IDENTIFIER ::= { etherWisMIB 2 }
92 etherWisConformance OBJECT IDENTIFIER ::= { etherWisMIB 3 }
101 -- groups in the Ethernet WIS MIB module
103 etherWisDevice OBJECT IDENTIFIER ::= { etherWisObjects 1 }
105 etherWisSection OBJECT IDENTIFIER ::= { etherWisObjects 2 }
107 etherWisPath OBJECT IDENTIFIER ::= { etherWisObjectsPath 1 }
109 etherWisFarEndPath OBJECT IDENTIFIER ::= { etherWisObjectsPath 2 }
114 -- These objects provide WIS extensions to
115 -- the SONET-MIB Medium Group.
117 etherWisDeviceTable OBJECT-TYPE
118 SYNTAX SEQUENCE OF EtherWisDeviceEntry
119 MAX-ACCESS not-accessible
122 "The table for Ethernet WIS devices"
123 ::= { etherWisDevice 1 }
125 etherWisDeviceEntry OBJECT-TYPE
126 SYNTAX EtherWisDeviceEntry
127 MAX-ACCESS not-accessible
130 "An entry in the Ethernet WIS device table. For each
131 instance of this object there MUST be a corresponding
132 instance of sonetMediumEntry."
134 ::= { etherWisDeviceTable 1 }
136 EtherWisDeviceEntry ::=
138 etherWisDeviceTxTestPatternMode INTEGER,
139 etherWisDeviceRxTestPatternMode INTEGER,
140 etherWisDeviceRxTestPatternErrors Gauge32
152 etherWisDeviceTxTestPatternMode OBJECT-TYPE
159 MAX-ACCESS read-write
162 "This variable controls the transmit test pattern mode.
163 The value none(1) puts the the WIS transmit path into
164 the normal operating mode. The value squareWave(2) puts
165 the WIS transmit path into the square wave test pattern
166 mode described in [IEEE 802.3 Std.] subclause 50.3.8.1.
167 The value prbs31(3) puts the WIS transmit path into the
168 PRBS31 test pattern mode described in [IEEE 802.3 Std.]
169 subclause 50.3.8.2. The value mixedFrequency(4) puts the
170 WIS transmit path into the mixed frequency test pattern
171 mode described in [IEEE 802.3 Std.] subclause 50.3.8.3.
172 Any attempt to set this object to a value other than
173 none(1) when the corresponding instance of ifAdminStatus
174 has the value up(1) MUST be rejected with the error
175 inconsistentValue, and any attempt to set the corresponding
176 instance of ifAdminStatus to the value up(1) when an
177 instance of this object has a value other than none(1)
178 MUST be rejected with the error inconsistentValue."
180 "[IEEE 802.3 Std.], 50.3.8, WIS test pattern generator and
181 checker, 45.2.2.6, 10G WIS control 2 register (2.7), and
182 45.2.2.7.2, PRBS31 pattern testing ability (2.8.1)."
183 ::= { etherWisDeviceEntry 1 }
185 etherWisDeviceRxTestPatternMode OBJECT-TYPE
191 MAX-ACCESS read-write
204 "This variable controls the receive test pattern mode.
205 The value none(1) puts the the WIS receive path into the
206 normal operating mode. The value prbs31(3) puts the WIS
207 receive path into the PRBS31 test pattern mode described
208 in [IEEE 802.3 Std.] subclause 50.3.8.2. The value
209 mixedFrequency(4) puts the WIS receive path into the mixed
210 frequency test pattern mode described in [IEEE 802.3 Std.]
211 subclause 50.3.8.3. Any attempt to set this object to a
212 value other than none(1) when the corresponding instance
213 of ifAdminStatus has the value up(1) MUST be rejected with
214 the error inconsistentValue, and any attempt to set the
215 corresponding instance of ifAdminStatus to the value up(1)
216 when an instance of this object has a value other than
217 none(1) MUST be rejected with the error inconsistentValue."
219 "[IEEE 802.3 Std.], 50.3.8, WIS test pattern generator and
220 checker, 45.2.2.6, 10G WIS control 2 register (2.7), and
221 45.2.2.7.2, PRBS31 pattern testing ability (2.8.1)."
222 ::= { etherWisDeviceEntry 2 }
224 etherWisDeviceRxTestPatternErrors OBJECT-TYPE
225 SYNTAX Gauge32 ( 0..65535 )
226 MAX-ACCESS read-write
229 "This object counts the number of errors detected when the
230 WIS receive path is operating in the PRBS31 test pattern
231 mode. It is reset to zero when the WIS receive path
232 initially enters that mode, and it increments each time
233 the PRBS pattern checker detects an error as described in
234 [IEEE 802.3 Std.] subclause 50.3.8.2 unless its value is
235 65535, in which case it remains unchanged. This object is
236 writeable so that it may be reset upon explicit request
237 of a command generator application while the WIS receive
238 path continues to operate in PRBS31 test pattern mode."
240 "[IEEE 802.3 Std.], 50.3.8, WIS test pattern generator and
241 checker, 45.2.2.7.2, PRBS31 pattern testing ability
242 (2.8.1), and 45.2.2.8, 10G WIS test pattern error counter
244 ::= { etherWisDeviceEntry 3 }
256 -- These objects provide WIS extensions to
257 -- the SONET-MIB Section Group.
259 etherWisSectionCurrentTable OBJECT-TYPE
260 SYNTAX SEQUENCE OF EtherWisSectionCurrentEntry
261 MAX-ACCESS not-accessible
264 "The table for the current state of Ethernet WIS sections."
265 ::= { etherWisSection 1 }
267 etherWisSectionCurrentEntry OBJECT-TYPE
268 SYNTAX EtherWisSectionCurrentEntry
269 MAX-ACCESS not-accessible
272 "An entry in the etherWisSectionCurrentTable. For each
273 instance of this object there MUST be a corresponding
274 instance of sonetSectionCurrentEntry."
276 ::= { etherWisSectionCurrentTable 1 }
278 EtherWisSectionCurrentEntry ::=
280 etherWisSectionCurrentJ0Transmitted OCTET STRING,
281 etherWisSectionCurrentJ0Received OCTET STRING
284 etherWisSectionCurrentJ0Transmitted OBJECT-TYPE
285 SYNTAX OCTET STRING (SIZE (16))
286 MAX-ACCESS read-write
289 "This is the 16-octet section trace message that
290 is transmitted in the J0 byte. The value SHOULD
291 be '89'h followed by fifteen octets of '00'h
292 (or some cyclic shift thereof) when the section
293 trace function is not used, and the implementation
294 SHOULD use that value (or a cyclic shift thereof)
295 as a default if no other value has been set."
297 "[IEEE 802.3 Std.], 30.8.1.1.8, aJ0ValueTX."
298 ::= { etherWisSectionCurrentEntry 1 }
305 etherWisSectionCurrentJ0Received OBJECT-TYPE
306 SYNTAX OCTET STRING (SIZE (16))
310 "This is the 16-octet section trace message that
311 was most recently received in the J0 byte."
313 "[IEEE 802.3 Std.], 30.8.1.1.9, aJ0ValueRX."
314 ::= { etherWisSectionCurrentEntry 2 }
319 -- These objects provide WIS extensions to
320 -- the SONET-MIB Path Group.
322 etherWisPathCurrentTable OBJECT-TYPE
323 SYNTAX SEQUENCE OF EtherWisPathCurrentEntry
324 MAX-ACCESS not-accessible
327 "The table for the current state of Ethernet WIS paths."
328 ::= { etherWisPath 1 }
330 etherWisPathCurrentEntry OBJECT-TYPE
331 SYNTAX EtherWisPathCurrentEntry
332 MAX-ACCESS not-accessible
335 "An entry in the etherWisPathCurrentTable. For each
336 instance of this object there MUST be a corresponding
337 instance of sonetPathCurrentEntry."
339 ::= { etherWisPathCurrentTable 1 }
341 EtherWisPathCurrentEntry ::=
343 etherWisPathCurrentStatus BITS,
344 etherWisPathCurrentJ1Transmitted OCTET STRING,
345 etherWisPathCurrentJ1Received OCTET STRING
356 etherWisPathCurrentStatus OBJECT-TYPE
366 "This variable indicates the current status of the
367 path payload with a bit map that can indicate multiple
368 defects at once. The bit positions are assigned as
372 This bit is set to indicate that an
373 LOP-P (Loss of Pointer - Path) defect
374 is being experienced. Note: when this
375 bit is set, sonetPathSTSLOP MUST be set
376 in the corresponding instance of
377 sonetPathCurrentStatus.
380 This bit is set to indicate that an
381 AIS-P (Alarm Indication Signal - Path)
382 defect is being experienced. Note: when
383 this bit is set, sonetPathSTSAIS MUST be
384 set in the corresponding instance of
385 sonetPathCurrentStatus.
388 This bit is set to indicate that a
389 PLM-P (Payload Label Mismatch - Path)
390 defect is being experienced. Note: when
391 this bit is set, sonetPathSignalLabelMismatch
392 MUST be set in the corresponding instance of
393 sonetPathCurrentStatus.
408 This bit is set to indicate that an
409 LCD-P (Loss of Codegroup Delination - Path)
410 defect is being experienced. Since this
411 defect is detected by the PCS and not by
412 the path layer itself, there is no
413 corresponding bit in sonetPathCurrentStatus."
415 "[IEEE 802.3 Std.], 30.8.1.1.18, aPathStatus."
416 ::= { etherWisPathCurrentEntry 1 }
418 etherWisPathCurrentJ1Transmitted OBJECT-TYPE
419 SYNTAX OCTET STRING (SIZE (16))
420 MAX-ACCESS read-write
423 "This is the 16-octet path trace message that
424 is transmitted in the J1 byte. The value SHOULD
425 be '89'h followed by fifteen octets of '00'h
426 (or some cyclic shift thereof) when the path
427 trace function is not used, and the implementation
428 SHOULD use that value (or a cyclic shift thereof)
429 as a default if no other value has been set."
431 "[IEEE 802.3 Std.], 30.8.1.1.23, aJ1ValueTX."
432 ::= { etherWisPathCurrentEntry 2 }
434 etherWisPathCurrentJ1Received OBJECT-TYPE
435 SYNTAX OCTET STRING (SIZE (16))
439 "This is the 16-octet path trace message that
440 was most recently received in the J1 byte."
442 "[IEEE 802.3 Std.], 30.8.1.1.24, aJ1ValueRX."
443 ::= { etherWisPathCurrentEntry 3 }
458 -- The Far End Path group
460 -- These objects provide WIS extensions to
461 -- the SONET-MIB Far End Path Group.
463 etherWisFarEndPathCurrentTable OBJECT-TYPE
464 SYNTAX SEQUENCE OF EtherWisFarEndPathCurrentEntry
465 MAX-ACCESS not-accessible
468 "The table for the current far-end state of Ethernet WIS
470 ::= { etherWisFarEndPath 1 }
472 etherWisFarEndPathCurrentEntry OBJECT-TYPE
473 SYNTAX EtherWisFarEndPathCurrentEntry
474 MAX-ACCESS not-accessible
477 "An entry in the etherWisFarEndPathCurrentTable. For each
478 instance of this object there MUST be a corresponding
479 instance of sonetFarEndPathCurrentEntry."
481 ::= { etherWisFarEndPathCurrentTable 1 }
483 EtherWisFarEndPathCurrentEntry ::=
485 etherWisFarEndPathCurrentStatus BITS
488 etherWisFarEndPathCurrentStatus OBJECT-TYPE
490 etherWisFarEndPayloadDefect(0),
491 etherWisFarEndServerDefect(1)
496 "This variable indicates the current status at the
497 far end of the path using a bit map that can indicate
498 multiple defects at once. The bit positions are
501 etherWisFarEndPayloadDefect(0)
502 A far end payload defect (i.e., far end
503 PLM-P or LCD-P) is currently being signaled
509 etherWisFarEndServerDefect(1)
510 A far end server defect (i.e., far end
511 LOP-P or AIS-P) is currently being signaled
512 in G1 bits 5-7. Note: when this bit is set,
513 sonetPathSTSRDI MUST be set in the corresponding
514 instance of sonetPathCurrentStatus."
516 "[IEEE 802.3 Std.], 30.8.1.1.25, aFarEndPathStatus."
517 ::= { etherWisFarEndPathCurrentEntry 1 }
521 -- Conformance Statements
524 etherWisGroups OBJECT IDENTIFIER ::= { etherWisConformance 1 }
526 etherWisCompliances OBJECT IDENTIFIER ::= { etherWisConformance 2 }
530 etherWisDeviceGroupBasic OBJECT-GROUP
532 etherWisDeviceTxTestPatternMode,
533 etherWisDeviceRxTestPatternMode
537 "A collection of objects that support test
538 features required of all WIS devices."
539 ::= { etherWisGroups 1 }
541 etherWisDeviceGroupExtra OBJECT-GROUP
543 etherWisDeviceRxTestPatternErrors
547 "A collection of objects that support
548 optional WIS device test features."
549 ::= { etherWisGroups 2 }
560 etherWisSectionGroup OBJECT-GROUP
562 etherWisSectionCurrentJ0Transmitted,
563 etherWisSectionCurrentJ0Received
567 "A collection of objects that provide
568 required information about a WIS section."
569 ::= { etherWisGroups 3 }
571 etherWisPathGroup OBJECT-GROUP
573 etherWisPathCurrentStatus,
574 etherWisPathCurrentJ1Transmitted,
575 etherWisPathCurrentJ1Received
579 "A collection of objects that provide
580 required information about a WIS path."
581 ::= { etherWisGroups 4 }
583 etherWisFarEndPathGroup OBJECT-GROUP
585 etherWisFarEndPathCurrentStatus
589 "A collection of objects that provide required
590 information about the far end of a WIS path."
591 ::= { etherWisGroups 5 }
593 -- Compliance Statements
595 etherWisCompliance MODULE-COMPLIANCE
598 "The compliance statement for interfaces that include
599 the Ethernet WIS. Compliance with the following
600 external compliance statements is prerequisite:
602 MIB Module Compliance Statement
603 ---------- --------------------
605 IF-INVERTED-STACK-MIB ifInvCompliance
606 EtherLike-MIB dot3Compliance2
607 MAU-MIB mauModIfCompl3"
611 MODULE -- this module
613 etherWisDeviceGroupBasic,
614 etherWisSectionGroup,
616 etherWisFarEndPathGroup
619 OBJECT etherWisDeviceTxTestPatternMode
626 "Support for values other than none(1),
627 squareWave(2), and mixedFrequency(4)
630 OBJECT etherWisDeviceRxTestPatternMode
636 "Support for values other than none(1)
637 and mixedFrequency(4) is not required."
639 GROUP etherWisDeviceGroupExtra
641 "Implementation of this group, along with support for
642 the value prbs31(3) for etherWisDeviceTxTestPatternMode
643 and etherWisDeviceRxTestPatternMode, is necessary if the
644 optional PRBS31 test pattern mode is to be supported."
646 OBJECT etherWisDeviceRxTestPatternErrors
647 WRITE-SYNTAX Gauge32 ( 0 )
649 "An implementation is not required to
650 allow values other than zero to be
651 written to this object."
667 sonetFarEndLineStuff2,
669 sonetFarEndPathStuff2
672 OBJECT sonetMediumType
678 "Write access is not required, nor is support
679 for any value other than sonet(1)."
681 OBJECT sonetMediumLineCoding
687 "Write access is not required, nor is support
688 for any value other than sonetMediumNRZ(4)."
690 OBJECT sonetMediumLineType
693 "Write access is not required."
695 OBJECT sonetMediumCircuitIdentifier
698 "Write access is not required."
700 OBJECT sonetMediumLoopbackConfig
707 "Write access is not required, nor is support for values
708 other than sonetNoLoop(0) and sonetFacilityLoop(1)."
713 OBJECT sonetSESthresholdSet
716 "Write access is not required, and only one
717 of the enumerated values need be supported."
719 OBJECT sonetPathCurrentWidth
725 "Write access is not required, nor is support
726 for any value other than sts192cSTM64(6)."
728 ::= { etherWisCompliances 1 }