TN-PTP-MIB

All MIBs › TN-PTP-MIB

Organization: Transition Networks, Inc.

Last Updated: 2013-11-11

Category: Time and NTP, Transition Networks Media Converters

Description: Manages Transition Networks IEEE 1588 PTP clock configuration, port state, and synchronization.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is TN-PTP-MIB?

This is a Transition Networks proprietary MIB for managing IEEE 1588 Precision Time Protocol (PTP) clock configuration and synchronization on their media-conversion/networking devices. It exposes clock mode configuration, per-port input/output timing state and frequency settings, actual measured input/output frequencies, and clock creation/configuration parameters. Its monitoring focus is on the hardware synchronization status of the device's timing ports: comparing configured versus actual input/output frequencies (tnPtpInFreq/tnPtpActualInFreq and tnPtpOutFreq/tnPtpActualOutFreq) reveals whether a port has achieved lock or is drifting, and tnPtpInState/tnPtpOutState show whether ports are actively synchronized. It implements the IEEE 1588 PTP standard, so it is conceptually dependent on that specification even though objects are vendor-specific. It is deployed on Transition Networks PTP-capable switches/media converters used to distribute precise time across telecom or industrial networks. Engineers can download the TN-PTP-MIB file directly to load it into their MIB browser.

IPNetwork Monitor allows you to monitor SNMP objects defined in TN-PTP-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Transition Networks PTP switch/media converter

Monitoring Examples

An administrator would poll tnPtpClkModesTable/tnPtpClkModesEntry alongside tnPtpInState and tnPtpOutState to confirm a clock port is in its expected synchronization mode, and compare tnPtpActualInFreq/tnPtpActualOutFreq against the configured tnPtpInFreq/tnPtpOutFreq to detect frequency drift. A mismatch between actual and configured frequency, or a port state reporting unlocked/free-run when lock is expected, would indicate a PTP synchronization failure needing investigation. The tnPtpCreateClkConfTable/tnPtpCreateClkConfEntry rows show how each clock instance was provisioned, useful for confirming configuration intent.

What Can Be Monitored

clock mode configuration
input/output synchronization state
configured vs. actual input/output frequency
clock impedance setting
clock instance configuration

Imported Objects

From ENTITY-MIB

entPhysicalIndex

OBJECT-TYPE

From INET-ADDRESS-MIB

InetAddress
InetAddressType
MODULE-IDENTITY
OBJECT-IDENTITY

From SNMPv2-TC

RowStatus
TruthValue

From TRANSITION-SMI

tnProducts

OBJECT-IDENTITY

OIDs

