Doc updated on 13/05/2013

README file for LTE_LINK_SAP

 ******************
  Release dates

  D0.1 :  13/05/2013 (RAL_UE only)
 ******************

 Content
 1. Install odtone on ubuntu
 2. Test RAL-Dummy
 3. Install and run LTE-RAL-UE

 ******************
 1. Install odtone on ubuntu

 A. Download Boost v1.48 + ODTONE (Medieval Version) in a directory named myDir for example

 B. unzip both files, creating folders boost_1_48_0 and odtone

 C. Compile boost.build
   > cd myDir/boost_1_48_0/tools/build/v2
   > ./bootstrap.sh
   > sudo ./b2 install

 D. Compile ODTONE
   > cd myDir/odtone
   > b2
   ==> this creates odtone-mihf and miis executables in the myDir/odtone/dist directory and copies odtone.conf in that same directory

 E. Test Local demo
   1- compile mih user
      > cd myDir/odtone/app/cm_demo1
      > b2
   ==> this creates cm_demo1 executable in the myDir/odtone/dist directory and copies mih_usr.conf in that same directory
   2- compile Link sap
      > cd myDir/odtone/app/link_sap
      > b2
   ==> this creates link_sap executable in the myDir/odtone/dist directory and copies link_sap.conf in that same directory
   3- check configuration files and update if needed (see ODTONE doc)
   4- open 3 terminals in the odtone/dist directory, each one for running an executable in the following order
      T1 : > ./odtone-mihf
      T2 : > ./link_sap
      T3 : > ./cm_demo1

 ******************
 2. Test RAL-Dummy

 A. Install LTE user 
   copy the LTE user folder from openair3/RAL-LTE/RAL-DUMMY/802.21-SCENARIO/VERSION0 to the app directory
    > b2  linkflags=-lrt

 B. Compile the RAL-Dummy
     > cd <oai-dir>/openair3/RAL-LTE/RAL-DUMMY
     > make
   ==> this creates several executables:
       - mRALlteDummy + NASUEdummy for the UE
       - eRALlteDummy + NASRGdummy for the eNB
    A small tool to trigger action on NASUEdummy is provided in RAL-DUMMY/802.21-SCENARIO : "sendUDP-01" and "sendUDP-FF" (see below)

 C. Execute RAL-UE simulation

   note : path1 = myDir/odtone, path2 = <oai-dir>/openair3/RAL-LTE

   Requires 5 terminals started in the following order (next step = create scripts)
     - T1  > cd path1/dist
           > ./odtone-mihf --log=4
     - T2  > cd path2/RAL-DUMMY
           > ./mRALlteDummy -c
     - T3  > cd path2/RAL-DUMMY
           > ./NASUEdummy
     - T4  > cd path1/dist
           > ./lte_user
     - T5  > cd path2/RAL-DUMMY/802.21-SCENARIO
             When USER receives MIH_Link_Get_Parameters_confirm
           > sendUDP-01
           ==> this tests link detection and activation
             When USER receives the second MIH_Link_Actions.confirm
           > sendUDP-FF
           ==> this tests link parameters report going down and de-activation

******************
 3. Install and run LTE-RAL-UE

 A. Install LTE user 
   copy the lte_test_user folder from openair3/RAL-LTE/LTE_RAL_UE/MIH-USER to the app directory of ODTONE
    > b2  linkflags=-lrt

 B. Compile the LTE_RAL_UE
     > cd <oai-dir>/openair3/RAL-LTE/LTE_RAL_UE
     > make
   ==> this creates the LTE_RAL_UE executable

 C. Run the LTE_RAL_UE

   note : path1 = myDir/odtone, path2 = <oai-dir>/openair3/RAL-LTE

   Requires 3 terminals started in the following order (next step = create scripts)
     - start OAI platform in CELLULAR mode
     - T1  > cd path1/dist
           > ./odtone-mihf --log=4
     - T2  > cd path2/LTE_RAL_UE
           > ./LTE_RAL_UE
     - T3  > cd path1/dist
           > ./lte_user






