ghaddab
c23783c702
git-svn-id: http://svn.eurecom.fr/openair4G/trunk@5714 818b1a75-f10b-46b9-bf7c-635c3b92a50f
198 lines
6.7 KiB
C
Executable File
198 lines
6.7 KiB
C
Executable File
/*******************************************************************************
|
|
OpenAirInterface
|
|
Copyright(c) 1999 - 2014 Eurecom
|
|
|
|
OpenAirInterface is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
|
|
OpenAirInterface is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with OpenAirInterface.The full GNU General Public License is
|
|
included in this distribution in the file called "COPYING". If not,
|
|
see <http://www.gnu.org/licenses/>.
|
|
|
|
Contact Information
|
|
OpenAirInterface Admin: openair_admin@eurecom.fr
|
|
OpenAirInterface Tech : openair_tech@eurecom.fr
|
|
OpenAirInterface Dev : openair4g-devel@eurecom.fr
|
|
|
|
Address : Eurecom, Campus SophiaTech, 450 Route des Chappes, CS 50193 - 06904 Biot Sophia Antipolis cedex, FRANCE
|
|
|
|
*******************************************************************************/
|
|
/*
|
|
pdcp_primitives.h
|
|
-------------------
|
|
AUTHOR : Baris Demiray
|
|
COMPANY : EURECOM
|
|
EMAIL : Baris.Demiray@eurecom.fr
|
|
***************************************************************************/
|
|
|
|
#ifndef PDCP_PRIMITIVES_H
|
|
#define PDCP_PRIMITIVES_H
|
|
|
|
/*
|
|
* 3GPP TS 36.323 V10.1.0 (2011-03)
|
|
*/
|
|
|
|
/*
|
|
* Data or control (1-bit, see 6.3.7)
|
|
*/
|
|
#define PDCP_CONTROL_PDU_BIT_SET 0x00
|
|
#define PDCP_DATA_PDU_BIT_SET 0x01
|
|
|
|
/*
|
|
* PDU-type (3-bit, see 6.3.8)
|
|
*/
|
|
#define PDCP_STATUS_REPORT 0x00
|
|
#define INTERSPERSED_ROHC_FEEDBACK_PACKET 0x01
|
|
|
|
/*
|
|
* 6.1 Protocol Data Units
|
|
* 6.2.2 Control Plane PDCP Data PDU
|
|
*/
|
|
#define PDCP_CONTROL_PLANE_DATA_PDU_SN_SIZE 1
|
|
#define PDCP_CONTROL_PLANE_DATA_PDU_MAC_I_SIZE 4
|
|
typedef struct {
|
|
uint8_t sn; // PDCP sequence number will wrap around 2^5-1 so
|
|
// reserved field is unnecessary here
|
|
uint8_t mac_i[PDCP_CONTROL_PLANE_DATA_PDU_MAC_I_SIZE]; // Integration protection is not implemented (pad with 0)
|
|
} pdcp_control_plane_data_pdu_header;
|
|
|
|
/*
|
|
* 6.2.3 User Plane PDCP Data PDU with long PDCP SN (12-bit)
|
|
*/
|
|
typedef struct {
|
|
uint8_t dc; // Data or control (see 6.3.7)
|
|
uint16_t sn; // 12-bit sequence number
|
|
} pdcp_user_plane_data_pdu_header_with_long_sn;
|
|
#define PDCP_USER_PLANE_DATA_PDU_LONG_SN_HEADER_SIZE 2
|
|
|
|
/*
|
|
* 6.2.4 User Plane PDCP Data PDU with short PDCP SN (7-bit)
|
|
*/
|
|
typedef struct {
|
|
uint8_t dc;
|
|
uint8_t sn; // 7-bit sequence number
|
|
} pdcp_user_plane_data_pdu_header_with_short_sn;
|
|
#define PDCP_USER_PLANE_DATA_PDU_SHORT_SN_HEADER_SIZE 1
|
|
|
|
/*
|
|
* 6.2.5 PDCP Control PDU for interspersed ROHC feedback packet
|
|
*/
|
|
typedef struct {
|
|
uint8_t dc;
|
|
uint8_t pdu_type; // PDU type (see 6.3.8)
|
|
} pdcp_control_pdu_for_interspersed_rohc_feedback_packet_header;
|
|
#define PDCP_CONTROL_PDU_INTERSPERSED_ROHC_FEEDBACK_HEADER_SIZE 1
|
|
|
|
/*
|
|
* 6.2.6 PDCP Control PDU for PDCP status report
|
|
*/
|
|
typedef struct {
|
|
uint8_t dc;
|
|
uint8_t pdu_type; // PDU type (see 6.3.8)
|
|
uint16_t first_missing_sn; // First missing PDCP SN
|
|
unsigned char* window_bitmap; // Ack/Nack information coded as a bitmap
|
|
uint16_t window_bitmap_size;
|
|
} pdcp_control_pdu_for_pdcp_status_report;
|
|
/*
|
|
* Following symbolic constant is the size of FIXED part of this PDU
|
|
* so bitmap size should be added to find total header size
|
|
*/
|
|
#define PDCP_CONTROL_PDU_STATUS_REPORT_HEADER_SIZE 2
|
|
|
|
/*
|
|
* Parses data/control field out of buffer of User Plane PDCP Data PDU with
|
|
* long PDCP SN (12-bit)
|
|
*
|
|
* @param pdu_buffer PDCP PDU buffer
|
|
* @return 1 bit dc
|
|
*/
|
|
|
|
uint8_t pdcp_get_dc_filed(unsigned char* pdu_buffer);
|
|
|
|
/*
|
|
* Parses sequence number out of buffer of User Plane PDCP Data PDU with
|
|
* long PDCP SN (12-bit)
|
|
*
|
|
* @param pdu_buffer PDCP PDU buffer
|
|
* @return 12-bit sequence number
|
|
*/
|
|
uint16_t pdcp_get_sequence_number_of_pdu_with_long_sn(unsigned char* pdu_buffer);
|
|
|
|
/*
|
|
* Parses sequence number out of buffer of User Plane PDCP Data PDU with
|
|
* short PDCP SN (7-bit)
|
|
*
|
|
* @param pdu_buffer PDCP PDU buffer
|
|
* @return 7-bit sequence number
|
|
*/
|
|
uint8_t pdcp_get_sequence_number_of_pdu_with_short_sn(unsigned char* pdu_buffer);
|
|
|
|
/*
|
|
* Parses sequence number out of buffer of Control Plane PDCP Data PDU with
|
|
* short PDCP SN (5-bit)
|
|
*
|
|
* @param pdu_buffer PDCP PDU buffer
|
|
* @return 5-bit sequence number
|
|
*/
|
|
uint8_t pdcp_get_sequence_number_of_pdu_with_SRB_sn(unsigned char* pdu_buffer);
|
|
|
|
/*
|
|
* Fills the incoming buffer with the fields of the header for SRB1
|
|
*
|
|
* @param pdu_buffer PDCP PDU buffer
|
|
* @return TRUE on success, FALSE otherwise
|
|
*/
|
|
boolean_t pdcp_serialize_control_plane_data_pdu_with_SRB_sn_buffer(unsigned char* pdu_buffer, \
|
|
pdcp_control_plane_data_pdu_header* pdu);
|
|
/*
|
|
* Fills the incoming buffer with the fields of the header for long SN (RLC UM and AM)
|
|
*
|
|
* @param pdu_buffer PDCP PDU buffer
|
|
* @return TRUE on success, FALSE otherwise
|
|
*/
|
|
boolean_t pdcp_serialize_user_plane_data_pdu_with_long_sn_buffer(unsigned char* pdu_buffer, \
|
|
pdcp_user_plane_data_pdu_header_with_long_sn* pdu);
|
|
|
|
/*
|
|
* Fills the incoming status report header with given value of bitmap
|
|
* and 'first missing pdu' sequence number
|
|
*
|
|
* @param FMS First Missing PDCP SN
|
|
* @param bitmap Received/Missing sequence number bitmap
|
|
* @param pdu A status report header
|
|
* @return TRUE on success, FALSE otherwise
|
|
*/
|
|
boolean_t pdcp_serialize_control_pdu_for_pdcp_status_report(unsigned char* pdu_buffer, \
|
|
uint8_t bitmap[512], pdcp_control_pdu_for_pdcp_status_report* pdu);
|
|
|
|
int pdcp_netlink_dequeue_element(module_id_t enb_mod_idP, module_id_t ue_mod_idP, eNB_flag_t eNB_flagP,
|
|
struct pdcp_netlink_element_s **data_ppP);
|
|
|
|
void pdcp_config_set_security(pdcp_t *pdcp_pP, module_id_t enb_mod_idP, module_id_t ue_mod_idP, frame_t frameP, eNB_flag_t eNB_flagP, rb_id_t rb_idP,
|
|
uint16_t lc_idP, uint8_t security_modeP, uint8_t *kRRCenc_pP, uint8_t *kRRCint_pP, uint8_t *kUPenc_pP);
|
|
|
|
#if defined(ENABLE_SECURITY)
|
|
int pdcp_apply_security(pdcp_t *pdcp_entity,
|
|
srb_flag_t srb_flagP,
|
|
rb_id_t rb_id,
|
|
uint8_t pdcp_header_len, uint16_t current_sn, uint8_t *pdcp_pdu_buffer,
|
|
uint16_t sdu_buffer_size);
|
|
|
|
int pdcp_validate_security(pdcp_t *pdcp_entity,
|
|
srb_flag_t srb_flagP,
|
|
rb_id_t rb_id,
|
|
uint8_t pdcp_header_len, uint16_t current_sn, uint8_t *pdcp_pdu_buffer,
|
|
uint16_t sdu_buffer_size);
|
|
#endif /* defined(ENABLE_SECURITY) */
|
|
|
|
#endif
|