Skip to content

Network Diagnostics Dialog

Use this page to monitor the live network link between AetherSDR and your FLEX-8600, confirm connection addresses, inspect per-stream data rates, and review filtered log output.

Before you start

  • AetherSDR must be running. The dialog does not require an active radio connection, but most fields and graphs will show meaningful values only after a connection attempt has been made.

Opening the dialog

  1. Click Settings > Network....
  2. The Network Diagnostics dialog opens. It defaults to a navigation tree on the left with a content panel on the right. The default view is Overview.

Layout overview

The dialog uses a two-panel layout with a navigation tree on the left and a content panel on the right. Click any item in the navigation tree to display the corresponding page.

The navigation tree contains the following sections and pages:

  • Radio Connection
  • Overview
  • Connection Details
  • Network Graphs
  • Latency
  • Rates
  • Packet Loss
  • Audio
  • Logging
  • Logs
  • TCI Clients (build-gated, shown only when TCI support is compiled in)

Search for a page

  1. Locate the search field at the top of the navigation tree, labeled with a magnifying glass icon.
  2. Type any part of a page name (for example, "delay" or "rates"). The navigation tree filters to show only matching items.
  3. Click a filtered item to open that page.
  4. Clear the search field to restore the full navigation tree.

Page overview

Page What it shows
Overview Four health cards (Status, Latency, Packet Loss, Audio Buffer) and four time-series graphs (Latency and Jitter, Recent Packet Loss, Total Stream Rates, Audio Buffer).
Connection Details Scrollable grid with labeled values for Network Status, Incoming Stream Rates, Packet Loss, and Audio Playback groups, plus the Adaptive Frame-Rate Throttle subsection. Renamed from "Details" in the v26.8.4 tree-navigation rework. Includes a Read-Only Clipboard Copy action to copy the whole diagnostic summary.
Latency Full-width time-series graph of RTT, arrival gap, and jitter in ms.
Rates Full-width log-scale time-series graph of per-stream incoming bitrates (RX total, Audio, FFT, Waterfall, Meters, DAX) in kbps.
Packet Loss Full-width time-series graph of packet loss % per stream category.
Audio Full-width time-series graph of playback buffer fill (ms) and underruns/s. Includes per-stream RX audio diagnostics showing feed rate, deficit, late packets, packet class code, and stream health for each active audio stream.
Logs Live tail of the AetherSDR log file, filtered by category checkboxes. Syntax-highlighted by log level and category name. Timeframe selector is hidden while this page is active.
TCI Clients Lists connected TCI clients with a live traffic monitor (Pause/Save log/Clear), answer-command suppression controls, and per-client details. New in v26.8.4. Build-gated by HAVE_TCI / TCI support. Timeframe selector is hidden on this page.

Verify the radio's IP and local bind address

  1. Open the Network Diagnostics dialog as described above.
  2. In the navigation tree, click Connection Details.
  3. Locate the Network Status group.
  4. Read Target Radio IP β€” this shows the IP address of the radio AetherSDR connected to. If no connection has been made, the field displays Not connected.
  5. Read Selected Source β€” this shows the local network interface or bind path AetherSDR used to reach the radio.
  6. Read Local TCP and Local UDP to see the exact local endpoints for each protocol.
  7. Click Close when done.

Review the Adaptive Frame-Rate Throttle

The Connection Details page includes an Adaptive Frame-Rate Throttle section that shows:

  • Current State β€” Whether throttling is currently active.
  • Pending Lift β€” Whether a lift of throttling is pending.
  • Sessions This Run β€” Number of throttle sessions since connect.

This throttle reduces panadapter frame rates when latency or packet loss is detected on the link. The section is hidden until throttle data becomes available.

Control the chart timeframe

The Timeframe combo box in the top-right corner sets how far back all time-series charts display history. It is hidden while the Logs or TCI Clients page is active.

Value Behavior Notes
1 minute
5 minutes (default)
15 minutes
1 hour
1 day
1 week

Select a value from the Timeframe drop-down. All visible charts update immediately.

Use the Logs page

  1. In the navigation tree, click Logs.
  2. The Log path label at the top of the page shows the full path of the log file being tailed.
  3. Use the Filter Categories (Logs) checkboxes to show or hide individual log categories. The list includes a General category (shown by default) plus every category registered with LogManager.
  4. Click Select All (Logs) to enable all categories at once.
  5. Click Deselect All (Logs) to hide all categories at once.
  6. The Live / Paused toggle button controls auto-scrolling:
  7. Live β€” the viewer auto-scrolls to the newest output as log lines arrive.
  8. Paused β€” scrolling is stopped so you can read earlier lines. Scroll up at any time to auto-pause.
  9. Click Live to resume and jump back to the tail.
  10. Log lines are syntax-highlighted by log level (DBG, INF, WRN, CRT, FTL) and by category name.

Note: The Timeframe selector is hidden while the Logs page is active. Navigate to any other page to restore it.

Use the TCI Clients page (build-gated)

Note: This page appears only in builds compiled with TCI support (HAVE_TCI).

  1. In the navigation tree, click TCI Clients.
  2. The page lists all connected TCI clients.
  3. For each client, review per-client details such as connection state and traffic activity.
  4. Use the traffic monitor controls:
  5. Pause β€” freeze the live traffic display.
  6. Save log β€” export the captured traffic log to a file.
  7. Clear β€” reset the traffic monitor.
  8. Use the answer-command suppression controls to prevent AetherSDR from responding to specific TCI commands, if needed.

