Refer to docker/ for the multi container solution
sudo apt-get update
sudo apt-get -y upgrade
sudo apt-get install -y libfftw3-dev libmbedtls-dev libsctp-dev qt5-default libconfig++-dev net-tools nano libtool pkg-config build-essential autoconf automake git python3 python3-distutils python3-pip python3-apt libzmq3-dev python3-zmq software-properties-common
sudo apt-get update
sudo add-apt-repository ppa:gnuradio/gnuradio-releases
sudo apt-get update
sudo apt-get install -y gnuradio xterm python3-gi gobject-introspection gir1.2-gtk-3.0 iputils-ping iproute2 libx11-dev iperf
sudo pip3 install --upgrade pip
sudo pip3 install gym pandas torchvision tensorboard redis debugpy ray gymnasium dm_tree pyarrow typer scikit-image plotly
sudo pip3 install hydra-core==1.1.0
sudo pip3 uninstall -y protobuf
sudo pip3 install protobuf==3.20.*
git clone https://github.com/ucsdwcsng/EdgeRIC-on-5G.git
cd EdgeRIC-on-5G
git checkout srsran
sudo ./make-ran-er.shOfficial documentation: open5gs-quickstart
sudo apt update
sudo apt install gnupg
curl -fsSL https://pgp.mongodb.com/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg --dearmor
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
sudo apt update
sudo apt install -y mongodb-org
sudo systemctl start mongod
sudo systemctl enable mongod
sudo add-apt-repository ppa:open5gs/latest
sudo apt update
sudo apt install open5gs
# Install webui
sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
# Create deb repository
NODE_MAJOR=20
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
# Run Update and Install webui
sudo apt update
sudo apt install nodejs -y
curl -fsSL https://open5gs.org/open5gs/assets/webui/install | sudo -E bash -Run the following commands:
$ sudo systemctl restart open5gs-mmed
$ sudo systemctl restart open5gs-sgwcd
$ sudo systemctl restart open5gs-smfd
$ sudo systemctl restart open5gs-amfd
$ sudo systemctl restart open5gs-sgwud
$ sudo systemctl restart open5gs-upfd
$ sudo systemctl restart open5gs-hssd
$ sudo systemctl restart open5gs-pcrfd
$ sudo systemctl restart open5gs-nrfd
$ sudo systemctl restart open5gs-scpd
$ sudo systemctl restart open5gs-seppd
$ sudo systemctl restart open5gs-ausfd
$ sudo systemctl restart open5gs-udmd
$ sudo systemctl restart open5gs-pcfd
$ sudo systemctl restart open5gs-nssfd
$ sudo systemctl restart open5gs-bsfd
$ sudo systemctl restart open5gs-udrd
$ sudo systemctl restart open5gs-webuihow to know open5gs is installed?
Run ps aux | grep open5gs --> this will show 16 active processes
Where are open5gs configs located?
~/etc/open5gs --> folder contains all config files as .yaml --> to write, you need to change permission --> sudo chmod a+w ~/etc/open5gs/
This repository contains all the open5gs configs used in folder open5gs
How to update UE data base on open5gs core network?
http://localhost:9999 --> username: admin, password: 1423, add all UE sim credentials, press Add a subscriber
Make sure you have UHD installed
Run the srsRAN
sudo ./run_gnb_ota.shRun User Equipments (srsue) with USRP
Update the UE config files, update [rf] section with the following, refer here:
device_name = uhd
device_args = ip_addr_of_sdr
GNU flowgraph - (Terminal 1)
Run the GNU radio flowgraph - for two UEs run:
python3 2ue-zmq-mode-23.04Mhz.pyRun the GNU radio flowgraph - for four UEs run:
python3 4ue-zmq-mode-23.04Mhz.pyRun the srsRAN - (Terminal 2)
sudo ./run_gnb_multi_ue.shPress t to see the network metrics
Run User Equipments (srsue) in zmq mode - - (Terminal 3)
For two UEs, you can run the script:
sudo ./run2ue-zmq-mode.shFor four UEs, you can run the script:
sudo ./run4ue-zmq-mode.shYou can also run the UEs in separate terminals
(Terminal 4)
cd traffic-generator
sudo ./iperf_server_2ues.sh(Terminal 5)
cd traffic-generator
sudo ./iperf_client_2ues.sh 13M 13M 1000Refer to edgeric-v2 for documentation
Refer to srsRAN-5G-ER for documentation of the rt-agent
Installations_and_setup.md --> contains documentation on how to setup the network
debugging_and_log_files.md --> contains documentation on necessary files needed to debug you network connectivity
/open5gs --> All open5gs configs
Configs below are for a 10MHz BW system, 20MHz settings are also available as comments
/srs-4G-UE/.config/ue-4g-zmq.conf --> config file to run 1 srsue in zmq mode, check section [usim] and appropriately add those credentials in the open5gs webui database
/srs-4G-UE/.config/ue1-4g-zmq.conf --> config file for UE1 in multi UE zmq mode, check section [usim] and appropriately add those credentials in the open5gs webui database
/srs-4G-UE/.config/ue2-4g-zmq.conf --> config file for UE2 in multi UE zmq mode, check section [usim] and appropriately add those credentials in the open5gs webui database
/srs-4G-UE/.config/ue3-4g-zmq.conf --> config file for UE3 in multi UE zmq mode, check section [usim] and appropriately add those credentials in the open5gs webui database
/srs-4G-UE/.config/ue4-4g-zmq.conf --> config file for UE4 in multi UE zmq mode, check section [usim] and appropriately add those credentials in the open5gs webui database
/srsRAN-5G-ER/configs/n320-ota-amarisoft.yml --> run srsgnb in Over the air mode with usrp N320, in section cell_cfg you can change the band and bandwidth of operation
/srsRAN-5G-ER/configs/zmq-mode.yml --> run srsgnb in zmq mode with 1 srsue
/srsRAN-5G-ER/configs/zmq-mode-multi-ue.yml --> run srsgnb in zmq mode for multiple UEs
For a full set of allowed configs from srsRAN, refer here