sdrangel/plugins/channelrx/demodradiosonde
Jiří Pinkava 0df2d75e6d Replace deprecated QMutex(Recursive) with QRecursiveMutex 2022-09-17 23:00:07 +02:00
..
CMakeLists.txt Add RS41 Radiosonde (Weather Ballon) demodulator and feature 2022-03-01 17:17:56 +00:00
radiosondedemod.cpp v7: API: added workspace handling for device, spectrum, feature and channel. Implements #1242 2022-05-13 22:24:48 +02:00
radiosondedemod.h v7: API: added workspace handling for device, spectrum, feature and channel. Implements #1242 2022-05-13 22:24:48 +02:00
radiosondedemodbaseband.cpp Replace deprecated QMutex(Recursive) with QRecursiveMutex 2022-09-17 23:00:07 +02:00
radiosondedemodbaseband.h Replace deprecated QMutex(Recursive) with QRecursiveMutex 2022-09-17 23:00:07 +02:00
radiosondedemodgui.cpp Massive UI revamping (v7): Restored channel highlighted by cursor function. Part of #1213 2022-04-26 00:42:26 +02:00
radiosondedemodgui.h Massive UI revamping (v7): updated basic channel settings and indicate stream index for MIMO device and single stream channel 2022-04-18 01:42:03 +02:00
radiosondedemodgui.ui Massive UI revamping (v7): added channels 2022-04-12 16:20:45 +02:00
radiosondedemodplugin.cpp Updated main and plugin versions 2022-05-14 13:16:33 +02:00
radiosondedemodplugin.h Add RS41 Radiosonde (Weather Ballon) demodulator and feature 2022-03-01 17:17:56 +00:00
radiosondedemodsettings.cpp Massive UI revamping (v7): persistent channel show/hide 2022-04-12 18:27:27 +02:00
radiosondedemodsettings.h Massive UI revamping (v7): persistent channel show/hide 2022-04-12 18:27:27 +02:00
radiosondedemodsink.cpp Some clang warnong fixes 2022-07-24 21:48:02 +02:00
radiosondedemodsink.h Fix linux errors 2022-03-01 17:48:36 +00:00
radiosondedemodwebapiadapter.cpp Add RS41 Radiosonde (Weather Ballon) demodulator and feature 2022-03-01 17:17:56 +00:00
radiosondedemodwebapiadapter.h Add RS41 Radiosonde (Weather Ballon) demodulator and feature 2022-03-01 17:17:56 +00:00
readme.md Massive UI revamping (v7): Channel window documentation. Show device type name in index tooltip 2022-04-17 10:20:07 +02:00

readme.md

Radiosonde demodulator plugin

Introduction

This plugin can be used to demodulate RS41 radiosonde weather balloon signals. Radiosondes typically transmit on 400-406MHz and are in the sky around the world for around 1 hour around 00:00 UTC.

RS41 radiosondes transmit data frames every second, containing position, velocity and PTU (Pressure, Temperature and Humidity) readings. The radios use GFSK modulation, with <20>2.4kHz deviation at 4,800 baud. Reed Solomon encoding is used for ECC (Error Checking and Correction).

The Radiosonde demodulator can forward received data to the Radiosone feature, which can plot charts showing how altitude and PTU vary over time, and also plot the position of the radiosonde on the 2D and 3D maps.

Interface

The top and bottom bars of the channel window are described here

Radiosonde Demodulator plugin GUI

1: Frequency shift from center frequency of reception

Use the wheels to adjust the frequency shift in Hz from the center frequency of reception. Left click on a digit sets the cursor position at this digit. Right click on a digit sets all digits on the right to zero. This effectively floors value at the digit position. Wheels are moved with the mousewheel while pointing at the wheel or by selecting the wheel with the left mouse click and using the keyboard arrows. Pressing shift simultaneously moves digit by 5 and pressing control moves it by 2.

2: Channel power

Average total power in dB relative to a +/- 1.0 amplitude signal received in the pass band.

3: Level meter in dB

  • top bar (green): average value
  • bottom bar (blue green): instantaneous peak value
  • tip vertical bar (bright green): peak hold value

4: BW - RF Bandwidth

This specifies the bandwidth of a LPF that is applied to the input signal to limit the RF bandwidth. For RS41 radiosondes, this can be 9.6kHz.

5: Dev - Frequency deviation

Adjusts the expected frequency deviation in 0.1 kHz steps from 1 to 5 kHz. Typical value to RS41 is 2.4kHz.

6: TH - Correlation Threshold

The correlation threshold between the received signal and the preamble (training sequence). A lower value may be able to demodulate weaker signals, but increases processor usage. The default value is 450.

7: UDP

When checked, received receives are forwarded to the specified UDP address (12) and port (13).

8: UDP address

IP address of the host to forward received frames to via UDP.

9: UDP port

UDP port number to forward received frames to.

10: Find

Entering a regular expression in the Find field displays only frames where the radiosonde serial number matches the given regular expression.

11: Start/stop Logging Frames to .csv File

When checked, writes all received frames to a .csv file.

14: .csv Log Filename

Click to specify the name of the .csv file which received frames are logged to.

15: Read Data from .csv File

Click to specify a previously written radiosonde .csv log file, which is read and used to update the table.

11: Clear Data from table

Pressing this button clears all data from the table.

Received Data Table

The received frames table displays information about each radiosonde frame received.

Radiosonde Demodulator plugin table

  • Date - The date the frame was received.
  • Time - The time the frame was received.
  • Serial - The serial number of the radiosonde. Double clicking on this column will search for the radiosone on https://sondehub.org/
  • Frame - Frame number
  • Phase - Flight phase: On ground, Ascent and Descent.
  • Lat (<28>) - Latitude in degrees, North positive. Double clicking on this column will search for the radiosonde on the Map.
  • Lon (<28>) - Longitude in degrees, East positive. Double clicking on this column will search for the radiosonde on the Map.
  • Alt (m) - Altitude in metres.
  • Spd (km/h) - Speed over ground in kilometres per hour.
  • VR (m/s) - Vertical climb rate in metres per second.
  • Hdg (<28>) - Heading in degrees.
  • P (hPA) - Air pressure in hectopascals. Not all RS41s include a pressure sensor. A value ending with 'U' indicates a uncalibrated estimate and may be inaccurate.
  • T (<28>C) - Air temperature in degrees Celsius. A value ending with 'U' indicates a uncalibrated estimate and may be inaccurate.
  • U (%) - Relative humidity in percent. A value ending with 'U' indicates a uncalibrated estimate and may be inaccurate.
  • Bat (V) - Battery voltage in Volts.
  • Bat - Battery status: OK or low.
  • PCB (<28>C) - Temperature of PCB.
  • PWM (%) - Humidity sensor heater PWM (Pulse Width Modulation) setting, in percent.
  • TX (%) - Transmit power in percent.
  • Max SF - Maximum subframe number.
  • SF No. - Subframe number of subframe data in this frame.
  • Subframe - Subframe data.
  • GPS Time - GPS date and time on board radiosonde. GPS time is offset 18 seconds from UTC.
  • GPS Sats - Number of GPS satellites used in position estimate.
  • ECC - Number of symbol errors corrected by Reed Solomon ECC.
  • Corr - Premable correlation value calculated for the frame. This can be used to choose a value for TH (6).

Right clicking on the table header allows you to select which columns to show. The columns can be reorderd by left clicking and dragging the column header. Right clicking on an item in the table allows you to copy the value to the clipboard.