/** * * \section COPYRIGHT * * Copyright 2013-2015 Software Radio Systems Limited * * \section LICENSE * * This file is part of the srsUE library. * * srsUE is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of * the License, or (at your option) any later version. * * srsUE 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 Affero General Public License for more details. * * A copy of the GNU Affero General Public License can be found in * the LICENSE file in the top-level directory of this distribution * and at http://www.gnu.org/licenses/. * */ #ifndef PDCP_ENTITY_H #define PDCP_ENTITY_H #include "srslte/common/buffer_pool.h" #include "srslte/common/log.h" #include "srslte/common/common.h" #include "srslte/interfaces/ue_interfaces.h" #include "srslte/common/security.h" #include "srslte/common/msg_queue.h" #include "srslte/common/threads.h" namespace srslte { /**************************************************************************** * Structs and Defines * Ref: 3GPP TS 36.323 v10.1.0 ***************************************************************************/ #define PDCP_CONTROL_MAC_I 0x00000000 #define PDCP_PDU_TYPE_PDCP_STATUS_REPORT 0x0 #define PDCP_PDU_TYPE_INTERSPERSED_ROHC_FEEDBACK_PACKET 0x1 typedef enum{ PDCP_D_C_CONTROL_PDU = 0, PDCP_D_C_DATA_PDU, PDCP_D_C_N_ITEMS, }pdcp_d_c_t; static const char pdcp_d_c_text[PDCP_D_C_N_ITEMS][20] = {"Control PDU", "Data PDU"}; /**************************************************************************** * PDCP Entity interface * Common interface for all PDCP entities ***************************************************************************/ class pdcp_entity :public thread { public: pdcp_entity(); void init(srsue::rlc_interface_pdcp *rlc_, srsue::rrc_interface_pdcp *rrc_, srsue::gw_interface_pdcp *gw_, srslte::log *log_, uint32_t lcid_, srslte_pdcp_config_t cfg_); void stop(); void reset(); bool is_active(); // RRC interface void write_sdu(byte_buffer_t *sdu); void config_security(uint8_t *k_rrc_enc_, uint8_t *k_rrc_int_, CIPHERING_ALGORITHM_ID_ENUM cipher_algo_, INTEGRITY_ALGORITHM_ID_ENUM integ_algo_); void enable_encryption(); // RLC interface void write_pdu(byte_buffer_t *pdu); private: byte_buffer_pool *pool; srslte::log *log; srsue::rlc_interface_pdcp *rlc; srsue::rrc_interface_pdcp *rrc; srsue::gw_interface_pdcp *gw; static const int PDCP_THREAD_PRIO = 7; srslte::msg_queue rx_pdu_queue; bool running; bool active; uint32_t lcid; srslte_pdcp_config_t cfg; bool do_integrity; bool do_encryption; uint32_t rx_count; uint32_t tx_count; uint8_t k_rrc_enc[32]; uint8_t k_rrc_int[32]; CIPHERING_ALGORITHM_ID_ENUM cipher_algo; INTEGRITY_ALGORITHM_ID_ENUM integ_algo; void integrity_generate(uint8_t *msg, uint32_t msg_len, uint8_t *mac); bool integrity_verify(uint8_t *msg, uint32_t count, uint32_t msg_len, uint8_t *mac); void cipher_encrypt(uint8_t *msg, uint32_t msg_len, uint8_t *ct); void cipher_decrypt(uint8_t *ct, uint32_t count, uint32_t ct_len, uint8_t *msg); void run_thread(); }; /**************************************************************************** * Pack/Unpack helper functions * Ref: 3GPP TS 36.323 v10.1.0 ***************************************************************************/ void pdcp_pack_control_pdu(uint32_t sn, byte_buffer_t *sdu); void pdcp_unpack_control_pdu(byte_buffer_t *sdu, uint32_t *sn); void pdcp_pack_data_pdu_short_sn(uint32_t sn, byte_buffer_t *sdu); void pdcp_unpack_data_pdu_short_sn(byte_buffer_t *sdu, uint32_t *sn); void pdcp_pack_data_pdu_long_sn(uint32_t sn, byte_buffer_t *sdu); void pdcp_unpack_data_pdu_long_sn(byte_buffer_t *sdu, uint32_t *sn); } // namespace srsue #endif // PDCP_ENTITY_H