Как пользоваться этим руководством

Руководство разделено на три части:

Названия элементов управления приведены так, как они выглядят в англоязычном интерфейсе (Monitor, Setup > Radio, Halt), потому что это язык, на котором написан код. Если вы работаете с Decodium на русском, итальянском, латышском или на любом другом доступном языке, элементы управления находятся точно в тех же местах, а перевод приведён там, где он может вызвать сомнения.

Замечание о доступности функций. Decodium собирается для Windows, macOS и Linux с разными декодирующими подсистемами и библиотеками. Некоторые описанные здесь функции могут отсутствовать или быть отключены — в зависимости от платформы, подключённого трансивера и параметров сборки того пакета, который вы скачали. Руководство указывает на это там, где это существенно.

Часть I — Установка и настройка

1. Введение

1.1 Что такое Decodium 4

Decodium 4.0 Core Shannon — это полноценная цифровая станция для режимов слабого сигнала. Программа выросла из линии WSJT-X / Decodium и переносит её на другую архитектуру: интерфейс Qt 6 / QML, постепенно переписанные на C++ декодеры и модуляторы, встроенное управление CAT с несколькими подсистемами, водопад и панадаптер с ускорением на GPU, карта в реальном времени, DX-кластер, PSK Reporter, аппаратный журнал и история декодирований в базе данных.

С Decodium 4 вы можете:

• принимать и передавать в режимах FT8, FT4, FT2, Q65, MSK144, JT65, JT9, JT4, FST4, FST4W и WSPR;
• управлять трансивером по CAT (Hamlib, встроенные подсистемы, Ham Radio Deluxe, OmniRig, TCI);
• проводить QSO вручную, а также использовать Auto Sequence, Auto CQ, Multi Answer Mode и режимы DX-Pedition;
• отправлять споты и QSO в PSK Reporter, QRZ Logbook, Cloudlog, LoTW и во внешние программы по UDP, ADIF TCP или N1MM;
• управлять станцией с планшета или телефона через удалённую веб-панель.

Название Core Shannon отсылает к Клоду Шеннону и к главной мысли проекта: относиться к слабой цифровой связи как к задаче об информации, синхронизации, устойчивости и надёжности работы, а не как к упражнению в модуляции.

1.2 Что изменилось по сравнению с Decodium 3

Тот, кто приходит с Decodium 3 «Raptor», найдёт три существенных отличия:

1. Новый интерфейс. Интерфейс на Qt Widgets заменён интерфейсом на QML: панели можно прикреплять, отделять и переставлять, а расположение сохраняется между сеансами.
2. Ядро на C++. Декодеры и модуляторы семейства FTx перенесены на C++, со сравнительными тестами относительно прежних процедур. Для некоторых специализированных режимов УКВ сохранены прежние компоненты.
3. Встроенные сервисы. История декодирований в SQLite, веб-панель, DX-кластер, телеметрия PWR/SWR/ALC и диагностика станции входят в саму программу и не требуют внешних инструментов.

Файл CHANGELOG.md в исходном коде описывает изменения по выпускам.

1.3 FT2 в двух словах

FT2 (Fast Track 2) — цифровой режим, созданный в рамках этого проекта и сертифицированный в ADIF со значениями MODE=MFSK и SUBMODE=FT2.

Шестая глава целиком посвящена FT2 и его настройкам.

1.4 Лицензия и исходный код

Decodium 4 распространяется по лицензии GPL-3.0. Полный текст лицензии находится в файле COPYING, который входит в состав исходного кода и пакетов. Исходный код открыт на GitHub, с полной историей коммитов и доступными для загрузки выпусками.

2. Требования и установка

2.1 Требования

Поддерживаемые операционные системы

• Windows 10 / 11, 64 бита
• macOS на Apple Silicon (и на Intel там, где пакет доступен)
• Linux x86_64 и aarch64, в виде AppImage

Рекомендуемая минимальная конфигурация

• Современный четырёхъядерный процессор для работы в FT2 с асинхронным декодированием
• 4 ГБ ОЗУ (8 ГБ рекомендуется при включённых Live Map и панадаптере)
• Видеокарта с актуальными драйверами: Decodium использует Qt Quick/RHI и аппаратное ускорение для водопада, панадаптера и карты
• Звуковая карта или USB-интерфейс трансивера
• Подключение к интернету для NTP, DX-кластера, PSK Reporter и обновлений

На более скромных машинах доступен режим Slow-PC (раздел 4.9), который снижает нагрузку на графику и частоту обновления интерфейса.

2.2 Загрузка пакета

1. Откройте страницу Releases в официальном репозитории.
2. Скачайте пакет для своей системы: - Windows: установщик x64; - macOS Apple Silicon / Intel: файл .dmg; - Linux: AppImage для x86_64 или aarch64.
3. Установите пакет или сделайте файл исполняемым и запустите Decodium.

2.3 Windows

