Требования к системе

Операционная система

  • Рекомендуется: Debian 12 (Bookworm) или Raspberry Pi OS (Bookworm).

  • Архитектура: x86_64 или ARM (arm64, armv7 — Raspberry Pi).

Образ клиента собирается под linux/amd64, linux/arm64 и linux/arm/v7, поэтому Raspberry Pi 3 и новее подходят.

Программное обеспечение

Единственная зависимость на хосте — Docker и Docker Compose. Всё остальное (GNU Radio, gr-satnogs, gr-satellites, драйверы SoapySDR) уже внутри образа. Ставить GNU Radio на хост не нужно и не рекомендуется.

Железо

  • SDR-приёмник с поддержкой SoapySDR. Проверены и штатно настраиваются: Airspy (Mini / R2), RTL-SDR, HackRF, SDRplay (msi001/msi2500), LibreSDR.

  • Антенна на нужный диапазон (чаще всего VHF 137–146 МГц и UHF 400–470 МГц).

  • Поворотное устройство — опционально, см. Поворотное устройство.

  • Трансивер — опционально; по умолчанию клиент работает с фиктивным rigctld (Hamlib model 1, dummy), который лишь принимает команды доплеровской коррекции.

Ресурсы

Клиент — только оркестратор, но DSP внутри контейнера требует заметных ресурсов:

  • ОЗУ: от 2 ГБ. В docker-compose.yml контейнеру выделяется shm_size: 1gb под разделяемые буферы GNU Radio.

  • Диск: ~4 ГБ под образ плюс запас под наблюдения. Рабочие файлы и логи лежат в томе /var/lib/soniks-client и переживают перезапуск контейнера. Выгруженные файлы с диска убираются, но невыгруженные ждут в incomplete/ столько, сколько потребуется.

  • Сеть: постоянный доступ к https://sonik.space/api/. Клиент опрашивает расписание раз в минуту и выгружает данные во время и после прохода.

Примечание

Если вы включаете запись IQ (FLOWGRAPH__ENABLE_IQ_DUMP=True, нужно для METEOR), поток пишется на диск со скоростью в десятки мегабайт в секунду. Указывайте FLOWGRAPH__IQ_DUMP_FILENAME на реальный диск с запасом места, а не в tmpfs.

Точность времени

Расчёт положения спутника и доплеровского сдвига идёт от системных часов. Убедитесь, что на хосте работает NTP (timedatectl statusNTP service: active). Уход часов на несколько секунд смещает окно прохода и портит приём.