Changes between Version 8 and Version 9 of Tutorials/4G5G/openairinterface

Timestamp:

Apr 23, 2020, 11:21:44 PM (5 years ago)

Author:

msherman

Comment:

—

Tutorials/4G5G/openairinterface

@@ +1 @@
+# Overview
 This tutorial contains instructions for running the openairinterface eNB and UE on various platforms.
 It adapts the Eurecom tutorial at : https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/HowToConnectOAIENBWithOAIUEWithoutS1Interface
 for the ORBIT and COSMOS testbeds.
 
-== Prerequisites ==
+# Prerequisites
 1. Two nodes, with appropriate hardware, within RF range
 1. Currently supported: USRP x310, USRP 2974, USRP b210
-1. Load the image {{{tutorial-oai.ndz}}} onto both nodes
+1. Load the image `tutorial-oai.ndz` onto both nodes
 1. Turn the nodes on
 1. If graphical display is desired, enable x11 tunneling to console and then to nodes
 1. ssh to the nodes
 
-== On node 1 ==
-1. run /opt/oaiscripts/build_oai.sh to build for the current hardware and kernel
-1. edit the file /opt/oaiscripts/run_enb.sh for the SDR in use, for example, set SDR IP addr and max gain
-1. run /opt/oaiscripts/run_enb.sh
+## On node 1
+1. run `/opt/oaiscripts/build_oai.sh` to build for the current hardware and kernel
+1. edit the file `/opt/oaiscripts/run_enb.sh` for the SDR in use, for example, set SDR IP addr and max gain
+1. run `/opt/oaiscripts/run_enb.sh`
 
 
 Example script, change parameters as needed:
-* run_enb.sh:
-{{{
+run_enb.sh:
+```
 #! /bin/bash
 #sdr_addrs takes standard uhd arguments, such as:
@@ -26 +27 @@
 #"type=b210"                    #b210 over usb
 #values for RUs.[0] override config file, must be set per usrp type
-# -d enables xforms charts
+#-d enables xforms charts
 
 cd /opt/openairinterface5g
@@ -37 +38 @@
 --usrp-args "type=b200" \
 -d
-}}}
+```
 
-== On Node 2 ==
+## On Node 2
 1. run /opt/oaiscripts/build_oai.sh to build for the current hardware and kernel
 1. edit the file /opt/oaiscripts/run_ue.sh for the SDR in use, for example, set SDR IP addr and max gain
@@ -45 +46 @@
 
 Example script, change parameters as needed:
-* run_ue.sh:
-{{{
+run_ue.sh
+```
 #! /bin/bash
 #sdr_addrs takes standard uhd arguments, such as:
@@ -53 +54 @@
 #"type=b210"                    #b210 over usb
 #values for RUs.[0] override config file, must be set per usrp type
-# -d enables xforms charts
+#-d enables xforms charts
 
 cd /opt/openairinterface5g
@@ -65 +66 @@
 --usrp-args "type=b200" \
 -d
-}}}
+```
 
-== Once Both nodes are running ==
+
+# Results
+
+## Once Both nodes are running
 * if all is successfull, you shouuld see new interfaces on the two nodes, with addresses:
   * 10.0.1.1
@@ -74 +78 @@
 
 
-== Understanding xforms terms and plots ==
+
+
+# Understanding xforms terms and plots
 * Explanations from:
-  * https://www.mathworks.com/help/lte/physical-channels.html
+  * [Mathworks LTE](https://www.mathworks.com/help/lte/physical-channels.html)
 
 * PBCH: physical broadcast channel
@@ -87 +93 @@
   * The PDSCH carries user data and paging information to the terminal.
 
-== Calibration ==
+
+# Details and Troubleshooting
+## Calibration
 * physical attenuation
 * received signal at UE
@@ -94 +102 @@
 * pdsch constellation at eNB
 
-== Expected Performance ==
+## Expected Performance
 This depends on a number of factors, including:
 * the total bandwidth (number of resource blocks)
@@ -118 +126 @@
 
 
-== Specifics per domain ==
-=== sb2.cosmos-lab.org ===
+## Specifics per domain
+### sb2.cosmos-lab.org
 1. set usrp address to "type=x3xx,resource=rio0"
 1. on eNB, set att_tx=70, att_rx=10
 1. use RFSWITCH service to set all switches to port 1 for antenna
 
-=== sb2.orbit-lab.org ===
+### sb2.orbit-lab.org
 1. set usrp address to "type=x3xx,addr=192.168.40.2"
 1. bring up usrp ethernet interface, set ip to 192.168.40.1/16
 
-=== sb1.orbit-lab.org ===
+### sb1.orbit-lab.org
 1. set usrp address to "type=b210"
 1. UE_rxgain: 120
@@ -137 +145 @@
 
 
-=== sb4.orbit-lab.org ===
+### sb4.orbit-lab.org ===
 1. set usrp address to "type=b210"
 1. configure RF matrix for 60db of attenuation between eNB and UE node chosen