Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NamePVDescription
Freq:PLL:NCO:FREQ_SWhen written this will set the PLL NCO to the given frequency.  If feedback is running the offset will briefly be forced to zero.

:PLL:NCO:FREQThis reads back the current NCO frequency.  This PV updates at 10Hz.
Offset:PLL:NCO:OFFSETThis is the current PLL offset, updated at 10Hz.
Gain:PLL:NCO:GAIN_DB_SThe NCO signal strength is configured here.   Clicking here links to NCO Gain Configuration.

:PLL:NCO:ENABLE_SThis PV turns the NCO output on or off.
Mean:PLL:NCO:MEAN_OFFSETThis is the mean offset computed over the last full OFFSETWF waveform.
Std:PLL:NCO:STD_OFFSETThis is the standard deviation computed over the last full OFFSETWF waveform.
Tune:PLL:NCO:TUNEThis is the fractional tune computed from the MEAN_OFFSET value and the base frequency.  This PV updates when MEAN_OFFSET updates, and is forced to NaN when feedback is not running.

...

NamePVDescription
I, Q

:PLL:FILT:I

:PLL:FILT:Q

Detector readbacks in I and Q components.  To regard the response as a complex number, compute

Mathinline
bodyr = I + i\times Q
.

Magnitude

:PLL:FILT:MAG

:PLL:FILT:MAG_DB

Magnitude of the detector response and converted to dB, relative to overflow at magnitude = 1.0.
Phase:PLL:FILT:PHASEPhase of the detector response.
Debug
Links to the Tune PLL Debug for a detailed view of the detector response.

:PLL:DEBUG:ENABLE_SThis PV indicates whether the debug readbacks are enabled.  This readback is normally not required, and the extra processing load can usefully be avoided by leaving this disabled when not required.
Mag rel std:PLL:DEBUG:RSTD_ABS, :PLL:DEBUG:RSTD_ABS_DB

"Magnitude relative standard deviation".  This pair of fields and "IQ rel std" below are an attempt to capture the quality of signal and lock as a single number.  This number should be small if there is a strong detector signal, but is not affected by the quality of the lock.  Given a debug IQ waveform

Unit
body\vec{z}
the relative standard deviation here is calculated as:

Mathblock
\frac{\text{std}(|\vec{z}|)}{\langle| \vec{z}|\rangle}

The :RSTD_ABS_DB  is simply

Mathinline
hostd2228c4b-e62e-3627-9b8b-c946cce47d9c
body--uriencoded--20\log_{10}%7B10%7D(\text{RSTD_ABS}text%7BRSTD\_ABS%7D)
.

IQ rel std:PLL:DEBUG:RSTD, :PLL:DEBUG:RSTD_DB

"IQ relative standard deviation".  This is intended to capture the quality of the PLL lock as a single number: this number should be small if there is little deviation in angle.  Give waveform

Unit
body\vec{z}
this is calculated as:

Mathblock
\frac{\text{std}(\vec{z})}{|\langle \vec{z}\rangle|}

Again, :RSTD_DB  is simply

Mathinline
body20\log_{10}(\text{RSTD})
.

...