Troubleshooting

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

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:Main.ERMAK-TT.Руководство пользователя EAX control.Решение проблем.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

← EAX control user guide

Troubleshooting

Find what you see and open the fix. Also here: the router, choosing the IP address and operating from a remote QTH.

Find the fix in 2 questions

What do you see?

EAX does not connect

The message “Unable connect to remote Rig”.

Connected, but no audio

Speed is 0. A few seconds later — “Lost connection with Rig”.

The audio drops out

Clicks, gurgling, gaps.

JTDX sees no signal or the transceiver does not transmit

Everything works in EAX, but not in the digital mode program.

Sound card error

The message “Unable to configure audio card”.

I need to operate from a remote QTH

The rig is at the home QTH, you are at the cottage or on holiday.

Other EAX messages

“Application is already running”, white window and others.

EAX does not connect

Wrong address

Check the URL field. You need the transceiver IP address, a colon and port 4002. Example: 192.168.1.50:4002.

The computer does not see the transceiver on the network

  1. Make sure the transceiver is on and connected to the router.
  2. Check the connection with ping (see below).
  3. If there are no replies, the problem is in the network or router. See Router.

The EAX interface is disabled on the transceiver

Enable EAX in the transceiver remote connection settings.

How to check the connection (ping)

Windows: press Win+R, type cmd, press Enter. Linux: open a terminal. Type your transceiver address:

ping 192.168.1.50

Lines “Reply from…” or “bytes from…” — the network works. “Request timed out” or “Destination Host Unreachable” — the computer does not see the transceiver.

Connected, but no audio

The connect button is lit, but Speed is zero. EAX has reached the transceiver, but the audio from the transceiver does not get to the computer.

Cause 1. Wrong IP address in EAX settings

This is the most common problem, especially on Windows. When connecting, EAX tells the transceiver the computer address from the Local IP address field. The transceiver sends audio only to that address.

A computer often has several addresses: Ethernet, Wi-Fi, VPN, virtual adapters. If the wrong one is selected, the audio goes nowhere.

ip_choice_en.png

  1. Disconnect from the transceiver.
  2. Open EAX settings ic_settings.png.
  3. In the Local IP address field select the address whose first three numbers match the transceiver address.
  4. Click OK and connect again.

Check: Speed is above zero, the L and R meters move.

On first start the field shows 127.0.0.1 — audio does not work with it. A laptop that connects sometimes over Wi-Fi and sometimes by cable gets different addresses — check the field after changing the connection.

Check the IP address for EAX

How to find the computer IP address

Windows: Win+R → cmd → Enter, then type ipconfig. You need the IPv4 Address line of the Ethernet or Wireless adapter.

Linux: type ip -4 addr in a terminal.

Cause 2. A firewall blocks the audio

The audio arrives at the computer over UDP on port 16742. A firewall may block it.

Windows:

  1. On the first connection Windows asks about network access. Click Allow access and tick Private networks.
  2. If you clicked Cancel: Control Panel → Windows Defender Firewall → Allow an app through firewall. Find eax and tick Private.
  3. Your network type must be Private, not Public: Settings → Network & Internet → network properties.
  4. If your antivirus has its own firewall (Kaspersky, ESET and others), allow EAX there too.
Linux: open the port in the firewall

Fedora:

sudo firewall-cmd --permanent --add-port=16742/udp
sudo firewall-cmd --reload

Ubuntu (if ufw is enabled):

sudo ufw allow 16742/udp

Cause 3. A VPN is on

Some VPNs send all traffic into the tunnel, and the home network becomes unreachable. Turn off the VPN or allow local network access in it (Allow LAN).

Router

router_en.png

Guest network. Devices on the guest Wi-Fi network do not see the main network. Connect the computer and the transceiver to the main network.

Client isolation (AP Isolation, Client Isolation). This Wi-Fi option stops devices from talking to each other. Turn it off in the router settings.

Two networks: regular and 5G (for example “Home” and “Home_5G”). Usually this is one network and EAX works. If there is no connection, put both devices on the network with the same name.

