Lab056: compare 20 and 500 ksymbol/s in controlled RF session

docs/lab056_rx_preflight.md

@@ -0,0 +1,98 @@
+# Lab056 — аппаратный common-clock и RX-only preflight
+
+10 сентября 2026 года, 12:16:28–12:16:29 по Москве.
+
+**Аппаратный preflight PASS. RF TX = 0. STOP перед отдельным разрешением TX.**
+Проверена общая опора и записан фон при выключенном передатчике.
+Сравнение A/B по эфиру ещё не выполнялось.
+
+```text
+RF_FREQ = 1400000000 Hz
+COMMON CLOCK = PASS; MASTER reg29=0x26; SLAVE reg29=0x26; SLAVE CLKIN=DETECTED
+RX PREFLIGHT = PASS; 800000 complex samples; 0.1 s; RX overruns=0
+CLIPPING = 0 / 800000 samples (0%)
+RF TX = 0
+READY FOR SINGLE ABAB TX = YES (technical preflight; separate authorization pending)
+STOP
+```
+
+## Условия
+
+По заданию пользователя 1400 МГц — только частота текущего лабораторного
+Lab056. Она не назначает рабочий диапазон SDR_Rover. Ориентир дальнейших
+полевых работ около 180 МГц рассматривается отдельно; антенна на этот
+диапазон уже имеется. Варианты 50/144 МГц здесь не исследуются.
+
+Схема задана пользователем: MASTER TX → TX-антенна → LOS → RX-антенна → SLAVE RX.
+Используются имеющиеся антенны на 1400 МГц. Точные модели/маркировка не
+сообщены и программно не установлены; они не являлись препятствием для
+этого RX-only этапа. Антенны неподвижны, ориентация и поляризация одинаковы.
+Расстояние по заданию примерно 3–5 м; точное измеренное значение отсутствует.
+Кабели и геометрия сохраняются на будущую ABAB.
+
+Аппаратный RX: Fs 8 Мвыб/с, LNA/VGA 24/24 дБ, RF amplifier и Bias-Tee OFF.
+Внешние PA/LNA не используются. TX VGA 10 дБ остаётся запланированным
+параметром будущего сеанса; TX в этом этапе не включался.
+
+MASTER `000000000000000097c063dc323b97d3` и SLAVE
+`000000000000000097c063dc2e5327d3` подтверждены свежей инвентаризацией.
+Обе платы определены как HackRF One r9 с firmware/libhackrf 2024.02.1.
+
+## Что выполнено
+
+Перед оборудованием подтверждены HEAD, пустой Git index, SHA проверенного
+кода и неизменность готового TX. Проверка процессов дала CLEAR.
+
+Выполнены короткие RX-start по 65 536 отсчётов на MASTER и SLAVE для выбора
+источника тактирования, чтения reg29 обеих плат и SLAVE CLKIN. Оба reg29
+равны 0x26; CLKIN обнаружен первым запросом, через 67,787 мс после начала
+ожидания опоры. Затем SLAVE записал 800 000 комплексных отсчётов RX, 0,1 с.
+Все три команды hackrf_transfer работали только с `-r`, на одной частоте
+и с одинаковыми RX-параметрами. Журнал команд не содержит `-t`.
+
+| Метрика сохранённого RX | Значение |
+|---|---:|
+| Размер CS8 | 1 600 000 байт |
+| Комплексных отсчётов | 800 000 |
+| Полная средняя мощность | 4,85388125 код² |
+| Мощность после удаления среднего | 0,6658039582 код² |
+| RMS полного IQ | 2,203152571 код |
+| Среднее I / Q | 0,92535625 / 1,82532 код |
+| Максимум абсолютного I / Q | 4 / 6 код |
+| Максимальная комплексная амплитуда | 6,08276253 код |
+| Отсчётов с rail-кодами −128/127 | 0 |
+| RX overruns | 0 |
+
+Цифровых признаков насыщения в этом RX-only фоне нет. Это не доказывает
+отсутствие перегрузки при включённом TX: его сигнал пока отсутствовал.
+Из этих отсчётов также нельзя установить абсолютную RF-мощность или
+доказать отсутствие аналоговой компрессии. При будущем разрешённом запуске
+сохраняются подготовленные проверки клиппинга без автоподбора gain.
+
+SHA-256 RX: `c4257f26e4cc8562eb32228f9a50fdeb055879c928af0744cdf4a81cf7cd085b`.
+SHA-256 TX: `5b34bbe1a8e6d037d2d6d367a74e9eb84e8940db7da61600ffaa7f7497d4f600`.
+После проверки CLKOUT обеих плат выключены успешно, процессы CLEAR,
+ошибок cleanup нет. Больше аппаратных действий не выполнялось.
+
+## Доказательства и STOP
+
+- [План и описание геометрии](../data/processed/lab056/rx_preflight_plan.json).
+- [Журнал фактических команд с временем и выводом](../data/processed/lab056/rx_preflight_commands.json).
+- [Результат RX-only preflight](../data/processed/lab056/rx_preflight_result.json).
+- Исходный RX и исходный результат: `data/raw/lab056/preflight_rx.cs8`,
+  `preflight_result.json`; маркер попытки: `preflight_attempt.json`.
+
+Код и TX waveform не менялись. Последние программные проверки относятся
+к этой же версии: 44 целевых теста, quick_gate 867/30/13 PASS и pytest
+867 passed. Полные тесты повторно не запускались для записи аппаратного
+результата. Git diff --check PASS. Lab054 NOT_A, 0/16 сохранён.
+
+Verifier проверил только сохранённые файлы: 12 команд, три RX-start,
+ни одной TX-команды; регистры, CLKIN, cleanup и параметры подтверждены
+по исходному выводу. Целочисленный пересчёт мощности/клиппинга и SHA
+полностью согласован с JSON. Воспроизведённых расхождений нет, PASS.
+Дополнительных аппаратных команд verifier не выполнял.
+
+HEAD `5add95ecb8865f59075bbbced08d97b183fb3b48`. Lab056 не коммитилась,
+push не выполнялся. Технические условия preflight выполнены; отдельного
+разрешения на единственный ABAB TX ещё нет. **STOP.**