79 lines
3.7 KiB
Markdown
79 lines
3.7 KiB
Markdown
# 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.
|