Automation Knowledge Base


M_TIMESYNC mode

Explanation

Control how the test module time-stamp clock is running, either freely in the chassis or locked to an external system time.

Running with free chassis time allows nano-second precision measurements of latencies, but only when the transmitting and receiving ports are in the same chassis. Running with locked external time enables inter-chassis latency measurements, but can introduce small time discontinuities as the test module time is adjusted.

Summary

 set and get, value type: B

Parameters

mode: coded byte, selecting the time sync mode: [ CHASSIS | EXTERNAL | MODULE]

Example

0 M_TIMESYNC CHASSIS


M_TIMEADJUSTMENT adjust

Explanation

Control time adjustment for module wall clock.

Summary

set and get, value type: I

Parameters

adjust: integer, adjustment in nanoseconds. This value should be a multiple of 8 as it will be converted to a number of 125 MHz clocks.

Example

0 M_TIMEADJUSTMENT 64


M_CLOCKPPB ppb

Explanation

Makes small adjustments to the local clock of the test module, which drives the TX rate of the test ports.

Summary

 set and get, value type: I

Parameters

 ppb: adjustment from nominal value, in parts-per-billion, positive or negative.

Example

 0 M_CLOCKPPB -200000


M_SMASTATUS status

Explanation

For test modules with SMA connectors, this returns the status of the SMA input.

Summary

get, value type: B

Parameters

