OpsLog/wiki/Troubleshooting.md

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 (Flex:, icom net:, icom scope, antgenius:, cluster:, qslmgr:log, audio:…).

CAT

• Radio not connecting — check the backend fields (COM port + baud for USB; IP/credentials for network). OpsLog connects non-blocking, so it won't freeze — watch the CAT status.
• 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.
• Icom scope blank on an IC-7300 — this was a bug where the scope decoder was chosen from the configured CI-V address; it now uses the model detected from the CI-V ID, so a single-scope rig run at address 0x98 decodes correctly. Update to the latest build.
• Icom attenuator button does nothing — the dB steps are model-specific; make sure the right model is selected (IC-7300 = 20 dB, IC-7610 = 6/12/18 dB).

Remote Icom

• Login rejected → wrong Network User1 name/password.
• Can't bind local port → the Icom Remote Utility is still running — close it.
• Link drops with the scope on → receive-side retransmit should hold it; if not, check network quality and 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 (e.g. the TX filter is reported as lo/hi, not filter_low/high). If a value never populates, capture the Flex: … status log line and report it.
• Antenna wrong band on a spot click — fixed: SetFrequency/SetMode update the slice cache immediately so the panel and the Ultrabeam follow don't chase a stale frequency.

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.

Still stuck?

Open an issue with: what you did, what happened, your radio/model, and the relevant log lines.