"""Tests for qpsk_model.py: mapping, filter taps, ROM files and an end-to-end loop.""" from __future__ import annotations import numpy as np import qpsk_model as m def test_gray_mapping_round_trip_and_neighbours() -> None: for b in range(4): i, q = m.gray_map(b) assert m.gray_demap(i, q) == b # Walk around the circle: (+,+) -> (-,+) -> (-,-) -> (+,-) -> back. order = [m.gray_demap(i, q) for i, q in [(1, 1), (-1, 1), (-1, -1), (1, -1)]] for a, b in zip(order, order[1:] + order[:1]): assert bin(a ^ b).count("1") == 1, "neighbours must differ in one bit" def test_dvb_s2_figure_9_mapping() -> None: # ETSI EN 302 307-1 figure 9: 00 at 45 deg, 10 at 135, 11 at 225, 01 at 315. assert m.gray_map(0b00) == (1, 1) assert m.gray_map(0b10) == (-1, 1) assert m.gray_map(0b11) == (-1, -1) assert m.gray_map(0b01) == (1, -1) def test_rrc_peak_matches_closed_form() -> None: h = m.rrc_taps_float() peak = 1 - m.ALPHA + 4 * m.ALPHA / np.pi # closed-form RRC value at t = 0 assert abs(h[len(h) // 2] - peak) < 1e-4 def test_rrc_pair_has_almost_no_isi() -> None: h = m.rrc_taps_float() r = np.convolve(h, h) # transmit filter + matched filter c = len(r) // 2 others = np.concatenate((r[c + m.SPS::m.SPS], r[c - m.SPS::-m.SPS])) assert np.max(np.abs(others)) / r[c] < 2e-3 # truncation to 6 symbols leaves < 0.2 % def test_integer_taps_fit_and_files_match() -> None: taps = m.rrc_taps_int() assert len(taps) == m.NTAPS assert np.array_equal(taps, taps[::-1]), "linear phase: symmetric taps" assert m.worst_case_sum(taps) <= m.Q15_MAX assert np.array_equal(m.read_hex(m.HERE / "rrc_taps.hex"), taps) assert np.array_equal(m.read_hex(m.HERE / "sine256.hex"), m.sine_table()) def test_tuning_word() -> None: assert m.tuning_word(25e6, 100e6) == 1 << 30 assert m.tuning_word(12.5e6, 100e6) == 0x2000_0000 def test_end_to_end_bits_come_back() -> None: rng = np.random.default_rng(18) n = 8000 valid = [1] * n bits = rng.integers(0, 4, n).tolist() tw = m.tuning_word(25e6, 100e6) out = m.tx_reference(valid, bits, tw) assert np.max(np.abs(out["i_bb"])) <= m.Q15_MAX y_i, y_q = m.coherent_receiver(out["s_out"], tw) delay = 4 + 2 * (m.NTAPS - 1) // 2 # pipeline + two filter group delays sent = list(range(0, n - delay - 1, m.SPS)) rx = [m.gray_demap(y_i[k + delay], y_q[k + delay]) for k in sent] assert rx == [bits[k] for k in sent]