# LTE Cell Tools

The latest version of this document is available online.

## Introduction

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. In fact, since the LTE downlink center frequencies are accurate to within 0.050 PPM, this program can be used to calibrate the receiver's oscillator.

Included executables:

- CellSearch is a tool that will scan a set of frequencies and identify LTE carriers. It also decodes the MIB.
- LTE-Tracker is a realtime tool that continuously identifies and tracks all the LTE cells on a particular frequency.

This code was developed on an Ubuntu 12.04 system. It has also been made to work on Ubuntu 10.04

To report any bugs, contact James Peroulas <james@evrytania.com>, or use the bugtracker on github.

## Obtaining the code

Using git:

`git clone git://github.com/Evrytania/LTE-Cell-Scanner.git`

ZIP file:

`https://github.com/Evrytania/Matlab-Library/zipball/master`

## Required libraries

The following libraries are required to compile and run these programs:

- Boost
- ITPP
- rtlsdr
- fftw

## Compile

    cd LTE-Cell-Scanner
    mkdir build
    cd build
    cmake ..
    make

## Install

`sudo make install`

## Un-Install

`sudo make uninstall`

## Related links:

- OpenLTE