Add O-RAN 7.2 FHI library

- Add the O-RAN 7.2 FHI library, interfacing with OSC xRAN library (E
  release)
- Add Findxran.cmake to detect the library and headers, including
  version information
- Test for numa and DPDK presence
- Add patch for OSC xRAN to make interworking possible
- Add sample config files for LiteOn, Benetel, and VVDN units.

Documentation is provided in the next commit.
Co-authored-by: Raymond Knopp <raymond.knopp@eurecom.fr>
Co-authored-by: Cedric Roux <cedric.roux@eurecom.fr>
Co-authored-by: Manish Kumar Singh <manish1.kumar@amd.com>
Co-authored-by: thamizhselvan.k <thamizhselvan.k@vvdntech.in>
Co-authored-by: rajeshwari.p <rajeshwari.p@vvdntech.in>
Co-authored-by: Hongzhi Wang <hongzhi.wang@openairinterface.org>
Co-authored-by: Sofia Pison <Sofia.Pison@eurecom.fr>

cmake_targets/build_oai

@@ -96,7 +96,7 @@ Options:
    USRP, BLADERF, LMSSDR, IRIS, SIMU, AW2SORI, None (Default)
    Adds this RF board support (in external packages installation and in compilation)
 -t | --transport
-   Selects the transport protocol type, options: None, Ethernet, benetel4g, benetel5g
+   Selects the transport protocol type, options: None, Ethernet, benetel4g, benetel5g, oran_fhlib_5g
 -P | --phy_simulators
    Makes the unitary tests Layer 1 simulators
 -S | --core_simulators
@@ -302,10 +302,14 @@ function main() {
                 TARGET_LIST="$TARGET_LIST oai_eth_transpro"
                 CMAKE_CMD="$CMAKE_CMD -DOAI_${2^^}=ON" # ^^ makes uppercase
                 ;;
-              "benetel4g" | "benetel5g")
+              "benetel4g" | "benetel5g" | "oran_fhlib_4g")
                 TARGET_LIST="$TARGET_LIST $2"
                 CMAKE_CMD="$CMAKE_CMD -DOAI_${2^^}=ON" # ^^ makes uppercase
                 ;;
+              "oran_fhlib_5g")
+                TARGET_LIST="$TARGET_LIST $2"
+                CMAKE_CMD="$CMAKE_CMD -DOAI_FHI72=ON"
+                ;;
               "None")
                 ;;
               *)
