du,du_high_unit: add option to set RAN slices and their scheduling parameters

Author: herlesupreeth

apps/units/flexible_du/du_high/du_high_config.h

@@ -27,6 +27,7 @@
 #include "srsran/ran/pucch/pucch_configuration.h"
 #include "srsran/ran/pusch/pusch_mcs.h"
 #include "srsran/ran/rnti.h"
+#include "srsran/ran/s_nssai.h"
 #include "srsran/ran/sib/system_info_config.h"
 #include "srsran/ran/slot_pdu_capacity_constants.h"
 #include "srsran/ran/subcarrier_spacing.h"
@@ -486,6 +487,22 @@ struct du_high_unit_prach_config {
   uint8_t nof_cb_preambles_per_ssb = 64;
 };
 
+/// Slice scheduling configuration for a cell.
+struct du_high_unit_cell_slice_sched_config {
+  /// Sets the minimum number of PRBs to be allocated to this group.
+  unsigned min_prb = 0;
+  /// Sets the maximum number of PRBs to be allocated to this group.
+  unsigned max_prb = MAX_NOF_PRBS;
+};
+
+/// Slice configuration for a cell.
+struct du_high_unit_cell_slice_config {
+  /// Slice identifier.
+  s_nssai_t s_nssai = s_nssai_t{1};
+  /// Slice scheduling configuration.
+  du_high_unit_cell_slice_sched_config sched_cfg;
+};
+
 /// Base cell configuration.
 struct du_high_unit_base_cell_config {
   /// Physical cell identifier.
@@ -540,6 +557,8 @@ struct du_high_unit_base_cell_config {
   du_high_unit_csi_config csi_cfg;
   /// Scheduler expert configuration.
   du_high_unit_scheduler_expert_config sched_expert_cfg;
+  /// Network slice configuration.
+  std::vector<du_high_unit_cell_slice_config> slice_cfg;
 };
 
 struct du_high_unit_test_mode_ue_config {

apps/units/flexible_du/du_high/du_high_config_cli11_schema.cpp

@@ -1027,6 +1027,31 @@ static void configure_cli11_sib_args(CLI::App& app, du_high_unit_sib_config& sib
       ->check(CLI::IsMember({100, 200, 300, 400, 600, 1000, 1500, 2000}));
 }
 
+static void configure_cli11_slicing_scheduling_args(CLI::App&                             app,
+                                                    du_high_unit_cell_slice_sched_config& slice_sched_params)
+{
+  add_option(app, "--min_prb", slice_sched_params.min_prb, "Minimum number of PRBs to be allocated to the slice")
+      ->capture_default_str()
+      ->check(CLI::Range(0U, (unsigned)MAX_NOF_PRBS));
+  add_option(app, "--max_prb", slice_sched_params.max_prb, "Maximum number of PRBs to be allocated to the slice")
+      ->capture_default_str()
+      ->check(CLI::Range(1U, (unsigned)MAX_NOF_PRBS));
+}
+
+static void configure_cli11_slicing_args(CLI::App& app, du_high_unit_cell_slice_config& slice_params)
+{
+  add_option(app, "--sst", slice_params.s_nssai.sst, "Slice Service Type")
+      ->capture_default_str()
+      ->check(CLI::Range(0, 255));
+  add_option(app, "--sd", slice_params.s_nssai.sd, "Service Differentiator")
+      ->capture_default_str()
+      ->check(CLI::Range(0, 0xffffff));
+
+  // Scheduling configuration.
+  CLI::App* sched_cfg_subcmd = add_subcommand(app, "sched_cfg", "Slice scheduling configuration")->configurable();
+  configure_cli11_slicing_scheduling_args(*sched_cfg_subcmd, slice_params.sched_cfg);
+}
+
 static void configure_cli11_common_cell_args(CLI::App& app, du_high_unit_base_cell_config& cell_params)
 {
   add_option(app, "--pci", cell_params.pci, "PCI")->capture_default_str()->check(CLI::Range(0, 1007));
@@ -1180,6 +1205,23 @@ static void configure_cli11_common_cell_args(CLI::App& app, du_high_unit_base_ce
   // Scheduler expert configuration.
   CLI::App* sched_expert_subcmd = add_subcommand(app, "sched_expert_cfg", "Scheduler expert parameters");
   configure_cli11_scheduler_expert_args(*sched_expert_subcmd, cell_params.sched_expert_cfg);
+
+  // Slicing configuration.
+  auto slicing_lambda = [&cell_params](const std::vector<std::string>& values) {
+    // Prepare the slices and its configuration.
+    cell_params.slice_cfg.resize(values.size());
+
+    // Format every slicing setting.
+    for (unsigned i = 0, e = values.size(); i != e; ++i) {
+      CLI::App subapp("Slicing parameters", "Slicing config, item #" + std::to_string(i));
+      subapp.config_formatter(create_yaml_config_parser());
+      subapp.allow_config_extras(CLI::config_extras_mode::capture);
+      configure_cli11_slicing_args(subapp, cell_params.slice_cfg[i]);
+      std::istringstream ss(values[i]);
+      subapp.parse_from_stream(ss);
+    }
+  };
+  add_option_cell(app, "--slicing", slicing_lambda, "Network slicing configuration");
 }
 
 static void configure_cli11_cells_args(CLI::App& app, du_high_unit_cell_config& cell_params)

apps/units/flexible_du/du_high/du_high_config_translators.cpp

@@ -603,6 +603,9 @@ std::vector<du_cell_config> srsran::generate_du_cell_config(const du_high_unit_c
           du_pucch_cfg, out_cell.ul_cfg_common.init_ul_bwp.generic_params.crbs.length(), is_long_prach);
     }
 
+    // Slicing configuration.
+    out_cell.rrm_policy_members = generate_du_slicing_rrm_policy_config(base_cell.plmn, base_cell.slice_cfg);
+
     logger.info(
         "SSB derived parameters for cell: {}, band: {}, dl_arfcn:{}, crbs: {} scs:{}, ssb_scs:{}:\n\t - SSB offset "
         "pointA:{} \n\t - k_SSB:{} \n\t - SSB arfcn:{} \n\t - Coreset index:{} \n\t - Searchspace index:{}",
@@ -667,6 +670,21 @@ static mac_lc_config generate_mac_lc_config(const du_high_unit_mac_lc_config& in
   return out_mac;
 }
 
+std::vector<slice_rrm_policy_config>
+srsran::generate_du_slicing_rrm_policy_config(const std::string&                         plmn,
+                                              span<const du_high_unit_cell_slice_config> slice_cfg)
+{
+  std::vector<slice_rrm_policy_config> rrm_policy_cfgs;
+  for (const auto& cfg : slice_cfg) {
+    rrm_policy_cfgs.emplace_back();
+    rrm_policy_cfgs.back().rrc_member.s_nssai = cfg.s_nssai;
+    rrm_policy_cfgs.back().rrc_member.plmn_id = plmn;
+    rrm_policy_cfgs.back().min_prb            = cfg.sched_cfg.min_prb;
+    rrm_policy_cfgs.back().max_prb            = cfg.sched_cfg.max_prb;
+  }
+  return rrm_policy_cfgs;
+}
+
 std::map<five_qi_t, du_qos_config> srsran::generate_du_qos_config(const du_high_unit_config& config)
 {
   std::map<five_qi_t, du_qos_config> out_cfg = {};

apps/units/flexible_du/du_high/du_high_config_translators.h

@@ -9,6 +9,8 @@
  */
 
 #pragma once
+
+#include "du_high_config.h"
 #include "srsran/du/du_cell_config.h"
 #include "srsran/du/du_qos_config.h"
 #include "srsran/du/du_srb_config.h"
@@ -44,4 +46,8 @@ e2ap_configuration generate_e2_config(const du_high_unit_config& du_high);
 /// Augments RLC parameters based on NTN configuration.
 void ntn_augment_rlc_parameters(const ntn_config& ntn_cfg, std::map<srb_id_t, du_srb_config>& srb_cfgs);
 
+/// Converts and returns the given gnb application configuration to a DU slice RRM policy configuration list.
+std::vector<slice_rrm_policy_config>
+generate_du_slicing_rrm_policy_config(const std::string& plmn, span<const du_high_unit_cell_slice_config> slice_cfg);
+
 } // namespace srsran

include/srsran/du/du_cell_config.h

@@ -20,6 +20,7 @@
 #include "srsran/ran/tdd/tdd_ul_dl_config.h"
 #include "srsran/scheduler/config/bwp_configuration.h"
 #include "srsran/scheduler/config/serving_cell_config.h"
+#include "srsran/scheduler/config/slice_rrm_policy_config.h"
 
 namespace srsran {
 
@@ -167,6 +168,9 @@ struct du_cell_config {
 
   /// Defines the maximum allowable channel delay in slots when runnning in NTN mode. seee (TS 38.300 section 16.14.2)
   unsigned ntn_cs_koffset = 0;
+
+  /// List of RAN slices to support in the scheduler.
+  std::vector<slice_rrm_policy_config> rrm_policy_members;
 };
 
 } // namespace srsran