readme.md
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
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 multiplier ('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
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 (
16or24) - 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 integeru: unsigned integerf: 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 shows24although 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
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.