Запустите установщик и следуйте указаниям. При первом запуске Windows может запросить доступ к сети: его нужно разрешить, если вы хотите пользоваться NTP, DX-кластером, PSK Reporter, веб-панелью или автоматическими обновлениями.

Пакеты для Windows подписаны цифровой подписью; замечания о подписи кода находятся в файле CODE_SIGNING_POLICY.md в исходном коде.

2.4 macOS

Если macOS блокирует программу из-за карантина, снимите атрибут с установленного приложения:

sudo xattr -r -d com.apple.quarantine /Applications/Decodium.app

Точное название приложения может отличаться в зависимости от собранного пакета.

При первом открытии звукового входа macOS запрашивает разрешение на доступ к микрофону: без него до декодера не доходит никакой сигнал.

2.5 Linux (AppImage)

Сделайте AppImage исполняемым и запустите его:

chmod +x Decodium*.AppImage
./Decodium*.AppImage

В некоторых дистрибутивах нужна библиотека libfuse2, либо содержимое можно распаковать вручную:

./Decodium*.AppImage --appimage-extract
cd squashfs-root
./AppRun

Для доступа к последовательным портам пользователь должен входить в нужную группу (dialout в Debian/Ubuntu, uucp в Arch). После добавления требуется войти в систему заново.

2.6 Обновления

Decodium содержит проверку обновлений (Setup > Advanced > DATA UPDATES). Если доступна более новая версия, появляется окно с описанием выпуска и ссылкой на пакет. Обновление не удаляет настройки, журналы и историю декодирований.

3. Первая настройка

Эта глава описывает минимум, необходимый для первого QSO. Полный справочник по всем настройкам находится в главе 14.

Откройте настройки кнопкой ⚙ Setup на верхней панели.

3.1 Станция — Setup > Station

Заполните поля раздела STATION DETAILS:

Раздел STATION INFO (Station Name, QTH, Rig Info, Antenna, Power (W), WSPR Power) не влияет на передачу: он наполняет журнал ADIF и внешние сервисы. Если заполнить его сейчас, позже не будет неполных записей в журнале.

3.2 Трансивер и CAT — Setup > Radio

В разделе BACKEND CAT выберите, как Decodium общается с трансивером:

Кроме этого, Decodium может работать вместе с Ham Radio Deluxe, когда трансивер уже находится под управлением HRD.

В разделе CAT CONTROL задайте последовательный порт, скорость, стоповые биты, управление потоком и способ PTT (CAT, RTS, DTR, VOX). В Linux лучше использовать устойчивые пути /dev/serial/by-id/..., а не /dev/ttyUSB*, которые могут меняться при каждой перезагрузке.

В разделе SPLIT OPERATION выберите режим разноса частот:

• None — без разноса, тон передачи остаётся в звуковой полосе;
• Rig — разносом управляет трансивер;
• Fake It — Decodium сдвигает частоту VFO, чтобы тон передачи оставался в чистой части фильтра.

Fake It — лучший выбор для большинства современных трансиверов, потому что удерживает тон передачи вдали от краёв фильтра и снижает искажения при передаче.

Проверьте связь в разделе DIAGNOSTICS: вы должны видеть настоящую частоту трансивера, смена диапазона должна работать в обе стороны, а PTT по команде Tune должен переводить трансивер на передачу.

Режимы передачи данных. Decodium старается сохранять режимы DATA/PKT у трансиверов Icom, Yaesu и Kenwood, чтобы не переводить аппарат в USB/LSB, когда правильная настройка — DATA-U. Если вы замечаете, что трансивер выходит из режима передачи данных, когда Decodium меняет частоту, проверьте режим, заданный в этом разделе.

Профили CAT. Несколько конфигураций CAT можно сохранить как профили и вызывать из меню Profile. Это самый быстрый способ переключаться между двумя трансиверами либо между домашней и выездной установкой.

3.3 Звук — Setup > Audio

В разделе AUDIO DEVICES выберите:

• Input: устройство, принимающее звук от трансивера (USB-кодек или звуковая карта);
• Output: устройство, отправляющее звук в трансивер;
• Канал: Mono, Left, Right или Both, в зависимости от подключения.

В разделе LEVELS задайте уровни приёма и передачи. В Decodium есть автоматическая регулировка уровня приёма, включённая по умолчанию: она защищает от перегрузки и избавляет от постоянной подстройки ползунка. Если её отключить, стремитесь к такому уровню приёма, при котором шумовая дорожка держится около 30–50 дБ по индикатору.

Для передачи по-прежнему действует правило цифровых режимов: никакого сжатия, никакой обработки, ALC в покое. Поднимайте уровень передачи до нужной мощности и не выше. В разделе 16.2 описано, как читать телеметрию ALC для проверки.

В Windows звуковой путь после передачи перезапускается намеренно жёстко, чтобы избежать неопустошённых буферов и застрявшей несущей. Если после каждой передачи вы замечаете короткую тишину — этот механизм работает правильно.

3.4 Синхронизация часов

