Merge branch 'develop-nb-iot-mac' into develop-nb-iot

cmake_targets/CMakeLists.txt

@@ -956,6 +956,7 @@ add_library(SECU_CN ${SECU_CN_SRC})
 ################################"
 set(SCHED_SRC
   ${OPENAIR1_DIR}/SCHED/phy_procedures_lte_eNb.c
+  ${OPENAIR1_DIR}/SCHED/phy_procedures_lte_eNb_nb_iot.c
   ${OPENAIR1_DIR}/SCHED/phy_procedures_lte_ue.c
   ${OPENAIR1_DIR}/SCHED/phy_procedures_lte_common.c
   ${OPENAIR1_DIR}/SCHED/phy_mac_stub.c
@@ -1043,6 +1044,7 @@ set(PHY_SRC
   ${OPENAIR1_DIR}/PHY/CODING/viterbi.c
   ${OPENAIR1_DIR}/PHY/CODING/viterbi_lte.c
   ${OPENAIR1_DIR}/PHY/INIT/lte_init.c
+  ${OPENAIR1_DIR}/PHY/INIT/lte_init_nb_iot.c
   ${OPENAIR1_DIR}/PHY/INIT/lte_parms.c
   ${OPENAIR1_DIR}/PHY/INIT/lte_param_init.c
   ${OPENAIR1_DIR}/PHY/TOOLS/file_output.c
@@ -1127,17 +1129,22 @@ set(L2_SRC
 set (MAC_SRC
   ${MAC_DIR}/lte_transport_init.c
   ${MAC_DIR}/main.c
+  ${MAC_DIR}/IF_Module_nb_iot.c
   ${MAC_DIR}/ue_procedures.c
   ${MAC_DIR}/ra_procedures.c
   ${MAC_DIR}/l1_helpers.c
   ${MAC_DIR}/rar_tools.c
   ${MAC_DIR}/eNB_scheduler.c
   ${MAC_DIR}/eNB_scheduler_dlsch.c
+  ${MAC_DIR}/eNB_scheduler_dlsch_nb_iot.c
   ${MAC_DIR}/eNB_scheduler_ulsch.c
+  ${MAC_DIR}/eNB_scheduler_ulsch_nb_iot.c
   ${MAC_DIR}/eNB_scheduler_mch.c
   ${MAC_DIR}/eNB_scheduler_bch.c
   ${MAC_DIR}/eNB_scheduler_primitives.c
+  ${MAC_DIR}/eNB_scheduler_primitives_nb_iot.c
   ${MAC_DIR}/eNB_scheduler_RA.c
+  ${MAC_DIR}/eNB_scheduler_RA_nb_iot.c
   ${MAC_DIR}/pre_processor.c
   ${MAC_DIR}/config.c
  )

openair1/PHY/INIT/lte_init.c

@@ -37,6 +37,70 @@ extern uint16_t prach_root_sequence_map0_3[838];
 extern uint16_t prach_root_sequence_map4[138];
 uint8_t dmrs1_tab[8] = {0,2,3,4,6,8,9,10};
 
+#if defined(NB_IoT)
+
+void NB_phy_config_mib_eNB(int                 Mod_id,
+			int                 CC_id,
+			int                 eutra_band,
+			int                 Nid_cell,
+			int                 Ncp,
+			int                 p_eNB,
+			uint32_t            dl_CarrierFreq,
+			uint32_t            ul_CarrierFreq) {
+
+  
+  LTE_DL_FRAME_PARMS *fp;
+
+  LOG_I(PHY,"Configuring MIB for instance %d, CCid %d : (band %d,N_RB_DL %d,Nid_cell %d,p %d,DL freq %u)\n",
+	Mod_id, CC_id, eutra_band, N_RB_DL_array[dl_Bandwidth], Nid_cell, p_eNB,dl_CarrierFreq);
+
+  /*if (RC.eNB == NULL) {
+    RC.eNB                               = (PHY_VARS_eNB ***)malloc((1+NUMBER_OF_eNB_MAX)*sizeof(PHY_VARS_eNB***));
+    LOG_I(PHY,"RC.eNB = %p\n",RC.eNB);
+    memset(RC.eNB,0,(1+NUMBER_OF_eNB_MAX)*sizeof(PHY_VARS_eNB***));
+  }
+  if (RC.eNB[Mod_id] == NULL) {
+    RC.eNB[Mod_id]                       = (PHY_VARS_eNB **)malloc((1+MAX_NUM_CCs)*sizeof(PHY_VARS_eNB**));
+    LOG_I(PHY,"RC.eNB[%d] = %p\n",Mod_id,RC.eNB[Mod_id]);
+    memset(RC.eNB[Mod_id],0,(1+MAX_NUM_CCs)*sizeof(PHY_VARS_eNB***));
+  }
+  if (RC.eNB[Mod_id][CC_id] == NULL) {
+    RC.eNB[Mod_id][CC_id] = (PHY_VARS_eNB *)malloc(sizeof(PHY_VARS_eNB));
+    LOG_I(PHY,"RC.eNB[%d][%d] = %p\n",Mod_id,CC_id,RC.eNB[Mod_id][CC_id]);
+    RC.eNB[Mod_id][CC_id]->Mod_id        = Mod_id;
+    RC.eNB[Mod_id][CC_id]->CC_id         = CC_id;
+  }
+
+  RC.eNB[Mod_id][CC_id]->mac_enabled     = 1;
+
+  fp = &RC.eNB[Mod_id][CC_id]->frame_parms; */
+
+  fp->Nid_cell                           = Nid_cell;
+  fp->nushift                            = Nid_cell%6;
+  fp->eutra_band                         = eutra_band;
+  fp->Ncp                                = Ncp;
+  fp->nb_antenna_ports_eNB               = p_eNB;
+  fp->dl_CarrierFreq                     = dl_CarrierFreq;
+  fp->ul_CarrierFreq                     = ul_CarrierFreq;
+  
+
+  init_frame_parms(fp,1);
+  init_lte_top(fp);
+
+}
+
+void NB_phy_config_sib2_eNB(uint8_t Mod_id,
+                         int CC_id,
+                         RadioResourceConfigCommonSIB_t *radioResourceConfigCommon,
+                         ARFCN_ValueEUTRA_t *ul_CArrierFreq,
+                         AdditionalSpectrumEmission_t *additionalSpectrumEmission,
+                         )
+{
+
+}
+
+#endif
+
 // FIXME not used anywhere
 void phy_config_mib(LTE_DL_FRAME_PARMS *fp,
                     uint8_t N_RB_DL,

openair1/PHY/LTE_TRANSPORT/dci_nb_iot.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.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.openairinterface.org/?page_id=698
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+/*! \file PHY/LTE_TRANSPORT/dci.h
+* \brief typedefs for LTE DCI structures from 36-212, V8.6 2009-03.  Limited to 5 MHz formats for the moment.Current LTE compliance V8.6 2009-03.
+* \author R. Knopp
+* \date 2011
+* \version 0.1
+* \company Eurecom
+* \email: knopp@eurecom.fr
+* \note
+* \warning
+*/
+#ifndef USER_MODE
+#include "PHY/types.h"
+#else
+#include <stdint.h>
+#endif
+
+typedef enum DCI_format_NB
+{
+  DCIFormatN0 = 0,
+  DCIFormatN1,
+  DCIFormatN1_RA,
+  DCIFormatN1_RAR,
+  DCIFormatN2_Ind,
+  DCIFormatN2_Pag,
+}e_DCI_format_NB;
+
+///  DCI Format Type 0 (180 kHz, 23 bits)
+struct DCIFormatN0{
+  /// type = 0 => DCI Format N0, type = 1 => DCI Format N1, 1 bits
+  uint8_t type;
+  /// Subcarrier indication, 6 bits
+  uint8_t scind;
+  /// Resourse Assignment (RU Assignment), 3 bits
+  uint8_t ResAssign;
+  /// Modulation and Coding Scheme, 4 bits
+  uint8_t mcs;
+  /// New Data Indicator, 1 bits
+  uint8_t ndi;
+  /// Scheduling Delay, 2 bits
+  uint8_t Scheddly;
+  /// Repetition Number, 3 bits
+  uint8_t RepNum;
+  /// Redundancy version for HARQ (only use 0 and 2), 1 bits
+  uint8_t rv;
+  /// DCI subframe repetition Number, 2 bits
+  uint8_t DCIRep;
+};
+
+typedef struct DCIFormatN0 DCIFormatN0_t;
+#define sizeof_DDCIFormatN0_t 23
+
+///  DCI Format Type N1 for User data
+struct DCIFormatN1{
+  /// type = 0 => DCI Format N0, type = 1 => DCI Format N1,1bits
+  uint8_t type;
+  //NPDCCH order indicator (set to 0), 1 bits
+  uint8_t orderIndicator;
+  // Scheduling Delay,3 bits
+  uint8_t Scheddly;
+  // Resourse Assignment (RU Assignment),3 bits
+  uint8_t ResAssign;
+  // Modulation and Coding Scheme,4 bits
+  uint8_t mcs;
+  // Repetition Number,4 bits
+  uint8_t RepNum;
+  // New Data Indicator,1 bits
+  uint8_t ndi;
+  // HARQ-ACK resource,4 bits
+  uint8_t HARQackRes;
+  // DCI subframe repetition Number,2 bits
+  uint8_t DCIRep;
+};
+
+
+typedef struct DCIFormatN1 DCIFormatN1_t;
+#define sizeof_DCIFormatN1_t 23
+
+///  DCI Format Type N1 for initial RA
+struct DCIFormatN1_RA{
+  /// type = 0 => DCI Format N0, type = 1 => DCI Format N1, 1 bits
+  uint8_t type;
+  //NPDCCH order indicator (set to 0),1 bits
+  uint8_t orderIndicator;
+  // Start number of NPRACH repetiiton, 2 bits
+  uint8_t Scheddly;
+  // Subcarrier indication of NPRACH, 6 bits
+  uint8_t scind;
+  // All the remainging bits, 13 bits
+  uint8_t remaingingBits;
+};
+
+typedef struct DCIFormatN1_RA DCIFormatN1_RA_t;
+#define sizeof_DCIFormatN1_RA_t 23
+
+///  DCI Format Type N1 for RAR
+struct DCIFormatN1_RAR{
+  /// type = 0 => DCI Format N0, type = 1 => DCI Format N1, 1 bits
+  uint8_t type;
+  //NPDCCH order indicator (set to 0),1 bits
+  uint8_t orderIndicator;
+  // Scheduling Delay, 3 bits
+  uint8_t Scheddly;
+  // Resourse Assignment (RU Assignment), 3 bits
+  uint8_t ResAssign;
+  // Modulation and Coding Scheme, 4 bits
+  uint8_t mcs;
+  // Repetition Number, 4 bits
+  uint8_t RepNum;
+  // Reserved 5 bits
+  uint8_t Reserved;
+  // DCI subframe repetition Number, 2 bits
+  uint8_t DCIRep;
+};
+
+typedef struct DCIFormatN1_RAR DCIFormatN1_RAR_t;
+#define sizeof_DCIFormatN1_RAR_t 23
+
+//  DCI Format Type N2 for direct indication, 15 bits
+struct DCIFormatN2_Ind{
+  //Flag for paging(1)/direct indication(0), set to 0,1 bits
+  uint8_t type;
+  //Direct indication information, 8 bits
+  uint8_t directIndInf;
+  // Reserved information bits, 6 bits
+  uint8_t resInfoBits;
+};
+
+typedef struct DCIFormatN2_Ind DCIFormatN2_Ind_t;
+#define sizeof_DCIFormatN2_Ind_t 15
+
+//  DCI Format Type N2 for Paging, 15 bits
+struct DCIFormatN2_Pag{
+  //Flag for paging(1)/direct indication(0), set to 1,1 bits
+  uint8_t type;
+  // Resourse Assignment (RU Assignment), 3 bits
+  uint8_t ResAssign;
+  // Modulation and Coding Scheme, 4 bits
+  uint8_t mcs;
+  // Repetition Number, 4 bits
+  uint8_t RepNum;
+  // Reserved 3 bits
+  uint8_t DCIRep;
+};
+
+typedef struct DCIFormatN2_Pag DCIFormatN2_Pag_t;
+#define sizeof_DCIFormatN2_Pag_t 15
+
+ typedef union DCI_CONTENT {
+ // 
+ DCIFormatN0_t DCIN0;
+ //
+ DCIFormatN1_t DCIN1;
+ //
+ DCIFormatN1_RA_t DCIN1_RA;
+ //
+ DCIFormatN1_RAR_t DCIN1_RAR;
+ //
+ DCIFormatN2_Ind_t DCIN2_Ind;
+ //
+ DCIFormatN2_Pag_t DCIN2_Pag;
+
+ }DCI_CONTENT;
\ No newline at end of file

openair1/PHY/impl_defs_lte_nb_iot.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.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.openairinterface.org/?page_id=698
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+/*! \file PHY/impl_defs_lte.h
+* \brief LTE Physical channel configuration and variable structure definitions
+* \author R. Knopp, F. Kaltenberger
+* \date 2011
+* \version 0.1
+* \company Eurecom
+* \email: knopp@eurecom.fr,florian.kaltenberger@eurecom.fr
+* \note
+* \warning
+*/
+
+
+
+#include "types.h"
+//#include "defs.h"
+
+#define	A_SEQUENCE_OF(type)	A_SET_OF(type)
+
+#define	A_SET_OF(type)					\
+	struct {					\
+		type **array;				\
+		int count;	/* Meaningful size */	\
+		int size;	/* Allocated size */	\
+		void (*free)(type *);			\
+	}
+
+
+/// NPRACH-ParametersList-NB-r13 from 36.331 RRC spec
+typedef struct {
+  /// the period time for nprach
+  uint8_t nprach_Periodicity;
+  /// for the start time for the NPRACH resource from 40ms-2560ms
+  uint8_t nprach_StartTime;	
+  /// for the subcarrier of set to the NPRACH preamble from n0 - n34
+  uint8_t nprach_SubcarrierOffset;
+  /// where is the region that in NPRACH resource to indicate if this UE support MSG3 for multi-tone or not. from 0 - 1
+  uint8_t nprach_SubcarrierMSG3_RangeStart;
+  /// The max preamble transmission attempt for the CE level from 1 - 128
+  uint8_t maxNumPreambleAttemptCE;
+  /// The number of the repetition for DCI use in RAR/MSG3/MSG4 from 1 - 2048
+  uint8_t npdcch_NumRepetitions_RA;
+  /// Starting subframe for NPDCCH Common searching space for (RAR/MSG3/MSG4)
+  uint8_t npdcch_StartSF_CSS_RA;
+  /// Fractional period offset of starting subframe for NPDCCH common search space
+  uint8_t npdcch_Offset_RA;
+} nprach_parameters_NB_t;
+
+typedef struct{
+  A_SEQUENCE_OF(struct NPRACH_Parameters_NB) list;
+}NPRACH_List_NB_t;
+
+typedef long RSRP_Range_t;
+
+typedef struct {
+  A_SEQUENCE_OF(RSRP_Range_t) list;
+}rsrp_ThresholdsNPrachInfoList;
+
+
+/// NPRACH_ConfigSIB-NB from 36.331 RRC spec
+typedef struct {
+  /// nprach_CP_Length_r13, for the CP length(unit us) only 66.7 and 266.7 is implemented
+  uint8_t nprach_CP_Length;
+  /// The criterion for UEs to select a NPRACH resource. Up to 2 RSRP threshold values can be signalled.  \vr{[1..2]}
+  struct rsrp_ThresholdsNPrachInfoList *rsrp_ThresholdsPrachInfoList;
+  /// NPRACH Parameters List
+  NPRACH_List_NB_t nprach_ParametersList;
+} NPRACH_CONFIG_COMMON;
+
+/// NPDSCH-ConfigCommon from 36.331 RRC spec
+typedef struct {
+  ///see TS 36.213 (16.2). \vr{[-60..50]}\n Provides the downlink reference-signal EPRE. The actual value in dBm.
+  int8_t nrs_Power;
+} NPDSCH_CONFIG_COMMON;
+
+typedef struct{
+  /// The base sequence of DMRS sequence in a cell for 3 tones transmission; see TS 36.211 [21, 10.1.4.1.2]. If absent, it is given by NB-IoT CellID mod 12. Value 12 is not used.
+  uint8_t threeTone_BaseSequence;
+  /// Define 3 cyclic shifts for the 3-tone case, see TS 36.211 [21, 10.1.4.1.2].
+  uint8_t threeTone_CyclicShift;
+  /// The base sequence of DMRS sequence in a cell for 6 tones transmission; see TS 36.211 [21, 10.1.4.1.2]. If absent, it is given by NB-IoT CellID mod 14. Value 14 is not used.
+  uint8_t sixTone_BaseSequence;
+  /// Define 4 cyclic shifts for the 6-tone case, see TS 36.211 [21, 10.1.4.1.2].
+  uint8_t sixTone_CyclicShift;
+  /// The base sequence of DMRS sequence in a cell for 12 tones transmission; see TS 36.211 [21, 10.1.4.1.2]. If absent, it is given by NB-IoT CellID mod 30. Value 30 is not used.
+  uint8_t twelveTone_BaseSequence;
+
+}DMRS_CONFIG_t;
+
+/// UL-ReferenceSignalsNPUSCH from 36.331 RRC spec
+typedef struct {
+  /// Parameter: Group-hopping-enabled, see TS 36.211 (5.5.1.3). \vr{[0..1]}
+  uint8_t groupHoppingEnabled;
+  /// , see TS 36.211 (5.5.1.3). \vr{[0..29]}
+  uint8_t groupAssignmentNPUSCH;
+} UL_REFERENCE_SIGNALS_NPUSCH_t;
+
+
+/// PUSCH-ConfigCommon from 36.331 RRC spec.
+typedef struct {
+  /// Number of repetitions for ACK/NACK HARQ response to NPDSCH containing Msg4 per NPRACH resource, see TS 36.213 [23, 16.4.2].
+  uint8_t ack_NACK_NumRepetitions_Msg4[3];
+  /// SRS SubframeConfiguration. See TS 36.211 [21, table 5.5.3.3-1]. Value sc0 corresponds to value 0, sc1 to value 1 and so on.
+  uint8_t srs_SubframeConfig;
+  /// Parameter: \f$N^{HO}_{RB}\f$, see TS 36.211 (5.3.4). \vr{[0..98]}
+  DMRS_CONFIG_t dmrs_Config;
+  /// Ref signals configuration
+  UL_REFERENCE_SIGNALS_NPUSCH_t ul_ReferenceSignalsNPUSCH;
+} NPUSCH_CONFIG_COMMON;
+
+
+typedef struct{
+  /// See TS 36.213 [23, 16.2.1.1], unit dBm.
+  uint8_t p0_NominalNPUSCH;
+  /// See TS 36.213 [23, 16.2.1.1] where al0 corresponds to 0, al04 corresponds to value 0.4, al05 to 0.5, al06 to 0.6, al07 to 0.7, al08 to 0.8, al09 to 0.9 and al1 corresponds to 1. 
+  uint8_t alpha;
+  /// See TS 36.213 [23, 16.2.1.1]. Actual value = IE value * 2 [dB].
+  uint8_t deltaPreambleMsg3;
+}UplinkPowerControlCommon_NB;
+
+
+/* DL-GapConfig-NB-r13 */
+typedef struct {
+	uint8_t	 dl_GapThreshold;
+	uint8_t	 dl_GapPeriodicity;
+	uint8_t	 dl_GapDurationCoeff;
+} DL_GapConfig_NB;
+
+typedef struct {
+  /// Cell ID
+  uint16_t Nid_cell;
+  /// Cyclic Prefix for DL (0=Normal CP, 1=Extended CP)
+  lte_prefix_type_t Ncp;
+  /// Cyclic Prefix for UL (0=Normal CP, 1=Extended CP)
+  lte_prefix_type_t Ncp_UL;
+  /// shift of pilot position in one RB
+  uint8_t nushift;
+  /// indicates if node is a UE (NODE=2) or eNB (PRIMARY_CH=0).
+  uint8_t node_id;
+  /// Frequency index of CBMIMO1 card
+  uint8_t freq_idx;
+  /// RX Frequency for ExpressMIMO/LIME
+  uint32_t carrier_freq[4];
+  /// TX Frequency for ExpressMIMO/LIME
+  uint32_t carrier_freqtx[4];
+  /// RX gain for ExpressMIMO/LIME
+  uint32_t rxgain[4];
+  /// TX gain for ExpressMIMO/LIME
+  uint32_t txgain[4];
+  /// RF mode for ExpressMIMO/LIME
+  uint32_t rfmode[4];
+  /// RF RX DC Calibration for ExpressMIMO/LIME
+  uint32_t rxdc[4];
+  /// RF TX DC Calibration for ExpressMIMO/LIME
+  uint32_t rflocal[4];
+  /// RF VCO calibration for ExpressMIMO/LIME
+  uint32_t rfvcolocal[4];
+  /// Turns on second TX of CBMIMO1 card
+  uint8_t dual_tx;
+  /// flag to indicate SISO transmission
+  uint8_t mode1_flag;
+  /// Indicator that 20 MHz channel uses 3/4 sampling frequency
+  //uint8_t threequarter_fs;
+  /// Size of FFT
+  uint16_t ofdm_symbol_size;
+  /// Number of prefix samples in all but first symbol of slot
+  uint16_t nb_prefix_samples;
+  /// Number of prefix samples in first symbol of slot
+  uint16_t nb_prefix_samples0;
+  /// Carrier offset in FFT buffer for first RE in PRB0
+  uint16_t first_carrier_offset;
+  /// Number of samples in a subframe
+  uint32_t samples_per_tti;
+  /// Number of OFDM/SC-FDMA symbols in one subframe (to be modified to account for potential different in UL/DL)
+  uint16_t symbols_per_tti;
+  /// Number of Physical transmit antennas in node
+  uint8_t nb_antennas_tx;
+  /// Number of Receive antennas in node
+  uint8_t nb_antennas_rx;
+  /// Number of common transmit antenna ports in eNodeB (1 or 2)
+  uint8_t nb_antenna_ports_eNB;
+  /// NPRACH Config Common (from 36-331 RRC spec)
+  NPRACH_CONFIG_COMMON nprach_config_common;
+  /// NPDSCH Config Common (from 36-331 RRC spec)
+  NPDSCH_CONFIG_COMMON npdsch_config_common;
+  /// PUSCH Config Common (from 36-331 RRC spec)
+  NPUSCH_CONFIG_COMMON npusch_config_common;
+  /// UL Power Control (from 36-331 RRC spec)
+  UplinkPowerControlCommon_NB ul_power_control_config_common;
+  /// DL Gap
+  DL_GapConfig_NB DL_gap_config;
+  /// Size of SI windows used for repetition of one SI message (in frames)
+  uint8_t SIwindowsize;
+  /// Period of SI windows used for repetition of one SI message (in frames)
+  uint16_t SIPeriod;
+  int                 eutra_band;
+  uint32_t            dl_CarrierFreq;
+  uint32_t            ul_CarrierFreq;
+  uint8_t             CE;// CE level to determine the NPRACH Configuration
+
+} NB_DL_FRAME_PARMS;
+

openair2/LAYER2/MAC/IF_Module_nb_iot.c

+#include "openair2/PHY_INTERFACE/IF_Module_nb_iot.h"
+#include "LAYER2/MAC/extern.h"
+#include "LAYER2/MAC/proto_nb_iot.h"
+
+void UL_indication(UL_IND_t UL_INFO)
+{
+    int i=0;
+    UL_INFO.test=1;
+    if(UL_INFO.test == 1)
+        {
+          /*If there is a preamble, do the initiate RA procedure*/
+          if(UL_INFO.preamble_index && UL_INFO.timing_offset)
+              NB_initiate_ra_proc(UL_INFO.module_id,UL_INFO.CC_id,UL_INFO.frame,UL_INFO.preamble_index,UL_INFO.timing_offset,UL_INFO.subframe);
+
+          /*If there is a Uplink SDU (even MSG3, NAK) need to send to MAC*/
+          for(i=0;i<UL_INFO.UE_NUM;i++)
+              {
+                  /*For MSG3, Normal Uplink Data, NAK*/
+                  if(UL_INFO.UL_SPEC_Info[i].rntiP)
+                      NB_rx_sdu(UL_INFO.module_id,
+                                UL_INFO.CC_id,
+                                UL_INFO.frame,
+                                UL_INFO.subframe,
+                                UL_INFO.UL_SPEC_Info[i].rntiP,
+                                UL_INFO.UL_SPEC_Info[i].sdu,
+                                UL_INFO.UL_SPEC_Info[i].sdu_lenP,
+                                UL_INFO.UL_SPEC_Info[i].harq_pidP,
+                                UL_INFO.UL_SPEC_Info[i].msg3_flagP
+                                );
+                    
+
+              }
+        }
+
+    NB_eNB_dlsch_ulsch_scheduler(UL_INFO.module_id,0,UL_INFO.frame,UL_INFO.subframe);
+}
+
+void Schedule_Response(Sched_Rsp_t Sched_INFO){
+      //todo
+}
\ No newline at end of file

openair2/LAYER2/MAC/eNB_scheduler_dlsch_nb_iot.c

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.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.openairinterface.org/?page_id=698
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+/*! \file eNB_scheduler_dlsch.c
+ * \brief procedures related to eNB for the DLSCH transport channel
+ * \author  Navid Nikaein and Raymond Knopp
+ * \date 2010 - 2014
+ * \email: navid.nikaein@eurecom.fr
+ * \version 1.0
+ * @ingroup _mac
+
+ */
+
+#include "assertions.h"
+#include "PHY/defs.h"
+#include "PHY/extern.h"
+
+#include "SCHED/defs.h"
+#include "SCHED/extern.h"
+
+#include "LAYER2/MAC/defs.h"
+#include "LAYER2/MAC/proto.h"
+#include "LAYER2/MAC/extern.h"
+#include "UTIL/LOG/log.h"
+#include "UTIL/LOG/vcd_signal_dumper.h"
+#include "UTIL/OPT/opt.h"
+#include "OCG.h"
+#include "OCG_extern.h"
+//NB-IoT
+#include "defs_nb_iot.h"
+#include "proto_nb_iot.h"
+
+#include "RRC/LITE/extern.h"
+#include "RRC/L2_INTERFACE/openair_rrc_L2_interface.h"
+
+//#include "LAYER2/MAC/pre_processor.c"
+#include "pdcp.h"
+
+#include "SIMULATION/TOOLS/defs.h" // for taus
+
+#if defined(ENABLE_ITTI)
+# include "intertask_interface.h"
+#endif
+
+#include "T.h"
+
+#define ENABLE_MAC_PAYLOAD_DEBUG
+//#define DEBUG_eNB_SCHEDULER 1
+
+
+uint8_t *NB_get_dlsch_sdu(
+  module_id_t module_idP,
+  int CC_id,
+  frame_t frameP,
+  rnti_t rntiP,
+  uint8_t TBindex
+)
+//------------------------------------------------------------------------------
+{
+
+  int UE_id;
+  eNB_MAC_INST_NB *eNB=&eNB_mac_inst_NB[module_idP];
+
+  /*for SIBs*/
+  if (rntiP==SI_RNTI) {
+    LOG_D(MAC,"[eNB %d] CC_id %d Frame %d Get DLSCH sdu for BCCH \n", module_idP, CC_id, frameP);
+
+    return((unsigned char *)&eNB->common_channels[CC_id].BCCH_pdu.payload[0]);
+  }
+
+  UE_id = find_UE_id(module_idP,rntiP);
+
+  if (UE_id != -1) {
+    LOG_D(MAC,"[eNB %d] Frame %d:  CC_id %d Get DLSCH sdu for rnti %x => UE_id %d\n",module_idP,frameP,CC_id,rntiP,UE_id);
+    return((unsigned char *)&eNB->UE_list.DLSCH_pdu[CC_id][TBindex][UE_id].payload[0]);
+  } else {
+    LOG_E(MAC,"[eNB %d] Frame %d: CC_id %d UE with RNTI %x does not exist\n", module_idP,frameP,CC_id,rntiP);
+    return NULL;
+  }
+
+}
+
+

openair2/LAYER2/MAC/eNB_scheduler_primitives_nb_iot.c

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.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.openairinterface.org/?page_id=698
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+/*! \file eNB_scheduler_primitives.c
+ * \brief primitives used by eNB for BCH, RACH, ULSCH, DLSCH scheduling
+ * \author  Navid Nikaein and Raymond Knopp
+ * \date 2010 - 2014
+ * \email: navid.nikaein@eurecom.fr
+ * \version 1.0
+ * @ingroup _mac
+
+ */
+
+#include "assertions.h"
+#include "PHY/defs.h"
+#include "PHY/extern.h"
+
+#include "SCHED/defs.h"
+#include "SCHED/extern.h"
+
+#include "LAYER2/MAC/defs.h"
+#include "LAYER2/MAC/extern.h"
+
+#include "LAYER2/MAC/proto.h"
+#include "UTIL/LOG/log.h"
+#include "UTIL/LOG/vcd_signal_dumper.h"
+#include "UTIL/OPT/opt.h"
+#include "OCG.h"
+#include "OCG_extern.h"
+
+#include "RRC/LITE/extern.h"
+#include "RRC/L2_INTERFACE/openair_rrc_L2_interface.h"
+//NB-IoT
+#include "defs_nb_iot.h"
+#include "proto_nb_iot.h"
+//#include "LAYER2/MAC/pre_processor.c"
+#include "pdcp.h"
+
+#if defined(ENABLE_ITTI)
+# include "intertask_interface.h"
+#endif
+
+#define ENABLE_MAC_PAYLOAD_DEBUG
+#define DEBUG_eNB_SCHEDULER 1
+
+/*TODO NB_mac_phy_remove_ue*/
+
+
+int NB_rrc_mac_remove_ue(
+		module_id_t mod_idP,
+		rnti_t rntiP)
+{
+  int i;
+  UE_list_NB_t *UE_list = &eNB_mac_inst_NB[mod_idP].UE_list;
+  int UE_id = find_UE_id(mod_idP,rntiP); //may should be changed
+  int pCC_id;
+
+  if (UE_id == -1) {
+printf("MAC: cannot remove UE rnti %x\n", rntiP);
+    LOG_W(MAC,"NB_rrc_mac_remove_ue: UE %x not found\n", rntiP);
+    //NB_mac_phy_remove_ue(mod_idP, rntiP);
+    return 0;
+  }
+
+  pCC_id = UE_PCCID(mod_idP,UE_id);
+
+printf("MAC: remove UE %d rnti %x\n", UE_id, rntiP);
+  LOG_I(MAC,"Removing UE %d from Primary CC_id %d (rnti %x)\n",UE_id,pCC_id, rntiP);
+  //dump_ue_list(UE_list,0); //may should be changed
+
+  UE_list->active[UE_id] = FALSE;
+  UE_list->num_UEs--;
+
+  // clear all remaining pending transmissions no lcgid in NB-IoT
+  /*UE_list->UE_template[pCC_id][UE_id].bsr_info[LCGID0]  = 0;
+  UE_list->UE_template[pCC_id][UE_id].bsr_info[LCGID1]  = 0;
+  UE_list->UE_template[pCC_id][UE_id].bsr_info[LCGID2]  = 0;
+  UE_list->UE_template[pCC_id][UE_id].bsr_info[LCGID3]  = 0;*/
+
+  //UE_list->UE_template[pCC_id][UE_id].ul_SR             = 0;
+  UE_list->UE_template[pCC_id][UE_id].rnti              = NOT_A_RNTI;
+  UE_list->UE_template[pCC_id][UE_id].ul_active         = FALSE;
+  eNB_ulsch_info[mod_idP][pCC_id][UE_id].rnti                        = NOT_A_RNTI;
+  eNB_ulsch_info[mod_idP][pCC_id][UE_id].status                      = S_UL_NONE;
+  eNB_dlsch_info[mod_idP][pCC_id][UE_id].rnti                        = NOT_A_RNTI;
+  eNB_dlsch_info[mod_idP][pCC_id][UE_id].status                      = S_DL_NONE;
+
+  //NB_mac_phy_remove_ue(mod_idP,rntiP);
+
+  // check if this has an RA process active
+  RA_TEMPLATE_NB *RA_template;
+  for (i=0;i<NB_RA_PROC_MAX;i++) {
+    RA_template = (RA_TEMPLATE_NB *)&eNB_mac_inst_NB[mod_idP].common_channels[pCC_id].RA_template[i];
+    if (RA_template->rnti == rntiP){
+      RA_template->RA_active=FALSE;
+      RA_template->generate_rar=0;
+      RA_template->generate_Msg4=0;
+      RA_template->wait_ack_Msg4=0;
+      RA_template->timing_offset=0;
+      RA_template->RRC_timer=20;
+      RA_template->rnti = 0;
+      //break;
+    }
+  }
+
+  return 0;
+}
+
+//------------------------------------------------------------------------------
+DCI_PDU_NB *NB_get_dci_sdu(module_id_t module_idP, int CC_id,frame_t frameP, sub_frame_t subframeP)
+//------------------------------------------------------------------------------
+{
+
+  return(&eNB_mac_inst_NB[module_idP].common_channels[CC_id].DCI_pdu);
+
+}
+
+//NB_UL_failure_indication... some of the used primitive haven't defined
+

openair2/LAYER2/MAC/extern.h

@@ -45,6 +45,7 @@
 #endif //PHY_EMUL
 #include "PHY_INTERFACE/defs.h"
 #include "RRC/LITE/defs.h"
+#include "defs_nb_iot.h"
 
 extern const uint32_t BSR_TABLE[BSR_TABLE_SIZE];
 //extern uint32_t EBSR_Level[63];

openair2/LAYER2/MAC/proto_nb_iot.h

+/*
+ * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The OpenAirInterface Software Alliance licenses this file to You under
+ * the OAI Public License, Version 1.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.openairinterface.org/?page_id=698
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *-------------------------------------------------------------------------------
+ * For more information about the OpenAirInterface (OAI) Software Alliance:
+ *      contact@openairinterface.org
+ */
+
+/*! \file LAYER2/MAC/proto.h
+ * \brief MAC functions prototypes for eNB and UE
+ * \author Navid Nikaein and Raymond Knopp
+ * \date 2010 - 2014
+ * \email navid.nikaein@eurecom.fr
+ * \version 1.0
+ */
+
+ 
+
+
+/** \addtogroup _mac
+ *  @{
+ */
+
+/*for NB-IoT*/
+
+/* \brief Function to indicate a received SDU on ULSCH for NB-IoT.
+*/
+void NB_rx_sdu(const module_id_t module_idP, const int CC_id,const frame_t frameP, const sub_frame_t subframeP, const rnti_t rnti, uint8_t *sdu, const uint16_t sdu_len, const int harq_pid,uint8_t *msg3_flag);
+
+/* \brief Function to retrieve result of scheduling (DCI) in current subframe.  Can be called an arbitrary numeber of times after eNB_dlsch_ulsch_scheduler
+in a given subframe. 
+*/
+DCI_PDU_NB *NB_get_dci_sdu(module_id_t module_idP,int CC_id,frame_t frameP,sub_frame_t subframe);
+
+
+/* \brief Function to trigger the eNB scheduling procedure.  It is called by PHY at the beginning of each subframe, \f$n$\f
+   and generates all DLSCH allocations for subframe \f$n\f$ and ULSCH allocations for subframe \f$n+k$\f. The resultant DCI_PDU is
+   ready after returning from this call.
+
+*/
+void NB_eNB_dlsch_ulsch_scheduler(module_id_t module_idP, uint8_t cooperation_flag, frame_t frameP, sub_frame_t subframeP);
+
+/* \brief Function to indicate a received preamble on PRACH.  It initiates the RA procedure.
+    In NB-IoT, it indicate preamble using the frequency to indicate the preamble.
+*/
+void NB_schedule_RA(module_id_t module_idP,frame_t frameP, sub_frame_t subframeP);
+
+void NB_initiate_ra_proc(module_id_t module_idP, int CC_id,frame_t frameP, uint16_t preamble_index,int16_t timing_offset,sub_frame_t subframeP);
+
+uint8_t *NB_get_dlsch_sdu(module_id_t module_idP,int CC_id,frame_t frameP,rnti_t rnti,uint8_t TBindex);
+
+
+int NB_rrc_mac_remove_ue(module_id_t Mod_id, rnti_t rntiP);
+
+int NB_l2_init_eNB(LTE_DL_FRAME_PARMS *frame_parms,int eMBMS_active, char *uecap_xer,uint8_t cba_group_active, uint8_t HO_active);
+
+
+

openair2/LAYER2/MAC/vars.h

@@ -41,6 +41,9 @@
 #include "PHY_INTERFACE/defs.h"
 #include "COMMON/mac_rrc_primitives.h"
 
+//NB-IoT
+eNB_MAC_INST_NB *eNB_mac_inst_NB;
+
 const uint32_t BSR_TABLE[BSR_TABLE_SIZE]= {0,10,12,14,17,19,22,26,31,36,42,49,57,67,78,91,
                                            105,125,146,171,200,234,274,321,376,440,515,603,706,826,967,1132,
                                            1326,1552,1817,2127,2490,2915,3413,3995,4677,5467,6411,7505,8787,10287,12043,14099,

openair2/PHY_INTERFACE/IF_Module_nb_iot.h

+
+/*This is the interface module between PHY
+* this will trigger the corresponding function in MAC or PHY layer according to the type of the message
+*
+*
+*
+*/
+
+
+#include "platform_types.h"
+#include "openair1/PHY/LTE_TRANSPORT/dci_nb_iot.h"
+
+
+
+#define NUMBER_OF_UE_MAX 20
+
+typedef struct{
+	
+//flag to show which message is
+uint8_t UL_MSG_flag;
+
+//rnti
+rnti_t rntiP;
+//Pointer to sdu
+uint8_t *sdu;
+//Pointer to sdu length 
+uint16_t sdu_lenP;
+//HARQ ID
+int harq_pidP;
+//MSG3 flag
+uint8_t *msg3_flagP;
+//ACK/NAK
+boolean_t NAK;
+// ULSCH consecutive error
+uint32_t ulsch_consecutive_errors;
+
+}UL_SPEC_t;
+
+//UL_IND
+typedef struct{
+
+ /*Start at the common part*/
+
+ int test;
+ //Module ID
+ module_id_t module_id;
+ //CC ID
+ int CC_id;
+ //frame 
+ frame_t frame;
+ //subframe
+ sub_frame_t subframe;
+ //Number of availble UE
+ int UE_NUM;
+
+ /*preamble part*/
+ //index of the preamble
+ uint16_t preamble_index;
+ //timing offset by PHY
+ int16_t timing_offset;
+
+ /*UE specific part*/
+ UL_SPEC_t UL_SPEC_Info[NUMBER_OF_UE_MAX]; 
+
+ }UL_IND_t;
+
+
+typedef struct{
+
+ /*Common part*/
+ module_id_t module_idP; 
+ int CC_id;
+ frame_t frameP;
+ sub_frame_t subframeP;
+
+ rnti_t rntiP;
+
+ /*Downlink data*/
+ //TB size for Downlink data
+ uint8_t TBindex;
+ //PDU for MIB,SIBs
+ uint8_t *BCCH_pdu_payload;
+ //PDU for DL-SCH
+ uint8_t *DLSCH_pdu_payload;
+
+ /*DCI start*/
+ // Format of DCI
+ uint8_t DCI_Format;
+ // Content of DCI
+ DCI_CONTENT DCI_Content;
+
+}Sched_Rsp_t;
+
+/*Interface for uplink, transmitting the Preamble(list), ULSCH SDU, NAK, Tick (trigger scheduler)
+*/
+void UL_indication(UL_IND_t UL_INFO);
+
+/*Interface for Downlink, transmitting the DLSCH SDU, DCI SDU*/
+void Schedule_Response(Sched_Rsp_t Sched_INFO);
+
+/*Interface for Configuration*/
+//void Config_Request();

openair2/RRC/LITE/rrc_eNB.c

@@ -128,50 +128,8 @@ init_SI(
 #if defined(Rel10) || defined(Rel14)
   int                                 i;
 #endif
-  /*
-     uint32_t mib=0;
-     int i;
-     int N_RB_DL,phich_resource;
-
-     do_MIB(enb_mod_idP, mac_xface->lte_frame_parms,0x321,&mib);
-
-     for (i=0;i<1024;i+=4)
-     do_MIB(enb_mod_idP, mac_xface->lte_frame_parms,i,&mib);
-
-     N_RB_DL=6;
-     while (N_RB_DL != 0) {
-     phich_resource = 1;
-     while (phich_resource != 0) {
-     for (i=0;i<2;i++) {
-     mac_xface->lte_frame_parms->N_RB_DL = N_RB_DL;
-     mac_xface->lte_frame_parms->phich_config_common.phich_duration=i;
-     mac_xface->lte_frame_parms->phich_config_common.phich_resource = phich_resource;
-     do_MIB(enb_mod_idP, mac_xface->lte_frame_parms,0,&mib);
-     }
-     if (phich_resource == 1)
-     phich_resource = 3;
-     else if (phich_resource == 3)
-     phich_resource = 6;
-     else if (phich_resource == 6)
-     phich_resource = 12;
-     else if (phich_resource == 12)
-     phich_resource = 0;
-     }
-     if (N_RB_DL == 6)
-     N_RB_DL = 15;
-     else if (N_RB_DL == 15)
-     N_RB_DL = 25;
-     else if (N_RB_DL == 25)
-     N_RB_DL = 50;
-     else if (N_RB_DL == 50)
-     N_RB_DL = 75;
-     else if (N_RB_DL == 75)
-     N_RB_DL = 100;
-     else if (N_RB_DL == 100)
-     N_RB_DL = 0;
-     }
-     exit(-1);
-   */
+  /*Nick Start*/
+  /*Here will copy basic parameters and implement do_MIB, rrc_eNB_carrier_data_t will add some parameters in MIB*/
 
   eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].sizeof_SIB1 = 0;
   eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].sizeof_SIB23 = 0;
@@ -185,6 +143,7 @@ init_SI(
    */
 
   if (eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].SIB1)
+  	/*the I/O of do_SIB1 will modify, the parameters like SIB1 siblock1 sib1 will assign in the carrier structure */
     eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].sizeof_SIB1 = do_SIB1(
           ctxt_pP->module_id,
           CC_id,
@@ -215,6 +174,7 @@ init_SI(
   eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].SIB23 = (uint8_t*) malloc16(64);
 
   if (eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].SIB23) {
+  	/*Modify as do_sib1*/
     eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].sizeof_SIB23 = do_SIB23(
           ctxt_pP->module_id,
           CC_id,
@@ -232,16 +192,7 @@ init_SI(
 #endif
         );
 
-    /*
-       eNB_rrc_inst[ctxt_pP->module_id].sizeof_SIB23 = do_SIB2_AT4(ctxt_pP->module_id,
-       eNB_rrc_inst[ctxt_pP->module_id].SIB23,
-       &eNB_rrc_inst[ctxt_pP->module_id].systemInformation,
-       &eNB_rrc_inst[ctxt_pP->module_id].sib2,
-       #if defined(ENABLE_ITTI)
-       , configuration
-       #endif
-       );
-     */
+
     if (eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].sizeof_SIB23 == 255) {
       mac_xface->macphy_exit("[RRC][init_SI] FATAL, eNB_rrc_inst[mod].carrier[CC_id].sizeof_SIB23 == 255");
     }
@@ -322,6 +273,7 @@ init_SI(
     LOG_D(RRC,
           PROTOCOL_RRC_CTXT_FMT" RRC_UE --- MAC_CONFIG_REQ (SIB1.tdd & SIB2 params) ---> MAC_UE\n",
           PROTOCOL_RRC_CTXT_ARGS(ctxt_pP));
+    /*modify to rrc_mac_config_req_eNB*/
     rrc_mac_config_req(ctxt_pP->module_id, CC_id, ENB_FLAG_YES, 0, 0,
                        (RadioResourceConfigCommonSIB_t *) &
                        eNB_rrc_inst[ctxt_pP->module_id].carrier[CC_id].sib2->radioResourceConfigCommon,

record.txt

+Develop record:
+
+Nick (nick133371@gmail.com)
+
+
+5/13 
+Add:	    openair1/PHY/impl_defs_lte_nb_iot.h
+Add:        openair1/PHY/INIT/defs_nb_iot.h
+Add:        openair1/PHY/INIT/Lte_init_nb_iot.c
+
+Comment: 
+Functions: NB_phy_config_mib_eNB(), NB_phy_config_sib2_eNB(), NB_phy_config_dedicated_eNB().
+Parameters: NB_DL_FRAME_PARAMS(Original LTE_DL_FRAME_PARAMS)
+
+5/14
+Add:        openair2/Layer2/MAC/defs_nb_iot.h
+Add:        openair2/Layer2/MAC/proto_nb_iot.h
+Add:        openair2/Layer2/MAC/eNB_scheduler_ulsch_nb_iot.c
+Add:        openair2/Layer2/MAC/eNB_scheduler_prmitives_nb_iot.c
+Add:        openair2/Layer2/MAC/eNB_scheduler_dlsch_nb_iot.c
+
+comment:
+Functions: NB_rx_sdu(), NB_get_dci_sdu(), NB_rrc_mac_remove_ue(), NB_get_dlsch_sdu();
+Parameters: All parameters/structures used in MAC Layer.
+
+5/15
+Add:        openair2/Layer2/MAC/eNB_scheduler_RA_nb_iot.c
+
+comment:
+Functions: NB_initiate_ra_proc()
+
+5/15
+modified:   openair1/PHY/LTE_TRANSPORT/dci_nb_iot.h
+modified:   openair1/PHY/LTE_TRANSPORT/defs.hod
+modified:   openair2/LAYER2/MAC/eNB_scheduler_RA_nb_iot.c
+modified:   openair2/LAYER2/MAC/proto_nb_iot.h
+
+comment:
+Functions: NB_schedule_RA()
+Parameters: Add DCI unpacked format 
+
+5/16
+Add:	    openair2/LAYER2/MAC/IF_Module_nb_iot.c
+Add:        openair2/PHY_INTERFACE/IF_Module_nb_iot.h
+Add:        openair1/PHY/sched/phy_procedures_lte_eNB_nb_iot.c
+
+Comment: Modify NB_phy_procedures_uespec_RX, change the way using primitive, use UL_IND data structure to store the needed parameters.
+	 Add the implementation for UL_INDICATION, it handles the Uplink information from PHY, also trigger the scheduler.
+Functions: NB_phy_procedures_uespec_RX(), UL_INDICATION()
+Parameters: UL_IND for Interface Module
+
+5/18
+Modified:   openair1/PHY/LTE_TRANSPORT/dci_nb_iot.h
+Modified:   openair2/PHY_INTERFACE/IF_Module_nb_iot.h
+Modified:   openair2/LAYER2/MAC/IF_Module_nb_iot.c
+
+Comment: Complete the UL_INDICATION
+Functions: UL_INDICATION()
+Parameters: Sched_Rsp for Interface Module
+
+5/19
+
+Comment: 15 warnings fixed 
+

targets/DOCS/NB-IoT_Docs/Readme

+NB-IoT_Docs Folder
+    BMW lab./NTUST
+
+        Document list:
+
+            1. images - The figures of the Message Sequence Chart compared LTE with NB-IoT, in Attach/MT/MO.
+            
+            2. NB_L2_interface - Describe the interface between MAC and other layers (mainly PHY layer), and show the basic concept for development.
+            
+            3. NB_MAC_Design_Document - This document is mainly describing about the NB-IoT MAC module design based on OAI in the system/block/process/procedure side.
+            
+            4. NB_MAC_Module_List - This document is mainly descrbing about the difference beween MAC in LTE and NB-IoT from 3gpp specification.
+            
+            5. NB_MAC_SAP - This document is mainly describling about the Service Access Point (primitives) between the MAC and other layers in OAI.
+            
+            6. NB_MAC_Fapi_interface - This document is mainly for the FAPI style interface between OAI MAC and PHY for NB-IoT, and described how old messages in OAI go through in the FAPI style interface.
+    
+
+If there is anything wrong, please do not hesitate to contact us, Thanks!
+
+Advisor : Prof.Ray Guang, Cheng 	crg@mail.ntust.edu.tw
+
+The response block for each person:
+
+Scheduling:Eric	                    qqq1993qqq029@gmail.com
+DownlinkProcedure:Xavier/Alan       sephiroth7277@gmail.com/Rely4679@gmail.com
+UplinkProcedure:Nick                nick133371@gmail.com
+Config:Kenny                        kroempa@gmail.com
+SystemInformation:Calvin            calvin820119@gmail.com
+
+                                                                                                                                                 20170405
\ No newline at end of file