mirror of
https://github.com/f4exb/sdrangel.git
synced 2024-12-23 01:55:48 -05:00
SDRdaemonSink documentation
This commit is contained in:
f4exb
parent
b113d588fa
commit
3650ca00b1
BIN
doc/img/SDRdaemonSink_plugin.png
Normal file
BIN
doc/img/SDRdaemonSink_plugin.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 25 KiB |
BIN
doc/img/SDRdaemonSink_plugin_04.png
Normal file
BIN
doc/img/SDRdaemonSink_plugin_04.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 4.8 KiB |
BIN
doc/img/SDRdaemonSink_plugin_06.png
Normal file
BIN
doc/img/SDRdaemonSink_plugin_06.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 8.1 KiB |
BIN
doc/img/SDRdaemonSink_plugin_07.png
Normal file
BIN
doc/img/SDRdaemonSink_plugin_07.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 6.0 KiB |
@ -1,59 +1,126 @@
|
||||
<h1>File sink plugin</h1>
|
||||
<h1>SDRdaemon sink plugin</h1>
|
||||
|
||||
<h2>Introduction</h2>
|
||||
|
||||
This output sample sink plugin sends its samples to file in the SDRangel .sdriq format.
|
||||
This output sample sink plugin sends its samples over tbe network to a SDRdaemon transmitter server using UDP connection. SDRdaemon refers to the SDRdaemon utility `sdrdaemontx`found in [this](https://github.com/f4exb/sdrdaemon) Github repostory.
|
||||
|
||||
The format is S16LE I/Q samples. Thus there are 4 bytes per sample. I and Q values are 16 bit signed integers. The file starts with a context header containing information about center frequency, sample rate and timestamp of the start of the recording. This header has a length which is a multiple of a sample size (normally 24 bytes thus 6 samples). Thus this file can be used as a raw I/Q file with S16LE samples tolerating a glitch at the start corresponding to the 6 "random" samples. For example in GNURadio you can simply specify your file source format as short complex.
|
||||
|
||||
You can also zap the 24 bytes header with this Linux command: `tail -c +25 myfile.sdriq > myfile.raw`
|
||||
|
||||
To convert in another format you may use the sox utility. For example to convert to 32 bit (float) complex samples do: `sox -r 48k −b 16 −e signed-integer -c 2 myfile.raw -e float -c 2 myfilec.raw`
|
||||
|
||||
Note that you have to specify the sampling rate and use .raw for the file extensions.
|
||||
Forward Error Correction with a Cauchy MDS block erasure codec is used to prevent block loss. This can make the UDP transmission more robust particularly over WiFi links.
|
||||
|
||||
<h2>Build</h2>
|
||||
|
||||
The plugin is always built.
|
||||
The plugin will be built only if `libnanomsg` and the [CM256cc library](https://github.com/f4exb/cm256cc) is installed in your system. `libnanomasg` is present in most distributions and the dev version can be installed using the package manager. For CM256cc library you will have to specify the include and library paths on the cmake command line. Say if you install cm256cc in `/opt/install/cm256cc` you will have to add `-DCM256CC_INCLUDE_DIR=/opt/install/cm256cc/include/cm256cc -DCM256CC_LIBRARIES=/opt/install/cm256cc/lib/libcm256cc.so` to the cmake commands.
|
||||
|
||||
<h2>Interface</h2>
|
||||
|
||||
|
||||
|
||||
|
||||
<h3>1: Start/Stop</h3>
|
||||
|
||||
Device start / stop button.
|
||||
|
||||
- Blue triangle icon: device is ready and can be started
|
||||
- Red square icon: device is running and can be stopped
|
||||
- Magenta (or pink) square icon: an error occured
|
||||
- Green square icon: device is running and can be stopped
|
||||
|
||||
<h3>2: File stream sample rate</h3>
|
||||
<h3>2: Stream sample rate</h3>
|
||||
|
||||
This is the file stream sample rate in kS/s after interpolation (4) from the baseband stream. Thus this is the sample rate (7) multiplied by the interpolation factor (6).
|
||||
Stream I/Q sample rate in kS/s over the network.
|
||||
|
||||
<h3>3: Frequency</h3>
|
||||
|
||||
This is the center frequency in kHz that will be put in the file header.
|
||||
This is the center frequency in kHz sent to the remote device.
|
||||
|
||||
<h3>4: Output file selection</h3>
|
||||
<h3>4: Sample rate</h3>
|
||||
|
||||
Use this file dialog to specify the output file.
|
||||
|
||||
|
||||
<h3>5: File name</h3>
|
||||
<h4>4.1: Network stream sample rate</h4>
|
||||
|
||||
This is the file path of the output file.
|
||||
This is the I/Q stream sample rate transmitted via UDP over the network
|
||||
|
||||
<h3>6: Interpolation factor</h3>
|
||||
<h4>4.2: Remote interpolation factor</h4>
|
||||
|
||||
The baseband stream is interpolated by this value before being written to file. It can vary in powers of two from 1 (no interpolation) to 64.
|
||||
This is the interpolation set in the remote `sdrdaemontx` server instance.
|
||||
|
||||
<h3>7: Baseband sample rate</h3>
|
||||
<h3>5: Delay between UDP blocks transmission</h3>
|
||||
|
||||
This is the baseband sample rate before interpolation in S/s.
|
||||
This sets the minimum delay between transmission of an UDP block (send datagram) and the next. This allows throttling of the UDP transmission that is otherwise uncontrolled and causes network congestion.
|
||||
|
||||
Use the wheels to adjust the sample rate. 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 arroews. Pressing shift simultanoeusly moves digit by 5 and pressing control moves it by 2.
|
||||
The value is a percentage of the nominal time it takes to process a block of samples corresponding to one UDP block (512 bytes). This is calculated as follows:
|
||||
|
||||
<h3>8: Time counter</h3>
|
||||
- Sample rate on the network: _SR_
|
||||
- Delay percentage: _d_
|
||||
- Number of FEC blocks: _F_
|
||||
- There are 127 blocks of I/Q data per frame (1 meta block for 128 blocks) and each I/Q data block of 512 bytes (128 samples) has a 4 bytes header (1 sample) thus there are 127 samples remaining effectively. This gives the constant 127*127 = 16219 samples per frame in the formula
|
||||
|
||||
This is the recording time count in HH:MM:SS.SSS
|
||||
Formula: ((127 ✕ 127 ✕ _d_) / _SR_) / (128 + _F_)
|
||||
|
||||
<h3>6: Forward Error Correction setting and status</h3>
|
||||
|
||||
|
||||
|
||||
<h4>6.1: Desired number of FEC blocks per frame</h4>
|
||||
|
||||
This sets the number of FEC blocks per frame. A frame consists of 128 data blocks (1 meta data block followed by 127 I/Q data blocks) and a variable number of FEC blocks used to protect the UDP transmission with a Cauchy MDS block erasure correction. The two numbers next are the total number of blocks and the number of FEC blocks separated by a slash (/).
|
||||
|
||||
<h4>6.2: Distant transmitter queue length</h4>
|
||||
|
||||
This is the samples queue length reported from the distant transmitter. This is a numnber of vectors of 127 ✕ 127 ✕ _I_ samples where _I_ is the interpolation factor. This corresponds to a block of 127 ✕ 127 samples sent over the network. This numbers serves to thottle the sample generator so that the queue length is close to 8 vectors.
|
||||
|
||||
<h4>6.3: Stream status</h4>
|
||||
|
||||
The color of the icon indicates stream status:
|
||||
|
||||
- Green: all original blocks have been received for all frames during the last polling timeframe (ex: 134)
|
||||
- No color: some original blocks were reconstructed from FEC blocks for some frames during the last polling timeframe (ex: between 128 and 133)
|
||||
- Red: some original blocks were definitely lost for some frames during the last polling timeframe (ex: less than 128)
|
||||
|
||||
<h4>6.4: Frames recovery status</h4>
|
||||
|
||||
These are two numbers separated by a slash (/):
|
||||
|
||||
- first: minimum total number of blocks per frame during the last polling period. If all blocks were received for all frames then this number is the nominal number of original blocks plus FEC blocks (Green lock icon). In our example this is 128+6 = 134.
|
||||
- second: maximum number of FEC blocks used for original blocks recovery during the last polling timeframe. Ideally this should be 0 when no blocks are lost but the system is able to correct lost blocks up to the nominal number of FEC blocks (Neutral lock icon).
|
||||
|
||||
<h4>6.5: Reset events counters</h4>
|
||||
|
||||
This push button can be used to reset the events counters (6.6 and 6.7) and reset the event counts timer (6.8)
|
||||
|
||||
<h4>6.6: Unrecoverable error events counter</h4>
|
||||
|
||||
This counter counts the unrecoverable error conditions found (i.e. 6.4 lower than 128) since the last counters reset.
|
||||
|
||||
<h4>6.7: Recoverable error events counter</h4>
|
||||
|
||||
This counter counts the unrecoverable error conditions found (i.e. 6.4 between 128 and 128 plus the number of FEC blocks) since the last counters reset.
|
||||
|
||||
<h4>6.8: events counters timer</h4>
|
||||
|
||||
This hh:mm:ss time display shows the time since the reset evetnts counters button (4.6) was pushed.
|
||||
|
||||
<h3>7: Network parameters</h3>
|
||||
|
||||
|
||||
|
||||
<h4>7.1: Distant interface IP address</h4>
|
||||
|
||||
Address of the network interface on the distance (server) machine where the SDRdaemon Tx server runs and receives samples.
|
||||
|
||||
<h4>7.2: Distant data port</h4>
|
||||
|
||||
UDP port on the distant (server) machine where the SDRdaemon Tx server runs and receives samples.
|
||||
|
||||
<h4>7.3 Distant configuration port</h4>
|
||||
|
||||
TCP port on the distant machine hosting the SDRdaemon Tx instance to send control messages to and receive status messages from.
|
||||
|
||||
<h4>7.4: Validation button</h4>
|
||||
|
||||
When the return key is hit within the address (7.1), data port (7.2) or configuration port (7.3) boxes the changes are effective immediately. You can also use this button to set again these values.
|
||||
|
||||
<h4>8: Other parameters hardware specific</h4>
|
||||
|
||||
These are the parameters that are specific to the hardware attached to the distant SDRdaemon instance. You have to know which device is attached to send the proper parameters. Please refer to the SDRdaemon documentation or its line help to get information on these parameters.
|
||||
|
||||
<h4>9: Send data to the distant SDRdaemon Rx instance</h4>
|
||||
|
||||
When any of the parameters change they get immediately transmitted to the distant server over the TCP link. You can however use this button to send again the complete configuration. This is handy if for some reason you are unsure of the parameters set in the distant server.
|
||||
|
||||
@ -112,15 +112,15 @@ Maximum number of FEC blocks used for original blocks recovery during the last p
|
||||
|
||||
This push button can be used to reset the events counters (4.7 and 4.8) and reset the event counts timer (4.9)
|
||||
|
||||
<h4>4.6: Unrecoverable error events counter</h4>
|
||||
<h4>4.7: Unrecoverable error events counter</h4>
|
||||
|
||||
This counter counts the unrecoverable error conditions found (i.e. 4.4 lower than 128) since the last counters reset.
|
||||
|
||||
<h4>4.6: Recoverable error events counter</h4>
|
||||
<h4>4.8: Recoverable error events counter</h4>
|
||||
|
||||
This counter counts the unrecoverable error conditions found (i.e. 4.4 between 128 and 128 plus the number of FEC blocks) since the last counters reset.
|
||||
|
||||
<h4>4.6: events counters timer</h4>
|
||||
<h4>4.9: events counters timer</h4>
|
||||
|
||||
This hh:mm:ss time display shows the time since the reset evetnts counters button (4.6) was pushed.
|
||||
|
||||
@ -161,7 +161,7 @@ The value is a percentage of the nominal time it takes to process a block of sam
|
||||
- Number of FEC blocks: _F_
|
||||
- There are 127 blocks of I/Q data per frame (1 meta block for 128 blocks) and each I/Q data block of 512 bytes (128 samples) has a 4 bytes header (1 sample) thus there are 127 samples remaining effectively. This gives the constant 127*127 = 16219 samples per frame in the formula
|
||||
|
||||
Formula: ((127 * 127) * _d_ / _SR_) / (128 + _F_)
|
||||
Formula: ((127 ✕ 127 ✕ _d_) / _SR_) / (128 + _F_)
|
||||
|
||||
<h3>8: Desired distant device sample rate</h3>
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user