Proprietary MIB Definition                                              
Internet Draft                                               S. Whitaker
Document: motorola-ptp-v2.txt                                   Motorola
Version: 5x400-09-02                           Tuesday 16th October 2007


                     Definitions of Managed Objects
            for the Motorola Point-to-Point Bridges - 400 Series

Status of this Memo

   This document is an Internet-Draft and is in full conformance with 
   all provisions of Section 10 of RFC 2026 except that the right to 
   produce derivative works is not granted. 

Abstract

   This memo defines a portion of the Management Information Base (MIB)
   for use with the Motorola Point-to-Point Bridges - 400 Series.

1.  The Network Management Framework

   Version 2 of the Internet-standard Network Management Framework consists
   of three components.  They are:

      STD 58, RFC 2578 [1] which defines Version 2 of the Structure of
      Management Information (SMIv2), the mechanisms used for
      describing and naming objects for the purpose of management.

      STD 58, RFC 2579 [2] which defines common MIB "Textual Conventions"
      to concisely convey the syntax and semantics of objects.

      STD 58, RFC 2580 which defines Conformance Statements and
      requirements for defining agent and manager capabilities.

   The Framework permits new objects to be defined for the purpose of
   experimentation and evaluation.

2.  Objects

   Managed objects are accessed via a virtual information store, termed
   the Management Information Base or MIB.  Objects in the MIB are
   defined using the subset of Abstract Syntax Notation One (ASN.1) [3,4]
   defined in the SMI.  In particular, each object is named by an OBJECT
   IDENTIFIER, an administratively assigned name, which specifies an
   object type.  The object type together with an object instance serves
   to uniquely identify a specific instantiation of the object.  For
   human convenience, we often use a textual string, termed the
   descriptor, to also refer to the object type.

2.1.  Format of Definitions

   Section 4 contains the specification of all object types contained in
   this MIB module.  The object types are defined using the conventions
   defined in the SMI, as amended by the extensions specified in [5,6].
 
S. Whitaker                                                     [Page 1]

RFC DRAFT                 Motorola PTP MIB               October 2007
 

3.  Overview

   The Motorola Point-to-Point Bridges - 400 Series uses advanced 
   wireless technology to provide non line of sight (NLOS) ethernet 
   communications.

3.1.  Structure of MIB

   Objects in this MIB are arranged into groups.  Each group is
   organized as a set of related objects.  The overall structure and
   assignment of objects to their groups is shown below.

   +-motorola
     |
     +-ptp
       |
       +-configuration
       | |
       | +-iPAddress
       | +-subnetMask
       | +-gatewayIPAddress
       | +-targetMACAddress
       | +-masterSlaveMode
       | +-maximumTransmitPower
       |
       +-licence
       | |
       | +-regionCode
       | +-productVariant
       | +-productName
       | +-ethernetFibreSupport
       | +-frequencyVariant
       |
       +-management
       | |
       | +-targetRange
       | +-rangingMode
       |
       +-phyControl
       | |
       | +-asymmetricTDD
       |
       +-phyStatus
       | |
       | +-receivePower
       | +-vectorError
       | +-transmitPower
       | +-range
       | +-linkLoss
       | +-receiveChannel
       | +-transmitChannel
       | +-receiveModulationMode
       | +-transmitModulationMode
       | +-receiveFreq
       | +-transmitFreq
       | +-signalStrengthRatio
       |
       +-reset
       | |
       | +-systemReset
       |
       +-versions
       | |
       | +-softwareVersion
       | +-hardwareVersion
       | +-secondarySoftwareVersion
       | +-bootVersion
       |
       +-pubStats
       | |
       | +-receiveDataRate
       | +-transmitDataRate
       | +-aggregateDataRate
       |
       +-encryption
       | |
       | +-encryptionAlgorithm
       |
 
3.1.1.  The configuration Group
 
   This mandatory group contains the objects which are applicable the 
   PTP unit configuration.  
 
3.1.2.  The licence Group
 
   This licence group contains a description of the system 
   capabilities that are controlled and managed via the 
   systems licence key  
 
3.1.3.  The management Group
 
    
 
3.1.4.  The phyControl Group
 
   The PHY control group contains a description of the attributes that 
   control the behaviour and performance of the wireless links 
   physical layer  
 
3.1.5.  The phyStatus Group
 
   This mandatory group contains the objects which are applicable the 
   PTP units' wireless physical layer operational parameters  
 
