461 lines
16 KiB
Plaintext
461 lines
16 KiB
Plaintext
CUMULUS-SENSOR-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE,
|
|
Integer32, Unsigned32, mib-2
|
|
FROM SNMPv2-SMI
|
|
MODULE-COMPLIANCE, OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
TEXTUAL-CONVENTION, TimeStamp
|
|
FROM SNMPv2-TC
|
|
SnmpAdminString
|
|
FROM SNMP-FRAMEWORK-MIB
|
|
cumulusMib
|
|
FROM CUMULUS-SNMP-MIB;
|
|
|
|
agentSwitchSensorMIB MODULE-IDENTITY
|
|
LAST-UPDATED "200212160000Z"
|
|
ORGANIZATION "Cumulus sensor MIB"
|
|
CONTACT-INFO
|
|
"Nvidia Cumulus"
|
|
DESCRIPTION
|
|
"Cumulus entity sensor mib based on ENTITY-SENSOR-MIB"
|
|
|
|
::= { cumulusMib 6 }
|
|
|
|
entitySensorObjects OBJECT IDENTIFIER
|
|
::= { agentSwitchSensorMIB 1 }
|
|
|
|
--
|
|
-- Textual Conventions
|
|
--
|
|
|
|
EntitySensorDataType ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An object using this data type represents the Entity Sensor
|
|
measurement data type associated with a physical sensor
|
|
value. The actual data units are determined by examining an
|
|
object of this type together with the associated
|
|
EntitySensorDataScale object.
|
|
|
|
An object of this type SHOULD be defined together with
|
|
objects of type EntitySensorDataScale and
|
|
EntitySensorPrecision. Together, associated objects of
|
|
these three types are used to identify the semantics of an
|
|
object of type EntitySensorValue.
|
|
|
|
Valid values are:
|
|
|
|
other(1): a measure other than those listed below
|
|
unknown(2): unknown measurement, or arbitrary,
|
|
relative numbers
|
|
voltsAC(3): electric potential
|
|
voltsDC(4): electric potential
|
|
amperes(5): electric current
|
|
watts(6): power
|
|
hertz(7): frequency
|
|
celsius(8): temperature
|
|
percentRH(9): percent relative humidity
|
|
rpm(10): shaft revolutions per minute
|
|
cmm(11),: cubic meters per minute (airflow)
|
|
truthvalue(12): value takes { true(1), false(2) }
|
|
"
|
|
SYNTAX INTEGER {
|
|
other(1),
|
|
unknown(2),
|
|
voltsAC(3),
|
|
voltsDC(4),
|
|
amperes(5),
|
|
watts(6),
|
|
hertz(7),
|
|
celsius(8),
|
|
percentRH(9),
|
|
rpm(10),
|
|
cmm(11),
|
|
truthvalue(12)
|
|
}
|
|
|
|
EntitySensorDataScale ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An object using this data type represents a data scaling
|
|
factor, represented with an International System of Units
|
|
(SI) prefix. The actual data units are determined by
|
|
examining an object of this type together with the
|
|
associated EntitySensorDataType object.
|
|
|
|
An object of this type SHOULD be defined together with
|
|
objects of type EntitySensorDataType and
|
|
EntitySensorPrecision. Together, associated objects of
|
|
these three types are used to identify the semantics of an
|
|
object of type EntitySensorValue."
|
|
REFERENCE
|
|
"The International System of Units (SI),
|
|
National Institute of Standards and Technology,
|
|
Spec. Publ. 330, August 1991."
|
|
SYNTAX INTEGER {
|
|
yocto(1), -- 10^-24
|
|
zepto(2), -- 10^-21
|
|
atto(3), -- 10^-18
|
|
femto(4), -- 10^-15
|
|
pico(5), -- 10^-12
|
|
nano(6), -- 10^-9
|
|
micro(7), -- 10^-6
|
|
milli(8), -- 10^-3
|
|
units(9), -- 10^0
|
|
kilo(10), -- 10^3
|
|
mega(11), -- 10^6
|
|
giga(12), -- 10^9
|
|
tera(13), -- 10^12
|
|
exa(14), -- 10^15
|
|
peta(15), -- 10^18
|
|
zetta(16), -- 10^21
|
|
yotta(17) -- 10^24
|
|
}
|
|
|
|
EntitySensorPrecision ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An object using this data type represents a sensor
|
|
precision range.
|
|
|
|
An object of this type SHOULD be defined together with
|
|
objects of type EntitySensorDataType and
|
|
EntitySensorDataScale. Together, associated objects of
|
|
these three types are used to identify the semantics of an
|
|
object of type EntitySensorValue.
|
|
|
|
If an object of this type contains a value in the range 1 to
|
|
9, it represents the number of decimal places in the
|
|
fractional part of an associated EntitySensorValue fixed-
|
|
point number.
|
|
|
|
If an object of this type contains a value in the range -8
|
|
to -1, it represents the number of accurate digits in the
|
|
associated EntitySensorValue fixed-point number.
|
|
|
|
The value zero indicates the associated EntitySensorValue
|
|
object is not a fixed-point number.
|
|
|
|
Agent implementors must choose a value for the associated
|
|
EntitySensorPrecision object so that the precision and
|
|
|
|
accuracy of the associated EntitySensorValue object is
|
|
correctly indicated.
|
|
|
|
For example, a physical entity representing a temperature
|
|
sensor that can measure 0 degrees to 100 degrees C in 0.1
|
|
degree increments, +/- 0.05 degrees, would have an
|
|
EntitySensorPrecision value of '1', an EntitySensorDataScale
|
|
value of 'units(9)', and an EntitySensorValue ranging from
|
|
'0' to '1000'. The EntitySensorValue would be interpreted
|
|
as 'degrees C * 10'."
|
|
SYNTAX Integer32 (-8..9)
|
|
|
|
EntitySensorValue ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An object using this data type represents an Entity Sensor
|
|
value.
|
|
An object of this type SHOULD be defined together with
|
|
objects of type EntitySensorDataType, EntitySensorDataScale
|
|
and EntitySensorPrecision. Together, associated objects of
|
|
those three types are used to identify the semantics of an
|
|
object of this data type.
|
|
|
|
The semantics of an object using this data type are
|
|
determined by the value of the associated
|
|
EntitySensorDataType object.
|
|
|
|
If the associated EntitySensorDataType object is equal to
|
|
'voltsAC(3)', 'voltsDC(4)', 'amperes(5)', 'watts(6),
|
|
'hertz(7)', 'celsius(8)', or 'cmm(11)', then an object of
|
|
this type MUST contain a fixed point number ranging from
|
|
-999,999,999 to +999,999,999. The value -1000000000
|
|
indicates an underflow error. The value +1000000000
|
|
indicates an overflow error. The EntitySensorPrecision
|
|
indicates how many fractional digits are represented in the
|
|
associated EntitySensorValue object.
|
|
|
|
If the associated EntitySensorDataType object is equal to
|
|
'percentRH(9)', then an object of this type MUST contain a
|
|
number ranging from 0 to 100.
|
|
|
|
If the associated EntitySensorDataType object is equal to
|
|
'rpm(10)', then an object of this type MUST contain a number
|
|
ranging from -999,999,999 to +999,999,999.
|
|
|
|
If the associated EntitySensorDataType object is equal to
|
|
'truthvalue(12)', then an object of this type MUST contain
|
|
either the value 'true(1)' or the value 'false(2)'.
|
|
|
|
If the associated EntitySensorDataType object is equal to
|
|
'other(1)' or unknown(2)', then an object of this type MUST
|
|
contain a number ranging from -1000000000 to 1000000000."
|
|
SYNTAX Integer32 (-1000000000..1000000000)
|
|
|
|
EntitySensorStatus ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An object using this data type represents the operational
|
|
status of a physical sensor.
|
|
|
|
The value 'ok(1)' indicates that the agent can obtain the
|
|
sensor value.
|
|
|
|
The value 'unavailable(2)' indicates that the agent
|
|
presently cannot obtain the sensor value.
|
|
|
|
The value 'nonoperational(3)' indicates that the agent
|
|
believes the sensor is broken. The sensor could have a hard
|
|
failure (disconnected wire), or a soft failure such as out-
|
|
of-range, jittery, or wildly fluctuating readings."
|
|
SYNTAX INTEGER {
|
|
ok(1),
|
|
unavailable(2),
|
|
nonoperational(3)
|
|
}
|
|
|
|
EntitySensorAlarm ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This enumerated data type provides
|
|
information about alarm
|
|
Valid values are:
|
|
|
|
normal(3),
|
|
warning(4),
|
|
alert(5),
|
|
critical(6)
|
|
"
|
|
|
|
SYNTAX INTEGER {
|
|
other(1),
|
|
unknown(2),
|
|
normal(3),
|
|
warning(4),
|
|
alert(5),
|
|
critical(6),
|
|
NotPresent(7),
|
|
NotOperational(8),
|
|
unavailable(9)
|
|
}
|
|
|
|
EntityAdminStatus ::= TEXTUAL-CONVENTION
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This enumerated data type
|
|
provides adiministrative state
|
|
on(1)
|
|
off(0)"
|
|
SYNTAX INTEGER {
|
|
off(0),
|
|
on(1),
|
|
notApplicable(2)
|
|
}
|
|
|
|
--
|
|
-- Entity Sensor Table
|
|
--
|
|
|
|
entPhySensorTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF EntPhySensorEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains one row per physical sensor represented
|
|
by an associated row in the entPhysicalTable."
|
|
::= { entitySensorObjects 1 }
|
|
|
|
entPhySensorEntry OBJECT-TYPE
|
|
SYNTAX EntPhySensorEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Information about a particular physical sensor.
|
|
|
|
An entry in this table describes the present reading of a
|
|
sensor, the measurement units and scale, and sensor
|
|
operational status.
|
|
|
|
Entries are created in this table by the agent. An entry
|
|
for each physical sensor SHOULD be created at the same time
|
|
as the associated entPhysicalEntry. An entry SHOULD be
|
|
destroyed if the associated entPhysicalEntry is destroyed."
|
|
INDEX {entPhySensorIndex}
|
|
::= { entPhySensorTable 1 }
|
|
|
|
EntPhySensorEntry ::= SEQUENCE {
|
|
entPhySensorIndex Integer32,
|
|
entPhySensorType EntitySensorDataType,
|
|
entPhySensorScale EntitySensorDataScale,
|
|
entPhySensorPrecision EntitySensorPrecision,
|
|
entPhySensorValue EntitySensorValue,
|
|
entPhySensorOperStatus EntitySensorStatus,
|
|
entPhySensorUnitsDisplay SnmpAdminString,
|
|
entPhySensorValueTimeStamp TimeStamp,
|
|
entPhySensorValueUpdateRate Unsigned32,
|
|
entPhySensorDescr SnmpAdminString,
|
|
entPhySensorMin EntitySensorValue,
|
|
entPhySensorMax EntitySensorValue,
|
|
entPhySensorAlarm EntitySensorAlarm,
|
|
entPhySensorAdminStatus EntityAdminStatus
|
|
}
|
|
|
|
entPhySensorIndex OBJECT-TYPE
|
|
SYNTAX Integer32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Sensor Identifier"
|
|
::= { entPhySensorEntry 1 }
|
|
|
|
entPhySensorType OBJECT-TYPE
|
|
SYNTAX EntitySensorDataType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The type of data returned by the associated
|
|
entPhySensorValue object.
|
|
|
|
This object SHOULD be set by the agent during entry
|
|
creation, and the value SHOULD NOT change during operation."
|
|
::= { entPhySensorEntry 2 }
|
|
|
|
entPhySensorScale OBJECT-TYPE
|
|
SYNTAX EntitySensorDataScale
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The exponent to apply to values returned by the associated
|
|
entPhySensorValue object.
|
|
|
|
This object SHOULD be set by the agent during entry
|
|
creation, and the value SHOULD NOT change during operation."
|
|
::= { entPhySensorEntry 3 }
|
|
|
|
entPhySensorPrecision OBJECT-TYPE
|
|
SYNTAX EntitySensorPrecision
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The number of decimal places of precision in fixed-point
|
|
sensor values returned by the associated entPhySensorValue
|
|
object.
|
|
|
|
This object SHOULD be set to '0' when the associated
|
|
entPhySensorType value is not a fixed-point type: e.g.,
|
|
'percentRH(9)', 'rpm(10)', 'cmm(11)', or 'truthvalue(12)'.
|
|
|
|
This object SHOULD be set by the agent during entry
|
|
creation, and the value SHOULD NOT change during operation."
|
|
::= { entPhySensorEntry 4 }
|
|
|
|
entPhySensorValue OBJECT-TYPE
|
|
SYNTAX EntitySensorValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The most recent measurement obtained by the agent for this
|
|
sensor.
|
|
|
|
To correctly interpret the value of this object, the
|
|
associated entPhySensorType, entPhySensorScale, and
|
|
entPhySensorPrecision objects must also be examined."
|
|
::= { entPhySensorEntry 5 }
|
|
|
|
entPhySensorOperStatus OBJECT-TYPE
|
|
SYNTAX EntitySensorStatus
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The operational status of the sensor."
|
|
::= { entPhySensorEntry 6 }
|
|
|
|
entPhySensorUnitsDisplay OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A textual description of the data units that should be used
|
|
in the display of entPhySensorValue."
|
|
::= { entPhySensorEntry 7 }
|
|
|
|
entPhySensorValueTimeStamp OBJECT-TYPE
|
|
SYNTAX TimeStamp
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime at the time the status and/or value
|
|
of this sensor was last obtained by the agent."
|
|
::= { entPhySensorEntry 8 }
|
|
|
|
entPhySensorValueUpdateRate OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "milliseconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An indication of the frequency that the agent updates the
|
|
associated entPhySensorValue object, representing in
|
|
milliseconds.
|
|
|
|
The value zero indicates:
|
|
|
|
- the sensor value is updated on demand (e.g.,
|
|
when polled by the agent for a get-request),
|
|
- the sensor value is updated when the sensor
|
|
value changes (event-driven),
|
|
- the agent does not know the update rate.
|
|
"
|
|
::= { entPhySensorEntry 9 }
|
|
|
|
entPhySensorDescr OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A textual description of physical entity. This object
|
|
should contain a string that identifies the manufacturer's
|
|
name for the physical entity, and should be set to a
|
|
distinct value for each version or model of the physical
|
|
entity."
|
|
::= { entPhySensorEntry 10 }
|
|
|
|
entPhySensorMin OBJECT-TYPE
|
|
SYNTAX EntitySensorValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Minimum value expected of the sensor. Provided by
|
|
manufacturer"
|
|
::= { entPhySensorEntry 11 }
|
|
|
|
entPhySensorMax OBJECT-TYPE
|
|
SYNTAX EntitySensorValue
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Maximum value expected of the sensor. Provided by
|
|
manufacturer"
|
|
::= { entPhySensorEntry 12 }
|
|
|
|
entPhySensorAlarm OBJECT-TYPE
|
|
SYNTAX EntitySensorAlarm
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Sensor value translates into the levels of alarm"
|
|
::= { entPhySensorEntry 13 }
|
|
|
|
entPhySensorAdminStatus OBJECT-TYPE
|
|
SYNTAX EntityAdminStatus
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The Admin status of the sensor."
|
|
::= { entPhySensorEntry 14 }
|
|
|
|
END
|