1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-12-13 04:56:24 -05:00
sdrangel/plugins/samplesource/sigmffileinput/readme.md

7.4 KiB

SigMF file input plugin

Introduction

This plugin reads a file of samples in SigMF format. SDRangel SigMF file sink plugin can save I/Q data in SigMF format. When files are recorded with SDRangel the SDRangel specific SigMF standard extensions are available among which variable sample rate.

This plugin supports single stream files having one .sigmf-meta file and only one .sigmf-data file. Thus it does not implement the multirecordings extension.

It adds a dependency to the libsigmf library more specifically the f4exb fork that supports multirecordings and sdrangel extensions.

Note: this plugin is officially supported since version 6.

Interface

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

SigMF File input plugin GUI

1: Start/Stop

Device start / stop button.

  • Blue triangle icon: ready to be started
  • Green square icon: currently running and can be stopped
  • Magenta (or pink) square icon: an error occurred. The file may not be found or there can be a CRC (SHA512) error or the file size is inconsistent (TOT label appears in red). You may stop and choose another file.

2: Frequency

This is the center frequency of reception in Hz of the track (or capture) being played currently. The 3 lower digits appear smaller above the "Hz" unit label.

3: Track sample rate

This is the sample rate in S/s of the track being played currently. It is possibly suffixed by a thousands mutiplier ('k' for kHz, 'M' for MHz). Recording SigMF files in SDRangel offers the possibility to change sample rate within the same record creating a new track.

4: Open file

Opens a file dialog to select the input file. It expects a default extension of .sigmf-meta which points to the meta data file. It expects a file with the sigmf-data extension and the same base name for the data file. This button is disabled when the stream is running. You need to pause (button 11) to make it active and thus be able to select another file.

5: File path

Absolute path of the meta file being read.

A: Global meta data

SigMF File input plugin A GUI

This section shows the meta data pertaining to the whole record. It is detailed as follows.

1: Recording detailed information

Opens a pop-up display with the complete global information contained in the meta file.

2: Recoding summary information

If the recoding was made with SDRangel it will show information about the instance that created the file.

  • GUI (SDRangel) or server (SDRangelSrv) instance
  • Number of sample bits (16 or 24)
  • Version

It the recording was not made with SDRangel it will just display Not recorded with SDRangel

3: Sample rate

This is the sample rate of the track currently being played or the global sample rate if the recording was not made by SDRangel.

4: Sample format

This is the sample format of the recording

  • Complex (c) or real (r). Note that real samples are completed with an imaginary part of zero resulting in aliasing (no Hilbert transform).
  • Sample type:
    • i: signed integer
    • u: unsigned integer
    • f: floating point (4 bytes or single precision)
  • Sample size in bits followed by b. This is the actual range of samples in bits. When record is made with 24 bit samples version of SDRangel it shows 24 although the sample size in the file is actually 32 bits.

5: CRC indicator

Indicates if the CRC check (SHA512) has succeeded (green) or failed (red) or is not available in meta data (grey).

6: Total number of samples check

Compares the size of the data file with the size data stored in the meta file. If they match the label shows in green else it shows in red. You can still read a file with a failing total samples check however it may be inconsistent and stop before the predicted end or not play all samples.

7: Current timestamp

This is the timestamp of the current pointer in the file based on the track start time, number of samples read from the start of the track and the track sample rate.

B: Tracks (or captures) data

SigMF File input plugin B GUI

This section shows tracks information and is detailed as follows

1: Current track

The track being played currently is highlighted. When the playing is paused you can click on the track you want to move to.

2: Track number

Track sequence number starting at 1.

3: Track start date and time

Shows the date and time of the start of the track in ISO format.

4: Track center frequency

Shows the center frequency of the track in Hz. It is possibly suffixed with a thousands multiplier (k for kHz, M for MHz, G for GHz).

5: Track sample rate

If the file was recorded by SDRangel the sample rate can vary between tracks else it is global for the whole record and will show this value for all tracks. Sample rate is in S/s possibly suffixed with a thousands multiplier (k for kHz, M for MHz).

6: Track duration time

This is the track duration in HH:MM:ss format

6: Current track pointer gauge

This represents the position of the current pointer position in the track being played. It can be used in paused mode to position the current pointer by moving the slider.

7: Track loop

Use this button to read current track in a loop or read it only once

8: Track play/pause

This is the play/pause button for the current track. In pause mode you may switch to full record play by clicking on the record play/pause button (14).

9: Track number

This is the track number of the track currently being played.

10: Relative track time

This is the time in HH:MM:ss.zzz format of the current pointer since the beginning of the track.

11: Track duration

This is the current track duration in HH:MM:ss format.

12: Current record pointer gauge

This represents the position of the current pointer position in the complete recording. It can be used in paused mode to position the current pointer by moving the slider.

13: Record loop

Use this button to read the full record in a loop or read it only once

14: Record play/pause

This is the play/pause button for the whole record. In pause mode you may switch to current track record play by clicking on the track play/pause button (8).

15: Playback acceleration

Use this combo to select play back acceleration to values of 1 (no acceleration), 2, 5, 10, 20, 50, 100, 200, 500, 1k (1000) times. This is useful on long recordings used in conjunction with the spectrum "Max" averaging mode in order to see the waterfall over a long period. Thus the waterfall will be filled much faster.

☞ Note that this control is enabled only in paused mode.

⚠ The result when using channel plugins with acceleration is unpredictable. Use this tool to locate your signal of interest then play at normal speed to get proper demodulation or decoding.

16: Relative timestamp and record length

Relative timestamp of the current pointer from the start of the record in HH:MM:ss.zzz format.

17: Record length

Total record time in HH:MM:ss format.