From caa5c8c5e1a1cfbac0568187432c4dd727e29505 Mon Sep 17 00:00:00 2001 From: Paul Sutton Date: Thu, 8 Jun 2017 16:22:56 +0100 Subject: [PATCH 1/3] Updating readme --- README.md | 138 +++++++++++++++++++++++++++--------------------------- 1 file changed, 69 insertions(+), 69 deletions(-) diff --git a/README.md b/README.md index 0423f3dc2..c5d7d3787 100644 --- a/README.md +++ b/README.md @@ -3,31 +3,56 @@ srsLTE [![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 library for SDR UE and eNodeB developed by SRS (www.softwareradiosystems.com). The library is highly modular with minimum inter-module or external dependencies. It is entirely written in C and, if available in the system, uses the acceleration library VOLK distributed in GNURadio. +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 and 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 (http://sourceforge.net/projects/openlte) for some security functions and for RRC/NAS message parsing. -**srsLTE is used by srsUE, a full stack (PHY to IP) implementation of an LTE UE. srsUE is available at https://github.com/srslte/srsue** +Common Features +--------------- - -The srsLTE software license is AGPLv3. - -Current Features: * LTE Release 8 compliant * FDD configuration * Tested bandwidths: 1.4, 3, 5, 10, 15 and 20 MHz * Transmission mode 1 (single antenna) and 2 (transmit diversity) - * Cell search and synchronization procedure for the UE - * All DL channels/signals are supported for UE and eNodeB side: PSS, SSS, PBCH, PCFICH, PHICH, PDCCH, PDSCH - * All UL channels/signals are supported for UE side: PRACH, PUSCH, PUCCH, SRS * Frequency-based ZF and MMSE equalizer * Highly optimized Turbo Decoder available in Intel SSE4.1/AVX (+100 Mbps) and standard C (+25 Mbps) - * UE receiver tested and verified with Amarisoft LTE 100 eNodeB and commercial LTE networks (Telefonica Spain, Three.ie and Eircom in Ireland) + * 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 -Missing Features: - * Closed-loop power control - * Semi-Persistent Scheduling +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 + * Above 60 Mbps DL in SISO configuration. + +### Compatibility + +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 + * PUCCH Format1 and Format1A receiver + * Standard S1AP and GTP-U interfaces to the Core Network + * Tested up to 75 Mbps DL in SISO configuration with commercial UEs + +### Compatibility + +srsENB has been tested and validated with the following handsets: + * LG Nexus 5 + * Motorola Moto G4 plus Hardware -======== +-------- 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. @@ -36,14 +61,26 @@ We have tested the following hardware: * USRP X300 * bladeRF -Download & Install Instructions -================================= +Build Instructions +------------------ * Mandatory dependencies: - * libfftw + * Common: + * 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/ + +* RF front-end driver: + * UHD: https://github.com/EttusResearch/uhd + * BladeRF: https://github.com/Nuand/bladeRF + * Optional requirements: - * srsgui: for real-time plotting. Download it here: https://github.com/srslte/srsgui - * VOLK: if the VOLK library and headers are detected, they will be used for accelerating some signal processing functions. + * srsgui: https://github.com/srslte/srsgui - for real-time plotting. + * VOLK: https://github.com/gnuradio/volk - if the VOLK library and headers are detected, they will be used to accelerate some signal processing functions. Download and build srsLTE: ``` @@ -55,64 +92,27 @@ cmake ../ make ``` -The library can also be installed using the command ```sudo make install```. +The software suite can also be installed using the command ```sudo make install```. -Running srsLTE Examples -======================== +Execution Instructions +---------------------- -* SIB1 reception and UE measurement from commercial LTE networks: +The srsUE and srsENB applications include example configuration files. Execute the applications with root privileges to enable real-time thread priorities and to permit creation of virtual network interfaces. + +### srsUE + +Run the srsUE application as follows: ``` -lte/examples/pdsch_ue -f [frequency_in_Hz] -``` -Where -f is the LTE channel frequency. - -* eNodeB to UE Downlink PHY test - -You will need two computers, each equipped with a USRP. At the transmitter side, run: - -``` -lte/examples/pdsch_enodeb -f [frequency_in_Hz] [-h for more commands] +sudo ./srsue ue.conf ``` -At the receiver run: +### srsENB + +As the srsLTE software suite does not include EPC functionality, a separate EPC is required to run srsENB. Run the application as follows: ``` -lte/examples/pdsch_ue -r 1234 -f [frequency_in_Hz] +sudo ./srsenb enb.conf ``` -At the transmitter console, it is possible to change the Modulation and Coding Scheme (MCS) by typing a new number (between 0 and 28) and pressing Enter. - - -The output at the receiver should look something similar to 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 - -![Screenshopt of the PBCH example output](pbch_capture.png "Screenshopt of the PBCH example output") - -* Video over Downlink PHY (eNodeB to UE) - -The previous example sends random bits to the UE. It is possible to open a TCP socket and stream video over the LTE PHY DL wireless connection. At the transmitter side, run the following command: - -``` -lte/examples/pdsch_enodeb -f [frequency_in_Hz] -u 2000 [-h for more commands] -``` - -The argument -u 2000 will open port 2000 for listening for TCP connections. Set a high-order MCS, like 16 by typing 16 in the eNodeB console and pressing Enter. - -``` -lte/examples/pdsch_ue -r 1234 -u 2001 -U 127.0.0.1 -f [frequency_in_Hz] -``` - -The arguments -u 2001 -U 127.0.0.1 will forward the data that was injected at the eNodeB to address:port indicated by the argument. Once you have the system running, you can transmit some useful data, like a video stream. At the transmitter side, run: - -``` -avconv -f video4linux2 -i /dev/video0 -c:v mp4 -f mpegts tcp://127.0.0.1:2000 -``` -to stream the video captured from the webcam throught the local host port 2000. At the receiver, run: - -``` -avplay tcp://127.0.0.1:2001?listen -analyzeduration 100 -loglevel verbose -``` -to watch the video. Support ======== From 8088530ab933c7f1b801726c5886662828c374ab Mon Sep 17 00:00:00 2001 From: Paul Sutton Date: Thu, 8 Jun 2017 16:29:04 +0100 Subject: [PATCH 2/3] Minor readme update --- README.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index c5d7d3787..81ea89107 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,13 @@ srsLTE [![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 and a highly modular set of common libraries for PHY, MAC, RLC, PDCP, RRC, NAS, S1AP and GW layers. +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 + * 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 (http://sourceforge.net/projects/openlte) for some security functions and for RRC/NAS message parsing. Common Features @@ -64,7 +70,7 @@ We have tested the following hardware: Build Instructions ------------------ -* Mandatory dependencies: +* Mandatory requirements: * Common: * libfftw http://www.fftw.org/ * PolarSSL/mbedTLS https://tls.mbed.org @@ -74,14 +80,14 @@ Build Instructions * Boost: http://www.boost.org * lksctp: http://lksctp.sourceforge.net/ -* RF front-end driver: - * UHD: https://github.com/EttusResearch/uhd - * BladeRF: https://github.com/Nuand/bladeRF - * Optional requirements: * srsgui: https://github.com/srslte/srsgui - for real-time plotting. * VOLK: https://github.com/gnuradio/volk - if the VOLK library and headers are detected, they will be used to accelerate some signal processing functions. +* RF front-end driver: + * UHD: https://github.com/EttusResearch/uhd + * BladeRF: https://github.com/Nuand/bladeRF + Download and build srsLTE: ``` git clone https://github.com/srsLTE/srsLTE.git From 2acb1a170df84d6f8cae9d21b5d001ae4012e896 Mon Sep 17 00:00:00 2001 From: Paul Sutton Date: Thu, 8 Jun 2017 16:30:24 +0100 Subject: [PATCH 3/3] Minor readme update --- README.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/README.md b/README.md index 81ea89107..2561f4e85 100644 --- a/README.md +++ b/README.md @@ -35,8 +35,6 @@ srsUE Features * Virtual network interface *tun_srsue* created upon network attach * Above 60 Mbps DL in SISO configuration. -### Compatibility - 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 @@ -51,8 +49,6 @@ srsENB Features * Standard S1AP and GTP-U interfaces to the Core Network * Tested up to 75 Mbps DL in SISO configuration with commercial UEs -### Compatibility - srsENB has been tested and validated with the following handsets: * LG Nexus 5 * Motorola Moto G4 plus