VE7UWU
/
sdrangel
mirror of https://github.com/f4exb/sdrangel.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

PlutoSDR: updated documentation

This commit is contained in:
f4exb 2017-09-21 21:26:28 +02:00
parent 0a9d70126b
commit dc2b705807
5 changed files with 30 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Readme.md
View File

@ -40,6 +40,7 @@ From version 3 transmission or signal generation is supported for BladeRF, HackR
- [BladeRF output plugin](https://github.com/f4exb/sdrangel/tree/dev/plugins/samplesink/bladerfoutput) limited support in Windows
- [HackRF output plugin](https://github.com/f4exb/sdrangel/tree/dev/plugins/samplesink/hackrfoutput)
- [LimeSDR output plugin](https://github.com/f4exb/sdrangel/tree/dev/plugins/samplesink/limesdroutput)
- [PlutoSDR output plugin](https://github.com/f4exb/sdrangel/tree/dev/plugins/samplesink/plutosdroutput)
- [File output or file sink plugin](https://github.com/f4exb/sdrangel/tree/dev/plugins/samplesink/filesink)
- [Remote device via Network with SDRdaemon](https://github.com/f4exb/sdrangel/tree/dev/plugins/samplesink/sdrdaemonsink) Linux only
@ -125,8 +126,6 @@ PlutoSDR is supported with the libiio interface. This library should be installe
If you use your own location for libiio install directory you need to specify library and include locations. Example with `/opt/install/libiio` with the following defines on `cmake` command line: `-DLIBIIO_INCLUDE_DIR=/opt/install/libiio/include -DLIBIIO_LIBRARY=/opt/install/libiio/lib/libiio.so`
Only the Rx part is supported at the moment.
<h2>RTL-SDR</h2>
RTL-SDR based dongles are supported through the librtlsdr library that should be installed in your system for proper build of the software and operation support. Add `librtlsdr-dev` to the list of dependencies to install.
@ -234,17 +233,15 @@ If you are not comfortable with this just do not install DSDcc and/or mbelib and
In the [releases](https://github.com/f4exb/sdrangel/releases) section one can find binary distributions for some common systems:
- Windows 32 bit (runs in 64 bit Windows)
- Windows 32 bit (runs also in 64 bit Windows)
- Debian x86_64 (Ubuntu 16.04, Ubuntu 17.04, Debian Stretch)
- Windows 64 bit until v3.5.4
- Windows 64 bit
- Debian armv7l (Debian Jessie) until v3.5.0
<h2>Windows distributions</h2>
This is the archive of the complete binary distribution that expands to the `sdrangel64` directory for the 64 bit version and `sdrangel` for the 32 bit version. You can install it anywhere you like and click on `sdrangel.exe` to start.
Starting at release v3.5.5 there are no more Windows64 distributions
<h2>Debian distributions</h2>
It is provided in the form of .deb packages for x86_64 architectures with SSE 4.1 support or ARMv7l architectures with Neon support.
@ -277,8 +274,8 @@ The software is installed in `/opt/sdrangel` you can start it from the command l
To be sure you will need at least Qt version 5.5. It definitely does not work with versions earlier than 5.3 but neither 5.3 nor 5.4 were tested.
- Linux builds are made with 5.5.1
- Windows 32 build is made with 5.5.1
- Windows 64 build is made with 5.6
- Windows 32 build is made with 5.9.1
- Windows 64 build is made with 5.9.1
<h2>Ubuntu</h2>

5
debian/changelog vendored
View File

@ -1,10 +1,11 @@
sdrangel (3.7.1-1) unstable; urgency=medium
* PlutoSDR: Tx support
* PlutoSDR: Tx support
* LimeSDR: use version 17.09 of LimeSuite providing bug fixes
* GUI segregation: remove device source or sink lifecycle from the GUI
* GUI segregation: handle GUI and device buddy updates separately
-- Edouard Griffiths, F4EXB <f4exb06@gmail.com> Thu, 17 Sep 2017 23:14:18 +0200
-- Edouard Griffiths, F4EXB <f4exb06@gmail.com> Thu, 21 Sep 2017 21:14:18 +0200
sdrangel (3.7.0-1) unstable; urgency=medium

4
devices/readme.md
View File

@ -14,5 +14,9 @@ This folder contains classes and methods that can be used by different plugins t
- limesdrinput
- limesdroutput
- PlutoSDR: one Rx and one Tx full duplex. Plugins are
- plutosdrinput
- plutosdroutput
- SDRdaemon: sends or receive samples to/from device remotely through the network. Used on the Tx plugin only
- sdrdaemonsink

22
plugins/samplesink/plutosdroutput/readme.md
View File

@ -35,7 +35,7 @@ Then add the following defines on `cmake` command line when compiling SDRangel:
<h4>1.1: Frequency</h4>
This is the center frequency of reception in kHz. The limits are set as those of the AD9364: from 70 to 6000 MHz. PlutoSDR can be fooled to think it has a AD9364 chip with a very simple software hack described [here](https://wiki.analog.com/university/tools/pluto/users/customizing).
This is the center frequency of transmission in kHz. The limits are set as those of the AD9364: from 70 to 6000 MHz. PlutoSDR can be fooled to think it has a AD9364 chip with a very simple software hack described [here](https://wiki.analog.com/university/tools/pluto/users/customizing).
AD9363 extended frequency range is not guaranteed but would work normally particularly in the lower range.
@ -53,15 +53,15 @@ This is the sample rate at which the DAC runs in kS/s (k) or MS/s (M) after hard
<h4>1.4: Stream sample rate</h4>
Baseband I/Q sample rate in kS/s. This is the host to device sample rate (5) multiplied by the software interpolation factor (3).
Baseband I/Q sample rate in kS/s. This is the host to device sample rate (5) divided by the software interpolation factor (3).
<h3>2: LO ppm correction</h3>
Use this slider to adjust LO correction in ppm. It can be varied from -20.0 to 20.0 in 0.1 steps and is applied in hardware.
Use this slider to adjust LO correction in ppm. It can be varied from -20.0 to 20.0 in 0.1 steps and is applied in hardware. This applies to the oscillator that controls both the Tx and Rx frequency therefore it is also changed on the Rx plugin if it is active.
<h3>3: Software decimation factor</h3>
<h3>3: Software interpolation factor</h3>
The I/Q stream from the LimeSDR is downsampled by a power of two by software inside the plugin before being sent to the passband. Possible values are increasing powers of two: 1 (no decimation), 2, 4, 8, 16, 32.
The I/Q stream to the PlutoSDR is upsampled by a power of two by software inside the plugin from the signal coming from the passband. Possible values are increasing powers of two: 1 (no interpolation), 2, 4, 8, 16, 32.
<h3>4: Antenna (output) connection</h3>
@ -73,7 +73,7 @@ This is the AD9363 device to/from host stream sample rate in S/s. It is the same
Use the wheels to adjust the sample rate. Pressing shift simultanoeusly moves digit by 5 and pressing control moves it by 2. 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.
The minimum sample rate depends on the hardware FIR decimation factor (12) and is the following:
The minimum sample rate depends on the hardware FIR decimation factor (9) and is the following:
- no decimation: 25/12 MS/s thus 2083336 S/s (next multiple of 4)
- decimation by 2: 25/24 MS/s thus 1041668 S/s
@ -87,17 +87,19 @@ This is the Tx analog filter bandwidth in kHz in the AD9363 device. It can be va
<h3>7: Hardware FIR filter toggle</h3>
The AD9363 chip has an optional FIR filter in the Rx decimation chain as the last decimation block. Use this button to activate or deactivate the filter.
The AD9363 chip has an optional FIR filter in the Tx interpolation chain as the first interpolation block. Use this button to activate or deactivate the filter.
The FIR filter settings are the same on Rx and Tx side therefore any change here is automatically forwarded to the Tx GUI.
The FIR filter settings are the same on Rx and Tx side therefore any change here is automatically forwarded to the Rx GUI.
<h3>8: Hardware FIR filter bandwidth</h3>
Use the wheels to adjust the bandwidth of the hardware FIR filter. Pressing shift simultanoeusly moves digit by 5 and pressing control moves it by 2.
The filter is calculated as a windowed FIR filter with a Blackman-Harris window. This has a high out of band rejection value at the expense of a slightly smoother roll off compared to other filters. The bandwidth value sets the -6 dB point approxomately.
The filter limits are calculated as 0.05 and 0.9 times the FIR filter input frequency for the lower and higher limit respectively. The FIR filter input frequency is the baseband sample rate (5) multiplied by the FIR interpolation factor (9)
The limits are calculated as 0.05 and 0.9 times the FIR filter input frequency for the lower and higher limit respectively. The FIR filter input frequency is the baseband sample rate (5) multiplied by the FIR interpolation factor (9)
For bandwidths greater than 0.2 times the FIR filter input frequency the filter is calculated as a windowed FIR filter with a Blackman-Harris window. This has a high out of band rejection value at the expense of a slightly smoother roll off compared to other filters. The bandwidth value sets the -6 dB point approxomately.
For bandwidths between 0.05 and 0.2 times the FIR filter input frequency the window used is a Hamming window giving a sharper transition.
<h3>9: Hardware FIR interpolation factor</h3>

10
plugins/samplesource/plutosdrinput/readme.md
View File

@ -61,7 +61,7 @@ Baseband I/Q sample rate in kS/s. This is the device to host sample rate (8) div
<h3>2: LO ppm correction</h3>
Use this slider to adjust LO correction in ppm. It can be varied from -20.0 to 20.0 in 0.1 steps and is applied in hardware.
Use this slider to adjust LO correction in ppm. It can be varied from -20.0 to 20.0 in 0.1 steps and is applied in hardware. This applies to the oscillator that controls both the Rx and Tx frequency therefore it is also changed on the Tx plugin if it is active.
<h3>3-4: Auto correction options</h3>
@ -74,7 +74,7 @@ These buttons control the software DSP auto correction options:
<h3>5: Software decimation factor</h3>
The I/Q stream from the LimeSDR is doensampled by a power of two by software inside the plugin before being sent to the passband. Possible values are increasing powers of two: 1 (no decimation), 2, 4, 8, 16, 32, 64.
The I/Q stream from the PlutoSDR is doensampled by a power of two by software inside the plugin before being sent to the passband. Possible values are increasing powers of two: 1 (no decimation), 2, 4, 8, 16, 32, 64.
<h3>6: Decimated bandpass center frequency placement</h3>
@ -114,9 +114,11 @@ The FIR filter settings are the same on Rx and Tx side therefore any change here
Use the wheels to adjust the bandwidth of the hardware FIR filter. Pressing shift simultanoeusly moves digit by 5 and pressing control moves it by 2.
The filter is calculated as a windowed FIR filter with a Blackman-Harris window. This has a high out of band rejection value at the expense of a slightly smoother roll off compared to other filters. The bandwidth value sets the -6 dB point approxomately.
The filter limits are calculated as 0.05 and 0.9 times the FIR filter input frequency for the lower and higher limit respectively. The FIR filter input frequency is the baseband sample rate (5) multiplied by the FIR interpolation factor (9)
The limits are calculated as 0.1 and 0.9 times the FIR filter input frequency for the lower and higher limit respectively. The FIR filter input frequency is the baseband sample rate (8) multiplied by the FIR decimation factor (12)
For bandwidths greater than 0.2 times the FIR filter input frequency the filter is calculated as a windowed FIR filter with a Blackman-Harris window. This has a high out of band rejection value at the expense of a slightly smoother roll off compared to other filters. The bandwidth value sets the -6 dB point approxomately.
For bandwidths between 0.05 and 0.2 times the FIR filter input frequency the window used is a Hamming window giving a sharper transition.
<h3>12: Hardware FIR decimation factor</h3>