Для FT8, FT4 и — ещё в большей степени — для FT2 синхронизация времени определяет, удастся ли декодировать хоть что-нибудь.

В Decodium есть:

• встроенный клиент NTP (Setup > Advanced > NTP TIME SYNC);
• панель DecoSyncTime, показывающая смещение, состояние синхронизации, среднее DT по декодированиям и задержку декодирования.

Включите Enable NTP и убедитесь, что панель показывает синхронизированное состояние. Среднее DT, систематически отличающееся от нуля у многих станций, указывает на ошибку местных часов, а не на прохождение.

3.5 Рабочий режим

Выберите режим в списке на верхней панели. Для первого QSO:

1. Начните с FT8 на обычной частоте: так вы проверите звук, CAT и время в известных условиях.
2. Убедитесь, что за один-два периода в Full Spectrum появляются декодирования.
3. Только после этого переходите к FT2, который гораздо менее снисходителен к ошибкам в синхронизации и в настройке звука.

4. Интерфейс

4.1 Строение окна

Главное окно Decodium 4 состоит из:

4.2 Верхняя панель

Кнопки верхней панели настраиваются (Setup > UI Buttons) как по видимости, так и по порядку:

Чтобы переставить кнопки: длительное нажатие и перетаскивание. Чтобы вернуться к исходному расположению, используйте Restore default button order в Setup > UI Buttons.

4.3 Водопад и панадаптер

Водопад показывает изменение спектра во времени; панадаптер показывает мгновенный спектр со шкалой звуковых частот внизу.

Основные действия:

• щелчок левой кнопкой по водопаду: перемещает звуковую частоту приёма;
• щелчок с модификатором (в соответствии с настройкой): перемещает звуковую частоту передачи;
• колесо мыши: масштаб или прокрутка, в зависимости от области;
• палитры: выбираются и настраиваются в Setup > Colors > SPECTRUM.

Водопад можно отделить в отдельное окно, снова прикрепить или свернуть. В компактном расположении он использует меньший порог истории и тем самым экономит память и текстуры, не теряя видимую часть.

4.4 Full Spectrum

Full Spectrum перечисляет все декодирования текущего периода. Видимые столбцы настраиваются в Setup > Display > DECODES и включают, среди прочего, расстояние (Dist), азимут (Az) и частоту.

• двойной щелчок по строке: выбирает эту станцию корреспондентом QSO и готовит сообщения;
• Clear: очищает список;
• кнопка перехода в конец списка (Go to the latest decode) возвращает вид вниз, если вы прокрутили список вверх.

Строки окрашиваются по правилам из Setup > Colors > DECODE COLORS: новая страна DXCC, новый континент, новая зона CQ или ITU, новый локатор, новый позывной, CQ в сообщении, 73/RR73, уже проведённые станции (B4), участники LoTW и переданные сообщения.

4.5 Signal RX

Signal RX — это «хирургический» вид: он показывает только то, что относится к текущему QSO и к станциям, которые вас вызывают. Во время наплыва вызовов смотреть нужно именно на эту панель, потому что Full Spectrum становится нечитаемым.

4.6 Панель TX

Панель TX содержит:

• сообщения TX1…TX7, которые можно формировать и править;
• состояние QSO и корреспондента;
• элементы управления: Auto (Auto Sequence), Call, Hold, Tune, Halt;
• мощность передачи и быстрые органы управления передачей.

Порядок кнопок на панели TX тоже настраивается, со сбросом через Restore default TX panel order.

Halt (или Esc) немедленно прерывает передачу: эту команду следует помнить наизусть.

4.7 Расположение: прикрепить, отделить, сбросить

Каждую главную панель можно:

• отделить в самостоятельное окно (Detach), что удобно при нескольких мониторах;
• снова прикрепить к расположению (Dock);
• скрыть и затем восстановить (Restore …);
• перенести между столбцами перетаскиванием;
• вернуть в исходное состояние командой Reset Layout.

Расположение сохраняется при закрытии программы и загружается при следующем запуске, включая отделённые окна и их положение.

4.8 Компактный режим

Компактный режим уменьшает высоту заголовков и строк, чтобы на экране помещалось больше декодирований. На ноутбуках и небольших экранах это правильный выбор.

4.9 Режим Slow-PC

Slow-PC mode снижает нагрузку на интерфейс и графику: реже обновляется водопад, меньше анимации, меньше работы в графическом потоке. Включите его, если на старых машинах замечаете рывки интерфейса или задержку декодирования: в FT2 интерфейс, который еле справляется, может стоить вам интервала передачи.

4.10 Темы и внешний вид

В Setup > Display > ASPETTO / TEMA выбираются тема (в том числе тёмная), цвета интерфейса и шрифты. В Setup > Display > FONT задаётся шрифт декодирований: используйте моноширинный шрифт, иначе столбцы сообщений не будут выровнены.

Часть II — Работа в эфире

5. QSO: от приёма до аппаратного журнала

5.1 Запуск приёма

