Lime Suite: Difference between revisions
| Line 11: | Line 11: | ||
=== Ubuntu PPA === | === Ubuntu PPA === | ||
[[File:ubuntu_logo.png]] | |||
The drivers PPA for Ubuntu has a recent build of LimeSuite: | The drivers PPA for Ubuntu has a recent build of LimeSuite: | ||
| Line 21: | Line 23: | ||
=== Windows === | === Windows === | ||
[[File:windows_logo.png]] | |||
* The build/bin/Release directory of the repo has a [https://github.com/myriadrf/LimeSuite/tree/master/build/bin/Release pre-built binary for the lms7suite GUI]. Use this application for testing, plotting, firmware updates, and hardware evaluation. | * The build/bin/Release directory of the repo has a [https://github.com/myriadrf/LimeSuite/tree/master/build/bin/Release pre-built binary for the lms7suite GUI]. Use this application for testing, plotting, firmware updates, and hardware evaluation. | ||
| Line 26: | Line 30: | ||
=== OSX homebrew === | === OSX homebrew === | ||
[[File:apple_logo.jpg]] | |||
The [https://github.com/pothosware/homebrew-pothos/wiki pothosware homebrew tap] has a build recipe for LimeSuite. | The [https://github.com/pothosware/homebrew-pothos/wiki pothosware homebrew tap] has a build recipe for LimeSuite. | ||
| Line 42: | Line 48: | ||
== Get the dependencies == | == Get the dependencies == | ||
[[File:git_logo.png]] | |||
Before building LimeSuite from source, several dependencies must be installed. | Before building LimeSuite from source, several dependencies must be installed. | ||
| Line 108: | Line 116: | ||
== Building LimeSuite == | == Building LimeSuite == | ||
[[File:Build_logo.png]] | |||
=== Build on unix === | === Build on unix === | ||
| Line 123: | Line 133: | ||
</pre> | </pre> | ||
'''Linux-only''' post install step: Install the udev rules to | |||
enable non-root users to access usb-based devices like the LimeSDR: | |||
<pre> | <pre> | ||
| Line 132: | Line 143: | ||
=== Build on windows === | === Build on windows === | ||
[[File:Visual_studio_logo.png]] | |||
After installing the dependencies, open a cmd prompt and run the following command to clone the repository: | After installing the dependencies, open a cmd prompt and run the following command to clone the repository: | ||
Revision as of 03:33, 20 May 2016
Welcome to Lime Suite
Lime Suite is a collection of software supporting several hardware platforms including the LimeSDR, drivers for the LMS7002M transceiver RFIC, and other tools for developing with LMS7-based hardware.
Supported hardware
Installers and binaries
We have support for a select number of platforms and package managers. If your platform isn't supported, follow the next sections for getting the dependencies and building LimeSuite.
Ubuntu PPA
The drivers PPA for Ubuntu has a recent build of LimeSuite:
sudo add-apt-repository -y ppa:myriadrf/drivers sudo apt-get update sudo apt-get install limesuite limesuite-udev soapysdr-lms7
Windows
- The build/bin/Release directory of the repo has a pre-built binary for the lms7suite GUI. Use this application for testing, plotting, firmware updates, and hardware evaluation.
- LimeSuite is also bundled with the PothoSDR development environment to use supported hardware in an ecosystem of SDR applications like GQRX, Pothos, CubicSDR, and GNU Radio.
OSX homebrew
The pothosware homebrew tap has a build recipe for LimeSuite. Also checkout the dholm homebrew tap for other SDR related software. To install LimeSuite:
- install the Xcode Command Line Tools,
- then install homebrew from http://brew.sh/,
- and run the following commands:
brew tap pothosware/homebrew-pothos brew update brew install limesuite
Get the dependencies
Before building LimeSuite from source, several dependencies must be installed. However, the dependencies required change based on how much of the suite will be used. LimeSuite will automatically try and build all components that it can satisfy the dependencies for. The following table is a guide to the the requirements for various components.
| Component | Dependencies | Notes |
|---|---|---|
| Build system | Git & CMake | |
| Core library | sqlite3 | Has embedded copy for windows |
| LMS7 GUI | wx widgets & OpenGL | Has embedded GL for windows |
| LimeSDR | libusb 1.0/CyAPI | Use CyAPI for windows |
| NovenaRF7 | i2c and spi dev | Linux only device |
| SoapyLMS7 | SoapySDR | SDR app ecosystem support |
Ubuntu
#packages for soapysdr available at myriadrf PPA sudo add-apt-repository -y ppa:myriadrf/drivers sudo apt-get update #install core library and build dependencies sudo apt-get install git g++ cmake libsqlite3-dev #install hardware support dependencies sudo apt-get install libsoapysdr-dev libi2c-dev libusb-1.0-0-dev #install graphics dependencies sudo apt-get install libwxgtk3.0-dev freeglut3-dev
Windows
Users building LimeSuite on windows will need a recent visual studio compiler, preferable 2015. Other dependencies can be obtained from the following download links:
- Git for windows - https://git-for-windows.github.io/
- CMake - https://cmake.org/download/
- wxWidgets - https://www.wxwidgets.org/downloads/
- CyUSB - http://www.cypress.com/documentation/software-and-drivers/ez-usb-fx3-software-development-kit
- It may be easier to download "cy_ssusbsuite_*.zip" rather than the full SDK
Building LimeSuite
Build on unix
The following commands will clone the LimeSuite repository, configure the project using CMake, build the project, and install it. The output of the cmake command will show enabled and disabled components. Pay careful attention to this before building with make.
git clone https://github.com/myriadrf/LimeSuite.git cd LimeSuite mkdir builddir && cd builddir cmake ../ make -j4 sudo make install
Linux-only post install step: Install the udev rules to enable non-root users to access usb-based devices like the LimeSDR:
cd LimeSuite/ udev-rules sudo ./install.sh
Build on windows
After installing the dependencies, open a cmd prompt and run the following command to clone the repository:
git clone https://github.com/myriadrf/LimeSuite.git
Now use cmake-gui or cmake command line to configure the project and to generate a visual studio project solution. The following settings are an example on how to specify the dependencies (cmake command line or gui), your installation directories may vary:
-DWX_ROOT_DIR=C:/wxWidgets-3.1.0 -DwxWidgets_ROOT_DIR=C:/wxWidgets-3.1.0 -DwxWidgets_LIB_DIR=C:/wxWidgets-3.1.0/lib/vc140_x64_lib -DFX3_SDK_PATH=C:/EZ-USB FX3 SDK/1.3 -DSoapySDR_DIR=C:/PothosSDR
Build the generated visual studio project solution.