Troubleshooting

Where's the log file?

OpsLog writes a diagnostic log. The path is shown in Settings (and can be opened from there). When reporting a problem, include the relevant lines — they're prefixed by subsystem (cat:, Flex:, icom net:, antgenius:, cluster:, qslmgr:log, audio:…). With an SMTP server configured, Help → Send log to F4BPO e-mails the logs straight to the developer.

A crash no longer leaves a blank window: the error is shown on screen, selectable, with a copy button.

CAT

Radio not connecting — check the backend fields (COM port + baud for USB; IP/credentials for network). The CAT log line carries the error explaining a disconnection.
"Serial port busy" in the log — another program holds the COM port (WSJT-X, MSHV, another logger configured for direct CAT). Only one program can own the port: let OpsLog hold it and point the others at Hamlib NET rigctl 127.0.0.1:4532 (Settings → CAT → Share CAT). Two masters on one CI-V bus also cause garbled frames and erratic behaviour.
The radio transmits as soon as OpsLog connects — your interface reads DTR or RTS as PTT. Xiegu drops the lines automatically; on Yaesu and Kenwood enable the lower DTR/RTS on connect option. (It is off by default because other interfaces stop transmitting with the lines low.)
WSJT-X won't key a Xiegu G90 through OmniRig — a G90 ignores the CI-V PTT command. Use the native Xiegu backend (which keys RTS/DTR) + rigctl sharing, or set the PTT line inside OmniRig. See Kenwood and Xiegu.
OmniRig frequency frozen / wrong VFO — set VFO to read (A or B) in the OmniRig backend settings; some rig files declare the wrong VFO.
"OmniRig not found" with OmniRig running — one of the two runs as administrator and the other doesn't. Start both the same way.
Icom: no CAT at all over USB — the CI-V address must match the radio; pick your model from the dropdown (it sets the address) and set CI-V USB Echo Back OFF on the rig.
A radio that answers oddly — enable the protocol trace (Settings → CAT): every frame to and from the rig lands in the log as hex, which turns a guess into a diagnosis.

Remote Icom

Login rejected → wrong Network User1 name/password.
Can't bind local port → the Icom Remote Utility is still running — close it.
Frequency frozen after another program took the CI-V session — OpsLog reconnects on its own; if it doesn't, check the icom net: log lines. See Remote Icom over the Internet.

FlexRadio

A control reads 0 / stale at startup — some SmartSDR status fields use short names. If a value never populates, capture the Flex: … status log line and report it.
SmartSDR CAT keeps disconnecting while OpsLog is open — fixed: OpsLog now binds only to the actual SmartSDR/Maestro GUI client. Update.
"Interlock is preventing transmission" with a SteppIR — see the tunable range setting in Maps and Antennas.

Multi-op live status PHP

Connection refused from the PHP page is almost always MySQL bind-address = 127.0.0.1 or a firewall/grant issue — see Multi-Operator Live Status.

DVK / PTT

Test PTT does nothing on CAT/OmniRig — the key is held ~1.5 s so the async OmniRig write is actually sent; if it still doesn't key, the rig's OmniRig profile may not expose CAT TX keying — use RTS/DTR or VOX.
A voice message transmits almost nothing — raise the message level (Settings → Audio) and check the rig's rear-input setting (FTDX10: SSB MOD SOURCE = REAR).

Still stuck?

Open an issue (or Send log to F4BPO) with: what you did, what happened, your radio/model, and the relevant log lines.

3.7 KiB Raw Blame History