Troubleshooting - Revision history

Kerel+satnogs: Update log level table: add description column and reduce rows to sensible defaults

2025-11-20T02:21:48Z

Update log level table: add description column and reduce rows to sensible defaults

Fredy: /* Client troubleshooting */

2025-03-21T09:58:16Z

‎Client troubleshooting

Acinonyx: /* RuntimeError: RTL-SDR device not found. */

2025-03-21T09:39:43Z

‎RuntimeError: RTL-SDR device not found.

Acinonyx: /* Not receiving anything? */

2025-03-21T09:12:34Z

‎Not receiving anything?

Acinonyx at 09:11, 21 March 2025

2025-03-21T09:11:11Z

Acinonyx: /* Blank or solid purple waterfall? */

2025-03-21T09:09:10Z

‎Blank or solid purple waterfall?

Acinonyx: /* Not receiving anything? */

2025-03-21T08:59:40Z

‎Not receiving anything?

Acinonyx at 08:58, 21 March 2025

2025-03-21T08:58:54Z

Acinonyx: /* Blank or solid purple waterfall? */

2025-03-21T08:57:50Z

‎Blank or solid purple waterfall?

Acinonyx: /* Client troubleshooting */

2025-03-21T08:50:45Z

‎Client troubleshooting

@@ Line 16: / Line 16: @@
 {| class="wikitable"
-!'''Setting'''
+!Level
-!Values
+!Description
 |-
-|'''DEBUG'''
+|WARNING
+|'''Default.''' Show only indications that something unexpected happened, or that a problem might occur in the near future (e.g. ‘disk space low’).
 |-
-|<code>ERROR</code>
+|INFO
 |-
-|<code>WARNING</code>
+|DEBUG
-|-
+| Show very detailed information, typically only of interest to a developer trying to diagnose a problem.
 |}

@@ Line 2: / Line 2: @@
 ==Client troubleshooting==
