-- =============================================================== -- Copyright (C) 2005 Paradyne Corporation. -- =============================================================== PDN-ADSL-SELT-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Integer32, Unsigned32 FROM SNMPv2-SMI OBJECT-GROUP, MODULE-COMPLIANCE FROM SNMPv2-CONF TEXTUAL-CONVENTION FROM SNMPv2-TC ifIndex FROM IF-MIB pdn-interfaces FROM PDN-HEADER-MIB; pdnAdslSeltMIB MODULE-IDENTITY LAST-UPDATED "200403280000Z" -- March 28, 2005 ORGANIZATION "Paradyne Networks MIB Working Group Other information about group editing the MIB" CONTACT-INFO "Paradyne Networks, Inc. 8545 126th Avenue North Largo, FL 33733 www.paradyne.com General Comments to: mibwg_team@paradyne.com Editors Jesus Pinto, Clay Sikes" DESCRIPTION "This MIB module defines a portion of the management information base (MIB) for managing configuration and monitoring results of SELT (Single Ended Line Test) tests over ADSL interfaces. At the time this MIB was defined, the IETF ADSL MIB Working does not have any work on the 'standard' MIBs planned and/or has not produced a schedule to address G.SELT needs. As a result, these objects may be a `temporary' solution until MIBs/Objects are defined meet the needs of ADSL SELT testing. ===================================================================== == == == Copyright (C) 2005 Paradyne Corporation. == == == =====================================================================" REVISION "200503280000Z" -- March 28, 2005 DESCRIPTION "Added clearResults(4) to pdnAdslSeltCmd to allow an entry in the pdnAdslSeltLcTable or the pdnAdslSeltLnfTable to be removed. Added resultsCleared(5) to pdnAdslSeltStatus to indicate that clearResults(4) have been executed." REVISION "200503100000Z" -- March 10, 2005 DESCRIPTION "Added notStarted(4) to pdnAdslSeltStatus. This solves the problem of what to return when the pdnAdslSeltTable is walked prior to a test being run on an interface." REVISION "200412020000Z" -- Dec 02, 2004 DESCRIPTION "Initial release." ::= { pdn-interfaces 31 } -- -- Define groups for Notifications, MIB Objects, Accessible for -- Notifications (AFNs), and Conformance. -- These may just be place holders. -- pdnAdslSeltNotifications OBJECT IDENTIFIER ::= { pdnAdslSeltMIB 0 } pdnAdslSeltObjects OBJECT IDENTIFIER ::= { pdnAdslSeltMIB 1 } pdnAdslSeltAFNs OBJECT IDENTIFIER ::= { pdnAdslSeltMIB 2 } pdnAdslSeltConformance OBJECT IDENTIFIER ::= { pdnAdslSeltMIB 3 } -- ============================================================================= -- == Textual Conventions == -- ============================================================================= PdnSeltTypes ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This textual convention defines the SELT test types available for configuration." SYNTAX INTEGER { loopCharacterization (1), -- Loop Characterization loopNoiseFloor (2) -- Loop noise floor } -- ============================================================================= -- == MIB Objects == -- ============================================================================= pdnAdslSeltWireSize OBJECT-TYPE SYNTAX INTEGER { awg (1), -- AWG metric (2), -- Metric metricJapan (3) -- Metric Japan } MAX-ACCESS read-write STATUS current DESCRIPTION "This object permits the selection of the metric unit to be used when reporting SELT test results. (i.e for AWG results are in feet and for metric/metricJapan results are in meters). This configuration parameter applies to all the SELT tests run in the device. " ::= { pdnAdslSeltObjects 1 } -- ================================================= -- == G.Selt (Single Ended Line Test) Configuration -- == -- == This section defines the tables requires to -- == support the SELT feature in the system. -- == -- == For now, we require Loop Characterization and -- == Loop Noise Floor Measurement Tests. Both tests -- == types can be started/stopped via a common table -- == described below -- -- ================================================ pdnAdslSeltTable OBJECT-TYPE SYNTAX SEQUENCE OF PdnAdslSeltEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table allows initiation/termination of SELT Tests." ::= { pdnAdslSeltObjects 2 } pdnAdslSeltEntry OBJECT-TYPE SYNTAX PdnAdslSeltEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry represents an instance of a SELT test currently running or ever run (since last system reset) on an ADSL interface. There should be entries in this table for every active running tests and test that are in the process of being stopped or have terminated already. There should be no entries for ADSL interfaces that have not run a test since last since reset; thus, the agent should return NO_SUCH_NAME for those cases. " INDEX { ifIndex, pdnAdslSeltType } ::= { pdnAdslSeltTable 1 } PdnAdslSeltEntry ::= SEQUENCE { pdnAdslSeltType PdnSeltTypes, pdnAdslSeltCmd INTEGER, pdnAdslSeltStatus INTEGER, pdnAdslSeltDuration Unsigned32, pdnAdslSeltTimeLeft Unsigned32 } pdnAdslSeltType OBJECT-TYPE SYNTAX PdnSeltTypes MAX-ACCESS not-accessible STATUS current DESCRIPTION "This object is used to specify the SELT test type that will be initiated. If a SELT Test is already running on the ADSL interface, writing to this object is prohibited by the agent until the previous test is completed or terminated. " ::= { pdnAdslSeltEntry 1 } pdnAdslSeltCmd OBJECT-TYPE SYNTAX INTEGER { noOp (1), -- used when reading the object start (2), -- start test stop (3), -- stop an initiated test clearResults (4) -- clears the results for the -- pdnAdslSeltType } MAX-ACCESS read-write STATUS current DESCRIPTION "This object corresponds to the list of test operations that can be performed. The possible values are noOp(1), start(2), stop(3), or clearResults(4). Reading this object will always return the value 'noOp (1)'. If SELT test is already running on an ADSL interface, the only possible test command is 'stop (1)'. The clearResults(4) command clears test results by removing and entry in the pdnAdslSeltLcTable or the pdnAdslSeltLnfTable. After the execution of this command, the appropriate value for pdnAdslSeltStatus would be resultsCleared(5). " ::= { pdnAdslSeltEntry 2 } pdnAdslSeltStatus OBJECT-TYPE SYNTAX INTEGER { inProgress (1), stoppedInProgress (2), complete (3), notStarted (4), resultsCleared (5) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object provides status about any SELT test running or ever run (since last reset) on an ADSL interface. This object can be read by NMS managers to determine the status of a test; that is: inProgress (1) - if the test is currently running. stoppedInProgress (2) - if a request to stop the test is still in progress. complete (3) - if the test has been run at least once since system reset and has completed. notStarted (4) - if the test has not been run on this interface since last system reset. resultsCleared (5) - if the entry in the test results table, Lc or Lnf, was removed as the result of the execution of the clearResults(4) pdnAdslSeltCmd. " ::= { pdnAdslSeltEntry 3 } pdnAdslSeltDuration OBJECT-TYPE SYNTAX Unsigned32 UNITS "seconds" MAX-ACCESS read-write STATUS current DESCRIPTION "This object provides the approximate time in Seconds that the SELT test measurement will take. This object should return 0 if no test is actively running on the ADSL interface specified. " ::= { pdnAdslSeltEntry 4 } pdnAdslSeltTimeLeft OBJECT-TYPE SYNTAX Unsigned32 UNITS "seconds" MAX-ACCESS read-only STATUS current DESCRIPTION "This object provides the approximate time left in Seconds for the test running on this ADSL interface. This object should return 0 if no test is actively running on the ADSL interface specified. " ::= { pdnAdslSeltEntry 5 } -- ================================================= -- == G.Selt (Single Ended Line Test) Results -- == -- == LOOP CHARACTERIZATION (Lc) Results Table -- == -- == This table is used to post results from an -- == initiated Loop Characterization test. -- -- ================================================ pdnAdslSeltLcTable OBJECT-TYPE SYNTAX SEQUENCE OF PdnAdslSeltLcEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table post results for loop characterization tests completed. " ::= { pdnAdslSeltObjects 3 } pdnAdslSeltLcEntry OBJECT-TYPE SYNTAX PdnAdslSeltLcEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry represents the results of a loop characterization test performed over an ADSL interface. " INDEX { ifIndex, pdnAdslSeltLcSegmentIndex } ::= { pdnAdslSeltLcTable 1 } PdnAdslSeltLcEntry ::= SEQUENCE { pdnAdslSeltLcSegmentIndex Integer32, pdnAdslSeltLcSegmentLength Integer32, pdnAdslSeltLcSegmentGauge INTEGER, pdnAdslSeltLcSegmentType INTEGER } pdnAdslSeltLcSegmentIndex OBJECT-TYPE SYNTAX Integer32(0..9) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This object indicates the index of the segment being reported. From no segments to a possible of 10 segments could be identified in the loop topology. " ::= { pdnAdslSeltLcEntry 1 } pdnAdslSeltLcSegmentLength OBJECT-TYPE SYNTAX Integer32(0..65534) MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates an estimate of the segment Length being reported " ::= { pdnAdslSeltLcEntry 2 } pdnAdslSeltLcSegmentGauge OBJECT-TYPE SYNTAX INTEGER { unknown (1), --AWG-- awg26 (2), awg24 (3), awg22 (4), awg19 (5), --Metric-- metric32 (10), -- (0.32mm) metric40 (11), -- (0.40mm) metric50 (12), -- (0.50mm) metric63 (13), -- (0.63mm) metric90 (14), -- (0.90mm) --Metric/Japan-- metricJapan32 (20), -- (0.32mm) metricJapan40 (21), -- (0.40mm) metricJapan50 (22), -- (0.50mm) metricJapan65 (23), -- (0.65mm) metricJapan90 (24) -- (0.90mm) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the estimated Gauge of the segment being reported. The gauge reported back is based on the pdnAdslSeltWireSizeWireSize configuration parameter passed when the test is started. " ::= { pdnAdslSeltLcEntry 3 } pdnAdslSeltLcSegmentType OBJECT-TYPE SYNTAX INTEGER { notPresent (1), inline (2), bridgeTap (3) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the segment type being reported. " ::= { pdnAdslSeltLcEntry 4 } -- ================================================= -- == G.Selt (Single Ended Line Test) Results -- == -- == LOOP NOISE FLOOR (Lnf) Results Table -- == -- == This table is used to post results from an -- == initiated Loop Noise Floor test. -- -- ================================================ pdnAdslSeltLnfTable OBJECT-TYPE SYNTAX SEQUENCE OF PdnAdslSeltLnfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table post results for loop noise floor tests completed. " ::= { pdnAdslSeltObjects 4 } pdnAdslSeltLnfEntry OBJECT-TYPE SYNTAX PdnAdslSeltLnfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry represents the results of a Loop Noise Floor test performed over an ADSL interface. " INDEX { ifIndex, pdnAdslSeltLnfSubCarrierIndex } ::= { pdnAdslSeltLnfTable 1 } PdnAdslSeltLnfEntry ::= SEQUENCE { pdnAdslSeltLnfSubCarrierIndex Integer32, pdnAdslSeltLnfPeakPsd Integer32, pdnAdslSeltLnfTotalPsd Integer32, pdnAdslSeltLnfSignalPsd Integer32 } pdnAdslSeltLnfSubCarrierIndex OBJECT-TYPE SYNTAX Integer32(0..63) MAX-ACCESS not-accessible STATUS current DESCRIPTION "Identifies a row in the table based on a subcarrier. The subcarrier index ranges from 0 to NSCus-1 (NSC is Number of Subcarriers) as specified in G.997.1 where NSCus is the higher subcarrier that can be transmitted in the upstream direction. Please refer to the corresponding ITU recommendation for specific values of NSCus. The `ADSL Values for NSC' comment above lists those recommendations." ::= { pdnAdslSeltLnfEntry 1 } pdnAdslSeltLnfPeakPsd OBJECT-TYPE SYNTAX Integer32(0..65534) MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the peak Psd of the tone indicated by the sub-carrier index. The value returned by the agent for this object is expressed in units of 1/256 dBm. " ::= { pdnAdslSeltLnfEntry 2 } pdnAdslSeltLnfTotalPsd OBJECT-TYPE SYNTAX Integer32(0..65534) MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the total Psd of the tone indicated by the sub-carrier index. The value returned by the agent for this object is expressed in units of 1/256 dBm. " ::= { pdnAdslSeltLnfEntry 3 } pdnAdslSeltLnfSignalPsd OBJECT-TYPE SYNTAX Integer32(0..65534) MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the signal Psd of the tone indicated by the sub-carrier index. The value returned by the agent for this object is expressed in units of 1/256 dBm. " ::= { pdnAdslSeltLnfEntry 4 } -- ============================================================================= -- == Accessible for Notifications (AFNs) == -- ============================================================================= -- None defined -- ============================================================================= -- == Traps/Notifications == -- ============================================================================= -- None defined -- ============================================================================= -- == Conformance Information == -- ============================================================================= pdnAdslSeltCompliances OBJECT IDENTIFIER ::= { pdnAdslSeltConformance 1 } pdnAdslSeltGroups OBJECT IDENTIFIER ::= { pdnAdslSeltConformance 2 } -- =========================== -- == Compliance Statements == -- =========================== pdnAdslSeltMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for the entities which implement the pdnAdslSeltMIB." MODULE -- this module -- No mandatory groups are specified GROUP pdnAdslSeltGroup DESCRIPTION "The group associates the objects related to the configuration of SELT tests in General." GROUP pdnAdslSeltLcGroup DESCRIPTION "The group associates the objects related to the results of a Loop characterization SELT test." GROUP pdnAdslSeltLnfGroup DESCRIPTION "The group associates the objects related to the results of a Loop Noise Floor SELT test." -- All objects, if implemented, are expected to be implemented to the -- maximal level as specified in their OBJECT-TYPE macro. -- ::= { pdnAdslSeltCompliances 1 } -- ========================== -- == Units of Conformance == -- ========================== pdnAdslSeltObjGroups OBJECT IDENTIFIER ::= { pdnAdslSeltGroups 1 } pdnAdslSeltAfnGroups OBJECT IDENTIFIER ::= { pdnAdslSeltGroups 2 } pdnAdslSeltNtfyGroups OBJECT IDENTIFIER ::= { pdnAdslSeltGroups 3 } -- =================== -- == Object Groups == -- =================== pdnAdslSeltGroup OBJECT-GROUP OBJECTS { pdnAdslSeltCmd, pdnAdslSeltStatus, pdnAdslSeltWireSize, pdnAdslSeltDuration, pdnAdslSeltTimeLeft } STATUS current DESCRIPTION "General configuration of SELT tests." ::= { pdnAdslSeltObjGroups 1 } pdnAdslSeltLcGroup OBJECT-GROUP OBJECTS { pdnAdslSeltLcSegmentLength, pdnAdslSeltLcSegmentGauge, pdnAdslSeltLcSegmentType } STATUS current DESCRIPTION "Objects related to results posted for Loop Characterization Test." ::= { pdnAdslSeltObjGroups 2 } pdnAdslSeltLnfGroup OBJECT-GROUP OBJECTS { pdnAdslSeltLnfPeakPsd, pdnAdslSeltLnfTotalPsd, pdnAdslSeltLnfSignalPsd } STATUS current DESCRIPTION "Objects related to results posted for Loop Signal Floor Test." ::= { pdnAdslSeltObjGroups 3 } -- ================================== -- == Accessible for Notify Groups == -- ================================== -- None. -- ========================= -- == Notification Groups == -- ========================= -- None. -- ========= -- == END == -- ========= END