status: coded byte, specifying the status of the SMA input:

  • OK (valid signal is received)
  • NO_VALID_SIGNAL (no valid signal is received

Example

0 M_SMASTATUS OK


M_SMAINPUT smain

Explanation

For test modules with SMA connectors, selects the function of the SMA input.

Summary

set and get, value type: B

Parameters

smain: coded byte, specifying the function:

  • NOTUSED
  • TX2MHZ (nominal 2.048 MHz reference clock for port TX rate)
  • TX10MHZ (nominal 10.0 MHz reference clock for port TX rate)

Example

0 M_SMAINPUT NOTUSED


M_SMAOUTPUT smaout

Explanation

For test modules with SMA connectors, selects the function of the SMA output.

Summary

set and get, value type: B

Parameters

smaout: coded byte, specifying the function:

  • DISABLED
  • PASSTHROUGH (replica of the SMA input signal)
  • P0SOF (start-of-frame pulse for port 0 TX)
  • P1SOF (start-of-frame pulse for port 1 TX)
  • REF2MHZ (nominal 2.048 MHz reference clock from TX port rate)
  • REF10MHZ (nominal 10.0 MHz reference clock from TX port rate)
  • REF156MHZ (nominal 156.25 MHz reference clock from TX port rate)
  • P0RXCLK (recovered clock from port 0 RX)
  • P1RXCLK (recovered clock from port 1 RX)
  • TS_PPS (timing reference in pulse-per-second format)

Example

0 M_SMAOUTPUT DISABLED


M_TXCLOCKSOURCE txclk

Explanation

For test modules with advanced timing features, select what drives the port TX rates.

Summary

 set and get, value type: B

Parameters

txclk: coded byte, specifying the function:

  • MODULELOCALCLOCK (default, the local oscillator of the test module)
  • SMAINPUT (clock derived from the reference on the SMA input)
  • P0RXCLK (SyncE, clock derived from RX clock of port 0)
  • P1RXCLK (SyncE, clock derived from RX clock of port 1)

Example

0 M_TXCLOCKSOURCE MODULELOCALCLOCK


M_TXCLOCKFILTER filter

Explanation

For test modules with advanced timing features, the loop bandwidth on the TX clock filter.

Summary

set and get, value type: B

Parameters

filter: coded byte, specifying the bandwidth:

  • BW103HZ (bandwidth of 103 Hz)
  • BW207HZ (bandwidth of 207 Hz)
  • BW416HZ (bandwidth of 416 Hz)
  • BW1683HZ (bandwidth of 1683 Hz)
  • BW7019HZ (bandwidth of 7019 Hz)

Example

0 M_TXCLOCKFILTER BW114HZ


M_TXCLOCKSTATUS status

Explanation

For test modules with advanced timing features, check whether a valid clock is present.

Summary

get only, value type: B

Parameters

status: coded byte, specifying the function:

  • OK
  • NOVALIDTXCLK (no valid clock, can be missing SMA input or no clock recovery from test port)

Example

0 M_TXCLOCKSTATUS OK


M_TIMESYNC mode

Explanation

Control how the test module time-stamp clock is running, either freely in the chassis or locked to an external system time.

Running with free chassis time allows nano-second precision measurements of latencies, but only when the transmitting and receiving ports are in the same chassis. Running with locked external time enables inter-chassis latency measurements, but can introduce small time discontinuities as the test module time is adjusted.

Summary

 set and get, value type: B

Parameters

mode: coded byte, selecting the time sync mode: [ CHASSIS | EXTERNAL | MODULE]

Example

0 M_TIMESYNC CHASSIS


M_TIMEADJUSTMENT adjust

Explanation

Control time adjustment for module wall clock.

Summary

set and get, value type: I

Parameters

adjust: integer, adjustment in nanoseconds. This value should be a multiple of 8 as it will be converted to a number of 125 MHz clocks.

Example

0 M_TIMEADJUSTMENT 64


M_CLOCKPPB ppb

Explanation

Makes small adjustments to the local clock of the test module, which drives the TX rate of the test ports.

Summary

 set and get, value type: I

Parameters

 ppb: adjustment from nominal value, in parts-per-billion, positive or negative.

Example

 0 M_CLOCKPPB -200000


M_SMASTATUS status

Explanation

For test modules with SMA connectors, this returns the status of the SMA input.

Summary

get, value type: B

Parameters

status: coded byte, specifying the status of the SMA input:

  • OK (valid signal is received)
  • NO_VALID_SIGNAL (no valid signal is received

Example

0 M_SMASTATUS OK


M_SMAINPUT smain

Explanation

For test modules with SMA connectors, selects the function of the SMA input.

Summary

set and get, value type: B

Parameters

smain: coded byte, specifying the function:

  • NOTUSED
  • TX2MHZ (nominal 2.048 MHz reference clock for port TX rate)
  • TX10MHZ (nominal 10.0 MHz reference clock for port TX rate)

Example

0 M_SMAINPUT NOTUSED


M_SMAOUTPUT smaout

Explanation

For test modules with SMA connectors, selects the function of the SMA output.

Summary

set and get, value type: B

Parameters

smaout: coded byte, specifying the function:

  • DISABLED
  • PASSTHROUGH (replica of the SMA input signal)
  • P0SOF (start-of-frame pulse for port 0 TX)
  • P1SOF (start-of-frame pulse for port 1 TX)
  • REF2MHZ (nominal 2.048 MHz reference clock from TX port rate)
  • REF10MHZ (nominal 10.0 MHz reference clock from TX port rate)
  • REF156MHZ (nominal 156.25 MHz reference clock from TX port rate)
  • P0RXCLK (recovered clock from port 0 RX)
  • P1RXCLK (recovered clock from port 1 RX)
  • TS_PPS (timing reference in pulse-per-second format)

Example

0 M_SMAOUTPUT DISABLED


M_TXCLOCKSOURCE txclk

Explanation

For test modules with advanced timing features, select what drives the port TX rates.

Summary

 set and get, value type: B

Parameters

txclk: coded byte, specifying the function:

  • MODULELOCALCLOCK (default, the local oscillator of the test module)
  • SMAINPUT (clock derived from the reference on the SMA input)
  • P0RXCLK (SyncE, clock derived from RX clock of port 0)
  • P1RXCLK (SyncE, clock derived from RX clock of port 1)

Example

0 M_TXCLOCKSOURCE MODULELOCALCLOCK


M_TXCLOCKFILTER filter

Explanation

For test modules with advanced timing features, the loop bandwidth on the TX clock filter.

Summary

set and get, value type: B

Parameters

filter: coded byte, specifying the bandwidth:

  • BW103HZ (bandwidth of 103 Hz)
  • BW207HZ (bandwidth of 207 Hz)
  • BW416HZ (bandwidth of 416 Hz)
  • BW1683HZ (bandwidth of 1683 Hz)
  • BW7019HZ (bandwidth of 7019 Hz)

Example

0 M_TXCLOCKFILTER BW114HZ


M_TXCLOCKSTATUS status

Explanation

For test modules with advanced timing features, check whether a valid clock is present.

Summary

get only, value type: B

Parameters

status: coded byte, specifying the function:

  • OK
  • NOVALIDTXCLK (no valid clock, can be missing SMA input or no clock recovery from test port)

Example

0 M_TXCLOCKSTATUS OK