241 lines
7.9 KiB
Plaintext
241 lines
7.9 KiB
Plaintext
-- *****************************************************************
|
|
-- CISCO-VOA-MIB.my
|
|
--
|
|
-- May 2002, Sonal Maheshwari, Mickey Spiegel
|
|
--
|
|
-- Copyright (c) 2002 by cisco Systems, Inc.
|
|
-- All rights reserved.
|
|
-- *****************************************************************
|
|
|
|
CISCO-VOA-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE,
|
|
Integer32 FROM SNMPv2-SMI
|
|
TEXTUAL-CONVENTION,
|
|
TimeStamp FROM SNMPv2-TC
|
|
MODULE-COMPLIANCE,
|
|
OBJECT-GROUP FROM SNMPv2-CONF
|
|
ifIndex FROM IF-MIB
|
|
OpticalIfDirection FROM CISCO-OPTICAL-MONITOR-MIB
|
|
ciscoMgmt FROM CISCO-SMI
|
|
;
|
|
|
|
ciscoVoaMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200205070000Z"
|
|
ORGANIZATION "Cisco Systems, Inc."
|
|
CONTACT-INFO "Cisco Systems
|
|
Customer Service
|
|
|
|
Postal: 170 W Tasman Drive
|
|
San Jose, CA 95134
|
|
|
|
Tel: +1 800 553-NETS
|
|
|
|
E-mail: cs-dwdm@cisco.com"
|
|
DESCRIPTION
|
|
"This MIB module defines objects to configure and manage the
|
|
Variable Optical Attenuator (VOA) modules.
|
|
|
|
VOA modules are typically used to attenuate channels added
|
|
by a network element, in order to equalize the input power of
|
|
each wavelength before the multiplexed signal consisting of
|
|
all wavelengths is sent through an EDFA. There may be
|
|
a separate VOA per channel, one VOA per band of wavelengths,
|
|
or one VOA for the pass through wavelengths.
|
|
|
|
VOA modules are also often used before terminating optical
|
|
wavelengths at optical receivers, in order to avoid receiver
|
|
saturation.
|
|
|
|
The VOAs may be present on various modules within the network
|
|
element, for example, on an Optical Add/Drop Multiplexer
|
|
(OADM) module, on the same module as an optical transceiver,
|
|
or on a separate module of its own.
|
|
"
|
|
REVISION "200205070000Z"
|
|
DESCRIPTION
|
|
"The initial revision of this MIB."
|
|
::= { ciscoMgmt 262 }
|
|
|
|
|
|
-- Textual Conventions
|
|
|
|
OpticalPowerInDbm ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An integer value that gives the optical power level in 1/10ths
|
|
of dBm.
|
|
Example: The value -300 represents a power level of -30.0 dBm.
|
|
|
|
The distinguished value of '-1000' indicates that the object
|
|
has not yet been initialized.
|
|
"
|
|
SYNTAX Integer32 ( -400..250 | -1000 )
|
|
|
|
|
|
OpticalAttenInDb ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An integer value that gives the attenuation level in
|
|
1/10ths of dB.
|
|
Example: The value 80 represents an attenuation
|
|
level of 8.0 dB.
|
|
"
|
|
SYNTAX Integer32 (0..400)
|
|
|
|
|
|
-- MIB Object Definitions
|
|
|
|
cVoaMIBObjects OBJECT IDENTIFIER ::= { ciscoVoaMIB 1 }
|
|
|
|
-- groups in this MIB module
|
|
|
|
cVoaBaseGroup OBJECT IDENTIFIER ::= { cVoaMIBObjects 1 }
|
|
|
|
-- VOA basic objects
|
|
|
|
cVoaTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CVoaEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table provides objects to configure and control the
|
|
attenuation on VOAs."
|
|
::={ cVoaBaseGroup 1 }
|
|
|
|
cVoaEntry OBJECT-TYPE
|
|
SYNTAX CVoaEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An entry in the cVoaTable provides objects to configure and
|
|
control the attenuation level of a VOA at an interface, for
|
|
a given direction."
|
|
INDEX { ifIndex, cVoaDirection }
|
|
::={ cVoaTable 1 }
|
|
|
|
CVoaEntry ::= SEQUENCE {
|
|
cVoaDirection OpticalIfDirection,
|
|
cVoaAttenuationControlMode INTEGER,
|
|
cVoaAttenuation OpticalAttenInDb,
|
|
cVoaAttenuationLastChange TimeStamp,
|
|
cVoaDesiredPower OpticalPowerInDbm
|
|
}
|
|
|
|
cVoaDirection OBJECT-TYPE
|
|
SYNTAX OpticalIfDirection
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This is the second index into the cVoaTable and indicates
|
|
the direction for which the attenuation level at this
|
|
interface is being controlled, in this entry."
|
|
::={ cVoaEntry 1 }
|
|
|
|
cVoaAttenuationControlMode OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
manual(1),
|
|
automatic(2)
|
|
}
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object is used to set the mode of controlling the
|
|
attenuation level of a VOA at an interface.
|
|
|
|
When the mode is set to 'manual', the attenuation level is
|
|
configured manually, by setting the desired attenuation
|
|
level in the cVoaAttenuation object. The cVoaDesiredPower
|
|
object does not apply in this case.
|
|
|
|
When the mode is set to 'automatic', the attenuation level
|
|
is continuously adjusted to maintain a desired power level,
|
|
after attenuation. The desired optical power level after
|
|
attenuation is configured using the cVoaDesiredPower object.
|
|
The cVoaAttenuation object cannot be configured in this case,
|
|
but it indicates the attenuation level derived from the
|
|
desired power level.
|
|
|
|
The automatic mode of controlling attenuation should not be
|
|
used when the monitored power level includes multiple
|
|
wavelengths, since the power level monitor cannot distinguish
|
|
between a decrease in power across all wavelengths, versus a
|
|
loss of power of some but not all wavelengths. If some but not
|
|
all wavelengths go down, this would cause the attenuation level
|
|
to be automatically decreased, leading to an increase in the
|
|
power level of the remaining wavelengths."
|
|
::={ cVoaEntry 2 }
|
|
|
|
cVoaAttenuation OBJECT-TYPE
|
|
SYNTAX OpticalAttenInDb
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the attenuation level applied at the
|
|
interface.
|
|
|
|
When the cVoaAttenuationControlMode object is set to 'manual',
|
|
the attenuation level may be specified by setting this object."
|
|
::={ cVoaEntry 3 }
|
|
|
|
cVoaAttenuationLastChange OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the value of sysUpTime at the last
|
|
time the attenuation level was adjusted at this interface,
|
|
in the given direction."
|
|
::={ cVoaEntry 4 }
|
|
|
|
cVoaDesiredPower OBJECT-TYPE
|
|
SYNTAX OpticalPowerInDbm
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the desired optical power level,
|
|
after attenuation, at the interface.
|
|
|
|
This object applies only when the cVoaAttenuationControlMode
|
|
object is set to 'automatic'. In this mode, the attenuation
|
|
level is continuously adjusted to maintain the desired
|
|
power level, after attenuation, as specified by this object."
|
|
::={ cVoaEntry 5 }
|
|
|
|
|
|
-- MIB Conformance Statements
|
|
|
|
cVoaMIBConformance OBJECT IDENTIFIER ::= { ciscoVoaMIB 3 }
|
|
|
|
cVoaMIBCompliances OBJECT IDENTIFIER ::= { cVoaMIBConformance 1 }
|
|
|
|
cVoaMIBGroups OBJECT IDENTIFIER ::= { cVoaMIBConformance 2 }
|
|
|
|
cVoaMIBCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for platforms that provide
|
|
configuration and control of VOA modules."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS { cVoaMIBBaseGroup }
|
|
|
|
::={ cVoaMIBCompliances 1 }
|
|
|
|
-- Units of Conformance
|
|
|
|
cVoaMIBBaseGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
cVoaAttenuationControlMode,
|
|
cVoaAttenuation,
|
|
cVoaAttenuationLastChange,
|
|
cVoaDesiredPower
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A collection of mandatory managed objects that provide basic
|
|
configuration and control of the VOA modules."
|
|
::={ cVoaMIBGroups 1 }
|
|
|
|
END
|