@@ -503,6 +507,12 @@ function main() {
 	echo_info "Built Doxygen based documentation. The documentation file is located here: $OPENAIR_DIR/$BUILD_DIR/build/html/index.html"
     fi
 
+    # TODO: once we got the CMakeLists.txt file done for the ORAN files, remove the following lines
+    if [[ $TARGET_LIST =~ "oran_fhlib_5g" ]]; then
+      rm -f liboai_transpro.so
+      ln -s liboran_fhlib_5g.so liboai_transpro.so
+    fi
+
     if [ "$UE" = 1 ] ; then
 
       echo_info "Compiling UE specific part"

cmake_targets/tools/MODULES/Findxran.cmake

+#
+# Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The OpenAirInterface Software Alliance licenses this file to You under
+# the OAI Public License, Version 1.1  (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.openairinterface.org/?page_id=698
+# 
+# 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.
+# ------------------------------------------------------------------------------
+# For more information about the OpenAirInterface (OAI) Software Alliance:
+#      contact@openairinterface.org
+# 
+
+# FindXran
+# -------
+# 
+# Finds the xran library. Note that the library number is as follows:
+# - oran_bronze_release_v1.1 -> 2.1.1 (B = second letter)
+# - oran_e_maintenance_release_v1.0 -> 5.1.0
+# the version is currently hardcoded to 5.1.0
+#
+# Required options
+# ^^^^^^^^^^^^^^^^
+#
+# ``xran_LOCATION``
+#   The location of the library.
+# 
+# Imported Targets
+# ^^^^^^^^^^^^^^^^
+# 
+# This module provides the following imported targets, if found:
+# 
+# ``xran::xran``
+#   The xran library
+# 
+# Result Variables
+# ^^^^^^^^^^^^^^^^
+# 
+# This will define the following variables:
+# 
+# ``xran_FOUND``
+#   True if the system has the xran library.
+# ``xran_VERSION``
+#   The version of the xran library which was found.
+# ``xran_INCLUDE_DIRS``
+#   Include directories needed to use xran.
+# ``xran_LIBRARIES``
+#   Libraries needed to link to xran.
+# 
+# Cache Variables
+# ^^^^^^^^^^^^^^^
+# 
+# The following cache variables may also be set:
+# 
+# ``xran_INCLUDE_DIR``
+#   The directory containing ``foo.h``.
+# ``xran_LIBRARY``
+#   The path to the xran library.
+
+option(xran_LOCATION "directory of XRAN library" "")
+if (NOT xran_LOCATION)
+  message(FATAL_ERROR "xran_LOCATION required")
+endif()
+if (NOT EXISTS ${xran_LOCATION})
+  message(FATAL_ERROR "no such directory: ${xran_LOCATION}")
+endif()
+
+find_path(xran_INCLUDE_DIR
+  NAMES
+    xran_common.h
+    xran_compression.h
+    xran_cp_api.h
+    xran_ecpri_owd_measurements.h
+    xran_fh_o_du.h
+    xran_pkt.h
+    xran_pkt_up.h
+    xran_sync_api.h
+  PATHS ${xran_LOCATION}
+  PATH_SUFFIXES api
+)
+find_library(xran_LIBRARY
+  NAMES xran
+  PATHS ${xran_LOCATION}/build
+)
+if (NOT xran_LIBRARY)
+  message(FATAL_ERROR "could not detect xran build artifacts at ${xran_LOCATION}/build")
+endif()
+
+set(xran_VERSION_FILE "${xran_LOCATION}/../app/src/common.h")
+if(NOT EXISTS ${xran_VERSION_FILE})
+  message(FATAL_ERROR "could not find xran version file at ${xran_VERSION_FILE}")
+endif()
+
+file(STRINGS ${xran_VERSION_FILE} xran_VERSION_LINE REGEX "^#define[ \t]+VERSIONX[ \t]+\"[a-z_.0-9]+\"$")
+string(REGEX REPLACE "^#define[ \t]+VERSIONX[ \t]+\"([a-z_.0-9]+)\"$" "\\1" xran_VERSION_STRING "${xran_VERSION_LINE}")
+message(STATUS "Found xran release ${xran_VERSION_STRING}")
+set(xran_VERSION "NOTFOUND")
+if (xran_VERSION_STRING STREQUAL "oran_e_maintenance_release_v1.0")
+  set(xran_VERSION 5.1.0)
+elseif (xran_VERSION_STRING STREQUAL "oran_e_maintenance_release_v1.1")
+  set(xran_VERSION 5.1.1)
+endif()
+unset(xran_VERSION_LINE)
+unset(xran_VERSION_STRING)
+unset(xran_VERSION_FILE)
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(xran
+  FOUND_VAR xran_FOUND
+  REQUIRED_VARS
+    xran_LIBRARY
+    xran_INCLUDE_DIR
+  VERSION_VAR xran_VERSION
+)
+
+if(xran_FOUND)
+  set(xran_LIBRARIES ${xran_LIBRARY})
+  set(xran_INCLUDE_DIRS ${xran_INCLUDE_DIR})
+endif()
+
+if(xran_FOUND AND NOT TARGET xran::xran)
+  add_library(xran::xran UNKNOWN IMPORTED)
+  set_target_properties(xran::xran PROPERTIES
+    IMPORTED_LOCATION "${xran_LIBRARY}"
+    INTERFACE_INCLUDE_DIRECTORIES "${xran_INCLUDE_DIR}"
+  )
+endif()
+
+mark_as_advanced(
+  xran_INCLUDE_DIR
+  xran_LIBRARY
+)

radio/CMakeLists.txt

@@ -13,6 +13,11 @@ if(OAI_BLADERF)
   add_subdirectory(BLADERF)
 endif()
 
+add_boolean_option(OAI_FHI72 OFF "Activate OAI's FHI 7.2 (xran/fhi_lib) driver" OFF)
+if(OAI_FHI72)
+  add_subdirectory(fhi_72)
+endif()
+
 add_boolean_option(OAI_IRIS OFF "Activate OAI's IRIS/SoapySDR driver" OFF)
 if(OAI_IRIS)
   add_subdirectory(IRIS)

radio/fhi_72/CMakeLists.txt

+# use env var PKG_CONFIG_PATH to override paths to libdpdk.pc!
+pkg_check_modules(dpdk REQUIRED libdpdk)
+pkg_check_modules(numa REQUIRED numa)
+
+find_package(xran 5.1.1 EXACT REQUIRED) # E release -> 5!
+
+# Ignore xran-specific warning: we don't care/can't change the following warning, so suppress
+# alignment 1 of ‘struct XYZ’ is less than 2
+add_compile_options(-Wno-packed-not-aligned)
+
+add_library(oran_fhlib_5g MODULE
+            oran_isolate.c
+            oaioran.c
+            oran-config.c
+            oran-init.c
+)
+
+set_target_properties(oran_fhlib_5g PROPERTIES COMPILE_FLAGS "-fvisibility=hidden -march=native")
+target_link_libraries(oran_fhlib_5g PRIVATE xran::xran)
+target_link_libraries(oran_fhlib_5g PRIVATE ${dpdk_LINK_LIBRARIES})
+target_include_directories(oran_fhlib_5g PRIVATE ${dpdk_INCLUDE_DIRS})
+target_link_libraries(oran_fhlib_5g PRIVATE pthread dl rt m numa)
+target_link_libraries(oran_fhlib_5g PRIVATE ${T_LIB})
+
+# TODO: can be removed?
+target_include_directories(oran_fhlib_5g PRIVATE ${xran_INCLUDE_DIRS}/../src/)
+
+set_target_properties(oran_fhlib_5g PROPERTIES LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR})
+add_custom_command(TARGET oran_fhlib_5g POST_BUILD
+                   COMMAND ${CMAKE_COMMAND} -E create_symlink liboran_fhlib_5g.so liboai_transpro.so
+                   WORKING_DIRECTORY ${CMAKE_BINARY_DIR})