-{{Message|
+If the hints for common issues below don't help solve your issue, you are welcome to post in the [https://community.libre.space/c/satnogs/6 SatNOGS section] of the [https://community.libre.space/ Community forum]. When doing so, please include any error from the logs and the output of the support report to give the necessary context:
-* Check the whole error log with <code>sudo docker logs satnogs_satnogs-client</code>
+{{Message|
-* Check live the error log with <code>sudo docker logs -f satnogs_satnogs-client</code>}}
+Check the whole error log with <code>sudo docker logs satnogs_satnogs-client</code>
-{{Message|If the hints for common issues below don't help solve your issue, you are welcome to post in the forum.  When doing so, please include any error from the logs and the output of the support report generated by the menu item <code>Advanced -> Support</code> from <code>sudo satnogs-setup</code>. This helps give context to the logging messages.}}
+{{Message|Generate support report by the menu item <code>Advanced -> Support</code> in <code>sudo satnogs-setup</code>}}
 ===Raise or Set the debug level===

@@ Line 45: / Line 45: @@
 ===RuntimeError: RTL-SDR device not found.===
-Seems that the device is not there. Try rebooting and check if Soapy can identify it using <code>sudo docker exec -ti satnogs_satnogs-client SoapySDRUtil --find="driver=rtlsdr"</code>.
+Seems that the device is not there. Try rebooting and check if Soapy can identify it using:
 ==="satnogsclient - ERROR - Cannot connect to socket 127.0.0.1:4533"===
@@ Line 55: / Line 57: @@
 *If you do have a rotator, ensure that rotctld is running.
 ===Some uploads missing & Doppler-correction not working properly===
@@ Line 135: / Line 135: @@
 You can reset USB without having to reboot the system by running these commands:
-    echo “usb1” > /sys/bus/usb/drivers/usb/unbind
+<pre>
-    echo “usb1” > /sys/bus/usb/drivers/usb/bind
+$ usbreset
-This can be placed in the satnogs_post_observation_script for automation.
+Devices:
 ===RF Noise===

@@ Line 117: / Line 117: @@
 <pre>
-$ sudo timeout -s INT 20s docker exec -ti satnogs_satnogs-client satnogs_afsk1200_ax25.py --soapy-rx-device="driver=rtlsdr" --antenna=RX --samp-rate-rx=2.048e6 --rx-freq=444000000 --rigctl-host=rigctld --file-path=/tmp/audio-out.ogg --waterfall-file-path=/tmp/waterfall.dat
+$ sudo docker exec -ti satnogs_satnogs-client timeout -s INT 20s satnogs_afsk1200_ax25.py --soapy-rx-device="driver=rtlsdr" --antenna=RX --samp-rate-rx=2.048e6 --rx-freq=444000000 --rigctl-host=rigctld --file-path=/tmp/audio-out.ogg --waterfall-file-path=/tmp/waterfall.dat
 $ sudo docker exec -ti satnogs_satnogs-client ls -lah /tmp/audio-out.ogg /tmp/waterfall.dat
 $ sudo docker exec -ti satnogs_satnogs-client rm /tmp/audio-out.ogg /tmp/waterfall.dat

@@ Line 117: / Line 117: @@
 <pre>
-$ sudo timeout 20s  docker exec -ti satnogs_satnogs-client satnogs_afsk1200_ax25.py --soapy-rx-device="driver=rtlsdr" --antenna=RX --samp-rate-rx=2.048e6 --rx-freq=444000000 --rigctl-host=rigctld --file-path=/tmp/audio-out.ogg --waterfall-file-path=/tmp/waterfall.dat
+$ sudo timeout -s INT 20s docker exec -ti satnogs_satnogs-client satnogs_afsk1200_ax25.py --soapy-rx-device="driver=rtlsdr" --antenna=RX --samp-rate-rx=2.048e6 --rx-freq=444000000 --rigctl-host=rigctld --file-path=/tmp/audio-out.ogg --waterfall-file-path=/tmp/waterfall.dat
 $ sudo docker exec -ti satnogs_satnogs-client ls -lah /tmp/audio-out.ogg /tmp/waterfall.dat
 $ sudo docker exec -ti satnogs_satnogs-client rm /tmp/audio-out.ogg /tmp/waterfall.dat

@@ Line 117: / Line 117: @@
 <pre>
-$ cd /tmp
+$ sudo timeout 20s  docker exec -ti satnogs_satnogs-client satnogs_afsk1200_ax25.py --soapy-rx-device="driver=rtlsdr" --antenna=RX --samp-rate-rx=2.048e6 --rx-freq=444000000 --rigctl-host=rigctld --file-path=/tmp/audio-out.ogg --waterfall-file-path=/tmp/waterfall.dat
-$ satnogs_afsk1200_ax25.py --soapy-rx-device="driver=rtlsdr" --antenna=RX --samp-rate-rx=2.048e6 --rx-freq=444000000 --file-path=./audio-out.ogg --waterfall-file-path=./waterfall.dat
+$ sudo docker exec -ti satnogs_satnogs-client ls -lah /tmp/audio-out.ogg /tmp/waterfall.dat
 </pre>
-Let it run for a minute or so.  If everything is working, this should create an .ogg file and a .dat file of non-zero size (probably a few MB each).
+If everything is working, this should create an .ogg file and a .dat file of non-zero size (probably a few MB each).
 ===Observations seem off-frequency?===

@@ Line 94: / Line 94: @@
 <pre>
-pi@raspberrypi:~ $ rtl_test
+pi@raspberrypi:~ $ sudo docker exec -ti satnogs_satnogs-client rtl_test
 Found 1 device(s):
 :  Realtek, RTL2838UHIDIR, SN: 00000001

@@ Line 81: / Line 81: @@
 At the first sign of trouble, put your station into testing mode.
-*Make sure the RTLSDR gain is set correctly. Follow the guide at [[Omnidirectional_Station_How_To#Setting_the_gain]] to find a proper gain setting.<br />Check your gain value is valid. Wrong values can result in blank waterfalls. For example '7.7.' will result in errors (and a blank waterfall - there is an extra '.' at the end).   <br /><code>sudo docker logs satnogs_satnogs-client</code> It might be a big file, but work through it and look for errors.  <br /><code>df -h</code> Ensure there is sufficient hard drive space. If temp files can not be created, the waterfall might be blank. <br />Run <code>rtl_test</code> for about 30 seconds and make sure you can connect with the dongle and that there are no errors.
+*Make sure the RTLSDR gain is set correctly. Follow the guide at [[Omnidirectional_Station_How_To#Setting_the_gain]] to find a proper gain setting.<br />Check your gain value is valid. Wrong values can result in blank waterfalls. For example '7.7.' will result in errors (and a blank waterfall - there is an extra '.' at the end).   <br /><code>sudo docker logs satnogs_satnogs-client</code> It might be a big file, but work through it and look for errors.  <br /><code>df -h</code> Ensure there is sufficient hard drive space. If temp files can not be created, the waterfall might be blank. <br />Run <code>sudo docker exec -ti satnogs_satnogs-client rtl_test</code> for about 30 seconds and make sure you can connect with the dongle and that there are no errors.
 ===Not receiving anything?===