Lab065: validate OTA gain improvement at TX VGA 20 dB

docs/lab065_current_state.md

@@ -0,0 +1,70 @@
+# Lab065: подготовка измерения при TX VGA 20 дБ
+
+Lab065 повторяет измерение Lab064 с одним изменением аппаратного параметра:
+TX VGA повышен с 10 до 20 дБ. Частота 1400000000 Гц, RX LNA/VGA 24/24 дБ,
+геометрия, антенны, кабели, общая опора и цифровой waveform сохранены.
+
+TX-файл Lab065 является побайтовой копией Lab064. Его SHA-256 должен быть равен
+`fa260719659b2984fe29588238415622cd75c6daefec6cc9130ba1bf851bd3f9`.
+Длина остаётся равной 6000000 комплексных отсчётов и 0,75 с. Ступени
+−18/−12/−6/0 дБ, PRBS7, BPSK, RRC, 20000 символов/с, Fs 8000000 отсчётов/с и
+цифровая несущая +50000 Гц не меняются.
+
+## Сравнение с Lab064
+
+Для L0, L1, L2 и L3 анализатор выдаёт изменение согласованной мощности,
+`|h|²`, остаточной мощности и matched/residual. Номинальное изменение TX VGA
+равно +10 дБ и приводится как справочная величина, а не как условие PASS.
+
+До RF зафиксированы численные правила:
+
+- линейность внутри Lab065: максимальная абсолютная ошибка шага не более 1 дБ;
+- компрессия: ошибка верхнего шага не более −1,5 дБ;
+- заметный прирост: медиана прироста matched power не менее 3 дБ;
+- заметное улучшение matched/residual: медиана не менее 3 дБ;
+- согласованность прироста четырёх уровней: разброс не более 3 дБ;
+- остаток считается растущим почти как сигнал, если его медианный прирост
+  отстаёт от медианного прироста matched power не более чем на 3 дБ.
+
+Эти пороги нужны для воспроизводимой классификации конкретного опыта. Они не
+заменяют измерение абсолютной RF-мощности.
+
+## Аппаратная граница
+
+Подготовка допускает программные проверки, common-clock preflight и RX-only
+запись фона. Любая команда с `-t` внутри preflight запрещена. Передача Lab065
+требует нового прямого разрешения пользователя и в текущий этап не входит.
+Автоматических повторов и изменения усилений после ошибки нет.
+
+`RF TX = 0`.
+
+## Результат подготовки
+
+Подготовка выполнена от HEAD
+`cff226e0bf9e36a627829ea11a4ca3292ae20953`. Software gate прошёл. Побайтовая
+копия waveform имеет требуемый SHA-256, подготовленная TX-команда содержит
+TX VGA 20 дБ, а RX-команда сохраняет LNA/VGA 24/24 дБ.
+
+Common-clock и RX-only preflight прошёл. Обе HackRF One r9 обнаружены с
+прежними ролями. MASTER и SLAVE имеют reg29 `0x26`; SLAVE CLKIN обнаружен на
+третьем опросе через 201,986 мс. В RX-фоне из 800000 отсчётов AC RMS равен
+1,056565 кода, max |I|/|Q| равны 6/8, clipping и overruns отсутствуют.
+Процессы до и после проверки имеют состояние CLEAR, ошибок очистки нет.
+
+Lab065 готова к рассмотрению перед одним RF-сеансом. Текущая подготовка такого
+разрешения не содержит. `RF TX = 0`.
+
+## Единственный RF-сеанс
+
+После отдельного прямого разрешения выполнен один TX. Общая опора прошла:
+MASTER/SLAVE reg29 `0x26`, SLAVE CLKIN обнаружен на втором опросе через
+136,897 мс. TX underrun, RX overrun, clipping и ошибки очистки отсутствуют.
+Повторов не было. RX содержит 16000000 отсчётов, SHA-256
+`845d7b7dcaef70e179ab69e6ba0041601859630786d2f4d51c16a8c1c7869d7e`.
+
+Медианный прирост matched power относительно Lab064 равен +11,233489 дБ,
+медианное изменение остатка +0,517004 дБ, улучшение matched/residual
++10,734495 дБ. Ошибки ступеней равны −0,077363/+0,034934/−0,013858 дБ.
+Признаков компрессии нет. Классификация: `LINEAR_GAIN_IMPROVEMENT`.
+
+[Полный RF-отчёт](lab065_rf_result.md). `RF TX = 0`.