Skip to content

S
Software for White Rabbit PTP Core
Commit 9d3b7924 authored by Grzegorz Daniluk's avatar Grzegorz Daniluk Committed by Adam Wujek
Browse files
Options

wrpc_failures: small fixes

parent 2d141594
Hide whitespace changes
Inline Side-by-side
Showing with 128 additions and 119 deletions
doc/wrpc_failures/fail.tex
View file @ 9d3b7924
...@@ -7,17 +7,18 @@ fail. The structure of each error description is the following: ...@@ -7,17 +7,18 @@ fail. The structure of each error description is the following:
\item WARNING - means that despite the fault the synchronization \item WARNING - means that despite the fault the synchronization
functionality was not affected so the WRPC behaves correctly in the WR functionality was not affected so the WRPC behaves correctly in the WR
network. network.
\item ERROR - means that the fault is critical and most probably a WRPC \item ERROR - means that the fault is critical and most probably WRPC
misbehaves. misbehaves.
\end{packed_items} \end{packed_items}
\item [] \underline{Mode}: for timing failures, it describes which modes are \item [] \underline{Mode}: for timing failures, it describes which modes are
affected. Possible values are: affected. Possible values are:
\begin{packed_items} \begin{packed_items}
\item \emph{Slave} - the WR PTP Core synchronizes to another WR device. \item \emph{Slave} - the WR Node (WR PTP Core) synchronizes to another WR
\item \emph{Grand Master} - the WR node (WR PTP Core) at the top of the device.
\item \emph{Grand Master} - the WR Node (WR PTP Core) is at the top of the
synchronization hierarchy. It is synchronized to an external clock (e.g. synchronization hierarchy. It is synchronized to an external clock (e.g.
GPS, Cesium) and provides timing to other WR/PTP devices. GPS, Cesium) and provides timing to other WR/PTP devices.
\item \emph{Master} - the WR node (WR PTP Core) at the top of the \item \emph{Master} - the WR Node (WR PTP Core) at the top of the
synchronization hierarchy. It provides timing to other WR/PTP devices synchronization hierarchy. It provides timing to other WR/PTP devices
but runs from a local oscillator (not synchronized to an external but runs from a local oscillator (not synchronized to an external
clock). clock).
...@@ -30,16 +31,24 @@ fail. The structure of each error description is the following: ...@@ -30,16 +31,24 @@ fail. The structure of each error description is the following:
\item [] \underline{SNMP objects}: Which SNMP objects should be monitored to \item [] \underline{SNMP objects}: Which SNMP objects should be monitored to
detect the failure. These are objects from the \texttt{WR-WRPC-MIB}. detect the failure. These are objects from the \texttt{WR-WRPC-MIB}.
\item [] \underline{Error/Warning condition}: condition that should be checked \item [] \underline{Error/Warning condition}: condition that should be checked
at the SNMP manager's side to detect given problem. at the SNMP manager's side to detect given problem. Often you will see there
conditions like:\\
\texttt{[value] != [value]\_prev} or\\
\texttt{[value] - [value]\_prev > [threshold]}\\
where \text{[value]} and \text{[value]\_prev} are the current and previous
iteration readouts of an SNMP object. This way we check if the value of the
object has changed from the previous readout or if it has changed by more
than a safe threshold.
\item [] \underline{Action}: list of actions that should be performed in case \item [] \underline{Action}: list of actions that should be performed in case
given error/warning is reported. There are some common remarks that apply to of an error/warning. Regardless of the detailed actions described for each
all situations: of the errors below, there are some common remarks that apply to all
situations:
\begin{itemize} \begin{itemize}
\item If a procedure given for a specific SNMP object does not solve the \item If a procedure given for a specific SNMP object does not solve the
problem, please contact WR experts to perform a more in-depth analysis of problem, please contact WR experts to perform a more in-depth analysis of
the network. For this, you should provide a complete dump of the WRPC the network. For this, you should provide a complete dump of the WRPC
status generated in the first step of each procedure. status generated in the first step of each procedure.
\item The first action in most of the procedures below named Dump state \item The first action in most of the procedures, called \emph{Dump state}
requires simply calling a tool provided by WR developers that reads all requires simply calling a tool provided by WR developers that reads all
the detailed information from the node and writes it to a single file the detailed information from the node and writes it to a single file
that can be later analyzed by the experts. that can be later analyzed by the experts.
...@@ -47,20 +56,19 @@ fail. The structure of each error description is the following: ...@@ -47,20 +56,19 @@ fail. The structure of each error description is the following:
Node working in the \emph{Grand Master} mode, please make sure that after Node working in the \emph{Grand Master} mode, please make sure that after
the repair, all other WR devices in the network are synchronized and do the repair, all other WR devices in the network are synchronized and do
not report any problems. not report any problems.
\item If a procedure requires replacing a WR ndoe with a new unit, the \item If a procedure requires replacing WR Node with a new unit, the
broken one should be handled to WR experts or the switch manufacturer to broken one should be handled to WR experts or the hardware manufacturer to
investigate the problem. investigate the problem.
\end{itemize} \end{itemize}
\end{itemize} \end{itemize}
\newpage
\subsection{Timing error} \subsection{Timing error}
\label{sec:timing_fail} \label{sec:timing_fail}
As a timing error we define the WR PTP Core not being able to synchronize its As a timing error we define the WR PTP Core not being able to synchronize its
local time to the WR Master (if WRPC runs in the slave mode), or not being able local time to the WR Master (if WRPC runs in the slave mode), or not being able
to provide correct WR time to the rest of the WR network (if WRPC runs in the to provide correct WR time to the rest of the WR network (if WRPC runs in the
master mode). master mode). This section contains the list of faults leading to a timing error.
\noindent This section contains the list of faults leading to a timing error.
\subsubsection{\bf PTP/PPSi went out of \texttt{TRACK\_PHASE}} \subsubsection{\bf PTP/PPSi went out of \texttt{TRACK\_PHASE}}
\label{fail:timing:ppsi_track_phase} \label{fail:timing:ppsi_track_phase}
...@@ -69,8 +77,8 @@ master mode). ...@@ -69,8 +77,8 @@ master mode).
\item [] \underline{Mode}: \emph{Slave} \item [] \underline{Mode}: \emph{Slave}
\item [] \underline{Description}:\\ \item [] \underline{Description}:\\
If the \emph{PTP/PPSi} WR servo goes out of the \texttt{TRACK\_PHASE} If the \emph{PTP/PPSi} WR servo goes out of the \texttt{TRACK\_PHASE}
state, this means something bad has happened and the node lost the state, this means something bad has happened and the node lost
synchronization to its Master. synchronization to its Master.
\item [] \underline{SNMP objects}:\\ \item [] \underline{SNMP objects}:\\
{\footnotesize {\footnotesize
\snmpadd{WR-WRPC-MIB::wrpcPtpServoStateN}\\ \snmpadd{WR-WRPC-MIB::wrpcPtpServoStateN}\\
...@@ -80,11 +88,14 @@ master mode). ...@@ -80,11 +88,14 @@ master mode).
\texttt{wrpcPtpServoStateErrCnt != wrpcPtpServoStateErrCnt\_prev} } \texttt{wrpcPtpServoStateErrCnt != wrpcPtpServoStateErrCnt\_prev} }
\item [] \underline{Action}: \item [] \underline{Action}:
\begin{pck_proc} \begin{pck_proc}
\item Check if the WR Master - timing source, was not restarted. If it
was, Slave leaving \texttt{TRACK\_PHASE} state is a normal behavior
and it should automatically re-synchronize.
\item Dump state \item Dump state
\item Check the status of the WR Master - timing source. In case it has \item Check the status of the WR Master - timing source. In case it has
reported some problems, please follow the diagnostics document for the reported some problems, please follow the diagnostics document for the
WR Switch. WR Switch.
\item If the Switch did not report any problems, restart the WR Node. \item If the switch did not report any problems, restart the WR Node.
\item If the problem persists replace the WR Node hardware with a new \item If the problem persists replace the WR Node hardware with a new
unit. unit.
\item If the problem persists, please notify WR experts. \item If the problem persists, please notify WR experts.
...@@ -110,8 +121,8 @@ master mode). ...@@ -110,8 +121,8 @@ master mode).
\item [] \underline{Action}: \item [] \underline{Action}:
\begin{pck_proc} \begin{pck_proc}
\item Dump state \item Dump state
\item Check the status of the WR Master - timing source. Normally the \item Check the status of the WR Master - timing source. Normally, time
time jumps should not happen and if they do, the problem should be jumps should not happen and if they do, the problem should be
investigated on the WR Master side (e.g. \emph{Grand Master} unlocked investigated on the WR Master side (e.g. \emph{Grand Master} unlocked
from the external reference). from the external reference).
\item Restart the WR Node and let it synchronize again. \item Restart the WR Node and let it synchronize again.
...@@ -155,8 +166,8 @@ master mode). ...@@ -155,8 +166,8 @@ master mode).
\item [] \underline{Description}:\\ \item [] \underline{Description}:\\
If \emph{PTP/PPSi} doesn't get the correct values of fixed hardware delays, If \emph{PTP/PPSi} doesn't get the correct values of fixed hardware delays,
it won't be able to calculate a proper Master-to-Slave delay. Although it won't be able to calculate a proper Master-to-Slave delay. Although
the estimated offset in \emph{PTP/PPSi} is close to 0, the WRS won't be the estimated offset in \emph{PTP/PPSi} is close to 0, the WRPC won't be
synchronized to the Master with the sub-nanosecond accuracy. synchronized to the Master with sub-nanosecond accuracy.
\item [] \underline{SNMP objects}:\\ \item [] \underline{SNMP objects}:\\
{\footnotesize {\footnotesize
\snmpadd{WR-WRPC-MIB::wrpcPtpDeltaTxM}\\ \snmpadd{WR-WRPC-MIB::wrpcPtpDeltaTxM}\\
...@@ -177,7 +188,7 @@ master mode). ...@@ -177,7 +188,7 @@ master mode).
\item Check the White Rabbit PTP Core User Manual \item Check the White Rabbit PTP Core User Manual
\footnote{\url{http://www.ohwr.org/projects/wr-cores/wiki/Current\_release}} \footnote{\url{http://www.ohwr.org/projects/wr-cores/wiki/Current\_release}}
for the instructions how the calibration values can be configured for the instructions how the calibration values can be configured
locally or remotely using SNMP SET objects. locally or remotely using SET for SNMP objects.
\end{pck_proc} \end{pck_proc}
\end{pck_descr} \end{pck_descr}
...@@ -293,7 +304,7 @@ master mode). ...@@ -293,7 +304,7 @@ master mode).
\item [] \underline{Action}: \item [] \underline{Action}:
\begin{pck_proc} \begin{pck_proc}
\item Dump state. \item Dump state.
\item Check the status of the WR Master - timing source. Especially if \item Check the state of the WR Master - timing source. Especially, if
the PTP daemon is still running there. the PTP daemon is still running there.
\item Check if the VLANs configuration on the WR Node matches the \item Check if the VLANs configuration on the WR Node matches the
configuration of the WR Switch where this node is connected. Wrong configuration of the WR Switch where this node is connected. Wrong
...@@ -314,9 +325,9 @@ master mode). ...@@ -314,9 +325,9 @@ master mode).
\item [] \underline{Description}:\\ \item [] \underline{Description}:\\
By not supported SFP for WR timing we mean a transceiver that doesn't By not supported SFP for WR timing we mean a transceiver that doesn't
have the \emph{alpha} parameter and fixed hardware delays defined in the have the \emph{alpha} parameter and fixed hardware delays defined in the
SFP database. The consequence is \emph{PTP/PPSi} not having the right SFP database. The consequence is \emph{PTP} not having the right
values to estimate link asymmetry. Despite \emph{PTP/PPSi} offset being values to estimate the link asymmetry. Despite the \emph{PTP} offset
close to 0 \emph{ps}, the device won't be properly synchronized. being close to \emph{0ps}, the device won't be properly synchronized.
\item [] \underline{SNMP objects}:\\ \item [] \underline{SNMP objects}:\\
{\footnotesize {\footnotesize
\snmpadd{WR-WRPC-MIB::wrpcPortSfpPn}\\ \snmpadd{WR-WRPC-MIB::wrpcPortSfpPn}\\
...@@ -326,11 +337,11 @@ master mode). ...@@ -326,11 +337,11 @@ master mode).
\texttt{wrpcPortSfpInDB != inDataBase\emph{(2)}} } \texttt{wrpcPortSfpInDB != inDataBase\emph{(2)}} }
\item [] \underline{Action}: \item [] \underline{Action}:
\begin{pck_proc} \begin{pck_proc}
\item Check if the SFP database is correctly defined by making sure if \item Check if the SFP database is correctly defined by making sure the
error \ref{fail:timing:no_sfpdb} is not reported. error \ref{fail:timing:no_sfpdb} is not reported.
\item Change the optical SFP transceiver in the WR Node. Either it is \item Change the optical SFP transceiver in the WR Node. Either it is
broken and its ID cannot be read correctly, or a non-supported broken and should be replaced since its ID cannot be read correctly,
transceiver was plugged to the device. or a non-supported transceiver was plugged to the device.
\end{pck_proc} \end{pck_proc}
\end{pck_descr} \end{pck_descr}
...@@ -346,20 +357,24 @@ master mode). ...@@ -346,20 +357,24 @@ master mode).
device won't be properly synchronized. device won't be properly synchronized.
\item [] \underline{SNMP objects}:\\ \item [] \underline{SNMP objects}:\\
{\footnotesize {\footnotesize
\snmpadd{WR-WRPC-MIB::wrpcSfpPn.<n>}\\
\snmpadd{WR-WRPC-MIB::wrpcSfpDeltaTx.<n>}\\ \snmpadd{WR-WRPC-MIB::wrpcSfpDeltaTx.<n>}\\
\snmpadd{WR-WRPC-MIB::wrpcSfpDeltaRx.<n>} } \snmpadd{WR-WRPC-MIB::wrpcSfpDeltaRx.<n>}\\
\snmpadd{WR-WRPC-MIB::wrpcSfpAlpha.<n>} }
\item [] \underline{Note}: It's enough to try reading index 1 of the above \item [] \underline{Note}: It's enough to try reading index 1 of the above
SNMP objects tables to make sure there is at least one entry in the SNMP objects tables to make sure there is at least one entry in the
database. database.
\item [] \underline{Error condition}:\\ \item [] \underline{Error condition}:\\
{\footnotesize {\footnotesize
Error when trying to get \texttt{wrpcSfpDeltaTx.1} and \texttt{wrpcSfpDeltaRx.1} SNMP objects} Error when trying to get any of the \texttt{wrpcSfpPn.1};
\texttt{wrpcSfpDeltaTx.1}; \texttt{wrpcSfpDeltaRx.1};
\texttt{wrpcSfpAlpha.1} SNMP objects}
\item [] \underline{Action}: \item [] \underline{Action}:
\begin{pck_proc} \begin{pck_proc}
\item Check the White Rabbit PTP Core User \item Check the White Rabbit PTP Core User's
Manual\footnote{\url{http://www.ohwr.org/projects/wr-cores/wiki/Current\_release}} Manual\footnote{\url{http://www.ohwr.org/projects/wr-cores/wiki/Current\_release}}
for the instructions how the calibration values can be configured for the instructions how the calibration values can be configured
locally or remotely using SNMP SET objects. locally or remotely using SET for SNMP objects.
\end{pck_proc} \end{pck_proc}
\end{pck_descr} \end{pck_descr}
...@@ -371,11 +386,10 @@ master mode). ...@@ -371,11 +386,10 @@ master mode).
\label{fail:timing:master_down} \label{fail:timing:master_down}
\begin{pck_descr} \begin{pck_descr}
\item [] \underline{Severity}: ERROR \item [] \underline{Severity}: ERROR
\item [] \underline{Mode}: \emph{all}
\item [] \underline{Description}:\\ \item [] \underline{Description}:\\
We monitor the WRPC over the WR network. We can realize if this only WRPC is monitored over the WR network. This means, to detect whether
communication link is down by either SNMP requests timeouts or the communication link is down we can either periodically ping the
periodically pinging the device. device or monitor if there are no timeouts from SNMP requests.
\item [] \underline{SNMP objects}: \emph{(none)} \item [] \underline{SNMP objects}: \emph{(none)}
\item [] \underline{Error condition}:\\ \item [] \underline{Error condition}:\\
{\footnotesize {\footnotesize
...@@ -388,8 +402,8 @@ master mode). ...@@ -388,8 +402,8 @@ master mode).
locally to verify if the WR Node is programmed correctly. locally to verify if the WR Node is programmed correctly.
\item Check the fiber link e.g. by connecting another WR Node, with a \item Check the fiber link e.g. by connecting another WR Node, with a
different SFP transceiver to the same fiber. different SFP transceiver to the same fiber.
\item If there is still no link on the new WR Node, try on the Master \item If there is still no link on the new WR Node, try connecting
side connecting the fiber to another port of the WR Switch (using fiber on the Master side to another port of the WR Switch (using
different SFP transceiver). different SFP transceiver).
\item If there is still no link, the fiber connection is either dirty or \item If there is still no link, the fiber connection is either dirty or
broken. broken.
......
doc/wrpc_failures/intro.tex
View file @ 9d3b7924
\section{Introduction} \section{Introduction}
This document provides information about the diagnostics of White Rabbit This document provides information about the diagnostics of the White Rabbit
PTP Core (WRPC) - an HDL module present in every White Rabbit node. It is a PTP Core (WRPC) - an HDL module present in every White Rabbit node. It is a
complementary documentation to the official \emph{White Rabbit PTP Core User's complementary documentation to the official \emph{White Rabbit PTP Core User's
Manual} published with every stable release. Please refer to this user manual Manual} published with every stable release. Please refer to this user manual
...@@ -9,25 +9,12 @@ the official reference designs.\\ ...@@ -9,25 +9,12 @@ the official reference designs.\\
White Rabbit PTP Core starting from \emph{v4.0} provides diagnostic mechanisms White Rabbit PTP Core starting from \emph{v4.0} provides diagnostic mechanisms
in the form of SNMP objects and optional Syslog messages (depending on the build in the form of SNMP objects and optional Syslog messages (depending on the build
time LM32 software configuration). The implementation of the SNMP agent in the time LM32 software configuration). The implementation of an SNMP agent in the
WRPC is very basic comparing to the diagnostics offered by the White Rabbit WRPC is very basic comparing to the diagnostics offered by the White Rabbit
Switch. Since we are very constraint on the code size running inside the WR PTP Switch. Since we are very constraint on the code size running inside the WR PTP
Core, almost all of the logic to detect and report errors has to be implemented Core, almost all of the logic to detect and report errors has to be implemented
on the SNMP Manager's side. on the SNMP Manager's side.\\
%This document is This document has many internal hyperlinks that associate SNMP objects with
%organized in two parts. It starts with a description of the SNMP objects and related problems description and the other way round. These links can be easily
%procedures to be followed if various errors are reported (section used when reading the document on a computer.
%\ref{sec:snmp_exports}). This first part is meant for the operators and people
%integrating a WR switch into a control system, without the deep knowledge about
%the White Rabbit internals. These people usually have to perform a quick
%diagnostics and decide on actions to restore a WR network.
%Second part of the document tries to list all the possible failures
%that may disturb synchronization and Ethernet switching (section
%\ref{sec:failures}). It is meant for the WR experts to help them with in-depth
%diagnosis of the problems reported by SNMP.
This document has many internal hyperlinks that associate general SNMP status
objects and expert SNMP objects with related problems' description and the other
way round. These links can be easily used when reading the document on a
computer.
doc/wrpc_failures/snmp_objects.tex
View file @ 9d3b7924
...@@ -6,10 +6,11 @@ ...@@ -6,10 +6,11 @@
Type of the hardware of a given WR Node.} Type of the hardware of a given WR Node.}
\snmpentrys{WR-WRPC-MIB}{wrpcVersionGroup}{wrpcVersionSwVersion}{ \snmpentrys{WR-WRPC-MIB}{wrpcVersionGroup}{wrpcVersionSwVersion}{
\underline{Description:} \underline{Description:}
Version of the LM32 software running inside the WR PTP Core (WRPC) } Version of the LM32 software running inside the WR PTP Core. }
\snmpentrys{WR-WRPC-MIB}{wrpcVersionGroup}{wrpcVersionSwBuildBy}{ \snmpentrys{WR-WRPC-MIB}{wrpcVersionGroup}{wrpcVersionSwBuildBy}{
\underline{Description:} \underline{Description:}
Information who has compiled the LM32 software running inside the WRPC } Information who has compiled the LM32 software running inside the WR PTP
Core. }
\snmpentrys{WR-WRPC-MIB}{wrpcVersionGroup}{wrpcVersionSwBuildDate}{ \snmpentrys{WR-WRPC-MIB}{wrpcVersionGroup}{wrpcVersionSwBuildDate}{
\underline{Description:} \underline{Description:}
Information when the LM32 software was compiled. } Information when the LM32 software was compiled. }
...@@ -47,43 +48,49 @@ ...@@ -47,43 +48,49 @@
\snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllMode}{ \snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllMode}{
\underline{Description:} \underline{Description:}
Mode of operation of the Soft PLL inside WR PTP Core. Possible values:\\ Mode of operation of the Soft PLL inside WR PTP Core. Possible values:
\texttt{grandmaster\emph{(1)}} -- Master synchronized to external reference (e.g. GPS or Cesium) \\ \begin{packed_items_snmp_obj}
\texttt{master\emph{(2)}} -- Free-running Master\\ \item \texttt{grandmaster\emph{(1)}} -- Master synchronized to external reference (e.g. GPS or Cesium)
\texttt{slave\emph{(3)}}\\ \item \texttt{master\emph{(2)}} -- Free-running Master
\texttt{disabled\emph{(4)}} \item \texttt{slave\emph{(3)}}
\item \texttt{disabled\emph{(4)}}
\end{packed_items_snmp_obj}
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllIrqCnt}{ \snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllIrqCnt}{
\underline{Description:} \underline{Description:}
Number of interrupts received by SoftPLL for DDMTD tags.} Number of interrupts received by SoftPLL for DDMTD tags.}
\snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllSeqState}{ \snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllSeqState}{
\underline{Description:} \underline{Description:}
SoftPLL sequencer state. Possible values:\\ SoftPLL sequencer state. Possible values:
\texttt{startExt\emph{(1)}}\\ \begin{packed_items_snmp_obj}
\texttt{waitExt\emph{(2)}}\\ \item \texttt{startExt\emph{(1)}}
\texttt{startHelper\emph{(3)}}\\ \item \texttt{waitExt\emph{(2)}}
\texttt{waitHelper\emph{(4)}}\\ \item \texttt{startHelper\emph{(3)}}
\texttt{startMain\emph{(5)}}\\ \item \texttt{waitHelper\emph{(4)}}
\texttt{waitMain\emph{(6)}}\\ \item \texttt{startMain\emph{(5)}}
\texttt{disabled\emph{(7)}}\\ \item \texttt{waitMain\emph{(6)}}
\texttt{ready\emph{(8)}}\\ \item \texttt{disabled\emph{(7)}}
\texttt{clearDacs\emph{(9)}}\\ \item \texttt{ready\emph{(8)}}
\texttt{waitClearDacs\emph{(10)}} \item \texttt{clearDacs\emph{(9)}}
\item \texttt{waitClearDacs\emph{(10)}}
\end{packed_items_snmp_obj}
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllAlignState}{ \snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllAlignState}{
\underline{Description:} \underline{Description:}
SoftPLL aligner state. Possible values:\\ SoftPLL aligner state. Possible values:
\texttt{extOff\emph{(0)}}\\ \begin{packed_items_snmp_obj}
\texttt{start\emph{(1)}}\\ \item \texttt{extOff\emph{(0)}}
\texttt{initCsync\emph{(2)}}\\ \item \texttt{start\emph{(1)}}
\texttt{waitCsync\emph{(3)}}\\ \item \texttt{initCsync\emph{(2)}}
\texttt{waitSample\emph{(4)}}\\ \item \texttt{waitCsync\emph{(3)}}
\texttt{compensateDelay\emph{(5)}}\\ \item \texttt{waitSample\emph{(4)}}
\texttt{locked\emph{(6)}}\\ \item \texttt{compensateDelay\emph{(5)}}
\texttt{startAlignment\emph{(7)}}\\ \item \texttt{locked\emph{(6)}}
\texttt{startMain\emph{(8)}}\\ \item \texttt{startAlignment\emph{(7)}}
\texttt{waitClkin\emph{(9)}}\\ \item \texttt{startMain\emph{(8)}}
\texttt{waitPlock\emph{(10)}} \item \texttt{waitClkin\emph{(9)}}
\item \texttt{waitPlock\emph{(10)}}
\end{packed_items_snmp_obj}
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllHlock}{ \snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllHlock}{
\underline{Description:} \underline{Description:}
...@@ -101,8 +108,8 @@ ...@@ -101,8 +108,8 @@
Main PLL DAC value (range 0-65535).} Main PLL DAC value (range 0-65535).}
\snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllDelCnt}{ \snmpentrys{WR-WRPC-MIB}{wrpcSpllStatusGroup}{wrpcSpllDelCnt}{
\underline{Description:} \underline{Description:}
Delock counter - how many times since the WRPC software has started, either Delock counter - how many times either Helper of Main PLL lost lock since
the Helper of Main PLL lost lock. the WRPC software has started.
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{}{wrpcPtpGroup}{ \snmpentrys{WR-WRPC-MIB}{}{wrpcPtpGroup}{
...@@ -111,13 +118,15 @@ the Helper of Main PLL lost lock. ...@@ -111,13 +118,15 @@ the Helper of Main PLL lost lock.
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpServoStateN}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpServoStateN}{
\underline{Description:} \underline{Description:}
Current state of WR synchronization servo running in the PTP. Possible Current state of WR synchronization servo running in the PTP. Possible
values:\\ values:
\texttt{uninitialized\emph{(0)}}\\ \begin{packed_items_snmp_obj}
\texttt{syncNsec\emph{(1)}}\\ \item \texttt{uninitialized\emph{(0)}}
\texttt{syncSec\emph{(2)}}\\ \item \texttt{syncNsec\emph{(1)}}
\texttt{syncPhase\emph{(3)}}\\ \item \texttt{syncSec\emph{(2)}}
\texttt{trackPhase\emph{(4)}}\\ \item \texttt{syncPhase\emph{(3)}}
\texttt{waitOffsetStable\emph{(5)}} \item \texttt{trackPhase\emph{(4)}}
\item \texttt{waitOffsetStable\emph{(5)}}
\end{packed_items_snmp_obj}
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpClockOffsetPsHR}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpClockOffsetPsHR}{
\underline{Description:} \underline{Description:}
...@@ -139,12 +148,21 @@ values:\\ ...@@ -139,12 +148,21 @@ values:\\
\underline{Description:} \underline{Description:}
TAI nanoseconds when the WR PTP servo was last updated. TAI nanoseconds when the WR PTP servo was last updated.
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaTxM}{} \snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaTxM}{
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaRxM}{} \underline{Description:}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaTxS}{} Fixed Tx latency of the WR master.
\glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaRxM}{
\underline{Description:}
Fixed Rx latency of the WR master.
\glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaTxS}{
\underline{Description:}
Fixed Tx latency of the WR slave.
\glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaRxS}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpDeltaRxS}{
\underline{Description:} \underline{Description:}
Fixed Tx and Rx latencies of the WR master and slave. Fixed Rx latency of the WR slave.
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpServoStateErrCnt}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpServoStateErrCnt}{
\underline{Description:} \underline{Description:}
...@@ -175,12 +193,12 @@ previously calculated value. ...@@ -175,12 +193,12 @@ previously calculated value.
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpAlpha}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpGroup}{wrpcPtpAlpha}{
\underline{Description:} \underline{Description:}
Alpha value (fiber asymmetry coeficient) used for WR to estimate the one-way Alpha value (fiber asymmetry coefficient) used for WR to estimate the
link delay. one-way link delay.
\glspar \underline{Related problems:}} \glspar \underline{Related problems:}}
\snmpentrys{WR-WRPC-MIB}{}{wrpcPtpConfigGroup}{ \snmpentrys{WR-WRPC-MIB}{}{wrpcPtpConfigGroup}{
The groups contains objects for configuring remotely the SFP databse with The groups contains objects for configuring remotely the SFP database with
calibration parameters} calibration parameters}
\snmpentrys{WR-WRPC-MIB}{wrpcPtpConfigGroup}{wrpcPtpConfigRestart}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpConfigGroup}{wrpcPtpConfigRestart}{
...@@ -189,7 +207,7 @@ calibration parameters} ...@@ -189,7 +207,7 @@ calibration parameters}
Possible values: Possible values:
\begin{packed_items_snmp_obj} \begin{packed_items_snmp_obj}
\item write: \texttt{restartPtp\emph{(1)}} -- triggers PTP restart \item write: \texttt{restartPtp\emph{(1)}} -- triggers PTP restart
\item read: \texttt{restartPtpSuccessful\emph{(100)}} -- PTP restart triggered succesfully \item read: \texttt{restartPtpSuccessful\emph{(100)}} -- PTP restart triggered successfully
\item read: \texttt{restartPtpFailed\emph{(200)}} -- failed to trigger PTP restart \item read: \texttt{restartPtpFailed\emph{(200)}} -- failed to trigger PTP restart
\end{packed_items_snmp_obj} \end{packed_items_snmp_obj}
} }
...@@ -229,7 +247,8 @@ Possible values: ...@@ -229,7 +247,8 @@ Possible values:
} }
\snmpentrys{WR-WRPC-MIB}{wrpcPtpConfigGroup}{wrpcPtpConfigSfpPn}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpConfigGroup}{wrpcPtpConfigSfpPn}{
\underline{Description:} \underline{Description:}
Read-write object. SFP product number identifying which entry in the Flash SFP databse to Read-write object. SFP product number identifying which entry in the Flash
SFP database to
update. } update. }
\snmpentrys{WR-WRPC-MIB}{wrpcPtpConfigGroup}{wrpcPtpConfigDeltaTx}{ \snmpentrys{WR-WRPC-MIB}{wrpcPtpConfigGroup}{wrpcPtpConfigDeltaTx}{
\underline{Description:} \underline{Description:}
......
doc/wrpc_failures/wrpc_failures.tex
View file @ 9d3b7924
...@@ -45,8 +45,9 @@ ...@@ -45,8 +45,9 @@
\setlength{\parsep}{0pt} \setlength{\parsep}{0pt}
}{\end{itemize}} }{\end{itemize}}
% \begin{itemize}[leftmargin=50pt] %,topsep=-12pt]
\newenvironment{packed_items_snmp_obj}{ \newenvironment{packed_items_snmp_obj}{
\begin{itemize}[leftmargin=50pt,topsep=-12pt] \begin{itemize}[leftmargin=50pt]
\setlength{\itemsep}{1pt} \setlength{\itemsep}{1pt}
\setlength{\parskip}{0pt} \setlength{\parskip}{0pt}
\setlength{\parsep}{0pt} \setlength{\parsep}{0pt}
...@@ -269,18 +270,6 @@ ...@@ -269,18 +270,6 @@
\newpage \newpage
\input{snmp_exports.tex} \input{snmp_exports.tex}
\appendix
%\newpage
%\section{Operator's diagnostic example}
%\input{diamon_example.tex}
%\newpage
%\section{Sorted list of all MIB objects}
%\label{sec:snmp_exports:sorted}
%% print alphabetical list
%\printnoidxglossary[type=snmp_all,style=tree,sort=letter]
% add not used entries, but don't display their's section % add not used entries, but don't display their's section
% based on: % based on:
% http://tex.stackexchange.com/questions/115635/glossaries-suppress-pages-when-using-glsaddall % http://tex.stackexchange.com/questions/115635/glossaries-suppress-pages-when-using-glsaddall
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment