Commit 4ce62bc3 authored by Sonika Jindal's avatar Sonika Jindal

Add documentation for oaisim

parent 3ba91b75
......@@ -9,10 +9,21 @@ and epc nodes. It is mounted as a clone of a remote blockstore
here, but be aware that your changes will not persist when your
experiment terminates.
To access the UE via ADB, first log in to the `adb-tgt` node, then run
`pnadb -a` to connect to the UE. Use ADB commands as per normal
afterward. If/when you reboot the UE, be aware that you will need to
again run `pnadb -a` to reestablish the ADB connection; wait a minute
This experiment can work in two modes:
1. UE and eNodeB SDR
2. Simulated UE+eNodeB (OAISIM).
To enable OAISIM, select OAI_SIM in the drop down menu "Experiment Type"
while instantiating the experiment. When the experiment starts, two nodes
will be created: sim_enb and epc.
To get the SDR based eNodeB and off-the-shelf UE, select one of the other
two options in the "Experiment Type" based upon the requirements.
When using real UE, to access the UE via ADB, first log in to the `adb-tgt`
node, then run `pnadb -a` to connect to the UE. Use ADB commands as per
normal afterward. If/when you reboot the UE, be aware that you will need
to again run `pnadb -a` to reestablish the ADB connection; wait a minute
or so for the UE to become available again before doing this.
The OAI mobile networking functions should automatically start up when
......
......@@ -47,6 +47,39 @@ Or you can kill a running enb service with:
The enb service should be started last because if it doesn't detect an
mme when it starts, it will never connect.
## Simulated UE+eNB control
When the experiment starts, necessary scripts are started with the required
configurations. You can monitor the logs by attaching to the screen:
sudo screen -r sim_enb
To confirm if UE is connected, ping using the oip1 interface:
ping -I oip1 8.8.8.8
To restart oaisim, use:
sudo /local/repository/bin/config_oai.pl -r SIM_ENB
The code for oaisim can be found in `/opt/oai/openairinterface5g`.
You can build the latest version of the code by using following steps:
cd ~
git clone https://gitlab.eurecom.fr/oai/openairinterface5g.git
cd openairinterface5g
source oaienv
cd cmake_targets
./build_oai -I --oaisim -x --install-system-files
./build_oai --oaisim -c
cd tools
sudo ./run_enb_ue_virt_s1 -c <conf_file>
You can use the config file `/usr/local/etc/oai/enb.conf` and update any
necessary parameters like interfaces, MCC, MNC etc.
Please note that current profile has been tested with the default binaries
and not with other versions of OAI.
## EPC Control
The startup script on the `epc` boots up the hss, mme, and spgw
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment