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)