This tutorial contains instructions for running the openairinterface eNB and UE on various platforms.

== Prerequisites ==
1. Two nodes, with appropriate hardware, within RF range
1. Currently supported: USRP x310, USRP 2974, USRP b210
1. Load the image {{{omf-baseline-oai-1804.ndz}}} onto both nodes
1. Turn the nodes on
1. If graphical display is desired, enable x11 tunneling to console and then to 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 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
1. run /opt/oaiscripts/run_ue.sh


== Understanding xforms terms and plots ==
* Explanations from:
  * https://www.mathworks.com/help/lte/physical-channels.html

* PBCH
  * physical broadcast channel
  * The PBCH carries part of the system information required for terminals to access the network
* PDCCH
  * physical downlink control channel
  * The PDCCH conveys control information, scheduling decisions for PDSCH reception, and for scheduling grants enabling transmission on the PUSCH.
* PDSCH
  * physical downlink shared channel
  * The PDSCH carries user data and paging information to the terminal.


== 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 ===
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 ===
1. set usrp address to "type=b210"

=== 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