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

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

`generic/`
: 11 флоуграфов общего назначения — модуляции и протоколы, не привязанные к
  конкретному спутнику. Разбор: [](generic.md).

`satellites/`
: 9 декодеров под конкретные спутники и протоколы. Разбор:
  [](satellites.md), [](geoscan.md), [](usp.md).

`test_flowgraphs/`
: 3 файла для ручного тестирования — генераторы сигналов и один стенд декодера.
  В сборку не входят, см. ниже.

Приёмный тракт до демодулятора у всех флоуграфов общий и правится в одном
месте — `generic/fm.grc` — с раскладкой `tools/sync_frontend.py`, см.
[](../dev/grc-conventions.md).

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

| Файл | Режим-потребитель | Что на выходе |
|---|---|---|
| `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 на диск
попадают через подписчиков, см. [](../outputs.md).

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

Каталог `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`).

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

Автоматические тесты живут в `tests/` и проверяют не сигнал, а инварианты
`.grc` и контракт аргументов диспетчера — см. [](../dev/contributing.md).

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

```{toctree}
:maxdepth: 1

generic
satellites
geoscan
usp
```