1. Нажмите Monitor: кнопка переключится на STOP, и водопад начнёт двигаться.
2. Убедитесь, что уровень приёма не перегружен.
3. Подождите один-два периода: декодирования появляются в Full Spectrum в конце каждого интервала.

Если ничего не декодируется, но водопад показывает сигналы, причина почти всегда в часах (раздел 3.4) или в неверном режиме для этой частоты.

5.2 Вызов станции

1. Двойной щелчок по строке станции в Full Spectrum или Signal RX. Decodium устанавливает корреспондента, формирует сообщения и выбирает нужный интервал.
2. Проверьте звуковую частоту передачи: в режимах FTx хорошая практика — передавать в свободной части спектра, а не поверх той станции, которую вы вызываете.
3. Просмотрите сообщения, сформированные на панели TX.
4. Включите передачу.
5. При включённом Auto Sequence Decodium доводит QSO до конца самостоятельно: рапорт, подтверждение, RR73/73.

5.3 Вызов CQ

1. Выберите TX6 (сообщение CQ).
2. Включите передачу или используйте Auto CQ для повторяющегося вызова.
3. Следите за Signal RX — там видны прямые ответы.
4. Дайте работать Auto Sequence или вмешайтесь вручную.

При включённом Auto CQ Decodium снова начинает вызывать CQ по завершении каждого QSO — с учётом заданных защит (watchdog, проверка КСВ, ограничения на повторы).

5.4 Auto Sequence и его настройки

Setup > TX > AUTO SEQUENCE собирает правила, управляющие автоматикой:

Quick QSO предназначен для соревнований и высокого темпа: он сокращает QSO до четырёх обменов и всё равно даёт полноценную запись в журнале.

5.5 Повторы и завершение QSO

Setup > TX > FT2 UTILITY содержит параметры завершения QSO, с отдельными значениями для FT2, FT4 и FT8:

У этих настроек вместе одна ясная цель: завершать слабые QSO, не занимая частоту бесконечно. Если вы работаете с DX на пределе, поднимите надбавку для очень слабых корреспондентов; если работаете в соревнованиях, держите повторы низкими.

5.6 Запись QSO в журнал

При завершении QSO Decodium открывает окно подтверждения записи (если включена настройка Prompt to log QSO в Setup > Reporting > LOGGING). QSO записывается в местный журнал ADIF и, если это настроено, передаётся в QRZ Logbook, Cloudlog, LoTW и в подключённые внешние программы.

Комбинация Alt+L записывает текущее QSO без обращения к мыши.

5.7 Worked-before (B4)

Decodium распознаёт уже проведённые станции по совокупности позывного, диапазона и режима. QSO на 20 м в FT2 не отмечает тот же позывной как проведённый на 20 м в FT8 или на 40 м в FT2. Поэтому цвет B4 в Full Spectrum указывает на настоящий повтор, а выделения «новая страна DXCC / локатор / зона» остаются надёжными, даже если вы меняете режим в течение сеанса.

6. Работа в FT2

FT2 — тот режим, с которого начался этот проект, и он остаётся его главной целью. Эта глава собирает в одном месте всё, что относится к FT2.

6.1 Чего ожидать от FT2

Интервал FT2 составляет 3,75 секунды, а передача длится около 2,52 секунды. Это означает две вещи:

1. Темп QSO гораздо выше, чем в FT8, и заметно выше, чем в FT4: это его преимущество в соревнованиях, при наплыве вызовов и в DX-экспедициях, где узкое место — время на одно QSO, а не чувствительность.
2. Запас времени на декодирование, решение и подготовку передачи невелик. Настройка звука, точность часов и загрузка процессора значат намного больше, чем в FT8.

FT2 — не «улучшенный FT8»: это быстрый режим, рассчитанный на условия, где сигнал есть, а времени не хватает.

6.2 Асинхронное декодирование

Decodium декодирует FT2 асинхронно: вместо того чтобы ждать конца интервала и обработать всё сразу, он работает с перекрывающимися порциями, пока сигнал ещё поступает. Это сокращает задержку между окончанием передачи корреспондента и появлением сообщения на экране — время, которое в FT2 нужно целиком, чтобы ответить в правильном интервале.

Состояние асинхронного декодирования видно по кнопке Async FT2 (A) на верхней панели.

6.3 Планировщик передачи

У планировщика передачи FT2 есть правило, о котором не торгуются: никогда не начинать передачу, которая не может завершиться внутри интервала. Обрезанную передачу никто не декодирует, она лишь засоряет частоту.

Отсюда следующие защиты:

Если вы видите, что ваши передачи начинаются и обрываются, сначала проверьте синхронизацию времени, затем — консервативное окно передачи.

6.4 Настройки устойчивости FT2

Эти настройки рассчитаны на слабые, неустойчивые или подверженные QSB сигналы. Не включайте их все «на всякий случай»: каждая стоит процессорного времени или задержки.

