Справочник флоуграфов¶

В репозитории 23 файла .grc в трёх каталогах:

generic/: 11 флоуграфов общего назначения — модуляции и протоколы, не привязанные к конкретному спутнику. Разбор: Флоуграфы общего назначения.
satellites/: 9 декодеров под конкретные спутники и протоколы. Разбор: Декодеры под конкретные спутники, Декодер Geoscan, Декодер USP (Спутникс).
test_flowgraphs/: 3 файла для ручного тестирования — генераторы сигналов и один стенд декодера. В сборку не входят, см. ниже.

Приёмный тракт до демодулятора у всех флоуграфов общий и правится в одном месте — generic/fm.grc — с раскладкой tools/sync_frontend.py, см. Соглашения в .grc.

Сводная таблица¶

Файл	Режим-потребитель	Что на выходе
`generic/afsk1200_ax25.grc`	`AFSK`	кадры, аудио
`generic/bpsk.grc`	`BPSK`	кадры, аудио
`generic/cw_decoder.grc`	`CW`	кадры, аудио
`generic/example_flowgraph.grc`	—	ничего (шаблон)
`generic/fm.grc`	`FM`, `SSTV`	аудио
`generic/fsk_ax100_mode5.grc`	`FSK`/`MSK AX.100 Mode 5`	кадры, аудио
`generic/fsk_ax100_mode6.grc`	`FSK`/`MSK AX.100 Mode 6`	кадры, аудио
`generic/fsk_ax25.grc`	`FSK`, `GFSK`, `GMSK`, `MSK`	кадры, аудио
`generic/iq_receiver.grc`	—	только IQ и водопад
`generic/sstv_pd120_demod.grc`	`SSTV_PD120`	изображение, аудио
`generic/unknown_transmission.grc`	`UNKNOWN`	аудио, IQ
`satellites/amsat_fox_duv_decoder.grc`	`DUV`	кадры, аудио
`satellites/argos_bpsk_ldr.grc`	`BPSK PMT-A3`	кадры, аудио
`satellites/fsk_phasma_decoder.grc`	`GFSK Pkst`, `FSK` на 50k/400k	кадры, аудио
`satellites/genesis_fsk.grc`	`GENESIS FSK`	аудио
`satellites/geoscan_gfsk_decoder.grc`	`GFSK_GEOSCAN`	кадры, аудио
`satellites/noaa_apt_decoder.grc`	`APT`	изображение, аудио
`satellites/qubik_telem.grc`	`GFSK/BPSK`	кадры, аудио
`satellites/reaktor_hello_world_fsk9600_decoder.grc`	`GFSK Rktr`	кадры, аудио
`satellites/usp_fsk_decoder.grc`	`GMSK USP`	кадры, аудио
`test_flowgraphs/fsk_coherent_generator.grc`	—	генератор, вне сборки
`test_flowgraphs/psk_generator.grc`	—	генератор, вне сборки
`test_flowgraphs/frame_decoder_zmq_test.grc`	—	стенд, вне сборки, неисправен

Все флоуграфы дополнительно пишут водопад и шлют IQ по UDP; кадры и IQ на диск попадают через подписчиков, см. Выходные данные.

Тестовые флоуграфы¶

Каталог test_flowgraphs/ — не автотесты, а инструменты для ручной проверки по петле: генераторы сигнала, которым можно скормить декодер без эфира.

Файл	Что это
`fsk_coherent_generator.grc`	Иерархический блок-передатчик: биты → `digital_chunks_to_symbols` → повтор `sps_tx` → `analog_frequency_modulator_fc`. Параметры `m_ary`, `mod_index`, `sps_tx`
`psk_generator.grc`	Иерархический блок-передатчик на `digital_constellation_modulator`, созвездия `bpsk`, `qpsk`, `dqpsk`, `psk8`, `qam16`. Параметры `constellation`, `excess_bw`, `sps_tx`
`frame_decoder_zmq_test.grc`	Автономный стенд: чтение IQ из файла → `digital_fll_band_edge_cc` → ФНЧ → квадратурный демодулятор → восстановление тактовой → `satnogs_frame_decoder` → ZMQ

Каталог выведен из сборки: grcc -u писал бы в домашний каталог сборщика на этапе make, а не make install. Ставится вручную — grcc -u *.grc кладёт блоки в gnuradio-config-info --persistentdir (обычно ~/.grc_gnuradio).

Примечание

frame_decoder_zmq_test.grc жёстко ссылается на несуществующий файл iq_9888458.raw и публикует на порт 55555, не согласованный с zmq_base_port. Использовать его можно, только открыв вручную в GRC и поправив путь к файлу.

Автоматические тесты живут в tests/ и проверяют не сигнал, а инварианты .grc и контракт аргументов диспетчера — см. Как вносить изменения.

До 2026-09-12 рядом лежал каталог hierarchical/ с шестью блоками GRC, задуманными как лекарство от копипасты. Ни один флоуграф их не использовал, а сами они отражали архитектуру до ZMQ (file_sink, ogg_encoder) и не содержали soapy_source. Удалены; роль «одной правки» выполняет золотой фронтенд.