Refresh the snapshot after changing slice state¶
After you change slice settings — such as adjusting audio routing, toggling mute, or switching antennas — the Slice Troubleshooting dialog does not update automatically. Use Refresh Snapshot to re-read the current slice state so the Issue Summary and JSON reflect your changes.
Before you start¶
- AetherSDR must be connected to the radio. The Slice Troubleshooting dialog requires an active radio connection.
- Open the dialog via
Help > Slice Troubleshooting...if it is not already open.
Steps¶
- Make the slice state change you want to capture (for example, unmute a slice, reassign an antenna, or adjust a DAX channel).
- In the Slice Troubleshooting dialog, click Refresh Snapshot.
- The dialog re-reads all slice, panadapter, transverter, DAX channel, audio device, client DSP, control-device (MIDI) binding, audio endpoint, renderer, remote audio RX, and panadapter slice connection state.
- Review the updated results on the Issue Summary tab or the JSON tab.
What each control does¶
| Control | Kind | Behavior |
|---|---|---|
| Refresh Snapshot | Button | Re-reads slice state into the snapshot. Use this after any slice configuration change. |
| Issue Summary (tab) | Tab | Shows a plain-language bullet list of detected problems based on the current snapshot, including audio routing, DSP, control-device (MIDI) state, multi-client ownership, remote audio RX routing, audio endpoint state, renderer state, and panadapter slice connection status. |
| JSON (tab) | Tab | Shows the full JSON snapshot (schema version 3) of slices, DAX channels, audio devices, client DSP, control devices, audio endpoints, renderers, TX band settings, remote audio RX state, and panadapter slice connection status. |
| Copy Summary | Button | Copies the issue summary to the clipboard. |
| Copy JSON | Button | Copies the full JSON to the clipboard. |
| Export JSON... | Button | Saves the JSON to a file. |
| Close | Button | Closes the dialog. |
What the Issue Summary reports¶
The Issue Summary tab includes the following categories of information. Each item appears as a plain-language bullet in the summary.
Radio-level audio and hardware state¶
- Headphone gain, headphone mute, and front speaker mute status.
- Oscillator setting, lock state, external reference, and TCXO status.
Remote audio RX state¶
The summary includes two bullets for remote audio RX:
- Remote audio RX: Reports the stream ID, whether a stream is expected, whether creation is pending, whether a status message has been seen, whether this client owns the stream, and the compression setting in use.
- Remote audio route note: A plain-language note about the remote audio RX routing state, if one is available.
Per-slice audio routing¶
For each slice, the summary reports:
- Engine RX volume, mute state, and whether RX audio is streaming.
- Radio stream route: Reports the remote audio RX stream ID, whether the stream is expected, whether creation or removal is pending, whether a status message has been seen, and whether this client owns the stream.
- TX input route, microphone selection, DAX TX mode, and related settings.
Audio endpoint state¶
For each audio endpoint, the summary reports:
- Name, direction (INPUT or OUTPUT), and kind (endpoint type).
- Backend, device name, sample rate, channel count, sample format, and whether resampling is active.
- Operational and running status, stream state, and error information.
- Buffer statistics (buffer bytes, peak bytes, and underrun count) if available.
- Any additional notes about the endpoint.
Renderer state¶
For each renderer in the audio engine, the summary reports the renderer name, a backend identifier, the sample rate, and whether audio is currently active.
Panadapter slice connection status¶
For each panadapter, the summary reports:
- The slice connection state, a human-readable summary of the link status, the list of connected slice IDs, the list of active slice IDs, and whether the connection requires attention.
Control device (MIDI) bindings¶
The summary reports each control device and the MIDI bindings associated with it, including the scope, mapping details, and error conditions.
Status indicator¶
After you click Copy Summary, Copy JSON, or Export JSON..., a status label below the buttons shows the result of the operation (for example, Copied to clipboard).
Tips¶
- After clicking Refresh Snapshot, check both the Issue Summary tab and the JSON tab to confirm the change you made is reflected before sharing the snapshot with support.
- If you plan to export or copy the snapshot for a bug report, always click Refresh Snapshot first to ensure the data is current.
- The remote audio RX routing note in the Issue Summary is a useful first indicator of stream ownership or creation problems when troubleshooting audio that is not reaching the client.
- The panadapter slice connection status and audio endpoint details can help identify connectivity or stream state issues that may not appear elsewhere.