# Быстрый старт

Запуск наблюдения вручную, без `soniks-client-new`. Полезно для проверки станции
после установки и для отладки декодера.

## Подготовка

**1. Каталог для результатов.** Подписчики открывают файлы на запись и не
создают каталоги сами:

```sh
mkdir -p /tmp/.satnogs/data
```

**2. `rigctld`.** Флоуграфы получают доплеровский сдвиг от `rigctld` по сети
(модель `NETRIGCTL`). Без него блок доплер-компенсации не запустится. Для
проверки без реального трансивера подойдёт фиктивная модель:

```sh
rigctld -m 1 -T 127.0.0.1 -t 4532 &
```

Проверить, что отвечает:

```sh
echo "f" | nc 127.0.0.1 4532
```

**3. Приёмник.** Узнать строку устройства для SoapySDR:

```sh
SoapySDRUtil --find
```

Обычно это `driver=rtlsdr`, `driver=airspy`, `driver=hackrf` и т. п.

## Приём в режиме FM

Самый простой режим: без декодера кадров, только аудио, водопад и IQ.

```sh
flowgraph_dispatcher \
    --mode FM \
    --soapy-rx-device=driver=rtlsdr \
    --samp-rate-rx=2.048e6 \
    --rx-freq=145800000 \
    --gain=40.0 \
    --antenna=RX \
    --ppm=0 \
    --rigctl-host=127.0.0.1 \
    --rigctl-port=4532 \
    --file-path=/tmp/.satnogs/data/audio.ogg \
    --waterfall-file-path=/tmp/.satnogs/data/waterfall.dat \
    --decoded-data-file-path=/tmp/.satnogs/data/data
```

Остановка — `Ctrl+C`. Диспетчер гасит флоуграф и подписчиков сам.

Появится:

- `/tmp/.satnogs/data/audio.ogg` — демодулированное аудио, OGG Vorbis, 48 кГц моно;
- `/tmp/.satnogs/data/waterfall.dat` — данные водопада.

Кадров не будет: у режима `FM` нет декодера (`outputs_frames: False`).

## Приём телеметрии Geoscan

Режим с декодером кадров: добавляется `--baud`, и диспетчер поднимает подписчика
кадров на порту 16887 (`--zmq-base-port`).

```sh
flowgraph_dispatcher \
    --mode GFSK_GEOSCAN \
    --baud 9600 \
    --soapy-rx-device=driver=rtlsdr \
    --samp-rate-rx=2.048e6 \
    --rx-freq=436500000 \
    --gain=40.0 \
    --rigctl-host=127.0.0.1 \
    --rigctl-port=4532 \
    --file-path=/tmp/.satnogs/data/audio.ogg \
    --waterfall-file-path=/tmp/.satnogs/data/waterfall.dat \
    --decoded-data-file-path=/tmp/.satnogs/data/data
```

Каждый декодированный кадр — отдельный JSON-файл
`/tmp/.satnogs/data/data_<UTC-метка>`:

```sh
ls -1 /tmp/.satnogs/data/data_*
cat /tmp/.satnogs/data/data_2026-08-22T14-31-07
```

```json
{
    "pdu": "SGVsbG8sIEdlb3NjYW4h"
}
```

Полезная нагрузка кадра лежит в `pdu` в base64. Набор остальных полей зависит от
декодера — [](outputs.md).

Для USP (Спутникс) всё то же самое, только `--mode "GMSK USP"` (кавычки
обязательны — в названии режима пробел).

## Запись IQ

По умолчанию IQ не пишется. Включается отдельным флагом:

```sh
flowgraph_dispatcher --mode FM --enable-iq-dump=1 \
    --iq-file-path=/tmp/.satnogs/data/iq  … 
```

Получится `/tmp/.satnogs/data/iq_cs16_<UTC>.raw` — чередующиеся комплексные
int16. Частота дискретизации в имени файла **не** сохраняется, её нужно помнить
самому; для FM это 48 кГц, для режимов с бодрейтом — `baudrate × decimation`
(см. [](dev/grc-conventions.md)).

## Живой поток IQ по UDP

Параллельно записи флоуграф всегда шлёт доплер-скорректированный поток по UDP:

```sh
flowgraph_dispatcher --mode FM --udp-dump-host=127.0.0.1 --udp-dump-port=57356  … 
```

Формат — комплексные 16-битные целые, полезная нагрузка пакета 1472 байта.
Удобно смотреть в реальном времени в `gqrx`, `inspectrum` или собственном
флоуграфе GNU Radio.

## Что дальше

- Все режимы и какой флоуграф каждый запускает: [](modes.md)
- Все аргументы командной строки: [](dispatcher.md)
- Если ничего не декодируется: [](troubleshooting.md)