// SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause /* * KUnit tests for link selection functions * * Copyright (C) 2025 Intel Corporation */ #include #include "utils.h" #include "mld.h" #include "link.h" #include "iface.h" #include "phy.h" #include "mlo.h" static const struct link_grading_test_case { const char *desc; struct { struct { u8 link_id; const struct cfg80211_chan_def *chandef; bool active; s32 signal; bool has_chan_util_elem; u8 chan_util; /* 0-255 , used only if has_chan_util_elem is true */ u8 chan_load_by_us; /* 0-100, used only if active is true */; } link; } input; unsigned int expected_grade; } link_grading_cases[] = { { .desc = "channel util of 128 (50%)", .input.link = { .link_id = 0, .chandef = &chandef_2ghz, .active = false, .has_chan_util_elem = true, .chan_util = 128, }, .expected_grade = 86, }, { .desc = "channel util of 180 (70%)", .input.link = { .link_id = 0, .chandef = &chandef_2ghz, .active = false, .has_chan_util_elem = true, .chan_util = 180, }, .expected_grade = 51, }, { .desc = "channel util of 180 (70%), channel load by us of 10%", .input.link = { .link_id = 0, .chandef = &chandef_2ghz, .has_chan_util_elem = true, .chan_util = 180, .active = true, .chan_load_by_us = 10, }, .expected_grade = 67, }, { .desc = "no channel util element", .input.link = { .link_id = 0, .chandef = &chandef_2ghz, .active = true, }, .expected_grade = 120, }, }; KUNIT_ARRAY_PARAM_DESC(link_grading, link_grading_cases, desc); static void setup_link(struct ieee80211_bss_conf *link) { struct kunit *test = kunit_get_current_test(); struct iwl_mld *mld = test->priv; const struct link_grading_test_case *test_param = (const void *)(test->param_value); KUNIT_ALLOC_AND_ASSERT(test, link->bss); link->bss->signal = DBM_TO_MBM(test_param->input.link.signal); link->chanreq.oper = *test_param->input.link.chandef; if (test_param->input.link.has_chan_util_elem) { struct cfg80211_bss_ies *ies; struct ieee80211_bss_load_elem bss_load = { .channel_util = test_param->input.link.chan_util, }; struct element *elem = iwlmld_kunit_gen_element(WLAN_EID_QBSS_LOAD, &bss_load, sizeof(bss_load)); unsigned int elem_len = sizeof(*elem) + sizeof(bss_load); KUNIT_ALLOC_AND_ASSERT_SIZE(test, ies, sizeof(*ies) + elem_len); memcpy(ies->data, elem, elem_len); ies->len = elem_len; rcu_assign_pointer(link->bss->beacon_ies, ies); rcu_assign_pointer(link->bss->ies, ies); } if (test_param->input.link.active) { struct ieee80211_chanctx_conf *chan_ctx = wiphy_dereference(mld->wiphy, link->chanctx_conf); struct iwl_mld_phy *phy; KUNIT_ASSERT_NOT_NULL(test, chan_ctx); phy = iwl_mld_phy_from_mac80211(chan_ctx); phy->channel_load_by_us = test_param->input.link.chan_load_by_us; } } static void test_link_grading(struct kunit *test) { struct iwl_mld *mld = test->priv; const struct link_grading_test_case *test_param = (const void *)(test->param_value); struct ieee80211_vif *vif; struct ieee80211_bss_conf *link; unsigned int actual_grade; /* Extract test case parameters */ u8 link_id = test_param->input.link.link_id; bool active = test_param->input.link.active; u16 valid_links; struct iwl_mld_kunit_link assoc_link = { .band = test_param->input.link.chandef->chan->band, }; /* If the link is not active, use a different link as the assoc link */ if (active) { assoc_link.id = link_id; valid_links = BIT(link_id); } else { assoc_link.id = BIT(ffz(BIT(link_id))); valid_links = BIT(assoc_link.id) | BIT(link_id); } vif = iwlmld_kunit_setup_mlo_assoc(valid_links, &assoc_link); wiphy_lock(mld->wiphy); link = wiphy_dereference(mld->wiphy, vif->link_conf[link_id]); KUNIT_ASSERT_NOT_NULL(test, link); setup_link(link); actual_grade = iwl_mld_get_link_grade(mld, link); wiphy_unlock(mld->wiphy); /* Assert that the returned grade matches the expected grade */ KUNIT_EXPECT_EQ(test, actual_grade, test_param->expected_grade); } static struct kunit_case link_selection_cases[] = { KUNIT_CASE_PARAM(test_link_grading, link_grading_gen_params), {}, }; static struct kunit_suite link_selection = { .name = "iwlmld-link-selection-tests", .test_cases = link_selection_cases, .init = iwlmld_kunit_test_init, }; kunit_test_suite(link_selection); static const struct channel_load_case { const char *desc; bool low_latency_vif; u32 chan_load_not_by_us; enum nl80211_chan_width bw_a; enum nl80211_chan_width bw_b; bool primary_link_active; bool expected_result; } channel_load_cases[] = { { .desc = "Unequal bandwidth, primary link inactive, EMLSR not allowed", .low_latency_vif = false, .primary_link_active = false, .bw_a = NL80211_CHAN_WIDTH_40, .bw_b = NL80211_CHAN_WIDTH_20, .expected_result = false, }, { .desc = "Equal bandwidths, sufficient channel load, EMLSR allowed", .low_latency_vif = false, .primary_link_active = true, .chan_load_not_by_us = 11, .bw_a = NL80211_CHAN_WIDTH_40, .bw_b = NL80211_CHAN_WIDTH_40, .expected_result = true, }, { .desc = "Equal bandwidths, insufficient channel load, EMLSR not allowed", .low_latency_vif = false, .primary_link_active = true, .chan_load_not_by_us = 6, .bw_a = NL80211_CHAN_WIDTH_80, .bw_b = NL80211_CHAN_WIDTH_80, .expected_result = false, }, { .desc = "Low latency VIF, sufficient channel load, EMLSR allowed", .low_latency_vif = true, .primary_link_active = true, .chan_load_not_by_us = 6, .bw_a = NL80211_CHAN_WIDTH_160, .bw_b = NL80211_CHAN_WIDTH_160, .expected_result = true, }, { .desc = "Different bandwidths (2x ratio), primary link load permits EMLSR", .low_latency_vif = false, .primary_link_active = true, .chan_load_not_by_us = 30, .bw_a = NL80211_CHAN_WIDTH_40, .bw_b = NL80211_CHAN_WIDTH_20, .expected_result = true, }, { .desc = "Different bandwidths (4x ratio), primary link load permits EMLSR", .low_latency_vif = false, .primary_link_active = true, .chan_load_not_by_us = 45, .bw_a = NL80211_CHAN_WIDTH_80, .bw_b = NL80211_CHAN_WIDTH_20, .expected_result = true, }, { .desc = "Different bandwidths (16x ratio), primary link load insufficient", .low_latency_vif = false, .primary_link_active = true, .chan_load_not_by_us = 45, .bw_a = NL80211_CHAN_WIDTH_320, .bw_b = NL80211_CHAN_WIDTH_20, .expected_result = false, }, }; KUNIT_ARRAY_PARAM_DESC(channel_load, channel_load_cases, desc); static void test_iwl_mld_channel_load_allows_emlsr(struct kunit *test) { const struct channel_load_case *params = test->param_value; struct iwl_mld *mld = test->priv; struct ieee80211_vif *vif; struct cfg80211_chan_def chandef_a, chandef_b; struct iwl_mld_link_sel_data a = {.chandef = &chandef_a, .link_id = 4}; struct iwl_mld_link_sel_data b = {.chandef = &chandef_b, .link_id = 5}; struct iwl_mld_kunit_link assoc_link = { .id = params->primary_link_active ? a.link_id : b.link_id, .bandwidth = params->primary_link_active ? params->bw_a : params->bw_b, }; bool result; vif = iwlmld_kunit_setup_mlo_assoc(BIT(a.link_id) | BIT(b.link_id), &assoc_link); chandef_a.width = params->bw_a; chandef_b.width = params->bw_b; if (params->low_latency_vif) iwl_mld_vif_from_mac80211(vif)->low_latency_causes = 1; wiphy_lock(mld->wiphy); /* Simulate channel load */ if (params->primary_link_active) { struct iwl_mld_phy *phy = iwlmld_kunit_get_phy_of_link(vif, a.link_id); phy->avg_channel_load_not_by_us = params->chan_load_not_by_us; } result = iwl_mld_channel_load_allows_emlsr(mld, vif, &a, &b); wiphy_unlock(mld->wiphy); KUNIT_EXPECT_EQ(test, result, params->expected_result); } static struct kunit_case channel_load_criteria_test_cases[] = { KUNIT_CASE_PARAM(test_iwl_mld_channel_load_allows_emlsr, channel_load_gen_params), {} }; static struct kunit_suite channel_load_criteria_tests = { .name = "iwlmld_channel_load_allows_emlsr", .test_cases = channel_load_criteria_test_cases, .init = iwlmld_kunit_test_init, }; kunit_test_suite(channel_load_criteria_tests);