Maciej LipinskiWR-streamers SNMP diagnostics
WRPC provides diagnostics via SNMP. The basic MIB for generic WRPC values can be extended for the purpose of application-specific cores (in general, an unlimited number of cores, each having its own MIB). This mechanism is used by WR Streamers to make its statistics available via SNMP.
The WR-streamers diagnostic via SNMP:
- is identified by reading OID in the MIB of WRPC that is generic for the application-specific extensions ****
- is the first to use this extension mechanism, and so has ID=1, thought we have already version=2 of it.
- is defined in the MIB file that can be found in wrpc-sw repository lib folder: WR-WRPC-AUX-STREAMERS-MIB.txt
Most of the values provided by the streamers are 64-bit values that are
read as two 32-bit values (LSB and MSB). Additionally, the average
latency needs to be calculated by dividing the accumulated latency by
the number of the accumulated values. Since the values might change
fast, we provide a mechanism that freezes the values (makes a coherent
snapshot of the data). Such a snapshot is done by writing 0x2 to
wrpcAuxDiag102RwControlRegister.1 ( 1.3.6.1.4.1.96.101.2.1.2.2.1.3.1).
After reading all values,
the data should be "un-frozen" by writing 0x0 to
wrpcAuxDiag102RwControlRegister.1 ( 1.3.6.1.4.1.96.101.2.1.2.2.1.3.1.
MIBs generic for the application-specific extensions (read-only)
| OID number | OID name | Value for this auxiliary diagnostic extension |
| 1.3.6.1.4.1.96.101.1. .1.1 | wrpcAuxDiagId | 1 |
| 1.3.6.1.4.1.96.101.1. .2.1 | wrpcAuxDiagVer | 2 |
| 1.3.6.1.4.1.96.101.1. .3.1 | wrpcAuxDiagName | WR Stremers |
| 1.3.6.1.4.1.96.101.1. .4.1 | wrpcAuxDiagMIB | 1.3.6.1.4.1.96.101.2.1.2.1.1 |
MIBs specific for the WR-streamers (read-only)
| OID number | OID name | Units | Meaning | Example threashold |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.3.1 | wrpcAuxDiag102RoStatus.1 | N/A | bit 0 is 1 if reset active | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.3.1 | wrpcAuxDiag102RoStatus .1 | N/A | bit 1 is 1 if overflow of latency accumulator | must be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.4.1 | wrpcAuxDiag102RoResetTimeCycles.1 | 8 [ns] | reset time: clock cycles within TAI second | must not be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.5.1 | wrpcAuxDiag102RoResetTimeTaiLsb.1 | [s] | reset time: LSB of TAI time in seconds | must not be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.6.1 | wrpcAuxDiag102RoResetTimeTaiMsb.1 | 2^32 [s] | reset time: MSB of TAI time in seconds | must not be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.7.1 | wrpcAuxDiag102RoLatencyMax.1 | 8 [ns] | maximum latency in clock cycles since reset | > 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.8.1 | wrpcAuxDiag102RoLatencyMin.1 | 8 [ns] | minimum latency in clock cycles since reset | <10 [us] |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.9.1 | wrpcAuxDiag102RoSentFrameCntLsb.1 | [frame] | number of transmitted frames (LSB) since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.10.1 | wrpcAuxDiag102RoSentFrameCntMsb.1 | 2^32 [frame] | number of transmitted frames (MSB) since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.11.1 | wrpcAuxDiag102RoRcvdFrameCntLsb.1 | [frame] | number of received frames (LSB) since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.12.1 | wrpcAuxDiag102RoRcvdFrameCntMsb.1 | 2^32 [frame] | number of received frames (MSB) since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.13.1 | wrpcAuxDiag102RoLostFrameCntLsb.1 | [frame] | number of lost frames (LSB) since reset | must be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.14.1 | wrpcAuxDiag102RoLostFrameCntMsb.1 | 2^32 [frame] | number of lost frames (MSB) since reset | must be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.15.1 | wrpcAuxDiag102RoLostBlockCntLsb.1 | [block] | number of lost blocsk (LSB) since reset | must be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.16.1 | wrpcAuxDiag102RoLostBlockCntMsb.1 | 2^32 [block] | number of lost blocsk (MSB) since reset | must be 0 |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.17.1 | wrpcAuxDiag102RoLatencyCntLsb.1 | [frame] | number of latency values accumulated (LSB) since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.18.1 | wrpcAuxDiag102RoLatencyCntMsb.1 | 2^32 [frame] | number of latency values accumulated (MSB) since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.19.1 | wrpcAuxDiag102RoLatencyAccLsb.1 | 8 [ns] | accumulated latency (LSB) in clock cycles since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.20.1 | wrpcAuxDiag102RoLatencyAccMsb.1 | 8*2^32 [ns] | accumulated latency (MSB) in clock cycles since reset | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.21.1 | wrpcAuxDiag102RoInputWord.1 | N/A | debug word | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.1.1.22.1 | wrpcAuxDiag102RoMagicNumber.1 | N/A | magic value 0xDEADBEEF | must be 0xDEADBEEF |
MIBs specific for the WR-streamers (read-write)
| OID number | OID name | Units | Meaning | Example threashold |
| 1.3.6.1.4.1.96.101.2.1.2.2.1.3.1 | wrpcAuxDiag102RwControlRegister.1 | N/A | bit 0 is set to 1, the statistics values are reset (write) | N/A |
| 1.3.6.1.4.1.96.101.2.1.2.2.1.3.1 | wrpcAuxDiag102RwControlRegister.1 | N/A | bit 1 is set to 1, the statistics values are frozen (write) | N/A |
18 December 2017