All new accounts created on Gitlab now require administrator approval. If you invite any collaborators, please let Flux staff know so they can approve the accounts.

README 2.91 KB
Newer Older
1 2 3 4 5
This directory contains the openLTE source code.  For support, please
subscribe to openlte-discuss@lists.sourceforge.net.  Details can be
found at sourceforge.net/projects/openlte/.

The directory structure for the project is:
6 7 8
octave                Octave test code
cmn_hdr               Common header files
liblte                C++ library of commonly used LTE functions
9 10
cmake                 Files needed for cmake
build                 Cmake generated build files
11 12
LTE_fdd_dl_file_scan  A gnu-radio LTE FDD DL file scanner application
LTE_fdd_dl_file_gen   A gnu-radio LTE FDD DL file generator application
13 14
LTE_fdd_dl_scan       A gnu-radio LTE FDD DL scanner application that
                      currently supports rtl-sdr hardware
15 16 17

To build the C++ and python code use the following:

18 19
  $ cd build
  $ cmake ../
20 21 22 23
  $ make

To install the C++ and python code use the following:

24 25
  $ cd build
  $ cmake ../
26
  $ make
27
  $ sudo make install
28

29 30 31
##################
#  FILE SCANNER  #
##################
32 33 34
To use the installed C++ and python code for the file scanner,
set the PYTHONPATH env variable to
<python_install_dir>/dist-packages/gnuradio/
35
for instance /usr/local/lib/python2.7/dist-packages/gnuradio/
36 37 38 39
and make sure that /usr/local/lib is added to /etc/ld.so.conf
and that LD_LIBRARY_PATH is set to /usr/local/lib (export
LD_LIBRARY_PATH=/usr/local/lib).  Then run LTE_fdd_dl_file_scan.py
and specify a recorded LTE file as the input. For example:
40

41
  $ LTE_fdd_dl_file_scan.py lte_file.bin
42 43 44 45

The recorded LTE file currently must be interleaved 8-bit I and
Q samples recorded at 30.72MHz.

46 47 48
####################
#  FILE GENERATOR  #
####################
49 50 51
To use the installed C++ and python code for the file generator,
set the PYTHONPATH env variable to
<python_install_dir>/dist-packages/gnuradio/
52 53 54 55 56
for instance /usr/local/lib/python2.7/dist-packages/gnuradio/
and that LD_LIBRARY_PATH is set to /usr/local/lib (export
LD_LIBRARY_PATH=/usr/local/lib).  Then run LTE_fdd_dl_file_gen.py
and specify an output file for the LTE fdd downlink signal.
For example:
57

58
  $ LTE_fdd_dl_file_gen.py lte_file.bin
59 60 61 62 63

The generated LTE file contains interleaved 8-bit I and Q samples
at a sample rate of 30.72MHz.  The output file can be used as the
input for the LTE_fdd_dl_file_scan application.

64 65 66
#############
#  SCANNER  #
#############
67 68 69 70 71 72 73
To use the installed C++ live scanner, make sure LD_LIBRARY_PATH
is set to /usr/local/lib (export LD_LIBRARY_PATH=/usr/local/lib),
plug in rtl-sdr hardware, run LTE_fdd_dl_scan, and connect (via
telnet, nc, etc) to the control port at port number 20000.  Scan
parameters can be changed and scan results can be observed on the
control port.  For a list of parameters simply type help on the
control port.
74 75 76 77

############
#  OCTAVE  #
############
78 79 80 81
To use the octave code, run the top level octave .m files:
lte_fdd_dl_transmit.m and lte_fdd_dl_receive.m.  If multiple
transmit antennas are used, the outputs need to be combined
before input to the receiver.