soniks-flowgraphs

Флоуграфы GNU Radio для наземных станций сети Соникс и Python-запускатор flowgraph_dispatcher, который ими управляет.

Проект — форк satnogs-flowgraphs (ветка soniks). Он принимает сигнал с SDR-приёмника, компенсирует доплеровский сдвиг, демодулирует и декодирует телеметрию спутника, а результат отдаёт клиенту станции soniks-client-new в виде кадров, аудиозаписи, водопада и потока IQ.

Форк добавил к апстриму декодеры Geoscan и USP (Спутникс).

---

С чего начать

Оператору станции — Обзор, затем Установка и сборка и Быстрый старт. Если что-то не декодируется, смотрите Диагностика неисправностей.

Разработчику — Архитектура описывает сквозной путь данных и контракты между слоями; Добавление флоуграфа и режима — рецепт добавления нового режима.

Справочник — Справочник режимов (какой режим какой флоуграф запускает), flowgraph_dispatcher (все аргументы командной строки), Выходные данные (что и в каком формате пишется на диск), Справочник флоуграфов (разбор каждого .grc).

ИИ-агенту — начинайте с Контекст для ИИ-агента: там карта репозитория, инварианты и правила работы.

---

Основное

• Обзор
  • Что это
  • Место в инфраструктуре Соникс
  • Что происходит во время наблюдения
  • Отношение к апстриму SatNOGS
  • Что дальше
• Установка и сборка
  • Зависимости
  • Сборка из исходников
  • Сборка Debian-пакета
  • Проверка установки
• Быстрый старт
  • Подготовка
  • Приём в режиме FM
  • Приём телеметрии Geoscan
  • Запись IQ
  • Живой поток IQ по UDP
  • Что дальше
• Диагностика неисправностей
  • Сборка
  • Запуск
  • Приём
  • Куда смотреть дальше

Справочник

• Справочник режимов
  • Таблица режимов
  • Особые случаи
  • Флоуграфы вне таблицы
  • Добавление режима
• flowgraph_dispatcher
  • Аргументы командной строки
  • Правила переписывания аргументов
  • Жизненный цикл процессов
  • Ошибки запуска
• Выходные данные
  • Каналы ZMQ
  • Кадры телеметрии
  • Аудио
  • IQ
  • Водопад
  • Живой поток по UDP
• Справочник флоуграфов
  • Сводная таблица
  • Тестовые флоуграфы
• Глоссарий

Разработка

• Архитектура
  • Слои
  • Контракт 1: .grc — источник правды
  • Контракт 2: имена аргументов
  • Контракт 3: ZMQ и владение файлами
  • Порядок запуска
  • Что где лежит
  • Чего в проекте нет
• Соглашения в .grc
  • Именование и режим генерации
  • Общий набор параметров
  • Доплеровская компенсация
  • Децимация и частоты
  • Три обязательных ответвления
  • Рудиментарные параметры
  • Общий фронтенд
  • Проверка после правки
• Добавление флоуграфа и режима
  • 1. Создать .grc
  • 2. Внести файл в CMake
  • 3. Зарегистрировать скрипт и режим
  • 4. Новый параметр — в две стороны
  • 5. Собрать и проверить
  • 6. Обновить документацию
  • 7. Закоммитить
• Как вносить изменения
  • Подпись коммита обязательна
  • Атомарные коммиты
  • Сообщение коммита
  • Что нельзя коммитить
  • Документация — часть изменения
  • Проверка перед отправкой
  • Merge request
• Отношения с апстримом
  • Точка расхождения
  • Что мы берём, а что нет
  • Решение по MR от 2026‑07‑02: не внедрять
  • Если апстрим понадобится позже
• Известные расхождения
  • Сборка и упаковка
  • Флоуграфы
• Контекст для ИИ-агента
  • Правила работы
  • Что это за проект
  • Карта репозитория
  • Инварианты
  • Частые задачи
  • Ловушки
  • Проверка изменений

---

Лицензия: GPL-3.0. Исходники: git@gitlab.com:space-education-development/soniks/soniks-flowgraphs.git.