srsRAN_4G/srsenb/test/mac/sched_ue_ded_test_suite.h

/**
 *
 * \section COPYRIGHT
 *
 * Copyright 2013-2020 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.
 *
 */

#ifndef SRSLTE_SCHED_UE_DED_TEST_SUITE_H
#define SRSLTE_SCHED_UE_DED_TEST_SUITE_H

#include "sched_common_test_suite.h"
#include "sched_sim_ue.h"

namespace srsenb {

/**
 * Checks DL grant content and whether it is consistent with the current UE context. Current checks:
 * - The DCI rv matches the nof DL harq retxs observed from the UE perspective
 * - The number of retxs per DL harq does not exceed its maximum set in the ue cfg
 * - HARQ pids are not reused too early (ACK hasn't arrive to the eNB yet)
 * @param enb_ctxt current eNB state, including list of UEs
 * @param sf_out result of a subframe sched result
 * @return error code
 */
int test_dl_sched_result(const sim_enb_ctxt_t& enb_ctxt, const sf_output_res_t& sf_out);

/**
 * Checks PHICH & PUSCH grant content and whether it is consistent with the current UE HARQ state. Current checks:
 * - All PHICH and PUSCH grants' rnti values are present in the eNB context
 * - UEs only get PUSCH grants in active CCs
 * - Active UE UL HARQs expect PHICH
 * - Active UE UL HARQs expect PUSCH grants except if it is the last retx
 * - The DCI rv matches the nof UL harq retxs observed from the UE perspective
 * - The number of retxs per UL harq does not exceed its maximum value set in the ue cfg
 * @param enb_ctxt current eNB state, including list of UEs
 * @param sf_out result of a subframe sched result
 * @return error code
 */
int test_ul_sched_result(const sim_enb_ctxt_t& enb_ctxt, const sf_output_res_t& sf_out);

/**
 * Checks whether the RAR, Msg3, Msg4 were scheduled within the expected windows. Current tests:
 * - RAR alloc falls within RAR window and only takes place once per user
 * - No UL allocs before Msg4 that are not Msg3
 * - Msg3 is allocated in expected TTI, without PDCCH, and PRBs advertised in RAR
 * - First Data allocation happens after Msg3 is ACKed, and contains a ConRes CE
 * - No RARs are allocated with wrong enb_cc_idx, preamble_idx or wrong user
 * - All RARs belong to a user that just PRACHed
 * - All DL/UL data allocs have a valid RNTI
 */
int test_ra(const sim_enb_ctxt_t& enb_ctxt, const sf_output_res_t& sf_out);

int test_meas_gaps(const sim_enb_ctxt_t& enb_ctxt, const sf_output_res_t& sf_out);

/**
 * Call all tests that depend on the UE internal state for all registered UEs in the eNB
 * @param enb_ctxt current eNB state, including list of UEs
 * @param sf_out result of a subframe sched result
 * @return error code
 */
int test_all_ues(const sim_enb_ctxt_t& enb_ctxt, const sf_output_res_t& sf_out);

} // namespace srsenb

#endif // SRSLTE_SCHED_UE_DED_TEST_SUITE_H