Рекомендуемое начало: оставьте значения по умолчанию, включите FT2 partner-memory, если работаете с DX при QSB, и включайте Conservative FT2 только тогда, когда охотитесь за сигналами на пределе.

6.5 Защиты журнала и сообщений

Последняя настройка полезна, когда нужно сообщить о сбое в последовательности: она даёт точный след пройденных состояний, а именно он и нужен, чтобы воспроизвести ошибку.

6.6 Позывные и хеши

FT2, как FT8 и FT4, сжимает позывные. Длинные или составные позывные передаются в виде хеша и раскрываются приёмной стороной по уже виденным позывным. В Decodium есть защита от ghost calls (позывных, которые как будто декодировались, но на самом деле отсутствуют) и от нераскрытого содержимого: если сообщение нельзя отнести к корреспонденту с уверенностью, оно не используется для продвижения последовательности QSO.

Такое поведение выбрано намеренно: незавершённое QSO предпочтительнее QSO, записанного с неверным позывным.

6.7 FT2 на слабых процессорах

На медленных машинах:

1. включите Slow-PC mode;
2. включите FT2: adaptive decode (CPU saver);
3. рассмотрите FT2: skip redundant end-slot decode;
4. уменьшите высоту водопада и видимую историю;
5. закройте Live Map, если он не нужен.

Порядок приоритетов в FT2 всегда один и тот же: сначала синхронизация, затем чувствительность, и в последнюю очередь внешний вид интерфейса.

7. Multi Answer Mode и очередь вызывающих

7.1 О чём речь

Multi Answer Mode (MAM) позволяет обслуживать несколько вызывающих одновременно, поддерживая более одного активного QSO. Панель MAM показывает активные потоки и позволяет добавлять станции двойным щелчком.

Ответственность остаётся на операторе: MAM организует работу, но не даёт на неё разрешения. Прежде чем применять его на загруженной частоте, убедитесь, что ваш сигнал и ваша настройка чисты.

7.2 Multi-stream

Setup > TX > FT2 UTILITY содержит:

• FT2/FT8 MAM multi-stream (MSHV, sperimentale) — включает работу с несколькими одновременными потоками;
• MAM multi-stream: max stream simultanei — сколько потоков разрешено.

Настройка помечена как экспериментальная: она увеличивает число одновременных передач, а вместе с ним и возможности ошибиться. Начните с двух потоков.

7.3 Очередь вызывающих

Панель Caller Queue собирает станции, которые вас вызывают, и позволяет упорядочить их по рабочим признакам. Это естественный инструмент, когда вы вызываете CQ с востребованной станции и ответы приходят быстрее, чем вы успеваете их обрабатывать.

8. Режимы DX-Pedition и соревнований

8.1 Fox / Hound / SuperFox

В Setup > Advanced > OPERATING MODE:

Настройки OTP (Setup > Advanced > OTP: OTP Enabled, OTP Seed, OTP Interval, OTP URL) относятся к созданию и распространению кодов, которыми проверяется активность: они касаются организатора экспедиции, а не отдельного вызывающего.

8.2 DX-Pedition Workspace

DX-Pedition Workspace — это отдельное расположение, которое в одном виде помещает рядом Full Spectrum · Decode, Signal RX · QSO Lock и Log · QSO Entry, со временем UTC и позывным оператора. Оно предназначено для операторских смен на востребованной станции, где активность на диапазоне, текущее QSO и ввод в журнал должны быть перед глазами одновременно.

8.3 Соревнования

Setup > Advanced > CONTEST задаёт текущую активность:

• Activity: None, Field Day, Fox, Hound;
• FD Exchange и RTTY Exchange: обмены, предусмотренные положением;
• Contest Name, Indiv Name, NCCC Sprint: параметры отдельных форматов.

Выбор активности меняет формирование сообщений: в соревновании всегда проверяйте сообщения TX, прежде чем начать передачу.

9. Расширенное декодирование

Setup > Advanced > ADV DECODING объединяет три способа восстановления, которые можно включать по отдельности или оставить в автоматическом управлении:

При включённом Auto Mode Decodium включает эти три способа только тогда, когда они нужны, исходя из измеренных условий; поле Live state показывает, какие из них действуют в данный момент.

Цена этих настроек — процессорное время. На медленных машинах включение их всех вручную ухудшает положение, а не улучшает: в большинстве случаев Auto Mode — самый разумный выбор.

Другие настройки декодирования находятся в Setup > Decode:

• DECODE PARAMETERS — глубина и общие параметры декодирования;
• JT65 VHF/UHF — параметры именно для работы на УКВ;
• SIDELOBE CONTROL — управление боковыми лепестками;
• DECODE FILTERS — фильтры для декодирований (см. раздел 12.4).

10. Live Map, Astro и Time Sync

10.1 Live Map

Live Map показывает декодированные станции и пути между вашей станцией и их станциями, с метками, окрашенными по направлению и состоянию. Карта автоматически очищается при смене диапазона или режима и при очистке списков декодирования, чтобы на ней не оставалась активность, которая уже не действительна.

