提交SMOD ATSC IMX APP版本 V122

2026-07-16 14:35:59 +08:00
commit 7601c270d5
485 changed files with 255032 additions and 0 deletions
@@ -0,0 +1,56 @@
+#ifndef __IQ_RX_H__
+#define __IQ_RX_H__
+
+/* ORx IQ receive/analysis thread (task/iq_rx.c). */
+void *iq_rx_thr(void *arg);
+
+/* Runtime spectrum/IQ processing switch. Defaults to disabled after boot. */
+int iq_spec_get_enable(void);
+void iq_spec_set_enable(int enable);
+
+/*
+ * Newest UIMD/LIMD measured on the imx6's own 10 MSPS ORx window.
+ *
+ * Same taps as the FPGA's imd_imd_fft_meas -- centre bin at +24.414 kHz and the two
+ * shoulder bins at +-3.1494 MHz -- but averaged over 11 bins (+-12.2 kHz) each and
+ * Welch-averaged over the whole 26.2 ms window. LIMD is always the shoulder on the
+ * pilot's side of the carrier; which one that is follows the measured pilot, so a
+ * spectral inversion cannot silently swap the two.
+ *
+ * The FPGA's own registers cannot be used any more: its 20-bit |DFT|^2 output
+ * quantises the shoulder bins to 0 once the shoulder is better than ~45 dB, and
+ * lcd_task.c's `if (imd_l == 0) imd_l = 1` then reports a constant.
+ *
+ * limd_db/uimd_db are 10*log10(P_centre / P_shoulder), i.e. positive dB, no +11 dB
+ * display offset applied.
+ *
+ * Returns 1 and fills both pointers when a window newer than IQ_IMD_MAX_AGE seconds
+ * is available, 0 otherwise (caller should keep whatever it had).
+ */
+#define IQ_IMD_MAX_AGE 10
+
+/* The 8VSB demod runs on a nice'd thread on a core that is already ~40% busy in
+ * softirq, so a fresh window lands every ~10 s rather than every second. */
+#define IQ_SNR_MAX_AGE 30
+
+int iq_get_imd(float *limd_db, float *uimd_db);
+
+/*
+ * 8VSB demodulation of one complete window (task/iq_vsb.c): matched filter, symbol
+ * recovery, SNR and the eye-diagram density map, published as /tmp/iq_eye.json.
+ * `win` is the raw window buffer (262144 big-endian int16 I/Q pairs).
+ */
+void iq_vsb_analyse(const unsigned char *win, int wid);
+
+/*
+ * Newest 8VSB SNR (== MER, I-path definition) measured on that window. Returns 1 and
+ * fills snr_db when a window newer than IQ_IMD_MAX_AGE seconds has been demodulated
+ * with segment sync locked, 0 otherwise.
+ *
+ * This replaces the value lcd_task.c used to fabricate: its "limit snr display" block
+ * overwrote the FPGA's SNR with a two-valued function of the (bottomed-out) IMD.
+ */
+int iq_get_snr(float *snr_db);
+void iq_vsb_clear_results(void);
+
+#endif /* __IQ_RX_H__ */