3.1.6.  The reset Group
 
   This mandatory group contains the objects which are applicable the 
   PTP units' reset information.  
 
3.1.7.  The versions Group
 
   This mandatory group contains the objects which are applicable the 
   PTP units' version information.  
 
3.1.8.  The pubStats Group
 
   This group contains the objects which are applicable the PTP units' 
   operational statistics.  
 
3.1.9.  The encryption Group
 
    

3.2.  Textual Conventions

   The datatypes, MacAddress, BridgeId and Timeout, are used as textual
   conventions in this document.  These textual conventions have NO
   effect on either the syntax nor the semantics of any managed object.
   Objects defined using these conventions are always encoded by means
   of the rules that define their primitive type.  Hence, no changes to
   the SMI or the SNMP are necessary to accommodate these textual
   conventions which are adopted merely for the convenience of readers.

4.  Definitions

   MOTOROLA-PTP-MIB DEFINITIONS ::= BEGIN

   IMPORTS
      MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
      Integer32, IpAddress,
      enterprises
         FROM SNMPv2-SMI
      MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
         FROM SNMPv2-CONF
      DisplayString
         FROM SNMPv2-TC;

   motorola MODULE-IDENTITY
      LAST-UPDATED "200710161052Z"
      ORGANIZATION "Motorola"
      CONTACT-INFO
         "Post:  Simon Whitaker
                 Motorola
                 Point to Point Wireless Solutions Group,
                 Unit A1,
                 Linhay Business Park,
                 Eastern Road,
                 Ashburton,
                 Devon.
                 TQ13 7UP
                 United Kingdom
         Phone:  +44 (0) 1364 655 500
         Email:  simon.whitaker@motorola.com"
      DESCRIPTION
         "MIB for 60Mbps non-line-of-sight (NLOS) wireless ethernet bridge."
      REVISION "200710161052Z"
      DESCRIPTION "Converted to SMIv2."
      ::= { enterprises 17713 }

 
   -- Groups in motorola 
   ptp                OBJECT IDENTIFIER ::= { motorola 1 }
   ptmp               OBJECT IDENTIFIER ::= { motorola 2 }

   -- Groups in ptp
   configuration      OBJECT IDENTIFIER ::= { ptp 5 }
   licence            OBJECT IDENTIFIER ::= { ptp 8 }
   management         OBJECT IDENTIFIER ::= { ptp 9 }
   phyControl         OBJECT IDENTIFIER ::= { ptp 10 }
   phyStatus          OBJECT IDENTIFIER ::= { ptp 12 }
   reset              OBJECT IDENTIFIER ::= { ptp 18 }
   versions           OBJECT IDENTIFIER ::= { ptp 19 }
   pubStats           OBJECT IDENTIFIER ::= { ptp 20 }
   encryption         OBJECT IDENTIFIER ::= { ptp 22 }
   ptpGroups          OBJECT IDENTIFIER ::= { ptp 98 }
   ptpTraps           OBJECT IDENTIFIER ::= { ptp 99 }
   ptpTrapPrefix      OBJECT IDENTIFIER ::= { ptpTraps 0 }

   -- Compliance information
   --
   ptpCompliance MODULE-COMPLIANCE
      STATUS current
      DESCRIPTION
         "The compliance statement for the Motorola PTP MIB"
      MODULE -- this module
         MANDATORY-GROUPS { configurationGroup
                          , licenceGroup
                          , managementGroup
                          , phyControlGroup
                          , phyStatusGroup
                          , resetGroup
                          , versionsGroup
                          , pubStatsGroup
                          , encryptionGroup
                          , notificationsGroup
                          } 
         ::= { ptp 97 }

   configurationGroup OBJECT-GROUP
      OBJECTS { iPAddress
              , subnetMask
              , gatewayIPAddress
              , targetMACAddress
              , masterSlaveMode
              , maximumTransmitPower
              }
      STATUS  current
      DESCRIPTION "The configuration object group."
      ::= { ptpGroups 5 }

   licenceGroup OBJECT-GROUP
      OBJECTS { regionCode
              , productVariant
              , productName
              , ethernetFibreSupport
              , frequencyVariant
              }
      STATUS  current
      DESCRIPTION "The licence object group."
      ::= { ptpGroups 8 }

   managementGroup OBJECT-GROUP
      OBJECTS { targetRange
              , rangingMode
              }
      STATUS  current
      DESCRIPTION "The management object group."
      ::= { ptpGroups 9 }

   phyControlGroup OBJECT-GROUP
      OBJECTS { asymmetricTDD
              }
      STATUS  current
      DESCRIPTION "The phyControl object group."
      ::= { ptpGroups 10 }

   phyStatusGroup OBJECT-GROUP
      OBJECTS { receivePower
              , vectorError
              , transmitPower
              , range
              , linkLoss
              , receiveChannel
              , transmitChannel
              , receiveModulationMode
              , transmitModulationMode
              , receiveFreq
              , transmitFreq
              , signalStrengthRatio
              }
      STATUS  current
      DESCRIPTION "The phyStatus object group."
      ::= { ptpGroups 12 }

   resetGroup OBJECT-GROUP
      OBJECTS { systemReset
              }
      STATUS  current
      DESCRIPTION "The reset object group."
      ::= { ptpGroups 18 }

   versionsGroup OBJECT-GROUP
      OBJECTS { softwareVersion
              , hardwareVersion
              , secondarySoftwareVersion
              , bootVersion
              }
      STATUS  current
      DESCRIPTION "The versions object group."
      ::= { ptpGroups 19 }

   pubStatsGroup OBJECT-GROUP
      OBJECTS { receiveDataRate
              , transmitDataRate
              , aggregateDataRate
              }
      STATUS  current
      DESCRIPTION "The pubStats object group."
      ::= { ptpGroups 20 }

   encryptionGroup OBJECT-GROUP
      OBJECTS { encryptionAlgorithm
              }
      STATUS  current
      DESCRIPTION "The encryption object group."
      ::= { ptpGroups 22 }

   notificationsGroup NOTIFICATION-GROUP
      NOTIFICATIONS { dfsChannelChangeTrap
                    , dfsImpulsiveInterferenceTrap
                    }
      STATUS current
      DESCRIPTION "The notifications group."
      ::= { ptpGroups 99 }

   -- Configuration group attribute definitions 
   --
   iPAddress OBJECT-TYPE
      SYNTAX IpAddress
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Internet protocol (IP) address. This address is used by 
             the family of Internet protocols to uniquely this 
             identify the unit on a network"  
      ::= { configuration 1 } 
 
   subnetMask OBJECT-TYPE
      SYNTAX IpAddress
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "A subnet allows the flow of network traffic between 
             hosts to be segregated based on a network 
             configuration. By organizing hosts into 
             logical groups, subnetting can improve network 
             security and performance"  
      ::= { configuration 2 } 
 
   gatewayIPAddress OBJECT-TYPE
      SYNTAX IpAddress
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "The IP address of a computer on the current network that 
             is currently acting as a network gateway. A gateway 
             acts as an entrance / exit to packets from / to 
             other networks"  
      ::= { configuration 3 } 
 
   targetMACAddress OBJECT-TYPE
      SYNTAX OCTET STRING (SIZE(6))
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "MAC address of the PTP wireless unit forming the other 
             end of the PTP link"  
      ::= { configuration 4 } 
 
   masterSlaveMode OBJECT-TYPE
      SYNTAX INTEGER {
                       master(0),
                       slave(1)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "The PTP wireless link operates using a master and slave 
             relationship"  
      ::= { configuration 5 } 
 
   maximumTransmitPower OBJECT-TYPE
      SYNTAX INTEGER (-15..25)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Maximum transmit power the wireless unit is permitted to 
             use when establishing and maintaining the wireless 
             link"  
      ::= { configuration 6 } 
 
   -- Licence group attribute definitions 
   --
   regionCode OBJECT-TYPE
      SYNTAX INTEGER (0..31)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "The region code prohibits the wireless unit from 
             operating outside the regulated limits"  
      ::= { licence 1 } 
 
   productVariant OBJECT-TYPE
      SYNTAX INTEGER {
                       motorolaPTPxx400Full(0),
                       motorolaPTPxx400Deprecated1(1),
                       motorolaPTPxx400Deprecated2(2),
                       motorolaPTPxx400Lite(3),
                       spare1(4),
                       spare2(5),
                       spare3(6),
                       spare4(7),
                       spare5(8),
                       spare6(9),
                       spare7(10),
                       motorolaPTPxx600Lite(11),
                       motorolaPTPxx600Full(12)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "The product variant"  
      ::= { licence 2 } 
 
   productName OBJECT-TYPE
      SYNTAX DisplayString (SIZE(0..255))
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Name of the product variant"  
      ::= { licence 3 } 
 
   ethernetFibreSupport OBJECT-TYPE
      SYNTAX INTEGER {
                       disabled(0),
                       enabled(1)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Gigabit Ethernet fibre support"  
      ::= { licence 4 } 
 
   frequencyVariant OBJECT-TYPE
      SYNTAX INTEGER {
                       freq5800MHz(0),
                       freq5400MHz(1),
                       freq4900MHz(2)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Frequency variant of the wireless unit"  
      ::= { licence 5 } 
 
   -- Management group attribute definitions 
   --
   targetRange OBJECT-TYPE
      SYNTAX INTEGER (0..2000)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Initial target range used in installation +/-1, 
             expressed in tenths of a kilometer. When 
             Auto-Ranging this must be set to 0"  
      ::= { management 1 } 
 
   rangingMode OBJECT-TYPE
      SYNTAX INTEGER {
                       auto0to5km(0),
                       auto0to40km(1),
                       auto0to100km(2),
                       auto0to200km(3),
                       targetRange(4)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Type of ranging to use during installation, either 
             Auto-Ranging or use a selectable Target 
             Range"  
      ::= { management 2 } 
 
   -- PhyControl group attribute definitions 
   --
   asymmetricTDD OBJECT-TYPE
      SYNTAX INTEGER {
                       symmetricDataRate1to1(0),
                       asymmetricDataRate2to1(1),
                       prohibited(2),
                       latencyOptimised(3)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Control TDD Structure"  
      ::= { phyControl 1 } 
 
   -- PhyStatus group attribute definitions 
   --
   receivePower OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Receive power expressed in tenths of a dBm"  
      ::= { phyStatus 1 } 
 
   vectorError OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "The vector error measurement compares the received 
             signal's IQ modulation characteristics to an 
             ideal signal to determine the composite error 
             vector magnitude. The value represented by this 
             attribute is the average vector error over the 
             previous second expressed in tenths of a dB"  
      ::= { phyStatus 2 } 
 
   transmitPower OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Transmit power expressed in tenths of a dBm"  
      ::= { phyStatus 3 } 
 
   range OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Distance between the two peer wireless units expressed 
             in tenths of a kilometer"  
      ::= { phyStatus 4 } 
 
   linkLoss OBJECT-TYPE
      SYNTAX INTEGER (-500..500)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "The wireless link loss expressed in tenths of a dB"  
      ::= { phyStatus 5 } 
 
   receiveChannel OBJECT-TYPE
      SYNTAX INTEGER (0..21)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Current active receive channel"  
      ::= { phyStatus 6 } 
 
   transmitChannel OBJECT-TYPE
      SYNTAX INTEGER (0..21)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Current active transmit channel"  
      ::= { phyStatus 7 } 
 
   receiveModulationMode OBJECT-TYPE
      SYNTAX INTEGER {
                       modAcquisition(0),
                       modBPSK50percent(1),
                       modQPSK50percent(2),
                       modQPSK67percent(3),
                       mod16QAM50percent(4),
                       mod16QAM75percent(5),
                       mod64QAM67percent(6),
                       mod64QAM75percent(7),
                       mod64QAM88percent(8)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Current active receive modulation mode"  
      ::= { phyStatus 8 } 
 
   transmitModulationMode OBJECT-TYPE
      SYNTAX INTEGER {
                       modAcquisition(0),
                       modBPSK50percent(1),
                       modQPSK50percent(2),
                       modQPSK67percent(3),
                       mod16QAM50percent(4),
                       mod16QAM75percent(5),
                       mod64QAM67percent(6),
                       mod64QAM75percent(7),
                       mod64QAM88percent(8)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Current active transmit modulation mode"  
      ::= { phyStatus 9 } 
 
   receiveFreq OBJECT-TYPE
      SYNTAX INTEGER (0..5875)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Current receive frequency expressed in MHz"  
      ::= { phyStatus 11 } 
 
   transmitFreq OBJECT-TYPE
      SYNTAX INTEGER (0..5875)
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Current transmit frequency expressed in MHz"  
      ::= { phyStatus 12 } 
 
   signalStrengthRatio OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Signal strength ratio (Vertical / Horizontal) expressed 
             in tenths of a dB"  
      ::= { phyStatus 13 } 
 
   -- Reset group attribute definitions 
   --
   systemReset OBJECT-TYPE
      SYNTAX INTEGER {
                       running(0),
                       consoleReboot(1)
                     }
      MAX-ACCESS read-write
      STATUS current
      DESCRIPTION
             "Setting this attribute to '1' will cause a system 
             reboot"  
      ::= { reset 1 } 
 
   -- Versions group attribute definitions 
   --
   softwareVersion OBJECT-TYPE
      SYNTAX DisplayString (SIZE(0..255))
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Current software version"  
      ::= { versions 1 } 
 
   hardwareVersion OBJECT-TYPE
      SYNTAX DisplayString (SIZE(0..255))
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Hardware platform version"  
      ::= { versions 2 } 
 
   secondarySoftwareVersion OBJECT-TYPE
      SYNTAX DisplayString (SIZE(0..255))
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Secondary software version, used when the primary 
             software image is invalid or erased"  
      ::= { versions 3 } 
 
   bootVersion OBJECT-TYPE
      SYNTAX DisplayString (SIZE(0..255))
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Boot code software version"  
      ::= { versions 4 } 
 
   -- PubStats group attribute definitions 
   --
   receiveDataRate OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Average data rate over the last one second interval 
             expressed in kbps"  
      ::= { pubStats 1 } 
 
   transmitDataRate OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Average data rate over the last one second interval 
             expressed in kbps"  
      ::= { pubStats 2 } 
 
   aggregateDataRate OBJECT-TYPE
      SYNTAX Integer32
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "Average data rate over the last one second interval 
             expressed in kbps"  
      ::= { pubStats 3 } 
 
   -- Encryption group attribute definitions 
   --
   encryptionAlgorithm OBJECT-TYPE
      SYNTAX INTEGER {
                       none(0),
                       aESRijndael(1),
                       aES256bitRijndael(2)
                     }
      MAX-ACCESS read-only
      STATUS current
      DESCRIPTION
             "The Encryption Algorithm used by the wireless link. You 
             should be aware that enabling encryption results 
             in a reduction in available data bandwidth N.B. The 
             same Encryption Algorithm must be configured at BOTH 
             ends of the link for it to function correctly"  
      ::= { encryption 1 } 
 
   -- Enterprise NOTIFICATION definitions
   --

   dfsChannelChangeTrap NOTIFICATION-TYPE
      OBJECTS { receiveChannel }
      STATUS current
      DESCRIPTION "DFS channel change event"
      ::= { ptpTrapPrefix 1 }

   dfsImpulsiveInterferenceTrap NOTIFICATION-TYPE
      OBJECTS { receiveChannel }
      STATUS current
      DESCRIPTION "DFS impulsive interference detected event"
      ::= { ptpTrapPrefix 2 }
   END


5.  References

   [1] McCloghrie, K., Perkins, D. and J. Schoenwaelder,
       "Structure of Management Information Version 2 (SMIv2)",
       RFC 2578, STD 58, April 1999.

   [2] McCloghrie, K., Perkins, D. and J. Schoenwaelder,
       "Textual Conventions for SMIv2", STD 58, RFC 2579, April
       1999.

   [3] Information processing systems - Open Systems Interconnection -
       Specification of Abstract Syntax Notation One (ASN.1),
       International Organization for Standardization, International
       Standard 8824, December 1987.

   [4] Information processing systems - Open Systems Interconnection -
       Specification of Basic Encoding Rules for Abstract Notation One
       (ASN.1), International Organization for Standardization,
       International Standard 8825, December 1987.

   [5] ANSI/IEEE Standard 802.1D-1990 MAC Bridges, IEEE Project 802
       Local and Metropolitan Area Networks, (March 8, 1991).

   [6] Frye, R., Levi, D., Routhier, S., Wijnen, B.,
       "Coexistence between Version 1, Version 2, and Version 3
       of the Internet-standard Network Management Framework",
       RFC 3584, August 2003.
 
S. Whitaker                                                     [Page 2]

RFC DRAFT                 Motorola PTP MIB               October 2007
 

6.  Security Considerations

   Security issues are not discussed in this memo.

7.  Authors' Addresses

   Simon Whitaker
   Motorola
   Point to Point Wireless Solutions Group,
   Unit A1,
   Linhay Business Park,
   Eastern Road,
   Ashburton,
   Devon.
   TQ13 7UP
   United Kingdom

   Phone: +44 (0) 1364 655 500
   Email: simon.whitaker@motorola.com