added more info to the readme

This commit is contained in:
Ryzerth 2020-12-14 01:07:30 +01:00
parent 7bea6058fe
commit 3e27af472b

View File

@ -3,11 +3,15 @@
![Screenshot](https://i.imgur.com/WejsiFN.png) ![Screenshot](https://i.imgur.com/WejsiFN.png)
SDR++ is a cross-platform and open source SDR software with the aim of being bloat free and simple to use. SDR++ is a cross-platform and open source SDR software with the aim of being bloat free and simple to use.
## Current Features * [Patreon](https://patreon.com/ryzerth)
* [Discord Server](https://discord.gg/aFgWjyD)
## Features
* Wide hardware support (both through SoapySDR and dedicated modules) * Wide hardware support (both through SoapySDR and dedicated modules)
* SIMD accelerated DSP * SIMD accelerated DSP
* Cross-platform * Cross-platform (Windows, Linux, OSX and BSD)
* Full waterfall update when possible. Makes browsing signals easier and more pleasant * Full waterfall update when possible. Makes browsing signals easier and more pleasant
## Comming soon ## Comming soon
@ -18,7 +22,9 @@ SDR++ is a cross-platform and open source SDR software with the aim of being blo
* Switchable fft size * Switchable fft size
* other small customisation options * other small customisation options
# Building on Windows # Building on Windows
## Requirements ## Requirements
* cmake * cmake
@ -30,39 +36,46 @@ SDR++ is a cross-platform and open source SDR software with the aim of being blo
* PothosSDR (for libvolk and SoapySDR) * PothosSDR (for libvolk and SoapySDR)
## The build ## The build
```
```powershell
mkdir build mkdir build
cd build cd build
cmake .. "-DCMAKE_TOOLCHAIN_FILE=C:/Users/Alex/vcpkg/scripts/buildsystems/vcpkg.cmake" -G "Visual Studio 15 2017 Win64" cmake .. "-DCMAKE_TOOLCHAIN_FILE=C:/Users/Alex/vcpkg/scripts/buildsystems/vcpkg.cmake" -G "Visual Studio 15 2017 Win64"
cmake --build . --config Release cmake --build . --config Release
``` ```
## Copying over needed directories
The last step of the build process is copying the `bandplans` and `res` directories to the output directory.
If you followed the steps above, it should be `build/Release`.
# Building on Linux # Building on Linux
## install requirements ## install requirements
On Debian/Ubtuntu system: On Debian/Ubtuntu system:
apt install libglew-dev libglfw3-dev libfftw3-dev libvolk1-dev portaudio19-dev libsoapysdr-dev gcc apt install libglew-dev libglfw3-dev libfftw3-dev libvolk1-dev portaudio19-dev libsoapysdr-dev gcc
## The build ## The build
``` Replace `<N>` by the number of threads available for building (eg. 4)
```sh
mkdir build mkdir build
cd build cd build
cmake .. cmake ..
make make -j<N>
``` ```
## Modify root_dev/modules_list.json ## Modify root_dev/config.json
If the content is different than the following, change it. You'll then need to set the right paths for the modules.
``` This is optional. If you don't plan on modifying the modules,
{ you can simply copy over their binaries (from `build/<module name>/<module name>.so`)
"Radio": "./radio/radio.so", to the `root_dev/modules/` directory.
"Recorder": "./recorder/recorder.so",
"Soapy": "./soapy/soapy.so", Here is an example of module paths in `root_dev/config.json`
"RTLTCPSource": "./rtl_tcp_source/rtl_tcp_source.so"
} ```json
"modules": [
"./radio/radio.so",
"./recorder/recorder.so",
"./soapy/soapy.so",
"./rtl_tcp_source/rtl_tcp_source.so"
]
``` ```
# Building on OSX # Building on OSX
@ -82,8 +95,28 @@ cmake ..
cmake --build . --config Release cmake --build . --config Release
``` ```
## Configuring
You'll then need to set the right paths for the modules.
This is optional. If you don't plan on modifying the modules,
you can simply copy over their binaries (from `build/<module name>/<module name>.so`)
to the `root_dev/modules/` directory.
Here is an example of module paths in `root_dev/config.json`
```json
"modules": [
"./radio/radio.so",
"./recorder/recorder.so",
"./soapy/soapy.so",
"./rtl_tcp_source/rtl_tcp_source.so"
]
```
# Building on OpenBSD # Building on OpenBSD
## Install requirements ## Install requirements
NOTE: These instructions are outdated
``` ```
pkg_add fftw3-float glew glfw portaudio-svn pkg_add fftw3-float glew glfw portaudio-svn