nearlink_sdr.phy.timing¶
Packet-local PSK clock recovery after matched filtering (TXS-10002-2025 §6.2.1.2).
The standard defines the waveform; this NDA Gardner/PI receiver is an implementation choice, not a mandated algorithm or a statement of clock-compliance limits.
Module Contents¶
Classes¶
Normalized loop bandwidth and experimental integral rate bound. |
Functions¶
Track a single packet without decisions, expected payload, CRC or modulation labels. |
API¶
- class nearlink_sdr.phy.timing.PSKTimingConfig[源代码]¶
Normalized loop bandwidth and experimental integral rate bound.
Gains assume beta=.4 RRC and power-normalized complex Gardner error. The detector gain 1.2 per symbol was measured with the independent TX reference for both alternating-rotation QPSK and 8PSK. Bounds are not SLE limits.
- nearlink_sdr.phy.timing.track_psk_timing(filtered: numpy.ndarray, sps: int, start: float, stop: float, *, hold_symbols: int = 32, config: nearlink_sdr.phy.timing.PSKTimingConfig | None = None) dict[源代码]¶
Track a single packet without decisions, expected payload, CRC or modulation labels.
startis the already selected known-sync center,stopan exclusive original-sample bound. Hold the sync centers fixed, then update the NCO phase and rate for every symbol. Error = Re[(previous-current)*conj(midpoint)] / power. Positive error advances the next center toward a later sample. Returned rate is the PI integrator state; it is not calibrated SRO or an independent truth.Cubic coefficients are built once; the feedback loop uses scalar Horner evaluation rather than a SciPy call per symbol. Centered matched filtering and cubic lookahead remain offline; state resets for every packet.