/** * * \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 MACPDU_H #define MACPDU_H #include #include "srslte/common/log.h" #include "srslte/common/interfaces_common.h" #include #include /* MAC PDU Packing/Unpacking functions. Section 6 of 36.321 */ namespace srslte { template class pdu { public: pdu(uint32_t max_subheaders_) : subheaders(max_subheaders_) { max_subheaders = max_subheaders_; nof_subheaders = 0; cur_idx = -1; pdu_len = 0; rem_len = 0; last_sdu_idx = -1; pdu_is_ul = false; buffer_tx = NULL; total_sdu_len = 0; } void fprint(FILE *stream) { fprintf(stream, "Number of Subheaders: %d\n", nof_subheaders); for (int i=0;i 0) { nof_subheaders++; next(); return true; } else { return false; } } bool next() { if (cur_idx < nof_subheaders - 1) { cur_idx++; return true; } else { return false; } } void del_subh() { if (nof_subheaders > 0) { nof_subheaders--; } if (cur_idx > 0) { cur_idx--; } } SubH* get() { if (cur_idx >= 0) { return &subheaders[cur_idx]; } else { return NULL; } } bool is_ul() { return pdu_is_ul; } uint8_t* get_current_sdu_ptr() { return &buffer_tx[total_sdu_len+sdu_offset_start]; } void add_sdu(uint32_t sdu_sz) { total_sdu_len += sdu_sz; } // Section 6.1.2 void parse_packet(uint8_t *ptr) { uint8_t *init_ptr = ptr; nof_subheaders = 0; while(subheaders[nof_subheaders].read_subheader(&ptr)) { nof_subheaders++; } nof_subheaders++; for (int i=0;i subheaders; uint32_t pdu_len; uint32_t rem_len; int cur_idx; int nof_subheaders; uint32_t max_subheaders; bool pdu_is_ul; uint8_t* buffer_tx; uint32_t total_sdu_len; uint32_t sdu_offset_start; int last_sdu_idx; private: /* Prepares the PDU for parsing or writing by setting the number of subheaders to 0 and the pdu length */ void init_(uint8_t *buffer_tx_ptr, uint32_t pdu_len_bytes, bool is_ulsch) { nof_subheaders = 0; pdu_len = pdu_len_bytes; rem_len = pdu_len; pdu_is_ul = is_ulsch; buffer_tx = buffer_tx_ptr; sdu_offset_start = max_subheaders*2 + 13; // Assuming worst-case 2 bytes per sdu subheader + all possible CE total_sdu_len = 0; last_sdu_idx = -1; reset(); for (uint32_t i=0;i class subh { public: virtual bool read_subheader(uint8_t** ptr) = 0; virtual void read_payload(uint8_t **ptr) = 0; virtual void write_subheader(uint8_t** ptr, bool is_last) = 0; virtual void write_payload(uint8_t **ptr) = 0; virtual void fprint(FILE *stream) = 0; pdu* parent; private: virtual void init() = 0; }; class sch_subh : public subh { public: typedef enum { PHR_REPORT = 26, CRNTI = 27, CON_RES_ID = 28, TRUNC_BSR = 28, TA_CMD = 29, SHORT_BSR = 29, DRX_CMD = 30, LONG_BSR = 30, PADDING = 31, SDU = 0 } cetype; // Size of MAC CEs const static int MAC_CE_CONTRES_LEN = 6; // Reading functions bool is_sdu(); cetype ce_type(); uint32_t size_plus_header(); void set_payload_size(uint32_t size); bool read_subheader(uint8_t** ptr); void read_payload(uint8_t **ptr); uint32_t get_sdu_lcid(); uint32_t get_payload_size(); uint32_t get_header_size(bool is_last); uint8_t* get_sdu_ptr(); uint16_t get_c_rnti(); uint64_t get_con_res_id(); uint8_t get_ta_cmd(); float get_phr(); int get_bsr(uint32_t buff_size[4]); // Writing functions void write_subheader(uint8_t** ptr, bool is_last); void write_payload(uint8_t **ptr); int set_sdu(uint32_t lcid, uint32_t nof_bytes, uint8_t *payload); int set_sdu(uint32_t lcid, uint32_t requested_bytes, read_pdu_interface *sdu_itf); bool set_c_rnti(uint16_t crnti); bool set_bsr(uint32_t buff_size[4], sch_subh::cetype format); bool set_con_res_id(uint64_t con_res_id); bool set_ta_cmd(uint8_t ta_cmd); bool set_phr(float phr); void set_padding(); void set_padding(uint32_t padding_len); void init(); void fprint(FILE *stream); private: static const int MAX_CE_PAYLOAD_LEN = 8; uint32_t lcid; int nof_bytes; uint8_t* payload; uint8_t w_payload_ce[8]; bool F_bit; uint32_t sizeof_ce(uint32_t lcid, bool is_ul); static uint8_t buff_size_table(uint32_t buffer_size); static uint8_t phr_report_table(float phr_value); }; class sch_pdu : public pdu { public: sch_pdu(uint32_t max_subh) : pdu(max_subh) {} void parse_packet(uint8_t *ptr); uint8_t* write_packet(); uint8_t* write_packet(srslte::log *log_h); bool has_space_ce(uint32_t nbytes); bool has_space_sdu(uint32_t nbytes); int get_pdu_len(); int rem_size(); int get_sdu_space(); static uint32_t size_header_sdu(uint32_t nbytes); bool update_space_ce(uint32_t nbytes); bool update_space_sdu(uint32_t nbytes); void fprint(FILE *stream); }; class rar_subh : public subh { public: static const uint32_t RAR_GRANT_LEN = 20; // Reading functions bool read_subheader(uint8_t** ptr); void read_payload(uint8_t** ptr); uint32_t get_rapid(); uint32_t get_ta_cmd(); uint16_t get_temp_crnti(); void get_sched_grant(uint8_t grant[RAR_GRANT_LEN]); // Writing functoins void write_subheader(uint8_t** ptr, bool is_last); void write_payload(uint8_t** ptr); void set_rapid(uint32_t rapid); void set_ta_cmd(uint32_t ta); void set_temp_crnti(uint16_t temp_rnti); void set_sched_grant(uint8_t grant[RAR_GRANT_LEN]); void init(); void fprint(FILE *stream); private: uint8_t grant[RAR_GRANT_LEN]; uint32_t ta; uint16_t temp_rnti; uint32_t preamble; }; class rar_pdu : public pdu { public: rar_pdu(uint32_t max_rars = 16); void set_backoff(uint8_t bi); bool has_backoff(); uint8_t get_backoff(); bool write_packet(uint8_t* ptr); void fprint(FILE *stream); private: bool has_backoff_indicator; uint8_t backoff_indicator; }; } // namespace srsue #endif // MACPDU_H