rrc_proto.h 5.5 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
/*
 * Licensed to the OpenAirInterface (OAI) Software Alliance under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The OpenAirInterface Software Alliance licenses this file to You under
 * the OAI Public License, Version 1.1  (the "License"); you may not use this file
 * except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.openairinterface.org/?page_id=698
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *-------------------------------------------------------------------------------
 * For more information about the OpenAirInterface (OAI) Software Alliance:
 *      contact@openairinterface.org
 */

22
/* \file proto.h
23
 * \brief RRC functions prototypes for eNB and UE
24 25 26 27 28 29 30
 * \author R. Knopp, K.H. HSU
 * \date 2018
 * \version 0.1
 * \company Eurecom / NTUST
 * \email: knopp@eurecom.fr, kai-hsiang.hsu@eurecom.fr
 * \note
 * \warning
31
 */
32

33 34
#ifndef _RRC_PROTO_H_
#define _RRC_PROTO_H_
35 36


37 38 39 40 41
#include "rrc_defs.h"
#include "NR_RRCReconfiguration.h"
#include "NR_MeasConfig.h"
#include "NR_CellGroupConfig.h"
#include "NR_RadioBearerConfig.h"
42 43 44 45
//
//  main_rrc.c
//
/**\brief Layer 3 initialization*/
46
NR_UE_RRC_INST_t* nr_l3_init_ue(char*);
47 48 49 50 51 52

//
//  UE_rrc.c
//

/**\brief Initial the top level RRC structure instance*/
53
NR_UE_RRC_INST_t* openair_rrc_top_init_ue_nr(char*);
54

55

56 57

/**\brief Decode RRC Connection Reconfiguration, sent from E-UTRA RRC Connection Reconfiguration v1510 carring EN-DC config
58 59
   \param buffer  encoded NR-RRC-Connection-Reconfiguration/Secondary-Cell-Group-Config message.
   \param size    length of buffer*/
60
//TODO check to use which one
61
//int8_t nr_rrc_ue_decode_rrcReconfiguration(const uint8_t *buffer, const uint32_t size);
62
int8_t nr_rrc_ue_decode_secondary_cellgroup_config(const module_id_t module_id, const uint8_t *buffer, const uint32_t size);
63
   
64 65

/**\brief Process NR RRC connection reconfiguration via SRB3
66
   \param rrcReconfiguration  decoded rrc connection reconfiguration*/
67
int8_t nr_rrc_ue_process_rrcReconfiguration(const module_id_t module_id, NR_RRCReconfiguration_t *rrcReconfiguration);
68 69

/**\prief Process measurement config from NR RRC connection reconfiguration message
70
   \param meas_config   measurement configuration*/
71
int8_t nr_rrc_ue_process_meas_config(NR_MeasConfig_t *meas_config);
72 73

/**\prief Process secondary cell group config from NR RRC connection reconfiguration message or EN-DC primitives
74
   \param cell_group_config   secondary cell group configuration*/
75
//TODO check EN-DC function call flow.
76
int8_t nr_rrc_ue_process_scg_config(const module_id_t module_id, NR_CellGroupConfig_t *cell_group_config);
77 78

/**\prief Process radio bearer config from NR RRC connection reconfiguration message
79
   \param radio_bearer_config    radio bearer configuration*/
80
int8_t nr_rrc_ue_process_radio_bearer_config(NR_RadioBearerConfig_t *radio_bearer_config);
81

82 83 84 85 86 87 88
/**\brief decode NR BCCH-BCH (MIB) message
   \param module_idP    module id
   \param gNB_index     gNB index
   \param sduP          pointer to buffer of ASN message BCCH-BCH
   \param sdu_len       length of buffer*/
int8_t nr_rrc_ue_decode_NR_BCCH_BCH_Message(const module_id_t module_id, const uint8_t gNB_index, uint8_t *const bufferP, const uint8_t buffer_len);

89
/**\brief decode NR SIB1 message
rmagueta's avatar
rmagueta committed
90 91
   \param module_idP    module id
   \param gNB_index     gNB index
92 93
   \param sduP          pointer to buffer of ASN message
   \param sdu_len       length of buffer*/
rmagueta's avatar
rmagueta committed
94
int8_t nr_rrc_ue_decode_NR_SIB1_Message(module_id_t module_id, uint8_t gNB_index, uint8_t *const bufferP, const uint8_t buffer_len);
95

96
/**\brief Decode NR DCCH from gNB, sent from lower layer through SRB3
97 98 99 100 101 102 103 104 105 106 107 108 109
   \param module_id  module id
   \param gNB_index  gNB index
   \param buffer     encoded DCCH bytes stream message
   \param size       length of buffer*/
int8_t nr_rrc_ue_decode_NR_DL_DCCH_Message(const module_id_t module_id, const uint8_t gNB_index, const uint8_t *buffer, const uint32_t size);

/**\brief interface between MAC and RRC thru SRB0 (RLC TM/no PDCP)
   \param module_id  module id
   \param CC_id      component carrier id
   \param gNB_index  gNB index
   \param channel    indicator for channel of the pdu
   \param pduP       pointer to pdu
   \param pdu_len    data length of pdu*/
110
int8_t nr_mac_rrc_data_ind_ue(const module_id_t module_id, const int CC_id, const uint8_t gNB_index, const channel_t channel, const uint8_t* pduP, const sdu_size_t pdu_len);
111

cig's avatar
cig committed
112 113 114 115 116 117 118 119 120 121 122 123
/**\brief
   \param module_id  module id
   \param CC_id      component carrier id
   \param frame_t    frameP
   \param rb_id_t    SRB id
   \param buffer_pP  pointer to buffer*/
int8_t mac_rrc_nr_data_req_ue(const module_id_t Mod_idP,
                              const int         CC_id,
                              const frame_t     frameP,
                              const rb_id_t     Srb_id,
                              uint8_t *const    buffer_pP);

heshanyun's avatar
heshanyun committed
124 125 126 127

/**\brief RRC UE task.
   \param void *args_p Pointer on arguments to start the task. */
void *rrc_nrue_task(void *args_p);
Xue Song's avatar
Xue Song committed
128 129 130 131 132 133

/**\brief RRC UE generate RRCSetupRequest message.
   \param ctxt_pP    protocol context 
   \param gNB_index  gNB index  */
void rrc_ue_generate_RRCSetupRequest( const protocol_ctxt_t *const ctxt_pP, const uint8_t gNB_index );

134
/** @}*/
WEI-TAI CHEN's avatar
WEI-TAI CHEN committed
135 136
#endif