mirror of
https://github.com/f4exb/sdrangel.git
synced 2024-11-26 17:58:43 -05:00
66 lines
2.6 KiB
Markdown
66 lines
2.6 KiB
Markdown
<h1>Repair or reformat record (.sdriq) files</h1>
|
|
|
|
<h2>Usage</h2>
|
|
|
|
This utility attempts to repair .sdriq files that have their header corrupted or with a pre version 4.2.1 header. Since version 4.2.1 a CRC32 checksum is present and the file will not be played if the check of the header content against the CRC32 fails.
|
|
|
|
The header is composed as follows:
|
|
|
|
- Sample rate in S/s (4 bytes, 32 bits)
|
|
- Center frequency in Hz (8 bytes, 64 bits)
|
|
- Start time Unix timestamp epoch in seconds (8 bytes, 64 bits)
|
|
- Sample size as 16 or 24 bits (4 bytes, 32 bits)
|
|
- filler with all zeroes (4 bytes, 32 bits)
|
|
- CRC32 (IEEE) of the 28 bytes above (4 bytes, 32 bits)
|
|
|
|
The header size is 32 bytes in total which is a multiple of 8 bytes thus occupies an integer number of samples whether in 16 or 24 bits mode. When migrating from a pre version 4.2.1 header you may crunch a very small amount of samples.
|
|
|
|
You can replace values in the header with the following options:
|
|
|
|
- -sr uint
|
|
Sample rate (S/s)
|
|
- -cf uint
|
|
Center frequency (Hz)
|
|
- -ts string
|
|
start time RFC3339 (ex: 2006-01-02T15:04:05Z)
|
|
- -now
|
|
use now for start time
|
|
- -sz uint
|
|
Sample size (16 or 24) (default 16)
|
|
|
|
You need to specify an input file. If no output file is specified the current header values are printed to the console and the program exits:
|
|
|
|
- -in string
|
|
input file (default "foo")
|
|
|
|
To convert to a new file you need to specify the output file:
|
|
|
|
- -out string
|
|
output file (default "foo")
|
|
|
|
You can specify a block size in multiples of 4k for the copy. Large blocks will yield a faster copy but a larger output file. With the default of 1 (4k) the copy does not take much time anyway:
|
|
|
|
- -bz uint
|
|
Copy block size in multiple of 4k (default 1)
|
|
|
|
<h2>Build</h2>
|
|
|
|
The program is written in go and is provided only in source code form. Compiling it is very easy:
|
|
|
|
<h3>Install go</h3>
|
|
|
|
You will usually find a `golang` package in your distribution. For example in Ubuntu or Debian you can install it with `sudo apt-get install golang`. You can find binary distributions for many systems at the [Go download site](https://golang.org/dl/)
|
|
|
|
<h3>Build the program</h3>
|
|
|
|
In this directory just do `go build`
|
|
|
|
<h3>Unit testing</h3>
|
|
|
|
Unit test (very simple) is located in `rescuesdriq_test.go`. It uses the [Go Convey](https://github.com/smartystreets/goconvey) framework. You should first install it with:
|
|
`go get github.com/smartystreets/goconvey`
|
|
|
|
You can run unit test from command line with: `go test`
|
|
|
|
Or with the Go Convey server that you start from this directory with: `$GOPATH/bin/goconvey` where `$GOPATH` is the path to your go installation.
|