From 4745e5c88ba931c6d71cb6d8c681f76cf364eac5 Mon Sep 17 00:00:00 2001 From: Luis Farias Date: Thu, 25 Jul 2019 14:51:42 -0700 Subject: [PATCH] Front Haul Interface Library first seed code contribution This first version supports only mmWave per 5G NR and it is not yet optimized and it is a first draft prior to the November 2019 Release A The following mandatory features of the ORAN FH interface are not yet supported in this initial release: 1) RU Category: Support of CAT-B RU (i.e. precoding in RU) 2) Beamforming: Beam Index Based and Real Time BF weights 3) Transport Features: QoS over FrontHaul and Application Fragmentation Additional Information available in the readme.txt file xran root refers to the o-du/phy/fhi_lib folder Issue-Id: ODUPHY-1 Change-Id: I9c801f99bfbc3911514c4e7ff51ea7c52c5666c5 Signed-off-by: luis farias --- fhi_lib/Licenses.txt | 31 + fhi_lib/app/Makefile | 28 + fhi_lib/app/ant_0.bin | Bin 0 -> 3669120 bytes fhi_lib/app/ant_1.bin | Bin 0 -> 3669120 bytes fhi_lib/app/ant_2.bin | Bin 0 -> 3669120 bytes fhi_lib/app/ant_3.bin | Bin 0 -> 3669120 bytes fhi_lib/app/common/common.c | 202 +++++ fhi_lib/app/common/common.h | 99 ++ fhi_lib/app/config_file_lls_cu.dat | 92 ++ fhi_lib/app/config_file_ru.dat | 92 ++ fhi_lib/app/dpdk.sh | 97 ++ fhi_lib/app/gen_test.m | 130 +++ fhi_lib/app/lls-cu/Makefile | 90 ++ fhi_lib/app/lls-cu/sample-lls-cu.c | 1165 ++++++++++++++++++++++++ fhi_lib/app/ru/Makefile | 85 ++ fhi_lib/app/run_lls-cu.sh | 36 + fhi_lib/app/run_ru.sh | 35 + fhi_lib/app/src/config.c | 373 ++++++++ fhi_lib/app/src/config.h | 90 ++ fhi_lib/app/src/xran_mlog_task_id.h | 61 ++ fhi_lib/build.sh | 30 + fhi_lib/lib/Makefile | 87 ++ fhi_lib/lib/api/xran_cp_api.h | 220 +++++ fhi_lib/lib/api/xran_fh_lls_cu.h | 822 +++++++++++++++++ fhi_lib/lib/api/xran_pkt.h | 261 ++++++ fhi_lib/lib/api/xran_pkt_cp.h | 287 ++++++ fhi_lib/lib/api/xran_pkt_up.h | 138 +++ fhi_lib/lib/api/xran_sync_api.h | 41 + fhi_lib/lib/api/xran_timer.h | 47 + fhi_lib/lib/api/xran_transport.h | 74 ++ fhi_lib/lib/api/xran_up_api.h | 116 +++ fhi_lib/lib/ethernet/ethdi.c | 376 ++++++++ fhi_lib/lib/ethernet/ethdi.h | 169 ++++ fhi_lib/lib/ethernet/ethernet.c | 357 ++++++++ fhi_lib/lib/ethernet/ethernet.h | 165 ++++ fhi_lib/lib/src/mlog_lnx_xRAN.h | 55 ++ fhi_lib/lib/src/xran_common.c | 397 ++++++++ fhi_lib/lib/src/xran_common.h | 300 +++++++ fhi_lib/lib/src/xran_cp_api.c | 1086 ++++++++++++++++++++++ fhi_lib/lib/src/xran_hash.h | 45 + fhi_lib/lib/src/xran_lib_mlog_tasks_id.h | 101 +++ fhi_lib/lib/src/xran_main.c | 1445 ++++++++++++++++++++++++++++++ fhi_lib/lib/src/xran_printf.h | 110 +++ fhi_lib/lib/src/xran_sync_api.c | 132 +++ fhi_lib/lib/src/xran_timer.c | 185 ++++ fhi_lib/lib/src/xran_transport.c | 101 +++ fhi_lib/lib/src/xran_ul_tables.c | 858 ++++++++++++++++++ fhi_lib/lib/src/xran_up_api.c | 481 ++++++++++ fhi_lib/readme.txt | 163 ++++ 49 files changed, 11355 insertions(+) create mode 100644 fhi_lib/Licenses.txt create mode 100644 fhi_lib/app/Makefile create mode 100644 fhi_lib/app/ant_0.bin create mode 100644 fhi_lib/app/ant_1.bin create mode 100644 fhi_lib/app/ant_2.bin create mode 100644 fhi_lib/app/ant_3.bin create mode 100644 fhi_lib/app/common/common.c create mode 100644 fhi_lib/app/common/common.h create mode 100644 fhi_lib/app/config_file_lls_cu.dat create mode 100644 fhi_lib/app/config_file_ru.dat create mode 100644 fhi_lib/app/dpdk.sh create mode 100644 fhi_lib/app/gen_test.m create mode 100644 fhi_lib/app/lls-cu/Makefile create mode 100644 fhi_lib/app/lls-cu/sample-lls-cu.c create mode 100644 fhi_lib/app/ru/Makefile create mode 100644 fhi_lib/app/run_lls-cu.sh create mode 100644 fhi_lib/app/run_ru.sh create mode 100644 fhi_lib/app/src/config.c create mode 100644 fhi_lib/app/src/config.h create mode 100644 fhi_lib/app/src/xran_mlog_task_id.h create mode 100644 fhi_lib/build.sh create mode 100644 fhi_lib/lib/Makefile create mode 100644 fhi_lib/lib/api/xran_cp_api.h create mode 100644 fhi_lib/lib/api/xran_fh_lls_cu.h create mode 100644 fhi_lib/lib/api/xran_pkt.h create mode 100644 fhi_lib/lib/api/xran_pkt_cp.h create mode 100644 fhi_lib/lib/api/xran_pkt_up.h create mode 100644 fhi_lib/lib/api/xran_sync_api.h create mode 100644 fhi_lib/lib/api/xran_timer.h create mode 100644 fhi_lib/lib/api/xran_transport.h create mode 100644 fhi_lib/lib/api/xran_up_api.h create mode 100644 fhi_lib/lib/ethernet/ethdi.c create mode 100644 fhi_lib/lib/ethernet/ethdi.h create mode 100644 fhi_lib/lib/ethernet/ethernet.c create mode 100644 fhi_lib/lib/ethernet/ethernet.h create mode 100644 fhi_lib/lib/src/mlog_lnx_xRAN.h create mode 100644 fhi_lib/lib/src/xran_common.c create mode 100644 fhi_lib/lib/src/xran_common.h create mode 100644 fhi_lib/lib/src/xran_cp_api.c create mode 100644 fhi_lib/lib/src/xran_hash.h create mode 100644 fhi_lib/lib/src/xran_lib_mlog_tasks_id.h create mode 100644 fhi_lib/lib/src/xran_main.c create mode 100644 fhi_lib/lib/src/xran_printf.h create mode 100644 fhi_lib/lib/src/xran_sync_api.c create mode 100644 fhi_lib/lib/src/xran_timer.c create mode 100644 fhi_lib/lib/src/xran_transport.c create mode 100644 fhi_lib/lib/src/xran_ul_tables.c create mode 100644 fhi_lib/lib/src/xran_up_api.c create mode 100644 fhi_lib/readme.txt diff --git a/fhi_lib/Licenses.txt b/fhi_lib/Licenses.txt new file mode 100644 index 0000000..6aee987 --- /dev/null +++ b/fhi_lib/Licenses.txt @@ -0,0 +1,31 @@ +Copyright (c) 2019 Intel. + +Unless otherwise specified, all software contained herein is licensed +under the Apache License, Version 2.0 (the "Software License"); +you may not use this software except in compliance with the Software +License. You may obtain a copy of the Software License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the Software License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the Software License for the specific language governing permissions +and limitations under the Software License. + + + +Unless otherwise specified, all documentation contained herein is licensed +under the Creative Commons License, Attribution 4.0 Intl. (the +"Documentation License"); you may not use this documentation except in +compliance with the Documentation License. You may obtain a copy of the +Documentation License at + +https://creativecommons.org/licenses/by/4.0/ + +Unless required by applicable law or agreed to in writing, documentation +distributed under the Documentation License is distributed on an "AS IS" +BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or +implied. See the Documentation License for the specific language governing +permissions and limitations under the Documentation License. + diff --git a/fhi_lib/app/Makefile b/fhi_lib/app/Makefile new file mode 100644 index 0000000..ebad9b9 --- /dev/null +++ b/fhi_lib/app/Makefile @@ -0,0 +1,28 @@ +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ + +PHONY: all + +all: + cd lls-cu && make #DEBUG=1 + cd ru && make #DEBUG=1 + +clean: + cd lls-cu && make clean #DEBUG=1 + cd ru && make clean #DEBUG=1 + diff --git a/fhi_lib/app/ant_0.bin b/fhi_lib/app/ant_0.bin new file mode 100644 index 0000000000000000000000000000000000000000..4d9fb4b51f37bff64249d280643ff13ab006f1bc GIT binary patch literal 3669120 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≠O0Wzx%}mq{;^UM9UvdYSYx>1EQ(q?buA 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 N(#xcm`Cs)i{{gq6$|e8+ literal 0 HcmV?d00001 diff --git a/fhi_lib/app/ant_1.bin b/fhi_lib/app/ant_1.bin new file mode 100644 index 0000000000000000000000000000000000000000..6cb4fe7470f48bb494b30c38322aa21c7aeb410a GIT binary patch literal 3669120 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 UkSEd0L@yJ)O!PAUPrc0l0l>s=Y5)KL literal 0 HcmV?d00001 diff --git a/fhi_lib/app/ant_2.bin b/fhi_lib/app/ant_2.bin new file mode 100644 index 0000000000000000000000000000000000000000..d761f9591d0de83e68f63e2d82d93fe250d46a0a GIT binary patch literal 3669120 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 literal 0 HcmV?d00001 diff --git a/fhi_lib/app/ant_3.bin b/fhi_lib/app/ant_3.bin new file mode 100644 index 0000000000000000000000000000000000000000..6962e6063f98f4b6a6901a9070cc4406aad648ef GIT binary patch literal 3669120 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 +#include +#include +#include +#include + +#include "../common/common.h" +#include "xran_pkt.h" +#include "xran_pkt_up.h" +#include "xran_cp_api.h" +#include "xran_up_api.h" +#include "../src/xran_printf.h" + + +#define MBUFS_CNT 256 + +extern enum app_state state; + +uint8_t numCCPorts = 1; +/* Number of antennas supported by front-end */ + +uint8_t num_eAxc = 4; +/* Number of CPRI ports supported by front-end */ + +int16_t *p_tx_play_buffer[MAX_ANT_CARRIER_SUPPORTED]; +int32_t tx_play_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; +int32_t tx_play_buffer_position[MAX_ANT_CARRIER_SUPPORTED]; + +int16_t *p_rx_log_buffer[MAX_ANT_CARRIER_SUPPORTED]; +int32_t rx_log_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; +int32_t rx_log_buffer_position[MAX_ANT_CARRIER_SUPPORTED]; + +int16_t *p_prach_log_buffer[MAX_ANT_CARRIER_SUPPORTED]; +int32_t prach_log_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; +int32_t prach_log_buffer_position[MAX_ANT_CARRIER_SUPPORTED]; + +int16_t *p_tx_buffer[MAX_ANT_CARRIER_SUPPORTED]; +int32_t tx_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; + +int16_t *p_rx_buffer[MAX_ANT_CARRIER_SUPPORTED]; +int32_t rx_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; + +void sys_save_buf_to_file(char *filename, char *bufname, unsigned char *pBuffer, unsigned int size, unsigned int buffers_num) +{ + if (size) + { + if (filename && bufname) + { + FILE *file; + printf("Storing %s to file %s: ", bufname, filename); + file = fopen(filename, "wb"); + if (file == NULL) + { + print_err("can't open file %s!!!", filename); + } + else + { + uint32_t num; + num = fwrite(pBuffer, buffers_num, size, file); + fflush(file); + fclose(file); + printf("from addr (0x%lx) size (%d) bytes num (%d)", (uint64_t)pBuffer, size, num); + } + printf(" \n"); + } + else + { + print_err(" the file name, buffer name are not set!!!"); + } + } + else + { + print_err(" the %s is free: size = %d bytes!!!", bufname, size); + } +} + +int sys_load_file_to_buff(char *filename, char *bufname, unsigned char *pBuffer, unsigned int size, unsigned int buffers_num) +{ + unsigned int file_size = 0; + int num= 0; + + if (size) + { + if (filename && bufname) + { + FILE *file; + printf("Loading file %s to %s: ", filename, bufname); + file = fopen(filename, "rb"); + + + if (file == NULL) + { + print_err("can't open file %s!!!", filename); + exit(-1); + } + else + { + fseek(file, 0, SEEK_END); + file_size = ftell(file); + fseek(file, 0, SEEK_SET); + + if ((file_size > size) || (file_size == 0)) + file_size = size; + + printf("Reading IQ samples from file: File Size: %d [Buffer Size: %d]\n", file_size, size); + + num = fread(pBuffer, buffers_num, size, file); + fflush(file); + fclose(file); + printf("from addr (0x%lx) size (%d) bytes num (%d)", (uint64_t)pBuffer, file_size, num); + } + printf(" \n"); + + } + else + { + print_err(" the file name, buffer name are not set!!!"); + } + } + else + { + print_err(" the %s is free: size = %d bytes!!!", bufname, size); + } + return num; +} + + +void sys_save_buf_to_file_txt(char *filename, char *bufname, unsigned char *pBuffer, unsigned int size, unsigned int buffers_num) +{ + unsigned int i; + int ret = 0; + if (pBuffer == NULL) + return; + + if (size) + { + if (filename && bufname) + { + FILE *file; + printf("Storing %s to file %s: ", bufname, filename); + file = fopen(filename, "w"); + if (file == NULL) + { + print_err("can't open file %s!!!", filename); + exit(-1); + } + else + { + uint32_t num = 0; + + signed short *ptr = (signed short*)pBuffer; + for (i = 0; i < (size/((unsigned int)sizeof(signed short) /** 2 * 2 * 2*/)); i = i + 2) + { + ret = fprintf(file,"%d %d\n", ptr[i], ptr[i + 1]); + if (ret < 0) + { + printf("fprintf %d\n", ret); + fclose(file); + break; + } + num++; + } + fflush(file); + fclose(file); + printf("from addr (0x%lx) size (%d) IQ num (%d)", (uint64_t)pBuffer, size, num); + } + printf(" \n"); + } + else + { + print_err(" the file name, buffer name are not set!!!"); + } + } + else + { + print_err(" the %s is free: size = %d bytes!!!", bufname, size); + } +} + + +#endif /* _XRAN_APP_COMMON_ */ diff --git a/fhi_lib/app/common/common.h b/fhi_lib/app/common/common.h new file mode 100644 index 0000000..fb4400d --- /dev/null +++ b/fhi_lib/app/common/common.h @@ -0,0 +1,99 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + +#include +#include + +#include "xran_pkt_up.h" + +#include +#include + +#define APP_LLS_CU 0 +#define APP_RU 1 + +enum app_state +{ + APP_RUNNING, + APP_STOPPED +}; + +#define NUM_OF_PRB_IN_FULL_BAND (66) +#define N_SC_PER_PRB 12 +#define N_SYM_PER_SLOT 14 +#define N_FULLBAND_SC (NUM_OF_PRB_IN_FULL_BAND*N_SC_PER_PRB) +#define MAX_ANT_CARRIER_SUPPORTED 16 +// 0.125, just for testing +#define SLOTNUM_PER_SUBFRAME 8 +#define SUBFRAMES_PER_SYSTEMFRAME 10 +#define PDSCH_PAYLOAD_SIZE (N_FULLBAND_SC*4) +#define NUM_OF_SLOT_IN_TDD_LOOP (80) +#define IQ_PLAYBACK_BUFFER_BYTES (NUM_OF_SLOT_IN_TDD_LOOP*N_SYM_PER_SLOT*N_FULLBAND_SC*4L) +/* PRACH data samples are 32 bits wide, 16bits for I and 16bits for Q. Each packet contains 839 samples. The payload length is 3356 octets.*/ +#define PRACH_PLAYBACK_BUFFER_BYTES (10*839*4L) + +#ifdef _DEBUG +#define iAssert(p) if(!(p)){fprintf(stderr,\ + "Assertion failed: %s, file %s, line %d, val %d\n",\ + #p, __FILE__, __LINE__, p);exit(-1);} +#else /* _DEBUG */ +#define iAssert(p) +#endif /* _DEBUG */ + +struct send_symbol_cb_args +{ + struct rb_map *samp_buf; + uint8_t *symb_id; +}; + +struct pkt_dump +{ + int num_samp; + int num_bytes; + uint8_t symb; + struct ecpri_seq_id seq; +} __rte_packed; + +extern uint8_t numCCPorts; +/* Number of antennas supported by front-end */ + +extern uint8_t num_eAxc; +/* Number of antennas supported by front-end */ +extern int16_t *p_tx_play_buffer[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t tx_play_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t tx_play_buffer_position[MAX_ANT_CARRIER_SUPPORTED]; + +/* Number of antennas supported by front-end */ +extern int16_t *p_rx_log_buffer[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t rx_log_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t rx_log_buffer_position[MAX_ANT_CARRIER_SUPPORTED]; + +extern int16_t *p_prach_log_buffer[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t prach_log_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t prach_log_buffer_position[MAX_ANT_CARRIER_SUPPORTED]; + +extern int16_t *p_tx_buffer[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t tx_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; + +extern int16_t *p_rx_buffer[MAX_ANT_CARRIER_SUPPORTED]; +extern int32_t rx_buffer_size[MAX_ANT_CARRIER_SUPPORTED]; + +void sys_save_buf_to_file_txt(char *filename, char *bufname, unsigned char *pBuffer, unsigned int size, unsigned int buffers_num); +void sys_save_buf_to_file(char *filename, char *bufname, unsigned char *pBuffer, unsigned int size, unsigned int buffers_num); +int sys_load_file_to_buff(char *filename, char *bufname, unsigned char *pBuffer, unsigned int size, unsigned int buffers_num); + diff --git a/fhi_lib/app/config_file_lls_cu.dat b/fhi_lib/app/config_file_lls_cu.dat new file mode 100644 index 0000000..7a17943 --- /dev/null +++ b/fhi_lib/app/config_file_lls_cu.dat @@ -0,0 +1,92 @@ +####################################################################### +# +# +# +####################################################################### + +# This is simple configuration file. Use '#' sign for comments +appMode=0 # lls-CU(0) | RU(1) +xranMode=0 # Category A (0) (precoder in lls-CU) | Category B (1) (precoder in RU) +ccNum=1 # Number of Componnent Carriers (CC) per ETH port with XRAN protocol (default:1 max: 4) +##Numerology +mu=3 #mmWave 120Khz Sub Carrier Spacing +antNum=4 # Number of Antennas per CC (default: 4) +ttiPeriod=125 # in us TTI period (mmWave default 125us) +llsCUMac=00:11:22:33:44:66 # asigned MAC of lls-CU VF +ruMac=00:11:22:33:44:55 #RU VF for RU app +#ruMac=3c:fd:fe:b1:d8:98 #RU PF for tcpdump +#56:1e:4b:0c:f5:9b # RU MAC +antC0=./ant_0.bin #CC0 +antC1=./ant_1.bin #CC0 +antC2=./ant_2.bin #CC0 +antC3=./ant_3.bin #CC0 +antC4=./ant_4.bin #CC1 +antC5=./ant_5.bin #CC1 +antC6=./ant_6.bin #CC1 +antC7=./ant_7.bin #CC1 +antC8=./ant_8.bin #CC2 +antC9=./ant_9.bin #CC2 +antC10=./ant_10.bin #CC2 +antC11=./ant_11.bin #CC2 +antC12=./ant_12.bin #CC3 +antC13=./ant_13.bin #CC3 +antC14=./ant_14.bin #CC3 +antC15=./ant_15.bin #CC3 + +## RACH TODO: update for PRACH +#rachEanble=1 # Enable (1)| disable (0) PRACH configuration +#rachOffset=43 # RB offset for prach detection (see RIU spec) +#rachCfgIdx=14 # PRACH config index as per TS36.211 - Table 5.7.1-2 : PRACH Configuration Index + +## control of IQ byte order +iqswap=0 #do swap of IQ before send buffer to eth +nebyteorderswap=0 #do swap of byte order for each I and Q from CPU byte order to network byte order + +##Debug +debugStop=0 #stop app on 1pps boundary (gps_second % 30) + +CPenable=1 #(1) C-Plane is enabled| (0) C-Plane is disabled +c_plane_vlan_tag=1 #VLAN Tag used for C-Plane +u_plane_vlan_tag=2 #VLAN Tag used for U-Plane + +##RU Settings +Tadv_cp_dl=25 #in us TODO: update per RU implementation + #C-Plane messages must arrive at the RU some amount of time in advance (Tcp_adv_dl) of the corresponding U-Plane messages + +#Reception Window C-plane DL +T2a_min_cp_dl=50 #in us TODO: update per RU implementation +T2a_max_cp_dl=140 #in us TODO: update per RU implementation + +#Reception Window C-plane UL +T2a_min_cp_ul=50 #in us TODO: update per RU implementation +T2a_max_cp_ul=140 #in us TODO: update per RU implementation + +#Reception Window U-plane +T2a_min_up=25 #in us +T2a_max_up=140 #in us + +#Transmission Window +Ta3_min=20 #in us +Ta3_max=32 #in us + +########################################################### +##lls-CU Settings +#C-plane +#Transmission Window Fast C-plane DL +T1a_min_cp_dl=70 +T1a_max_cp_dl=100 + +##Transmission Window Fast C-plane UL +T1a_min_cp_ul=70 +T1a_max_cp_ul=80 + +#U-plane +##Transmission Window +T1a_min_up=35 +T1a_max_up=50 + +#Reception Window +Ta4_min=0 +Ta4_max=45 +########################################################### + diff --git a/fhi_lib/app/config_file_ru.dat b/fhi_lib/app/config_file_ru.dat new file mode 100644 index 0000000..d1edf90 --- /dev/null +++ b/fhi_lib/app/config_file_ru.dat @@ -0,0 +1,92 @@ +####################################################################### +# +# +# +####################################################################### + +# This is simple configuration file. Use '#' sign for comments +appMode=1 # lls-CU(0) | RU(1) +xranMode=0 # Category A (0) (precoder in lls-CU) | Category B (1) (precoder in RU) +ccNum=1 # Number of Componnent Carriers (CC) per ETH port with XRAN protocol (default:1 max: 4) +##Numerology +mu=3 #mmWave 120Khz Sub Carrier Spacing +antNum=4 # Number of Antennas per CC (default: 4) +ttiPeriod=125 # in us TTI period (mmWave default 125us) +llsCUMac=00:11:22:33:44:66 # asigned MAC of lls-CU VF +#llsCUMac=3c:fd:fe:9e:93:68 # PF for tcpdump +ruMac=00:11:22:33:44:55 +#56:1e:4b:0c:f5:9b # RU MAC +antC0=./ant_0.bin #CC0 +antC1=./ant_1.bin #CC0 +antC2=./ant_2.bin #CC0 +antC3=./ant_3.bin #CC0 +antC4=./ant_4.bin #CC1 +antC5=./ant_5.bin #CC1 +antC6=./ant_6.bin #CC1 +antC7=./ant_7.bin #CC1 +antC8=./ant_8.bin #CC2 +antC9=./ant_9.bin #CC2 +antC10=./ant_10.bin #CC2 +antC11=./ant_11.bin #CC2 +antC12=./ant_12.bin #CC3 +antC13=./ant_13.bin #CC3 +antC14=./ant_14.bin #CC3 +antC15=./ant_15.bin #CC3 + +## RACH TODO: update for PRACH +#rachEanble=1 # Enable (1)| disable (0) PRACH configuration +#rachOffset=43 # RB offset for prach detection (see RIU spec) +#rachCfgIdx=14 # PRACH config index as per TS36.211 - Table 5.7.1-2 : PRACH Configuration Index + +## control of IQ byte order +iqswap=0 #do swap of IQ before send buffer to eth +nebyteorderswap=0 #do swap of byte order for each I and Q from CPU byte order to network byte order + +##Debug +debugStop=0 #stop app on 1pps boundary (gps_second % 30) + +CPenable=0 #(1) C-Plane is enabled| 0 C-Plane is disabled +c_plane_vlan_tag=1 #VLAN Tag used for C-Plane +u_plane_vlan_tag=2 #VLAN Tag used for U-Plane + +##RU Settings +Tadv_cp_dl=25 #in us TODO: update per RU implementation + #C-Plane messages must arrive at the RU some amount of time in advance (Tcp_adv_dl) of the corresponding U-Plane messages + +#Reception Window C-plane DL +T2a_min_cp_dl=50 #in us TODO: update per RU implementation +T2a_max_cp_dl=140 #in us TODO: update per RU implementation + +#Reception Window C-plane UL +T2a_min_cp_ul=50 #in us TODO: update per RU implementation +T2a_max_cp_ul=140 #in us TODO: update per RU implementation + +#Reception Window U-plane +T2a_min_up=25 #in us +T2a_max_up=140 #in us + +#Transmission Window +Ta3_min=20 #in us +Ta3_max=32 #in us + +########################################################### +##lls-CU Settings +#C-plane +#Transmission Window Fast C-plane DL +T1a_min_cp_dl=70 +T1a_max_cp_dl=100 + +##Transmission Window Fast C-plane UL +T1a_min_cp_ul=70 +T1a_max_cp_ul=80 + +#U-plane +##Transmission Window +T1a_min_up=35 +T1a_max_up=50 + +#Reception Window +Ta4_min=10 +Ta4_max=100 +########################################################### + diff --git a/fhi_lib/app/dpdk.sh b/fhi_lib/app/dpdk.sh new file mode 100644 index 0000000..96bb84f --- /dev/null +++ b/fhi_lib/app/dpdk.sh @@ -0,0 +1,97 @@ +#! /bin/bash + +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ + +export RTE_SDK=/home/turner/dpdk +export RTE_TARGET=x86_64-native-linuxapp-icc + +# +# Unloads igb_uio.ko. +# +remove_igb_uio_module() +{ + echo "Unloading any existing DPDK UIO module" + /sbin/lsmod | grep -s igb_uio > /dev/null + if [ $? -eq 0 ] ; then + sudo /sbin/rmmod igb_uio + fi +} + +# +# Loads new igb_uio.ko (and uio module if needed). +# +load_igb_uio_module() +{ + if [ ! -f $RTE_SDK/$RTE_TARGET/kmod/igb_uio.ko ];then + echo "## ERROR: Target does not have the DPDK UIO Kernel Module." + echo " To fix, please try to rebuild target." + return + fi + + remove_igb_uio_module + + /sbin/lsmod | grep -s uio > /dev/null + if [ $? -ne 0 ] ; then + if [ -f /lib/modules/$(uname -r)/kernel/drivers/uio/uio.ko ] ; then + echo "Loading uio module" + sudo /sbin/modprobe uio + fi + fi + + # UIO may be compiled into kernel, so it may not be an error if it can't + # be loaded. + + echo "Loading DPDK UIO module" + sudo /sbin/insmod $RTE_SDK/$RTE_TARGET/kmod/igb_uio.ko + if [ $? -ne 0 ] ; then + echo "## ERROR: Could not load kmod/igb_uio.ko." + quit + fi +} + +load_igb_uio_module + +CPU_FEATURES_DETECT=`cat /proc/cpuinfo |grep hypervisor | wc -l` + +if [ "$CPU_FEATURES_DETECT" -eq "0" ] +then +VM_DETECT='HOST' +echo ${VM_DETECT} +else +VM_DETECT='VM' +echo ${VM_DETECT} +fi + +$RTE_SDK/usertools/dpdk-devbind.py --status +if [ ${VM_DETECT} == 'HOST' ]; then + #HOST + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:d8:02.0 + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:d8:02.1 + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:07:02.0 + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:07:02.1 +else + #VM + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:00:04.0 + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:00:05.0 + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:00:06.0 + $RTE_SDK/usertools/dpdk-devbind.py --bind=igb_uio 0000:00:07.0 +fi + +$RTE_SDK/usertools/dpdk-devbind.py --status + diff --git a/fhi_lib/app/gen_test.m b/fhi_lib/app/gen_test.m new file mode 100644 index 0000000..b93736c --- /dev/null +++ b/fhi_lib/app/gen_test.m @@ -0,0 +1,130 @@ +%/****************************************************************************** +%* +%* 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. +%* +%*******************************************************************************/ + +%Matlab: read bin +%fileID_c = fopen('ant_7.bin','r'); +%ant7_c= fread(fileID_c, [2, 792*14*80], 'integer*2'); +%ant7_c; +%ant7_c=ant7_c.'; + +close all; +clear all; + +ifft_in = load('ifft_in.txt') +ant_c = ifft_in; +for (i=1:1:80*14-1) + ant_c = [ant_c; ifft_in]; +end + +ant0=ant_c; +ant1=ant_c*10; +ant2=ant_c*20; +ant3=ant_c*30; +ant4=ant_c*40; +ant5=ant_c*50; +ant6=ant_c*60; +ant7=ant_c*70; +ant8=ant_c*80; +ant9=ant_c*90; +ant10=ant_c*100; +ant11=ant_c*110; +ant12=ant_c*120; +ant13=ant_c*130; +ant14=ant_c*140; +ant15=ant_c*150; + + +ant0_16=int16(ant0.'); +fileID = fopen('ant_0.bin','w'); +fwrite(fileID,ant0_16, 'int16'); +fclose(fileID); + +ant1_16=int16(ant1.'); +fileID = fopen('ant_1.bin','w'); +fwrite(fileID,ant1_16, 'int16'); +fclose(fileID); + +ant2_16=int16(ant2.'); +fileID = fopen('ant_2.bin','w'); +fwrite(fileID,ant2_16, 'int16'); +fclose(fileID); + +ant3_16=int16(ant3.'); +fileID = fopen('ant_3.bin','w'); +fwrite(fileID,ant3_16, 'int16'); +fclose(fileID); + +ant4_16=int16(ant4.'); +fileID = fopen('ant_4.bin','w'); +fwrite(fileID,ant4_16, 'int16'); +fclose(fileID); + +ant5_16=int16(ant5.'); +fileID = fopen('ant_5.bin','w'); +fwrite(fileID,ant5_16, 'int16'); +fclose(fileID); + +ant6_16=int16(ant6.'); +fileID = fopen('ant_6.bin','w'); +fwrite(fileID,ant6_16, 'int16'); +fclose(fileID); + +ant7_16=int16(ant7.'); +fileID = fopen('ant_7.bin','w'); +fwrite(fileID,ant7_16, 'int16'); +fclose(fileID); + +ant8_16=int16(ant8.'); +fileID = fopen('ant_8.bin','w'); +fwrite(fileID,ant8_16, 'int16'); +fclose(fileID); + +ant9_16=int16(ant9.'); +fileID = fopen('ant_9.bin','w'); +fwrite(fileID,ant9_16, 'int16'); +fclose(fileID); + +ant10_16=int16(ant10.'); +fileID = fopen('ant_10.bin','w'); +fwrite(fileID,ant10_16, 'int16'); +fclose(fileID); + +ant11_16=int16(ant11.'); +fileID = fopen('ant_11.bin','w'); +fwrite(fileID,ant11_16, 'int16'); +fclose(fileID); + +ant12_16=int16(ant12.'); +fileID = fopen('ant_12.bin','w'); +fwrite(fileID,ant12_16, 'int16'); +fclose(fileID); + +ant13_16=int16(ant13.'); +fileID = fopen('ant_13.bin','w'); +fwrite(fileID,ant13_16, 'int16'); +fclose(fileID); + +ant14_16=int16(ant14.'); +fileID = fopen('ant_14.bin','w'); +fwrite(fileID,ant14_16, 'int16'); +fclose(fileID); + +ant15_16=int16(ant15.'); +fileID = fopen('ant_15.bin','w'); +fwrite(fileID,ant15_16, 'int16'); +fclose(fileID); diff --git a/fhi_lib/app/lls-cu/Makefile b/fhi_lib/app/lls-cu/Makefile new file mode 100644 index 0000000..86aa9cc --- /dev/null +++ b/fhi_lib/app/lls-cu/Makefile @@ -0,0 +1,90 @@ +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ +CC := icc + +ifeq ($(RTE_SDK),) + $(error "Please define RTE_SDK environment variable") +endif + +RTE_TARGET := x86_64-native-linuxapp-icc +RTE_INC := $(RTE_SDK)/$(RTE_TARGET)/include +#include $(RTE_SDK)/mk/rte.vars.mk + +ifeq ($(XRAN_DIR),) + XRAN_DIR=$(PWD)/../.. +endif + +COMMON_SRC=$(XRAN_DIR)/app/common +SRC_SRC=$(XRAN_DIR)/app/src + +ifeq ($(MLOG_DIR),) + MLOG_DIR=$(XRAN_DIR)/../mlog +endif + +APP = sample-lls-cu +SRC = $(COMMON_SRC)/common.c \ + ./sample-lls-cu.c \ + $(SRC_SRC)/config.c + +CFLAGS += -std=gnu11 -Wall -wd9 -Wextra -Werror -I$(XRAN_DIR)/lib/api -I$(COMMON_SRC) -I$(SRC_SRC) -I$(MLOG_DIR)/source -I$(RTE_INC) +ifeq ($(ME),1) + CFLAGS += -DMLOG_ENABLED +endif +ifeq ($(NB),1) + CFLAGS += -DNightly_build +endif + +ifeq ($(DEBUG),1) + CFLAGS += -DDEBUG -O0 -g +else + CFLAGS += -O3 +endif + +ifeq ($(MULTI_SECTION),1) + CFLAGS += -DMULTI_SECTION +endif + +LDFLAGS += -pthread -lrt + +RTE_LIBS = -L$(RTE_SDK)/$(RTE_TARGET)/lib -Wl,-lrte_flow_classify -Wl,--whole-archive -Wl,-lrte_pipeline -Wl,--no-whole-archive -Wl,--whole-archive -Wl,-lrte_table -Wl,--no-whole-archive -Wl,--whole-archive -Wl,-lrte_port -Wl,--no-whole-archive -Wl,-lrte_pdump -Wl,-lrte_distributor -Wl,-lrte_ip_frag -Wl,-lrte_meter -Wl,-lrte_lpm -Wl,--whole-archive -Wl,-lrte_acl -Wl,--no-whole-archive -Wl,-lrte_jobstats -Wl,-lrte_metrics -Wl,-lrte_bitratestats -Wl,-lrte_latencystats -Wl,-lrte_power -Wl,-lrte_efd -Wl,-lrte_bpf -Wl,--whole-archive -Wl,-lrte_cfgfile -Wl,-lrte_gro -Wl,-lrte_gso -Wl,-lrte_hash -Wl,-lrte_member -Wl,-lrte_vhost -Wl,-lrte_kvargs -Wl,-lrte_mbuf -Wl,-lrte_net -Wl,-lrte_ethdev -Wl,-lrte_bbdev -Wl,-lrte_cryptodev -Wl,-lrte_security -Wl,-lrte_compressdev -Wl,-lrte_eventdev -Wl,-lrte_rawdev -Wl,-lrte_timer -Wl,-lrte_mempool -Wl,-lrte_mempool_ring -Wl,-lrte_ring -Wl,-lrte_pci -Wl,-lrte_eal -Wl,-lrte_cmdline -Wl,-lrte_reorder -Wl,-lrte_sched -Wl,-lrte_kni -Wl,-lrte_common_octeontx -Wl,-lrte_bus_pci -Wl,-lrte_bus_vdev -Wl,-lrte_bus_dpaa -Wl,-lrte_bus_fslmc -Wl,-lrte_mempool_bucket -Wl,-lrte_mempool_stack -Wl,-lrte_mempool_dpaa -Wl,-lrte_mempool_dpaa2 -Wl,-lrte_pmd_af_packet -Wl,-lrte_pmd_ark -Wl,-lrte_pmd_avf -Wl,-lrte_pmd_avp -Wl,-lrte_pmd_axgbe -Wl,-lrte_pmd_bnxt -Wl,-lrte_pmd_bond -Wl,-lrte_pmd_cxgbe -Wl,-lrte_pmd_dpaa -Wl,-lrte_pmd_dpaa2 -Wl,-lrte_pmd_e1000 -Wl,-lrte_pmd_ena -Wl,-lrte_pmd_enic -Wl,-lrte_pmd_fm10k -Wl,-lrte_pmd_failsafe -Wl,-lrte_pmd_i40e -Wl,-lrte_pmd_ixgbe -Wl,-lrte_pmd_kni -Wl,-lrte_pmd_lio -Wl,-lrte_pmd_nfp -Wl,-lrte_pmd_null -Wl,-lrte_pmd_qede -Wl,-lrte_pmd_ring -Wl,-lrte_pmd_softnic -Wl,-lrte_pmd_tap -Wl,-lrte_pmd_thunderx_nicvf -Wl,-lrte_pmd_vdev_netvsc -Wl,-lrte_pmd_virtio -Wl,-lrte_pmd_vhost -Wl,-lrte_pmd_ifc -Wl,-lrte_pmd_vmxnet3_uio -Wl,-lrte_bus_vmbus -Wl,-lrte_pmd_netvsc -Wl,-lrte_pmd_bbdev_null -Wl,-lrte_pmd_null_crypto -Wl,-lrte_pmd_crypto_scheduler -Wl,-lrte_pmd_dpaa2_sec -Wl,-lrte_pmd_dpaa_sec -Wl,-lrte_pmd_virtio_crypto -Wl,-lrte_pmd_octeontx_zip -Wl,-lrte_pmd_qat -Wl,-lrte_pmd_skeleton_event -Wl,-lrte_pmd_sw_event -Wl,-lrte_pmd_octeontx_ssovf -Wl,-lrte_pmd_dpaa_event -Wl,-lrte_pmd_dpaa2_event -Wl,-lrte_mempool_octeontx -Wl,-lrte_pmd_octeontx -Wl,-lrte_pmd_opdl_event -Wl,-lrte_pmd_skeleton_rawdev -Wl,-lrte_pmd_dpaa2_cmdif -Wl,-lrte_pmd_dpaa2_qdma -Wl,-lrte_bus_ifpga -Wl,-lrte_pmd_ifpga_rawdev -Wl,--no-whole-archive -Wl,-lrt -Wl,-lm -Wl,-lnuma -Wl,-ldl -Wl, + +XRAN_LIB_DIR=$(XRAN_DIR)/lib/bin +LDFLAGS += -L$(XRAN_LIB_DIR) -Wl, -lxran -Wl, -L$(MLOG_DIR)/bin -Wl, $(RTE_LIBS) +ifeq ($(ME),1) + LDFLAGS += -Wl,-lmlog +endif + +OBJ = $(foreach file,$(SRC),$(file:.c=.o)) + + +all: $(APP) install + +$(OBJ): %.o: %.c + $(CC) $(CFLAGS) -c $< -o $@ + +$(APP): $(OBJ) + $(CC) -o $(APP) $(CFLAGS) $(OBJ) $(LDFLAGS) + +install: $(APP) + @mkdir -p bin + @cp $(APP) ./bin + +clean: + @rm -rf $(APP) $(OBJ) ./bin/$(APP) + +#include $(RTE_SDK)/mk/rte.extapp.mk diff --git a/fhi_lib/app/lls-cu/sample-lls-cu.c b/fhi_lib/app/lls-cu/sample-lls-cu.c new file mode 100644 index 0000000..31ffb4b --- /dev/null +++ b/fhi_lib/app/lls-cu/sample-lls-cu.c @@ -0,0 +1,1165 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + +#define _GNU_SOURCE +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "common.h" +#include "config.h" + +#ifndef MLOG_ENABLED +#include "../../lib/src/mlog_lnx_xRAN.h" +#else +#include "mlog_lnx.h" +#endif + + +#include "xran_fh_lls_cu.h" +//#include "xran_pkt.h" +//#include "xran_up_api.h" +#include "xran_cp_api.h" +#include "xran_sync_api.h" +#include "xran_mlog_task_id.h" + +#define SW_FPGA_TOTAL_BUFFER_LEN 4*1024*1024*1024 +#define SW_FPGA_SEGMENT_BUFFER_LEN 1*1024*1024*1024 +#define SW_FPGA_FH_TOTAL_BUFFER_LEN 1*1024*1024*1024 +#define FPGA_TO_SW_PRACH_RX_BUFFER_LEN (8192) + +#define NSEC_PER_SEC 1000000000 + +#define MAX_PKT_BURST (448+4) // 4x14x8 +#define N_MAX_BUFFER_SEGMENT MAX_PKT_BURST + +#define MAIN_PRIORITY 98 +#define NUM_OF_SUBFRAME_PER_FRAME (10) + +enum app_state state; + +uint64_t tick_per_usec; +static volatile uint64_t timer_last_irq_tick = 0; +static uint64_t tsc_resolution_hz = 0; + +RuntimeConfig startupConfiguration = {0}; + +//FH FPGA buffer +uint32_t nFpgaToSW_FTH_RxBufferLen; +uint32_t nFpgaToSW_PRACH_RxBufferLen; +uint32_t nSW_ToFpga_FTH_TxBufferLen; + +static XRANFHINIT xranInit; +void * xranHandle = NULL; + +XRANFHCONFIG xranConf; +PXRANFHCONFIG pXranConf = NULL; + +typedef struct +{ + uint32_t phaseFlag :1; + uint32_t NRARFCN :22; + uint32_t SULFreShift :1; + uint32_t SULFlag :1; + uint32_t rsv :7; +}FPGAPhaseCompCfg; + +typedef struct XranLibConfig +{ + uint32_t nDriverCoreId; + uint32_t nTimingAdvance; + uint32_t nFhConfig; + uint32_t nFhBufIntFlag; + uint32_t nSectorNum; + uint32_t nNrOfSlotInSf; + uint32_t nNrofSfInFrame; + void * pFthInstanceHandles; +}XranLibConfigStruct; +typedef enum { + XRANFTHTX_OUT = 0, + XRANFTHRX_IN, + XRANFTHRACH_IN, + MAX_SW_XRAN_INTERFACE_NUM +}SWXRANInterfaceTypeEnum; + +/* + * manage one cell's all Ethernet frames for one DL or UL LTE subframe + */ +typedef struct { + /* -1-this subframe is not used in current frame format + 0-this subframe can be transmitted, i.e., data is ready + 1-this subframe is waiting transmission, i.e., data is not ready + 10 - DL transmission missing deadline. When FE needs this subframe data but bValid is still 1, + set bValid to 10. + */ + int32_t bValid ; // when UL rx, it is subframe index. + int32_t nSegToBeGen; + int32_t nSegGenerated; // how many date segment are generated by DL LTE processing or received from FE + // -1 means that DL packet to be transmitted is not ready in BS + int32_t nSegTransferred; // number of data segments has been transmitted or received + struct rte_mbuf *pData[N_MAX_BUFFER_SEGMENT]; // point to DPDK allocated memory pool + XRANBufferListStruct sBufferList; +} BbuIoBufCtrlStruct; + +typedef struct { + uint64_t nCoreMask; + int16_t cpuSocketId; + uint8_t nDriverCoreId; + uint8_t nFHCoreId; + + struct rte_mempool *bbuio_buf_pool; + + /* io struct */ + BbuIoBufCtrlStruct sFrontHaulTxBbuIoBufCtrl[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR]; + BbuIoBufCtrlStruct sFrontHaulRxBbuIoBufCtrl[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR]; + BbuIoBufCtrlStruct sFHPrachRxBbuIoBufCtrl[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR]; + + /* buffers lists */ + XRANFlatBufferStruct sFrontHaulTxBuffers[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + XRANFlatBufferStruct sFrontHaulRxBuffers[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + XRANFlatBufferStruct sFHPrachRxBuffers[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + + void* nInstanceHandle[XRAN_PORTS_NUM][XRAN_MAX_SECTOR_NR]; // instance per sector + uint32_t nBufPoolIndex[XRAN_MAX_SECTOR_NR][MAX_SW_XRAN_INTERFACE_NUM]; // every api owns unique buffer pool + uint16_t nInstanceNum; + + /*subframe type for this TTI: + 0: DL control + DL data + 1: DL control + DL data + UL control + 2: DL control + UL data + 3: DL control + UL data + UL control + */ + uint8_t nSubframeType; + + uint64_t nTscTiming[XRAN_N_FE_BUF_LEN]; // records the TSC when a timing packet is received. +} BbuXranIoIfStruct; + +static BbuXranIoIfStruct gsXranIoIf; +static XranLibConfigStruct *gpXranLibConfig = NULL; + +#define CPU_HZ tick_per_usec //us + +/* Application User space functions */ +void xran_fh_rx_callback(void *pCallbackTag, int32_t status); +void xran_fh_rx_prach_callback(void *pCallbackTag, int32_t status); + +static BbuXranIoIfStruct *xran_get_ctx(void) +{ + return &gsXranIoIf; +} + +static void print_menu() +{ + puts("+---------------------------------------+"); + puts("| Press 1 to start 5G NR XRAN traffic |"); + puts("| Press 2 reserved for future use |"); + puts("| Press 3 to quit |"); + puts("+---------------------------------------+"); +} + +void xran_fh_rx_callback(void *pCallbackTag, XranStatusInt32 status) +{ + uint64_t t1 = MLogTick(); + uint32_t mlogVar[10]; + uint32_t mlogVarCnt = 0; + + mlogVar[mlogVarCnt++] = 0xCCCCCCCC; + mlogVar[mlogVarCnt++] = status >> 16; /* tti */ + mlogVar[mlogVarCnt++] = status & 0xFF; /* sym */ + MLogAddVariables(mlogVarCnt, mlogVar, MLogTick()); + rte_pause(); + + MLogTask(PID_GNB_SYM_CB, t1, MLogTick()); + return; +} + +void xran_fh_rx_prach_callback(void *pCallbackTag, XranStatusInt32 status) +{ + uint64_t t1 = MLogTick(); + rte_pause(); + MLogTask(PID_GNB_PRACH_CB, t1, MLogTick()); +} + +//------------------------------------------------------------------------------------------- +/** @ingroup group_nbiot_source_auxlib_timer + * + * @param void + * + * @return Ticks + * + * @description + * This function reads the rtdsc clock and returns the current value in there. + * +**/ +//------------------------------------------------------------------------------------------- +unsigned long timer_get_ticks(void) +{ + unsigned long ret; + union + { + unsigned long tsc_64; + struct + { + uint32_t lo_32; + uint32_t hi_32; + }; + } tsc; + + __asm volatile("rdtsc" : + "=a" (tsc.lo_32), + "=d" (tsc.hi_32)); + + ret = ((unsigned long)tsc.tsc_64); + return ret; +} + +//------------------------------------------------------------------------------------------- +/** @ingroup group_lte_source_auxlib_timer + * + * @param void + * + * @return 0 if SUCCESS + * + * @description + * This function gets the clock speed of the core and figures out number of ticks per usec. + * It is used by l1app and testmac applications to initialize the mlog utility + * +**/ +//------------------------------------------------------------------------------------------- +int timer_set_tsc_freq_from_clock(void) +{ +#define NS_PER_SEC 1E9 + struct timespec sleeptime = {.tv_nsec = 5E8 }; /* 1/2 second */ + struct timespec t_start, t_end; + uint64_t tsc_resolution_hz = 0; + + if (clock_gettime(CLOCK_MONOTONIC_RAW, &t_start) == 0) + { + unsigned long ns, end, start = timer_get_ticks(); + nanosleep(&sleeptime,NULL); + clock_gettime(CLOCK_MONOTONIC_RAW, &t_end); + end = timer_get_ticks(); + ns = ((t_end.tv_sec - t_start.tv_sec) * NS_PER_SEC); + ns += (t_end.tv_nsec - t_start.tv_nsec); + + double secs = (double)ns/NS_PER_SEC; + tsc_resolution_hz = (unsigned long)((end - start)/secs); + + tick_per_usec = (tsc_resolution_hz / 1000000); + printf("System clock (rdtsc) resolution %lu [Hz]\n", tsc_resolution_hz); + printf("Ticks per us %lu\n", tick_per_usec); + return 0; + } + + return -1; +} + +int physide_dl_tti_call_back(void * param) +{ + uint64_t t1 = MLogTick(); + rte_pause(); + MLogTask(PID_GNB_PROC_TIMING, t1, MLogTick()); + return 0; +} + +int physide_ul_half_slot_call_back(void * param) +{ + uint64_t t1 = MLogTick(); + rte_pause(); + MLogTask(PID_GNB_PROC_TIMING, t1, MLogTick()); + return 0; +} + +int physide_ul_full_slot_call_back(void * param) +{ + uint64_t t1 = MLogTick(); + rte_pause(); + MLogTask(PID_GNB_PROC_TIMING, t1, MLogTick()); + return 0; +} + +int32_t init_xran(void) +{ + BbuXranIoIfStruct *psBbuIo = xran_get_ctx(); + XranStatusInt32 status; + int32_t nSectorIndex[XRAN_MAX_SECTOR_NR]; + int32_t nSectorNum; + int32_t i, j, k, z; + + void *ptr; + uint32_t *u32dptr; + uint16_t *u16dptr; + uint8_t *u8dptr; + + SWXRANInterfaceTypeEnum eInterfaceType; + + XranLibConfigStruct *ptrLibConfig; + + XRANBufferListStruct *pFthTxBuffer[XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN]; + XRANBufferListStruct *pFthRxBuffer[XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN]; + XRANBufferListStruct *pFthRxRachBuffer[XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN]; + + FPGAPhaseCompCfg *pPhaseCompDl = NULL; + FPGAPhaseCompCfg *pPhaseCompUl = NULL; + uint32_t nPhaseCompDl,nPhaseCompUl; + + +#if 0 + printf("init_xran: nFpgaProbe[%d] nSecNum[%d] nUENum[%d] nTimeAdvance[%d] nEthPorts[%d] nPhaseCompFlag[%d]\n", + psFPGAInitPara->nFpgaProbe, psFPGAInitPara->nSecNum, psFPGAInitPara->nUENum, psFPGAInitPara->nTimeAdvance, psFPGAInitPara->nEthPorts, psFPGAInitPara->nPhaseCompFlag); + for (i = 0; i < nSectorNum; i ++) + { + printf(" [%d]: nDlArfcn[%d] nUlArfcn[%d]\n", i, psFPGAInitPara->nDlArfcn[i], psFPGAInitPara->nUlArfcn[i]); + } +#endif + for (nSectorNum = 0; nSectorNum < XRAN_MAX_SECTOR_NR; nSectorNum++) + { + nSectorIndex[nSectorNum] = nSectorNum; + } + + nSectorNum = numCCPorts; + printf ("XRAN front haul xran_mm_init \n"); + status = xran_mm_init (xranHandle, (uint64_t) SW_FPGA_FH_TOTAL_BUFFER_LEN, SW_FPGA_SEGMENT_BUFFER_LEN); + if (status != XRAN_STATUS_SUCCESS) + { + printf ("Failed at XRAN front haul xran_mm_init \n"); + exit(-1); + } + + psBbuIo->nInstanceNum = numCCPorts; + + for (k = 0; k < XRAN_PORTS_NUM; k++) { + status = xran_sector_get_instances (xranHandle, psBbuIo->nInstanceNum,psBbuIo->nInstanceHandle[k]); + if (status != XRAN_STATUS_SUCCESS) + { + printf ("get sector instance failed %d for XRAN nInstanceNum %d\n",k, psBbuIo->nInstanceNum); + exit(-1); + } + } + + printf("Sucess xran_mm_init \n"); + gpXranLibConfig = (XranLibConfigStruct*)malloc(sizeof(XranLibConfigStruct)); + ptrLibConfig = gpXranLibConfig; + if (ptrLibConfig) + { + #if 0 + ptrLibConfig->nDriverCoreId = psBbuIo->nDriverCoreId; + ptrLibConfig->pFecInstanceHandles = &(psBbuIo->nInstanceHandle[FPGA_FEC][0]); + ptrLibConfig->pFthInstanceHandles = &(psBbuIo->nInstanceHandle[FPGA_FRONTHAUL][0]); + ptrLibConfig->nTimingAdvance = psFPGAInitPara->nTimeAdvance; + ptrLibConfig->nFhConfig = psFPGAInitPara->nEthPorts; + ptrLibConfig->nFhBufIntFlag = 0; //need init fronthaul buffer, then set to 1. + ptrLibConfig->nNrofSfInFrame = NUM_OF_SUBFRAME_PER_FRAME; + ptrLibConfig->nNrOfSlotInSf = pConfigParams->nNumOfSlotPerSubframe; + if (pConfigParams->nNumerology < 3) + { + ptrLibConfig->nSectorNum = psFPGAInitPara->nSecNum; + } + #endif + } + else + { + printf ("could not allocate ptrLibConfig in init_xran\n"); + exit(-1); + } + + printf("nSectorNum %d\n", nSectorNum); + + /* Init Memory */ + for(i = 0; inBufPoolIndex[nSectorIndex[i]][eInterfaceType], + XRAN_N_FE_BUF_LEN*XRAN_MAX_ANTENNA_NR*XRAN_NUM_OF_SYMBOL_PER_SLOT, nSW_ToFpga_FTH_TxBufferLen); + if(XRAN_STATUS_SUCCESS != status) + { + printf("Failed at xran_bm_init , status %d\n", status); + iAssert(status == XRAN_STATUS_SUCCESS); + } + for(j = 0; j < XRAN_N_FE_BUF_LEN; j++) + { + for(z = 0; z < XRAN_MAX_ANTENNA_NR; z++){ + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].bValid = 0; + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].nSegGenerated = -1; + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].nSegToBeGen = -1; + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].nSegTransferred = 0; + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.nNumBuffers = XRAN_NUM_OF_SYMBOL_PER_SLOT; + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers = &psBbuIo->sFrontHaulTxBuffers[j][i][z][0]; + + for(k = 0; k < XRAN_NUM_OF_SYMBOL_PER_SLOT; k++) + { + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nElementLenInBytes = nSW_ToFpga_FTH_TxBufferLen; // 14 symbols 3200bytes/symbol + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nNumberOfElements = 1; + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nOffsetInBytes = 0; + status = xran_bm_allocate_buffer(xranHandle,psBbuIo->nBufPoolIndex[nSectorIndex[i]][eInterfaceType],&ptr); + if(XRAN_STATUS_SUCCESS != status) + { + printf("Failed at xran_bm_allocate_buffer , status %d\n",status); + iAssert(status == XRAN_STATUS_SUCCESS); + } + psBbuIo->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].pData = (uint8_t *)ptr; + + if(ptr){ + u32dptr = (uint32_t*)(ptr); + uint8_t *ptr_temp = (uint8_t *)ptr; + memset(u32dptr, 0xCC, nSW_ToFpga_FTH_TxBufferLen); + ptr_temp[0] = j; // TTI + ptr_temp[1] = i; // Sec + ptr_temp[2] = z; // Ant + ptr_temp[3] = k; // sym + } + } + } + } + } + + for(i = 0; inBufPoolIndex[nSectorIndex[i]][eInterfaceType], XRAN_N_FE_BUF_LEN*XRAN_MAX_ANTENNA_NR*XRAN_NUM_OF_SYMBOL_PER_SLOT, nSW_ToFpga_FTH_TxBufferLen); + if(XRAN_STATUS_SUCCESS != status) + { + printf("Failed at xran_bm_init, status %d\n", status); + iAssert(status == XRAN_STATUS_SUCCESS); + } + + for(j = 0;j < XRAN_N_FE_BUF_LEN; j++) + { + for(z = 0; z < XRAN_MAX_ANTENNA_NR; z++){ + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].bValid = 0; + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].nSegGenerated = -1; + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].nSegToBeGen = -1; + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].nSegTransferred = 0; + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.nNumBuffers = XRAN_NUM_OF_SYMBOL_PER_SLOT; + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers = &psBbuIo->sFrontHaulRxBuffers[j][i][z][0]; + for(k = 0; k< XRAN_NUM_OF_SYMBOL_PER_SLOT; k++) + { + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nElementLenInBytes = nFpgaToSW_FTH_RxBufferLen; // 1 symbols 3200bytes + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nNumberOfElements = 1; + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nOffsetInBytes = 0; + status = xran_bm_allocate_buffer(xranHandle,psBbuIo->nBufPoolIndex[nSectorIndex[i]][eInterfaceType],&ptr); + if(XRAN_STATUS_SUCCESS != status) + { + printf("Failed at cpa_bb_bm_allocate_buffer , status %d\n",status); + iAssert(status == XRAN_STATUS_SUCCESS); + } + psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].pData = (uint8_t *)ptr; + if(ptr){ + u32dptr = (uint32_t*)(ptr); + uint8_t *ptr_temp = (uint8_t *)ptr; + memset(u32dptr, 0xCC, nFpgaToSW_FTH_RxBufferLen); + ptr_temp[0] = j; // TTI + ptr_temp[1] = i; // Sec + ptr_temp[2] = z; // Ant + ptr_temp[3] = k; // sym + } + } + } + } + } + + // add prach rx buffer + for(i = 0; inBufPoolIndex[nSectorIndex[i]][eInterfaceType],XRAN_N_FE_BUF_LEN*XRAN_MAX_ANTENNA_NR*XRAN_NUM_OF_SYMBOL_PER_SLOT, FPGA_TO_SW_PRACH_RX_BUFFER_LEN); + if(XRAN_STATUS_SUCCESS != status) + { + printf("Failed at xran_bm_init, status %d\n", status); + iAssert(status == XRAN_STATUS_SUCCESS); + } + for(j = 0;j < XRAN_N_FE_BUF_LEN; j++) + { + for(z = 0; z < XRAN_MAX_ANTENNA_NR; z++){ + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].bValid = 0; + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].nSegGenerated = -1; + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].nSegToBeGen = -1; + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].nSegTransferred = 0; + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.nNumBuffers = XRAN_MAX_ANTENNA_NR; // ant number. + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers = &psBbuIo->sFHPrachRxBuffers[j][i][z][0]; + //for(k = 0; k< XRAN_NUM_OF_SYMBOL_PER_SLOT; k++) + k = 0; // one PRACH buffer per antenna per slot + { + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nElementLenInBytes = FPGA_TO_SW_PRACH_RX_BUFFER_LEN; + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nNumberOfElements = 1; + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].nOffsetInBytes = 0; + status = xran_bm_allocate_buffer(xranHandle,psBbuIo->nBufPoolIndex[nSectorIndex[i]][eInterfaceType],&ptr); + if(XRAN_STATUS_SUCCESS != status) + { + printf("Failed at xran_bm_allocate_buffer, status %d\n",status); + iAssert(status == XRAN_STATUS_SUCCESS); + } + psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].pData = (uint8_t *)ptr; + if(ptr){ + u32dptr = (uint32_t*)(ptr); + memset(u32dptr, 0xCC, FPGA_TO_SW_PRACH_RX_BUFFER_LEN); + } + } + } + } + } + + for(i=0; isFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList); + pFthRxBuffer[i][z][j] = &(psBbuIo->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList); + pFthRxRachBuffer[i][z][j] = &(psBbuIo->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList); + } + } + } + + if(NULL != psBbuIo->nInstanceHandle[0]) + { + for (i = 0; inInstanceHandle[0][i], + pFthTxBuffer[i], + pFthRxBuffer[i], + xran_fh_rx_callback, &pFthRxBuffer[i][0]); + } + + // add prach callback here + for (i = 0; inInstanceHandle[0][i], pFthRxRachBuffer[i], + xran_fh_rx_prach_callback,&pFthRxRachBuffer[i][0]); + } + ptrLibConfig->nFhBufIntFlag = 1; + } + + /*config phase compensation*/ + /* TODO: add phase compensation handling */ + for(i=0; iNRARFCN = 0;//psFPGAInitPara->nDlArfcn[i]; + pPhaseCompDl->phaseFlag = 0;//psFPGAInitPara->nPhaseCompFlag; + pPhaseCompDl->SULFlag = 0; + pPhaseCompDl->SULFreShift = 0; + pPhaseCompDl->rsv = 0; + + pPhaseCompUl = (FPGAPhaseCompCfg *)(&nPhaseCompUl); + pPhaseCompUl->NRARFCN = 0;//psFPGAInitPara->nUlArfcn[i]; + pPhaseCompUl->phaseFlag = 0;// psFPGAInitPara->nPhaseCompFlag; + pPhaseCompUl->SULFlag = 0; + pPhaseCompUl->SULFreShift = 0; + pPhaseCompUl->rsv = 0; + + xran_5g_pre_compenstor_cfg(psBbuIo->nInstanceHandle[0][i],nPhaseCompDl,nPhaseCompUl,i); + + printf("@@@ NB cell %d DL NR-ARFCN %d,DL phase comp flag %d UL NR-ARFCN %d,UL phase comp flag %d \n", + i,pPhaseCompDl->NRARFCN,pPhaseCompDl->phaseFlag, + pPhaseCompUl->NRARFCN,pPhaseCompUl->phaseFlag); + } + return status; +} + +int init_xran_iq_content(void) +{ + BbuXranIoIfStruct *psBbuIo = xran_get_ctx(); + XranStatusInt32 status; + int32_t nSectorIndex[XRAN_MAX_SECTOR_NR]; + int32_t nSectorNum; + int32_t cc_id, ant_id, sym_id, tti; + int32_t flowId; + + uint8_t frame_id = 0; + uint8_t subframe_id = 0; + uint8_t slot_id = 0; + uint8_t sym = 0; + + void *ptr; + uint32_t *u32dptr; + uint16_t *u16dptr; + uint8_t *u8dptr; + + char *pos = NULL; + + for (nSectorNum = 0; nSectorNum < XRAN_MAX_SECTOR_NR; nSectorNum++) + { + nSectorIndex[nSectorNum] = nSectorNum; + } + nSectorNum = numCCPorts; + printf ("init_xran_iq_content\n"); + + /* Init Memory */ + for(cc_id = 0; cc_id sFrontHaulTxBbuIoBufCtrl[tti][cc_id][ant_id].sBufferList.pBuffers[sym_id].pData; + + if(ptr){ + u32dptr = (uint32_t*)(ptr); + rte_memcpy(u32dptr, pos, PDSCH_PAYLOAD_SIZE); +#ifdef DEBUG_XRAN_BUFFERS + uint8_t *ptr_temp = (uint8_t *)ptr; + ptr_temp[0] = tti; // TTI + ptr_temp[1] = cc_id; // Sec + ptr_temp[2] = ant_id; // Ant + ptr_temp[3] = sym_id; // sym +#endif + }else + printf("ptr ==NULL\n"); + + tx_play_buffer_position[flowId] += PDSCH_PAYLOAD_SIZE; + + if(tx_play_buffer_position[flowId] >= tx_play_buffer_size[flowId]) + tx_play_buffer_position[flowId] = 0; + } else { + //printf("flowId %d\n", flowId); + } + } + } + } + + } + + return 0; +} + +void stop_xran(void) +{ + XranStatusInt32 status = 0; + SWXRANInterfaceTypeEnum eInterfaceType; + + free(gpXranLibConfig); + gpXranLibConfig = NULL; + + status += xran_mm_destroy(xranHandle)*2; + + if(XRAN_STATUS_SUCCESS != status) + { + printf("Failed at xran_mm_destroy, status %d\n",status); + iAssert(status == XRAN_STATUS_SUCCESS); + } +} + +int32_t get_xran_sfidx(uint8_t nNrOfSlotInSf) +{ + int32_t nSfIdx = -1; + uint32_t nFrameIdx; + uint32_t nSubframeIdx; + uint32_t nSlotIdx; + uint64_t nSecond; + + uint32_t nXranTime = xran_get_slot_idx(&nFrameIdx, &nSubframeIdx, &nSlotIdx, &nSecond); + nSfIdx = nFrameIdx*NUM_OF_SUBFRAME_PER_FRAME*nNrOfSlotInSf + + nSubframeIdx*nNrOfSlotInSf + + nSlotIdx; +#if 0 + printf("\nxranTime is %d, return is %d, radio frame is %d, subframe is %d slot is %d tsc is %llu us", + nXranTime, + nSfIdx, + nFrameIdx, + nSubframeIdx, + nSlotIdx, + __rdtsc()/CPU_HZ); +#endif + + return nSfIdx; +} + +int get_xran_iq_content(void) +{ + BbuXranIoIfStruct *psBbuIo = xran_get_ctx(); + XranStatusInt32 status; + int32_t nSectorIndex[XRAN_MAX_SECTOR_NR]; + int32_t nSectorNum; + int32_t cc_id, ant_id, sym_id, tti; + int32_t flowId; + + uint8_t frame_id = 0; + uint8_t subframe_id = 0; + uint8_t slot_id = 0; + uint8_t sym = 0; + + void *ptr; + uint32_t *u32dptr; + uint16_t *u16dptr; + uint8_t *u8dptr; + + char *pos = NULL; + + for (nSectorNum = 0; nSectorNum < XRAN_MAX_SECTOR_NR; nSectorNum++) + { + nSectorIndex[nSectorNum] = nSectorNum; + } + nSectorNum = numCCPorts; + printf ("get_xran_iq_content\n"); + + /* Init Memory */ + for(cc_id = 0; cc_id sFrontHaulRxBbuIoBufCtrl[tti][cc_id][ant_id].sBufferList.pBuffers[sym_id].pData; + if(ptr){ + u32dptr = (uint32_t*)(ptr); + rte_memcpy(pos, u32dptr, PDSCH_PAYLOAD_SIZE); +#ifdef DEBUG_XRAN_BUFFERS + if (pos[0] != tti|| + pos[1] != cc_id || + pos[2] != ant_id || + pos[3] != sym_id){ + printf("[flowId %d] %d %d %d %d\n", flowId, pos[0], pos[1], pos[2], pos[3]); + } +#endif + }else + printf("ptr ==NULL\n"); + + rx_log_buffer_position[flowId] += PDSCH_PAYLOAD_SIZE; + + if(rx_log_buffer_position[flowId] >= rx_log_buffer_size[flowId]) + rx_log_buffer_position[flowId] = 0; + } else { + //printf("flowId %d\n", flowId); + } + } + } + } + } + + return 0; +} + +int main(int argc, char *argv[]) +{ + int i; + int j; + int lcore_id = 0; + char filename[64]; + + if (argc == 3) + errx(2, "Need two argument - the PCI address of the network port"); + + if (xran_is_synchronized() != 0) + printf("Machine is not synchronized using PTP!\n"); + else + printf("Machine is synchronized using PTP!\n"); + + memset(&startupConfiguration, 0, sizeof(RuntimeConfig)); + + if (parseConfigFile(argv[1], &startupConfiguration) != 0) { + printf("Configuration file error.\n"); + return 0; + } + + if(startupConfiguration.ant_file[0] == NULL){ + printf("it looks like test vector for antennas were not provided\n"); + exit(-1); + } + + numCCPorts = startupConfiguration.numCC; + num_eAxc = startupConfiguration.numAxc; + + printf("numCCPorts %d num_eAxc%d\n", numCCPorts, num_eAxc); + + /* Numerology 3 */ + nFpgaToSW_FTH_RxBufferLen = 3328; //3200 * 14; + nFpgaToSW_PRACH_RxBufferLen = 8192; + nSW_ToFpga_FTH_TxBufferLen = 3328; //3200; * 14; + + memset(&xranInit, 0, sizeof(XRANFHINIT)); + + if(startupConfiguration.appMode == APP_LLS_CU) { + printf("set lls-CU\n"); + xranInit.io_cfg.id = 0;//ID_LLS_CU; + xranInit.io_cfg.core = 4+1; + xranInit.io_cfg.system_core = 0; + xranInit.io_cfg.pkt_proc_core = 4+2; + xranInit.io_cfg.pkt_aux_core = 0; /* do not start*/ + xranInit.io_cfg.timing_core = 4+3; + } else { + printf("set RU\n"); + xranInit.io_cfg.id = 1; /* ID_LLS_CU;*/ + xranInit.io_cfg.core = 1; + xranInit.io_cfg.system_core = 0; + xranInit.io_cfg.pkt_proc_core = 2; + xranInit.io_cfg.pkt_aux_core = 0; /* do not start */ + xranInit.io_cfg.timing_core = 3; + } + + xranInit.llscuId = 0; // for ecpriRtcid/ecpriPcid + xranInit.nSec = 1; // shall be one + + xranInit.eAxCId_conf.mask_cuPortId = 0xf000; + xranInit.eAxCId_conf.mask_bandSectorId = 0x0f00; + xranInit.eAxCId_conf.mask_ccId = 0x00f0; + xranInit.eAxCId_conf.mask_ruPortId = 0x000f; + xranInit.eAxCId_conf.bit_cuPortId = 12; + xranInit.eAxCId_conf.bit_bandSectorId = 8; + xranInit.eAxCId_conf.bit_ccId = 4; + xranInit.eAxCId_conf.bit_ruPortId = 0; + + xranInit.io_cfg.dpdk_dev[XRAN_UP_VF] = argv[2]; + xranInit.io_cfg.dpdk_dev[XRAN_CP_VF] = argv[3]; + xranInit.p_lls_cu_addr = (int8_t*)&startupConfiguration.lls_cu_addr; + xranInit.p_ru_addr = (int8_t*)&startupConfiguration.ru_addr; + xranInit.ttiPeriod = startupConfiguration.ttiPeriod; + + xranInit.Tadv_cp_dl = startupConfiguration.Tadv_cp_dl; + xranInit.T2a_min_cp_dl = startupConfiguration.T2a_min_cp_dl; + xranInit.T2a_max_cp_dl = startupConfiguration.T2a_max_cp_dl; + xranInit.T2a_min_cp_ul = startupConfiguration.T2a_min_cp_ul; + xranInit.T2a_max_cp_ul = startupConfiguration.T2a_max_cp_ul; + xranInit.T2a_min_up = startupConfiguration.T2a_min_up; + xranInit.T2a_max_up = startupConfiguration.T2a_max_up; + xranInit.Ta3_min = startupConfiguration.Ta3_min; + xranInit.Ta3_max = startupConfiguration.Ta3_max; + xranInit.T1a_min_cp_dl = startupConfiguration.T1a_min_cp_dl; + xranInit.T1a_max_cp_dl = startupConfiguration.T1a_max_cp_dl; + xranInit.T1a_min_cp_ul = startupConfiguration.T1a_min_cp_ul; + xranInit.T1a_max_cp_ul = startupConfiguration.T1a_max_cp_ul; + xranInit.T1a_min_up = startupConfiguration.T1a_min_up; + xranInit.T1a_max_up = startupConfiguration.T1a_max_up; + xranInit.Ta4_min = startupConfiguration.Ta4_min; + xranInit.Ta4_max = startupConfiguration.Ta4_max; + + xranInit.enableCP = startupConfiguration.enableCP; + xranInit.debugStop = startupConfiguration.debugStop; + + xranInit.cp_vlan_tag = startupConfiguration.cp_vlan_tag; + xranInit.up_vlan_tag = startupConfiguration.up_vlan_tag; + + + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + p_tx_play_buffer[i] = (int16_t*)malloc(IQ_PLAYBACK_BUFFER_BYTES); + tx_play_buffer_size[i] = (int32_t)IQ_PLAYBACK_BUFFER_BYTES; + + if (p_tx_play_buffer[i] == NULL) + exit(-1); + + tx_play_buffer_size[i] = sys_load_file_to_buff(startupConfiguration.ant_file[i], + "DL IFFT IN IQ Samples in binary format", + (uint8_t*) p_tx_play_buffer[i], + tx_play_buffer_size[i], + 1); + tx_play_buffer_position[i] = 0; + } + + /* log of ul */ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + p_rx_log_buffer[i] = (int16_t*)malloc(IQ_PLAYBACK_BUFFER_BYTES); + rx_log_buffer_size[i] = (int32_t)IQ_PLAYBACK_BUFFER_BYTES; + + if (p_rx_log_buffer[i] == NULL) + exit(-1); + + rx_log_buffer_position[i] = 0; + + memset(p_rx_log_buffer[i], 0, rx_log_buffer_size[i]); + } + + /* log of Prach */ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + p_prach_log_buffer[i] = (int16_t*)malloc(PRACH_PLAYBACK_BUFFER_BYTES); + prach_log_buffer_size[i] = (int32_t)PRACH_PLAYBACK_BUFFER_BYTES; + + if (p_prach_log_buffer[i] == NULL) + exit(-1); + + memset(p_prach_log_buffer[i], 0, prach_log_buffer_size[i]); + prach_log_buffer_position[i] = 0; + } + + for (i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + sprintf(filename, "%s-play_ant%d.txt",((startupConfiguration.appMode == APP_LLS_CU) ? "lls-cu" : "ru"), i); + sys_save_buf_to_file_txt(filename, + "DL IFFT IN IQ Samples in human readable format", + (uint8_t*) p_tx_play_buffer[i], + tx_play_buffer_size[i], + 1); + + sprintf(filename, "%s-play_ant%d.bin",((startupConfiguration.appMode == APP_LLS_CU) ? "lls-cu" : "ru"), i); + sys_save_buf_to_file(filename, + "DL IFFT IN IQ Samples in binary format", + (uint8_t*) p_tx_play_buffer[i], + tx_play_buffer_size[i]/sizeof(short), + sizeof(short)); + } + if (startupConfiguration.iqswap == 1){ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + printf("TX: Swap I and Q to match RU format: [%d]\n",i); + { + /* swap I and Q */ + int32_t j; + signed short *ptr = (signed short *) p_tx_play_buffer[i]; + signed short temp; + + for (j = 0; j < (int32_t)(tx_play_buffer_size[i]/sizeof(short)) ; j = j + 2){ + temp = ptr[j]; + ptr[j] = ptr[j + 1]; + ptr[j + 1] = temp; + } + } + } + } + +#if 0 + for (i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + sprintf(filename, "swap_IQ_play_ant%d.txt", i); + sys_save_buf_to_file_txt(filename, + "DL IFFT IN IQ Samples in human readable format", + (uint8_t*) p_tx_play_buffer[i], + tx_play_buffer_size[i], + 1); + } +#endif + if (startupConfiguration.nebyteorderswap == 1){ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + printf("TX: Convert S16 I and S16 Q to network byte order for XRAN Ant: [%d]\n",i); + for (j = 0; j < tx_play_buffer_size[i]/sizeof(short); j++){ + p_tx_play_buffer[i][j] = rte_cpu_to_be_16(p_tx_play_buffer[i][j]); + } + } + } + +#if 0 + for (i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + sprintf(filename, "swap_be_play_ant%d.txt", i); + sys_save_buf_to_file_txt(filename, + "DL IFFT IN IQ Samples in human readable format", + (uint8_t*) p_tx_play_buffer[i], + tx_play_buffer_size[i], + 1); + } +#endif + + timer_set_tsc_freq_from_clock(); + xran_init(argc, argv, &xranInit, argv[0], &xranHandle); + if(xranHandle == NULL) + exit(1); + + memset(&xranConf, 0, sizeof(XRANFHCONFIG)); + pXranConf = &xranConf; + + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + pXranConf->playback_conf.TxPlayBufAddr[i] = (unsigned long)p_tx_play_buffer[i]; + pXranConf->playback_conf.TxPlayBufSize = tx_play_buffer_size[i]; + } + + pXranConf->sector_id = 0; + pXranConf->nCC = numCCPorts; + pXranConf->neAxc = num_eAxc; + + pXranConf->frame_conf.nFrameDuplexType = 1; // TDD + pXranConf->frame_conf.nNumerology = startupConfiguration.mu_number; // 120KHz; same as XRAN_SCS_120KHz? +// pXranConf->frame_conf.nTddPeriod = ; + + pXranConf->prach_conf.nPrachSubcSpacing = XRAN_SCS_120KHZ; + pXranConf->prach_conf.nPrachFreqStart = 0; + pXranConf->prach_conf.nPrachFilterIdx = XRAN_FILTERINDEX_PRACH_ABC; + pXranConf->prach_conf.nPrachConfIdx = 81; + pXranConf->prach_conf.nPrachFreqOffset = -792; + + pXranConf->ru_conf.iqWidth = 16; + pXranConf->ru_conf.compMeth = XRAN_COMPMETHOD_NONE; + pXranConf->ru_conf.fftSize = XRAN_FFTSIZE_2048; + + + if(init_xran() != 0) + exit(-1); + + xran_reg_physide_cb(xranHandle, physide_dl_tti_call_back, NULL, 10, XRAN_CB_TTI); + xran_reg_physide_cb(xranHandle, physide_ul_half_slot_call_back, NULL, 10, XRAN_CB_HALF_SLOT_RX); + xran_reg_physide_cb(xranHandle, physide_ul_full_slot_call_back, NULL, 10, XRAN_CB_FULL_SLOT_RX); + + init_xran_iq_content(); + + xran_open(xranHandle, pXranConf); + + sprintf(filename, "mlog-%s", startupConfiguration.appMode == 0 ? "lls-cu" : "ru"); + + MLogOpen(0, 32, 0, 0xFFFFFFFF, filename); + puts("----------------------------------------"); + printf("MLog Info: virt=0x%016lx size=%d\n", MLogGetFileLocation(), MLogGetFileSize()); + puts("----------------------------------------"); + + state = APP_RUNNING; + sleep(6); + for (;;) { + print_menu(); + char input[10]; + int sel_opt; +//#ifdef Nightly_build +// sel_opt = 3; +// sleep(10); +//#else + if (NULL == fgets(input, 10, stdin)) { + state = APP_STOPPED; + break; + } + sel_opt = atoi(input); +//#endif + switch (sel_opt) { + case 1: + xran_start(xranHandle); + printf("Start XRAN traffic\n"); + break; + case 2: + break; + case 3: + xran_stop(xranHandle); + printf("Stop XRAN traffic\n"); + state = APP_STOPPED; + break; + case 4: +// send_cpmsg_dlul(XRAN_DIR_DL, flowId, +// frame_id, subframe_id, slot_id, +// 0, XRAN_SYMBOLPERSLOT_MAX, NUM_OF_PRB_IN_FULL_BAND, +// beam_id, cc_id, ant_id, +// cp_seq_id_num[XRAN_DIR_DL][ant_id]++); + break; + default: + puts("Wrong option passed!"); + break; + } + + if (APP_STOPPED == state) + break; + } + + get_xran_iq_content(); + + puts("Closing l1 app... Ending all threads..."); + xran_close(xranHandle); + MLogPrint(NULL); + + stop_xran(); + puts("Dump IQs..."); + + if (startupConfiguration.iqswap == 1){ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + printf("RX: Swap I and Q to match CPU format: [%d]\n",i); + { + /* swap I and Q */ + int32_t j; + signed short *ptr = (signed short *) p_rx_log_buffer[i]; + signed short temp; + + for (j = 0; j < (int32_t)(rx_log_buffer_size[i]/sizeof(short)) ; j = j + 2){ + temp = ptr[j]; + ptr[j] = ptr[j + 1]; + ptr[j + 1] = temp; + } + } + } + } + + if (startupConfiguration.nebyteorderswap == 1){ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + printf("RX: Convert S16 I and S16 Q to cpu byte order from XRAN Ant: [%d]\n",i); + for (j = 0; j < rx_log_buffer_size[i]/sizeof(short); j++){ + p_rx_log_buffer[i][j] = rte_be_to_cpu_16(p_rx_log_buffer[i][j]); + } + } + } + + for (i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + sprintf(filename, "%s-rx_log_ant%d.txt",((startupConfiguration.appMode == APP_LLS_CU) ? "lls-cu" : "ru"), i); + sys_save_buf_to_file_txt(filename, + "UL FFT OUT IQ Samples in human readable format", + (uint8_t*) p_rx_log_buffer[i], + rx_log_buffer_size[i], + 1); + + sprintf(filename, "%s-rx_log_ant%d.bin",((startupConfiguration.appMode == APP_LLS_CU) ? "lls-cu" : "ru"), i); + sys_save_buf_to_file(filename, + "UL FFT OUT IQ Samples in binary format", + (uint8_t*) p_rx_log_buffer[i], + rx_log_buffer_size[i]/sizeof(short), + sizeof(short)); + } + + if (startupConfiguration.iqswap == 1){ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + printf("PRACH: Swap I and Q to match CPU format: [%d]\n",i); + { + /* swap I and Q */ + int32_t j; + signed short *ptr = (signed short *) p_prach_log_buffer[i]; + signed short temp; + + for (j = 0; j < (int32_t)(prach_log_buffer_size[i]/sizeof(short)) ; j = j + 2){ + temp = ptr[j]; + ptr[j] = ptr[j + 1]; + ptr[j + 1] = temp; + } + } + } + } + + if (startupConfiguration.nebyteorderswap == 1){ + for(i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + printf("PRACH: Convert S16 I and S16 Q to cpu byte order from XRAN Ant: [%d]\n",i); + for (j = 0; j < prach_log_buffer_size[i]/sizeof(short); j++){ + p_prach_log_buffer[i][j] = rte_be_to_cpu_16(p_prach_log_buffer[i][j]); + } + } + } + + for (i = 0; i < MAX_ANT_CARRIER_SUPPORTED && i < (uint32_t)(numCCPorts * num_eAxc); i++) { + + sprintf(filename, "%s-prach_log_ant%d.txt",((startupConfiguration.appMode == APP_LLS_CU) ? "lls-cu" : "ru"), i); + sys_save_buf_to_file_txt(filename, + "PRACH FFT OUT IQ Samples in human readable format", + (uint8_t*) p_prach_log_buffer[i], + prach_log_buffer_size[i], + 1); + + sprintf(filename, "%s-prach_log_ant%d.bin",((startupConfiguration.appMode == APP_LLS_CU) ? "lls-cu" : "ru"), i); + sys_save_buf_to_file(filename, + "PRACH FFT OUT IQ Samples in binary format", + (uint8_t*) p_prach_log_buffer[i], + prach_log_buffer_size[i]/sizeof(short), + sizeof(short)); + } + + return 0; +} diff --git a/fhi_lib/app/ru/Makefile b/fhi_lib/app/ru/Makefile new file mode 100644 index 0000000..29ac054 --- /dev/null +++ b/fhi_lib/app/ru/Makefile @@ -0,0 +1,85 @@ +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ +CC := icc + +ifeq ($(RTE_SDK),) + $(error "Please define RTE_SDK environment variable") +endif + +RTE_TARGET := x86_64-native-linuxapp-icc +RTE_INC := $(RTE_SDK)/$(RTE_TARGET)/include +#include $(RTE_SDK)/mk/rte.vars.mk + +ifeq ($(XRAN_DIR),) + XRAN_DIR=$(PWD)/../.. +endif + +COMMON_SRC=$(XRAN_DIR)/app/common +SRC_SRC=$(XRAN_DIR)/app/src + +ifeq ($(MLOG_DIR),) + MLOG_DIR=$(XRAN_DIR)/../mlog +endif +APP = sample-ru +SRC = $(COMMON_SRC)/common.c \ + ../lls-cu/sample-lls-cu.c \ + $(SRC_SRC)/config.c + +CFLAGS += -std=gnu11 -Wall -wd9 -Wextra -Werror -I$(XRAN_DIR)/lib/api -I$(COMMON_SRC) -I$(SRC_SRC) -I$(MLOG_DIR)/source -I$(RTE_INC) +ifeq ($(ME),1) + CFLAGS += -DMLOG_ENABLED +endif + +ifeq ($(DEBUG),1) + CFLAGS += -DDEBUG -O0 -g +else + CFLAGS += -O3 +endif + +ifeq ($(MULTI_SECTION),1) + CFLAGS += -DMULTI_SECTION +endif + +LDFLAGS += -pthread -lrt + +RTE_LIBS = -L$(RTE_SDK)/$(RTE_TARGET)/lib -Wl,-lrte_flow_classify -Wl,--whole-archive -Wl,-lrte_pipeline -Wl,--no-whole-archive -Wl,--whole-archive -Wl,-lrte_table -Wl,--no-whole-archive -Wl,--whole-archive -Wl,-lrte_port -Wl,--no-whole-archive -Wl,-lrte_pdump -Wl,-lrte_distributor -Wl,-lrte_ip_frag -Wl,-lrte_meter -Wl,-lrte_lpm -Wl,--whole-archive -Wl,-lrte_acl -Wl,--no-whole-archive -Wl,-lrte_jobstats -Wl,-lrte_metrics -Wl,-lrte_bitratestats -Wl,-lrte_latencystats -Wl,-lrte_power -Wl,-lrte_efd -Wl,-lrte_bpf -Wl,--whole-archive -Wl,-lrte_cfgfile -Wl,-lrte_gro -Wl,-lrte_gso -Wl,-lrte_hash -Wl,-lrte_member -Wl,-lrte_vhost -Wl,-lrte_kvargs -Wl,-lrte_mbuf -Wl,-lrte_net -Wl,-lrte_ethdev -Wl,-lrte_bbdev -Wl,-lrte_cryptodev -Wl,-lrte_security -Wl,-lrte_compressdev -Wl,-lrte_eventdev -Wl,-lrte_rawdev -Wl,-lrte_timer -Wl,-lrte_mempool -Wl,-lrte_mempool_ring -Wl,-lrte_ring -Wl,-lrte_pci -Wl,-lrte_eal -Wl,-lrte_cmdline -Wl,-lrte_reorder -Wl,-lrte_sched -Wl,-lrte_kni -Wl,-lrte_common_octeontx -Wl,-lrte_bus_pci -Wl,-lrte_bus_vdev -Wl,-lrte_bus_dpaa -Wl,-lrte_bus_fslmc -Wl,-lrte_mempool_bucket -Wl,-lrte_mempool_stack -Wl,-lrte_mempool_dpaa -Wl,-lrte_mempool_dpaa2 -Wl,-lrte_pmd_af_packet -Wl,-lrte_pmd_ark -Wl,-lrte_pmd_avf -Wl,-lrte_pmd_avp -Wl,-lrte_pmd_axgbe -Wl,-lrte_pmd_bnxt -Wl,-lrte_pmd_bond -Wl,-lrte_pmd_cxgbe -Wl,-lrte_pmd_dpaa -Wl,-lrte_pmd_dpaa2 -Wl,-lrte_pmd_e1000 -Wl,-lrte_pmd_ena -Wl,-lrte_pmd_enic -Wl,-lrte_pmd_fm10k -Wl,-lrte_pmd_failsafe -Wl,-lrte_pmd_i40e -Wl,-lrte_pmd_ixgbe -Wl,-lrte_pmd_kni -Wl,-lrte_pmd_lio -Wl,-lrte_pmd_nfp -Wl,-lrte_pmd_null -Wl,-lrte_pmd_qede -Wl,-lrte_pmd_ring -Wl,-lrte_pmd_softnic -Wl,-lrte_pmd_tap -Wl,-lrte_pmd_thunderx_nicvf -Wl,-lrte_pmd_vdev_netvsc -Wl,-lrte_pmd_virtio -Wl,-lrte_pmd_vhost -Wl,-lrte_pmd_ifc -Wl,-lrte_pmd_vmxnet3_uio -Wl,-lrte_bus_vmbus -Wl,-lrte_pmd_netvsc -Wl,-lrte_pmd_bbdev_null -Wl,-lrte_pmd_null_crypto -Wl,-lrte_pmd_crypto_scheduler -Wl,-lrte_pmd_dpaa2_sec -Wl,-lrte_pmd_dpaa_sec -Wl,-lrte_pmd_virtio_crypto -Wl,-lrte_pmd_octeontx_zip -Wl,-lrte_pmd_qat -Wl,-lrte_pmd_skeleton_event -Wl,-lrte_pmd_sw_event -Wl,-lrte_pmd_octeontx_ssovf -Wl,-lrte_pmd_dpaa_event -Wl,-lrte_pmd_dpaa2_event -Wl,-lrte_mempool_octeontx -Wl,-lrte_pmd_octeontx -Wl,-lrte_pmd_opdl_event -Wl,-lrte_pmd_skeleton_rawdev -Wl,-lrte_pmd_dpaa2_cmdif -Wl,-lrte_pmd_dpaa2_qdma -Wl,-lrte_bus_ifpga -Wl,-lrte_pmd_ifpga_rawdev -Wl,--no-whole-archive -Wl,-lrt -Wl,-lm -Wl,-lnuma -Wl,-ldl -Wl, + +XRAN_LIB_DIR=$(XRAN_DIR)/lib/bin +LDFLAGS += -L$(XRAN_LIB_DIR) -Wl, -lxran -Wl, -L$(MLOG_DIR)/bin -Wl, $(RTE_LIBS) +ifeq ($(ME),1) + LDFLAGS += -Wl,-lmlog +endif +OBJ = $(foreach file,$(SRC),$(file:.c=.o)) + + +all: $(APP) install + +$(OBJ): %.o: %.c + $(CC) $(CFLAGS) -c $< -o $@ + +$(APP): $(OBJ) + $(CC) -o $(APP) $(CFLAGS) $(OBJ) $(LDFLAGS) + +install: $(APP) + @mkdir -p bin + @cp $(APP) ./bin + +clean: + @rm -rf $(APP) $(OBJ) ./bin/$(APP) + +#include $(RTE_SDK)/mk/rte.extapp.mk diff --git a/fhi_lib/app/run_lls-cu.sh b/fhi_lib/app/run_lls-cu.sh new file mode 100644 index 0000000..cec7e5b --- /dev/null +++ b/fhi_lib/app/run_lls-cu.sh @@ -0,0 +1,36 @@ +#! /bin/bash + +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ + + +ulimit -c unlimited +echo 1 > /proc/sys/kernel/core_uses_pid + +grep Huge /proc/meminfo +huge_folder="/mnt/huge_bbu" +[ -d "$huge_folder" ] || mkdir -p $huge_folder +if ! mount | grep $huge_folder; then + mount none $huge_folder -t hugetlbfs -o rw,mode=0777 +fi + +./lls-cu/bin/sample-lls-cu config_file_lls_cu.dat 0000:18:02.0 0000:18:02.1 + +umount $huge_folder +rmdir $huge_folder + diff --git a/fhi_lib/app/run_ru.sh b/fhi_lib/app/run_ru.sh new file mode 100644 index 0000000..e84bc0a --- /dev/null +++ b/fhi_lib/app/run_ru.sh @@ -0,0 +1,35 @@ +#! /bin/bash + +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ + +ulimit -c unlimited +echo 1 > /proc/sys/kernel/core_uses_pid + +grep Huge /proc/meminfo +huge_folder="/mnt/huge_ru" +[ -d "$huge_folder" ] || mkdir -p $huge_folder +if ! mount | grep $huge_folder; then + mount none $huge_folder -t hugetlbfs -o rw,mode=0777 +fi + +./ru/bin/sample-ru config_file_ru.dat 0000:18:02.0 0000:18:02.1 + +umount $huge_folder +rmdir $huge_folder + diff --git a/fhi_lib/app/src/config.c b/fhi_lib/app/src/config.c new file mode 100644 index 0000000..1564c8d --- /dev/null +++ b/fhi_lib/app/src/config.c @@ -0,0 +1,373 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief + * @file + * @ingroup + * @author Intel Corporation + **/ + +#include "rte_common.h" +#include "config.h" + +#include + +#define MAX_LINE_SIZE 512 +/* Configuration file maximum supported line length */ + + +#define KEY_APP_MODE "appMode" +#define KEY_XRAN_MODE "xranMode" +#define KEY_MU_NUMBER "mu" +#define KEY_CC_PER_PORT_NUM "ccNum" +#define KEY_ANT_NUM "antNum" +#define KEY_TTI_PERIOD "ttiPeriod" +#define KEY_LLS_CU_MAC "llsCUMac" +#define KEY_RU_MAC "ruMac" + +#define KEY_FILE_AxC0 "antC0" +#define KEY_FILE_AxC1 "antC1" +#define KEY_FILE_AxC2 "antC2" +#define KEY_FILE_AxC3 "antC3" +#define KEY_FILE_AxC4 "antC4" +#define KEY_FILE_AxC5 "antC5" +#define KEY_FILE_AxC6 "antC6" +#define KEY_FILE_AxC7 "antC7" +#define KEY_FILE_AxC8 "antC8" +#define KEY_FILE_AxC9 "antC9" +#define KEY_FILE_AxC10 "antC10" +#define KEY_FILE_AxC11 "antC11" +#define KEY_FILE_AxC12 "antC12" +#define KEY_FILE_AxC13 "antC13" +#define KEY_FILE_AxC14 "antC14" +#define KEY_FILE_AxC15 "antC15" + +#define KEY_PRACH_ENABLE "rachEanble" +#define KEY_PRACH_OFFSET "rachOffset" +#define KEY_PRACH_CFG_IDX "rachCfgIdx" + +#define KEY_IQ_SWAP "iqswap" +#define KEY_HTONS_SWAP "nebyteorderswap" + +#define KEY_TADV_CP_DL "Tadv_cp_dl" +#define KEY_T2A_MIN_CP_DL "T2a_min_cp_dl" +#define KEY_T2A_MAX_CP_DL "T2a_max_cp_dl" +#define KEY_T2A_MIN_CP_UL "T2a_min_cp_ul" +#define KEY_T2A_MAX_CP_UL "T2a_max_cp_ul" +#define KEY_T2A_MIN_UP "T2a_min_up" +#define KEY_T2A_MAX_UP "T2a_max_up" +#define KEY_TA3_MIN "Ta3_min" +#define KEY_TA3_MAX "Ta3_max" +#define KEY_T1A_MIN_CP_DL "T1a_min_cp_dl" +#define KEY_T1A_MAX_CP_DL "T1a_max_cp_dl" +#define KEY_T1A_MIN_CP_UL "T1a_min_cp_ul" +#define KEY_T1A_MAX_CP_UL "T1a_max_cp_ul" +#define KEY_T1A_MIN_UP "T1a_min_up" +#define KEY_T1A_MAX_UP "T1a_max_up" +#define KEY_TA4_MIN "Ta4_min" +#define KEY_TA4_MAX "Ta4_max" + + +#define KEY_CP_ENABLE "CPenable" +#define KEY_CP_VTAG "c_plane_vlan_tag" +#define KEY_UP_VTAG "u_plane_vlan_tag" +#define KEY_DEBUG_STOP "debugStop" + + +/** + * Set runtime configuration parameters to their defaults. + * + * @todo Initialize missing parameters. + */ +static void init_config(RuntimeConfig* config) +{ + memset(config , 0, sizeof(RuntimeConfig)); +} + +/** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - **/ + +static void trim(char* input) +{ + uint32_t i; + for (i = 0; iappMode = atoi(value); + } else if (strcmp(key, KEY_XRAN_MODE) == 0) { + config->xranMode = atoi(value); + } else if (strcmp(key, KEY_CC_PER_PORT_NUM) == 0) { + config->numCC= atoi(value); + } else if (strcmp(key, KEY_MU_NUMBER) == 0) { + config->mu_number= atoi(value); + } else if (strcmp(key, KEY_ANT_NUM) == 0) { + config->numAxc = atoi(value); + } else if (strcmp(key, KEY_TTI_PERIOD) == 0) { + config->ttiPeriod = atoi(value); + } else if (strcmp(key, KEY_IQ_SWAP) == 0) { + config->iqswap = atoi(value); + } else if (strcmp(key, KEY_HTONS_SWAP) == 0) { + config->nebyteorderswap = atoi(value); + } else if (strcmp(key, KEY_LLS_CU_MAC) == 0) { + sscanf(value, "%02x:%02x:%02x:%02x:%02x:%02x", (uint32_t*)&config->lls_cu_addr.addr_bytes[0], + (uint32_t*)&config->lls_cu_addr.addr_bytes[1], + (uint32_t*)&config->lls_cu_addr.addr_bytes[2], + (uint32_t*)&config->lls_cu_addr.addr_bytes[3], + (uint32_t*)&config->lls_cu_addr.addr_bytes[4], + (uint32_t*)&config->lls_cu_addr.addr_bytes[5]); + + printf("lls-CU MAC address: %02X:%02X:%02X:%02X:%02X:%02X\n", + config->lls_cu_addr.addr_bytes[0], + config->lls_cu_addr.addr_bytes[1], + config->lls_cu_addr.addr_bytes[2], + config->lls_cu_addr.addr_bytes[3], + config->lls_cu_addr.addr_bytes[4], + config->lls_cu_addr.addr_bytes[5]); + + } else if (strcmp(key, KEY_RU_MAC) == 0) { + sscanf(value, "%02x:%02x:%02x:%02x:%02x:%02x", (uint32_t*)&config->ru_addr.addr_bytes[0], + (uint32_t*)&config->ru_addr.addr_bytes[1], + (uint32_t*)&config->ru_addr.addr_bytes[2], + (uint32_t*)&config->ru_addr.addr_bytes[3], + (uint32_t*)&config->ru_addr.addr_bytes[4], + (uint32_t*)&config->ru_addr.addr_bytes[5]); + + printf("RU MAC address: %02X:%02X:%02X:%02X:%02X:%02X\n", + config->ru_addr.addr_bytes[0], + config->ru_addr.addr_bytes[1], + config->ru_addr.addr_bytes[2], + config->ru_addr.addr_bytes[3], + config->ru_addr.addr_bytes[4], + config->ru_addr.addr_bytes[5]); + } else if (strcmp(key, KEY_FILE_AxC0) == 0) { + strncpy(&config->ant_file[0][0], value, strlen(value)); + printf("ant0: %s\n",config->ant_file[0]); + } else if (strcmp(key, KEY_FILE_AxC1) == 0) { + strncpy(&config->ant_file[1][0], value, strlen(value)); + printf("ant1: %s\n",config->ant_file[1]); + } else if (strcmp(key, KEY_FILE_AxC2) == 0) { + strncpy(&config->ant_file[2][0], value, strlen(value)); + printf("ant2: %s\n",config->ant_file[2]); + } else if (strcmp(key, KEY_FILE_AxC3) == 0) { + strncpy(&config->ant_file[3][0], value, strlen(value)); + printf("ant3: %s\n",config->ant_file[3]); + } else if (strcmp(key, KEY_FILE_AxC4) == 0) { + strncpy(&config->ant_file[4][0], value, strlen(value)); + printf("ant4: %s\n",config->ant_file[4]); + } else if (strcmp(key, KEY_FILE_AxC5) == 0) { + strncpy(&config->ant_file[5][0], value, strlen(value)); + printf("ant5: %s\n",config->ant_file[5]); + } else if (strcmp(key, KEY_FILE_AxC6) == 0) { + strncpy(&config->ant_file[6][0], value, strlen(value)); + printf("ant6: %s\n",config->ant_file[6]); + } else if (strcmp(key, KEY_FILE_AxC7) == 0) { + strncpy(&config->ant_file[7][0], value, strlen(value)); + printf("ant7: %s\n",config->ant_file[7]); + } else if (strcmp(key, KEY_FILE_AxC8) == 0) { + strncpy(&config->ant_file[8][0], value, strlen(value)); + printf("ant8: %s\n",config->ant_file[8]); + } else if (strcmp(key, KEY_FILE_AxC9) == 0) { + strncpy(&config->ant_file[9][0], value, strlen(value)); + printf("ant9: %s\n",config->ant_file[9]); + } else if (strcmp(key, KEY_FILE_AxC10) == 0) { + strncpy(&config->ant_file[10][0], value, strlen(value)); + printf("ant10: %s\n",config->ant_file[10]); + } else if (strcmp(key, KEY_FILE_AxC11) == 0) { + strncpy(&config->ant_file[11][0], value, strlen(value)); + printf("ant11: %s\n",config->ant_file[11]); + } else if (strcmp(key, KEY_FILE_AxC12) == 0) { + strncpy(&config->ant_file[12][0], value, strlen(value)); + printf("ant12: %s\n",config->ant_file[12]); + } else if (strcmp(key, KEY_FILE_AxC13) == 0) { + strncpy(&config->ant_file[13][0], value, strlen(value)); + printf("ant13: %s\n",config->ant_file[13]); + } else if (strcmp(key, KEY_FILE_AxC14) == 0) { + strncpy(&config->ant_file[14][0], value, strlen(value)); + printf("ant14: %s\n",config->ant_file[14]); + } else if (strcmp(key, KEY_FILE_AxC15) == 0) { + strncpy(&config->ant_file[15][0], value, strlen(value)); + printf("ant15: %s\n",config->ant_file[15]); + } else if (strcmp(key, KEY_PRACH_ENABLE) == 0) { + config->enablePrach = atoi(value); + printf("Prach enable: %d\n",config->enablePrach); + } else if (strcmp(key, KEY_PRACH_OFFSET ) == 0) { + config->prachOffset = atoi(value); + printf("Prach Offset: %d\n",config->prachOffset); + } else if (strcmp(key, KEY_PRACH_CFG_IDX ) == 0) { + config->prachConfigIndex = atoi(value); + printf("Prach Conf Index: %d\n",config->prachConfigIndex); + + /* timing */ + } else if (strcmp(key, KEY_TADV_CP_DL ) == 0) { + config->Tadv_cp_dl = atoi(value); + printf("Tadv_cp_dl: %d\n",config->Tadv_cp_dl); + } else if (strcmp(key, KEY_T2A_MIN_CP_DL ) == 0) { + config->T2a_min_cp_dl = atoi(value); + printf("T2a_min_cp_dl: %d\n",config->T2a_min_cp_dl); + } else if (strcmp(key, KEY_T2A_MAX_CP_DL ) == 0) { + config->T2a_max_cp_dl = atoi(value); + printf("T2a_max_cp_dl: %d\n",config->T2a_max_cp_dl); + } else if (strcmp(key, KEY_T2A_MIN_CP_UL ) == 0) { + config->T2a_min_cp_ul = atoi(value); + printf("T2a_min_cp_ul: %d\n",config->T2a_min_cp_ul); + } else if (strcmp(key, KEY_T2A_MAX_CP_UL ) == 0) { + config->T2a_max_cp_ul = atoi(value); + printf("T2a_max_cp_ul: %d\n",config->T2a_max_cp_ul); + } else if (strcmp(key, KEY_T2A_MIN_UP ) == 0) { + config->T2a_min_up = atoi(value); + printf("T2a_min_up: %d\n",config->T2a_min_up); + } else if (strcmp(key, KEY_T2A_MAX_UP ) == 0) { + config->T2a_max_up = atoi(value); + printf("T2a_max_up: %d\n",config->T2a_max_up); + } else if (strcmp(key, KEY_TA3_MIN ) == 0) { + config->Ta3_min = atoi(value); + printf("Ta3_min: %d\n",config->Ta3_min); + } else if (strcmp(key, KEY_TA3_MAX ) == 0) { + config->Ta3_max = atoi(value); + printf("Ta3_max: %d\n",config->Ta3_max); + } else if (strcmp(key, KEY_T1A_MIN_CP_DL ) == 0) { + config->T1a_min_cp_dl = atoi(value); + printf("T1a_min_cp_dl: %d\n",config->T1a_min_cp_dl); + } else if (strcmp(key, KEY_T1A_MAX_CP_DL ) == 0) { + config->T1a_max_cp_dl = atoi(value); + printf("T1a_max_cp_dl: %d\n",config->T1a_max_cp_dl); + } else if (strcmp(key, KEY_T1A_MIN_CP_UL ) == 0) { + config->T1a_min_cp_ul = atoi(value); + printf("T1a_min_cp_ul: %d\n",config->T1a_min_cp_ul); + } else if (strcmp(key, KEY_T1A_MAX_CP_UL ) == 0) { + config->T1a_max_cp_ul = atoi(value); + printf("T1a_max_cp_ul: %d\n",config->T1a_max_cp_ul); + } else if (strcmp(key, KEY_T1A_MIN_UP ) == 0) { + config->T1a_min_up = atoi(value); + printf("T1a_min_up: %d\n",config->T1a_min_up); + } else if (strcmp(key, KEY_T1A_MAX_UP ) == 0) { + config->T1a_max_up = atoi(value); + printf("T1a_max_up: %d\n",config->T1a_max_up); + } else if (strcmp(key, KEY_TA4_MIN ) == 0) { + config->Ta4_min = atoi(value); + printf("Ta4_min: %d\n",config->Ta4_min); + } else if (strcmp(key, KEY_TA4_MAX ) == 0) { + config->Ta4_max = atoi(value); + printf("Ta4_max: %d\n",config->Ta4_max); + /* end of timing */ + } else if (strcmp(key, KEY_CP_ENABLE ) == 0) { + config->enableCP = atoi(value); + printf("CPenable: %d\n",config->enableCP); + } else if (strcmp(key, KEY_DEBUG_STOP ) == 0) { + config->debugStop = atoi(value); + printf("debugStop: %d\n",config->debugStop); + } else if (strcmp(key, KEY_CP_VTAG ) == 0) { + config->cp_vlan_tag = atoi(value); + printf("cp_vlan_tag: %d\n",config->cp_vlan_tag); + } else if (strcmp(key, KEY_UP_VTAG ) == 0) { + config->up_vlan_tag = atoi(value); + printf("up_vlan_tag: %d\n",config->up_vlan_tag); + } else { + printf("Unsupported configuration key [%s]\n", key); + return -1; + } + + return 0; +} + +int parseConfigFile(char *filename, RuntimeConfig *config) +{ + char inputLine[MAX_LINE_SIZE] = {0}; + int inputLen = 0; + int i; + int lineNum = 0; + char key[MAX_LINE_SIZE] = {0}; + char value[MAX_LINE_SIZE] = {0}; + FILE *file = fopen(filename, "r"); + + if (NULL == file) { + //log_err("Error while opening config file from: %s", filename); + return -1; + } + + init_config(config); + + for (;;) { + if (fgets(inputLine, MAX_LINE_SIZE, file) == NULL) { + if (lineNum > 0) { + printf("%d lines of config file has been read.\n", lineNum); + break; + } else { + printf("Configuration file reading error has occurred.\n"); + fclose(file); + return -1; + } + } + + if (inputLine[strlen(inputLine)-1] == '\n') + inputLine[strlen(inputLine)-1] == '\0'; + + lineNum++; + inputLen = strlen(inputLine); + + for (i=0; i inputLen - 1) || (i - 2 > inputLen)) { + //log_err("Parsing config file error at line %d", lineNum); + fclose(file); + return -1; + } + strncpy(value, &inputLine[i+1], (sizeof(value) - 1)); + value[inputLen-i-2] = '\0'; + trim(value); + + if (strlen(key) == 0 || strlen(value) == 0) { + printf("Parsing config file error at line %d", lineNum); + fclose(file); + return -1; + } + + if (fillConfigStruct(config, key, value) != 0) { + fclose(file); + return -1; + } + + break; + } + + memset(&inputLine[0], 0, sizeof(MAX_LINE_SIZE)); + memset(&key[0], 0, sizeof(MAX_LINE_SIZE)); + memset(&value[0], 0, sizeof(MAX_LINE_SIZE)); + } + fclose(file); + + return 0; +} diff --git a/fhi_lib/app/src/config.h b/fhi_lib/app/src/config.h new file mode 100644 index 0000000..b2953ee --- /dev/null +++ b/fhi_lib/app/src/config.h @@ -0,0 +1,90 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief + * @file + * @ingroup + * @author Intel Corporation + **/ + +#ifndef _SAMPLEAPP__CONFIG_H_ +#define _SAMPLEAPP__CONFIG_H_ + +#include +#include + +/** Run time configuration of application */ +typedef struct _RuntimeConfig +{ + uint8_t appMode; /**< Application mode: lls-CU or RU */ + uint8_t xranMode; /**< xran mode: Categoty A | Category B */ + uint8_t numCC; /**< Number of CC per ports supported by RU */ + uint8_t mu_number; /**< Mu numner as per 3GPP */ + uint8_t numAxc; /**< Number of Antenna Carriers per CC */ + uint32_t ttiPeriod; /**< TTI period */ + uint32_t testVect; /**< Test Signal to send */ + struct ether_addr lls_cu_addr; /**< lls-CU Ethernet Mac Address */ + struct ether_addr ru_addr; /**< RU Ethernet Mac Address */ + char ant_file[16][512] /**< file to use for test vector */ ; + + /* prach config */ + uint8_t enablePrach; /**< enable PRACH */ + uint8_t prachOffset; /**< Sets the PRACH position in frequency / subcarrier position, n_PRBoffset^RA and is expressed as a physical resource block number. + Set by SIB2, prach-FreqOffset in E-UTRA. */ + + uint8_t prachConfigIndex; /**< TS36.211 - Table 5.7.1-2 : PRACH Configuration Index */ + uint8_t iqswap; /**< do swap of IQ before send to ETH */ + uint8_t nebyteorderswap; /**< do swap of byte order from host byte order to network byte order. ETH */ + + uint16_t Tadv_cp_dl; + uint16_t T2a_min_cp_dl; + uint16_t T2a_max_cp_dl; + uint16_t T2a_min_cp_ul; + uint16_t T2a_max_cp_ul; + uint16_t T2a_min_up; + uint16_t T2a_max_up; + uint16_t Ta3_min; + uint16_t Ta3_max; + uint16_t T1a_min_cp_dl; + uint16_t T1a_max_cp_dl; + uint16_t T1a_min_cp_ul; + uint16_t T1a_max_cp_ul; + uint16_t T1a_min_up; + uint16_t T1a_max_up; + uint16_t Ta4_min; + uint16_t Ta4_max; + + uint8_t enableCP; /**< enable C-plane */ + uint8_t cp_vlan_tag; /**< C-plane vlan tag */ + uint8_t up_vlan_tag; /**< U-plane vlan tag */ + + int32_t debugStop; + + +} RuntimeConfig; + +/** + * Parse application configuration file. + * + * @param filename The name of the configuration file to be parsed. + * @param config The configuration structure to be filled with parsed data. */ +int parseConfigFile(char *filename, RuntimeConfig *config); + +#endif /* _SAMPLEAPP__CONFIG_H_ */ diff --git a/fhi_lib/app/src/xran_mlog_task_id.h b/fhi_lib/app/src/xran_mlog_task_id.h new file mode 100644 index 0000000..23a673c --- /dev/null +++ b/fhi_lib/app/src/xran_mlog_task_id.h @@ -0,0 +1,61 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file has the System Debug Trace Logger (Mlog) Task IDs used by PHY + * @file mlog_task_id.h + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +#ifndef _XRAN_TASK_ID_H_ +#define _XRAN_TASK_ID_H_ + +#define RESOURCE_CORE_0 0 +#define RESOURCE_CORE_1 1 +#define RESOURCE_CORE_2 2 +#define RESOURCE_CORE_3 3 +#define RESOURCE_CORE_4 4 +#define RESOURCE_CORE_5 5 +#define RESOURCE_CORE_6 6 +#define RESOURCE_CORE_7 7 +#define RESOURCE_CORE_8 8 +#define RESOURCE_CORE_9 9 +#define RESOURCE_CORE_10 10 +#define RESOURCE_CORE_11 11 +#define RESOURCE_CORE_12 12 +#define RESOURCE_CORE_13 13 +#define RESOURCE_CORE_14 14 +#define RESOURCE_CORE_15 15 +#define RESOURCE_CORE_16 16 + +#define RESOURCE_IA_CORE 100 + +//-------------------------------------------------------------------- +// XRAN APP +//-------------------------------------------------------------------- + +#define PID_GNB_PROC_TIMING 902 +#define PID_GNB_PROC_TIMING_TIMEOUT 903 +#define PID_GNB_SYM_CB 904 +#define PID_GNB_PRACH_CB 905 + + +#endif /* _XRAN_TASK_ID_H_ */ + diff --git a/fhi_lib/build.sh b/fhi_lib/build.sh new file mode 100644 index 0000000..149ad8a --- /dev/null +++ b/fhi_lib/build.sh @@ -0,0 +1,30 @@ +#!/bin/bash +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ + +XRAN_FH_LIB_DIR=$XRAN_DIR/lib +XRAN_FH_APP_DIR=$XRAN_DIR/app + +echo 'Building XRAN Library' +cd $XRAN_FH_LIB_DIR +make clean; make #DEBUG=1 VERBOSE=1 + +echo 'Building XRAN Test Application' +cd $XRAN_FH_APP_DIR +make clean; make #DEBUG=1 VERBOSE=1 + diff --git a/fhi_lib/lib/Makefile b/fhi_lib/lib/Makefile new file mode 100644 index 0000000..d65eef1 --- /dev/null +++ b/fhi_lib/lib/Makefile @@ -0,0 +1,87 @@ +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ +CC := icc +AR := xiar + +ifeq ($(RTE_SDK),) + $(error "Please define RTE_SDK environment variable") +endif + +RTE_TARGET := x86_64-native-linuxapp-icc +RTE_INC := $(RTE_SDK)/$(RTE_TARGET)/include +#include $(RTE_SDK)/mk/rte.vars.mk +API_DIR := $(PWD)/api +SRC_DIR := $(PWD)/src +ETH_DIR := $(PWD)/ethernet + + +ifeq ($(MLOG_DIR),) + MLOG_DIR=$(XRAN_DIR)/../mlog +endif + +CFLAGS += -std=gnu11 -Wall -wd9 -Wno-deprecated-declarations -Wextra -Werror -qopt-report-phase:all -qopt-zmm-usage=high \ + -fdata-sections \ + -ffunction-sections \ + -restrict \ + -g \ + -Wall \ + -Wimplicit-function-declaration \ + -Werror \ + -Wextra \ + -no-inline-max-total-size \ + -no-inline-max-size \ + -I$(API_DIR) -I$(ETH_DIR) -I$(MLOG_DIR)/source -I$(RTE_INC) -g -O3 + +ifeq ($(ME),1) + CFLAGS += -DMLOG_ENABLED +endif +SRC = $(ETH_DIR)/ethdi.c \ + $(ETH_DIR)/ethernet.c \ + $(SRC_DIR)/xran_up_api.c \ + $(SRC_DIR)/xran_sync_api.c \ + $(SRC_DIR)/xran_timer.c \ + $(SRC_DIR)/xran_cp_api.c \ + $(SRC_DIR)/xran_transport.c \ + $(SRC_DIR)/xran_common.c \ + $(SRC_DIR)/xran_ul_tables.c \ + $(SRC_DIR)/xran_main.c + +FLEX_C_CRAN_LIB = libxran.a + +OBJ = $(foreach file,$(SRC),$(file:.c=.o)) + + +all: flex_lib install + +$(OBJ): %.o: %.c + $(CC) $(CFLAGS) -I$(API_DIR) -c $< -o $@ + + +flex_lib:$(FLEX_C_CRAN_LIB) + +$(FLEX_C_CRAN_LIB): $(OBJ) + $(AR) rsu $@ $^ + +install: $(FLEX_C_CRAN_LIB) + mkdir -p bin + @mv $(FLEX_C_CRAN_LIB) ./bin + +clean: + @rm -rf $(FLEX_C_CRAN_LIB) $(OBJ) ./bin/$(FLEX_C_CRAN_LIB) + +#include $(RTE_SDK)/mk/rte.extlib.mk diff --git a/fhi_lib/lib/api/xran_cp_api.h b/fhi_lib/lib/api/xran_cp_api.h new file mode 100644 index 0000000..9d08e42 --- /dev/null +++ b/fhi_lib/lib/api/xran_cp_api.h @@ -0,0 +1,220 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides the definitions for Control Plane Messages APIs. + * + * @file xran_cp_api.h + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#ifndef _XRAN_CP_API_H_ +#define _XRAN_CP_API_H_ + +#include "xran_fh_lls_cu.h" +#include "xran_pkt_cp.h" + +/* Error Codes + * For errors and exceptions, all values will be negative */ +enum xran_errcodes { + XRAN_ERRCODE_OK = 0, + XRAN_ERRCODE_INVALIDPARAM, + XRAN_ERRCODE_OUTOFMEMORY, + XRAN_ERRCODE_FAILTOSEND, + XRAN_ERRCODE_INVALIDPACKET, + XRAN_ERRCODE_MAX + }; + +/** Control Plane section types, defined in 5.4 Table 5.1 */ +enum xran_cp_sectiontype { + XRAN_CP_SECTIONTYPE_0 = 0, /**< Unused RB or Symbols in DL or UL, not supported */ + XRAN_CP_SECTIONTYPE_1 = 1, /**< Most DL/UL Radio Channels */ + XRAN_CP_SECTIONTYPE_3 = 3, /**< PRACH and Mixed-numerology Channels */ + XRAN_CP_SECTIONTYPE_5 = 5, /**< UE scheduling information, not supported */ + XRAN_CP_SECTIONTYPE_6 = 6, /**< Channel Information, not supported */ + XRAN_CP_SECTIONTYPE_7 = 7, /**< LAA, not supported */ + XRAN_CP_SECTIONTYPE_MAX + }; + +/** Filter index, defined in 5.4.4.3 */ +enum xran_cp_filterindex { + XRAN_FILTERINDEX_STANDARD = 0, /**< UL filter for standard channel */ + XRAN_FILTERINDEX_PRACH_012 = 1, /**< UL filter for PRACH preamble format 0, 1, 2 */ + XRAN_FILTERINDEX_PRACH_3 = 2, /**< UL filter for PRACH preamble format 3 */ + XRAN_FILTERINDEX_PRACH_ABC = 3, /**< UL filter for PRACH preamble format A1~3, B1~4, C0, C2 */ + XRAN_FILTERINDEX_NPRACH = 4, /**< UL filter for NPRACH */ + XRAN_FILTERINDEX_MAX + }; + +/** Maximum Slot Index, defined in 5.4.4.6 */ +#define XRAN_SLOTID_MAX 16 + +/** FFT size in frame structure, defined in 5.4.4.13 Table 5.9 */ +enum xran_cp_fftsize { + XRAN_FFTSIZE_128 = 7, /* 128 */ + XRAN_FFTSIZE_256 = 8, /* 256 */ + XRAN_FFTSIZE_512 = 9, /* 512 */ + XRAN_FFTSIZE_1024 = 10, /* 1024 */ + XRAN_FFTSIZE_2048 = 11, /* 2048 */ + XRAN_FFTSIZE_4096 = 12, /* 4096 */ + XRAN_FFTSIZE_1536 = 13, /* 1536 */ + XRAN_FFTSIZE_MAX + }; + +/** Sub-carrier spacing, defined in 5.4.4.13 Table 5.10 */ +enum xran_cp_subcarrierspacing { /*3GPP u, SCS, Nslot, Slot len */ + XRAN_SCS_15KHZ = 0, /* 0, 15kHz, 1, 1ms */ + XRAN_SCS_30KHZ = 1, /* 1, 30kHz, 2, 500us */ + XRAN_SCS_60KHZ = 2, /* 2, 60kHz, 4, 250us */ + XRAN_SCS_120KHZ = 3, /* 3, 120kHz, 8, 125us */ + XRAN_SCS_240KHZ = 4, /* 4, 240kHz, 16, 62.5us */ + XRAN_SCS_1P25KHZ = 12, /* NA, 1.25kHz, 1, 1ms */ + XRAN_SCS_3P75KHZ = 13, /* NA, 3.75kHz, 1, 1ms */ + XRAN_SCS_5KHZ = 14, /* NA, 5kHz, 1, 1ms */ + XRAN_SCS_7P5KHZ = 15, /* NA, 7.5kHz, 1, 1ms */ + XRAN_SCS_MAX + }; + +/** Resource block indicator, defined in 5.4.5.2 */ +enum xran_cp_rbindicator { + XRAN_RBIND_EVERY = 0, /**< every RB used */ + XRAN_RBIND_EVERYOTHER = 1, /**< every other RB used */ + XRAN_RBIND_MAX + }; + +/** Symbol number increment command, defined in 5.4.5.3 */ +enum xran_cp_symbolnuminc { + XRAN_SYMBOLNUMBER_NOTINC = 0, /**< do not increment the current symbol number */ + XRAN_SYMBOLNUMBER_INC = 1, /**< increment the current symbol number and use that */ + XRAN_SYMBOLNUMBER_INC_MAX + }; + +/** Minimum number of symbols, defined in 5.4.5.7 */ +#define XRAN_SYMBOLNUMBER_MIN 1 +/** Maximum number of symbols, defined in 5.4.5.7 */ +#define XRAN_SYMBOLNUMBER_MAX 14 + +/* LAA message type 5.4.5.14 Table 5.11, not supported */ +#define XRAN_LAAMSGTYPE_LBT_PDSCH_REQ 0 +#define XRAN_LAAMSGTYPE_LBT_DRS_REQ 1 +#define XRAN_LAAMSGTYPE_LBT_PDSCH_RSP 2 +#define XRAN_LAAMSGTYPE_LBT_DRS_RSP 3 +#define XRAN_LAAMSGTYPE_LBT_BUFFER_ERROR 4 +#define XRAN_LAAMSGTYPE_LBT_CWCONFIG_REQ 5 +#define XRAN_LAAMSGTYPE_LBT_CWCONFIG_RSP 6 + +#define XRAN_LBTMODE_FULL 0 +#define XRAN_LBTMODE_PARTIAL25 1 +#define XRAN_LBTMODE_PARTIAL34 2 +#define XRAN_LBTMODE_FULLSTOP 3 + +/** + * This structure contains the information to generate the section body of C-Plane message */ +struct xran_section_info { + /* section type bit- */ + /* 0 1 3 5 6 7 length */ + uint16_t id; /* X X X X X 12bits */ + uint8_t rb; /* X X X X X 1bit */ + uint8_t symInc; /* X X X X X 1bit */ + uint16_t startPrbc; /* X X X X X 10bits */ + uint8_t numPrbc; /* X X X X X 8bits */ + uint8_t numSymbol; /* X X X X 4bits */ + uint16_t reMask; /* X X X X 12bits */ + uint16_t beamId; /* X X 15bits */ + uint16_t ueId; /* X X 15bits */ + uint16_t regFactor; /* X 16bits */ + int32_t freqOffset; /* X 24bits */ + uint8_t ef; /* X X X X 1bit */ + + uint8_t type; /* type of this section */ + uint16_t pad0; + }; + +/** + * This structure contains the information to generate the section header of C-Plane message */ +struct xran_cp_header_params { + // common parameters + uint8_t filterIdx; + uint8_t frameId; + uint8_t subframeId; + uint8_t slotId; + uint8_t startSymId; + /* section type bit- */ + /* 0 1 3 5 6 7 length */ + uint8_t fftSize; /* X X 4bits */ + uint8_t scs; /* X X 4bits */ + uint8_t iqWidth; /* X X X 4bits */ + uint8_t compMeth; /* X X X 4bits */ + uint8_t numUEs; /* X 8bits */ + uint16_t timeOffset; /* X X 16bits */ + uint16_t cpLength; /* X X 16bits */ + }; + +/** + * This structure to hold the information to generate the sections of C-Plane message */ +struct xran_section_gen_info { + struct xran_section_info info; /**< The information for section */ + + uint32_t exDataSize; + /**< Extension or type 6/7 data size, not supported */ + void *exData; + /*(< The pointer to the extension or type 6/7 data, not supported */ + }; + +/** + * This structure to hold the information to generate a C-Plane message */ +struct xran_cp_gen_params { + uint8_t dir; /**< UL or DL */ + uint8_t sectionType; /**< each section must have same type with this */ + uint16_t numSections; /**< the number of sections to generate */ + + struct xran_cp_header_params hdr; + /**< The information for C-Plane message header */ + struct xran_section_gen_info *sections; + /**< Array of the section information */ + }; + + +uint16_t xran_get_cplength(int cpLength, int uval); +int32_t xran_get_freqoffset(int freqOffset, int scs); + +int xran_prepare_ctrl_pkt(struct rte_mbuf *mbuf, + struct xran_cp_gen_params *params, + uint8_t CC_ID, uint8_t Ant_ID, + uint8_t seq_id); + +int xran_cp_init_sectiondb(void *pHandle); +int xran_cp_free_sectiondb(void *pHandle); +int xran_cp_add_section_info(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id, + uint8_t subframe_id, uint8_t slot_id, + struct xran_section_info *info); +struct xran_section_info *xran_cp_find_section_info(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id, + uint8_t subframe_id, uint8_t slot_id, + uint16_t section_id); +struct xran_section_info *xran_cp_iterate_section_info(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id, + uint8_t subframe_id, uint8_t slot_id, uint32_t *next); +int xran_cp_getsize_section_info(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ruport_id); +int xran_cp_reset_section_info(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ruport_id); + +#endif /* _XRAN_CP_API_H_ */ diff --git a/fhi_lib/lib/api/xran_fh_lls_cu.h b/fhi_lib/lib/api/xran_fh_lls_cu.h new file mode 100644 index 0000000..24bacba --- /dev/null +++ b/fhi_lib/lib/api/xran_fh_lls_cu.h @@ -0,0 +1,822 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides public interface to XRAN Front Haul layer implementation as defined in the + * XRAN-FH.CUS.0-v02.00 spec. Implementation is specific to lls-CU node + * for 5G NR Radio Access technology + * + * @file xran_fh_lls_cu.h + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#ifndef _XRAN_FH_LLS_CU_H_ +#define _XRAN_FH_LLS_CU_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define XRAN_STATUS_SUCCESS (0) +/**< + * @ingroup xran + * Success status value. */ +#define XRAN_STATUS_FAIL (-1) +/**< + * @ingroup xran + * Fail status value. */ + +#define XRAN_STATUS_RETRY (-2) +/**< + * @ingroup xran + * Retry status value. */ + +#define XRAN_STATUS_RESOURCE (-3) +/**< + * @ingroup xran + * The resource that has been requested is unavailable. Refer + * to relevant sections of the API for specifics on what the suggested + * course of action is. */ + +#define XRAN_STATUS_INVALID_PARAM (-4) +/**< + * @ingroup xran + * Invalid parameter has been passed in. */ +#define XRAN_STATUS_FATAL (-5) +/**< + * @ingroup xran + * A serious error has occurred. Recommended course of action + * is to shutdown and restart the component. */ + +#define XRAN_STATUS_UNSUPPORTED (-6) +/**< + * @ingroup xran + * The function is not supported, at least not with the specific + * parameters supplied. This may be because a particular + * capability is not supported by the current implementation. */ + +/** Macro to calculate TTI number [0:7999] from symbol index [0: 112000-1] used by timing thread */ +#define XranGetTtiNum(symIdx, numSymPerTti) (((uint32_t)symIdx / (uint32_t)numSymPerTti)) +/** Macro to calculate Symbol number [0:7] for given slot from symbol index [0: 112000-1] */ +#define XranGetSymNum(symIdx, numSymPerTti) (((uint32_t)symIdx % (uint32_t)numSymPerTti)) +/** Macro to calculate Frame number [0:99] for given tti [0: 7999] */ +#define XranGetFrameNum(tti,numSubFramePerSystemFrame, numSlotPerSubFrame) ((uint32_t)tti / ((uint32_t)numSubFramePerSystemFrame * (uint32_t)numSlotPerSubFrame)) +/** Macro to calculate Subframe number [0:9] for given tti [0: 7999] */ +#define XranGetSubFrameNum(tti, numSlotPerSubFrame, numSubFramePerSystemFrame) (((uint32_t)tti/(uint32_t)numSlotPerSubFrame) % (uint32_t)numSubFramePerSystemFrame) +/** Macro to calculate Slot number [0:7] for given tti [0: 7999] */ +#define XranGetSlotNum(tti, numSlotPerSfn) ((uint32_t)tti % ((uint32_t)numSlotPerSfn)) + +#define XRAN_PORTS_NUM (1) /**< number of XRAN ports supported */ +#define XRAN_N_FE_BUF_LEN (80)/** Number of TTIs (slots) */ +#define XRAN_MAX_SECTOR_NR (4) /**< Max sectors per XRAN port */ +#define XRAN_MAX_ANTENNA_NR (4) /**< Max antenna per port */ +#define XRAN_NUM_OF_SYMBOL_PER_SLOT ( 14 ) /**< Number of symbols per slot */ + +#define XRAN_MAX_CELLS_PER_PORT (4) /**< Max cells mapped to XRAN port */ +#define XRAN_COMPONENT_CARRIERS_MAX XRAN_MAX_SECTOR_NR /**< number of CCs */ +#define XRAN_NUM_OF_ANT_RADIO 16 /**< Max Number of Antennas supported for all CC on single XRAN port */ + +#define XRAN_MAX_PKT_BURST (448+4) /**< 4x14x8 symbols per ms */ +#define XRAN_N_MAX_BUFFER_SEGMENT XRAN_MAX_PKT_BURST /**< Max number of segments per ms */ + +#define XRAN_STRICT_PARM_CHECK (1) /**< enable parameter check for C-plane */ + +//#define _XRAN_DEBUG /**< Enable debug log */ +//#define _XRAN_VERBOSE /**< Enable verbose log */ + +#ifdef _XRAN_DEBUG + #define xran_log_dbg(fmt, ...) \ + fprintf(stderr, \ + "DEBUG: %s(%d): " fmt "\n", \ + __FILE__, \ + __LINE__, ##__VA_ARGS__) +#else + #define xran_log_dbg(fmt, ...) +#endif + +#if defined(_XRAN_DEBUG) || defined(_XRAN_VERBOSE) + #define xran_log_wrn(fmt, ...) \ + fprintf( \ + stderr, \ + "WARNING: %s(%d): " fmt "\n", \ + __FILE__, \ + __LINE__, ##__VA_ARGS__) +#else + #define xran_log_dbg(fmt, ...) + #define xran_log_wrn(fmt, ...) +#endif + +#define xran_log_err(fmt, ...) \ + fprintf(stderr, \ + "ERROR: %s(%d): " fmt "\n", \ + __FILE__, \ + __LINE__, ##__VA_ARGS__) + +/** + ****************************************************************************** + * @ingroup xran + * + * @description + * Compression Method 6.3.3.13, Table 6-43 + *****************************************************************************/ +enum xran_compression_method { + XRAN_COMPMETHOD_NONE = 0, + XRAN_COMPMETHOD_BLKFLOAT = 1, + XRAN_COMPMETHOD_BLKSCALE = 2, + XRAN_COMPMETHOD_ULAW = 3, + XRAN_COMPMETHOD_MODULATION = 4, + XRAN_COMPMETHOD_MAX + }; + +/** + ****************************************************************************** + * @ingroup xran + * + * @description + * Callback function type for symbol packet enum + *****************************************************************************/ +enum callback_to_phy_id +{ + XRAN_CB_TTI = 0, /**< callback on TTI boundary */ + XRAN_CB_HALF_SLOT_RX =1, /**< callback on half slot (sym 7) packet arrival*/ + XRAN_CB_FULL_SLOT_RX =2, /**< callback on full slot (sym 14) packet arrival */ + XRAN_CB_MAX /**< max number of callbacks */ +}; + +typedef int32_t XranStatusInt32; /**< Xran status return value */ + +/** callback function type for Symbol packet */ +typedef void (*XRANFHSYMPROCCB)(void*); + +/** Callback function type for TTI event */ +typedef int (*XRANFHTTIPROCCB)(void* ); + +/** Callback function type packet arrival from transport layer (ETH or IP) */ +typedef void (*XranTransportBlockCallbackFn)(void*, int32_t); + +/** +* Component Carrier Initialization +*/ +typedef struct tagXRANCCINIT +{ + uint32_t RadioMode; /**< XRAN mode Cat A or Cat B on given CC */ + uint32_t nTxAnt; /**< Number of TX antennas */ + uint32_t nRxAnt; /**< Number of RX antennas */ + uint32_t radiobw; /**< bandwidth id */ + uint32_t dpdk_port; /**< networking layer port id */ + char *dpdk_pcie_eth_dev; /**< pcie device for this cc */ + char *ru_mac_str; /**< mac address of RU */ + uint32_t ulAgc; /**< state of UL AGC (ON/OFF) */ + uint32_t numCell; /**< Number of Cells per port per CC */ + uint32_t phyInsId[XRAN_MAX_CELLS_PER_PORT]; /**< Mapping of Cell ID to CC */ + uint32_t dpdkRxCore; /**< DPDK RX Core */ + uint32_t dpdkTxCore; /**< DPDK TX Core */ +}XRANCCINIT, *PXRANCCINIT; + +/** XRAN port enum */ +enum xran_vf_ports +{ + XRAN_UP_VF = 0, /**< port type for U-plane */ + XRAN_CP_VF, /**< port type for C-plane */ + XRAN_VF_MAX +}; + +/** DPDK IO configuration for XRAN layer */ +typedef struct tagXRAN_IO_LOOP_CFG +{ + uint8_t id; + char *dpdk_dev[XRAN_VF_MAX]; + int core; + int system_core; /* Needed as DPDK will change your starting core. */ + int pkt_proc_core; /* Needed for packet processing thread. */ + int pkt_aux_core; /* Needed for debug purposes. */ + int timing_core; /* Needed for getting precise time */ + int port[XRAN_VF_MAX]; /* This is auto-detected, no need to set. */ +}XRAN_IO_LOOP_CFG, *PXRAN_IO_LOOP_CFG; + +/** XRAN spec section 3.1.3.1.6 ecpriRtcid / ecpriPcid define */ +typedef struct tagXRANEAXCIDCONFIG +{ + uint16_t mask_cuPortId; /**< Mask CU PortId */ + uint16_t mask_bandSectorId; /**< Mask Band */ + uint16_t mask_ccId; /**< Mask CC */ + uint16_t mask_ruPortId; /**< Mask RU Port ID */ + + uint8_t bit_cuPortId; /**< bandsectorId + ccId + ruportId */ + uint8_t bit_bandSectorId; /**< ccId + ruPortId */ + uint8_t bit_ccId; /**< ruportId */ + uint8_t bit_ruPortId; /**< 0 */ +}XRANEAXCIDCONFIG, *PXRANEAXCIDCONFIG; + +/** +* XRAN Front haul interface initialization settings +*/ +typedef struct tagXRANFHINIT +{ + uint32_t llscuId; /**< lls-cu ID */ + uint32_t nSec; /**< number of sectors, shall be 1 */ + XRANCCINIT ccCfg[XRAN_COMPONENT_CARRIERS_MAX]; /**< configuration of each CCs */ + XRANEAXCIDCONFIG eAxCId_conf; /**< config of ecpriRtcid/ecpriPcid */ + uint32_t radio_iface; /**< enable/disable radio */ + uint32_t dpdkMasterCore; /**< master core of DPDK */ + uint32_t dpdkMemorySize; /**< huge pages allocation for DPDK */ + uint32_t dpdkIrqMode; /**< DPDK IRQ or PMD mode */ + uint32_t dpdkBasebandFecMode; /**< DPDK Baseband FEC device mode (0-SW, 1-HW) */ + char *dpdkBasebandDevice; /**< DPDK Baseband device address */ + uint32_t singleThreadTxRx; + uint32_t bbuPoolCores; /**< DPDK cores for BBU pool */ + uint32_t radioEnabled; /**< reserved */ + uint32_t powerSaveEn; /**< reserved */ + char *filePrefix; /**< DPDK prefix */ + XRAN_IO_LOOP_CFG io_cfg;/**< DPDK IO for XRAN */ + uint8_t xranMode; /**< mode: lls-CU or RU */ + int8_t *p_lls_cu_addr; /**< lls-CU Ethernet Mac Address */ + int8_t *p_ru_addr; /**< RU Ethernet Mac Address */ + uint32_t ttiPeriod; /**< TTI period */ + + uint16_t Tadv_cp_dl; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T2a_min_cp_dl; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T2a_max_cp_dl; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T2a_min_cp_ul; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T2a_max_cp_ul; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T2a_min_up; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T2a_max_up; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t Ta3_min; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t Ta3_max; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T1a_min_cp_dl; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T1a_max_cp_dl; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T1a_min_cp_ul; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T1a_max_cp_ul; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T1a_min_up; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t T1a_max_up; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t Ta4_min; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + uint16_t Ta4_max; /**< Table 2 7 : xRAN Delay Management Model Parameters */ + + uint8_t enableCP; /**< enable C-plane */ + uint8_t cp_vlan_tag; /**< C-plane vlan tag */ + uint8_t up_vlan_tag; /**< U-plane vlan tag */ + int32_t debugStop; /**< enable auto stop */ +} XRANFHINIT, *PXRANFHINIT; + +/** XRAN Playback format */ +typedef enum { + XRAN_RADIO_PLAYBACK_TIME_DOMAIN = 0, + XRAN_RADIO_PLAYBACK_FREQ_DOMAIN = 1 +} XranPlaybackFormatEnum; + +/* PRACH config required for XRAN based FH */ +typedef struct tagXRANPRACHCONFIG +{ + /**** word 5 *****/ + /* PRACH config*/ + /** PRACH Configuration Index*/ + uint8_t nPrachConfIdx; + /** PRACH Sub-carrier spacing + Value:0->1 + For below 6GHz the values indicate 15kHz or 30kHz + For above 6GHz the values indicate 60kHz or 120kHz*/ + /*PRACH zeroCorrelationZoneConfig */ + uint8_t nPrachSubcSpacing; + /** PRACH zeroCorrelationZoneConfig */ + uint8_t nPrachZeroCorrConf; + /** PRACH restrictedSetConfig */ + uint8_t nPrachRestrictSet; + + /**** word 6 *****/ + /** PRACH Root Sequence Index */ + uint16_t nPrachRootSeqIdx; + /** PRACH prach-frequency-start */ + uint16_t nPrachFreqStart; + + /** PRACH prach-frequency-offset */ + int32_t nPrachFreqOffset; + /** PRACH Filter index */ + uint8_t nPrachFilterIdx; +}XRANPRACHCONFIG, *PXRANPRACHCONFIG; + +/** XRAN front haul playback configuration (not supported in 19.03) */ +typedef struct tagXRANFHPLAYBACK +{ + XranPlaybackFormatEnum TxPlayFormatType; /**< type of play back files [Time|Freq] */ + + unsigned long TxPlayBufAddr[XRAN_NUM_OF_ANT_RADIO]; /**< pointer to buffers to play */ + uint32_t TxPlayBufSize; /**< Buffer size */ + + char* TxPlayFileName[XRAN_NUM_OF_ANT_RADIO]; /**< files to play */ + uint32_t TxPlayFileSize; /**< expected the same size for all Ant */ + +}XRANPLAYBACKCONFIG,*PXRANPLAYBACKCONFIG; + +/** XRAN front haul logging configuration (not supported in 19.03) */ +typedef struct tagXRANFHLOGCONF +{ + /* logging */ + unsigned long TxLogBufAddr; + uint32_t TxLogBufSize; + + unsigned long TxLogIfftInAddr; + uint32_t TxLogIfftInSize; + + unsigned long TxLogIfft1200InAddr; + uint32_t TxLogIfft1200InSize; + + unsigned long RxLogFftOutAddr; + uint32_t RxLogFftOutSize; + + unsigned long RxLogFftOutExpAddr; + uint32_t RxLogFftOutExpSize; + + unsigned long RxLogFftOutGainAddr; + uint32_t RxLogFftOutGainSize; + + unsigned long RxLogBufAddr; + uint32_t RxLogBufSize; + + unsigned long RxLogAlawBufAddr; + uint32_t RxLogAlawBufSize; + + unsigned long RxLogPrachBufAddr; + uint32_t RxLogPrachBufSize; + + uint32_t cfg_dl_iq_buf_enabled; + uint32_t cfg_ul_iq_buf_enabled; + +}XRANFHLOGCONF, *PXRANFHLOGCONF; + +/** XRAN front haul frame config */ +typedef struct tagXRANFRAMECONFIG +{ + /** Frame Duplex type: 0 -> FDD, 1 -> TDD */ + uint8_t nFrameDuplexType; + /** Numerology, determine sub carrier spacing, Value: 0->4 + 0: 15khz, 1: 30khz, 2: 60khz + 3: 120khz, 4: 240khz */ + uint8_t nNumerology; + /** TDD period */ + uint8_t nTddPeriod; +}XRANFRAMECONFIG, *PXRANFRAMECONFIG; + +/** XRAN front haul BBU pooling config */ +typedef struct tagXRANBBUPOOLCONFIG +{ + uint32_t isBbuPool; /**< FH running with BBU pool */ +}XRANBBUPOOLCONFIG, *PXRANBBUPOOLCONFIG; + +/** XRAN front haul IQ compression settings */ +typedef struct tagXRANRUCONFIG +{ + uint8_t iqWidth; /**< IQ bit width */ + uint8_t compMeth; /**< Compression method */ + uint8_t fftSize; /**< FFT Size */ +}XRANRUCONFIG, *PXRANRUCONFIG; + +/** XRAN front haul Phase compensation settings */ +typedef struct +{ + uint32_t nSecNum; + uint32_t nPhaseCompFlag; + uint32_t nDlArfcn[XRAN_MAX_SECTOR_NR]; + uint32_t nUlArfcn[XRAN_MAX_SECTOR_NR]; +}XRANPHASECompConfig; + +/** + * @ingroup xran + *XRAN front haul general configuration */ +typedef struct tagXRANFHCONFIG +{ + uint32_t dpdk_port; /**< DPDK port number used for FH */ + uint32_t sector_id; /**< Band sector ID for FH */ + uint32_t nCC; /**< number of Component carriers supported on FH */ + uint32_t neAxc; /**< number of eAxc supported on FH */ + XRANPLAYBACKCONFIG playback_conf;/**< configuration of playback of IQs supported with FH */ + XRANFHLOGCONF log_conf; /**< config of logging functionality supported by FH */ + XRANFHTTIPROCCB ttiCb; /**< call back for TTI event */ + void *ttiCbParam; /**< parameters of call back function */ + XRANPRACHCONFIG prach_conf; /**< PRACH specific configurations for FH */ + XRANFRAMECONFIG frame_conf; /**< frame config */ + XRANBBUPOOLCONFIG bbu_conf; /**< BBU pool config */ + XRANRUCONFIG ru_conf; /**< config of RU as per XRAN spec */ + XRANPHASECompConfig phase_compensation; /**< phase compensation settings */ +}XRANFHCONFIG, *PXRANFHCONFIG; + + +/** + * @ingroup xran + * CC instance handle pointer type */ +typedef void * XranCcInstanceHandleVoidP; + +/** + ***************************************************************************** + * @ingroup xran + * + * @description + * A flat buffer structure. The data pointer, pData, is a virtual address. + * The API requires the memory to by physically contiguous. Each flat + * buffer segment may contain several equally sized elements. + * + *****************************************************************************/ +typedef struct XRANFlatBuffer +{ + uint32_t nElementLenInBytes; + /**< The Element length specified in bytes. + * This parameter specifies the size of a single element in the buffer. + * The total size of the buffer is described as + * bufferSize = nElementLenInBytes * nNumberOfElements */ + uint32_t nNumberOfElements; + /**< The number of elements in the physical contiguous memory segment */ + uint32_t nOffsetInBytes; + /**< Offset in bytes to the start of the data in the physical contiguous + * memory segment */ + uint32_t nIsPhyAddr; + uint8_t *pData; + /**< The data pointer is a virtual address, however the actual data pointed + * to is required to be in contiguous physical memory unless the field + requiresPhysicallyContiguousMemory in CpaInstanceInfo is false. */ +} XRANFlatBufferStruct; + +/** + ***************************************************************************** + * @ingroup xran + * Scatter/Gather buffer list containing an array of Simple buffers. + * + * @description + * A Scatter/Gather buffer list structure. It is expected that this buffer + * structure will be used where more than one flat buffer can be provided + * on a particular API. + * + * IMPORTANT - The memory for the pPrivateMetaData member must be allocated + * by the client as contiguous memory. When allocating memory for + * pPrivateMetaData a call to cpaCyBufferListGetMetaSize MUST be made to + * determine the size of the Meta Data Buffer. The returned size + * (in bytes) may then be passed in a memory allocation routine to allocate + * the pPrivateMetaData memory. + * + *****************************************************************************/ +typedef struct XRANBufferList +{ + uint32_t nNumBuffers; + /**< Number of pointers */ + XRANFlatBufferStruct *pBuffers; + /**< Pointer to an unbounded array containing the number of CpaFlatBuffers + * defined by nNumBuffers */ + void *pUserData; + /**< This is an opaque field that is not read or modified internally. */ + void *pPrivateMetaData; + /**< Private Meta representation of this buffer List - the memory for this + * buffer needs to be allocated by the client as contiguous data. + * The amount of memory required is returned with a call to + * cpaCyBufferListGetMetaSize. If cpaCyBufferListGetMetaSize returns a size + * of zero no memory needs to be allocated, and this parameter can be NULL. + */ +} XRANBufferListStruct; + +/** + * @ingroup xran + * Initialize the XRAN Layer via DPDK. + * + * @param argc + * A non-negative value. If it is greater than 0, the array members + * for argv[0] through argv[argc] (non-inclusive) shall contain pointers + * to strings. + * @param argv + * An array of strings. The contents of the array, as well as the strings + * which are pointed to by the array, may be modified by this function. + * + * @return + * 0 - on success + * Error codes returned via rte_errno + */ +int32_t xran_init(int argc, char *argv[], PXRANFHINIT p_xran_fh_init, char *appName, void ** pHandle); + +/** + * @ingroup xran + * + * Function returns handles for number of sectors supported by XRAN layer. Currently function + * supports one handle XRAN layer where it supports only one CC + * + * @param pHandle + * Pointer to XRAN layer handle + * @param nNumInstances + * total number of instances of CC + * @param pSectorInstanceHandles + * Pointer to XranCcInstanceHandleVoidP where to store Handle pointer + * + * @return + * 0 - on success + */ +int32_t xran_sector_get_instances (void * pHandle, uint16_t nNumInstances, + XranCcInstanceHandleVoidP * pSectorInstanceHandles); + +/** + * @ingroup xran + * + * Function initialize Memory Management subsystem (mm) in order to handle memory buffers between XRAN layer + * and PHY. + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param nMemorySize + * memory size of all segments + * @param nMemorySegmentSize + * size of memory per segment + * + * @return + * 0 - on success + */ +int32_t xran_mm_init (void * pHandle, uint64_t nMemorySize, uint32_t nMemorySegmentSize); + +/** + * @ingroup xran + * + * Function allocates buffer memory (bm) used between XRAN layer and PHY. In general case it's DPDK mbuf. + * it uses Memory Management system to get memory chunk and define memory pool on top of it. + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param nPoolIndex + * pointer to buffer pool identification to be returned + * @param nNumberOfBuffers + * number of buffer to allocate in the pool + * @param nBufferSize + * buffer size to allocate + * + * @return + * 0 - on success + */ +int32_t xran_bm_init (void * pHandle, uint32_t * pPoolIndex, uint32_t nNumberOfBuffers, uint32_t nBufferSize); + +/** + * @ingroup xran + * + * Function allocates buffer used between XRAN layer and PHY. In general case it's DPDK mbuf. + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param nPoolIndex + * buffer pool identification + * @param ppVirtAddr + * Pointer to pointer where to store address of new buffer + * + * @return + * 0 - on success + */ +int32_t xran_bm_allocate_buffer(void * pHandle, uint32_t nPoolIndex, void **ppVirtAddr); + +/** + * @ingroup xran + * + * Function frees buffer used between XRAN layer and PHY. In general case it's DPDK mbuf + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param pVirtAddr + * Pointer to buffer + * + * @return + * 0 - on success + */ +int32_t xran_bm_free_buffer(void * pHandle, void *pVirtAddr); + +/** + * @ingroup xran + * + * Function destroys Memory Management (MM) layer of XRAN library + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * + * @return + * 0 - on success + */ +int32_t xran_mm_destroy (void * pHandle); + +/** + * @ingroup xran + * + * Function configures TX(DL) and RX(UL) output buffers and callback (UL only) for XRAN layer with + * given handle + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param pSrcBuffer + * list of memory buffers to use to fetch IQs from PHY to XRAN layer (DL) + * @param pDstBuffer + * list of memory buffers to use to deliver IQs from XRAN layer to PHY (UL) + * @param XranTransportBlockCallbackFn pCallback + * Callback function to call with arrival of all packets for given CC for given symbol + * @param pCallbackTag + * Parameters of Callback function + * + * @return + * 0 - on success + * -1 - on error + */ +int32_t xran_5g_fronthault_config (void * pHandle, + XRANBufferListStruct *pSrcBuffer[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN], + XRANBufferListStruct *pDstBuffer[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN], + XranTransportBlockCallbackFn pCallback, + void *pCallbackTag); + +/** + * @ingroup xran + * + * Function configures PRACH output buffers and callback for XRAN layer with given handle + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param pDstBuffer + * list of memory buffers to use to deliver PRACH IQs from xran layer to PHY + * @param XranTransportBlockCallbackFn pCallback + * Callback function to call with arrival of PRACH packets for given CC + * @param pCallbackTag + * Parameters of Callback function + * + * @return + * 0 - on success + * -1 - on error + */ +int32_t xran_5g_prach_req (void * pHandle, + XRANBufferListStruct *pDstBuffer[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN], + XranTransportBlockCallbackFn pCallback, + void *pCallbackTag); +/** + * @ingroup xran + * + * Function configures phase compensation for RU via XRAN layer with given handle + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param nTxPhaseCps + * TX(DL) phase compensation settings + * @param nTxPhaseCps + * RX(UL) phase compensation settings + * @param nSectorId + * Sector id to use with given settings + * + * @return + * 0 - on success + */ +int32_t xran_5g_pre_compenstor_cfg(void* pHandle, + uint32_t nTxPhaseCps, + uint32_t nRxPhaseCps, + uint8_t nSectorId); + +/** + * @ingroup xran + * + * Function opens XRAN layer with given handle + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param PXRANFHCONFIG pConf + * Pointer to XRAN configuration structure with specific settings to use + * + * @return + * 0 - on success + */ +int32_t xran_open(void *pHandle, PXRANFHCONFIG pConf); + +/** + * @ingroup xran + * + * Function starts XRAN layer with given handle + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * + * @return + * 0 - on success + */ +int32_t xran_start(void *pHandle); + +/** + * @ingroup xran + * + * Function stops XRAN layer with given handle + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * + * @return + * 0 - on success + */ +int32_t xran_stop(void *pHandle); + +/** + * @ingroup xran + * + * Function closes XRAN layer with given handle + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * + * @return + * 0 - on success + */ +int32_t xran_close(void *pHandle); + +/** + * @ingroup xran + * + * Function registers callback to XRAN layer. Function support callbacks aligned on packet arrival. + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param symCb + * pointer to callback function + * @param symCb + * pointer to Callback Function parameters + * @param symb + * symbol to be register for + * @param ant + * Antenna number to trigger callback for packet arrival + * + * @return + * 0 - in case of success + * -1 - in case of failure + */ +int32_t xran_reg_sym_cb(void *pHandle, XRANFHSYMPROCCB symCb, void * symCbParam, uint8_t symb, uint8_t ant); + +/** + * @ingroup xran + * + * Function registers callback to XRAN layer. Function support callbacks align to OTA time. TTI even, half of slot, + * full slot with respect to PTP time. + * + * @param pHandle + * Pointer to XRAN layer handle for given CC + * @param Cb + * pointer to callback function + * @param cbParam + * pointer to Callback Function parameters + * @param skipTtiNum + * number of calls to be skipped before first call + * @param callback_to_phy_id + * call back time identification (see enum callback_to_phy_id) + * + * @return + * 0 - in case of success + * -1 - in case of failure + */ +int32_t xran_reg_physide_cb(void *pHandle, XRANFHTTIPROCCB Cb, void *cbParam, int skipTtiNum, enum callback_to_phy_id); + +/** + * @ingroup xran + * + * Function returns current TTI, Frame, Subframe, Slot Number as seen "Over air" base on PTP time + * + * @param nFrameIdx + * Pointer to Frame number [0-99] + * + * @param nSubframeIdx + * Pointer to Subframe number [0-10] + * + * @param nSlotIdx + * Pointer to Slot number [0-7] + * + * @param nSecond + * Pointer to current UTC second + * + * @return + * current TTI number [0-7999] + */ +int32_t xran_get_slot_idx (uint32_t *nFrameIdx, uint32_t *nSubframeIdx, uint32_t *nSlotIdx, uint64_t *nSecond); + +#ifdef __cplusplus +} +#endif + +#endif /* _XRAN_FH_LLS_CU_H_*/ diff --git a/fhi_lib/lib/api/xran_pkt.h b/fhi_lib/lib/api/xran_pkt.h new file mode 100644 index 0000000..112ea41 --- /dev/null +++ b/fhi_lib/lib/api/xran_pkt.h @@ -0,0 +1,261 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief Definitions and support functions to process XRAN packet + * @file xran_pkt.h + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +/* XRAN-FH.CUS.0-v02.01.03 xRAN Front haul Working Group Control, User and Synchronization Plane Specification */ + +/* + * Layer common to data and control packets + */ + +#ifndef _XRAN_PKT_H_ +#define _XRAN_PKT_H_ + +#include +#include +#include + + +/** + ***************************************************************************** + * @file xran_pkt.h + * + * @defgroup xran_common_pkt XRAN Packet definitions and functions + * @ingroup xran + * + * @description + * Definitions and support functions to process XRAN packet + *****************************************************************************/ + +#define ECPRI_MAX_PAYLOAD_SIZE 65535 /**< Max packet size taken in this implementation */ + +/* XRAN spec: For this encapsulation, either the eCPRI Ethertype or the IEEE 1914.3 Ethertype shall be use */ +#define XRAN_ETHER_TYPE 0xAEFE /**< defined by eCPRI Specification V1.1 */ + +#define XRAN_ECPRI_VER 0x0001 /**< eCPRI protocol revision 3.1.3.1.1 */ +#define XRAN_PAYLOAD_VER 0x0001 /**< Payload version 5.4.4.2 */ + +#define VLAN_ID 0 /**< Default Tag protocol identifier (TPID)*/ +#define VLAN_PCP 7 /**< U-Plane and C-Plane only see Table 3 5 : Quality of service classes */ + +/** + ****************************************************************************** + * @ingroup xran_common_pkt + * + * @description + * eCPRI message types + * as per eCPRI spec 3.2.4. Message Types + *****************************************************************************/ +enum ecpri_msg_type +{ + ECPRI_IQ_DATA = 0x00, /**< U-plane: IQ data */ + ECPRI_BIT_SEQUENCE = 0x01, /* msg type is not supported */ + ECPRI_RT_CONTROL_DATA = 0x02, /**< C-plane: Control */ + + /* Below msg types are not supported */ + ECPRI_GEN_DATA_TRANSFER = 0x03, + ECPRI_REMOTE_MEM_ACCESS = 0x04, + ECPRI_DELAY_MEASUREMENT = 0x05, + ECPRI_REMOTE_RESET = 0x06, + ECPRI_EVENT_INDICATION = 0x07, + ECPRI_MSG_TYPE_MAX +}; + +/** + ****************************************************************************** + * @ingroup xran_common_pkt + * + * @description + * see 3.1.3.1.7 ecpriSeqid (message identifier) + *****************************************************************************/ +struct ecpri_seq_id +{ + uint8_t seq_id:8; /**< Sequence ID */ + uint8_t sub_seq_id:7; /**< Subsequence ID */ + uint8_t e_bit:1; /**< E bit */ +} __rte_packed; + + +/** + ****************************************************************************** + * @ingroup xran_common_pkt + * + * @description + * Structure holds common eCPRI header as per + * Table 3 1 : eCPRI Transport Header Field Definitions + *****************************************************************************/ +struct xran_ecpri_hdr +{ + uint8_t ecpri_concat:1; /**< This parameter indicates when eCPRI concatenation is in use + (allowing multiple eCPRI messages in a single Ethernet payload). + NOTE: This parameter is part of the eCPRI common header. */ + uint8_t ecpri_resv:3; /**< This parameter is reserved for eCPRI future use. + NOTE: This parameter is part of the eCPRI common header. */ + uint8_t ecpri_ver:4; /**< This parameter indicates the eCPRI protocol version. + NOTE: This parameter is part of the eCPRI common header. */ + uint8_t ecpri_mesg_type:8; /**< This parameter indicates the type of service conveyed by + the message type. NOTE: This parameter is part of the eCPRI + common header. NOTE: In this version of the specification, + only values "0000 0000b" and "0000 0010b" and "0000 0101b" are used. */ + rte_be16_t ecpri_payl_size:16; /**< This parameter is the size in bytes of the payload part + of the corresponding eCPRI message. It does not include any padding bytes + following the eCPRI message. The maximum supported payload size is 216-1, + but the actual size may be further limited by the maximum payload size of + the underlying transport network. NOTE: This parameter is part of the + eCPRI common header. */ + + rte_be16_t ecpri_xtc_id; /**< 3.1.3.1.6 This parameter is a component_eAxC identifier (c_eAxC ID) and + identifies the specific data flow associated with each C-Plane (ecpriRtcid) or + U-Plane (ecpriPcid) message. It is the analog of CPRI's "AxC" (antenna-carrier) + value so is designated here as "eAxC" ("e" for "extended" to accommodate multiple + bands and multiple component carriers). In addition, the "eAxC" is divided into + "component eAxC" parts (c_eAxC) because multiple lls-CU processors may contribute + to a single eAxC and must be identified for correct data routing. */ + + struct ecpri_seq_id ecpri_seq_id; /**< This parameter provides unique message identification and ordering on + two different levels. The first octet of this parameter is the Sequence ID, which is used to identify ordering of + messages within an eAxC message stream. The Sequence ID field increments and wraps independently for each U-Plane + eAxC DL, U-Plane eAxC UL, C-Plane eAxC DL, and C-Plane eAxC UL, even if they share the same eAxC ID. + The Sequence ID is used to verify that all messages are received and also to reorder messages that are received out of order. + The second octet of this parameter is the Subsequence ID. The Subsequence ID is used to verify ordering and implement + reordering when radio-transport-level (eCPRI or IEEE-1914.3) fragmentation occurs. + Radio-transport (eCPRI or IEEE-1914.3) fragmentation is a method of splitting U-plane messages containing one or + more sections whose length exceeds the maximum packet or message length of the underlying protocol. + The Subsequence ID field consists of a 7 bit Subsequence counter and a single bit field, called E-bit. + The Subsequence number increments starting from zero for each fragment of a U-plane message. The E bit + is used to indicate the last message of the radio-transport level fragments. It is always set to zero + except for the last message of the U-plane fragment. In the case of C-plane messages radio-transport + fragmentation is not allowed, therefore the Subsequence ID shall be set to zero, and the E bit set to one. + See Section 3.1.4 for a description of the fragmentation process. + NOTE: As an alternative to radio-transport-level fragmentation, application fragmentation can be implemented. + In this case the application can take the responsibility to ensure all transport messages are not too long + (fit within the necessary transport payload size). When this "application layer fragmentation" is used, + the subsequence identifier shall always be set to "0", and the E-bit set to "1" (See Section 3.1.4). */ + +} __rte_packed; + +/** + ****************************************************************************** + * @ingroup xran_common_pkt + * + * @description + * Structure holds complete xran packet header + * 3.1.1 Ethernet Encapsulation + *****************************************************************************/ +struct xran_pkt_hdr +{ + struct ether_hdr eth_hdr; /**< Ethernet Header */ + struct vlan_hdr vlan_hdr; /**< VLAN Header */ + struct xran_ecpri_hdr ecpri_hdr; /**< eCPRI Transport Header */ +}; + +/** + ****************************************************************************** + * @ingroup xran_common_pkt + * + * @description + * Enum used to set xRAN packet data direction (gNB Tx/Rx 5.4.4.1) + * uplink or downlink + *****************************************************************************/ +enum xran_pkt_dir +{ + XRAN_DIR_UL = 0, /**< UL direction */ + XRAN_DIR_DL = 1, /**< DL direction */ + XRAN_DIR_MAX +}; + +/** + ****************************************************************************** + * @ingroup xran_common_pkt + * + * @description + * Structure holds components of radio application header + * 5.4.4 Coding of Information Elements - Application Layer, Common + * for U-plane as per 6.3.2 DL/UL Data + *****************************************************************************/ +struct radio_app_common_hdr +{ + /* Octet 9 */ + uint8_t filter_id:4; /**< This parameter defines an index to the channel filter to be + used between IQ data and air interface, both in DL and UL. + For most physical channels filterIndex =0000b is used which + indexes the standard channel filter, e.g. 100MHz channel filter + for 100MHz nominal carrier bandwidth. (see 5.4.4.3 for more) */ + uint8_t payl_ver:3; /**< This parameter defines the payload protocol version valid + for the following IEs in the application layer. In this version of + the specification payloadVersion=001b shall be used. */ + uint8_t data_direction:1; /**< This parameter indicates the gNB data direction. */ + + /* Octet 10 */ + uint8_t frame_id:8; /**< This parameter is a counter for 10 ms frames (wrapping period 2.56 seconds) */ + + /* Octet 11 */ + /* Octet 12 */ + union { + uint16_t value; + struct { + uint16_t symb_id:6; /**< This parameter identifies the first symbol number within slot, + to which the information of this message is applies. */ + uint16_t slot_id:6; /**< This parameter is the slot number within a 1ms sub-frame. All slots in + one sub-frame are counted by this parameter, slotId running from 0 to Nslot-1. + In this version of the specification the maximum Nslot=16, All + other values of the 6 bits are reserved for future use. */ + uint16_t subframe_id:4; /**< This parameter is a counter for 1 ms sub-frames within 10ms frame. */ + }; + }sf_slot_sym; + +} __rte_packed; + +/** + ****************************************************************************** + * @ingroup xran_common_pkt + * + * @description + * This parameter defines the compression method and IQ bit width for the + * user data in the data section. This field is absent from U-Plane messages + * when the static IQ format and compression method is configured via the M-Plane. + * In this way a single compression method and IQ bit width is provided + * (per UL and DL, per LTE and NR) without adding more overhead to U-Plane messages. + *****************************************************************************/ +struct compression_hdr +{ + uint8_t ud_iq_width:4; /**< Bit width of each I and each Q + 16 for udIqWidth=0, otherwise equals udIqWidth e.g. udIqWidth = 0000b means I and Q are each 16 bits wide; + e.g. udIQWidth = 0001b means I and Q are each 1 bit wide; + e.g. udIqWidth = 1111b means I and Q are each 15 bits wide + */ + uint8_t ud_comp_meth:4; + /**< udCompMeth| compression method |udIqWidth meaning + ---------------+-----------------------------+-------------------------------------------- + 0000b | no compression |bitwidth of each uncompressed I and Q value + 0001b | block floating point |bitwidth of each I and Q mantissa value + 0010b | block scaling |bitwidth of each I and Q scaled value + 0011b | mu-law |bitwidth of each compressed I and Q value + 0100b | modulation compression |bitwidth of each compressed I and Q value + 0100b - 1111b | reserved for future methods |depends on the specific compression method + */ +} __rte_packed; + +#endif diff --git a/fhi_lib/lib/api/xran_pkt_cp.h b/fhi_lib/lib/api/xran_pkt_cp.h new file mode 100644 index 0000000..0f0e1ba --- /dev/null +++ b/fhi_lib/lib/api/xran_pkt_cp.h @@ -0,0 +1,287 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides the definition of Control Plane Messages + * for XRAN Front Haul layer as defined in XRAN-FH.CUS.0-v02.01. + * + * @file xran_pkt_cp.h + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#ifndef _XRAN_PKT_CP_H_ +#define _XRAN_PKT_CP_H_ + + +/********************************************************************** + * Common structures for C/U-plane + **********************************************************************/ +/** + * @ingroup xran_cp_pkt + * + * @description + * user data compression header defined in 5.4.4.10 / 6.3.3.13 + */ +struct xran_radioapp_udComp_header { + uint8_t udCompMeth:4; /**< Compression method, XRAN_COMPMETHOD_xxxx */ + uint8_t udIqWidth:4; /**< IQ bit width, 1 ~ 16 */ + } __attribute__((__packed__)); + + +/********************************************************************** + * Definition of C-Plane Protocol 5.4 + **********************************************************************/ +/** + * @ingroup xran_cp_pkt + * + * @description + * Common Radio Application Header for C-Plane + */ +struct xran_cp_radioapp_common_header { /* 6bytes, first 4bytes need the conversion for byte order */ + uint32_t startSymbolId:6; /**< 5.4.4.7 start symbol identifier */ + uint32_t slotId:6; /**< 5.4.4.6 slot identifier */ + uint32_t subframeId:4; /**< 5.4.4.5 subframe identifier */ + uint32_t frameId:8; /**< 5.4.4.4 frame identifier */ + uint32_t filterIndex:4; /**< 5.4.4.3 filter index, XRAN_FILTERINDEX_xxxx */ + uint32_t payloadVer:3; /**< 5.4.4.2 payload version, should be 1 */ + uint32_t dataDirection:1; /**< 5.4.4.1 data direction (gNB Tx/Rx) */ + uint8_t numOfSections; /**< 5.4.4.8 number of sections */ + uint8_t sectionType; /**< 5.4.4.9 section type */ + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * frame structure defined in 5.4.4.13 + */ +struct xran_cp_radioapp_frameStructure { + uint8_t uScs:4; /**< sub-carrier spacing, XRAN_SCS_xxx */ + uint8_t fftSize:4; /**< FFT size, XRAN_FFTSIZE_xxx */ + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section headers definition for C-Plane. + * Section type 6 and 7 are not present since those have different fields. + */ +struct xran_cp_radioapp_section_header { // 8bytes, need the conversion for byte order + union { + struct { + uint32_t reserved:16; + uint32_t numSymbol:4; /**< 5.4.5.7 number of symbols */ + uint32_t reMask:12; /**< 5.4.5.5 resource element mask */ + } s0; + struct { + uint32_t beamId:15; /**< 5.4.5.9 beam identifier */ + uint32_t ef:1; /**< 5.4.5.8 extension flag */ + uint32_t numSymbol:4; /**< 5.4.5.7 number of symbols */ + uint32_t reMask:12; /**< 5.4.5.5 resource element mask */ + } s1; + struct { + uint32_t beamId:15; /**< 5.4.5.9 beam identifier */ + uint32_t ef:1; /**< 5.4.5.8 extension flag */ + uint32_t numSymbol:4; /**< 5.4.5.7 number of symbols */ + uint32_t reMask:12; /**< 5.4.5.5 resource element mask */ + } s3; + struct { + uint32_t ueId:15; /**< 5.4.5.10 UE identifier */ + uint32_t ef:1; /**< 5.4.5.8 extension flag */ + uint32_t numSymbol:4; /**< 5.4.5.7 number of symbols */ + uint32_t reMask:12; /**< 5.4.5.5 resource element mask */ + } s5; + } u; + + uint32_t numPrbc:8; /**< 5.4.5.6 number of contiguous PRBs per control section */ + uint32_t startPrbc:10; /**< 5.4.5.4 starting PRB of control section */ + uint32_t symInc:1; /**< 5.4.5.3 symbol number increment command XRAN_SYMBOLNUMBER_xxxx */ + uint32_t rb:1; /**< 5.4.5.2 resource block indicator, XRAN_RBIND_xxx */ + uint32_t sectionId:12; /**< 5.4.5.1 section identifier */ + } __attribute__((__packed__)); + + +/********************************************************** + * Scheduling and Beam-forming Commands 5.4.2 + **********************************************************/ +/** + * @ingroup xran_cp_pkt + * + * @description + * Section header definition for type 0 + */ +struct xran_cp_radioapp_section0_header { // 12bytes (6+2+1+2+1) + struct xran_cp_radioapp_common_header cmnhdr; + uint16_t timeOffset; /**< 5.4.4.12 time offset */ + + struct xran_cp_radioapp_frameStructure frameStructure; + uint16_t cpLength; /**< 5.4.4.14 cyclic prefix length */ + uint8_t reserved; + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section definition for type 0: Unused RB or Symbols in DL or UL (Table 5-2) + * Not supported in this release + */ +struct xran_cp_radioapp_section0 { // 8bytes (4+4) + struct xran_cp_radioapp_section_header hdr; + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section header definition for type 1 + */ +struct xran_cp_radioapp_section1_header { // 8bytes (6+1+1) + struct xran_cp_radioapp_common_header cmnhdr; + struct xran_radioapp_udComp_header udComp; + uint8_t reserved; + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section definition for type 1: Most DL/UL Radio Channels (Table 5-3) + */ +struct xran_cp_radioapp_section1 { // 8bytes (4+4) + struct xran_cp_radioapp_section_header hdr; + + // section extensions // 5.4.6 & 5.4.7 + // ......... + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section header definition for type 3 + */ +struct xran_cp_radioapp_section3_header { // 12bytes (6+2+1+2+1) + struct xran_cp_radioapp_common_header cmnhdr; + uint16_t timeOffset; /**< 5.4.4.12 time offset */ + + struct xran_cp_radioapp_frameStructure frameStructure; + uint16_t cpLength; /**< 5.4.4.14 cyclic prefix length */ + struct xran_radioapp_udComp_header udComp; + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section definition for type 3: PRACH and Mixed-numerology Channels (Table 5-4) + */ +struct xran_cp_radioapp_section3 { // 12bytes (4+4+4) + struct xran_cp_radioapp_section_header hdr; + uint32_t freqOffset:24; /**< 5.4.5.11 frequency offset */ + uint32_t reserved:8; + + // section extensions // 5.4.6 & 5.4.7 + // ......... + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section header definition for type 5 + */ +struct xran_cp_radioapp_section5_header { // 8bytes (6+1+1) + struct xran_cp_radioapp_common_header cmnhdr; + struct xran_radioapp_udComp_header udComp; + uint8_t reserved; + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section definition for type 5: UE scheduling information (Table 5-5) + * Not supported in this release + */ +struct xran_cp_radioapp_section5 { + struct xran_cp_radioapp_section_header hdr; + + // section extensions // 5.4.6 & 5.4.7 + // ......... + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section header definition for type 6 + */ +struct xran_cp_radioapp_section6_header { // 8bytes (6+1+1) + struct xran_cp_radioapp_common_header cmnhdr; + uint8_t numberOfUEs; /**< 5.4.4.11 number of UEs */ + uint8_t reserved; + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section definition for type 5: Channel Information (Table 5-6) + * Not supported in this release + */ +struct xran_cp_radioapp_section6 { + uint32_t regularizationFactor:16;/**< 5.4.5.12 regularization Factor */ + uint32_t ueId:15; /**< 5.4.5.10 UE identifier */ + uint32_t ef:1; /**< 5.4.5.8 extension flag */ + uint8_t startPrbch:2; /**< 5.4.5.4 starting PRB of control section */ + uint8_t symInc:1; /**< 5.4.5.3 symbol number increment command XRAN_SYMBOLNUMBER_xxxx */ + uint8_t rb:1; /**< 5.4.5.2 resource block indicator, XRAN_RBIND_xxx */ + uint8_t reserved:4; + uint8_t startPrbcl:8; /**< 5.4.5.4 starting PRB of control section */ + uint8_t numPrbc:8; /**< 5.4.5.6 number of contiguous PRBs per control section */ + + // ciIQsamples start from here // 5.4.5.13 channel information I and Q values + // ......... + // + // section extensions // 5.4.6 & 5.4.7 + // ......... + } __attribute__((__packed__)); + +/** + * @ingroup xran_cp_pkt + * + * @description + * Section header definition for type 7: LAA + * Not supported in this release + */ +struct xran_cp_radioapp_section7_header { + struct xran_cp_radioapp_common_header cmnhdr; + uint16_t reserved; + uint8_t laaMsgLen:4; /**< 5.4.5.15 LAA message length */ + uint8_t laaMsgType:4; /**< 5.4.5.14 LAA message type */ + + // Payload start from here // 5.4.5.16 ~ 5.4.5.32 + } __attribute__((__packed__)); + + +#endif /* _XRAN_PKT_CP_H_ */ diff --git a/fhi_lib/lib/api/xran_pkt_up.h b/fhi_lib/lib/api/xran_pkt_up.h new file mode 100644 index 0000000..a2399f0 --- /dev/null +++ b/fhi_lib/lib/api/xran_pkt_up.h @@ -0,0 +1,138 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief Definitions and support functions to process XRAN packet + * @file xran_pkt_up.h + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +/** + ***************************************************************************** + * @file xran_pkt_up.h + * + * @defgroup xran_up_pkt U-Plane XRAN Packet definitions and functions + * @ingroup xran + * + * @description + * Structures relevant to U-plane packets only (data now only) + *****************************************************************************/ +#ifndef _XRAN_PKT_UP_H_ +#define _XRAN_PKT_UP_H_ + +#include "xran_pkt.h" + +#define IQ_PAIR_NUM_IN_RB 12 +#define MAX_DATA_SECTIONS_NUM 273 +#define MAX_IQ_BIT_WIDTH 16 + +/* currently library supports I and Q sizes of 8 and 16 bits each */ +#define IQ_BITS MAX_IQ_BIT_WIDTH + +/* + * Structure holding data section header fields + * It is repeated for every section ID in xRAN packet + */ + +/** + ****************************************************************************** + * @ingroup xran_up_pkt + * + * @description + * Structure holding data section header fields + * It is repeated for every section ID in xRAN packet + * 5.4.5 Coding of Information Elements - Application Layer, Sections + * for U-plane as per 6.3.2 DL/UL Data + *****************************************************************************/ +struct data_section_hdr { + union { + uint32_t all_bits; + struct { + uint32_t num_prbu:8; /**< 5.4.5.6 number of contiguous PRBs per control section */ + uint32_t start_prbu:10; /**< 5.4.5.4 starting PRB of control section */ + uint32_t sym_inc:1; /**< 5.4.5.3 symbol number increment command XRAN_SYMBOLNUMBER_xxxx */ + uint32_t rb:1; /**< 5.4.5.2 resource block indicator, XRAN_RBIND_xxx */ + uint32_t sect_id:12; /**< 5.4.5.1 section identifier */ + }; + }fields; + } __attribute__((__packed__)); + + +/* + ****************************************************************************** + * @ingroup xran_up_pkt + * + * @description + * Structure holds compression header structure and field reserved for future use. + * reserved goes always with udCompHdr in u-plane pkt + * U-plane as per 6.3.2 DL/UL Data + *****************************************************************************/ +struct data_section_compression_hdr +{ + struct compression_hdr ud_comp_hdr; + uint8_t rsrvd; /**< This parameter provides 1 byte for future definition, + should be set to all zeros by the sender and ignored by the receiver. + This field is only present when udCompHdr is present, and is absent when + the static IQ format and compression method is configured via the M-Plane */ + + /* TODO: support for Block Floating Point compression */ + /* udCompMeth 0000b = no compression absent*/ +}; + +/* + ****************************************************************************** + * @ingroup xran_up_pkt + * + * @description + * Structure holds the compression parameters by the compression header. + * may not be present by udCompMeth in 6.3.3.13 + *****************************************************************************/ +union compression_params { + struct block_fl_point { + uint8_t exponent:4; + uint8_t reserved:4; + } blockFlPoint; + struct block_scaling { + uint8_t sblockScaler; + } blockScaling; + struct u_law { + uint8_t compShift:4; + uint8_t compBitWidth:4; + } uLaw; + } __attribute__((__packed__)); + + +/* + ****************************************************************************** + * @ingroup xran_up_pkt + * + * @description + * Structure holds an IQ sample pair + * U-plane as per 6.3.2 DL/UL Data + * Each bit field size is defined with IQ_BITS macro + * Currently supported I and Q sizes are 8 and 16 bits + *****************************************************************************/ +struct rb_map +{ + int16_t i_sample:IQ_BITS; /**< This parameter is the In-phase sample value */ + int16_t q_sample:IQ_BITS; /**< This parameter is the Quadrature sample value */ +} __rte_packed;; + +#endif diff --git a/fhi_lib/lib/api/xran_sync_api.h b/fhi_lib/lib/api/xran_sync_api.h new file mode 100644 index 0000000..2e98311 --- /dev/null +++ b/fhi_lib/lib/api/xran_sync_api.h @@ -0,0 +1,41 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides interface to synchronization related APIs (PTP/1588) + * for XRAN. + * + * @file xran_sync_api.h + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#ifndef _XRAN_SYNC_API_H_ +#define _XRAN_SYNC_API_H_ + +/** + * @brief Function checks if machine is synchronized using PTP for Linux + * software. + * + * @return int Returns 0 if synchronized, otherwise positive. + */ +int xran_is_synchronized(void); + +#endif /* _XRAN_SYNC_API_H_ */ diff --git a/fhi_lib/lib/api/xran_timer.h b/fhi_lib/lib/api/xran_timer.h new file mode 100644 index 0000000..d44b5e0 --- /dev/null +++ b/fhi_lib/lib/api/xran_timer.h @@ -0,0 +1,47 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides interface to Timing for XRAN. + * + * @file xran_timer.h + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#ifndef _XRAN_TIMER_H +#define _XRAN_TIMER_H +#include +#include +#include +#include + +#define MSEC_PER_SEC 1000L + +#define XranIncrementSymIdx(sym_idx, numSymPerMs) (((uint32_t)sym_idx >= (((uint32_t)numSymPerMs * MSEC_PER_SEC) - 1)) ? 0 : (uint32_t)sym_idx+1) +#define XranDecrementSymIdx(sym_idx, numSymPerMs) (((uint32_t)sym_idx == 0) ? (((uint32_t)numSymPerMs * MSEC_PER_SEC)) - 1) : (uint32_t)sym_idx-1) + +long poll_next_tick(long interval_ns); +long sleep_next_tick(long interval); +int timing_set_debug_stop(int value); +int timing_get_debug_stop(void); +inline uint64_t timing_get_current_second(void); + +#endif diff --git a/fhi_lib/lib/api/xran_transport.h b/fhi_lib/lib/api/xran_transport.h new file mode 100644 index 0000000..6d69c3e --- /dev/null +++ b/fhi_lib/lib/api/xran_transport.h @@ -0,0 +1,74 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides the definitions for Transport layer (eCPRI) API. + * + * @file xran_transport.h + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#ifndef _XRAN_TRANSPORT_H_ +#define _XRAN_TRANSPORT_H_ + +#include +#include + +#include "xran_pkt.h" + +struct xran_eaxc_info { + uint8_t cuPortId; + uint8_t bandSectorId; + uint8_t ccId; + uint8_t ruPortId; + }; + +/** + * @brief Compose ecpriRtcid/ecpriPcid + * + * @param CU_Port_ID CU Port ID + * @param BanbSector_ID Band Sector ID + * @param CC_ID Component Carrier ID + * @param Ant_ID RU Port ID (antenna ID) + * @return uint16_t composed ecpriRtcid/ecpriPcid + */ +uint16_t xran_compose_cid(uint8_t CU_Port_ID, uint8_t BandSector_ID, uint8_t CC_ID, uint8_t Ant_ID); + +/** + * @brief Decompose ecpriRtcid/ecpriPcid + * + * @param cid composed ecpriRtcid/ecpriPcid (network byte order) + * @param result the pointer of the structure to store decomposed values + * @return none + */ +void xran_decompose_cid(uint16_t cid, struct xran_eaxc_info *result); + +/** + * @brief modify the payload size of eCPRI header in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet which has eCPRI header already + * @param size payload size to be updated + * @return none + */ +void xran_update_ecpri_payload_size(struct rte_mbuf *mbuf, int size); + +#endif + diff --git a/fhi_lib/lib/api/xran_up_api.h b/fhi_lib/lib/api/xran_up_api.h new file mode 100644 index 0000000..4665762 --- /dev/null +++ b/fhi_lib/lib/api/xran_up_api.h @@ -0,0 +1,116 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides the definitions for User Plane Messages APIs. + * + * @file xran_up_api.h + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#ifndef _XRAN_UP_API_H_ +#define _XRAN_UP_API_H_ + +#include +#include + +#include "xran_pkt.h" +#include "xran_pkt_up.h" + +#define XRAN_BYTE_ORDER_SWAP + +/* + * structure used for storing packet parameters needed for generating + * a data packet + */ +struct xran_up_pkt_gen_params +{ + struct radio_app_common_hdr app_params; + struct data_section_hdr sec_hdr; + struct data_section_compression_hdr compr_hdr_param; + union compression_params compr_param; +}; + +/* + * structure used for storing packet parameters needed for generating + * a data packet without compression + * Next fields are omitted: + * udCompHdr (not always present) + * reserved (not always present) + * udCompParam (not always present) + */ +struct xran_up_pkt_gen_no_compression_params +{ + struct radio_app_common_hdr app_params; + struct data_section_hdr sec_hdr; +}; + + +/** + * @brief Function that is preparing an mbuf with portion of IQ samples related + * to the single symbol. + * + * @param mbuf Initialized rte_mbuf packet + * @param iq_data_start Address of the first element in IQ data array. + * @param iq_data_num_elements Size of the IQ data array. + * @param iq_data_offset IQ data array's elements already sent. + * @param alignment Align data to this many bytes. + * @param params Structure containing Radio App Header and Data Section Header + * structures. + * @return int Bytes of IQ samples that have been appended to the packet. + */ +int xran_prepare_iq_symbol_portion( + struct rte_mbuf *mbuf, + const void *iq_data_start, + const uint32_t iq_data_num_bytes, + uint32_t *iq_data_offset, + const uint8_t alignment, + struct xran_up_pkt_gen_params *params, + int sub_seq_id); + +/** + * @brief Function extracts IQ samples from received mbuf packet. + * + * @param mbuf Packet with received data. + * @param iq_data_start Address of the first IQ sample in mbuf will be returned + * here + * @return int Bytes of IQ samples that have been extracted from mbuf. + */ +int xran_extract_iq_samples(struct rte_mbuf *mbuf, + void **iq_data_start, + uint8_t *CC_ID, + uint8_t *Ant_ID, + uint8_t *frame_id, + uint8_t *subframe_id, + uint8_t *slot_id, + uint8_t *symb_id, + struct ecpri_seq_id *seq_id); + +int xran_prepare_iq_symbol_portion_no_comp( + struct rte_mbuf *mbuf, + const void *iq_data_start, + const uint32_t iq_data_num_bytes, + struct xran_up_pkt_gen_no_compression_params *params, + uint8_t CC_ID, + uint8_t Ant_ID, + uint8_t seq_id); + +#endif /* _XRAN_UP_API_H_ */ diff --git a/fhi_lib/lib/ethernet/ethdi.c b/fhi_lib/lib/ethernet/ethdi.c new file mode 100644 index 0000000..3664ecc --- /dev/null +++ b/fhi_lib/lib/ethernet/ethdi.c @@ -0,0 +1,376 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file has all definitions for the Ethernet Data Interface Layer + * @file ethdi.c + * @ingroup group_lte_source_auxlib + * @author Intel Corporation + **/ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "ethernet.h" +#include "ethdi.h" +#ifndef MLOG_ENABLED +#include "../src/mlog_lnx_xRAN.h" +#else +#include "mlog_lnx.h" +#endif + +#include "../src/xran_lib_mlog_tasks_id.h" + +struct xran_ethdi_ctx g_ethdi_ctx = { 0 }; +enum xran_if_state xran_if_current_state = XRAN_STOPPED; + +struct rte_mbuf *xran_ethdi_mbuf_alloc(void) +{ + return rte_pktmbuf_alloc(_eth_mbuf_pool); +} + +int xran_ethdi_mbuf_send(struct rte_mbuf *mb, uint16_t ethertype) +{ + struct xran_ethdi_ctx *ctx = xran_ethdi_get_ctx(); + int res = 0; + + mb->port = ctx->io_cfg.port[ETHDI_UP_VF]; + xran_add_eth_hdr_vlan(&ctx->entities[ID_RU], ethertype, mb, ctx->up_vtag); + + res = xran_enqueue_mbuf(mb, ctx->tx_ring[ETHDI_UP_VF]); + return res; +} + +int xran_ethdi_mbuf_send_cp(struct rte_mbuf *mb, uint16_t ethertype) +{ + struct xran_ethdi_ctx *ctx = xran_ethdi_get_ctx(); + int res = 0; + + mb->port = ctx->io_cfg.port[ETHDI_CP_VF]; + xran_add_eth_hdr_vlan(&ctx->entities[ID_RU], ethertype, mb, ctx->cp_vtag); + + res = xran_enqueue_mbuf(mb, ctx->tx_ring[ETHDI_CP_VF]); + return res; +} + +void xran_ethdi_stop_tx() +{ + struct xran_ethdi_ctx *const ctx = xran_ethdi_get_ctx(); + rte_timer_stop_sync(&ctx->timer_tx); +} + + +struct { + uint16_t ethertype; + ethertype_handler fn; +} xran_ethertype_handlers[] = { + { ETHER_TYPE_ETHDI, NULL }, + { ETHER_TYPE_ECPRI, NULL }, + { ETHER_TYPE_START_TX, NULL } +}; + + + +int xran_register_ethertype_handler(uint16_t ethertype, ethertype_handler callback) +{ + int i; + + for (i = 0; i < RTE_DIM(xran_ethertype_handlers); ++i) + if (xran_ethertype_handlers[i].ethertype == ethertype) { + xran_ethertype_handlers[i].fn = callback; + + return 1; + } + + elog("support for ethertype %u not found", ethertype); + + return 0; +} + +int xran_handle_ether(uint16_t ethertype, struct rte_mbuf *pkt, uint64_t rx_time) +{ + int i; + + for (i = 0; i < RTE_DIM(xran_ethertype_handlers); ++i) + if (xran_ethertype_handlers[i].ethertype == ethertype) + if (xran_ethertype_handlers[i].fn) + return xran_ethertype_handlers[i].fn(pkt, rx_time); + + wlog("Packet with unrecognized ethertype '%.4X' dropped", ethertype); + + return 0; +}; + + +/* Process vlan tag. Cut the ethernet header. Call the etherype handlers. */ +int xran_ethdi_filter_packet(struct rte_mbuf *pkt, uint64_t rx_time) +{ + struct xran_ethdi_ctx *ctx = xran_ethdi_get_ctx(); + +#ifdef VLAN_SUPPORT + if (rte_vlan_strip(pkt) == 0) { + if (pkt->vlan_tci == ctx->cp_vtag) { + dlog("VLAN tci matches %d", pkt->vlan_tci); + } else { + wlog("packet with wrong VLAN tag %d, dropping", + pkt->vlan_tci); + return 0; + } + } else + dlog("Packet not vlan tagged"); +#endif + + const struct ether_hdr *eth_hdr = rte_pktmbuf_mtod(pkt, void *); + +#if defined(DPDKIO_DEBUG) && DPDKIO_DEBUG > 1 + nlog("*** processing RX'ed packet of size %d ***", + rte_pktmbuf_data_len(pkt)); + /* TODO: just dump ethernet header in readable format? */ +#endif + +#if defined(DPDKIO_DEBUG) && DPDKIO_DEBUG > 1 + { + char dst[ETHER_ADDR_FMT_SIZE] = "(empty)"; + char src[ETHER_ADDR_FMT_SIZE] = "(empty)"; + + ether_format_addr(dst, sizeof(dst), ð_hdr->d_addr); + ether_format_addr(src, sizeof(src), ð_hdr->s_addr); + nlog("src: %s dst: %s ethertype: %.4X", dst, src, + rte_be_to_cpu_16(eth_hdr->ether_type)); + } +#endif + + /* Cut out the ethernet header. It's not needed anymore. */ + if (rte_pktmbuf_adj(pkt, sizeof(*eth_hdr)) == NULL) { + wlog("Packet too short, dropping"); + return 0; + } + + + return xran_handle_ether(rte_be_to_cpu_16(eth_hdr->ether_type), pkt, rx_time); +} + + + + +int xran_ethdi_init_dpdk_io(char *name, const struct xran_io_loop_cfg *io_cfg, + int *lcore_id, struct ether_addr *p_lls_cu_addr, struct ether_addr *p_ru_addr, + uint16_t cp_vlan, uint16_t up_vlan) +{ + uint16_t port[2] = {0, 0}; + struct xran_ethdi_ctx *ctx = xran_ethdi_get_ctx(); + int i; + char core_mask[20]; + char *argv[] = { name, core_mask, "-m3072", "--proc-type=auto", + "--file-prefix", name, "-w", "0000:00:00.0" }; + + if (io_cfg == NULL) + return 0; + + snprintf(core_mask, sizeof(core_mask), "-c%x", + (1 << io_cfg->core) | + (1 << io_cfg->system_core) | + (1 << io_cfg->pkt_proc_core) | + (1 << io_cfg->pkt_aux_core) | + (1 << io_cfg->timing_core)); + + ctx->io_cfg = *io_cfg; + ctx->ping_state = PING_IDLE; + ctx->known_peers = 1; + ctx->busy_poll_till = rte_rdtsc(); + ctx->cp_vtag = cp_vlan; + ctx->up_vtag = up_vlan; + + for (i = 0; i <= ID_BROADCAST; i++) /* Initialize all as broadcast */ + memset(&ctx->entities[i], 0xFF, sizeof(ctx->entities[0])); + + /* This will return on system_core, which is not necessarily the + * one we're on right now. */ + if (rte_eal_init(RTE_DIM(argv), argv) < 0) + rte_panic("Cannot init EAL: %s\n", rte_strerror(rte_errno)); + + xran_init_mbuf_pool(); + + /* Timers. */ + rte_timer_subsystem_init(); + rte_timer_init(&ctx->timer_ping); + rte_timer_init(&ctx->timer_sync); + rte_timer_init(&ctx->timer_tx); + + *lcore_id = rte_get_next_lcore(rte_lcore_id(), 0, 0); + + PANIC_ON(*lcore_id == RTE_MAX_LCORE, "out of lcores for io_loop()"); + + if (rte_eal_process_type() == RTE_PROC_PRIMARY) { + for (i = 0; i < ETHDI_VF_MAX; i ++){ + if (rte_eth_dev_attach(io_cfg->dpdk_dev[i], &port[i]) != 0 || + rte_eth_dev_count_avail() == 0) + errx(1, "Network port doesn't exist."); + xran_init_port(port[i], p_lls_cu_addr); /* we only have 1 port at this stage */ + if(i==0){ + ctx->tx_ring[i] = rte_ring_create("tx_ring_up", NUM_MBUFS, + rte_lcore_to_socket_id(*lcore_id), RING_F_SC_DEQ); + ctx->rx_ring[i] = rte_ring_create("rx_ring_up", NUM_MBUFS, + rte_lcore_to_socket_id(*lcore_id), RING_F_SC_DEQ); + ctx->pkt_dump_ring[i] = rte_ring_create("pkt_dump_ring_up", NUM_MBUFS, + rte_lcore_to_socket_id(*lcore_id), RING_F_SC_DEQ); + }else { + ctx->tx_ring[i] = rte_ring_create("tx_ring_cp", NUM_MBUFS, + rte_lcore_to_socket_id(*lcore_id), RING_F_SC_DEQ); + ctx->rx_ring[i] = rte_ring_create("rx_ring_cp", NUM_MBUFS, + rte_lcore_to_socket_id(*lcore_id), RING_F_SC_DEQ); + ctx->pkt_dump_ring[i] = rte_ring_create("pkt_dump_ring_cp", NUM_MBUFS, + rte_lcore_to_socket_id(*lcore_id), RING_F_SC_DEQ); + } + } + } else { + rte_panic("ethdi_dpdk_io_loop() failed to start with RTE_PROC_SECONDARY\n"); + } + PANIC_ON(ctx->tx_ring == NULL, "failed to allocate tx ring"); + PANIC_ON(ctx->rx_ring == NULL, "failed to allocate rx ring"); + PANIC_ON(ctx->pkt_dump_ring == NULL, "failed to allocate pkt dumping ring"); + for (i = 0; i < ETHDI_VF_MAX; i++) + ctx->io_cfg.port[i] = port[i]; + + rte_eth_macaddr_get(port[ETHDI_UP_VF], &ctx->entities[io_cfg->id]); + ether_addr_copy(p_ru_addr, &ctx->entities[ID_RU]); + + /* Start the actual IO thread */ + if (rte_eal_remote_launch(xran_ethdi_dpdk_io_loop, &ctx->io_cfg, *lcore_id)) + rte_panic("ethdi_dpdk_io_loop() failed to start\n"); + + return 1; +} + +static inline uint16_t xran_tx_from_ring(int port, struct rte_ring *r) +{ + struct rte_mbuf *mbufs[BURST_SIZE]; + uint16_t dequeued, sent = 0; + uint32_t remaining; + int i; + long t1 = MLogTick(); + + dequeued = rte_ring_dequeue_burst(r, (void **)mbufs, BURST_SIZE, + &remaining); + if (!dequeued) + return 0; /* Nothing to send. */ + + while (1) { /* When tx queue is full it is trying again till succeed */ + t1 = MLogTick(); + sent += rte_eth_tx_burst(port, 0, &mbufs[sent], dequeued - sent); + MLogTask(PID_RADIO_ETH_TX_BURST, t1, MLogTick()); + + if (sent == dequeued) + return remaining; + } +} + + + +/* + * This is the main DPDK-IO loop. + * This will sleep if there's no packets incoming and there's + * no work enqueued, sleep lenth is defined in IDLE_SLEEP_MICROSECS + */ +int xran_ethdi_dpdk_io_loop(void *io_loop_cfg) +{ + struct xran_ethdi_ctx *ctx = xran_ethdi_get_ctx(); + const struct xran_io_loop_cfg *const cfg = io_loop_cfg; + const int port[ETHDI_VF_MAX] = {cfg->port[ETHDI_UP_VF], cfg->port[ETHDI_CP_VF]}; + int port_id = 0; + struct sched_param sched_param; + int res = 0; + + printf("%s [PORT: %d %d] [CPU %2d] [PID: %6d]\n", __FUNCTION__, port[ETHDI_UP_VF], port[ETHDI_CP_VF] , rte_lcore_id(), getpid()); + + printf("%s [CPU %2d] [PID: %6d]\n", __FUNCTION__, rte_lcore_id(), getpid()); + sched_param.sched_priority = XRAN_THREAD_DEFAULT_PRIO; + if ((res = pthread_setschedparam(pthread_self(), SCHED_FIFO, &sched_param))) + { + printf("priority is not changed: coreId = %d, result1 = %d\n",rte_lcore_id(), res); + } + + for (;;) { + for (port_id = 0; port_id < ETHDI_VF_MAX; port_id++){ + struct rte_mbuf *mbufs[BURST_SIZE]; + /* RX */ + const uint16_t rxed = rte_eth_rx_burst(port[port_id], 0, mbufs, BURST_SIZE); + if (rxed != 0){ + long t1 = MLogTick(); + rte_ring_enqueue_burst(ctx->rx_ring[port_id], (void*)mbufs, rxed, NULL); + MLogTask(PID_RADIO_RX_VALIDATE, t1, MLogTick()); + } + + /* TX */ + const uint16_t sent = xran_tx_from_ring(port[port_id], ctx->tx_ring[port_id]); + if (rxed | sent) + continue; /* more packets might be waiting in queues */ + + rte_pause(); /* short pause, optimize memory access */ + if (XRAN_STOPPED == xran_if_current_state) + break; + } + + if (XRAN_STOPPED == xran_if_current_state) + break; + } + + fflush(stderr); + fflush(stdout); + puts("IO loop finished"); + + //for (port_id = 0; port_id < ETHDI_VF_MAX; port_id++) + // xran_ethdi_port_stats(port[port_id]); + + return 0; +} diff --git a/fhi_lib/lib/ethernet/ethdi.h b/fhi_lib/lib/ethernet/ethdi.h new file mode 100644 index 0000000..3b00e15 --- /dev/null +++ b/fhi_lib/lib/ethernet/ethdi.h @@ -0,0 +1,169 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file has all definitions for the Ethernet Data Interface Layer + * @file ethdi.h + * @ingroup group_lte_source_auxlib + * @author Intel Corporation + **/ + + +#ifndef _ETHDI_H_ +#define _ETHDI_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include + +#include "ethernet.h" + +#define XRAN_THREAD_DEFAULT_PRIO (98) + +/* How often to ping? */ +#define PING_INTERVAL 300 /* (us) */ +#define PING_BUSY_POLL 50 /* (us) how long to actively wait for response */ + +/* If we're not receiving packets for more then this threshold... */ +//#define SLEEP_THRESHOLD (rte_get_tsc_hz() / 30) /* = 33.3(3)ms */ +/* we go to sleep for this long (usleep). Undef SLEEP_TRESHOLD to disable. */ +#define SLEEP_TIME 200 /* (us) */ +#define BCAST {0xff, 0xff, 0xff, 0xff, 0xff, 0xff} + +#define TX_TIMER_INTERVAL ((rte_get_timer_hz() / 1000000000L)*interval_us*1000) /* nanosec */ +#define TX_RX_LOOP_TIME rte_get_timer_hz() / 1 + +extern enum xran_if_state xran_if_current_state; + +enum xran_if_state +{ + XRAN_RUNNING, + XRAN_STOPPED +}; + +enum xran_ping_states +{ + PING_IDLE, + PING_NEEDED, + AWAITING_PONG +}; + +enum xran_ethdi_vf_ports +{ + ETHDI_UP_VF = 0, + ETHDI_CP_VF, + ETHDI_VF_MAX +}; + +struct xran_io_loop_cfg +{ + uint8_t id; + char *dpdk_dev[ETHDI_VF_MAX]; + int core; + int system_core; /* Needed as DPDK will change your starting core. */ + int pkt_proc_core; /* Needed for packet processing thread. */ + int pkt_aux_core; /* Needed for packet dumping for debug purposes. */ + int timing_core; /* Needed for getting precise time */ + int port[ETHDI_VF_MAX]; /* This is auto-detected, no need to set. */ +}; + +/* CAUTION: Keep in sync with the string table below. */ +enum xran_entities_id +{ + ID_LLS_CU, + ID_RU, + ID_BROADCAST, + ID_MAX +}; + +static char *const entity_names[] = { + "xRAN lls-CU sim app", + "xRAN RU sim app", +}; + +typedef int (*PROCESS_CB)(void * arg); + +struct xran_ethdi_ctx +{ + struct xran_io_loop_cfg io_cfg; + struct ether_addr entities[ID_BROADCAST + 1]; + uint8_t ping_state; + int ping_times; + int known_peers; + + struct rte_ring *tx_ring[ETHDI_VF_MAX]; + struct rte_ring *rx_ring[ETHDI_VF_MAX]; + struct rte_ring *pkt_dump_ring[ETHDI_VF_MAX]; + struct rte_timer timer_autodetect; + struct rte_timer timer_ping; + struct rte_timer timer_sync; + struct rte_timer timer_tx; + + uint64_t busy_poll_till; + + unsigned pkt_stats[PKT_LAST + 1]; + + uint16_t cp_vtag; + uint16_t up_vtag; +}; + +enum { + MBUF_KEEP, + MBUF_FREE +}; + +extern uint8_t ping_dst_id; +extern struct ether_addr entities_addrs[]; + +static inline struct xran_ethdi_ctx *xran_ethdi_get_ctx(void) +{ + extern struct xran_ethdi_ctx g_ethdi_ctx; + + return &g_ethdi_ctx; +} +typedef int (*xran_ethdi_handler)(struct rte_mbuf *, int sender, uint64_t rx_time); + +typedef int (*ethertype_handler)(struct rte_mbuf *, uint64_t rx_time); +typedef int (*xran_ethdi_handler)(struct rte_mbuf *, int sender, uint64_t rx_time); +typedef void (xran_ethdi_tx_callback)(struct rte_timer *tim, void *arg); + + +int xran_register_ethertype_handler(uint16_t ethertype, ethertype_handler callback); + + +int xran_ethdi_init_dpdk_io(char *name, const struct xran_io_loop_cfg *io_cfg, + int *lcore_id, struct ether_addr *p_lls_cu_addr, struct ether_addr *p_ru_addr, + uint16_t cp_vlan, uint16_t up_vlan); +int xran_ethdi_dpdk_io_loop(void *); +struct rte_mbuf *xran_ethdi_mbuf_alloc(void); +int xran_ethdi_mbuf_send(struct rte_mbuf *mb, uint16_t ethertype); +int xran_ethdi_mbuf_send_cp(struct rte_mbuf *mb, uint16_t ethertype); +void xran_ethdi_stop_tx(void); +int xran_ethdi_filter_packet(struct rte_mbuf *pkt, uint64_t rx_time); + + +#ifdef __cplusplus +} +#endif + +#endif /* #ifndef _ETHDI_H_ */ diff --git a/fhi_lib/lib/ethernet/ethernet.c b/fhi_lib/lib/ethernet/ethernet.c new file mode 100644 index 0000000..ebf997c --- /dev/null +++ b/fhi_lib/lib/ethernet/ethernet.c @@ -0,0 +1,357 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file has all definitions for the Ethernet Data Interface Layer + * @file ethernet.c + * @ingroup group_lte_source_auxlib + * @author Intel Corporation + **/ + + +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "ethernet.h" +#include "ethdi.h" + +/* Our mbuf pools. */ +struct rte_mempool *_eth_mbuf_pool; +struct rte_mempool *_eth_mbuf_pool_rx; +struct rte_mempool *_eth_mbuf_pool_small; +struct rte_mempool *_eth_mbuf_pool_big; + +/* + * Make sure the ring indexes are big enough to cover buf space x2 + * This ring-buffer maintains the property head - tail <= RINGSIZE. + * head == tail: ring buffer empty + * head - tail == RINGSIZE: ring buffer full + */ +typedef uint16_t ring_idx; +static struct { + ring_idx head; + ring_idx read_head; + ring_idx tail; + char buf[1024]; /* needs power of 2! */ +} io_ring = { {0}, 0, 0}; + +#define RINGSIZE sizeof(io_ring.buf) +#define RINGMASK (RINGSIZE - 1) + + +/* + * Display part of the message stored in the ring buffer. + * Might require multiple calls to print the full message. + * Will return 0 when nothing left to print. + */ +int xran_show_delayed_message(void) +{ + ring_idx tail = io_ring.tail; + ring_idx wlen = io_ring.read_head - tail; /* always within [0, RINGSIZE] */ + + if (wlen <= 0) + return 0; + + tail &= RINGMASK; /* modulo the range down now that we have wlen */ + + /* Make sure we're not going over buffer end. Next call will wrap. */ + if (tail + wlen > RINGSIZE) + wlen = RINGSIZE - tail; + + RTE_ASSERT(tail + wlen <= RINGSIZE); + + /* We use write() here to avoid recaculating string length in fwrite(). */ + const ssize_t written = write(STDOUT_FILENO, io_ring.buf + tail, wlen); + if (written <= 0) + return 0; /* To avoid moving tail the wrong way on error. */ + + /* Move tail up. Only we touch it. And we only print from one core. */ + io_ring.tail += written; + + return written; /* next invocation will print the rest if any */ +} + + +void xran_init_mbuf_pool(void) +{ + /* Init the buffer pool */ + if (rte_eal_process_type() == RTE_PROC_PRIMARY) { + _eth_mbuf_pool = rte_pktmbuf_pool_create("mempool", NUM_MBUFS, + MBUF_CACHE, 0, MBUF_POOL_ELEMENT, rte_socket_id()); + _eth_mbuf_pool_rx = rte_pktmbuf_pool_create("mempool_rx", NUM_MBUFS, + MBUF_CACHE, 0, MBUF_POOL_ELEMENT, rte_socket_id()); + _eth_mbuf_pool_small = rte_pktmbuf_pool_create("mempool_small", + NUM_MBUFS, MBUF_CACHE, 0, MBUF_POOL_ELM_SMALL, rte_socket_id()); + _eth_mbuf_pool_big = rte_pktmbuf_pool_create("mempool_big", + NUM_MBUFS_BIG, 0, 0, MBUF_POOL_ELM_BIG, rte_socket_id()); + } else { + _eth_mbuf_pool = rte_mempool_lookup("mempool"); + _eth_mbuf_pool_rx = rte_mempool_lookup("mempool_rx"); + _eth_mbuf_pool_small = rte_mempool_lookup("mempool_small"); + _eth_mbuf_pool_big = rte_mempool_lookup("mempool_big"); + } + if (_eth_mbuf_pool == NULL) + rte_panic("Cannot create mbuf pool: %s\n", rte_strerror(rte_errno)); + if (_eth_mbuf_pool_rx == NULL) + rte_panic("Cannot create mbuf pool: %s\n", rte_strerror(rte_errno)); + if (_eth_mbuf_pool_small == NULL) + rte_panic("Cannot create small mbuf pool: %s\n", rte_strerror(rte_errno)); + if (_eth_mbuf_pool_big == NULL) + rte_panic("Cannot create big mbuf pool: %s\n", rte_strerror(rte_errno)); +} + +/* Init NIC port, then start the port */ +void xran_init_port(int p_id, struct ether_addr *p_lls_cu_addr) +{ + char buf[ETHER_ADDR_FMT_SIZE]; + struct ether_addr eth_addr; + struct rte_eth_rxmode rxmode = + { .split_hdr_size = 0, + .max_rx_pkt_len = MAX_RX_LEN, + .offloads=(DEV_RX_OFFLOAD_JUMBO_FRAME|DEV_RX_OFFLOAD_CRC_STRIP) + }; + struct rte_eth_txmode txmode = { + .mq_mode = ETH_MQ_TX_NONE + }; + struct rte_eth_conf port_conf = { + .rxmode = rxmode, + .txmode = txmode + }; + struct ether_addr pDstEthAddr; + + struct rte_eth_rxconf rxq_conf; + struct rte_eth_txconf txq_conf; + + int ret; + struct rte_eth_dev_info dev_info; + const char *drv_name = ""; + int sock_id = rte_eth_dev_socket_id(p_id); + + // ether_format_addr(buf, sizeof(buf), p_lls_cu_addr); + // printf("port %d set mac address %s\n", p_id, buf); + // rte_eth_dev_default_mac_addr_set(p_id, p_lls_cu_addr); + + rte_eth_dev_info_get(p_id, &dev_info); + if (dev_info.driver_name) + drv_name = dev_info.driver_name; + printf("initializing port %d for TX, drv=%s\n", p_id, drv_name); + + /* In order to receive packets from any server need to add broad case address + * for the port*/ + pDstEthAddr.addr_bytes[0] = 0xFF; + pDstEthAddr.addr_bytes[1] = 0xFF; + pDstEthAddr.addr_bytes[2] = 0xFF; + + pDstEthAddr.addr_bytes[3] = 0xFF; + pDstEthAddr.addr_bytes[4] = 0xFF; + pDstEthAddr.addr_bytes[5] = 0xFF; + + rte_eth_macaddr_get(p_id, ð_addr); + ether_format_addr(buf, sizeof(buf), ð_addr); + printf("port %d mac address %s\n", p_id, buf); + + struct ether_addr addr; + rte_eth_macaddr_get(p_id, &addr); + +// rte_eth_dev_mac_addr_add(p_id, &pDstEthAddr,1); + // rte_eth_dev_mac_addr_add(p_id, &addr, 1); + + printf("Port %u MAC: %02"PRIx8" %02"PRIx8" %02"PRIx8 + " %02"PRIx8" %02"PRIx8" %02"PRIx8"\n", + (unsigned)p_id, + addr.addr_bytes[0], addr.addr_bytes[1], addr.addr_bytes[2], + addr.addr_bytes[3], addr.addr_bytes[4], addr.addr_bytes[5]); + + /* Init port */ + ret = rte_eth_dev_configure(p_id, 1, 1, &port_conf); + if (ret < 0) + rte_panic("Cannot configure port %u (%d)\n", p_id, ret); + + /* Init RX queues */ + rxq_conf = dev_info.default_rxconf; + ret = rte_eth_rx_queue_setup(p_id, 0, BURST_SIZE, + sock_id, &rxq_conf, _eth_mbuf_pool_rx); + if (ret < 0) + rte_panic("Cannot init RX for port %u (%d)\n", + p_id, ret); + + /* Init TX queues */ + txq_conf = dev_info.default_txconf; + ret = rte_eth_tx_queue_setup(p_id, 0, BURST_SIZE, sock_id, &txq_conf); + if (ret < 0) + rte_panic("Cannot init TX for port %u (%d)\n", + p_id, ret); + + /* Start port */ + ret = rte_eth_dev_start(p_id); + if (ret < 0) + rte_panic("Cannot start port %u (%d)\n", p_id, ret); + + rte_eth_promiscuous_enable(p_id); +} + +void xran_memdump(void *addr, int len) +{ + int i; + char tmp_buf[len * 2 + len / 16 + 1]; + char *p = tmp_buf; + + return; +#if 0 + for (i = 0; i < len; ++i) { + sprintf(p, "%.2X ", ((uint8_t *)addr)[i]); + if (i % 16 == 15) + *p++ = '\n'; + } + *p = 0; + nlog("%s", tmp_buf); +#endif +} + + +/* Prepend ethernet header, possibly vlan tag. */ +void xran_add_eth_hdr_vlan(struct ether_addr *dst, uint16_t ethertype, struct rte_mbuf *mb, uint16_t vlan_tci) +{ + /* add in the ethernet header */ + struct ether_hdr *const h = (void *)rte_pktmbuf_prepend(mb, sizeof(*h)); + + PANIC_ON(h == NULL, "mbuf prepend of ether_hdr failed"); + + /* Fill in the ethernet header. */ + rte_eth_macaddr_get(mb->port, &h->s_addr); /* set source addr */ + h->d_addr = *dst; /* set dst addr */ + h->ether_type = rte_cpu_to_be_16(ethertype); /* ethertype too */ + +#if defined(DPDKIO_DEBUG) && DPDKIO_DEBUG > 1 + { + char dst[ETHER_ADDR_FMT_SIZE] = "(empty)"; + char src[ETHER_ADDR_FMT_SIZE] = "(empty)"; + + nlog("*** packet for TX below (len %d) ***", rte_pktmbuf_pkt_len(mb)); + ether_format_addr(src, sizeof(src), &h->s_addr); + ether_format_addr(dst, sizeof(dst), &h->d_addr); + nlog("src: %s dst: %s ethertype: %.4X", src, dst, ethertype); + } +#endif +#ifdef VLAN_SUPPORT + mb->vlan_tci = vlan_tci; + dlog("Inserting vlan tag of %d", vlan_tci); + rte_vlan_insert(&mb); +#endif +} + +int xran_send_message_burst(int dst_id, int pkt_type, void *body, int len) +{ + struct rte_mbuf *mbufs[BURST_SIZE]; + int i; + uint8_t *src = body; + const struct xran_ethdi_ctx *const ctx = xran_ethdi_get_ctx(); + + /* We're limited by maximum mbuf size on the receive size. + * We can change this but this would be a bigger rework. */ + RTE_ASSERT(len < MBUF_POOL_ELM_BIG); + + /* Allocate the required number of mbufs. */ + const uint8_t count = ceilf((float)len / MAX_DATA_SIZE); + if (rte_pktmbuf_alloc_bulk(_eth_mbuf_pool, mbufs, count) != 0) + rte_panic("Failed to allocate %d mbufs\n", count); + + nlog("burst transfer with data size %lu", MAX_DATA_SIZE); + for (i = 0; len > 0; ++i) { + char *p; + struct burst_hdr *bhdr; + struct ethdi_hdr *edi_hdr; + + /* Setup the ethdi_hdr. */ + edi_hdr = (void *)rte_pktmbuf_append(mbufs[i], sizeof(*edi_hdr)); + if (edi_hdr == NULL) + rte_panic("append of ethdi_hdr failed\n"); + edi_hdr->pkt_type = PKT_BURST; + /* edi_hdr->source_id setup in tx_from_ring */ + edi_hdr->dest_id = dst_id; + + /* Setup the burst header */ + bhdr = (void *)rte_pktmbuf_append(mbufs[i], sizeof(*bhdr)); + if (bhdr == NULL) /* append failed. */ + rte_panic("mbuf prepend of burst_hdr failed\n"); + bhdr->original_type = pkt_type; + bhdr->pkt_idx = i; /* save the index of the burst chunk. */ + bhdr->total_pkts = count; + + /* now copy in the actual data */ + const int curr_data_len = RTE_MIN(len, MAX_TX_LEN - + rte_pktmbuf_pkt_len(mbufs[i]) - sizeof(struct ether_hdr)); + p = (void *)rte_pktmbuf_append(mbufs[i], curr_data_len); + if (p == NULL) + rte_panic("mbuf append of %d data bytes failed\n", curr_data_len); + /* This copy is unavoidable, as we're splitting one big buffer + * into multiple mbufs. */ + rte_memcpy(p, src, curr_data_len); + + dlog("curr_data_len[%d] = %d", i, curr_data_len); + dlog("packet %d size %d", i, rte_pktmbuf_pkt_len(mbufs[i])); + + /* Update our source data pointer and remaining length. */ + len -= curr_data_len; + src += curr_data_len; + } + + /* Now enqueue the full prepared burst. */ + i = rte_ring_enqueue_bulk(ctx->tx_ring[0], (void **)mbufs, count, NULL); + PANIC_ON(i != count, "failed to enqueue all mbufs: %d/%d", i, count); + dlog("%d packets enqueued on port %d.", count, ctx->io_cfg.port); + + return 1; +} diff --git a/fhi_lib/lib/ethernet/ethernet.h b/fhi_lib/lib/ethernet/ethernet.h new file mode 100644 index 0000000..b22aed8 --- /dev/null +++ b/fhi_lib/lib/ethernet/ethernet.h @@ -0,0 +1,165 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file has all definitions for the Ethernet Data Interface Layer + * @file ethernet.h + * @ingroup group_lte_source_auxlib + * @author Intel Corporation + **/ + +#ifndef AUXLIB_ETHERNET_H +#define AUXLIB_ETHERNET_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include + +#define BURST_SIZE 64 + +//#define VLAN_SUPPORT +#define FLEXRAN_UP_VLAN_TAG 2 +#define ETHER_TYPE_ETHDI ETHER_TYPE_IPv4 /* hack needed for jumbo frames */ +#define ETHER_TYPE_ECPRI 0xAEFE +#define ETHER_TYPE_SYNC 0xBEFE +#define ETHER_TYPE_START_TX 0xCEFE + +#define NUM_MBUFS 262144 +#define MBUF_CACHE 256 + +#define MBUF_POOL_ELM_SMALL 1500 /* regular ethernet MTU, most compatible */ +#define MBUF_POOL_ELEMENT MAX_RX_LEN + +#define MAX_RX_LEN 9600 +#define MAX_TX_LEN (MAX_RX_LEN - 14) /* headroom for rx driver */ +#define MAX_DATA_SIZE (MAX_TX_LEN - sizeof(struct ether_hdr) - \ + sizeof(struct ethdi_hdr) - sizeof(struct burst_hdr)) + +/* Looks like mbuf size is limited to 16 bits - see the buf_len field. */ +#define MBUF_POOL_ELM_BIG USHRT_MAX +#define NUM_MBUFS_BIG 64 + +#define DEFAULT_DUMP_LENGTH 96 + +extern struct rte_mempool *_eth_mbuf_pool; +extern struct rte_mempool *_eth_mbuf_pool_small; +extern struct rte_mempool *_eth_mbuf_pool_big; + +/* Do NOT change the order of this enum and below + * - need to be in sync with the table of handlers in testue.c */ +enum pkt_type +{ + PKT_ZERO, + PKT_EMPTY, + PKT_DISCOVER_REQUEST, + PKT_PING, + PKT_PONG, + PKT_DISCOVER_REPLY, + PKT_LTE_DATA, + PKT_LTE_CONTROL, + PKT_BURST, + PKT_DATATEST, + PKT_ADD_ETHDEV, + PKT_SYNC_START, + PKT_LAST, +}; + +/* Do NOT change the order. */ +static char * const xran_pkt_descriptions[PKT_LAST + 1] = { + "ZERO", + "empty packet", + "discovery request packet", + "ping packet", + "pong packet", + "discovery reply packet", + "LTE data packet", + "LTE control packet", + "BURST packet", + "DATATEST packet", + "Add ethernet port command packet", + "SYNC-START packet", + "LAST packet", +}; + +struct burst_hdr { + int8_t pkt_idx; + int8_t total_pkts; + int8_t original_type; + int8_t data[]; +}; + +struct ethdi_hdr { + uint8_t pkt_type; + uint8_t source_id; + uint8_t dest_id; + int8_t data[]; /* original raw data starts here! */ +}; + + +void xran_init_mbuf_pool(void); + +void xran_init_port(int port, struct ether_addr *p_lls_cu_addr); + +void xran_add_eth_hdr_vlan(struct ether_addr *dst, uint16_t ethertype, struct rte_mbuf *mb, uint16_t vlan_tci); +int xran_send_mbuf(struct ether_addr *dst, struct rte_mbuf *mb); + +int xran_send_message_burst(int dst_id, int pkt_type, void *body, int len); + +void xran_memdump(void *addr, int len); + +/* + * Print a message after all critical processing done. + * Mt-safe. 4 variants - normal, warning, error and debug log. + */ + +#define nlog(m, ...) +#define delayed_message /* this is the old alias for this function */ +#define wlog(m, ...) +#define elog(m, ...) +#ifdef DEBUG +# define dlog(m, ...) +#else +# define dlog(m, ...) +#endif + +#define PANIC_ON(x, m, ...) do { if (unlikely(x)) \ + rte_panic("%s: " m "\n", #x, ##__VA_ARGS__); } while (0) + +/* Add mbuf to the TX ring. */ +static inline int xran_enqueue_mbuf(struct rte_mbuf *mb, struct rte_ring *r) +{ + if (rte_ring_enqueue(r, mb) == 0) { + return 1; /* success */ + } + + rte_pktmbuf_free(mb); + wlog("failed to enqueue packet on port %d (ring full)", mb->port); + + return 0; /* fail */ +} + +#ifdef __cplusplus +} +#endif + +#endif /* AUXLIB_ETHERNET_H */ diff --git a/fhi_lib/lib/src/mlog_lnx_xRAN.h b/fhi_lib/lib/src/mlog_lnx_xRAN.h new file mode 100644 index 0000000..5494045 --- /dev/null +++ b/fhi_lib/lib/src/mlog_lnx_xRAN.h @@ -0,0 +1,55 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + +#ifndef _MLOG_LNX_XRAN_H_ +#define _MLOG_LNX_XRAN_H_ + +#ifdef __cplusplus +extern "C" +{ +#endif + +#define MLOG_FALSE ( 0 ) + +#define MLogOpen(a, b, c, d, e) MLOG_FALSE +#define MLogRestart(a) MLOG_FALSE +#define MLogPrint(a) MLOG_FALSE +#define MLogGetFileLocation() NULL +#define MLogGetFileSize() 0 +#define MLogSetMask(a) MLOG_FALSE +#define MLogGetMask() +#define MLogRegisterTick() +#define MLogTick() 0 +#define MLogIncrementCounter() 0 +#define MLogTask(w,x,y) 0 +#define MLogTaskCore(w,x,y,z) 0 +#define MLogMark(x,y) +#define MLogDevInfo(x) +#define MLogRegisterFrameSubframe(x,y) +#define MLogAddVariables(x,y,z) +#define MLogGetStats(a, b, c, d, e) MLOG_FALSE +#define MLogGetAvgStats(a, b, c, d) MLOG_FALSE +#define MLogAddTestCase(a, b) MLOG_FALSE +#define MLogAddPowerStats(a, b, c, d, e) MLOG_FALSE + +#ifdef __cplusplus +} +#endif /* #ifdef __cplusplus */ + +#endif /* #ifndef _MLOG_LNX_H_ */ + diff --git a/fhi_lib/lib/src/xran_common.c b/fhi_lib/lib/src/xran_common.c new file mode 100644 index 0000000..67079e2 --- /dev/null +++ b/fhi_lib/lib/src/xran_common.c @@ -0,0 +1,397 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + +#ifndef _XRAN_COMMON_ +#define _XRAN_COMMON_ + +/** + * @brief XRAN layer common functionality for both lls-CU and RU as well as C-plane and + * U-plane + * @file xran_common.c + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +#include +#include +#include +#include +#include + +#include "xran_common.h" +#include "ethdi.h" +#include "xran_pkt.h" +#include "xran_pkt_up.h" +#include "xran_cp_api.h" +#include "xran_up_api.h" +#include "../src/xran_printf.h" + +#ifndef MLOG_ENABLED +#include "mlog_lnx_xRAN.h" +#else +#include "mlog_lnx.h" +#endif + +#define MBUFS_CNT 256 + +extern int xran_process_rx_sym(void *arg, + void *iq_data_start, + uint16_t size, + uint8_t CC_ID, + uint8_t Ant_ID, + uint8_t frame_id, + uint8_t subframe_id, + uint8_t slot_id, + uint8_t symb_id); + + +int process_mbuf(struct rte_mbuf *pkt) +{ + void *iq_samp_buf; + struct ecpri_seq_id seq; + static int symbol_total_bytes = 0; + int num_bytes = 0; + struct xran_ethdi_ctx *const ctx = xran_ethdi_get_ctx(); + uint8_t CC_ID = 0; + uint8_t Ant_ID = 0; + uint8_t frame_id = 0; + uint8_t subframe_id = 0; + uint8_t slot_id = 0; + uint8_t symb_id = 0; + + num_bytes = xran_extract_iq_samples(pkt, + &iq_samp_buf, + &CC_ID, + &Ant_ID, + &frame_id, + &subframe_id, + &slot_id, + &symb_id, + &seq); + if (num_bytes <= 0) + return -1; + + symbol_total_bytes += num_bytes; + + if (seq.e_bit == 1) { + print_dbg("Completed receiving symbol %d, size=%d bytes\n", + symb_id, symbol_total_bytes); + + if (symbol_total_bytes) + xran_process_rx_sym(NULL, + iq_samp_buf, + symbol_total_bytes, + CC_ID, + Ant_ID, + frame_id, + subframe_id, + slot_id, + symb_id); + symbol_total_bytes = 0; + } + + return 0; +} + +static int set_iq_bit_width(uint8_t iq_bit_width, struct data_section_compression_hdr *compr_hdr) +{ + if (iq_bit_width == MAX_IQ_BIT_WIDTH) + compr_hdr->ud_comp_hdr.ud_iq_width = (uint8_t) 0; + else + compr_hdr->ud_comp_hdr.ud_iq_width = iq_bit_width; + + return 0; + +} + +/* Send a single 5G symbol over multiple packets */ +int send_symbol_ex(enum xran_pkt_dir direction, + uint16_t section_id, + struct rb_map *data, + uint8_t frame_id, + uint8_t subframe_id, + uint8_t slot_id, + uint8_t symbol_no, + int prb_start, + int prb_num, + uint8_t CC_ID, + uint8_t RU_Port_ID, + uint8_t seq_id) +{ + const int n_bytes = prb_num * N_SC_PER_PRB * sizeof(struct rb_map); + int sent; + uint32_t off; + struct xran_up_pkt_gen_no_compression_params xp = { 0 }; + + /* radio app header */ + xp.app_params.data_direction = direction; + xp.app_params.payl_ver = 1; + xp.app_params.filter_id = 0; + xp.app_params.frame_id = frame_id; + xp.app_params.sf_slot_sym.subframe_id = subframe_id; + xp.app_params.sf_slot_sym.slot_id = slot_id; + xp.app_params.sf_slot_sym.symb_id = symbol_no; + + /* convert to network byte order */ + xp.app_params.sf_slot_sym.value = rte_cpu_to_be_16(xp.app_params.sf_slot_sym.value); + + xp.sec_hdr.fields.sect_id = section_id; + xp.sec_hdr.fields.num_prbu = (uint8_t)prb_num; + xp.sec_hdr.fields.start_prbu = (uint8_t)prb_start; + xp.sec_hdr.fields.sym_inc = 0; + xp.sec_hdr.fields.rb = 0; + + /* network byte order */ + xp.sec_hdr.fields.all_bits = rte_cpu_to_be_32(xp.sec_hdr.fields.all_bits); + + struct rte_mbuf *mb = xran_ethdi_mbuf_alloc(); + + if (mb == NULL){ + MLogPrint(NULL); + errx(1, "out of mbufs after %d packets", 1); + } + + sent = xran_prepare_iq_symbol_portion_no_comp(mb, + data, + n_bytes, + &xp, + CC_ID, + RU_Port_ID, + seq_id); + if (sent <= 0) + errx(1, "failed preparing symbol"); + + xran_ethdi_mbuf_send(mb, ETHER_TYPE_ECPRI); + +#ifdef DEBUG + printf("Symbol %2d sent (%d packets, %d bytes)\n", symbol_no, i, n_bytes); +#endif + + return sent; +} + +int send_cpmsg_dlul(void *pHandle, enum xran_pkt_dir dir, + uint8_t frame_id, uint8_t subframe_id, uint8_t slot_id, + uint8_t startsym, uint8_t numsym, int prb_num, + uint16_t beam_id, + uint8_t cc_id, uint8_t ru_port_id, + uint8_t seq_id) +{ + struct xran_cp_gen_params params; + struct xran_section_gen_info sect_geninfo[XRAN_MAX_NUM_SECTIONS]; + struct rte_mbuf *mbuf; + int ret, nsection, i; + + + params.dir = dir; + params.sectionType = XRAN_CP_SECTIONTYPE_1; // Most DL/UL Radio Channels + params.hdr.filterIdx = XRAN_FILTERINDEX_STANDARD; + params.hdr.frameId = frame_id; + params.hdr.subframeId = subframe_id; + params.hdr.slotId = slot_id; + params.hdr.startSymId = startsym; // start Symbol ID + params.hdr.iqWidth = xran_get_conf_iqwidth(pHandle); + params.hdr.compMeth = xran_get_conf_compmethod(pHandle); + + nsection = 0; + sect_geninfo[nsection].info.type = params.sectionType; + sect_geninfo[nsection].info.id = xran_alloc_sectionid(pHandle, dir, cc_id, ru_port_id, slot_id); + sect_geninfo[nsection].info.rb = XRAN_RBIND_EVERY; + sect_geninfo[nsection].info.symInc = XRAN_SYMBOLNUMBER_NOTINC; + sect_geninfo[nsection].info.startPrbc = 0; + sect_geninfo[nsection].info.numPrbc = NUM_OF_PRB_IN_FULL_BAND, + sect_geninfo[nsection].info.numSymbol = numsym; + sect_geninfo[nsection].info.reMask = 0xfff; + sect_geninfo[nsection].info.beamId = beam_id; + + sect_geninfo[nsection].info.ef = 0; // no extension + sect_geninfo[nsection].exDataSize = 0; + sect_geninfo[nsection].exData = NULL; + nsection++; + + params.numSections = nsection; + params.sections = sect_geninfo; + + mbuf = xran_ethdi_mbuf_alloc(); + if(unlikely(mbuf == NULL)) { + print_err("Alloc fail!\n"); + return (-1); + } + + ret = xran_prepare_ctrl_pkt(mbuf, ¶ms, cc_id, ru_port_id, seq_id); + if(ret < 0) { + print_err("Fail to build control plane packet - [%d:%d:%d] dir=%d\n", + frame_id, subframe_id, slot_id, dir); + } + else { + xran_ethdi_mbuf_send_cp(mbuf, ETHER_TYPE_ECPRI); + for(i=0; iPrachCPConfig); + +#if 0 + printf("%d:%d:%d:%d - filter=%d, startSym=%d[%d:%d], numSym=%d, occasions=%d, freqOff=%d\n", + frame_id, subframe_id, slot_id, prach_port_id, + pPrachCPConfig->filterIdx, + pPrachCPConfig->startSymId, + pPrachCPConfig->startPrbc, + pPrachCPConfig->numPrbc, + pPrachCPConfig->numSymbol, + pPrachCPConfig->occassionsInPrachSlot, + pPrachCPConfig->freqOffset); +#endif + + params.dir = XRAN_DIR_UL; + params.sectionType = XRAN_CP_SECTIONTYPE_3; + params.hdr.filterIdx = pPrachCPConfig->filterIdx; + params.hdr.frameId = frame_id; + params.hdr.subframeId = subframe_id; + params.hdr.slotId = slot_id; + params.hdr.startSymId = pPrachCPConfig->startSymId; + params.hdr.iqWidth = xran_get_conf_iqwidth(pHandle); + params.hdr.compMeth = xran_get_conf_compmethod(pHandle); + /* use timeOffset field for the CP length value for prach sequence */ + params.hdr.timeOffset = pPrachCPConfig->timeOffset; + params.hdr.fftSize = xran_get_conf_fftsize(pHandle); + params.hdr.scs = xran_get_conf_prach_scs(pHandle); + params.hdr.cpLength = 0; + + nsection = 0; + sect_geninfo[nsection].info.type = params.sectionType; + sect_geninfo[nsection].info.id = xran_alloc_sectionid(pHandle, XRAN_DIR_UL, cc_id, prach_port_id, slot_id); + sect_geninfo[nsection].info.rb = XRAN_RBIND_EVERY; + sect_geninfo[nsection].info.symInc = XRAN_SYMBOLNUMBER_NOTINC; + sect_geninfo[nsection].info.startPrbc = pPrachCPConfig->startPrbc; + sect_geninfo[nsection].info.numPrbc = pPrachCPConfig->numPrbc, + sect_geninfo[nsection].info.numSymbol = pPrachCPConfig->numSymbol*pPrachCPConfig->occassionsInPrachSlot; + sect_geninfo[nsection].info.reMask = 0xfff; + sect_geninfo[nsection].info.beamId = beam_id; + sect_geninfo[nsection].info.freqOffset= pPrachCPConfig->freqOffset; + + sect_geninfo[nsection].info.ef = 0; // no extension + sect_geninfo[nsection].exDataSize = 0; + sect_geninfo[nsection].exData = NULL; + nsection++; + + params.numSections = nsection; + params.sections = sect_geninfo; + + mbuf = xran_ethdi_mbuf_alloc(); + if(unlikely(mbuf == NULL)) { + print_err("Alloc fail!\n"); + return (-1); + } + + ret = xran_prepare_ctrl_pkt(mbuf, ¶ms, cc_id, prach_port_id, seq_id); + if(ret < 0) { + print_err("Fail to build prach control packet - [%d:%d:%d]\n", frame_id, subframe_id, slot_id); + return (ret); + } + else { + xran_ethdi_mbuf_send_cp(mbuf, ETHER_TYPE_ECPRI); + for(i=0; i < nsection; i++) + xran_cp_add_section_info(pHandle, + XRAN_DIR_UL, cc_id, prach_port_id, subframe_id, slot_id, + §_geninfo[i].info); + } + + return (ret); +} + + +int process_ring(struct rte_ring *r) +{ + assert(r); + + struct rte_mbuf *mbufs[MBUFS_CNT]; + int i; + uint32_t remaining; + const uint16_t dequeued = rte_ring_dequeue_burst(r, (void **)mbufs, + RTE_DIM(mbufs), &remaining); + + if (!dequeued) + return 0; + for (i = 0; i < dequeued; ++i) { + if (xran_ethdi_filter_packet(mbufs[i], 0) == MBUF_FREE) + rte_pktmbuf_free(mbufs[i]); + } + + return remaining; +} + +int ring_processing_thread(void *args) +{ + struct timespec tv = {0}; + int64_t prev_nsec = 0; + uint8_t is_timer_set = 0; + struct xran_ethdi_ctx *const ctx = xran_ethdi_get_ctx(); + struct sched_param sched_param; + int res = 0; + + printf("%s [CPU %2d] [PID: %6d]\n", __FUNCTION__, rte_lcore_id(), getpid()); + sched_param.sched_priority = XRAN_THREAD_DEFAULT_PRIO; + if ((res = pthread_setschedparam(pthread_self(), SCHED_FIFO, &sched_param))) + { + printf("priority is not changed: coreId = %d, result1 = %d\n",rte_lcore_id(), res); + } + for (;;) { + if (!is_timer_set) { + if (clock_gettime(CLOCK_REALTIME, &tv) != 0) + err(1, "gettimeofday() failed"); + if (tv.tv_nsec % 125000 < prev_nsec % 125000) { /* crossed an 125ms boundary */ + rte_timer_manage(); /* timers only run on IO core */ + is_timer_set = 1; + } + prev_nsec = tv.tv_nsec; + } else { + rte_timer_manage(); + } + + /* UP first */ + if (process_ring(ctx->rx_ring[ETHDI_UP_VF])) + continue; + /* CP next */ + if (process_ring(ctx->rx_ring[ETHDI_CP_VF])) + continue; + + if (XRAN_STOPPED == xran_if_current_state) + break; + } + + puts("Pkt processing thread finished."); + return 0; +} + +#endif /* _XRAN_COMMON_ */ diff --git a/fhi_lib/lib/src/xran_common.h b/fhi_lib/lib/src/xran_common.h new file mode 100644 index 0000000..ad17c1e --- /dev/null +++ b/fhi_lib/lib/src/xran_common.h @@ -0,0 +1,300 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief XRAN layer common functionality for both lls-CU and RU as well as C-plane and + * U-plane + * @file xran_common.h + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +#ifndef _XRAN_COMMON_H_ +#define _XRAN_COMMON_H_ + +#include +#include + +#include +#include +#include + +#include "xran_fh_lls_cu.h" +#include "xran_pkt_up.h" + +#define APP_LLS_CU 0 +#define APP_RU 1 +#define NUM_OF_PRB_IN_FULL_BAND (66) +#define N_SC_PER_PRB 12 +#define N_SYM_PER_SLOT 14 +#define N_FULLBAND_SC (NUM_OF_PRB_IN_FULL_BAND*N_SC_PER_PRB) +#define MAX_ANT_CARRIER_SUPPORTED 16 +/* 0.125, just for testing */ +#define SLOTNUM_PER_SUBFRAME 8 +#define SUBFRAMES_PER_SYSTEMFRAME 10 +#define SLOTS_PER_SYSTEMFRAME (SLOTNUM_PER_SUBFRAME*SUBFRAMES_PER_SYSTEMFRAME) +#define PDSCH_PAYLOAD_SIZE (N_FULLBAND_SC*4) +#define NUM_OF_SLOT_IN_TDD_LOOP (80) +#define IQ_PLAYBACK_BUFFER_BYTES (NUM_OF_SLOT_IN_TDD_LOOP*N_SYM_PER_SLOT*N_FULLBAND_SC*4L) + +/* PRACH data samples are 32 bits wide, 16bits for I and 16bits for Q. Each packet contains 839 samples. The payload length is 3356 octets.*/ +#define PRACH_PLAYBACK_BUFFER_BYTES (10*839*4L) + +#define XRAN_MAX_NUM_SECTIONS (NUM_OF_PRB_IN_FULL_BAND) // TODO: need to decide proper value + +#define XRAN_MAX_MBUF_LEN 9600 /**< jummbo frame */ +#define NSEC_PER_SEC 1000000000 +#define TIMER_RESOLUTION_CYCLES 1596*1 /* 1us */ +#define XRAN_RING_SIZE 512 /*4*14*8 pow of 2 */ +#define XRAN_NAME_MAX_LEN (64) +#define XRAN_RING_NUM (3) + +#define MAX_NUM_OF_XRAN_CTX (2) +#define XranIncrementCtx(ctx) ((ctx >= (MAX_NUM_OF_XRAN_CTX-1)) ? 0 : (ctx+1)) +#define XranDecrementCtx(ctx) ((ctx == 0) ? (MAX_NUM_OF_XRAN_CTX-1) : (ctx-1)) + +#define XranDiffSymIdx(prevSymIdx, currSymIdx, numTotalSymIdx) ((prevSymIdx > currSymIdx) ? ((currSymIdx + numTotalSymIdx) - prevSymIdx) : (currSymIdx - prevSymIdx)) + +#define XRAN_SYM_JOB_SIZE 512 + +struct send_symbol_cb_args +{ + struct rb_map *samp_buf; + uint8_t *symb_id; +}; + +struct pkt_dump +{ + int num_samp; + int num_bytes; + uint8_t symb; + struct ecpri_seq_id seq; +} __rte_packed; + +/* PRACH configuration table defines */ +#define XRAN_PRACH_CANDIDATE_PREAMBLE (2) +#define XRAN_PRACH_CANDIDATE_Y (2) +#define XRAN_PRACH_CANDIDATE_SLOT (40) +#define XRAN_PRACH_CONFIG_TABLE_SIZE (256) +#define XRAN_PRACH_PREAMBLE_FORMAT_OF_ABC (9) +typedef enum +{ + FORMAT_0 = 0, + FORMAT_1, + FORMAT_2, + FORMAT_3, + FORMAT_A1, + FORMAT_A2, + FORMAT_A3, + FORMAT_B1, + FORMAT_B2, + FORMAT_B3, + FORMAT_B4, + FORMAT_C0, + FORMAT_C2, + FORMAT_LAST +}PreambleFormatEnum; + +/* add PRACH used config table, same structure as used in refPHY */ +typedef struct +{ + uint8_t prachConfigIdx; + uint8_t preambleFmrt[XRAN_PRACH_CANDIDATE_PREAMBLE]; + uint8_t x; + uint8_t y[XRAN_PRACH_CANDIDATE_Y]; + uint8_t slotNr[XRAN_PRACH_CANDIDATE_SLOT]; + uint8_t slotNrNum; + uint8_t startingSym; + uint8_t nrofPrachInSlot; + uint8_t occassionsInPrachSlot; + uint8_t duration; +} xRANPrachConfigTableStruct; + +typedef struct +{ + uint8_t preambleFmrt; + uint16_t lRALen; + uint8_t fRA; + uint32_t nu; + uint16_t nRaCp; +}xRANPrachPreambleLRAStruct; + +typedef struct +{ + uint8_t filterIdx; + uint8_t startSymId; + uint16_t startPrbc; + uint8_t numPrbc; + uint8_t numSymbol; + uint16_t timeOffset; + int32_t freqOffset; + uint8_t occassionsInPrachSlot; + uint8_t x; + uint8_t y[XRAN_PRACH_CANDIDATE_Y]; + uint8_t isPRACHslot[XRAN_PRACH_CANDIDATE_SLOT]; +}xRANPrachCPConfigStruct; + + +typedef struct DeviceHandleInfo +{ + /**< Structure that contains the information to describe the + * instance i.e service type, virtual function, package Id etc..*/ + uint16_t nIndex; + /* Unique ID of an handle shared between phy layer and library */ + /**< number of antennas supported per link*/ + uint32_t nBufferPoolIndex; + /**< Buffer poolIndex*/ + struct rte_mempool * p_bufferPool[XRAN_MAX_SECTOR_NR]; + uint32_t bufferPoolElmSz[XRAN_MAX_SECTOR_NR]; + uint32_t bufferPoolNumElm[XRAN_MAX_SECTOR_NR]; + +}XranLibHandleInfoStruct; + +typedef void (*XranSymCallbackFn)(struct rte_timer *tim, void* arg); + +/* + * manage one cell's all Ethernet frames for one DL or UL LTE subframe + */ +typedef struct { + /* -1-this subframe is not used in current frame format + 0-this subframe can be transmitted, i.e., data is ready + 1-this subframe is waiting transmission, i.e., data is not ready + 10 - DL transmission missing deadline. When FE needs this subframe data but bValid is still 1, + set bValid to 10. + */ + int32_t bValid ; // when UL rx, it is subframe index. + int32_t nSegToBeGen; + int32_t nSegGenerated; // how many date segment are generated by DL LTE processing or received from FE + // -1 means that DL packet to be transmitted is not ready in BS + int32_t nSegTransferred; // number of data segments has been transmitted or received + struct rte_mbuf *pData[XRAN_N_MAX_BUFFER_SEGMENT]; // point to DPDK allocated memory pool + XRANBufferListStruct sBufferList; +} BbuIoBufCtrlStruct; + +struct xran_sym_job { + uint32_t sym_idx; + uint32_t status; +}__rte_cache_aligned; + +#define XranIncrementJob(i) ((i >= (XRAN_SYM_JOB_SIZE-1)) ? 0 : (i+1)) + +struct xran_lib_ctx +{ + uint8_t llscu_id; + uint8_t sector_id; + XRANEAXCIDCONFIG eAxc_id_cfg; + XRANFHINIT xran_init_cfg; + XRANFHCONFIG xran_fh_cfg; + XranLibHandleInfoStruct* pDevHandle; + xRANPrachCPConfigStruct PrachCPConfig; + uint32_t enableCP; + char ring_name[XRAN_RING_NUM][XRAN_MAX_SECTOR_NR][RTE_RING_NAMESIZE]; + struct rte_ring *dl_sym_idx_ring[XRAN_MAX_SECTOR_NR]; + struct rte_ring *xran2phy_ring[XRAN_MAX_SECTOR_NR]; + struct rte_ring *xran2prach_ring[XRAN_MAX_SECTOR_NR]; + + struct xran_sym_job sym_job[XRAN_SYM_JOB_SIZE]; + uint32_t sym_job_idx; + + BbuIoBufCtrlStruct sFrontHaulTxBbuIoBufCtrl[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR]; + BbuIoBufCtrlStruct sFrontHaulRxBbuIoBufCtrl[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR]; + BbuIoBufCtrlStruct sFHPrachRxBbuIoBufCtrl[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR]; + + /* buffers lists */ + XRANFlatBufferStruct sFrontHaulTxBuffers[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + XRANFlatBufferStruct sFrontHaulRxBuffers[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + XRANFlatBufferStruct sFHPrachRxBuffers[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_MAX_ANTENNA_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + + XranTransportBlockCallbackFn pCallback[XRAN_MAX_SECTOR_NR]; + void *pCallbackTag[XRAN_MAX_SECTOR_NR]; + + XranTransportBlockCallbackFn pPrachCallback[XRAN_MAX_SECTOR_NR]; + void *pPrachCallbackTag[XRAN_MAX_SECTOR_NR]; + + XranSymCallbackFn pSymCallback[XRAN_MAX_SECTOR_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + void *pSymCallbackTag[XRAN_MAX_SECTOR_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + + int32_t sym_up; /**< when we start sym 0 of up with respect to OTA time as measured in symbols */ + int32_t sym_up_ul; + + XRANFHTTIPROCCB ttiCb[XRAN_CB_MAX]; + void *TtiCbParam[XRAN_CB_MAX]; + uint32_t SkipTti[XRAN_CB_MAX]; + + int xran2phy_mem_ready; + + int rx_packet_symb_tracker[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR][XRAN_NUM_OF_SYMBOL_PER_SLOT]; + int rx_packet_callback_tracker[XRAN_N_FE_BUF_LEN][XRAN_MAX_SECTOR_NR]; + int phy_tti_cb_done; +}; + +extern const xRANPrachConfigTableStruct gxranPrachDataTable_sub6_fdd[XRAN_PRACH_CONFIG_TABLE_SIZE]; +extern const xRANPrachConfigTableStruct gxranPrachDataTable_sub6_tdd[XRAN_PRACH_CONFIG_TABLE_SIZE]; +extern const xRANPrachConfigTableStruct gxranPrachDataTable_mmw[XRAN_PRACH_CONFIG_TABLE_SIZE]; +extern const xRANPrachPreambleLRAStruct gxranPreambleforLRA[XRAN_PRACH_PREAMBLE_FORMAT_OF_ABC]; + +int process_mbuf(struct rte_mbuf *pkt); +int process_ring(struct rte_ring *r); +int ring_processing_thread(void *args); +int packets_dump_thread(void *args); + +int send_symbol_ex(enum xran_pkt_dir direction, + uint16_t section_id, + struct rb_map *data, + uint8_t frame_id, + uint8_t subframe_id, + uint8_t slot_id, + uint8_t symbol_no, + int prb_start, + int prb_num, + uint8_t CC_ID, + uint8_t RU_Port_ID, + uint8_t seq_id); + +int send_cpmsg_dlul(void *pHandle, enum xran_pkt_dir dir, + uint8_t frame_id, uint8_t subframe_id, uint8_t slot_id, + uint8_t startsym, uint8_t numsym, int prb_num, + uint16_t beam_id, uint8_t cc_id, uint8_t ru_port_id, + uint8_t seq_id); + +int send_cpmsg_prach(void *pHandle, + uint8_t frame_id, uint8_t subframe_id, uint8_t slot_id, + uint16_t beam_id, uint8_t cc_id, uint8_t prach_port_id, + uint8_t seq_id); + +uint8_t xran_get_max_sections(void *pHandle); + +XRANEAXCIDCONFIG *xran_get_conf_eAxC(void *pHandle); +uint8_t xran_get_conf_prach_scs(void *pHandle); +uint8_t xran_get_conf_fftsize(void *pHandle); +uint8_t xran_get_conf_numerology(void *pHandle); +uint8_t xran_get_conf_iqwidth(void *pHandle); +uint8_t xran_get_conf_compmethod(void *pHandle); + +uint8_t xran_get_num_cc(void *pHandle); +uint8_t xran_get_num_eAxc(void *pHandle); +uint8_t xran_get_llscuid(void *pHandle); +uint8_t xran_get_sectorid(void *pHandle); +struct xran_lib_ctx *xran_lib_get_ctx(void); + +uint16_t xran_alloc_sectionid(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ant_id, uint8_t slot_id); +uint8_t xran_get_seqid(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ant_id, uint8_t slot_id); + +#endif + diff --git a/fhi_lib/lib/src/xran_cp_api.c b/fhi_lib/lib/src/xran_cp_api.c new file mode 100644 index 0000000..d42b22b --- /dev/null +++ b/fhi_lib/lib/src/xran_cp_api.c @@ -0,0 +1,1086 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides the API functions to build Control Plane Messages + * for XRAN Front Haul layer as defined in XRAN-FH.CUS.0-v02.01. + * + * @file xran_cp_api.c + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#include + +#include "xran_common.h" +#include "xran_transport.h" +#include "xran_cp_api.h" +#include "xran_hash.h" +#include "xran_printf.h" + + +struct xran_sectioninfo_db { + uint32_t max_num; + uint32_t cur_index; +#if defined(XRAN_CP_USES_HASHTABLE) + struct rte_hash *hash; +#endif + struct xran_section_info *list; + }; + + +static struct xran_sectioninfo_db *sectiondb[XRAN_DIR_MAX]; + +int xran_cp_init_sectiondb(void *pHandle) +{ + int i, j, k; + uint32_t size; + uint16_t cid; + struct xran_sectioninfo_db *ptr; + uint8_t num_eAxc; + + +#if !defined(PRACH_USES_SHARED_PORT) + num_eAxc = xran_get_num_eAxc(pHandle) * 2; +#else + num_eAxc = xran_get_num_eAxc(pHandle); +#endif + + for(i=0; i < XRAN_DIR_MAX; i++) { + size = (xran_get_num_cc(pHandle) * num_eAxc * sizeof(struct xran_sectioninfo_db)); + print_log("Allocation Size for Section DB : %d (%dx%dx%ld)", size + , xran_get_num_cc(pHandle) + , num_eAxc + , sizeof(struct xran_sectioninfo_db)); + sectiondb[i] = malloc(size); + + if(sectiondb[i] == NULL) { + print_err("Allocation Failed for Section DB!"); + return (-XRAN_ERRCODE_OUTOFMEMORY); + } + + for(j=0; j < xran_get_num_cc(pHandle); j++) { // CC + for(k=0; k < num_eAxc; k++) { // antenna + ptr = sectiondb[i] + num_eAxc*j + k; + + ptr->max_num = xran_get_max_sections(pHandle); + ptr->cur_index = 0; + + // allicate array to store section information + size = sizeof(struct xran_section_info)*xran_get_max_sections(pHandle); + print_log("Allocation Size for list : %d (%ldx%d)", size, + sizeof(struct xran_section_info), + xran_get_max_sections(pHandle)); + ptr->list = malloc(size); + if(ptr-> list == NULL) { + print_err("Allocation Failed for Section DB!"); + return (-XRAN_ERRCODE_OUTOFMEMORY); + } + +#if defined(XRAN_CP_USES_HASHTABLE) + // Create hash table for section information + cid = rte_be_to_cpu_16(xran_compose_cid(xran_get_llscuid(pHandle), xran_get_sectorid(pHandle), j, k)); + print_log("Creating hash for %04X", cid); + ptr->hash = xran_section_init_hash(i, cid, xran_get_max_sections(pHandle)); +#endif + } + } + } + + return (XRAN_ERRCODE_OK); +} + +int xran_cp_free_sectiondb(void *pHandle) +{ + int i, j, k; + uint32_t size; + struct xran_sectioninfo_db *ptr; + uint8_t num_eAxc; + +#if !defined(PRACH_USES_SHARED_PORT) + num_eAxc = xran_get_num_eAxc(pHandle) * 2; +#else + num_eAxc = xran_get_num_eAxc(pHandle); +#endif + + for(i=0; i < XRAN_DIR_MAX; i++) { + for(j=0; j < xran_get_num_cc(pHandle); j++) { // CC + for(k=0; k < num_eAxc; k++) { // antenna + ptr = sectiondb[i] + num_eAxc*j + k; + +#if defined(XRAN_CP_USES_HASHTABLE) + xran_section_free_hash(ptr->hash); +#endif + if(ptr->list != NULL) + free(ptr->list); + else print_err("list is NULL"); + } + } + if(sectiondb[i] != NULL) + free(sectiondb[i]); + else print_err("sectiondb[%d] is NULL", i); + } + + return (XRAN_ERRCODE_OK); +} + +static struct xran_sectioninfo_db *xran_get_section_db(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id) +{ + struct xran_sectioninfo_db *ptr; + uint8_t num_eAxc; + + if(unlikely(dir>=XRAN_DIR_MAX)) { + print_err("Invalid direction - %d", dir); + return (NULL); + } + + if(unlikely(cc_id >= xran_get_num_cc(pHandle))) { + print_err("Invalid CC id - %d", cc_id); + return (NULL); + } + +#if !defined(PRACH_USES_SHARED_PORT) + num_eAxc = xran_get_num_eAxc(pHandle) * 2; +#else + num_eAxc = xran_get_num_eAxc(pHandle); +#endif + + if(unlikely(ruport_id >= num_eAxc)) { + print_err("Invalid eAxC id - %d", ruport_id); + return (NULL); + } + + ptr = sectiondb[dir] + xran_get_num_eAxc(pHandle)*cc_id + ruport_id; + + return(ptr); +} + +static struct xran_section_info *xran_get_section_info(struct xran_sectioninfo_db *ptr, uint16_t index) +{ + if(unlikely(ptr == NULL)) + return (NULL); + + if(unlikely(ptr->max_num < index)) { + print_err("Index is out of range - %d", index); + return (NULL); + } + + return(&(ptr->list[index])); +} + +int xran_cp_add_section_info(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id, + uint8_t subframe_id, uint8_t slot_id, + struct xran_section_info *info) +{ + struct xran_sectioninfo_db *ptr; + struct xran_section_info *list; + + ptr = xran_get_section_db(pHandle, dir, cc_id, ruport_id); + if(unlikely(ptr == NULL)) { + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + if(unlikely(ptr->cur_index >= ptr->max_num)) { + print_err("No more space to add section information!"); + return (-XRAN_ERRCODE_OUTOFMEMORY); + } + + list = xran_get_section_info(ptr, ptr->cur_index); + + rte_memcpy(list, info, sizeof(struct xran_section_info)); +#if defined(XRAN_CP_USES_HASHTABLE) + xran_section_add_hash(ptr->hash, info->id, ptr->cur_index); +#endif + + ptr->cur_index++; + + return (XRAN_ERRCODE_OK); +} + +int xran_cp_add_multisection_info(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id, + uint8_t subframe_id, uint8_t slot_id, + uint8_t num_sections, struct xran_section_gen_info *gen_info) +{ + int i; + struct xran_sectioninfo_db *ptr; + struct xran_section_info *list; + + ptr = xran_get_section_db(pHandle, dir, cc_id, ruport_id); + if(unlikely(ptr == NULL)) { + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + if(unlikely(ptr->cur_index >= (ptr->max_num+num_sections))) { + print_err("No more space to add section information!"); + return (-XRAN_ERRCODE_OUTOFMEMORY); + } + + list = xran_get_section_info(ptr, ptr->cur_index); + + for(i=0; ihash, gen_info[i].info.id, ptr->cur_index); +#endif + ptr->cur_index++; + } + + return (XRAN_ERRCODE_OK); +} + +struct xran_section_info *xran_cp_find_section_info(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id, + uint8_t subframe_id, uint8_t slot_id, + uint16_t section_id) +{ + int index; + struct xran_sectioninfo_db *ptr; + + + ptr = xran_get_section_db(pHandle, dir, cc_id, ruport_id); + if(unlikely(ptr == NULL)) + return (NULL); + +#if defined(XRAN_CP_USES_HASHTABLE) + index = xran_section_lookup(ptr->hash, section_id); + if(unlikely(index > ptr->max_num)) { + print_err("Invalid index - %d", index); + return (NULL); + } + + if(index < 0) { + print_dbg("No section ID in the list - %d", section_id); + return (NULL); + } + + return (xran_get_section_info(ptr, index)); +#else + for(index=0; indexcur_index; index++) { + if(ptr->list[index].id == section_id) { + print_dbg("Found section info %04X", section_id); + return (xran_get_section_info(ptr, index)); + } + } + + print_dbg("No section ID in the list - %d", section_id); + return (NULL); +#endif + +} + +struct xran_section_info *xran_cp_iterate_section_info(void *pHandle, + uint8_t dir, uint8_t cc_id, uint8_t ruport_id, + uint8_t subframe_id, uint8_t slot_id, uint32_t *next) +{ + int index; + struct xran_sectioninfo_db *ptr; + + + ptr = xran_get_section_db(pHandle, dir, cc_id, ruport_id); + if(unlikely(ptr == NULL)) + return (NULL); + +#if defined(XRAN_CP_USES_HASHTABLE) + index = xran_section_iterate(ptr->hash, next); + if(unlikely(index > ptr->max_num)) { + print_err("Invalid index - %d", index); + return (NULL); + } + + if(index < 0) { + print_dbg("No section ID in the list - %d", section_id); + return (NULL); + } + + return (xran_get_section_info(ptr, index)); +#else + index = *next; + if(*next < ptr->cur_index) { + (*next)++; + return (xran_get_section_info(ptr, index)); + } + else + print_dbg("No more sections in the list"); + + return (NULL); +#endif +} + +int xran_cp_getsize_section_info(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ruport_id) +{ + int i, index; + struct xran_sectioninfo_db *ptr; + + + ptr = xran_get_section_db(pHandle, dir, cc_id, ruport_id); + if(unlikely(ptr == NULL)) + return (-1); + + return (ptr->cur_index); +} + +int xran_cp_reset_section_info(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ruport_id) +{ + struct xran_sectioninfo_db *ptr; + + ptr = xran_get_section_db(pHandle, dir, cc_id, ruport_id); + if(unlikely(ptr == NULL)) { + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + ptr->cur_index = 0; +#if defined(XRAN_CP_USES_HASHTABLE) + xran_section_reset_hash(ptr->hash); +#endif + + return (XRAN_ERRCODE_OK); +} + +int xran_dump_sectiondb(void) +{ + // TODO: + return (0); +} + + +// Cyclic Prefix Length 5.4.4.14 +// CP_length = cpLength * Ts * 2^u, Ts = 1/30.72MHz, if u is N/A, it shall be zero +#define CPLEN_TS (30720000) +inline uint16_t xran_get_cplength(int cpLength, int uval) // uval = -1 for N/A +{ + return ((cpLength * ((uval<0)?0:(2<>1); +} + + +/** + * @brief Fill the section body of type 0 in C-Plane packet + * + * @param section + * A pointer to the section in the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +static int xran_prepare_section0( + struct xran_cp_radioapp_section0 *section, + struct xran_section_gen_info *params) +{ +#if (XRAN_STRICT_PARM_CHECK) + if(unlikely(params->info.numSymbol > XRAN_SYMBOLNUMBER_MAX)) { + print_err("Invalid number of Symbols - %d", params->info.numSymbol); + return (-XRAN_ERRCODE_INVALIDPARAM); + } +#endif + + section->hdr.sectionId = params->info.id; + section->hdr.rb = params->info.rb; + section->hdr.symInc = params->info.symInc; + section->hdr.startPrbc = params->info.startPrbc; + section->hdr.numPrbc = params->info.numPrbc; + + section->hdr.u.s0.reMask = params->info.reMask; + section->hdr.u.s0.numSymbol = params->info.numSymbol; + section->hdr.u.s0.reserved = 0; + + // for network byte order + *((uint64_t *)section) = rte_cpu_to_be_64(*((uint64_t *)section)); + + return (XRAN_ERRCODE_OK); +} +/** + * @brief Fill the section header of type 0 in C-Plane packet + * + * @param s0hdr + * A pointer to the section header in the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +static int xran_prepare_section0_hdr( + struct xran_cp_radioapp_section0_header *s0hdr, + struct xran_cp_gen_params *params) + +{ + s0hdr->timeOffset = rte_cpu_to_be_16(params->hdr.timeOffset); + s0hdr->frameStructure.fftSize = params->hdr.fftSize; + s0hdr->frameStructure.uScs = params->hdr.scs; + s0hdr->cpLength = rte_cpu_to_be_16(params->hdr.cpLength); + s0hdr->reserved = 0; + + return (XRAN_ERRCODE_OK); +} + +/** + * @brief Fill the section body of type 1 in C-Plane packet + * Extension is not supported. + * + * @param section + * A pointer to the section header in the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +static int xran_prepare_section1( + struct xran_cp_radioapp_section1 *section, + struct xran_section_gen_info *params) +{ +#if (XRAN_STRICT_PARM_CHECK) + if(unlikely(params->info.numSymbol > XRAN_SYMBOLNUMBER_MAX)) { + print_err("Invalid number of Symbols - %d", params->info.numSymbol); + return (-XRAN_ERRCODE_INVALIDPARAM); + } +#endif + + section->hdr.sectionId = params->info.id; + section->hdr.rb = params->info.rb; + section->hdr.symInc = params->info.symInc; + section->hdr.startPrbc = params->info.startPrbc; + section->hdr.numPrbc = params->info.numPrbc; + + section->hdr.u.s1.reMask = params->info.reMask; + section->hdr.u.s1.numSymbol = params->info.numSymbol; + section->hdr.u.s1.beamId = params->info.beamId; + + if(params->info.ef) { + // TODO: need to handle extension + print_err("Extension is not supported!"); + section->hdr.u.s1.ef = 0; +// section->hdr.u.s1.ef = params->info.ef; + } + else + section->hdr.u.s1.ef = 0; + + // for network byte order + *((uint64_t *)section) = rte_cpu_to_be_64(*((uint64_t *)section)); + + return (XRAN_ERRCODE_OK); +} +/** + * @brief Fill the section header of type 1 in C-Plane packet + * + * @param s1hdr + * A pointer to the section header in the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +static int xran_prepare_section1_hdr( + struct xran_cp_radioapp_section1_header *s1hdr, + struct xran_cp_gen_params *params) +{ + s1hdr->udComp.udIqWidth = params->hdr.iqWidth; + s1hdr->udComp.udCompMeth = params->hdr.compMeth; + s1hdr->reserved = 0; + + return (XRAN_ERRCODE_OK); +} + +/** + * @brief Fill the section body of type 3 in C-Plane packet + * Extension is not supported. + * + * @param section + * A pointer to the section header in the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +static int xran_prepare_section3( + struct xran_cp_radioapp_section3 *section, + struct xran_section_gen_info *params) +{ +#if (XRAN_STRICT_PARM_CHECK) + if(unlikely(params->info.numSymbol > XRAN_SYMBOLNUMBER_MAX)) { + print_err("Invalid number of Symbols - %d", params->info.numSymbol); + return (-XRAN_ERRCODE_INVALIDPARAM); + } +#endif + + section->hdr.sectionId = params->info.id; + section->hdr.rb = params->info.rb; + section->hdr.symInc = params->info.symInc; + section->hdr.startPrbc = params->info.startPrbc; + section->hdr.numPrbc = params->info.numPrbc; + + section->hdr.u.s3.reMask = params->info.reMask; + section->hdr.u.s3.numSymbol = params->info.numSymbol; + section->hdr.u.s3.beamId = params->info.beamId; + + section->freqOffset = rte_cpu_to_be_32(params->info.freqOffset)>>8; + section->reserved = 0; + + if(params->info.ef) { + // TODO: need to handle extension + print_err("Extension is not supported!"); + section->hdr.u.s3.ef = 0; +// section->hdr.u.s3.ef = params->info.ef; + } + else + section->hdr.u.s3.ef = 0; + + // for network byte order (header, 8 bytes) + *((uint64_t *)section) = rte_cpu_to_be_64(*((uint64_t *)section)); + + return (XRAN_ERRCODE_OK); +} +/** + * @brief Fill the section header of type 3 in C-Plane packet + * + * @param s3hdr + * A pointer to the section header in the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +static int xran_prepare_section3_hdr( + struct xran_cp_radioapp_section3_header *s3hdr, + struct xran_cp_gen_params *params) + +{ + s3hdr->timeOffset = rte_cpu_to_be_16(params->hdr.timeOffset); + s3hdr->frameStructure.fftSize = params->hdr.fftSize; + s3hdr->frameStructure.uScs = params->hdr.scs; + s3hdr->cpLength = rte_cpu_to_be_16(params->hdr.cpLength); + s3hdr->udComp.udIqWidth = params->hdr.iqWidth; + s3hdr->udComp.udCompMeth = params->hdr.compMeth; + + return (XRAN_ERRCODE_OK); +} + +/** + * @brief add sections to C-Plane packet + * Section type 1 and 3 are supported. + * + * @param mbuf + * A pointer to the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +int xran_append_control_section(struct rte_mbuf *mbuf, struct xran_cp_gen_params *params) +{ + int i, ret; + uint32_t totalen; + void *section; + int section_size; + int (*xran_prepare_section_func)(void *section, void *params); + + + totalen = 0; + switch(params->sectionType) { + case XRAN_CP_SECTIONTYPE_0: /* Unused RB or Symbols in DL or UL, not supportted */ + section_size = sizeof(struct xran_cp_radioapp_section0); + xran_prepare_section_func = (int (*)(void *, void *))xran_prepare_section0; + break; + + case XRAN_CP_SECTIONTYPE_1: /* Most DL/UL Radio Channels */ + section_size = sizeof(struct xran_cp_radioapp_section1); + xran_prepare_section_func = (int (*)(void *, void *))xran_prepare_section1; + break; + + case XRAN_CP_SECTIONTYPE_3: /* PRACH and Mixed-numerology Channels */ + section_size = sizeof(struct xran_cp_radioapp_section3); + xran_prepare_section_func = (int (*)(void *, void *))xran_prepare_section3; + break; + + case XRAN_CP_SECTIONTYPE_5: /* UE scheduling information, not supported */ + case XRAN_CP_SECTIONTYPE_6: /* Channel Information, not supported */ + case XRAN_CP_SECTIONTYPE_7: /* LAA, not supported */ + default: + section_size = 0; + xran_prepare_section_func = NULL; + print_err("Section Type %d is not supported!", params->sectionType); + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + if(unlikely(xran_prepare_section_func == NULL)) { + print_err("Section Type %d is not supported!", params->sectionType); + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + for(i=0; inumSections; i++) { + section = rte_pktmbuf_append(mbuf, section_size); + if(section == NULL) { + print_err("Fail to allocate the space for section[%d]!", i); + return (-XRAN_ERRCODE_OUTOFMEMORY); + } + + if(unlikely(xran_prepare_section_func((void *)section, + (void *)¶ms->sections[i]) < 0)) { + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + totalen += section_size; + } + + return (totalen); +} + +/** + * @brief fill the information of a radio application header in a C-Plane packet + * + * @param apphdr + * A pointer to the application header in the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +static inline int xran_prepare_radioapp_common_header( + struct xran_cp_radioapp_common_header *apphdr, + struct xran_cp_gen_params *params) +{ + +#if (XRAN_STRICT_PARM_CHECK) + if(unlikely(params->dir != XRAN_DIR_DL && params->dir != XRAN_DIR_UL)) { + print_err("Invalid direction!"); + return (-XRAN_ERRCODE_INVALIDPARAM); + } + if(unlikely(params->hdr.slotId > XRAN_SLOTID_MAX)) { + print_err("Invalid Slot ID!"); + return (-XRAN_ERRCODE_INVALIDPARAM); + } + if(unlikely(params->hdr.startSymId > XRAN_SYMBOLNUMBER_MAX)) { + print_err("Invalid Symbol ID!"); + return (-XRAN_ERRCODE_INVALIDPARAM); + } +#endif + + apphdr->dataDirection = params->dir; + apphdr->payloadVer = XRAN_PAYLOAD_VER; + apphdr->filterIndex = params->hdr.filterIdx; + apphdr->frameId = params->hdr.frameId; + apphdr->subframeId = params->hdr.subframeId; + apphdr->slotId = params->hdr.slotId; + apphdr->startSymbolId = params->hdr.startSymId; + apphdr->numOfSections = params->numSections; + apphdr->sectionType = params->sectionType; + + // radio app header has common parts of 4bytes for all section types + *((uint32_t *)apphdr) = rte_cpu_to_be_32(*((uint32_t *)apphdr)); + + return (XRAN_ERRCODE_OK); +} + +/** + * @brief add a radio application header in a C-Plane packet + * + * @param mbuf + * A pointer to the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @return + * 0 on success; non zero on failure + */ +int xran_append_radioapp_header(struct rte_mbuf *mbuf, struct xran_cp_gen_params *params) +{ + int ret; + uint32_t totalen; + struct xran_cp_radioapp_common_header *apphdr; + int (*xran_prepare_radioapp_section_hdr_func)(void *hdr, void *params); + + +#if (XRAN_STRICT_PARM_CHECK) + if(unlikely(params->sectionType >= XRAN_CP_SECTIONTYPE_MAX)) { + print_err("Invalid Section Type - %d", params->sectionType); + return (-XRAN_ERRCODE_INVALIDPARAM); + } +#endif + + switch(params->sectionType) { + case XRAN_CP_SECTIONTYPE_0: // Unused RB or Symbols in DL or UL, not supportted + xran_prepare_radioapp_section_hdr_func = (int (*)(void *, void*))xran_prepare_section0_hdr; + totalen = sizeof(struct xran_cp_radioapp_section0_header); + break; + + case XRAN_CP_SECTIONTYPE_1: // Most DL/UL Radio Channels + xran_prepare_radioapp_section_hdr_func = (int (*)(void *, void*))xran_prepare_section1_hdr; + totalen = sizeof(struct xran_cp_radioapp_section1_header); + break; + + case XRAN_CP_SECTIONTYPE_3: // PRACH and Mixed-numerology Channels + xran_prepare_radioapp_section_hdr_func = (int (*)(void *, void*))xran_prepare_section3_hdr; + totalen = sizeof(struct xran_cp_radioapp_section3_header); + break; + + case XRAN_CP_SECTIONTYPE_5: // UE scheduling information, not supported + case XRAN_CP_SECTIONTYPE_6: // Channel Information, not supported + case XRAN_CP_SECTIONTYPE_7: // LAA, not supported + default: + print_err("Section Type %d is not supported!", params->sectionType); + xran_prepare_radioapp_section_hdr_func = NULL; + totalen = 0; + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + apphdr = (struct xran_cp_radioapp_common_header *)rte_pktmbuf_append(mbuf, totalen); + if(unlikely(apphdr == NULL)) { + print_err("Fail to reserve the space for radio application header!"); + return (-XRAN_ERRCODE_OUTOFMEMORY); + } + + ret = xran_prepare_radioapp_common_header(apphdr, params); + if(unlikely(ret < 0)) { + return (ret); + } + + if(likely(xran_prepare_radioapp_section_hdr_func)) { + xran_prepare_radioapp_section_hdr_func(apphdr, params); + } + else { + print_err("xran_prepare_radioapp_section_hdr_func is NULL!"); + return (-XRAN_ERRCODE_INVALIDPARAM); + } + + return (totalen); +} + +/** + * @brief Create a C-Plane packet + * Transport layer fragmentation is not supported. + * + * @ingroup xran_cp_pkt + * + * @param mbuf + * A pointer to the packet buffer + * @param params + * A porinter to the information to generate a C-Plane packet + * @param CC_ID + * Component Carrier ID for this C-Plane message + * @param Ant_ID + * Antenna ID(RU Port ID) for this C-Plane message + * @param seq_id + * Sequence ID for this C-Plane message + * @return + * 0 on success; non zero on failure + */ +int xran_prepare_ctrl_pkt(struct rte_mbuf *mbuf, + struct xran_cp_gen_params *params, + uint8_t CC_ID, uint8_t Ant_ID, + uint8_t seq_id) +{ + int ret; + uint32_t payloadlen; + struct xran_ecpri_hdr *ecpri_hdr; + + + ecpri_hdr = (struct xran_ecpri_hdr *)rte_pktmbuf_append(mbuf, sizeof(struct xran_ecpri_hdr)); + if(unlikely(ecpri_hdr == NULL)) { + print_err("Fail to allocate the space for eCPRI hedaer!"); + return (-XRAN_ERRCODE_OUTOFMEMORY); + } + + ecpri_hdr->ecpri_ver = XRAN_ECPRI_VER; + ecpri_hdr->ecpri_resv = 0; // should be zero + ecpri_hdr->ecpri_concat = 0; + ecpri_hdr->ecpri_mesg_type = ECPRI_RT_CONTROL_DATA; + ecpri_hdr->ecpri_xtc_id = xran_compose_cid(0, 0, CC_ID, Ant_ID); + ecpri_hdr->ecpri_seq_id.seq_id = seq_id; + + /* TODO: Transport layer fragmentation is not supported */ + ecpri_hdr->ecpri_seq_id.sub_seq_id = 0; + ecpri_hdr->ecpri_seq_id.e_bit = 1; + + payloadlen = 0; + + ret = xran_append_radioapp_header(mbuf, params); + if(ret < 0) { + return (ret); + } + payloadlen += ret; + + ret = xran_append_control_section(mbuf, params); + if(ret < 0) { + return (ret); + } + payloadlen += ret; + +// printf("Total Payload length = %d\n", payloadlen); + ecpri_hdr->ecpri_payl_size = rte_cpu_to_be_16(payloadlen); + + return (XRAN_ERRCODE_OK); +} + +/////////////////////////////////////// +// for Debug +int xran_parse_cp_pkt(struct rte_mbuf *mbuf, struct xran_cp_gen_params *result) +{ + struct xran_ecpri_hdr *ecpri_hdr; + struct xran_cp_radioapp_common_header *apphdr; + int i, ret; + int extlen; + + + ret = 0; + ecpri_hdr = rte_pktmbuf_mtod(mbuf, void *); + if(ecpri_hdr == NULL) { + print_err("Invalid packet - eCPRI hedaer!"); + return (-XRAN_ERRCODE_INVALIDPACKET); + } + + /* Process eCPRI header. */ + if(ecpri_hdr->ecpri_ver != XRAN_ECPRI_VER) { + print_err("Invalid eCPRI version - %d", ecpri_hdr->ecpri_ver); + ret = -XRAN_ERRCODE_INVALIDPACKET; + } + + if(ecpri_hdr->ecpri_resv != 0) { + print_err("Invalid reserved field - %d", ecpri_hdr->ecpri_resv); + ret = -XRAN_ERRCODE_INVALIDPACKET; + } + + if(ecpri_hdr->ecpri_mesg_type != ECPRI_RT_CONTROL_DATA) { + print_err("Not C-Plane Message - %d", ecpri_hdr->ecpri_mesg_type); + ret = -XRAN_ERRCODE_INVALIDPACKET; + } +#if 0 + printf("[CPlane] [%04X:%03d-%3d-%d] len=%5d\n", + rte_be_to_cpu_16(ecpri_hdr->ecpri_xtc_id), + ecpri_hdr->ecpri_seq_id.seq_id, ecpri_hdr->ecpri_seq_id.sub_seq_id, + ecpri_hdr->ecpri_seq_id.e_bit, + rte_be_to_cpu_16(ecpri_hdr->ecpri_payl_size)); +#endif + + /* Process radio header. */ + apphdr = (void *)rte_pktmbuf_adj(mbuf, sizeof(struct xran_ecpri_hdr)); + if(apphdr == NULL) { + print_err("Invalid packet - radio app hedaer!"); + return (-XRAN_ERRCODE_INVALIDPACKET); + } + + *((uint32_t *)apphdr) = rte_cpu_to_be_32(*((uint32_t *)apphdr)); + + if(apphdr->payloadVer != XRAN_PAYLOAD_VER) { + print_err("Invalid Payload version - %d", apphdr->payloadVer); + ret = -XRAN_ERRCODE_INVALIDPACKET; + } + + result->dir = apphdr->dataDirection; + result->hdr.filterIdx = apphdr->filterIndex; + result->hdr.frameId = apphdr->frameId; + result->hdr.subframeId = apphdr->subframeId; + result->hdr.slotId = apphdr->slotId; + result->hdr.startSymId = apphdr->startSymbolId; + result->sectionType = apphdr->sectionType; + result->numSections = apphdr->numOfSections; + + switch(apphdr->sectionType) { + case XRAN_CP_SECTIONTYPE_0: // Unused RB or Symbols in DL or UL, not supportted + { + struct xran_cp_radioapp_section0_header *hdr; + struct xran_cp_radioapp_section0 *section; + + hdr = (struct xran_cp_radioapp_section0_header*)apphdr; + + result->hdr.fftSize = rte_be_to_cpu_16(hdr->timeOffset); + result->hdr.scs = hdr->frameStructure.fftSize; + result->hdr.timeOffset = hdr->frameStructure.uScs; + result->hdr.cpLength = rte_be_to_cpu_16(hdr->cpLength); + //hdr->reserved; /* should be zero */ + + section = (void *)rte_pktmbuf_adj(mbuf, sizeof(struct xran_cp_radioapp_section0_header)); + if(section == NULL) { + print_err("Invalid packet 0 - radio app hedaer!"); + return (-XRAN_ERRCODE_INVALIDPACKET); + } + for(i=0; inumSections; i++) { + *((uint64_t *)section) = rte_be_to_cpu_64(*((uint64_t *)section)); + + result->sections[i].info.type = apphdr->sectionType; + result->sections[i].info.id = section->hdr.sectionId; + result->sections[i].info.rb = section->hdr.rb; + result->sections[i].info.symInc = section->hdr.symInc; + result->sections[i].info.startPrbc = section->hdr.startPrbc; + result->sections[i].info.numPrbc = section->hdr.numPrbc, + result->sections[i].info.numSymbol = section->hdr.u.s0.numSymbol; + result->sections[i].info.reMask = section->hdr.u.s0.reMask; + //section->hdr.u.s0.reserved; /* should be zero */ + + section = (void *)rte_pktmbuf_adj(mbuf, sizeof(struct xran_cp_radioapp_section0)); + if(section == NULL) { + print_err("Invalid packet 0 - number of section [%d:%d]!", + result->numSections, i); + result->numSections = i; + ret = (-XRAN_ERRCODE_INVALIDPACKET); + break; + } + } + } + break; + + case XRAN_CP_SECTIONTYPE_1: // Most DL/UL Radio Channels + { + struct xran_cp_radioapp_section1_header *hdr; + struct xran_cp_radioapp_section1 *section; + + hdr = (struct xran_cp_radioapp_section1_header*)apphdr; + + result->hdr.iqWidth = hdr->udComp.udIqWidth; + result->hdr.compMeth = hdr->udComp.udCompMeth; + + section = (void *)rte_pktmbuf_adj(mbuf, sizeof(struct xran_cp_radioapp_section1_header)); + if(section == NULL) { + print_err("Invalid packet 1 - radio app hedaer!"); + return (-XRAN_ERRCODE_INVALIDPACKET); + } + + for(i=0; inumSections; i++) { + *((uint64_t *)section) = rte_be_to_cpu_64(*((uint64_t *)section)); + + result->sections[i].info.type = apphdr->sectionType; + result->sections[i].info.id = section->hdr.sectionId; + result->sections[i].info.rb = section->hdr.rb; + result->sections[i].info.symInc = section->hdr.symInc; + result->sections[i].info.startPrbc = section->hdr.startPrbc; + result->sections[i].info.numPrbc = section->hdr.numPrbc, + result->sections[i].info.numSymbol = section->hdr.u.s1.numSymbol; + result->sections[i].info.reMask = section->hdr.u.s1.reMask; + result->sections[i].info.beamId = section->hdr.u.s1.beamId; + result->sections[i].info.ef = section->hdr.u.s1.ef; + + if(section->hdr.u.s1.ef) { + // TODO: handle section extension + extlen = 0; + } + else extlen = 0; + + section = (void *)rte_pktmbuf_adj(mbuf, + sizeof(struct xran_cp_radioapp_section1)+extlen); + if(section == NULL) { + print_err("Invalid packet 1 - number of section [%d:%d]!", + result->numSections, i); + result->numSections = i; + ret = (-XRAN_ERRCODE_INVALIDPACKET); + break; + } + } + } + break; + + case XRAN_CP_SECTIONTYPE_3: // PRACH and Mixed-numerology Channels + { + struct xran_cp_radioapp_section3_header *hdr; + struct xran_cp_radioapp_section3 *section; + + hdr = (struct xran_cp_radioapp_section3_header*)apphdr; + + result->hdr.timeOffset = rte_be_to_cpu_16(hdr->timeOffset); + result->hdr.scs = hdr->frameStructure.uScs; + result->hdr.fftSize = hdr->frameStructure.fftSize; + result->hdr.cpLength = rte_be_to_cpu_16(hdr->cpLength); + result->hdr.iqWidth = hdr->udComp.udIqWidth; + result->hdr.compMeth = hdr->udComp.udCompMeth; + + section = (void *)rte_pktmbuf_adj(mbuf, sizeof(struct xran_cp_radioapp_section3_header)); + if(section == NULL) { + print_err("Invalid packet 3 - radio app hedaer!"); + return (-XRAN_ERRCODE_INVALIDPACKET); + } + + for(i=0; inumSections; i++) { + *((uint64_t *)section) = rte_be_to_cpu_64(*((uint64_t *)section)); + + result->sections[i].info.type = apphdr->sectionType; + result->sections[i].info.id = section->hdr.sectionId; + result->sections[i].info.rb = section->hdr.rb; + result->sections[i].info.symInc = section->hdr.symInc; + result->sections[i].info.startPrbc = section->hdr.startPrbc; + result->sections[i].info.numPrbc = section->hdr.numPrbc, + result->sections[i].info.numSymbol = section->hdr.u.s3.numSymbol; + result->sections[i].info.reMask = section->hdr.u.s3.reMask; + result->sections[i].info.beamId = section->hdr.u.s3.beamId; + result->sections[i].info.ef = section->hdr.u.s3.ef; + result->sections[i].info.freqOffset = ((int32_t)rte_be_to_cpu_32(section->freqOffset))>>8; + + if(section->reserved) { + print_err("Invalid packet 3 - section[%d:%d]", i, section->reserved); + ret = -XRAN_ERRCODE_INVALIDPACKET; + } + + if(section->hdr.u.s3.ef) { + // TODO: handle section extension + extlen = 0; + } + else extlen = 0; + + section = (void *)rte_pktmbuf_adj(mbuf, + sizeof(struct xran_cp_radioapp_section3)+extlen); + if(section == NULL) { + print_err("Invalid packet 3 - number of section [%d:%d]!", + result->numSections, i); + result->numSections = i; + ret = (-XRAN_ERRCODE_INVALIDPACKET); + break; + } + } + } + break; + + case XRAN_CP_SECTIONTYPE_5: // UE scheduling information, not supported + case XRAN_CP_SECTIONTYPE_6: // Channel Information, not supported + case XRAN_CP_SECTIONTYPE_7: // LAA, not supported + default: + ret = -XRAN_ERRCODE_INVALIDPARAM; + print_err("Non-supported Section Type - %d", apphdr->sectionType); + } + +#if 0 + printf("[CP-%s] [%3d:%2d:%2d] section%d[%d] startSym=%d filterIdx=%X IQwidth=%d CompMeth=%d\n", + result->dir?"DL":"UL", + result->hdr.frameId, result->hdr.subframeId, result->hdr.slotId, + result->sectionType, result->numSections, + result->hdr.startSymId, + result->hdr.filterIdx, + result->hdr.iqWidth, result->hdr.compMeth); + + for(i=0; inumSections; i++) { + printf(" >> %3d:%04X| rb=%d symInc=%d numSym=%d startPrbc=%02X numPrbc=%d reMask=%03X beamId=%04X freqOffset=%d ef=%d\n", + i, result->sections[i].info.id, + result->sections[i].info.rb, + result->sections[i].info.symInc, result->sections[i].info.numSymbol, + result->sections[i].info.startPrbc, result->sections[i].info.numPrbc, + result->sections[i].info.reMask, + result->sections[i].info.beamId, + result->sections[i].info.freqOffset, + result->sections[i].info.ef); +// result->sections[i].info.type + } +#endif + + return(ret); +} + diff --git a/fhi_lib/lib/src/xran_hash.h b/fhi_lib/lib/src/xran_hash.h new file mode 100644 index 0000000..b06c694 --- /dev/null +++ b/fhi_lib/lib/src/xran_hash.h @@ -0,0 +1,45 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief Definitions and support functions to process XRAN packet + * @file xran_hash.h + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +#ifndef _XRAN_HASH_H +#define _XRAN_HASH_H + +#include +#include +#include + +#define DEFAULT_HASH_FUNC rte_hash_crc + + +struct rte_hash *xran_section_init_hash(uint16_t dir, uint16_t cid, int max_num_sections); +void xran_section_free_hash(struct rte_hash *hash); + +void xran_section_reset_hash(struct rte_hash *hash); +int xran_section_add_hash(const struct rte_hash *hash, uint16_t section_id, int index); +int xran_section_lookup(const struct rte_hash *hash, uint16_t section_id); +int xran_section_iterate(const struct rte_hash *hash, uint32_t *next); + +#endif diff --git a/fhi_lib/lib/src/xran_lib_mlog_tasks_id.h b/fhi_lib/lib/src/xran_lib_mlog_tasks_id.h new file mode 100644 index 0000000..2c99c19 --- /dev/null +++ b/fhi_lib/lib/src/xran_lib_mlog_tasks_id.h @@ -0,0 +1,101 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + +/** + * @brief This file has the System Debug Trace Logger (Mlog) Task IDs used by XRAN library + * @file mlog_task_id.h + * @ingroup group_lte_source_common + * @author Intel Corporation + **/ + +#ifndef _XRAN_TASK_ID_H_ +#define _XRAN_TASK_ID_H_ + +#define RESOURCE_CORE_0 0 +#define RESOURCE_CORE_1 1 +#define RESOURCE_CORE_2 2 +#define RESOURCE_CORE_3 3 +#define RESOURCE_CORE_4 4 +#define RESOURCE_CORE_5 5 +#define RESOURCE_CORE_6 6 +#define RESOURCE_CORE_7 7 +#define RESOURCE_CORE_8 8 +#define RESOURCE_CORE_9 9 +#define RESOURCE_CORE_10 10 +#define RESOURCE_CORE_11 11 +#define RESOURCE_CORE_12 12 +#define RESOURCE_CORE_13 13 +#define RESOURCE_CORE_14 14 +#define RESOURCE_CORE_15 15 +#define RESOURCE_CORE_16 16 + +#define RESOURCE_IA_CORE 100 + +//-------------------------------------------------------------------- +// XRAN +//-------------------------------------------------------------------- +#define PID_TTI_TIMER 2100 +#define PID_TTI_CB 2101 + +#define PID_SYM_TIMER 2102 +#define PID_GNB_PROC_TIMING_TIMEOUT 2103 + +#define PID_TIME_SYSTIME_POLL 2104 +#define PID_TIME_SYSTIME_STOP 2105 +#define PID_TIME_ARM_TIMER 2106 + + +#define PID_RADIO_FREQ_RX_PKT 2400 +#define PID_RADIO_RX_STOP 2401 +#define PID_RADIO_RX_UL_IQ 2402 +#define PID_RADIO_PRACH_PKT 2403 +#define PID_RADIO_FE_COMPRESS 2404 +#define PID_RADIO_FE_DECOMPRESS 2405 +#define PID_RADIO_TX_BYPASS_PROC 2406 +#define PID_RADIO_ETH_TX_BURST 2407 +#define PID_RADIO_TX_DL_IQ 2408 +#define PID_RADIO_RX_VALIDATE 2409 + +#define PID_RADIO_RX_IRQ_ON 2410 +#define PID_RADIO_RX_IRQ_OFF 2411 +#define PID_RADIO_RX_EPOLL_WAIT 2412 + +#define PID_RADIO_TX_LTEMODE_PROC 2413 +#define PID_RADIO_RX_LTEMODE_PROC 2414 + +#define PID_RADIO_TX_PLAY_BACK_IQ 2415 + +#define PID_PROCESS_TX_SYM 2416 + +#define PID_CP_DL_CB 2500 +#define PID_CP_UL_CB 2501 +#define PID_UP_DL_CB 2502 +#define PID_SYM_OTA_CB 2503 +#define PID_TTI_CB_TO_PHY 2504 +#define PID_HALF_SLOT_CB_TO_PHY 2505 +#define PID_FULL_SLOT_CB_TO_PHY 2506 +#define PID_UP_UL_HALF_DEAD_LINE_CB 2507 +#define PID_UP_UL_FULL_DEAD_LINE_CB 2508 + +#define PID_PROCESS_UP_PKT 2600 +#define PID_PROCESS_CP_PKT 2700 + + + +#endif /* _XRAN_TASK_ID_H_ */ + diff --git a/fhi_lib/lib/src/xran_main.c b/fhi_lib/lib/src/xran_main.c new file mode 100644 index 0000000..94751f6 --- /dev/null +++ b/fhi_lib/lib/src/xran_main.c @@ -0,0 +1,1445 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief XRAN main functionality module + * @file xran_main.c + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +#define _GNU_SOURCE +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include + +#include "xran_fh_lls_cu.h" + +#include "ethdi.h" +#include "xran_pkt.h" +#include "xran_up_api.h" +#include "xran_cp_api.h" +#include "xran_sync_api.h" +#include "xran_lib_mlog_tasks_id.h" +#include "xran_timer.h" +#include "xran_common.h" +#include "xran_printf.h" + +#ifndef MLOG_ENABLED +#include "mlog_lnx_xRAN.h" +#else +#include "mlog_lnx.h" +#endif + +#define DIV_ROUND_OFFSET(X,Y) ( X/Y + ((X%Y)?1:0) ) + +#define XranOffsetSym(offSym, otaSym, numSymTotal) (((int32_t)offSym > (int32_t)otaSym) ? \ + ((int32_t)otaSym + ((int32_t)numSymTotal) - (uint32_t)offSym) : \ + (((int32_t)otaSym - (int32_t)offSym) >= numSymTotal) ? \ + (((int32_t)otaSym - (int32_t)offSym) - numSymTotal) : \ + ((int32_t)otaSym - (int32_t)offSym)) + +#define MAX_NUM_OF_XRAN_CTX (2) +#define XranIncrementCtx(ctx) ((ctx >= (MAX_NUM_OF_XRAN_CTX-1)) ? 0 : (ctx+1)) +#define XranDecrementCtx(ctx) ((ctx == 0) ? (MAX_NUM_OF_XRAN_CTX-1) : (ctx-1)) + +struct xran_timer_ctx { + uint32_t tti_to_process; +}; + +static XranLibHandleInfoStruct DevHandle; +static struct xran_lib_ctx g_xran_lib_ctx = { 0 }; + +struct xran_timer_ctx timer_ctx[MAX_NUM_OF_XRAN_CTX]; + +static struct rte_timer tti_to_phy_timer[10]; +static struct rte_timer tti_timer; +static struct rte_timer sym_timer; +static struct rte_timer tx_cp_dl_timer; +static struct rte_timer tx_cp_ul_timer; +static struct rte_timer tx_up_timer; + +static long interval_us = 125; + +uint32_t xran_lib_ota_tti = 0; /* [0:7999] */ +uint32_t xran_lib_ota_sym = 0; /* [0:7] */ +uint32_t xran_lib_ota_sym_idx = 0; /* [0 : 14*8*1000-1] */ + +uint64_t xran_lib_gps_second = 0; + +static uint8_t xran_cp_seq_id_num[XRAN_MAX_CELLS_PER_PORT][XRAN_DIR_MAX][XRAN_MAX_ANTENNA_NR]; +static uint8_t xran_section_id_curslot[XRAN_MAX_CELLS_PER_PORT][XRAN_MAX_ANTENNA_NR]; +static uint16_t xran_section_id[XRAN_MAX_CELLS_PER_PORT][XRAN_MAX_ANTENNA_NR]; + +void xran_timer_arm(struct rte_timer *tim, void* arg); +int xran_process_tx_sym(void *arg); + +int xran_process_rx_sym(void *arg, + void *iq_data_start, + uint16_t size, + uint8_t CC_ID, + uint8_t Ant_ID, + uint8_t frame_id, + uint8_t subframe_id, + uint8_t slot_id, + uint8_t symb_id); + +void tti_ota_cb(struct rte_timer *tim, void *arg); +void tti_to_phy_cb(struct rte_timer *tim, void *arg); +void xran_timer_arm_ex(struct rte_timer *tim, void* CbFct, void *CbArg, unsigned tim_lcore); + +struct xran_lib_ctx *xran_lib_get_ctx(void) +{ + return &g_xran_lib_ctx; +} + +static inline XRANFHCONFIG *xran_lib_get_ctx_fhcfg(void) +{ + return (&(xran_lib_get_ctx()->xran_fh_cfg)); +} + +inline uint16_t xran_get_beamid(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ant_id, uint8_t slot_id) +{ + return (0); // NO BEAMFORMING +} + +int xran_init_sectionid(void *pHandle) +{ + int cell, dir, ant; + + for(cell=0; cell < XRAN_MAX_CELLS_PER_PORT; cell++) { + for(ant=0; ant < XRAN_MAX_ANTENNA_NR; ant++) { + xran_section_id[cell][ant] = 0; + xran_section_id_curslot[cell][ant] = 255; + } + } + + return (0); +} + +int xran_init_seqid(void *pHandle) +{ + int cell, dir, ant; + + for(cell=0; cell < XRAN_MAX_CELLS_PER_PORT; cell++) { + for(dir=0; dir < XRAN_DIR_MAX; dir++) { + for(ant=0; ant < XRAN_MAX_ANTENNA_NR; ant++) { + xran_cp_seq_id_num[cell][dir][ant] = 0; + } + } + } + + return (0); +} + +inline uint16_t xran_alloc_sectionid(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ant_id, uint8_t slot_id) +{ + if(cc_id >= XRAN_MAX_CELLS_PER_PORT) { + print_err("Invalid CC ID - %d", cc_id); + return (0); + } + if(ant_id >= XRAN_MAX_ANTENNA_NR) { + print_err("Invalid antenna ID - %d", ant_id); + return (0); + } + + /* if new slot has been started, + * then initializes section id again for new start */ + if(xran_section_id_curslot[cc_id][ant_id] != slot_id) { + xran_section_id[cc_id][ant_id] = 0; + xran_section_id_curslot[cc_id][ant_id] = slot_id; + } + + return(xran_section_id[cc_id][ant_id]++); +} + +inline uint8_t xran_get_seqid(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ant_id, uint8_t slot_id) +{ + if(dir >= XRAN_DIR_MAX) { + print_err("Invalid direction - %d", dir); + return (0); + } + if(cc_id >= XRAN_MAX_CELLS_PER_PORT) { + print_err("Invalid CC ID - %d", cc_id); + return (0); + } + if(ant_id >= XRAN_MAX_ANTENNA_NR) { + print_err("Invalid antenna ID - %d", ant_id); + return (0); + } + + return(xran_cp_seq_id_num[cc_id][dir][ant_id]++); +} + +inline int xran_update_seqid(void *pHandle, uint8_t dir, uint8_t cc_id, uint8_t ant_id, uint8_t slot_id, uint8_t seq_id) +{ + return (0); +} + +////////////////////////////////////////// +// For RU emulation +static struct xran_section_gen_info cpSections[255]; +static struct xran_cp_gen_params cpInfo; +int process_cplane(struct rte_mbuf *pkt) +{ + int xran_parse_cp_pkt(struct rte_mbuf *mbuf, struct xran_cp_gen_params *result); + + cpInfo.sections = cpSections; + xran_parse_cp_pkt(pkt, &cpInfo); + + return (0); +} +////////////////////////////////////////// + +void sym_ota_cb(struct rte_timer *tim, void *arg) +{ + uint8_t offset = 0; + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + struct xran_timer_ctx *pTCtx = (struct xran_timer_ctx *)arg; + long t1 = MLogTick(); + + if(XranGetSymNum(xran_lib_ota_sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT) == 0){ + tti_ota_cb(NULL, arg); + } + + if(XranGetSymNum(xran_lib_ota_sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT) == 1){ + if(p_xran_lib_ctx->phy_tti_cb_done == 0){ + uint64_t t3 = MLogTick(); + /* rearm timer to deliver TTI event to PHY */ + p_xran_lib_ctx->phy_tti_cb_done = 0; + xran_timer_arm_ex(&tti_to_phy_timer[xran_lib_ota_tti % 10], tti_to_phy_cb, (void*)pTCtx, p_xran_lib_ctx->xran_init_cfg.io_cfg.pkt_proc_core); + MLogTask(PID_TIME_ARM_TIMER, t3, MLogTick()); + } + } + + xran_process_tx_sym(timer_ctx); + /* check if there is call back to do something else on this symbol */ + if(p_xran_lib_ctx->pSymCallback[0][xran_lib_ota_sym]) + p_xran_lib_ctx->pSymCallback[0][xran_lib_ota_sym](&tx_cp_dl_timer, p_xran_lib_ctx->pSymCallbackTag[0][xran_lib_ota_sym]); + + xran_lib_ota_sym++; + if(xran_lib_ota_sym >= N_SYM_PER_SLOT){ + xran_lib_ota_sym=0; + } + MLogTask(PID_SYM_OTA_CB, t1, MLogTick()); +} + +void tti_ota_cb(struct rte_timer *tim, void *arg) +{ + uint32_t frame_id = 0; + uint32_t subframe_id = 0; + uint32_t slot_id = 0; + uint32_t next_tti = 0; + + uint32_t mlogVar[10]; + uint32_t mlogVarCnt = 0; + uint64_t t1 = MLogTick(); + uint64_t t3 = 0; + uint32_t reg_tti = 0; + struct xran_timer_ctx *pTCtx = (struct xran_timer_ctx *)arg; + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + + MLogTask(PID_TTI_TIMER, t1, MLogTick()); + + /* To match TTbox */ + if(xran_lib_ota_tti == 0) + reg_tti = 8000-1; + else + reg_tti = xran_lib_ota_tti -1; + MLogIncrementCounter(); + /* subframe and slot */ + MLogRegisterFrameSubframe(((reg_tti/SLOTNUM_PER_SUBFRAME) % SUBFRAMES_PER_SYSTEMFRAME), + reg_tti % (SLOTNUM_PER_SUBFRAME)); + MLogMark(1, t1); + + slot_id = XranGetSlotNum(xran_lib_ota_tti, SLOTNUM_PER_SUBFRAME); + subframe_id = XranGetSubFrameNum(xran_lib_ota_tti,SLOTNUM_PER_SUBFRAME, SUBFRAMES_PER_SYSTEMFRAME); + frame_id = XranGetFrameNum(xran_lib_ota_tti,SUBFRAMES_PER_SYSTEMFRAME, SLOTNUM_PER_SUBFRAME); + + pTCtx[(xran_lib_ota_tti & 1) ^ 1].tti_to_process = xran_lib_ota_tti; + + mlogVar[mlogVarCnt++] = 0x11111111; + mlogVar[mlogVarCnt++] = xran_lib_ota_tti; + mlogVar[mlogVarCnt++] = xran_lib_ota_sym_idx; + mlogVar[mlogVarCnt++] = xran_lib_ota_sym_idx / 14; + mlogVar[mlogVarCnt++] = frame_id; + mlogVar[mlogVarCnt++] = subframe_id; + mlogVar[mlogVarCnt++] = slot_id; + mlogVar[mlogVarCnt++] = 0; + MLogAddVariables(mlogVarCnt, mlogVar, MLogTick()); + + if(p_xran_lib_ctx->xran_init_cfg.io_cfg.id == ID_LLS_CU) + next_tti = xran_lib_ota_tti + 1; + else + next_tti = xran_lib_ota_tti; + + if(next_tti>= SLOTNUM_PER_SUBFRAME*1000){ + print_dbg("[%d]SFN %d sf %d slot %d\n",next_tti, frame_id, subframe_id, slot_id); + next_tti=0; + } + /* [0 - 7] */ + slot_id = XranGetSlotNum(next_tti, SLOTNUM_PER_SUBFRAME); + /* sf [0 - 9] */ + subframe_id = XranGetSubFrameNum(next_tti,SLOTNUM_PER_SUBFRAME, SUBFRAMES_PER_SYSTEMFRAME); + /* frame [0 - 99] for now */ + frame_id = XranGetFrameNum(next_tti,SUBFRAMES_PER_SYSTEMFRAME, SLOTNUM_PER_SUBFRAME); + + print_dbg("[%d]SFN %d sf %d slot %d\n",next_tti, frame_id, subframe_id, slot_id); + + if(p_xran_lib_ctx->xran_init_cfg.io_cfg.id == ID_LLS_CU){ + pTCtx[(xran_lib_ota_tti & 1)].tti_to_process = next_tti; + } else { + pTCtx[(xran_lib_ota_tti & 1)].tti_to_process = pTCtx[(xran_lib_ota_tti & 1)^1].tti_to_process; + } + + t3 = MLogTick(); + p_xran_lib_ctx->phy_tti_cb_done = 0; + xran_timer_arm_ex(&tti_to_phy_timer[xran_lib_ota_tti % 10], tti_to_phy_cb, (void*)pTCtx, p_xran_lib_ctx->xran_init_cfg.io_cfg.pkt_proc_core); + MLogTask(PID_TIME_ARM_TIMER, t3, MLogTick()); + + xran_lib_ota_tti++; + /* within 1 sec we have 8000 TTIs as 1000ms/0.125ms where TTI is 125us*/ + if(xran_lib_ota_tti >= SLOTNUM_PER_SUBFRAME*1000){ + print_dbg("[%d]SFN %d sf %d slot %d\n",xran_lib_ota_tti, frame_id, subframe_id, slot_id); + xran_lib_ota_tti=0; + } + MLogTask(PID_TTI_CB, t1, MLogTick()); +} + +void xran_timer_arm(struct rte_timer *tim, void* arg) +{ + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + if (xran_if_current_state == XRAN_RUNNING){ + rte_timer_cb_t fct = (rte_timer_cb_t)arg; + rte_timer_reset_sync(tim, 0, SINGLE, p_xran_lib_ctx->xran_init_cfg.io_cfg.pkt_proc_core, fct, timer_ctx); + } +} + +void xran_timer_arm_ex(struct rte_timer *tim, void* CbFct, void *CbArg, unsigned tim_lcore) +{ + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + if (xran_if_current_state == XRAN_RUNNING){ + rte_timer_cb_t fct = (rte_timer_cb_t)CbFct; + rte_timer_init(tim); + rte_timer_reset_sync(tim, 0, SINGLE, tim_lcore, fct, CbArg); + } +} + +void tx_cp_dl_cb(struct rte_timer *tim, void *arg) +{ + long t1 = MLogTick(); + int tti, sym; + uint32_t slot_id, subframe_id, frame_id; + int ant_id; + int32_t cc_id = 0; + uint16_t beam_id; + uint8_t num_eAxc, num_CCPorts; + void *pHandle; + + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + struct xran_timer_ctx *pTCtx = (struct xran_timer_ctx *)arg; + + + pHandle = NULL; // TODO: temp implemantation + num_eAxc = xran_get_num_eAxc(pHandle); + num_CCPorts = xran_get_num_cc(pHandle); + + if(p_xran_lib_ctx->enableCP) { + + tti = pTCtx[(xran_lib_ota_tti & 1) ^ 1].tti_to_process; + + slot_id = XranGetSlotNum(tti, SLOTNUM_PER_SUBFRAME); + subframe_id = XranGetSubFrameNum(tti,SLOTNUM_PER_SUBFRAME, SUBFRAMES_PER_SYSTEMFRAME); + frame_id = XranGetFrameNum(tti,SUBFRAMES_PER_SYSTEMFRAME, SLOTNUM_PER_SUBFRAME); + + print_dbg("[%d]SFN %d sf %d slot %d\n", tti, frame_id, subframe_id, slot_id); + + for(ant_id = 0; ant_id < num_eAxc; ++ant_id) { + for(cc_id = 0; cc_id < num_CCPorts; cc_id++ ) { + // start new section information list + xran_cp_reset_section_info(pHandle, XRAN_DIR_DL, cc_id, ant_id); + + beam_id = xran_get_beamid(pHandle, XRAN_DIR_DL, cc_id, ant_id, slot_id); + + send_cpmsg_dlul(pHandle, XRAN_DIR_DL, + frame_id, subframe_id, slot_id, + 0, N_SYM_PER_SLOT, NUM_OF_PRB_IN_FULL_BAND, + beam_id, cc_id, ant_id, + xran_get_seqid(pHandle, XRAN_DIR_DL, cc_id, ant_id, slot_id)); + } + } + } + MLogTask(PID_CP_DL_CB, t1, MLogTick()); +} + +void rx_ul_deadline_half_cb(struct rte_timer *tim, void *arg) +{ + long t1 = MLogTick(); + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + XranStatusInt32 status; + /* half of RX for current TTI as measured against current OTA time */ + int32_t rx_tti = (int32_t)XranGetTtiNum(xran_lib_ota_sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT); + + if(p_xran_lib_ctx->xran2phy_mem_ready == 0) + return; + + if(p_xran_lib_ctx->rx_packet_callback_tracker[rx_tti % XRAN_N_FE_BUF_LEN][0] == 0){ + status = (rx_tti << 16) | 0; /* base on PHY side implementation first 7 sym of slot */ + if(p_xran_lib_ctx->pCallback[0]) + p_xran_lib_ctx->pCallback[0](p_xran_lib_ctx->pCallbackTag[0], status); + } else { + p_xran_lib_ctx->rx_packet_callback_tracker[rx_tti % XRAN_N_FE_BUF_LEN][0] = 0; + } + MLogTask(PID_UP_UL_HALF_DEAD_LINE_CB, t1, MLogTick()); +} + +void rx_ul_deadline_full_cb(struct rte_timer *tim, void *arg) +{ + long t1 = MLogTick(); + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + XranStatusInt32 status; + int32_t rx_tti = (int32_t)XranGetTtiNum(xran_lib_ota_sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT); + + if(rx_tti >= 8000-1) + rx_tti = 0; + else + rx_tti -= 1; /* end of RX for prev TTI as measured against current OTA time */ + + if(p_xran_lib_ctx->xran2phy_mem_ready == 0) + return; + + if(p_xran_lib_ctx->rx_packet_callback_tracker[rx_tti % XRAN_N_FE_BUF_LEN][0] == 0){ + status = (rx_tti << 16) | 7; /* last 7 sym means full slot of Symb */ + if(p_xran_lib_ctx->pCallback[0]) + p_xran_lib_ctx->pCallback[0](p_xran_lib_ctx->pCallbackTag[0], status); + } else { + p_xran_lib_ctx->rx_packet_callback_tracker[rx_tti % XRAN_N_FE_BUF_LEN][0] = 0; + } + + MLogTask(PID_UP_UL_FULL_DEAD_LINE_CB, t1, MLogTick()); +} + + +void tx_cp_ul_cb(struct rte_timer *tim, void *arg) +{ + long t1 = MLogTick(); + int sym, tti; + uint32_t frame_id = 0; + uint32_t subframe_id = 0; + uint32_t slot_id = 0; + + int32_t cc_id; + int ant_id, prach_port_id; + uint16_t beam_id; + uint8_t num_eAxc, num_CCPorts; + + void *pHandle; + + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + xRANPrachCPConfigStruct *pPrachCPConfig = &(p_xran_lib_ctx->PrachCPConfig); + struct xran_timer_ctx *pTCtx = (struct xran_timer_ctx *)arg; + + pHandle = NULL; // TODO: temp implemantation + num_eAxc = xran_get_num_eAxc(pHandle); + num_CCPorts = xran_get_num_cc(pHandle); + + if (p_xran_lib_ctx->enableCP){ + tti = pTCtx[(xran_lib_ota_tti & 1) ^ 1].tti_to_process; + slot_id = XranGetSlotNum(tti, SLOTNUM_PER_SUBFRAME); + subframe_id = XranGetSubFrameNum(tti,SLOTNUM_PER_SUBFRAME, SUBFRAMES_PER_SYSTEMFRAME); + frame_id = XranGetFrameNum(tti,SUBFRAMES_PER_SYSTEMFRAME, SLOTNUM_PER_SUBFRAME); + print_dbg("[%d]SFN %d sf %d slot %d\n", tti, frame_id, subframe_id, slot_id); + + + for(ant_id = 0; ant_id < num_eAxc; ++ant_id) { + for(cc_id = 0; cc_id < num_CCPorts; cc_id++ ) { + // start new section information list + xran_cp_reset_section_info(pHandle, XRAN_DIR_UL, cc_id, ant_id); + + beam_id = xran_get_beamid(pHandle, XRAN_DIR_UL, cc_id, ant_id, slot_id); + send_cpmsg_dlul(pHandle, XRAN_DIR_UL, + frame_id, subframe_id, slot_id, + 0, N_SYM_PER_SLOT, NUM_OF_PRB_IN_FULL_BAND, + beam_id, cc_id, ant_id, + xran_get_seqid(pHandle, XRAN_DIR_UL, cc_id, ant_id, slot_id)); + } + } + + if ((frame_id % pPrachCPConfig->x == pPrachCPConfig->y[0]) && (pPrachCPConfig->isPRACHslot[slot_id]==1)) //is prach slot + { + for(ant_id = 0; ant_id < num_eAxc; ant_id++) { + for(cc_id = 0; cc_id < num_CCPorts; cc_id++) { +#if !defined(PRACH_USES_SHARED_PORT) + prach_port_id = ant_id + num_eAxc; + // start new section information list + xran_cp_reset_section_info(pHandle, XRAN_DIR_UL, cc_id, prach_port_id); +#else + prach_port_id = ant_id; +#endif + beam_id = xran_get_beamid(pHandle, XRAN_DIR_UL, cc_id, prach_port_id, slot_id); + send_cpmsg_prach(pHandle, + frame_id, subframe_id, slot_id, + beam_id, cc_id, prach_port_id, + xran_get_seqid(pHandle, XRAN_DIR_UL, cc_id, prach_port_id, slot_id)); + } + } + } + + } + MLogTask(PID_CP_UL_CB, t1, MLogTick()); +} + +void ul_up_full_slot_cb(struct rte_timer *tim, void *arg) +{ + long t1 = MLogTick(); + rte_pause(); + MLogTask(PID_TTI_CB_TO_PHY, t1, MLogTick()); +} + +void tti_to_phy_cb(struct rte_timer *tim, void *arg) +{ + long t1 = MLogTick(); + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + + static int first_call = 0; + p_xran_lib_ctx->phy_tti_cb_done = 1; /* DPDK called CB */ + if (first_call){ + if(p_xran_lib_ctx->ttiCb[XRAN_CB_TTI]){ + if(p_xran_lib_ctx->SkipTti[XRAN_CB_TTI] <= 0){ + p_xran_lib_ctx->ttiCb[XRAN_CB_TTI](p_xran_lib_ctx->TtiCbParam[XRAN_CB_TTI]); + }else{ + p_xran_lib_ctx->SkipTti[XRAN_CB_TTI]--; + } + } + } else { + if(p_xran_lib_ctx->ttiCb[XRAN_CB_TTI]){ + int32_t tti = (int32_t)XranGetTtiNum(xran_lib_ota_sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT); + if(tti == 8000-1) + first_call = 1; + } + } + + + MLogTask(PID_TTI_CB_TO_PHY, t1, MLogTick()); +} + +int xran_timing_source_thread(void *args) +{ + cpu_set_t cpuset; + int32_t do_reset = 0; + uint64_t t1 = 0; + uint64_t delta; + int32_t result1; + uint32_t delay_cp_dl; + uint32_t delay_cp_ul; + uint32_t delay_up; + uint32_t delay_up_ul; + uint32_t delay_cp2up; + uint32_t sym_cp_dl; + uint32_t sym_cp_ul; + uint32_t sym_up_ul; + int32_t sym_up; + struct sched_param sched_param; + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + + /* ToS = Top of Second start +- 1.5us */ + struct timespec ts; + + char buff[100]; + + printf("%s [CPU %2d] [PID: %6d]\n", __FUNCTION__, rte_lcore_id(), getpid()); + + /* set main thread affinity mask to CPU2 */ + sched_param.sched_priority = 98; + + CPU_ZERO(&cpuset); + CPU_SET(p_xran_lib_ctx->xran_init_cfg.io_cfg.timing_core, &cpuset); + if (result1 = pthread_setaffinity_np(pthread_self(), sizeof(cpu_set_t), &cpuset)) + { + printf("pthread_setaffinity_np failed: coreId = 2, result1 = %d\n",result1); + } + if ((result1 = pthread_setschedparam(pthread_self(), 1, &sched_param))) + { + printf("priority is not changed: coreId = 2, result1 = %d\n",result1); + } + + if (p_xran_lib_ctx->xran_init_cfg.io_cfg.id == APP_LLS_CU) { + do { + timespec_get(&ts, TIME_UTC); + }while (ts.tv_nsec >1500); + struct tm * ptm = gmtime(&ts.tv_sec); + if(ptm){ + strftime(buff, sizeof buff, "%D %T", ptm); + printf("lls-CU: thread_run start time: %s.%09ld UTC [%ld]\n", buff, ts.tv_nsec, interval_us); + } + + delay_cp_dl = p_xran_lib_ctx->xran_init_cfg.ttiPeriod - p_xran_lib_ctx->xran_init_cfg.T1a_max_cp_dl; + delay_cp_ul = p_xran_lib_ctx->xran_init_cfg.ttiPeriod - p_xran_lib_ctx->xran_init_cfg.T1a_max_cp_ul; + delay_up = p_xran_lib_ctx->xran_init_cfg.T1a_max_up; + delay_up_ul = p_xran_lib_ctx->xran_init_cfg.Ta4_max; + + delay_cp2up = delay_up-delay_cp_dl; + + sym_cp_dl = delay_cp_dl*1000/(interval_us*1000/N_SYM_PER_SLOT)+1; + sym_cp_ul = delay_cp_ul*1000/(interval_us*1000/N_SYM_PER_SLOT)+1; + sym_up_ul = delay_up_ul*1000/(interval_us*1000/N_SYM_PER_SLOT); + p_xran_lib_ctx->sym_up = sym_up = -(delay_up*1000/(interval_us*1000/N_SYM_PER_SLOT)+1); + p_xran_lib_ctx->sym_up_ul = sym_up_ul = (delay_up_ul*1000/(interval_us*1000/N_SYM_PER_SLOT)+1); + + printf("Start C-plane DL %d us after TTI [trigger on sym %d]\n", delay_cp_dl, sym_cp_dl); + printf("Start C-plane UL %d us after TTI [trigger on sym %d]\n", delay_cp_ul, sym_cp_ul); + printf("Start U-plane DL %d us before OTA [offset in sym %d]\n", delay_up, sym_up); + printf("Start U-plane UL %d us OTA [offset in sym %d]\n", delay_up_ul, sym_up_ul); + + printf("C-plane to U-plane delay %d us after TTI\n", delay_cp2up); + printf("Start Sym timer %ld ns\n", TX_TIMER_INTERVAL/N_SYM_PER_SLOT); + + p_xran_lib_ctx->pSymCallback[0][sym_cp_dl] = xran_timer_arm; + p_xran_lib_ctx->pSymCallbackTag[0][sym_cp_dl] = tx_cp_dl_cb; + + p_xran_lib_ctx->pSymCallback[0][sym_cp_ul] = xran_timer_arm; + p_xran_lib_ctx->pSymCallbackTag[0][sym_cp_ul] = tx_cp_ul_cb; + + /* Full slot UL OTA + delay_up_ul */ + p_xran_lib_ctx->pSymCallback[0][sym_up_ul] = xran_timer_arm; + p_xran_lib_ctx->pSymCallbackTag[0][sym_up_ul] = rx_ul_deadline_full_cb; + + /* Half slot UL OTA + delay_up_ul*/ + p_xran_lib_ctx->pSymCallback[0][sym_up_ul + N_SYM_PER_SLOT/2] = xran_timer_arm; + p_xran_lib_ctx->pSymCallbackTag[0][sym_up_ul + N_SYM_PER_SLOT/2] = rx_ul_deadline_half_cb; + + } else { // APP_RU + /* calcualte when to send UL U-plane */ + delay_up = p_xran_lib_ctx->xran_init_cfg.Ta3_min; + p_xran_lib_ctx->sym_up = sym_up = delay_up*1000/(interval_us*1000/N_SYM_PER_SLOT)+1; + printf("Start UL U-plane %d us after OTA [offset in sym %d]\n", delay_up, sym_up); + do { + timespec_get(&ts, TIME_UTC); + }while (ts.tv_nsec >1500); + struct tm * ptm = gmtime(&ts.tv_sec); + if(ptm){ + strftime(buff, sizeof buff, "%D %T", ptm); + printf("RU: thread_run start time: %s.%09ld UTC [%ld]\n", buff, ts.tv_nsec, interval_us); + } + } + + do { + timespec_get(&ts, TIME_UTC); + }while (ts.tv_nsec == 0); + + while(1) { + delta = poll_next_tick(interval_us*1000L/N_SYM_PER_SLOT); + if (XRAN_STOPPED == xran_if_current_state) + break; + sym_ota_cb(&sym_timer, timer_ctx); + } + printf("Closing timing source thread...\n"); + + return 0; +} + +/* Handle ecpri format. */ +int handle_ecpri_ethertype(struct rte_mbuf *pkt, uint64_t rx_time) +{ + const struct xran_ecpri_hdr *ecpri_hdr; + unsigned long t1; + + if (rte_pktmbuf_data_len(pkt) < sizeof(struct xran_ecpri_hdr)) { + wlog("Packet too short - %d bytes", rte_pktmbuf_data_len(pkt)); + return 0; + } + + /* check eCPRI header. */ + ecpri_hdr = rte_pktmbuf_mtod(pkt, struct xran_ecpri_hdr *); + if(ecpri_hdr == NULL) + return MBUF_FREE; + + switch(ecpri_hdr->ecpri_mesg_type) { + case ECPRI_IQ_DATA: + t1 = MLogTick(); + process_mbuf(pkt); + MLogTask(PID_PROCESS_UP_PKT, t1, MLogTick()); + break; + // For RU emulation + case ECPRI_RT_CONTROL_DATA: + t1 = MLogTick(); + if(xran_lib_get_ctx()->xran_init_cfg.io_cfg.id == APP_RU) { + process_cplane(pkt); + } else { + print_err("LLS-CU recevied CP message!"); + } + MLogTask(PID_PROCESS_CP_PKT, t1, MLogTick()); + break; + default: + wlog("Invalid eCPRI message type - %d", ecpri_hdr->ecpri_mesg_type); + } +#if 0 +//def DEBUG + return MBUF_KEEP; +#else + return MBUF_FREE; +#endif +} + +int xran_process_rx_sym(void *arg, + void *iq_data_start, + uint16_t size, + uint8_t CC_ID, + uint8_t Ant_ID, + uint8_t frame_id, + uint8_t subframe_id, + uint8_t slot_id, + uint8_t symb_id) +{ + char *pos = NULL; + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + uint32_t tti=0; + XranStatusInt32 status; + void *pHandle = NULL; + + if(p_xran_lib_ctx->xran2phy_mem_ready == 0) + return 0; + + tti = frame_id * SLOTS_PER_SYSTEMFRAME + subframe_id * SLOTNUM_PER_SUBFRAME + slot_id; + + status = tti << 16 | symb_id; + + if(tti < 8000 && CC_ID < XRAN_MAX_SECTOR_NR && CC_ID == 0 && Ant_ID < XRAN_MAX_ANTENNA_NR && symb_id < XRAN_NUM_OF_SYMBOL_PER_SLOT){ + pos = (char*) p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[tti % XRAN_N_FE_BUF_LEN][CC_ID][Ant_ID].sBufferList.pBuffers[symb_id].pData; + if(pos && iq_data_start && size){ +#ifdef XRAN_BYTE_ORDER_SWAP + int idx = 0; + uint16_t *restrict psrc = (uint16_t *)iq_data_start; + uint16_t *restrict pdst = (uint16_t *)pos; + /* network byte (be) order of IQ to CPU byte order (le) */ + for (idx = 0; idx < size/sizeof(int16_t); idx++){ + pdst[idx] = (psrc[idx]>>8) | (psrc[idx]<<8); //rte_be_to_cpu_16(psrc[idx]); + } +#else +#error xran spec is network byte order + /* for debug */ + rte_memcpy(pdst, psrc, size); +#endif +#ifdef DEBUG_XRAN_BUFFERS + if (pos[0] != tti % XRAN_N_FE_BUF_LEN || + pos[1] != CC_ID || + pos[2] != Ant_ID || + pos[3] != symb_id){ + printf("%d %d %d %d\n", pos[0], pos[1], pos[2], pos[3]); + } +#endif + } else { + print_err("pos %p iq_data_start %p size %d\n",pos, iq_data_start, size); + } + } else { + print_err("TTI %d(f_%d sf_%d slot_%d) CC %d Ant_ID %d symb_id %d\n",tti, frame_id, subframe_id, slot_id, CC_ID, Ant_ID, symb_id); + } + if (symb_id == 7 || symb_id == 13){ + p_xran_lib_ctx->rx_packet_symb_tracker[tti % XRAN_N_FE_BUF_LEN][CC_ID][symb_id]++; + + if(p_xran_lib_ctx->rx_packet_symb_tracker[tti % XRAN_N_FE_BUF_LEN][CC_ID][symb_id] >= xran_get_num_eAxc(pHandle)){ + if(p_xran_lib_ctx->pCallback[0]) + p_xran_lib_ctx->pCallback[0](p_xran_lib_ctx->pCallbackTag[0], status); + p_xran_lib_ctx->rx_packet_callback_tracker[tti % XRAN_N_FE_BUF_LEN][CC_ID] = 1; + p_xran_lib_ctx->rx_packet_symb_tracker[tti % XRAN_N_FE_BUF_LEN][CC_ID][symb_id] = 0; + } + } + return size; +} + + +int xran_process_tx_sym(void *arg) +{ + uint32_t tti=0; + uint32_t mlogVar[10]; + uint32_t mlogVarCnt = 0; + unsigned long t1 = MLogTick(); + + void *pHandle = NULL; + int32_t ant_id; + int32_t cc_id = 0; + uint8_t num_eAxc = 0; + uint8_t num_CCPorts = 0; + + uint32_t frame_id = 0; + uint32_t subframe_id = 0; + uint32_t slot_id = 0; + uint32_t sym_id = 0; + uint32_t sym_idx = 0; + + char *pos = NULL; + int prb_num = 0; + + struct xran_section_info *sectinfo; + uint32_t next; + + enum xran_pkt_dir direction; + + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + struct xran_timer_ctx *pTCtx = (struct xran_timer_ctx *)arg; + + + if(p_xran_lib_ctx->xran2phy_mem_ready == 0) + return 0; + + if(p_xran_lib_ctx->xran_init_cfg.io_cfg.id == APP_LLS_CU) { + direction = XRAN_DIR_DL; /* lls-CU */ + prb_num = NUM_OF_PRB_IN_FULL_BAND; + } + else { + direction = XRAN_DIR_UL; /* RU */ + prb_num = NUM_OF_PRB_IN_FULL_BAND; /*TODO: simulation on D-1541 @ 2.10GHz has issue with performace. reduce copy size */ + } + + /* RU: send symb after OTA time with delay (UL) */ + /* lls-CU:send symb in advance of OTA time (DL) */ + sym_idx = XranOffsetSym(p_xran_lib_ctx->sym_up, xran_lib_ota_sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT*SLOTNUM_PER_SUBFRAME*1000); + + tti = XranGetTtiNum(sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT); + slot_id = XranGetSlotNum(tti, SLOTNUM_PER_SUBFRAME); + subframe_id = XranGetSubFrameNum(tti,SLOTNUM_PER_SUBFRAME, SUBFRAMES_PER_SYSTEMFRAME); + frame_id = XranGetFrameNum(tti,SUBFRAMES_PER_SYSTEMFRAME, SLOTNUM_PER_SUBFRAME); + sym_id = XranGetSymNum(sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT); + + print_dbg("[%d]SFN %d sf %d slot %d\n", tti, frame_id, subframe_id, slot_id); + + mlogVar[mlogVarCnt++] = 0xAAAAAAAA; + mlogVar[mlogVarCnt++] = xran_lib_ota_sym_idx; + mlogVar[mlogVarCnt++] = sym_idx; + mlogVar[mlogVarCnt++] = abs(p_xran_lib_ctx->sym_up); + mlogVar[mlogVarCnt++] = tti; + mlogVar[mlogVarCnt++] = frame_id; + mlogVar[mlogVarCnt++] = subframe_id; + mlogVar[mlogVarCnt++] = slot_id; + mlogVar[mlogVarCnt++] = sym_id; + MLogAddVariables(mlogVarCnt, mlogVar, MLogTick()); + + if(frame_id > 99) { + print_err("OTA %d: TX:[sym_idx %d: TTI %d] fr %d sf %d slot %d sym %d\n",xran_lib_ota_sym_idx, sym_idx, tti, frame_id, subframe_id, slot_id, sym_id); + xran_if_current_state =XRAN_STOPPED; + } + + num_eAxc = xran_get_num_eAxc(pHandle); + num_CCPorts = xran_get_num_cc(pHandle); + + /* U-Plane */ + for(ant_id = 0; ant_id < num_eAxc; ant_id++) { + for(cc_id = 0; cc_id < num_CCPorts; cc_id++) { + if(p_xran_lib_ctx->xran_init_cfg.io_cfg.id == APP_LLS_CU && p_xran_lib_ctx->enableCP) { + next = 0; + while(next < xran_cp_getsize_section_info(pHandle, direction, cc_id, ant_id)) { + sectinfo = xran_cp_iterate_section_info(pHandle, direction, + cc_id, ant_id, subframe_id, slot_id, &next); + if(sectinfo == NULL) + break; + + /* pointer to IQs input */ + /* TODO: need to implement the case of partial RB assignment */ + pos = (char*) p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[tti % XRAN_N_FE_BUF_LEN][cc_id][ant_id].sBufferList.pBuffers[sym_id].pData; + print_dbg(">>> [%d] type%d, id %d, startPrbc=%d, numPrbc=%d, numSymbol=%d\n", next, + sectinfo->type, sectinfo->id, sectinfo->startPrbc, + sectinfo->numPrbc, sectinfo->numSymbol); + + if(sectinfo->type != XRAN_CP_SECTIONTYPE_1) { + print_err("Invalid section type in section DB - %d", sectinfo->type); + continue; + } + + send_symbol_ex(direction, sectinfo->id, + (struct rb_map *)pos, + frame_id, subframe_id, slot_id, sym_id, + sectinfo->startPrbc, sectinfo->numPrbc, + cc_id, ant_id, + xran_get_seqid(pHandle, direction, cc_id, ant_id, slot_id)); + } + } + + else { /* if(p_xran_lib_ctx->xran_init_cfg.io_cfg.id == APP_LLS_CU && p_xran_lib_ctx->enableCP) */ + /* pointer to IQs input */ + pos = (char*) p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[tti % XRAN_N_FE_BUF_LEN][cc_id][ant_id].sBufferList.pBuffers[sym_id].pData; +#ifdef DEBUG_XRAN_BUFFERS + if (pos[0] != tti % XRAN_N_FE_BUF_LEN || + pos[1] != cc_id || + pos[2] != ant_id || + pos[3] != sym_id) + printf("%d %d %d %d\n", pos[0], pos[1], pos[2], pos[3]); +#endif + send_symbol_ex(direction, + xran_alloc_sectionid(pHandle, direction, cc_id, ant_id, slot_id), + (struct rb_map *)pos, + frame_id, subframe_id, slot_id, sym_id, + 0, prb_num, + cc_id, ant_id, + xran_get_seqid(pHandle, direction, cc_id, ant_id, slot_id)); + } + } + } + + MLogTask(PID_PROCESS_TX_SYM, t1, MLogTick()); + return 0; +} + +int xran_packet_and_dpdk_timer_thread(void *args) +{ + struct xran_ethdi_ctx *const ctx = xran_ethdi_get_ctx(); + + uint64_t prev_tsc = 0; + uint64_t cur_tsc = rte_rdtsc(); + uint64_t diff_tsc = cur_tsc - prev_tsc; + cpu_set_t cpuset; + struct sched_param sched_param; + int res = 0; + printf("%s [CPU %2d] [PID: %6d]\n", __FUNCTION__, rte_lcore_id(), getpid()); + + sched_param.sched_priority = XRAN_THREAD_DEFAULT_PRIO; + + if ((res = pthread_setschedparam(pthread_self(), 1, &sched_param))) + { + printf("priority is not changed: coreId = %d, result1 = %d\n",rte_lcore_id(), res); + } + + while(1){ + + cur_tsc = rte_rdtsc(); + diff_tsc = cur_tsc - prev_tsc; + if (diff_tsc > TIMER_RESOLUTION_CYCLES) { + rte_timer_manage(); + prev_tsc = cur_tsc; + } + + if (XRAN_STOPPED == xran_if_current_state) + break; + } + + printf("Closing pkts timer thread...\n"); + return 0; +} + + +int32_t xran_init(int argc, char *argv[], PXRANFHINIT p_xran_fh_init, char *appName, void ** pHandle) +{ + int i; + int j; + + struct xran_io_loop_cfg *p_io_cfg = (struct xran_io_loop_cfg *)&p_xran_fh_init->io_cfg; + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + + int lcore_id = 0; + char filename[64]; + + memset(p_xran_lib_ctx, 0, sizeof(struct xran_lib_ctx)); + /* copy init */ + p_xran_lib_ctx->xran_init_cfg = *p_xran_fh_init; + + xran_if_current_state = XRAN_RUNNING; + interval_us = p_xran_fh_init->ttiPeriod; + + p_xran_lib_ctx->llscu_id = p_xran_fh_init->llscuId; + memcpy(&(p_xran_lib_ctx->eAxc_id_cfg), &(p_xran_fh_init->eAxCId_conf), sizeof(XRANEAXCIDCONFIG)); + + p_xran_lib_ctx->enableCP = p_xran_fh_init->enableCP; + + xran_register_ethertype_handler(ETHER_TYPE_ECPRI, handle_ecpri_ethertype); + if (p_io_cfg->id == 0) + xran_ethdi_init_dpdk_io(basename(appName), + p_io_cfg, + &lcore_id, + (struct ether_addr *)p_xran_fh_init->p_lls_cu_addr, + (struct ether_addr *)p_xran_fh_init->p_ru_addr, + p_xran_fh_init->cp_vlan_tag, + p_xran_fh_init->up_vlan_tag); + else + xran_ethdi_init_dpdk_io(basename(appName), + p_io_cfg, + &lcore_id, + (struct ether_addr *)p_xran_fh_init->p_ru_addr, + (struct ether_addr *)p_xran_fh_init->p_lls_cu_addr, + p_xran_fh_init->cp_vlan_tag, + p_xran_fh_init->up_vlan_tag); + + for(i = 0; i < 10; i++ ) + rte_timer_init(&tti_to_phy_timer[i]); + + rte_timer_init(&tti_timer); + rte_timer_init(&sym_timer); + rte_timer_init(&tx_cp_dl_timer); + rte_timer_init(&tx_cp_ul_timer); + rte_timer_init(&tx_up_timer); + + for(i = 0; i < XRAN_MAX_SECTOR_NR; i++ ){ + unsigned n = snprintf(&p_xran_lib_ctx->ring_name[0][i][0], RTE_RING_NAMESIZE, "dl_sym_ring_%u", i); + p_xran_lib_ctx->dl_sym_idx_ring[i] = rte_ring_create(&p_xran_lib_ctx->ring_name[0][i][0], XRAN_RING_SIZE, + rte_lcore_to_socket_id(lcore_id), RING_F_SP_ENQ | RING_F_SC_DEQ); + } + + + lcore_id = rte_get_next_lcore(lcore_id, 0, 0); + PANIC_ON(lcore_id == RTE_MAX_LCORE, "out of lcores for io_loop()"); + + /* Start packet processing thread */ + if (rte_eal_remote_launch(ring_processing_thread, NULL, lcore_id)) + rte_panic("ring_processing_thread() failed to start\n"); + + if(p_io_cfg->pkt_aux_core > 0){ + lcore_id = rte_get_next_lcore(lcore_id, 0, 0); + PANIC_ON(lcore_id == RTE_MAX_LCORE, "out of lcores for io_loop()"); + + /* Start packet processing thread */ + if (rte_eal_remote_launch(xran_packet_and_dpdk_timer_thread, NULL, lcore_id)) + rte_panic("ring_processing_thread() failed to start\n"); + } + + lcore_id = rte_get_next_lcore(lcore_id, 0, 0); + PANIC_ON(lcore_id == RTE_MAX_LCORE, "out of lcores for io_loop()"); + + /* Start packet processing thread */ + if (rte_eal_remote_launch(xran_timing_source_thread, xran_lib_get_ctx(), lcore_id)) + rte_panic("thread_run() failed to start\n"); + + printf("Set debug stop %d\n", p_xran_fh_init->debugStop); + timing_set_debug_stop(p_xran_fh_init->debugStop); + + memset(&DevHandle, 0, sizeof(XranLibHandleInfoStruct)); + + *pHandle = &DevHandle; + + return 0; +} + +int32_t xran_sector_get_instances (void * pHandle, uint16_t nNumInstances, + XranCcInstanceHandleVoidP * pSectorInstanceHandles) +{ + int i; + + /* only one handle as only one CC is currently supported */ + for(i = 0; i < nNumInstances; i++ ) + pSectorInstanceHandles[i] = pHandle; + + return 0; +} + +int32_t xran_mm_init (void * pHandle, uint64_t nMemorySize, + uint32_t nMemorySegmentSize) +{ + /* we use mbuf from dpdk memory */ + return 0; +} + +int32_t xran_bm_init (void * pHandle, uint32_t * pPoolIndex, uint32_t nNumberOfBuffers, uint32_t nBufferSize) +{ + XranLibHandleInfoStruct* pXran = (XranLibHandleInfoStruct*) pHandle; + + char pool_name[RTE_MEMPOOL_NAMESIZE]; + + snprintf(pool_name, RTE_MEMPOOL_NAMESIZE, "bm_mempool_%ld", pPoolIndex); + + pXran->p_bufferPool[pXran->nBufferPoolIndex] = rte_pktmbuf_pool_create(pool_name, nNumberOfBuffers, + MBUF_CACHE, 0, XRAN_MAX_MBUF_LEN, rte_socket_id()); + + pXran->bufferPoolElmSz[pXran->nBufferPoolIndex] = nBufferSize; + pXran->bufferPoolNumElm[pXran->nBufferPoolIndex] = nNumberOfBuffers; + + print_dbg("[nPoolIndex %d] mb pool %p \n", pXran->nBufferPoolIndex, pXran->p_bufferPool[pXran->nBufferPoolIndex]); + + *pPoolIndex = pXran->nBufferPoolIndex++; + + return 0; +} + +int32_t xran_bm_allocate_buffer(void * pHandle, uint32_t nPoolIndex, void **ppVirtAddr) +{ + XranLibHandleInfoStruct* pXran = (XranLibHandleInfoStruct*) pHandle; + *ppVirtAddr = NULL; + + struct rte_mbuf * mb = rte_pktmbuf_alloc(pXran->p_bufferPool[nPoolIndex]); + + if(mb){ + *ppVirtAddr = rte_pktmbuf_append(mb, pXran->bufferPoolElmSz[nPoolIndex]); + + }else { + print_err("[nPoolIndex %d] mb alloc failed \n", nPoolIndex ); + return -1; + } + + if (*ppVirtAddr == NULL){ + print_err("[nPoolIndex %d] rte_pktmbuf_append for %d failed \n", nPoolIndex, pXran->bufferPoolElmSz[nPoolIndex]); + return -1; + } + + return 0; +} + +int32_t xran_bm_free_buffer(void * pHandle, void *pVirtAddr) +{ + XranLibHandleInfoStruct* pXran = (XranLibHandleInfoStruct*) pHandle; + rte_pktmbuf_free(pVirtAddr); + + return 0; +} + +int32_t xran_5g_fronthault_config (void * pHandle, + XRANBufferListStruct *pSrcBuffer[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN], + XRANBufferListStruct *pDstBuffer[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN], + XranTransportBlockCallbackFn pCallback, + void *pCallbackTag) +{ + XranLibHandleInfoStruct *pInfo = (XranLibHandleInfoStruct *) pHandle; + XranStatusInt32 nStatus = XRAN_STATUS_SUCCESS; + int j, i = 0, z, k; + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + + print_dbg("%s\n", __FUNCTION__); + + if(NULL == pHandle) + { + printf("Handle is NULL!\n"); + return XRAN_STATUS_FAIL; + } + if (pCallback == NULL) + { + printf ("no callback\n"); + return XRAN_STATUS_FAIL; + } + + for(j=0; jsFrontHaulTxBbuIoBufCtrl[j][i][z].bValid = 0; + p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[j][i][z].nSegGenerated = -1; + p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[j][i][z].nSegToBeGen = -1; + p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[j][i][z].nSegTransferred = 0; + p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.nNumBuffers = XRAN_NUM_OF_SYMBOL_PER_SLOT; + p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers = &p_xran_lib_ctx->sFrontHaulTxBuffers[j][i][z][0]; + + p_xran_lib_ctx->sFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList = *pSrcBuffer[z][j]; + + p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[j][i][z].bValid = 0; + p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[j][i][z].nSegGenerated = -1; + p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[j][i][z].nSegToBeGen = -1; + p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[j][i][z].nSegTransferred = 0; + p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.nNumBuffers = XRAN_NUM_OF_SYMBOL_PER_SLOT; + p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers = &p_xran_lib_ctx->sFrontHaulRxBuffers[j][i][z][0]; + p_xran_lib_ctx->sFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList = *pDstBuffer[z][j]; + } + } + +#if 0 + for(j=0; jsFrontHaulTxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].pData; + printf(" sym: %2d %p 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x\n", k, ptr, ptr[0],ptr[1], ptr[2], ptr[3], ptr[4]); + } + } + + for(j=0; jsFrontHaulRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers[k].pData; + printf(" sym: %2d %p 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x\n", k, ptr, ptr[0],ptr[1], ptr[2], ptr[3], ptr[4]); + } + } +#endif + + p_xran_lib_ctx->pCallback[i] = pCallback; + p_xran_lib_ctx->pCallbackTag[i] = pCallbackTag; + + p_xran_lib_ctx->xran2phy_mem_ready = 1; + + return nStatus; +} + +int32_t xran_5g_prach_req (void * pHandle, + XRANBufferListStruct *pDstBuffer[XRAN_MAX_ANTENNA_NR][XRAN_N_FE_BUF_LEN], + XranTransportBlockCallbackFn pCallback, + void *pCallbackTag) +{ + XranLibHandleInfoStruct *pInfo = (XranLibHandleInfoStruct *) pHandle; + XranStatusInt32 nStatus = XRAN_STATUS_SUCCESS; + int j, i = 0, z; + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + + if(NULL == pHandle) + { + printf("Handle is NULL!\n"); + return XRAN_STATUS_FAIL; + } + if (pCallback == NULL) + { + printf ("no callback\n"); + return XRAN_STATUS_FAIL; + } + + for(j=0; jsFHPrachRxBbuIoBufCtrl[j][i][z].bValid = 0; + p_xran_lib_ctx->sFHPrachRxBbuIoBufCtrl[j][i][z].nSegGenerated = -1; + p_xran_lib_ctx->sFHPrachRxBbuIoBufCtrl[j][i][z].nSegToBeGen = -1; + p_xran_lib_ctx->sFHPrachRxBbuIoBufCtrl[j][i][z].nSegTransferred = 0; + p_xran_lib_ctx->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.nNumBuffers = XRAN_MAX_ANTENNA_NR; // ant number. + p_xran_lib_ctx->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList.pBuffers = &p_xran_lib_ctx->sFHPrachRxBuffers[j][i][z][0]; + p_xran_lib_ctx->sFHPrachRxBbuIoBufCtrl[j][i][z].sBufferList = *pDstBuffer[z][j]; + } + } + + p_xran_lib_ctx->pPrachCallback[i] = pCallback; + p_xran_lib_ctx->pPrachCallbackTag[i] = pCallbackTag; + + return 0; +} + +int32_t xran_5g_pre_compenstor_cfg(void* pHandle, + uint32_t nTxPhaseCps, + uint32_t nRxPhaseCps, + uint8_t nSectorId) +{ + /* functionality is not yet implemented */ + return 0; +} + +int32_t xran_open(void *pHandle, PXRANFHCONFIG pConf) +{ + int i; + uint8_t slotNr; + XRANFHCONFIG *pFhCfg; + xRANPrachCPConfigStruct *pPrachCPConfig = &(xran_lib_get_ctx()->PrachCPConfig); + pFhCfg = &(xran_lib_get_ctx()->xran_fh_cfg); + memcpy(pFhCfg, pConf, sizeof(XRANFHCONFIG)); + PXRANPRACHCONFIG pPRACHConfig = &pFhCfg->prach_conf; + uint8_t nPrachConfIdx = pPRACHConfig->nPrachConfIdx; + const xRANPrachConfigTableStruct *pxRANPrachConfigTable = &gxranPrachDataTable_mmw[nPrachConfIdx]; + uint8_t preambleFmrt = pxRANPrachConfigTable->preambleFmrt[0]; + const xRANPrachPreambleLRAStruct *pxranPreambleforLRA = &gxranPreambleforLRA[preambleFmrt - FORMAT_A1]; + memset(pPrachCPConfig, 0, sizeof(xRANPrachCPConfigStruct)); + + //setup PRACH configuration for C-Plane + pPrachCPConfig->filterIdx = XRAN_FILTERINDEX_PRACH_ABC; // 3, PRACH preamble format A1~3, B1~4, C0, C2 + pPrachCPConfig->startSymId = pxRANPrachConfigTable->startingSym; + pPrachCPConfig->startPrbc = pPRACHConfig->nPrachFreqStart; + pPrachCPConfig->numPrbc = (preambleFmrt >= FORMAT_A1)? 12 : 70; + pPrachCPConfig->numSymbol = pxRANPrachConfigTable->duration; + pPrachCPConfig->timeOffset = pxranPreambleforLRA->nRaCp; + pPrachCPConfig->freqOffset = xran_get_freqoffset(pPRACHConfig->nPrachFreqOffset, pPRACHConfig->nPrachSubcSpacing); + pPrachCPConfig->occassionsInPrachSlot = pxRANPrachConfigTable->occassionsInPrachSlot; + pPrachCPConfig->x = pxRANPrachConfigTable->x; + pPrachCPConfig->y[0] = pxRANPrachConfigTable->y[0]; + pPrachCPConfig->y[1] = pxRANPrachConfigTable->y[1]; + + pPrachCPConfig->isPRACHslot[pxRANPrachConfigTable->slotNr[0]] = 1; + for (i=1; i < XRAN_PRACH_CANDIDATE_SLOT; i++) + { + slotNr = pxRANPrachConfigTable->slotNr[i]; + if (slotNr > 0) + pPrachCPConfig->isPRACHslot[slotNr] = 1; + } + + xran_cp_init_sectiondb(pHandle); + xran_init_sectionid(pHandle); + xran_init_seqid(pHandle); + + return 0; +} + +int32_t xran_start(void *pHandle) +{ + xran_if_current_state = XRAN_RUNNING; + return 0; +} + +int32_t xran_stop(void *pHandle) +{ + xran_if_current_state = XRAN_STOPPED; + return 0; +} + +int32_t xran_close(void *pHandle) +{ + xran_if_current_state = XRAN_STOPPED; + xran_cp_free_sectiondb(pHandle); + rte_eal_mp_wait_lcore(); + return 0; +} + +int32_t xran_mm_destroy (void * pHandle) +{ + /* functionality is not yet implemented */ + return -1; +} + +int32_t xran_reg_sym_cb(void *pHandle, XRANFHSYMPROCCB symCb, void * symCbParam, uint8_t symb, uint8_t ant) +{ + /* functionality is not yet implemented */ + return -1; +} + +int32_t xran_reg_physide_cb(void *pHandle, XRANFHTTIPROCCB Cb, void *cbParam, int skipTtiNum, enum callback_to_phy_id id) +{ + struct xran_lib_ctx * p_xran_lib_ctx = xran_lib_get_ctx(); + + p_xran_lib_ctx->ttiCb[id] = Cb; + p_xran_lib_ctx->TtiCbParam[id] = cbParam; + p_xran_lib_ctx->SkipTti[id] = skipTtiNum; + + return 0; +} + +int32_t xran_get_slot_idx (uint32_t *nFrameIdx, uint32_t *nSubframeIdx, uint32_t *nSlotIdx, uint64_t *nSecond) +{ + int32_t tti = 0; + + tti = (int32_t)XranGetTtiNum(xran_lib_ota_sym_idx, XRAN_NUM_OF_SYMBOL_PER_SLOT); + *nSlotIdx = (uint32_t)XranGetSlotNum(tti, SLOTNUM_PER_SUBFRAME); + *nSubframeIdx = (uint32_t)XranGetSubFrameNum(tti,SLOTNUM_PER_SUBFRAME, SUBFRAMES_PER_SYSTEMFRAME); + *nFrameIdx = (uint32_t)XranGetFrameNum(tti,SUBFRAMES_PER_SYSTEMFRAME, SLOTNUM_PER_SUBFRAME); + *nSecond = timing_get_current_second(); + + return tti; +} + +/** + * @brief Get supported maximum number of sections + * + * @return maximum number of sections + */ +inline uint8_t xran_get_max_sections(void *pHandle) +{ + return (XRAN_MAX_NUM_SECTIONS); +} + +/** + * @brief Get the configuration of eAxC ID + * + * @return the pointer of configuration + */ +inline XRANEAXCIDCONFIG *xran_get_conf_eAxC(void *pHandle) +{ + return (&(xran_lib_get_ctx()->eAxc_id_cfg)); +} + +/** + * @brief Get the configuration of subcarrier spacing for PRACH + * + * @return subcarrier spacing value for PRACH + */ +inline uint8_t xran_get_conf_prach_scs(void *pHandle) +{ + return (xran_lib_get_ctx_fhcfg()->prach_conf.nPrachSubcSpacing); +} + +/** + * @brief Get the configuration of FFT size for RU + * + * @return FFT size value for RU + */ +inline uint8_t xran_get_conf_fftsize(void *pHandle) +{ + return (xran_lib_get_ctx_fhcfg()->ru_conf.fftSize); +} + +/** + * @brief Get the configuration of nummerology + * + * @return subcarrier spacing value for PRACH + */ +inline uint8_t xran_get_conf_numerology(void *pHandle) +{ + return (xran_lib_get_ctx_fhcfg()->frame_conf.nNumerology); +} + +/** + * @brief Get the configuration of IQ bit width for RU + * + * @return IQ bit width for RU + */ +inline uint8_t xran_get_conf_iqwidth(void *pHandle) +{ + XRANFHCONFIG *pFhCfg; + + pFhCfg = xran_lib_get_ctx_fhcfg(); + return ((pFhCfg->ru_conf.iqWidth==16)?0:pFhCfg->ru_conf.iqWidth); +} + +/** + * @brief Get the configuration of compression method for RU + * + * @return Compression method for RU + */ +inline uint8_t xran_get_conf_compmethod(void *pHandle) +{ + return (xran_lib_get_ctx_fhcfg()->ru_conf.compMeth); +} + +/** + * @brief Get the configuration of lls-cu ID + * + * @return Configured lls-cu ID + */ +inline uint8_t xran_get_llscuid(void *pHandle) +{ + return (xran_lib_get_ctx()->llscu_id); +} + +/** + * @brief Get the configuration of lls-cu ID + * + * @return Configured lls-cu ID + */ +inline uint8_t xran_get_sectorid(void *pHandle) +{ + return (xran_lib_get_ctx()->sector_id); +} + +/** + * @brief Get the configuration of the number of component carriers + * + * @return Configured the number of componen carriers + */ +inline uint8_t xran_get_num_cc(void *pHandle) +{ + return (xran_lib_get_ctx_fhcfg()->nCC); +} + +/** + * @brief Get the configuration of the number of antenna + * + * @return Configured the number of antenna + */ +inline uint8_t xran_get_num_eAxc(void *pHandle) +{ + return (xran_lib_get_ctx_fhcfg()->neAxc); +} + + diff --git a/fhi_lib/lib/src/xran_printf.h b/fhi_lib/lib/src/xran_printf.h new file mode 100644 index 0000000..6caee87 --- /dev/null +++ b/fhi_lib/lib/src/xran_printf.h @@ -0,0 +1,110 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief Modules provide debug prints and utility functions + * @file xran_printf.h + * @ingroup group_source_xran + * @author Intel Corporation + **/ + +#ifndef XRAN_PRINTF_H +#define XRAN_PRINTF_H + +#ifdef __cplusplus +extern "C" { +#endif +#include +#include + +#define PRINTF_LOG_OK +#define PRINTF_INF_OK +#define PRINTF_ERR_OK +//#define PRINTF_DBG_OK + +#ifndef WIN32 +#ifdef PRINTF_LOG_OK +#define print_log(fmt, args...) printf("%s:" fmt "\n", __FUNCTION__, ## args) +#else /* PRINTF_LOG_OK */ +#define print_log(fmt, args...) +#endif /* PRINTF_LOG_OK */ +#else +#define print_log(fmt, ...) printf("%s:" fmt "\n", __FUNCTION__, __VA_ARGS__) +#endif + +#ifndef WIN32 +#ifdef PRINTF_DBG_OK +#define print_dbg(fmt, args...) printf("%s:[dbg] " fmt "\n", __FUNCTION__, ## args) +#else /* PRINTF_LOG_OK */ +#define print_dbg(fmt, args...) +#endif /* PRINTF_LOG_OK */ +#else +#define print_dbg(fmt, ...) printf("%s:[dbg] " fmt "\n", __FUNCTION__, __VA_ARGS__) +#endif + +#ifndef WIN32 +#ifdef PRINTF_ERR_OK +#define print_err(fmt, args...) printf("%s:[err] " fmt "\n", __FUNCTION__, ## args) +#else /* PRINTF_LOG_OK */ +#define print_err(fmt, args...) +#endif /* PRINTF_LOG_OK */ +#else +#define print_err(fmt, ...) printf("%s:[err] " fmt "\n", __FUNCTION__, __VA_ARGS__) +#endif + +#ifndef WIN32 +#ifdef PRINTF_INF_OK +#define print_inf printf +#else /* PRINTF_LOG_OK */ +#define print_inf +#endif /* PRINTF_LOG_OK */ +#else +#define print_inf printf +#endif + +#ifdef __cplusplus +} +#endif + +#ifndef _IASSERT_ +#define _IASSERT_ + +#ifdef _DEBUG +#define iAssert(p) if(!(p)){fprintf(stderr,\ + "Assertion failed: %s, file %s, line %d, val %d\n",\ + #p, __FILE__, __LINE__, p);exit(-1);} +#else /* _DEBUG */ +#define iAssert(p) +#endif /* _DEBUG */ + +#ifndef PHY_APP +#ifndef _assert +#define _assert(x) +#endif +#endif + +#endif /* _IASSERT_*/ + + + +#ifdef __cplusplus +} +#endif + +#endif // PHY_PRINTF_H diff --git a/fhi_lib/lib/src/xran_sync_api.c b/fhi_lib/lib/src/xran_sync_api.c new file mode 100644 index 0000000..e030a86 --- /dev/null +++ b/fhi_lib/lib/src/xran_sync_api.c @@ -0,0 +1,132 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + +/** + * @brief This file provides implementation of synchronization related APIs (PTP/1588) + * for XRAN. + * + * @file xran_sync_api.c + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "xran_sync_api.h" +#include "xran_printf.h" + +#define BUF_LEN 256 +#define PROC_DIR "/proc" +#define COMM_FILE "comm" +#define PMC_CMD "pmc -u -b 0 'GET PORT_DATA_SET'" +#define PTP4L_PROC_NAME "ptp4l" +#define PHC2SYS_PROC_NAME "phc2sys" + +static int find_substr(const char *str, const unsigned int str_len, + const char *substr, const unsigned int substr_len) +{ + assert(str); + assert(substr); + unsigned int ind = 0; + + while (ind + substr_len <= str_len) { + if (0 == strncmp(&str[ind], substr, substr_len)) + return 0; + ++ind; + } + return 1; +} + +static int is_process_running(char *pname) +{ + char full_path[BUF_LEN] = {0}; + char read_proc_name[BUF_LEN] = {0}; + int res = 1; + int null = 0; + int dir_fd = dirfd((DIR*)PROC_DIR); + DIR *dir = fdopendir(dir_fd); + if (NULL == dir) { + return 1; + } + + struct dirent *entry = NULL; + while ((entry = readdir(dir))) { + long pid = atol(entry->d_name); + if (0 == pid) + continue; + + snprintf(full_path, BUF_LEN,"%s/%ld/%s", PROC_DIR, pid, COMM_FILE); + int proc_name_file = open(full_path, O_RDONLY); + if (null == proc_name_file) + continue; + fgets( read_proc_name, BUF_LEN, (FILE*)proc_name_file); + if (0 == strncmp(read_proc_name, pname, strlen(pname))) { + res = 0; + close(proc_name_file); + break; + } + close(proc_name_file); + } + closedir(dir); + return res; +} + +static int check_ptp_status() +{ + char pmc_out_line[BUF_LEN]; + const char *keywords[2] = {"portState", "SLAVE"}; + int res = 1; + FILE *pmc_pipe = popen(PMC_CMD, "r"); + if (NULL == pmc_pipe) + return 1; + + while(fgets(pmc_out_line, BUF_LEN, pmc_pipe)) { + if (0 == find_substr(pmc_out_line, strlen(pmc_out_line), keywords[0], + strlen(keywords[0]))) { + if (0 == find_substr(pmc_out_line, strlen(pmc_out_line), + keywords[1], strlen(keywords[1]))) { + res = 0; + break; + } + } + } + fclose(pmc_pipe); + return res; +} + +int xran_is_synchronized() +{ + int res = 0; + res |= is_process_running(PTP4L_PROC_NAME); + print_dbg("PTP4L_PROC_NAME %d\n", res); + res |= is_process_running(PHC2SYS_PROC_NAME); + print_dbg("PHC2SYS_PROC_NAME %d\n", res); + res |= check_ptp_status(); + print_dbg("check_ptp_status %d\n", res); + return res; +} diff --git a/fhi_lib/lib/src/xran_timer.c b/fhi_lib/lib/src/xran_timer.c new file mode 100644 index 0000000..875b0b6 --- /dev/null +++ b/fhi_lib/lib/src/xran_timer.c @@ -0,0 +1,185 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides implementation to Timing for XRAN. + * + * @file xran_timer.c + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#include +#include +#include +#include + +#include "xran_timer.h" +#include "xran_printf.h" +#ifndef MLOG_ENABLED +#include "mlog_lnx_xRAN.h" +#else +#include "mlog_lnx.h" +#endif +#include "xran_lib_mlog_tasks_id.h" +#include "ethdi.h" + +#define NSEC_PER_SEC 1000000000L +#define NSEC_PER_USEC 1000L +#define THRESHOLD 35 /**< the avg cost of clock_gettime() in ns */ +#define TIMECOMPENSATION 2 /**< time compensation in us, avg latency of clock_nanosleep */ + +#define SEC_MOD_STOP (30) + +static struct timespec started_time; +static struct timespec last_time; +static struct timespec cur_time; + +static struct timespec* p_cur_time = &cur_time; +static struct timespec* p_last_time = &last_time; + +static struct timespec* p_temp_time; + +static unsigned long current_second = 0; +static unsigned long started_second = 0; +extern uint32_t xran_lib_ota_sym; +extern uint32_t xran_lib_ota_tti; +extern uint32_t xran_lib_ota_sym_idx; + +static int debugStop = 0; + +uint64_t timing_get_current_second(void) +{ + return current_second; +} + +int timing_set_debug_stop(int value) +{ + debugStop = value; + + if(debugStop){ + clock_gettime(CLOCK_REALTIME, &started_time); + started_second =started_time.tv_sec; + } + return debugStop; +} + +int timing_get_debug_stop(void) +{ + return debugStop; +} + +long poll_next_tick(long interval_ns) +{ + long target_time; + long delta; + static int counter = 0; + static long sym_acc = 0; + static long sym_cnt = 0; + + if(counter){ + clock_gettime(CLOCK_REALTIME, p_last_time); + current_second = p_last_time->tv_sec; + counter = 1; + } + + target_time = (p_last_time->tv_sec * NSEC_PER_SEC + p_last_time->tv_nsec + interval_ns); + + while(1) + { + clock_gettime(CLOCK_REALTIME, p_cur_time); + delta = (p_cur_time->tv_sec * NSEC_PER_SEC + p_cur_time->tv_nsec) - target_time; + if(delta > 0 || (delta < 0 && abs(delta) < THRESHOLD)) { + if(current_second != p_cur_time->tv_sec){ + current_second = p_cur_time->tv_sec; + xran_lib_ota_sym_idx = 0; + xran_lib_ota_tti = 0; + xran_lib_ota_sym = 0; + sym_cnt = 0; + sym_acc = 0; + print_dbg("ToS:C Sync timestamp: [%ld.%09ld]\n", p_cur_time->tv_sec, p_cur_time->tv_nsec); + if(debugStop){ + if(p_cur_time->tv_sec > started_second && ((p_cur_time->tv_sec % SEC_MOD_STOP) == 0)){ + uint64_t t1; + printf("STOP:[%ld.%09ld]\n", p_cur_time->tv_sec, p_cur_time->tv_nsec); + t1 = MLogTick(); + rte_pause(); + MLogTask(PID_TIME_SYSTIME_STOP, t1, MLogTick()); + xran_if_current_state = XRAN_STOPPED; + } + } + p_cur_time->tv_nsec = 0; // adjust to 1pps + } else { + xran_lib_ota_sym_idx = XranIncrementSymIdx(xran_lib_ota_sym_idx, 14*8); + /* adjust to sym boundary */ + if(sym_cnt & 1) + sym_acc += 8928L; + else + sym_acc += 8929L; + /* fine tune to second boundary */ + if(sym_cnt % 13 == 0) + sym_acc += 1; + + p_cur_time->tv_nsec = sym_acc; + sym_cnt++; + } + if(debugStop && delta < interval_ns*10) + MLogTask(PID_TIME_SYSTIME_POLL, (p_last_time->tv_sec * NSEC_PER_SEC + p_last_time->tv_nsec), (p_cur_time->tv_sec * NSEC_PER_SEC + p_cur_time->tv_nsec)); + p_temp_time = p_last_time; + p_last_time = p_cur_time; + p_cur_time = p_temp_time; + break; + } + } + + return delta; +} + +long sleep_next_tick(long interval) +{ + struct timespec start_time; + struct timespec cur_time; + //struct timespec target_time_convert; + struct timespec sleep_target_time_convert; + long target_time; + long sleep_target_time; + long delta; + + clock_gettime(CLOCK_REALTIME, &start_time); + target_time = (start_time.tv_sec * NSEC_PER_SEC + start_time.tv_nsec + interval * NSEC_PER_USEC) / (interval * NSEC_PER_USEC) * interval; + //printf("target: %ld, current: %ld, %ld\n", target_time, start_time.tv_sec, start_time.tv_nsec); + sleep_target_time = target_time - TIMECOMPENSATION; + sleep_target_time_convert.tv_sec = sleep_target_time * NSEC_PER_USEC / NSEC_PER_SEC; + sleep_target_time_convert.tv_nsec = (sleep_target_time * NSEC_PER_USEC) % NSEC_PER_SEC; + + //target_time_convert.tv_sec = target_time * NSEC_PER_USEC / NSEC_PER_SEC; + //target_time_convert.tv_nsec = (target_time * NSEC_PER_USEC) % NSEC_PER_SEC; + + clock_nanosleep(CLOCK_REALTIME, TIMER_ABSTIME, &sleep_target_time_convert, NULL); + + clock_gettime(CLOCK_REALTIME, &cur_time); + + delta = (cur_time.tv_sec * NSEC_PER_SEC + cur_time.tv_nsec) - target_time * NSEC_PER_USEC; + + return delta; +} + + + diff --git a/fhi_lib/lib/src/xran_transport.c b/fhi_lib/lib/src/xran_transport.c new file mode 100644 index 0000000..9e1d192 --- /dev/null +++ b/fhi_lib/lib/src/xran_transport.c @@ -0,0 +1,101 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file provides the implementation for Transport lyaer (eCPRI) API. + * + * @file xran_transport.c + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#include +#include +#include +#include + +#include "xran_fh_lls_cu.h" +#include "xran_common.h" +#include "xran_transport.h" +#include "xran_up_api.h" + + +/** + * @brief Compose ecpriRtcid/ecpriPcid + * + * @param CU_Port_ID CU Port ID + * @param BanbSector_ID Band Sector ID + * @param CC_ID Component Carrier ID + * @param Ant_ID RU Port ID (antenna ID) + * @return uint16_t composed ecpriRtcid/ecpriPcid (network byte order) + */ +inline uint16_t xran_compose_cid(uint8_t CU_Port_ID, uint8_t BandSector_ID, uint8_t CC_ID, uint8_t Ant_ID) +{ + uint16_t cid; + XRANEAXCIDCONFIG *conf; + + conf = xran_get_conf_eAxC(NULL); + + cid = ((CU_Port_ID << conf->bit_cuPortId) & conf->mask_cuPortId) + | ((BandSector_ID << conf->bit_bandSectorId) & conf->mask_bandSectorId) + | ((CC_ID << conf->bit_ccId) & conf->mask_ccId) + | ((Ant_ID << conf->bit_ruPortId) & conf->mask_ruPortId); + + return (rte_cpu_to_be_16(cid)); +} + +/** + * @brief Decompose ecpriRtcid/ecpriPcid + * + * @param cid composed ecpriRtcid/ecpriPcid (network byte order) + * @param result the pointer of the structure to store decomposed values + * @return none + */ +inline void xran_decompose_cid(uint16_t cid, struct xran_eaxc_info *result) +{ + XRANEAXCIDCONFIG *conf; + + conf = xran_get_conf_eAxC(NULL); + cid = rte_be_to_cpu_16(cid); + + result->cuPortId = (cid&conf->mask_cuPortId) >> conf->bit_cuPortId; + result->bandSectorId = (cid&conf->mask_bandSectorId) >> conf->bit_bandSectorId; + result->ccId = (cid&conf->mask_ccId) >> conf->bit_ccId; + result->ruPortId = (cid&conf->mask_ruPortId) >> conf->bit_ruPortId; + + return; +} + +/** + * @brief modify the payload size of eCPRI header in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet which has eCPRI header already + * @param size payload size to be updated + * @return none + */ +inline void xran_update_ecpri_payload_size(struct rte_mbuf *mbuf, int size) +{ + struct xran_ecpri_hdr *ecpri_hdr; + + ecpri_hdr = rte_pktmbuf_mtod(mbuf, struct xran_ecpri_hdr *); + + ecpri_hdr->ecpri_payl_size = rte_cpu_to_be_16(size); +} + diff --git a/fhi_lib/lib/src/xran_ul_tables.c b/fhi_lib/lib/src/xran_ul_tables.c new file mode 100644 index 0000000..99feefb --- /dev/null +++ b/fhi_lib/lib/src/xran_ul_tables.c @@ -0,0 +1,858 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + + +/** + * @brief This file defines those table used in 5G NR spec. + * @file xran_ul_tables.c + * @author Intel Corporation + **/ + +#include +#include +#include + +#include "xran_common.h" + +/* 3GPP 38.211-f20 Table - 6.3.3.2-2 */ +const xRANPrachConfigTableStruct gxranPrachDataTable_sub6_fdd[XRAN_PRACH_CONFIG_TABLE_SIZE] = +{ + { 0, { 0 }, 16, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 1, { 0 }, 16, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 2, { 0 }, 16, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 3, { 0 }, 16, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 4, { 0 }, 8, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 5, { 0 }, 8, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 6, { 0 }, 8, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 7, { 0 }, 8, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 8, { 0 }, 4, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 9, { 0 }, 4, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 10, { 0 }, 4, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 11, { 0 }, 4, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 12, { 0 }, 2, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 13, { 0 }, 2, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 14, { 0 }, 2, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 15, { 0 }, 2, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 16, { 0 }, 1, { 0 }, { 1 }, 1, 0, 0, 0, 0 }, + { 17, { 0 }, 1, { 0 }, { 4 }, 1, 0, 0, 0, 0 }, + { 18, { 0 }, 1, { 0 }, { 7 }, 1, 0, 0, 0, 0 }, + { 19, { 0 }, 1, { 0 }, { 1, 6 }, 2, 0, 0, 0, 0 }, + { 20, { 0 }, 1, { 0 }, { 2, 7 }, 2, 0, 0, 0, 0 }, + { 21, { 0 }, 1, { 0 }, { 3, 8 }, 2, 0, 0, 0, 0 }, + { 22, { 0 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 0, 0, 0 }, + { 23, { 0 }, 1, { 0 }, { 2, 5, 8 }, 3, 0, 0, 0, 0 }, + { 24, { 0 }, 1, { 0 }, { 3, 6, 9 }, 3, 0, 0, 0, 0 }, + { 25, { 0 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 0, 0, 0 }, + { 26, { 0 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 0, 0, 0 }, + { 27, { 0 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 0, 0, 0 }, + { 28, { 1 }, 16, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 29, { 1 }, 16, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 30, { 1 }, 16, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 31, { 1 }, 16, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 32, { 1 }, 8, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 33, { 1 }, 8, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 34, { 1 }, 8, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 35, { 1 }, 8, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 36, { 1 }, 4, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 37, { 1 }, 4, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 38, { 1 }, 4, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 39, { 1 }, 4, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 40, { 1 }, 2, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 41, { 1 }, 2, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 42, { 1 }, 2, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 43, { 1 }, 2, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 44, { 1 }, 1, { 0 }, { 1 }, 1, 0, 0, 0, 0 }, + { 45, { 1 }, 1, { 0 }, { 4 }, 1, 0, 0, 0, 0 }, + { 46, { 1 }, 1, { 0 }, { 9 }, 1, 0, 0, 0, 0 }, + { 47, { 1 }, 1, { 0 }, { 1, 6 }, 2, 0, 0, 0, 0 }, + { 48, { 1 }, 1, { 0 }, { 2, 7 }, 2, 0, 0, 0, 0 }, + { 49, { 1 }, 1, { 0 }, { 3, 8 }, 2, 0, 0, 0, 0 }, + { 50, { 1 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 0, 0, 0 }, + { 51, { 1 }, 1, { 0 }, { 2, 5, 8 }, 3, 0, 0, 0, 0 }, + { 52, { 1 }, 1, { 0 }, { 3, 6, 9 }, 3, 0, 0, 0, 0 }, + { 53, { 2 }, 16, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 54, { 2 }, 8, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 55, { 2 }, 4, { 0 }, { 1 }, 1, 0, 0, 0, 0 }, + { 56, { 2 }, 2, { 0 }, { 1 }, 1, 0, 0, 0, 0 }, + { 57, { 2 }, 2, { 0 }, { 5 }, 1, 0, 0, 0, 0 }, + { 58, { 2 }, 1, { 0 }, { 1 }, 1, 0, 0, 0, 0 }, + { 59, { 2 }, 1, { 0 }, { 5 }, 1, 0, 0, 0, 0 }, + { 60, { 3 }, 16, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 61, { 3 }, 16, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 62, { 3 }, 16, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 63, { 3 }, 16, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 64, { 3 }, 8, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 65, { 3 }, 8, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 66, { 3 }, 8, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 67, { 3 }, 8, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 68, { 3 }, 4, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 69, { 3 }, 4, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 70, { 3 }, 4, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 71, { 3 }, 4, { 1 }, { 1 }, 1, 0, 0, 0, 0 }, + { 72, { 3 }, 2, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 73, { 3 }, 2, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 74, { 3 }, 2, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 75, { 3 }, 2, { 0 }, { 1 }, 1, 0, 0, 0, 0 }, + { 76, { 3 }, 1, { 0 }, { 4 }, 1, 0, 0, 0, 0 }, + { 77, { 3 }, 1, { 0 }, { 7 }, 1, 0, 0, 0, 0 }, + { 78, { 3 }, 1, { 0 }, { 1, 6 }, 2, 0, 0, 0, 0 }, + { 79, { 3 }, 1, { 0 }, { 2, 7 }, 2, 0, 0, 0, 0 }, + { 80, { 3 }, 1, { 0 }, { 3, 8 }, 2, 0, 0, 0, 0 }, + { 81, { 3 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 0, 0, 0 }, + { 82, { 3 }, 1, { 0 }, { 2, 5, 8 }, 3, 0, 0, 0, 0 }, + { 83, { 3 }, 1, { 0 }, { 3, 6, 9 }, 3, 0, 0, 0, 0 }, + { 84, { 3 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 0, 0, 0 }, + { 85, { 3 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 0, 0, 0 }, + { 86, { 3 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 0, 0, 0 }, + { 87, { FORMAT_A1 }, 16, { 0 }, { 4, 9 }, 2, 0, 1, 6, 2 }, + { 88, { FORMAT_A1 }, 16, { 1 }, { 4 }, 1, 0, 2, 6, 2 }, + { 89, { FORMAT_A1 }, 8, { 0 }, { 4, 9 }, 2, 0, 1, 6, 2 }, + { 90, { FORMAT_A1 }, 8, { 1 }, { 4 }, 1, 0, 2, 6, 2 }, + { 91, { FORMAT_A1 }, 4, { 0 }, { 4, 9 }, 2, 0, 1, 6, 2 }, + { 92, { FORMAT_A1 }, 4, { 1 }, { 4, 9 }, 2, 0, 1, 6, 2 }, + { 93, { FORMAT_A1 }, 4, { 0 }, { 4 }, 1, 0, 2, 6, 2 }, + { 94, { FORMAT_A1 }, 2, { 0 }, { 4, 9 }, 2, 0, 1, 6, 2 }, + { 95, { FORMAT_A1 }, 2, { 0 }, { 1 }, 1, 0, 2, 6, 2 }, + { 96, { FORMAT_A1 }, 2, { 0 }, { 4 }, 1, 0, 2, 6, 2 }, + { 97, { FORMAT_A1 }, 2, { 0 }, { 7 }, 1, 0, 2, 6, 2 }, + { 98, { FORMAT_A1 }, 1, { 0 }, { 4 }, 1, 0, 1, 6, 2 }, + { 99, { FORMAT_A1 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 6, 2 }, + { 100, { FORMAT_A1 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 6, 2 }, + { 101, { FORMAT_A1 }, 1, { 0 }, { 1 }, 1, 0, 2, 6, 2 }, + { 102, { FORMAT_A1 }, 1, { 0 }, { 7 }, 1, 0, 2, 6, 2 }, + { 103, { FORMAT_A1 }, 1, { 0 }, { 2, 7 }, 2, 0, 2, 6, 2 }, + { 104, { FORMAT_A1 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 6, 2 }, + { 105, { FORMAT_A1 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 6, 2 }, + { 106, { FORMAT_A1 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 6, 2 }, + { 107, { FORMAT_A1 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 2, 6, 2 }, + { 108, { FORMAT_A1, FORMAT_B1 }, 2, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 109, { FORMAT_A1, FORMAT_B1 }, 2, { 0 }, { 4 }, 1, 0, 2, 7, 2 }, + { 110, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 4 }, 1, 0, 1, 7, 2 }, + { 111, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 7, 2 }, + { 112, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 113, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 1 }, 1, 0, 2, 7, 2 }, + { 114, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 7 }, 1, 0, 2, 7, 2 }, + { 115, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 7, 2 }, + { 116, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 7, 2 }, + { 117, { FORMAT_A2 }, 16, { 1 }, { 2, 6, 9 }, 3, 0, 1, 3, 4 }, + { 118, { FORMAT_A2 }, 16, { 1 }, { 4 }, 1, 0, 2, 3, 4 }, + { 119, { FORMAT_A2 }, 8, { 1 }, { 2, 6, 9 }, 3, 0, 1, 3, 4 }, + { 120, { FORMAT_A2 }, 8, { 1 }, { 4 }, 1, 0, 2, 3, 4 }, + { 121, { FORMAT_A2 }, 4, { 0 }, { 2, 6, 9 }, 3, 0, 1, 3, 4 }, + { 122, { FORMAT_A2 }, 4, { 0 }, { 4 }, 1, 0, 2, 3, 4 }, + { 123, { FORMAT_A2 }, 2, { 1 }, { 2, 6, 9 }, 3, 0, 1, 3, 4 }, + { 124, { FORMAT_A2 }, 2, { 0 }, { 1 }, 1, 0, 2, 3, 4 }, + { 125, { FORMAT_A2 }, 2, { 0 }, { 4 }, 1, 0, 2, 3, 4 }, + { 126, { FORMAT_A2 }, 2, { 0 }, { 7 }, 1, 0, 2, 3, 4 }, + { 127, { FORMAT_A2 }, 1, { 0 }, { 4 }, 1, 0, 1, 3, 4 }, + { 128, { FORMAT_A2 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 3, 4 }, + { 129, { FORMAT_A2 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 3, 4 }, + { 130, { FORMAT_A2 }, 1, { 0 }, { 1 }, 1, 0, 2, 3, 4 }, + { 131, { FORMAT_A2 }, 1, { 0 }, { 7 }, 1, 0, 2, 3, 4 }, + { 132, { FORMAT_A2 }, 1, { 0 }, { 2, 7 }, 2, 0, 2, 3, 4 }, + { 133, { FORMAT_A2 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 3, 4 }, + { 134, { FORMAT_A2 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 3, 4 }, + { 135, { FORMAT_A2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 3, 4 }, + { 136, { FORMAT_A2 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 2, 3, 4 }, + { 137, { FORMAT_A2, FORMAT_B2 }, 2, { 1 }, { 2, 6, 9 }, 3, 0, 1, 3, 4 }, + { 138, { FORMAT_A2, FORMAT_B2 }, 2, { 0 }, { 4 }, 1, 0, 2, 3, 4 }, + { 139, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 4 }, 1, 0, 1, 3, 4 }, + { 140, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 3, 4 }, + { 141, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 3, 4 }, + { 142, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 1 }, 1, 0, 2, 3, 4 }, + { 143, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 7 }, 1, 0, 2, 3, 4 }, + { 144, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 3, 4 }, + { 145, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 3, 4 }, + { 146, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 3, 4 }, + { 147, { FORMAT_A3 }, 16, { 1 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 148, { FORMAT_A3 }, 16, { 1 }, { 4 }, 1, 0, 2, 2, 6 }, + { 149, { FORMAT_A3 }, 8, { 1 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 150, { FORMAT_A3 }, 8, { 1 }, { 4 }, 1, 0, 2, 2, 6 }, + { 151, { FORMAT_A3 }, 4, { 0 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 152, { FORMAT_A3 }, 4, { 0 }, { 4 }, 1, 0, 2, 2, 6 }, + { 153, { FORMAT_A3 }, 2, { 1 }, { 2, 6, 9 }, 3, 0, 2, 2, 6 }, + { 154, { FORMAT_A3 }, 2, { 0 }, { 1 }, 1, 0, 2, 2, 6 }, + { 155, { FORMAT_A3 }, 2, { 0 }, { 4 }, 1, 0, 2, 2, 6 }, + { 156, { FORMAT_A3 }, 2, { 0 }, { 7 }, 1, 0, 2, 2, 6 }, + { 157, { FORMAT_A3 }, 1, { 0 }, { 4 }, 1, 0, 1, 2, 6 }, + { 158, { FORMAT_A3 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 2, 6 }, + { 159, { FORMAT_A3 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 160, { FORMAT_A3 }, 1, { 0 }, { 1 }, 1, 0, 2, 2, 6 }, + { 161, { FORMAT_A3 }, 1, { 0 }, { 7 }, 1, 0, 2, 2, 6 }, + { 162, { FORMAT_A3 }, 1, { 0 }, { 2, 7 }, 2, 0, 2, 2, 6 }, + { 163, { FORMAT_A3 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 2, 6 }, + { 164, { FORMAT_A3 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 2, 6 }, + { 165, { FORMAT_A3 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 2, 6 }, + { 166, { FORMAT_A3 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 2, 2, 6 }, + { 167, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 2, 6, 9 }, 3, 0, 2, 2, 6 }, + { 168, { FORMAT_A3, FORMAT_B3 }, 2, { 0 }, { 4 }, 1, 0, 2, 2, 6 }, + { 169, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 4 }, 1, 0, 2, 2, 6 }, + { 170, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 2, 6 }, + { 171, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 172, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 1 }, 1, 0, 1, 2, 6 }, + { 173, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 7 }, 1, 0, 2, 2, 6 }, + { 174, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 2, 6 }, + { 175, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 2, 6 }, + { 176, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 2, 6 }, + { 177, { FORMAT_B1 }, 16, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 178, { FORMAT_B1 }, 16, { 1 }, { 4 }, 1, 0, 2, 7, 2 }, + { 179, { FORMAT_B1 }, 8, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 180, { FORMAT_B1 }, 8, { 1 }, { 4 }, 1, 0, 2, 7, 2 }, + { 181, { FORMAT_B1 }, 4, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 182, { FORMAT_B1 }, 4, { 1 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 183, { FORMAT_B1 }, 4, { 0 }, { 4 }, 1, 0, 2, 7, 2 }, + { 184, { FORMAT_B1 }, 2, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 185, { FORMAT_B1 }, 2, { 0 }, { 1 }, 1, 0, 2, 7, 2 }, + { 186, { FORMAT_B1 }, 2, { 0 }, { 4 }, 1, 0, 2, 7, 2 }, + { 187, { FORMAT_B1 }, 2, { 0 }, { 7 }, 1, 0, 2, 7, 2 }, + { 188, { FORMAT_B1 }, 1, { 0 }, { 4 }, 1, 0, 1, 7, 2 }, + { 189, { FORMAT_B1 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 7, 2 }, + { 190, { FORMAT_B1 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 191, { FORMAT_B1 }, 1, { 0 }, { 1 }, 1, 0, 2, 7, 2 }, + { 192, { FORMAT_B1 }, 1, { 0 }, { 7 }, 1, 0, 2, 7, 2 }, + { 193, { FORMAT_B1 }, 1, { 0 }, { 2, 7 }, 2, 0, 2, 7, 2 }, + { 194, { FORMAT_B1 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 7, 2 }, + { 195, { FORMAT_B1 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 7, 2 }, + { 196, { FORMAT_B1 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 7, 2 }, + { 197, { FORMAT_B1 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 2, 7, 12 }, + { 198, { FORMAT_B4 }, 16, { 0 }, { 4, 9 }, 2, 0, 2, 1, 12 }, + { 199, { FORMAT_B4 }, 16, { 1 }, { 4 }, 1, 0, 2, 1, 12 }, + { 200, { FORMAT_B4 }, 8, { 0 }, { 4, 9 }, 2, 0, 2, 1, 12 }, + { 201, { FORMAT_B4 }, 8, { 1 }, { 4 }, 1, 0, 2, 1, 12 }, + { 202, { FORMAT_B4 }, 4, { 0 }, { 4, 9 }, 2, 0, 2, 1, 12 }, + { 203, { FORMAT_B4 }, 4, { 0 }, { 4 }, 1, 0, 2, 1, 12 }, + { 204, { FORMAT_B4 }, 4, { 1 }, { 4, 9 }, 2, 0, 2, 1, 12 }, + { 205, { FORMAT_B4 }, 2, { 0 }, { 4, 9 }, 2, 0, 2, 1, 12 }, + { 206, { FORMAT_B4 }, 2, { 0 }, { 1 }, 1, 0, 2, 1, 12 }, + { 207, { FORMAT_B4 }, 2, { 0 }, { 4 }, 1, 0, 2, 1, 12 }, + { 208, { FORMAT_B4 }, 2, { 0 }, { 7 }, 1, 0, 2, 1, 12 }, + { 209, { FORMAT_B4 }, 1, { 0 }, { 1 }, 1, 0, 2, 1, 12 }, + { 210, { FORMAT_B4 }, 1, { 0 }, { 4 }, 1, 0, 2, 1, 12 }, + { 211, { FORMAT_B4 }, 1, { 0 }, { 7 }, 1, 0, 2, 1, 12 }, + { 212, { FORMAT_B4 }, 1, { 0 }, { 1, 6 }, 2, 0, 2, 1, 12 }, + { 213, { FORMAT_B4 }, 1, { 0 }, { 2, 7 }, 2, 0, 2, 1, 12 }, + { 214, { FORMAT_B4 }, 1, { 0 }, { 4, 9 }, 2, 0, 2, 1, 12 }, + { 215, { FORMAT_B4 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 1, 12 }, + { 216, { FORMAT_B4 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 1, 12 }, + { 217, { FORMAT_B4 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 1, 12 }, + { 218, { FORMAT_B4 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 2, 1, 12 }, + { 219, { FORMAT_C0 }, 8, { 1 }, { 4 }, 1, 0, 2, 7, 2 }, + { 220, { FORMAT_C0 }, 4, { 1 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 221, { FORMAT_C0 }, 4, { 0 }, { 4 }, 1, 0, 2, 7, 2 }, + { 222, { FORMAT_C0 }, 2, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 223, { FORMAT_C0 }, 2, { 0 }, { 1 }, 1, 0, 2, 7, 2 }, + { 224, { FORMAT_C0 }, 2, { 0 }, { 4 }, 1, 0, 2, 7, 2 }, + { 225, { FORMAT_C0 }, 2, { 0 }, { 7 }, 1, 0, 2, 7, 2 }, + { 226, { FORMAT_C0 }, 1, { 0 }, { 4 }, 1, 0, 1, 7, 2 }, + { 227, { FORMAT_C0 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 7, 2 }, + { 228, { FORMAT_C0 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 7, 2 }, + { 229, { FORMAT_C0 }, 1, { 0 }, { 1 }, 1, 0, 2, 7, 2 }, + { 230, { FORMAT_C0 }, 1, { 0 }, { 7 }, 1, 0, 2, 7, 2 }, + { 231, { FORMAT_C0 }, 1, { 0 }, { 2, 7 }, 2, 0, 2, 7, 2 }, + { 232, { FORMAT_C0 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 7, 2 }, + { 233, { FORMAT_C0 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 7, 2 }, + { 234, { FORMAT_C0 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 7, 2 }, + { 235, { FORMAT_C0 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 2, 7, 2 }, + { 236, { FORMAT_C2 }, 16, { 1 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 237, { FORMAT_C2 }, 16, { 1 }, { 4 }, 1, 0, 2, 2, 6 }, + { 238, { FORMAT_C2 }, 8, { 1 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 239, { FORMAT_C2 }, 8, { 1 }, { 4 }, 1, 0, 2, 2, 6 }, + { 240, { FORMAT_C2 }, 4, { 0 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 241, { FORMAT_C2 }, 4, { 0 }, { 4 }, 1, 0, 2, 2, 6 }, + { 242, { FORMAT_C2 }, 2, { 1 }, { 2, 6, 9 }, 3, 0, 2, 2, 6 }, + { 243, { FORMAT_C2 }, 2, { 0 }, { 1 }, 1, 0, 2, 2, 6 }, + { 244, { FORMAT_C2 }, 2, { 0 }, { 4 }, 1, 0, 2, 2, 6 }, + { 245, { FORMAT_C2 }, 2, { 0 }, { 7 }, 1, 0, 2, 2, 6 }, + { 246, { FORMAT_C2 }, 1, { 0 }, { 4 }, 1, 0, 1, 2, 6 }, + { 247, { FORMAT_C2 }, 1, { 0 }, { 1, 6 }, 2, 0, 1, 2, 6 }, + { 248, { FORMAT_C2 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 249, { FORMAT_C2 }, 1, { 0 }, { 1 }, 1, 0, 2, 2, 6 }, + { 250, { FORMAT_C2 }, 1, { 0 }, { 7 }, 1, 0, 2, 2, 6 }, + { 251, { FORMAT_C2 }, 1, { 0 }, { 2, 7 }, 2, 0, 2, 2, 6 }, + { 252, { FORMAT_C2 }, 1, { 0 }, { 1, 4, 7 }, 3, 0, 2, 2, 6 }, + { 253, { FORMAT_C2 }, 1, { 0 }, { 0, 2, 4, 6, 8 }, 5, 0, 2, 2, 6 }, + { 254, { FORMAT_C2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 2, 6 }, + { 255, { FORMAT_C2 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 2, 2, 6 }, +}; +/* 3GPP 38.211-f20 Table - 6.3.3.2-3 */ +const xRANPrachConfigTableStruct gxranPrachDataTable_sub6_tdd[XRAN_PRACH_CONFIG_TABLE_SIZE] = +{ + { 0, { 0 }, 16, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 1, { 0 }, 8, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 2, { 0 }, 4, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 3, { 0 }, 2, { 0 }, { 9 }, 1, 0, 0, 0, 0 }, + { 4, { 0 }, 2, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 5, { 0 }, 2, { 0 }, { 4 }, 1, 0, 0, 0, 0 }, + { 6, { 0 }, 2, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 7, { 0 }, 1, { 0 }, { 9 }, 1, 0, 0, 0, 0 }, + { 8, { 0 }, 1, { 0 }, { 8 }, 1, 0, 0, 0, 0 }, + { 9, { 0 }, 1, { 0 }, { 7 }, 1, 0, 0, 0, 0 }, + { 10, { 0 }, 1, { 0 }, { 6 }, 1, 0, 0, 0, 0 }, + { 11, { 0 }, 1, { 0 }, { 5 }, 1, 0, 0, 0, 0 }, + { 12, { 0 }, 1, { 0 }, { 4 }, 1, 0, 0, 0, 0 }, + { 13, { 0 }, 1, { 0 }, { 3 }, 1, 0, 0, 0, 0 }, + { 14, { 0 }, 1, { 0 }, { 2 }, 1, 0, 0, 0, 0 }, + { 15, { 0 }, 1, { 0 }, { 1, 6 }, 2, 0, 0, 0, 0 }, + { 16, { 0 }, 1, { 0 }, { 1, 6 }, 2, 7, 0, 0, 0 }, + { 17, { 0 }, 1, { 0 }, { 4, 9 }, 2, 0, 0, 0, 0 }, + { 18, { 0 }, 1, { 0 }, { 3, 8 }, 2, 0, 0, 0, 0 }, + { 19, { 0 }, 1, { 0 }, { 2, 7 }, 2, 0, 0, 0, 0 }, + { 20, { 0 }, 1, { 0 }, { 8, 9 }, 2, 0, 0, 0, 0 }, + { 21, { 0 }, 1, { 0 }, { 4, 8, 9 }, 3, 0, 0, 0, 0 }, + { 22, { 0 }, 1, { 0 }, { 3, 4, 9 }, 3, 0, 0, 0, 0 }, + { 23, { 0 }, 1, { 0 }, { 7, 8, 9 }, 3, 0, 0, 0, 0 }, + { 24, { 0 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 0, 0, 0 }, + { 25, { 0 }, 1, { 0 }, { 6, 7, 8, 9 }, 4, 0, 0, 0, 0 }, + { 26, { 0 }, 1, { 0 }, { 1, 4, 6, 9 }, 4, 0, 0, 0, 0 }, + { 27, { 0 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 0, 0, 0 }, + { 28, { 1 }, 16, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 29, { 1 }, 8, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 30, { 1 }, 4, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 31, { 1 }, 2, { 0 }, { 7 }, 1, 0, 0, 0, 0 }, + { 32, { 1 }, 2, { 1 }, { 7 }, 1, 0, 0, 0, 0 }, + { 33, { 1 }, 1, { 0 }, { 7 }, 1, 0, 0, 0, 0 }, + { 34, { 2 }, 16, { 1 }, { 6 }, 1, 0, 0, 0, 0 }, + { 35, { 2 }, 8, { 1 }, { 6 }, 1, 0, 0, 0, 0 }, + { 36, { 2 }, 4, { 1 }, { 6 }, 1, 0, 0, 0, 0 }, + { 37, { 2 }, 2, { 0 }, { 6 }, 1, 7, 0, 0, 0 }, + { 38, { 2 }, 2, { 1 }, { 6 }, 1, 7, 0, 0, 0 }, + { 39, { 2 }, 1, { 0 }, { 6 }, 1, 7, 0, 0, 0 }, + { 40, { 3 }, 16, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 41, { 3 }, 8, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 42, { 3 }, 4, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 43, { 3 }, 2, { 0 }, { 9 }, 1, 0, 0, 0, 0 }, + { 44, { 3 }, 2, { 1 }, { 9 }, 1, 0, 0, 0, 0 }, + { 45, { 3 }, 2, { 0 }, { 4 }, 1, 0, 0, 0, 0 }, + { 46, { 3 }, 2, { 1 }, { 4 }, 1, 0, 0, 0, 0 }, + { 47, { 3 }, 1, { 0 }, { 9 }, 1, 0, 0, 0, 0 }, + { 48, { 3 }, 1, { 0 }, { 8 }, 1, 0, 0, 0, 0 }, + { 49, { 3 }, 1, { 0 }, { 7 }, 1, 0, 0, 0, 0 }, + { 50, { 3 }, 1, { 0 }, { 6 }, 1, 0, 0, 0, 0 }, + { 51, { 3 }, 1, { 0 }, { 5 }, 1, 0, 0, 0, 0 }, + { 52, { 3 }, 1, { 0 }, { 4 }, 1, 0, 0, 0, 0 }, + { 53, { 3 }, 1, { 0 }, { 3 }, 1, 0, 0, 0, 0 }, + { 54, { 3 }, 1, { 0 }, { 2 }, 1, 0, 0, 0, 0 }, + { 55, { 3 }, 1, { 0 }, { 1, 6 }, 2, 0, 0, 0, 0 }, + { 56, { 3 }, 1, { 0 }, { 1, 6 }, 2, 7, 0, 0, 0 }, + { 57, { 3 }, 1, { 0 }, { 4, 9 }, 2, 0, 0, 0, 0 }, + { 58, { 3 }, 1, { 0 }, { 3, 8 }, 2, 0, 0, 0, 0 }, + { 59, { 3 }, 1, { 0 }, { 2, 7 }, 2, 0, 0, 0, 0 }, + { 60, { 3 }, 1, { 0 }, { 8, 9 }, 2, 0, 0, 0, 0 }, + { 61, { 3 }, 1, { 0 }, { 4, 8, 9 }, 3, 0, 0, 0, 0 }, + { 62, { 3 }, 1, { 0 }, { 3, 4, 9 }, 3, 0, 0, 0, 0 }, + { 63, { 3 }, 1, { 0 }, { 7, 8, 9 }, 3, 0, 0, 0, 0 }, + { 64, { 3 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 0, 0, 0 }, + { 65, { 3 }, 1, { 0 }, { 1, 4, 6, 9 }, 4, 0, 0, 0, 0 }, + { 66, { 3 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 0, 0, 0 }, + { 67, { FORMAT_A1 }, 18, { 1 }, { 9 }, 1, 0, 2, 6, 2 }, + { 68, { FORMAT_A1 }, 8, { 1 }, { 9 }, 1, 0, 2, 6, 2 }, + { 69, { FORMAT_A1 }, 4, { 1 }, { 9 }, 1, 0, 1, 6, 2 }, + { 70, { FORMAT_A1 }, 2, { 1 }, { 9 }, 1, 0, 1, 6, 2 }, + { 71, { FORMAT_A1 }, 2, { 1 }, { 4, 9 }, 2, 7, 1, 3, 2 }, + { 72, { FORMAT_A1 }, 2, { 1 }, { 7, 9 }, 2, 7, 1, 3, 2 }, + { 73, { FORMAT_A1 }, 2, { 1 }, { 7, 9 }, 2, 0, 1, 6, 2 }, + { 74, { FORMAT_A1 }, 2, { 1 }, { 8, 9 }, 2, 0, 2, 6, 2 }, + { 75, { FORMAT_A1 }, 2, { 1 }, { 4, 9 }, 2, 0, 2, 6, 2 }, + { 76, { FORMAT_A1 }, 2, { 1 }, { 2, 3, 4, 7, 8, 9 }, 6, 0, 1, 6, 2 }, + { 77, { FORMAT_A1 }, 1, { 0 }, { 9 }, 1, 0, 2, 6, 2 }, + { 78, { FORMAT_A1 }, 1, { 0 }, { 9 }, 1, 7, 1, 3, 2 }, + { 79, { FORMAT_A1 }, 1, { 0 }, { 9 }, 1, 0, 1, 6, 2 }, + { 80, { FORMAT_A1 }, 1, { 0 }, { 8, 9 }, 2, 0, 2, 6, 2 }, + { 81, { FORMAT_A1 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 6, 2 }, + { 82, { FORMAT_A1 }, 1, { 0 }, { 7, 9 }, 2, 7, 1, 3, 2 }, + { 83, { FORMAT_A1 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 1, 6, 2 }, + { 84, { FORMAT_A1 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 2, 6, 2 }, + { 85, { FORMAT_A1 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 1, 6, 2 }, + { 86, { FORMAT_A1 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 1, 3, 2 }, + { 87, { FORMAT_A2 }, 16, { 1 }, { 9 }, 1, 0, 2, 3, 4 }, + { 88, { FORMAT_A2 }, 8, { 1 }, { 9 }, 1, 0, 2, 3, 4 }, + { 89, { FORMAT_A2 }, 4, { 1 }, { 9 }, 1, 0, 1, 3, 4 }, + { 90, { FORMAT_A2 }, 2, { 1 }, { 7, 9 }, 2, 0, 1, 3, 4 }, + { 91, { FORMAT_A2 }, 2, { 1 }, { 8, 9 }, 2, 0, 2, 3, 4 }, + { 92, { FORMAT_A2 }, 2, { 1 }, { 7, 9 }, 2, 9, 1, 1, 4 }, + { 93, { FORMAT_A2 }, 2, { 1 }, { 4, 9 }, 2, 9, 1, 1, 4 }, + { 94, { FORMAT_A2 }, 2, { 1 }, { 4, 9 }, 2, 0, 2, 3, 4 }, + { 95, { FORMAT_A2 }, 16, { 1 }, { 2, 3, 4, 7, 8, 9 }, 6, 0, 1, 3, 4 }, + { 96, { FORMAT_A2 }, 1, { 0 }, { 2 }, 1, 0, 1, 3, 4 }, + { 97, { FORMAT_A2 }, 1, { 0 }, { 9 }, 1, 0, 1, 3, 4 }, + { 98, { FORMAT_A2 }, 2, { 1 }, { 9 }, 1, 0, 1, 3, 4 }, + { 99, { FORMAT_A2 }, 1, { 0 }, { 9 }, 1, 0, 2, 3, 4 }, + { 100, { FORMAT_A2 }, 1, { 0 }, { 9 }, 1, 9, 1, 1, 4 }, + { 101, { FORMAT_A2 }, 1, { 0 }, { 9 }, 1, 0, 1, 3, 4 }, + { 102, { FORMAT_A2 }, 1, { 0 }, { 2, 7 }, 2, 0, 1, 3, 4 }, + { 103, { FORMAT_A2 }, 1, { 0 }, { 8, 9 }, 2, 0, 2, 3, 4 }, + { 104, { FORMAT_A2 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 3, 4 }, + { 105, { FORMAT_A2 }, 1, { 0 }, { 7, 9 }, 2, 9, 1, 1, 4 }, + { 106, { FORMAT_A2 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 1, 3, 4 }, + { 107, { FORMAT_A2 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 2, 3, 4 }, + { 108, { FORMAT_A2 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 1, 3, 4 }, + { 109, { FORMAT_A2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 9, 1, 1, 4 }, + { 110, { FORMAT_A3 }, 16, { 1 }, { 9 }, 1, 0, 2, 2, 6 }, + { 111, { FORMAT_A3 }, 8, { 1 }, { 9 }, 1, 0, 2, 2, 6 }, + { 112, { FORMAT_A3 }, 4, { 1 }, { 9 }, 1, 0, 1, 2, 6 }, + { 113, { FORMAT_A3 }, 2, { 1 }, { 4, 9 }, 2, 7, 1, 1, 6 }, + { 114, { FORMAT_A3 }, 2, { 1 }, { 7, 9 }, 2, 7, 1, 1, 6 }, + { 115, { FORMAT_A3 }, 2, { 1 }, { 7, 9 }, 2, 0, 1, 2, 6 }, + { 116, { FORMAT_A3 }, 2, { 1 }, { 4, 9 }, 2, 0, 2, 2, 6 }, + { 117, { FORMAT_A3 }, 2, { 1 }, { 8, 9 }, 2, 0, 2, 2, 6 }, + { 118, { FORMAT_A3 }, 2, { 1 }, { 2, 3, 4, 7, 8, 9 }, 6, 0, 1, 2, 6 }, + { 119, { FORMAT_A3 }, 1, { 0 }, { 2 }, 1, 0, 1, 2, 6 }, + { 120, { FORMAT_A3 }, 1, { 0 }, { 7 }, 1, 0, 1, 2, 6 }, + { 121, { FORMAT_A3 }, 2, { 1 }, { 9 }, 1, 0, 1, 2, 6 }, + { 122, { FORMAT_A3 }, 1, { 0 }, { 9 }, 1, 0, 2, 2, 6 }, + { 123, { FORMAT_A3 }, 1, { 0 }, { 9 }, 1, 7, 1, 1, 6 }, + { 124, { FORMAT_A3 }, 1, { 0 }, { 9 }, 1, 0, 1, 2, 6 }, + { 125, { FORMAT_A3 }, 1, { 0 }, { 2, 7 }, 2, 0, 1, 2, 6 }, + { 126, { FORMAT_A3 }, 1, { 0 }, { 8, 9 }, 2, 0, 2, 2, 6 }, + { 127, { FORMAT_A3 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 128, { FORMAT_A3 }, 1, { 0 }, { 7, 9 }, 2, 7, 1, 1, 6 }, + { 129, { FORMAT_A3 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 1, 2, 6 }, + { 130, { FORMAT_A3 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 2, 2, 6 }, + { 131, { FORMAT_A3 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 1, 2, 6 }, + { 132, { FORMAT_A3 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 7, 1, 1, 6 }, + { 133, { FORMAT_B1 }, 4, { 1 }, { 9 }, 1, 2, 1, 6, 2 }, + { 134, { FORMAT_B1 }, 2, { 1 }, { 9 }, 1, 2, 1, 6, 2 }, + { 135, { FORMAT_B1 }, 2, { 1 }, { 7, 9 }, 2, 2, 1, 6, 2 }, + { 136, { FORMAT_B1 }, 2, { 1 }, { 4, 9 }, 2, 8, 1, 3, 2 }, + { 137, { FORMAT_B1 }, 2, { 1 }, { 4, 9 }, 2, 2, 2, 6, 2 }, + { 138, { FORMAT_B1 }, 1, { 0 }, { 9 }, 1, 2, 2, 6, 2 }, + { 139, { FORMAT_B1 }, 1, { 0 }, { 9 }, 1, 8, 1, 3, 2 }, + { 140, { FORMAT_B1 }, 1, { 0 }, { 9 }, 1, 2, 1, 6, 2 }, + { 141, { FORMAT_B1 }, 1, { 0 }, { 8, 9 }, 2, 2, 2, 6, 2 }, + { 142, { FORMAT_B1 }, 1, { 0 }, { 4, 9 }, 2, 2, 1, 6, 2 }, + { 143, { FORMAT_B1 }, 1, { 0 }, { 7, 9 }, 2, 8, 1, 3, 2 }, + { 144, { FORMAT_B1 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 2, 1, 6, 2 }, + { 145, { FORMAT_B4 }, 16, { 1 }, { 9 }, 1, 0, 2, 1, 12 }, + { 146, { FORMAT_B4 }, 8, { 1 }, { 9 }, 1, 0, 2, 1, 12 }, + { 147, { FORMAT_B4 }, 4, { 1 }, { 9 }, 1, 2, 1, 1, 12 }, + { 148, { FORMAT_B4 }, 2, { 1 }, { 9 }, 1, 0, 1, 1, 12 }, + { 149, { FORMAT_B4 }, 2, { 1 }, { 9 }, 1, 2, 1, 1, 12 }, + { 150, { FORMAT_B4 }, 2, { 1 }, { 7, 9 }, 2, 2, 1, 1, 12 }, + { 151, { FORMAT_B4 }, 2, { 1 }, { 4, 9 }, 2, 2, 1, 1, 12 }, + { 152, { FORMAT_B4 }, 2, { 1 }, { 4, 9 }, 2, 0, 2, 1, 12 }, + { 153, { FORMAT_B4 }, 2, { 1 }, { 8, 9 }, 2, 0, 2, 1, 12 }, + { 154, { FORMAT_B4 }, 2, { 1 }, { 2, 3, 4, 7, 8, 9 }, 6, 0, 1, 1, 12 }, + { 155, { FORMAT_B4 }, 1, { 0 }, { 1 }, 1, 0, 1, 1, 12 }, + { 156, { FORMAT_B4 }, 1, { 0 }, { 2 }, 1, 0, 1, 1, 12 }, + { 157, { FORMAT_B4 }, 1, { 0 }, { 4 }, 1, 0, 1, 1, 12 }, + { 158, { FORMAT_B4 }, 1, { 0 }, { 7 }, 1, 0, 1, 1, 12 }, + { 159, { FORMAT_B4 }, 1, { 0 }, { 9 }, 1, 0, 1, 1, 12 }, + { 160, { FORMAT_B4 }, 1, { 0 }, { 9 }, 1, 2, 1, 1, 12 }, + { 161, { FORMAT_B4 }, 1, { 0 }, { 9 }, 1, 0, 2, 1, 12 }, + { 162, { FORMAT_B4 }, 1, { 0 }, { 4, 9 }, 2, 2, 1, 1, 12 }, + { 163, { FORMAT_B4 }, 1, { 0 }, { 7, 9 }, 2, 2, 1, 1, 12 }, + { 164, { FORMAT_B4 }, 1, { 0 }, { 8, 9 }, 2, 0, 2, 1, 12 }, + { 165, { FORMAT_B4 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 2, 1, 1, 12 }, + { 166, { FORMAT_B4 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 2, 1, 1, 12 }, + { 167, { FORMAT_B4 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 0, 2, 1, 12 }, + { 168, { FORMAT_B4 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 2, 1, 1, 12 }, + { 169, { FORMAT_C0 }, 16, { 1 }, { 9 }, 1, 2, 2, 6, 2 }, + { 170, { FORMAT_C0 }, 8, { 1 }, { 9 }, 1, 2, 2, 6, 2 }, + { 171, { FORMAT_C0 }, 4, { 1 }, { 9 }, 1, 2, 1, 6, 2 }, + { 172, { FORMAT_C0 }, 2, { 1 }, { 9 }, 1, 2, 1, 6, 2 }, + { 173, { FORMAT_C0 }, 2, { 1 }, { 8, 9 }, 2, 2, 2, 6, 2 }, + { 174, { FORMAT_C0 }, 2, { 1 }, { 7, 9 }, 2, 2, 1, 6, 2 }, + { 175, { FORMAT_C0 }, 2, { 1 }, { 7, 9 }, 2, 8, 1, 3, 2 }, + { 176, { FORMAT_C0 }, 2, { 1 }, { 4, 9 }, 2, 8, 1, 3, 2 }, + { 177, { FORMAT_C0 }, 2, { 1 }, { 4, 9 }, 2, 2, 2, 6, 2 }, + { 178, { FORMAT_C0 }, 2, { 1 }, { 2, 3, 4, 7, 8, 9 }, 6, 2, 1, 6, 2 }, + { 179, { FORMAT_C0 }, 1, { 0 }, { 9 }, 1, 2, 2, 6, 2 }, + { 180, { FORMAT_C0 }, 1, { 0 }, { 9 }, 1, 8, 1, 3, 2 }, + { 181, { FORMAT_C0 }, 1, { 0 }, { 9 }, 1, 2, 1, 6, 2 }, + { 182, { FORMAT_C0 }, 1, { 0 }, { 8, 9 }, 2, 2, 2, 6, 2 }, + { 183, { FORMAT_C0 }, 1, { 0 }, { 4, 9 }, 2, 2, 1, 6, 2 }, + { 184, { FORMAT_C0 }, 1, { 0 }, { 7, 9 }, 2, 8, 1, 3, 2 }, + { 185, { FORMAT_C0 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 2, 1, 6, 2 }, + { 186, { FORMAT_C0 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 2, 2, 6, 2 }, + { 187, { FORMAT_C0 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 2, 1, 6, 2 }, + { 188, { FORMAT_C0 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 8, 1, 3, 2 }, + { 189, { FORMAT_C2 }, 16, { 1 }, { 9 }, 1, 2, 2, 2, 6 }, + { 190, { FORMAT_C2 }, 8, { 1 }, { 9 }, 1, 2, 2, 2, 6 }, + { 191, { FORMAT_C2 }, 4, { 1 }, { 9 }, 1, 2, 1, 2, 6 }, + { 192, { FORMAT_C2 }, 2, { 1 }, { 9 }, 1, 2, 1, 2, 6 }, + { 193, { FORMAT_C2 }, 2, { 1 }, { 8, 9 }, 2, 2, 2, 2, 6 }, + { 194, { FORMAT_C2 }, 2, { 1 }, { 7, 9 }, 2, 2, 1, 2, 6 }, + { 195, { FORMAT_C2 }, 2, { 1 }, { 7, 9 }, 2, 8, 1, 1, 6 }, + { 196, { FORMAT_C2 }, 2, { 1 }, { 4, 9 }, 2, 8, 1, 1, 6 }, + { 197, { FORMAT_C2 }, 2, { 1 }, { 4, 9 }, 2, 2, 2, 2, 6 }, + { 198, { FORMAT_C2 }, 2, { 1 }, { 2, 3, 4, 7, 8, 9 }, 6, 2, 1, 2, 6 }, + { 199, { FORMAT_C2 }, 8, { 1 }, { 9 }, 1, 8, 2, 1, 6 }, + { 200, { FORMAT_C2 }, 4, { 1 }, { 9 }, 1, 8, 1, 1, 6 }, + { 201, { FORMAT_C2 }, 1, { 0 }, { 9 }, 1, 2, 2, 2, 6 }, + { 202, { FORMAT_C2 }, 1, { 0 }, { 9 }, 1, 8, 1, 1, 6 }, + { 203, { FORMAT_C2 }, 1, { 0 }, { 9 }, 1, 2, 1, 2, 6 }, + { 204, { FORMAT_C2 }, 1, { 0 }, { 8, 9 }, 2, 2, 2, 2, 6 }, + { 205, { FORMAT_C2 }, 1, { 0 }, { 4, 9 }, 2, 2, 1, 2, 6 }, + { 206, { FORMAT_C2 }, 1, { 0 }, { 7, 9 }, 2, 8, 1, 1, 6 }, + { 207, { FORMAT_C2 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 2, 1, 2, 6 }, + { 208, { FORMAT_C2 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 2, 2, 2, 6 }, + { 209, { FORMAT_C2 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 2, 1, 2, 6 }, + { 210, { FORMAT_C2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 8, 1, 1, 6 }, + { 211, { FORMAT_A1, FORMAT_B1 }, 2, { 1 }, { 9 }, 1, 2, 1, 6, 2 }, + { 212, { FORMAT_A1, FORMAT_B1 }, 2, { 1 }, { 4, 9 }, 2, 8, 1, 3, 2 }, + { 213, { FORMAT_A1, FORMAT_B1 }, 2, { 1 }, { 7, 9 }, 2, 8, 1, 3, 2 }, + { 214, { FORMAT_A1, FORMAT_B1 }, 2, { 1 }, { 7, 9 }, 2, 2, 1, 6, 2 }, + { 215, { FORMAT_A1, FORMAT_B1 }, 2, { 1 }, { 4, 9 }, 2, 2, 2, 6, 2 }, + { 216, { FORMAT_A1, FORMAT_B1 }, 2, { 1 }, { 8, 9 }, 2, 2, 2, 6, 2 }, + { 217, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 9 }, 1, 2, 2, 6, 2 }, + { 218, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 9 }, 1, 8, 1, 3, 2 }, + { 219, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 9 }, 1, 2, 1, 6, 2 }, + { 220, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 8, 9 }, 2, 2, 2, 6, 2 }, + { 221, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 4, 9 }, 2, 2, 1, 6, 2 }, + { 222, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 7, 9 }, 2, 8, 1, 3, 2 }, + { 223, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 2, 2, 6, 2 }, + { 224, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 2, 1, 6, 2 }, + { 225, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 8, 1, 3, 2 }, + { 226, { FORMAT_A2, FORMAT_B2 }, 2, { 1 }, { 9 }, 1, 0, 1, 3, 4 }, + { 227, { FORMAT_A2, FORMAT_B2 }, 2, { 1 }, { 4, 9 }, 2, 6, 1, 2, 4 }, + { 228, { FORMAT_A2, FORMAT_B2 }, 2, { 1 }, { 7, 9 }, 2, 6, 1, 2, 4 }, + { 229, { FORMAT_A2, FORMAT_B2 }, 2, { 1 }, { 4, 9 }, 2, 0, 2, 3, 4 }, + { 230, { FORMAT_A2, FORMAT_B2 }, 2, { 1 }, { 8, 9 }, 2, 0, 2, 3, 4 }, + { 231, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 9 }, 1, 0, 2, 3, 4 }, + { 232, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 9 }, 1, 6, 1, 2, 4 }, + { 233, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 9 }, 1, 0, 1, 3, 4 }, + { 234, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 8, 9 }, 2, 0, 2, 3, 4 }, + { 235, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 3, 4 }, + { 236, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 7, 9 }, 2, 6, 1, 2, 4 }, + { 237, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 1, 3, 4 }, + { 238, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 3, 4, 8, 9 }, 4, 0, 2, 3, 4 }, + { 239, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 1, 3, 4 }, + { 240, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 6, 1, 2, 4 }, + { 241, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 9 }, 1, 0, 1, 2, 6 }, + { 242, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 4, 9 }, 2, 2, 1, 2, 6 }, + { 243, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 7, 9 }, 2, 0, 1, 2, 6 }, + { 244, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 7, 9 }, 2, 2, 1, 2, 6 }, + { 245, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 4, 9 }, 2, 0, 2, 2, 6 }, + { 246, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 8, 9 }, 2, 0, 2, 2, 6 }, + { 247, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 9 }, 1, 0, 2, 2, 6 }, + { 248, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 9 }, 1, 2, 1, 2, 6 }, + { 249, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 9 }, 1, 0, 1, 2, 6 }, + { 250, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 8, 9 }, 2, 0, 2, 2, 6 }, + { 251, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 4, 9 }, 2, 0, 1, 2, 6 }, + { 252, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 7, 9 }, 2, 2, 1, 2, 6 }, + { 253, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 3, 4, 8, 9 }, 3, 0, 2, 2, 6 }, + { 254, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 1, 3, 5, 7, 9 }, 5, 0, 1, 2, 6 }, + { 255, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }, 10, 2, 1, 2, 6 }, +}; + +/* 3GPP 38.211-f20 Table - 6.3.3.2-4 */ +const xRANPrachConfigTableStruct gxranPrachDataTable_mmw[XRAN_PRACH_CONFIG_TABLE_SIZE] = +{ + { 0, { FORMAT_A1 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 6, 2 }, + { 1, { FORMAT_A1 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 6, 2 }, + { 2, { FORMAT_A1 }, 8, { 1, 2 }, { 9, 19, 29, 39 }, 4, 0, 2, 6, 2 }, + { 3, { FORMAT_A1 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 6, 2 }, + { 4, { FORMAT_A1 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 6, 2 }, + { 5, { FORMAT_A1 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 6, 2 }, + { 6, { FORMAT_A1 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 6, 2 }, + { 7, { FORMAT_A1 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 6, 2 }, + { 8, { FORMAT_A1 }, 2, { 1 }, { 7, 15, 23, 31, 39 }, 5, 0, 2, 6, 2 }, + { 9, { FORMAT_A1 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 6, 2 }, + { 10, { FORMAT_A1 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 6, 2 }, + { 11, { FORMAT_A1 }, 2, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 6, 2 }, + { 12, { FORMAT_A1 }, 1, { 0 }, { 19, 39 }, 2, 7, 1, 3, 2 }, + { 13, { FORMAT_A1 }, 1, { 0 }, { 3, 5, 7 }, 2, 0, 1, 6, 2 }, + { 14, { FORMAT_A1 }, 1, { 0 }, { 24, 29, 34, 39 }, 4, 7, 1, 3, 2 }, + { 15, { FORMAT_A1 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 7, 2, 3, 2 }, + { 16, { FORMAT_A1 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 0, 1, 6, 2 }, + { 17, { FORMAT_A1 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 0, 2, 6, 2 }, + { 18, { FORMAT_A1 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 6, 2 }, + { 19, { FORMAT_A1 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 7, 1, 3, 2 }, + { 20, { FORMAT_A1 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 7, 1, 3, 2 }, + { 21, { FORMAT_A1 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 7, 1, 3, 2 }, + { 22, { FORMAT_A1 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 0, 1, 6, 2 }, + { 23, { FORMAT_A1 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 0, 1, 6, 2 }, + { 24, { FORMAT_A1 }, 1, { 0 }, { 13, 14, 15, 29, 30, 31, 37, 38, 39 }, 10, 7, 2, 3, 2 }, + { 25, { FORMAT_A1 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 7, 1, 3, 2 }, + { 26, { FORMAT_A1 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 6, 2 }, + { 27, { FORMAT_A1 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 0, 1, 6, 2 }, + { 28, { FORMAT_A1 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, + 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, + 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, + 34, 35, 36, 37, 38, 39 }, 40, 7, 1, 3, 2 }, + { 29, { FORMAT_A2 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 3, 4 }, + { 30, { FORMAT_A2 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 3, 4 }, + { 31, { FORMAT_A2 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 10, 0, 2, 3, 4 }, + { 32, { FORMAT_A2 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 3, 4 }, + { 33, { FORMAT_A2 }, 8, { 1, 2 }, { 9, 19, 29, 39 }, 4, 0, 2, 3, 4 }, + { 34, { FORMAT_A2 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 3, 4 }, + { 35, { FORMAT_A2 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 3, 4 }, + { 36, { FORMAT_A2 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 3, 4 }, + { 37, { FORMAT_A2 }, 2, { 1 }, { 7, 15, 23, 31, 39 }, 5, 0, 2, 3, 4 }, + { 38, { FORMAT_A2 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 3, 4 }, + { 39, { FORMAT_A2 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 3, 4 }, + { 40, { FORMAT_A2 }, 2, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 3, 4 }, + { 41, { FORMAT_A2 }, 1, { 0 }, { 19, 39 }, 2, 5, 1, 2, 4 }, + { 42, { FORMAT_A2 }, 1, { 0 }, { 3, 5, 7 }, 3, 0, 1, 3, 4 }, + { 43, { FORMAT_A2 }, 1, { 0 }, { 24, 29, 34, 39 }, 4, 5, 1, 2, 4 }, + { 44, { FORMAT_A2 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 5, 2, 2, 4 }, + { 45, { FORMAT_A2 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 0, 1, 3, 4 }, + { 46, { FORMAT_A2 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 0, 2, 3, 4 }, + { 47, { FORMAT_A2 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 0, 1, 3, 4 }, + { 48, { FORMAT_A2 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 5, 1, 2, 4 }, + { 49, { FORMAT_A2 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 0, 1, 3, 4 }, + { 50, { FORMAT_A2 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 5, 1, 2, 4 }, + { 51, { FORMAT_A2 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 0, 1, 3, 4 }, + { 52, { FORMAT_A2 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 5, 1, 2, 4 }, + { 53, { FORMAT_A2 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 3, 4 }, + { 54, { FORMAT_A2 }, 1, { 0 }, { 13, 14, 15, 29, 30, 31, 37, 38, 39 }, 10, 5, 2, 2, 4 }, + { 55, { FORMAT_A2 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 5, 1, 2, 4 }, + { 56, { FORMAT_A2 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 3, 4 }, + { 57, { FORMAT_A2 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 0, 1, 3, 4 }, + { 58, { FORMAT_A2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, + 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, + 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, + 34, 35, 36, 37, 38, 39 }, 40, 5, 1, 2, 4 }, + { 59, { FORMAT_A3 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 60, { FORMAT_A3 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 61, { FORMAT_A3 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 62, { FORMAT_A3 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 63, { FORMAT_A3 }, 8, { 1, 2 }, { 9, 19, 29, 39 }, 4, 0, 2, 2, 6 }, + { 64, { FORMAT_A3 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 2, 6 }, + { 65, { FORMAT_A3 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 66, { FORMAT_A3 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 67, { FORMAT_A3 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 2, 6 }, + { 68, { FORMAT_A3 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 69, { FORMAT_A3 }, 2, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 70, { FORMAT_A3 }, 1, { 0 }, { 19, 39 }, 2, 7, 1, 1, 6 }, + { 71, { FORMAT_A3 }, 1, { 0 }, { 3, 5, 7 }, 3, 0, 1, 2, 6 }, + { 72, { FORMAT_A3 }, 1, { 0 }, { 9, 11, 13 }, 3, 2, 1, 2, 6 }, + { 73, { FORMAT_A3 }, 1, { 0 }, { 24, 29, 34, 39 }, 4, 7, 1, 1, 6 }, + { 74, { FORMAT_A3 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 7, 2, 1, 6 }, + { 75, { FORMAT_A3 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 0, 1, 2, 6 }, + { 76, { FORMAT_A3 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 0, 2, 2, 6 }, + { 77, { FORMAT_A3 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 0, 1, 2, 6 }, + { 78, { FORMAT_A3 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 7, 1, 1, 6 }, + { 79, { FORMAT_A3 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 0, 1, 2, 6 }, + { 80, { FORMAT_A3 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 0, 1, 2, 6 }, + { 81, { FORMAT_A3 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 7, 1, 1, 6 }, + { 82, { FORMAT_A3 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 2, 6 }, + { 83, { FORMAT_A3 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 7, 1, 1, 6 }, + { 84, { FORMAT_A3 }, 1, { 0 }, { 13, 14, 15, 29, 30, 31, 37, 38, 39 }, 10, 7, 2, 1, 6 }, + { 85, { FORMAT_A3 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 7, 1, 1, 6 }, + { 86, { FORMAT_A3 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 87, { FORMAT_A3 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 0, 1, 2, 6 }, + { 88, { FORMAT_A3 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, + 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, + 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, + 34, 35, 36, 37, 38, 39 }, 40, 7, 1, 1, 6 }, + { 89, { FORMAT_B1 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 2, 6, 2 }, + { 90, { FORMAT_B1 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 2, 6, 2 }, + { 91, { FORMAT_B1 }, 8, { 1, 2 }, { 9, 19, 29, 39 }, 4, 2, 2, 6, 2 }, + { 92, { FORMAT_B1 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 2, 6, 2 }, + { 93, { FORMAT_B1 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 2, 6, 2 }, + { 94, { FORMAT_B1 }, 2, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 6, 2 }, + { 95, { FORMAT_B1 }, 1, { 0 }, { 19, 39 }, 2, 8, 1, 3, 2 }, + { 96, { FORMAT_B1 }, 1, { 0 }, { 3, 5, 7 }, 3, 2, 1, 6, 2 }, + { 97, { FORMAT_B1 }, 1, { 0 }, { 24, 29, 34, 39 }, 4, 8, 1, 3, 2 }, + { 98, { FORMAT_B1 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 8, 2, 3, 2 }, + { 99, { FORMAT_B1 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 2, 1, 6, 2 }, + { 100, { FORMAT_B1 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 2, 2, 6, 2 }, + { 101, { FORMAT_B1 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 2, 1, 6, 2 }, + { 102, { FORMAT_B1 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 8, 1, 3, 2 }, + { 103, { FORMAT_B1 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 2, 1, 6, 2 }, + { 104, { FORMAT_B1 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 8, 1, 3, 2 }, + { 105, { FORMAT_B1 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 8, 1, 3, 2 }, + { 106, { FORMAT_B1 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 6, 2 }, + { 107, { FORMAT_B1 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 8, 1, 3, 2 }, + { 108, { FORMAT_B1 }, 1, { 0 }, { 13, 14, 15, 29, 30, 31, 37, 38, 39 }, 10, 8, 2, 3, 2 }, + { 109, { FORMAT_B1 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 6, 2 }, + { 110, { FORMAT_B1 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 2, 1, 6, 2 }, + { 111, { FORMAT_B1 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, + 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, + 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, + 34, 35, 36, 37, 38, 39 }, 40, 8, 1, 3, 2 }, + { 112, { FORMAT_B4 }, 16, { 1, 2 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 1, 12 }, + { 113, { FORMAT_B4 }, 16, { 1, 2 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 1, 12 }, + { 114, { FORMAT_B4 }, 8, { 1, 2 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 1, 12 }, + { 115, { FORMAT_B4 }, 8, { 1, 2 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 1, 12 }, + { 116, { FORMAT_B4 }, 8, { 1, 2 }, { 9, 19, 29, 39 }, 4, 0, 2, 1, 12 }, + { 117, { FORMAT_B4 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 1, 12 }, + { 118, { FORMAT_B4 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 1, 12 }, + { 119, { FORMAT_B4 }, 4, { 1, 2 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 1, 12 }, + { 120, { FORMAT_B4 }, 2, { 1 }, { 7, 15, 23, 31, 39 }, 5, 2, 2, 1, 12 }, + { 121, { FORMAT_B4 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 1, 12 }, + { 122, { FORMAT_B4 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 1, 12 }, + { 123, { FORMAT_B4 }, 2, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 1, 12 }, + { 124, { FORMAT_B4 }, 1, { 0 }, { 19, 39 }, 2, 2, 2, 1, 12 }, + { 125, { FORMAT_B4 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 0, 1, 1, 12 }, + { 126, { FORMAT_B4 }, 1, { 0 }, { 24, 29, 34, 39 }, 4, 2, 1, 1, 12 }, + { 127, { FORMAT_B4 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 2, 2, 1, 12 }, + { 128, { FORMAT_B4 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 0, 2, 1, 12 }, + { 129, { FORMAT_B4 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 0, 1, 1, 12 }, + { 130, { FORMAT_B4 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 0, 2, 1, 12 }, + { 131, { FORMAT_B4 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 0, 1, 1, 12 }, + { 132, { FORMAT_B4 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 2, 2, 1, 12 }, + { 133, { FORMAT_B4 }, 1, { 0 }, { 9, 11, 13, 15, 17, 19 }, 6, 0, 1, 1, 12 }, + { 134, { FORMAT_B4 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 2, 1, 1, 12 }, + { 135, { FORMAT_B4 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 1, 12 }, + { 136, { FORMAT_B4 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 2, 1, 12 }, + { 137, { FORMAT_B4 }, 1, { 0 }, { 13, 14, 15, 29, 30, 31, 37, 38, 39 }, 10, 2, 2, 1, 12 }, + { 138, { FORMAT_B4 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 1, 12 }, + { 139, { FORMAT_B4 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 1, 12 }, + { 140, { FORMAT_B4 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25 }, 12, 2, 1, 1, 12 }, + { 141, { FORMAT_B4 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25 }, 12, 0, 2, 1, 12 }, + { 142, { FORMAT_B4 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 0, 1, 1, 12 }, + { 143, { FORMAT_B4 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, + 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, + 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, + 34, 35, 36, 37, 38, 39 }, 40, 2, 1, 1, 12 }, + { 144, { FORMAT_C0 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 7, 2 }, + { 145, { FORMAT_C0 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 7, 2 }, + { 146, { FORMAT_C0 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 7, 2 }, + { 147, { FORMAT_C0 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 7, 2 }, + { 148, { FORMAT_C0 }, 8, { 1, 2 }, { 9, 19, 29, 39 }, 4, 0, 2, 7, 2 }, + { 149, { FORMAT_C0 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 7, 2 }, + { 150, { FORMAT_C0 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 7, 2 }, + { 151, { FORMAT_C0 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 7, 2 }, + { 152, { FORMAT_C0 }, 2, { 1 }, { 7, 15, 23, 31, 39 }, 5, 0, 2, 7, 2 }, + { 153, { FORMAT_C0 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 7, 2 }, + { 154, { FORMAT_C0 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 7, 2 }, + { 155, { FORMAT_C0 }, 2, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 7, 2 }, + { 156, { FORMAT_C0 }, 1, { 0 }, { 19, 39 }, 2, 8, 1, 3, 2 }, + { 157, { FORMAT_C0 }, 1, { 0 }, { 3, 5, 7 }, 3, 0, 1, 7, 2 }, + { 158, { FORMAT_C0 }, 1, { 0 }, { 24, 29, 34, 39 }, 4, 8, 1, 3, 2 }, + { 159, { FORMAT_C0 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 8, 2, 3, 2 }, + { 160, { FORMAT_C0 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 0, 1, 7, 2 }, + { 161, { FORMAT_C0 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 0, 2, 7, 2 }, + { 162, { FORMAT_C0 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 8, 1, 3, 2 }, + { 163, { FORMAT_C0 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 0, 1, 7, 2 }, + { 164, { FORMAT_C0 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 0, 1, 7, 2 }, + { 165, { FORMAT_C0 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 8, 1, 3, 2 }, + { 166, { FORMAT_C0 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 8, 1, 3, 2 }, + { 167, { FORMAT_C0 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 7, 2 }, + { 168, { FORMAT_C0 }, 1, { 0 }, { 13, 14, 15, 29, 30, 31, 37, 38, 39 }, 10, 8, 2, 3, 2 }, + { 169, { FORMAT_C0 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 8, 1, 3, 2 }, + { 170, { FORMAT_C0 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 7, 2 }, + { 171, { FORMAT_C0 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 0, 1, 7, 2 }, + { 172, { FORMAT_C0 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, + 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, + 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, + 34, 35, 36, 37, 38, 39 }, 40, 8, 1, 3, 2 }, + { 173, { FORMAT_C2 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 174, { FORMAT_C2 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 175, { FORMAT_C2 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 176, { FORMAT_C2 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 177, { FORMAT_C2 }, 8, { 1, 2 }, { 9, 19, 29, 39 }, 4, 0, 2, 2, 6 }, + { 178, { FORMAT_C2 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 2, 6 }, + { 179, { FORMAT_C2 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 180, { FORMAT_C2 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 181, { FORMAT_C2 }, 2, { 1 }, { 7, 15, 23, 31, 39 }, 5, 2, 2, 2, 6 }, + { 182, { FORMAT_C2 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 1, 2, 6 }, + { 183, { FORMAT_C2 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 0, 2, 2, 6 }, + { 184, { FORMAT_C2 }, 2, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 185, { FORMAT_C2 }, 1, { 0 }, { 19, 39 }, 2, 2, 1, 2, 6 }, + { 186, { FORMAT_C2 }, 1, { 0 }, { 3, 5, 7 }, 3, 0, 1, 2, 6 }, + { 187, { FORMAT_C2 }, 1, { 0 }, { 24, 29, 34, 39 }, 4, 7, 1, 1, 6 }, + { 188, { FORMAT_C2 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 7, 2, 1, 6 }, + { 189, { FORMAT_C2 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 0, 1, 2, 6 }, + { 190, { FORMAT_C2 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 2, 2, 2, 6 }, + { 191, { FORMAT_C2 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 2, 1, 2, 6 }, + { 192, { FORMAT_C2 }, 1, { 0 }, { 3, 5, 7, 9, 11, 13 }, 6, 7, 1, 1, 6 }, + { 193, { FORMAT_C2 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 7, 2, 1, 6 }, + { 194, { FORMAT_C2 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 0, 1, 2, 6 }, + { 195, { FORMAT_C2 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 7, 2, 1, 6 }, + { 196, { FORMAT_C2 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 2, 6 }, + { 197, { FORMAT_C2 }, 1, { 0 }, { 13, 14, 15, 29, 30, 31, 37, 38, 39 }, 10, 7, 2, 1, 6 }, + { 198, { FORMAT_C2 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 7, 1, 1, 6 }, + { 199, { FORMAT_C2 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 0, 1, 2, 6 }, + { 200, { FORMAT_C2 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 0, 1, 2, 6 }, + { 201, { FORMAT_C2 }, 1, { 0 }, { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, + 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, + 33, 34, 35, 36, 37, 38, 39 }, 40, 7, 1, 1, 6 }, + { 202, { FORMAT_A1, FORMAT_B1 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 6, 2 }, + { 203, { FORMAT_A1, FORMAT_B1 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 6, 2 }, + { 204, { FORMAT_A1, FORMAT_B1 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 6, 2 }, + { 205, { FORMAT_A1, FORMAT_B1 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 6, 2 }, + { 206, { FORMAT_A1, FORMAT_B1 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 6, 2 }, + { 207, { FORMAT_A1, FORMAT_B1 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 6, 2 }, + { 208, { FORMAT_A1, FORMAT_B1 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 6, 2 }, + { 209, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 19, 39 }, 2, 8, 1, 3, 2 }, + { 210, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 8, 1, 3, 2 }, + { 211, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 2, 1, 6, 2 }, + { 212, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 2, 2, 6, 2 }, + { 213, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 8, 1, 3, 2 }, + { 214, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 2, 1, 6, 2 }, + { 215, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 2, 1, 6, 2 }, + { 216, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 8, 1, 3, 2 }, + { 217, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 6, 2 }, + { 218, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 6, 2 }, + { 219, { FORMAT_A1, FORMAT_B1 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 2, 1, 6, 2 }, + { 220, { FORMAT_A2, FORMAT_B2 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 3, 4 }, + { 221, { FORMAT_A2, FORMAT_B2 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 3, 4 }, + { 222, { FORMAT_A2, FORMAT_B2 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 3, 4 }, + { 223, { FORMAT_A2, FORMAT_B2 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 3, 4 }, + { 224, { FORMAT_A2, FORMAT_B2 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 3, 4 }, + { 225, { FORMAT_A2, FORMAT_B2 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 3, 4 }, + { 226, { FORMAT_A2, FORMAT_B2 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 3, 4 }, + { 227, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 19, 39 }, 2, 6, 1, 2, 4 }, + { 228, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 6, 1, 2, 4 }, + { 229, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 2, 1, 3, 4 }, + { 230, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 2, 2, 3, 4 }, + { 231, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 6, 1, 2, 4 }, + { 232, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 2, 1, 3, 4 }, + { 233, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 2, 1, 3, 4 }, + { 234, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 6, 1, 2, 4 }, + { 235, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 3, 4 }, + { 236, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 3, 4 }, + { 237, { FORMAT_A2, FORMAT_B2 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 2, 1, 3, 4 }, + { 238, { FORMAT_A3, FORMAT_B3 }, 16, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 2, 6 }, + { 239, { FORMAT_A3, FORMAT_B3 }, 16, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 2, 6 }, + { 240, { FORMAT_A3, FORMAT_B3 }, 8, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 2, 6 }, + { 241, { FORMAT_A3, FORMAT_B3 }, 8, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 2, 6 }, + { 242, { FORMAT_A3, FORMAT_B3 }, 4, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 2, 6 }, + { 243, { FORMAT_A3, FORMAT_B3 }, 4, { 1 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 1, 2, 6 }, + { 244, { FORMAT_A3, FORMAT_B3 }, 2, { 1 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 2, 6 }, + { 245, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 19, 39 }, 2, 2, 1, 2, 6 }, + { 246, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 2, 1, 2, 6 }, + { 247, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 17, 19, 37, 39 }, 4, 2, 1, 2, 6 }, + { 248, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 9, 19, 29, 39 }, 4, 2, 2, 2, 6 }, + { 249, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 2, 1, 2, 6 }, + { 250, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 23, 27, 31, 35, 39 }, 5, 2, 1, 2, 6 }, + { 251, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 2, 2, 6 }, + { 252, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 4, 9, 14, 19, 24, 29, 34, 39 }, 8, 2, 1, 2, 6 }, + { 253, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 3, 7, 11, 15, 19, 23, 27, 31, 35, 39 }, 10, 2, 2, 2, 6 }, + { 254, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 35, 37, 39 }, 15, 2, 1, 2, 6 }, + { 255, { FORMAT_A3, FORMAT_B3 }, 1, { 0 }, { 7, 15, 23, 31, 39 }, 5, 2, 1, 2, 6 }, +}; + +const xRANPrachPreambleLRAStruct gxranPreambleforLRA[XRAN_PRACH_PREAMBLE_FORMAT_OF_ABC] = +{ + {FORMAT_A1, 139, 15, 2 , 288 }, + {FORMAT_A2, 139, 15, 4 , 576 }, + {FORMAT_A3, 139, 15, 6 , 864 }, + {FORMAT_B1, 139, 15, 2 , 216 }, + {FORMAT_B2, 139, 15, 4 , 360 }, + {FORMAT_B3, 139, 15, 6 , 504 }, + {FORMAT_B4, 139, 15, 12, 936 }, + {FORMAT_C0, 139, 15, 1 , 1240}, + {FORMAT_C2, 139, 15, 4 , 2048} +}; + diff --git a/fhi_lib/lib/src/xran_up_api.c b/fhi_lib/lib/src/xran_up_api.c new file mode 100644 index 0000000..a8c71f2 --- /dev/null +++ b/fhi_lib/lib/src/xran_up_api.c @@ -0,0 +1,481 @@ +/****************************************************************************** +* +* 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. +* +*******************************************************************************/ + +/** + * @brief This file provides the implementation of User Plane Messages APIs. + * + * @file xran_up_api.c + * @ingroup group_lte_source_xran + * @author Intel Corporation + * + **/ + +#include +#include +#include "xran_fh_lls_cu.h" +#include "xran_transport.h" +#include "xran_up_api.h" +#ifndef MLOG_ENABLED +#include "mlog_lnx_xRAN.h" +#else +#include "mlog_lnx.h" +#endif + +extern uint32_t xran_lib_ota_tti; + + +/** + * @brief Builds eCPRI header in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet + * @param iq_data_num_bytes Number of bytes in IQ data buffer + * @param iq_data_offset Number of elements already sent + * @return int int 0 on success, non zero on failure + */ +static int build_ecpri_hdr(struct rte_mbuf *mbuf, + const uint32_t iq_data_num_bytes, + const uint32_t iq_data_offset, + uint8_t alignment) +{ + struct xran_ecpri_hdr *ecpri_hdr = (struct xran_ecpri_hdr *) + rte_pktmbuf_append(mbuf, sizeof(struct xran_ecpri_hdr)); + + uint16_t iq_samples_bytes_in_mbuf = rte_pktmbuf_tailroom(mbuf) - + sizeof(struct radio_app_common_hdr) - sizeof(struct data_section_hdr); + + iq_samples_bytes_in_mbuf -= (iq_samples_bytes_in_mbuf % alignment); + + if (NULL == ecpri_hdr) + return 1; + + ecpri_hdr->ecpri_ver = XRAN_ECPRI_VER; + ecpri_hdr->ecpri_resv = 0; + ecpri_hdr->ecpri_concat = 0; + ecpri_hdr->ecpri_mesg_type = ECPRI_IQ_DATA; + + if (iq_data_offset + iq_samples_bytes_in_mbuf > iq_data_num_bytes) { + ecpri_hdr->ecpri_payl_size = + rte_cpu_to_be_16(sizeof(struct radio_app_common_hdr) + + sizeof(struct data_section_hdr) + + (iq_data_num_bytes - iq_data_offset)); + ecpri_hdr->ecpri_seq_id.e_bit = 1; /* last segment */ + } else { + ecpri_hdr->ecpri_payl_size = + rte_cpu_to_be_16(sizeof(struct radio_app_common_hdr) + + sizeof(struct data_section_hdr) + + iq_samples_bytes_in_mbuf); + ecpri_hdr->ecpri_seq_id.e_bit = 0; + } + +// ecpri_hdr->ecpri_xtc_id = 0; /* currently not used */ + ecpri_hdr->ecpri_seq_id.seq_id = 0; + ecpri_hdr->ecpri_seq_id.sub_seq_id = iq_data_offset / + iq_samples_bytes_in_mbuf; + + return 0; +} + +/** + * @brief Builds eCPRI header in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet + * @param ecpri_mesg_type eCPRI message type + * @param payl_size the size in bytes of the payload part of eCPRI message + * @param CC_ID Component Carrier ID for ecpriRtcid/ecpriPcid + * @param Ant_ID Antenna ID for ecpriRtcid/ecpriPcid + * @param seq_id Message identifier for eCPRI message + * @return int int 0 on success, non zero on failure + */ +static int xran_build_ecpri_hdr_ex(struct rte_mbuf *mbuf, + uint8_t ecpri_mesg_type, + int payl_size, + uint8_t CC_ID, + uint8_t Ant_ID, + uint8_t seq_id) +{ + struct xran_ecpri_hdr *ecpri_hdr = (struct xran_ecpri_hdr *) + rte_pktmbuf_append(mbuf, sizeof(struct xran_ecpri_hdr)); + + if (NULL == ecpri_hdr) + return 1; + + ecpri_hdr->ecpri_ver = XRAN_ECPRI_VER; + ecpri_hdr->ecpri_resv = 0; // should be zero + ecpri_hdr->ecpri_concat = 0; + ecpri_hdr->ecpri_mesg_type = ecpri_mesg_type; + ecpri_hdr->ecpri_payl_size = rte_cpu_to_be_16(payl_size + + sizeof(struct data_section_hdr)+sizeof(struct radio_app_common_hdr)); + + /* one to one lls-CU to RU only and band sector is the same */ + ecpri_hdr->ecpri_xtc_id = xran_compose_cid(0, 0, CC_ID, Ant_ID); + + ecpri_hdr->ecpri_seq_id.seq_id = seq_id; + + /* no transport layer fragmentation supported */ + ecpri_hdr->ecpri_seq_id.sub_seq_id = 0; + ecpri_hdr->ecpri_seq_id.e_bit = 1; + + return 0; +} + + +/** + * @brief Builds application layer of xRAN packet + * + * @param mbuf Initialized rte_mbuf packet + * @param app_hdr_input Radio App common header structure to be set in mbuf + * packet. + * @return int 0 on success, non zero on failure + */ +static int build_application_layer( + struct rte_mbuf *mbuf, + const struct radio_app_common_hdr *app_hdr_input) +{ + struct radio_app_common_hdr *app_hdr = (struct radio_app_common_hdr *) + rte_pktmbuf_append(mbuf, sizeof(struct radio_app_common_hdr)); + + if (NULL == app_hdr) + return 1; + + rte_memcpy(app_hdr, app_hdr_input, sizeof(struct radio_app_common_hdr)); + + return 0; +} + +/** + * @brief Builds section header in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet + * @param sec_hdr Section header structure to be set in mbuf packet + * @return int 0 on success, non zero on failure + */ +static int build_section_hdr( + struct rte_mbuf *mbuf, + const struct data_section_hdr *sec_hdr) +{ + struct data_section_hdr *section_hdr = (struct data_section_hdr *) + rte_pktmbuf_append(mbuf, sizeof(struct data_section_hdr)); + + if (NULL == section_hdr) + return 1; + + rte_memcpy(section_hdr, sec_hdr, sizeof(struct data_section_hdr)); + + return 0; +} +/** + * @brief Function for appending IQ samples data to the mbuf. + * + * @param mbuf Initialized rte_mbuf packet. + * @param iq_data_start Address of the first element in IQ data array. + * @param iq_data_num_bytes Size of the IQ data array. + * @param iq_data_offset IQ data btyes already sent. + * @return uint16_t Bytes that have been appended to the packet. + */ +static uint16_t append_iq_samples_ex( + struct rte_mbuf *mbuf, + const void *iq_data_start, + const uint32_t iq_data_num_bytes) +{ + uint16_t free_space_in_pkt = rte_pktmbuf_tailroom(mbuf); + + if(free_space_in_pkt >= iq_data_num_bytes){ + + void *iq_sam_buf = (void *)rte_pktmbuf_append(mbuf, iq_data_num_bytes); + if (iq_sam_buf == NULL) + return 0; +#ifdef XRAN_BYTE_ORDER_SWAP + int idx = 0; + uint16_t *restrict psrc = (uint16_t *)iq_data_start; + uint16_t *restrict pdst = (uint16_t *)iq_sam_buf; + /* CPU byte order (le) of IQ to network byte order (be) */ + for (idx = 0; idx < iq_data_num_bytes/sizeof(int16_t); idx++){ + pdst[idx] = (psrc[idx]>>8) | (psrc[idx]<<8); //rte_cpu_to_be_16(psrc[idx]); + } +#else +#error xran spec is network byte order + /* for debug */ + rte_memcpy(iq_sam_buf, (uint8_t *)iq_data_start, iq_data_num_bytes); + +#endif + + return iq_data_num_bytes; + } + + return 0; +} + + +/** + * @brief Function for appending IQ samples data to the mbuf. + * + * @param mbuf Initialized rte_mbuf packet. + * @param iq_data_start Address of the first element in IQ data array. + * @param iq_data_num_bytes Size of the IQ data array. + * @param iq_data_offset IQ data btyes already sent. + * @return uint16_t Bytes that have been appended to the packet. + */ +static uint16_t append_iq_samples( + struct rte_mbuf *mbuf, + const void *iq_data_start, + const uint32_t iq_data_num_bytes, + const uint32_t iq_data_offset, + const uint8_t alignment) +{ + uint16_t iq_bytes_to_send = 0; + uint16_t free_space_in_pkt = rte_pktmbuf_tailroom(mbuf); + + if (free_space_in_pkt > iq_data_num_bytes - iq_data_offset) + iq_bytes_to_send = iq_data_num_bytes - iq_data_offset; + else + iq_bytes_to_send = free_space_in_pkt; + + /* don't cut off an iq in half */ + iq_bytes_to_send -= iq_bytes_to_send % alignment; + + void *iq_sam_buf = (void *)rte_pktmbuf_append(mbuf, iq_bytes_to_send); + + rte_memcpy(iq_sam_buf, (uint8_t *)iq_data_start + iq_data_offset, + iq_bytes_to_send); + + return iq_bytes_to_send; +} + +/** + * @brief Builds compression header in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet + * @param compression_hdr Section compression header structure + * to be set in mbuf packet + * @return int 0 on success, non zero on failure + */ +static int build_compression_hdr( + struct rte_mbuf *mbuf, + const struct data_section_compression_hdr *compr_hdr) +{ + struct data_section_compression_hdr *compression_hdr = + (struct data_section_compression_hdr *) + rte_pktmbuf_append(mbuf, sizeof(*compression_hdr)); + + if (NULL == compression_hdr) + return 1; + + rte_memcpy(compression_hdr, compr_hdr, sizeof(*compression_hdr)); + + return 0; +} + +/** + * @brief Appends compression parameter in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet + * @param ud_comp_paramr Compression param to be set in mbuf packet + * @return int 0 on success, non zero on failure + */ +static int append_comp_param(struct rte_mbuf *mbuf, union compression_params *ud_comp_param) +{ + union compression_params *compr_param = + (union compression_params *)rte_pktmbuf_append(mbuf, sizeof(union compression_params)); + + if (NULL == compr_param) + return 1; + + rte_memcpy(compr_param, ud_comp_param, sizeof(union compression_params)); + + return 0; +} + +/** + * @brief Function for starting preparion of IQ samples portions + * to be sent in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet. + * @param iq_data_start Address of the first element in IQ data array. + * @param iq_data_num_bytes Size of the IQ data array. + * @param iq_data_offset IQ data bytes already sent. + * @param alignment Size of IQ data alignment. + * @param pkt_gen_params Struct with parameters used for building packet + * @return int Number of bytes that have been appended + to the packet within a single data section appended. + */ +int xran_prepare_iq_symbol_portion( + struct rte_mbuf *mbuf, + const void *iq_data_start, + const uint32_t iq_data_num_bytes, + uint32_t *iq_data_offset, + uint8_t alignment, + struct xran_up_pkt_gen_params *params, + int sub_seq_id) +{ + uint8_t i = 0; + uint16_t iq_sam_bytes_sent = 0; + + if (build_ecpri_hdr(mbuf, iq_data_num_bytes, *iq_data_offset, alignment)) + return 0; + + if (build_application_layer(mbuf, &(params->app_params)) != 0) + return 0; + + if (build_section_hdr(mbuf, &(params->sec_hdr)) != 0) + return 0; + + if(params->compr_hdr_param.ud_comp_hdr.ud_comp_meth != XRAN_COMPMETHOD_NONE) { + if (build_compression_hdr(mbuf, &(params->compr_hdr_param)) !=0) + return 0; + + if(append_comp_param(mbuf, &(params->compr_param)) !=0) + return 0; + } + + return append_iq_samples(mbuf, iq_data_start, iq_data_num_bytes, + (*iq_data_offset), alignment); +} + +/** + * @brief Function for extracting all IQ samples from xRAN packet + * holding a single data section + * @param iq_data_start Address of the first element in IQ data array. + * @param symb_id Symbol ID to be extracted from ecpri header + * @param seq_id Sequence ID to be extracted from radio header + * @return int Size of remaining mbuf filled with IQ samples + zero on failure + */ +int xran_extract_iq_samples(struct rte_mbuf *mbuf, + void **iq_data_start, + uint8_t *CC_ID, + uint8_t *Ant_ID, + uint8_t *frame_id, + uint8_t *subframe_id, + uint8_t *slot_id, + uint8_t *symb_id, + struct ecpri_seq_id *seq_id) +{ + uint32_t mlogVar[10]; + uint32_t mlogVarCnt = 0; + struct xran_eaxc_info result; + + if (NULL == mbuf) + return 0; + if (NULL == iq_data_start) + return 0; + + /* Process eCPRI header. */ + const struct xran_ecpri_hdr *ecpri_hdr = rte_pktmbuf_mtod(mbuf, void *); + if (ecpri_hdr == NULL) + return 0; + + if (seq_id) + *seq_id = ecpri_hdr->ecpri_seq_id; + + xran_decompose_cid((uint16_t)ecpri_hdr->ecpri_xtc_id, &result); + + *CC_ID = result.ccId; + *Ant_ID = result.ruPortId; + + /* Process radio header. */ + struct radio_app_common_hdr *radio_hdr = + (void *)rte_pktmbuf_adj(mbuf, sizeof(*ecpri_hdr)); + if (radio_hdr == NULL) + return 0; /* packet too short */ + + radio_hdr->sf_slot_sym.value = rte_be_to_cpu_16(radio_hdr->sf_slot_sym.value); + + if (frame_id) + *frame_id = radio_hdr->frame_id; + + if (subframe_id) + *subframe_id = radio_hdr->sf_slot_sym.subframe_id; + + if (slot_id) + *slot_id = radio_hdr->sf_slot_sym.slot_id; + + if (symb_id) + *symb_id = radio_hdr->sf_slot_sym.symb_id; + + /* Process data section hdr */ + const struct data_section_hdr *data_hdr = + (void *)rte_pktmbuf_adj(mbuf, sizeof(*radio_hdr)); + if (data_hdr == NULL) + return 0; /* packet too short */ + +#ifdef COMPRESSION + const struct data_section_compression_hdr *data_compr_hdr = + (void *) rte_pktmbuf_adj(mbuf, sizeof(*data_hdr)); + + const uint8_t *compr_param = + (void *)rte_pktmbuf_adj(mbuf, sizeof(*data_compr_hdr)); + + *iq_data_start = rte_pktmbuf_adj(mbuf, sizeof(*compr_param)); + +#else + *iq_data_start = rte_pktmbuf_adj(mbuf, sizeof(*data_hdr)); +#endif + if (*iq_data_start == NULL) + return 0; + + mlogVar[mlogVarCnt++] = 0xBBBBBBB; + mlogVar[mlogVarCnt++] = xran_lib_ota_tti; + mlogVar[mlogVarCnt++] = radio_hdr->frame_id; + mlogVar[mlogVarCnt++] = radio_hdr->sf_slot_sym.subframe_id; + mlogVar[mlogVarCnt++] = radio_hdr->sf_slot_sym.slot_id; + mlogVar[mlogVarCnt++] = radio_hdr->sf_slot_sym.symb_id; + mlogVar[mlogVarCnt++] = rte_pktmbuf_pkt_len(mbuf); + MLogAddVariables(mlogVarCnt, mlogVar, MLogTick()); + + return rte_pktmbuf_pkt_len(mbuf); +} + +/** + * @brief Function for starting preparion of IQ samples portions + * to be sent in xRAN packet + * + * @param mbuf Initialized rte_mbuf packet. + * @param iq_data_start Address of the first element in IQ data array. + * @param iq_data_num_bytes Size of the IQ data array. + * @param iq_data_offset IQ data bytes already sent. + * @param alignment Size of IQ data alignment. + * @param pkt_gen_params Struct with parameters used for building packet + * @return int Number of bytes that have been appended + to the packet within all appended sections. + */ +int xran_prepare_iq_symbol_portion_no_comp( + struct rte_mbuf *mbuf, + const void *iq_data_start, + const uint32_t iq_data_num_bytes, + struct xran_up_pkt_gen_no_compression_params *params, + uint8_t CC_ID, + uint8_t Ant_ID, + uint8_t seq_id) +{ + if(xran_build_ecpri_hdr_ex(mbuf, + ECPRI_IQ_DATA, + iq_data_num_bytes, + CC_ID, + Ant_ID, + seq_id)) + return 0; + + if (build_application_layer(mbuf, &(params->app_params)) != 0) + return 0; + + if (build_section_hdr(mbuf, &(params->sec_hdr)) != 0) + return 0; + + return append_iq_samples_ex(mbuf, iq_data_start, iq_data_num_bytes); +} + diff --git a/fhi_lib/readme.txt b/fhi_lib/readme.txt new file mode 100644 index 0000000..5394371 --- /dev/null +++ b/fhi_lib/readme.txt @@ -0,0 +1,163 @@ +#/****************************************************************************** +#* +#* 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. +#* +#*******************************************************************************/ +1. Introduction +xRAN Lib performs communication between the low-layer split central unit (lls-CU) and RU, it is highly-optimized software implementation based on Intel Architecture to provide the standard interface implementation based on O-RAN front haul interface specification. + +2. Supported features +please refer PRD in the table <>, only ICC compiler was supported for this version. + +3. Fixed Issues +It's first version of seed code for feature development, future fixed issues will be tracked here. + +4. Known Issues +From current unit testing coverage, no Know issues was founded yet. + +5. Prerequisites for install + +5.1 Intel Compiler version +icc -v +icc version 18.0.1 (gcc version 4.8.5 compatibility) + +5.2 DPDK version +dpdk_18.08 + +5.3 compile DPDK with command +[dpdk]# ./usertools/dpdk-setup.sh + +select [16] x86_64-native-linuxapp-icc +select [18] Insert IGB UIO module +exit [35] Exit Script + +5.4 Find PCIe device of Fortville port + +lspci |grep Eth +19:00.0 Ethernet controller: Intel Corporation 82599ES 10-Gigabit SFI/SFP+ Network Connection (rev 01) +19:00.1 Ethernet controller: Intel Corporation 82599ES 10-Gigabit SFI/SFP+ Network Connection (rev 01) +41:00.0 Ethernet controller: Intel Corporation Ethernet Connection X722 for 10GBASE-T (rev 04) +41:00.1 Ethernet controller: Intel Corporation Ethernet Connection X722 for 10GBASE-T (rev 04) +d8:00.0 << Ethernet controller: Intel Corporation Ethernet Controller XL710 for 40GbE QSFP+ (rev 02) <<<< this one +d8:00.1 Ethernet controller: Intel Corporation Ethernet Controller XL710 for 40GbE QSFP+ (rev 02) + +5.5 Corresponding Eth device via + +ifconfig -a + +find port Eth with correct PCIe Bus address as per list above + +ethtool -i enp216s0f0 +driver: i40e +version: 2.4.10 << i40e driver +firmware-version: 6.01 0x800034a4 1.1747.0 +expansion-rom-version: +bus-info: 0000:d8:00.0 <<< this one +supports-statistics: yes +supports-test: yes +supports-eeprom-access: yes +supports-register-dump: yes +supports-priv-flags: yes + +5.6 install correct 2.4.10 i40e version if different (https://downloadcenter.intel.com/download/28306/Intel-Network-Adapter-Driver-for-PCIe-40-Gigabit-Ethernet-Network-Connections-Under-Linux-) + +make sure firmare version is + +firmware-version: 6.01 + +5.7 make sure that linux boot arguments are correct + +cat /proc/cmdline +BOOT_IMAGE=/vmlinuz-3.10.0-rt56 root=/dev/mapper/centos_5gnr--skx--sp-root ro crashkernel=auto rd.lvm.lv=centos_5gnr-skx-sp/root rd.lvm.lv=centos_5gnr-skx-sp/swap intel_iommu=off usbcore.autosuspend=-1 selinux=0 enforcing=0 nmi_watchdog=0 softlockup_panic=0 audit=0 intel_pstate=disable cgroup_disable=memory mce=off idle=poll hugepagesz=1G hugepages=20 hugepagesz=2M hugepages=0 default_hugepagesz=1G isolcpus=1-35 rcu_nocbs=1-35 kthread_cpus=0 irqaffinity=0 nohz_full=1-35 + +5.8 enable SRIOV VF port for XRAN + +echo 2 > /sys/class/net/enp216s0f0/device/sriov_numvfs + +see https://doc.dpdk.org/guides/nics/intel_vf.html + +5.9 Check Virtual Function was created + +lspci |grep Eth +19:00.0 Ethernet controller: Intel Corporation 82599ES 10-Gigabit SFI/SFP+ Network Connection (rev 01) +19:00.1 Ethernet controller: Intel Corporation 82599ES 10-Gigabit SFI/SFP+ Network Connection (rev 01) +41:00.0 Ethernet controller: Intel Corporation Ethernet Connection X722 for 10GBASE-T (rev 04) +41:00.1 Ethernet controller: Intel Corporation Ethernet Connection X722 for 10GBASE-T (rev 04) +d8:00.0 Ethernet controller: Intel Corporation Ethernet Controller XL710 for 40GbE QSFP+ (rev 02) +d8:00.1 Ethernet controller: Intel Corporation Ethernet Controller XL710 for 40GbE QSFP+ (rev 02) +d8:02.0 Ethernet controller: Intel Corporation XL710/X710 Virtual Function (rev 02) <<<< this is XRAN port (u-plane) +d8:02.1 Ethernet controller: Intel Corporation XL710/X710 Virtual Function (rev 02) <<<< this is XRAN port (c-plane) + +5.10 Configure VFs +- set mac to 00:11:22:33:44:66 +- set Vlan tag to 2 (U-plane) for VF0 +- set Vlan tag to 1 (C-plane) for VF1 + +[root@5gnr-sc12-xran app]# ip link set enp216s0f0 vf 0 mac 00:11:22:33:44:66 vlan 2 +[root@5gnr-sc12-xran app]# ip link set enp216s0f0 vf 1 mac 00:11:22:33:44:66 vlan 1 +[root@5gnr-sc12-xran app]# ip link show +1: lo: mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT qlen 1 + link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 +2: enp65s0f0: mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000 + link/ether a4:bf:01:3e:6b:79 brd ff:ff:ff:ff:ff:ff +3: eno2: mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000 + link/ether a4:bf:01:3e:6b:7a brd ff:ff:ff:ff:ff:ff +4: enp25s0f0: mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000 + link/ether 90:e2:ba:d3:b2:ec brd ff:ff:ff:ff:ff:ff +5: enp129s0f0: mtu 1500 qdisc mq state DOWN mode DEFAULT qlen 1000 + link/ether 3c:fd:fe:a8:e0:70 brd ff:ff:ff:ff:ff:ff +6: enp129s0f1: mtu 1500 qdisc mq state DOWN mode DEFAULT qlen 1000 + link/ether 3c:fd:fe:a8:e0:71 brd ff:ff:ff:ff:ff:ff +7: enp216s0f0: mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000 + link/ether 3c:fd:fe:9e:93:68 brd ff:ff:ff:ff:ff:ff + vf 0 MAC 00:11:22:33:44:66, vlan 2, spoof checking on, link-state auto, trust off + vf 1 MAC 00:11:22:33:44:66, vlan 1, spoof checking on, link-state auto, trust off +8: enp25s0f1: mtu 1500 qdisc mq state DOWN mode DEFAULT qlen 1000 + link/ether 90:e2:ba:d3:b2:ed brd ff:ff:ff:ff:ff:ff +9: enp216s0f1: mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000 + link/ether 3c:fd:fe:9e:93:69 brd ff:ff:ff:ff:ff:ff +12: enp216s2: mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000 + link/ether 96:fa:4d:04:4d:87 brd ff:ff:ff:ff:ff:ff +13: enp216s2f1: mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000 + link/ether a6:67:49:bb:bd:5e brd ff:ff:ff:ff:ff:ff + +6. Install xRAN Lib + +6.1 start matlab and run gen_test.m +copy ant_*.bin to /xran/app + +6.2 build xran sample application +export XRAN_DIR=xRAN folder +export RTE_SDK=dpdk folder +[xRAN root folder]$ ./build.sh + +6.3 update Eth port used for XRAN +in ./app/run_lls-cu.sh +ports have to match VF function from step 1.11 (0000:d8:02.0 - U-plane 0000:d8:02.1 C-plane) + +6.4 Run dpdk.sh to assign port to PMD + +[xran root folder]# ./app/dpdk.sh + +Network devices using DPDK-compatible driver +============================================ +0000:d8:02.0 'XL710/X710 Virtual Function 154c' drv=igb_uio unused=i40evf +0000:d8:02.1 'XL710/X710 Virtual Function 154c' drv=igb_uio unused=i40evf + + +6.5 Run XRAN lls-CU sample app +setup RU mac address in config_file_lls_cu.dat +[xran root folder]# ./app/run_lls-cu.sh + -- 2.16.6