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

Show last authors
1 {{velocity}}
2 $xwiki.ssx.use("Main.DocStyle")$xwiki.jsx.use("Main.DocStyle")
3 {{/velocity}}
4
5 (% class="eax" %)
6 (((
7 (% class="eax-back" %)
8 [[← EAX control user guide>>Main.ERMAK-TT.Руководство пользователя EAX control.WebHome]]
9
10 (% class="eax-pagehead" %)
11 (((
12 (% class="eax-pagehead-title" %)
13 Installing EAX on Linux
14
15 (% class="eax-pagehead-text" %)
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.
17 )))
18
19 === What you need ===
20
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.
25
26 (% class="eax-toc" %)
27 (((
28 Steps
29
30 {{toc depth="2"/}}
31 )))
32
33 (% class="eax-howto" %)
34 (((
35 == Install EAX ==
36
37 Download the package for your system:
38
39 (% class="eax-download" %)
40 (((
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"]]
42 )))
43
44 Open a terminal in the folder with the downloaded file and install the package:
45
46 (% class="eax-split" %)
47 (((
48 (% class="eax-card" %)
49 (((
50 Ubuntu
51
52 {{code language="bash"}}
53 sudo apt install ./eaxcontrol-1.5.2-ubuntu24.04.deb
54 {{/code}}
55 )))
56
57 (% class="eax-card" %)
58 (((
59 Fedora
60
61 {{code language="bash"}}
62 sudo dnf install ./eaxcontrol-1.5.2-fc42.rpm
63 {{/code}}
64 )))
65 )))
66
67 (% class="eax-check" %)
68 (((
69 Check: **EAX Control** appears in the application menu.
70 )))
71
72 == Create the virtual sound cards ==
73
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.
75
76 Paste these three commands into the terminal. They configure the cards and enable them at once, no reboot needed:
77
78 {{code language="bash"}}
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
82 {{/code}}
83
84 (% class="eax-check" %)
85 (((
86 Check: **aplay -l | grep Loopback** shows 4 lines — cards 10 and 11, two devices each.
87 )))
88
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:
91
92 {{code language="bash"}}
93 sudo apt install linux-modules-extra-$(uname -r)
94 {{/code}}
95
96 On Fedora the module is already in the system.
97 {{/expand}}
98
99 == Add names for digital mode programs ==
100
101 This command creates two devices with clear names — **ERMAK_OUT** and **ERMAK_IN**. You will select them in JTDX or WSJT-X.
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
118 (% class="eax-note" %)
119 (((
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.
121 )))
122
123 == Set up EAX ==
124
125 Start EAX and click the settings button [[image:Main.ERMAK-TT.Руководство пользователя EAX control.WebHome@ic_settings.png]]. Select the devices as shown:
126
127 (% class="eax-figure" %)
128 (((
129 [[image:devmap_linux_en.png]]
130 )))
131
132 (% class="eax-split" %)
133 (((
134 (% class="eax-shot" %)
135 (((
136 [[image:05_settings_linux.png]]
137 )))
138
139 (((
140 * **EAX Output** — **Loopback: PCM (hw:10,1)**
141 * **EAX Input** — **Loopback: PCM (hw:11,0)**
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
144
145 (% class="eax-key" %)
146 (((
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.
148 )))
149
150 Click **OK**.
151 )))
152 )))
153
154 (% class="eax-note" %)
155 (((
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.
157 )))
158
159 == Connect to the transceiver ==
160
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]].
163
164 (% class="eax-check" %)
165 (((
166 Check: **Speed** in the status line is above zero, the L and R meters move.
167 )))
168
169 {{expand title="Speed is zero — open the port in the firewall" expanded="false"}}
170 Fedora:
171
172 {{code language="bash"}}
173 sudo firewall-cmd --permanent --add-port=16742/udp
174 sudo firewall-cmd --reload
175 {{/code}}
176
177 Ubuntu (if ufw is enabled):
178
179 {{code language="bash"}}
180 sudo ufw allow 16742/udp
181 {{/code}}
182
183 Other causes — see [[Connected, but no audio>>Main.ERMAK-TT.Руководство пользователя EAX control.Решение проблем.WebHome||anchor="nosound"]].
184 {{/expand}}
185
186 == Set up JTDX or WSJT-X ==
187
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:
189
190 (% class="eax-figure" %)
191 (((
192 [[image:eax_jtdx_linux.png]]
193 )))
194
195 Details: [[JTDX and WSJT-X setup>>Main.ERMAK-TT.Руководство пользователя EAX control.Настройка JTDX и WSJT-X.WebHome]].
196
197 (% class="eax-check" %)
198 (((
199 Check: JTDX shows decodes. You are ready for QSOs.
200 )))
201 )))
202
203 == Summary of settings ==
204
205 |=Program|=Field|=Value
206 |EAX|URL|transceiver IP address:4002
207 |EAX|EAX Output|Loopback: PCM (hw:10,1)
208 |EAX|EAX Input|Loopback: PCM (hw:11,0)
209 |EAX|Audio device|default
210 |EAX|Local IP address|computer IP address on the transceiver network
211 |JTDX / WSJT-X|Input|ERMAK_OUT
212 |JTDX / WSJT-X|Output|ERMAK_IN
213 |JTDX / WSJT-X|Rig|Hamlib NET rigctl, transceiver IP address:4532
214
215 == Related articles ==
216
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]]
221 )))