21a649a109e1bf953008715909980410d80570b9
[o-du/phy.git] / docs / Assumptions_Dependencies.rst
1 ..    Copyright (c) 2019 Intel
2 ..
3 ..  Licensed under the Apache License, Version 2.0 (the "License");
4 ..  you may not use this file except in compliance with the License.
5 ..  You may obtain a copy of the License at
6 ..
7 ..      http://www.apache.org/licenses/LICENSE-2.0
8 ..
9 ..  Unless required by applicable law or agreed to in writing, software
10 ..  distributed under the License is distributed on an "AS IS" BASIS,
11 ..  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 ..  See the License for the specific language governing permissions and
13 ..  limitations under the License.
14
15 .. |br| raw:: html
16
17    <br />
18
19
20 Assumptions and Dependencies
21 ===============================
22
23 .. contents::
24     :depth: 3
25     :local:
26
27 This chapter contains the assumptions, requirements and dependencies for the O-DU Low current implementation.
28
29 Assumptions
30 -----------
31
32 An L1 with a proprietary interface and a testmac supporting the FAPI interface are available through the Open Source Community(OSC) github in binary blob form and with the reference
33 files that support the tests required for the ORAN Bronze Release. The required header files that are needed to build the 5G FAPI TM and to run validation tests and to |br|
34 integrate with the O-DU
35 High to check network functionality are available from the same site.
36 The L1 App and Testmac |br|
37 repository is at https://github.com/intel/FlexRAN/
38
39 Requirements
40 ------------
41 * Only Xeon® series Processor with Intel Architecture are supported and the platform should be |br|
42   Intel® Xeon® SkyLake / CascadeLake platforms with at least 2.0 GHz core frequency
43 * FPGA/ASIC card for FEC acceleration that's compliance with BBDev framework and interface if you need run high throughput case with HW FEC card assistant.
44 * Bios setting steps and options might have difference, however at least you should have the same Bios setting as decribed in the README.me file available at https://github.com/intel/FlexRAN Bios settings section
45 * Runing with FH requires PTP for Linux\* version 2.0 (or later) to be installed to provide IEEE 1588 synchronization.
46
47 Dependencies
48 ------------
49
50 * Centos OS 7 (7.5+) (7.7 was used for the L1 and testmac binaries)
51
52 * RT Kernel kernel-rt-3.10.0-1062.12.1.rt56.1042
53
54 * Data Plane Development Kit (DPDK v18.08) with corresponding DPDK patch according to O-RAN FH setup |br|
55   configuation section.
56
57 * FEC SDK lib which was needed when you run FEC in SW mode, download through: https://software.intel.com/en-us/articles/flexran-lte-and-5g-nr-fec-software-development-kit-modules
58
59 * Intel® C++ Compiler v19.0.3 is used for test application and system integration. Free Intel® C++ Compiler can be gotten through below link with community license, however the version you could get is always latest ICC version, the verification for that version might not be performed yet, please feedback through O-DU Low WIKI page if you meet issue.
60   https://software.intel.com/en-us/system-studio/choose-download 
61
62 * Optionally Octave v3.8.2 can be used to generate reference IQ samples (octave-3.8.2-20.el7.x86_64) for O-RAN FH Sample App, which is not needed if running sample APP for O-RAN FHI is not performed.
63
64
65
66