OID symbolic	OID numeric	Type	Access	Description
tnPtp	1.3.6.1.4.1.868.2.5.123.1
INT tnPtpActualInFreq	1.3.6.1.4.1.868.2.5.123.1.1.1.6	INTEGER	read-only	The actual input frequency in Hz.
INT tnPtpActualOutFreq	1.3.6.1.4.1.868.2.5.123.1.1.1.7	INTEGER	read-only	The actual output frequency in Hz. If output state is disabled set to 0
INT tnPtpAdjustMethod	1.3.6.1.4.1.868.2.5.123.1.3.1.7	INTEGER	read-only	Shows the actual clock adjustment method. The method depends on the available hardware.
INT tnPtpAnv	1.3.6.1.4.1.868.2.5.123.1.7.1.6	INTEGER	read-create	The interval for issuing announce messages in master state. [-3..4]
INT tnPtpATO	1.3.6.1.4.1.868.2.5.123.1.7.1.7	INTEGER	read-create	The timeout for receiving announce messages on the port. [-1..10]
tnPtpClkConf0Entry	1.3.6.1.4.1.868.2.5.123.1.3.1		not-accessible	An entry in the table,tnPtpClkConf0Table
INT tnPtpClkConf0Index	1.3.6.1.4.1.868.2.5.123.1.3.1.1	INTEGER	read-only	Indicates the Instance of a particular Clock Instance [0..CLOCK_INST_MAX].
tnPtpClkConf0Table	1.3.6.1.4.1.868.2.5.123.1.3		not-accessible	Table of PTP ClkInstance
tnPtpClkConf2Entry	1.3.6.1.4.1.868.2.5.123.1.5.1		not-accessible	An entry in the table,tnPtpClkConf2Table
tnPtpClkConf2Table	1.3.6.1.4.1.868.2.5.123.1.5		not-accessible	Table 2 of PTP ClkInstance
tnPtpClkConfEntry	1.3.6.1.4.1.868.2.5.123.1.4.1		not-accessible	An entry in the table,tnPtpClkConfTable
INT tnPtpClkConfIndex	1.3.6.1.4.1.868.2.5.123.1.4.1.1	INTEGER	not-accessible	Indicates the Instance of a particular Clock Instance [0..CLOCK_INST_MAX].
INT tnPtpClkConfIndex2	1.3.6.1.4.1.868.2.5.123.1.5.1.1	INTEGER	not-accessible	Indicates the Instance of a particular Clock Instance [0..CLOCK_INST_MAX].
ROW tnPtpClkConfRowStatus	1.3.6.1.4.1.868.2.5.123.1.2.1.10	RowStatus	read-create	The status of the row. The writable columns in a row cannot be changed if the row is active. All columns must have a valid value before a row can be activated.
tnPtpClkConfTable	1.3.6.1.4.1.868.2.5.123.1.4		not-accessible	Table of PTP ClkInstance
tnPtpClkModesEntry	1.3.6.1.4.1.868.2.5.123.1.1.1		not-accessible	An entry in the table,tnPtpClkModesTable
tnPtpClkModesTable	1.3.6.1.4.1.868.2.5.123.1.1		not-accessible	Table of SyncE External I/O
OCT tnPtpClockId	1.3.6.1.4.1.868.2.5.123.1.2.1.4	OCTET STRING	read-create	A unique clock identifier.
INT tnPtpCommState	1.3.6.1.4.1.868.2.5.123.1.6.1.6	INTEGER	read-write	The state of the communication with the master, possible values are: IDLE : The entry is not in use. INIT : Announce is sent to the master (Waiting for a response). CONN : The master has responded. SELL : The assigned master is selected as current master. SYNC : The master is sending Sync messages.
tnPtpCreateClkConfEntry	1.3.6.1.4.1.868.2.5.123.1.2.1		not-accessible	An entry in the table,tnPtpCreateClkConfTable
INT tnPtpCreateClkConfIndex	1.3.6.1.4.1.868.2.5.123.1.2.1.1	INTEGER	not-accessible	Index of ptp clocks.
tnPtpCreateClkConfTable	1.3.6.1.4.1.868.2.5.123.1.2		not-accessible	Table of PTP ClkInstance
INT tnPtpDConstant	1.3.6.1.4.1.868.2.5.123.1.5.1.16	INTEGER	read-write	The default clock servo uses a PID regulator to calculate the current clock rate. i.e. clockAdjustment = OffsetFromMaster/ P constant + Integral(OffsetFromMaster)/ I constant + Differential OffsetFromMaster)/ D constant [1..10000].
OCT tnPtpDefaultClockQuality	1.3.6.1.4.1.868.2.5.123.1.3.1.3	OCTET STRING	read-write	The clock quality is determined by the system, and holds 3 parts: Clock Class, Clock Accuracy and OffsetScaledLog Variance as defined in IEEE1588. The Clock Accuracy values are defined in IEEE1588 table 6 (Currently the clock Accuracy is set to 'Unknown' as default).
INT tnPtpDefaultDom	1.3.6.1.4.1.868.2.5.123.1.3.1.2	INTEGER	read-write	Clock domain [0..127].
INT tnPtpDefaultPri1	1.3.6.1.4.1.868.2.5.123.1.3.1.4	INTEGER	read-write	Clock priority 1 [0..255] used by the BMC master select algorithm.
INT tnPtpDefaultPri2	1.3.6.1.4.1.868.2.5.123.1.3.1.5	INTEGER	read-write	Clock priority 2 [0..255] used by the BMC master select algorithm.
INT tnPtpDelayAsym	1.3.6.1.4.1.868.2.5.123.1.7.1.12	INTEGER	read-create	If the transmission delay for a link in not symmetric, the asymmetry can be configured here, see IEEE 1588 Section 7.4.2 Communication path asymmetry. [-100000..100000]
INT tnPtpDelayFilter	1.3.6.1.4.1.868.2.5.123.1.4.1.5	INTEGER	read-write	The default delay filter is a low pass filter, with a time constant of 2*DelayFilterDelayRequestRate. The value must be in the range of 1..6.
T/F tnPtpDEnable	1.3.6.1.4.1.868.2.5.123.1.5.1.13	TruthValue	read-write	If true the D part of the algorithm is included.
INT tnPtpDeviceType	1.3.6.1.4.1.868.2.5.123.1.2.1.2	INTEGER	read-create	Indicates the Type of the Clock Instance. There are five Device Types. 1. Ord-Bound - clock's Device Type is Ordinary-Boundary Clock. 2. P2p Transp - clock's Device Type is Peer to Peer Transparent Clock. 3. E2e Transp - clock's Device Type is End to End Transparent Clock. 4. Master Only - clock's Device Type is Master Only. 5. Slave Only - clock's Device Type is Slave Only.
INT tnPtpDim	1.3.6.1.4.1.868.2.5.123.1.7.1.10	INTEGER	read-create	Configurable member delayMechanism: The delay mechanism used for the port: e2e End to end delay measurement p2p Peer to peer delay measurement. Can be defined per port in an Ordinary/Boundary clock. In a transparent clock all ports use the same delay mechanism, determined by the clock type.
T/F tnPtpDisplay	1.3.6.1.4.1.868.2.5.123.1.5.1.10	TruthValue	read-write	If true then Offset From Master, MeanPathDelay and clockAdjustment are logged on the debug terminal.
INT tnPtpEgressLat	1.3.6.1.4.1.868.2.5.123.1.7.1.14	INTEGER	read-create	Egress latency measured in ns, as defined in IEEE 1588 Section 7.3.4.2. [-100000..100000]
INT tnPtpFilterDist	1.3.6.1.4.1.868.2.5.123.1.4.1.7	INTEGER	read-write	The distance between two calculations is Dist periods. Note: In configurations with Timestamp enabled PHYs, the period is automatically increased, if (period*dist 1 the offset is calculated using 'min' offset. The value must be in the range of 1..10
INT tnPtpFilterPeriod	1.3.6.1.4.1.868.2.5.123.1.4.1.6	INTEGER	read-write	The default offset filter uses a minimum delay filter method i.e. The minimum measured offset during Period samples is used in the calculation. The value must be in the range of 1..1000.
T/F tnPtpFreqTrac	1.3.6.1.4.1.868.2.5.123.1.5.1.7	TruthValue	read-write	Freq Trac.
INT tnPtpGrant	1.3.6.1.4.1.868.2.5.123.1.6.1.5	INTEGER	read-write	The granted repetition period for the sync message.
INT tnPtpIConstant	1.3.6.1.4.1.868.2.5.123.1.5.1.15	INTEGER	read-write	The default clock servo uses a PID regulator to calculate the current clock rate. i.e. clockAdjustment = OffsetFromMaster/ P constant + Integral(OffsetFromMaster)/ I constant + Differential OffsetFromMaster)/ D constant [1..10000].
T/F tnPtpIEnable	1.3.6.1.4.1.868.2.5.123.1.5.1.12	TruthValue	read-write	If true the I part of the algorithm is included.
INT tnPtpImpedance	1.3.6.1.4.1.868.2.5.123.1.1.1.5	INTEGER	read-write	Select the impedance termination of the input clock. The following values are possible: 1. 50 : 50 ohm impedance. 2. 75 : 75 ohm impedance. 3. Hi-Z : no impedance termination driven, tri-stated or floating.
INT tnPtpInFreq	1.3.6.1.4.1.868.2.5.123.1.1.1.3	INTEGER	read-write	Clock frequency 1 PPS or 8k-25Mhz table of values.
INT tnPtpIngerssLat	1.3.6.1.4.1.868.2.5.123.1.7.1.13	INTEGER	read-create	Ingress latency measured in ns, as defined in IEEE 1588 Section 7.3.4.2. [-100000..100000]
INT tnPtpInState	1.3.6.1.4.1.868.2.5.123.1.1.1.1	INTEGER	read-write	IEEE 1588 Input State.
IP tnPtpIPAddress	1.3.6.1.4.1.868.2.5.123.1.6.1.4	InetAddress	read-write	IPv4 Address of the Master clock.
T/F tnPtpLeap59	1.3.6.1.4.1.868.2.5.123.1.5.1.4	TruthValue	read-write	Leap 59.
T/F tnPtpLeap61	1.3.6.1.4.1.868.2.5.123.1.5.1.5	TruthValue	read-write	Leap 61.
INT tnPtpMDR	1.3.6.1.4.1.868.2.5.123.1.7.1.4	INTEGER	not-accessible	Dynamic member log Min Delay Req Interval: The delay request interval announced by the master.
OCT tnPtpMeanPath	1.3.6.1.4.1.868.2.5.123.1.7.1.5	OCTET STRING	not-accessible	The path delay measured by the port in P2P mode. In E2E mode this value is 0.
tnPtpMIB	1.3.6.1.4.1.868.2.5.123			The mib provides functionalities for managing PTP.
INT tnPtpMPR	1.3.6.1.4.1.868.2.5.123.1.7.1.11	INTEGER	read-create	The interval for issuing Delay_Req messages for the port in E2e mode. This value is announced from the master to the slave in an announce message. The value is reflected in the MDR field in the Slave The interval for issuing Pdelay_Req messages for the port in P2P mode Note: The interpretation of this parameter has changed from release 2.40. In earlier versions the value was interpreted relative to the Sync interval, this was a violation of the standard, so now the value is interpreted as an interval. I.e. MPR = 0 =>1 Delay_Req pr sec, independent of the Sync rate. [-7..5]
OCT tnPtpOffset	1.3.6.1.4.1.868.2.5.123.1.4.1.3	OCTET STRING	read-only	Time difference between the master clock and the local slave clock, measured in ns.
T/F tnPtpOneWay	1.3.6.1.4.1.868.2.5.123.1.2.1.5	TruthValue	read-create	If true, one-way measurements are used. This parameter applies only to a slave. In one-way mode no delay measurements are performed, i.e. this is applicable only if frequency synchronization is needed. The master always responds to delay requests..
INT tnPtpOutFreq	1.3.6.1.4.1.868.2.5.123.1.1.1.4	INTEGER	read-write	The following values are possible: Editable value with the possible range of values are 1 - 25000000 (1 - 25MHz).
INT tnPtpOutState	1.3.6.1.4.1.868.2.5.123.1.1.1.2	INTEGER	read-write	IEEE 1588 Output State.
INT tnPtpParentChgRate	1.3.6.1.4.1.868.2.5.123.1.4.1.12	INTEGER	read-only	Observed Parent Clock Phase Change Rate. i.e. the slave clocks rate offset compared to the master. (unit = ns per s).
OCT tnPtpParentGMId	1.3.6.1.4.1.868.2.5.123.1.4.1.13	OCTET STRING	read-only	Clock identity for the grand master clock, if the local clock is not a slave, the value is the clocks own id.
OCT tnPtpParentGMQual	1.3.6.1.4.1.868.2.5.123.1.4.1.14	OCTET STRING	read-only	The clock quality announced by the grand master.
INT tnPtpParentPort	1.3.6.1.4.1.868.2.5.123.1.4.1.9	INTEGER	read-only	Port Id for the parent master port.
OCT tnPtpParentPortId	1.3.6.1.4.1.868.2.5.123.1.4.1.8	OCTET STRING	read-only	Clock identity for the parent clock, if the local clock is not a slave, the value is the clocks own id.
INT tnPtpParentPri1	1.3.6.1.4.1.868.2.5.123.1.4.1.15	INTEGER	read-only	Clock priority 1 announced by the grand master.
INT tnPtpParentPri2	1.3.6.1.4.1.868.2.5.123.1.4.1.16	INTEGER	read-only	Clock priority 2 announced by the grand master.
T/F tnPtpParentPStat	1.3.6.1.4.1.868.2.5.123.1.4.1.10	TruthValue	read-only	Parents Stats (always false).
INT tnPtpParentVar	1.3.6.1.4.1.868.2.5.123.1.4.1.11	INTEGER	read-only	It is observed parent offset scaled log variance.
OCT tnPtpPathDelay	1.3.6.1.4.1.868.2.5.123.1.4.1.4	OCTET STRING	read-only	The mean propagation time for the link between the master and the local slave.
INT tnPtpPConstant	1.3.6.1.4.1.868.2.5.123.1.5.1.14	INTEGER	read-write	The default clock servo uses a PID regulator to calculate the current clock rate. i.e. clockAdjustment = OffsetFromMaster/ P constant + Integral(OffsetFromMaster)/ I constant + Differential OffsetFromMaster)/ D constant [1..1000].
INT tnPtpPCP	1.3.6.1.4.1.868.2.5.123.1.2.1.9	INTEGER	read-create	Priority Code Point value used for PTP frames.
T/F tnPtpPEnable	1.3.6.1.4.1.868.2.5.123.1.5.1.11	TruthValue	read-write	If true the P part of the algorithm is included.
tnPtpPortConfEntry	1.3.6.1.4.1.868.2.5.123.1.7.1		not-accessible	An entry in the table,tnPtpPortConfTable
INT tnPtpPortConfIndex	1.3.6.1.4.1.868.2.5.123.1.7.1.2	INTEGER	not-accessible	Static member port Identity : Port number [1..max port no].
INT tnPtpPortConfInstIndex	1.3.6.1.4.1.868.2.5.123.1.7.1.1	INTEGER	not-accessible	Indicates the Instance of a particular Clock Instance [0..3].
ROW tnPtpPortConfRowStatus	1.3.6.1.4.1.868.2.5.123.1.7.1.16	RowStatus	read-create	The status of the row. The writable columns in a row cannot be changed if the row is active. All columns must have a valid value before a row can be activated.
tnPtpPortConfTable	1.3.6.1.4.1.868.2.5.123.1.7		not-accessible	Table of PTP Clock Port Data Set Configuration
INT tnPtpProtocol	1.3.6.1.4.1.868.2.5.123.1.2.1.6	INTEGER	read-create	Transport protocol used by the PTP protocol engine ethernet PTP over Ethernet multicast ip4multi PTP over IPv4 multicast ip4uni PTP over IPv4 unicast Note : IPv4 unicast protocol only works in Master only and Slave only clocks See parameter Device Type In a unicast Slave only clock you also need configure which master clocks to request Announce and Sync messages from. See: Unicast Slave Configuration.
INT tnPtpServoDelayFilter	1.3.6.1.4.1.868.2.5.123.1.5.1.17	INTEGER	read-write	The default delay filter is a low pass filter, with a time constant of 2*DelayFilterDelayRequestRate. This is for the custom filter.
OCT tnPtpStat	1.3.6.1.4.1.868.2.5.123.1.7.1.3	OCTET STRING	not-accessible	Dynamic member portState: Current state of the port.
INT tnPtpStpRm	1.3.6.1.4.1.868.2.5.123.1.4.1.2	INTEGER	read-only	Steps Removed : It is the number of PTP clocks traversed from the grandmaster to the local slave clock.
INT tnPtpSynce	1.3.6.1.4.1.868.2.5.123.1.3.1.8	INTEGER	read-write	Activate to synchronize the System Clock to PTP Time.
T/F tnPtpSyncIntErr	1.3.6.1.4.1.868.2.5.123.1.7.1.9	TruthValue	not-accessible	Synce Interval Error truth value
INT tnPtpSyv	1.3.6.1.4.1.868.2.5.123.1.7.1.8	INTEGER	read-create	The interval for issuing sync messages in master. [-7..4]
OCT tnPtpTime	1.3.6.1.4.1.868.2.5.123.1.3.1.6	OCTET STRING	read-only	Shows the actual PTP time with nanosecond resolution.
T/F tnPtpTimeScale	1.3.6.1.4.1.868.2.5.123.1.5.1.8	TruthValue	read-write	Time Scale.
INT tnPtpTimeSource	1.3.6.1.4.1.868.2.5.123.1.5.1.9	INTEGER	read-write	Time Source. Value of 0-255
T/F tnPtpTimeTrac	1.3.6.1.4.1.868.2.5.123.1.5.1.6	TruthValue	read-write	Time Trac.
T/F tnPtpTwoStepFlag	1.3.6.1.4.1.868.2.5.123.1.2.1.3	TruthValue	read-create	Static member: defined by the system, true if two-step Sync events and Pdelay_Resp events are used.
INT tnPtpUnicastDuration	1.3.6.1.4.1.868.2.5.123.1.6.1.3	INTEGER	read-write	The number of seconds a master is requested to send Announce/Sync messages. The request is repeated from the slave each Duration/4 seconds. [10..1000].
INT tnPtpUnicastInstIndex	1.3.6.1.4.1.868.2.5.123.1.6.1.1	INTEGER	not-accessible	Indicates the Instance of a particular Clock Instance [0..3].
tnPtpUnicastSlaveEntry	1.3.6.1.4.1.868.2.5.123.1.6.1		not-accessible	An entry in the table,tnPtpUnicastSlaveTable
INT tnPtpUnicastSlaveIndex	1.3.6.1.4.1.868.2.5.123.1.6.1.2	INTEGER	not-accessible	Indicates the Instance of a particular Unicast Slave [0..4].
tnPtpUnicastSlaveTable	1.3.6.1.4.1.868.2.5.123.1.6		not-accessible	Table of PTP Unicast Slave
INT tnPtpUtcOffset	1.3.6.1.4.1.868.2.5.123.1.5.1.2	INTEGER	read-write	Unicast Offset must be an integer value between 0 and 10000.
T/F tnPtpValid	1.3.6.1.4.1.868.2.5.123.1.5.1.3	TruthValue	read-write	Valid.
INT tnPtpVersion	1.3.6.1.4.1.868.2.5.123.1.7.1.15	INTEGER	not-accessible	The current implementation only supports PTP version 2.
INT tnPtpVID	1.3.6.1.4.1.868.2.5.123.1.2.1.8	INTEGER	read-create	VLAN Identifier used for tagging the PTP frames.
T/F tnPtpVLANTag	1.3.6.1.4.1.868.2.5.123.1.2.1.7	TruthValue	read-create	Enables the VLAN tagging for the PTP frames. Note: Packets are only tagged if the port is configured for vlan tagging. i.e: Port Type != Unaware and PortVLAN mode == None, and the port is member of the VLAN.

RFC description

IEEE 1588 Precision Time Protocol (PTP) and Synchronous Ethernet clock management for Transition Networks devices.

Start monitoring Transition Networks PTP switch/media converter (IEEE 1588 clock sync/frequency-lock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download TN-PTP-MIB

What Is TN-PTP-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description