Slice Troubleshooting¶
The Slice Troubleshooting dialog captures a JSON snapshot (schema v3) of every slice, panadapter, transverter, DAX channel, audio device, client DSP state, audio endpoint, control-device (MIDI) bindings, and renderer state, and summarizes likely problems (missing audio, stuck mute, missing antenna, XVTR validity) in plain language. This page explains how to capture and share that snapshot for support.
Before you start¶
- AetherSDR must be connected to a radio. The dialog requires an active radio connection.
- If slice state has changed since you last opened the dialog, click
Refresh Snapshotbefore copying to ensure the data is current.
Steps¶
- Open
Help > Slice Troubleshooting.... - Review the
Issue Summarytab for a plain-language list of detected problems, or click theJSONtab to view the full snapshot. - Click
Copy Summaryto copy the issue summary to the clipboard, orCopy JSONto copy the full JSON snapshot. - Confirm the status label reads
Copied to clipboard. - Paste into your target application.
What each control does¶
| Control | Kind | Behavior |
|---|---|---|
Issue Summary (tab) |
Tab | Displays a plain-language bullet list of detected problems. |
JSON (tab) |
Tab | Displays the full JSON snapshot (schema v3) of slices, DAX channels, audio devices, client DSP state, control devices, audio endpoints, and renderer state. |
Refresh Snapshot |
Button | Re-reads current slice state into the snapshot. Click this after making any slice changes before copying. |
Copy Summary |
Button | Copies the issue summary text to the clipboard. |
Copy JSON |
Button | Copies the full JSON snapshot to the clipboard. |
Export JSON... |
Button | Saves the JSON snapshot to a file. |
Find: |
Text field | Highlights matching occurrences of the entered term in the active tab (Issue Summary or JSON). Has clear button and placeholder 'Search snapshot...'. Enter jumps to the next match; tab sharing updates highlight counts. Status label shows ' |
Find Next |
Button | Jumps to the next match of the search term in the active tab. Wraps within the current tab. Empty term produces no matches. |
Close |
Button | Closes the dialog. |
What the Issue Summary includes¶
The Issue Summary tab generates a plain-language bullet list from the snapshot. As of v26.8.4 the summary includes the following:
TX meter freshness¶
The summary now reports whether TX meters are live. If the TX meter sample is stale, the summary shows:
- A warning that TX meters are NOT live, with the age of the last sample (or a note that no TX meter sample has been received this session).
- An explanation that TX forward power shown is the last value received, not a current reading, and that TX SWR is omitted rather than shown stale.
This prevents misdiagnosis where a plausible wattage next to a missing SWR could lead a reader to conclude the antenna is the problem.
Audio endpoint status¶
For each audio endpoint, the summary reports:
- Name, direction (INPUT/OUTPUT), kind, operational flag, running flag, state, error, backend, device name, sample rate, channel count, sample format, resampling flag, and buffer statistics (buffer bytes, buffer peak bytes, underrun count).
- When applicable, voice input normalization to 48 kHz, voice egress resampling to 24 kHz, and RADE resampling to 24 kHz flags.
- Any user-facing note.
Remote audio RX (radio-level)¶
The summary reports the radio-level remote audio RX stream state, including:
- Stream ID, whether the stream was expected, whether creation is pending, whether a status message has been seen, whether this client owns the stream, and the compression setting in use.
- A routing note that explains any detected routing problem for the remote audio RX stream.
Remote audio RX (per-slice radio stream route)¶
For each slice, the summary also reports the per-slice radio stream route for remote audio RX, including:
- Stream ID, expected flag, create-pending flag, remove-requested flag, status-seen flag, and owned-by-us flag.
Panadapter slice connection status¶
For each panadapter, the summary reports its connection status to slices, including:
- State (e.g. "connected", "partially_connected"), summary of connection status, list of connected slice IDs, list of active slice IDs, and whether the connection requires attention.
Client DSP NR2 settings¶
The summary includes the full NR2 noise reduction configuration read from the Nr2SettingsModel, including:
- Gain method and method name, NPE method and method name, AE filter enabled/disabled, gain max, gain floor, gain smooth, and Qspp.
Tips¶
- Use the
Find:field to search for specific terms within the active tab. The status label shows the match count, andFind Nextjumps to the next occurrence (wrapping within the current tab). - If you want only a plain-language problem summary rather than the full JSON, use
Copy Summaryon theIssue Summarytab instead. - To get the most accurate snapshot, make any slice configuration changes first, then click
Refresh Snapshot, thenCopy JSON. - The JSON snapshot can be pasted directly into an AI assistant for guided troubleshooting.