153 lines
11 KiB
Markdown
153 lines
11 KiB
Markdown
# RF-001: аппаратная подготовка и результаты
|
||
|
||
17 сентября 2026 года. **Аппаратная подготовка не завершена; RF-001A и
|
||
RF-001B не проводились. RF TX = 0.** Этот файл фиксирует уже выполненную
|
||
инвентаризацию основного ПК и оставшиеся проверки. Числа из программных
|
||
RF-001/CLOCK-001 не выдаются за результат эфира.
|
||
|
||
## Версия проекта и граница работы
|
||
|
||
| Поле | Значение |
|
||
|---|---|
|
||
| Ветка | `video-development` |
|
||
| HEAD | `3c31bac0da5d4f7eca5e1fbf9cf3b2eb32b5d650` |
|
||
| Коммит | `CLOCK-001: validate independent-clock QPSK receiver` |
|
||
| Основной ПК после коммита | рабочее дерево чистое |
|
||
| Push | не выполнялся |
|
||
| Основной режим будущего теста | QPSK, 500 ксимв/с, FEC 2/3, payload 256 байт, 100 пакетов, пауза 5 мс |
|
||
| Видео / внешний FEC | выключены |
|
||
|
||
Коммит содержит также файловую подготовку RF-001, от которой зависит
|
||
CLOCK-001. На RX-ноутбуке этот же HEAD **ещё не подтверждён**. До его
|
||
проверки и локального файлового круга 100/100 RF-эксперимент не начинается.
|
||
|
||
Для передачи коммитов **без push** создан проверенный Git bundle
|
||
`data/raw/rf001/bringup_main_20260917/video005_clock001_from_95f6640.bundle`:
|
||
89 319 байт, SHA-256
|
||
`1d63e918f02f5f6e683f768496f586890dcddf7462c03c37afbab75f2c1bbe39`.
|
||
Он содержит точный `video-development` HEAD и требует, чтобы на RX-ноутбуке
|
||
уже был базовый коммит `95f664076a225b083d5bacee0135831f3c992c93`.
|
||
Файл лежит в игнорируемом Git `data/raw` и **не передан** на второй ноутбук.
|
||
После копирования сначала сверить SHA и `git bundle verify`; при отсутствии
|
||
базового коммита остановиться, а не перестраивать историю. При чистом
|
||
дереве переход на полученный HEAD возможен только fast-forward.
|
||
|
||
## Инвентаризация основного ПК: TX-узел
|
||
|
||
Один раз запущен `hackrf_info` из локального комплекта host tools, без RX/TX.
|
||
Исходный вывод сохранён в игнорируемом Git файле
|
||
`data/raw/rf001/bringup_main_20260917/hackrf_info.txt` (SHA-256
|
||
`2f025656208646c0e4bf7df411ca765436ddfc3bfc1942d00643224d9df48f50`).
|
||
Команда завершилась с кодом 0 и обнаружила **одно** устройство:
|
||
|
||
| Поле | Прочитанное значение |
|
||
|---|---|
|
||
| `hackrf_info` / host library | `2024.02.1` / `2024.02.1 (0.9)` |
|
||
| Board ID | `4 (HackRF One)` |
|
||
| Hardware revision | `r9` |
|
||
| Firmware / API | `2024.02.1` / `1.08` |
|
||
| Serial | `000000000000000097c063dc323b97d3` |
|
||
| Part ID | `0xa000cb3c 0x00744f5a` |
|
||
| USB speed | `NOT_REPORTED_BY_HACKRF_INFO` |
|
||
|
||
`hackrf_info` также сообщил, что плата не выглядит произведённой Great
|
||
Scott Gadgets. Обозначение Auron HackRF Plus взято из постановки; команда
|
||
определяет совместимый Board ID HackRF One и сама по себе не подтверждает
|
||
изготовителя. Успешное перечисление доказывает доступность устройства по
|
||
USB для управляющей команды, но не пропускную способность 8 Мвыб/с, не
|
||
отсутствие потерь RX и не готовность к TX. Запрос Windows PnP в этой сессии
|
||
вернул отказ доступа (`0x80041003`); скорость USB пока не установлена.
|
||
Прошивка, CPLD, драйвер и конфигурация общей опоры не менялись.
|
||
|
||
После коммита на основном ПК повторно прочитан сохранённый программный
|
||
`tx_waveform.c64le`: 70 670 624 байта, SHA-256
|
||
`7cd81395efaa88b623b7e4e5a02e3a80b52185007397ea56ceaacc13353974b2`.
|
||
Файловый приём с TX-ведомостью дал **100 CRC-valid и 100 точных пакетов**,
|
||
raw BER 0. Это контроль основного ПК, не проверка второго ноутбука.
|
||
|
||
## Незавершённые проверки RX-ноутбука
|
||
|
||
Пользователь сообщил, что удалённый доступ настроен. На основном ПК запущен
|
||
AnyDesk, но доступного в этой сессии канала команд к RX-ноутбуку пока нет:
|
||
единственное устройство в Remote Desktop Commander имеет статус `offline`,
|
||
а интерактивные окна удалённого сеанса здесь не доступны. Принадлежность
|
||
зарегистрированного устройства RX-ноутбуку не подтверждена. Поэтому локальные
|
||
выводы второго ноутбука пока не получены.
|
||
Следующие поля остаются `NOT_RUN`: `hackrf_info` второго SDR, host/firmware,
|
||
serial и USB-подключение; ветка/HEAD/чистота Git; Python и зависимости;
|
||
локальный файловый круг 100/100; RX-only захват 8 Мвыб/с, скорость записи,
|
||
счётчики overruns, размер и SHA исходного IQ, clipping. Значения нельзя
|
||
заменять историческими результатами Lab064 или нулями.
|
||
|
||
На RX-ноутбуке сначала сохранить полный вывод команд `git status --short`,
|
||
`git branch --show-current`, `git rev-parse HEAD`, `python --version`,
|
||
`git --version`, `hackrf_info`. Затем создать новый каталог для файлового
|
||
TX dry-run и запустить `tools/qpsk_rf_rx.py` на сохранённом IQ с TX-ведомостью.
|
||
Требование: 100 сгенерированных, 100 CRC-valid и 100 точных пакетов. Эти
|
||
команды не открывают SDR, кроме отдельно названного `hackrf_info`.
|
||
|
||
После проверки Git и установки зависимостей файловый круг можно запустить
|
||
на RX-ноутбуке из корня проекта так, чтобы не перезаписать старый результат:
|
||
|
||
```powershell
|
||
$run = Get-Date -Format 'yyyyMMdd_HHmmss'
|
||
$directory = Join-Path 'data/raw/rf001' "rx_laptop_offline_$run"
|
||
python -B -X utf8 tools/qpsk_rf_tx.py --output-dir $directory
|
||
python -B -X utf8 tools/qpsk_rf_rx.py `
|
||
--iq-file (Join-Path $directory 'tx_waveform.c64le') `
|
||
--truth-metadata (Join-Path $directory 'tx_metadata.json') `
|
||
--report "data/processed/rf001/rx_laptop_offline_${run}.json"
|
||
```
|
||
|
||
Полный JSON и stdout обеих команд нужно сохранить. Нельзя делать вывод
|
||
«100/100 на втором ноутбуке» по готовому отчёту основного ПК.
|
||
|
||
RX-only проба на втором ноутбуке допустима только после этих проверок.
|
||
Сначала сохранить **исходный** `cs8` IQ и stdout/stderr инструмента, затем
|
||
сверить число отсчётов и SHA, все промежуточные и финальные наблюдения
|
||
overrun, насыщение кодов I/Q и скорость записи. Ненулевой, нечистый или
|
||
неполный счётчик запрещает PASS и переход к RF TX. Формат захвата и поля
|
||
metadata описаны в `RF_001_PLAN.md`. Пока RX-only проба **не выполнялась**.
|
||
|
||
## Будущие RF-001A и RF-001B
|
||
|
||
| Метрика | RF-001A, общая 10 МГц | RF-001B, независимые такты | Разница |
|
||
|---|---|---|---|
|
||
| Захват, состояние счётчиков | NOT_RUN | NOT_RUN | NOT_ESTIMATED |
|
||
| Точные пакеты из 100 / доля успеха | NOT_RUN | NOT_RUN | NOT_ESTIMATED |
|
||
| Raw BER / ошибки после FEC | NOT_RUN | NOT_RUN | NOT_ESTIMATED |
|
||
| Отказы CRC / пропуски / дубли | NOT_RUN | NOT_RUN | NOT_ESTIMATED |
|
||
| CFO, изменение CFO, timing drift | NOT_RUN | NOT_RUN | NOT_ESTIMATED |
|
||
| Оценка разницы sample clocks | NOT_RUN | NOT_RUN | NOT_ESTIMATED |
|
||
| Время приёмника | NOT_RUN | NOT_RUN | NOT_ESTIMATED |
|
||
|
||
RF-001A возможен после завершения bring-up и свежей проверки общей опоры.
|
||
RF-001B требует отдельного сеанса с отключённым проводом CLKOUT → CLKIN;
|
||
остальные RF-параметры, уровни, антенны и геометрия должны совпасть с A.
|
||
Каждый сеанс сохраняет свой raw IQ, metadata, ожидаемые SHA пакетов, полные
|
||
логи и результат файлового приёмника. Реальный ppm оценивать только по
|
||
фактическим данным B; если оценка ненадёжна, писать
|
||
`NOT_RELIABLY_ESTIMATED`. Программный результат CLOCK-001 не задаёт ppm плат.
|
||
|
||
Для каждого выхода в эфир нужны свежий аппаратный preflight и отдельное
|
||
прямое разрешение на TX. Одного успешного `hackrf_info`, программных 100/100
|
||
или исторической проверки общей опоры недостаточно. Критерий первого
|
||
короткого опыта: 99–100 точных пакетов — GOOD, 95–98 — PARTIAL, менее 95 —
|
||
не переходить к видео. Один прогон не даёт статистического доказательства;
|
||
повторы требуют отдельного согласования и сохранения каждого захвата.
|
||
|
||
## Текущее решение
|
||
|
||
| Поле | Статус |
|
||
|---|---|
|
||
| RF-001 hardware bring-up | **INCOMPLETE**: основной узел перечислен, RX-узел не проверен |
|
||
| RF-001A common clock | **NOT_RUN**, exact packets `null` |
|
||
| RF-001B independent clocks | **NOT_RUN**, exact packets `null` |
|
||
| Measured CFO / sample-clock offset / timing drift | **NOT_MEASURED** |
|
||
| Common-clock advantage | **NOT_ESTIMATED** |
|
||
| Independent-clock architecture | **UNDECIDED** по аппаратным данным |
|
||
| Следующий шаг | RX-ноутбук: инвентаризация → тот же HEAD → офлайн 100/100 → RX-only проба |
|
||
| RF TX / video / push | **0 / OFF / NOT PERFORMED** |
|
||
|
||
RF-002 не начинается автоматически.
|