Note: The Timeframe selector is hidden while this page is active.

Inspect per-stream RX audio diagnostics

  1. In the navigation tree, click Audio.
  2. The main graph shows playback buffer fill (ms) and underruns/s over time.
  3. Below the graph, a detail area displays per-stream RX audio diagnostics for each active audio stream:
  4. Feed rate β€” The rate at which audio data is being fed to the playback buffer.
  5. Deficit β€” The current buffer deficit in ms.
  6. Late packets β€” Count of packets arriving after their scheduled playback time.
  7. Packet class code β€” Classification of the packet quality.
  8. Stream health β€” Overall health indicator for the audio stream.
  9. Use this information to identify which audio stream is experiencing issues and what type of problem is occurring.

What each indicator means

Indicator Meaning
Status Overall link quality, color-coded from green (Excellent) to red (Poor). States: Excellent, Very Good, Good, Fair, Poor.
Target Radio IP IP address of the connected radio. Displays Not connected if no connection is active.
Selected Source Local NIC or bind path used to reach the radio.
Local TCP Local TCP endpoint (address and port).
Local UDP Local UDP endpoint (address and port).
First UDP Packet Whether the first UDP packet has been received since connect (Yes / No).
Latency (RTT) Current round-trip time. Displays "not measured on this link" if the transport has no round trip to time.
Max Latency (RTT) Highest RTT seen since connect. Displays "not measured on this link" if the transport has no round trip to time.
Audio / FFT / Waterfall / Meters / DAX rates Per-category ingress rate in kbps. Displays "n/a" on transports that do not expose per-stream category statistics.
Total RX / Total TX Aggregate bytes per second in each direction.
Audio / FFT / Waterfall / Meters / DAX drops Per-category dropped-packet counts and percentage. Displays "n/a" on transports that do not expose per-stream category statistics.
RX Buffer Now / Peak Current and peak audio buffer fill in bytes and ms.
Underruns (total / last sec) Audio underrun counters.
Audio Arrival Gap / Max Arrival Gap Inter-packet arrival timing. Displays "not measured on this link" before the first timing window closes or if the transport reports no timing.
Network Jitter Smoothed jitter estimate of the audio stream in ms. Displays "not measured on this link" before the first timing window closes or if the transport reports no timing.
Log path label Full path of the log file being tailed (visible on the Logs page).

Controls reference

Control Type Default Behavior
Timeframe Combo box 5 minutes Selects how far back the time-series charts display history. Hidden when the Logs or TCI Clients page is active.
Filter Categories (Logs) Checkboxes β€” Per-category checkboxes filter the log view. Includes a General category plus all registered LogManager categories.
Select All (Logs) Button β€” Shows all log categories in the viewer.
Deselect All (Logs) Button β€” Hides all log categories from the viewer.
Live / Paused (Logs) Toggle button Live When Live, the viewer auto-scrolls to newest output. Scrolling up auto-pauses; clicking Live resumes and jumps to the tail.
Close Button β€” Closes the dialog.

Tips

  • The dialog refreshes all values once per second. If you have just connected, wait a moment for the fields to populate.
  • Selected Source is useful when the host has multiple network interfaces. Confirm it shows the interface on the same subnet as the radio, not a VPN or secondary adapter.
  • The Rates page uses a logarithmic y-axis, which makes it easier to compare high-bandwidth streams (such as total RX at several Mbps) alongside low-bandwidth streams (such as Meters at a few kbps) on the same chart.
  • On the Logs page, scrolling up automatically switches the toggle to Paused. Click Live to jump back to the current tail.
  • The Audio page's per-stream diagnostics help you identify whether audio problems are caused by network issues (late packets, high deficit) or local playback issues (underruns, buffer mismanagement).
  • Use the search field at the top of the navigation tree to quickly find any page by name.
  • On transports with no round trip to time, the Latency (RTT) and Max Latency (RTT) indicators display "not measured on this link" rather than a misleading "< 1 ms" value. Where per-stream category statistics are not available, rate and drop fields display "n/a" rather than zeroed rows.

Troubleshooting

  • Target Radio IP shows Not connected β€” No connection to the radio is active. Use Settings > Connect to Radio... to discover and connect to your FLEX-8600, then reopen the dialog.
  • Selected Source shows an unexpected interface β€” Your operating system routed the connection through a different NIC than intended. Check your routing table or disable unused network interfaces, then reconnect.
  • Status card shows Poor or Fair β€” Check the Latency and Packet Loss pages for the affected time range. High jitter or sustained packet loss on the Audio stream usually points to network congestion or Wi-Fi interference.
  • Logs page shows no output β€” All category checkboxes may be deselected. Click Select All (Logs) to restore visibility.
  • Audio stream shows high late packet count β€” Check the Latency page for jitter spikes and the Packet Loss page for Audio stream drops. Consider increasing the audio buffer size in audio
⚑ Athena AetherSDR Assistant
Hi! I'm Athena, the AetherSDR AI assistant. Ask me anything about installation, configuration, or troubleshooting.