Исходный код вики Руководство пользователя EAX control
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Содержание**"}} | ||
| 2 | {{toc depth="2"/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | **EAX control panel** — программа для компьютера, которая передаёт звук между трансивером **ЕРМАК-ТТ** и программами на PC по локальной сети (Ethernet / Wi-Fi), без аудиокабелей и USB-звуковой карты. | ||
| 6 | |||
| 7 | (% class="box infomessage" %) | ||
| 8 | ((( | ||
| 9 | **Что умеет EAX:** | ||
| 10 | |||
| 11 | * принимает звук обоих приёмников трансивера (**RX1** и **RX2**) и выводит его в виртуальную аудиокарту, откуда его берут цифровые программы (WSJT-X, JTDX, fldigi и т.п.); | ||
| 12 | * забирает звук из виртуальной аудиокарты (выход цифровой программы) и отправляет его на трансивер для передачи (**TX**); | ||
| 13 | * одновременно может выводить принятый звук на динамики или наушники компьютера; | ||
| 14 | * показывает уровни сигналов RX1, RX2 и TX, скорость потоков и задержку. | ||
| 15 | ))) | ||
| 16 | |||
| 17 | {{warning}} | ||
| 18 | Если на Windows 10/11 при запуске виден белый экран, установите [[Пакет совместимости OpenCL™, OpenGL® и Vulkan®>>https://apps.microsoft.com/detail/9nqpsl29bfff]] | ||
| 19 | {{/warning}} | ||
| 20 | |||
| 21 | == Как это работает == | ||
| 22 | |||
| 23 | EAX подключается к трансиверу по адресу **IP-адрес трансивера : 4002**. По этому TCP-соединению трансивер сообщает параметры потока (частота дискретизации, размер кадра, порты), после чего звук идёт по UDP в обе стороны. | ||
| 24 | |||
| 25 | |=Направление|=Откуда|=Куда | ||
| 26 | |Приём (RX)|Трансивер → UDP|EAX → **EAX Output** (виртуальная карта) → цифровая программа; при включённом динамике — также **Audio device** (динамики PC) | ||
| 27 | |Передача (TX)|Цифровая программа → **EAX Input** (виртуальная карта) → EAX|UDP → трансивер | ||
| 28 | |||
| 29 | Используемые сетевые порты (подробнее — [[Порты TCP и UDP>>Main.ERMAK.Руководство пользователя ЕРМАК.Порты TCP и UDP.WebHome]]): | ||
| 30 | |||
| 31 | |=Протокол|=Порт|=Назначение | ||
| 32 | |TCP|4002|управляющее соединение EAX (на трансивере) | ||
| 33 | |UDP|1277|приём звука передачи трансивером | ||
| 34 | |UDP|16742 (по умолчанию)|приём звука компьютером, настраивается в EAX (**Local UDP port**) | ||
| 35 | |||
| 36 | == Что понадобится == | ||
| 37 | |||
| 38 | * Трансивер ЕРМАК-ТТ, подключённый к той же сети, что и компьютер. Нужно знать его IP-адрес. | ||
| 39 | * Компьютер с одной из систем: | ||
| 40 | ** **Linux x86_64**: Fedora 38–44, Ubuntu 20.04 / 22.04 / 24.04 (готовые пакеты .rpm и .deb); | ||
| 41 | ** **Windows 10/11 x64**. | ||
| 42 | * Последняя версия EAX: [[EAX aduio control - история релизов>>Main.ERMAK-TT.EAX aduio control utility releases.WebHome]]. | ||
| 43 | * Виртуальная аудиокарта (на Linux — модуль ALSA **snd-aloop**, на Windows — драйвер VAC). Её настройка описана ниже. | ||
| 44 | |||
| 45 | == Подготовка трансивера == | ||
| 46 | |||
| 47 | 1. Убедитесь, что в настройках удалённых подключений трансивера разрешён интерфейс **EAX**. | ||
| 48 | 1. Для передачи звука с компьютера выберите источник входного сигнала **EAX** в [[окне оперативных настроек передатчика>>Main.ERMAK-TT.Руководство пользователя ЕРМАК-ТТ.TX settings.WebHome]] (нажатие энкодера {{html}}<span style="font-size:100%;font-weight:bold; background-color: #28a745;" class="badge bg-dark">RF</span>{{/html}}). | ||
| 49 | 1. Для управления трансивером из цифровых программ (CAT) используйте сервер **RIGCTL** — TCP-порт **4532** (RX1) или **4533** (RX2). | ||
| 50 | |||
| 51 | == Установка на Linux == | ||
| 52 | |||
| 53 | === 1. Установка программы === | ||
| 54 | |||
| 55 | Скачайте пакет для своего дистрибутива со страницы [[история релизов>>Main.ERMAK-TT.EAX aduio control utility releases.WebHome]] и установите его. | ||
| 56 | |||
| 57 | Fedora: | ||
| 58 | |||
| 59 | {{code language="bash"}} | ||
| 60 | sudo dnf install ./eaxcontrol-1.5.2-fc42.rpm | ||
| 61 | {{/code}} | ||
| 62 | |||
| 63 | Ubuntu: | ||
| 64 | |||
| 65 | {{code language="bash"}} | ||
| 66 | sudo apt install ./eaxcontrol-1.5.2-ubuntu24.04.deb | ||
| 67 | {{/code}} | ||
| 68 | |||
| 69 | После установки программа появится в меню приложений как **EAX Control**. Из терминала её можно запустить командой **eax**. | ||
| 70 | |||
| 71 | === 2. Виртуальные аудиокарты (snd-aloop) === | ||
| 72 | |||
| 73 | На Linux EAX работает напрямую через ALSA. Для обмена звуком с цифровыми программами нужны две виртуальные «петлевые» аудиокарты ALSA — модуль ядра **snd-aloop** ([[описание модуля>>https://alsa-project.org/wiki/Matrix:Module-aloop]]). | ||
| 74 | |||
| 75 | Проверьте, что модуль есть в системе: | ||
| 76 | |||
| 77 | {{code language="bash"}} | ||
| 78 | modinfo -n snd-aloop | ||
| 79 | {{/code}} | ||
| 80 | |||
| 81 | Если команда выдаёт ошибку: | ||
| 82 | |||
| 83 | * **Ubuntu**: {{code language="none"}}sudo apt install linux-modules-extra-$(uname -r){{/code}} | ||
| 84 | * **Fedora**: модуль входит в стандартный пакет **kernel-modules**. | ||
| 85 | |||
| 86 | Создайте два файла, чтобы модуль загружался при старте системы с двумя картами (номера 10 и 11): | ||
| 87 | |||
| 88 | {{code language="bash"}} | ||
| 89 | echo "options snd-aloop enable=1,1 index=10,11 pcm_substreams=2,2" | sudo tee /etc/modprobe.d/snd-aloop.conf | ||
| 90 | echo "snd-aloop" | sudo tee /etc/modules-load.d/snd-aloop.conf | ||
| 91 | {{/code}} | ||
| 92 | |||
| 93 | В домашней папке создайте (или дополните) файл **~/.asoundrc** — он даёт виртуальным устройствам понятные имена: | ||
| 94 | |||
| 95 | {{code language="none"}} | ||
| 96 | pcm.ERMAK_OUT { | ||
| 97 | type plug | ||
| 98 | slave { pcm "hw:10,0,0" format S16_LE rate 48000 channels 2 } | ||
| 99 | hint { show on description "EAX: RX audio (EAX Output)" } | ||
| 100 | } | ||
| 101 | pcm.ERMAK_OUT_RESERVED { | ||
| 102 | type plug | ||
| 103 | slave { pcm "hw:10,1,0" format S16_LE rate 48000 channels 2 } | ||
| 104 | hint { show on description "EAX: RX audio for WSJT-X (Input)" } | ||
| 105 | } | ||
| 106 | pcm.ERMAK_IN { | ||
| 107 | type plug | ||
| 108 | slave { pcm "hw:11,1,0" format S16_LE rate 48000 channels 1 } | ||
| 109 | hint { show on description "EAX: TX audio (EAX Input)" } | ||
| 110 | } | ||
| 111 | pcm.ERMAK_IN_RESERVED { | ||
| 112 | type plug | ||
| 113 | slave { pcm "hw:11,0,0" format S16_LE rate 48000 channels 1 } | ||
| 114 | hint { show on description "EAX: TX audio for WSJT-X (Output)" } | ||
| 115 | } | ||
| 116 | {{/code}} | ||
| 117 | |||
| 118 | (% class="box warningmessage" %) | ||
| 119 | ((( | ||
| 120 | Не переопределяйте в **~/.asoundrc** устройство **pcm.!default**: в современных дистрибутивах звуком управляет PipeWire/PulseAudio, и такая строка может отключить системный звук. | ||
| 121 | ))) | ||
| 122 | |||
| 123 | Перезагрузите компьютер и проверьте, что карты 10 и 11 появились: | ||
| 124 | |||
| 125 | {{code language="bash"}} | ||
| 126 | aplay -l | grep Loopback | ||
| 127 | card 10: Loopback [Loopback], device 0: Loopback PCM [Loopback PCM] | ||
| 128 | card 10: Loopback [Loopback], device 1: Loopback PCM [Loopback PCM] | ||
| 129 | card 11: Loopback_1 [Loopback], device 0: Loopback PCM [Loopback PCM] | ||
| 130 | card 11: Loopback_1 [Loopback], device 1: Loopback PCM [Loopback PCM] | ||
| 131 | {{/code}} | ||
| 132 | |||
| 133 | Петлевая карта работает «насквозь»: звук, выведенный в устройство **0**, можно записать с устройства **1** той же карты, и наоборот. Поэтому устройства распределяются так: | ||
| 134 | |||
| 135 | |=Устройство|=Где выбрать|=Назначение | ||
| 136 | |**ERMAK_OUT** (hw:10,0)|EAX → **EAX Output**|EAX выводит сюда принятый звук | ||
| 137 | |**ERMAK_OUT_RESERVED** (hw:10,1)|WSJT-X → **Input**|программа слушает эфир | ||
| 138 | |**ERMAK_IN_RESERVED** (hw:11,0)|WSJT-X → **Output**|программа выводит сигнал передачи | ||
| 139 | |**ERMAK_IN** (hw:11,1)|EAX → **EAX Input**|EAX забирает звук передачи | ||
| 140 | |||
| 141 | == Установка на Windows == | ||
| 142 | |||
| 143 | === 1. Виртуальная аудиокарта (VAC) === | ||
| 144 | |||
| 145 | Нужны **две** виртуальные аудиокарты: одна для приёма, другая для передачи. Можно использовать: | ||
| 146 | |||
| 147 | * **ERMAK VAC** — [[скачать (EAX VAC, Windows 10)>>https://nx8619.your-storageshare.de/s/pdeEJr5mG4ix7PQ?dir=/EAX%20VAC]]. Драйвер подписан самоподписанным сертификатом, поэтому перед установкой нужно [[отключить проверку подписи драйверов>>https://answers.microsoft.com/en-us/windows/forum/all/permanent-disable-driver-signature-verification/009c3498-bef8-4564-bb52-1d05812506e0]], а при включённом Secure Boot — отключить его в BIOS. Драйвер устанавливается через **Диспетчер устройств**, установку повторяют дважды, чтобы появилось две карты. | ||
| 148 | * **Virtual Audio Cable** (Eugene Muzychenko) — коммерческий драйвер с подписью, на нём проводились [[измерения задержки>>Main.ERMAK-TT.Application notes.WebHome]]. | ||
| 149 | |||
| 150 | В свойствах обеих виртуальных карт (**Панель управления → Звук → Свойства → Дополнительно**) установите формат **16 бит, 48000 Гц**. | ||
| 151 | |||
| 152 | === 2. Установка программы === | ||
| 153 | |||
| 154 | 1. Скачайте **eaxcontrol-1.5.2-windows-x64-setup.exe** со страницы [[история релизов>>Main.ERMAK-TT.EAX aduio control utility releases.WebHome]] и запустите его. | ||
| 155 | 1. При необходимости отметьте: | ||
| 156 | 1*. **Create a desktop shortcut** — ярлык на рабочем столе; | ||
| 157 | 1*. **Run at Windows startup** — автозапуск EAX при входе в Windows. | ||
| 158 | 1. Если предыдущая версия уже установлена, установщик предложит сначала удалить её. | ||
| 159 | 1. В брандмауэре Windows разрешите программе **eax.exe** входящие UDP-соединения (Windows обычно спрашивает об этом при первом подключении). | ||
| 160 | |||
| 161 | На Windows EAX показывает значок в области уведомлений (трее). Щелчок по значку скрывает и показывает окно. Через контекстное меню значка можно подключиться к трансиверу, включить динамик, выбрать каналы (**Mixer..**), открыть настройки и выйти (**Quit**). При подключении и потере связи появляются всплывающие уведомления. | ||
| 162 | |||
| 163 | == Главное окно == | ||
| 164 | |||
| 165 | [[image:01_main.png]] | ||
| 166 | |||
| 167 | |=Элемент|=Назначение | ||
| 168 | |**URL**|адрес трансивера в формате **IP:порт**, например **192.168.1.50:4002**. После успешного подключения адрес запоминается в списке. Удалить адрес из списка: правая кнопка мыши → **Delete RIG's URL..** | ||
| 169 | |[[image:ic_speaker.png]]|**Динамик**: включает и выключает вывод принятого звука на **Audio device** (динамики или наушники PC). Стрелка справа открывает меню выбора каналов | ||
| 170 | |[[image:ic_settings.png]]|**Настройки** (доступны только когда EAX не подключён) | ||
| 171 | |[[image:ic_connect.png]]|**Подключиться / отключиться** от трансивера. Красный значок — нет подключения | ||
| 172 | |**L**|уровень приёмника **RX1** (левый канал) | ||
| 173 | |**R**|уровень приёмника **RX2** (правый канал) | ||
| 174 | |**M**|уровень сигнала **передачи**, который EAX отправляет на трансивер | ||
| 175 | |Строка состояния|**Speed** — скорость входящего / исходящего потока (Кбит/с), **Latency** — задержка вывода звука | ||
| 176 | |||
| 177 | === Выбор каналов для динамика === | ||
| 178 | |||
| 179 | [[image:02_menu.png]] | ||
| 180 | |||
| 181 | * **RX1+RX2** — стерео: RX1 в левом канале, RX2 в правом; | ||
| 182 | * **RX1** — только первый приёмник (в обоих каналах); | ||
| 183 | * **RX2** — только второй приёмник (в обоих каналах). | ||
| 184 | |||
| 185 | Выбор влияет только на динамики PC (**Audio device**). В **EAX Output** всегда идёт стерео RX1+RX2. | ||
| 186 | |||
| 187 | === Темы оформления === | ||
| 188 | |||
| 189 | Внешний вид меняется в настройках (**Appearance → Theme**): **System Default**, **Dark Teal**, **Dark Amber**, **Dark Cyan**, **Light Blue**. | ||
| 190 | |||
| 191 | [[image:04_main_dark_teal.png]] | ||
| 192 | |||
| 193 | == Окно настроек == | ||
| 194 | |||
| 195 | Нажмите [[image:ic_settings.png]], задайте параметры и нажмите **OK**. | ||
| 196 | |||
| 197 | [[image:03_settings.png]] | ||
| 198 | |||
| 199 | === Soundcard === | ||
| 200 | |||
| 201 | |=Параметр|=Что выбрать | ||
| 202 | |**EAX Output**|виртуальное устройство, куда EAX выводит принятый звук. Linux: **ERMAK_OUT**; Windows: первая виртуальная карта (VAC 1) | ||
| 203 | |**EAX Input**|виртуальное устройство, откуда EAX берёт звук для передачи. Linux: **ERMAK_IN**; Windows: вторая виртуальная карта (VAC 2) | ||
| 204 | |**Audio device**|динамики или наушники компьютера для прослушивания эфира | ||
| 205 | |**Refresh**|обновить список устройств | ||
| 206 | |||
| 207 | Если устройство подключили или настроили, когда EAX уже работал, и его нет в списке, перезапустите EAX. | ||
| 208 | |||
| 209 | === RX buffer / TX buffer === | ||
| 210 | |||
| 211 | Размер буферов приёма и передачи в кадрах. **Auto** — минимальная задержка. Большие значения (**x2…x8** для RX, **x2…x4** для TX) делают звук устойчивее при нестабильной сети (Wi-Fi), но увеличивают задержку. Если звук прерывается, увеличьте буфер. | ||
| 212 | |||
| 213 | === Network Settings === | ||
| 214 | |||
| 215 | |=Параметр|=Что указать | ||
| 216 | |**Local IP address**|IP-адрес сетевой карты компьютера, через которую он видит трансивер. Это важно, если в компьютере несколько сетевых карт (Ethernet, Wi-Fi, VPN) | ||
| 217 | |**Local UDP port**|UDP-порт на компьютере, на который трансивер отправляет звук. По умолчанию **16742**. Порт должен быть открыт в брандмауэре | ||
| 218 | |||
| 219 | === Appearance === | ||
| 220 | |||
| 221 | **Theme** — тема оформления (см. выше). | ||
| 222 | |||
| 223 | == Подключение к трансиверу == | ||
| 224 | |||
| 225 | 1. Запустите EAX. | ||
| 226 | 1. В поле **URL** введите адрес трансивера, например **192.168.1.50:4002**. | ||
| 227 | 1. Нажмите [[image:ic_connect.png]]. Во время подключения отображается индикатор ожидания. | ||
| 228 | 1. После подключения в строке состояния растёт **Speed**, а индикаторы **L** / **R** показывают уровни приёма. | ||
| 229 | 1. Чтобы слушать эфир на компьютере, включите [[image:ic_speaker.png]]. | ||
| 230 | |||
| 231 | Если связь пропадает, EAX переподключается автоматически: сначала через 1 секунду, затем с увеличивающимся интервалом до 30 секунд. В строке состояния при этом видно сообщение **Reconnecting in N s...** | ||
| 232 | |||
| 233 | == Настройка цифровых программ (WSJT-X / JTDX) == | ||
| 234 | |||
| 235 | **File → Settings → Audio:** | ||
| 236 | |||
| 237 | |=Поле|=Linux|=Windows | ||
| 238 | |**Input**|ERMAK_OUT_RESERVED|виртуальная карта 1 (VAC 1), запись | ||
| 239 | |**Output**|ERMAK_IN_RESERVED|виртуальная карта 2 (VAC 2), воспроизведение | ||
| 240 | |||
| 241 | **File → Settings → Radio:** | ||
| 242 | |||
| 243 | * **Rig**: **Hamlib NET rigctl** | ||
| 244 | * **Network Server**: **IP-адрес трансивера:4532** | ||
| 245 | * **PTT Method**: **CAT** | ||
| 246 | |||
| 247 | Проверьте работу кнопкой **Tune**: трансивер должен перейти на передачу, а индикатор **M** в EAX — показать уровень сигнала. | ||
| 248 | |||
| 249 | == Решение проблем == | ||
| 250 | |||
| 251 | |=Сообщение / симптом|=Что проверить | ||
| 252 | |**Unable connect to remote Rig**|правильность IP и порта (**4002**), доступность трансивера по сети (**ping**), разрешён ли интерфейс EAX на трансивере | ||
| 253 | |**Unable to configure audio card**|в настройках выбраны все три устройства, и они не заняты другой программой; на Linux загружен snd-aloop (**aplay -l**) | ||
| 254 | |**Lost connection with Rig**|входящий поток долго оставался ниже 200 Кбит/с: проверьте сеть, **Local IP address** и брандмауэр (входящий UDP на **Local UDP port**) | ||
| 255 | |Подключение есть, но **Speed** входящего потока = 0|брандмауэр PC блокирует UDP или выбран неверный **Local IP address** | ||
| 256 | |Звук прерывается|увеличьте **RX buffer**, по возможности используйте Ethernet вместо Wi-Fi | ||
| 257 | |Нет передачи|на трансивере выбран источник **EAX** в окне TX settings; в WSJT-X выход — правильное виртуальное устройство; индикатор **M** показывает уровень | ||
| 258 | |**Application is already running.**|EAX уже запущен (на Windows проверьте значок в трее) | ||
| 259 | |Белый экран на Windows|установите пакет совместимости OpenCL/OpenGL/Vulkan (см. в начале страницы) | ||
| 260 | |||
| 261 | == Дополнительно == | ||
| 262 | |||
| 263 | === Где хранятся настройки === | ||
| 264 | |||
| 265 | * Linux: **~/.config/Ermak/eAX.conf** | ||
| 266 | * Windows: реестр, раздел **HKEY_CURRENT_USER\Software\Ermak\eAX** | ||
| 267 | |||
| 268 | === Параметры командной строки === | ||
| 269 | |||
| 270 | {{code language="none"}} | ||
| 271 | eax [параметры] | ||
| 272 | -t, --theme <тема> default | dark_teal | dark_amber | dark_cyan | light_blue | ||
| 273 | -l, --log-file <файл> записывать журнал в файл | ||
| 274 | -L, --log-level <уровень> emergency|alert|critical|error|warning|notice|info|debug (по умолчанию error) | ||
| 275 | -v, --version версия программы | ||
| 276 | -h, --help справка | ||
| 277 | {{/code}} | ||
| 278 | |||
| 279 | Для диагностики проблем запустите EAX с журналом и приложите файл к сообщению об ошибке: | ||
| 280 | |||
| 281 | {{code language="bash"}} | ||
| 282 | eax -L debug -l ~/eax.log | ||
| 283 | {{/code}} |