Changes between Version 10 and Version 11 of Tutorials/4G5G/openairinterface


Ignore:
Timestamp:
Apr 23, 2020, 11:25:58 PM (4 years ago)
Author:
msherman
Comment:

Reverted to version 8.

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/4G5G/openairinterface

    v10 v11  
    1 {{{
    2 #!Markdown
    3 
    4 # Overview
    51This tutorial contains instructions for running the openairinterface eNB and UE on various platforms.
    62It adapts the Eurecom tutorial at : https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectOAIENBWithOAIUEWithoutS1Interface
    73for the ORBIT and COSMOS testbeds.
    84
    9 # Prerequisites
     5== Prerequisites ==
    1061. Two nodes, with appropriate hardware, within RF range
    1171. Currently supported: USRP x310, USRP 2974, USRP b210
    12 1. Load the image `tutorial-oai.ndz` onto both nodes
     81. Load the image {{{tutorial-oai.ndz}}} onto both nodes
    1391. Turn the nodes on
    14101. If graphical display is desired, enable x11 tunneling to console and then to nodes
    15111. ssh to the nodes
    1612
    17 ## On node 1
    18 1. run `/opt/oaiscripts/build_oai.sh` to build for the current hardware and kernel
    19 1. edit the file `/opt/oaiscripts/run_enb.sh` for the SDR in use, for example, set SDR IP addr and max gain
    20 1. run `/opt/oaiscripts/run_enb.sh`
     13== On node 1 ==
     141. run /opt/oaiscripts/build_oai.sh to build for the current hardware and kernel
     151. edit the file /opt/oaiscripts/run_enb.sh for the SDR in use, for example, set SDR IP addr and max gain
     161. run /opt/oaiscripts/run_enb.sh
    2117
    2218
    2319Example script, change parameters as needed:
    24 run_enb.sh:
    25 ```
     20* run_enb.sh:
     21{{{
    2622#! /bin/bash
    2723#sdr_addrs takes standard uhd arguments, such as:
     
    3026#"type=b210"                    #b210 over usb
    3127#values for RUs.[0] override config file, must be set per usrp type
    32 #-d enables xforms charts
     28# -d enables xforms charts
    3329
    3430cd /opt/openairinterface5g
     
    4137--usrp-args "type=b200" \
    4238-d
    43 ```
     39}}}
    4440
    45 ## On Node 2
     41== On Node 2 ==
    46421. run /opt/oaiscripts/build_oai.sh to build for the current hardware and kernel
    47431. edit the file /opt/oaiscripts/run_ue.sh for the SDR in use, for example, set SDR IP addr and max gain
     
    4945
    5046Example script, change parameters as needed:
    51 run_ue.sh
    52 ```
     47* run_ue.sh:
     48{{{
    5349#! /bin/bash
    5450#sdr_addrs takes standard uhd arguments, such as:
     
    5753#"type=b210"                    #b210 over usb
    5854#values for RUs.[0] override config file, must be set per usrp type
    59 #-d enables xforms charts
     55# -d enables xforms charts
    6056
    6157cd /opt/openairinterface5g
     
    6965--usrp-args "type=b200" \
    7066-d
    71 ```
     67}}}
    7268
    73 
    74 # Results
    75 
    76 ## Once Both nodes are running
     69== Once Both nodes are running ==
    7770* if all is successfull, you shouuld see new interfaces on the two nodes, with addresses:
    7871  * 10.0.1.1
     
    8174
    8275
    83 
    84 
    85 # Understanding xforms terms and plots
     76== Understanding xforms terms and plots ==
    8677* Explanations from:
    87   * [Mathworks LTE](https://www.mathworks.com/help/lte/physical-channels.html)
     78  * https://www.mathworks.com/help/lte/physical-channels.html
    8879
    8980* PBCH: physical broadcast channel
     
    9687  * The PDSCH carries user data and paging information to the terminal.
    9788
    98 
    99 # Details and Troubleshooting
    100 ## Calibration
     89== Calibration ==
    10190* physical attenuation
    10291* received signal at UE
     
    10594* pdsch constellation at eNB
    10695
    107 ## Expected Performance
     96== Expected Performance ==
    10897This depends on a number of factors, including:
    10998* the total bandwidth (number of resource blocks)
     
    129118
    130119
    131 ## Specifics per domain
    132 ### sb2.cosmos-lab.org
     120== Specifics per domain ==
     121=== sb2.cosmos-lab.org ===
    1331221. set usrp address to "type=x3xx,resource=rio0"
    1341231. on eNB, set att_tx=70, att_rx=10
    1351241. use RFSWITCH service to set all switches to port 1 for antenna
    136125
    137 ### sb2.orbit-lab.org
     126=== sb2.orbit-lab.org ===
    1381271. set usrp address to "type=x3xx,addr=192.168.40.2"
    1391281. bring up usrp ethernet interface, set ip to 192.168.40.1/16
    140129
    141 ### sb1.orbit-lab.org
     130=== sb1.orbit-lab.org ===
    1421311. set usrp address to "type=b210"
    1431321. UE_rxgain: 120
     
    148137
    149138
    150 ### sb4.orbit-lab.org
     139=== sb4.orbit-lab.org ===
    1511401. set usrp address to "type=b210"
    1521411. configure RF matrix for 60db of attenuation between eNB and UE node chosen
    153 
    154 }}}