You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

211 lines
7.3 KiB
Markdown

10 years ago
srsLTE
11 years ago
========
[![Coverity Scan Build Status](https://scan.coverity.com/projects/10045/badge.svg)](https://scan.coverity.com/projects/10045)
srsLTE is a free and open-source LTE software suite developed by SRS (www.softwareradiosystems.com).
It includes:
* srsUE - a complete SDR LTE UE application featuring all layers from PHY to IP
* srsENB - a complete SDR LTE eNodeB application
7 years ago
* 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.
8 years ago
srsLTE is released under the AGPLv3 license and uses software from the OpenLTE project (http://sourceforge.net/projects/openlte) for some security functions and for RRC/NAS message parsing.
10 years ago
8 years ago
Common Features
---------------
9 years ago
7 years ago
* LTE Release 8 compliant (with selected features of Release 9)
10 years ago
* FDD configuration
9 years ago
* Tested bandwidths: 1.4, 3, 5, 10, 15 and 20 MHz
7 years ago
* Transmission mode 1 (single antenna), 2 (transmit diversity), 3 (CCD) and 4 (closed-loop spatial multiplexing)
9 years ago
* Frequency-based ZF and MMSE equalizer
7 years ago
* Evolved multimedia broadcast and multicast service (eMBMS)
7 years ago
* Highly optimized Turbo Decoder available in Intel SSE4.1/AVX2 (+100 Mbps) and standard C (+25 Mbps)
8 years ago
* 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
srsUE Features
--------------
* Cell search and synchronization procedure for the UE
* Soft USIM supporting Milenage and XOR authentication
* Virtual network interface *tun_srsue* created upon network attach
7 years ago
* +100 Mbps DL in 20 MHz MIMO TM4 configuration in i7 Quad-Core CPU.
8 years ago
* 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.
8 years ago
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
---------------
* Round Robin MAC scheduler with FAPI-like C++ API
8 years ago
* SR support
* Periodic and Aperiodic CQI feedback support
8 years ago
* Standard S1AP and GTP-U interfaces to the Core Network
7 years ago
* 150 Mbps DL in 20 MHz MIMO TM4 with commercial UEs
* 75 Mbps DL in SISO configuration with commercial UEs
8 years ago
srsENB has been tested and validated with the following handsets:
* LG Nexus 5
8 years ago
* LG Nexus 4
8 years ago
* Motorola Moto G4 plus
7 years ago
* Huawei P9/P9lite
* Huawei dongles: E3276 and E398
10 years ago
7 years ago
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
11 years ago
Hardware
8 years ago
--------
11 years ago
9 years ago
The library currently supports the Ettus Universal Hardware Driver (UHD) and the bladeRF driver. Thus, any hardware supported by UHD or bladeRF 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.
11 years ago
9 years ago
We have tested the following hardware:
* USRP B210
* USRP X300
* bladeRF
7 years ago
* limeSDR (currently, only the PHY-layer examples, i.e., pdsch_enodeb/ue are supported)
9 years ago
8 years ago
Build Instructions
------------------
11 years ago
* Mandatory requirements:
8 years ago
* Common:
7 years ago
* cmake https://cmake.org/
8 years ago
* libfftw http://www.fftw.org/
* PolarSSL/mbedTLS https://tls.mbed.org
* srsUE:
* Boost: http://www.boost.org
* srsENB:
* Boost: http://www.boost.org
* lksctp: http://lksctp.sourceforge.net/
* config: http://www.hyperrealm.com/libconfig/
7 years ago
* srsEPC:
* Boost: http://www.boost.org
* lksctp: http://lksctp.sourceforge.net/
* config: http://www.hyperrealm.com/libconfig/
8 years ago
For example, on Ubuntu 17.04, one can install the required libraries with:
```
7 years ago
sudo apt-get install cmake libfftw3-dev libmbedtls-dev libboost-program-options-dev libboost-thread-dev libconfig++-dev libsctp-dev
```
Note that depending on your flavor and version of Linux, the actual package names may be different.
10 years ago
* Optional requirements:
8 years ago
* srsgui: https://github.com/srslte/srsgui - for real-time plotting.
10 years ago
* RF front-end driver:
* UHD: https://github.com/EttusResearch/uhd
* BladeRF: https://github.com/Nuand/bladeRF
10 years ago
Download and build srsLTE:
11 years ago
```
10 years ago
git clone https://github.com/srsLTE/srsLTE.git
cd srsLTE
11 years ago
mkdir build
cd build
cmake ../
7 years ago
make
make test
11 years ago
```
8 years ago
The software suite can also be installed using the command ```sudo make install```.
10 years ago
8 years ago
Execution Instructions
----------------------
11 years ago
7 years ago
The srsUE, srsENB and srsEPC applications include example configuration files
that should be copied and modified, if needed, to meet the system configuration.
On many systems they should work out of the box.
11 years ago
7 years ago
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.
7 years ago
Also note that when you run the applications that all additional configuration files,
7 years ago
for example the UE database file needed by srsEPC, reside in your current working directory.
If that is not the case, you may need to specify the location of those files as
7 years ago
command line arguments, for example using the --hss.db_file parameter in srsEPC.
7 years ago
7 years ago
srsENB and srsEPC can run on the same machine as a network-in-the-box configuration.
srsUE needs to run on a separate machine.
7 years ago
If you have installed the software suite using ```sudo make install```, you may just
change in the source directory and start the applications as follows.
### srsEPC
On machine 1, change back to the source directory and copy the srsEPC
config example and UE database file.
```
cd ..
cp srsepc/epc.conf.example srsepc/epc.conf
cp srsepc/user_db.csv.example srsepc/user_db.csv
```
11 years ago
7 years ago
Now, run srsEPC with the default configuration as follows:
11 years ago
```
7 years ago
sudo srsepc srsepc/epc.conf
11 years ago
```
8 years ago
### srsENB
10 years ago
7 years ago
On machine 1, but in another console, change back to the source directory
and copy the main srsENB config example as well as all additional config files for RR, SIB and DRB.
```
cd ..
cp srsenb/enb.conf.example srsenb/enb.conf
cp srsenb/rr.conf.example srsenb/rr.conf
cp srsenb/sib.conf.example srsenb/sib.conf
cp srsenb/drb.conf.example srsenb/drb.conf
```
Now, run the application as follows:
```
sudo srsenb srsenb/enb.conf
```
### srsUE
7 years ago
On machine 2, after having following the installation instructions above,
7 years ago
change back to the source directory and copy the srsUE example configuration:
10 years ago
```
7 years ago
cd ..
cp srsue/ue.conf.example srsue/ue.conf
10 years ago
```
7 years ago
Now run the srsUE application as follows:
```
sudo srsue srsue/ue.conf
```
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 172.16.0.2, you may now exchange
7 years ago
IP traffic with machine 1 over the LTE link. For example, run a ping to
7 years ago
the default SGi IP address:
```
ping 172.16.0.1
```
11 years ago
Support
========
10 years ago
Mailing list: http://www.softwareradiosystems.com/mailman/listinfo/srslte-users