A mesh system or Wi-Fi extender sometimes creates a separate network. Check that the first three numbers of the transceiver and computer addresses match.

The audio drops out

Audio flows over the network continuously, and weak Wi-Fi breaks it up.

  1. If possible, connect the computer or the transceiver by cable.
  2. Increase RX buffer in EAX settings: x4 or x8.
  3. Close programs that load the network heavily (downloads, video).

JTDX sees no signal or the transceiver does not transmit

If the L and R meters move in EAX but JTDX sees no signal, the wrong input is selected in JTDX. If the transceiver goes to transmit but the M meter in EAX does not move, the wrong output is selected.

Correct devices: JTDX and WSJT-X setup.

If the transceiver goes to transmit but there is no power, select the EAX source on the transceiver in the TX settings window.

Sound card error

The message “Unable to configure audio card” means that EAX cannot open an audio device.

  1. In EAX settings select all three devices: EAX Output, EAX Input and Audio device.
  2. Close programs that may use these devices.
  3. Linux: check that the virtual cards are present — aplay -l must show Loopback lines.
  4. Close EAX and start it again.

Operating from a remote QTH

The transceiver is at your home QTH, and you are at the cottage, on holiday or at work. There are two ways to connect EAX to the transceiver over the Internet.

remote_en.png

Option 1. Port forwarding

Works if both the home and the remote Internet have a public (external) IP address. Only router settings are needed.

Option 2. VPN

Always works, also without a public IP: mobile Internet, hotel, provider with CGNAT. Safer: no ports are open to the whole Internet.

Option 1. Port forwarding

On the home QTH router (where the transceiver is) forward to the transceiver IP address:

PortProtocolPurpose
4002TCPEAX connection to the transceiver
1277UDPtransmit audio from the computer

On the remote QTH router (where the computer is) forward to the computer IP address:

PortProtocolPurpose
16742UDPreceive audio from the transceiver (Local UDP port field in EAX)

In EAX:

  1. In the URL field type the public IP address of the home router and port 4002, for example 203.0.113.10:4002.
  2. Open settings. In the Local IP address field type manually the public IP address of the remote router. The transceiver will send audio exactly there.
  3. Click OK and connect.

Check: Speed is above zero. If the first number is 0, the UDP 16742 forwarding on the remote router does not work or the wrong address is in Local IP address.

How to find the public IP address and whether it is really public

Open an IP check site in your browser — it shows the external address. Compare it with the WAN address in the router settings. If they match, the IP is public and forwarding works. If not (the router shows an address like 10.x.x.x or 100.64–100.127.x.x), the provider uses CGNAT and you need a VPN.

If the external address changes (dynamic IP), set up DDNS in the home router and type the name in the URL field, for example myqth.example.net:4002.

An open port 4002 is visible to the whole Internet: anyone who knows the address can connect to the transceiver. If the router can do it, allow forwarding only from your remote QTH address. Or enable forwarding only while you operate.

Option 2. VPN

A VPN connects the computer to the home network as if you were in your shack. WireGuard, OpenVPN, ZeroTier, Tailscale or a VPN server built into the router will do.

  1. Connect the computer to the home QTH VPN.
  2. In the URL field enter the transceiver address on the home network, for example 192.168.1.50:4002.
  3. In the Local IP address field select the address of the computer VPN adapter.

No port forwarding is needed.

Other messages

Application is already running. EAX is already running. On Windows look for the EAX icon next to the clock.

Lost connection with Rig. No audio has arrived from the transceiver for a few seconds. See Connected, but no audio.

Reconnecting in N s... The connection dropped, EAX reconnects by itself. If this happens often, check the network.

White window on Windows. Install the OpenCL, OpenGL and Vulkan Compatibility Pack.

Nothing helped

  1. Close EAX.
  2. Start EAX with a log: Windows — eax.exe -L debug -l eax.log in the program folder, Linux — eax -L debug -l ~/eax.log.
  3. Reproduce the problem.
  4. Send the log file to the developers with a description: what you did and what you saw.