Go to file

ismagom ee4c80d340 Fixed merge conflicts with ismagom fork		2015-01-21 07:55:40 +00:00
cmake/modules	Fix for building without VOLK	2015-01-20 19:58:43 +00:00
common	General cleanup - moving prach code to phch folder, moving common ret vals to config.h, renamed phy_common files	2014-06-26 12:13:05 +01:00
cuhd	PDSCH Video demo working	2015-01-14 18:16:35 -08:00
graphics	Added waterfall plot to pdsch_ue	2015-01-11 22:24:54 -04:00
lte	Fixed merge conflicts with ismagom fork	2015-01-21 07:55:40 +00:00
matlab	PDSCH CB segmentation computation used erroneous CB length	2015-01-20 18:41:20 +00:00
mex	PDSCH Video demo working	2015-01-14 18:16:35 -08:00
scripts	Replacing tabs with spaces	2014-06-17 10:11:41 +01:00
CMakeLists.txt	Adding explicit paths to rrc asn headers	2015-01-08 14:03:30 +00:00
COPYRIGHT	All tests completed	2014-03-15 01:04:21 +00:00
CTestConfig.cmake	Using CTest for testing	2014-03-08 11:46:19 +00:00
CTestCustom.cmake.in	Added scrambling, ratematching and layer mapping tests	2014-03-11 13:42:51 -05:00
LICENSE	Initial commit	2014-01-28 11:41:17 +00:00
README.md	Update README.md	2015-01-20 20:01:05 +00:00
cmake_uninstall.cmake.in	Reorganized the directory structure. Added Graphics support. Added precoding/layer mapper. MIB detection now working with 1 or 2 tx antennas. Initial eNodeB implementation with PSS/SSS and PBCH generation	2014-03-03 19:09:26 +00:00
pbch_capture.png	PBCH example capture	2014-03-08 12:25:07 +00:00

README.md

libLTE

libLTE is a free and open-source LTE library for SDR UE and eNodeB. The library does not rely on any external dependencies or frameworks.

The license is LGPLv3.

The project contains a set of Python tools for the automatic code generation of modules for popular SDR frameworks, including GNURadio, ALOE++, IRIS, and OSSIE. These tools are easy to use and adapt for generating targets for specific platforms or frameworks.

Current Status

The following parts are available:

Physical Channels: PBCH, PCFICH, PDCCH, PHICH, PDSCH eNodeB and UE side
Synchronization and CFO estimation/correction
Equalization
UE receiver (MIB + SIB1 decoding) verified with live LTE signals

Hardware

The library currently uses Ettus Universal Hardware Driver (UHD). Thus, any hardware supported by UHD can be used. There is no sampling rate conversion, therefore the hardware should support 30.72 MHz clock in order to work correctly with LTE sampling frequencies and decode signals from live LTE base stations. We are using the B210 USRP.

Download & Install Instructions

Requirements: Currently, the library requires libfftw, although we plan make this dependency optional in the future. Also, QT4 and Qwt6 are needed for graphics visualization. Compilation is possible without QT4, although graphics will be disabled.

To install QT4, Qwt6 and libfftw use your distribution packet management system, for instance in ubuntu you can run: sudo apt-get install libfftw3-dev libqwt-dev libqt4-dev to install all requirements.

Finally, to download and build libLTE, just run:

git clone https://github.com/ismagom/libLTE.git
cd libLTE
mkdir build
cd build
cmake ../
make

The library can also be installed using the command sudo make install.

PHY Examples

eNodeB and UE PBCH example

Setup one or two computers connected to two USRP or UHD-compatible hardware. From the eNodeB, type

lte/phy/examples/pdsch_enodeb -f [frequency_in_Hz] -c [cell_id] [-a [UHD args]] [-h for more commands]

From the UE, type

lte/phy/examples/pdsch_ue -f [frequency_in_Hz] [-a [UHD args]] [-h for more commands]

And the output should look something like the following video. In this example, we removed the transmitter and receiver antennas in the middle of the demonstration, showing how reception is still possible (despite with some erros).

https://www.dropbox.com/s/txh1nuzdb0igq5n/demo_pbch.ogv

The SIB1 message is decoded and shown on the console, for example:

Decoded SIB1 Message: [40 48 50 03 02 0b 14 4a 30 18 28 20 90 81 84 79 a0 00 ];

Support

Mailing list: https://lists.sourceforge.net/lists/listinfo/liblte-users