Skip to content

Troubleshooting

SP5XTF edited this page Nov 8, 2026 · 2 revisions

Troubleshooting

Wersja polska

“No response” after connecting – choose the other port of the pair, check CAT RATE = 38400 on the radio and the speed in the status bar.

Scope: “libft4222.dylib not found” – install both FTDI libraries (libft4222 and libftd2xx) in /usr/local/lib and remove the quarantine flag (xattr). “Cannot open the FT4222” – SCU-LAN10 = ON, replug USB, no other program is using the scope.

macOS asks for the Keychain password (QRZ) – click “Always Allow”. After every new build macOS asks again (it treats it as a new program).

Greyed-out control – the radio did not answer its command; details in the Help → CAT log window.

No audio from the radio – microphone permission for the program (System Settings → Privacy & Security → Microphone), the correct “From radio (RX)” device.

Waterfall stutters – check the counters in the status bar (“Diagnostics” topic) and include them in your report.

DX Cluster does not connect – try another node from the menu; node messages are shown in the console.

The CW key does not transmit – check on the radio: CW mode, BK-IN on, PC KEYING = DTR (or RTS, matching the program); in the program the key port = the radio's second port (not the CAT port). “Cannot open the key port” – the port is used by another program (e.g. WSJT-X set to PTT on that port).

The CW decoder prints garbage – check the SNR (bar in the CW tab) and pick the station by clicking the spectrum; with several stations close together, narrow the radio filter (RX BW).

Restoring the logbook – in the logbook window click Restore from backup… and choose a backup. Manually: backups are in ~/Library/Application Support/FT710Control/ (logbook-kopia.json, logbook-przed-….json) – quit the program, rename the chosen backup to logbook.json and start the program again. If the Mac's disk failed: daily backups are in iCloud Drive (folder FT-710 Control/Kopie dziennika) – on a new computer restore them with Restore from backup…, and dziennik-najnowszy.adi can be imported into any program.

Diagnostic report (menu Help → Save diagnostic report…)

  • One text file to attach to a bug report on GitHub (Issues): program version, macOS, Mac model, the radio connection state, the latest CAT and scope log entries, audio devices, the FT8, remote operation and CAT Share state, and the settings – without passwords. Save it right after the problem occurs, before quitting the program.

← Shortcuts · Home · About →

Clone this wiki locally