How To Start a simple OAI Simulaton

How To Start a simple OAI Simulaton

When you are a beginner of OAI, you can follow this page to start a simple OAI simulation. Since OAI gives us an Autorun shell recently, the whole process is not so complicated anymore.

1.Checkout the latest source

mkdir openair4G 
svn co http://svn.eurecom.fr/openair4G/trunk openair4G

===================================================================

wjn@wjn-Inspiron-N4010:~/Simulator/OAI/openair4G/trunk$ ls

cmake_targets  COPYING   oaienv    openair2  openair-cn  README.txt

common         maketags  openair1  openair3  openairITS  targets

wjn@wjn-Inspiron-N4010:~/Simulator/OAI/openair4G/trunk$ svn info

Path: .

Working Copy Root Path: /home/wjn/Simulator/OAI/openair4G

URL: http://svn.eurecom.fr/openair4G/trunk

Relative URL: ^/trunk

Repository Root: http://svn.eurecom.fr/openair4G

Repository UUID: 818b1a75-f10b-46b9-bf7c-635c3b92a50f

Revision: 6865

Node Kind: directory

Schedule: normal

Last Changed Author: gauthier

Last Changed Rev: 6854

Last Changed Date: 2015-03-19 11:44:16 -0400 (四, 19  3月 2015)

================================================================

2.Set the Env for OAI

Edit the ~/.bashrc file, add following lines:

export OPENAIR_HOME=path_to_openair_dir --> You need to set your's

export OPENAIR1_DIR=$OPENAIR_HOME/openair1

export OPENAIR2_DIR=$OPENAIR_HOME/openair2

export OPENAIR3_DIR=$OPENAIR_HOME/openair3

export OPENAIR_TARGETS=$OPENAIR_HOME/targets

export OPENAIRCN_DIR=$OPENAIR_HOME/openair-cn

3.Run the auto shell

Under the dir $OPENAIR_HOME/targets/ , run the build_oai.sh, which will install all the depended libraries and softwares,

-h will list all the available options:

=============================================

wjn@wjn-Inspiron-N4010:~/Simulator/OAI/openair4G/trunk/targets$ ./build_oai.bash -h
Run as a sudoers
Name : build_oai  - install and build OAI
Usage: build_oai.bash -a -b -c -d -e RTAI -m -r REL8 -s -t OAISIM -w EXMIMO -x
-a | --doxygen                          : Enable doxygen for documentation (default disabled)
-b | --disable-s1                       : Disable S1 interface for eNB (default enabled)
-c | --clean                            : Enable clean OAI build (default disabled)
-C | --config-file                      : Set the config file local path
-d | --debug                            : Enable debug mode (default disabled)
-D | --disable-check-installed-software : Disable the checking of installed software (default is check)
-e | --realtime                         : Set realtime mode: RTAI, NONE (default NONE)
-g | --run-with-gdb                     : Run the executable built by this script with gdb
-K | --itti-dump-file                   : Set the execution events trace file
-l | --build-target                     : Set the LTE build target: ENB,EPC,HSS,NONE (default ENB)
-m | --build-from-makefile              : Enable build from the makefile (default disabled)
-r | --3gpp-release                     : Set the release: REL8, REL10 (default REL8)
-R | --run                              : Run the executable built by this script
-s | --check                            : Enable OAI testing and sanity check (default disabled)
-t | --enb-build-target                 : Set the eNB build target: ALL, SOFTMODEM,OAISIM,UNISIM (default ALL)
-V | --vcd                              : Log vcd events
-w | --hardware                         : Set the hardware platform: EXMIMO, USRP (also installs UHD driver), ETHERNET, NONE, (default EXMIMO)
-x | --xforms                           : Enable xforms (default disabled)
-z | --defaults                         : Set the default build options

=============================================

as a beginner, you can type "./build_oai.bash -b -l ENB -t OAISIM -w NONE", this command will run and exit gracefully, (the first time run will take a lot of minutes, except your network speed is great)

4. Run a simple test

after the 3rd step, you can find an executable file named "oaisim" under the $OPENAIR_HOME/targets/bin dir, as you want, you can run this file.

OR, you can do some PHY link simulation, $OPENAIR_HOME/openair1/SIMULATION/LTE_PHY

make dlsim

./dlsim -n100

will simulate 100 frames with the default options.

5.ALL Yours.......

(You can follow my Sina Weibo(http://weibo.com/10891030), there I will post some PICs and Videos)