Last modified by UT2UK on 2026/11/16 13:09

Hide last authors
UT2UK 7.3 1 {{velocity}}
UT2UK 7.10 2 $xwiki.ssx.use("Main.DocStyle")$xwiki.jsx.use("Main.DocStyle")
UT2UK 7.3 3 {{/velocity}}
UT2UK 5.2 4
5 (% class="eax" %)
UT2UK 1.1 6 (((
UT2UK 5.2 7 (% class="eax-back" %)
UT2UK 13.2 8 [[← EAX control user guide>>Main.ERMAK-TT.Руководство пользователя EAX control.WebHome]]
UT2UK 1.1 9
UT2UK 5.2 10 (% class="eax-pagehead" %)
11 (((
12 (% class="eax-pagehead-title" %)
UT2UK 13.2 13 Installing EAX on Linux
UT2UK 1.1 14
UT2UK 5.2 15 (% class="eax-pagehead-text" %)
UT2UK 13.2 16 How to install EAX, create the virtual sound cards and make your first FT8 QSO. Fedora 38–44 and Ubuntu 20.04–24.04, about 15 minutes.
UT2UK 1.1 17 )))
18
UT2UK 13.2 19 === What you need ===
UT2UK 6.2 20
UT2UK 13.2 21 * The ERMAK-TT transceiver is connected to the router and the EAX interface is enabled. You know its IP address.
22 * A Linux computer on the same network.
23 * The administrator password for **sudo** commands.
24 * For digital modes — JTDX or WSJT-X installed.
UT2UK 6.2 25
UT2UK 5.2 26 (% class="eax-toc" %)
27 (((
UT2UK 13.2 28 Steps
UT2UK 1.1 29
UT2UK 5.2 30 {{toc depth="2"/}}
31 )))
UT2UK 1.1 32
UT2UK 5.2 33 (% class="eax-howto" %)
34 (((
UT2UK 13.2 35 == Install EAX ==
UT2UK 5.2 36
UT2UK 13.2 37 Download the package for your system:
UT2UK 1.1 38
UT2UK 5.2 39 (% class="eax-download" %)
40 (((
UT2UK 13.2 41 [[⬇ Ubuntu 24.04>>attach:Main.ERMAK-TT.Руководство пользователя EAX control.История версий.WebHome@eaxcontrol-1.5.2-ubuntu24.04.deb||class="btn btn-success"]] [[⬇ Fedora 42>>attach:Main.ERMAK-TT.Руководство пользователя EAX control.История версий.WebHome@eaxcontrol-1.5.2-fc42.rpm||class="btn btn-success"]] [[Other versions>>Main.ERMAK-TT.Руководство пользователя EAX control.История версий.WebHome||class="btn btn-default"]]
UT2UK 5.2 42 )))
UT2UK 1.1 43
UT2UK 13.2 44 Open a terminal in the folder with the downloaded file and install the package:
UT2UK 1.1 45
UT2UK 5.2 46 (% class="eax-split" %)
47 (((
48 (% class="eax-card" %)
49 (((
50 Ubuntu
UT2UK 1.1 51
52 {{code language="bash"}}
53 sudo apt install ./eaxcontrol-1.5.2-ubuntu24.04.deb
54 {{/code}}
UT2UK 5.2 55 )))
UT2UK 1.1 56
UT2UK 5.2 57 (% class="eax-card" %)
58 (((
59 Fedora
UT2UK 1.1 60
61 {{code language="bash"}}
62 sudo dnf install ./eaxcontrol-1.5.2-fc42.rpm
63 {{/code}}
UT2UK 5.2 64 )))
65 )))
UT2UK 1.1 66
UT2UK 5.2 67 (% class="eax-check" %)
68 (((
UT2UK 13.2 69 Check: **EAX Control** appears in the application menu.
UT2UK 5.2 70 )))
UT2UK 1.1 71
UT2UK 13.2 72 == Create the virtual sound cards ==
UT2UK 1.1 73
UT2UK 13.2 74 A virtual sound card is a “cable” inside the computer: EAX sends audio into it, and JTDX or WSJT-X receive it. On Linux the **snd-aloop** module creates such cards. You need two cards: no. 10 for receive and no. 11 for transmit.
UT2UK 1.1 75
UT2UK 13.2 76 Paste these three commands into the terminal. They configure the cards and enable them at once, no reboot needed:
UT2UK 1.1 77
78 {{code language="bash"}}
UT2UK 5.2 79 echo "options snd-aloop enable=1,1 index=10,11 pcm_substreams=2,2" | sudo tee /etc/modprobe.d/snd-aloop.conf
80 echo "snd-aloop" | sudo tee /etc/modules-load.d/snd-aloop.conf
81 sudo modprobe snd-aloop
UT2UK 1.1 82 {{/code}}
83
UT2UK 5.2 84 (% class="eax-check" %)
85 (((
UT2UK 13.2 86 Check: **aplay -l | grep Loopback** shows 4 lines — cards 10 and 11, two devices each.
UT2UK 1.1 87 )))
88
UT2UK 13.2 89 {{expand title="modprobe reports an error (Ubuntu)" expanded="false"}}
90 On some Ubuntu versions the module is in a separate package. Install it and repeat the commands:
UT2UK 1.1 91
92 {{code language="bash"}}
UT2UK 5.2 93 sudo apt install linux-modules-extra-$(uname -r)
UT2UK 1.1 94 {{/code}}
95
UT2UK 13.2 96 On Fedora the module is already in the system.
UT2UK 5.2 97 {{/expand}}
UT2UK 1.1 98
UT2UK 13.2 99 == Add names for digital mode programs ==
UT2UK 1.1 100
UT2UK 13.2 101 This command creates two devices with clear names — **ERMAK_OUT** and **ERMAK_IN**. You will select them in JTDX or WSJT-X.
UT2UK 1.1 102
103 {{code language="bash"}}
104 cat >> ~/.asoundrc <<'EOF'
105 pcm.ERMAK_OUT {
106 type plug
107 slave { pcm "hw:10,0,0" format S16_LE rate 48000 channels 2 }
108 hint { show on description "Ermak EAX VAC RX" }
109 }
110 pcm.ERMAK_IN {
111 type plug
112 slave { pcm "hw:11,1,0" format S16_LE rate 48000 channels 1 }
113 hint { show on description "Ermak EAX VAC TX" }
114 }
115 EOF
116 {{/code}}
117
UT2UK 5.2 118 (% class="eax-note" %)
UT2UK 1.1 119 (((
UT2UK 13.2 120 Do not add **pcm.!default** lines from old guides to **~~/.asoundrc**. Today PipeWire or PulseAudio manages audio on Linux, and such lines can mute audio in other programs.
UT2UK 1.1 121 )))
122
UT2UK 13.2 123 == Set up EAX ==
UT2UK 1.1 124
UT2UK 13.2 125 Start EAX and click the settings button [[image:Main.ERMAK-TT.Руководство пользователя EAX control.WebHome@ic_settings.png]]. Select the devices as shown:
UT2UK 1.1 126
UT2UK 5.2 127 (% class="eax-figure" %)
128 (((
UT2UK 13.2 129 [[image:devmap_linux_en.png]]
UT2UK 5.2 130 )))
UT2UK 1.1 131
UT2UK 5.2 132 (% class="eax-split" %)
133 (((
134 (% class="eax-shot" %)
135 (((
136 [[image:05_settings_linux.png]]
137 )))
UT2UK 1.1 138
UT2UK 5.2 139 (((
140 * **EAX Output** — **Loopback: PCM (hw:10,1)**
141 * **EAX Input** — **Loopback: PCM (hw:11,0)**
UT2UK 13.2 142 * **Audio device** — **default**: audio goes to the speakers selected in the system
143 * **Local IP address** — the computer address on the same network as the transceiver
UT2UK 1.1 144
UT2UK 5.2 145 (% class="eax-key" %)
146 (((
UT2UK 13.2 147 **Local IP address is the most important field.** The first three numbers must match the transceiver address: 192.168.1.50 → 192.168.1.10. On first start it shows 127.0.0.1 — with it there is no audio.
UT2UK 5.2 148 )))
UT2UK 1.1 149
UT2UK 13.2 150 Click **OK**.
UT2UK 5.2 151 )))
152 )))
UT2UK 1.1 153
UT2UK 5.2 154 (% class="eax-note" %)
155 (((
UT2UK 13.2 156 EAX reads the list of audio devices at startup. If the Loopback cards are not in the list, close EAX and start it again.
UT2UK 5.2 157 )))
UT2UK 1.1 158
UT2UK 13.2 159 == Connect to the transceiver ==
UT2UK 1.1 160
UT2UK 13.2 161 1. In the URL field type the transceiver address and port 4002, for example **192.168.1.50:4002**.
162 1. Click [[image:Main.ERMAK-TT.Руководство пользователя EAX control.WebHome@ic_connect.png]].
UT2UK 1.1 163
UT2UK 5.2 164 (% class="eax-check" %)
UT2UK 1.1 165 (((
UT2UK 13.2 166 Check: **Speed** in the status line is above zero, the L and R meters move.
UT2UK 1.1 167 )))
168
UT2UK 13.2 169 {{expand title="Speed is zero — open the port in the firewall" expanded="false"}}
UT2UK 5.2 170 Fedora:
UT2UK 1.1 171
172 {{code language="bash"}}
173 sudo firewall-cmd --permanent --add-port=16742/udp
174 sudo firewall-cmd --reload
175 {{/code}}
176
UT2UK 13.2 177 Ubuntu (if ufw is enabled):
UT2UK 1.1 178
UT2UK 5.2 179 {{code language="bash"}}
180 sudo ufw allow 16742/udp
181 {{/code}}
UT2UK 1.1 182
UT2UK 13.2 183 Other causes — see [[Connected, but no audio>>Main.ERMAK-TT.Руководство пользователя EAX control.Решение проблем.WebHome||anchor="nosound"]].
UT2UK 5.2 184 {{/expand}}
UT2UK 1.1 185
UT2UK 13.2 186 == Set up JTDX or WSJT-X ==
UT2UK 1.1 187
UT2UK 13.2 188 In the program select **Input — ERMAK_OUT** and **Output — ERMAK_IN**, and on the Radio tab — **Hamlib NET rigctl** with the transceiver address and port 4532. This is how correct JTDX and EAX settings look together:
UT2UK 1.1 189
UT2UK 7.2 190 (% class="eax-figure" %)
191 (((
192 [[image:eax_jtdx_linux.png]]
193 )))
194
UT2UK 13.2 195 Details: [[JTDX and WSJT-X setup>>Main.ERMAK-TT.Руководство пользователя EAX control.Настройка JTDX и WSJT-X.WebHome]].
UT2UK 7.2 196
UT2UK 5.2 197 (% class="eax-check" %)
198 (((
UT2UK 13.2 199 Check: JTDX shows decodes. You are ready for QSOs.
UT2UK 5.2 200 )))
201 )))
202
UT2UK 13.2 203 == Summary of settings ==
UT2UK 5.2 204
UT2UK 13.2 205 |=Program|=Field|=Value
206 |EAX|URL|transceiver IP address:4002
UT2UK 6.2 207 |EAX|EAX Output|Loopback: PCM (hw:10,1)
208 |EAX|EAX Input|Loopback: PCM (hw:11,0)
209 |EAX|Audio device|default
UT2UK 13.2 210 |EAX|Local IP address|computer IP address on the transceiver network
UT2UK 6.2 211 |JTDX / WSJT-X|Input|ERMAK_OUT
212 |JTDX / WSJT-X|Output|ERMAK_IN
UT2UK 13.2 213 |JTDX / WSJT-X|Rig|Hamlib NET rigctl, transceiver IP address:4532
UT2UK 6.2 214
UT2UK 13.2 215 == Related articles ==
UT2UK 6.2 216
UT2UK 13.2 217 * [[JTDX and WSJT-X setup>>Main.ERMAK-TT.Руководство пользователя EAX control.Настройка JTDX и WSJT-X.WebHome]]
218 * [[Program windows>>Main.ERMAK-TT.Руководство пользователя EAX control.Окна программы.WebHome]]
219 * [[Troubleshooting>>Main.ERMAK-TT.Руководство пользователя EAX control.Решение проблем.WebHome]]
220 * [[All EAX versions>>Main.ERMAK-TT.Руководство пользователя EAX control.История версий.WebHome]]
UT2UK 5.2 221 )))