Во время передачи карта обновляется намеренно медленнее: это решение о приоритетах, ведь графический поток не должен отнимать время у передачи.

Если карта не нужна, её закрытие освобождает видеокарту и память — это первая панель, от которой отказываются на слабом оборудовании.

10.2 Astro

Панель Astro даёт астрономические данные, полезные для EME и для работы на УКВ: положение Луны, азимут и угол места, доплер, ослабление. Папка данных AzEl задаётся в Setup > Audio > DIRECTORY.

10.3 Time Sync (DecoSyncTime)

Панель DecoSyncTime собирает всё, что связано со временем:

• состояние NTP и применяемое смещение;
• среднее DT, вычисленное по принятым декодированиям;
• задержка декодирования;
• число измерений, использованных для оценки.

Как это читать:

Есть также оценка уходя частоты звуковой карты в ppm с зелёным/жёлтым/красным указателем: значительный уход постепенно смещает разметку интервалов и характерен для недорогих USB-кодеков.

11. Журнал, сетевые сервисы и связки с внешними программами

11.1 Местный аппаратный журнал

Decodium ведёт местный журнал ADIF и окно QSO Log с вводом и правкой QSO. Настройки поведения находятся в Setup > Reporting > LOGGING: подтверждение перед записью, обязательные поля, формат рапортов.

11.2 PSK Reporter

Decodium отправляет наблюдения в PSK Reporter и позволяет искать собственные споты на соответствующей панели. Отправка идёт через очередь: когда отправлять нечего, никакого фонового обмена со сервисом не поддерживается.

11.3 QRZ Logbook, Cloudlog и LoTW

Для Cloudlog Decodium приводит адрес API к единому виду и различает в сообщениях об ошибках сбои HTTP, проверки подлинности и прокси: если отправка не удалась, сообщение указывает, какой из трёх случаев это.

Данные LoTW применяются и для выделения участников LoTW в Full Spectrum (цвет LoTW marker).

11.4 DX-кластер

Панель DX Cluster подключается к узлу telnet и показывает споты с возможностью фильтрации. Настройка находится в Setup > Reporting > DX CLUSTER (узел, порт, позывной для входа, фильтры).

11.5 Связки с внешними программами

Если вы используете JTAlert или GridTracker, UDP Server должен быть включён, а порт должен совпадать с тем, что задан во внешней программе.

11.6 Запись звука

Setup > Reporting > RECORDING управляет записью принятого звука — это полезно для последующего разбора и чтобы приложить настоящие образцы к сообщению об ошибке.

12. История декодирований, фильтры и оповещения

12.1 Decode History

Decodium хранит декодирования в базе SQLite, доступной для поиска из окна History. Искать можно по:

• позывному;
• диапазону;
• режиму;
• диапазону дат UTC;
• ограничению числа результатов.

Результаты выгружаются в ADIF. История переживает закрытие программы и позволяет разбираться после работы: проверить прохождение, просмотреть активность на диапазоне, восстановить сомнительное QSO.

Живые виды, хранимые в памяти, ограничены, чтобы расход ОЗУ не рос при долгих сеансах; полная история остаётся в базе.

12.2 Звуковые оповещения

Setup > Alerts > AUDIO ALERTS позволяет привязать звук к определённым событиям: новая страна DXCC, новый локатор, искомый позывной, прямой вызов. Так можно работать в фоне, не глядя постоянно на экран.

12.3 Фильтры: чёрный список, белый список и территории

Setup > Filters содержит:

ALWAYS PASS имеет преимущество: здесь место позывному друга, которого вы никогда не хотите пропустить, даже когда фильтруете жёстко.

12.4 Фильтры декодирования

Setup > Decode > DECODE FILTERS вмешивается раньше — в работу декодера и в то, что попадает в списки. При разумном применении это снижает загрузку процессора на загруженном диапазоне.

13. Удалённая веб-панель и FT2-Link

13.1 Удалённая веб-панель (iPad, телефон, PWA)

В Decodium есть встроенный веб-сервер, позволяющий управлять станцией с другого устройства в той же локальной сети.

Включение

1. Откройте Setup > Display > REMOTE WEB SERVER (iPad / mobile PWA) или Setup > Reporting > REMOTE WEB DASHBOARD (LAN).
2. Включите сервер и задайте порт и учётные данные для доступа.
3. Узнайте IP-адрес компьютера станции.
4. На планшете или телефоне откройте в браузере http://IP-АДРЕС:ПОРТ.
5. Добавьте страницу на домашний экран, чтобы пользоваться ею как приложением (PWA).

Безопасность — прочтите перед включением

• Пользуйтесь сервером только в локальной сети. Не открывайте к нему доступ из интернета и не открывайте порты на маршрутизаторе.
• Задайте непростой пароль: тот, кто доберётся до панели, сможет управлять вашей станцией, а значит и вашей передачей.
• В общих сетях (гостиницы, коллективные станции, выставки) держите сервер выключенным, когда он не нужен.