radio/fhi_72/oaioran.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.1  (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.openairinterface.org/?page_id=698
+ *
+ * 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.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+#ifndef OAIORAN_H
+#define OAIORAN_H
+
+#include <stdint.h>
+#include "xran_fh_o_du.h"
+
+typedef struct {
+	uint32_t tti;
+	uint32_t sl;
+	uint32_t f;
+} oran_sync_info_t;
+
+void oai_xran_fh_rx_callback(void *pCallbackTag, xran_status_t status);
+int oai_physide_dl_tti_call_back(void * param);
+
+#endif /* OAIORAN_H */

radio/fhi_72/oran-config.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.1  (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.openairinterface.org/?page_id=698
+ *
+ * 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.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+#ifndef ORAN_CONFIG_H
+#define ORAN_CONFIG_H
+
+#include "stdbool.h"
+#include "stdint.h"
+
+struct xran_fh_init;
+void print_fh_init(const struct xran_fh_init *fh_init);
+struct xran_fh_config;
+void print_fh_config(const struct xran_fh_config *fh_config);
+
+bool set_fh_init(struct xran_fh_init *fh_init);
+struct openair0_config;
+bool set_fh_config(int ru_idx, int num_rus, const struct openair0_config *oai0_cfg, struct xran_fh_config *fh_config);
+
+// hack to workaround LiteOn limitation
+extern int g_kbar;
+
+#endif /* ORAN_CONFIG_H */

radio/fhi_72/oran-init.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.1  (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.openairinterface.org/?page_id=698
+ *
+ * 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.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+#ifndef ORAN_INIT_H
+#define ORAN_INIT_H
+
+typedef struct oran_bufs {
+  struct xran_flat_buffer tx[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN][XRAN_NUM_OF_SYMBOL_PER_SLOT];
+  struct xran_flat_buffer tx_prbmap[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+  struct xran_flat_buffer rx[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN][XRAN_NUM_OF_SYMBOL_PER_SLOT];
+  struct xran_flat_buffer rx_prbmap[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+
+  struct xran_flat_buffer prach[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN][XRAN_NUM_OF_SYMBOL_PER_SLOT];
+  struct xran_flat_buffer prachdecomp[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN][XRAN_NUM_OF_SYMBOL_PER_SLOT];
+} oran_bufs_t;
+
+typedef struct oran_buf_list {
+  // xran API requires buffer lists as structs of arrays
+  struct xran_buffer_list src[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+  struct xran_buffer_list srccp[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+  struct xran_buffer_list dst[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+  struct xran_buffer_list dstcp[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+
+  struct xran_buffer_list prachdst[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+  struct xran_buffer_list prachdstdecomp[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN];
+
+  oran_bufs_t bufs;
+} oran_buf_list_t;
+
+typedef struct oran_port_instance_t {
+  oran_buf_list_t *buf_list;
+  void *instanceHandle;
+  //uint32_t dpdkPoolIndex[MAX_SW_XRAN_INTERFACE_NUM];
+
+  struct xran_cb_tag  RxCbTag[XRAN_PORTS_NUM][XRAN_MAX_SECTOR_NR];
+  struct xran_cb_tag  PrachCbTag[XRAN_PORTS_NUM][XRAN_MAX_SECTOR_NR];
+} oran_port_instance_t;
+
+extern struct xran_fh_config gxran_fh_config[XRAN_PORTS_NUM];
+extern void* gxran_handle;
+
+struct openair0_config;
+int *oai_oran_initialize(const struct openair0_config *openair0_cfg);
+
+#endif /* ORAN_INIT_H */

radio/fhi_72/oran-params.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.1  (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.openairinterface.org/?page_id=698
+ *
+ * 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.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+#ifndef ORAN_PARAMS_H
+#define ORAN_PARAMS_H
+
+#include "stdbool.h"
+#include "stdint.h"
+
+#define CONFIG_STRING_ORAN "fhi_72"
+
+#define ORAN_CONFIG_DPDK_DEVICES "dpdk_devices"
+#define ORAN_CONFIG_IO_CORE "io_core"
+#define ORAN_CONFIG_WORKER_CORES "worker_cores"
+#define ORAN_CONFIG_DU_ADDR "du_addr"
+#define ORAN_CONFIG_RU_ADDR "ru_addr"
+#define ORAN_CONFIG_MTU "mtu"
+#define ORAN_CONFIG_FILE_PREFIX "file_prefix"
+#define ORAN_CONFIG_NETHPERPORT "eth_lines"
+#define ORAN_CONFIG_NETHSPEED "eth_speed"
+
+// clang-format off
+// TODO: PCI addr check
+// TODO: ethernet addr check
+#define ORAN_GLOBALPARAMS_DESC { \
+  {ORAN_CONFIG_DPDK_DEVICES,    "PCI addr of devices for DPDK\n",           PARAMFLAG_MANDATORY, .strlistptr=NULL, .defstrlistval=NULL, TYPE_STRINGLIST, 0}, \
+  {ORAN_CONFIG_IO_CORE,         "DPDK Core used for IO\n",                  PARAMFLAG_MANDATORY, .iptr=NULL,       .defintval=4,        TYPE_INT,        0}, \
+  {ORAN_CONFIG_WORKER_CORES,    "CPU Cores to use for workers\n",           PARAMFLAG_MANDATORY, .uptr=NULL,       .defintarrayval=NULL,TYPE_UINTARRAY,  0}, \
+  {ORAN_CONFIG_DU_ADDR,         "Ether addr of DU\n",                       PARAMFLAG_MANDATORY, .strlistptr=NULL, .defstrlistval=NULL, TYPE_STRINGLIST, 0}, \
+  {ORAN_CONFIG_RU_ADDR,         "Ether addr of RU\n",                       PARAMFLAG_MANDATORY, .strlistptr=NULL, .defstrlistval=NULL, TYPE_STRINGLIST, 0}, \
+  {ORAN_CONFIG_MTU,             "MTU of Eth interface\n",                   PARAMFLAG_MANDATORY, .uptr=NULL,       .defuintval=1500,    TYPE_UINT,       0}, \
+  {ORAN_CONFIG_FILE_PREFIX,     "DPDK file-prefix\n",                       0,                   .strptr=NULL,     .defstrval="wls_0",  TYPE_STRING,     0}, \
+  {ORAN_CONFIG_NETHPERPORT,     "number of links per port\n",               0,                   .uptr=NULL,       .defuintval=1,       TYPE_UINT,       0}, \
+  {ORAN_CONFIG_NETHSPEED,       "ethernet speed link\n",                    0,                   .uptr=NULL,       .defuintval=10,      TYPE_UINT,       0}, \
+}
+// clang-format on
+
+
+#define CONFIG_STRING_ORAN_FH "fh_config"
+
+#define ORAN_FH_CONFIG_TADV_CP_DL "Tadv_cp_dl"
+#define ORAN_FH_CONFIG_T2A_CP_DL "T2a_cp_dl"
+#define ORAN_FH_CONFIG_T2A_CP_UL "T2a_cp_ul"
+#define ORAN_FH_CONFIG_T2A_UP "T2a_up"
+#define ORAN_FH_CONFIG_TA3 "Ta3"
+#define ORAN_FH_CONFIG_T1A_CP_DL "T1a_cp_dl"
+#define ORAN_FH_CONFIG_T1A_CP_UL "T1a_cp_ul"
+#define ORAN_FH_CONFIG_T1A_UP "T1a_up"
+#define ORAN_FH_CONFIG_TA4 "Ta4"
+#define ORAN_FH_CONFIG_CP_VLAN_TAG "cp_vlan_tag"
+#define ORAN_FH_CONFIG_UP_VLAN_TAG "up_vlan_tag"
+
+#define ORAN_FH_HLP_CPLT " parameter of RU in list form (Min&Max, length 2!)\n"
+
+// clang-format off
+#define ORAN_FH_DESC { \
+  {ORAN_FH_CONFIG_TADV_CP_DL,   "Tadv parameter of RU\n",      PARAMFLAG_MANDATORY, .uptr=NULL, .defuintval=0,     TYPE_UINT,      0}, \
+  {ORAN_FH_CONFIG_T2A_CP_DL,    "T2a_cp_dl" ORAN_FH_HLP_CPLT,  PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_T2A_CP_UL,    "T2a_cp_ul" ORAN_FH_HLP_CPLT,  PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_T2A_UP,       "T2a_up" ORAN_FH_HLP_CPLT,     PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_TA3,          "Ta3" ORAN_FH_HLP_CPLT,        PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_T1A_CP_DL,    "T1a_cp_dl" ORAN_FH_HLP_CPLT,  PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_T1A_CP_UL,    "T1a_cp_ul" ORAN_FH_HLP_CPLT,  PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_T1A_UP,       "T1a_up" ORAN_FH_HLP_CPLT,     PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_TA4,          "Ta4" ORAN_FH_HLP_CPLT,        PARAMFLAG_MANDATORY, .uptr=NULL, .defintarrayval=0, TYPE_UINTARRAY, 0}, \
+  {ORAN_FH_CONFIG_CP_VLAN_TAG,  "not used by xran",            0,                   .uptr=NULL, .defuintval=0,     TYPE_UINT,      0}, \
+  {ORAN_FH_CONFIG_UP_VLAN_TAG,  "not used by xran",            0,                   .uptr=NULL, .defuintval=0,     TYPE_UINT,      0}, \
+}
+// clang-format on
+
+
+#define CONFIG_STRING_ORAN_RU "ru_config"
+
+#define ORAN_RU_CONFIG_IQWIDTH "iq_width"
+#define ORAN_RU_CONFIG_IQWIDTH_PRACH "iq_width_prach"
+#define ORAN_RU_CONFIG_FFT_SIZE "fft_size"
+
+// clang-format off
+#define ORAN_RU_DESC {\
+  {ORAN_RU_CONFIG_IQWIDTH,       "sample IQ width (16=uncompressed)\n",       PARAMFLAG_MANDATORY, .u8ptr=NULL, .defuintval=16, TYPE_UINT8, 0}, \
+  {ORAN_RU_CONFIG_IQWIDTH_PRACH, "PRACH sample IQ width (16=uncompressed)\n", PARAMFLAG_MANDATORY, .u8ptr=NULL, .defuintval=16, TYPE_UINT8, 0}, \
+  {ORAN_RU_CONFIG_FFT_SIZE,      "Size of FFT at RU\n",                       PARAMFLAG_MANDATORY, .u8ptr=NULL, .defuintval=12, TYPE_UINT8, 0}, \
+}
+// clang-format on
+
+
+#define CONFIG_STRING_ORAN_PRACH "prach_config"
+
+#define ORAN_PRACH_CONFIG_EAXC_OFFSET "eAxC_offset"
+#define ORAN_PRACH_CONFIG_KBAR "kbar"
+
+// clang-format off
+#define ORAN_PRACH_DESC {\
+  {ORAN_PRACH_CONFIG_EAXC_OFFSET, "RU's eAxC offset for PRACH\n", PARAMFLAG_MANDATORY, .u8ptr=NULL, .defuintval=0, TYPE_UINT8, 0}, \
+  {ORAN_PRACH_CONFIG_KBAR,        "PRACH guard interval\n",       0,                   .uptr=NULL,  .defuintval=4, TYPE_UINT,  0}, \
+}
+// clang-format on
+
+#endif /* ORAN_PARAMS_H */

radio/fhi_72/oran.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.1  (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.openairinterface.org/?page_id=698
+ *
+ * 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.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+#ifndef _ORAN_H_
+#define _ORAN_H_
+
+#include "shared_buffers.h"
+#include "common_lib.h"
+void oran_fh_if4p5_south_out(RU_t *ru,
+			     int frame,
+			     int slot,
+			     uint64_t timestamp);
+
+void oran_fh_if4p5_south_in(RU_t *ru,
+			    int *frame,
+			    int *slot);
+
+int transport_init(openair0_device *device,
+                     openair0_config_t *openair0_cfg,
+                     eth_params_t * eth_params );
+
+
+typedef struct {
+  eth_state_t           e;
+  shared_buffers        buffers;
+  rru_config_msg_type_t last_msg;
+  int                   capabilities_sent;
+  void                  *oran_priv;
+} oran_eth_state_t;
+#endif /* _ORAN_H_ */

radio/fhi_72/oran_isolate.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.1  (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.openairinterface.org/?page_id=698
+ *
+ * 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.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+#ifndef _ORAN_ISOLATE_H_
+#define _ORAN_ISOLATE_H_
+
+#include <stdio.h>
+
+#include <pthread.h>
+#include <stdint.h>
+
+#include "xran_fh_o_du.h"
+
+/*
+ * Structure added to bear the information needed from OAI RU
+ */
+typedef struct ru_info_s{
+
+        // Needed for UL
+ 	int nb_rx;
+	int32_t **rxdataF;
+
+        // Needed for DL
+	int nb_tx;
+	int32_t **txdataF_BF;
+
+        // Needed for Prach
+        int16_t **prach_buf;
+} ru_info_t;
+
+int xran_fh_rx_read_slot(ru_info_t *ru, int *frame, int *slot);
+int xran_fh_tx_send_slot(ru_info_t *ru, int frame, int slot, uint64_t timestamp);
+
+
+int compute_xran_statistics();
+
+#endif /* _ORAN_ISOLATE_H_ */