Open source SDR 4G/5G software suite with extNAS/RRCTL support (forked from
Go to file
Dillon Amburgey 6fc2562ca1 Include current time in EMM information 2020-10-16 12:23:59 +02:00
.github gh_actions: enable gcc and clang builds, disable parallel ctest for x86 2020-05-09 12:28:45 +02:00
cmake/modules Merge branch 'master' into next_merge_from_master2 2020-10-07 15:50:17 +02:00
debian Copy copyright modifications into debian/copyright. 2020-10-09 12:51:50 +01:00
lib Remove redundant declaration of EIA2 2020-10-16 11:11:51 +01:00
srsenb enb.conf.example: add comment about device args for 75 PRB cells 2020-10-16 11:57:00 +02:00
srsepc Include current time in EMM information 2020-10-16 12:23:59 +02:00
srsue proc_bsr: improve BSR logging to print name of triggered BSR instead of enum 2020-10-16 09:16:54 +02:00
test run_lte: fix UE/eNB args 2020-09-03 18:28:49 +02:00
.clang-format revert clang-format change 2020-05-12 14:17:57 +01:00
.clang-tidy added for-range loop and bool decay checks to clang-tidy. Applied some of the recommendations of clang-tidy to 2019-10-18 12:36:17 +02:00
.lgtm.yml add basic lgtm config 2019-12-16 12:49:07 +01:00
.travis.yml travis: add missing and optional build dependencies 2020-04-30 13:38:44 +02:00
CHANGELOG add tentative changelog for 20.10 release 2020-10-07 15:38:57 +02:00
CMakeLists.txt - Fix compiler errors when trying to build the project without SIMD support. 2020-09-02 12:35:18 +02:00
COPYRIGHT Restructure of included third-party copyright details 2020-10-07 15:50:08 +01:00
CTestConfig.cmake let valgrind fail when test app returns 0 but valgrind still found an error 2019-02-08 22:37:51 +01:00 SRSUE: avoid testing ue_phy_test 2019-12-23 22:57:37 +01:00
LICENSE move license info for pcsc class from LICENSE to COPYRIGHT file 2020-10-07 15:43:44 +02:00 update readme install instructions and features 2020-06-30 14:28:00 +02:00 Adding custom build target to build osmo-gsm-tester trial 2020-04-15 13:41:57 +02:00 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 fix typo in clang-format helper script 2020-07-15 10:41:56 +02:00


Build Status Language grade: C/C++ Coverity

srsLTE is a free and open-source LTE software suite developed by SRS ( See the srsLTE project pages ( for documentation, guides and project news.

It includes:

  • srsUE - a complete SDR LTE UE application featuring all layers from PHY to IP
  • srsENB - a complete SDR LTE eNodeB application
  • srsEPC - a light-weight LTE core network implementation with MME, HSS and S/P-GW
  • a highly modular set of common libraries for PHY, MAC, RLC, PDCP, RRC, NAS, S1AP and GW layers.

srsLTE is released under the AGPLv3 license and uses software from the OpenLTE project ( for some security functions and for NAS message parsing.

Common Features

  • LTE Release 10 aligned
  • Tested bandwidths: 1.4, 3, 5, 10, 15 and 20 MHz
  • Transmission mode 1 (single antenna), 2 (transmit diversity), 3 (CCD) and 4 (closed-loop spatial multiplexing)
  • Carrier Aggregation support
  • Frequency-based ZF and MMSE equalizer
  • Evolved multimedia broadcast and multicast service (eMBMS)
  • Highly optimized Turbo Decoder available in Intel SSE4.1/AVX2 (+150 Mbps)
  • MAC, RLC, PDCP, RRC, NAS, S1AP and GW layers
  • Detailed log system with per-layer log levels and hex dumps
  • MAC layer Wireshark packet capture
  • Command-line trace metrics
  • Detailed input configuration files
  • Channel simulator for EPA, EVA, and ETU 3GPP channels
  • ZeroMQ-based fake RF driver for I/Q over IPC/network

srsUE Features

  • FDD and TDD configuration
  • Cell search and synchronization procedure for the UE
  • Soft USIM supporting Milenage and XOR authentication
  • Hard USIM support using PCSC framework
  • Virtual network interface tun_srsue created upon network attach
  • QoS support
  • 150 Mbps DL in 20 MHz MIMO TM3/TM4 configuration in i7 Quad-Core CPU.
  • 75 Mbps DL in 20 MHz SISO configuration in i7 Quad-Core CPU.
  • 36 Mbps DL in 10 MHz SISO configuration in i5 Dual-Core CPU.

srsUE has been fully tested and validated with the following network equipment:

  • Amarisoft LTE100 eNodeB and EPC
  • Nokia FlexiRadio family FSMF system module with 1800MHz FHED radio module and TravelHawk EPC simulator
  • Huawei DBS3900
  • Octasic Flexicell LTE-FDD NIB

srsENB Features

  • FDD configuration
  • Round Robin MAC scheduler with FAPI-like C++ API
  • SR support
  • Periodic and Aperiodic CQI feedback support
  • Standard S1AP and GTP-U interfaces to the Core Network
  • 150 Mbps DL in 20 MHz MIMO TM3/TM4 with commercial UEs
  • 75 Mbps DL in SISO configuration with commercial UEs
  • 50 Mbps UL in 20 MHz with commercial UEs
  • User-plane encryption

srsENB has been tested and validated with the following handsets:

  • LG Nexus 5 and 4
  • Motorola Moto G4 plus and G5
  • Huawei P9/P9lite, P10/P10lite, P20/P20lite
  • Huawei dongles: E3276 and E398

srsEPC Features

  • Single binary, light-weight LTE EPC implementation with:
    • MME (Mobility Management Entity) with standard S1AP and GTP-U interface to eNB
    • S/P-GW with standard SGi exposed as virtual network interface (TUN device)
    • HSS (Home Subscriber Server) with configurable user database in CSV format
  • Support for paging


srsLTE has native support for the Ettus Universal Hardware Driver (UHD) and the bladeRF driver. We also support SoapySDR. Thus, any hardware supported by SoapySDR 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 have tested the following hardware:

  • USRP B2x0
  • USRP B205mini
  • USRP X3x0
  • LimeSDR
  • bladeRF

For Ettus Research equipment we recommended the LTS version of UHD, i.e. either 3.9.7 or 3.15.

Build Instructions

For example, on Ubuntu, one can install the mandatory build dependencies with:

sudo apt-get install cmake libfftw3-dev libmbedtls-dev libboost-program-options-dev libconfig++-dev libsctp-dev

or on Fedora:

dnf install cmake fftw3-devel mbedtls-devel lksctp-tools-devel libconfig-devel boost-devel

For CentOS, use the Fedora packages but replace libconfig-devel with just libconfig.

Note that depending on your flavor and version of Linux, the actual package names may be different.

Download and build srsLTE:

git clone
cd srsLTE
mkdir build
cd build
cmake ../
make test

Install srsLTE:

sudo make install user

This installs srsLTE and also copies the default srsLTE config files to the user's home directory (~/.config/srslte).

Execution Instructions

The srsUE, srsENB and srsEPC applications include example configuration files that should be copied (manually or by using the convenience script) and modified, if needed, to meet the system configuration. On many systems they should work out of the box.

By default, all applications will search for config files in the user's home directory (~/.config/srslte) upon startup.

Note that you have to execute the applications with root privileges to enable real-time thread priorities and to permit creation of virtual network interfaces.

srsENB and srsEPC can run on the same machine as a network-in-the-box configuration. srsUE needs to run on a separate machine.

If you have installed the software suite using sudo make install and have installed the example config files using user, you may just start all applications with their default parameters.


On machine 1, run srsEPC as follows:

sudo srsepc

Using the default configuration, this creates a virtual network interface named "srs_spgw_sgi" on machine 1 with IP All connected UEs will be assigned an IP in this network.


Also on machine 1, but in another console, run srsENB as follows:

sudo srsenb


On machine 2, run srsUE as follows:

sudo srsue

Using the default configuration, this creates a virtual network interface named "tun_srsue" on machine 2 with an IP in the network 172.16.0.x. Assuming the UE has been assigned IP, you may now exchange IP traffic with machine 1 over the LTE link. For example, run a ping to the default SGi IP address:



Mailing list: