README

CRITICAL PROBLEM: forked from Evrytania/LTE-Cell-Scanner (unsupported for the last 4 years). I need to pull https://github.com/JiaoXianjun/LTE-Cell-Scanner instead

# All testing is performed against the following configuration:
* ubuntu 16.04 LTS

# setup
sudo apt install cmake libitpp-dev libblas-dev librtlsdr-dev libncurses5-dev liblapack-dev -y # create an issue if you identify more

--------------------------
LTE Cell Scanner / Tracker
--------------------------

This is a collection of tools to locate and track LTE basestation cells using
very low performance RF front ends. For example, these tools work with RTL2832
based dongles (E4000, R820T, etc.) which have a noise figure of 20dB, only 8
bits in the A/D, and a crystal with a frequency error of about 100 ppm.

The 'CellSearch' program can be used to search for LTE carriers within a range
of frequencies.  Once an LTE frequency has been located, 'LTE-Tracker' can be
used to monitor and track, in realtime, any LTE cells on that frequency.

The main documentation in html format can be found on the web at:
  http://www.evrytania.com/lte-tools
And in the doc/index.html subdirectory of this distribution.

For questions, comments, or bug reports, check the bugtracker on github:
  https://github.com/lucasduffey/LTE-Cell-Scanner/issues

------
Quick build instructions:
------
  cd LTE-Cell-Scanner
  gtags . # make dev work easier
  mkdir build
  cd build
  cmake ..
  make -j8 # reduce to troubleshoot

------
Install:
------
  sudo make install

------
Quick usage instructions:
------
LTE band info: http://www.radio-electronics.com/info/cellulartelecomms/lte-long-term-evolution/lte-frequency-spectrum.php

Search for LTE carriers within a common LTE frequency range used in the US:
  CellSearch --freq-start 715e6 --freq-end 768e6

Start tracking LTE cells on frequency 739 MHz:
  LTE-Tracker -f 739000000