WR-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
Diangostic values available via SNMP for WR-streamers
Table below shows the values that are available fro WR-Streamers via SNMP. Each value can be read using one, two, or more OIDs that are listed below. Most of the values are 64-bit values that are read as two 32-bit values (LSB and MSB).
name | source | Units | Example threashold |
reset | reset | N/A | must be 0 |
overflow | overflow | N/A | must be 0 |
rest time | (rest time MSB)<<32 + (rest time LSB) seconds and 8*(rest time CYC) nanoseconds | time from epoch | not be 0 |
latency max | 8*( latency max )/1000 | [us] | < 10 " |
frames sent | ( frames sent MSB)<<32 + ( frames sent LSB) | [frame] | N/A |
frames received | ( frames received MSB)<<32 + ( frames received LSB) | [frame] | N/A |
frames lost | ( frames lost MSB)<<32 + ( frames lost LSB) | [frame] | must be 0 |
blocks lost | ( blocks lost MSB)<<32 + ( blocks lost LSB) | [blocks] | must be 0 |
average latency | 8*[{( blocks lost MSB)<<32 + ( blocks lost LSB) } /{( blocks lost MSB)<<32 + ( blocks lost LSB) }]/1000 | [us] | N/A |
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)
To be added in v4.3 of WRPC, see
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 | wrpcAuxDiagOID | 1.3.6.1.4.1.96.101.2.1.2.1.1 |
MIBs specific for the WR-streamers (read-only)
name | OID number | OID name | Units | Meaning | Example threashold |
reset | 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 |
overflow | 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 |
rest time CYC | 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 |
rest time LSB | 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 |
rest time MSB | 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 |
latency max | 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 |
latency min | 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 | <10000 [ns] |
frames sent LSB | 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 |
frames sent MSB | 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 |
frames received LSB | 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 |
frames received MSB | 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 |
frames lost LSB | 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 |
frames lost MSB | 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 |
blocks lost LSB | 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 |
blocks lost MSB | 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 |
latency acc cnt LSB | 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 |
latency acc cnt MSB | 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 |
latency acc LSB | 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 |
latency acc MSB | 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 |
debug | 1.3.6.1.4.1.96.101.2.1.2.1.1.21.1 | wrpcAuxDiag102RoInputWord.1 | N/A | debug word | N/A |
magic | 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