Пошаговое руководство для начинающих находится в файле doc/WEBAPP_SETUP_GUIDE.en-GB.md в исходном коде, вместе с разделом об устранении неполадок и описанием точек API для продвинутого применения.

13.2 FT2-Link (экспериментальный)

FT2-Link — открытый протокол для надёжного обмена сообщениями и переписки, разрабатываемый внутри Decodium. Он открыто документирован и не зависит от модема: один и тот же механизм ARQ может работать на разных формах сигнала.

Предусмотренный порядок таков: маяк или CQ в NARROW, ответ HELLO, согласование лучшего общего профиля, переход на W500 или W2300 для данных и возврат к NARROW, если широкий профиль не держится.

Рабочий период FT2-Link составляет 15 секунд, в отличие от 3,75 с у FT2.

Внимание. FT2-Link — экспериментальная разработка, а профили W500/W2300 не являются стандартным FT2 и не должны выдаваться за него. Прежде чем выходить в эфир, проверьте правила, действующие для той полосы, которую вы намерены занять, в вашем диапазоне и в вашем регионе IARU.

Часть III — Справочник

14. Справочник настроек

Настройки распределены по тринадцати закладкам. Ниже перечислены все разделы в том порядке, в каком они появляются, с указанием назначения.

14.1 Station

14.2 Radio

14.3 Audio

14.4 TX

14.4.1 Ready Profiles

Готовые профили одним действием задают согласованный набор параметров:

Действующий профиль помечен значком ● active. Можно взять профиль за основу и затем изменить отдельные настройки: ваши изменения сохраняются и перезаписываются только тогда, когда вы применяете другой профиль.

14.4.2 Watchdog

Не отключайте watchdog. Это та защита, которая не позволяет забытой несущей остаться в эфире, когда вы вышли из комнаты.

14.5 Display

Приоритет процесса. High (recommended) — рекомендуемая настройка. Realtime помечен предупреждением: на некоторых системах из-за него компьютер становится вялым или неустойчивым. Не пользуйтесь им, если не проводите специальных измерений.

14.6 Decode

14.7 Reporting

14.8 Frequencies

Управление рабочими частотами: список по диапазонам и режимам, добавление, изменение, загрузка и сохранение в файлы .qrg / .qrg.json, с возможностью объединить (Merge Working Frequencies) внешний список со своим, а не заменять его.

14.9 Colors

14.10 Advanced

14.11 Alerts

AUDIO ALERTS — привязка звуков к событиям (новая страна DXCC, новый локатор, искомый позывной, прямой вызов).

14.12 Filters

BLACKLIST, WHITELIST, ALWAYS PASS, EXCLUDE TERRITORY, FILTER OPTIONS (раздел 12.3).

14.13 UI Buttons

TOP TOOLBAR (видимость кнопок) и TOOLBAR BUTTON ORDER (порядок, со сбросом к значениям по умолчанию как для панели, так и для панели TX).

15. Горячие клавиши

Передача

Управление (Ctrl)

Действия (Alt)

Прочее

Полный перечень можно посмотреть в самой программе, в пункте Keyboard Shortcuts.

16. Диагностика и устранение неполадок

16.1 Ничего не декодируется

Проверяйте в таком порядке:

1. Работает ли Monitor? На кнопке должно быть STOP.
2. Идёт ли водопад? Если он стоит, причина в устройстве звукового входа, а не в декодере.
3. Разумен ли уровень приёма? Слишком низкая шумовая дорожка и перегрузка одинаково мешают декодированию.
4. Синхронизированы ли часы? Посмотрите панель Time Sync. В FT2 и FT4 нескольких десятых секунды достаточно, чтобы потерять всё.
5. Соответствует ли режим частоте? FT8 на частоте FT4 не декодирует ничего.
6. Верен ли звуковой канал? При стереокодеке неверный канал равносилен тишине.

16.2 Я передаю, но никто не отвечает

• Проверьте, работает ли PTT и действительно ли трансивер переходит на передачу.
• Проверьте телеметрию в Setup > Radio > DIAGNOSTICS: мощность должна соответствовать ожидаемой, а ALC должен оставаться в покое. Показание ALC -- означает, что данные недоступны, тогда как 0 — допустимое значение: это два разных положения.
• Проверьте КСВ: Check SWR не блокирует Tune, так что вы можете измерять и исправлять, но настоящую передачу и Auto CQ эта проверка защищает.
• Убедитесь, что не передаёте за пределами интервала: в FT2 консервативное окно передачи (раздел 6.3) отклоняет запоздавшие передачи, и это правильное поведение.

16.3 Неполадки графики и производительности

Указатель загрузки процессора в Setup > Display > UI — PERFORMANCE считает случаи перегрузки за сеанс: если счётчик severe растёт, компьютер не справляется и настройку следует облегчить.

16.4 Звук застрял или несущая после передачи

В Decodium есть watchdog звука передачи, предназначенный именно для этого случая. Если такое происходит:

