/** * * \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/. * */ #include #include #include #include "srslte/common/log_filter.h" #include "srslte/common/logger_stdout.h" #include "srslte/common/threads.h" #include "srslte/common/rlc_pcap.h" #include "srslte/upper/rlc.h" #include #include #include #include #define LOG_HEX_LIMIT (-1) using namespace std; using namespace srsue; using namespace srslte; namespace bpo = boost::program_options; typedef struct { std::string mode; uint32_t sdu_size; uint32_t test_duration_sec; float error_rate; uint32_t sdu_gen_delay_usec; uint32_t pdu_tx_delay_usec; bool reestablish; uint32_t log_level; bool single_tx; bool write_pcap; float opp_sdu_ratio; bool zero_seed; bool pedantic; } stress_test_args_t; void parse_args(stress_test_args_t *args, int argc, char *argv[]) { // Command line only options bpo::options_description general("General options"); general.add_options() ("help,h", "Produce help message") ("version,v", "Print version information and exit"); // Command line or config file options bpo::options_description common("Configuration options"); common.add_options() ("mode", bpo::value(&args->mode)->default_value("AM"), "Whether to test RLC acknowledged or unacknowledged mode (AM/UM)") ("duration", bpo::value(&args->test_duration_sec)->default_value(5), "Duration (sec)") ("sdu_size", bpo::value(&args->sdu_size)->default_value(1500), "Size of SDUs") ("sdu_gen_delay", bpo::value(&args->sdu_gen_delay_usec)->default_value(0), "SDU generation delay (usec)") ("pdu_tx_delay", bpo::value(&args->pdu_tx_delay_usec)->default_value(0), "Delay in MAC for transfering PDU from tx'ing RLC to rx'ing RLC (usec)") ("error_rate", bpo::value(&args->error_rate)->default_value(0.1), "Rate at which RLC PDUs are dropped") ("opp_sdu_ratio", bpo::value(&args->opp_sdu_ratio)->default_value(0.0), "Ratio between MAC opportunity and SDU size (0==random)") ("reestablish", bpo::value(&args->reestablish)->default_value(false), "Mimic RLC reestablish during execution") ("loglevel", bpo::value(&args->log_level)->default_value(srslte::LOG_LEVEL_DEBUG), "Log level (1=Error,2=Warning,3=Info,4=Debug)") ("singletx", bpo::value(&args->single_tx)->default_value(false), "If set to true, only one node is generating data") ("pcap", bpo::value(&args->write_pcap)->default_value(false), "Whether to write all RLC PDU to PCAP file") ("zeroseed", bpo::value(&args->zero_seed)->default_value(false), "Whether to initialize random seed to zero") ("pedantic", bpo::value(&args->pedantic)->default_value(true), "Whether to perform strict SDU size checking at receiver"); // these options are allowed on the command line bpo::options_description cmdline_options; cmdline_options.add(common).add(general); // parse the command line and store result in vm bpo::variables_map vm; bpo::store(bpo::command_line_parser(argc, argv).options(cmdline_options).run(), vm); bpo::notify(vm); // help option was given - print usage and exit if (vm.count("help") > 0) { cout << "Usage: " << argv[0] << " [OPTIONS] config_file" << endl << endl; cout << common << endl << general << endl; exit(0); } if (args->log_level > 4) { args->log_level = 4; printf("Set log level to %d (%s)\n", args->log_level, srslte::log_level_text[args->log_level]); } } class mac_dummy :public srslte::mac_interface_timers ,public thread { public: mac_dummy(rlc_interface_mac *rlc1_, rlc_interface_mac *rlc2_, stress_test_args_t args_, uint32_t lcid_, rlc_pcap* pcap_ = NULL) :timers(8) ,run_enable(true) ,rlc1(rlc1_) ,rlc2(rlc2_) ,args(args_) ,pcap(pcap_) ,lcid(lcid_) ,log("MAC ") { log.set_level(static_cast(args.log_level)); log.set_hex_limit(LOG_HEX_LIMIT); } void stop() { run_enable = false; wait_thread_finish(); } srslte::timers::timer* timer_get(uint32_t timer_id) { return timers.get(timer_id); } uint32_t timer_get_unique_id() { return timers.get_unique_id(); } void timer_release_id(uint32_t timer_id) { timers.release_id(timer_id); } void step_timer() { timers.step_all(); } private: void run_tti(rlc_interface_mac *tx_rlc, rlc_interface_mac *rx_rlc, bool is_dl) { byte_buffer_t *pdu = byte_buffer_pool::get_instance()->allocate(__PRETTY_FUNCTION__); if (!pdu) { printf("Fatal Error: Could not allocate PDU in mac_reader::run_thread\n"); exit(-1); } float r = args.opp_sdu_ratio ? args.opp_sdu_ratio : static_cast(rand())/RAND_MAX; int opp_size = r*args.sdu_size; uint32_t buf_state = tx_rlc->get_buffer_state(lcid); if (buf_state > 0) { int read = tx_rlc->read_pdu(lcid, pdu->msg, opp_size); pdu->N_bytes = read; if (args.pdu_tx_delay_usec > 0) { usleep(args.pdu_tx_delay_usec); } if(((float)rand()/RAND_MAX > args.error_rate) && read>0) { rx_rlc->write_pdu(lcid, pdu->msg, pdu->N_bytes); if (is_dl) { pcap->write_dl_am_ccch(pdu->msg, pdu->N_bytes); } else { pcap->write_ul_am_ccch(pdu->msg, pdu->N_bytes); } } else { log.warning_hex(pdu->msg, pdu->N_bytes, "Dropping RLC PDU (%d B)\n", pdu->N_bytes); } } byte_buffer_pool::get_instance()->deallocate(pdu); } void run_thread() { while (run_enable) { // Downlink direction first (RLC1->RLC2) run_tti(rlc1, rlc2, true); // UL direction (RLC2->RLC1) run_tti(rlc2, rlc1, false); // step timer step_timer(); } } rlc_interface_mac *rlc1; rlc_interface_mac *rlc2; srslte::timers timers; bool run_enable; stress_test_args_t args; rlc_pcap *pcap; uint32_t lcid; srslte::log_filter log; }; class rlc_tester :public pdcp_interface_rlc ,public rrc_interface_rlc ,public thread { public: rlc_tester(rlc_interface_pdcp *rlc_, std::string name_, stress_test_args_t args_, uint32_t lcid_) :log("Testr") ,rlc(rlc_) ,run_enable(true) ,rx_pdus() ,name(name_) ,args(args_) ,lcid(lcid_) { log.set_level(srslte::LOG_LEVEL_ERROR); log.set_hex_limit(LOG_HEX_LIMIT); } void stop() { run_enable = false; wait_thread_finish(); } // PDCP interface void write_pdu(uint32_t rx_lcid, byte_buffer_t *sdu) { assert(rx_lcid == lcid); if (sdu->N_bytes != args.sdu_size) { log.error_hex(sdu->msg, sdu->N_bytes, "Received SDU with size %d, expected %d.\n", sdu->N_bytes, args.sdu_size); // exit if in pedantic mode or SDU is not a multiple of the expected size if (args.pedantic || sdu->N_bytes % args.sdu_size != 0) { exit(-1); } } byte_buffer_pool::get_instance()->deallocate(sdu); rx_pdus++; } void write_pdu_bcch_bch(byte_buffer_t *sdu) {} void write_pdu_bcch_dlsch(byte_buffer_t *sdu) {} void write_pdu_pcch(byte_buffer_t *sdu) {} void write_pdu_mch(uint32_t lcid, srslte::byte_buffer_t *sdu) {} // RRC interface void max_retx_attempted(){} std::string get_rb_name(uint32_t rx_lcid) { return std::string("DRB1"); } int get_nof_rx_pdus() { return rx_pdus; } private: void run_thread() { uint8_t sn = 0; while(run_enable) { byte_buffer_t *pdu = byte_buffer_pool::get_instance()->allocate("rlc_tester::run_thread"); if (pdu == NULL) { printf("Error: Could not allocate PDU in rlc_tester::run_thread\n\n\n"); // backoff for a bit usleep(1000); continue; } for (uint32_t i = 0; i < args.sdu_size; i++) { pdu->msg[i] = sn; } sn++; pdu->N_bytes = args.sdu_size; rlc->write_sdu(lcid, pdu); if (args.sdu_gen_delay_usec > 0) { usleep(args.sdu_gen_delay_usec); } } } bool run_enable; uint64_t rx_pdus; uint32_t lcid; srslte::log_filter log; std::string name; stress_test_args_t args; rlc_interface_pdcp *rlc; }; void stress_test(stress_test_args_t args) { srslte::log_filter log1("RLC_1"); srslte::log_filter log2("RLC_2"); log1.set_level(static_cast(args.log_level)); log2.set_level(static_cast(args.log_level)); log1.set_hex_limit(LOG_HEX_LIMIT); log2.set_hex_limit(LOG_HEX_LIMIT); rlc_pcap pcap; uint32_t lcid = 1; if (args.write_pcap) { pcap.open("rlc_stress_test.pcap", 0); } srslte_rlc_config_t cnfg_; if (args.mode == "AM") { // config RLC AM bearer cnfg_.rlc_mode = RLC_MODE_AM; cnfg_.am.max_retx_thresh = 4; cnfg_.am.poll_byte = 25*1000; cnfg_.am.poll_pdu = 4; cnfg_.am.t_poll_retx = 5; cnfg_.am.t_reordering = 5; cnfg_.am.t_status_prohibit = 5; } else if (args.mode == "UM") { // config UM bearer cnfg_.rlc_mode = RLC_MODE_UM; cnfg_.um.t_reordering = 5; cnfg_.um.rx_mod = 32; cnfg_.um.rx_sn_field_length = RLC_UMD_SN_SIZE_5_BITS; cnfg_.um.rx_window_size = 16; cnfg_.um.tx_sn_field_length = RLC_UMD_SN_SIZE_5_BITS; cnfg_.um.tx_mod = 32; } else if (args.mode == "TM") { // use default LCID in TM lcid = 0; } else { cout << "Unsupported RLC mode " << args.mode << ", exiting." << endl; exit(-1); } rlc rlc1; rlc rlc2; rlc_tester tester1(&rlc1, "tester1", args, lcid); rlc_tester tester2(&rlc2, "tester2", args, lcid); mac_dummy mac(&rlc1, &rlc2, args, lcid, &pcap); ue_interface ue; rlc1.init(&tester1, &tester1, &ue, &log1, &mac, 0); rlc2.init(&tester2, &tester2, &ue, &log2, &mac, 0); // only add AM and UM bearers if (args.mode != "TM") { rlc1.add_bearer(lcid, cnfg_); rlc2.add_bearer(lcid, cnfg_); } tester1.start(7); if (!args.single_tx) { tester2.start(7); } mac.start(); if (args.test_duration_sec < 1) { args.test_duration_sec = 1; } for (uint32_t i = 0; i < args.test_duration_sec; i++) { // if enabled, mimic reestablishment every second if (args.reestablish) { rlc1.reestablish(); rlc2.reestablish(); } usleep(1e6); } printf("Test finished, tearing down ..\n"); // Stop RLC instances first to release blocking writers rlc1.stop(); rlc2.stop(); printf("RLC entities stopped.\n"); // Stop upper layer writers tester1.stop(); tester2.stop(); printf("Writers stopped.\n"); mac.stop(); if (args.write_pcap) { pcap.close(); } rlc_metrics_t metrics = {}; rlc1.get_metrics(metrics); printf("RLC1 received %d SDUs in %ds (%.2f/s), Throughput: DL=%4.2f Mbps, UL=%4.2f Mbps\n", tester1.get_nof_rx_pdus(), args.test_duration_sec, static_cast(tester1.get_nof_rx_pdus()/args.test_duration_sec), metrics.dl_tput_mbps[lcid], metrics.ul_tput_mbps[lcid]); rlc2.get_metrics(metrics); printf("RLC2 received %d SDUs in %ds (%.2f/s), Throughput: DL=%4.2f Mbps, UL=%4.2f Mbps\n", tester2.get_nof_rx_pdus(), args.test_duration_sec, static_cast(tester2.get_nof_rx_pdus()/args.test_duration_sec), metrics.dl_tput_mbps[lcid], metrics.ul_tput_mbps[lcid]); } int main(int argc, char **argv) { stress_test_args_t args = {}; parse_args(&args, argc, argv); if (args.zero_seed) { srand(0); } else { srand(time(NULL)); } stress_test(args); byte_buffer_pool::get_instance()->cleanup(); exit(0); }