This directory contains the openLTE source code.  For support, pleasesubscribe to openlte-discuss@lists.sourceforge.net.  Details can befound at sourceforge.net/projects/openlte/.The directory structure for the project is:octave                Octave test codecmn_hdr               Common header filesliblte                C++ library of commonly used LTE functionscmake                 Files needed for cmakeLTE_fdd_dl_file_scan  A gnu-radio LTE FDD DL file scanner applicationLTE_fdd_dl_file_gen   A gnu-radio LTE FDD DL file generator applicationLTE_fdd_dl_scan       A gnu-radio LTE FDD DL scanner application that                      currently supports rtl-sdr, hackrf, USRP B2X0,                      and bladeRF hardwareLTE_file_recorder     A gnu-radio LTE file recording application that                      currently supports rtl-sdr, hackrf, USRP B2X0,                      and bladeRF hardwareLTE_fdd_enodeb        An LTE FDD eNodeB application that currently                      supports URSP B2X0 hardwareopenLTE is dependant on the following:1) GNU Radio2) GrOsmoSDR3) rtl-sdr4) UHD5) HackRF6) bladeRF7) polarssl8) iptablesTo build the C++ and python code use the following:  $ mkdir build  $ cd build  $ cmake ../  $ makeTo install the C++ and python code use the following:  $ mkdir build  $ cd build  $ cmake ../  $ make  $ sudo make installAll testing was performed against the following configuration:- Intel Core i5-2557M- Ubuntu 12.04- GNU Radio 3.7.2- GrOsmoSDR 0.1.1- rtl-sdr 0.5- UHD 3.6.0-1- HackRF 0.2- bladeRF 0.9.0###################  FILE SCANNER  ###################To use the installed C++ and python code for the file scanner,set the PYTHONPATH env variable to<python_install_dir>/dist-packages/gnuradio/for instance /usr/local/lib/python2.7/dist-packages/gnuradio/and make sure that /usr/local/lib is added to /etc/ld.so.confand that LD_LIBRARY_PATH is set to /usr/local/lib (exportLD_LIBRARY_PATH=/usr/local/lib).  Then run LTE_fdd_dl_file_scan.pyand specify a recorded LTE file as the input. For example:  $ LTE_fdd_dl_file_scan.py lte_file.binTo see a list of options, use the -h option:  $ LTE_fdd_dl_file_scan.py -hTo change the input file data type (int8 or gr_complex), use the-d/--data-type option:  $ LTE_fdd_dl_file_scan.py -d int8 lte_file.binFor int8 data type, the recorded LTE file must be interleaved signed8-bit I and Q samples.  For the gr_complex data type, the recordedLTE file must be sequential gr_complex I/Q samples.  Files recordedwith LTE_file_recorder or generated with LTE_fdd_dl_file_gen can bescanned with this application.#####################  FILE GENERATOR  #####################To use the installed C++ and python code for the file generator,set the PYTHONPATH env variable to<python_install_dir>/dist-packages/gnuradio/for instance /usr/local/lib/python2.7/dist-packages/gnuradio/and that LD_LIBRARY_PATH is set to /usr/local/lib (exportLD_LIBRARY_PATH=/usr/local/lib).  Then run LTE_fdd_dl_file_gen.pyand specify an output file for the LTE fdd downlink signal.For example:  $ LTE_fdd_dl_file_gen.py lte_file.binTo see a list of options, use the -h option:  $ LTE_fdd_dl_file_gen.py -hTo change the output file data type (int8 or gr_complex), use the-d/--data-type option:  $ LTE_fdd_dl_file_gen.py -d gr_complex lte_file.binFor int8 data type, the generated LTE file contains interleavedsigned 8-bit I and Q samples.  For the gr_complex data type, thegenerated LTE file contains sequential gr_complex I/Q samples.Files generated with this application can be scanned withLTE_fdd_dl_file_scan.##############  SCANNER  ##############To use the installed C++ live scanner, make sure LD_LIBRARY_PATHis set to /usr/local/lib (export LD_LIBRARY_PATH=/usr/local/lib),plug in rtl-sdr, hackrf, USRP B2X0, or bladeRF hardware, runLTE_fdd_dl_scan, and connect (via telnet, nc, etc) to the controlport at port number 20000.  Scan parameters can be changed andscan results can be observed on the control port.  For a list ofparameters simply type help on the control port.####################  FILE RECORDER  ####################To use the installed C++ file recorder, make sure LD_LIBRARY_PATHis set to /usr/local/lib (export LD_LIBRARY_PATH=/usr/local/lib),plug in rtl-sdr, hackrf, USRP B2X0, or bladeRF hardware, runLTE_file_recorder, and connect (via telnet, nc, etc) to thecontrol port at port number 25000.  Recording parameters can bechanged on the control port.  For a list of parameters simply typehelp on the control port.  Files recorded using hackRF, USRP B2X0,or bladeRF hardware are recorded using a sample rate of 15.36MHz.Files recorded with all other hardware are recorded using a samplerate of 1.92MHz.  All files recorded with this application can bescanned with LTE_fdd_dl_file_scan.#############  ENODEB  #############To use the installed C++ eNodeB, make sure LD_LIBRARY_PATH is setto /usr/local/lib (export LD_LIBRARY_PATH=/usr/local/lib), plug inUSRP B2X0 hardware, run LTE_fdd_enodeb, and connect (via telnet, nc,etc) to the control port at port number 30000.  eNodeB parameterscan be changed on the control port.  For a list of parameters simplytype help on the control port.  A MAC and above level PCAP trace isoutput to /tmp/LTE_fdd_enodeb.pcap.  Data packets are routed througha tun device named tun_openlte.  Wireshark can be used to observeIP packets on tun_openlte to inspect the IP traffic to/from UEs. Inorder to configure properly, set the ip_addr_start parameter to thebegining of a non-conflicting private address range (i.e. 10.0.0.1)and set the dns_addr parameter to the primary DNS address listed byyour modem.  All UEs will be assigned IP addresses in the rangeof ip_addr_start to ip_addr_start+254 and all traffic will be tunneledthrough the tun device to the internet using NAT/iptables.NOTES: This application has been tested exclusively at 5MHzbandwidth.  Higher bandwidths are supported and performance mayvary based on processing hardware.WARNINGS: By using this application you risk disruption of service ina public network, even if you are not directly interfering with theradio transmissions.  This is a criminal act in most countries, and amuch more serious offense than a simple violation of radio spectrumregulaions.  It is highly recommended to use this application onlywith antennas and test UEs inside an RF Shielded Enclosure (FaradayCage).#############  OCTAVE  #############To use the octave code, run the top level octave .m files:lte_fdd_dl_transmit.m and lte_fdd_dl_receive.m.  If multipletransmit antennas are used, the outputs need to be combinedbefore input to the receiver.