Add alternative to the building of modules

Vincent Sonnier 2018-05-20 16:00:01 +02:00
parent 5f94a83ee5
commit 2ddada1cce
1 changed files with 28 additions and 12 deletions

@ -9,7 +9,8 @@ Visual Studio 2017 also has a better optimizing compiler which may result a fast
Interesting point, VS2017 produces binaries compatible with VS2015 ones so there is no point of not using VS2017 whatsoever.
Alternatively if you don't want to compile anything and use pre-built binaries instead, you can install the [PothosSDR distribution](https://github.com/pothosware/PothosSDR/wiki/Tutorial) (Resources / Download installer) which contains a Win64 build of the latest CubicSDR source code together with all the existing SoapySDR modules to talk to any SDR device.
Given a new version is released roughly every month, you may get more recent CubicSDR binaries than from the official [release page.](https://github.com/cjcliffe/CubicSDR/releases)
Given a new version is released roughly every month, you may get more recent CubicSDR binaries than from the [official
release page.](https://github.com/cjcliffe/CubicSDR/releases)
# Install Visual Studio Community 2017
@ -26,7 +27,7 @@ Navigate to `C:\MSVCDev\wxWidgets-3.1.1\build\msw` (or wherever you extracted) a
Choose `Release` and `x64` for the build configuration and "Build Solution". All *should* compile successfully and you can close the project.
This configuration effectively builds wxWidgets as a static library, later linked with CubicSDR.
# Install CMake:
# Install CMake
Download CMake from:
@ -45,7 +46,7 @@ Download ZIP or clone SoapySDR from https://github.com/pothosware/SoapySDR to `C
* Launch CMake, set source path to `C:/MSVCDev/SoapySDR/`
* Set destination to `C:/MSVCDev/SoapySDR_win64/`
* Click "Configure" and choose "Visual Studio 15 2017 Win64" and Finish
* Set CMAKE_INSTALL_PREFIX to `C:/MSVCDev/SoapySDR_install`
* Set CMAKE_INSTALL_PREFIX to `C:/MSVCDev/SoapySDR_win64_install`
* Set SOAPY_SDR_ROOT to `C:/MSVCDev/SoapySDR_install`
* Click Configure again, all should be good, then Generate.
@ -60,7 +61,7 @@ C:\MSVCDEV> cmake --build SoapySDR_win64 --config Release --target install
0 Error(s)
```
# Build CubicSDR:
# Build CubicSDR
* Clone or download ZIP from https://github.com/cjcliffe/CubicSDR/ to `C:\MSVCDev\CubicSDR`
* Run CMake GUI
@ -68,22 +69,37 @@ C:\MSVCDEV> cmake --build SoapySDR_win64 --config Release --target install
* Choose `C:\MSVCDev\CubicSDR_win64` for build folder.
* Click Configure.
* Choose "Visual Studio 15 2017 Win64" and Finish.
* Set wxWidgets_ROOT_DIR to `C:\MSVCDev\wxWidgets-3.1.1`.
* Set wxWidgets_LIB_DIR to `C:\MSVCDev\wxWidgets-3.1.1\lib\vc_x64_lib`.
* Set wxWidgets_ROOT_DIR to `C:\MSVCDev\wxWidgets-3.1.1`
* Set wxWidgets_LIB_DIR to `C:\MSVCDev\wxWidgets-3.1.1\lib\vc_x64_lib`
* Set CMAKE_INSTALL_PREFIX to `C:/MSVCDev/SoapySDR_win64_install`
* Click "Configure" again
Configure variables to indicate CubicSDR that modules files will be searched in the `[CubicSDR executable]\modules` directory:
* Set BUILD_INSTALLER to 1 (selected)
* Click "Configure" again
* Set BUNDLE_SOAPY_MODS to 1 (selected)
* Click "Configure" again
* Set BUNDLED_MODS_ONLY to 1 (selected)
* Click Configure again, all should be good, then Generate.
* Navigate to `C:\MSVCDev\CubicSDR_win64` in explorer and open `CubicSDR.sln`.
* Navigate to `C:\MSVCDev\CubicSDR_win64` in Explorer and open `CubicSDR.sln`.
- Once open select "Release" and "x64" build configuration and then "Build Solution" (F6)
- CubicSDR.exe should now be in the output folder (i.e. `C:\MSVCDev\CubicSDR_win64\x64`) and ready to run (minus support modules).
- CubicSDR.exe should now be in the output folder (i.e. `C:\MSVCDev\CubicSDR_win64\x64`).
# Build Support Modules and dependencies
# Using existing Modules
## Getting or building low-level dependencies
The simplest way to make CubicSDR ready tu run at that point is to 'reuse' the modules and libraries from an existing Installer:
* Download the CubicSDR installer from [official release page.](https://github.com/cjcliffe/CubicSDR/releases)
* Run the installer and set `C:\MSVCDev\CubicSDR_win64\x64` as the installation directory.
Then re-compile CubicSDR as described in the previous section:
* Navigate to `C:\MSVCDev\CubicSDR_win64` in Explorer and open `CubicSDR.sln`.
- Once open select "Release" and "x64" build configuration and then "Build Solution" (F6)
- CubicSDR.exe should now be re-generated in the `C:\MSVCDev\CubicSDR_win64\x64` folder and ready to run.
Alternatively, see the following section to build the modules from scratch:
# Building Modules and dependencies
SoapySDR modules need hardware-specific libraries to communicate with the hardware. Such libraries either come from Open Source Software or are provided by the hardware vendor.
For instance,
@ -154,7 +170,7 @@ Copy the file `rtlsdr.dll` in the `C:\MSVCDev\CubicSDR_win64\x64` directory wher
* Launch CMake, set source path to `C:/MSVCDev/SoapyRTLSDR/`
* Set destination to `C:/MSVCDev/SoapyRTLSDR_win64`
* Click "Configure" and choose "Visual Studio 15 2017 Win64" and Finish
* Set CMAKE_INSTALL_PREFIX to `C:/MSVCDev/SoapySDR_install`
* Set CMAKE_INSTALL_PREFIX to `C:/MSVCDev/SoapySDR_win64_install`
* Click "Configure" again
* Set RTLSDR_INCLUDE_DIR to `C:/MSVCDev/librtlsdr/include`
* Set RTLSDR_LIBRARY to `C:/MSVCDev/librtlsdr_win64/src/Release/rtlsdr.lib`
@ -178,7 +194,7 @@ Copy the generated module file `rtlsdrSupport.dll` in the `C:\MSVCDev\CubicSDR_w
* Launch CMake, set source path to `C:/MSVCDev/SoapySDRPlay`
* Set destination to `C:/MSVCDev/SoapySDRPlay_win64`
* Click "Configure" and choose "Visual Studio 15 2017 Win64" and Finish
* Set CMAKE_INSTALL_PREFIX to `C:/MSVCDev/SoapySDR_install`
* Set CMAKE_INSTALL_PREFIX to `C:/MSVCDev/SoapySDR_win64_install`
* Click "Configure" again
* Set LIBSDRPLAY_INCLUDE_DIRS to `C:/Program Files/SDRplay/API/inc`
* Set LIBSDRPLAY_LIBRARIES to `C:/Program Files/SDRplay/API/x64/mir_sdr_api.lib`