# Глоссарий

Флоуграф (flowgraph)
: Граф обработки сигнала в GNU Radio — блоки и соединения между ними. В этом
  репозитории описывается файлом `.grc`, из которого `grcc` генерирует
  исполняемый Python-скрипт.

`.grc`
: Формат GNU Radio Companion (YAML). **Источник правды** в этом проекте:
  сгенерированные `.py` не коммитятся. См. [](dev/grc-conventions.md).

`grcc`
: Компилятор GNU Radio Companion: превращает `.grc` в `.py`. Запускается при
  сборке, поэтому все зависимости нужны уже на этапе `make`.

Иерархический блок (hier block)
: Флоуграф с `generate_options: hb`, устанавливаемый в палитру GNU Radio
  Companion как переиспользуемый блок. В сборке репозитория таких нет: два
  генератора в `test_flowgraphs/` — [](flowgraphs/index.md).

OOT-модуль
: Out-of-tree module — внешний набор блоков GNU Radio. Проект использует
  `gr-satnogs`, `gr-satellites` и `gr-soapy`.

SoapySDR
: Прослойка, дающая единый интерфейс к SDR-приёмникам разных производителей.
  Блок `soapy_source`, параметр `--soapy-rx-device` вида `driver=rtlsdr`.

Доплеровская компенсация
: Сдвиг частоты, устраняющий эффект Доплера от движения спутника. Блок
  `satnogs_doppler_compensation` получает текущий сдвиг от `rigctld`.

`rigctld`
: Сетевой демон Hamlib, управляющий трансивером и сообщающий частоту. Флоуграфы
  подключаются к нему по модели `NETRIGCTL` на `--rigctl-host:--rigctl-port`.

`rotctld`
: Аналогичный демон Hamlib для поворотного устройства антенны. Им управляет
  клиент станции, флоуграфы с ним не общаются.

Бодрейт (baudrate)
: Символьная скорость передачи. Приходит от клиента как `--baud`, диспетчер
  переименовывает его в `--baudrate` (или в `--wpm` для CW).

Децимация
: Понижение частоты дискретизации в целое число раз. В проекте вычисляется как
  `max(4, satnogs.find_decimation(baudrate, 2, 48000))` и определяет частоту
  всего тракта — [](dev/grc-conventions.md).

Дефреймер (deframer)
: Блок, выделяющий кадры из потока бит: ищет синхрослово, проверяет контрольную
  сумму, отдаёт полезную нагрузку сообщением. Например,
  `satellites_geoscan_deframer`.

Фрейминг (framing)
: Формат кадра канального уровня. Поддерживаются `ax25`, `ax100_mode5`,
  `ax100_mode6`, `ieee_802_15`, `amsat`, `argos`.

AX.25
: Классический любительский протокол канального уровня, унаследованный от
  пакетного радио. Самый распространённый фрейминг телеметрии кубсатов.

AX.100 Mode 5 / Mode 6
: Протоколы приёмопередатчиков GOMspace. Добавляют скремблирование, коды
  Рида—Соломона и проверку CRC поверх потока бит.

USP
: Unified SPUTNIX Protocol — формат телеметрии аппаратов «Спутникс». Режим
  `GMSK USP`, см. [](flowgraphs/usp.md).

PDU
: Protocol Data Unit — полезная нагрузка кадра. В JSON-файле кадра лежит в поле
  `pdu`, закодированная base64.

PMT
: Polymorphic Type — тип сообщений GNU Radio. Кадры передаются по ZMQ именно как
  сериализованные PMT: пара «метаданные, полезная нагрузка».

Водопад (waterfall)
: Спектрограмма наблюдения — зависимость спектра от времени. Пишет блок
  `satnogs_waterfall_sink`, БПФ на 1024 точки, 10 строк в секунду.

IQ
: Комплексный поток отсчётов (синфазная и квадратурная составляющие). В файл
  пишется как чередующиеся 16-битные целые после умножения на 16384.

GFSK / GMSK / MSK
: Разновидности частотной манипуляции со сглаживанием переходов. В диспетчере
  `FSK`, `GFSK`, `GMSK` и `MSK` ведут на один и тот же флоуграф.

APT
: Automatic Picture Transmission — аналоговая передача изображений метеоспутников
  NOAA.

SSTV
: Slow-Scan Television — медленная передача изображений. В этом форке режим
  `SSTV` пишет только аудио; декодирование картинки — под режимом `SSTV_PD120`.

DUV
: Data Under Voice — телеметрия AMSAT, передаваемая под голосовым каналом на
  200 бод.