The srsRAN Project is a complete 5G RAN solution, featuring an ORAN-native CU/DU developed by SRS.

The solution includes a complete L1/2/3 implementation with minimal external dependencies. Portable across processor architectures, the software has been optimized for x86 and ARM. srsRAN follows the 3GPP 5G system architecture implementing the functional splits between distributed unit (DU) and centralized unit (CU). The CU is further disaggregated into control plane (CU-CP) and user-plane (CU-UP).

See the srsRAN Project for information, guides and project news.

Build instructions and user guides - srsRAN Project documentation.

Community announcements and support - Discussion board.

Features and roadmap - Features.

• Build tools:

  • cmake: https://cmake.org/

• Mandatory requirements:

  • libfftw: https://www.fftw.org/
  • libsctp: https://github.com/sctp/lksctp-tools
  • yaml-cpp: https://github.com/jbeder/yaml-cpp
  • mbedTLS: https://www.trustedfirmware.org/projects/mbed-tls/
  • googletest: https://github.com/google/googletest/

You can install the build tools and mandatory requirements for some example distributions with the commands below:

sudo apt-get install cmake make gcc g++ pkg-config libfftw3-dev libmbedtls-dev libsctp-dev libyaml-cpp-dev libgtest-dev

sudo yum install cmake make gcc gcc-c++ fftw-devel lksctp-tools-devel yaml-cpp-devel mbedtls-devel gtest-devel

sudo pacman -S cmake make base-devel fftw mbedtls yaml-cpp lksctp-tools gtest

For Split-8 configurations, either UHD or ZMQ is required for the fronthaul interface. Both drivers are linked below, please see their respective documentation for installation instructions.

• UHD: https://github.com/EttusResearch/uhd
• ZMQ: https://zeromq.org/

For Split-7.2 configurations no extra 3rd-party dependencies are required, only those listed above.

Optionally, DPDK can be installed for high-bandwidth low-latency scenarios. For more information on this, please see this tutorial.

Download and build srsRAN:

    git clone https://github.com/srsRAN/srsRAN_Project.git

    cd srsRAN_Project
    mkdir build
    cd build
    cmake ../ 
    make -j $(nproc)
    make test -j $(nproc)

    sudo make install

git clone https://github.com/srsran/srsRAN_Project.git
cd srsRAN_Project
mkdir build
cd build
cmake ../ -DENABLE_EXPORT=ON -DENABLE_ZEROMQ=ON
make -j $(nproc)
make test -j $(nproc)

...
-- FINDING ZEROMQ.
-- Checking for module 'ZeroMQ'
--   No package 'ZeroMQ' found
-- Found libZEROMQ: /usr/local/include, /usr/local/lib/libzmq.so
...

git clone https://github.com/srsRAN/srsRAN_Project.git

cd srsRAN_Project
mkdir build
cd build
cmake ../ -DENABLE_DPDK=True -DASSERT_LEVEL=MINIMAL
make -j $(nproc)
make test -j $(nproc)

PHY layer tests use binary test vectors and are not built by default. To enable, see the docs.

srsRAN Project can be run in two ways:

• As a monolithic gNB (combined CU & DU)
• With a split CU and DU

For exact details on running srsRAN Project in any configuration, see the documentation.

For information on configuring and running srsRAN for various different use cases, check our tutorials.