1. воспользуйтесь Halt (или Esc);
2. проверьте, отпущен ли PTT на трансивере;
3. проверьте устройство звукового выхода в Setup > Audio;
4. если это повторяется постоянно, снимите диагностический журнал и сообщите о случае.

16.5 Порты CAT меняются или появляются дважды

В Linux используйте пути /dev/serial/by-id/..., которые сохраняются между перезагрузками. Если одно и то же устройство появляется дважды (как /dev/ttyUSB0 и как путь by-id), выбирайте путь by-id, а не оба: это одно и то же физическое устройство.

16.6 Как сообщить об ошибке так, чтобы это помогло

В Decodium есть окно для сообщений об ошибках. Полезное сообщение содержит:

• точную версию программы (About Decodium);
• операционную систему и платформу;
• применяемый трансивер и подсистему CAT;
• рабочий режим и частоту;
• описание шагов, которые воспроизводят неполадку;
• диагностический журнал и, если неполадка касается декодирования, файл WAV с сигналом;
• при сбоях последовательности FT2: включите FT2 state transition census (log only) и приложите след.

17. Файлы, папки и пользовательские данные

Decodium использует стандартные системные папки, предусмотренные Qt, для:

• настроек;
• кэша QML;
• базы SQLite с историей декодирований (db.sqlite);
• файла CTY.DAT и данных DXCC;
• журнала ADIF;
• диагностических журналов;
• звуковых записей.

Точные расположения зависят от платформы. Самый надёжный способ их найти — прочитать журнал запуска, в котором Decodium выводит основные пути (AppDataLocation, CacheLocation, путь к базе данных).

Для полного резервного копирования настроек нужны: папка настроек, журнал ADIF и база с историей.

В Decodium есть и перенос хранилища: когда строение данных меняется между версиями, существующие файлы преобразуются при первом запуске. Перед крупным обновлением копия папки с данными всё же остаётся разумной предосторожностью.

18. Сборка из исходного кода

18.1 Зависимости

В зависимости от платформы нужны:

• CMake (3.20 или новее) и современный компилятор C/C++;
• Qt 6 с модулями Quick, Qml, QuickControls2, Widgets, Multimedia, Network, SerialPort, Sql и WebSockets;
• Hamlib;
• компилятор Fortran (gfortran) для сохранившихся прежних компонентов;
• Boost и прочие зависимости, указанные в файлах сборки.

18.2 Сценарии сборки

В репозитории есть готовые сценарии для основных платформ:

Замечания именно по Windows находятся в файле doc/building on MS Windows.txt и в соседних файлах; перенос на macOS описан в doc/MACOS_PORTING_v1.2.0.md.

18.3 Тесты

Каталог tests/ содержит модульные тесты и сравнения между реализациями декодеров, в том числе тесты для FT2 и FT2-Link. Чтобы их выполнить:

ctest --output-on-failure

Сравнительные тесты между ступенями декодирования — верный инструмент, чтобы убедиться, что изменение в декодере не привело к падению чувствительности.

19. Словарь

20. Благодарности, лицензия и контакты

Проект

• Мартино Мерола — IU8LMC — создатель FT2, lead developer DECODIUM
• Сальваторе Раккампо — 9H1SR — ядро C++, сборки и пакеты для macOS и Linux
• Испытатели и участники сообщества FT2, чьи сообщения направляли большую часть работы над последними выпусками
• Переводчики из сообщества, которые поддерживают переводы программы

Происхождение кода

Decodium происходит от линии WSJT-X, разработанной Джо Тейлором K1JT, Стивом Франке K9AN, Биллом Сомервиллом G4WJS и другими авторами проекта и распространяемой по лицензии GPL. Файлы AUTHORS, THANKS и COPYING, входящие в состав исходного кода, содержат полные упоминания и текст лицензии. Собственный вклад этого проекта — протокол FT2, переписанные декодеры и модуляторы, интерфейс QML, встроенные сервисы — описан в истории коммитов и в файле CHANGELOG.md.

Лицензия

Decodium 4.0 Core Shannon — свободная программа, распространяемая по GNU General Public License версии 3. Вы можете применять её, изучать, изменять и передавать дальше на условиях этой лицензии. Программа передаётся без каких-либо гарантий, в той мере, в какой это допускает применимое право.

Где искать помощь

• Сайт проекта: ft2.it
• Сообщество и поддержка: community.ft2.it
• Канал Telegram FT2 Digital Mode
• Технические сообщения: раздел Issues в репозитории GitHub

Заключительное замечание о работе в эфире

Decodium управляет передатчиком. Ответственность за то, что выходит в эфир — диапазон, полоса, мощность, время, разрешения — лежит на операторе, имеющем лицензию. Экспериментальные возможности программы, в особенности широкие профили FT2-Link и режимы multi-stream, применяйте только после того, как проверите правила, действующие в вашем диапазоне и вашем регионе IARU.

73 de IU8LMC