LimeMicro BT MiniHackathon

Details for BT & Lime Micro Mini Hackathon, London, 21st June 2017.

Agenda

 * 08:30 – 09:00: Introduction & registration
 * 09:00 – 10:15: Introduction to modern wireless communication, Physical layer & LimeSDR hardware (Lime)
 * 10:15 – 11:00: Quortus EPC, function and features (Quortus)
 * 11:00 – 11:30: Coffee break
 * 11:30 – 12:15: Open Air Interface, background and status (Eurecom)
 * 12:15 – 12:30: Short introduction to the practical sessions
 * 12:30 – 13:30: Lunch
 * 13:30 – 14:00: Introduction to Osmocom
 * 14:00 – 15:00: LimeSDR drivers and APIs (Lime) / 3&4G PHY, up and downlink examples
 * 15:00 – 15:30: Coffee Break
 * 15:30 – 17:00: Complete LTE+EPC example setup, call setup (eNodeB and hands on demo)
 * 17:00 – 17:30: Feedback and closing remarks

Software prerequisites
The following software must be installed.

Binary package install
sudo add-apt-repository -y ppa:myriadrf/drivers sudo apt-get update sudo apt-get install limesuite limesuite-udev limesuite-images sudo apt-get install liblimesuite-dev sudo apt-get install soapysdr soapysdr-module-lms7

Build from source
1. Configure Myriad-RF drivers PPA for SoapySDR packages

sudo add-apt-repository -y ppa:myriadrf/drivers sudo apt-get update

2. Install dependencies

sudo apt-get install git g++ cmake libsqlite3-dev libsoapysdr-dev libi2c-dev libusb-1.0-0-dev libwxgtk3.0-dev freeglut3-dev

3. Get sources

git clone https://github.com/myriadrf/LimeSuite

To update use 'git pull'

4. Build and install

cd ~/LimeSuite mkdir builddir && cd builddir cmake ../ make -j4 sudo make install cd ~/LimeSuite/udev-rules sudo ./install.sh

Windows 8, 10
Use Pothos SDR Development Environment installer:

http://downloads.myriadrf.org/builds/PothosSDR/

(get latest)

Octave
Note octave 3.8.2 does not support -O3 flag Modified MakeFile to fix

Binary package install
We currently only support Ubuntu 16.04 LTS.


 * sudo can be omitted on some non-Ubuntu systems if you are logged in as su or using root terminal.
 * package manager can be used instead of 'sudo apt-get install'

1. install package manager such as synaptic and other useful linux tools

sudo apt-get install synaptic sudo apt-get ssh sudo apt-get filezilla

2. install octave 4.0.0 or 3.8.2, gnuplot-x11, liboctave-dev from repo

sudo apt-get install gnuplot-x11 sudo apt-get install octave liboctave-dev octave-general octave-control octave-signal octave-communications

Ubuntu currently installs Octave 4.0.0. Other linux systems install Octave 3.8.2.

gnuplot is used for graph plotting, but fltk, qt can also be used. Use the following line to change toolkit: graphics_toolkit('gnuplot')

See: https://www.gnu.org/software/octave/doc/interpreter/Introduction-to-Plotting.html sudo apt-get install libfltk1.3

Note communications package does not automatically load in octave >=4.0.0, add this line to your code: pkg load communications

Build from source
Note it is also possible to build octave from source, but there are a lot of dependencies.

E.g. http://wiki.octave.org/Octave_for_Debian_systems

Packages can also be downloaded from Sourceforge.

https://www.gnu.org/software/octave/doc/interpreter/Installing-and-Removing-Packages.html


 * https://octave.sourceforge.io/general/index.html
 * https://octave.sourceforge.io/control/index.html
 * https://octave.sourceforge.io/signal/index.html
 * https://octave.sourceforge.io/communications/index.html

mkdir ~/octave cp *.tar.gz ~/octave octave pkg install ~/octave/general-2.0.0.tar.gz pkg install ~/octave/control-3.0.0.tar.gz pkg install ~/octave/signal-1.3.2.tar.gz pkg install ~/octave/communications-1.2.1.tar.gz

You need also to install LimeSuite before the following lines - see separate note.

Note you will need liboctave-dev installed.

Copy the limesdr-1.0.0.tar.gz and limesp-1.0.0.tar.gz into ~/octave folder cp *.tar.gz ~/octave octave pkg install ~/octave/limesdr-1.0.0.tar.gz pkg install ~/octave/limesp-1.0.0.tar.gz

Windows 8, 10
Recommend install Octave 4.0.3 (Note we have found 4.2.0 incompatible with Communications package)

https://ftp.gnu.org/gnu/octave/windows/

All 3rd party packages automatically installed.

You will need to install LimeSuite via Pothos SDR DE installer.

Copy the limesdr-1.0.0.tar.gz and limesp-1.0.0.tar.gz into C:\Users\UserName\octave.

From octave command line window pkg install ~/octave/limesdr-1.0.0.tar.gz pkg install ~/octave/limesp-1.0.0.tar.gz

Also extract .dll from limesdr-1.0.0.tar.gz and keep here 'control panels'->'system'->'advance system settings'->'environmental variables'->'path' add C:\Users\UserName\octave to your path

Mac OS X
http://wiki.octave.org/Octave_for_MacOS_X Homebrew version of Octave 4.0.3 appears to be unable to install packages. ! G A M E  O V E R !

Demo applications and presentation
The demo applications and slides for the Advanced Digital Radio presentation are on GitHub.

Download ZIP file
A ZIP archive can be downloaded via:

https://github.com/myriadrf/LimeSDR_Workshop/archive/bt-mini.zip

Clone git repo
git clone https://github.com/myriadrf/LimeSDR_Workshop.git git checkout bt-mini