/** * * \section COPYRIGHT * * Copyright 2013-2021 Software Radio Systems Limited * * By using this file, you agree to the terms and conditions set * forth in the LICENSE file which can be found at the top level of * the distribution. * */ #include "rlc_test_common.h" #include "srsran/upper/rlc_um_lte.h" #include #define TESTASSERT(cond) \ { \ if (!(cond)) { \ std::cout << "[" << __FUNCTION__ << "][Line " << __LINE__ << "]: FAIL at " << (#cond) << std::endl; \ return -1; \ } \ } #define MAX_NBUFS 100 #define NBUFS 5 using namespace srsran; using namespace srsue; // Helper class to create two pre-configured RLC instances class rlc_um_lte_test_context1 { public: rlc_um_lte_test_context1() : logger1(srslog::fetch_basic_logger("RLC_UM_1", false)), logger2(srslog::fetch_basic_logger("RLC_UM_2", false)), timers(16), rlc1(logger1, 3, &tester, &tester, &timers), rlc2(logger2, 3, &tester, &tester, &timers) { // setup logging logger1.set_level(srslog::basic_levels::debug); logger1.set_hex_dump_max_size(-1); logger2.set_level(srslog::basic_levels::debug); logger2.set_hex_dump_max_size(-1); // configure RLC entities rlc_config_t cnfg = rlc_config_t::default_rlc_um_config(10); if (rlc1.configure(cnfg) != true) { fprintf(stderr, "Couldn't configure RLC1 object\n"); } if (rlc2.configure(cnfg) != true) { fprintf(stderr, "Couldn't configure RLC2 object\n"); } tester.set_expected_sdu_len(1); } srslog::basic_logger& logger1; srslog::basic_logger& logger2; srsran::timer_handler timers; rlc_um_tester tester; rlc_um_lte rlc1, rlc2; }; int meas_obj_test() { rlc_um_lte_test_context1 ctxt; // Push 5 SDUs into RLC1 unique_byte_buffer_t sdu_bufs[NBUFS]; for (int i = 0; i < NBUFS; i++) { sdu_bufs[i] = srsran::make_byte_buffer(); *sdu_bufs[i]->msg = i; // Write the index into the buffer sdu_bufs[i]->N_bytes = 1; // Give each buffer a size of 1 byte ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } TESTASSERT(14 == ctxt.rlc1.get_buffer_state()); // Read 5 PDUs from RLC1 (1 byte each) byte_buffer_t pdu_bufs[NBUFS]; for (int i = 0; i < NBUFS; i++) { int len = ctxt.rlc1.read_pdu(pdu_bufs[i].msg, 4); // 3 bytes for header + payload pdu_bufs[i].N_bytes = len; } TESTASSERT(0 == ctxt.rlc1.get_buffer_state()); // Write 5 PDUs into RLC2 for (int i = 0; i < NBUFS; i++) { ctxt.rlc2.write_pdu(pdu_bufs[i].msg, pdu_bufs[i].N_bytes); } TESTASSERT(0 == ctxt.rlc2.get_buffer_state()); TESTASSERT(NBUFS == ctxt.tester.get_num_sdus()); for (uint32_t i = 0; i < ctxt.tester.sdus.size(); i++) { TESTASSERT(ctxt.tester.sdus.at(i)->N_bytes == 1); TESTASSERT(*(ctxt.tester.sdus[i]->msg) == i); } return 0; } int loss_test() { rlc_um_lte_test_context1 ctxt; // Push 5 SDUs into RLC1 unique_byte_buffer_t sdu_bufs[NBUFS]; for (int i = 0; i < NBUFS; i++) { sdu_bufs[i] = srsran::make_byte_buffer(); sdu_bufs[i]->msg[0] = i; // Write the index into the buffer sdu_bufs[i]->N_bytes = 1; // Give each buffer a size of 1 byte ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } TESTASSERT(14 == ctxt.rlc1.get_buffer_state()); // Read 5 PDUs from RLC1 (1 byte each) byte_buffer_t pdu_bufs[NBUFS]; for (int i = 0; i < NBUFS; i++) { int len = ctxt.rlc1.read_pdu(pdu_bufs[i].msg, 4); // 3 bytes for header + payload pdu_bufs[i].N_bytes = len; } TESTASSERT(0 == ctxt.rlc1.get_buffer_state()); // Write 5 PDUs into RLC2 (skip SN 1) for (int i = 0; i < NBUFS; i++) { if (i != 1) { ctxt.rlc2.write_pdu(pdu_bufs[i].msg, pdu_bufs[i].N_bytes); } } // Step the reordering timer until expiry while (ctxt.timers.nof_running_timers() != 0) { ctxt.timers.step_all(); } TESTASSERT(NBUFS - 1 == ctxt.tester.sdus.size()); return 0; } int basic_mbsfn_test() { rlc_um_lte_test_context1 ctxt; // configure as MCH ctxt.rlc1.configure(rlc_config_t::mch_config()); ctxt.rlc2.configure(rlc_config_t::mch_config()); // Push 5 SDUs into RLC1 unique_byte_buffer_t sdu_bufs[NBUFS * 2]; for (int i = 0; i < NBUFS; i++) { sdu_bufs[i] = srsran::make_byte_buffer(); sdu_bufs[i]->msg[0] = i; // Write the index into the buffer sdu_bufs[i]->N_bytes = 1; // Give each buffer a size of 1 byte ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } TESTASSERT(13 == ctxt.rlc1.get_buffer_state()); // Read 5 PDUs from RLC1 (1 byte each) byte_buffer_t pdu_bufs[NBUFS * 2]; for (int i = 0; i < NBUFS; i++) { int len = ctxt.rlc1.read_pdu(pdu_bufs[i].msg, 3); // 2 bytes for header + payload pdu_bufs[i].N_bytes = len; } TESTASSERT(0 == ctxt.rlc1.get_buffer_state()); // Write 5 PDUs into RLC2 for (int i = 0; i < NBUFS; i++) { ctxt.rlc2.write_pdu(pdu_bufs[i].msg, pdu_bufs[i].N_bytes); } TESTASSERT(0 == ctxt.rlc2.get_buffer_state()); TESTASSERT(NBUFS == ctxt.tester.sdus.size()); for (uint32_t i = 0; i < ctxt.tester.sdus.size(); i++) { TESTASSERT(ctxt.tester.sdus[i]->N_bytes == 1); TESTASSERT(*(ctxt.tester.sdus[i]->msg) == i); } return 0; } // This test checks the reassembly routines when a PDU // is lost that contains the beginning of SDU segment. // The PDU that contains the end of this SDU _also_ contains // a segment of another SDU. // On reassembly of the SDUs, the missing start segment // should be detected and the complete SDU be discarded // Therefore, one SDU less should be received than was tx'ed. // This test sends PDU in two batches so it's not the reordering // timeout that detects the missing PDU but the fact more // PDUs than rx_mod are received. int reassmble_test() { rlc_um_lte_test_context1 ctxt; // reconfigure them with 5bit SNs rlc_config_t cnfg = rlc_config_t::default_rlc_um_config(5); ctxt.rlc1.configure(cnfg); ctxt.rlc2.configure(cnfg); // Push SDUs into RLC1 const int n_sdus = 25; const int sdu_len = 100; ctxt.tester.set_expected_sdu_len(sdu_len); const int n_sdu_first_batch = 17; unique_byte_buffer_t sdu_bufs[n_sdus]; for (int i = 0; i < n_sdu_first_batch; i++) { sdu_bufs[i] = srsran::make_byte_buffer(); for (int k = 0; k < sdu_len; ++k) { sdu_bufs[i]->msg[k] = i; } sdu_bufs[i]->N_bytes = sdu_len; // Give each buffer a size of 1 byte ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } // Read PDUs from RLC1 (use smaller grant for first PDU and large for the rest) const int max_n_pdus = 100; int n_pdus = 0; std::unique_ptr pdu_bufs[max_n_pdus]; for (int i = 0; i < max_n_pdus; i++) { pdu_bufs[i] = srsran::make_byte_buffer(); int len = ctxt.rlc1.read_pdu(pdu_bufs[i]->msg, (i == 0) ? sdu_len * 3 / 4 : sdu_len * 1.25); pdu_bufs[i]->N_bytes = len; if (len) { n_pdus++; } else { break; } } printf("Generated %d PDUs in first batch\n", n_pdus); TESTASSERT(0 == ctxt.rlc1.get_buffer_state()); // push second batch of SDUs for (int i = n_sdu_first_batch; i < n_sdus; ++i) { sdu_bufs[i] = srsran::make_byte_buffer(); for (int k = 0; k < sdu_len; ++k) { sdu_bufs[i]->msg[k] = i; } sdu_bufs[i]->N_bytes = sdu_len; // Give each buffer a size of 1 byte ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } // Read second batch of PDUs (use large grants) for (int i = n_pdus; i < max_n_pdus; i++) { pdu_bufs[i] = srsran::make_byte_buffer(); int len = ctxt.rlc1.read_pdu(pdu_bufs[i]->msg, sdu_len * 1.25); pdu_bufs[i]->N_bytes = len; if (len) { n_pdus++; } else { // stop reading PDUs after first zero length PDU break; } } printf("Generated %d PDUs in total\n", n_pdus); // Write all PDUs into RLC2 except first one for (int i = 0; i < n_pdus; i++) { if (i != 0) { ctxt.rlc2.write_pdu(pdu_bufs[i]->msg, pdu_bufs[i]->N_bytes); } } // We should have received one SDU less than we tx'ed TESTASSERT(ctxt.tester.sdus.size() == n_sdus - 1); for (uint32_t i = 0; i < ctxt.tester.sdus.size(); ++i) { TESTASSERT(ctxt.tester.sdus[i]->N_bytes == sdu_len); } return 0; } // This reassmble test checks the reassembly routines when a PDU // is lost that _only_ contains the beginning of SDU segment, // while the next PDU contains the middle part of this SDU (and // yet another PDU the end part). // On reassembly of the SDUs, the missing start segment // should be detected and the complete SDU be discarded // Therefore, one SDU less should be received than was tx'ed. int reassmble_test2() { rlc_um_lte_test_context1 ctxt; // reconfigure them with 5bit SNs rlc_config_t cnfg = rlc_config_t::default_rlc_um_config(5); ctxt.rlc1.configure(cnfg); ctxt.rlc2.configure(cnfg); // Push SDUs into RLC1 const int n_sdus = 25; const int sdu_len = 100; ctxt.tester.set_expected_sdu_len(sdu_len); const int n_sdu_first_batch = 17; unique_byte_buffer_t sdu_bufs[n_sdus]; for (int i = 0; i < n_sdu_first_batch; i++) { sdu_bufs[i] = srsran::make_byte_buffer(); for (int k = 0; k < sdu_len; ++k) { sdu_bufs[i]->msg[k] = i; } sdu_bufs[i]->N_bytes = sdu_len; ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } const int max_n_pdus = 100; int n_pdus = 0; srsran::unique_byte_buffer_t pdu_bufs[max_n_pdus]; for (int i = 0; i < max_n_pdus; i++) { pdu_bufs[i] = srsran::make_byte_buffer(); int len = ctxt.rlc1.read_pdu(pdu_bufs[i]->msg, (i == 0) ? sdu_len * .75 : sdu_len * .25); pdu_bufs[i]->N_bytes = len; if (len) { n_pdus++; } else { break; } } printf("Generated %d PDUs in first batch\n", n_pdus); TESTASSERT(0 == ctxt.rlc1.get_buffer_state()); // push second batch of SDUs for (int i = n_sdu_first_batch; i < n_sdus; ++i) { sdu_bufs[i] = srsran::make_byte_buffer(); for (int k = 0; k < sdu_len; ++k) { sdu_bufs[i]->msg[k] = i; } sdu_bufs[i]->N_bytes = sdu_len; // Give each buffer a size of 1 byte ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } // Read second batch of PDUs for (int i = n_pdus; i < max_n_pdus; i++) { pdu_bufs[i] = srsran::make_byte_buffer(); int len = ctxt.rlc1.read_pdu(pdu_bufs[i]->msg, sdu_len * 1.25); pdu_bufs[i]->N_bytes = len; if (len) { n_pdus++; } else { break; } } printf("Generated %d PDUs in total\n", n_pdus); // Write all PDUs into RLC2 except first one for (int i = 0; i < n_pdus; i++) { if (i != 0) { ctxt.rlc2.write_pdu(pdu_bufs[i]->msg, pdu_bufs[i]->N_bytes); } } // We should have received one SDU less than we tx'ed TESTASSERT(ctxt.tester.sdus.size() == n_sdus - 1); for (uint32_t i = 0; i < ctxt.tester.sdus.size(); ++i) { TESTASSERT(ctxt.tester.sdus[i]->N_bytes == sdu_len); } return 0; } /* PDU pack test where 2nd SDU segment is added but no * space is left in PDU to add data bytes of the newly added SDU. * The test makes sure that a SDU header is removed again and that * the SDU is in fact transmitted in the next PDU. */ int pdu_pack_no_space_test() { rlc_um_lte_test_context1 ctxt; const int32_t num_sdus = 2; // Push 2 SDUs into RLC1 unique_byte_buffer_t sdu_bufs[num_sdus]; for (int i = 0; i < num_sdus; i++) { sdu_bufs[i] = srsran::make_byte_buffer(); *sdu_bufs[i]->msg = i; // Write the index into the buffer sdu_bufs[i]->N_bytes = 10; // Give each buffer a size of 1 byte ctxt.rlc1.write_sdu(std::move(sdu_bufs[i])); } // Read 1 PDU from RLC1 byte_buffer_t pdu_bufs[num_sdus]; int grant_size = 14; // Provide grant slightly bigger than the SDU int len = ctxt.rlc1.read_pdu(pdu_bufs[0].msg, grant_size); pdu_bufs[0].N_bytes = len; // the generated PDU is shorter than the MAC opportunity TESTASSERT(len < grant_size); // this PDU contains a full SDU { srsran::rlc_umd_pdu_header_t h; rlc_um_read_data_pdu_header(&pdu_bufs[0], srsran::rlc_umd_sn_size_t::size10bits, &h); TESTASSERT(h.fi == RLC_FI_FIELD_START_AND_END_ALIGNED); } // get the 2nd SDU len = ctxt.rlc1.read_pdu(pdu_bufs[1].msg, grant_size); pdu_bufs[1].N_bytes = len; { srsran::rlc_umd_pdu_header_t h; rlc_um_read_data_pdu_header(&pdu_bufs[1], srsran::rlc_umd_sn_size_t::size10bits, &h); TESTASSERT(h.fi == RLC_FI_FIELD_START_AND_END_ALIGNED); } return SRSRAN_SUCCESS; } int main(int argc, char** argv) { srslog::init(); if (meas_obj_test()) { return -1; } if (loss_test()) { return -1; } if (basic_mbsfn_test()) { return -1; } if (reassmble_test()) { return -1; } if (reassmble_test2()) { return -1; } TESTASSERT(pdu_pack_no_space_test() == 0); }