Документация СОНИКС Клиента¶
Клиент наземной станции для портала sonik.space.
Клиент опрашивает портал на предмет запланированных проходов спутников, во время
каждого прохода управляет SDR-приёмником, трансивером и поворотным устройством
через потоковые графы GNU Radio (gr-satnogs / gr-satellites), а затем
загружает на портал аудио, водопад и демодулированные кадры.
Поставляется Docker-образом, станции запускают его через docker compose.
Куда идти¶
- Я оператор станции — подключаю и настраиваю железо.
Проверьте по списку, что понадобится, и пройдите установку: восемь шагов от чистой Raspberry Pi до первого принятого спутника. Поля формы «Настройки станции» разобраны в настройке станции. Дальше — эксплуатация и полный справочник переменных окружения. Станция уже работает на старом клиенте — переход.
- Я разработчик — хочу дорабатывать клиент.
Начните с архитектуры — там жизненный цикл наблюдения целиком. Затем разделы по подсистемам: потоковый граф, скрипты и декодеры, загрузка данных, водопад. Проверка правки на живом железе — стенд. Правила участия — в contributing. Что известно сломанным и в каком порядке чинится — дорожная карта.
- Мне нужен справочник по коду.
Справочник API — автоматически сгенерирован из исходников.
- Я ИИ-агент.
Начинайте с Контекст экосистемы для ИИ-агента — устройство соседних проектов, контракты между ними и подтверждённые дефекты на их стороне. Затем Дорожная карта: надёжность сети — принятые решения и план работ по всей сети.
Станция
- Что понадобится
- Установка станции
- Шаг 1. Зарегистрируйте станцию на портале
- Шаг 2. Подготовьте Raspberry Pi
- Шаг 3. Установите Docker
- Шаг 4. Подготовьте систему к SDR-приёмнику
- Шаг 5. Скачайте файлы станции
- Шаг 6. Запустите станцию
- Шаг 7. Настройте приёмник на портале
- Шаг 8. Примите первый проход
- Если Docker уже был установлен
- Как устроена станция
- Переход со старого клиента
- Настройка станции
- Переменные окружения
- STATION — параметры станции
- URL — адреса портала
- MQTT — живой канал с порталом
- API — таймауты HTTP
- ANTENNA — поворотное устройство и трансивер
- OBSERVATION — параметры наблюдения
- FLOWGRAPH — потоковый граф SDR
- WATERFALL — водопад
- LOG — логирование
- SCHEDULER — планировщик заданий
- SDR — обследование приёмника
- HEALTH — состояние станции
- AGENT — агент обновлений
- PATHS — размещение файлов
- DECODERS — декодеры и обвязка прохода
- Поворотное устройство
- Эксплуатация
- Агент обновлений
- Поддерживаемые спутники
Разработка
- Архитектура
- Потоковый граф
- Декодеры и скрипты
- Загрузка данных
- Водопад
- Стенд
- Участие в разработке
- Дорожная карта: закрытие техдолга
- Дорожная карта: надёжность сети
- Где мы на 2026-09-10
- Зачем
- Состояние на входе
- Принятые решения
- Правило 21 на практике
- Целевая архитектура
- Фаза 0 — остановить кровотечение
- Фаза 1 — надёжность обмена
- Фаза 2 — агент и управление парком
- Фаза 3 — тракт приёма
- Фаза 4 — качество приёма
- Фаза 5 — монитор
- Новые контракты API
- Стенд
- Наследование от дорожной карты техдолга
- Разбор
origin/soniks-update(решение 19) - Сознательно отложено
- Верификация
- Открытые вопросы
- Контекст экосистемы для ИИ-агента
Справочник API
Проект¶
Исходники: gitlab.com/space-education-development/soniks/client/soniks-client
Определения спутников: soniks-satyaml
Портал: sonik.space, Telegram: @sonikspace
Лицензия: AGPL-3.0