docs/Sample-Application_fh.rst

..    Copyright (c) 2019 Intel
..
..  Licensed under the Apache License, Version 2.0 (the "License");
..  you may not use this file except in compliance with the License.
..  You may obtain a copy of the License at
..
..      http://www.apache.org/licenses/LICENSE-2.0
..
..  Unless required by applicable law or agreed to in writing, software
..  distributed under the License is distributed on an "AS IS" BASIS,
..  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
..  See the License for the specific language governing permissions and
..  limitations under the License.

.. |br| raw:: html

   <br />

Sample Application
==================

.. contents::
    :depth: 3
    :local:

Figure 25 illustrates a sample xRAN application.

.. image:: images/Sample-Application.jpg
  :width: 600
  :alt: Figure 25. Sample Application

Figure 25. Sample Application

The sample application was created to execute test scenarios with
features of the xRAN library and test external API as well as timing.
The sample application is named sample-app, and depending on
configuration file settings can act as O-DU or simplified simulation of
O-RU. The first O-DU should be run on the machine that acts as O-DU and
the second as O-RU. Both machines are connected via ETH. The sample
application on both sides executes using a constant configuration |br|
according to settings in corresponding config files
(./app/usecase/mu0_10mhz/config_file_o_du.dat and |br|
./app/usecase/mu0_10mhz/config_file_o_ru.dat) and uses binary files
(ant.bin) with IQ samples as input. Multiple-use |br| 
cases for different
numerologies and different BW are available as examples. Configuration
files provide descriptions of each |br|
parameter and in general, those are
related to M-plane level settings as per the ORAN Fronthaul
specification.

From the start of the process, the application (O-DU) sends DL packets
for the U-plane and C-plane and receives U-plane UL packets.
Synchronization of O-DU and O-RU sides is achieved via IEEE 1588.

U-plane packets for UL and DL direction are constructed the same way
except for the direction field.

The several default configurations used with the sample app for v20.02
release are:

1 Cell mmWave 100MHz TDD DDDS:


-  Numerology 3 (mmWave)

-  TTI period 125 µs

-  100 Mhz Bandwidth: 792 subcarriers (all 66 RB utilized at all times)

-  4x4 MIMO

-  No beamforming

-  1 Component carrier

-  Jumbo Frame for Ethernet (up to 9728 bytes)

-  Front haul throughput ~11.5 Gbps.

12 Cells Sub6 10MHz FDD:


-  Numerology 0 (Sub-6)

-  TTI period 1000 µs

-  10Mhz Bandwidth: 624 subcarriers (all 52 RB utilized at all times)

-  4x4 MIMO

-  No beamforming

-  12 Component carrier

-  Jumbo Frame for Ethernet (up to 9728 bytes)

-  Front haul throughput ~13.7Gbps.

1 Cell Sub6 100MHz TDD:


-  Numerology 1 (Sub-6)

-  TTI period 500us

-  100Mhz Bandwidth: 3276 subcarriers (all 273RB utilized at all times)

-  4x4 MIMO

-  No beamforming

-  1 Component carrier

-  Jumbo Frame for Ethernet (up to 9728 bytes)

-  Front haul throughput ~11.7 Gbps.

.. _cell-sub6-100mhz-tdd-1:

1 Cell Sub6 100MHz TDD:


-  Numerology 1 (Sub-6)

-  TTI period 500 µs

-  100 Mhz Bandwidth: 3276 subcarriers (all 273RB utilized at all
   times). 8 UEs per TTI per layer

-  8DL /4UL MIMO Layers

-  Digital beamforming with 32T32R

-  1 Component carrier

-  Jumbo Frame for Ethernet (up to 9728 bytes)

-  Front haul throughput ~23.5 Gbps.

Other configurations can be constructed by modifying config files
(please see app/usecase/)